Aktualisierungsprozess

Mit Zero Downtime Upgrade können Sie Ihr AE-System ohne Systemausfälle aktualisieren. Der System Upgrade-Assistent im Automic Web Interface führt Sie durch alle Schritte des Upgrade-Vorgangs. Es besteht keine Notwendigkeit für ein Scripting oder die Verwendung interner Komponenten der AE.

Sie können auch das Zero Downtime Upgrade verwenden, wenn das alternative MS SQL Server-Schema bereits verwendet wird. Sie können damit jedoch nicht zu diesem Schema wechseln. Weitere Informationen finden Sie unter Integration eines alternativen MS SQL Server-Schemas.

Die Kommunikation zwischen der AE und dem AWI sowie zwischen der AE und den Windows-, UNIX- und Java-Agenten verwendet TLS/SSL über ein sicheres WebSocket (WSS). Diese Komponenten richten eine Verbindung mit dem Java-Kommunikationsprozess (JCP) ein.

Der Java-Kommunikationsprozess (JCP) verwendet vertrauenswürdige Zertifikate, um seine Identität anderen Kommunikationspartnern gegenüber nachzuweisen, und benötigt einen Keystore, um mit diesen Zertifikaten zu arbeiten. Deshalb müssen Sie den Java-Kommunikationsprozess (JCP) installieren und konfigurieren und sicherstellen, dass Sie die erforderlichen Zertifikate haben.

Windows-, UNIX- und Java-Agenten können verschiedene Parameter in ihrer entsprechenden INI-Datei verwenden, um zu definieren, wie man die Zertifikate bearbeitet.

Hinweis: Die TLS/SSL-Implementierung gilt nicht für die HP-UX- und ZLINUX (32 Bit)-Agenten, da sie nicht mehr unterstützt werden.

Mehr Informationen:

Wichtig!

Verwenden Sie das ZDU nur zum Aktualisieren von Systemen, die manuell installiert wurden, oder für Testsysteme, die unter Verwendung des ONE Installer installiert wurden. Sie können unter Verwendung der Zero Downtime Upgrade nicht auf ein Container-basiertes System migrieren oder ein Container-basiertes System aktualisieren.
Es ist nicht möglich, ein Centralized Agent Upgrade (CAU) parallel zu einem Zero Downtime Upgrade durchzuführen.
Die AWI-Instanzen in Versionen höher als 12.3 stellen eine Verbindung zum neuen JCP her, das die erforderlichen Zertifikate zur Verfügung haben muss.
Während des ZDU ist der neue JCP erst verfügbar, nachdem die Verbindungen in Schritt 4 des Assistenten umgeschaltet wurden und der primäre Arbeitsprozess (PWP) in der neuen Version ausgeführt wird.

Führen Sie daher kein Upgrade der AWI-Instanz durch, die Sie für Zero Downtime Upgrade verwenden. Stellen Sie sicher, dass Sie für eine separate, aktualisierte Instanz Ihres Automic Web Interface besitzen, nachdem die Verbindungen umgeschaltet wurden.

Wenn Sie Hilfe benötigen, wenden Sie sich an unser Support-Team. Unsere Berater sind Experten für Upgrades von AE-Systemen und helfen Ihnen bei Bedarf gerne weiter. Weitere Informationen finden Sie unter Support.

Diese Seite beinhaltet Folgendes:

Übersicht

Es wird empfohlen, ein Upgrade nur dann zu starten, wenn die notwendigen Vorbereitungen für die Einrichtung und den Test getroffen wurden.

Während des Upgrades werden zwei verschiedene Modi aktiviert: der Kompatibilitätsmodus und der parallele Modus.

Kompatibilitätsmodus

Dieser Modus ist während des gesamten Upgrade-Vorgangs aktiv, selbst wenn Sie ein Rollback durchführen. Bestimmte Systemoptimierungsfunktionen sind im Kompatibilitätsmodus nicht verfügbar und die Systemleistung wird um ungefähr ein Drittel reduziert.

