Обновление версии ПО ECCM состоит из следующих этапов:

  1. 0. Создание резервной копии данных;
  2. 1. Скачивание и распаковка архива с новой версией файлов запуска ЕССМ;
  3. 2. Остановка старой версии ECCM;
  4. 3. Запуск новой версии ЕССМ.


Сервисы ЕССМ совместимы с версией PostgreSQL 14.10.

Если обновление до версии 2.6 осуществляется с версии 1.6 (или более ранней), то перед выполнением шагов из данного раздела:

  1. Выполните обновление до версии 1.7 (так как необходимо обновить базу данных PostgreSQL с версии 12.5 до версии 14.2). Подробная инструкция по обновлению БД приведена в разделе Обновление 1.6 → 1.7.
  2. Выполните обновление до версии 1.8. Подробная инструкция приведена в разделе Обновление 1.7 → 1.8. 
  3. Выполните обновление до версии 1.9. Подробная инструкция приведена в разделе Обновление 1.8 → 1.9.
  4. Выполните обновление до версии 1.10. Подробная инструкция приведена в разделе Обновление 1.9 → 1.10.
  5. Выполните обновление до версии 1.11. Подробная инструкция приведена в разделе Обновление 1.10 → 1.11.
  6. Выполните обновление до версии 1.12. Подробная инструкция приведена в разделе Обновление 1.11 → 1.12.
  7. Выполните обновление до версии 1.13. Подробная инструкция приведена в разделе Обновление 1.12 → 1.13.
  8. Выполните обновление до версии 2.0. Подробная инструкция приведена в разделе Обновление 1.13 → 2.0.
  9. Выполните обновление до версии 2.1. Подробная инструкция приведена в разделе Обновление 2.0 → 2.1.
  10. Выполните обновление до версии 2.2. Подробная инструкция приведена в разделе Обновление 2.1 → 2.2.
  11. Выполните обновление до версии 2.3. Подробная инструкция приведена в разделе Обновление 2.2 → 2.3.
  12. Выполните обновление до версии 2.4. Подробная инструкция приведена в разделе Обновление 2.3 → 2.4.
  13. Выполните обновление до версии 2.5. Подробная инструкция приведена в разделе Обновление 2.4 → 2.5.

Создание резервной копии

Для возможности отката к предыдущей версии перед началом обновления рекомендуем создать резервную копию данных. В случае если ECCM установлен на сервере с использованием виртуализации, следует сделать Snapshot системы. В ином случае — создать резервную копию базы данных eccm средствами PostgreSQL. Подробная инструкция по созданию резервной копии базы данных приведена в разделе "Резервное копирование базы данных ЕССМ".

Получение и распаковка архива

Для offline-установки воспользуйтесь инструкцией по загрузке установочных файлов и установке образов проекта, приведенной в разделе "Offline-установка ЕССМ". 

Перед установкой новой версии ЕССМ необходимо предварительно скачать архив с файлами системы. Файлы, необходимые для запуска проекта, распространяются в виде архива .tar.gz. Их можно получить с общедоступного облака. Загрузите архив на сервер и распакуйте его. Рекомендуется распаковывать архив в заранее созданную отдельную директорию:

wget "https://cloud.eltex-co.ru/index.php/s/P8xDfmyo3XyEs0g/download?path=%2F&files=eccm-2.6.tar.gz" -O eccm-2.6.tar.gz
mkdir eccm
sudo tar -zxvf eccm-2.6.tar.gz -C eccm/

Для удобства работы рекомендуется предварительно разместить файлы для запуска новой версии в соседнюю директорию от старой, например:

$ tree -L 2 --dirsfirst
.
├── 2.5
│   ├── eccm
│   ├── postgres
│   ├── README.md
│   ├── args-compose-tools.log
│   ├── compose-tools.sh
│   ├── generate-cert.sh
│   └── technical_support.sh
└── 2.6
    ├── eccm
    ├── postgres
    ├── README.md
    ├── args-compose-tools.log
    ├── compose-tools.sh
    ├── generate-cert.sh
    └── technical_support.sh



В случае многохостовой установки скачайте и распакуйте архив и на сервер с ЕССМ, и на сервер с базой данных.


Остановка старой версии ECCM

Остановка сервисов ЕССМ при однохостовой установке

Когда ECCM запущен на одном хосте (ЕССМ и база данных находятся на одном сервере), для остановки старой версии ЕССМ и удаления контейнеров выполните команду из директории с файлами запуска старой версии ECCM:

cd <путь до каталога с файлами запуска ECCM 2.5>
sudo ./compose-tools.sh --stop --delete-containers


Остановка сервисов ЕССМ при многохостовой установке

Когда ECCM запущен на нескольких хостах (ЕССМ на одном сервере, база данных — на другом), для остановки старой версии ЕССМ выполните команды, приведенные ниже.

На сервере с ЕССМ:

cd <путь до каталога с файлами запуска ECCM 2.5>
sudo ./compose-tools.sh --stop --delete-containers


На сервере с базой данных:

cd <путь до каталога с файлами запуска ECCM 2.5>/postgres
sudo docker compose down


Запуск новой версии ЕССМ

Для offline-установки воспользуйтесь инструкцией, приведенной в разделе "Инструкция по установке и запуску".

Запуск новой версии ЕССМ при однохостовой установке

Для однохостовой системы после успешной остановки старой версии ЕССМ перейдите в директорию, в которую был распакован архив с новой версией ЕССМ, и выполните команду:

cd <путь до каталога с файлами запуска ECCM 2.6>
sudo ./compose-tools.sh --pull --start <IP ADDRESS>


Запуск новой версии ЕССМ при многохостовой установке

Если система была установлена на нескольких хостах, для запуска новой версии ECCM выполните команды, приведенные ниже.

На сервере с базой данных:

cd <путь до каталога с файлами запуска ECCM 2.6>/postgres
sudo docker compose up -d

На сервере с ЕССМ:

cd <путь до каталога с файлами запуска ECCM 2.6>
sudo ./compose-tools.sh --pull --start <IP ADDRESS> --database-host <IP ADDRESS DATABASE> --database-port <PORT DATABASE>

Запуск новой версии ЕССМ в отказоустойчивой системе

Если запуск новой версии ЕССМ предполагается в отказоустойчивой системе, то остановленная система с актуальной версией ЕССМ должна быть новым мастером в кластере.

Для запуска ЕССМ в отказоустойчивой системе воспользуйтесь инструкцией, приведенной в разделе "Запуск ЕССМ в отказоустойчивой системе".