Installieren des Automic Web Interface

Tomcat

WebSphere

WebLogic

Wichtig! Wir empfehlen, dass Sie die AWI-WAR-Datei auf einem dedizierten Anwendungsserver bereitstellen, den Sie ausschließlich zu diesem Zweck verwenden.

Übersicht

Befolgen Sie diese Anweisungen.

1. Laden Sie die AWI-ZIP-Datei herunter und extrahieren Sie sie.

   Laden Sie die ZIP-Datei in unser Download-Center unter https://downloads.automic.com/ herunter und extrahieren Sie die Automic Web Interface-ZIP-Datei. Dieser Screenshot zeigt den Inhalt der ZIP-Datei an:

   

2. StartAWI.

   Standardmäßig wird AWI jedoch mit einer unsicheren Verbindung gestartet (http).

   Folgende Optionen stehen zur Verfügung, um AWI zu starten:

   • Start des AWI unter Verwendung der Kommandozeile

     Öffnen Sie die Kommandozeile, und führen Sie den folgenden Befehl aus:

     java -jar C:\temp\awi\aa-webui-launcher.jar -console

     Der Parameter -console am Ende des Befehls ist optional. Wenn Sie dies festgelegt haben, werden die AWI-Logdateien auf die Konsole und nicht in den Ordner /osgi-tmp geschrieben. Weitere Informationen finden Sie unter .

     Das Automic Web Interface wurde erfolgreich gestartet, wenn die folgende Zeile angezeigt wird:

     2020-06-30 15:45:45,183 46b2-a41e-0d03a9131bd3 [INFO ] NOSESSION/- NOUI [com.uc4.ecc.jetty.JettyServerLauncher] - JettyServerLauncher started: http://localhost:8080/awi

     Hinweise:

     • Die angezeigte Zeile enthält die URL

     • (Optional) Wenn Sie den Port ändern möchten, über den AWI ausgeführt wird, fügen Sie der Datei configuration.properties den folgenden Parameter hinzu:

       http.port=80

   • Starten von AWI unter Verwendung des Service Managers

     1. Fügen Sie dem Service Manager einen neuen Eintrag hinzu.

        

     2. Kopieren Sie den folgenden Befehl und fügen Sie ihn in den Eigenschaftsbereich ein:

        java -Xrs -jar C:\temp\awi\aa-webui-launcher.jar

        

3. Aktivieren Sie TLS/SSL.

   Weitere Informationen finden Sie unter .

4. Konfigurieren Sie die Verbindung zu den Automation Engine-Systemen.

   Sie haben die folgenden Optionen, um die Verbindungen zu Automation Engine-Systemen zu konfigurieren:

   • Verwendung der Konfigurationsdatei uc4config.xml

     Nachdem AWI zum ersten Mal gestartet wurde, wird die Datei uc4config.xml.sample im Order awi\config in Ihrem Installationspfad erstellt. Sie können sie umbenennen (die zusätzliche Erweiterung .sample entfernen) oder eine alte, bereits konfigurierte Datei in diesen Ordner kopieren.

     Mit der Datei uc4config.xml können Sie Verbindungen zu mehr als einem AE-System definieren.

     Wenn Sie mehrere Verbindungen definieren, müssen Sie die Eigenschaft automationEngine.index der Datei configuration.properties konfigurieren. In dieser Eigenschaft definieren Sie, ob Benutzer zwischen diesen Verbindungen auswählen können, oder ob sie nur eine Verbindung zur ersten in uc4config.xml angegebenen Verbindung herstellen können.

     Damit die Änderungen wirksam werden, müssen Sie den Anwendungsserver stoppen und neu starten.

   • Verwendung von Umgebungsvariablen

     Wenn Sie eine Verbindung zum Automic Web Interface mithilfe von Umgebungsvariablen konfigurieren, gilt Folgendes:

     • Wenn Sie sich beim AWI anmelden, ist dies der Name, der im Feld Verbindung und in seiner Dropdown-Liste erscheint.

     • Die Datei uc4config.xml ist nicht mehr erforderlich.

       Sie können jedoch sowohl Umgebungsvariablen als auch uc4config.xml verwenden. Wenn die in der Datei uc4config.xml und in der Umgebungsvariablen verwendeten Verbindungs- und Systemnamen identisch sind, wird die Umgebungsverbindung verwendet. Wenn die Namen unterschiedlich sind, werden beide Verbindungen aufgelistet und können im Feld Verbindung ausgewählt werden.

     • Sie können nur eine Automation Engine-Verbindung definieren.

       Wenn Sie mehr definieren möchten, setzen Sie die Eigenschaft automationEngine.index in der Datei configuration.properties auf einen anderen Wert als -1. Infolgedessen wird die in der Umgebungsvariable definierte AE-Verbindung ignoriert und nicht im Feld Verbindung angezeigt.

     • Wenn Sie eine Umgebungsvariable verwenden, um eine Trace-Ebene zu definieren, überschreibt dieser Wert auch den in der Datei uc4config.xml definierten Wert. Andernfalls wird der Standardwert verwendet.

     Umgebungsvariablen für AE-Verbindungen

     Alle Umgebungsvariablen für AE-Verbindungen müssen das Präfix AUTOMIC gefolgt von einem Unterstrich verwenden: AUTOMIC_.

     Umgebungsvariablen für AE-Verbindungen

     Schlüssel	Beschreibung
     AUTOMIC_SYSTEM_NAME (obligatorisch)	Name des Automation Engine-Systems, zu dem Sie eine Verbindung herstellen möchten. Bei der Anmeldung beim AWI wird im Feld Verbindung und in der Dropdown-Liste der Systemname in Klammern neben dem Verbindungsnamen angezeigt. Beispiel: AUTOMIC_SYSTEM_NAME: AUTOMIC AUTOMIC_CONNECTION_NAME: AE_TEST Verbindung: AE_TEST (AUTOMIC)
     AUTOMIC_CONNECTION_NAME (Optional)	Name der Verbindung. Wenn dieser Wert nicht definiert ist, wird der Systemname auch als Verbindungsname verwendet. Beispiel: AUTOMIC_SYSTEM_NAME: AUTOMIC AUTOMIC_CONNECTION_NAME: Verbindung: AUTOMIC (AUTOMIC)
     AUTOMIC_SYSTEM_CPS (obligatorisch)	Beschreibung: Definition der Verbindung zu den Kommunikationsprozessen (JCPs) des Automation Engine-Systems Wert: Adresse (IP-Adresse:Port) oder (Hostname:Port) der JCPs, getrennt durch ein Semikolon Beispiel: 127.0.0.1:2217;127.0.0.1:2218
     AUTOMIC_TRACE_LEVEL (Optional)	Beschreibung: Trace-Ebene von XML-Vorgängen Zulässige Werte: 0–3 0: Aus 1: Anrufe senden 2: Anrufe empfangen 3: Alle

     Umgebungsvariablen für allgemeine AWI-Eigenschaften

     Sie können auch Umgebungsvariablen verwenden, um benutzerdefinierte Eigenschaftseinstellungen für die Kommunikation zwischen der Automation Engine und dem Automic Web Interface zu definieren. Sie müssen auch für diese Variablen das Präfix AUTOMIC gefolgt von einem Unterstrich verwenden.

     Schlüssel:AUTOMIC_<Eigenschaftsname> (in Großbuchstaben)

     Wert: Eigenschaftswert

     Beispiel:

     AUTOMIC_AUTOMATIONENGINEOPENCONNECTIONTIMEOUTMILLISECONDS=9999

     Wenn der Eigenschaftsname einen Punkt enthält, müssen Sie den Punkt durch einen Unterstrich ersetzen. Beispielsweise muss der Eigenschaftsname für automationEngine.index als AUTOMIC_AUTOMATIONENGINE_INDEX definiert werden.