Sie können einen Arbeitsprozess (WP) nicht auf einen Dialog-Arbeitsprozess (DWP) umschalten, während Sie sich im Kompatibilitätsmodus befinden.
Parallelmodus

Dieser Modus ist nur aktiv, wenn Serverprozesse aus der aktuellen und der neuen Version gleichzeitig aktiv sind. Die Arbeitsprozesse (WPs) der aktuellen Version werden möglicherweise langsamer, bis das Upgrade abgeschlossen ist.

Während des Upgrades werden Sie gebeten, umfassend zu testen, ob alles funktioniert, bevor Sie das Upgrade durchführen. Wenn Probleme auftreten, können Sie die Option Rollback verwenden. Es ist nur in Schritt 4 (Verbindungen) des Assistenten verfügbar, wenn es erfolgreich verarbeitet wurde. Weitere Informationen finden Sie auf der Seite .

Hinweis: Alle Datenbankänderungen bleiben bestehen, selbst wenn Sie die Rollback-Option verwenden.

Wenn ein Automation Engine-Prozess, der die alte Version ausführt, stoppt, kann er nicht neu gestartet werden. Wenn alle Automation Engine-Prozesse beendet werden (beispielsweise aufgrund eines Stromausfalls), beendet das Zero Downtime Upgrade den Upgrade-Vorgang. In diesem Fall können Sie kein Rollback durchführen. Nachdem der Upgrade-Vorgang abgeschlossen ist, enden die alten Serverprozesse automatisch.

Sobald Sie den Upgrade-Prozess abgeschlossen haben, indem Sie im letzten Schritt des Assistenten auf Weiter klicken, ist ein Rollback nicht mehr möglich.

Wenn der Upgrade-Prozess abgeschlossen ist, endet der Kompatibilitätsmodus und das System läuft wieder normal.

Wichtig!

Es wird dringend empfohlen, die folgenden Upgrade-Schritte in der Reihenfolge durchzuführen, wie sie in der CAPKI-Dokumentation aufgeführt sind. Weitere Informationen finden Sie unter CAPKI - Sicherung des ServiceManagers.
Es ist möglich, die Berechtigung für diese Art von Upgrade für jedes Benutzerobjekt festzulegen, aber es wird empfohlen, dass nur die Systemadministratoren Aktualisierungen koordinieren und durchführen.
Das Upgrade muss von Anfang bis Ende im gleichen Mandanten durchgeführt werden.
Nehmen Sie während des Upgrades keine Änderungen in Mandant 0 vor, während Sie das Dienstprogramm DB Load verwenden, da erste Daten eingefügt/aktualisiert werden. Andernfalls gibt es Inkonsistenzen in Ihrem System.
Dienstprogramme können nach dem Upgrade der Datenbank in Schritt 2 (Prozesse) des Assistenten nicht mehr zurückgesetzt werden. Sie müssen ab diesem Zeitpunkt die Dienstprogramme in der neuen (Ziel-) Version verwenden.
Automation Engine Dienstprogramme sind externe Anwendungen. Stellen Sie sicher, dass während des Zero Downtime Upgrade-Prozesses keine Dienstprogramme ausgeführt werden.
Hinweis: der Automic Web Interface- und der AE-Server müssen die gleiche Release-Version haben. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilitätsinformationen oder indem Sie direkt auf die compatibility matrix zugreifen.

Voraussetzungen

Stellen Sie sicher, dass Ihr System die System- und Benutzervoraussetzungen erfüllt. Andernfalls funktioniert die Zero Downtime Upgrade nicht ordnungsgemäß.

Systemeinrichtung

Um die Zero Downtime Upgraderichtig ausführen zu können, müssen Sie eine verteilte Installation verwenden. Diese Installationen können sich entweder auf zwei getrennten Hosts oder zwei getrennten Installationen auf demselben Host befinden, jedoch in unterschiedlichen Bin-Verzeichnissen. Weitere Informationen finden Sie unter ZDU Verteilte Installation.

