Alpha.Community

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

OC Windows

Установка PostgreSQL

Чтобы установить СУБД PostgreSQL:

  1. Запустите установочный файл postgresql-x.х-х-windows-xxx.exe (дистрибутив можно скачать с официального сайта https://www.enterprisedb.com/downloads/postgres-postgresql-downloads).
  2. Задайте пароль для подключения к серверу PostgreSQL для пользователя postgres, который создаётся в процессе установки PostgreSQL.

Установка Alpha.RMap

Чтобы установить Alpha.RMap, запустите установочный файл Alpha.RMap х.х.х.х (x64).msi и следуйте инструкциям мастера установки.

Каталог установки Alpha.RMap по умолчанию: C:\Program Files\Automiq\Alpha.RMap.

Выполнение скрипта установки

После установки Alpha.RMap:

  1. Запустите от имени администратора файл install.cmd, расположенный в каталоге установки Alpha.RMap.
  2. Введите версию установленного ранее PostgreSQL.

  3. Введите номер редакции PostgreSQL из списка:

  4. После выбора редакции будет определён путь установки PostgreSQL и создан файл rmap_fdw.control.

Если в списке редакций нет требуемой редакции PostgreSQL:

  1. Выберите 0 (Другая).
  2. Введите номер редакции PostgreSQL из списка, совместимой с целевой.
  3. Введите путь до папки с расширениями, в каталоге установки требуемого PostgreSQL, например, C:\Program Files\PostgreSQL\11\share\extension.

Настройка Alpha.RMap

Откройте любым текстовым редактором файл скрипта init_rmap_history.sql (расположение в папке по умолчанию C:\Program Files\Automiq\Alpha.RMap\Initialize).

Если пользователей СУБД несколько, то пропишите команды SQL CREATE USER MAPPING для каждого пользователя:

CREATE USER MAPPING FOR "postgres"
SERVER history_server;

CREATE USER MAPPING FOR "admin" 
SERVER history_server; 

CREATE USER MAPPING FOR "user" 
SERVER history_server;

Получение данных по TCP (рекомендуемое)

Чтобы получать данные Alpha.Server и Alpha.Historian по TCP, укажите значения соответствующих атрибутов параметра OPTIONS команды SQL CREATE SERVER.

Получение оперативных значений Alpha.Server

Чтобы получать оперативные значения Alpha.Server по TCP, укажите значения атрибутов:

CREATE SERVER history_server TYPE 'alpha.rmap.historian.rprovider'
FOREIGN DATA WRAPPER rmap_fdw
  OPTIONS ( 
    SourceLocation '127.0.0.1',
    --SourceDA 'AP.OPCDAServer',
    SourceTcpPort '4388',
    HistorianLocation '127.0.0.1',
    --HistorianName 'Alpha.Historian.Server',
    HistorianTcpPort '4949',
    HistorianDB 'default',
    --SourceAE 'AP.OPCAEServer',
    SourceAETcpPort '4388',
    AeHistorianLocation '127.0.0.1',
    --AeHistorianName 'Alpha.Historian.Server',
    AeHistorianTcpPort '4949',
    AeHistorianDB 'aebase'
);
  • SourceLocation – адрес Alpha.Server;
  • SourceTcpPort и SourceAETcpPort – порт модуля TCP Server, указанный в параметре конфигурации модуля Номер TCP порта. По умолчанию порт 4388.

Символы комментирования -- перед атрибутами SourceTcpPort и SourceAETcpPort должны отсутствовать.

Атрибуты SourceDA и SourceAE должны быть закомментированы символами --.

Получение истории из Alpha.Historian через модуль TCP Server (рекомендуемое)

Чтобы получать историю значений и событий из Alpha.Historian через модуль TCP Server, в значениях атрибутов укажите адрес Alpha.Server и порт доступа к истории, заданный в настройках модуля TCP Server:

CREATE SERVER history_server TYPE 'alpha.rmap.historian.rprovider'
FOREIGN DATA WRAPPER rmap_fdw
  OPTIONS ( 
    SourceLocation '127.0.0.1',
    --SourceDA 'AP.OPCDAServer',
    SourceTcpPort '4388',
    HistorianLocation '127.0.0.1',
    --HistorianName 'Alpha.Historian.Server',
    HistorianTcpPort '8085',
    HistorianDB 'default',
    --SourceAE 'AP.OPCAEServer',
    SourceAETcpPort '4388',
    AeHistorianLocation '127.0.0.1',
    --AeHistorianName 'Alpha.Historian.Server',
    AeHistorianTcpPort '8085',
    AeHistorianDB 'aebase'
);
  • HistorianLocation и AeHistorianLocation - адрес Alpha.Server с модулем TCP Server;
  • HistorianTcpPort и AeHistorianTcpPort – порт доступа к истории модуля TCP Server.

Порт доступа к истории задан в настройках модуля TCP Server:

  • в Alpha.DevStudio в свойстве Номер TCP порта группы Настройки доступа к истории;
  • в сервисном приложении Конфигуратор в параметре Порт доступа к истории группы Настройки доступа к истории.

Если в настройках модуля TCP Server порт не задан, то установите в соответствующем параметре модуля любой свободный порт.

Получение истории из Alpha.Historian по TCP

Чтобы получать историю значений и событий из Alpha.Historian по TCP, укажите значения атрибутов:

CREATE SERVER history_server TYPE 'alpha.rmap.historian.rprovider'
FOREIGN DATA WRAPPER rmap_fdw
  OPTIONS ( 
    SourceLocation '127.0.0.1',
    --SourceDA 'AP.OPCDAServer',
    SourceTcpPort '4388',
    HistorianLocation '127.0.0.1',
    --HistorianName 'Alpha.Historian.Server',
    HistorianTcpPort '4949',
    HistorianDB 'default',
    --SourceAE 'AP.OPCAEServer',
    SourceAETcpPort '4388',
    AeHistorianLocation '127.0.0.1',
    --AeHistorianName 'Alpha.Historian.Server',
    AeHistorianTcpPort '4949',
    AeHistorianDB 'aebase'
);
  • HistorianLocation и HistorianTcpPort – адрес и порт Alpha.Historian, в котором хранятся значения;
  • HistorianDB – имя базы данных, в которой хранятся значения;
  • AeHistorianLocation и AeHistorianTcpPort – адрес и порт Alpha.Historian, в котором хранятся события;
  • AeHistorianDB – имя базы данных, в которой хранятся события.

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

<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="default" />
    <Base Alias="aebase" />
  </Bases>
</Alpha.Historian.Server>

Символы комментирования -- перед атрибутами HistorianTcpPort и AeHistorianTcpPort должны отсутствовать.

Атрибуты HistorianName и AeHistorianName должны быть закомментированы символами --.

Получение данных по OPC

Чтобы получать данные Alpha.Server и Alpha.Historian по OPC, укажите значения соответствующих атрибутов параметра OPTIONS команды SQL CREATE SERVER.

Получение оперативных значений Alpha.Server

Чтобы получать оперативные значения Alpha.Server по OPC, укажите значения атрибутов:

CREATE SERVER history_server TYPE 'alpha.rmap.historian.rprovider'
FOREIGN DATA WRAPPER rmap_fdw
  OPTIONS ( 
    SourceLocation '127.0.0.1',
    SourceDA 'AP.OPCDAServer',
    --SourceTcpPort '4388',
    HistorianLocation '127.0.0.1',
    HistorianName 'Alpha.Historian.Server',
    --HistorianTcpPort '4949',
    HistorianDB 'default',
    SourceAE 'AP.OPCAEServer',
    --SourceAETcpPort '4388',
    AeHistorianLocation '127.0.0.1',
    AeHistorianName 'Alpha.Historian.Server',
    --AeHistorianTcpPort '4949',
    AeHistorianDB 'aebase'
);
  • SourceLocation – адрес Alpha.Server;
  • SourceDA и SourceAE – ProgID модулей OPC DA Server и OPC AE Server, указанные в конфигурации Alpha.Server в файле Alpha.Server.xml:

    <?xml version="1.0" encoding="windows-1251"?>
    <configuration>
      <install ServiceName="Alpha.Server" ExeName="Alpha.Server.exe">
        <ComServers>
          <OPCDA ProgID="AP.OPCDAServer" CLSID="{28A2AD9C-C45E-4C6b-A0C3-6E363F99CA72}" />
          <OPCAE ProgID="AP.OPCAEServer" CLSID="{0CAEA48A-D7E6-44A4-85FD-C27836727D07}" />
          <HDA ProgID="AP.HDAServer" CLSID="{8002740A-886F-1488-2280-42058D6D5CA8}" />
        </ComServers>
      </install>
      <Storage Filename="AlphaServer.cfg" />
      <Connection Port="4572" />
      <Backup Path="..\Backups" Time="00:00" StorageDepth="14" />
      <Log Path="..\Logs" />
      <Instance ID="6423D92E-9FA4-4B02-945A-D047A0D9EA14" />
      <Culture LangID="ru-RU" />
    </configuration>

Символы комментирования -- перед атрибутами SourceDA и SourceAE должны отсутствовать.

Атрибуты SourceTcpPort и SourceAETcpPort должны быть закомментированы символами --.

Получение истории из Alpha.Historian по OPC

Чтобы получать историю значений и событий из Alpha.Historian по OPC, укажите значения атрибутов:

CREATE SERVER history_server TYPE 'alpha.rmap.historian.rprovider'
FOREIGN DATA WRAPPER rmap_fdw
  OPTIONS ( 
    SourceLocation '127.0.0.1',
    SourceDA 'AP.OPCDAServer',
    --SourceTcpPort '4388',
    HistorianLocation '127.0.0.1',
    HistorianName 'Alpha.Historian.Server',
    --HistorianTcpPort '8085',
    HistorianDB 'default',
    SourceAE 'AP.OPCAEServer',
    --SourceAETcpPort '4388',
    AeHistorianLocation '127.0.0.1',
    AeHistorianName 'Alpha.Historian.Server',
    --AeHistorianTcpPort '8085',
    AeHistorianDB 'aebase'
);
  • HistorianLocation – адрес Alpha.Historian, в котором хранятся значения;
  • HistorianName – имя Alpha.Historian, в котором хранятся значения;
  • HistorianDB – имя базы данных, в которой хранятся значения;
  • AeHistorianLocation – адрес Alpha.Historian, в котором хранятся события;
  • AeHistorianName – имя Alpha.Historian, в котором хранятся события;
  • AeHistorianDB – имя базы данных, в которой хранятся события.

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

<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="default" />
    <Base Alias="aebase" />
  </Bases>
</Alpha.Historian.Server>

Символы комментирования -- перед атрибутами HistorianName и AeHistorianName должны отсутствовать.

Атрибуты HistorianTcpPort и AeHistorianTcpPort должны быть закомментированы символами --.

Получение истории из Alpha.Historian через модуль OPC HDA Server

Чтобы получать историю значений и событий из Alpha.Historian с помощью модуля OPC HDA Server, в значениях атрибутов укажите адрес Alpha.Server и ProgID модуля OPC HDA Server.

CREATE SERVER history_server TYPE 'alpha.rmap.historian.rprovider'
FOREIGN DATA WRAPPER rmap_fdw
  OPTIONS ( 
    SourceLocation '127.0.0.1',
    SourceDA 'AP.OPCDAServer',
    --SourceTcpPort '4388',
    HistorianLocation '127.0.0.1',
    HistorianName 'AP.HDAServer',
    --HistorianTcpPort '8085',
    HistorianDB 'default',
    SourceAE 'AP.OPCAEServer',
    --SourceAETcpPort '4388',
    AeHistorianLocation '127.0.0.1',
    AeHistorianName 'AP.HDAServer',
    --AeHistorianTcpPort '8085',
    AeHistorianDB 'aebase'
);
  • HistorianLocation и AeHistorianLocation - адрес Alpha.Server с модулем OPC HDA Server;
  • HistorianName и AeHistorianName – ProgID модуля OPC HDA Server.

ProgID модуля OPC HDA Server указан в конфигурации Alpha.Server в файле Alpha.Server.xml:

<?xml version="1.0" encoding="windows-1251"?>
<configuration>
  <install ServiceName="Alpha.Server" ExeName="Alpha.Server.exe">
    <ComServers>
      <OPCDA ProgID="AP.OPCDAServer" CLSID="{28A2AD9C-C45E-4C6b-A0C3-6E363F99CA72}" />
      <OPCAE ProgID="AP.OPCAEServer" CLSID="{0CAEA48A-D7E6-44A4-85FD-C27836727D07}" />
      <HDA ProgID="AP.HDAServer" CLSID="{8002740A-886F-1488-2280-42058D6D5CA8}" />
    </ComServers>
  </install>
  <Storage Filename="AlphaServer.cfg" />
  <Connection Port="4572" />
  <Backup Path="..\Backups" Time="00:00" StorageDepth="14" />
  <Log Path="..\Logs" />
  <Instance ID="6423D92E-9FA4-4B02-945A-D047A0D9EA14" />
  <Culture LangID="ru-RU" />
</configuration>

Применение настроек Alpha.RMap

Чтобы применить настройки Alpha.RMap:

  1. После внесения изменений сохраните файл init_rmap_history.sql.
  2. Запустите среду разработки и администрирования pgAdmin.
  3. В pgAdmin исполните скрипт init_rmap_history.sql.

Чтобы SQL запросы выполнялись по OPC, служба postgresql-ххх-x.x должна быть запущена от пользователя с правами Администратора.

Установка и настройка драйвера ODBC

Для предоставления данных сторонним системам установите драйвер ODBC для PostgreSQL.

Чтобы установить драйвер ODBC для PostgreSQL:

  1. Скачайте дистрибутив драйвера ODBC с официального сайта https://www.postgresql.org/ftp/odbc/releases/ в зависимости от разрядности программного продукта, в который будут предоставляться данные Альфа платформы (например, Microsoft Excel).
  2. Запустите установочный файл и следуйте инструкциям мастера установки.

Чтобы настроить драйвер ODBC для PostgreSQL:

  1. Выполните команду Пуск → Панель управления → Администрирование → Источники данных(ODBC). Аналогичное действие можно выполнить, запустив файл odbcad32.exe, расположенный в папке C:\Windows\System32.

    Приведенные способы актуальны в случае если разрядность ОС Windows совпадает с разрядностью программного продукта, в который будут предоставляться данные.

    Если разрядность ОС Windows - 64 бита, а разрядность приложения - 32 бита, запустите файл odbcad32.exe, расположенный в папке C:\Windows\SysWOW64

  2. В окне Администратор источников данных ODBC перейдите на вкладку Пользовательский DSN и нажмите кнопку Добавить.... В появившемся окне Создание нового источника данных выберите драйвер PostgreSQL Unicode и нажмите кнопку Готово.

  3. В появившемся окне PostgreSQL Unicode ODBC Driver (psqlODBC) Setup укажите:

    • Database - имя базы данных PostgreSQL;
    • Server - адрес сервера;
    • User Name - имя пользователя для подключения к серверу PostgreSQL;
    • Password - пароль пользователя.

  4. После настройки драйвер ODBC для Postgres будет готов к работе: