Mailmaini seadistus Debianis - Redigeerimiste ajalugu

Jj – 10. september 2009, kell 11:39

2009-09-10T11:39:33Z

←Vanem redaktsioon		Redaktsioon: 10. september 2009, kell 11:39
124. rida:		124. rida:

	</VirtualHost>		</VirtualHost>

	~~Kontrolliks sobib proovida logida sisse veebipõhisesse haldusliidesesse kasutades mailman listi parooli, kasutajanime ei pea sisestama.~~

	~~[[Pilt:Mailman-1.gif]]~~

	===Postfixi seadistamine===		===Postfixi seadistamine===

Jj – 10. september 2009, kell 11:20

2009-09-10T11:20:53Z

@@ 173. rida: / 173. 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===

Jj – 10. september 2009, kell 10:03

2009-09-10T10:03:53Z

←Vanem redaktsioon		Redaktsioon: 10. september 2009, kell 10:03
1. rida:		1. rida:
	===Sissejuhatus===		===Sissejuhatus===

	~~Mailman (ingl. k. postiljon) http://www.list.org/ on postiloendite (ingl. k. list) pidamise tarkvara.~~

	Järgnevas kirjaldatalse sellise eesmärgi saavutamist		Järgnevas kirjaldatalse sellise eesmärgi saavutamist

Jj: Uus lehekülg: ===Sissejuhatus=== Mailman (ingl. k. postiljon) http://www.list.org/ on postiloendite (ingl. k. list) pidamise tarkvara. Järgnevas kirjaldatalse sellise eesmärgi saavutamist * ü...

2009-09-10T10:03:40Z

Uus lehekülg: ===Sissejuhatus=== Mailman (ingl. k. postiljon) http://www.list.org/ on postiloendite (ingl. k. list) pidamise tarkvara. Järgnevas kirjaldatalse sellise eesmärgi saavutamist * ü...

Uus lehekülg

===Sissejuhatus===

Mailman (ingl. k. postiljon) http://www.list.org/ on postiloendite (ingl. k. list) pidamise tarkvara.

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

* https://lists.loomaaed.tartu.ee/
* https://lists.vagunitehas.tartu.ee/
* https://lists.raudteejaam.tartu.ee/

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>

Kontrolliks sobib proovida logida sisse veebipõhisesse haldusliidesesse kasutades mailman listi parooli, kasutajanime ei pea sisestama.

[[Pilt:Mailman-1.gif]]

===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')

===Mailmani haldamine===

* Listimootori adminstraatori parooli muutmiseks tuleb öelda

# mmsitepass uusparool

Olulised failid asuvad kataloogis /var/lib/mailman

lrwxrwxrwx 1 root root 24 Feb 10 09:53 Mailman -> /usr/lib/mailman/Mailman
drwxrwsr-x 4 root list 4096 Feb 10 09:53 archives
lrwxrwxrwx 1 root root 20 Feb 10 09:53 bin -> /usr/lib/mailman/bin
lrwxrwxrwx 1 root root 24 Feb 10 09:53 cgi-bin -> /usr/lib/cgi-bin/mailman
lrwxrwxrwx 1 root root 21 Feb 10 09:53 cron -> /usr/lib/mailman/cron
drwxrwsr-x 2 root list 4096 Feb 10 22:58 data
lrwxrwxrwx 1 root root 25 Feb 10 09:53 icons -> /usr/share/images/mailman
drwxrwsr-x 5 root list 4096 Feb 11 01:04 lists
lrwxrwxrwx 1 root root 17 Feb 10 09:53 locks -> /var/lock/mailman
lrwxrwxrwx 1 root root 16 Feb 10 09:53 logs -> /var/log/mailman
lrwxrwxrwx 1 root root 21 Feb 10 09:53 mail -> /usr/lib/mailman/mail
drwxr-sr-x 37 root list 4096 Feb 10 09:53 messages
lrwxrwxrwx 1 root root 26 Feb 10 09:53 pythonlib -> /usr/lib/mailman/pythonlib
drwxrwsr-x 11 list list 4096 Feb 10 10:57 qfiles
lrwxrwxrwx 1 root root 24 Feb 10 09:53 scripts -> /usr/lib/mailman/scripts
drwxrwsr-x 2 root list 4096 Jan 26 21:52 spam
lrwxrwxrwx 1 root root 12 Feb 10 09:53 templates -> /etc/mailman
drwxrwsr-x 4 root list 4096 Feb 10 09:53 tests

* /etc/mailman - muu hulgas paigaldatud keeled (milles saadetakse kasutajatele teavitusi jms)
* lists/test/config.pck - listi test seadistusfail
* data/adm.pw - listimootori superuseri parool
* archives - listide arhiivid

Listi moodustamiseks tuleb öelda

# newlist listinime@domeeninimi halduri@epostiaadress halduriparool

Listi seadistuse saab esitada tekstilisel kujul öeldes

# config_list -o - listinimi

Uue listi juures võiks pöörata tähelepanu sellistele määratlustele

General Options

* real_name - listi nimi, kasutatakse listi aadressis, vasakul @ märki ja reeglina näidatakse listi tekitamisel
* owner - listi halduri aadress, sinna saadab listimootor erinevaid automaatselt genereeritud teateid
* respond_to_post_request - kas listimootor saadab listi kirja saatnud kasutajale tagasi kirja teatega kui tema kirja modereeritakse, soovitav väärtus on No, et internetti mitte risustada
* max_message_size - listimootori poolt töödeldava kirja maksimaalne suurus, ehk on tänapäeval 8M sobiv kui rahvas saadab ka kirja lisasid

