Alpha.Community

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

XML-конфигурация предыдущего поколения

Все настройки как сервера истории, так и баз данных хранились в едином файле конфигурации Alpha.Historian.Server.xml в папке установки.

Настройки Alpha.Historian

Настройки Alpha.Historian указывались в виде атрибутов корневого элемента Alpha.Historian.Server.

<?xml version="1.0" encoding="utf-8"?>
<Alpha.Historian.Server 
  StatPort="3388"
  DefaultPrimaryDir="C:\Alpha.Historian\Databases"
  MaxPoolMemorySize="512">
</Alpha.Historian.Server>
Атрибуты элемента Alpha.Historian.Server

Атрибут

Описание

StatPort

Номер порта, по которому будет открыт доступ к статистике сервера

DefaultPrimaryDir

Путь до основного каталога файлов БД; используется в качестве значения по умолчанию для БД, в которых не переопределён

MaxPoolMemorySize

Максимальный объём оперативной памяти в мегабайтах, используемой в качестве кеша для работы с базами данных. Значение данного атрибута вычисляется по формуле, приведённой в этом разделе

EnableDCOM

Поддержка DCOM. Значения:

  • 0 – отключён
  • 1 – включён

Значение по умолчанию – 1.

Если DCOM включён, клиенты смогут подключаться к Alpha.Historian по OPC (используется по умолчанию в модуле истории). DCOM доступен только в ОС Windows. Если Alpha.Historian или клиент установлен в ОС Linux, нужно настроить подключение по TCP.

Атрибут StatPort обязательный, остальные атрибуты опциональны.

Настройки подключения по TCP

Настройки подключения на TPC указывались в виде атрибутов элемента tcp-server и его дочерних элементов server-endpoint.

<?xml version="1.0" encoding="utf-8"?>
<Alpha.Historian.Server StatPort="3388" DefaultPrimaryDir="C:\Alpha.Historian\Databases" MaxPoolMemorySize="512">
  <tcp-server
    default-port=4949
    idle-sessions-count=1
    idle-sessions-timeout=15>
      <server-endpoint host="0.0.0.0" />
  </tcp-server> 
</Alpha.Historian.Server>
Атрибуты элемента tcp-server
Атрибут Описание
default-port Порт по умолчанию, используется для дочерних элементов server-endpoint, у которых не указан порт.
idle-sessions-count

Количество одновременно удерживаемых неактивных сессий.

Значение по умолчанию – 0 (не ограничено).

idle-sessions-timeout

Время ожидания активации неактивных сессий (в секундах).

Значение по умолчанию – 0 (не ограничено).

Все атрибуты опциональны.

Атрибуты элементов server-endpoint
Атрибут Описание
port Порт точки доступа к серверу. Если не указан, используется порт default-port родительского элемента.
host

Хост точки доступа к серверу.

Значение по умолчанию – 0.0.0.0 (любой адрес).

Все атрибуты опциональны.

Настройки баз данных

Базы данных описывались в элементе Bases. Настройки каждой базы данных задавались в виде атрибутов элемента Base, дочернего для Bases.

<?xml version="1.0" encoding="utf-8"?>
<Alpha.Historian.Server StatPort="3388" DefaultPrimaryDir="C:\Alpha.Historian\Databases" MaxPoolMemorySize="512">
  <tcp-server default-port=4949 idle-sessions-count=1 idle-sessions-timeout=15>
    <server-endpoint host="0.0.0.0" />
  </tcp-server>
  <Bases>
    <Base Alias="DBName" /> 
    <Base Alias="DB2Name" /> 
  </Bases>
</Alpha.Historian.Server>
Атрибуты элемента Base
Название атрибута элемента Описание
Alias Короткое имя БД (псевдоним), должно быть уникальным для сервера истории
Атрибуты хранения
PrimaryDir Путь до основного каталога БД. Если не указан, то совпадает с DefaultPrimaryDir из настроек сервера
ArchiveDir Путь до архивного каталога БД. Если не указан, то совпадает с PrimaryDir
Атрибуты для ограничений на хранение данных
PreferredCommonCacheLimit

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

Чем больше значение данного параметра, тем больше данных будет находиться в кэше, обращение к которому выполняется значительно быстрее, чем запрос данных с диска.

Значение по умолчанию – 128

ActiveStorageDepth

Длительность хранения данных в активной области в сутках. Минимальное значение – 1.

Значение по умолчанию – 3

StorageDepth

Максимальная глубина хранения данных в БД до удаления в сутках. 0 - без ограничений; если не 0, то должно быть больше или равно значения ActiveStorageDepth.

Значение по умолчанию – 0

VolumeLimit

Предельный объём БД в мегабайтах; при превышении предела выполняется очистка архивных данных до снижения объёма ниже предела, если это возможно. 0 – без ограничений.

Значение по умолчанию – 0

Атрибуты для сжатия архивированных данных
ArchiveCompression

Алгоритм сжатия архивных файлов:

  • none – без сжатия;
  • lzma – сжатие алгоритмом LZMA.

Значение по умолчанию – none

BlocksPerCompressedPack

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

Значение по умолчанию – 10

Recompress

Стратегия выбора файлов для сжатия:

Значение по умолчанию – none

Атрибут Alias обязательный, остальные атрибуты опциональны.