Bereitstellen von Unica Plan auf WebSphere

Sie können die Anwendung Unica Plan aus einer WAR-Datei oder einer EAR-Datei auf dem WebSphere® Application Server (WAS) bereitstellen.

Vorbereitungen

Beachten Sie die folgenden Punkte, bevor Sie Unica Plan auf WebSphere bereitstellen:
  • Vergewissern Sie sich, dass Ihre Version von WebSphere die Voraussetzungen erfüllt einschließlich aller erforderlichen Fixpacks oder Upgrades, die im Dokument Empfohlene Softwareumgebungen und Mindestsystemvoraussetzungen beschrieben sind.
  • Zur Konfiguration Ihres WebSphere Application Servers verwenden Sie die WebSphere Integrated Solutions Konsole. In den folgenden Schritten wird die Einstellung bestimmter Steuerelemente erläutert.
  • Stellen Sie sicher, dass Sie el-api.jar im WAS-Server lib-Verzeichnis hinzufügen.
Anmerkung: Verschiedene Versionen von WebSphere Application Server stellen Bedienelemente der Benutzeroberfläche in unterschiedlicher Reihenfolge und mit alternativen Bezeichnungen dar.

Warum und wann dieser Vorgang ausgeführt wird

Führen Sie die folgenden Schritte aus, um die Umgebung für die Bereitstellung von Unica Plan einzurichten:

