Mailman Installieren: Unterschied zwischen den Versionen
(Installation als Paketuser) |
(update done) |
||
| Zeile 1: | Zeile 1: | ||
Mailman | Mailman | ||
Version vom 25. Juni 2009, 23:56 Uhr
Mailman
Installation
Installationsanleitung für Mailman als Paketadmin
(zuletzt getestet mit mailman-2.1.12)
Vielen Dank an alle Benutzer die Verbesserungen beisteuern!
Mailman kann als Paketadmin oder Paketuser installiert werden. Wenn er als Paketadmin installiert wird haben jedoch ausnahmslos alle Paketuser direkten Zugriff auf die Mailman Daten, und bei Sicherheitslücken in Mailman könnten potentiell Paketadminrechte übernommen werden.
Zur Separation von Paketadminrechten und anderen Paketusern ist es vorzuziehen Mailman in einem Paketuser Account zu installieren. (Bspw. xyz00-listen) Und diesem separaten User ggf mehrere lists.*.* Subdomains aufzuschalten.
Vorteil der Installation als Paketuser ist, dass nur dieser direkten Zugriff auf die Mailmandaten hat und mailman ohne Paketadminrechte läuft. Während der Emailauslieferung werden (wie immer bei .forward) die Rechte des Zielusers angenommen. (So läuft das auch bei procmail.)
Nachteil der Installation als Paketuser ist lediglich, dass bisher so nicht die Paketdomain mit dem SSL Zertifikat von Hostsharing genutzt werden kann.
Sourcen besorgen und entpacken
Unter http://www.gnu.org/software/mailman/ die aktuelle Software besorgen.
~$ tar -xzvf mailman-2.1.12.tgz
Log-Verzeichnis anlegen
Bei der Installation als Paketadmin:
~$ mkdir var/mailman ~$ chmod 02775 var/mailman
Bei der Installation als Paketuser:
~$ mkdir -p mailman/var ~$ chmod 02775 mailman/var
Kompilieren
braucht einige Optionen, die anzupassen sind.
~$ cd mailman-2.1.12
Bei der Installation als Paketadmin:
~/mailman-2.1.12$ ./configure --prefix=/home/pacs/XYZ00/mailman \
--with-username=XYZ00 \
--with-groupname=XYZ00 \
--with-var-prefix=/home/pacs/XYZ00/var/mailman \
--with-cgi-gid=XYZ00 \
--with-mail-gid=nogroup
(die \ bedeuten, dass alles in eine Zeile gehört, bzw. die Returns nicht interpretiert werden sollen.)
Bei der Installation als Paketuser:
~/mailman-2.1.12$ ./configure --prefix=/home/pacs/XYZ00/users/listen/mailman \
--with-username=XYZ00-listen \
--with-groupname=XYZ00 \
--with-var-prefix=/home/pacs/XYZ00/users/listen/mailman/var \
--with-cgi-gid=XYZ00 \
--with-mail-gid=nogroup
Anschließend:
~/mailman-2.1.12$ make ~/mailman-2.1.12$ make install
Datenrechte prüfen
Sicherheitshalber die Dateirechte prüfen (und ggf. korrigieren) lassen:
~/mailman-2.1.12$ cd .. ~$ mailman/bin/check_perms -f
Konfiguration
mm_cfg.py
Konfigurationsdatei editieren:
~$ nano mailman/Mailman/mm_cfg.py
Beispielkonfiguration für lists.example.com könnte so aussehen:
...
##################################################
# Put YOUR site-specific settings below this line.
# -*- python -*-
DEFAULT_HOST_NAME = 'lists.example.com'
DEFAULT_EMAIL_HOST = 'example.com'
DEFAULT_URL_HOST = 'lists.example.com'
add_virtualhost(DEFAULT_URL_HOST, DEFAULT_EMAIL_HOST)
DEFAULT_SERVER_LANGUAGE = 'de'
DEFAULT_URL_PATTERN = 'http://%s/'
In ~/mailman/Mailman/Defaults.py seht ihr, was man in mm_cfg.py alles einstellen kann.
CGIs in die Domains
CGIs in alle Domain-Verzeichnisse linken, auf denen das Mailman Webfrontend laufen soll.
Beispielsweise:
~$ ln -s mailman/cgi-bin doms/listen.example.com/cgi/mailman
Wenn die Domains bei anderen Usern liegen ggf. kopieren:
~$ mkdir ~/doms/lists.example.com/cgi/mailman ~$ cp mailman/cgi-bin/* ~/doms/lists.example.com/cgi/mailman ~$ chmod g-s ~/doms/example.com/cgi/mailman/*
Icons in die Domains
~$ ln -s mailman/icons doms/lists.example.com/htdocs/
oder kopieren
~$ cp -R mailman/icons doms/lists.example.com/htdocs/
.htaccess
Bei einer extra Mailman Domain dafür sorgen, dass Mailman auch unter lists.example.com statt unter lists.example.com/cgi-bin/mailman erreichbar ist. In ~/doms/lists.example.com/htdocs/.htaccess folgendes eintragen:
RewriteEngine On
RewriteRule ^(.*)$ /cgi-bin/mailman/$1
Wenn Mailman unter der www Domain laufen soll und unter www.example.com/mailman statt www.example.com/cgi-bin/mailman erreichbar sein soll, hilft folgendes in ~/doms/example.com/subs/www/.htaccess:
RewriteEngine On
RewriteRule ^mailman/(.*)$ /cgi-bin/mailman/$1
Passwort setzen
~$ mailman/bin/mmsitepass
Mailinglisten einrichten
Zuerst die "mailman site list" Einrichten
Die "site list" mit dem Namen "mailman" ist die Mailingliste der lokalen Mailman Administratoren. Sie wird zur einwandfreien Funktion von Mailman benötigt.
Neue Liste anlegen:
~$ mailman/bin/newlist mailman Enter the email of the person running the list: admin@xyz00.hostsharing.net Initial mailman password:
Für die "mailman site list" einige Konfigurationsvorgaben laden:
~$ mailman/bin/config_list -i ~/var/mailman/data/sitelist.cfg mailman
(nicht für eigene Listen verwenden)
Email Adressen einrichten
Bei der Installation als Paketuser erfolgt die Einrichtung der Emailadressen per hsadmin (virtusertable) und .forward Dateien. Anlegen mittels hsadmin CLI.
Beispiel für Paketuser XYZ00-listen:
hsadmin -c emailaddress.add -s localpart=mailman -s domain=lists.example.com -s 'target=XYZ00-listen+mailman' hsadmin -c emailaddress.add -s localpart=mailman-admin -s domain=lists.example.com -s 'target=XYZ00-listen+mailman-admin' hsadmin -c emailaddress.add -s localpart=mailman-bounces -s domain=lists.example.com -s 'target=XYZ00-listen+mailman-bounces' hsadmin -c emailaddress.add -s localpart=mailman-confirm -s domain=lists.example.com -s 'target=XYZ00-listen+mailman-confirm' hsadmin -c emailaddress.add -s localpart=mailman-join -s domain=lists.example.com -s 'target=XYZ00-listen+mailman-join' hsadmin -c emailaddress.add -s localpart=mailman-leave -s domain=lists.example.com -s 'target=XYZ00-listen+mailman-leave' hsadmin -c emailaddress.add -s localpart=mailman-owner -s domain=lists.example.com -s 'target=XYZ00-listen+mailman-owner' hsadmin -c emailaddress.add -s localpart=mailman-request -s domain=lists.example.com -s 'target=XYZ00-listen+mailman-request' hsadmin -c emailaddress.add -s localpart=mailman-subscribe -s domain=lists.example.com -s 'target=XYZ00-listen+mailman-subscribe' hsadmin -c emailaddress.add -s localpart=mailman-unsubscribe -s domain=lists.example.com -s 'target=XYZ00-listen+mailman-unsubscribe'
Im Homeverzeichnis des Users XYZ00-listen werden anschließend entsprechende .forward-Dateien angelegt:
echo "|/home/pacs/XYZ00/users/listen/mailman/mail/mailman post mailman" > .forward+mailman echo "|/home/pacs/XYZ00/users/listen/mailman/mail/mailman admin mailman" > .forward+mailman-admin echo "|/home/pacs/XYZ00/users/listen/mailman/mail/mailman bounces mailman" > .forward+mailman-bounces echo "|/home/pacs/XYZ00/users/listen/mailman/mail/mailman confirm mailman" > .forward+mailman-confirm echo "|/home/pacs/XYZ00/users/listen/mailman/mail/mailman join mailman" > .forward+mailman-join echo "|/home/pacs/XYZ00/users/listen/mailman/mail/mailman leave mailman" > .forward+mailman-leave echo "|/home/pacs/XYZ00/users/listen/mailman/mail/mailman owner mailman" > .forward+mailman-owner echo "|/home/pacs/XYZ00/users/listen/mailman/mail/mailman request mailman" > .forward+mailman-request echo "|/home/pacs/XYZ00/users/listen/mailman/mail/mailman subscribe mailman" > .forward+mailman-subscribe echo "|/home/pacs/XYZ00/users/listen/mailman/mail/mailman unsubscribe mailman" > .forward+mailman-unsubscribe
Bei der Installation als Paketadmin XYZ00 erfolgt die Einrichtung hingegen per hsadmin (virtusertable) und hsadmin (aliases) so:
hsadmin -c emailaddress.add -s localpart=mailman -s domain=lists.example.com -s 'target=XYZ00-mailman' hsadmin -c emailaddress.add -s localpart=mailman-admin -s domain=lists.example.com -s 'target=XYZ00-mailman-admin' hsadmin -c emailaddress.add -s localpart=mailman-bounces -s domain=lists.example.com -s 'target=XYZ00-mailman-bounces' hsadmin -c emailaddress.add -s localpart=mailman-confirm -s domain=lists.example.com -s 'target=XYZ00-mailman-confirm' hsadmin -c emailaddress.add -s localpart=mailman-join -s domain=lists.example.com -s 'target=XYZ00-mailman-join' hsadmin -c emailaddress.add -s localpart=mailman-leave -s domain=lists.example.com -s 'target=XYZ00-mailman-leave' hsadmin -c emailaddress.add -s localpart=mailman-owner -s domain=lists.example.com -s 'target=XYZ00-mailman-owner' hsadmin -c emailaddress.add -s localpart=mailman-request -s domain=lists.example.com -s 'target=XYZ00-mailman-request' hsadmin -c emailaddress.add -s localpart=mailman-subscribe -s domain=lists.example.com -s 'target=XYZ00-mailman-subscribe' hsadmin -c emailaddress.add -s localpart=mailman-unsubscribe -s domain=lists.example.com -s 'target=XYZ00-mailman-unsubscribe'
Hinweis: Die e-Mail Adressen und die Targets, welche noch in den Aliasen definiert werden müssen, können von Domain und Mailingliste unterschiedlich sein bzw. müssen bei mehreren identische Listen unterschiedlich sein!
Im nächsten Schritt werden die oben zu den Mail-Adressen angegebenen Aliase mit hsadmin CLI angelegt:
hsadmin -c emailalias.add -s name='XYZ00-mailman' -s 'target="|/home/pacs/XYZ00/mailman/mail/mailman post mailman"' hsadmin -c emailalias.add -s name='XYZ00-mailman-admin' -s 'target="|/home/pacs/XYZ00/mailman/mail/mailman admin mailman"' hsadmin -c emailalias.add -s name='XYZ00-mailman-bounces' -s 'target="|/home/pacs/XYZ00/mailman/mail/mailman bounces mailman"' hsadmin -c emailalias.add -s name='XYZ00-mailman-confirm' -s 'target="|/home/pacs/XYZ00/mailman/mail/mailman confirm mailman"' hsadmin -c emailalias.add -s name='XYZ00-mailman-join' -s 'target="|/home/pacs/XYZ00/mailman/mail/mailman join mailman"' hsadmin -c emailalias.add -s name='XYZ00-mailman-leave' -s 'target="|/home/pacs/XYZ00/mailman/mail/mailman leave mailman"' hsadmin -c emailalias.add -s name='XYZ00-mailman-owner' -s 'target="|/home/pacs/XYZ00/mailman/mail/mailman owner mailman"' hsadmin -c emailalias.add -s name='XYZ00-mailman-request' -s 'target="|/home/pacs/XYZ00/mailman/mail/mailman request mailman"' hsadmin -c emailalias.add -s name='XYZ00-mailman-subscribe' -s 'target="|/home/pacs/XYZ00/mailman/mail/mailman subscribe mailman"' hsadmin -c emailalias.add -s name='XYZ00-mailman-unsubscribe' -s 'target="|/home/pacs/XYZ00/mailman/mail/mailman unsubscribe mailman"'
Hinweis: Die Aliase und die Targets können von Domain und Mailingliste unterschiedlich sein bzw. müssen bei mehreren identische Listen unterschiedlich sein! Des Weiteren ist der Pfad zur Mailman Installation anzupassen.
Cronjobs
In die Crontab wird z.B. eingetragen:
* * * * * ~/mailman/bin/qrunner -o -r All 47 * * * * rm -f ~/var/mailman/logs/qrunner
(Queuebearbeitung alle Minute, löschen der Verarbeitungslogs in der 47ten Minute jeder Std.)
Dies übernimmt die Funktion des qrunner-Dämons, der bei Mailman normalerweise laufen würde. Das Logfile wird gelöscht, da es sonst sehr schnell sehr groß wird.
Zudem müssen noch die Cronjobs aus ~/mailman/cron/crontab.in eingefügt werden.
crontab -l > mycronjobs.tmp cat ~/mailman/cron/crontab.in >> mycronjobs.tmp crontab mycronjobs.tmp
Administriert werden Listen über http://lists.example.com/admin/<listenname> und entweder dem Listenpasswort oder dem Site-Passwort.
Als erstes sollte man die Liste "mailman" selber abbonieren.
Bis auf das Anwenden der sitelist.cfg werden auch alle anderen Listen nach diesem Schema angelegt, oder über das Webinterface.
Das war's. Mailman ist jetzt fertig installiert und müsste sogar funktionieren ;)
Feintuning
Wer will, kann auch noch etwas Platz sparen. Die normale Mailmaninstallation schlägt mit über 20 MB zu Buche...
Mit den folgenden Tips kann man das auf ca. 6 MB reduzieren :)
Es kann natürlich sein, dass ich zuviel lösche, aber bei mir funktioniert's. Wenn ihr also sicher(er) sein wollt, dass euch der Mailman nicht um die Ohren fliegt, macht das nicht!
- ~/mailman/cgi-bin und ~/mailman/icons können gelöscht werden, falls sie an andere Stelle kopiert worden sind.
- In ~/mailman/messages die nicht benötigten Sprachen löschen (bis auf englisch).
- In ~/mailman/templates die nicht benötigten Sprachen löschen (bis auf englisch).
- ~/mailman/tests kann, soweit ich das sehe, komplett gelöscht werden.
- Falls man koreanisch und japanisch nicht braucht, kann man folgendes machen:
- In ~/mailman/bin/paths.py, ~/mailman/cron/paths.py und ~/mailman/scripts/paths.py die Zeilen:
# In a normal interactive Python environment, the japanese.pth and korean.pth # files would be imported automatically. But because we inhibit the importing # of the site module, we need to be explicit about importing these codecs. import japanese # As of KoreanCodecs 2.0.5, you had to do the second import to get the Korean # codecs installed, however leave the first import in there in case an upgrade # changes this. import korean import korean.aliases
auskommentieren.
Dann kann man ~/mailman/pythonlib/japanese, ~/mailman/pythonlib/korean, ~/mailman/pythonlib/korean.pth sowie ~/mailman/pythonlib/lib löschen.
Man kann auch noch die Debug-Informationen aus den binaries strippen:
strip ~/mailman/mail/mailman
strip ~/mailman/cgi-bin/*
strip ~/doms/example.com /cgi/mailman/*
Multidomainfähigkeit
Seit Mailman 2.x kann eine Mailman-Installation unter gewissen Einschränkungen für mehrere Domains verwendet werden. Hier soll kurz gezeigt werden, was geht und wie es geht.
Anleitung
Logischerweise muss das Webfrontend (die CGIs) auf allen Domains installiert werden.
Wenn man nun Mailinglisten mit newlist neu anlegt, muss man den Hostnamen für das Webfontend mit angeben, und zwar so:
~$ mailman/bin/newlist listenname@lists.example.com
Es ist ggf. wichtig, dass in der mm_cfg.py eine entsprechende add_virtualhost-Direktive für www.example.com steht, die der Frontend-URL einen Host-Part für die Mailadressen zuordnet. Ist eine solche Direktive nicht vorhanden, so wird lists.example.com sowohl als URL für das Webfrontend wie auch als Hostpart für Emailadressen verwendet. (Was für separate aufgeschaltete Domains wie z.B. lists.example.com gerade zutrifft.)
Liegt das Frondend nicht auf der Maildomain ist es wichtig, dass ihr Mailman sagt, für welches die zugehörige Maildomain ist. Dies tut ihr in der Datei ~/mailman/Mailman/mm_cfg.py:
Also z.B.
DEFAULT_URL_HOST = 'www.example.com' DEFAULT_EMAIL_HOST = 'lists.example.com' add_virtualhost(DEFAULT_URL_HOST,DEFAULT_EMAIL_HOST)
und
add_virtualhost('www.zoopnet.de', 'listen.zoopnet.de')
Das bedeutet, dass Mailman per default davon ausgeht, dass alle Listen für die Domain example.com sind. Alle weiteren add_virtualhost-Direktiven ordnen einem Hostnamen für das Webfrontend (z.B. www.zoopnet.de) einen Hostpart für die Adresse der Mailinglisten (z.B. zoopnet.de) zu.
Tip von Raimund Specht: Lässt man den zweiten Parameter weg, also schreibt z.B. add_virtualhost('www.example.org'), dann benutzt Mailman als Hostpart alles was nach dem ersten Punkt steht, hier also example.org als Maildomain.
Prinzipiell war's das. Man muss die Listeneinträge natürlich immer in die richtige virtusertable eintragen, und für gleichnamige Mailinglisten auf verschiedenen Domains (mailman@*) verschidene +Ergänzungen bzw. aliase verwenden. :)
Probleme
Verschiedene Listen mit gleichem Namen (also z.B. liste@example1.com und liste@example2.com) sind mit Mailman 2.1 leider nicht möglich.
Tips und Tricks
Listen werden nach Webadressen/Host-Namen Aktualisierung nicht mehr im Web-Interface angezeigt.
Um den Listen den neuen Host-Namen zuzuordnen, kann im /bin Verzeichnis der Mailman Installation der Befehl
./withlist -l -r fix_url <Listen_Name> -v -u <Neue_Url>
genutzt werden. <Listen_Name> - Mailingliste welche bearbeitet werden soll. <Neue_Url> - Neue URL/Webadresse des Webinterfaces.
Weitere Cron-Jobs zur Mailinglisten Verwaltung
Folgende Cronjobs helfen bei der Verwaltung und sind User freundlich:
< In Arbeit >
Referenzen
Lösung zur installation als Domainadmin statt Paketadmin: https://lists.hostsharing.net/archiv/support/2009-June/019414.html
ältere Anleitung für Installation als Dom-Admin: <http://lists.hostsharing.net/archiv/support/2005-January/012426.html>
Laufenlassen mit event:
Download und Doku auf <http://al000.hostsharing.net/mailman/mmhs/>
Die "Mutter der Mailman-Installations-Doku" <http://al000.hostsharing.net/mailman/>
"kleinen Tools" auf http://hs.andreasloesch.de, wobei das 'pac-mm-install' wahrscheinlich nicht aktuell (genug) ist