Описание
Изменения образа СУБД PostgreSQL для однохостовой установки
Для однохостовой (stand-alone) установки СУБД PostgreSQL была изменена на аналогичную используемой в установке с резервированием (с использованием replication manager), что привело к необходимости миграции БД.
Попытка выполнить обновление путем установки поверх новой версии NAICE приведет к неработоспособности NAICE!
Перенос сертификатов безопасности и сертификатов RADIUS в менеджер конфигураций
В версии 1.2 поддержана возможность управления сертификатами безопасности (WEB-интерфейса и портала) и сертификатами RADIUS (EAP-PEAP и EAP-TLS) из графического интерфейса системы (см. Настройки системы → Хранилище сертификатов → Серверные сертификаты).
Если в версии 1.1 или ранее были установлены пользовательские сертификаты через переменные окружения, то после обновления на версию 1.2 необходимо выполнить их повторную установку через графический интерфейс NAICE: v1.2_3.8 Использование сертификатов безопасности и v1.2_3.14 Обновление/замена сертификатов RADIUS для EAP-PEAP/TLS.
Данные действия необходимо выполнить один раз, при дальнейших обновлениях установленные сертификаты будут сохранены.
Перенос управления двумя УЗ компьютеров в схеме с резервированием для взаимодействия с Active Directory в графический интерфейс
В версии 1.2 поддержана конфигурация двух УЗ компьютеров с привязкой к ноде NAICE в схемах с резервированием. При выполнении обновления данные настройки не будут перенесены в БД! Необходимо после обновления добавить данные УЗ компьютеров вручную в разделе Пользователи и устройства → Управление идентификацией → Внешние источники идентификации: v1.2_4.1.1 Настройка интеграции с Active Directory.
Адреса управления
В версии 1.1 и ранее доступ к веб-интерфейсу управления осуществлялся по определенному во время установки адресу хостовой машины.
В версии 1.2 ограничение было убрано, и доступ к управлению NAICE по умолчанию может осуществлятся по любому IPv4-адресу или доменному имени хоста по порту 443. Также был добавлен механизм, позволяющий ограничить список адресов для управления. Настройка осуществляется в разделе Настройки системы → Безопасность и доступ → Вход в систему → Адреса управления.
Портальная авторизация
В версии 1.2 настройка уровня сложности CAPTCHA была перенесена из переменных окружения .env в конструктор порталов. Для существующих порталов, в которых был включен способ входа "По СМС", при обновлении автоматически выставляется средний уровень сложности CAPTCHA. При необходимости изменения уровня сложности или выключения CAPTCHA внесите соответствующие изменения в конструкторе портала (см. v1.2_4.8 Настройка Captive Portal - "Настройка сложности CAPTCHA" ).
Возможность изменения IP-адресации подсетей Docker плейбуками Ansible
В версии 1.2 добавлена возможность изменения подсетей Docker через переменные плейбуков Ansible. Подробнее в разделе v1.2_3.15 Смена Docker-сетей.
Необходимо перед обновлением обязательно указать актуальные адреса подсетей в плейбуке, совпадающие с ранее настроенными. В противном случае обновление завершится ошибкой!
Подготовка к обновлению
Перед обновлением необходимо создать резервную копию БД в соответствии с инструкцией: v1.2_3.10 Создание резервной копии данных БД и восстановление данных БД и выгрузить её с сервера для возможности восстановления данных в случае ошибок обновления.
Если какие-либо переменные в groups/all.yml были изменены - необходимо перенести значения переменных all.yml из старого плейбука в новый перед установкой.
Если используется клиент мониторинга Peeper Client
Если в составе NAICE ранее был установлен Peeper-Client (подробнее v1.2_7.3 Мониторинг NAICE с использованием Eltex Peeper), то перед выполнением обновления необходимо вручную остановить Peeper-Client. Для этого необходимо зайти в папку установки клиента <папка установки NAICE>/peeper (по умолчанию /etc/docker-naice/peeper) и остановить его командой:
cd /etc/docker-naice/peeper sudo bash ./setup.sh -u
После выполнения обновления необходимо вручную выполнить его запуск:
sudo bash ./setup.sh -i
Обновление однохостовой (stand-alone) установки
Подготовка к обновлению выполняется в соответствии с инструкцией по установке:
Для онлайн обновления: v1.2_3.4 Установка плейбуками Ansible (одиночная "Stand-Alone")
Для оффлайн обновления: v1.2_3.4.1 Установка в закрытом контуре (одиночная "Stand-Alone")
Рекомендуется использовать для запуска плейбуков Ansible тот же хост, что использовался ранее для установки, чтобы не выполнять его повторную подготовку.
Для оффлайн обновления в соответствии с инструкцией используется тот же хост, на котором развернут NAICE.
Подготовка к установке
В файле конфигурации inventory/hosts.yml указать:
common:
hosts:
# Хост для выполнения stand-alone установки NAICE
common_host:
ansible_host: <IP-адрес хоста для NAICE>
ansible_port: 22
ansible_user: <логин пользователя хоста, под которым выполняется запуск плейбука>
ansible_ssh_pass: <пароль пользователя хоста, под которым выполняется запуск плейбука>
ansible_become_password: <пароль для повышения привилегий (sudo) пользователя хоста, под которым выполняется запуск плейбука>
Обновление
Обновление осуществляется запуском соответствующего плейбука Ansible. По завершении работы плейбука не должно быть ошибок!
ansible-playbook migrate-postgres-1.1-to-1.2.yml -i inventory/hosts.yml
При выполнении оффлайн обновления на ОС Astra Linux 1.7.X необходимо выполнять запуск плейбука из под пользователя root, без использования sudo!
Перед запуском плейбука необходимо выполнить:
$sudo su #
Проверка состояния сервисов
Проверить успешность запуска контейнеров можно, перейдя в директорию для установки NAICE (по умолчанию - /etc/docker-naice/ ) и выполнив команду для просмотра списка и статуса контейнеров docker compose ps -a. Вывод команды должен быть примерно следующим:
Обновление установки с резервированием
Для установки с резервированием необходимость миграции БД нет, что позволяет выполнить обновления путем запуска плейбуков установки NAICE версии 1.2.
Подготовка к обновлению выполняется в соответствии с инструкцией по установке:
Для онлайн обновления:
- v1.2_3.5 Установка с резервированием (c использованием VRRP)
- v1.2_3.6 Установка с резервированием (без использования VRRP)
Для оффлайн обновления:
- v1.2_3.5.1 Установка схемы с резервированием в закрытом контуре (с использованием VRRP)
- v1.2_3.6.1 Установка схемы с резервированием в закрытом контуре (без использования VRRP)
Рекомендуется использовать для запуска плейбуков Ansible тот же хост, что использовался ранее для установки, что бы не выполнять его повторную подготовку.
Особенности подготовки хостов с кластером PostgreSQL и нод NAICE перед обновлением с изменением подсетей Docker
Если в ходе обновления планируется изменение подсетей Docker - необходимо перед обновлением остановить на каждой ноде сервисы NAICE и кластер PostgreSQL.
Для этого необходимо перейти в папку установки NAICE (по умолчанию /etc/docker-naice) и выполнить команды:
Остановка сервисов NAICE:
sudo docker compose down
Остановка кластера PostgreSQL:
sudo docker compose -f docker-compose.repmgr.yml down
Затем выполнить установку в соответствии с инструкцией.
Приложения
Ручное обновление СУБД PostgreSQL для однохостовой (stand-alone) установки с версии 1.1 на версию 1.2
Далее везде указана папка установки NAICE по умолчанию: /etc/docker-naice. Если NAICE развернут по другому пути - следует использовать его.
В случае невозможности или возникновения ошибок в ходе автоматического обновления СУБД можно выполнить обновление СУБД вручную. Для этого требуется выполнить следующие действия.
- Создать резервную копию БД для версии 1.1 командой:
sudo docker exec -it naice-postgres /scripts/backup/backup.sh
- Скопировать полученный архив в другую папку, например в домашнюю папку пользователя:
cp -v /etc/docker-naice/backups/naice_2026-06-25_03-15-31_231.tar.gz ~
- Перейти в папку установки NAICE и остановить все контейнеры:
cd /etc/docker-naice/ sudo docker compose down
- Удалить папку с данными СУБД PostgreSQL:
sudo rm -rfv var/pgdata
- Выполнить установку версии 1.2 с учетом всех необходимых действий указанных в разделе Подготовка к обновлению:
ansible-playbook install-naice.yml
- Скопировать ранее выгруженный архив БД в новую папку резервных копий:
sudo cp -v ~/naice_2026-06-25_03-15-31_231.tar.gz /etc/docker-naice/postgres/backups
- Запустить восстановление бэкапа из скопированного файла:
sudo docker exec -it naice-postgres /home/worker/scripts/backup/restore.sh -f /var/backups/naice_2026-06-25_03-15-31_231.tar.gz
- Выполнить перезапуск контейнеров:
sudo docker compose down && sudo docker compose up -d
- Проверить состояние сервисов NAICE:
$ sudo docker compose ps -a NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS epg-service naice-build-hosted.registry.eltex.loc/naice/epg-service:1.3-2 "/bin/sh -e /usr/loc…" epg-service 6 minutes ago Up 5 minutes (healthy) naice-aquila naice-release.registry.eltex.loc/naice-aquila:1.2 "java -cp @/app/jib-…" naice-aquila About a minute ago Up About a minute (healthy) 0.0.0.0:8091->8091/tcp, [::]:8091->8091/tcp, 0.0.0.0:49->1049/tcp, [::]:49->1049/tcp naice-bubo naice-release.registry.eltex.loc/naice-bubo:1.2 "java -cp @/app/jib-…" naice-bubo 5 minutes ago Up 3 minutes (healthy) 0.0.0.0:8093->8093/tcp, [::]:8093->8093/tcp naice-castor naice-release.registry.eltex.loc/naice-castor:1.2 "java -Djava.awt.hea…" naice-castor 5 minutes ago Up 3 minutes (healthy) 0.0.0.0:8095->8095/tcp, [::]:8095->8095/tcp naice-cetus naice-release.registry.eltex.loc/naice-cetus:1.2 "java -cp @/app/jib-…" naice-cetus 5 minutes ago Up 3 minutes (healthy) 0.0.0.0:8099->8099/tcp, [::]:8099->8099/tcp naice-gavia naice-release.registry.eltex.loc/naice-gavia:1.2 "java -cp @/app/jib-…" naice-gavia 5 minutes ago Up About a minute (healthy) 0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp naice-gulo naice-release.registry.eltex.loc/naice-gulo:1.2 "java -cp @/app/jib-…" naice-gulo 5 minutes ago Up 3 minutes (healthy) 0.0.0.0:8089->8089/tcp, [::]:8089->8089/tcp naice-lemmus naice-release.registry.eltex.loc/naice-lemmus:1.2 "java -cp @/app/jib-…" naice-lemmus 5 minutes ago Up 3 minutes (healthy) 0.0.0.0:8083->8083/tcp, [::]:8083->8083/tcp naice-lepus naice-release.registry.eltex.loc/naice-lepus:1.2 "java -cp @/app/jib-…" naice-lepus 5 minutes ago Up 3 minutes (healthy) 0.0.0.0:8087->8087/tcp, [::]:8087->8087/tcp, 0.0.0.0:67->1024/udp, [::]:67->1024/udp naice-mustela naice-release.registry.eltex.loc/naice-mustela:1.2 "java -cp @/app/jib-…" naice-mustela 5 minutes ago Up 3 minutes (healthy) 0.0.0.0:8070->8070/tcp, [::]:8070->8070/tcp naice-nats naice-build-hosted.registry.eltex.loc/naice/nats:1.2.2 "docker-entrypoint.s…" nats 6 minutes ago Up 5 minutes (healthy) 4222/tcp, 6222/tcp, 7777/tcp, 8222/tcp naice-ovis naice-release.registry.eltex.loc/naice-ovis:1.2 "java -cp @/app/jib-…" naice-ovis 5 minutes ago Up 3 minutes (healthy) 0.0.0.0:8084->8084/tcp, [::]:8084->8084/tcp naice-phoca naice-release.registry.eltex.loc/naice-phoca:1.2 "java -cp @/app/jib-…" naice-phoca 6 minutes ago Up 5 minutes (healthy) 0.0.0.0:8097->8097/tcp, [::]:8097->8097/tcp naice-postgres naice-build-hosted.registry.eltex.loc/naice/postgres-repmgr:1.2.2 "/opt/bitnami/script…" postgres 7 minutes ago Up 5 minutes (healthy) 127.0.0.1:5432->5432/tcp, 127.0.0.1:15432->22/tcp naice-radius naice-release.registry.eltex.loc/naice-radius:1.2 "/docker-entrypoint.…" naice-radius 4 minutes ago Up 4 minutes (healthy) 0.0.0.0:1812-1813->1812-1813/udp, [::]:1812-1813->1812-1813/udp, 0.0.0.0:9812->9812/tcp, [::]:9812->9812/tcp naice-sterna naice-release.registry.eltex.loc/naice-sterna:1.2 "/docker-entrypoint.…" naice-sterna About a minute ago Up About a minute (healthy) 0.0.0.0:32888->80/tcp, [::]:32888->80/tcp, 0.0.0.0:8443->444/tcp, [::]:8443->444/tcp naice-ursus naice-release.registry.eltex.loc/naice-ursus:1.2 "java -cp @/app/jib-…" naice-ursus 5 minutes ago Up 4 minutes (healthy) 0.0.0.0:8081->8081/tcp, [::]:8081->8081/tcp naice-vulpus naice-release.registry.eltex.loc/naice-vulpus:1.2 "java -cp @/app/jib-…" naice-vulpus 5 minutes ago Up 3 minutes (healthy) 0.0.0.0:8086->8086/tcp, [::]:8086->8086/tcp naice-web naice-release.registry.eltex.loc/naice-web:1.2 "/docker-entrypoint.…" naice-web About a minute ago Up 59 seconds (healthy) 0.0.0.0:443->443/tcp, [::]:443->443/tcp, 0.0.0.0:32889->80/tcp, [::]:32889->80/tcp, 0.0.0.0:80->4200/tcp, [::]:80->4200/tcp
Для ОС Astra Linux 1.7.X может наблюдаться проблема с запуском некоторых контейнеров. В этом случае необходимо выполнить рестарт сервиса docker:
sudo systemctl restart docker
И повторно выполнить запуск контейнеров:
sudo docker compose up -d