Prozedur

  1. Definieren Sie eine angepasste Eigenschaft: Klicken Sie im Formular Anwendungsserver > <Server> > Web-Container > Angepasste Eigenschaftenauf Neu und geben folgende Werte ein:
    • Name:com.ibm.ws.webcontainer.invokefilterscompatibility
    • Wert: true
  2. Erstellen Sie JDBC-Provider: Klicken Sie im Formular Ressourcen > JDBC > JDBC-Provider auf Neu. Führen Sie den Assistenten Erstellen eines neuen JDBC-Providers einschließlich der folgenden Felder aus:

    Die Datenquellenerstellung kann im Web-App-Server übersprungen werden, wenn Sie die Konfiguration vom Installationsprogramm vornehmen lassen.

    1. Wählen Sie als Implementierungstyp die Datenquelle Verbindungspool aus.
    2. Geben Sie den Pfad der nativen Bibliothek der JAR-Datei des Datenbankträgers auf Ihrem Server an.
      Beispiel: db2jcc4.jar / ojdbc6.jar / sqljdbc4.jar / mariadb-java-client-2.4.1 / onedb-jdbc-8.0.0.1-complete.jar.
    3. Legen Sie für MariaDB den Namen der Implementierungsklasse als org.mariadb.jdbc.MariaDbDataSource
  3. Erstellen Sie die Datenquelle: Klicken Sie im Formular Ressourcen > JDBC > Datenquelle auf Neu. Führen Sie den Assistenten 'Erstellen einer Datenquelle' mit folgenden Aktionen aus:

    Die Datenquellenerstellung kann im Web-App-Server übersprungen werden, wenn Sie die Konfiguration vom Installationsprogramm vornehmen lassen.

    1. Geben Sie einen Datenquellennamen an.
    2. Geben Sie als JNDI-Namen plands ein.
    3. Wählen Sie den JDBC-Provider aus, den Sie in Schritt 2 erstellt haben.
    4. Geben Sie den Datenbanknamen und den Servernamen an.
    5. Wählen Sie als Alias für Zuordnungskonfiguration WSLogin aus.
  4. Definieren Sie benutzerdefinierte Eigenschaften für die Datenquelle: Klicken Sie im Formular JDBC-Provider > <Datenbankprovider> > Datenquellen > Angepasste Eigenschaften auf Neu, und fügen zwei neue Eigenschaften hinzu:
    • Name: user
    • Wert: <user_name>
    • Name: Kennwort
    • Wert: <password>

    Wenn sich Ihre Unica Plan-Systemtabellen in DB2® befinden, finden Sie die resultSetHoldability-Eigenschaft und setzen Sie ihren Wert auf 1. Wenn diese Eigenschaft nicht vorhanden ist, fügen Sie sie hinzu.

  5. Erstellen Sie neue angepasste Eigenschaften für die MariaDB-Datenquelle.
    • Port: <portnumber>
    • databaseName: <database name>
    • serverName: <server name>
    • driverType : 4
  6. Konfigurieren Sie die JVM: Ermitteln Sie auf dem Formular Anwendungsserver > <Server> > Prozessdefinition > Java Virtual Machine die Option 'Classpath' und fügen, getrennt durch Leerzeichen, die folgenden Einträge als generische JVM-Argumente hinzu:
    • -Dplan.home=<HCL_Unica_Home>\<Plan_Home>

      Wobei <HCL_Unica_Home> der Pfad zum Basisverzeichnis ist und <Plan_Home> der Pfad zu dem Verzeichnis, in dem Sie Unica Plan installiert haben. Typischerweise ist dieser Pfad HCL_Unica/Plan.

    • -Dclient.encoding.override=UTF-8
    • Stellen Sie sicher, dass die folgenden JVM-Parameter vorhanden sind. Wenn nicht, fügen Sie sie hinzu:
      • Fügen Sie für Version 12.1.0, 12.1.0.1, 12.1.0.2 und 12.1.0.3 die folgenden Parameter hinzu:
        • -Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector
        • -Dlog4j2.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml (in case of fresh install of 12.1)
        • -Dlog4j.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml (in case of fresh install of 12.1)
      • Bei Version 12.1.0.4 fügen Sie, wenn Sie installieren, die folgenden Parameter hinzu. Wenn Sie ein Upgrade von Version 12.1.0 oder höher durchführen, entfernen Sie die oben erwähnten Parameter und fügen Sie die folgenden Parameter hinzu:
        • -Dlog4j.configuration=file:///<Plan_home>\conf\plan_log4j_1x.xml
        • -Dplan.log4j.config=<Plan_home>\conf\plan_log4j.xml
        • -Dplan.log4j.async=true (If not set, deafults to true)
      Anmerkung:
      • Wenn Sie in den Versionen 12.1.0, 12.1.0.1, 12.1.0.2 und 12.1.0.3 plan_log4j.xml die Einstellung plan_log4j.xml angepasst und einige Änderungen vorgenommen haben, um sie an Ihr Unternehmen anzupassen, dann stellen Sie sicher, dass Sie diese Einstellungen in der hier angegebenen -Dlog4j2.configurationFile gemäß der -Dlog4j.configurationFile vornehmen, die wir jetzt für Sie bereitgestellt haben.
      • Wenn Sie in der Version 12.1.0.4 plan_log4j.xml die Einstellung angepasst und einige Änderungen vorgenommen haben, um sie an Ihr Unternehmen anzupassen, dann stellen Sie sicher, dass Sie diese Einstellungen in der hier angegebenen plan_log4j.xml gemäß der -Dplan.log4j.config vornehmen, die wir jetzt für Sie bereitgestellt haben.
      • Stellen Sie in den Versionen 12.1.0, 12.1.0.1, 12.1.0.2 und 12.1.0.3 sicher, dass die xml-Datei, auf die log4j2.configurationFile und log4j.configurationFile zeigen, identisch ist und der log4j2-Syntax folgt. Die Datei muss oben die folgenden zwei Zeilen enthalten:
         <?xml version="1.0" encoding="UTF-8"?>
<Configuration packages="com.unica.afc.logger" monitorInterval="60">
      • Stellen Sie für Version 12.1.0.4 sicher, dass die Datei xml, auf die durch Datei -Dplan.log4j.config verwiesen wird, der Syntax log4j2 folgt. Die Datei muss oben die folgenden zwei Zeilen enthalten:
         <?xml version="1.0" encoding="UTF-8"?>
