Alpha.Community

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

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

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

Ниже описаны:

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

    После миграции рекомендуем перевести все базы данных на использование индивидуальных пулов буферов: это предотвратит возможные проблемы взаимного влияния баз данных. Как это сделать, описано здесь.

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

Миграция выполняется при запуске сервера истории, если выполняются все условия:

  • В папке установки Alpha.Historian есть xml-конфигурация.
  • Отсутствует домашняя папка.

Порядок миграции:

  1. Создаётся домашняя папка.
  2. В домашней папке создаются (описания настроек в каждом файле – ниже):

    • Файл определения сервера истории.
    • Файл локальных настроек сервера истории.
    • Для каждой базы данных, описанной в xml-конфигурации, создаётся папка базы данных, в ней – файл определения и файл локальных настроек базы данных.

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

Настройки в файле определения сервера истории:

  • Содержимое элемента tcp-server (настройки работы TCP-интерфейса) копируется в раздел api.
  • Содержимое элемента net-entry-point (настройки подключения к Alpha.Net), если он есть, копируется в раздел net_entry_port, иначе раздел не создаётся.
  • Значения атрибутов 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 копируются прочие атрибуты базы данных.

После миграции

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

Если по каким-либо причинам требуется повторно выполнить миграцию, нужно:

  1. Удалить домашнюю папку.
  2. Перезапустить сервер истории.

Удаление xml-конфигурации

После выполнения миграции, xml-файл конфигурации можно удалить.

Рекомендуется: использовать собственные пулы буферов для баз данных

После выполнения миграции баз данных формата 3x, для них продолжает использоваться общий пул буферов. Общий пул буферов является устаревшим механизмом, вместо него рекомендуется использовать индивидуальный пул буферов для каждой базы данных. Использование индивидуальных пулов буферов позволяет исключить взаимное влияние баз данных, в частности, предотвратить проблемы с недостатком пула буферов при параллельном использовании баз данных.

Для этого:

  1. Для каждой базы данных:

    1. В файле локальных настроек установите значение параметра 3x/workset_cache_limit.
    2. В файле определения отключите флаг deprecated/use_shared_memory_pool (флаг можно удалить).
  2. После перевода всех баз данных на новый режим работы в файле локальных настроек сервера истории можете удалить параметр deprecated/3x_shared_max_memory_pool_size.
  3. Перезагрузите Alpha.Historian, чтобы применить изменения.

Миграция настроек предварительных версий баз данных 4x

Раздел актуален только при обновлении Alpha.Historian со специализированных сборок 3.7, в которых была поддержана предварительная версия баз данных формата 4x.

Помимо описанной выше миграции, для специализированных версий также выполняется миграция:

  • Специфичных настроек сервера истории.
  • Миграция настроек баз данных формата 4x.

Миграция стандартных настроек сервера истории и баз данных формата 3x выполняется так, как описано выше.

Миграция специфичных настроек сервера истории

В файл определения сервера истории дополнительно копируется:

  • Содержимое элемента monitor (настройки интерфейса мониторинга) копируется в раздел monitor.

Миграция настроек баз данных 4x

Формат 4x определяется по наличию вложенного элемента deferred-writes у элемента, описывающего базу данных в файле конфигурации.

Для баз данных 4x миграция настроек выполняется аналогично миграции настроек баз данных 3x со следующими отличиями:

  • Файл определения базы данных создаётся для формата 4x, а не 3x. В файле:

    • Создаётся секция deprecated_add23034_compatibility со следующим содержимым:

      {
        ...
        "deprecated_add23034_compatibility":
        {
          // Совместимость структуры папок/файлов базы данных
          "layout": true,
          // Совместимость формата конфигурационных данных
          "config": true
        }
      }

      В секции – флаги совместимости, о работе с ними сказано ниже.

    • Содержимое элемента settings-policy (настройки политики настроек), если есть, копируется в поле config_policy.
  • Настройки базы данных из xml-конфигурации копируются в файл <папка базы данных>/.alpha.historian.server/config/from_add23034_xmlcfg.jsonc. Файл создаётся, только если в xml-конфигурации для базы данных указан хотя бы один параметр, значение которого отличается от значения по умолчанию. Правила переноса параметров:

    • chunk-size – в поле data/write/auto_commit_size
    • chunk-group-size – в поле data/write/chunk_size
    • threads – в поле data/write/commit_threads
    • PreferredCommonCacheLimit – в поле cache/max_size
    • VolumeLimit – в поле data/storage_limits/max_data_size
    • StorageDepth – в поле data/storage_limits/max_depth
  • Настройки из файла ng/config/policy.json копируются в файл <папка базы данных>/.alpha.historian.db/config/local.jsonc.
  • Настройки из файла ng/config/policy.json копируются в файл <папка базы данных>/.alpha.historian.db/config/policy.jsonc.

После миграции: приведение к стандартному виду

В специальных версиях содержимое базы данных формата 4x хранилось в подпапке ng корневой папки базы данных:

C:\Alpha.Historian\Databases\My-DB/
├── active/
├── archive/
├── imported/
├── ng/
├── stx/
└── db.index

Чтобы привести структуру файлов и папок к стандартному виду:

  1. Остановите сервер истории, чтобы он не блокировал удаление и переименование файлов.
  2. Удалите папки и файлы формата 3x: active, archive, imported, stx, db.index.
  3. Удалите папку ng/config – настройки из неё перенесены при миграции.
  4. Переместите оставшееся содержимое папки ng в корневую папку.
  5. В файле определения базы данных удалите параметр deprecated_add23034_compatibility/layout или установите ему значение false.
  6. Запустите Alpha.Historian.

В результате содержимое папки будет иметь следующую структуру – стандартную для базы данных формата 4x:

C:\Alpha.Historian\Databases\My-DB/
├── data/
├── rlock/
├── objects
└── tx

Чтобы привести содержимое файлов конфигурации к стандартному виду:

  1. Если используется политика настроек, актуализируйте её содержимое.

    Описание будет дополнено в следующих редакциях.

  2. Перенесите настройки из файла <папка базы данных>/.alpha.historian.server/config/from_add23034_xmlcfg.jsonc в файл локальных настроек или в файл политики настроек.
  3. В файле определения базы данных удалите параметр deprecated_add23034_compatibility/config или установите ему значение false.
  4. Перезапустите Alpha.Historian, чтобы применить изменения.

После этого можно удалить:

  • файл <папка базы данных>/.alpha.historian.server/config/from_add23034_xmlcfg.jsonc.
  • секцию deprecated_add23034_compatibility в файле определения базы данных – если секция пуста или оба флага в ней выключены.