История страницы

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

Если обновление до версии 2.10 осуществляется с версии 2.6 (или более ранней), то перед выполнением шагов из данного раздела выполните обновление до версии 2.7 (так как необходимо обновить базу данных PostgreSQL с версии 14.2 до версии 16.11). Подробная инструкция по обновлению БД приведена в разделе "Обновление 2.6 -> 2.7".

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

[ -d eccm/2.10 ] && sudo cp eccm/2.10 "eccm/eccm-backup-2.10-$(date +%Y%m%d)" #создание бэкапа текущей директории ECCM, если она существует

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

В случае установки в отказоустойчивой системе скачайте и распакуйте архив на каждый узел системы.

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

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

Когда ЕССМ запущен в отказоустойчивой системе с БД на отдельном сервере, для остановки старой версии ЕССМ сначала остановите кластер приложений. Перейдите на сервера Master-app и Slave-app и выполните команды, приведенные ниже.

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

 Остановка Master-db и Slave-db должна быть произведена в определенном порядке в соответствии с ролью узла БД. Для того чтобы узнать текущую роль узла, перейдите на сервер Witness и выполните следующие команды:

cd <путь до каталога с файлами запуска ECCM 2.10>/witness/scripts
bash check-postgres-cluster.sh

Вывод скрипта отобразит роль сервера в БД, а также его статус: 

Состояние PostgreSQL-кластера по данным witness:
Primary:
  - master (100.110.3.203), статус: * running
Standby:
  - slave (100.110.3.204), статус: running, upstream: master
Witness:
  - witness (100.110.3.67), статус: * running, upstream: master

 Для корректного обновления обязательным условием является роль Standby для сервера Slave.

Состояние PostgreSQL-кластера по данным witness:
Primary:
  - slave (100.110.3.204), статус: * running
Standby:
  - master (100.110.3.203), статус: running, upstream: slave
Witness:
  - witness (100.110.3.67), статус: * running, upstream: slave

docker stop eccm-postgres

cd <путь до каталога с файлами запуска ECCM 2.10>/witness/scripts
bash check-postgres-cluster.sh

Состояние PostgreSQL-кластера по данным witness:
Primary:
  - master (100.110.3.203), статус: * running
  - slave (100.110.3.204), статус: - failed, upstream: ?
Standby:
  - не найден
Witness:
  - witness (100.110.3.67), статус: * running, upstream: master
Обнаружен split brain, witness указывает на мастерство: 100.110.3.203

docker start eccm-postgres

Состояние PostgreSQL-кластера по данным witness:
Primary:
  - master (100.110.3.203), статус: * running
Standby:
  - slave (100.110.3.204), статус: running, upstream: master
Witness:
  - witness (100.110.3.67), статус: * running, upstream: master

Далее произведите остановку БД с ролью Standby при помощи следующей команды:

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

После полной остановки старой версии ЕССМ на сервере Standby при помощи аналогичной команды одновременно остановите оставшиеся узлы системы.

 Также произведите остановку утилиты Keepalived на узлах Master и Slave при помощи следующей команды:

sudo systemctl stop keepalived

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

cd <путь до каталога с файлами запуска ЕССМ 2.9>
sudo cp cluster-cert/* <путь до каталога с файлами запуска ЕССМ 2.10>/cluster-cert/

В версии ЕССМ 2.10 конфигурационный файл .env.cluster был изменен. Повторно заполните данный файл, а также произведите изменение значения параметра RECONFIGURE_CLUSTER на true. Для синхронизации конфигурационных файлов между узлами воспользуйтесь инструкцией в разделе "Запуск ЕССМ в отказоустойчивой системе".

Изменение параметра RECONFIGURE_CLUSTER инициализирует принудительное назначение ролей. При отсутствии изменения данного параметра узел Slave не будет обновлен и система может не запуститься.

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

Перед запуском самих контейнеров скрипт проверяет наличие файла .env.personal и в случае его отсутствия предлагает создать его в дополнительном диалоге. При стандартных паролях система также предложит изменить их: вручную или с помощью автоматической генерации. После изменения паролей проект продолжит запуск. Пароли сервисов при обновлении автоматически заменяются со старых на новые из файла .env.personal.

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