<Configuration packages="com.unica.afc.logger" monitorInterval="60">
      • Siehe log4j2-Dokumentation, indem Sie auf den Link verweisen: https://logging.apache.org/log4j/2.0/manual/configuration.html
      • In Windows enthält der Dateipfad einen umgekehrten Schrägstrich. In UNIX hingegen muss er einen Schrägstrich enthalten.
      • Das Pfad-Trennzeichen im log4j-Konfigurationsdateinamen sollte als Windows-Stil() oder UNIX (/ ) Stil, basierend auf dem grundlegenden Betriebssystem, gesetzt werden.
  7. Legen Sie die JSP-Kompilierungsebene im WebSphere Application Server auf den Wert 18 fest.

Bereitstellen der WAR-Datei oder der EAR-Datei

Wenn Sie eine neue Unternehmensanwendung bereitstellen, konfrontiert Sie WebSphere Integrated Solutions Console mit einer Reihe von Formularen. Die nachfolgenden Schritte veranschaulichen, welche Einstellungen Sie für bestimmte Steuerelemente in diesen Formularen vornehmen müssen. Die Reihenfolge der Steuerelemente sowie ihre Bezeichnungen können sich je nach Version von WebSphere unterscheiden.

Warum und wann dieser Vorgang ausgeführt wird

Führen Sie die folgenden Schritte aus, um die WAR-Datei oder die EAR-Datei bereitzustellen:

Prozedur

  1. Wählen Sie Anwendungen > Neue Anwendung > Neue Unternehmensanwendungaus.
  2. Wählen Sie im ursprünglichen Formular Fernes Dateisystem und dann Durchsuchen aus und lokalisieren Sie die Datei plan.war bzw. Ihre EAR-Datei.
  3. Gehen Sie im nächsten Fenster Vorbereiten auf die Anwendungsinstallation folgendermaßen vor:
    • Wählen Sie Detailliert aus.
    • Wählen Sie Standardbindungen generieren aus.
    • Wählen Sie Bestehende Bindungen überschreiben aus.
  4. Führen Sie im Fenster Installationsoptionen auswählen die folgenden Aktionen aus:
    • Wählen Sie JavaServer Pages-Dateien vorkompilieren aus.
    • Geben Sie als Anwendungsnamen Plan ein.
    • Wählen Sie Einstellungen für das erneute Laden von Klassen für Web- und EJB-Module überschreiben aus.
    • Geben Sie bei Intervall für erneutes Laden in Sekunden eine ganze Zahl, zum Beispiel 4, ein.
  5. Wählen Sie im Fenster Zuordnen von Modulen zu Servern den Eintrag Modul aus. Falls Sie eine EAR-Datei bereitgestellt haben, wählen Sie sämtliche WAR-Dateien aus.
  6. Wählen Sie im Fenster Optionen für das Kompilieren von JSPs bereitstellen den Eintrag Webmodul aus. Falls Sie eine EAR-Datei bereitgestellt haben, wählen Sie sämtliche WAR-Dateien aus.
  7. Legen Sie die JDK-Quellenebene auf 18 fest.
  8. Wählen Sie im Formular JSP-Optionen des erneuten Ladens für Webmodule den Eintrag JSP erneutes Laden von Klassen aktivieren aus und geben Sie für Intervall des erneuten Ladens von JSP in Sekunden 5 ein.
  9. Wählen Sie im Fenster Gemeinsam genutzte Bibliotheken zuordnen die Anwendung und das Modul aus.
  10. Wählen Sie im Fenster Gemeinsam genutzte Bibliotheksbeziehungen zuordnen die Anwendung und das Modul aus.
  11. Wählen Sie im Fenster Ressourcenverweise Ressourcen zuordnen das Modul aus und geben als JNDI-Namen der Zielressource plands ein.
  12. Geben Sie im Fenster Kontextstammverzeichnis für Webmodule zuordnen für Kontextstammverzeichnis /plan ein.
  13. Überprüfen Sie die Einstellungen und speichern sie.

Definieren der Richtlinie für das Klassenladeprogramm

Die Richtlinie für das Klassenladeprogramm definiert, wie die Anwendung auf WAS konfiguriert ist. Sie müssen einige der Standardeinstellungen auf WAS ändern, bevor Sie Unica Plan bereitstellen.

Warum und wann dieser Vorgang ausgeführt wird

