Migration Melin 3
Aus Melin WebHelp
[bearbeiten] Sichern und Bereinigen
Im ersten Schritt sollte die bestehende Installation gesichert werden. Dazu muß der Daemon und der Application Server angehalten werden und das gesamte Melin-Verzeichnis gesichert werden. Drei Dateien sollen zusätzlich gesichert werden, da diese im Rahmen des Updates überschrieben werden da hier neue Felder hinzukommen:
- msite/demon/config/melinconfig.xml
- htdocs/melin/WEB-INF/web.xml
Es ist empfehlenswert auch ein Backup der MMDB-Datenbank zu machen.
[bearbeiten] Einspielen des Updates
Nun muss das Migrationspaket über die bestehende Installation entpackt werden, bestehenden Scripte werden dabei überschrieben, Konfigurationsdaten und Einstellungen beibehalten.
[bearbeiten] Anpassen der web.xml
Bei Melin 3 ist es möglich, mehrere Melin-Installationen unter einem Tomcat-Server zu betreiben. Damit jede Installation ihre Konfigurationsdaten findet, wird der Pfad zum SITE-Verzeichnis (Anwendungsdaten und Daemon) als Umgebungsvariable definiert. Die Definition des SITE-Verzeichnisses erfolgt in der htdocs/melin/WEB-INF/web.xml
<?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <context-param> <param-name>appName</param-name> <param-value>MelinWebInterface</param-value> </context-param> <context-param> <param-name>SITE-DIR</param-name> <param-value>/home/melin/msite</param-value> </context-param> <listener> <listener-class>services.ServletEventContextListener</listener-class> </listener> </web-app>
Es ist nur der eine Parameter zu ändern, wenn Melin nicht in /home/melin/ installiert ist. Unter Windows setzt man zum Beispiel c:/melin als Wert.
[bearbeiten] Anpassen der melinconfig.xml
Die Datei msite/demon/config/melinconfig.xml verfügt nun über eine Reihe von neuen Konfigurationsparametern. Öffen Sie die Datei und ergänzen Sie - falls noch nicht vorhanden - die folgenden Felder:
- Pfad zum DocumentRoot von Melin: <DOCUMENT-ROOT>/home/melin/htdocs</DOCUMENT-ROOT>
- Klicktracker, statt 127.0.0.1:8200 setzen Sie hier die URL unter der Melin erreicht werden kann: <TRACK-URL>http://127.0.0.1:8200/j.jsp?OC=UD[SYSTEM_CUSTOMER_ID]</TRACK-URL>
- Voreingestellter Zeichensatz: <ENCODING>ISO-8859-1</ENCODING> (hier könnte man der Versuchung erliegen ein UTF-8 reinzuschreiben, wenn Internet Explorer bis inkl. 7 verwendet wird geht das nicht, da der IE bis inklusive 7.x Formulare IMMER als ISO-8859 absendet und nur bei der Darstellung UTF-8 beherrscht - führt zu Fehlern)
- Zustellversuche können bei Melin 3 auf "1" gesetzt werden: <SMTP_TRY_SENDING>1</SMTP_TRY_SENDING>
[bearbeiten] Neustarten des Tomcat
Jetzt kann der Tomcat neu gestartet werden, im Browser sollte "Melin 3" als Loginseite erscheinen. Ein erster Test sollte sein ob sich der "superuser" einloggen kann.
[bearbeiten] Aktualisieren der Datenbankstruktur
Die Melin3-MMDB verfügt über neue und erweiterte Tabellen. Um eine Konvertierung der Datenbank zu aktivieren wählen Sie im Hauptmenü den Punkt "Voreinstellungen" und dann "Master Datenbank". Das Formular sollte bereits mit den richtigen Werten belegt sein, klicken Sie auf "Absenden". Nun werden die Tabellen geprüft und ggf. erweitert. Da keine Daten modifiziert werden ist dieser Prozess schnell abgeschlossen. Getestet wurden bisher die Datenbanken Oracle, MySQL und SimpleSQL.
[bearbeiten] BounceMail Management
Im BounceMail-Management gibt es eine neue Option "Redirect to". Hier kann pro BounceMail-Account eine Emailadresse angegeben werden an die Mails weitergeleitet werden die das BounceMail-Management nicht bearbeiten kann. Hier sollte eine Emailadresse eingetragen werden. Die Option "Auch weiterleiten wenn User unbekannt" wird meist nicht benötigt, in der Standardkonfiguration werden nur Mails von existierenden Abonnenten weitergeleitet und man bleibt von allen Spam-Mails verschont die typischerweise auf dem Bouncemail-Account eingehen.
Neu ist hier die Option "Queue" mit der man nichtnur überprüfen kann ob die Passwörter alle korrekt sind, sondern auch die Anzahl der Mails in den POP3-Postfächern kontrollieren kann. Wenn Melin komplett läuft, sollen die Postfächer leer sein oder nur mit aktuellen Mails aus den letzen Minuten gefüllt sein.
[bearbeiten] Aktivieren des BounceMail-Listeners
Unter "Workflow" / "Serverprozesse" kann das BounceMail-Management aktiviert werden. Alle fünf Minuten werden die definierten Bouncemail-Accounts überprüft.Im Logfile vom Tomcat (tomcat/logs/catalina.out) kann man sehen ob es hier Fehler gibt.
[bearbeiten] Abonenntenpflege-Setup
Als nächstes muß eine Option kontrolliert werden die nur der Superuser sieht: unter "Abonnenten" / "Abonnent hinzu" befindet sich ein neuer Button "Setup". Hier kann eingestellt werden welche Felder der MMDB durch Benutzer der Oberfläche geändert werden können. Da in den meisten Fällen nicht alle existierenden Felder verwendet werden bietet es sich an hier einmal aufzuräumen und das System so für Benutzer zu vereinfachen.
[bearbeiten] Zielgruppenfilter
Die Logik hinter dem Zielgruppenfilter wurde grundlegend überarbeitet. Wenn Sie diesen nutzen sollen Sie bei allen existierenden Regeln einmal auf "Bearbeiten" klicken und dann auf "Speichern" um diese neu zu schreiben
[bearbeiten] Prüfen der JPEG-Library
Eine der neuen Funktionen in Melin 3 ist die Sedcard, die zu allen versandten Mailings abgerufen werden kann. Die Sedcard wird aus dem Menü "Auswertungen" / "Einzelversandstatistiken" aus aufgerufen, neben jedem Mailing ist rechts ein Icon das ein neues Fenster öffnet. Für alte Mailings stehen nicht alle Daten zur Verfügung, jedoch sollte testweise eine Seite aufgerufen werden. Entscheidend für den Test ist, ob hier zwei Grafiken erscheinen, eine Balkengrafik oben und ein Kreisdiagramm gegen Ende der Seite. Wenn ja, ist dieser Test erfolgreich.
Auf manchen Linux-System sind die JPEG-Libraries nicht installiert, in diesem Fall erscheint hier eine Fehlermeldung und es müssen die Libraries installiert werden (unabhängig von Java). Wenn nicht der Tomcat in der Standard-Konfiguration verwendet wird sondern ein anderer Application-Server, so muss sichergestellt sein daß Java mit "-Djava.awt.headless=true" läuft oder ein Window-System zur Verfügung steht, Java kann sonst keine JPEGs generieren.
[bearbeiten] Daemon / Abschluss
Jetzt kann der Daemon wieder gestartet werden. Das System ist wieder Betriebsbereit. Herzlichen Glückwunsch zur Migration auf Melin 3.