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

Update version of ELMA365 Enterprise

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

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 three stages:

  1. Determine the number of update steps.
  2. Copy the configuration file from the currently installed version.
  3. 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. 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: Copy the configuration file from the currently installed version

Copy the configuration file values-elma365.yaml to the current directory. Use this file saved at the installation stage or the last update.

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

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

Note that 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. Obtain the updated values-elma365.yaml configuration file by executing the command.

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

  1. Manually transfer the application parameters from the old sample values-elma365.yaml configuration file (versions prior to 2023.4.30) to the new configuration file.

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

Execute the update of the ELMA365 application using the configuration file values-elma365.yaml. To do this:

  1. Sequentially perform the update for each intermediate minor version if there are intermediate minor versions (two or more update steps):

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

Updating the application takes 10-30 minutes at each step.

  1. Perform the update to the latest version:

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

The application update 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