search string side menu

BRIX On-Premises > BRIX On-Premises Enterprise / Update version of BRIX Enterprise offline

Update version of BRIX Enterprise offline

To ensure data integrity when migrating with a version change of the BRIX edition, it is recommended to update each major version without skipping any. For instance, version 2023.2.1 can be updated to 2023.3.1.

The BRIX 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 BRIX application.

Step 1: Determine the number of update steps

  1. Determine the version of the installed chart with which the BRIX 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 you need to update your chart for more than one version, install each major version until you reach the latest chart.

Important: in each version, install the latest minor release.

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

Examples:

  1. Installed chart version 2023.5.1, current (latest) chart version 2023.6.9. The update is done in one step: directly to 2023.6.9.
  2. Installed chart version 2023.3.23, current (latest) chart version 2023.6.9. The update is done in three steps: 2023.3.23 > 2023.4.60 > 2023.5.31 > 2023.6.9.
  3. Installed chart version 2023.11.56, current (latest) chart version 2023.4.42. The update is done in four steps: 2023.11.56 > 2024.1.32 > 2024.2.30 > 2024.3.36 > 2024.4.42.

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

Please note that your current version in an LTS version, you can update directly to the next LTS version according to the release life cycle schedule.

To see the list of all BRIX versions, use the following command:

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

You can also download a .tar.gz file with a specific BRIX version using the links provided in Links for downloading BRIX distribution packages.

Step 2: Download the helm chart of the latest version

  1. On a computer with internet access, download the recent BRIX images and upload them into the local image registry. For more details, see Download BRIX 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 BRIX 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 BRIX 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 BRIX 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 BRIX application

Update the BRIX 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 BRIX 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 BRIX Enterprise application parameters to complete.

version-update-enterprise.html database-backup-and-recovery.html