5. Konfigurieren Sie Ihren Browser.

   • Cookies aktivieren
   • Popup-Blocker deaktivieren
   • Den Cache nach jedem Upgrade leeren

6. Stellen Sie sicher, dass AWI erwartungsgemäß funktioniert (Integritätsprüfung).

   Verwenden Sie die Integritätsprüfung von AWI, um zu überprüfen, ob der Anwendungsserver AWI richtig bereitgestellt hat, und das es ausgeführt wird.

   1. Fügen Sie der URL das Wort status hinzu:

      http://hostName:<port>/AWI/status

   2. Der Standard-Statusantwortcode OK von HTTP 200 wird zurückgegeben und eine Seite mit dem Wort OK wird angezeigt, was darauf hinweist, dass AWI ausgeführt wird. Andernfalls wird die entsprechende standardmäßige HTTP-Meldung angezeigt.

   Sie können dieses Endpunkt für den Systemstatus in Ihren internen URL-Überwachungssystemen verwenden, um sicherzustellen, AWI richtig funktioniert.

   Sie können diesen Endpunkt auch in Shell-Scripts verwenden, um den Status des Automic Web Interface abzurufen.

Lokale Dokumentationsversion

Die Produktdokumentation von Automic Automation ist immer auf dem neuesten Stand und online verfügbar unter docs.automic.com. In Umgebungen, in denen Ihre Benutzer keinen Internetzugang haben, können Sie ihn intern auf einem Webserver Ihrer Wahl hosten. Stellen Sie in diesem Fall Folgendes sicher:

• AWI und die Dokumentation haben die gleiche Browser-Kompatibilität. Weitere Informationen finden Sie unter Kompatibilitätsinformationen oder greifen direkt auf den compatibility matrix zu.

• Der Parameter helpUrl.pattern in der Datei configuration.properties verweist auf den Webserver, auf dem die Dokumentation gehostet wird. Weitere Informationen finden Sie in der .

Speicherort der Logdatei

AWI speichert die Logdateien im Ordner /osgi-tmp. Jede laufende Instanz erstellt einen Unterordner mit einer aufsteigenden Nummer, beginnend mit 0. Die Ordner enthalten sowohl die osgi-bezogenen Daten als auch die AWI-Logdateien.

Ausnahme: Wenn Sie das AWI über die Kommandozeile starten und dem Befehl den Parameter -console hinzufügen, wird das Protokoll stattdessen auf die Konsole geschrieben.

Siehe auch:

AWI wird erfolgreich ausgeführt. Jetzt können Sie mit der Konfiguration beginnen. Die folgenden Themen führen Sie durch die Aktivitäten für die AWI-Konfiguration:

• Konfiguration des Automic Web Interface

  Dieses Thema enthält die folgenden Informationen:

  • Optimierung der Serverkonfigurationsgrößen
  • Sicherung des Zugriffs über TLS
  • Anpassen des Konfigurationspfades
  • Konfigurieren von Login und Benutzerauthentifizierung
  • Logging-Konfiguration
  • Anpassen der Benutzeroberfläche
  • Einrichten des Load Balancers und Konfigurieren von Proxys

• uc4config.xml - Konfigurieren der Verbindung zwischen AWI und AE

  Dieses Thema beschreibt, wie Sie die Verbindung zum Automation Engine-System definieren

• configuration.properties – Lokales Setup konfigurieren

  Dieses Thema beschreibt, wie Sie definieren, wie die Kommunikation zwischen der Automation Engine und dem AWI-Server, der AWI und ihren Mandanten ausgeführt wird.

• logback.xml - Log-Ebenen konfigurieren

  Dieses Thema beschreibt, wie die AWI das Logging handhabt

• colors.properties - Konfigurieren des Farbschemas

  Dieses Thema beschreibt das Konfigurieren des AWI-Farbschemas

