Upgrade eines AE-Systems von Version 12.2 auf Version 21.0

Als Systemadministrator aktualisieren Sie Ihr bestehendes Automation Engine-System auf die neueste Version.

Wichtig!

  • Es wird dringend empfohlen, die Upgrade-Schritte in der Reihenfolge durchzuführen, wie sie in der CAPKI-Dokumentation aufgeführt sind, siehe CAPKI - Sicherung des ServiceManagers.

  • Aktualisieren Sie niemals ein produktives AE-System, ohne es in einer separaten Umgebung ausgiebig getestet zu haben.

  • Wenn Sie von einer Automation Engine-Version upgraden möchten, die nicht mehr gewartet wird, oder Hilfe bei Ihrem Upgrade benötigen, wenden Sie sich bitte an unsere Support-Abteilung, siehe Support.

  • Automation Engine und Automic Web Interface müssen dieselbe Hauptversion und dasselbe Service Pack aufweisen.

  • Wenn Automation Engine und Automic Web Interface im selben Hotfix gebündelt sind, müssen sie sich auf derselben Hauptversion, demselben Service Pack und demselben Hotfix befinden.

  • Wenn Sie die AE manuell ohne ZDU aktualisieren, starten die Arbeitsprozesse (WPs) immer kalt. Wenn Sie mit ZDUaktualisieren, ist kein Kaltstart erforderlich.

Voraussetzungen

  1. Überprüfung auf Inkompatibilitäten zwischen Version 12.3 und 21.0

  2. Überprüfung auf Inkompatibilitäten zwischen Version 12.2 und 12.3

  3. Vorbereitung auf das Upgrade

Installationsschritte

  1. Herunterfahren des Systems
  2. Duplizieren der Umgebung
  3. Aktualisieren der Dienstprogramm-Binärdateien
  4. Aktualisieren der AE-Datenbank
  5. Aktualisieren der verbleibenden Binärdateien
  6. Inbetriebnahme des Systems
  7. Aktualisierung der restlichen Komponenten

Die Installationsschritte betreffen die folgenden Komponenten:

Kommunikationsprozesse (CPs/JCPs) werden verwendet, um bestimmte Komponenten (z. B. Agenten und User Interfaces) mit den Arbeitsprozessen (WPs) zu verbinden und deren Kommunikation zu steuern. Der REST-Prozess stellt einen REST-Endpunkt für die Automation Engine zur Verfügung.

JWP steht für Java-basierte Arbeitsprozesse und JCP für Java-basierte Kommunikationsprozesse.

Weitere Informationen finden Sie unter Serverprozesstypen.

Wichtig! Ab Version 21.0 stellt der REST-Prozess den REST-Endpunkt für die Automation Engineanstelle des JCP zur Verfügung. Wenn Sie auf diese Version aktualisieren, wird die aktuelle (Basis-)Version des JCP zum REST-Prozess auf der Zielversion. Der neue JCP muss in einem separaten Schritt gestartet werden.

Herunterfahren des Systems

  1. Stoppen aller Mandanten.

    Stoppen Sie alle Mandanten, wenn Sie ein Upgrade durchführen möchten. Dies ist in der Systemsteuerung des Mandanten 0 einfach möglich.

    Weitere Informationen finden Sie unter Mandanten via Application Interface starten / stoppen.

  2. Stoppen der AE-Serverprozesse.

    Hinweis: Wenn Sie in einer verteilten Serverumgebung arbeiten, werden alle Serverprozesse auf allen beteiligten Computern deaktiviert. Achten Sie auch auf Programme wie Watchdogs, Cluster-Monitoring usw., bevor Sie die Serverprozesse beenden. Sie könnten einen Alarm auslösen oder die Automation Engine neu starten.

    Sie können die Serverprozesse mit dem Kontextmenübefehl Shutdown stoppen (AE-System) :SHUTDOWN.

  3. Stoppen des Service Manager.

    • Windows: UCYBSMCL[.EXE] -c STOP_PROCESS -h Computername -n Phrase -s Dienstname [-m Stoppmodus] [-p Passwort].

    • Unix: ucybsmcl -c STOP_PROCESS -h Computername :Portnummer -n Phrase -s Dienstname [-m Passwort] [-p Passwort].

Duplizieren der Umgebung

  1. Duplizieren Sie die Utility-Binärdateien (Utilities/Bin).

  2. Duplizieren Sie die AE-Datenbank.

    3. Wie bereits im Abschnitt über Vorbereitungen beschrieben, bietet die Erstellung einer Datenbankkopie viele Vorteile. Duplizieren Sie sie jetzt, wenn Sie sich für diesen Schritt entschieden, ihn aber noch nicht ausgeführt haben. Wenn bereits zu einem früheren Zeitpunkt ein Datenbankduplikat erstellt wurde, prüfen Sie, ob dieses Duplikat aktualisiert werden muss.

Aktualisieren der Dienstprogramm-Binärdateien

Verwenden Sie immer ein separates Verzeichnis, um ein Vermischen der Dateien der verschiedenen Automation Engine-Versionen zu vermeiden. Je nach Computer installieren Sie entweder eine oder mehrere Komponenten.

  1. Erstellen Sie zunächst einen Ordner, dessen Name die Version der Automation Engine repräsentiert. Erstellen Sie dann für jede Komponente einen eigenen Unterordner.

  2. Dienstprogramme installieren, siehe Installation der Dienstprogramme - UNIX oder Installation der Dienstprogramme - Windows.

  3. Kopieren Sie den DB-Ordner aus dem heruntergeladenen Paket in das Verzeichnis der Dienstprogramme. Es enthält die Dateien zum Laden der AE-Datenbank. Der DB-Ordner muss ein paralleler Ordner des BIN-Verzeichnisses der Dienstprogramme sein.

    Beispiel für Windows

    Dienstprogramm in C:\AUTOMIC\UTILITY\BIN

    Datenbankdateien in C:\AUTOMIC\UTILITY\DB

Aktualisieren der AE-Datenbank

Hinweise:

  • Es wird empfohlen, dass ein Datenbankadministrator die folgenden Schritte ausführt.

  • Direkte Änderungen, die an Datenbankinhalten ohne Verwendung von AE-Programmen vorgenommen werden, führen zu einer inkonsistenten Datenbank.

  • Führen Sie immer eine Datenbanksicherung durch, bevor Sie Arbeitsschritte durchführen.

  • Dieser Prozess kann je nach Datenbankgröße und Komplexität des Upgrades einige Zeit in Anspruch nehmen.

  • Stellen Sie sicher, dass genügend Speicherplatz für das Verzeichnis \AUTOMIC\DB vorhanden ist und dass der LOG-Bereich der Datenbank all diese Daten speichern kann.

  • Schemata, die den Zugriff auf die Datenbank ermöglichen, sollten nach dem Aktualisierungsprozess entfernt werden, um unbeabsichtigte Datenbankänderungen zu vermeiden.

  • (DB2) Überprüfen Sie nach dem Aktualisieren der AE-Datenbank die Größe der Tablespaces und führen Sie bei Bedarf die folgende SQL-Anweisung aus:

    Alter tablespace <UC4 Tablespace-Name> reduce max:

  • Das DB-Verzeichnis des Installations-Images kann mehrere Versionen von SQL-Scripts und Datenbankdateien enthalten. Sie sind erforderlich, wenn Sie mehrere Versionen aktualisieren. Achten Sie darauf, die richtige Version zu verwenden, wenn <vers> im Dokument angegeben ist.

  • Änderungen, die vorgenommen werden sollen, sind in der Datei special_rt.sql verfügbar. Führen Sie auch die Datei new_mq.sql aus.

  • Das DB Load-Log enthält möglicherweise die Meldung U00038042 Aktion erforderlich! Überprüfen Sie, ob der Index NK_AH_IDNR_bearb mit der Definition in uc_ddl.sql übereinstimmt. In diesem Fall müssen Sie den NK_AH_IDNR_bearb-Index manuell aktualisieren, weil eine automatische Aktualisierung sehr lange dauern könnte. Sie müssen dies aber nicht während der Ausführung von DB Load machen, sondern können es später erledigen.

