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