Unter Fehlerbehebung bei Problemen mit AWI-Mandanten finden Sie Tipps, wie Sie sicherstellen können, dass Benutzer alle AWI-Teile korrekt sehen und keine Login-Probleme haben.

Nach der Installation und Konfiguration des AWI können Sie mit der Einrichtung Ihres Systems beginnen oder mit der Installation anderer Plug-ins und Komponenten fortfahren.

Weitere Informationen finden Sie unter Voraussetzungen und Installationstypen.

Voraussetzung: Tomcat ist bereits installiert.

Wichtig! Es wird dringend empfohlen, nur eine AWI-Instanz pro Tomcat-Instanz zu installieren.

Übersicht:

1. Erhöhen Sie den Arbeitsspeicher, den Tomcat dem AWI zuweist.
2. Stellen Sie sicher, dass Tomcat automatisch startet.
3. Starten Sie Tomcat.
4. Stellen Sie die WAR-Datei bereit.
5. Konfigurieren Sie die Verbindung zur Automation Engine.
6. Starten Sie AWI.
7. Konfigurieren Sie Ihren Browser.
8. Stellen Sie sicher, dass AWI erwartungsgemäß funktioniert (Integritätsprüfung).

Befolgen Sie diese Anweisungen.

1. Verwenden Sie den Speicherparameter Heap-GrößeTomcat, um den Speicher, den der AWI zuweisen kann, auf mindestens 2 GB zu vergrößern.

   Standardmäßig weist Tomcat einer Anwendung eine geringe Menge an Speicher zu. Dies ist nicht ausreichend für AWI, das viele UI-Zustandsdaten im Speicher behält.

   Windows:

   1. Gehen Sie in den BinTomcat-Ordner Ihrer Tomcat-Installation (...Apache Software Foundation\<version>\bin).
   2. Klicken Sie mit der rechten Maustaste auf die .exe-Datei und wählen Sie im Kontextmenü Als Administrator ausführen.

   3. Stellen Sie auf der Registerkarte Java die Heap-Größe ein, indem Sie den maximalen Speicherpool auf das auf Ihrem System maximal mögliche Maß einstellen, z. B. 8.192 MB (-Xmx8192m).

   Linux:

   Setzen Sie in der Umgebungsvariablen CATALINA_OPTS den Heap-Speicher auf das mögliche Maximum auf Ihrem System, z. B. 8.192 MB.

2. Stellen Sie sicher, dass Tomcat automatisch startet, wenn Sie den Server starten, auf dem es installiert ist, z. B. mit einem Windows-Dienst oder einem Init-Script.

3. Starten Sie und gehen Sie zur Standard-URL, um sicherzustellen, dass es reagiert.Tomcat

4. Stellen Sie die WAR-Datei bereit.

   Kopieren Sie die Datei awi.war in den Ordner webapps der Tomcat-Installation. Wenn Tomcat ausgeführt wird, wird die Datei awi.war automatisch bereitgestellt und ein Ordner mit dem gleichen Namen wird erstellt.

   Wichtig! Das Löschen der Datei awi.war entfernt den entsprechenden Unterordner, womit auch das AWI deaktiviert wird.

