debian/rules: Use `git' potty wrapper.
[qmail] / UPGRADE
... / ...
CommitLineData
1SAVE COPIES OF YOUR OUTGOING MAIL! Like any other piece of software (and
2information generally), the qmail system comes with NO WARRANTY. It's
3much more secure and reliable than sendmail, but that's not saying much.
4
5
6Here's how to upgrade to qmail 1.03. This procedure will overwrite the
7old qmail binaries. Furthermore, it may begin delivering messages from
8the queue before you have had a chance to test it.
9
10
11WARNING for upgrades from 1.00 or 1.01: qlist has been split into a
12separate package. You can obtain it from http://pobox.com/~djb/qlist.html
13if you have any users who need it.
14
15WARNING for upgrades from 1.01: recipientmap is gone. The virtualdomains
16mechanism has been expanded to support virtual users.
17
18
19Before starting, compare conf* to your old conf*, and make any necessary
20changes. You can copy conf* from 1.02.
21
22
23How 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
5810. Read TEST.receive.
59
60
61That's it! To report success:
62 % ( echo 'First M. Last'; cat `cat SYSDEPS` ) | mail djb-qst@cr.yp.to
63Replace First M. Last with your name.
64
65If you have questions about qmail, join the qmail mailing list; see
66http://pobox.com/~djb/qmail.html.