Führen Sie die folgenden Schritte aus, um die Richtlinie für das Klassenladeprogramm festzulegen:

Prozedur

  1. Wählen Sie im Formular Unternehmensanwendungen > Plan > Klassenladeprogrammden Eintrag Einstellungen für das erneute Laden von Klassen für Web- und EJB-Module überschreiben aus.
  2. Wählen Sie bei Reihenfolge der Klassenladeprogramme die Option Mit lokalem Klassenladeprogramm geladene Klassen werden zuerst geladen (übergeordnetes Element zuletzt) aus.
  3. Wählen Sie für Richtlinie für WAR-Klassenladeprogramm den Eintrag Einzelnes Klassenladeprogramm für Anwendung aus.
  4. Klicken Sie auf Anwenden und Einstellungen speichern.

Definieren von Einstellungen für Cookies

Sie müssen die Option Sitzungsmanagement der WebSphere-Unternehmensanwendungen verwenden, um Einstellungen für Cookies zu definieren und festzulegen.

Warum und wann dieser Vorgang ausgeführt wird

Führen Sie die folgenden Schritte aus, um die Einstellungen für Cookies zu definieren:

Prozedur

  1. Wechseln Sie zum Formular Unternehmensanwendungen > plan > Sitzungsmanagement.
  2. Wählen Sie Sitzungsmanagement überschreiben aus.
  3. Wählen Sie Cookies aktivieren aus.
  4. Klicken Sie auf Anwenden und wechseln dann zu Unternehmensanwendungenn > plan > Sitzungsmanagement > Cookies.
  5. Ändern Sie den Unica Plan Cookienamen von JSESSIONID in UMOSESSIONID.
  6. Klicken Sie auf Anwenden und Einstellungen speichern.

Definieren der EAR-Moduleinstellungen

Wenn Sie eine EAR-Datei bereitgestellt haben, müssen Sie die Einstellungen der in der EAR-Datei enthaltenen einzelnen WAR-Dateien definieren.

Warum und wann dieser Vorgang ausgeführt wird

Führen Sie die folgenden Schritte aus, um Moduleinstellungen für die EAR-Datei zu definieren:

Prozedur

  1. Wechseln Sie zu Unternehmensanwendungen und wählen Sie die EAR-Datei aus.
  2. Wählen Sie im Formular Module verwalten eine der WAR-Dateien aus, beispielsweise MktOps.war.
  3. Führen Sie die folgenden Teilschritte im Formular Unternehmensanwendungen > EAR > Module verwalten > WAR aus:
    1. Setzen Sie die Anfangsgewichtung auf 10000.
    2. Wählen Sie bei Reihenfolge der Klassenladeprogramme die Option Mit Anwendungsklassenladeprogramm geladene Klassen zuerst aus.
  4. Wählen Sie Unternehmensanwendungen > EAR > Module verwalten > WAR > Sitzungsmanagement, Cookies aktivieren aus.
  5. Führen Sie unter Unternehmensanwendungen > EAR > Module verwalten > WAR > Sitzungsmanagement Cookies folgenden Schritte aus:
    1. Geben Sie für Cookiename den Wert CMPJSESSIONID an.
    2. Wählen Sie für Maximales Alter des Cookies den Eintrag Aktuelle Browsersitzung aus.
  6. Geben Sie unter Unternehmensanwendungen > EAR > Module verwalten > WAR > Sitzungsmanagement folgenden Informationen ein:
    1. Wählen Sie Überlauf ermöglichen aus.
    2. Geben Sie für Maximalzahl speicherinterner Sitzungen den Wert 1000 ein.
    3. Wählen Sie für Sitzungszeitlimit den Eintrag Zeitlimit eingeben aus und geben Sie den Wert 30 ein.
  7. Definieren Sie dieselben Einstellungen für jede der anderen WAR-Dateien einschließlich unica.war und plan.war.
    Anmerkung: Wenn die Datei Campaign.war in der EAR-Datei vorhanden ist und wenn Sie Unica Plan in Unica Campaign integrieren möchten, definieren Sie die gleichen Einstellungen für die Datei Campaign.war.