Просмотреть исходный

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

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

Для возможности отката к предыдущей версии перед началом обновления рекомендуем создать резервную копию данных. В случае если ECCM установлен на сервере с использованием виртуализации, следует сделать Snapshot системы. В ином случае — создать резервную копию баз данных eccm и identity_provider_db средствами PotsgreSQL.

Начиная с версии 1.7 сервисы ЕССМ используют версию PostgreSQL 14.2.

Если обновление до версии 1.8 осуществляется с версии 1.6 (или более ранней), сначала выполните обновление до версии 1.7 (так как необходимо обновить базу данных PostgreSQL с версии 12.5 до версии 14.2). Подробная инструкция по обновлению БД приведена в разделе Обновление 1.6->1.7.

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

Если необходим доступ к старым данным мониторинга (из версии 1.7), то первичный запуск ЕССМ следует осуществлять с ключом "--ms_legacy":

$ ./compose-tools.sh --start <ECCM_IP> --ms_legacy

Какие-либо данные, добавленные/измененные в ЕССМ 1.8 с новым мониторингом (т.е. ЕССМ 1.8 запускалась без ключа "--ms_legacy") будут недоступны при последующем запуске ЕССМ 1.8 с устаревшим мониторингом (т.е. с ключом "--ms_legacy").

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

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

wget ftp://wifiguest:GuestWiFi@ftp.eltex.org/eccm/eccm-1.8.tar.gz
mkdir eccm
sudo tar -zxvf eccm-1.8.tar.gz -C eccm/

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

$ tree -L 2 --dirsfirst
.
├── 1.7
│   ├── eccm
│   ├── identity-provider
│   ├── postgres
│   ├── README.md
│   ├── compose-tools.sh
│   └── technical_support.sh
├── 1.8
│   ├── db-tools
│   ├── eccm
│   ├── identity-provider
│   ├── postgres
│   ├── README.md
│   ├── compose-tools.sh
│   ├── generate-cert.sh
│   └── technical_support.sh

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

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

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

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

Остановка identity-provider

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

Остановка eccm

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

Остановка postgres

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

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

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

на сервере ЕССМ

Остановка identity-provider

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

Остановка eccm

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

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

Остановка postgres

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

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

ECCM 1.8 адаптирована для запуска c помощью Docker Compose plugin v2. Необходимые версии пакетов:

Docker >= 20.10.18

Docker Compose >= 2.10.2

Проверьте установленную версию Docker и Docker Compose, используя команды:

docker version ; docker compose version

Если установленные пакеты имеют версии:

Docker <= 20.10.18
Docker Compose <= 1.29

То их необходимо обновить и установить Docker Compose plugin v2. Для этого обновите/установите пакеты с помощью скрипта compose-tools из директории с файлами запуска новой версии ЕССМ:

cd  <путь до каталога с файлами запуска ECCM 1.8>
sudo ./compose-tools --install

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

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

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

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

Если система была установлена на нескольких хостах, то сначала необходимо запустить БД на сервере с Postgres:

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

Потом запустить новую версию ЕССМ на сервере с ЕССМ:

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