Die Datenbank mit dem Dienstprogramm AE DB Load aktualisieren

  1. Ändern des Datenbankschemas und laden neuer Initialdaten in die Datenbank.

    • Auf dem Servercomputer müssen alle Serverprozesse gestoppt werden. Achten Sie besonders darauf, wenn Serverprozesse auf mehreren Computern laufen. Schließen Sie alle Komponenten und beenden Sie alle aktiven Aufgaben wie Ereignisse, Schedules und so weiter. Die EH-Tabelle sollte keine Datensätze enthalten.

      Dies gilt nur, wenn Sie die AE auf ein anderes Betriebssystem verschieben. Weitere Informationen finden Sie unter Process Monitoring.

    • Auf dem Admin-Computer muss das Verzeichnis mit den Datenbankdateien an dem Ort gespeichert werden, der im INI-Dateiparameter INPUT des Dienstprogramms AE DB Load angegeben ist (siehe AE DB Load). Der Ordner, der das BIN-Verzeichnis der Dienstprogramme enthält, ist der Standardordner. 

      • Beispiel Windows:

    • Dienstprogramm in C:\AUTOMIC\UTILITY\BIN

    • Datenbankdateien in C:\AUTOMIC\UTILITY\DB

    • Für Windows-Dienstprogramme werden die Dateien für die AE-Datenbank in IMAGE:DB bereitgestellt. Kopieren Sie den kompletten DB-Ordner in das obige Verzeichnis.

    • Für UNIX-Dienstprogramme:

      • Die Datenbankdateien sind im Archiv db.tar.gz enthalten, das sich im Ordner IMAGE:DB befindet. Verwenden Sie die folgenden Befehle zum Entpacken des Archivs:
        gzip -d db.tar.gz oder gunzip db.tar.gz
        tar xvfo db.tar
        (Linux: tar -zxvf db.tar.gz)
        Kopieren Sie die entpackten Dateien in das definierte Verzeichnis.
      • Starten Sie das Programm AE DB Load, um die Datenbank zu aktualisieren, und wählen Sie die Datei <DB-Verzeichnis>\GENERAL\<vers>\UC_UPD.TXT.
      • Die aktuelle Datenbankversion wird identifiziert und die Datenbank aktualisiert. Dabei werden die Datenbankstruktur und die Daten geändert. Objekte des Mandanten 0 werden automatisch ersetzt oder ergänzt.

  2. Wählen Sie die Authentifizierungsmethode aus

    Auf dem Admin-Computer zeigt das Dienstprogramm AE.DB Load einen Dialog an, in dem Sie eine Authentifizierungsmethode auswählen müssen.

    Dieser Dialog wird nur angezeigt, wenn die Datenbank auf eine neue Automation Engine-Version aktualisiert wird.

  3. (Optional) Partitionierung mit ILM installieren

    Auf dem Admin-Computer öffnet sich ein Dialog, in dem Sie die Einstellungen für die Partitionierung mit ILM auswählen können. Weitere Informationen finden Sie unter ILM - Information Lifecycle Management.

    Wichtig! Sie können einen AE-Datenbank-Partitionierungsprozess nicht rückgängig machen.

