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

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

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

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

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

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

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

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

  • Перед загрузкой метаинформации на стенд рекомендуется выгрузить с него текущий файл метаинформации. Это позволит восстановить предыдущие настройки системы при возникновении ошибок.

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

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

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

Страница "Администрирование", вкладка "Управление системой".

Чтобы перейти на страницу "Администрирование", в меню навигации выберите "Настройка системы" → "Администрирование".

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

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

    1. В меню навигации выберите "Настройка системы" → "Администрирование".

    2. На вкладке "Управление системой" (блок "Выгрузка/загрузка") в строке "Метаинформация" нажмите кнопку "Выгрузить", выберите значение параметра "Выгрузить, возможные значения" и нажмите кнопку "Выгрузить". После этого выполнится процесс сохранения файла.

      Возможные значения параметра "Выгрузить, возможные значения":

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

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

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

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

    1. В меню навигации выберите "Настройка системы" → "Администрирование".

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

      Параметры формы загрузки метаинформации:

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

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

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

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

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

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

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

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

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

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

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

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

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