Обновление версии ПО ECCM состоит из следующих этапов:
- 0. Создание резервной копии данных;
- 1. Скачивание и распаковка архива с новой версией файлов запуска ЕССМ.
- 2. Остановка старой версии ECCM.
- 3. Запуск новой версии ЕССМ.
Для возможности отката к предыдущей версии перед началом обновления рекомендуем создать резервную копию данных. В случае если ECCM установлен на сервере с использованием виртуализации, следует сделать Snapshot системы. В ином случае — создать резервную копию баз данных eccm и identity_provider_db средствами PotsgreSQL.
Начиная с версии 1.7 сервисы ЕССМ используют версию PostgreSQL 14.2.
Если обновление до версии 1.9 осуществляется с версии 1.6 (или более ранней), то перед выполнением шагов из данного раздела:
- Выполните обновление до версии 1.7 (так как необходимо обновить базу данных PostgreSQL с версии 12.5 до версии 14.2). Подробная инструкция по обновлению БД приведена в разделе Обновление 1.6 → 1.7.
- Выполните обновление до версии 1.8. Подробная инструкция приведена в разделе Обновление 1.7 → 1.8.
Получение и распаковка архива
Перед установкой новой версии ЕССМ необходимо предварительно скачать архив с файлами системы. Файлы, необходимые для запуска проекта, распространяются в виде архива .tar.gz. Их можно получить с общедоступного FTP-сервера. Загрузите архив на сервер и распакуйте его. Рекомендуется распаковывать архив в заранее созданную отдельную директорию:
wget "https://cloud.eltex-co.ru/index.php/s/P8xDfmyo3XyEs0g/download?path=%2F&files=eccm-1.9.tar.gz" -O eccm-1.9.tar.gz mkdir eccm sudo tar -zxvf eccm-1.9.tar.gz -C eccm/
Для удобства работы рекомендуем предварительно разместить файлы для запуска новой версии в соседнюю директорию от старой, например:
$ tree -L 2 --dirsfirst
.
├── 1.8
│ ├── db-tools
│ ├── eccm
│ ├── identity-provider
│ ├── postgres
│ ├── README.md
│ ├── compose-tools.sh
│ ├── generate-cert.sh
│ └── technical_support.sh
└── 1.9
├── eccm
├── identity-provider
├── postgres
├── README.md
├── compose-tools.sh
├── generate-cert.sh
└── technical_support.sh
В случае многохостовой установки скачайте и распакуйте архив и на сервер с ЕССМ, и на сервер с базой данных.
Остановка старой версии ECCM
Остановка сервисов ЕССМ при однохостовой установке
Когда ECCM запущен на одном хосте (ЕССМ и база данных находятся на одном сервере), для остановки старой версии ЕССМ выполните команду из директории с файлами запуска старой версии ECCM:
Остановка identity-provider
cd <путь до каталога с файлами запуска ECCM 1.8>/identity-provider sudo docker-compose down
Остановка eccm
cd <путь до каталога с файлами запуска ECCM 1.8>/eccm sudo docker-compose down
Остановка postgres
cd <путь до каталога с файлами запуска ECCM 1.8>/postgres sudo docker-compose down
Остановка сервисов ЕССМ при многохостовой установке
Когда ECCM запущен на нескольких хостах (ЕССМ на одном сервере, база данных — на другом), для остановки старой версии ЕССМ выполните команды:
- на сервере ЕССМ
Остановка identity-provider
cd <путь до каталога с файлами запуска ECCM 1.8>/identity-provider sudo docker-compose down
Остановка eccm
cd <путь до каталога с файлами запуска ECCM 1.8>/eccm sudo docker-compose down
- на сервере с базой данных
Остановка postgres
cd <путь до каталога с файлами запуска ECCM 1.8>/postgres sudo docker-compose down
Запуск новой версии ЕССМ
Запуск новой версии ЕССМ на одном хосте
Для однохостовой системы после успешной остановки старой версии ЕССМ перейдите в директорию, в которую был распакован архив с новой версией ЕССМ, и выполните команду:
cd <путь до каталога с файлами запуска ECCM 1.9> sudo ./compose-tools --pull --start <IP ADDRESS>
Запуск новой версии ЕССМ на нескольких хостах
Если система была установлена на нескольких хостах, то сначала необходимо запустить БД на сервере с Postgres:
cd <путь до каталога с файлами запуска ECCM 1.9>/postgres sudo docker compose up -d
Потом запустить новую версию ЕССМ на сервере с ЕССМ:
cd <путь до каталога с файлами запуска ECCM 1.9> sudo ./compose-tools --pull --start <IP ADDRESS> --external-database <IP ADDRESS DATABASE>