Mailing lists are provided using Ecartis.
Lists can be adminstered either by e-mail or by using the web interface (if that is configured for the domain).
Reasonable internal documentation is provided by the e-mail interface. This can be retrieved by sending mail to ecartis@lists.projectcolo.org.uk with the text:
help
flags
commands
in the body of the mail.
To configure a new list for an existing domain run:
/usr/lib/ecartis/ecartis -config <domain>.cfg -newlist <listname>
where <domain> is a previously configured domain and answer the prompt for the initial mailing list admin. A set of aliases will be output to stdout: these can safely be ignored. An extensively commented default configuration will be written for the list - all further configuration may be performed using the admin interface.
Ecartis on kerouac is configured to handle all mail for a domain. Therefore if you have a domain registered any mailing lists for that domain will have to use a subdomain - for example, the projectcolo lists are all @lists.projectcolo.org.uk. Aliases in the main domain may be used if that is convenient. Throughout this section "domain" refers to the subdomain with the lists.
To add a new domain to the Ecartis configuration create /etc/ecartis/<doman>.cfg by copying one of the existing configurations then editing it to taste.
This domain should then be registered with Postfix by adding a line in the form:
<domain> ecartis:
to /etc/ecartis/transport and running postmap /etc/ecartis/transport. Once this is done the domain will be operational and the primary MX record for the domain can be pointed at kerouac.
To activate the web administration interface for the domain the A record for the list domain should be pointed at 80.71.3.114 and a stanza should be added to the Apache configuration in the form:
<VirtualHost 80.71.3.114:80>
ServerName <domain>
DocumentRoot /home/vhosts/<domain>/html
ScriptAlias /cgi-bin/ /home/vhosts/<domain>/cgi-bin/
</VirtualHost>
and the script lsg2.cgi should be created in the cgi-bin directory. It should contain:
#!/bin/sh
/usr/lib/ecartis/ecartis -config <domain>.cfg -lsg2
The rest of the domain may be configured as desired but that CGI must be there with that name. The admin interface can then by entered at /cgi-bin/lsg2.cgi.