Der Aktualisierungsprozess verweist entweder auf das aktuelle (Basis-) oder das neue (Ziel-) System, die auch die aktuelle und neue Version im Aktualisierungsszenario darstellen.

Wenn Sie einen Proxy und eine Firewall in den Systemen verwenden, die für das Upgrade verwendet werden, müssen Sie die Ports entsprechend konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von Firewall und Ports

Informationssicherheitsdienste, wie die TLS/SSL-Implementierung des ServiceManagers, erfordern Funktionen, die vom CAPKI-Paket bereitgestellt werden. Sie müssen CAPKI auf allen Computern installieren, auf denen die AE-Prozesse oder der ServiceManager und alle seine Mandanten laufen.

Wichtig! Überschreiben Sie in einer UNIX-Umgebung die vorhandene Installation nicht. In UNIX kann dies ohne Warnung geschehen, selbst wenn die Binärdateien derzeit verwendet werden.

Die Kommunikation zwischen der AE und dem AWI verwendet TLS/SSL über ein sicheres WebSocket (WSS). Die aktualisierte AWI-Instanz richtet eine Verbindung mit dem neuen Java-Kommunikationsprozess(JCP) ein, der vertrauenswürdige Zertifikate verwendet, um seine Identität anderen Kommunikationspartnern gegenüber nachzuweisen, und benötigt einen Keystore, um mit diesen Zertifikaten zu arbeiten. Deshalb müssen Sie den neuen Java-Kommunikationsprozess (JCP) installieren und konfigurieren und sicherstellen, dass Sie die erforderlichen Zertifikate haben.

Mehr Informationen:
Benutzerberechtigungen einstellen

Stellen Sie sicher, dass der jeweilige Benutzer (normalerweise Systemadministratoren) die notwendigen Berechtigungen hat. Der Benutzer, der das Upgrade durchführt, benötigt die Berechtigung Systemaktualisierungen durchführen, die im entsprechenden Benutzerobjekt festgelegt ist. Weitere Informationen finden Sie unter Berechtigungen Automation Enginegewähren.

Upgrade und Rollback

Wählen Sie in der Administration-Perspektive Automation Engine Management > System-Upgrade und klicken Sie auf System Upgrade-Assistent ausführen, um die Zero Downtime Upgrade zu starten.

Beim Aktualisieren können Sie den Prozess jederzeit verlassen und später wieder zu ihm zurückkehren. Das System speichert die Informationen des Schrittes, an dem Sie aufgehört haben, und öffnet die Seite System Upgrade automatisch bei diesem Schritt, sobald Sie zurückkehren.

Rollback

Mit der Rollback-Funktion können Sie Aufgaben oder Prozesse prüfen, die möglicherweise nicht erwartungsgemäß ausgeführt werden, während Sie die neue (Ziel-) Version testen. Sie ist in Schritt 4 (Verbindungen) des System Upgrade-Assistenten sichtbar, sobald die Serverprozesse aus der neuen (Ziel-) Version gestartet wurden und ausgeführt werden. Mit dieser Option wird die Verarbeitung auf die aktuelle (Basis-) Version zurückgesetzt.

Sobald Sie den Upgrade-Prozess abgeschlossen haben, indem Sie im letzten (siebten) Schritt des Assistenten mit Weiter bestätigen, ist ein Rollback nicht mehr möglich.

Wichtig! Beachten Sie bei einem Rollback von Versionen höher als 12.3, dass die Kommunikation zwischen der Automation Engine und dem Automic Web Interface durch den neuen Java-Kommunikationsprozess (JCP) hergestellt wird. Das bedeutet, dass Sie das Rollback in der Zielversion der AWI starten und in der aktuellen (Basis-) Version der AWI fortfahren müssen.

Upgrade-Schritte

Melden Sie sich bei Mandant 0 im Automic Web Interface an.

