Option 2: Update des X4 Servers

Allgemeine Informationen

Mit dieser Option können Sie nur den X4 Server aktualisieren, ohne den X4DB-Ordner, die X4-Datenbank und die Keycloak-Datenbank zu aktualisieren.

Folgende Schritte werden beim Update durchgeführt:

1. Sicherung des bestehenden X4 Servers

2. Entpacken der neuen X4 Server-Installation

3. Kopieren des X4DB-Ordners in die neue Installation

4. Kopieren der Ordner configurations und deployments in die neue Installation

5. Migration von Konfigurationen (de.softproject.x4.database.X4ConfigurationMigration)

6. Migration von Keycloak

7. Migration von Wildfly-Erweiterungsmodulen

Hinweis zur Aktualisierung von benutzerdefinierten Dateien

Benutzerdefinierte Dateien (z. B. Adapter, Erweiterungen, Module), die NICHT im Ordner  <Serververzeichnis>\wildfly\modules\system\layers\base\de\softproject\x4\extensions\main\module.xml gespeichert sind, werden NICHT migriert!

Diese Dateien müssen manuell migriert werden, in dem sie hier gespeichert werden: <Serververzeichnis>\Server\wildfly\modules\de\softproject\extensions\main\module.xml.

Wenn Sie außerdem Anpassungen in Wildfly vorgenommen haben, z. B. in der Datei standalone.xml, werden diese nicht übernommen und müssen manuell vorgenommen werden.

Schritte im Detail

Das Update Tool führt Sie durch die einzelnen Schritte:

1. Backup your X4 Server
   (→ Das Update Tool erstellt ein Backup Ihres X4 Servers.)
   Backup: <Ordner>\X4_7-3-1_Release\Server_bak_2024-02-29_12-56-19 successfully created

2. Unzip your X4 Server installation
   (→ Das Update Tool entpackt die neue X4 Server-Installation, auf die die Daten migriert werden sollen, in einen neuen Ordner.)
   Successfully unzipped to (→ Erfolgreich entpackt nach): <Ordner>\X4_7-3-1_Release\Server

3. Copy your X4DB folder
   (→Das Update Tool kopiert den X4DB-Ordner.)
   Successfully copied  (→ Erfolgreich kopiert)
   <Ordner>\X4_7-3-1_Release\Server_bak_2024-02-29_12-56-19\X4DBto <Ordner>\X4_7-3-1_Release\Server\X4DB

4. Copy your configurations and deployments folders
   (→Das Update Tool kopiert die Ordner configurations und deployments.)
   Successfully copied (→ Erfolgreich kopiert)
   <Ordner>\X4_7-3-1_Release\Server_bak_2024-02-29_12-56-19\configurations
   to
   <Ordner>\X4_7-3-1_Release\Server\configurations
   Successfully copied (→ Erfolgreich kopiert)
   <Ordner>\X4_7-3-1_Release\Server_bak_2024-02-29_12-56-19\deployments
   to
   <Ordner>\X4_7-3-1_Release\Server\deployments

5. Migrate your configurations
   (→ Das Update Tool migriert die Konfigurationsdateien.)

Hinweis des Update-Tools für die Konfigurationsmigration (de.softproject.x4.database.X4ConfigurationMigration):

1. Prüfen Sie, ob die Speichereinstellungen an die neue X4-Version angepasst sind und die Mindestanforderungen erfüllen:

   1. Überprüfen Sie die Datei startX4.bat für die Windows-Installation und die X4-Server-Datei für die Linux-Installation.

   2. Überprüfen Sie die Datei standalone.conf.bat für die Windows-Installation, wenn der X4 Server als Dienst installiert ist.

2. Überprüfen Sie die Datei standalone.xml, um sicherzustellen, dass die Datenquellen <datasources> korrekt konfiguriert sind.

3. Für Oracle-Datenbank-Installationen:

   1. Nach der Migration müssen Sie den entsprechenden Treiber installieren. Weitere Informationen zum Einrichten einer Oracle-Datenbank finden Sie hier: (7.4.0-de) Oracle-Datenbank einrichten.

4. Alle Konfigurationsdateien, die nicht Teil von X4 sind, werden nicht migriert. Diese müssen Sie manuell migrieren.

6. Migrate your Keycloak
   (→ Das Update-Tool migriert die Keycloak-Einstellungen.)
   Successfully migrate keycloak to the current installation (Meldung des Update Tools) 

7. Migrate your wildfly extensions modules
   (→ Das Update-Tool migriert die Wildfly Extension Module.)

Diese Migration gilt für eine Migration von X4 BPMS Version 7.3.x auf X4 BPMS 7.4.x.

Die Wildfly Extension Module werden verschoben von

<Serververzeichnis>\wildfly\modules\system\layers\base\de\softproject\x4\extensions

nach

<Serververzeichnis>\wildfly\modules\de\softproject\extensions

Benutzerdefinierte Abhängigkeiten und Ressourcen werden ebenfalls verschoben:

• Pfad vor der Migration: <Serververzeichnis>\wildfly\modules\system\layers\base\de\customer\custom\adapter

• Pfad nach der Migration: <Serververzeichnis>\wildfly\modules\de\customer\custom\adapter

Wenn Sie Anpassungen an Ihrem Wildfly vorgenommen haben, z. B. in der Datei standalone.xml, werden diese nicht übernommen und müssen manuell vorgenommen werden.

8. Prüfen Sie nach der Migration, ob Ihre benutzerdefinierten Änderungen aus <Ordner>\X4_7-3-1_Release\Server_bak_2024-02-29_12-56-19\wildfly\modules\system\layers\base\de\softproject\x4\extensions\main\module.xml (z.B. kundenspezifische Adapter, eigene Implementierungen und Erweiterungen) korrekt angewandt und an den neuen Standort migriert wurden: <Ordner>\X4_7-3-1_Release\Server\wildfly\modules\de\softproject\extensions\main\module.xml. 

Nach erfolgreichem Update erzeugt das Update-Tool eine Meldung:

Completed. BYE BYE!