mdw@git.distorted.org.uk Git - qmail/blob - UPGRADE

   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.