NAME

toaster_setup.pl - Everything you need to build a mail toaster except a computer

SYNOPSIS

To build a great mail system, install FreeBSD (latest stable), and follow the directions on the toaster page (see URL below).

DESCRIPTION

A complete set of instructions for building a mail toaster are on the toaster install page. There is actually quite a bit of documenation available for the "Matt Style" toaster. Much of it is readable via "perldoc Mail::Toaster", and all the subsequent pages. Don't forget to read the Install, Configure, and FAQ pages on the web site. If you still have questions, the mailing list archives are browseable and searchable for your convenience.

http://www.tnpi.biz/internet/mail/toaster/

command line flags

toaster_setup.pl can be passed several flags. -s [ section ] - run without a parameter to see the available options -d [ debug ] - enabled (very) verbose debugging output -a [ action ] - default action is "install".

An -a upgrade option is planned.

USAGE

toaster_setup.pl -s [ section ] [-debug]

         pre - installs a list of programs and libraries other toaster components need
       ports - updates your ports tree, installs the pkg_* tools
     sources - update your FreeBSD sources (/usr/src)
       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
       ucspi - install ucspi w/MySQL patch
       ezmlm - install EzMLM idx
    vpopmail - installs vpopmail
   vpeconfig - configure ~vpopmail/etc/tcp.smtp
   vpopmysql - run the vpopmail MySQL grant and db create commands
       qmail - installs qmail with toaster patches
   qmailconf - configure various /var/qmail/control/* files
    netqmail - installs netqmail 
  qmailadmin - installs qmailadmin
   sqwebmail - installs sqwebmail (webmail app)
     courier - installs courier imap & pop3 daemons
squirrelmail - installs squirrelmail (webmail app)
      filter - installs SpamAssassin, ClamAV, DCC, razor, and more
      clamav - installs just ClamAV
qmailscanner - installs Qmail-Scanner & qmailscanner stats
         qss - installs qmailscanner stats
   supervise - creates the directories to be used by svscan
    maillogs - creates the mail logging directories
     rrdutil - installs rrdutil
  mattbundle - install MATT::Bundle
     toaster - install Mail::Toaster
     socklog - installs socklog
         all - installs everything shown on the toaster INSTALL page

AUTHOR

Matt Simerson <matt@tnpi.biz>

BUGS

None known. Report any to author.

TODO

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

SEE ALSO

Mail::Toaster::CGI, Mail::Toaster::DNS, Mail::Toaster::Logs, Mail::Toaster::Qmail, toaster.conf Mail::Toaster::Setup, Mail::Toaster::Conf, toaster-watcher.conf

http://matt.simerson.net/computing/mail/toaster/
http://matt.simerson.net/computing/mail/toaster/faq.shtml
http://matt.simerson.net/computing/mail/toaster/changelog.shtml

COPYRIGHT

Copyright (c) 2004, 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.