Особенности обновления с версии 1.21.0 на версию 1.22.0

При обновлении с версии 1.21.0 на версию 1.22.0 выполните дополнительные действия и настройки, описанные в разделах ниже.

Обнуление контрольных сумм для скриптов миграции

При обновлении версии продукта с 1.21.0 на 1.22.0 происходит обновление версии библиотеки, используемой для миграций базы данных. Это может привести к изменению контрольных сумм (MD5) уже примененных миграций. В результате система может выдать ошибку при попытке запуска миграций, указывая на несоответствие контрольных сумм.

Для устранения этой ошибки необходимо обнулить контрольные суммы для определенных скриптов миграции.

Порядок действий:

Подключитесь к базе данных продукта.

Выполните следующий SQL-запрос:

UPDATE databasechangelog
SET md5sum = NULL
WHERE filename IN (
    'db/1.5.0/2024-02-22--04-app_config.change_default_schedules_config.yml',
    'db/1.5.0/2024-03-15--10-insert.user_session_history_schedule.yml',
    'db/1.6.0/2024-05-06--16-insert.install_agent_task_settings.yml',
    'db/1.7.0/2024-06-18--08-insert.ldap_attr_settings.yml',
    'db/1.8.0/2024-07-01--01-insert.software_inventory_sync_schedule.yml',
    'db/1.9.0/2024-07-11--01-insert.inventory.collection_configuration.yml',
    'db/1.9.0/2024-07-10--03-insert.app_config.ldap_sync_delta_schedule.yml',
    'db/1.9.0/2024-07-10--04-insert.app_config.ldap_sync_schedule.yml',
    'db/1.14.0/2025-01-08--05-insert.app_config.access_zones_defaults.yml',
    'db/1.15.0/2025-05-15--01-insert.app_config.access_zones_refresh_schedule.yml',
    'db/1.16.0/2025-06-05--01-insert.app_config.new_format_uninstalled_config_metrics_param.yml',
    'db/1.16.0/2025-06-04--01-insert.app_config.osmax.metrics.calculation.cron.yml',
    'db/1.16.0/2025-06-18--01-insert.app_config.osmax.inventory.software.sync_cache_data.yml',
    'db/1.16.0/2025-07-24--01-insert.app_config.result_expiration_interval.yml',
    'db/1.17.0/2025-09-18--01-insert.app_config.linked-devices-flag.yml',
    'db/1.18.0/2025-12-04--01-insert.app_config.result_expiration_interval_for_files.yml',
    'db/1.19.0/2025-12-10--01-insert.app_config.polling_interval.yml',
    'db/1.19.0/2026-01-26--01-insert.app_config.idle_time.yml',
    'db/1.19.0/2026-03-13--03-insert.app_config.run_on_start.yml',
    'db/1.19.0/2026-04-02--01-insert.app_config.request_timeout.yml',
    'db/1.20.0/2026-04-27--01-insert.app_config.user_sessions_extraction_depth.yml',
    'db/1.20.0/2026-05-13--01-insert.app_config.user_sessions_extraction_run_on_start.yml',
    'db/1.20.0/2026-05-18--01-insert.app_config.run_on_start.inventory.files.yml',
    'db/1.20.0/2026-05-18--02-insert.app_config.run_on_start.inventory.software_packages.yml',
    'db/1.20.0/2026-05-18--03-insert.app_config.file_inventory_schedules.yml',
    'db/1.20.0/2026-06-10--01-insert.app_config.ldap_machine_import_parameter.yml',
    'db/1.21.0/2026-08-25--01-insert.app_config.salt-denied-keys-cleanup.yml',
    'db/1.21.1/2026-09-16--01-insert.app_config.app_store.software_request_url.yml'
);

Перезапустите сервис приложения, чтобы изменения вступили в силу.

Настройка схемы базы данных (currentSchema)

В связи с обновлением версии фреймворка Quarkus в продукте необходимо явно указать схему базы данных для источников данных. Это обеспечивает корректное обращение к объектам базы данных в схеме osmax_schema без необходимости явного указания схемы в каждом SQL-запросе или аннотации JPA.

Параметры currentSchema передаются драйверу JDBC PostgreSQL и устанавливают схему по умолчанию для сессии подключения.

Порядок действий:

Откройте файл конфигурации application.properties компонента osmax-core .

Убедитесь, что присутствуют следующие параметры (или добавьте их, если отсутствуют):

quarkus.datasource."lcm-db".jdbc.additional-jdbc-properties.currentSchema=osmax_schema
quarkus.datasource."lcm-db-readonly".jdbc.additional-jdbc-properties.currentSchema=osmax_schema

Сохраните файл и перезапустите сервис приложения.

Если схема osmax_schema не существует в вашей базе данных, убедитесь, что она была создана ранее. Обычно схема создается автоматически при первой инициализации базы данных или вручную администратором БД.

Настройка параметра state_auto_order

В версии 1.22.0 реализована функциональность управления приоритетом выполнения формул SaltStack. Приоритет определяет порядок записи формул в файл top.sls. Однако порядок выполнения отдельных состояний (state) внутри каждой формулы определяется компилятором Salt.

Для обеспечения корректного применения зависимостей между состояниями внутри формул необходимо, чтобы параметр state_auto_order на сервере управления Salt был установлен в значение True.

Если параметр state_auto_order установлен в False, Salt не будет автоматически переупорядочивать состояния по зависимостям, а будет выполнять их в лексикографическом порядке (по алфавиту).

Обновлено: 19.10.2026