GridGain Developers Hub

Updating Control Center

Control Center enables you to migrate data between versions during the version update process. Generally, we support Control Center versions 2 years back from the current (latest released) version - see the supported version table.

Use Generic Procedure for updates:

  • From 2022.3 to any more recent version

  • From 2022.2 or any more recent version to 2024.2 or more recent

Use Procedure for Versions Older than 2022.3 to update from versions older than 2022.3 to more recent versions up to and including 2024.1.1.

Generic Procedure

To update from 2022.3 to any more recent version, or from 2022.2 (or any more recent version) to 2024.2 or more recent:

  1. Create a storage backup of the work folder for the Control Center version you are migrating from.

  2. Enable the migration auto application by setting the control.repositories.auto-migrate-enabled parameter to true in the application.properties.

  3. Start the new version of Control Center.

    If the migration is successful, the log file contains information similar to the one below:

    [2021-04-20T10:36:31,706][INFO ][main][MigrationService] All new migrations were processed

    If the migration fails, the log file contains the following information:

    Failed to execute migration: {migration name}, please restore your DB from backup or manual remove migration changes
  4. In case of a migration failure:

Procedure for Versions Older than 2022.3

To update from Control Center versions older than 2022.3 to any more recent version up to and including 2024.1.1, you need to update to 2022.3 first:

  1. Create a storage backup of the work folder for the Control Center version you are migrating from.

  2. Install Control Center 2022.3.

  3. Enable the migration auto application by setting the control.repositories.auto-migrate-enabled parameter to true in the application.properties in 2022.3.

  4. Copy the work folder from 2022.2 and paste it under 2022.3.

  5. Start Control Center 2022.3.

  6. Wait until the migration is finished and Control Center 2022.3 is started.

  7. In case of a migration failure:

  8. Perform Generic Procedure.