Mailmaini seadistus Debianis

Allikas: Kuutõrvaja

Sissejuhatus

Järgnevas kirjaldatalse sellise eesmärgi saavutamist

  • ühe Mailman eksempari abil peetakse kolme domeeniga seotud postiloendeid, @lists.loomaaed.tartu.ee, @lists.vagunitehas.tartu.ee, @lists.raudteejaam.tartu.ee
  • MTAna kasutatakse Postfixi, kusjuures mainitud domeene kasutatakse ainult eposti jaoks
  • postiloendite haldusliidesed sh arhiivid on ligipääsetavad aadressidelt https://lists.loomaaed.tartu.ee/listinfo ja /admin, https://lists.vagunitehas.tartu.ee/listinfo ja /admin jne

Kirjeldatud moel kasutusel on üks märkimisväärne piirang, listide nimede vasakud pooled peavad olema unikaalsed, st aadressidele info@lists.loomaaed.tartu.ee ja info@lists.vagunitehas.tartu.ee saadetud kirjad jõuavad välja ühte ja samasse listi.

Mailman tarkvara paigaldamine

Tarkvara paigaldamiseks tuleb öelda

 # apt-get install mailman

Seejärel küsitakse, millistes keeltes soovitakse, et Mailman oleks võimeline kasutajaga suhtlema, eriti puudutab see valik, millistes keeltes saab saata kasutajatele automaatselt genereeritud kirju (nt teated listiga liitumise kohta)

 For each supported language, Mailman stores default language specific texts in /etc/mailman/LANG/ giving
 them conffile like treatment with the help of ucf.  This means approximately 150kB for each supported
 language on the root file system.
 
 If you need a different set of languages at a later time, just run dpkg-reconfigure mailman.
 
 NOTE: Languages enabled on existing mailing lists are forcibly re-enabled when deselected and mailman
 needs at least one language for displaying its messages.

Lisaks mailman paketile paigaldatakse automaatlselt ka Apache veebiserver, kuna tavaliselt toimub Mailmani haldamine üle veebiliidese. Paigaldamise käigus tuleb valida kasutatavad lokaadid, mis tähendab seda, millistes keeltes on võimalik mailmani kasutajaliidest tööle lülitada.

Seejärel teatab installer, et

 Missing site list

 Mailman needs a so-called "site list", which is the list from which password reminders and such 
 are sent out from.  This list needs to be created before mailman will start. To create the list, run
 "newlist mailman" and follow the instructions on-screen. Note that you also need to start mailman after
 that, using /etc/init.d/mailman start.

Mailmani seadistamine

Mailmani listihalduse tarkvara esineb arvutis töötava deemoni kujul ning oluliseks seadistusfailiks on /etc/mailman/mm_cfg.py. Selles tuleks teha sellised muudatused

 MAILMAN_SITE_LIST = 'mailman'
 DEFAULT_URL_PATTERN = 'https://%s/'
 PRIVATE_ARCHIVE_URL = '/private'
 IMAGE_LOGOS         = '/images/mailman/'
 DEFAULT_EMAIL_HOST = 'lists.loomaaed.tartu.ee'
 DEFAULT_URL_HOST   = 'lists.loomaaed.tartu.ee'
 add_virtualhost(DEFAULT_URL_HOST, DEFAULT_EMAIL_HOST)
 DEFAULT_SERVER_LANGUAGE = 'en'
 USE_ENVELOPE_SENDER    = 0              # Still used?
 DEFAULT_SEND_REMINDERS = 0
 MTA=None
 DEB_LISTMASTER = 'listmaster@lists.loomaaed.tartu.ee'

Kui Mailman on seadistatud, siis tuleb tekitada esimene list

 # newlist mailman mart@loomaaed.tartu.ee parool

Seejärel saab listserveri deemoni käivitada

 # /etc/init.d/mailman start

Apache veebiserveri seadistamine

Ülidselt tuleb veebiserver seadistada käima aadressidel

tavalisel moel. Mailmanile spetsiifilise osa kohta on toodud näide failis

 /etc/mailman/apache.conf

Kokkuvõttes võiks olla lists.loomaaed.tartu.ee virtuaalhosti seadistusfail nt sellise sisuga

 <VirtualHost 10.0.6.221:443>
   ServerName  lists.loomaaed.tartu.ee
   ServerAdmin mart@loomaaed.tartu.ee
   DocumentRoot /srv/www
   ErrorLog     /var/log/apache2/lists.loomaaed.tartu.ee-ssl-error.log
   TransferLog  /var/log/apache2/lists.loomaaed.tartu.ee-ssl-access.log
 
   SSLEngine on
   SSLCertificateFile /etc/apache2/serdid/lists.loomaaed.tartu.ee-200706-200906.crt
   SSLCertificateKeyFile /etc/apache2/serdid/lists.loomaaed.tartu.ee-200706-200906.key
   SSLCACertificateFile /etc/apache2/serdid/ca-sk.crt
   
   <Directory /srv/www>
     Options All
     AllowOverRide None
     Order Allow,Deny
     Allow from All
   </Directory>
   
   RewriteEngine On
   RewriteRule ^/$ https://lists.loomaaed.tartu.ee/listinfo [R]
 
   Alias /pipermail/ /var/lib/mailman/archives/public/
   Alias /images/mailman/ /usr/share/images/mailman/
   ScriptAlias / /usr/lib/cgi-bin/mailman/
  
   <Directory /usr/lib/cgi-bin/mailman/>
     AllowOverride None
     Options ExecCGI
     AddHandler cgi-script .cgi
     Order allow,deny
     Allow from all
   </Directory>
 
   <Directory /var/lib/mailman/archives/public/>
     Options Indexes FollowSymlinks
     AllowOverride None
     Order allow,deny
     Allow from all
   </Directory>
  
   <Directory /usr/share/images/mailman/>
     AllowOverride None
     Order allow,deny
     Allow from all
   </Directory>
 
 </VirtualHost>