5. Konfigurieren Sie die Verbindung zu den Automation Engine-Systemen.

   Sie haben die folgenden Optionen, um die Verbindungen zu Automation Engine-Systemen zu konfigurieren:

   • Verwendung der Konfigurationsdatei uc4config.xml

     Nachdem AWI zum ersten Mal gestartet wurde, wird die Datei uc4config.xml.sample im Order awi\config in Ihrem Installationspfad erstellt. Sie können sie umbenennen (die zusätzliche Erweiterung .sample entfernen) oder eine alte, bereits konfigurierte Datei in diesen Ordner kopieren.

     Mit der Datei uc4config.xml können Sie Verbindungen zu mehr als einem AE-System definieren.

     Wenn Sie mehrere Verbindungen definieren, müssen Sie die Eigenschaft automationEngine.index der Datei configuration.properties konfigurieren. In dieser Eigenschaft definieren Sie, ob Benutzer zwischen diesen Verbindungen auswählen können, oder ob sie nur eine Verbindung zur ersten in uc4config.xml angegebenen Verbindung herstellen können.

     Damit die Änderungen wirksam werden, müssen Sie den Anwendungsserver stoppen und neu starten.

   • Verwendung von Umgebungsvariablen

     Wenn Sie eine Verbindung zum Automic Web Interface mithilfe von Umgebungsvariablen konfigurieren, gilt Folgendes:

     • Wenn Sie sich beim AWI anmelden, ist dies der Name, der im Feld Verbindung und in seiner Dropdown-Liste erscheint.

     • Die Datei uc4config.xml ist nicht mehr erforderlich.

       Sie können jedoch sowohl Umgebungsvariablen als auch uc4config.xml verwenden. Wenn die in der Datei uc4config.xml und in der Umgebungsvariablen verwendeten Verbindungs- und Systemnamen identisch sind, wird die Umgebungsverbindung verwendet. Wenn die Namen unterschiedlich sind, werden beide Verbindungen aufgelistet und können im Feld Verbindung ausgewählt werden.

     • Sie können nur eine Automation Engine-Verbindung definieren.

       Wenn Sie mehr definieren möchten, setzen Sie die Eigenschaft automationEngine.index in der Datei configuration.properties auf einen anderen Wert als -1. Infolgedessen wird die in der Umgebungsvariable definierte AE-Verbindung ignoriert und nicht im Feld Verbindung angezeigt.

     • Wenn Sie eine Umgebungsvariable verwenden, um eine Trace-Ebene zu definieren, überschreibt dieser Wert auch den in der Datei uc4config.xml definierten Wert. Andernfalls wird der Standardwert verwendet.

     Umgebungsvariablen für AE-Verbindungen

     Alle Umgebungsvariablen für AE-Verbindungen müssen das Präfix AUTOMIC gefolgt von einem Unterstrich verwenden: AUTOMIC_.

     Umgebungsvariablen für AE-Verbindungen

     Schlüssel	Beschreibung
     AUTOMIC_SYSTEM_NAME (obligatorisch)	Name des Automation Engine-Systems, zu dem Sie eine Verbindung herstellen möchten. Bei der Anmeldung beim AWI wird im Feld Verbindung und in der Dropdown-Liste der Systemname in Klammern neben dem Verbindungsnamen angezeigt. Beispiel: AUTOMIC_SYSTEM_NAME: AUTOMIC AUTOMIC_CONNECTION_NAME: AE_TEST Verbindung: AE_TEST (AUTOMIC)
     AUTOMIC_CONNECTION_NAME (Optional)	Name der Verbindung. Wenn dieser Wert nicht definiert ist, wird der Systemname auch als Verbindungsname verwendet. Beispiel: AUTOMIC_SYSTEM_NAME: AUTOMIC AUTOMIC_CONNECTION_NAME: Verbindung: AUTOMIC (AUTOMIC)
     AUTOMIC_SYSTEM_CPS (obligatorisch)	Beschreibung: Definition der Verbindung zu den Kommunikationsprozessen (JCPs) des Automation Engine-Systems Wert: Adresse (IP-Adresse:Port) oder (Hostname:Port) der JCPs, getrennt durch ein Semikolon Beispiel: 127.0.0.1:2217;127.0.0.1:2218
     AUTOMIC_TRACE_LEVEL (Optional)	Beschreibung: Trace-Ebene von XML-Vorgängen Zulässige Werte: 0–3 0: Aus 1: Anrufe senden 2: Anrufe empfangen 3: Alle

     Umgebungsvariablen für allgemeine AWI-Eigenschaften

     Sie können auch Umgebungsvariablen verwenden, um benutzerdefinierte Eigenschaftseinstellungen für die Kommunikation zwischen der Automation Engine und dem Automic Web Interface zu definieren. Sie müssen auch für diese Variablen das Präfix AUTOMIC gefolgt von einem Unterstrich verwenden.

     Schlüssel:AUTOMIC_<Eigenschaftsname> (in Großbuchstaben)

     Wert: Eigenschaftswert

     Beispiel:

     AUTOMIC_AUTOMATIONENGINEOPENCONNECTIONTIMEOUTMILLISECONDS=9999

     Wenn der Eigenschaftsname einen Punkt enthält, müssen Sie den Punkt durch einen Unterstrich ersetzen. Beispielsweise muss der Eigenschaftsname für automationEngine.index als AUTOMIC_AUTOMATIONENGINE_INDEX definiert werden.

6. StartAWI.

   1. Geben Sie http://hostName:<port>/AWI/ in die Adressleiste Ihres Internet-Browsers ein:

      • hostName = der Name des Computers, auf dem der Anwendungsserver läuft, z. B. „localhost“

      • <port>= Der Standard-Port für den Anwendungsserver, der je nach Einrichtung des Anwendungsservers variieren kann.

   2. Melden Sie sich am Mandanten 0 mit Ihrem Benutzernamen und Passwort an.

      Mandant 0 ist ein Systemmandant, der standardmäßig mit Ihrer Installation ausgeliefert wird. Hier fügen Sie weitere Mandanten hinzu, legen Benutzer an, ordnen sie ihren entsprechenden Mandanten zu usw. Weitere Informationen finden Sie unter Systemmandant 0000 .

7. Konfigurieren Sie Ihren Browser.

   • Cookies aktivieren
   • Popup-Blocker deaktivieren
   • Den Cache nach jedem Upgrade leeren

8. Stellen Sie sicher, dass AWI erwartungsgemäß funktioniert (Integritätsprüfung).

   Verwenden Sie die Integritätsprüfung von AWI, um zu überprüfen, ob der Anwendungsserver AWI richtig bereitgestellt hat, und das es ausgeführt wird.

   1. Fügen Sie der URL das Wort status hinzu:

      http://hostName:<port>/AWI/status

   2. Der Standard-Statusantwortcode OK von HTTP 200 wird zurückgegeben und eine Seite mit dem Wort OK wird angezeigt, was darauf hinweist, dass AWI ausgeführt wird. Andernfalls wird die entsprechende standardmäßige HTTP-Meldung angezeigt.

   Sie können dieses Endpunkt für den Systemstatus in Ihren internen URL-Überwachungssystemen verwenden, um sicherzustellen, AWI richtig funktioniert.

   Sie können diesen Endpunkt auch in Shell-Scripts verwenden, um den Status des Automic Web Interface abzurufen.

Siehe auch:

AWI wird erfolgreich ausgeführt. Jetzt können Sie mit der Konfiguration beginnen. Die folgenden Themen führen Sie durch die Aktivitäten für die AWI-Konfiguration:

• Konfiguration des Automic Web Interface

  Dieses Thema enthält die folgenden Informationen:

  • Optimierung der Serverkonfigurationsgrößen
  • Sicherung des Zugriffs über TLS
  • Anpassen des Konfigurationspfades
  • Konfigurieren von Login und Benutzerauthentifizierung
  • Logging-Konfiguration
  • Anpassen der Benutzeroberfläche
  • Einrichten des Load Balancers und Konfigurieren von Proxys

• uc4config.xml - Konfigurieren der Verbindung zwischen AWI und AE

  Dieses Thema beschreibt, wie Sie die Verbindung zum Automation Engine-System definieren

• configuration.properties – Lokales Setup konfigurieren

  Dieses Thema beschreibt, wie Sie definieren, wie die Kommunikation zwischen der Automation Engine und dem AWI-Server, der AWI und ihren Mandanten ausgeführt wird.

