1 SAVE COPIES OF YOUR OUTGOING MAIL! Like any other piece of software (and

     2 information generally), the qmail system comes with NO WARRANTY. It's

     3 much more secure and reliable than sendmail, but that's not saying much.

     4 

     5 

     6 Here's how to upgrade to qmail 1.03. This procedure will overwrite the

     7 old qmail binaries. Furthermore, it may begin delivering messages from

     8 the queue before you have had a chance to test it.

     9 

    10 

    11 WARNING for upgrades from 1.00 or 1.01: qlist has been split into a

    12 separate package. You can obtain it from http://pobox.com/~djb/qlist.html

    13 if you have any users who need it.

    14 

    15 WARNING for upgrades from 1.01: recipientmap is gone. The virtualdomains

    16 mechanism has been expanded to support virtual users.

    17 

    18 

    19 Before starting, compare conf* to your old conf*, and make any necessary

    20 changes. You can copy conf* from 1.02.

    21 

    22 

    23 How to install:

    24 

    25  1. Compile the programs and create the formatted man pages:

    26        # make it man

    27 

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

    29 

    30  3. Disable deliveries by killing your old qmail-send. Wait for it to

    31     print ``exiting'' in the log.

    32 

    33  4. Disable SMTP service by commenting out the smtp line in inetd.conf;

    34     kill -HUP your inetd. (If you are using tcpserver, simply kill -STOP

    35     your tcpserver. If you are running a QMTP server, disable that too.)

    36     Wait for current qmail-smtpd processes to die.

    37 

    38  5. Install the new binaries and man pages:

    39        # make setup check

    40 

    41  6. If your boot scripts are using qmail-start instead of /var/qmail/rc:

    42     Copy /var/qmail/boot/home to /var/qmail/rc. (Use home+df instead if

    43     you have installed dot-forward; use proc or proc+df if you are using

    44     procmail by default for local deliveries.) Compare /var/qmail/rc to

    45     your qmail-start boot line, and edit /var/qmail/rc if necessary.

    46     Replace your qmail-start boot line with

    47             csh -cf '/var/qmail/rc &'

    48 

    49  7. Reenable deliveries:

    50        # csh -cf '/var/qmail/rc &'

    51 

    52  8. Read TEST.deliver.

    53 

    54  9. Reenable SMTP service by restoring the smtp line in inetd.conf; kill

    55     -HUP your inetd. (If you are using tcpserver, simply kill -CONT your

    56     tcpserver. If you are running a QMTP server, reenable that too.)

    57 

    58 10. Read TEST.receive.

    59 

    60 

    61 That's it! To report success:

    62        % ( echo 'First M. Last'; cat `cat SYSDEPS` ) | mail djb-qst@cr.yp.to

    63 Replace First M. Last with your name.

    64 

    65 If you have questions about qmail, join the qmail mailing list; see

    66 http://pobox.com/~djb/qmail.html.