В этом документе описываются шаги, необходимые для обновления программного обеспечения X-Road Security Server с версии 7.2.2 до версии 7.3.2 на Ubuntu 22.04 LTS. Пожалуйста, внимательно прочитайте весь документ перед началом процесса обновления. Предполагается, что читатель знаком с дистрибутивом Ubuntu Linux и имеет опыт администрирования серверов безопасности X-Road.

• Java 8 больше не поддерживается. Единственная поддерживаемая версия — Java 11. При обновлении Java 11 будет установлена автоматически как зависимость.
• Исправлена проблема с автоматическими бэкапами, которые создавались 60 раз за один период (баг версии 7.3.0, исправлен в 7.3.2).
• Механизм автоматического бэкапа перенесён из cron в конфигурацию X-Road (файл /etc/xroad/conf.d/local.ini).
• Ужесточены допустимые символы в идентификаторах X-Road. При обновлении legacy-режим включается автоматически — существующие идентификаторы продолжат работать.
• Некоторые свойства конфигурации Security Server переименованы (deprecated-свойства продолжают работать).
• Обновлены сторонние зависимости (Spring Boot, Hibernate, Jackson, Jetty и др.).

• Убедитесь, что текущая версия X-Road — 7.2.2:

dpkg -l | grep xroad

• Убедитесь, что все пакеты системы обновлены:

sudo apt update && sudo apt full-upgrade

• Рекомендуется: убедитесь, что у вас есть актуальная резервная копия (или моментальный снимок виртуальной машины) сервера.

• Сделайте резервную копию конфигурации Security Server через пользовательский интерфейс:
  • Откройте веб-интерфейс https://SECURITYSERVER:4000/
  • Перейдите в Settings → Back Up and Restore
  • Нажмите Back Up Configuration и скачайте файл бэкапа в безопасное место.

• Дополнительно сделайте резервную копию базы данных:

sudo -iu postgres pg_dump -d serverconf -F c -f /var/lib/xroad/backup/serverconf_backup_$(date +%Y%m%d).sql

• Сделайте резервную копию конфигурационных файлов X-Road:

sudo cp -r /etc/xroad /etc/xroad.backup.$(date +%Y%m%d)

sudo systemctl stop "xroad-*"

Убедитесь, что все службы остановлены:

sudo systemctl list-units "xroad*"

Удалить старый репозиторий:

sudo rm /etc/apt/sources.list.d/xroad.list

Добавить репозиторий версии 7.3.2:

echo "deb [signed-by=/etc/apt/keyrings/xroad.asc] https://deb.tunduk.kg/ubuntu22.04-7.3.2 /" | sudo tee /etc/apt/sources.list.d/xroad.list

wget -qO - https://deb.tunduk.kg/key.pub | sudo tee /etc/apt/keyrings/xroad.asc

sudo apt-get update && sudo apt-get -y full-upgrade

sudo systemctl start "xroad-*"

Или запустить через основной сервис:

sudo systemctl start xroad-proxy

dpkg -l | grep xroad

Все пакеты должны показывать версию 7.3.2.

sudo systemctl list-units "xroad*"

Ожидаемый результат:

  UNIT                           LOAD   ACTIVE SUB     DESCRIPTION               
  xroad-addon-messagelog.service loaded active running X-Road Messagelog Archiver
  xroad-base.service             loaded active exited  X-Road initialization     
  xroad-confclient.service       loaded active running X-Road confclient         
  xroad-monitor.service          loaded active running X-Road Monitor            
  xroad-opmonitor.service        loaded active running X-Road opmonitor daemon   
  xroad-proxy-ui-api.service     loaded active running X-Road Proxy UI REST API  
  xroad-proxy.service            loaded active running X-Road Proxy              
  xroad-signer.service           loaded active running X-Road signer

Откройте https://SECURITYSERVER:4000/ в веб-браузере. Для входа используйте учётную запись, заданную при установке.

Перейдите в раздел Keys and Certificates и убедитесь, что OCSP статус сертификатов — «Good».

sudo journalctl -u xroad-proxy -n 100 --no-pager
sudo journalctl -u xroad-signer -n 50 --no-pager

Убедитесь, что в логах нет критических ошибок.

Начиная с версии 7.3.0, расписание автоматических бэкапов задаётся не через cron, а через параметр в файле /etc/xroad/conf.d/local.ini.

Если вы ранее изменяли расписание бэкапов в файле /etc/cron.d/xroad-proxy, перенесите настройку вручную:

sudo nano /etc/xroad/conf.d/local.ini

Добавьте или отредактируйте секцию:

[configuration-client]
proxy-configuration-backup-cron=0 15 3 * * ?

После изменения перезапустите конфигурационный клиент:

sudo systemctl restart xroad-confclient

Следующие свойства Security Server считаются устаревшими (deprecated), но продолжают работать:

Рекомендуется при возможности перейти на новые имена свойств.

Убедитесь, что используется Java 11:

java -version

Ожидаемый результат должен содержать openjdk version «11.x.x».

В случае проблем после обновления:

Если перед обновлением был сделан snapshot виртуальной машины — восстановите его.

Удалить репозиторий 7.3.2:

sudo rm /etc/apt/sources.list.d/xroad.list

Добавить репозиторий 7.2.2:

echo "deb [signed-by=/etc/apt/keyrings/xroad.asc] https://deb.tunduk.kg/ubuntu22.04-7.2.2 /" | sudo tee /etc/apt/sources.list.d/xroad.list

Выполнить переустановку:

sudo apt-get update
sudo apt-get install --reinstall xroad-securityserver xroad-proxy xroad-signer xroad-confclient xroad-proxy-ui-api xroad-monitor xroad-opmonitor xroad-addon-messagelog xroad-addon-opmonitoring xroad-base

Если конфигурация повреждена, восстановите её из резервной копии:

sudo -u xroad /usr/share/xroad/scripts/restore_xroad_proxy_configuration.sh \
  -s <security server ID> \
  -f /var/lib/xroad/backup/<backup_file>.tar

Проверьте логи конкретного сервиса:

sudo journalctl -u xroad-proxy -n 200 --no-pager
sudo journalctl -u xroad-signer -n 200 --no-pager
sudo journalctl -u xroad-proxy-ui-api -n 200 --no-pager

Убедитесь, что сервис xroad-proxy-ui-api запущен:

sudo systemctl status xroad-proxy-ui-api

Если сервис не запускается, проверьте лог:

sudo tail -100 /var/log/xroad/proxy_ui_api.log

Проверьте доступность базы данных:

sudo -u postgres psql -c "SELECT pg_database.datname, 
       pg_size_pretty(pg_database_size(pg_database.datname)) AS size 
FROM pg_database 
WHERE datname IN ('serverconf', 'messagelog', 'op-monitor');"

При необходимости восстановите базу данных из резервной копии:

sudo -iu postgres pg_restore -d serverconf -c /var/lib/xroad/backup/serverconf_backup_YYYYMMDD.sql

Если после обновления токен не активен:

• Перейдите в Keys and Certificates
• Нажмите Log In на нужном токене и введите PIN-код

—-

Автор Даниил Горбенко