Option 2: Updating the X4 Server

General Information

With this option, you can only update the X4 Server without updating the X4DB folder, the X4 database and the Keycloak database.

The following steps are performed:

Backup of the existing X4 server
Unpacking of the new X4 Server installation
Copying of the X4DB folder into the new installation
Copying of the configurations and deployments folders into the new installation
Migration of configurations (de.softproject.x4.database.X4ConfigurationMigration )
Migration of Keyloak
Migration of Wildfly expansion modules

Note on updating custom files

Custom files (e.g. adapters, extensions, modules) that are NOT stored in the <Server_directory>\wildfly\modules\system\layers\base\de\softproject\x4\extensions\main\module.xml folder will NOT be migrated!

These files must be migrated manually by saving them here: <Server_directory>\Server\wildfly\modules\de\softproject\extensions\main\module.xml.

If you have also made changes in Wildfly, for example, in the standalone.xml file, these changes will not be adopted and must be done manually.

Steps in detail

The Update Tool guides you through the individual steps:

Backup your X4 Server
Backup: <Folder>\X4_7-3-1_Release\Server_bak_2024-02-29_12-56-19 successfully created
Unzip your X4 server installation
Successfully unzipped to (→ successfully unzipped to): <Folder>\X4_7-3-1_Release\Server
Copy your X4DB folder
Successfully copied
<Folder>\X4_7-3-1_Release\Server_bak_2024-02-29_12-56-19\X4DB to <Folder>\X4_7-3-1_Release\Server\X4DB
Copy your configurations and deployments folders.
Successfully copied
<Folder>\X4_7-3-1_Release\Server_bak_2024-02-29_12-56-19\configurations
to
<Folder>\X4_7-3-1_Release\Server\configurations
Successfully copied
<Folder>\X4_7-3-1_Release\Server_bak_2024-02-29_12-56-19\deployments
to
<Ordner>\X4_7-3-1_Release\Server\deployments
Migrate your configurations

Update Tool Note for the Configuration Migration (de.softproject.x4.database.X4ConfigurationMigration ):

Make sure the memory settings have been adjusted to the new X4 version and meet the minimum requirements:
1. Check the startX4.bat file for Windows installations and the X4 Server File file for Linux installations.
2. Check the standalone.conf.bat file for Windows installations if the X4 server is installed as a service.
Check the standalone.xml file to ensure that the <datasources> are configured correctly.
For Oracle database installations:
1. After the migration, you need to install the appropriate driver. You can find more information on how to set up an Oracle database here: (7.4.0-en) Setting up an Oracle database .
Any configuration files that are not part of X4 will not be migrated. You need to migrate these manually.

Migrate your Keycloak
Successfully migrate keycloak to the current installation (update tool message)
Migrate your WildFly extensions modules

This migration applies to a migration from X4 BPMS version 7.3.x to X4 BPMS 7.4.x.

The Wildfly Extension modules are moved from

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

to

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

Custom dependencies and resources are also moved:

Path before migration: <Server_directory>\wildfly\modules\system\layers\base\de\customer\custom\adapter

Path after migration: <Server_directory>\wildfly\modules\de\customer\custom\adapter

If you have made changes to your Wildfly, for example, in the standalone.xml file, thes changes are not adopted and need be done manually.

After the migration, check whether your custom changes from <Folder>\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 (e. g. custom adapters, implementations, and extensions) have been applied correctly and migrated to the new location: <Folder>\X4_7-3-1_Release\Server\wildfly\modules\de\softproject\extensions\main\module.xml.

After a successful update, the Update Tool generates a message:

Completed. BYE BYE!