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-Website unter Ressourcen > X4 Downloads.

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 der X4 Server aktualisiert werden soll, benötigen Sie das Installationspaket X4 Server – 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 Angabe von Argumenten	Keines der Argumente für den Expertenmodus ist angegeben: `--run-server-update` `--run-repository-update` `--run-database-update`
2	X4 Server-Update (Expertenmodus)	Ausführung eines X4 Server-Updates.	`--run-server-update` `--x4server` `--x4zip`
3	X4DB-Update (Expertenmodus)	Ausführung eines Updates von X4DB.	`--run-repository-update` `--x4db`
4	X4-Datenbank-Update (Expertenmodus)	Ausführung eines Datenbank-Updates.	`--run-database-update` `--x4_jdbc` Optional: Wenn nicht angegeben, werden diese Werte abgefragt: `--x4_jdbc_user` `--x4_jdbc_password`
5	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.
`--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

Ausgabe von Meldungen

Das Update-Tool verwendet zur Ausgabe von Meldungen das log4j-Framework. Die folgenden Protokollierungsregeln sind standardmäßig eingerichtet:

Alle Meldungen ab dem Log-Level INFO werden in der Konsole ausgegeben.
Alle Meldungen ab dem Log-Level DEBUG werden zusätzlich in einer Logdatei gespeichert.
Die Datei wird unter dem Namen migration-<timestamp>.log erzeugt und im Serververzeichnis abgelegt.

Bei Bedarf kann eine eigene log4j-Konfiguration eingebunden werden. Starten Sie das Update-Tool hierzu mit der folgenden Option:

java -jar -Dlog4j.configurationFile=<Pfad-zur-log4j2.xml> …

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