Bereitstellen von Asset Picker

Voraussetzungen

  • Stellen Sie sicher, dass JRE 1.8 oder höher für Asset Picker geeignet ist.
    Anmerkung: Asset Picker unterstützt keine Clusterumgebung.
  • Die UnicaPlatformDS JNDI-Ressource für die Platform-Datenbank ist für Asset Picker erforderlich. In diesem Handbuch erfahren Sie, wie Sie die UnicaPlatformDS-Datenquelle einrichten.

Festlegen eines JVM-Arguments im Installationsverzeichnis von Asset Picker

  1. Fügen Sie das folgende JVM-Argument dem Anwendungsserver hinzu, auf dem Asset Picker bereitgestellt werden soll.

    -DASSET_PICKER_HOME= path_where_asset_picker_is_installed

    Zum Beispiel: ASSET_PICKER_HOME =/opt/Platform/AssetPicker

    Verweisen Sie mit ASSET_PICKER_HOME auf das Verzeichnis, in dem Asset Picker installiert ist. Es wird im AssetPicker-Verzeichnis unter UNICA_PLATFORM_HOME installiert.

  2. Erteilen Sie Schreibberechtigungen für das Protokollverzeichnis, das bereits in ASSET_PICKER_HOME erstellt wurde.

Vorgehensweise bei der Bereitstellung

Sie müssen eine Reihe von Richtlinien befolgen, wenn Sie Asset Picker auf Ihrem Webanwendungsserver bereitstellen. Für die Bereitstellung von Asset Picker unter WebLogic und WebSphere gelten andere Richtlinien. Wenn Sie das Suite-Installationsprogramm ausgeführt haben, dann haben Sie folgende Aktion durchgeführt:
  • Sie haben die WAR-Datei von Asset Picker (asset-viewer.war) im Verzeichnis UNICA_PLATFORM_HOME/AssetPicker erstellt. UNICA_PLATFORM_HOME bezieht sich auf die Installationsposition von Unica Platform.
Anmerkung: Es wird vorausgesetzt, dass Sie Informationen zur Funktionsweise Ihres Webanwendungsservers besitzen. Weitere Informationen finden Sie in der Dokumentation zum Webanwendungsserver.

Richtlinien zur Bereitstellung von Asset Picker unter WebLogic

Sie müssen eine Reihe von Richtlinien befolgen, wenn Sie Asset Picker in der WebLogic-Anwendung bereitstellen. Befolgen Sie bei der Bereitstellung von Asset Picker in einer unterstützten Version von WebLogic die folgenden Richtlinien:

  • Unica-Produkte passen die von WebLogic verwendete Java Virtual Machine (JVM) an. Wenn Sie auf Fehler im Zusammenhang mit JVM stoßen, können Sie eine WebLogic-Instanz erstellen, die den Unica-Produkten zugeordnet ist.
  • Öffnen Sie die Datei startWebLogic.cmd und prüfen Sie, ob das für die WebLogic-Domäne ausgewählte SDK, das Sie verwenden, das Sun SDK für die Variable JAVA_VENDOR ist.
  • Die Variable JAVA_VENDOR muss auf Sun (JAVA_VENDOR=Sun) festgelegt sein. Wenn die Variable JAVA_VENDOR auf JAVA_VENDOR festgelegt ist, bedeutet dies, dass JRockit ausgewählt ist. Sie müssen das ausgewählte SDK ändern, weil JRockit nicht unterstützt wird. Weitere Informationen zum Ändern des ausgewählten SDK finden Sie in der Dokumentation zu BEA WebLogic.
  • Stellen Sie Asset Picker als Webanwendung bereit.
  • Weitere Informationen zum Konfigurieren von WebLogic für die Verwendung des IIS-Plug-ins finden Sie in der Dokumentation zu BEA WebLogic.
  • Führen Sie die folgenden Aufgaben durch, damit Ihre Installation Nicht-ASCII-Zeichen unterstützt, z. B. für Portugiesisch oder für Ländereinstellungen, die Mehrbytezeichen erfordern.
    1. Bearbeiten Sie das Script setDomainEnv im bin-Verzeichnis des WebLogic-Domänenverzeichnisses so, dass -Dfile.encoding=UTF-8 to JAVA_VENDOR hinzugefügt wird.
    2. Klicken Sie in der WebLogic-Konsole auf der Startseite auf den Link Domäne.
    3. Aktivieren Sie auf der Registerkarte Webanwendungendas Kontrollkästchen Archivierter realer Pfad aktiviert.
    4. Starten Sie WebLogic neu.
    5. Stellen Sie die Datei asset-viewer.war bereit und starten Sie sie.
  • Wenn Sie die Bereitstellung in einer Produktionsumgebung vornehmen, setzen Sie die Parameter für die Größe des JVM-Heapspeichers auf 1024, indem Sie folgende Zeile zum setDomainEnv script: Set MEM_ARGS=-Xms1024m -Xmx1024m -XX:MaxPermSize=256m hinzufügen.

Richtlinien zur Bereitstellung von Asset Picker unter WebSphere®

Sie müssen eine Reihe von Richtlinien befolgen, wenn Sie Asset Picker unter WebSphere bereitstellen. Stellen Sie sicher, dass die Version von WebSphere die im Dokument Empfohlene Softwareumgebungen und Mindestsystemvoraussetzungen beschriebenen Anforderungen erfüllt, einschließlich erforderlicher Fixpacks. Befolgen Sie bei der Bereitstellung von Asset Picker unter WebSphere die folgenden Richtlinien:
  1. Geben Sie die folgende benutzerdefinierte Eigenschaft im Server an:
    • Name: com.ibm.ws.webcontainer.invokefilterscompatibility
    • Wert: true
  2. Stellen Sie die Datei asset-viewer.war als Unternehmensanwendung bereit. Wenn Sie die Datei asset-viewer.war bereitstellen, stellen Sie sicher, dass die JDK-Quellenebene für SDK 1.8 auf 18 festgelegt ist:
    1. Wählen Sie im Formular die WAR-Datei und anschließend die Option Alle Installationsoptionen und Parameter anzeigen aus, sodass der Assistent Installationsoptionen auswählen ausgeführt wird.
    2. Stellen Sie in Schritt 3 des Assistenten Installationsoptionen auswählen sicher, dass die JDK-Quellenebene für SDK 1.8 auf 18 festgelegt ist.
    3. Wählen Sie in Schritt 8 des Assistenten Installationsoptionen auswählen UnicaPlatformDS als passende Zielressource aus. Die UnicaPlatformDS JNDI-Ressource muss für Asset Picker vorhanden sein. Im Handbuch erfahren Sie, wie Sie die UnicaPlatformDS-Datenquelle einrichten.
    4. In Schritt 10 des Assistenten Installationsoptionen auswählen muss das Kontextstammverzeichnis auf /asset-viewer (alles in Kleinbuchstaben) festgelegt werden.
  3. Fügen Sie die folgenden Argumente zu den generischen JVM-Argumenten auf Serverebene hinzu, damit Ihre Installation Nicht-ASCII-Zeichen unterstützt, z. B. für Portugiesisch oder für Ländereinstellungen, die Mehrbytezeichen erfordern.
    • -Dfile.encoding=UTF-8
    • -Dclient.encoding.override=UTF-8
    Anmerkung: Hinweis zur Navigation: Wählen Sie Server > Anwendungsserver > Java und Prozessmanagement > Prozessdefinition > Virtuelle Java-Maschine > Generische JVM-Argumente. Weitere Einzelheiten finden Sie in der WebSphere-Dokumentation.
  4. Wählen Sie im Abschnitt Anwendungen > Unternehmensanwendungen des Servers die WAR-Datei aus, die Sie bereitgestellt haben, wählen Sie dann Laden von Klassen und Aktualisierungserkennung aus und legen Sie die folgenden Eigenschaften fest.
    • Wählen Sie als Reihenfolge der Klassenladeprogramme die Option Mit dem lokalen Klassenladeprogramm geladene Klassen zuerst (übergeordnete zuletzt) aus.
    • Wählen Sie für Richtlinie für WAR-Klassenladeprogramm den Eintrag Einzelnes Klassenladeprogramm für Anwendung aus.
  5. Starten Sie die Bereitstellung. Wenn die WebSphere-Instanz für die Verwendung einer JVM-Version ab 1.7 konfiguriert ist, führen Sie die folgenden Schritte aus, um einen Fehler mit der Zeitzonendatenbank zu umgehen.
    1. Stoppen Sie WebSphere.
    2. Laden Sie das Dienstprogramm zur Zeitzonenaktualisierung für Java (JTZU) herunter.
    3. Führen Sie die vom IBM Tool JTZU bereitgestellten Schritte durch, um die Zeitzonendaten in der JVM zu aktualisieren.
    4. Starten Sie WebSphere erneut.
  6. Wählen Sie in WebSphere-Unternehmensanwendungen Ihre Anwendung > Module verwalten > Ihre Anwendung > Reihenfolge für Klassenladeprogramm > Mit dem lokalen Klassenladeprogramm geladene Klassen zuerst (übergeordnete zuletzt) aus.
  7. Die empfohlene Mindestgröße des Heapspeichers für die grundlegenden Funktionen der Anwendung ist 512 und die empfohlene maximale Größe des Heapspeichers ist 1024. Führen Sie folgende Aufgaben aus, um die Größe des Heapspeichers festzulegen.
    1. Wählen Sie in WebSphere-Unternehmensanwendungen Server > WebSphere-Anwendungsserver > Server1 > Serverinfrastruktur > Java und Prozessmanagement > Prozessdefinition > Java Virtual Machine aus.
    2. Setzen Sie die Anfangsgröße des Heapspeichers auf 512.
    3. Setzen Sie die maximale Größe des Heapspeichers auf 1024.
      Anmerkung: Weitere Informationen zur Dimensionierung finden Sie in der WebSphere-Dokumentation.

