Hostsharing Wiki - Benutzerbeiträge [de]

Diskussion:Ecartis Installieren

2010-03-04T13:07:40Z

Chg00: Neuer Abschnitt /* Einrichtung OK */

Ich hoffe, das tut's jetzt so.

== Einrichtung OK ==

Ja habe es erfoglreich durchgeführt.

--[[Benutzer:Chg00|Chg00]] 14:07, 4. Mär. 2010 (CET)

Ecartis Installieren

2010-03-04T12:59:37Z

Chg00: - durch + ersetzt bei moderators@example.com und admin@example.com

== Mailinglisten mit ecartis ==

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing EMail-Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME
mkdir $HOME/ecartis/queue

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^X-Original-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von Aliases.

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^X-Original-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^X-Original-To: testmailingliste\+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^X-Original-To: testmailingliste\+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^X-Original-To: testmailingliste\+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^X-Original-To: testmailingliste\+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^X-Original-To: testmailingliste\+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste+admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true

Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
*# confirm - Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Anmeldung muss vom Listenadmin erlaubt werden
* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
*# confirm - Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

moderated = yes
moderate-include-queue = true
moderator = testmailingliste+moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

admin-approvepost = true

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

post-password = geheimesPasswort

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die EMail-Adresse und die Einträge in der ''.procmailrc'' zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Ecartis Installieren

2010-01-25T19:40:47Z

Chg00: umstellung auf hsadmin (virtueluser / alias Datei)

== Mailinglisten mit ecartis ==

{{Baustelle}}

Es ist möglich, in seinem Paket Mailinglisten mit dem Listenmanager ecartis zu benutzen.
Einmalige Einrichtung wahlweise zentral für das Paket bzw. einzelne Domains

== ecartis ==

=== Einrichten ===

Initial muss dafür das Skript add-mailinglist aufgerufen werden, welches im Paketverzeichnis ein neues Verzeichnis mailinglist erstellt, in dem sich dann alle Dateien für die Mailinglisten befinden.

Aufruf:

add-mailinglist

Damit ist der Listenmanager zentral für das Paket vorbereitet, d.h. benötigte Dateien wurden in das Verzeichnis ~/mailinglist kopiert. Außerdem wurden [[Aliases]] zur Ansteuerung des Listenmanagers angelegt.

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man dieses Verzeichnis als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

Im Verzeichnis des Listenmanagers befindet sich eine Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für jeden Listenmanager müssen nun in ecartis.cfg die Zeilen ecartis-address, ecartis-admin und ecartis-root konfiguriert werden. ecartis-root muss nur dann angepasst werden, wenn man ein anderes Verzeichnis als ~/mailinglist verwendet, weil man beispielsweise mehrere Listenmanager betreibt. Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

Man konfiguriert jetzt die Einträge in ecartis.cfg.

Beispiel:

ecartis-address = ecartis@example.com
ecartis-admin = postmaster@example.com
ecartis-root = /home/pacs/xyz00/mailinglist

==== E-Mail Adresse ====

Entsprechend des Eintrages ecartis-address fügt man [[E-Mail-Adressen]] der Domain example.com folgendes ein:

ecartis@example.com xyz00-ecartis

==== mehrere Listenmanager ====

Verwendet man mehrere Listenmanager, so muss man jedem Listenmanager einen eigenen E-Mail-Alias geben. Dazu müssen diese dann auch in der [[aliases]] eingetragen werden. Als Vorlage dienen hierfür die automatisch eingetragenen Aliase, welche auf den Listenmanager in ~/mailinglist verweisen.

=== Test ===
Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.
Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== aliases ====

Folgende Einträge nun mit hsadmin
[[Aliases]] bzw direkt im [[WebFrontend]]
anlegen:

# Aliases for 'testmailingliste' mailing list.
xyz00-testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
xyz00-testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
xyz00-testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
xyz00-testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
xyz00-testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
xyz00-testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== E-Mail Adressen ====

Bis jetzt haben wir noch nirgendwo festgelegt, unter welcher Domain die Mailingliste läuft. Dafür editieren wir die [[E-Mail-Adressen]] der Domain (Bsp: für die Domain example.com:)

testmailingliste@example.com xyz00-testmailingliste
testmailingliste-request@example.com xyz00-testmailingliste-request
testmailingliste-repost@example.com xyz00-testmailingliste-repost
testmailingliste-admins@example.com xyz00-testmailingliste-admins
testmailingliste-moderators@example.com xyz00-testmailingliste-moderators
testmailingliste-bounce@example.com xyz00-testmailingliste-bounce

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste-request@example.com mit dem Inhalt subscribe anmelden kann.
Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

=== Konfiguration ===
Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]