• logback.xml - Log-Ebenen konfigurieren

  Dieses Thema beschreibt, wie die AWI das Logging handhabt

• colors.properties - Konfigurieren des Farbschemas

  Dieses Thema beschreibt das Konfigurieren des AWI-Farbschemas

Unter Fehlerbehebung bei Problemen mit AWI-Mandanten finden Sie Tipps, wie Sie sicherstellen können, dass Benutzer alle AWI-Teile korrekt sehen und keine Login-Probleme haben.

Nach der Installation und Konfiguration des AWI können Sie mit der Einrichtung Ihres Systems beginnen oder mit der Installation anderer Plug-ins und Komponenten fortfahren.

Weitere Informationen finden Sie unter Voraussetzungen und Installationstypen.

Voraussetzung: WebSphere ist bereits installiert.

Das von WebSphere bereitgestellte JAXB bietet nicht die für AWI erforderliche Konfiguration. Um sicherzustellen, dass es ordnungsgemäß läuft, müssen Sie JAXB deaktivieren und WebSphere wie in den folgenden Schritten beschrieben konfigurieren.

Übersicht:

1. Ändern Sie den Delegierungsmodus des Classloaders.
2. Schalten Sie das Annotation-Scanning für Web Services aus und stellen Sie den korrekten JAXB-Kontext ein.
3. Neustart WebSphere.
4. Stellen Sie die WAR-Datei bereit.
5. Konfigurieren Sie die Verbindung zur Automation Engine.
6. Starten Sie AWI.
7. Konfigurieren Sie Ihren Browser.
8. Stellen Sie sicher, dass AWI erwartungsgemäß funktioniert (Integritätsprüfung).

Befolgen Sie diese Anweisungen:

1. Ändern Sie den ClassLoader-Delegierungsmodus PARENT_FIRST (Standard) auf PARENT_LAST. Führen Sie dazu folgende Schritte aus:

   • Verwenden Sie den WebSphere® Application Server Deployment Editor

   • Verwenden Sie die Kommandozeile

   Wichtig: Wenn Sie andere Anwendungen auf WebSphere ausführen, stellen Sie sicher, dass Sie nur die Classloader-Einstellung für das Automic Web Interface-Modul ändern.

2. Schalten Sie das Annotation-Scanning für Web-Dienste aus und stellen Sie den korrekten JAXB-Kontext wie folgt ein:

   1. Wählen Sie in der WebSphere-Administrationskonsole Server aus.

   2. Erweitern Sie den Servertyp und wählen Sie WebSphere-Anwendung. Wählen Sie den Namen Ihres Servers.

   3. Erweitern Sie Java und Prozessmanagement und wählen Sie Prozessdefinition.

   4. Klicken Sie im Abschnitt Zusätzliche Eigenschaften auf Java Virtual Machine.

   5. Gehen Sie unter Benutzerdefinierte Eigenschaften wie folgt vor:

      1. Setzen Sie die Eigenschaft com.ibm.websphere.webservices.DisableIBMJAXWSEngine auf "true".

         Wenn sie noch nicht existiert, können Sie sie durch einen Klick auf Neu erstellen.

      2. Setzen Sie die Eigenschaft javax.xml.bind.JAXBContext auf com.sun.xml.internal.bind.v2.ContextFactory.

         Wenn sie noch nicht existiert, können Sie sie durch einen Klick auf Neu erstellen.

3. Wiederanlauf WebSphere. Gehen Sie zur Standard-URL, um sicherzustellen, dass sie reagiert.

4. Stellen Sie die WAR-Datei bereit. Weitere Informationen finden Sie in der offiziellen WebSphere-Dokumentation.

   Wenn Sie WebSphere 8.5.5.x verwenden, löschen Sie die folgenden Dateien aus dem AWI-Ordner, bevor Sie die WAR-Datei bereitstellen:

   • WEB-INF/lib/jaxb-api-2.2.11.jar

   • WEB-INF/lib/jaxb-core-2.2.11.jar

   • WEB-INF/lib/jaxb-impl-2.2.11.jar

