X4 Update Tool

Zur Aktualisierung bestehender Versionen von X4 BPMS benötigen Sie das Update Tool. Das aktuelle Update Tool finden Sie auf der SoftProject-Website unter Ressourcen > Software X4 BPMS.

Allgemeine Hinweise

Wenn Sie den X4 Server einer älteren Produktlinie auf die aktuelle Produktlinie migrieren möchten, empfehlen wir, einen SoftProject-Consultant zu Rate zu ziehen, der Sie bei der Migration unterstützt. Für kundenseitig ausgeführte Updates kann SoftProject keine Gewähr übernehmen.
Wenn Keycloak oder der X4 Server aktualisiert werden sollen, benötigen Sie das Installationspaket X4 Server und Keycloak - ZIP-Archiv für ein Update mit dem Update Tool.
Während des Updates wird automatisch ein Backup erstellt. Wir empfehlen dennoch, vor dem Update ein Backup Ihrer gesamten X4 Installation zu erstellen.
Wenn das Update Tool während des Updates abstürzt, stellt es automatisch den vorherigen Zustand der X4 Installation wieder her.

Optionen im Update Tool

Das Update Tool bietet verschiedene Optionen für die Aktualisierung:

Option im Update Tool	Update-Art	Beschreibung	Argumente (Befehle in der Befehlszeile)
1	Geführtes Update (empfohlen)	Geführtes Update ohne Argumente	Keine Argumente
2	X4 Server-Update	Ausführung eines X4 Server-Updates	`--x4server` `--zip`
3	X4DB-Update	Ausführung eines Updates von X4DB	`--x4db`
4	X4-Datenbank-Update	Ausführung eines Datenbank-Updates	`--x4_jdbc` Optional: Wenn nicht angegeben, werden diese Werte abgefragt: `--x4_jdbc_user` `--x4_jdbc_password`
5	X4 Server als Windows Service	X4 Server als Windows Service installieren	`--installX4Service` `--x4server`
6	Keycloak als Windows Service	Keycloak als Windows Service installieren	`--installKeycloakService` `--keycloakPath`
7	Migration von benutzerdefinierten Platzhaltern (=globale Parameter)	Migration von benutzerdefinierten Platzhaltern (=globale Parameter)
nicht als Option angegeben	Vollständig automatisiertes Update	Für ein vollständig automatisiertes Update führen Sie das Update Tool mit allen Argumenten aus.	Alle Argumente

Liste der Java-Argumente

Argument	Beschreibung
`-?`, `-h`, `--help`	Zeigt die Befehlszeilenhilfe an.
`--backup`	Optional. Pfad zu einem zuvor manuell erstellten Backup. Wenn das Argument nicht angegeben wird, wird automatisch ein Backup erstellt.
`--installKeycloakService`	Installiert Keycloak als Windows Service.
`--installX4Service`	Installiert X4 als Windows Service.
`--keycloakPath`	Pfad zur Keycloak-Installation
`--x4_jdbc`	JDBC-URL für die Verbindung zur X4-Datenbank
`--x4_jdbc_password`	Passwort für den Datenbankbenutzer der X4-Datenbankverbindung
`--x4_jdbc_user`	Datenbankbenutzer für die X4-Datenbankverbindung
`--x4db`	Vollqualifizierter Pfad zum X4DB-Ordner
`--x4server`	Vollqualifizierter Pfad zum X4 Server-Ordner
`--zip`	Vollqualifizierter Pfad zur ZIP-Datei der neuen X4 Installation
`--silent`	Silent überspringt die Benutzerinteraktion für das JDBC-Update. Warnung! Dies kann zu Datenverlust führen. Erstellen Sie ein Backup Ihrer Datenbank, bevor Sie dieses Argument verwenden!
`--dry-run`	Simulationsmodus des Update Tools

Weitere Informationen finden Sie in der README.txt des Update Tools und auf den folgenden Seiten:

Update Tool starten

Simulationsmodus des Update Tools

Liquibase im Update Tool verwenden

Option 1: Vollständiges Update durchführen

Option 2: Update des X4 Servers

Option 3: Migration des X4DB-Ordners

Option 4: Update der X4 Datenbank

Option 5: Installation des X4 Servers als Windows Service

Option 6: Installation von Keycloak als Windows Service

Option 7: Migration der benutzerdefinierten Platzhalter (=globale Parameter)