Upgrade

Daria Barysheva, Adelya Zvyagintseva
CAUTION

General recommendations and limitations

  • Before upgrading, it is strongly recommended to back up ADCM data. For more information, see Backup and restore.

  • Downgrade of the ADCM version is not supported.

  • It is not recommended to update ADCM more than 5 minor versions ahead (see <minor> in the versioning format below).

  • Before upgrading ADCM to version 2.7, migrate data from SQLite to PostgreSQL. Migration can be performed in any ADCM version up to and including 2.6.

Version restrictions during upgrade

  • Version 2.10 is mandatory for installation and cannot be skipped. Direct upgrade from versions lower than 2.10 to 2.11 and later is not supported.

  • If installed clusters contain products with an outdated contract version, a warning about unsupported contract versions is displayed in the Docker container logs.

  • If installed clusters contain products with an unsupported contract version, the Docker container startup is stopped. Such products should be updated to a supported version.

The ADCM update process depends on the installation method of ADCM.

Update using ADCM Installer

If ADCM was deployed using ADCM Installer, the update is performed by modifying the configuration and applying the changes using the adi utility.

To update ADCM to the required version, follow these steps:

  1. Open the adcm.yaml configuration file used during installation.

  2. In the section corresponding to ADCM, specify the Docker image of ADCM with the required version tag in the image parameter, for example, hub.arenadata.io/adcm/adcm:2.12.0.

  3. Apply the changes:

    $ adi apply

    After the adi apply command is executed, the ADCM container will be recreated using the image specified in the image parameter of the adcm.yaml file.

Online update

If you need to upgrade the previously installed version of ADCM that was installed without using ADCM Installer, do the following:

  1. Stop and remove the adcm container:

    $ sudo docker rm -f adcm

  2. Download the required Docker image from the Arenadata Docker Registry:

    $ sudo docker pull hub.arenadata.io/adcm/adcm:<version>

    where <version> is a desired ADCM image version in one of the following formats:

    • <major>.<minor>.<patch> — if you need a specific ADCM patch. For example, 2.0.0.

    • <major>.<minor> — if you need the last patch within the selected ADCM version. For example, 2.0.

    IMPORTANT

    • latest was used for earlier versions of ADCM and is no longer supported starting from version 2.0.0.

    • Before ADCM 2.0.0, the following format was used for versioning: YYYY.MM.DD.HH.

  3. Create and start a new container based on the downloaded image:

    $ sudo docker run --name adcm -p 8000:8000 -v /opt/adcm:/adcm/data -e DB_HOST="<DATABASE_HOSTNAME_OR_IP_ADDRESS>" -e DB_PORT="<DATABASE_TCP_PORT>" -e DB_USER="<DATABASE_USERNAME>" -e DB_NAME="<DATABASE_NAME>" -e DB_PASS="<DATABASE_USER_PASSWORD>" -e DB_OPTIONS="<DATABASE_OPTIONS>" hub.arenadata.io/adcm/adcm:<version>
    NOTE
    For more information on the environment variables (DB_HOST, DB_PORT, DB_USER, DB_NAME, DB_PASS, and DB_OPTIONS), see the Installation article.

Offline update

You can also try offline ADCM update in situations without Internet access.

To upgrade ADCM that was installed without using ADCM Installer offline, follow these steps:

  1. Stop and remove the adcm container:

    $ sudo docker rm -f adcm
    NOTE
    For customers who use Enterprise editions of products, it is possible to contact the Arenadata support team to get an archive with the sh.xz extension that contains a special installation shell script. After stopping the adcm container, the ADCM update process includes the installation according to the instruction.

  2. Download the required Docker image from the Arenadata Docker Registry on a host that has Internet access:

    $ sudo docker pull hub.arenadata.io/adcm/adcm:<version>

    where <version> is a desired ADCM image version in one of the following formats:

    • <major>.<minor>.<patch> — if you need a specific ADCM patch. For example, 2.0.0.

    • <major>.<minor> — if you need the last patch within the selected ADCM version. For example, 2.0.

    IMPORTANT

    • latest was used for earlier versions of ADCM and is no longer supported starting from version 2.0.0.

    • Before ADCM 2.0.0, the following format was used for versioning: YYYY.MM.DD.HH.

  3. Save the Docker image to a .tar file:

    $ sudo docker save -o <file_name> hub.arenadata.io/adcm/adcm:<version>

    where <file_name> is the full name of the created file with the extension (for example, adcm_2.5.0_arenadata.tar).

    NOTE
    Running the command can take some time. Please wait until it is completed.

  4. Copy the saved file from the current host to a host without Internet connection using any available methods.

    IMPORTANT
    Make sure you have configured access to hosts and necessary file permissions.

  5. Load the Docker image from the .tar file:

    $ sudo docker load -i <file_path>

    where <file_path> is the absolute path to the .tar file with the Docker image.

    The example of a successful command execution result:

    Loaded image: hub.arenadata.io/adcm/adcm:2.5.0

  6. Create and start a new container based on the downloaded image:

    $ sudo docker run --name adcm -p 8000:8000 -v /opt/adcm:/adcm/data -e DB_HOST="<DATABASE_HOSTNAME_OR_IP_ADDRESS>" -e DB_PORT="<DATABASE_TCP_PORT>" -e DB_USER="<DATABASE_USERNAME>" -e DB_NAME="<DATABASE_NAME>" -e DB_PASS="<DATABASE_USER_PASSWORD>" -e DB_OPTIONS="<DATABASE_OPTIONS>" hub.arenadata.io/adcm/adcm:<version>
    NOTE
    For more information on the environment variables (DB_HOST, DB_PORT, DB_USER, DB_NAME, DB_PASS, and DB_OPTIONS), see the Installation article.
Found a mistake? Seleсt text and press Ctrl+Enter to report it