eMail Marketing und Newsletter Software | BACKCLICK
email Marketing Software + Newsletter Software BACKCLICK InhaltIndex
vorigeshinaufnächstes
Unix/Linux
Installation

IV. Entpacken der Archive / Einspielen der Datenbank *

  1. Legen Sie im webapps-Verzeichnis des Tomcat bsp. /usr/local/tomcat/webapps ein Verzeichnis names „bc“ an.
  2. Kopieren Sie die Datei „bc_gui.tgz“ in dieses Verzeichnis.
  3. Entpacken Sie „bc_gui.tgz“ mit dem Befehl „tar –xvzf bc_gui.tgz“.
  4. Legen Sie in /usr/local ein Verzeichnis mit Namen „bc_api“ an.
  5. Kopieren Sie die Datei „bc_api.tgz“ in obiges Verzeichnis.
  6. Entpacken Sie „bc_api.tgz“ mit dem Befehl „tar –xvzf bc_api.tgz“.
  7. Legen Sie in /usr/local ein Verzeichnis mit Namen „JacORB_2_2“ an.
  8. Kopieren Sie die Datei „jacorb.tgz“ in obiges Verzeichnis.
  9. Entpacken Sie „jacorb.tgz“ mit dem Befehl „tar –xvzf jacorb.tgz“.
  10. Wechseln Sie nach /usr/local/bc_api/database
  11. Legen Sie eine leere Datenbank mit dem Namen BACKCLICK an (mysql> create database backclick;)
  12. Initialisieren Sie nun die BACKCLICK Datenbank, indem Sie das SQL-Skript „backclick.sql“ ausführen:

 

# mysql –u root < backclick.sql
V. Anpassen der Backclick-Konfigurationsdateien

Es wird angenommen, dass 

- die Backclick-API unter /usr/local/bc_api installiert ist 

- die Backclick-GUI unter /usr/local/tomcat/webapps/bc installiert ist 

- JacORB unter /usr/local/JacORB_2_2 installiert ist 

 

JacORB Anpassung: 

In dem Verzeichnis /usr/local/JacORB_2_2/etc befinden sich zwei Unterverzeichnisse mit den Vorlagen der Konfigurationsdateien für die Server und Clientkonfiguration. Diese Verzeichnisse besitzen die Namen "server" und "client". Nach der Anpassung der Dateien jacorb.properties und orb.properties im jeweiligen Verzeichnis kopieren Sie diese Dateien unbedingt in das übergeordnete Verzeichnis /usr/local/JacORB_2_2/etc. 

Folgende Variablen werden in den Konfigurationsdateien jacorb.properties und orb.properties verwendet und müssen mit den entsprechenden Werten ersetzt werden: 

 

- $$SERVER_IP$$ > IP-Adresse des Servers (Server auf dem die API läuft) 

- $$NS_PORT$$ > Port für Nameservice (Standard: 2222) 

- $$CLIENT_IP$$ > IP-Adresse des Clients (auf 1. Maschine = $$SERVER-IP$$) 

- $$IMR_PORT$$ > Port für IMR (Standard : 55569) 

- $$PATH$$ > Stammpfad von JacORB (hier /usr/local) 

- $$PATH$$ > Homeverzeichnis von JacORB (hier /usr/local/JacORB_2_2) 

 

 

  • /usr/local/JacORB_2_2/bin/reboot.sh anpassen - Passen Sie evtl. den Pfad zum Tomcat an.
  • /usr/local/JacORB_2_2/bin/jaco.sh anpassen - Passen Sie alle Pfade entsprechend der Installation an.
  • /usr/local/bc_api/jaco.sh anpassen - Passen Sie alle Pfade entsprechend der Installation an oder kopieren Sie die jaco.sh aus /usr/local/JacORB_2_2/bin/ hierher.

 

 

Anpassung der backclick.conf Datei:

Folgende Variablen werden in der Konfigurationsdatei verwendet und müssen mit den entsprechenden Werten ersetzt werden: 

 

- $$BCPATH$$ > Pfad zu Backclick-API (hier /usr/local/bc_api) 