Postfixi seadistamine

Kui kogu domeeni eposti kasutus on seotud postiloendiga ja ainult postiloendiga, siis saab seadistada Postfixi käima lihtsustatud kujul ja otsekohesemalt. Muu hulgas tähendab see seda, et ei pea kasutama aliases'eid.

Sellisel juhul tuleb

  • kasutada /etc/postfix/main.cf failis
 relay_domains = ... lists.loomaaed.tartu.ee, lists.vagunitehas.tartu.ee, lists.raudteejaam.tartu.ee
 transport_maps = hash:/etc/postfix/transport
 mailman_destination_recipient_limit = 1
  • kasutada /etc/postfix/master.cf failis
 mailman unix  -       n       n       -       -       pipe
 flags=FR user=list 
 argv=/var/lib/mailman/bin/postfix-to-mailman.py ${nexthop} ${mailbox}
  • kasutada /etc/postfix/transport failis
 lists.loomaaed.tartu.ee     mailman:
 lists.vagunitehas.tartu.ee  mailman:
 lists.raudteejaam.tartu.ee  mailman:
  • kasutada /etc/mailman/mm_cfg.py failis
 MTA = None # No MTA alias processing required
 DEB_LISTMASTER = 'postmaster@loomaaed.tartu.ee'

ning lisaks olemasolevatele ridadele

 # Default domain for email addresses of newly created MLs
 DEFAULT_EMAIL_HOST = 'lists.loomaaed.tartu.ee'
 #-------------------------------------------------------------
 # Default host for web interface of newly created MLs
 DEFAULT_URL_HOST   = 'lists.loomaaed.tartu.ee'
 #-------------------------------------------------------------
 # Required when setting any of its arguments.
 add_virtualhost(DEFAULT_URL_HOST, DEFAULT_EMAIL_HOST)

kaks rida

 add_virtualhost('lists.vagunitehas.tartu.ee','lists.vagunitehas.tartu.ee')
 add_virtualhost('lists.raudteejaam.tartu.ee','lists.raudteejaam.tartu.ee')

Mailmanile peale paigaldamist uue keele toe lisamine

Kuigi veebipõhise kasutajaliidese abil on võimalik valida terve hulga keelte seast, millises keeles Mailman kasutajaga suhtleb, toimib ta täieliselt, st nii veebiliides kui automaatselt kasutajatele saadetavad kirjad ainult neis keeltes, mis asuvad /etc/mailman kataloogis. Nt eesti keele puhul peab seal olema kataloog

 /etc/mailman/et

Nende kataloogide tekitamiseks tuleb öelda soovitavalt töötava Mailmani tingimustes

 # dpkg-reconfigure mailman

Seejärel esitatakse kasutajale diagloog

 For each supported language, Mailman stores default language specific texts in /etc/mailman/LANG/ giving
 them conffile like treatment with the help of ucf. This means approximately 150kB for each supported
 language on the root file system. If you need a different set of languages at a later time, just run
 dpkg-reconfigure mailman.                                        | 
  
 NOTE: Languages enabled on existing mailing lists are forcibly re-enabled when deselected and mailman needs
 at least one language for displaying its messages.
 
 Languages to support:
 ...

dpkg-reconfigure käivitab automaatselt Mailmani protsessid.

Mailmani uuendamine 2.1.5 -> 2.1.11

Kuigi antud juhul on tegu konkreetse versiooniuuenduse kirjeldusega võib saada siit ideid ka muudeks juhtumiteks. Abiks materjal konkreetseks juhtumiks on www.list.org pealt kopeeritud tar.gz arhiivis UPGRADE failis.

Sammud

  • Vana ja uus listimootor käivad erinevates arvutites ja mõlema töö lõpetada.
  • Kopeerida arhiivid kataloogist /var/lib/mailman/archives ümber uude kohta.
  • Kopeerida listide seadistused kataloogist /var/lib/mailman/lists/listinimi uude kohta.
  • Kopeerida ajutiselt peatatud failid /var/lib/mailman/data/heldmsg-* ümber uude kohta.
  • Käivitada uues kohas listimootor ja veenduda veebipõhises haldusliideses, et seadistused on tulnud ilusti üle, uurida logi.