Hostsharing Wiki - Benutzerbeiträge [de]

Diskussion:Mailman Installieren

2009-06-16T14:59:15Z

Bis00-bjoise:

Sollte die zoopenet Zeile nicht weg?
add_virtualhost('www.zoopnet.de', 'zoopnet.de')

-------------------
da etc/virtusertable leider nicht mehr möglich ist, frage ich mich wie das das anlegen mit hsadmin-mail funktioniert.
z.b. so?

vorher:
mailman@example.com XYZ00-mailman

nachher:
hsadmin --call:emailaddress.add \
--set:localpart=mailman \
--set:domain=example.com \
--set:'target=XYZ00-mailman'

+9x

-> Habe das mal an hsadmin angepasst.

Mailman Installieren

2009-06-16T14:58:12Z

Bis00-bjoise:

{{Baustelle}}

Mailman

== Installation ==

Installationsanleitung für Mailman als Paketadmin 
(aktuell getestet mit 2.1.12)

Bei der hier Dokumentierten Installation haben alle Paketuser Zugriff auf die Mailman Daten. 
Zur Separation von Paketadminrechten und anderen Paketusern wäre es vorzuziehen Mailman in einem Paketuser Account (zentral) zu installieren, der z.B. eine oder mehrere lists.*.* Subdomains aufgeschaltet bekommt.
(Mailman könnte mit Hilfe von Email-Adressen, die auf +Adressen gemappt werden und eine procmail Filterung (http://pm-doc.sourceforge.net/pm-tips.html#using_plus_addressing_foobar) die die Emails entsprechend mailman zuführt, ganz innerhalb der Rechte eines Users realisiert werden.)

Vielen Dank an aller Benutzer die Verbesserungen beisteuern!

=== Sourcen besorgen und entpacken ===
Unter http://www.gnu.org/software/mailman/ die aktuelle Software besorgen.

=== Log-Verzeichnis anlegen ===

xyz00@hopi:~$ mkdir /home/pacs/XYZ00/var/mailman
xyz00@hopi:~$ chmod 02775 /home/pacs/XYZ00/var/mailman

=== Kompilieren ===
braucht einige Optionen, die anzupassen sind:

xyz00@hopi:~$ ./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
--with-python=/opt/python/2.4.5/bin/python2.4

(auf aktuell bei HS installierte python Version achten)

xyz00@hopi:~$ make
xyz00@hopi:~$ make install

=== Datenrechte prüfen ===

Sicherheitshalber die Dateirechte prüfen (und ggf. korrigieren) lassen:

xyz00@hopi:~$ ~/mailman/bin/check_perms -f

== Konfiguration ==

=== mm_cfg.py ===

~/mailman/Mailman/mm_cfg.py editieren.

Folgendes könnte dort z.B. stehen:

...
##################################################
# Put YOUR site-specific settings below this line.
# -*- python -*-

DEFAULT_HOST_NAME = 'www.example.com'
DEFAULT_EMAIL_HOST = 'example.com'
DEFAULT_URL_HOST = 'www.example.com'
add_virtualhost(DEFAULT_URL_HOST, DEFAULT_EMAIL_HOST)

DEFAULT_SERVER_LANGUAGE = 'de'

In ~/mailman/Mailman/Defaults.py seht ihr, was man in mm_cfg.py alles einstellen kann.

=== CGIs kopieren (in alle Domain-Verzeichnisse, die Mailman haben sollen) ===

xyz00@hopi:~$ mkdir ~/doms/example.com/cgi/mailman
xyz00@hopi:~$ cp ~/mailman/cgi-bin/* ~/doms/example.com/cgi/mailman
xyz00@hopi:~$ chmod g-s ~/doms/example.com/cgi/mailman/*

=== .htaccess ===

Dafür sorgen, dass mailman unter /mailman statt /cgi-bin/mailman erreichbar ist. In ~/doms/example.com/subs/www/.htaccess folgendes eintragen:

RewriteEngine On
RewriteRule ^mailman/(.*)$ /cgi-bin/mailman/$1

=== Icons kopieren/verlinken ===

xyz00@hopi:~$ cp -R ~/mailman/icons ~/doms/example.com/subs/www

oder symlinken (spart ein klein wenig Platz)

xyz00@hopi:~$ ln -s ~/mailman/icons ~/doms/example.com/subs/www

=== Passwort setzen ===

xyz00@hopi:~$ ~/mailman/bin/mmsitepass

== Mailinglisten ==

=== Die "mailman site list" Einrichten ===

Die "site list" mit dem Namen "mailman" ist die Mailingliste der lokalen Mailman Administratoren und wird zur einwandfreien Funktion von Mailman benötigt. Einrichten und die Standard Konfigurationsvorgaben dafür laden:

xyz00@hopi:~$ ~/mailman/bin/newlist mailman
Enter the email of the person running the list: admin@xyz00.hostsharing.net
Initial mailman password:
xyz00@hopi:~$ ~/mailman/bin/config_list -i ~/var/mailman/data/sitelist.cfg mailman

=== ~/etc/ virtusertable ===

In die virtusertable müssen nun die Adressen mittels [[hsadmin|hsadmin CLI]] eingerichtet werden.

Beispiel:

hsadmin -c emailaddress.add -s localpart=mailman -s domain=domain.de -s 'target=XYZ00-mailman'
hsadmin -c emailaddress.add -s localpart=mailman-admin -s domain=domain.de -s 'target=XYZ00-mailman-admin'
hsadmin -c emailaddress.add -s localpart=mailman-bounces -s domain=domain.de -s 'target=XYZ00-mailman-bounces'
hsadmin -c emailaddress.add -s localpart=mailman-confirm -s domain=domain.de -s 'target=XYZ00-mailman-confirm'
hsadmin -c emailaddress.add -s localpart=mailman-join -s domain=domain.de -s 'target=XYZ00-mailman-join'
hsadmin -c emailaddress.add -s localpart=mailman-leave -s domain=domain.de -s 'target=XYZ00-mailman-leave'
hsadmin -c emailaddress.add -s localpart=mailman-owner -s domain=domain.de -s 'target=XYZ00-mailman-owner'
hsadmin -c emailaddress.add -s localpart=mailman-request -s domain=domain.de -s 'target=XYZ00-mailman-request'
hsadmin -c emailaddress.add -s localpart=mailman-subscribe -s domain=domain.de -s 'target=XYZ00-mailman-subscribe'
hsadmin -c emailaddress.add -s localpart=mailman-unsubscribe -s domain=domain.de -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!''

=== ~/etc/aliases ===

Die oben zu den Mail-Adressen angegebenen Aliase müssen im nächsten Schritt ebenfalls mit [[hsadmin|hsadmin CLI]] erstellt werden:

Beispiel:

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

=== [[Cron |Crontab]] ===

In die Crontab wird z.B. eingetragen:

* * * * * ~/mailman/bin/qrunner -o -r All
0 * * * * rm -f ~/var/mailman/logs/qrunner

Dies übernimmt die Funktion des qrunner-Dämons, der bei Mailman 2.1.1 normalerweise laufen würde.
Das Logfile wird gelöscht, da es sonst sehr schnell sehr groß wird.
Zusätzlich müssen noch die Cronjobs in ~/mailman/cron/crontab.in angelegt werden.

Administriert wird die Liste nun über http://www.example.com/mailman/admin/<listenname> und entweder dem Listenpasswort oder dem Site-Passwort. Als erstes sollte man die Liste "mailman" selbst abbonieren.

Bis auf das Anwenden der sitelist.cfg können auch alle anderen Listen nach diesem Schema angelegt werden, 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, da die normale Mailmaninstallation mit über 20 MB zu Buche schlägt...

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, da sie ja an anderer Stelle noch vorhanden 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 ==
Man kann seit Mailman 2.x eine Mailman-Installation unter gewissen Einschränkungen für mehrere Domains verwenden. Hier soll kurz gezeigt werden, was geht und wie es geht.

=== Anleitung ===

Als erstes ist wichtig, dass ihr Mailman sagt, für welche Domains Mailinglisten verwaltet werden sollen. Dies tut ihr in der Datei ~/mailman/Mailman/mm_cfg.py:

DEFAULT_EMAIL_HOST = 'example.com'
DEFAULT_URL_HOST = 'www.example.com'
add_virtualhost(DEFAULT_URL_HOST,DEFAULT_EMAIL_HOST)
add_virtualhost('www.zoopnet.de', 'zoopnet.de')

Das bedeutet, dass Mailman per default davon ausgeht, dass alle Listen für die Domain example.com sind.
Die 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.zoopnet.de'), dann benutzt Mailman als Hostpart alles was nach dem ersten Punkt steht, im Beispiel also zoopnet.de

Dann muss man logischerweise das Webfrontend mehrmals installieren.

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@www.example.com

Es ist 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 www.example.com sowohl als URL für das Webfrontend wie auch als Hostpart für Emailadressen verwenet.

Prinzipiell war's das. Man muss die Listeneinträge natürlich immer in die richtige virtusertable eintragen :)

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

= Alte Referenzen =

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

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Mailman]]

Mailman Installieren

2009-06-16T14:07:19Z

Bis00-bjoise:

{{Baustelle}}

Mailman

== Installation ==

Installationsanleitung für Mailman als Paketadmin 
(aktuell getestet mit 2.1.12)

Bei der hier Dokumentierten Installation haben alle Paketuser Zugriff auf die Mailman Daten. 
Zur Separation von Paketadminrechten und anderen Paketusern wäre es vorzuziehen Mailman in einem Paketuser Account (zentral) zu installieren, der z.B. eine oder mehrere lists.*.* Subdomains aufgeschaltet bekommt.
(Mailman könnte mit Hilfe von Email-Adressen, die auf +Adressen gemappt werden und eine procmail Filterung (http://pm-doc.sourceforge.net/pm-tips.html#using_plus_addressing_foobar) die die Emails entsprechend mailman zuführt, ganz innerhalb der Rechte eines Users realisiert werden.)

Vielen Dank an aller Benutzer die Verbesserungen beisteuern!

=== Sourcen besorgen und entpacken ===
Unter http://www.gnu.org/software/mailman/ die aktuelle Software besorgen.

=== Log-Verzeichnis anlegen ===

xyz00@hopi:~$ mkdir /home/pacs/XYZ00/var/mailman
xyz00@hopi:~$ chmod 02775 /home/pacs/XYZ00/var/mailman

=== Kompilieren ===
braucht einige Optionen, die anzupassen sind:

xyz00@hopi:~$ ./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
--with-python=/opt/python/2.4.5/bin/python2.4

(auf aktuell bei HS installierte python Version achten)

xyz00@hopi:~$ make
xyz00@hopi:~$ make install

=== Datenrechte prüfen ===

Sicherheitshalber die Dateirechte prüfen (und ggf. korrigieren) lassen:

xyz00@hopi:~$ ~/mailman/bin/check_perms -f

== Konfiguration ==

=== mm_cfg.py ===

~/mailman/Mailman/mm_cfg.py editieren.

Folgendes könnte dort z.B. stehen:

...
##################################################
# Put YOUR site-specific settings below this line.
# -*- python -*-

DEFAULT_HOST_NAME = 'www.example.com'
DEFAULT_EMAIL_HOST = 'example.com'
DEFAULT_URL_HOST = 'www.example.com'
add_virtualhost(DEFAULT_URL_HOST, DEFAULT_EMAIL_HOST)

DEFAULT_SERVER_LANGUAGE = 'de'

In ~/mailman/Mailman/Defaults.py seht ihr, was man in mm_cfg.py alles einstellen kann.

=== CGIs kopieren (in alle Domain-Verzeichnisse, die Mailman haben sollen) ===

xyz00@hopi:~$ mkdir ~/doms/example.com/cgi/mailman
xyz00@hopi:~$ cp ~/mailman/cgi-bin/* ~/doms/example.com/cgi/mailman
xyz00@hopi:~$ chmod g-s ~/doms/example.com/cgi/mailman/*

=== .htaccess ===

Dafür sorgen, dass mailman unter /mailman statt /cgi-bin/mailman erreichbar ist. In ~/doms/example.com/subs/www/.htaccess folgendes eintragen:

RewriteEngine On
RewriteRule ^mailman/(.*)$ /cgi-bin/mailman/$1

=== Icons kopieren/verlinken ===

xyz00@hopi:~$ cp -R ~/mailman/icons ~/doms/example.com/subs/www

oder symlinken (spart ein klein wenig Platz)

xyz00@hopi:~$ ln -s ~/mailman/icons ~/doms/example.com/subs/www

=== Passwort setzen ===

xyz00@hopi:~$ ~/mailman/bin/mmsitepass

== Mailinglisten ==

=== Die "mailman site list" Einrichten ===

Die "site list" mit dem Namen "mailman" ist die Mailingliste der lokalen Mailman Administratoren und wird zur einwandfreien Funktion von Mailman benötigt. Einrichten und die Standard Konfigurationsvorgaben dafür laden:

xyz00@hopi:~$ ~/mailman/bin/newlist mailman
Enter the email of the person running the list: admin@xyz00.hostsharing.net
Initial mailman password:
xyz00@hopi:~$ ~/mailman/bin/config_list -i ~/var/mailman/data/sitelist.cfg mailman

=== ~/etc/ virtusertable ===

In die virtusertable müssen wir die Adressen zuordnen:

Editor aufrufen:

xyz00@hopi:~$ vi /home/doms/example.com/etc/virtusertable
mailman@example.com XYZ00-mailman
mailman-admin@example.com XYZ00-mailman-admin
mailman-bounces@example.com XYZ00-mailman-bounces
mailman-confirm@example.com XYZ00-mailman-confirm
mailman-join@example.com XYZ00-mailman-join
mailman-leave@example.com XYZ00-mailman-leave
mailman-owner@example.com XYZ00-mailman-owner
mailman-request@example.com XYZ00-mailman-request
mailman-subscribe@example.com XYZ00-mailman-subscribe
mailman-unsubscribe@example.com XYZ00-mailman-unsubscribe

=== ~/etc/aliases ===

Auch die aliases müssen wir ändern:

Editor aufrufen

xyz00@hopi:~$ vi ~/etc/aliases
XYZ00-mailman: "|/home/pacs/XYZ00/mailman/mail/mailman post mailman"
XYZ00-mailman-admin: "|/home/pacs/XYZ00/mailman/mail/mailman admin mailman"
XYZ00-mailman-bounces: "|/home/pacs/XYZ00/mailman/mail/mailman bounces mailman"
XYZ00-mailman-confirm: "|/home/pacs/XYZ00/mailman/mail/mailman confirm mailman"
XYZ00-mailman-join: "|/home/pacs/XYZ00/mailman/mail/mailman join mailman"
XYZ00-mailman-leave: "|/home/pacs/XYZ00/mailman/mail/mailman leave mailman"
XYZ00-mailman-owner: "|/home/pacs/XYZ00/mailman/mail/mailman owner mailman"
XYZ00-mailman-request: "|/home/pacs/XYZ00/mailman/mail/mailman request mailman"
XYZ00-mailman-subscribe: "|/home/pacs/XYZ00/mailman/mail/mailman subscribe mailman"
XYZ00-mailman-unsubscribe: "|/home/pacs/XYZ00/mailman/mail/mailman unsubscribe mailman"

=== [[Cron |Crontab]] ===

In die Crontab wird z.B. eingetragen:

* * * * * ~/mailman/bin/qrunner -o -r All
0 * * * * rm -f ~/var/mailman/logs/qrunner

Dies übernimmt die Funktion des qrunner-Dämons, der bei Mailman 2.1.1 normalerweise laufen würde.
Das Logfile wird gelöscht, da es sonst sehr schnell sehr groß wird.
Zusätzlich müssen noch die Cronjobs in ~/mailman/cron/crontab.in angelegt werden.

Administriert wird die Liste nun über http://www.example.com/mailman/admin/<listenname> und entweder dem Listenpasswort oder dem Site-Passwort. Als erstes sollte man die Liste "mailman" selbst abbonieren.

Bis auf das Anwenden der sitelist.cfg können auch alle anderen Listen nach diesem Schema angelegt werden, 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, da die normale Mailmaninstallation mit über 20 MB zu Buche schlägt...

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, da sie ja an anderer Stelle noch vorhanden 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 ==
Man kann seit Mailman 2.x eine Mailman-Installation unter gewissen Einschränkungen für mehrere Domains verwenden. Hier soll kurz gezeigt werden, was geht und wie es geht.

=== Anleitung ===

Als erstes ist wichtig, dass ihr Mailman sagt, für welche Domains Mailinglisten verwaltet werden sollen. Dies tut ihr in der Datei ~/mailman/Mailman/mm_cfg.py:

DEFAULT_EMAIL_HOST = 'example.com'
DEFAULT_URL_HOST = 'www.example.com'
add_virtualhost(DEFAULT_URL_HOST,DEFAULT_EMAIL_HOST)
add_virtualhost('www.zoopnet.de', 'zoopnet.de')

Das bedeutet, dass Mailman per default davon ausgeht, dass alle Listen für die Domain example.com sind.
Die 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.zoopnet.de'), dann benutzt Mailman als Hostpart alles was nach dem ersten Punkt steht, im Beispiel also zoopnet.de

Dann muss man logischerweise das Webfrontend mehrmals installieren.

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@www.example.com

Es ist 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 www.example.com sowohl als URL für das Webfrontend wie auch als Hostpart für Emailadressen verwenet.

Prinzipiell war's das. Man muss die Listeneinträge natürlich immer in die richtige virtusertable eintragen :)

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

= Alte Referenzen =

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

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Mailman]]

Benutzer:Bis00-bjoise

2009-06-15T12:18:18Z

Bis00-bjoise: Die Seite wurde neu angelegt: Name: Bjoern Seit längerem bei HS am Hosten und immer noch happy. ;)

Name: Bjoern
Seit längerem bei HS am Hosten und immer noch happy. ;)

Mailman Installieren

2009-06-15T12:16:50Z

Bis00-bjoise:

Mailman

== Installation ==

Installationsanleitung für Mailman als Paketadmin 
(aktuell getestet mit 2.1.12)

Bei der hier Dokumentierten Installation haben alle Paketuser Zugriff auf die Mailman Daten. 
Zur Separation von Paketadminrechten und anderen Paketusern wäre es vorzuziehen Mailman in einem Paketuser Account (zentral) zu installieren, der z.B. eine oder mehrere lists.*.* Subdomains aufgeschaltet bekommt.
(Mailman könnte mit Hilfe von Email-Adressen, die auf +Adressen gemappt werden und eine procmail Filterung (http://pm-doc.sourceforge.net/pm-tips.html#using_plus_addressing_foobar) die die Emails entsprechend mailman zuführt, ganz innerhalb der Rechte eines Users realisiert werden.)

Vielen Dank an aller Benutzer die Verbesserungen beisteuern!

=== Sourcen besorgen und entpacken ===
Unter http://www.gnu.org/software/mailman/ die aktuelle Software besorgen.

=== Log-Verzeichnis anlegen ===

xyz00@hopi:~$ mkdir /home/pacs/XYZ00/var/mailman
xyz00@hopi:~$ chmod 02775 /home/pacs/XYZ00/var/mailman

=== Kompilieren ===
braucht einige Optionen, die anzupassen sind:

xyz00@hopi:~$ ./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
--with-python=/opt/python/2.4.5/bin/python2.4

(auf aktuell bei HS installierte python Version achten)

xyz00@hopi:~$ make
xyz00@hopi:~$ make install

=== Datenrechte prüfen ===

Sicherheitshalber die Dateirechte prüfen (und ggf. korrigieren) lassen:

xyz00@hopi:~$ ~/mailman/bin/check_perms -f

== Konfiguration ==

=== mm_cfg.py ===

~/mailman/Mailman/mm_cfg.py editieren.

Folgendes könnte dort z.B. stehen:

...
##################################################
# Put YOUR site-specific settings below this line.
# -*- python -*-

DEFAULT_HOST_NAME = 'www.example.com'
DEFAULT_EMAIL_HOST = 'example.com'
DEFAULT_URL_HOST = 'www.example.com'
add_virtualhost(DEFAULT_URL_HOST, DEFAULT_EMAIL_HOST)

DEFAULT_SERVER_LANGUAGE = 'de'

In ~/mailman/Mailman/Defaults.py seht ihr, was man in mm_cfg.py alles einstellen kann.

=== CGIs kopieren (in alle Domain-Verzeichnisse, die Mailman haben sollen) ===

xyz00@hopi:~$ mkdir ~/doms/example.com/cgi/mailman
xyz00@hopi:~$ cp ~/mailman/cgi-bin/* ~/doms/example.com/cgi/mailman
xyz00@hopi:~$ chmod g-s ~/doms/example.com/cgi/mailman/*

=== .htaccess ===

Dafür sorgen, dass mailman unter /mailman statt /cgi-bin/mailman erreichbar ist. In ~/doms/example.com/subs/www/.htaccess folgendes eintragen:

RewriteEngine On
RewriteRule ^mailman/(.*)$ /cgi-bin/mailman/$1

=== Icons kopieren/verlinken ===

xyz00@hopi:~$ cp -R ~/mailman/icons ~/doms/example.com/subs/www

oder symlinken (spart ein klein wenig Platz)

xyz00@hopi:~$ ln -s ~/mailman/icons ~/doms/example.com/subs/www

=== Passwort setzen ===

xyz00@hopi:~$ ~/mailman/bin/mmsitepass

== Mailinglisten ==

=== Die "mailman site list" Einrichten ===

Die "site list" mit dem Namen "mailman" ist die Mailingliste der lokalen Mailman Administratoren und wird zur einwandfreien Funktion von Mailman benötigt. Einrichten und die Standard Konfigurationsvorgaben dafür laden:

xyz00@hopi:~$ ~/mailman/bin/newlist mailman
Enter the email of the person running the list: admin@xyz00.hostsharing.net
Initial mailman password:
xyz00@hopi:~$ ~/mailman/bin/config_list -i ~/var/mailman/data/sitelist.cfg mailman

=== ~/etc/ virtusertable ===

In die virtusertable müssen wir die Adressen zuordnen:

Editor aufrufen:

xyz00@hopi:~$ vi /home/doms/example.com/etc/virtusertable
mailman@example.com XYZ00-mailman
mailman-admin@example.com XYZ00-mailman-admin
mailman-bounces@example.com XYZ00-mailman-bounces
mailman-confirm@example.com XYZ00-mailman-confirm
mailman-join@example.com XYZ00-mailman-join
mailman-leave@example.com XYZ00-mailman-leave
mailman-owner@example.com XYZ00-mailman-owner
mailman-request@example.com XYZ00-mailman-request
mailman-subscribe@example.com XYZ00-mailman-subscribe
mailman-unsubscribe@example.com XYZ00-mailman-unsubscribe

=== ~/etc/aliases ===

Auch die aliases müssen wir ändern:

Editor aufrufen

xyz00@hopi:~$ vi ~/etc/aliases
XYZ00-mailman: "|/home/pacs/XYZ00/mailman/mail/mailman post mailman"
XYZ00-mailman-admin: "|/home/pacs/XYZ00/mailman/mail/mailman admin mailman"
XYZ00-mailman-bounces: "|/home/pacs/XYZ00/mailman/mail/mailman bounces mailman"
XYZ00-mailman-confirm: "|/home/pacs/XYZ00/mailman/mail/mailman confirm mailman"
XYZ00-mailman-join: "|/home/pacs/XYZ00/mailman/mail/mailman join mailman"
XYZ00-mailman-leave: "|/home/pacs/XYZ00/mailman/mail/mailman leave mailman"
XYZ00-mailman-owner: "|/home/pacs/XYZ00/mailman/mail/mailman owner mailman"
XYZ00-mailman-request: "|/home/pacs/XYZ00/mailman/mail/mailman request mailman"
XYZ00-mailman-subscribe: "|/home/pacs/XYZ00/mailman/mail/mailman subscribe mailman"
XYZ00-mailman-unsubscribe: "|/home/pacs/XYZ00/mailman/mail/mailman unsubscribe mailman"

=== [[Cron |Crontab]] ===

In die Crontab wird z.B. eingetragen:

* * * * * ~/mailman/bin/qrunner -o -r All
0 * * * * rm -f ~/var/mailman/logs/qrunner

Dies übernimmt die Funktion des qrunner-Dämons, der bei Mailman 2.1.1 normalerweise laufen würde.
Das Logfile wird gelöscht, da es sonst sehr schnell sehr groß wird.
Zusätzlich müssen noch die Cronjobs in ~/mailman/cron/crontab.in angelegt werden.

Administriert wird die Liste nun über http://www.example.com/mailman/admin/<listenname> und entweder dem Listenpasswort oder dem Site-Passwort. Als erstes sollte man die Liste "mailman" selbst abbonieren.

Bis auf das Anwenden der sitelist.cfg können auch alle anderen Listen nach diesem Schema angelegt werden, 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, da die normale Mailmaninstallation mit über 20 MB zu Buche schlägt...

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, da sie ja an anderer Stelle noch vorhanden 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 ==
Man kann seit Mailman 2.x eine Mailman-Installation unter gewissen Einschränkungen für mehrere Domains verwenden. Hier soll kurz gezeigt werden, was geht und wie es geht.

=== Anleitung ===

Als erstes ist wichtig, dass ihr Mailman sagt, für welche Domains Mailinglisten verwaltet werden sollen. Dies tut ihr in der Datei ~/mailman/Mailman/mm_cfg.py:

DEFAULT_EMAIL_HOST = 'example.com'
DEFAULT_URL_HOST = 'www.example.com'
add_virtualhost(DEFAULT_URL_HOST,DEFAULT_EMAIL_HOST)
add_virtualhost('www.zoopnet.de', 'zoopnet.de')

Das bedeutet, dass Mailman per default davon ausgeht, dass alle Listen für die Domain example.com sind.
Die 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.zoopnet.de'), dann benutzt Mailman als Hostpart alles was nach dem ersten Punkt steht, im Beispiel also zoopnet.de

Dann muss man logischerweise das Webfrontend mehrmals installieren.

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@www.example.com

Es ist 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 www.example.com sowohl als URL für das Webfrontend wie auch als Hostpart für Emailadressen verwenet.

Prinzipiell war's das. Man muss die Listeneinträge natürlich immer in die richtige virtusertable eintragen :)

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

= Alte Referenzen =

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

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Mailman]]