Aktualisieren der verbleibenden Binärdateien

  1. Upgrade AE und ServiceManager.

    1. Installieren Sie die Automation Engine in ein neues Verzeichnis, siehe Installation von AE - UNIX oder Installation der AE - Windows.
    2. Installieren Sie die neue ServiceManager-Version. Verwenden Sie einen neuen Namen für die ServiceManager-Umgebung (Phrase).

  2. Kopieren Sie den Ordner Documentation in das neue Verzeichnis.

  3. Konfigurieren und starten Sie den Java-Arbeitsprozess (JWP).

    Hinweise:

    • Wenn kein JWP bei der Anmeldung verfügbar ist, schlägt die Anmeldung fehl und es wird eine Fehlermeldung angezeigt. Das System benachrichtigt Sie auch, wenn aus einem bestimmten Grund die Mindestzahl von Prozessen während einer Session nicht erfüllt wird. Die Benachrichtigung wird nicht mehr angezeigt, sobald der Prozess wieder ausgeführt wird.

      Der JWP befindet sich im gleichen Verzeichnis wie alle anderen Automation Engine-Dateien. Das Verzeichnis /configuration/ wird beim ersten Start des JWP automatisch angelegt und enthält den Cache des OSGI-Pakets.

    • Der JDBC-Verbindungsstring verwendet den Benutzernamen und das Kennwort, die im Abschnitt [ODBC] der INI-Datei der Automation Engine(UCSRV. INI, siehe Automation Engine) definiert sind, um eine Verbindung zur Datenbank herzustellen.

    • Alle Java-basierten Serverprozesse verwenden den Parameter XML_ENCODING der Variablen UC_SYSTEM_SETTINGS zum Codieren von Zeichen. Entsprechende Informationen finden Sie unter XML-Parameter. Das System verwendet Unicode, um mit der Datenbank über JDBC zu kommunizieren. Stellen Sie daher sicher, dass Ihre Systemeinstellungen mit der für die Datenbank verwendeten Codierung übereinstimmen, damit Nicht-ASCII-Zeichen richtig verarbeitet werden können.

    Entpacken der Dateien

    Unter Windows werden die JWP-Dateien automatisch aus dem Programm SETUP.EXE in das Verzeichnis BIN kopiert. Unter UNIX befinden sich die Dateien im jeweiligen TAR-Archiv.

    Kopieren Sie die mitgelieferten Verzeichnisse "plugin" und "lib" in das BIN-Verzeichnis der Automation Engine.

    Wichtig! Wenn das bin-Verzeichnis für diese Installation bereits ein "plugin"- und/oder "lib"-Verzeichnis hat, sollten Sie diese(s) löschen, bevor Sie die neuen kopieren.

    Die nachfolgenden Installationsschritte hängen vom verwendeten Datenbanktyp ab.

    Java Cryptography Extension (JCE) (Optional - Nur für SSO mit Kerberos)

    Wichtig! JDK benötigt diese Richtliniendateien nur, wenn Sie mit Java 8 arbeiten. Java 9 und höhere Versionen enthalten und verwenden diese Dateien standardmäßig.

    1. Installation von Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy.

      Die JCE Unlimited Strength Jurisdiction Policy muss auf den Rechnern installiert werden, auf denen:

      • Das Automic Web Interface läuft.
      • Die Automation Engine (JWP/JCP) läuft.

      Download unter Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy

      Für IBM Java müssen Sie die Richtliniendateien von IBM verwenden. Die Unlimited Jurisdiction Policy Dateien befinden sich im Verzeichnis SDK /demo/jce/policy-files/unrestricted/. Weitere Informationen finden Sie unter https://www.ibm.com/support/knowledgecenter/en/SSYKE2_7.1.0/com.ibm.java.security.component.71.doc/security-component/sdkpolicyfiles.html.

      Die Readme-Datei enthält die Installationsanweisungen dazu, wie Sie die .jar-Dateien an einen geeigneten Ort kopieren können (z. B <java-home>\lib\security). Wenn sich mehrere Java-Installationen auf demselben Computer befinden, wird empfohlen, eine Policy Datei für alle Installationen einzurichten.

    MS SQL-Server

    1. Installieren Sie den JDBC-Treiber.

      1. Laden Sie Microsoft JDBC Driver für SQL Server herunter.

      2. Folgen Sie den Installationsanweisungen auf der Seite (laden Sie die.exe-Datei herunter, führen Sie sie aus und geben Sie das Installationsverzeichnis ein).

      3. Kopieren Sie nach der Installation die .jar-Datei aus dem entsprechenden JRE-Zielordner in das Verzeichnis <server\bin\lib> der Automation Engine. Stellen Sie sicher, dass Sie den neuesten JDBC-Treiber verwenden, der für Ihre Java-Version verfügbar ist.

        Sehen Sie in compatibility matrix nach, um festzustellen, welche Java-Versionen unterstützt werden. Weitere Informationen finden Sie unter Kompatibilitätsinformationen.

    2. Aktivieren Sie TCP/IP im MS SQL-Server. Gehen Sie dazu wie folgt vor:

      1. Öffnen Sie den SQL Server Configuration Manager.
      2. Erweitern Sie die SQL Server Netzwerkkonfiguration.
      3. Wählen Sie Protokolle für MSSQLSERVER unter SQL Server Netzwerkkonfiguration aus.
      4. TCP/IP muss im rechten Bereich auf Aktiviert gesetzt sein.
      5. Starten Sie die SQL Server Services neu.

    3. Bestimmen Sie den MS SQL-Server Port.

      Der Standardport des MS SQL-Serverports ist 1433.

      Hinweis: Wenn Sie sich nicht sicher sind, welchen Port Ihre MS SQL-Serverinstanz hat, können Sie dies der ERRORLOG-Datei (MSSQL > LOG) entnehmen. Eine der Meldungen: "Server is listening on [ 'any'<ipv4> Port-Nummer]" oder "Server is listening on [ 'any'<ipv6> Port-Nummer]" sollte in der aktuellen Log-Datei stehen, die den Port enthält.

    4. Konfigurieren der Datenbankverbindung.

      Der JWP verwendet dieselbe INI-Datei (UCSRV.INI, siehe Automation Engine) wie alle anderen WPs des Automation Engine-Systems.

      JDBC-Verbindung zur Datenbank

      Definieren Sie einen separaten Verbindungs-String für das JWP im Abschnitt [JDBC]. Sie können diese Zeichenkette automatisch generieren, indem Sie den folgenden Befehl verwenden:

      java -jar ucsrvjp.jar -setup

      Das System überprüft dann, ob der JDBC-Treiber verfügbar ist und ob die Datenbankverbindung hergestellt werden konnte.

      Der Vorteil dabei ist, dass die Verbindungszeichenkette der anderen WPs ([ODBC]-Abschnitt) nicht geändert oder neu gestartet werden muss.

      Wenn Sie die Windows-Authentifizierung verwenden möchten, müssen Sie ;IntegratedSecurity=true an den JDBC-Verbindungszeichenkette im Abschnitt [JDBC] der AE INI-Datei anhängen.

      Beispiel

      SQLDRIVERCONNECT=jdbc:sqlserver://localhost:1433;databaseName=AUTOMIC;IntegratedSecurity=true

      Hinweis: Wenn Sie den JDBC-Treiber installieren und die Windows-Authentifizierung verwenden müssen, müssen Sie auch die Datei sqljdbc_auth.dll in das Verzeichnis BIN der Automation Engine kopieren .

      DSN-freie ODBC-Verbindung

      Diese Option verwendet die gleiche Datenbank-Verbindungs-String, die auch von allen anderen WPs im Automation Engine-System verwendet wird. Bei der Installation eines JWP für ein bestehendes System müssen anschließend alle WPs neu gestartet werden.

      Im Abschnitt [ODBC] der Konfigurationsdatei wird ein Verbindungs-String benötigt, deren Syntax keinen DSN erfordert. Der Server- und Datenbankname muss in diesem Fall direkt angegeben werden.

      SQLDRIVERCONNECT=ODBCVAR=SNNNNNRN,Driver={SQL Server Native Client VERSION};Server=tcp:SRVNAME,PORT;Database=DBNAME;UID=DBUSER;PWD=DBPWD

      • VERSION- Version des SQL Server Native Client. Wird im SQL Server Configuration Manager angezeigt.
      • SRVNAME - Name des Datenbank-Rechners.
      • PORT - Port der MS SQL-Serverinstanz.
      • DBNAME - Datenbankname.
      • DBUSER - Datenbankbenutzer.
      • DBPWD - Datenbank-Passwort.

      Beispiel

      [ODBC]
      SQLDRIVERCONNECT=ODBCVAR=SNNNNNRN,Driver={SQL Server Native Client 11.0};Server=tcp:dbsrv01,1433;Database=AEV10;UID=user;PWD=password

      Der Eintrag sollte in einer Zeile erfolgen (ohne Zeilenumbruch).

    Oracle

    1. JDBC-Treiber installieren.

      1. Kopieren Sie den JDBC-Treiber ojdbc8.jar aus der Oracle-Datenbank-Mandanten-Installation in den lib-Ordner des JWP.
        Die Datei befindet sich hier: ORACLE_HOME/jdbc/lib/ojdbc8.jar.

      2. Kopieren Sie die Dateien xdb6.jar oder xdb.jar und xmlparserv2.jar in den Ordner lib des JWP, um sicherzustellen, dass XML-Variablen korrekt verarbeitet werden.

        Die Dateien sind entweder Teil der Oracle-Datenbank oder können von der Oracle SQL Developer-Website heruntergeladen werden. Diese befinden sich hier:

        • $SQLDEVELOPER_HOME/modules/oracle.xdk/xmlparserv2.jar

        • $SQLDEVELOPER_HOME/rdbms/jlib/xdb6.jar oder $SQLDEVELOPER_HOME/rdbms/jlib/xdb.jar

    2. Konfigurieren der Datenbankverbindung

      JDBC-Verbindung zur Datenbank

      Definieren Sie einen separaten Verbindungs-String für den JWP im Abschnitt [JDBC]. Sie können diesen String automatisch generieren, indem Sie den folgenden Befehl verwenden:

      java -jar ucsrvjp.jar -setup

      Das System überprüft dann, ob der JDBC-Treiber verfügbar ist und ob die Datenbankverbindung hergestellt werden konnte.

      Weitere Informationen zur Installation des JDBC-Treibers finden Sie in der Oracle JDBC Installationsanleitung.

    DB2

    1. JDBC-Treiber installieren.

      Kopieren Sie die Datei db2jcc4.jar (JDBC-Treiber) in das Verzeichnis lib des JWP.

      Diese Datei ist Teil des DB2-Mandanten und befindet sich im Unterverzeichnis SQLLIB/java.

    2. Konfigurieren der Datenbankverbindung

      JDBC-Verbindung zur Datenbank

      Definieren Sie einen separaten Verbindungs-String für den JWP im Abschnitt [JDBC]. Sie können diesen String automatisch generieren, indem Sie den folgenden Befehl verwenden:

      java -jar ucsrvjp.jar -setup

      Das System überprüft dann, ob der JDBC-Treiber verfügbar ist und ob die Datenbankverbindung hergestellt werden konnte.

    PostgreSQL

    1. Installieren Sie den JDBC-Treiber.

      Laden Sie die entsprechende *.jar-Datei von https://jdbc.postgresql.org/download.html herunter und kopieren Sie sie in das Verzeichnis lib des JWP.

    2. Konfigurieren der Datenbankverbindung

      JDBC-Verbindung zur Datenbank

      Definieren Sie einen separaten Verbindungs-String für den JWP im Abschnitt [JDBC]. Sie können diesen String automatisch generieren, indem Sie den folgenden Befehl verwenden:

      java -jar ucsrvjp.jar -setup

      Das System überprüft dann, ob der JDBC-Treiber verfügbar ist und ob die Datenbankverbindung hergestellt werden konnte.

    TLS/SSL-Zertifizierungsstelle für Agenten (optional)

    Um die Kommunikation zwischen Agenten zu sichern, generiert die Automation Engine automatisch beim ersten Start ein Schlüsselpaar mit öffentlichem/privatem Schlüssel und eine selbstsignierte Zertifizierungsstelle.

    Jedoch können Sie Ihre eigene Zertifizierungsstelle verwenden, um Ihr Zertifikat und das jeweilige Schlüsselpaar zu verwalten. Dazu müssen Sie die Variable UC_AGENT_TLS_SETTINGS in Mandant 0 erstellen und die relevanten Einstellungen definieren. Weitere Informationen finden Sie unter UC_AGENT_TLS_SETTINGS – Agenten-Zertifikatverwaltung.

    TLS/SSL-Zertifikate für LDAP (optional)

    Um TLS/SSL verwenden zu können, müssen die Zertifikate des LDAP-Servers dem Java-Arbeitsprozess (JWP) zur Verfügung stehen. Das JWP verwendet die standardmäßigen Keystore-Datei cacerts im Verzeichnis lib/security der JRE.

    Es gibt eine Reihe von Konfigurationsoptionen für die Keystore-Datei:

    • Verwendung einer alternativen Keystore-Datei:

      Wenn Sie möchten, dass die JWP(s) eine alternative Keystore-Datei verwenden, müssen Sie den Dateinamen und den Pfad zu einer zentral gespeicherten Datei im Schlüssel JWP_KEYSTORE_PATH in der Variablen UC_SYSTEM_SETTINGS definieren. Falls der definierte Pfad nicht zugänglich oder ungültig ist, wird eine Logmeldung an den Standard-Log-Speicherort geschrieben und das JWP verwendet die Standard-Keystore-Datei. Weitere Informationen finden Sie unter JWP_KEYSTORE_PATH.

    • Erstellen einer individuellen Keystore-Datei mit dem JWP:

      Wenn Sie eine einzelne Keystore-Datei verwenden möchten, können Sie diese mit dem folgenden Befehl erstellen:

      java -jar ucsrvjp.jar -installcert host:port keystorePath

      Falls der definierte Pfad in keystorePath nicht existiert, erstellt das JWP eine neue Keystore-Datei an dieser Stelle. Sie können dann ein Passwort für diese Keystore-Datei festlegen.

    • Verwendung eines alternativen Passworts für den Zugriff auf Keystore-Dateien:

      Das vom JWP verwendete Standardpasswort ist das Standardpasswort des JRE-Keystores. Wenn Sie möchten, dass das JWP ein anderes Passwort verwendet, müssen Sie ein Anmeldeobjekt mit diesem Passwort definieren, indem Sie den folgenden Schritten folgen:

      • Erstellen Sie ein Login-Objekt (oder verwenden Sie ein bestehendes).
      • Verwenden Sie den Schlüssel JWP_KEYSTORE_LOGIN in der Variablen UC_SYSTEM_SETTINGS, um den Namen dieses Login-Objekts einzugeben. Weitere Informationen finden Sie unter JWP_KEYSTORE_LOGIN.
      • Öffnen Sie das referenzierte Login-Objekt, wählen Sie die Seite Login und fügen Sie dort eine neue Zeile hinzu.
      • Wählen Sie in der Spalte Name "*", wählen Sie in der Spalte Typ JWP_KEYSTORE.
      • Die Login-Info ist für diese Funktion optional, aber da diese Spalte standardmäßig nicht leer sein darf, müssen Sie hier etwas eingeben.
      • Geben Sie das von Ihnen gewählte Passwort für die Keystore-Datei ein.

    Zertifikate hinzufügen

    1. Zertifikate mit dem Keytool-Befehl hinzufügen.

      1. Um den Standard-Keystore der JRE zu verwenden, gehen Sie in den Ordner jre\lib\security der Java-Installation und importieren Sie das Zertifikat mit dem Keytool-Befehl:

        2. keytool -keystore cacerts -importcert -alias ldapServer -file certficate.cer

      2. Um Ihre eigene Keystore-Datei zu verwenden, die mit dem Schlüssel JWP_KEYSTORE_PATH in der Variablen UC_SYSTEM_SETTINGS definiert ist, gehen Sie zu dem definierten Pfad und importieren Sie das Zertifikat mit dem keytool-Befehl:

        3. keytool -keystore <keystore> -importcert -alias ldapServer -file certficate.cer

        Wenn Sie aufgefordert werden, diesem Zertifikat zu vertrauen, antworten Sie mit der Eingabe von "Y".

        Weitere Informationen finden Sie unter JWP_KEYSTORE_PATH.

    2. Fügen Sie Zertifikate per Download hinzu.

      1. Eine weitere Option zur Installation des Zertifikats ist der Kommandozeilenparameter -installcert des Java-Arbeitsprozesses.

        2. java -jar ucsrvjp.jar -installcert <host>:<sslport>

        • Dies setzt voraus, dass der Java-Arbeitsprozess Schreibzugriff auf die cacerts-Datei der Java-Installation hat.
        • Dieser Befehl erkennt den Pfad von cacerts, verbindet sich mit dem angegebenen Host und Port und versucht, eine TLS/SSL-Verbindung herzustellen.
      2. Dieser Befehl zum Hinzufügen eines Zertifikats per Download setzt einen optionalen Parameter für den Dateinamen des Keystores:

        3. java -jar ucsrvjp.jar -installcert <host>:<sslport> <keystorePath>

      Hinweise:

      • Wenn der Parameter JWP_KEYSTORE_PATH gültig ist, aber die Datei nicht existiert, erstellt JWP eine neue Keystore-Datei am gleichen Speicherort. Weitere Informationen finden Sie unter JWP_KEYSTORE_PATH. Während dieses Vorgangs kann der Benutzer ein individuelles Passwort definieren.

      • Wenn ein Zertifikat fehlt, wird die Meldung "gültiger Zertifikat-Pfad zum abgefragten Ziel kann nicht gefunden werden" gedruckt und das fehlende Zertifikat heruntergeladen und in der cacerts-Datei gespeichert.

    Starten des JWPs

    Verwenden Sie diese Art von Befehl, um den JWP über die Kommandozeile zu starten.

    java -Xmx2G -jar ucsrvjp.jar -Iucsrv.ini

    Die Datei ucsrvjp.jar befindet sich im gleichen Verzeichnis wie die anderen Automation Engine Sie wird ausschließlich zum Starten des JWP verwendet.

    Das JWP kann auch über den ServiceManager gestartet werden.

    java -Xmx2G -jar ucsrvjp.jar -svc%port% -IC:\temp\ucsrv.ini

    Der Parameter -svc sollte weggelassen werden, wenn Sie direkt über die Kommandozeile starten.

    Der Parameter -I zur Angabe der INI-Datei ist optional. Fehlt der Parameter, versucht der JWP, die Datei ucsrv.ini im aktuellen Arbeitsverzeichnis (= Verzeichnis, in dem sich die Datei ucsrvjp.jar befindet) zu finden.

    Sie können JWP als dedizierten Prozess mit einer spezifischen Rolle starten. Beispielsweise können Sie den folgenden Befehl verwenden, um den JWP als dedizierten Prozess mit der Authentifizierungsrolle (AUT) zu starten:

    java -Xmx2G -jar ucsrvjp.jar -Iucsrv.ini -role=AUT

    Sie können JWP auch mit einer dedizierten IDX- oder UTL-Rolle starten, indem Sie den Kommandozeilenparameter -role entsprechend einstellen.

    Hinweis: Wenn Sie eine Rolle zuweisen und einen JWP über die Kommandozeile starten, werden diese Serverprozesse ausschließlich für die Rolle verwendet, die Sie in der Kommandozeile definiert haben. In diesem Fall kann der JWP keine Aufgaben anderer JWPs übernehmen, falls diese anhalten sollten.

    Weitere Informationen finden Sie unter JWP-Rollen.

    Wichtig! Ab Version 21.0 stellt der REST-Prozess den REST-Endpunkt für die Automation Engineanstelle des JCP zur Verfügung. Wenn Sie auf diese Version aktualisieren, wird die aktuelle (Basis-)Version des JCP zum REST-Prozess auf der Zielversion. Der neue JCP muss in einem separaten Schritt gestartet werden.

  4. Konfigurieren und Starten des REST-Prozesses (REST).

    Die für den REST-Prozess benötigten Dateien sind die gleichen wie die für den JWP bereitgestellten Dateien im gleichen Verzeichnis wie alle anderen Automation Engine-Dateien.

    Da die Installation des JWP obligatorisch ist und die für den REST-Prozess notwendigen Dateien mit denen der Installation des JWP übereinstimmen, ist es nicht notwendig, Dateien zu entpacken oder einen anderen Installationsschritt durchzuführen.

    Hinweise:

    • Die Installation des REST-Prozesses ist relevant für die AE REST-API sowie für die erweiterte Objektsuche. Stellen Sie sicher, den [REST]-Abschnitt der Automation Engine-Konfigurationsdatei (ucsrv.ini siehe Automation Engine) entsprechend zu konfigurieren.
    • Die Automation Engine verwendet TLS/SSL, um die Kommunikation zu sichern und zu verschlüsseln. Stellen Sie sicher, den zugehörigen Keystore zuvor unter Verwendung des pkcs 12-Formats zu erstellen und den Abschnitt [TLS] der Automation Engine-Konfigurationsdatei (ucsrv.ini, siehe Automation Engine) entsprechend zu konfigurieren. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).
    • Wenn bei der Anmeldung kein REST-Prozess verfügbar ist, schlägt die Anmeldung fehl und es wird eine Fehlermeldung angezeigt. Das System benachrichtigt Sie auch, wenn aus einem bestimmten Grund die Mindestzahl von Prozessen während einer Session nicht erfüllt wird. Die Benachrichtigung wird nicht mehr angezeigt, sobald der Prozess wieder ausgeführt wird.
    • Wenn der REST-Prozess initiiert wird, wird er an den Port gebunden, den Sie im Parameter JCP.PORTS im Abschnitt [PORTS] der INI-Datei der AE definiert haben. Wenn in diesem Abschnitt kein Port definiert ist, wird er willkürlich an einen anderen Port gebunden, was für die interne Kommunikation zwischen dem WP und dem REST-Prozess erforderlich ist. Wenn der REST-Prozess startet, öffnet er einen willkürlich ausgewählten Port und sendet ihn intern über die Datenbank an die WPs, damit WPs den REST-Prozess erreichen können. Weitere Informationen finden Sie unter Konfigurieren von Firewall und Ports.

    Starten des REST-Prozesses

    Verwenden Sie diese Art von Befehl, um den REST-Prozess über die Kommandozeile zu starten:

    java -Xmx2G -jar ucsrvjp.jar -Iucsrv.ini -rest

    Die Datei "ucsrvjp.jar" befindet sich im gleichen Verzeichnis wie die anderen Automation Engine Sie wird ausschließlich verwendet, um den JWP- und REST-Prozess zu starten.

    Der REST-Prozess kann auch über den ServiceManager gestartet werden.

    java -Xmx2G -jar ucsrvjp.jar -Iucsrv.ini -svc%port% -rest

    Der Parameter -svc sollte weggelassen werden, wenn Sie direkt über die Kommandozeile starten.

    Der Parameter -I zur Angabe der INI-Datei ist optional. Fehlt der Parameter, versucht der REST-Prozess, die Datei ucsrv.ini im aktuellen Arbeitsverzeichnis (selbes Verzeichnis, in dem sich die Datei ucsrvjp.jar befindet) zu finden.

    Mehrere REST-API-Prozesse einrichten

    Die REST-Installation ist sowohl für die AE-REST-API  als auch für die erweiterte Objektsuche relevant. Sie können einen einzelnen REST-Prozess (REST) installieren. In diesem Fall werden alle REST-Anfragen an diese einzelne AE REST-API-Instanz gesendet, und es steht keine REST-API zur Verfügung, wenn der REST-Prozess nicht läuft.

    Sie können auch ein System mit mehreren REST-Prozessen einrichten. In diesem Fall werden zwei REST-Prozesse in einem Cluster verwendet, aber nur einer von ihnen ist jeweils verfügbar.

    Es wird empfohlen, einen REST-Prozess pro Knoten zu verwenden. Sie können jedoch auch ein System mit mehreren REST-Prozessen einrichten. Dies kann sinnvoll für Lastausgleichszwecke sein, ebenso wie für die Bereitstellung von Ausfallsicherungen, da die REST-Anfragen nur an verfügbare REST-Prozesse gesendet und verteilt werden. Weitere Informationen finden Sie unter AE-REST-API - Allgemeine Informationen

    Wichtig!

    • Wenn ein System mit mehreren REST-Prozessen eingerichtet wird, ist es zwingend erforderlich, dass jedes System eine eigene Automation Engine-Konfigurationsdatei (ucsrv.ini, siehe Automation Engineverwendet, und dass verschiedene Ports für jeden REST zugewiesen werden. Andernfalls stellt der erste erfolgreich eine Verbindung her, während die anderen beendet werden, wenn sie versuchen, sich beim gleichen REST-Port zu registrieren, wenn beide auf demselben Knoten ausgeführt werden. In die Logdatei des REST-Prozesses wird eine Fehlermeldung mit Angabe der Ursache für den Abbruch geschrieben.

    • Wenn bei der Anmeldung kein REST-Prozess verfügbar ist, schlägt die Anmeldung fehl und es wird eine Fehlermeldung angezeigt. Das System benachrichtigt Sie auch, wenn aus einem bestimmten Grund die Mindestzahl von Prozessen während einer Sitzung nicht erfüllt wird. Die Benachrichtigung wird nicht mehr angezeigt, sobald der Prozess wieder ausgeführt wird.

  5. Konfigurieren und Starten des Java-Kommunikationsprozesses (JCP).

    Die für den JCP benötigten Dateien sind die gleichen wie die für den JWP bereitgestellten Dateien im gleichen Verzeichnis wie alle anderen Automation Engine-Dateien.

    Da die Installation des JWP obligatorisch ist und die für das JCP notwendigen Dateien mit denen der Installation des JWP übereinstimmen, ist es nicht notwendig, Dateien zu entpacken oder einen anderen Installationsschritt durchzuführen.

    Die Installation des Java Communication Process (JCP) ist auch für die TLS/SSL-Verbindung zu den UNIX-, Windows- und Java-basierten Agenten, der Automic Web Interface und der Java-API relevant. Diese Verbindung wird über sichere WebSockets (WSS) hergestellt.

    Der für diese Verbindungen zugewiesene Port oder Port-Bereich wird im Parameter WS.PORT= im Abschnitt [PORTS] der INI-Datei der Automation Engine definiert (siehe Automation Engine). Wenn Sie einen JCP pro Host installiert haben, können Sie in jeder Instanz dieselbe WSS-Port-Definition verwenden.

    Hinweise:

    • Für die Prozesse ist ein Schlüsselspeicher (im Format PKCS12) erforderlich, damit sie mit den entsprechenden Zertifikaten arbeiten. Stellen Sie sicher, dass Sie zuvor einen Schlüsselspeicher erstellt haben. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL).

      Sie müssen auch die folgenden Parameter im Abschnitt [TLS] der INI-Datei der Automation Engine (ucsrv.ini) definieren:

      • keystore= Pfad und Datei, in der der Keystore für das TLS/SSL-Zertifikat gespeichert ist

        Standardwert: ./httpsKeyfile

        Dieser Parameter ist obligatorisch und muss auf das richtige Ziel zeigen; andernfalls wird der Prozess-Server beendet.

      • keystorePassword= Kennwort für die Keystore-Datei

        Standardwert: changeit

        Wenn der Wert nicht definiert ist oder leer bleibt, verwendet das System den Standardwert.

      • keyPassword=Kennwort für den Schlüssel

        Standardwert: changeit

        Wenn der Wert nicht definiert ist oder leer bleibt, verwendet das System den Standardwert.

      • keyAlias= Alias, der für den Schlüssel verwendet wird

        Standardwert: jetty

        Wenn der Wert nicht definiert ist oder leer bleibt, verwendet das System den Standardwert.

      Das keystorePassword und das keyPassword können mit dem Dienstprogramm UCYBCRYP verschleiert werden. Weitere Informationen finden Sie unter Verschleiern von Kennwörtern.

    • Wenn der JCP initiiert wird, ist er an zwei Ports gebunden:

      • Den WS.PORT, der in der INI-Datei konfigurierbar ist und von den Agenten für die Kommunikation mit dem JCP verwendet wird.

      • Den Port, den Sie im Parameter JCP.PORTS im Abschnitt [PORTS] der INI-Datei der AE definiert haben. Wenn in diesem Abschnitt keine Ports definiert sind, wird der JPC willkürlich an einen anderen Port gebunden, was für die interne Kommunikation zwischen WP und JCP/CP erforderlich ist. Wenn der JCP startet, öffnet er einen willkürlich ausgewählten Port und sendet ihn intern über die Datenbank an die WPs, damit WPs die JCPs/CPs erreichen können.

      • Weitere Informationen finden Sie unter Konfigurieren von Firewall und Ports.

    Starten des JCP

    Verwenden Sie diese Art von Befehl, um den JCP über die Kommandozeile zu starten:

    java -Xmx2G -jar ucsrvjp.jar -Iucsrv.ini -cp

    Die Datei ucsrvjp.jar befindet sich im gleichen Verzeichnis wie die anderen Automation Engine Sie wird ausschließlich verwendet, um den JWP-, JCP- und REST-Prozess zu starten.

    Der JCP kann auch über den ServiceManager gestartet werden.

    java -Xmx2G -jar ucsrvjp.jar -Iucsrv.ini -svc%port% -cp

    Der Parameter -svc sollte weggelassen werden, wenn Sie direkt über die Kommandozeile starten.

  6. Aktualisieren des Automic Web Interface.

    7. Es gibt zwei Hauptaspekte, die Sie berücksichtigen müssen, bevor Sie auf Automic Web Interface Version 21 aktualisieren:

    • Die Automation Engine und die Automic Web Interface kommunizieren ab v21 unter Verwendung von TLS/SSL AWI richtet eine Verbindung zum neuen Java-Kommunikationsprozess (JCP) ein, der vertrauenswürdige Zertifikate verwendet, um ihre Identität gegenüber anderen Kommunikationspartnern nachzuweisen. Stellen Sie daher sicher, dass Sie vor der Aktualisierung von AWI alle erforderlichen Zertifikate besitzen.

      Mehr Informationen:

    • Ab Version 21 ist es nicht mehr notwendig, einen Anwendungsserver vor der Installation der Automic Web Interface zu installieren, weil das Lieferungsartefakt den AWI Jetty Launcher enthält. Sie haben dann zwei Möglichkeiten: 

      • Sie können Ihren Anwendungsserver behalten und AWI wie gewohnt aktualisieren.

      • Sie können eine neue AWI-Version mit dem Jetty Launcher installieren und Ihre gesicherten Konfigurations- und Plug-in-Dateien verwenden, um die AWI zu konfigurieren. Weitere Informationen finden Sie unter Installieren des Automic Web Interface.

    AWI unter Verwendung eines Anwendungsservers aktualisieren

    Ein Upgrade einer bestehenden Installation auf das neue Release aktualisiert gleichzeitig das AWI-Framework und alle seine Plug-ins. Verwenden Sie die gleichen Schritte, um Hotfix-Packages zwischen den Versionen zu installieren.

    1. Stoppen Sie den Tomcat-Dienst.

      1. Öffnen Sie Ihren Windows Services Manager.

      2. Stoppen Sie den Tomcat-Dienst.

    2. Sichern Sie aktuelle Dateien.

      Sie können eine Sicherheitskopie Ihrer gesamten AWI-Installation oder nur der Konfigurationsdateien erstellen. Obwohl Sie in der neuen Version nur sehr wenig von den vorherigen Konfigurationen verwenden können, ist es vielleicht hilfreich, eine Kopie zu besitzen, die Sie als Referenz bei der Konfiguration der Aktualisierung verwenden können.

      • Um Ihre gesamte AWI-Installation zu sichern, gehen Sie zu Ihrer Tomcat-Installation, öffnen den Ordner webapps und erstellen eine Sicherungskopie des gesamten awi-Ordners.

      • Um nur die Konfigurationsdateien zu sichern, gehen Sie in den Ordner, in dem Sie die aktuelle AWI-Version installiert haben, und erstellen Sie eine Sicherungskopie des Ordners webapps/awi/config.

    3. Aktualisieren Sie den Anwendungsserver.

      Wichtig! AWI Wird normalerweise auf Tomcat ausgeführt. Wenn Sie einen anderen Anwendungsserver für das Automic Web Interface verwenden möchten, finden Sie weitere Informationen unter Installieren des Automic Web Interface.

      Vor dem Upgrade des Anwendungsserver gehen Sie zu compatibility matrix, um zu sehen, welche Version mit AWI kompatibel ist. Die Upgrade-Anleitung und weitere relevante Informationen finden Sie auf der Website Ihres Anwendungsserver-Anbieters. Weitere Informationen finden Sie unter Kompatibilitätsinformationen.

    4. Starten Sie den Anwendungsserver neu.

      Die entsprechenden Informationen finden Sie auf der Website Ihres Anwendungsserver-Anbieters.

    5. Stellen Sie die neue AWI-Version (WAR-Datei) auf Ihrem Anwendungsserver bereit.

      • Wenn Sie Tomcat verwenden

        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.

      • Wenn Sie WebSphere oder WebLogic verwenden

        Weitere Informationen finden Sie in der offiziellen Dokumentation von WebSphere oder WebLogic.

    6. Konfigurieren Sie die neue AWI-Version.

      Weitere Informationen zur Konfiguration Ihrer aktualisierten AWI finden Sie unter Konfiguration des Automic Web Interface.

      Wenn Sie vor Beginn des Upgrades ein Backup erstellt haben, können Sie die folgenden Dateien und Einstellungen aus den Backup-Dateien des vorherigen Ordners in den neuen Ordner webapps/awi/config herunterladen:

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

        Sie können die neue Datei durch Ihr Backup ersetzen.

        Wenn Sie mehr als eine AE-Systemverbindung definiert haben, können Sie Ihren Benutzern erlauben, ihre Verbindung beim Anmelden auszuwählen, oder Sie können eine der definierten Verbindungen als einzige gültige Verbindung angeben. Sie haben dies in der Einstellung automationengine.index der Datei configuration.properties definiert.

        Bisher konnten Benutzer keine Verbindung auswählen und Sie mussten sicherstellen, dass Ihre einzige gültige Verbindung zuerst in der Datei uc4config.xml definiert wurde.

        Wenn Sie selbstsignierte Zertifikate verwenden, können Sie den Parameter trustedCertFolder= verwenden, um den Pfad zum Ordner zu definieren, in dem die vertrauenswürdigen Zertifikate gespeichert sind. Andernfalls sollten die Zertifikate im Java-Truststore installiert werden. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL) und Hinweise zu TLS-/SSL-Zertifikaten.

      • configuration.properties – Lokales Setup konfigurieren:

      • logback.xml - Log-Ebenen konfigurieren:

        Stellen Sie Ihre gesicherte Version nicht wieder her.

        Wenn Sie jedoch die Standardeinstellung für den Dringlichkeitsgrad von Ereignismeldungen (DEBUG) für das Root-Element geändert haben, sollten Sie die gleiche Änderung für AWI vornehmen.

      • Ordner Thema:

        Wenn Sie das Farb- oder Bannerlogo in Ihrer vorherigen Umgebung angepasst haben, kopieren Sie den Inhalt Ihres gesicherten webapps/awi/config/theme-Ordners in den gleichnamigen Ordner in Ihrer aktuellen AWI-Version.

        Weitere Informationen finden Sie unter colors.properties - Konfigurieren des Farbschemas.

    Upgrades AWI ohne Verwendung eines Anwendungsservers

    In diesem Fall installieren Sie eine neue AWI-Instanz, die das AWI-Framework und alle seine Plug-ins enthält.

    1. Sichern Sie die aktuellen Konfigurationsdateien.

      Sie können eine Sicherheitskopie Ihrer Konfigurationsdateien erstellen. Obwohl Sie in der neuen Version nur sehr wenig von den vorherigen Konfigurationen verwenden können, ist es vielleicht hilfreich, eine Kopie zu besitzen, die Sie als Referenz bei der Konfiguration der Aktualisierung verwenden können.

      Um Ihre Dateien zu sichern, wechseln Sie in den Ordner, in dem Sie die aktuelle AWI-Version installiert haben, und erstellen Sie eine Backup-Kopie beispielsweise des Ordners config (Tomcat)

      • <webserver>/webapps/awi/config für die Konfigurationsdateien

    2. Installieren Sie die Automic Web Interface-Version, die den AWI Jetty Launcher enthält, siehe Installieren des Automic Web Interface.

    3. Konfigurieren Sie die neue AWI-Version.

      Weitere Informationen zur Konfiguration Ihrer aktualisierten AWI finden Sie unter Konfiguration des Automic Web Interface.

      Wenn Sie vor Beginn des Upgrades ein Backup erstellt haben, können Sie die folgenden Dateien und Einstellungen aus den Backup-Dateien des vorherigen Ordners in den neuen Ordner webapps/awi/config herunterladen:

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

        Sie können die neue Datei durch Ihr Backup ersetzen.

        Wenn Sie mehr als eine AE-Systemverbindung definiert haben, können Sie Ihren Benutzern erlauben, ihre Verbindung beim Anmelden auszuwählen, oder Sie können eine der definierten Verbindungen als einzige gültige Verbindung angeben. Sie haben dies in der Einstellung automationengine.index der Datei configuration.properties definiert.

        Bisher konnten Benutzer keine Verbindung auswählen und Sie mussten sicherstellen, dass Ihre einzige gültige Verbindung zuerst in der Datei uc4config.xml definiert wurde.

        Wenn Sie selbstsignierte Zertifikate verwenden, können Sie den Parameter trustedCertFolder= verwenden, um den Pfad zum Ordner zu definieren, in dem die vertrauenswürdigen Zertifikate gespeichert sind. Andernfalls sollten die Zertifikate im Java-Truststore installiert werden. Weitere Informationen finden Sie unter Verbindungen zur AE sichern (TLS/SSL) und Hinweise zu TLS-/SSL-Zertifikaten.

      • configuration.properties – Lokales Setup konfigurieren:

      • logback.xml - Log-Ebenen konfigurieren:

        Stellen Sie Ihre gesicherte Version nicht wieder her.

        Wenn Sie jedoch die Standardeinstellung für den Dringlichkeitsgrad von Ereignismeldungen (DEBUG) für das Root-Element geändert haben, sollten Sie die gleiche Änderung für AWI vornehmen.

      • Ordner Thema:

        Wenn Sie das Farb- oder Bannerlogo in Ihrer vorherigen Umgebung angepasst haben, kopieren Sie den Inhalt Ihres gesicherten webapps/awi/config/theme-Ordners in den gleichnamigen Ordner in Ihrer aktuellen AWI-Version.

        Weitere Informationen finden Sie unter colors.properties - Konfigurieren des Farbschemas.

      Wenn Sie ein Backup der Plug-ins erstellt haben, bevor Sie mit der Aktualisierung beginnen, können Sie sie in den Ordner <jetty>/plugins/autoinstall der neuen AWI-Installation kopieren. Vergleichen Sie dazu entweder die standardmäßig installierten und kopieren Sie die restlichen oder kopieren Sie alle gesicherten Plug-ins und stellen Sie sicher, dass Sie keine der vorhandenen ersetzen.