Setzen Sie bei DB2 progressiveStreaming = 2 in der WebSphere-Konsole unter folgendem Pfad: JDBC > Datenquellen > UnicaPlatformDS > Angepasste Eigenschaften.

Richtlinien zur Bereitstellung von Asset Picker unter JBOSS

Sie müssen eine Reihe von Richtlinien befolgen, wenn Sie Asset Picker unter JBoss bereitstellen. Stellen Sie sicher, dass die Version von JBoss die im Dokument Empfohlene Softwareumgebungen und Mindestsystemvoraussetzungen beschriebenen Anforderungen erfüllt. Befolgen Sie bei der Bereitstellung von Asset Picker unter JBoss die folgenden Richtlinien:

Befolgen Sie bei der Bereitstellung des Produkts Asset Picker in einer unterstützten Version von JBoss die folgenden Richtlinien:
  1. Stellen Sie die Datei asset-viewer.war als Unternehmensanwendung bereit. Anweisungen zur Bereitstellung der Webserveranwendung unter JBoss finden Sie unter https://docs.jboss.org/jbossweb/3.0.x/deployer-howto.html.
  2. Führen Sie die folgende Aufgabe durch, wenn Ihre Installation Nicht-ASCII-Zeichen unterstützen muss, z. B. für Portugiesisch oder für Ländereinstellungen, die Mehrbytezeichen erfordern.
    • Bearbeiten Sie das folgende standalone.conf-Script im bin-Verzeichnis unter Ihrem JBOSS /bin-Verzeichnis, um JAVA_VENDOR hinzuzufügen.
      • -Dfile.encoding=UTF-8
      • -Dclient.encoding.override=UTF-8
      • -Djboss.as.management.blocking.timeout=3600
  3. Starten Sie den JBOSS-Server erneut.

Richtlinien zur Bereitstellung von Asset Picker unter Apache Tomcat®

Sie müssen eine Reihe von Richtlinien befolgen, wenn Sie Asset Picker unter 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 Asset Picker unter Apache Tomcat die folgenden Richtlinien.
  1. Stellen Sie die HCL-Datei asset-viewer.war als Unternehmensanwendung auf dem Tomcat Apache-Server bereit. 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.
  2. 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.

Asset Picker | Erstellung von Benutzerrollen

Das in diesem Abschnitt beschriebene Verfahren ist für die folgenden Szenarien nicht erforderlich:
  • Es handelt sich um eine neue Installation. Der Installationsprozess erstellt diese Rolle unter der Standardpartition (Partition1).
  • Es handelt sich um ein Upgrade und im aktuellen System existiert nur eine Partition.

Falls es sich um ein Upgrade handelt und das System mehr als eine Partition enthält, müssen Sie den folgenden Befehl für jede Partition mit Ausnahme von Partition1 manuell ausführen. Der Befehl existiert unter dem Verzeichnis <PLATFORM_HOME>\tools\bin innerhalb Ihres Platform-Installationsverzeichnisses. Dadurch wird die Asset Picker-Benutzerrolle unter jeder Partition erstellt.

Windows

populateDb.bat -n AssetPicker -p <partition_name>

Unter Unix

populateDb.sh -n AssetPicker -p <partition_name>