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

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

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

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

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

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

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

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

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

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

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

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

  • Если при загрузке метаинформации возникла ошибка о неверном формате файла, обратитесь в службу поддержки NAUMEN.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

          Изменение типа значения атрибута при загрузке метаинформации с полным замещением не предусмотрено. Система не выполняет автоматическое изменение типа данных в базе данных.

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

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

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

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

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

  • Если найден объект того же типа с таким же UUID, то значения устанавливаются.
  • Если объект с таким же UUID отсутствует, то настройки не переносятся.

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

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

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

Далее перенос метаинформации с условиями фильтрации выполняется по правилам, заданным в конфигурационном файле dbaccess.properties (параметр ru.naumen.metainfo.server.spi.MetainfoExportSource.useMetainfoFiltersUuidsTransformer, раздел Метаинформация):

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

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

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