Inbetriebnahme des Systems

  1. Starten Sie den ServiceManager, siehe Startparameter - ServiceManager.

  2. Starten Sie die Serverprozesse (Kaltstart).

    Führen Sie einen Kaltstart des Serverprozesses durch, wenn alle Installations- und Konfigurationsschritte erfolgreich abgeschlossen sind. Führen Sie dies in der INI-Datei der Serverprozesse durch, indem Sie den Parameter StartMode= auf COLD setzen. Nun können die Prozesse gestartet werden.

  3. Warten Sie, bis alle Agenten wieder verbunden sind.

  4. Starten Sie die Mandanten (Go).

    Alle Mandanten können von der Administration-Perspektive des Mandanten 0 aus gestartet werden. Weitere Informationen finden Sie unter Mandanten via Application Interface starten / stoppen.

Aktualisierung der restlichen Komponenten

Nun können Sie die restlichen Komponenten installieren und/oder ersetzen:

  • Agenten installieren

    Bevor Sie die Agenten installieren, lesen Sie bitte die unten aufgeführten Empfehlungen und Beispiele.

  • Installation von CallAPIs

    Denken Sie daran, die neu installierte Version für einige Zeit zu überwachen.

Hinweise:

  • Es wird empfohlen, Agenten der gleichen Service Pack-Version wie jene der Automation Engine zu verwenden. Verwenden Sie in der Regel das neueste Service Pack.
  • Sie können Agenten eines älteren Service-Packs einer Minor- oder Major-Version mit einer Automation Engine eines neueren Service-Packs einer Minor- oder Major-Version verbinden. Die folgenden Voraussetzungen müssen berücksichtigt werden:
    • Die Agentenversion muss noch unterstützt werden.
    • Funktionen und Features, die mit einer neueren Version des Agenten eingeführt wurden, können normalerweise nicht mit einem Agenten einer älteren Version verwendet werden.
    • Es kann Ausnahmen geben. Lesen Sie die Abschnitte über Inkompatibilitäten zwischen den Versionen in der jeweiligen Upgrade-Dokumentation. Weitere Informationen finden Sie unter Upgrade-Installation
  • Sie können keine Agenten einer neueren Minor- oder Major-Version mit einer Automation Engine einer älteren Minor- oder Major-Version verbinden.