Wenn einem Benutzer das Recht System-Upgrades ausführen zum ersten Mal erteilt wurde, muss sich dieser Benutzer abmelden, neu starten und sich dann erneut bei Mandant 0 mit diesen Zugangsdaten anmelden.
Wählen Sie in der Administration-Perspektive Automation Engine Management > System Upgrade aus, und klicken Sie auf System Upgrade-Assistenten ausführen, um das Upgrade zu starten.

Dadurch wird der Kompatibilitätsmodus gestartet und es wird ein Upgrade der Datenbank mit dem Schema und den anfänglichen Daten der neuen (Ziel-) Version aktiviert.

Hinweis: Lassen Sie die Seite offen und verwenden Sie das externe Dienstprogramm DB Load, um die Datenbank zu aktualisieren. Weitere Informationen finden Sie unter AE DB Load.

Das DB Load Utility führt die folgenden Aktionen durch:
- System-Check durchführen
  
  Wenn die Variable ZERO_DOWNTIME_UPGRADE auf N gesetzt ist und das System ausgeführt wird, beendet DB Load den Ladevorgang mit einer entsprechenden Meldung.
- Versionsprüfung:
  
  DB Load prüft, ob die richtige Version für die Zero Downtime Upgrade installiert ist und verwendet wird. Wenn die Version falsch ist, wird eine entsprechende Meldung zurückgegeben.
- Prüfen und Laden eines neuen DB-Schemas und der anfänglichen Daten
  - Wenn Variable ZERO_DOWNTIME_UPGRADE auf N gesetzt ist und das System nicht läuft, lädt DB Load das neue DB-Schema und die anfänglichen Daten. Datensätze werden in die entsprechende Datenbanktabelle zur zukünftigen Referenz geschrieben.
  - Wenn die Variable ZERO_DOWNTIME_UPGRADE auf Y gesetzt ist und das System läuft, lädt DB Load auch das neue DB-Schema und die anfänglichen Daten. Andernfalls bricht DB Load ab und gibt die entsprechende Meldung zurück.
  - Zusätzlich prüft DB Load, ob die Serverprozesse der neuen Version bereits aktiv sind. In diesem Fall endet DB Load und gibt die entsprechende Meldung zurück.

Während dieses Schrittes lädt das AE-System das Datenbankschema der neuen Version und die Anfangsdaten. Wenn Sie das Upgrade der Datenbank mit dem Dienstprogramm DB Load beendet haben, klicken Sie auf Weiter, um den Schritt im Assistenten zu bestätigen. Die Automation Engine prüft, ob die anfänglichen Daten für die aktuelle und neue Version vorhanden sind und die Daten der neuen Version korrekt geladen wurden.

Installieren und starten Sie die Serverprozesse für die neue Version parallel zu denjenigen, die bereits in der aktuellen Version ausgeführt werden. Die neuen Prozesse werden noch nicht verwendet.

Wichtig!
- Beachten Sie bei der Aktualisierung auf Versionen höher als 12.3, dass die Kommunikation zwischen der Automation Engine und der Automic Web Interface durch den neuen Java-Kommunikationsprozess (JCP) hergestellt wird, der die erforderlichen Zertifikate besitzen muss, bevor der neue JCP gestartet wird (siehe Hinweise zu TLS-/SSL-Zertifikaten). Das bedeutet, dass Sie den Serverprozess in Ihrem Service Manager starten können, aber der primäre Arbeitsprozess (PWP) der aktuellen Version erkennt ihn nicht. Deshalb wird der neue JCP nicht auf der Seite Automation Engine Management > Prozesse und Auslastung der Administration-Perspektive angezeigt, bis die Verbindungen in Schritt 4 des Assistenten umgeschaltet wurden und der primäre Arbeitsprozess (PWP) in der neuen Version ausgeführt wird.
- Stellen Sie sicher, dass CP und JCP ausgeführt werden.
Stellen Sie sicher, dass Sie eine separate, aktualisierte Instanz des Automic Web Interface zur Verfügung haben, nachdem die Verbindungen in Schritt 4 (Verbindungen) des Assistenten umgeschaltet wurden.

