GSB 7.0 Standardlösung

Springe direkt zu:

Version: GSB 7Installationsanleitung

Der EventDispatcher ist eine optionale Komponente des GSB und wird als eigenständiges Modul des GSB ausgeliefert. Die Installation und Basiskonfiguration des EventDispatchers ist somit nicht in der Standard Installationsanleitung enthalten, sondern wird an dieser Stelle explizit dokumentiert. Die Installation und Konfiguration des EventDispatcher wird mit Hilfe des Standard GSB-Deployments, d.h. mit dem Skript gsbinstall durchgeführt.

Neben dem EventDispatcher wird noch ein spezieller CAE-Tomcat-Server benötigt, der für die Erzeugung von Newsletter-Inhalten zuständig ist. Dieser Tomcat-Server wird im Rahmen der EventDispatcher-Konfiguration und des -Deployments mit eingerichtet.

Voraussetzungen

Die Installationsvoraussetzungen des GSB-Kerns müssen gegeben sein, d.h. die Schritte zur Vorbereitung und Aktivierung eines GSB-Release müssen durchgeführt (s.a. GSB Installationsvoraussetzungen)

Installation[Bearbeiten]

Der EventDispatcher ist im GSB-Release parallel zum GSB-Kern als eigenständige Komponente enthalten. Das Verzeichnis EventDispatcher enthält die EventDispatcher Software sowie Vorlagendateien, die für das Deployment des EventDispatchers benötigt werden.

Vorbereitung Build-Properties

Die für den EventDispatcher benötigten Build-Properties müssen zunächst aus dem Verzeichnis EventDispatcher/buildProperties in den Ordner ~cmadmin/admin/config kopiert werden. Für die Installation und den Betrieb des Eventdispatchers werden die folgenden Dateien benötigt:

  • build_cm_tomcat_eventdispatcher.properties enthält alle Build-Properties, die für die Installation und Konfiguration des EventDispatcher Tomcat-Servers benötigt werden.
  • webapps/build_cm_webapp_cae_eventdispatcher.properties enthält alle Build-Properties, die für die Konfiguration der EventDispatcher Webapplikation benötigt werden.
  • build_cm_tomcat_newsletter.properties enthält alle Build-Properties, die für die Installation und Konfiguration des Newsletter Tomcat-Servers benötigt werden.
  • webapps/build_cm_webapp_cae_newsletter.properties enthält alle Build-Properties, die für die Konfiguration der Newsletter-cae Webapplikation benötigt werden.

Anpassung der Hostnamen

Die EventDispatcher Build-Properties enthalten noch eine Reihe von Hostnamen, die an die konkreten Servernamen der Hostingplattform angepasst werden müssen. Folgende Hostnamen müssen angepasst werden:

  • content.domain.example Name des ContentServers. Der EventDispatcher registriert einen EventListener im angegebenen Contentserver, um auf ConentEvents reagieren zu können
  • preview.domain.example Servername auf dem der GSB Newsletter-Tomcat installiert ist
  • mail.domain.example Name des Mailservers der für den direkten Versand von Emails durch den EventDispatcher verwendet werden soll.
  • cmsearch.domain.example Name des Solr-Servers für die Suche im Content des Redaktionssystems (Preview).

Aktivierung

Nachdem die Build-Properties kopiert und angepasst worden sind, muss die Komponente EventDispatcher noch aktiviert werden. Details zur Aktivierung finden sich in der GSB-Installationsanleitung im Kapitel "Aktivierung von Komponenten". Die Aktivierung des EventDispatcher wird mit dem Kommando durchgeführt.

<syntaxhighlight lang="xml" enclose="div">gsbinstall activateComponent $GSB_ADMIN_HOME/config/build_cm_tomcat_eventdispatcher.properties</syntaxhighlight>

Nach Aktivierung des EventDispatchers ist dieser unter dem Komponentennamen eventdispatchertomcat auf dem Server registriert und kann unter diesem Namen installiert und aktualisiert werden.

Installation

Die Installation des EventDispatchers kann entweder im Rahmen einer Komplettinstallation der GSB-Komponenten eines Servers durchgeführt werden (s.a. Installation der Komponenten).

<syntaxhighlight lang="xml" enclose="div">gsbinstall rebuildSystem</syntaxhighlight>

Alternativ kann der EventDispatcher auch als mit Hilfe des rebuildComponent Deployments mit folgenden Kommando installiert werden.

<syntaxhighlight lang="xml" enclose="div">gsbinstall rebuildComponent eventdispatchertomcat</syntaxhighlight>

Der Newsletter Tomcat wird mit dem folgenden Kommando installiert:

<syntaxhighlight lang="xml" enclose="div">gsbinstall rebuildComponent newslettertomcat</syntaxhighlight>

Konfiguration

Nach Installation des EventDispatchers steht dieser als Service-Funktionalität in der GSB-Infrastruktur zur Verfügung. Damit einzelne GSB-Mandanten den EventDispatcher für die Newsletter Generierung nutzen können, müssen diese entsprechend vorbereitet werden. Hierfür sind zwei Schritte im GSB-Mandanten notwendig

Aktivierung im Mandanten

Möchte ein Mandant den EventDispatcher nutzen so müssen die mandantenspezifischen Customer-Properties angepasst werden. Die Property should_configure_eventdispatcher muss auf den Wert true gesetzt werden. Bei einem anschließenden Deployment des EventDispatchers wird jetzt die mandantenspezifische Konfiguration des EventDispatcher mit deployed, so dass der EventDispatcher diese anschließend berücksichtigen kann.

EventDispatcher Konfiguration

Die mandantenspezifische Konfiguration des EventDispatchers findet in sogenannten Performern statt. Ein Performer definiert das Regelwerk für die Erkennung relevanter Content-Events und die anschließende Verarbeitung der Events. Details zur Konfiguration und Möglichkeiten des Performers finden sich in der EventDispatcher Konfiguration.

Die Standardlösung enthält eine Vorlage die für eine mandantenspezifische Anpassung genutzt werden kann. Diese findet sich in der Datei standardlsg_basis/config/EventDispatcher/config/standardlsg-Performer.xml abgelegt und kann bei Bedarf in andere Mandanten übernommen und an die mandantenspezifischen Belange angepasst werden.