- $$SQL_SERVER_IP$$ > IP-Adresse des SQL-Servers (wenn auf dem gleichem Server dann localhost) 

- $$SQL_USER$$ > Benutzername für Datenbank (Beispiel: backclick) 

- $$SQL_PASS$$ > Passwort für Datenbank 

- $$SQL_DATABASE$$ > Name der Datenbank (Beispiel: backclick) 

 

Ersetzen Sie die Variablen. Sollten die Verzeichnisse, auf die verwiesen wird, nicht existieren, legen Sie diese bitte an! 

 

<ORBInitialHost value="$$SERVER_IP$$"/> 

<ORBInitialPort value="$$NS_PORT$$"/> 

<DatabaseHost value="$$SQL_SERVER_IP$$"/> 

<DatabaseUser value="$$SQL_USER$$"/> 

<DatabasePassword value="$$SQL_PASS$$"/> 

<DatabaseName value="$$SQL_DATABASE$$"/> 

<AttachmentDirectory value="$$BCPATH$$/attachments/"/> 

<ApplicationDirectory value="$$BCPATH$$"/> 

<SubscriberImportDirectory value="$$BCPATH$$/subimport/"/> 

<ExportDirectory value="$$BCPATH$$/export/"/> 

<XMLImportDirectory value="$$BCPATH$$/XMLImport/"/> 

<TemplateImportDirectory value="$$BCPATH$$/templates/"/> 

<PDFlibDirectory value="$$BCPATH$$/pdflib/"/> 

<InlineImageDirectory value="$$BCPATH$$/inline_images/"/> 

<SubscriberAutoDelDirectory value="$$BCPATH$$/subdel/"/> 

<TempDirectory value="$$BCPATH$$/temp/"/> 

 

Bei normalen Installationen lassen Sie bitte den Parameter sendfast auf "no". Sollten Sie den parameter auf "yes" setzen, sind spezielle Konfigurationen am SMTP Server nötig. Ohne diese Änderungen an der Mailserverkonfiguration wird BACKCLICK Fehler beim Versand der Newsletter produzieren. 

 

<sendfast value="no"/> 

 

ACHTUNG: Eine unsachgemäße Benutzung dieses Parameters wird Fehler in der Mailzustellung bewirken!!! 

 

Anpassung der BACKCLICK-Webapplikation im Tomcat Server

In unserem Beispiel haben wir die Webapplikation im Verzeichnis webapps/bc des Tomcat angelegt. 

Passen Sie dazu nun die Datei /usr/local/tomcat/webapps/bc/WEB-INF/web.xml an. 

 

Folgende Variablen werden in der Konfigurationsdatei verwendet und müssen mit den entsprechenden Werten ersetzt werden: 

 

- $$SERVER-IP$$ > IP-Adresse des Servers (Server auf dem die API läuft) 

- $$NS_PORT$$ > Port für Nameservice (Standard: 2222) 

- $$PATH$$ > Stammpfad von JacORB (hier /usr/local) 

- $$PATH$$ > Homeverzeichnis von JacORB (hier /usr/local/JacORB_2_2) 

 

Ersetzen Sie bitte die Variablen durch die entsprechenden Angaben: 

 

<context-param> 

<param-name>ORBHost</param-name> 

<param-value>$$SERVER_IP$$</param-value> 

<description>The host of the CORBA Naming Service.</description> 

</context-param> 

<context-param> 

<param-name>ORBPort</param-name> 

<param-value>$$NS_PORT$$</param-value> 

<description>The port of the CORBA Naming Service.</description> 

</context-param> 

<context-param> 

<param-name>Server_Address</param-name> 

<param-value>http://$$SERVER_IP$$:8080/bc</param-value> 

<description>The Address, where the Backclick-GUI is installed.</description> 

</context-param> 

<context-param> 

<param-name>webInterface_Address</param-name> 

<param-value>http://$$SERVER_IP$$:8080/bc</param-value> 

<description>The Address where the WebInterface is installed</description> 

</context-param> 

 

 

