Bereitstellen von Unica Plan unter Apache Tomcat

Sie müssen eine Reihe von Richtlinien befolgen, wenn Sie Unica Plan auf Apache Tomcat bereitstellen.

Überprüfen Sie, ob Ihre Version von Apache Tomcat die Anforderungen im Dokument "Von Unica empfohlene Software-Umgebungen und Mindestsystemanforderungen" erfüllt. Befolgen Sie bei der Bereitstellung von Unica Plan auf Apache Tomcat folgende Richtlinien:

Suchen oder erstellen Sie aus dem bin-Verzeichnis unter Ihrem Apache-Tomcat-Installationsverzeichnis das für Ihr Betriebssystem geeignete setenv.sh oder setenv. bat-Script in einem Texteditor und fügen Sie die JAVA_OPTIONS-Eigenschaft hinzu oder ändern Sie sie und fügen Sie die folgenden Einträge hinzu. Trennen Sie die einzelnen Einträge durch ein Leerzeichen.

  • -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. Normalerweise ist dieses Verzeichnis HCL_Unica/Plan.

  • -Dfile.encoding=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.
    • 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.
    • Stellen Sie sicher, dass der Parameter relaxQueryChars im Connector-Tag in conf/server.xml in Tomcat vorhanden ist

      <Connector port="7002" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" relaxedQueryChars="|,[,],\,`,{,},^" />

  1. Stellen Sie die HCL plan.war-Datei als Enterprise-Anwendung auf dem Tomcat-Apache-Server bereit.
    Anmerkung: Die Bereitstellung einer HCL EAR-Datei wird bei Tomcat nicht unterstützt.
  2. Führen Sie die folgenden Aufgaben durch, wenn Ihre Installation Nicht-ASCII-Zeichen unterstützen muss, z. B. für Portugiesisch oder für Ländereinstellungen, die Mehrbytezeichen erfordern.
    1. Bearbeiten Sie die Datei setenv.sh für das jeweilige Produktinstanzen-Script im bin-Verzeichnis unter Ihrem Tomcat-Instanzen-Verzeichnis, um Dfile.encoding=UTF-8 -Dclient.encoding.override=UTF-8 to JAVA_VENDOR hinzuzufügen.
    2. Starten Sie Tomcat erneut.
  3. Bei der Bereitstellung in einer Produktionsumgebung können Sie die JVM-Heap-Einstellung für diese Tomcat-Instanz in der Datei app-one/bin/setenv.sh bzw. für alle Instanzen hinzufügen.