Upgrade

Daria Barysheva

Contents

Online update
Offline update

CAUTION

Before upgrade, it is strongly recommended to backup ADCM data. For more information, see Backup & 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).

Online update

If you need to upgrade the previously installed version of ADCM, do the following:

Stop the adcm container.
```
$ sudo docker stop adcm
```
Remove the adcm container.
```
$ sudo docker container rm adcm
```

Download the Docker image that you need 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.

Create a new container based on the uploaded image.

$ sudo docker create --name adcm -p 8000:8000 -v /opt/adcm:/adcm/data hub.arenadata.io/adcm/adcm:<version>

Start the new adcm container.
```
$ sudo docker start adcm
```

IMPORTANT

If you use ADCM with an external database, the container must be run with the appropriate environment variables.

Offline update

You can also try offline ADCM update in situations without Internet access. To upgrade the previously installed ADCM version offline, follow these steps:

Stop the adcm container.
```
$ sudo docker stop adcm
```
Remove the adcm container.
```
$ sudo docker container rm adcm
```

Download the Docker image that you need 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.

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.
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.
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
```

Create a new container based on the uploaded image.

$ sudo docker create --name adcm -p 8000:8000 -v /opt/adcm:/adcm/data hub.arenadata.io/adcm/adcm:<version>

Start the new adcm container.
```
$ sudo docker start adcm
```

Found a mistake? Seleсt text and press Ctrl+Enter to report it