Данный документ описывает процесс миграции системы с версии 1.4.0 на версию 1.5.0.
Миграция включает обновление схемы баз данных PostgreSQL и ClickHouse, а также перенос данных.
Внимание! Перед началом миграции обязательно создайте резервную копию всех данных, как описано в разделе Подготовительные действия. |
Рекомендуемые ресурсы для успешной миграции (на примере системы с 3000 сотрудников, 2200 пропусков и 300 камер):
Используйте сценарий Миграция на текущем сервере, если обновление выполняется на том же сервере, где уже работает система с версией 1.4.0. |
Используйте сценарий Миграция на новом сервере, если миграция выполняется на новом чистом сервере. |
Создайте временную папку для резервной копии и файлов миграции в домашней директории пользователя:
mkdir ~/backup cd ~/backup |
Этот сценарий необходим для сравнения конфигурационных файлов версий 1.5.0 и 1.4.0. |
sudo cp /opt/evi-*/*.conf . sudo cp /etc/nginx/sites-available/evi-core-web . |
Перед проведением дампа базы данных необходимо остановить сервисы.
sudo systemctl stop nginx evi-core evi-scud evi-live evi-archive evi-analyzer |
echo "SELECT pg_terminate_backend(pid) FROM pg_stat_activity where usename='core'" | sudo -u postgres psql -A -t |
Выполните дамп текущей базы PostgreSQL (версия 1.4.1):
sudo -u postgres pg_dump core > evi-backup.dump |
Для проверки наличия файла evi-backup.dump в домашней директории пользователя в подпапке backup выполните следующие действия:
ls -lh | grep evi-backup.dump |
-rw-rw-r-- 1 user user 7.4G Jul 29 14:49 evi-backup.dump |
Далее переходите к шагу Миграция на текущем сервере или Миграция на новом сервере в зависимости от ваших требований.
Используйте этот сценарий, если обновление выполняется на том же сервере, где уже работает система. |
Находясь в папке ~/backup, выполните команды:
wget https://archive.eltex-co.ru/evi-raw/evi-1.5.0/db_migration-1.4.0-1.5.0.zip unzip db_migration-1.4.0-1.5.0.zip cd db_migration-1.4.0-1.5.0 |
sudo apt purge evi-core-web evi-core evi-scud evi-live evi-archive evi-analyzer nginx |
Выполните необходимые предварительные действия, как описано в разделе Подготовка к установке.
Поскольку у вас уже установлена база данных PostgreSQL, следующим шагом является установка ClickHouse: раздел Установка баз данных, пункт База данных ClickHouse.
sudo bash migrate.sh <host> <user> <password> <psql_db_name_from> <psql_db_name_to> <psql_port> <ch_def_user_password> <ch_db_name> |
sudo bash migrate.sh localhost core core core core 5432 core core |
После успешного выполнения скрипта миграции в консоли вы увидите сообщение: Restoring DB done <3.
Далее переходите к разделу Установка и настройка сервисов EVI после миграции.
Используйте этот сценарий, если миграция выполняется на новом чистом сервере. |
Выполните необходимые предварительные действия, как описано в разделе Подготовка к установке.
Установите и настройте PostgreSQL и ClickHouse, как описано в разделе Установка баз данных.
Создайте резервную копию всех данных, как описано в разделе Подготовительные действия.
Скопируйте папку backup вместе со всем содержимым с исходного сервера на новый.
Для передачи данных рекомендуется использовать утилиту scp, которая обеспечивает безопасное копирование по SSH.
scp -r ~/backup user@remote-server:~ |
После переноса перейдите на новом сервере в папку backup в домашней директории:
cd ~/backup |
sudo -u postgres psql -c "CREATE USER core; ALTER USER core WITH PASSWORD 'core'; ALTER USER core WITH SUPERUSER;" |
При необходимости измените пароль на более безопасный. В примерах используется пароль и имя пользовател\ по умолчанию. |
Загрузить базу данных с версией 1.4.0.
sudo -u postgres createdb core sudo -u postgres psql -d core -f evi-backup.dump |
Убедитесь, что дамп корректно загружен. |
wget https://archive.eltex-co.ru/evi-raw/evi-1.5.0/db_migration-1.4.0-1.5.0.zip unzip db_migration-1.4.0-1.5.0.zip cd db_migration-1.4.0-1.5.0 |
sudo bash migrate.sh <host> <user> <password> <psql_db_name_from> <psql_db_name_to> <psql_port> <ch_def_user_password> <ch_db_name> |
sudo bash migrate.sh localhost core core core core 5432 core core |
После успешного выполнения скрипта миграции в консоли вы увидите сообщение: Restoring DB done <3.
Далее переходите к разделу Установка и настройка сервисов EVI после миграции.
После успешного завершения миграции баз данных необходимо установить сервисы EVI версии 1.5.0.
Установите и настройте сервисы EVI, как описано в разделе Ручная установка.
Для версии 1.5.0 необходимо использовать прошивку для контроллеров СКУД: IPA-ER-020-2.3.0_build_52.tar.gz |
В версии 1.5.0 внесены изменения в структуру и параметры конфигурационных файлов, включая новые порты по умолчанию и обновлённые секции.
В конфигурационном файле evi-live.conf в секции [global] изменился параметр:
[global] extern_host=127.0.0.1 |
Убедитесь, что значение extern_host соответствует внешнему IP-адресу или доменному имени сервера, по которому клиенты подключаются к системе. |
Сравните конфигурационные файлы: старый (1.4.0) и новый (1.5.0) evi-core.conf, evi-scud.conf, evi-live.conf, evi-archive.conf, evi-analyzer.conf.
Перенесите важные настройки (сертификаты, пути видеоархива), соблюдая новую структуру.
После завершения миграции выполните следующие действия:
При возникновении ошибок обратитесь в техническую поддержку с логами. |