VI. Registrieren und starten der Backclick-Server am persistenten CORBA Implementation Repository
  1. wechseln Sie in das Verzeichnis /usr/local/JacORB_2_2/bin
  2. starten Sie "./imr.sh" in einer separaten Shell
  3. starten Sie "./ns.sh" in einer separaten Shell
  4. starten Sie "./imr_ssd.sh" in einer separaten Shell
  5. Sollten Sie in den drei Shells keine Fehlermeldungen sehen, ist Ihre CORBA Schicht einsatzbereit
  6. wechseln Sie nun ins Verzeichnis /usr/local/bc_api
  7. führen Sie "./servtool.sh –r BCServer" aus.
  8. führen Sie "./servtool.sh –r MCP" aus.
  9. führen Sie "./servtool.sh –s BCServer" aus.
  10. führen Sie "./servtool.sh –s MCP" aus.
  11. führen Sie "./jaco.sh bc.mailerctrl.MailerImp"l aus

 

 

Punkt 11 registriert eine Mailengine. Möchten Sie mehrere Engines installieren, wiederholen Sie Punkt 11. 

Im Verzeichnis /usr/local/bc_api/logs sollte jetzt die Datei api.log angelegt worden sein. Wenn Sie hier in der letzten Zeile eine Meldung erhalten, ist Ihr BACKCLICK-Server bereit Anfragen über CORBA zu emfangen und zu antworten. Dies ist die Voraussetzung, damit die Webapplilkation /bc im Tomcat auf die Businesslogik von BACKCLICK zugreifen kann. 

 

VII. Abschluss der Installation

Führen Sie das Skript „./reboot.sh“ in /usr/local/JacORB_2_2/bin aus. Dies ist das zentrale Skript um Backclick komplett (inkl. Tomcat) zu starten. 

Im Verzeichnis /usr/local/bc_api/logs sollte jetzt die Datei api.log angelegt worden sein. Wenn Sie hier in der letzten Zeile folgende Meldung erhalten: dann ist Ihr BACKCLICK Server bereit Anfragen über CORBA zu emfangen und zu antworten. Dies ist die Voraussetzung, damit die Webapplilkation /bc im Tomcat auf die Businesslogik von BACKCLICK zugreifen kann. 

 

??.??.???? ??:??:?? (level 1): Backclick Server "Backclick" started and ready for service. 

 

Wenn diese Zeile vorhanden ist, wurden die Server korrekt registriert und gestartet. Finden Sie hier eine Fehlermeldung (Exeption) sind Ihre Zugangseinstellungen zum Datenbankserver nicht korrekt oder der Datenbankserver verweigert den Zugriff. Bitte überprüfen Sie dann die Logfiles des Datenbankservers, um die nötigen Berechtigungen zu erteilen. 

 

Starten Sie nun Ihren Webbrowser und rufen Sie die Backclick-GUI auf. Die URL haben Sie vorher in der Datei usr/local/tomcat/webapps/bc/WEB-INF/web.xml im Block Server_Address eingetragen. 

Loggen Sie sich nun an Backclick mit dem Benutzer „bcadmin“ und dem Passwort „bcadmin“ ein. Funktioniert alles, sind Sie nun in der Administrationsoberfläche von Backclick und die Datei api.log wird um den Eintrag: 

 

??.??.???? ??:??:?? (level 4): User "bcadmin" successfully logged in 

 

ergänzt. Sollten Sie hier CORBA-spezifische Meldungen erhalten oder ein "Access Denied", haben Sie bei der Installation einen Fehler gemacht. 

 

 

VIII. Serverstart beim Booten

Wenn Ihr Server neu gestartet werden muss, können Sie das Skript “reboot.sh” in /usr/local/JacORB_2_2 in den Startprozess einbinden. Dieses Script startet Backclick inkl. dem Tomcat. Stellen Sie jedoch sicher, dass die Umgebungsvariablen (siehe Punkt III) VORHER korrekt gesetzt wurden oder dem reboot.sh Script zur Bootzeit zur Verfügung stehen. Sollten diese Variablen zum Ausführungszeitpunkt des Scriptes nicht zur Verfügung stehen, erhalten Sie beim Einlogversuch eine CORBA (JacORB) Fehlermeldung.

Links
Installation
ATD GmbH
InhaltIndex