SmartList bei Hostsharing ========================= Andreas Loesch Version 0.2 04.05.2004 Administrivia: ============== Disclaimer / Hinweis: --------------------- Mit diesen Infos funktioniert SmartList bei mir :) alle Infos stammen aus dem Installationstext, dem Manual und der FAQ (siehe Links) und sind nur auf die HS -Situation angepasst (alias und virtualusers). Dieses Tutorial ist natürlich nicht als vollständig anzusehen :) auch sind evtl. Fehler nicht ausgeschlossen, ich übernehme keinerlei Haftung etc. blah blah.. Fehler, Hinweise oder sonstige Anmerkungen bitte an mich: mailto:al000@hostsharing.net History: -------- 0.2 -- 04.05.2004 -- Kapitel 3 hinzugefügt. 0.1 -- 02.05.2004 -- erste Version .................................................................... Inhalt: ======= 1. SmartList 1.1 Allgemein 1.2 Links und Literatur 2. Installation 2.1 Download 2.2 Vorbereitung 2.3 Installation 2.4 Basis-Konfiguration 3. Listen 3.1 anlegen 3.2 löschen 3.3 Konfiguration 3.4 gleiche Listnamen 3.5 Listen unter verschiedenen Domains/Subdomains 1. SmartList ============ 1.1 Allgemein ------------- SmartList ist ein _sehr_ einfaches Mail-Listen Managementwerkzeug, das auf procmail basiert. Die Vorteile sind, es ist winzig (< 400k pro Installation) und braucht keine Dämonen oder Cron-Jobs alles wird über procmail-Scripte gesteuert. Als Nachteil ist anzumerken, dass es _kein_ WWW-Interface gibt (ausser 3rd-party ->links). Als Ausnahme, bei low-traffic-digest-Listen kann ein Cronjob sinnvoll sein (vgl. Manual) Die aktuelle Version ist 3.15 und kann von der procmail-Seite (http://www.procmail.org/) bezogen werden. 1.2 Links und Literatur ----------------------- Installationsanleitung ---------------------- Die Anleiung (Datei INSTALL) liegt im Smart-List-Archiv, nach dem Entpacken (siehe 2.2) also in ~/procmail-3.22/SmartList/ Manual ------ Das SmartList-Handbuch (Datei MANUAL) liegt im Smart-List-Archiv, nach dem Entpacken (siehe 2.2) also in ~/procmail-3.22/SmartList/ und nach der Installation (siehe 2.3) in ~/smartlist/.etc/ Zusätzlich gibts eine html-Version unter: http://www.hartzler.net/smartlist/Manual.html FAQ --- Eine Liste von FAQs findet man unter: http://www.hartzler.net/smartlist/SmartList-FAQ.html Add-Ons ------- Unter: ftp://www.pure.ch/pub/smartlist/ finden sich einige Add-Ons für SmartList, so z.B. WebInterfaces oder Opt-In-Confirmation etc. (noch nichts getestet) 2. Installation =============== 2.1 Download ------------ benötigt werden SmartList: http://www.procmail.org/SmartList-3.15.tar.gz oder ftp://ftp.procmail.org/pub/procmail/SmartList-3.15.tar.gz und während der Erstellung auch noch procmail: http://www.procmail.org/procmail-3.22.tar.gz oder ftp://ftp.procmail.net/pub/procmail/procmail-3.22.tar.gz 2.2 Vorbereitung ---------------- beide Pakete entpacken (nicht verwirren lassen :) im SmartList-Paket ist ein procmail-3.15 Verzeichnis drin, einfach in das andere (procmail-3.22) reinkopieren (die Verzeichnisse SmartList und src gibts auch in procmail-3.22). Im Folgenden gehe ich davon aus, dass die Sourcen in procmail-3.22 zusammengeführt wurden! jetzt können die Tarballs und das procmail-3.15-Verzeichnis gelöscht werden. 2.3 Installation ---------------- Die Installation verläuft im Großen und Ganzen wie in procmail -3.22/SmartList/INSTALL beschrieben. Funktioniert hat sie bei mir nur als PAKET-ADMIN bei einem Domain-Admin gabs hänger (wenn ich mal Lust und Zeit habe, dann versuche ich noch zu ergründen warum) Also: ein Verzeichnis erstellen, in dem die Listen und Programme gespeichert werden sollen: PAKETADM:~$ mkdir smartlist dann die Installation starten. Da sich die Installation bei direktem Aufruf der Installationsroutine idr aufhängt muss erst procmail gebaut werden... (Grund?, egal!) PAKETADM:~$ cd procmail-3.22 PAKETADM:procmail-3.22$ make den Hinweis auf 'root' geflissentlich ignorieren, wir installieren das als User |Return|. Die vorgeschlagenenen Lock-test-Verzeichnisse einfach akzeptieren |Return| und nach kurzer Zeit gehts weiter. die Files liegen dann im Verzeichnis ./new werden aber nicht weiter verwendet... irgendwelche TEMP-Files werden wohl nur benötigt. Jetzt kann SmartList installiert werden (~/smartlist/ ist das Zielverzeichnis) PAKETADM:procmail-3.22$ cd SmartList PAKETADM:procmail-3.22/SmartList$ sh install.sh ~/smartlist/ Das wars jetzt auch schon, der komplette Baum ~/procmail-3.22/ kann auch weg, es steht jetzt alles in den Verzeichnissen unter ~/smartlist/ (z.B. .bin/ für die Programme und .etc/ für die zentralen Konfig-Dateien) 2.4 Basis-Konfiguration ----------------------- Nach der Installation muss noch die zentrale Konfig-Datei angepasst werden, also PATH, domain, und listmaster in ~/smartlist/.etc/rc.init anpassen. SmartList bringt einen eigenen Wrapper für den Editor mit, da aber noch keine Liste aktiv ist kann das direkt manuell durchgeführt werden. Der Pfad kann so bleiben, im Folgenden sei als domain example.org und als listmaster mail@example.org eingestellt. 3. Listen ========= Nach der Installation können die Listen eingerichtet werden. Auch hier kann man sich weitgehend wieder an der Dokumentation orientieren, so dass hier nur die HS-Besonderheiten näher erläutert werden sollen. 3.1 anlegen ----------- Wie im Handbuch (http://www.hartzler.net/smartlist/Manual.html#1) beschrieben einfach die Liste liste1 durch PAKETADM:smartlist/.bin$ ./createlist liste1 anlegen. Anschließend wird man aufgefordert die alias-Datei anzupassen, hier geht man einen kleinen Umweg über die virtualusers-Datei in der Domain, also wird für die Liste liste1 in die virtualusers durch den DOM-Admin liste1@example.org xyz00-liste1 liste1-request@example.org xyz00-liste1-request eingetragen. Diese beiden lokalen Adressen (xyz00-liste1 und xyz00-liste1 -request) kommen jetzt in die ~/etc/alias mit den Aufrufen zum SmartList-Kram. xyz00-liste1 "|/home/pacs/xyz00/smartlist/.bin/flist liste1" xyz00-liste1-request "|/home/pacs/xyz00/smartlist/.bin/flist liste1-request" damit ist die Liste lauffähig. Zur Administration und konfiguration verweise ich auf das Manual und die FAQ 3.2 löschen ----------- Entsprechend dem Manual PAKETADM:smartlist/.bin$ ./removelist liste1 und anschliessend nohc die Einträge aus der ~/etc/alias und der example.org/etc/virtualusers entfernen. 3.3 Konfiguration --------------------- Die zentrale Konfigurationsdatei ist ~/smartlist/.etc/rc.init, hier werden alle Einstellungen für _alle_ Listen getätigt, also Domain, Listmaster sowie subscribe/unsubscribe/archiv/...-Verhalten. Das Verhalten einzelner Listen kann über die ~/smartlist/LISTENNAME/rc.custom parametriesiert werden. die Datei rc.init wird auch in jedes Listenverzeichnis ge-'hardlinked', so dass sie auch dort vorliegt. Wenn man die Subscriber-Liste (~/smartlist/LISTENNAME/dist) manuell bearbeiten will (ich habs jetzt auf die Schnelle nicht im HB gefunden muss auch hinter dem letzten Namen eine Zeilenwechsel stehen, sonst wird der letzte Name nciht berücksichtigt. 3.4 gleiche Listnamen --------------------- Die Domain für die Listen ist in der (zentralen) rc.init festgelegt, d.h. wenn in rc.init example.org als Domain steht kommen alle Systemantoworten von der liste1@example.org, auch wenn eine Listenadresse z.B. liste2@sub.example2.org in die entsprechende virtualuser-Datei eingetragen ist und über die alias-Datei auf die bekannte liste1 abgebildet ist. Weiterhin werden die Listen auf Verzeichnisse ~/smartlist/LISTENNAME/ abgebildet, und der Listenname ist gleich dem Verzeichnisnamen. Das bedeutet: Sinnvoll sind mit einer Installation von SmartList nur eindeutige Namen, sollen die gleichen Listnamen für verschiedene Domains verwendet werden, so sind mehrere installationen von SmartList zu empfehlen. Wobei hierbei die Größe von <400k dem nicht entgegen stehen sollte :) 3.5 Listen unter verschiedenen Domains/Subdomains ------------------------------------------------- Wenn die Listennamen nicht gleich sein müssen, so kann eine Installation problemlos für verschiedene Domains/Subdomains genutzt werden. Die Listendomains werden in ~/smartlist/.etc/rc.init festgelegt, wie in 3.3 beschrieben findet sich diese Datei als Hardlink in jedem ~/smartlist/LISTENNAME/rc.init wieder, möchte man die Konfiguration von der zentralen Installation abkoppeln gibt es ein Script delink im bin-Verz. der Installation. PAKETADM:smartlist/LISTNAME$ ../.bin/delink rc.init damit ist das init-File losgelöst und es kann für eine einzelne Liste eine andere Domain eingestellt werden. ================================================================================ End of "SmartList bei Hostsharing" (c) 2004 by Andreas Loesch ================================================================================