nightmaremail

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs

UPGRADE.md (2339B)


      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 notqmail 1.08. 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 <https://cr.yp.to/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 or 1.03.
     21 
     22 
     23 How to install:
     24 
     25  1. Compile the programs and create the formatted man pages:
     26 
     27     `# make it man`
     28 
     29  2. Inform your users that mail will not be accepted for a few minutes.
     30 
     31  3. Disable deliveries by killing your old qmail-send. Wait for it to
     32     print "exiting" in the log.
     33 
     34  4. Disable SMTP service by commenting out the smtp line in inetd.conf;
     35     kill -HUP your inetd. (If you are using tcpserver, simply kill -STOP
     36     your tcpserver. If you are running a QMTP server, disable that too.)
     37     Wait for current qmail-smtpd processes to die.
     38 
     39  5. Install the new binaries and man pages:
     40 
     41     `# make setup check`
     42 
     43  6. If your boot scripts are using qmail-start instead of /var/qmail/rc:
     44     Copy /var/qmail/boot/home to /var/qmail/rc. (Use home+df instead if
     45     you have installed dot-forward; use proc or proc+df if you are using
     46     procmail by default for local deliveries.) Compare /var/qmail/rc to
     47     your qmail-start boot line, and edit /var/qmail/rc if necessary.
     48     Replace your qmail-start boot line with
     49 
     50     `csh -cf '/var/qmail/rc &'`
     51 
     52  7. Reenable deliveries:
     53 
     54     `# csh -cf '/var/qmail/rc &'`
     55 
     56  8. Read TEST.deliver.md.
     57 
     58  9. Reenable SMTP service by restoring the smtp line in inetd.conf; kill
     59     -HUP your inetd. (If you are using tcpserver, simply kill -CONT your
     60     tcpserver. If you are running a QMTP server, reenable that too.)
     61 
     62 10. Read TEST.receive.md.
     63 
     64 
     65 That's it!
     66 
     67 If you have questions about qmail, join the qmail mailing list; see
     68 <https://cr.yp.to/qmail.html>.