16 MAR 1999
This documents describes how to upgrade from earlier versions of
ezmlm-idx/mod. For upgrades from ezmlm-0.53, see INSTALL.idx. For detains on changes see CHANGES.idx.
This file is for upgrading from earlier version of ezmlm-idx/mod. If you use
ezmlm-0.53 but have not installed a previous version of ezmlm-idx,
see INSTALL.idx. For details on changes see CHANGES.idx.
- Proceed as per INSTALL.idx.
- If your old lists use SENDER restriction on posts with aliases (DIR/extra)
and blacklisted addresses (DIR/blacklist) you need to change the name of
these directories to DIR/allow and DIR/deny, respectively, and rebuild the list
(see below). Without this change the list will still function normally, but
addresses cannot be added/removed from these addresses remotely (e.g. via
list-allow-subscribe). Other than this, your lists will function without
modifications if you are upgrading from ezmlm-idx>=0.30.
ezmlmrc is upgraded from ezmlm-idx-0.31x, but the changes are not required
for using the list.
- The changes from ezmlm-0.30x are minimal, but fix a couple of bugs, see
CHANGES.idx). If you have custom ezmlmrc files and wish to update them,
do the following:
Any existing list can be edited with 'ezmlm-make -e dir dot local host code]'
with the appropriate switches to take advantage of new ezmlm functions. If
you make ezmlmrc files in other languages, please make them public domain and
mail them to
- First create a diff between the old ezmlmrc distribution and the
custom ezmlmrc file:
% cp /usr/local/bin/ezmlm/ezmlmrc ~/ezmlmrc.orig
% cp ~/.ezmlmrc ~/ezmlmrc
% diff -c ~/ezmlmrc.orig ~/ezmlmrc ~/ezmlmrc.diff
- Next, apply the changes to the new ezmlmrc:
% cp .../ezmlm-idx-0.313/ezmlmrc ~/ezmlmrc
% patch ~/ezmlmrc < ~/ezmlmrc.diff
- Next check for rejected parts (you need to apply them manually):
% cat ~/ezmlmrc.rej
email@example.com for inclusion in future versions of
That's it! To report success (this helps to track platform-specific problems):
Replace First M. Last with your name.
Send bugs reports, ideally with patch, to
% ( echo 'First M. Last'; cat `cat SYSDEPS` )
| mail firstname.lastname@example.org
email@example.com at any time.
Additional steps required when upgrading from ezmlm-idx<0.30:
- Adjust the name of the extra databases:
% mv DIR/extra DIR/allow
% mv DIR/blacklist DIR/deny
% ezmlm-make -+ DIR
- Reindex the subject index for existing lists:
for each list directory 'DIR'.
% ezmlm-idx DIR
- For existing digest lists, assuming the list "joe-sos" and the digest list
The digest list bounce info will be lost, as the key used for the new
digest is the same as for the list, and different for that from the old
digest. At worst, this will make the info for a digest user on missed
digests incomplete. It may also slightly delay the removal
of a permanently bouncing subscriber addresses.
- Remove links to the digest list:
% rm -f ~joe/.qmail-sos-digest*
- edit the main list to include a digest list:
where 'xxx' are switches used in creating the original list. For lists
created with ezmlm-idx-0.23 or later, the arguments after the list
directory may be omitted.
% ezmlm-make -edxxx ~joe/SOS ~joe/.qmail joe-sos id.com gaga
- Move the digest subscriber info:
% mv ~joe/SOS-digest/subscribers/* ~joe/SOS/digest/subscribers
Additional steps required when upgrading subscription-moderated lists
created with ezmlm-idx<0.23:
- If you have subscription moderated lists created with ezmlm-idx<0.23,
they likely lack dir/text/mod-sub-confirm and dir/text/mod-unsub-confirm.
Ezmlm-idx-0.23 substituted dir/text/(un)sub-confirm if the above files were
missing, but ezmlm-idx>=0.30 will not work without these files. Again,
ezmlm-make -e is the easiest way to update the list. Alternatively,r
just copy dir/text/(un)sub-confirm to dir/text/mod-(un)sub-confirm.