5. Konfigurieren Sie die Verbindung zu den Automation Engine-Systemen.

   Sie haben die folgenden Optionen, um die Verbindungen zu Automation Engine-Systemen zu konfigurieren:

   • Verwendung der Konfigurationsdatei uc4config.xml

     Nachdem AWI zum ersten Mal gestartet wurde, wird die Datei uc4config.xml.sample im Order awi\config in Ihrem Installationspfad erstellt. Sie können sie umbenennen (die zusätzliche Erweiterung .sample entfernen) oder eine alte, bereits konfigurierte Datei in diesen Ordner kopieren.

     Mit der Datei uc4config.xml können Sie Verbindungen zu mehr als einem AE-System definieren.

     Wenn Sie mehrere Verbindungen definieren, müssen Sie die Eigenschaft automationEngine.index der Datei configuration.properties konfigurieren. In dieser Eigenschaft definieren Sie, ob Benutzer zwischen diesen Verbindungen auswählen können, oder ob sie nur eine Verbindung zur ersten in uc4config.xml angegebenen Verbindung herstellen können.

     Damit die Änderungen wirksam werden, müssen Sie den Anwendungsserver stoppen und neu starten.

   • Verwendung von Umgebungsvariablen

     Wenn Sie eine Verbindung zum Automic Web Interface mithilfe von Umgebungsvariablen konfigurieren, gilt Folgendes:

     • Wenn Sie sich beim AWI anmelden, ist dies der Name, der im Feld Verbindung und in seiner Dropdown-Liste erscheint.

     • Die Datei uc4config.xml ist nicht mehr erforderlich.

       Sie können jedoch sowohl Umgebungsvariablen als auch uc4config.xml verwenden. Wenn die in der Datei uc4config.xml und in der Umgebungsvariablen verwendeten Verbindungs- und Systemnamen identisch sind, wird die Umgebungsverbindung verwendet. Wenn die Namen unterschiedlich sind, werden beide Verbindungen aufgelistet und können im Feld Verbindung ausgewählt werden.

     • Sie können nur eine Automation Engine-Verbindung definieren.

       Wenn Sie mehr definieren möchten, setzen Sie die Eigenschaft automationEngine.index in der Datei configuration.properties auf einen anderen Wert als -1. Infolgedessen wird die in der Umgebungsvariable definierte AE-Verbindung ignoriert und nicht im Feld Verbindung angezeigt.

     • Wenn Sie eine Umgebungsvariable verwenden, um eine Trace-Ebene zu definieren, überschreibt dieser Wert auch den in der Datei uc4config.xml definierten Wert. Andernfalls wird der Standardwert verwendet.

     Umgebungsvariablen für AE-Verbindungen

     Alle Umgebungsvariablen für AE-Verbindungen müssen das Präfix AUTOMIC gefolgt von einem Unterstrich verwenden: AUTOMIC_.

     Umgebungsvariablen für AE-Verbindungen

     Schlüssel	Beschreibung
     AUTOMIC_SYSTEM_NAME (obligatorisch)	Name des Automation Engine-Systems, zu dem Sie eine Verbindung herstellen möchten. Bei der Anmeldung beim AWI wird im Feld Verbindung und in der Dropdown-Liste der Systemname in Klammern neben dem Verbindungsnamen angezeigt. Beispiel: AUTOMIC_SYSTEM_NAME: AUTOMIC AUTOMIC_CONNECTION_NAME: AE_TEST Verbindung: AE_TEST (AUTOMIC)
     AUTOMIC_CONNECTION_NAME (Optional)	Name der Verbindung. Wenn dieser Wert nicht definiert ist, wird der Systemname auch als Verbindungsname verwendet. Beispiel: AUTOMIC_SYSTEM_NAME: AUTOMIC AUTOMIC_CONNECTION_NAME: Verbindung: AUTOMIC (AUTOMIC)
     AUTOMIC_SYSTEM_CPS (obligatorisch)	Beschreibung: Definition der Verbindung zu den Kommunikationsprozessen (JCPs) des Automation Engine-Systems Wert: Adresse (IP-Adresse:Port) oder (Hostname:Port) der JCPs, getrennt durch ein Semikolon Beispiel: 127.0.0.1:2217;127.0.0.1:2218
     AUTOMIC_TRACE_LEVEL (Optional)	Beschreibung: Trace-Ebene von XML-Vorgängen Zulässige Werte: 0–3 0: Aus 1: Anrufe senden 2: Anrufe empfangen 3: Alle

     Umgebungsvariablen für allgemeine AWI-Eigenschaften

     Sie können auch Umgebungsvariablen verwenden, um benutzerdefinierte Eigenschaftseinstellungen für die Kommunikation zwischen der Automation Engine und dem Automic Web Interface zu definieren. Sie müssen auch für diese Variablen das Präfix AUTOMIC gefolgt von einem Unterstrich verwenden.

     Schlüssel:AUTOMIC_<Eigenschaftsname> (in Großbuchstaben)

     Wert: Eigenschaftswert

     Beispiel:

     AUTOMIC_AUTOMATIONENGINEOPENCONNECTIONTIMEOUTMILLISECONDS=9999

     Wenn der Eigenschaftsname einen Punkt enthält, müssen Sie den Punkt durch einen Unterstrich ersetzen. Beispielsweise muss der Eigenschaftsname für automationEngine.index als AUTOMIC_AUTOMATIONENGINE_INDEX definiert werden.

6. StartAWI.

   1. Geben Sie http://hostName:<port>/AWI/ in die Adressleiste Ihres Internet-Browsers ein:

      • hostName = der Name des Computers, auf dem der Anwendungsserver läuft, z. B. „localhost“

      • <port>= Der Standard-Port für den Anwendungsserver, der je nach Einrichtung des Anwendungsservers variieren kann.

   2. Melden Sie sich am Mandanten 0 mit Ihrem Benutzernamen und Passwort an.

      Mandant 0 ist ein Systemmandant, der standardmäßig mit Ihrer Installation ausgeliefert wird. Hier fügen Sie weitere Mandanten hinzu, legen Benutzer an, ordnen sie ihren entsprechenden Mandanten zu usw. Weitere Informationen finden Sie unter Systemmandant 0000 .

7. Konfigurieren Sie Ihren Browser.

   • Cookies aktivieren
   • Popup-Blocker deaktivieren
   • Den Cache nach jedem Upgrade leeren

8. Stellen Sie sicher, dass AWI erwartungsgemäß funktioniert (Integritätsprüfung).

   Verwenden Sie die Integritätsprüfung von AWI, um zu überprüfen, ob der Anwendungsserver AWI richtig bereitgestellt hat, und das es ausgeführt wird.

   1. Fügen Sie der URL das Wort status hinzu:

      http://hostName:<port>/AWI/status

   2. Der Standard-Statusantwortcode OK von HTTP 200 wird zurückgegeben und eine Seite mit dem Wort OK wird angezeigt, was darauf hinweist, dass AWI ausgeführt wird. Andernfalls wird die entsprechende standardmäßige HTTP-Meldung angezeigt.

   Sie können dieses Endpunkt für den Systemstatus in Ihren internen URL-Überwachungssystemen verwenden, um sicherzustellen, AWI richtig funktioniert.

   Sie können diesen Endpunkt auch in Shell-Scripts verwenden, um den Status des Automic Web Interface abzurufen.

Siehe auch:

AWI wird erfolgreich ausgeführt. Jetzt können Sie mit der Konfiguration beginnen. Die folgenden Themen führen Sie durch die Aktivitäten für die AWI-Konfiguration:

• Konfiguration des Automic Web Interface

  Dieses Thema enthält die folgenden Informationen:

  • Optimierung der Serverkonfigurationsgrößen
  • Sicherung des Zugriffs über TLS
  • Anpassen des Konfigurationspfades
  • Konfigurieren von Login und Benutzerauthentifizierung
  • Logging-Konfiguration
  • Anpassen der Benutzeroberfläche
  • Einrichten des Load Balancers und Konfigurieren von Proxys

• uc4config.xml - Konfigurieren der Verbindung zwischen AWI und AE

  Dieses Thema beschreibt, wie Sie die Verbindung zum Automation Engine-System definieren

• configuration.properties – Lokales Setup konfigurieren

  Dieses Thema beschreibt, wie Sie definieren, wie die Kommunikation zwischen der Automation Engine und dem AWI-Server, der AWI und ihren Mandanten ausgeführt wird.

• logback.xml - Log-Ebenen konfigurieren

  Dieses Thema beschreibt, wie die AWI das Logging handhabt

• colors.properties - Konfigurieren des Farbschemas

  Dieses Thema beschreibt das Konfigurieren des AWI-Farbschemas

Unter Fehlerbehebung bei Problemen mit AWI-Mandanten finden Sie Tipps, wie Sie sicherstellen können, dass Benutzer alle AWI-Teile korrekt sehen und keine Login-Probleme haben.

Nach der Installation und Konfiguration des AWI können Sie mit der Einrichtung Ihres Systems beginnen oder mit der Installation anderer Plug-ins und Komponenten fortfahren.

Weitere Informationen finden Sie unter Voraussetzungen und Installationstypen.

Voraussetzung: WebLogic ist bereits installiert. Das Automic Web Interface erfordert keine spezifische WebLogic-Konfiguration.

Übersicht:

1. Stellen Sie die WAR-Datei bereit.
2. Konfigurieren Sie die Verbindung zur Automation Engine.
3. Starten Sie AWI
4. Konfigurieren Sie Ihren Browser.
5. Stellen Sie sicher, dass AWI erwartungsgemäß funktioniert (Integritätsprüfung).

Befolgen Sie diese Anweisungen:

1. Stellen Sie die WAR-Datei bereit. Weitere Informationen finden Sie in der offiziellen WebLogic-Dokumentation.

2. Konfigurieren Sie die Verbindung zu den Automation Engine-Systemen.

   Sie haben die folgenden Optionen, um die Verbindungen zu Automation Engine-Systemen zu konfigurieren:

   • Verwendung der Konfigurationsdatei uc4config.xml

     Nachdem AWI zum ersten Mal gestartet wurde, wird die Datei uc4config.xml.sample im Order awi\config in Ihrem Installationspfad erstellt. Sie können sie umbenennen (die zusätzliche Erweiterung .sample entfernen) oder eine alte, bereits konfigurierte Datei in diesen Ordner kopieren.

     Mit der Datei uc4config.xml können Sie Verbindungen zu mehr als einem AE-System definieren.

     Wenn Sie mehrere Verbindungen definieren, müssen Sie die Eigenschaft automationEngine.index der Datei configuration.properties konfigurieren. In dieser Eigenschaft definieren Sie, ob Benutzer zwischen diesen Verbindungen auswählen können, oder ob sie nur eine Verbindung zur ersten in uc4config.xml angegebenen Verbindung herstellen können.

     Damit die Änderungen wirksam werden, müssen Sie den Anwendungsserver stoppen und neu starten.

   • Verwendung von Umgebungsvariablen

     Wenn Sie eine Verbindung zum Automic Web Interface mithilfe von Umgebungsvariablen konfigurieren, gilt Folgendes:

     • Wenn Sie sich beim AWI anmelden, ist dies der Name, der im Feld Verbindung und in seiner Dropdown-Liste erscheint.

     • Die Datei uc4config.xml ist nicht mehr erforderlich.

       Sie können jedoch sowohl Umgebungsvariablen als auch uc4config.xml verwenden. Wenn die in der Datei uc4config.xml und in der Umgebungsvariablen verwendeten Verbindungs- und Systemnamen identisch sind, wird die Umgebungsverbindung verwendet. Wenn die Namen unterschiedlich sind, werden beide Verbindungen aufgelistet und können im Feld Verbindung ausgewählt werden.

     • Sie können nur eine Automation Engine-Verbindung definieren.

       Wenn Sie mehr definieren möchten, setzen Sie die Eigenschaft automationEngine.index in der Datei configuration.properties auf einen anderen Wert als -1. Infolgedessen wird die in der Umgebungsvariable definierte AE-Verbindung ignoriert und nicht im Feld Verbindung angezeigt.

     • Wenn Sie eine Umgebungsvariable verwenden, um eine Trace-Ebene zu definieren, überschreibt dieser Wert auch den in der Datei uc4config.xml definierten Wert. Andernfalls wird der Standardwert verwendet.

     Umgebungsvariablen für AE-Verbindungen

     Alle Umgebungsvariablen für AE-Verbindungen müssen das Präfix AUTOMIC gefolgt von einem Unterstrich verwenden: AUTOMIC_.

     Umgebungsvariablen für AE-Verbindungen

     Schlüssel	Beschreibung
     AUTOMIC_SYSTEM_NAME (obligatorisch)	Name des Automation Engine-Systems, zu dem Sie eine Verbindung herstellen möchten. Bei der Anmeldung beim AWI wird im Feld Verbindung und in der Dropdown-Liste der Systemname in Klammern neben dem Verbindungsnamen angezeigt. Beispiel: AUTOMIC_SYSTEM_NAME: AUTOMIC AUTOMIC_CONNECTION_NAME: AE_TEST Verbindung: AE_TEST (AUTOMIC)
     AUTOMIC_CONNECTION_NAME (Optional)	Name der Verbindung. Wenn dieser Wert nicht definiert ist, wird der Systemname auch als Verbindungsname verwendet. Beispiel: AUTOMIC_SYSTEM_NAME: AUTOMIC AUTOMIC_CONNECTION_NAME: Verbindung: AUTOMIC (AUTOMIC)
     AUTOMIC_SYSTEM_CPS (obligatorisch)	Beschreibung: Definition der Verbindung zu den Kommunikationsprozessen (JCPs) des Automation Engine-Systems Wert: Adresse (IP-Adresse:Port) oder (Hostname:Port) der JCPs, getrennt durch ein Semikolon Beispiel: 127.0.0.1:2217;127.0.0.1:2218
     AUTOMIC_TRACE_LEVEL (Optional)	Beschreibung: Trace-Ebene von XML-Vorgängen Zulässige Werte: 0–3 0: Aus 1: Anrufe senden 2: Anrufe empfangen 3: Alle

     Umgebungsvariablen für allgemeine AWI-Eigenschaften

     Sie können auch Umgebungsvariablen verwenden, um benutzerdefinierte Eigenschaftseinstellungen für die Kommunikation zwischen der Automation Engine und dem Automic Web Interface zu definieren. Sie müssen auch für diese Variablen das Präfix AUTOMIC gefolgt von einem Unterstrich verwenden.

     Schlüssel:AUTOMIC_<Eigenschaftsname> (in Großbuchstaben)

     Wert: Eigenschaftswert

     Beispiel:

     AUTOMIC_AUTOMATIONENGINEOPENCONNECTIONTIMEOUTMILLISECONDS=9999

     Wenn der Eigenschaftsname einen Punkt enthält, müssen Sie den Punkt durch einen Unterstrich ersetzen. Beispielsweise muss der Eigenschaftsname für automationEngine.index als AUTOMIC_AUTOMATIONENGINE_INDEX definiert werden.

