UPGRADE

SAVE COPIES OF YOUR OUTGOING MAIL! Like any other piece of software (and
information generally), the qmail system comes with NO WARRANTY. It's
much more secure and reliable than sendmail, but that's not saying much.


Here's how to upgrade to qmail 1.03. This procedure will overwrite the
old qmail binaries. Furthermore, it may begin delivering messages from
the queue before you have had a chance to test it.


WARNING for upgrades from 1.00 or 1.01: qlist has been split into a
separate package. You can obtain it from http://pobox.com/~djb/qlist.html
if you have any users who need it.

WARNING for upgrades from 1.01: recipientmap is gone. The virtualdomains
mechanism has been expanded to support virtual users.


Before starting, compare conf* to your old conf*, and make any necessary
changes. You can copy conf* from 1.02.


How to install:

 1. Compile the programs and create the formatted man pages:
       # make it man

 2. Inform your users that mail will not be accepted for a few minutes.

 3. Disable deliveries by killing your old qmail-send. Wait for it to
    print ``exiting'' in the log.

 4. Disable SMTP service by commenting out the smtp line in inetd.conf;
    kill -HUP your inetd. (If you are using tcpserver, simply kill -STOP
    your tcpserver. If you are running a QMTP server, disable that too.)
    Wait for current qmail-smtpd processes to die.

 5. Install the new binaries and man pages:
       # make setup check

 6. If your boot scripts are using qmail-start instead of /var/qmail/rc:
    Copy /var/qmail/boot/home to /var/qmail/rc. (Use home+df instead if
    you have installed dot-forward; use proc or proc+df if you are using
    procmail by default for local deliveries.) Compare /var/qmail/rc to
    your qmail-start boot line, and edit /var/qmail/rc if necessary.
    Replace your qmail-start boot line with
            csh -cf '/var/qmail/rc &'

 7. Reenable deliveries:
       # csh -cf '/var/qmail/rc &'

 8. Read TEST.deliver.

 9. Reenable SMTP service by restoring the smtp line in inetd.conf; kill
    -HUP your inetd. (If you are using tcpserver, simply kill -CONT your
    tcpserver. If you are running a QMTP server, reenable that too.)

10. Read TEST.receive.


That's it! To report success:
       % ( echo 'First M. Last'; cat `cat SYSDEPS` ) | mail djb-qst@cr.yp.to
Replace First M. Last with your name.

If you have questions about qmail, join the qmail mailing list; see
http://pobox.com/~djb/qmail.html.