NAME
   toaster_setup.pl - runs various build and testing functions for
   Mail::Toaster

VERSION
   This document refers to Mail::Toaster version 5.00

SYNOPSIS
   toaster_setupl.pl is the front end to everything you need to turn a
   computer into a secure, full-featured, high-performance mail server.

      toaster_setup.pl -s <help> [-d]

         -s[ection] - see OPTIONS AND ARGUMENTS section for choices
         -d[ebug]   - enable verbose debugging

   A really good place to start is:

      toaster_setupl.pl -s help | less

DESCRIPTION
   The mail toaster is a collection of open-source software which provides
   a full-featured mail server running on FreeBSD, Mac OS X, and Linux. The
   system is built around the qmail mail transport agent, with many
   additions and modifications. Matt Simerson is the primary author and
   maintainer of the toaster. There is an active and friendly community of
   toaster owners which supports the toaster on a mailing list and web
   forum.

   The toaster is built around qmail, a robust mail transfer agent by
   Daniel J. Bernstein, and vpopmail, a virtual domain manager by Inter7
   systems. Matt keeps up with releases of the core software, evaluates
   them, decides when they are stable, and then integrates them into the
   toaster. Matt has also added several patches which add functionality to
   these core programs.

   A complete set of instructions for building a mail toaster are on the
   toaster install page. There is a substantial amount of documentation
   available for the "Mail::Toaster" toaster. Much of it is also readable
   via "perldoc Mail::Toaster", and the subsequent pages. Don't forget to
   read the Install, Configure, and FAQ pages on the web site. If you still
   have questions, there is a Web Forum and mailing list. Both are
   browseable and searchable for your convenience.

 URLs
      http://mail-toaster.org/
      http://www.tnpi.net/internet/mail/toaster/

OPTIONS AND ARGUMENTS
     toaster_setup.pl -s <section> [-debug]

              help - print this usage screen
            config - initial configuration of toaster*.conf files
              perl - installs or upgrades perl
               pre - installs a list of programs and libraries other toaster components need

                        FreeBSD Specific
             ports - updates your ports tree, installs the pkg_* tools
           sources - update your FreeBSD sources (/usr/src)
           jailadd - creates a new jail
         jailstart - starts up an existing jail
        jaildelete - deletes an existing jail

                       Standard Daemons & Utilities
             mysql - installs MySQL
        phpmyadmin - installs phpMyAdmin
            apache - installs Apache
         apachessl - installs self signed SSL certs for Apache
        apacheconf - patches httpd.conf for use with Mail::Toaster

                        Qmail and related tools
             ucspi - install ucspi-tcp w/MySQL patch
       daemontools - install daemontools
             ezmlm - install EzMLM idx
          vpopmail - installs vpopmail
         vpeconfig - configure ~vpopmail/etc/tcp.smtp
         vpopmysql - run the vpopmail MySQL grant and db create commands
           vqadmin - install vqadmin
             qmail - installs qmail with toaster patches
         qmailconf - configure various qmail control files
          netqmail - installs netqmail
       netqmailmac - installs netqmail with no patches
            djbdns - install the djbdns program

           courier - installs courier imap & pop3 daemons
       courierconf - post install configure for courier

                      Web Mail and Admin interfaces
        qmailadmin - installs qmailadmin
         sqwebmail - installs sqwebmail (webmail app)
      squirrelmail - installs squirrelmail (webmail app)
         roundcube - installs Roundcube (webmail app)

                        Mail Filtering
            filter - installs SpamAssassin, ClamAV, DCC, razor, and more
             razor - installs the razor2 agents
          maildrop - installs maildrop and mailfilter
            clamav - installs just ClamAV
      qmailscanner - installs Qmail-Scanner & qmailscanner stats
           simscan - install simscan
           simconf - configure simscan
           simtest - run email tests to verify that simscan is working
      spamassassin - install and configure spamassassin
           allspam - activate spam filtering for all users

                     Logs, Statistics, and Monitoring
          maillogs - creates the mail logging directories
               qss - installs qmailscanner stats
           socklog - installs socklog
           isoqlog - installs and configured isoqlog
           rrdutil - installs rrdutil
         supervise - creates the directories to be used by svscan

              test - runs a complete test suite against your server
        filtertest - runs the simscan and qmail-scanner email scanner tests
          authtest - authenticates against pop, imap, and smtp servers
          proctest - check for processes that *should* be running
    imap|pop3|smtp - do authentication test for imap, pop3, or smtp-auth

           toaster - install Mail::Toaster
        mattbundle - install MATT::Bundle
               mrm - install Mysql::Replication
        logmonster - install Apache::Logmonster
           nictool - install nictool (http://www.nictool.com/)
               all - installs everything shown on the toaster INSTALL page

METHODS
   all
             toaster_setup.pl -s all

           a special target that tries to build the entire Mail::Toaster
           without any interaction from you. Unlike other targets, it will
           keep right on going when it encounters an error, getting as much
           built as it possibly can. It is presumed that the administrator
           is logging the output for later review. I use this target
           primarily in testing.

AUTHOR
   Matt Simerson ([email protected])

BUGS
   None known. Report any to author, preferably via RT
   http://rt.cpan.org/Public/Bug/Report.html?Queue=Mail-Toaster

   Patches welcome in "diff -u" format.

TODO
    Add -s dnscache section to install a DNS stub resolver
    Check if daemons are running before installs. - mostly done
    Turn entire process into a ./install_it_all script  - done

SEE ALSO
   The following are all man/perldoc pages:

     Mail::Toaster::Conf
     toaster.conf
     toaster-watcher.conf

     Mail::Toaster
     Mail::Toaster::Apache
     Mail::Toaster::CGI
     Mail::Toaster::DNS
     Mail::Toaster::Darwin
     Mail::Toaster::Ezmlm
     Mail::Toaster::FreeBSD
     Mail::Toaster::Logs
     Mail::Toaster::Mysql
     Mail::Toaster::Passwd
     Mail::Toaster::Perl
     Mail::Toaster::Provision
     Mail::Toaster::Qmail
     Mail::Toaster::Setup
     Mail::Toaster::Utility

     http://mail-toaster.org/
     http://mail-toaster.org/docs/
     http://mail-toaster.org/faq.shtml
     http://mail-toaster.org/changes.shtml

COPYRIGHT
   Copyright (c) 2004-2008, The Network People, Inc. All rights reserved.

   Redistribution and use in source and binary forms, with or without
   modification, are permitted provided that the following conditions are
   met:

   Redistributions of source code must retain the above copyright notice,
   this list of conditions and the following disclaimer.

   Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or other materials provided with the distribution.

   Neither the name of the The Network People, Inc. nor the names of its
   contributors may be used to endorse or promote products derived from
   this software without specific prior written permission.

   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
   IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
   TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
   PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
   OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.