Passwords

* listi haldusi ja moderaatori paroolide määramine

Membership management

* Listi liikmete lisamine, eemaldamine jm haldus

Privacy Options -> Subscription rules

* advertised - määrab, kas listi nimi esineb listserveri listide nimekirjas aadressil https://lists.loomaaed.tartu.ee/admin/listinimi, võiks valida No, et mitte liigselt tähelepanu tõmmata
* subscribe_policy - määrab, mis tingimustel saab tekkida listi uus kasutaja, soovitav on Confirm and approve, et vaikselt ei saaks huvilised ennast ise listi lisada

Archival options

* archive - määrab, kas listi kirjad arhiveeritakse listserveris
* archive_private - määrab, kas listi arhiiv on avalik või privaatne, kusjuures privaatne tähendab, et arhiivi saavad näha vaid listi kasutajad ja nad peavad enda veebiliideses autentima, soovitav valida private

Nö ühe domeeni listide nimekirja esitamiseks tuleb öelda

# list_lists -V lists.raudteejaam.tartu.ee

* Liste eemaldamine toimub öeldes, kusjuures listi aadress on listinimi@lists.loomaaed.tartu.ee

# rmlist listinimi

Kui lisaks kasutada võtit -a rmlist käsu järel, siis eemaldatakse ka kogunenud listi arhiivid.

Listi kõigi seadistusparameetrite esitamiseks tuleb küsida seda otse seadistusfailist, nt listi test puhul

$ cd /var/lib/mailman/lists/test
$ /usr/lib/mailman/bin/dumpdb config.pck | less

===Mailmani logi===

Mailmani protsessid logivad oma tegevusi sellistesse failidesse

/var/log/mailman# ls -l
total 72
-rw-rw-r-- 1 list list 83 Feb 12 12:04 bounce
-rw-rw-r-- 1 root list 16860 Feb 12 17:35 error
-rw-rw-r-- 1 list list 1972 Feb 12 18:06 post
-rw-rw-r-- 1 list list 729 Feb 12 06:25 qrunner
-rw-rw-r-- 1 list list 2549 Feb 12 18:17 smtp
-rw-rw-r-- 1 www-data list 753 Feb 12 01:43 subscribe
-rw-rw-r-- 1 list list 1140 Feb 12 18:17 vette

Listserveri MTA + listimootori läbimisel tekivad kirjast Postfixi logisse sellised sissekanded

Feb 10 23:05:58 smtp2a postfix/smtpd[28944]: connect from moraal.auul[192.168.2.38]
Feb 10 23:05:58 smtp2a postfix/smtpd[28944]: E57443E4EC: client=moraal.auul[192.168.2.38]
Feb 10 23:05:59 smtp2a postfix/cleanup[28947]: E57443E4EC: message-id=<alpine.DEB.1.10.0902102305480.2613@moraal.auul>
Feb 10 23:05:59 smtp2a postfix/qmgr[25982]: E57443E4EC: from=<mart@loomaaed.tartu.ee>, size=523, nrcpt=1 (queue active)
Feb 10 23:05:59 smtp2a postfix/smtpd[28944]: disconnect from moraal.auul[192.168.2.38]
Feb 10 23:05:59 smtp2a postfix/pipe[28998]: E57443E4EC: to=<test@lists.loomaaed.tartu.ee>, relay=mailman, delay=0.3, delays=0.1/0/0/0.2, \
dsn=2.0.0, status=sent (delivered via mailman service)
Feb 10 23:05:59 smtp2a postfix/qmgr[25982]: E57443E4EC: removed
Feb 10 23:05:59 smtp2a postfix/smtpd[28944]: connect from localhost.localdomain[127.0.0.1]
Feb 10 23:05:59 smtp2a postfix/smtpd[28944]: E2F1E3E4EC: client=localhost.localdomain[127.0.0.1]
Feb 10 23:05:59 smtp2a postfix/cleanup[28947]: E2F1E3E4EC: message-id=<alpine.DEB.1.10.0902102305480.2613@moraal.auul>
Feb 10 23:05:59 smtp2a postfix/qmgr[25982]: E2F1E3E4EC: from=<test-bounces@lists.loomaaed.tartu.ee>, size=1445, nrcpt=1 (queue active)
Feb 10 23:05:59 smtp2a postfix/smtpd[28944]: disconnect from localhost.localdomain[127.0.0.1]
Feb 10 23:06:00 smtp2a postfix/smtp[28995]: E2F1E3E4EC: to=<priit@loomaaed.ee>, relay=mail.loomaaed.tartu.ee[192.168.96.138]:25, \
delay=0.11, delays=0.01/0/0.04/0.06, dsn=2.0.0, status=sent (250 2.0.0 Ok: queued as 906E42CB28)
Feb 10 23:06:00 smtp2a postfix/qmgr[25982]: E2F1E3E4EC: removed

Logist on ilusti näha süsteemi modulaarsus

* esmalt võetakse kiri vastu smtpd poolt
* seejärel antakse kiri edasi pipe abil mailmanile
* mailman pöördud smtpd poole ja kiri saadetakse süsteemist välja

===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.