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