Wichtig!
- Führen Sie kein Upgrade der AWI-Instanz durch, die Sie für verwendenZero Downtime Upgrade. Stellen Sie sicher, dass Sie eine separate Instanz aktualisieren.
- Da AWI-Instanzen in Versionen höher als 12.3 eine Verbindung zum neuen JCP herstellen, führen Sie kein Upgrade des AWI durch und versuchen Sie das Zero Downtime Upgrade sofort in der neuen AWI-Version fortzusetzen. Denken Sie daran, dass der neue JCP erst verfügbar ist, nachdem die Verbindungen in Schritt 4 des Assistenten umgeschaltet wurden und der primäre Arbeitsprozess (PWP) in der neuen Version ausgeführt wird. Denken Sie auch daran, dass der JCP die erforderlichen Zertifikate besitzen muss.
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.
Wenn Sie eine aktualisierte Instanz des AWI für später verfügbar haben, klicken Sie auf Weiter, um den Schritt im Assistenten zu bestätigen und mit Schritt 4 (Verbindungen) fortzufahren.
In diesem Schritt (Verbindungen) werden die Serverprozesse der aktuellen und neuen Versionen umgeschaltet.

Hinweis: Wenn die Verbindungen zur neuen Version wechseln, enthält die WP-Logdatei möglicherweise die Meldung "UCMAIN_R: Unexpected KICK with type 'RLASS' occurred." oder eine andere KICK-Meldung. Sie können diese Meldung ignorieren, während sich ZDU im gemischten Modus befindet, da sich das Problem von selbst behebt, sobald der ZDU-Prozess abgeschlossen ist.

Die ausgeführten Aufgaben enden auf den Prozessen der aktuellen Version, während neue Aufgaben auf den Prozessen der neuen Version starten, bis alle Prozesse der aktuellen Version inaktiv sind. Deshalb müssen alle Benutzer, die weiterhin mit den AWI-Instanzen der aktuellen Version verbunden sind, getrennt werden. Außerdem müssen Sie alle Agenten, die mit Prozessen der aktuellen Version verbunden sind, manuell trennen, damit sie automatisch wieder mit den Prozessen der neuen Version verbunden werden. Stellen Sie sicher, dass die Agenten getrennt werden können, ohne dass laufende Ausführungen unterbrochen werden.

Wichtig! Denken Sie daran, dass der neue JCP erst verfügbar ist, nachdem die Verbindungen umgeschaltet wurden und das System in der neuen Version ausgeführt wird.

Der Assistent bietet eine interaktive Seite mit zwei Bereichen, in denen Sie Benutzer und Agenten selbst trennen können. Die Schaltflächen zum Trennen von Benutzern und Neustart-Agenten ändern die Seite des Bereichs und erscheinen über der Tabelle für neue oder alte Versionen, je nachdem, welche Funktion Sie verwenden: Upgrade oder Rollback.
- So trennen Sie einen oder mehrere Benutzer gleichzeitig:
  
  Greifen Sie auf die Benutzerliste im Bereich Verbindungen zu. Wählen Sie den oder die Benutzer aus, die Sie trennen möchten, und klicken Sie auf Benutzer trennen. Um die Verbindung aller Benutzer zu trennen, klicken Sie auf die entsprechende Schaltfläche. In diesem Fall ist keine Auswahl erforderlich.
  
  Die getrennten Benutzer werden nicht mehr in der Liste angezeigt.