Beispiele

  • Automation Engine v12.3.6 und Agent v12.3.6

    Unterstützt, beste Wahl.

  • Automation Engine v12.3.5 und Agent v12.3.6

    Unterstützt, da der Agent auf der gleichen Version ist, nur ein neueres Service-Pack

  • Automation Engine v12.3.6 und Agent v21.0.0

    Wird nicht unterstützt, da sich der Agent auf einer neueren Major-Version befindet.

  • Automation Engine v21.0.0 und Agent v12.3.6

    Wird unterstützt, wenn sich die Agentenversion noch in der Wartung befindet.

  • Automation Engine v21.0.0 und Agent v12.0.9

    Wird nicht unterstützt, wenn die Agentenversion nicht mehr gewartet wird.

Wichtig!

  • Diese Informationen gelten für Betriebssystem-Agenten, Anwendungsagenten und andere Java-basierte Agenten wie den Rapid Automation-Kernagenten. Sie gelten jedoch nicht für Rapid Automation-Lösungen. Überprüfen Sie die Kompatibilität von RA-Lösungen in der compatibility matrix, sieheKompatibilitätsinformationen. Auch wenn die aktuell verwendete RA-Lösung kompatibel ist, stellen Sie sicher, dass die RA-Lösung noch unterstützt wird. Weitere Informationen finden Sie unter Support-Lebenszyklus von Komponenten.

  • Entfernen oder überschreiben Sie nicht die Installationsverzeichnisse Ihrer Agenten. Sichern Sie den entsprechenden Ordner, um sicherzustellen, dass Sie schnell zu Ihrer alten Version zurückkehren können.

  • Die neuen Agenten müssen in einem separaten Verzeichnis installiert werden. Eine angemessene Überwachungszeit ist unerlässlich. Es ist am besten, nicht alle Agenten durch die neue Version zu ersetzen. Ersetzen Sie z. B. eine Plattform nach der anderen. Ersetzen Sie zunächst UNIX und erst dann den nächsten, wenn sich herausgestellt hat, dass die Agenten für einige Zeit stabil laufen.

Um sicherzustellen, dass Jobs den neuen Job Messenger aufrufen, führen Sie die folgenden Schritte aus:

  1. Korrigieren Sie den Dateinamen des Job Messengers in der INI-Datei, wenn Sie den Agenten aktualisieren (Variable UC_EX_JOB_MD).

  2. Wenn Sie den neuen Agenten im gleichen Verzeichnis wie den alten installieren, müssen Sie den alten Job Messenger nach der Installation löschen.

  3. Anstatt die INI-Datei während des Aktualisierungsprozesses anzupassen, können Sie auch einen Link erstellen, der auf den neuen Messenger zeigt. Verwenden Sie Großbuchstaben für die alten Messenger-Namen. Zum Beispiel für Linux:  ln -s ucxjli3m UCXJLI3M.