Skip to content

Latest commit

 

History

History
68 lines (42 loc) · 2.28 KB

UPGRADE.md

File metadata and controls

68 lines (42 loc) · 2.28 KB

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 notqmail 1.08. 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 https://cr.yp.to/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 or 1.03.

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

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

That's it!

If you have questions about qmail, join the qmail mailing list; see https://cr.yp.to/qmail.html.