- So stellen Sie die Verbindung zu einem oder mehreren Agenten gleichzeitig her:
  
  Greifen Sie auf die Liste Agenten im Bereich Verbindungen zu. Wählen Sie den oder die Agenten aus, den bzw. die Sie erneut verbinden möchten, und klicken Sie auf Agent neu verbinden. Um die Verbindung zu allen Agenten wiederherzustellen, klicken Sie auf die entsprechende Schaltfläche. In diesem Fall ist keine Auswahl erforderlich.
  
  Die erneut verbundenen Agenten werden entweder in der aktuellen Version oder in der Liste der neuen Versionen angezeigt, abhängig von der Version, in der Sie sie erneut verbunden haben.
Das System wird jetzt mit den anfänglichen Daten und Prozessen aus der neuen Version ausgeführt, während die Prozesse der aktuellen Version anschließend entfernt werden.

Wichtig!
- Die Option Rollback ist zu diesem Zeitpunkt verfügbar (in den vorherigen Schritten ist sie nicht sichtbar). Dies ist die letzte Gelegenheit zum Rollback, bevor Sie den Upgrade-Prozess abschließen.
- Beachten Sie bei einem Rollback von Versionen höher als 12.3, dass die Kommunikation zwischen der Automation Engine und dem Automic Web Interface durch den neuen Java-Kommunikationsprozess (JCP) hergestellt wird. Das bedeutet, dass Sie das Rollback in der Zielversion der AWI starten und in der aktuellen (Basis-) Version der AWI fortfahren müssen.
- Dieser Parallelmodus sollte so lange dauern, wie es für eine ordnungsgemäße Prüfung erforderlich ist. Wenn Sie das System testen, können Sie prüfen, ob alle Prozesse und Aufgaben problemlos ausgeführt werden können. Sobald Sie das System getestet haben und Sie festgestellt haben, dass das Upgrade erfolgreich war, können Sie den letzten Schritt des Vorgangs durchführen, um das Upgrade fertigzustellen. Weitere Informationen finden Sie unter FAQ - Zero Downtime Upgrade.
Nachdem die Verbindungen umgeschaltet wurden und das System in der neuen Version ausgeführt wird, melden Sie sich vom AWI ab und mit der aktualisierten neuen Automic Web Interface-Instanz wieder an.

Greifen Sie erneut auf die Seite System-Upgrade zu. Das System speichert die Informationen des Schrittes, an dem Sie aufgehört haben, und öffnet die Seite bei diesem Schritt automatisch, sobald Sie zurückkehren. Klicken Sie auf Weiter, um den Schritt im Assistenten zu bestätigen und fortzufahren.

