Sympa installieren

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen

Allgemein

Sympa [1] ist eine Software zum Verwalten von Mailinglisten. Sie wird unter der GPL veröffentlicht und ist damit freie Software.

Technische Details

Es gibt ein Ansible Skript, das die Installationsschritte für Sympa automatisiert durchführt.

Die Quellen für das Ansible Skript können hier eingesehen werden: https://github.com/tpokorra/Hostsharing-Ansible-Sympa/

Es werden die eingehenden E-Mails über procmail in ein lokales Spool Verzeichnis gespeichert.

Das Perl SKript für die Webseite wird auf einem eigenen Port gestartet, auf den der Apache Webserver über FCGI zugreift.

Mit Monit werden die verschiedenen Prozesse gestartet und überwacht.

Installation

Achtung: Sympa benötigt zahlreiche Hintergrundprozesse, was beim Managed Webspace zusätzliche Kosten verursacht.

Es muss ein Port für den fcgi Dienst beim Hostsharing Service beantragt werden.

Das Ansible Skript (https://github.com/tpokorra/Hostsharing-Ansible-Sympa/) wird entsprechend der Anleitung Anwendungen mit Ansible installieren installiert.

Einrichtung

Nach der Installation kann die Seite hier erreicht werden: https://sympa.example.org

Administrativen Benutzer einrichten

Nun müssen Sie den Benutzer für die Listen-Administration einrichten. Dazu klicken Sie auf den "Anmelden" Schalter, und klicken dann auf den Link "Erste Anmeldung". Hier geben Sie die E-Mail-Adresse des Administrator-Benutzers ein. Diese Adresse haben Sie bereits in der inventory.yml Datei unter listmaster eingetragen. Dann wird eine E-Mail mit einem Link verschickt, öffnen Sie diese E-Mail und gehen Sie auf den Link, dann können Sie das Passwort für den Administrator Benutzer setzen.

Neue Liste einrichten

Nun können Sie auf "Liste beantragen" klicken, und dort können Sie eine neue Mailingliste einrichten.

Es stehen verschiedene Optionen zur Verfügung:

  • Vertrauliche Liste
  • Öffentliche Diskussions-Liste
  • Hotline-Liste
  • Newsletter mit Klartext und/oder HTML-Format
  • Private Arbeitsgruppe
  • Mailingliste mit Web-Forum

Siehe auch dieses Bildschirmfoto:

Sympa neue liste.png

Es muss in HSAdmin in der Domain, die Mailingliste beherbergt, eine catch-all Adresse eingerichtet werden. Die E-Mails sollten in das Postfach des Unix-Benutzers fließen, wo Sympa installiert ist. Dafür bleibt der lokale Teil einfach leer, und als Postfach wird der Unix-Benutzer angegeben.

Sympa hsadmin catchall.png

Es muss noch eingerichtet werden, dass die E-Mails an den richtigen Speicherort gelangen. Dazu muss dieses Skript ausgeführt werden:

   $ ./bin/addlist.sh meineliste sympa.example.org

Benutzung

Die Liste der verfügbaren Mailinglisten ist erreichbar auf https://sympa.example.org/sympa/lists

Wenn man dort auf eine Liste klickt, hat man diese Möglichkeiten:

  • Anmelden, Abonnieren
  • Abmelden, Abbestellen
  • Zugriff auf das Archiv (wenn es öffentlich ist)
  • Senden: falls es eine ganz öffentliche Liste ist, wo jeder schreiben darf.

Zu verschickende E-Mails werden an die Adresse meineliste@sympa.example.org verschickt.

Debuggen

Zum Debuggen kann ein Prozess gestoppt werden, und im Vordergrund auf der Konsole ausführen werden:

   killall -u $USER monit
   $HOME/bin/sympa-stop.sh
   export PERL5LIB=$HOME/perl5/lib/perl5/
   $HOME/sympa/sbin/sympa_msg.pl --debug --foreground

Dann wieder Monit starten, damit die Prozesse überwacht und gestartet werden:

   rm $HOME/var/run/sympa_msg.pid
   /usr/bin/monit -c "$HOME/.monitrc"

Links