search string side menu

ELMA365 On-Premises > ELMA365 On-Premises Enterprise / Офлайн-обновление версии ELMA365 Enterprise

Офлайн-обновление версии ELMA365 Enterprise

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

Для обеспечения целостности при миграции данных со сменой версии редакции ELMA365 необходимо выполнять обновление на каждую минорную версию (второе число в номере версии) без пропусков, например, версию 2023.4.1 можно обновить до 2023.5.1.

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

Процесс обновления ELMA365 Enterprise состоит из четырёх этапов:

  1. Определение количества шагов обновления.
  2. Скачать helm-чарт актуальной (latest) версии.
  3. Копирование конфигурационного файла от текущей установленной версии.
  4. Обновление с помощью helm в Kubernetes-кластере приложения ELMA365.

Шаг 1: Определение количества шагов обновления

  1. Определите версию установленного чарта, с помощью которого было ранее развёрнуто или обновлено приложение ELMA365:

helm show chart elma365/elma365

  1. На компьютере с доступом в интернет определите версию актуального (latest) чарта:

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

  1. Если минорная версия установленного чарта отличается более чем на одну от минорной версии актуального (latest) чарта, то обновление необходимо проводить в несколько этапов на каждую минорную версию.

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

Примеры:

  1. Версия установленного чарта 2023.5.1, версия актуального (latest) чарта 2023.6.9 — обновление производится в один этап (сразу на 2023.6.9);
  1. Версия установленного чарта 2023.3.23, версия актуального (latest) чарта 2023.6.9 — обновление производится в три этапа (2023.3.23->2023.4.х->2023.5.х->2023.6.9).

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

Шаг 2: Скачивание helm-чарта актуальной (latest) версии

  1. На компьютере с доступом в интернет скачайте свежие образы ELMA365 и загрузите их в локальный реестр образов. Подробнее читайте в статье «Загрузка образов ELMA365».
  1. Обновите список чартов в репозитории:

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

  1. Если нужно скачайте архивы чартов промежуточных минорных версий для всех шагов обновления:

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

  1. Cкачайте архив актуальной версии (latest) чарта ELMA365 On-Premises

helm pull elma365/elma365

  1. Полученный архив (архивы, если есть промежуточные шагов обновления) чарта elma365-X.Y.Z.tgz скопируйте на сервер, где будет производиться обновление.
  1. На сервере где будет производиться обновление распакуем чарт или чарты elma365-X.Y.Z.tgz каждый в отдельный каталог.

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

Шаг 3: Копирование конфигурационного файла от текущей установленной версии

Cкопируйте конфигурационный файл values-elma365.yaml из каталога с чартом старой (текущей) установки ELMA365 On-Premises в каждый каталог с чартом подготовленным на шаге скачивание helm-чарта актуальной (latest) версии.

Если файл values-elma365.yaml был утрачен, получите параметры текущей установки ELMA365 и сохраните их в этот файл, выполнив команду:

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

Обратите внимание, с версии 2023.4.30 обновилась структура конфигурационного файла values-elma365.yaml.

Если вы обновляете с 2023.4.0-21 или с более ранних версий на 2023.4.30 или более новые версии, нужно:

  1. На компьютере с доступом в интернет получить обновлённый конфигурационный файл values-elma365.yaml, выполнив команду.

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

  1. Скопировать на сервер новый файл values-elma365.yaml, где будет производиться обновление.
  1. Перенести вручную параметры приложения из конфигурационного файла values-elma365.yaml старого образца (версии до 2023.4.30) в новый конфигурационный файл.

Шаг 4: Обновление с помощью helm в Kubernetes-кластере приложения ELMA365

Обновите приложения ELMA365 с использованием конфигурационного файла values-elma365.yaml. Если имеются промежуточные минорные версий (шагов обновления два или больше), последовательно произведите обновление на каждую промежуточную минорную версию.

Перейдите в каталог с нужной версией ELMA365 и выполните команду:

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

Обновление приложения занимает 10-30 минут. Дождитесь обновления параметров приложения ELMA365 Enterprise.

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