3. StartAWI.

   1. Geben Sie http://hostName:<port>/AWI/ in die Adressleiste Ihres Internet-Browsers ein:

      • hostName = der Name des Computers, auf dem der Anwendungsserver läuft, z. B. „localhost“

      • <port>= Der Standard-Port für den Anwendungsserver, der je nach Einrichtung des Anwendungsservers variieren kann.

   2. Melden Sie sich am Mandanten 0 mit Ihrem Benutzernamen und Passwort an.

      Mandant 0 ist ein Systemmandant, der standardmäßig mit Ihrer Installation ausgeliefert wird. Hier fügen Sie weitere Mandanten hinzu, legen Benutzer an, ordnen sie ihren entsprechenden Mandanten zu usw. Weitere Informationen finden Sie unter Systemmandant 0000 .

4. Konfigurieren Sie Ihren Browser.

   • Cookies aktivieren
   • Popup-Blocker deaktivieren
   • Den Cache nach jedem Upgrade leeren

5. Stellen Sie sicher, dass AWI erwartungsgemäß funktioniert (Integritätsprüfung).

   Verwenden Sie die Integritätsprüfung von AWI, um zu überprüfen, ob der Anwendungsserver AWI richtig bereitgestellt hat, und das es ausgeführt wird.

   1. Fügen Sie der URL das Wort status hinzu:

      http://hostName:<port>/AWI/status

   2. Der Standard-Statusantwortcode OK von HTTP 200 wird zurückgegeben und eine Seite mit dem Wort OK wird angezeigt, was darauf hinweist, dass AWI ausgeführt wird. Andernfalls wird die entsprechende standardmäßige HTTP-Meldung angezeigt.

   Sie können dieses Endpunkt für den Systemstatus in Ihren internen URL-Überwachungssystemen verwenden, um sicherzustellen, AWI richtig funktioniert.

   Sie können diesen Endpunkt auch in Shell-Scripts verwenden, um den Status des Automic Web Interface abzurufen.

Siehe auch:

AWI wird erfolgreich ausgeführt. Jetzt können Sie mit der Konfiguration beginnen. Die folgenden Themen führen Sie durch die Aktivitäten für die AWI-Konfiguration:

• Konfiguration des Automic Web Interface

  Dieses Thema enthält die folgenden Informationen:

  • Optimierung der Serverkonfigurationsgrößen
  • Sicherung des Zugriffs über TLS
  • Anpassen des Konfigurationspfades
  • Konfigurieren von Login und Benutzerauthentifizierung
  • Logging-Konfiguration
  • Anpassen der Benutzeroberfläche
  • Einrichten des Load Balancers und Konfigurieren von Proxys

• uc4config.xml - Konfigurieren der Verbindung zwischen AWI und AE

  Dieses Thema beschreibt, wie Sie die Verbindung zum Automation Engine-System definieren

• configuration.properties – Lokales Setup konfigurieren

  Dieses Thema beschreibt, wie Sie definieren, wie die Kommunikation zwischen der Automation Engine und dem AWI-Server, der AWI und ihren Mandanten ausgeführt wird.

• logback.xml - Log-Ebenen konfigurieren

  Dieses Thema beschreibt, wie die AWI das Logging handhabt

• colors.properties - Konfigurieren des Farbschemas

  Dieses Thema beschreibt das Konfigurieren des AWI-Farbschemas

Unter Fehlerbehebung bei Problemen mit AWI-Mandanten finden Sie Tipps, wie Sie sicherstellen können, dass Benutzer alle AWI-Teile korrekt sehen und keine Login-Probleme haben.

Nach der Installation und Konfiguration des AWI können Sie mit der Einrichtung Ihres Systems beginnen oder mit der Installation anderer Plug-ins und Komponenten fortfahren.

Weitere Informationen finden Sie unter Voraussetzungen und Installationstypen.