Выгрузка и перенос настроек системы (метаинформации)

Описание действия

Файл с настройками системы (метаинформацией) можно выгрузить с одного стенда, на котором развернуто приложение, и загрузить на другой стенд.

Условия корректного переноса настроек системы: одинаковая версия приложения и одна и та же СУБД.

Перенос настроек системы рекомендуется выполнять во время минимальной нагрузки на систему или во время технологических блокировок.
Не рекомендуется выполнять какие-либо действия по настройке системы до завершения процесса загрузки метаинформации.

Особенности выгрузки метаинформации

  • В метаинформацию не выгружаются значения системного справочника "Классы обслуживания" и значения, настроенные в таблицах соответствий.
  • При выгрузке частичной метаинформации существует временное ограничение 15 минут, по истечении которого выводится сообщение об ошибке org.hibernate.LazyInitializationException: could not initialize proxy - no Session.

Особенности загрузки метаинформации

  • Перед загрузкой метаинформации на стенд рекомендуется выгрузить с него текущий файл метаинформации. Это позволит восстановить предыдущие настройки системы при возникновении ошибок.
  • При загрузке полной метаинформации некоторые компоненты системы (встроенные приложения, файлы отчетов и пр.) загружаются отдельными транзакциями. Если в какой-либо транзакции при полной загрузке метаинформации возникает ошибка, то выполняется отмена только этой транзакции.

  • При полной загрузке метаинформации необходимо отслеживать, что коды атрибутов на стенде и в файле метаинформации совпадали с учетом регистра. Различие в регистрах может привести к некорректной работе системы.

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

  • Если при загрузке часть настроек была утеряна, обратитесь в службу поддержки NAUMEN за консультацией по их восстановлению.

Место действия в интерфейсе

Меню навигации "Настройка системы" → настройка "Администрирование" → вкладка "Управление системой".

Выполнение действия

  1. На стенде A выгрузите файл с настройками системы (метаинформацией):

    1. На вкладке "Управление системой" → блок "Выгрузка/загрузка" → строка "Метаинформация" нажмите кнопку Выгрузить.

    2. Выберите вариант выгрузки:

      • "Все настройки" — выгружаются все настройки текущей конфигурации.

      • "Выбранные настройки" — выгружаются только настройки, выбранные пользователем.

        • Настройки — выберите настройки, которые необходимо выгрузить.
      • "Настройки без доступных в облегченном интерфейсе" — выгружаются все настройки, кроме настроек, доступных в облегченном интерфейсе настроек, см. Модуль "Облегченный интерфейс настройки".

    3. Нажмите кнопку Выгрузить. После этого выполнится процесс сохранения файла.

  2. На стенде B загрузите файл с настройками системы (метаинформацией):

    1. На вкладке "Управление системой" → блок "Выгрузка/ загрузка" → строка "Метаинформация" нажмите кнопку Загрузить,

    2. Заполните поля формы загрузки метаинформации:

      • Файл метаинформации — файл с настройками системы.

      • Полное замещение настроек:

        • флажок снят (по умолчанию) — замещение текущих настроек при загрузке метаинформации не производится;
        • флажок установлен — при загрузке метаинформации данные из загружаемого файла полностью замещают настройки текущей конфигурации. Текущие настройки конфигурации удаляются без возможности восстановления.

        • Отображение параметра зависит от настройки суперпользователя, см. Добавление суперпользователя и администратора.

    3. Нажмите кнопку Начать загрузку. После этого выполнится процесс загрузки файла.

Результат выполнения действия

Настройки системы будут перенесены со стенда A на стенд B.

При загрузке метаинформации для настроек, которые синхронизируются по UUID объекта (значения по умолчанию, элементы таблиц соответствий, условия фильтрации и пр.), значения устанавливаются, если найден объект того же типа с таким же UUID. Если объект с таким же UUID отсутствует, то настройки не переносятся.

У одних и тех же объектов на разных стендах UUID могут совпадать, только если один из них копия другого (создан на дампе базы данных).

Особенности переноса метаинформации с условиями фильтрации

По окончанию процесса загрузки метаинформации (полной или частичной) во всех настройках фильтрации списка объектов (фильтрации по умолчанию, ограничения содержимого списка, условий отображения контента и фильтрации списков в мобильном приложении) производится поиск условий фильтрации, использующих значения справочников.

Если в условии фильтрации используется значение справочника, то производится замена UUID элемента справочника на основании его кода (в случае, если в загружаемой метаинформации есть сведения о самом справочнике). Другими словами для корректного переноса условий фильтрации в любом из перечисленных выше мест, необходимо при частичной выгрузке метаинформации выгрузить также справочник, элементы которого используются в фильтрации.

Данный функционал можно отключить в конфигурационном файле dbaccess.properties (параметр ru.naumen.metainfo.server.spi.MetainfoExportSource.useMetainfoFiltersUuidsTransformer)

Включение параметра может привести к значительному увеличению времени загрузки метаинформации.