Mail::Toaster::Setup README

- NAME
- SYNOPSIS
- DESCRIPTION

- command line flags

- USAGE
- AUTHOR
- BUGS
- TODO
- SEE ALSO
- COPYRIGHT

# 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.