Außerdem wird der neue JCP jetzt auf der Seite Automation EngineManagement > Prozesse und Auslastung der Administration-Perspektive angezeigt.
Wenn das Testen erfolgreich war, klicken Sie auf Weiter. Analytics, CDA und andere Plug-Ins und Zusatzkomponenten können hier aktualisiert werden.
Überprüfen Sie die Speichereinträge in der Datenbank und löschen Sie die Einträge, die sich auf die alte Version beziehen.
Wenn Sie Ihre Agenten aktualisieren möchten, verwenden Sie die Centralized Agent Upgrade (CAU)Zentralisierte Agentenaktualisierung (. Weitere Informationen finden Sie unter CAU - Aktualisierungsprozess.

Wenn Sie auf Weiter klicken, wird der Upgrade-Prozess abgeschlossen. Dies ist nur möglich, wenn keine Prozesse der aktuellen Version mehr aktiv sind. Dadurch werden auch die parallelen und Kompatibilitätsmodi beendet. Nachdem Sie dies getan haben, ist ein Rollback nicht mehr möglich.

Hinweis: Wenn die Fehlermeldung ZERO_DOWNTIME_UPGRADE - 'FINALIZE' nicht möglich. Zu beendende Arbeitsprozesse sind noch nicht im Leerlauf. Versuchen Sie es später erneut. wird angezeigt, Zeitplanaufgaben sind möglicherweise aktiv. Warten Sie, bis die geplanten Aufgaben ihren Ausführungszeitraum geändert haben (normalerweise am nächsten Tag), kehren Sie dann zum Assistenten zurück und versuchen Sie, die Option erneut auszuführen.

Rollback-Schritte

Ein Rollback ist nur in Schritt 4 (Verbindungen) des System Upgrade-Assistenten möglich. Sie können das Upgrade jederzeit verlassen und später wieder zu ihm zurückkehren. Das Automation Engine-System speichert die Informationen des Schrittes, an dem Sie aufgehört haben, und öffnet die Seite System Upgrade automatisch bei diesem Schritt, sobald Sie zurückkehren.

Wählen Sie in Schritt 4 (Verbindungen) des Assistenten Rollback und folgen Sie den Anweisungen.

Wichtig! Beachten Sie bei einem Rollback von Versionen höher als 12.3, dass die Kommunikation zwischen der Automation Engine und dem Automic Web Interface durch den neuen Java-Kommunikationsprozess (JCP) hergestellt wird. Das bedeutet, dass Sie das Rollback in der Zielversion der AWI starten und in der aktuellen (Basis-) Version der AWI fortfahren müssen.
Das System wechselt unter Verwendung der Serverprozesse von der aktuellen Version zurück, während die neuen Prozesse anschließend schrittweise entfernt werden.

Ausnahme! Die Primärrolle (PWP) bleibt bei einem neuen WP bis zum Neustart erhalten.
Zwei Hauptszenarien können zu einem Rollback führen:
1. Etwas in AE-Objektdefinitionen oder Umgebungseinstellungen muss angepasst werden, um mit der neuen Version korrekt zu arbeiten. In diesem Fall stellen Sie sicher, dass Sie das Problem lösen und mit Schritt 1 (Anfängliche Daten) im Assistenten fortfahren.
  
  Um aus Schritt 4 (Verbindungen) zu Schritt 1 (Anfängliche Daten) zurückzukehren, stellen Sie sicher, dass Sie sich im Rollback-Modus befinden, und klicken Sie auf Weiter.
2. Die anfänglichen Daten oder die Prozesse der neuen Version funktionieren nicht wie erwartet. Wenden Sie sich in diesem Fall an unseren Support. Weitere Informationen finden Sie unter Support.
  - Wenn zur Lösung des Problems neue Komponenten installiert werden müssen, führen Sie in Schritt vier des Assistenten (Rollback-Modus) die Option Restart aus. Dadurch wird der Parallelmodus beendet und die PWP-Rolle wieder auf die aktuelle Version umgestellt und laufende Komponenten der neuen Version heruntergefahren, sodass sie ersetzt werden können.
    
    Hinweis: Wenn ein Rollback aus dem parallelen Modus ausgeführt wird, beendet die aktuelle Version die Prozesse aus der höheren Version. Da die aktuelle Version nur Prozesse beenden kann, die sie bereits kennt, muss der Benutzer alle anderen Prozesse manuell beenden. Beispielsweise kann die aktuelle Version (12.3) während einer ZDU von 12.3 auf eine höhere Version den JCP nicht beenden.
  - Installieren Sie Komponenten, die Sie möglicherweise von unserer Support-Abteilung erhalten haben, und fahren Sie mit dem Aktualisierungsverfahren Schritt 1 fort, indem Sie auf Weiter klicken, um die Prüfung auf anfängliche Daten zu starten, wie vorstehend beschrieben.
  Hinweis: Wenn Sie auf Neustart klicken, wird möglicherweise die Fehlermeldung ZERO_DOWNTIME_UPGRADE - 'Neustart' nicht möglich. Zu beendende Arbeitsprozesse sind noch nicht im Leerlauf. Versuchen Sie es später erneut. wird angezeigt, Zeitplanaufgaben sind möglicherweise aktiv. Warten Sie, bis die geplanten Aufgaben ihren Ausführungszeitraum geändert haben (normalerweise am nächsten Tag), kehren Sie dann zum Assistenten zurück und versuchen Sie, die Option erneut auszuführen.

Siehe auch: