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 (matt@tnpi.net)

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.

