4.2.1.2.1.5.1. Миграция настроек предыдущих версий

 
Если на компьютере ранее был установлен Astra.Historian предыдущего поколения (версия < 2.0), в которой настройки хранились в xml-конфигурации, то сервер истории при первом запуске выполнит миграцию настроек в новый формат. Таким образом после переустановки сервер истории и базы данных продолжат работать в том же режиме и с теми же параметрами, с которыми они работали до переустановки Astra.Historian.
Настройки для предыдущего поколения (версия < 2.0), в котором настройки хранились в xml-конфигурации, описаны в разделе XML-конфигурация предыдущего поколения.
После миграции рекомендуем перевести все базы данных на использование индивидуальных пулов буферов: это предотвратит возможные проблемы взаимного влияния баз данных.
 

Алгоритм выполнения миграции

 
Миграция выполняется при запуске сервера истории, если выполняются все условия:
В папке установки Astra.Historian есть xml-конфигурация.
Отсутствует домашняя папка.
 
Порядок миграции:
  • Создаётся домашняя папка.
  • В домашней папке создаются:
Файл определения сервера истории.
Файл локальных настроек сервера истории.
Для каждой базы данных, описанной в xml-конфигурации, создаётся папка базы данных, в ней – файл определения и файл локальных настроек базы данных.
Для отображения конфигурационных файлов  необходимо:
в ОС AstraLinux: включить функцию "Отображать скрытые".
в РЕД ОС: включить функцию "Показывать скрытые файлы".
 
Если миграцию по какой-либо причине не получится завершить успешно, домашняя папка, созданная в процессе миграции, будет удалена со всем содержимым, чтобы миграцию можно было запустить повторно.
 
Настройки в файле определения сервера истории:
  Содержимое элемента "tcp-server" (настройки работы TCP-интерфейса) копируется в раздел "api".
Значения атрибутов "StatPort" и "EnableDCOM" корневого элемента (настройки устаревшего интерфейса статистики и DCOM-интерфейса) копируются в поля "deprecated/start_port" и "deprecated/enable_dcom" соответственно.
 
Настройки в файле локальных настроек сервера истории:
Значение атрибута "MaxPoolMemorySize" корневого элемента копируется в поле "deprecated/3x_shared_max_memory_pool_size".
 
Описание файлов определения и локальных настроек сервера истории представлены в разделе Настройки сервера
Папка базы данных:
Имя папки – имя базы данных: значение атрибута "Alias" у элемента "Base" в xml-конфигурации.
 
Настройки в файле определения базы данных:
В поле "format" записывается значение "3x".
В поле "location" записывается полный путь к основной папке размещения содержимого базы данных:
Если в xml-конфигурации для базы данных указан атрибут "PrimaryDir", то будет записан путь к папке <PrimaryDir>/<Alias>.
Иначе будет записан путь к папке <DefaultPrimaryDir>/<Alias> (DefaultPrimaryDir – атрибут корневого элемента, задающий папку по умолчанию для всех баз данных).
В поле "archive_location" записывается полный путь к папке размещения архивного раздела базы данных:
Если в xml-конфигурации для базы данных указан атрибут "ArchiveDir", будет записан путь к папке <ArchiveDir>/<Alias>.
Иначе поле не добавляется.
В поле "deprecated/use_shared_memory_pool" записывается значение "true".
 
Настройки в файле локальных настроек базы данных:
Создаётся раздел 3x.
В раздел 3x копируются прочие атрибуты базы данных.
 
Если по каким-либо причинам требуется повторно выполнить миграцию, необходимо удалить домашнюю папку и перезапустить сервер истории.
После выполнения миграции, xml-файл конфигурации можно удалить.
 
После выполнения миграции баз данных формата 3x, для них продолжает использоваться общий пул буферов. Общий пул буферов является устаревшим механизмом, вместо него рекомендуется использовать индивидуальный пул буферов для каждой базы данных.
Использование индивидуальных пулов буферов позволяет исключить взаимное влияние баз данных, в частности, предотвратить проблемы с недостатком пула буферов при параллельном использовании баз данных.
 
Чтобы использовать индивидуальные пулы буферов для каждой базы данных, выполните следующие действия:
  • Для каждой базы данных:
  • В файле локальных настроек установите значение параметра "3x/workset_cache_limit".
  • В файле определения отключите флаг "deprecated/use_shared_memory_pool" (флаг можно удалить).
  • После перевода всех баз данных на новый режим работы в файле локальных настроек сервера истории можете удалить параметр "deprecated/3x_shared_max_memory_pool_size".
    Перезагрузите Astra.Historian, чтобы применить изменения.