ELMA365 On-Premises > ELMA365 Enterprise > Administering ELMA365 Enterprise / Update version of ELMA365 Enterprise offline

Update version of ELMA365 Enterprise offline

Начало внимание

To ensure data integrity during migration with a change in the version of the ELMA365 edition, it is necessary to update to each minor version (the second number in the version number) without skipping any, for example, version 2023.4.1 can be updated to 2023.5.1.

Конец внимание

The ELMA365 Enterprise update process consists of four stages:

  1. Determine the number of update steps.
  2. Download the helm chart of the latest version.
  3. Copy the configuration file from the currently installed version.
  4. Update using helm in the Kubernetes cluster for the ELMA365 application.

Step 1: Determine the number of update steps

  1. Determine the version of the installed chart with which the ELMA365 application was previously deployed or updated:

helm show chart elma365/elma365

  1. On a computer with internet access, determine the version of the latest chart:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm search repo elma365/elma365

  1. If the minor version of the installed chart differs by more than one from the minor version of the latest chart, then the update must be carried out in several stages for each minor version.

начало примера

Examples:

  1. If the installed chart version is 2023.5.1 and the latest chart version is 2023.6.9, then the update is done in one step (directly to 2023.6.9);
  1. If the installed chart version is 2023.3.23 and the latest chart version is 2023.6.9, then the update is done in three steps (2023.3.23->2023.4.x->2023.5.x->2023.6.9).

конец примера

Step 2: Download the helm chart of the latest version

  1. On a computer with internet access, download the recent ELMA365 images and upload them into the local image registry. For more details, see Download ELMA365 images.
  1. Update the list of charts in the repository:

helm repo add elma365 https://charts.elma365.tech
helm repo update

  1. If needed, download the archive files of the intermediate minor versions for all update steps:

helm pull elma365/elma365 --version <elma365-chart-version>

  1. Download the archive of the latest version of the ELMA365 On-Premises chart

helm pull elma365/elma365

  1. Copy the obtained archive (or archives, if there are intermediate update steps) of the elma365-X.Y.Z.tgz chart to the server where the update will be performed.
  1. On the server where the update will take place, unpack the elma365-X.Y.Z.tgz chart or charts, each into a separate directory.

mkdir /path/to/elma365-X.Y.Z.tgz
tar -xf elma365-X.Y.Z.tgz -C /path/to/elma365-X.Y.Z.tgz --strip-components=1

Step 3: Copy the configuration file from the currently installed version

Copy the configuration file values-elma365.yaml from the directory with the chart of the old (current) installation of ELMA365 On-Premises into each directory with the chart prepared at the step of downloading the helm-chart of the latest version.

If the values-elma365.yaml file was lost, retrieve the parameters of the current ELMA365 installation and save them in this file by executing the command:

helm get values elma365 [-n namespace] > values-elma365.yaml

Please note, starting from version 2023.4.30, the structure of the values-elma365.yaml configuration file has been updated.

If you are updating from 2023.4.0-21 or earlier versions to 2023.4.30 or newer versions, you need to:

  1. On a computer with internet access, obtain the updated configuration file values-elma365.yaml by executing the command.

helm show values elma365/elma365 > values-elma365.yaml

  1. Copy the new file values-elma365.yaml to the server where the update will be performed.
  1. Manually transfer the application parameters from the old  configuration file values-elma365.yaml (versions before 2023.4.30) to the new configuration file.

Step 4: Update using helm in the Kubernetes cluster for the ELMA365 application

Update the ELMA365 applications using the values-elma365.yaml configuration file. If there are intermediate minor versions (two or more update steps), sequentially perform the update for each intermediate minor version.

Navigate to the directory with the required version of ELMA365 and execute the command:

helm upgrade --install elma365 ./elma365 -f values-elma365.yaml --timeout=30m --wait [-n namespace]

Updating the application takes 10-30 minutes. Wait for the update of the ELMA365 Enterprise application parameters to complete.

Found a typo? Highlight the text, press ctrl + enter and notify us