X4 Update Tool | X4Documentation

Zur Aktualisierung bestehender Versionen von X4 BPMS benötigen Sie das Update Tool. Das aktuelle Update Tool finden Sie auf der SoftProject-Webseite 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.
Das Installationspaket X4 Server und Keycloak - ZIP-Archiv ist für ein Update mit dem Update Tool erforderlich, wenn Keycloak oder der X4 Server aktualisiert werden sollen.
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.
`--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: