Alpha.Community

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

OC Linux

Установка СУБД PostgreSQL

Astra Linux

  1. Установите в компьютер диск с ОС Astra Linux.
  2. Установите СУБД PostgreSQL. Команда установки с помощью пакетного менеджера apt:

    sudo apt install postgresql-15 postgresql-contrib

Ubuntu

  1. Добавьте репозиторий PostgreSQL, выполнив команды:

    sudo sudo add-apt-repository "deb http://apt.postgresql.org/pub/repos/apt/ $(lsb_release -sc)-pgdg main"
    wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc
    sudo apt-key add ACCC4CF8.asc
    sudo apt-get update
    
  2. Установите СУБД PostgreSQL. Команда установки с помощью пакетного менеджера apt:

    sudo apt install postgresql-xx postgresql-contrib-xx

    где xx - номер версии СУБД PostgreSQL.

РЕД ОС

  1. Установите СУБД PostgreSQL. Команда установки с помощью пакетного менеджера dnf:

    sudo dnf install postgresqlxx-server

    где xx - номер версии СУБД PostgreSQL.

  2. Запуcтите инициализацию базы данных PostgreSQL командой:

    sudo postgresql-xx-setup initdb

    где xx - номер версии СУБД PostgreSQL.

ОС семейства "Альт"

  1. Установите СУБД PostgreSQL. Команда установки с помощью пакетного менеджера apt:

    apt-get install postgresqlxx-server

    где xx - номер версии СУБД PostgreSQL.

  2. Создайте системную базу данных PostgreSQL командой:

    /etc/init.d/postgresql initdb
  3. Запустите PostgreSQL командами:

    systemctl start postgresql
    systemctl enable postgresql

Установка СУБД Tantor BE

Чтобы установить Tantor BE:

  1. Загрузите скрипт инсталлятора командой:

    wget https://public.tantorlabs.ru/db_installer.sh
  2. Скрипту предоставьте права на выполнение командой:

    chmod +x db_installer.sh
  3. Установите переменные среды командой:

    export NEXUS_URL="nexus-public.tantorlabs.ru"
  4. Запустите установку командой:

    ./db_installer.sh \
    --do-initdb \
    --major-version=15 \
    --edition=be
    

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

Каталог установки Alpha.RMap по умолчанию: /opt/Automiq/Alpha.RMap.

Astra Linux, Ubuntu

Имя устанавливаемого пакета: alpha.rmap-x.x.x+bx.rxxxxxx.deb.

Находясь в папке с установочным пакетом, запустите установку. Команда установки с помощью пакетного менеджера dpkg:

sudo dpkg --install ./alpha.rmap-x.x.x+bx.rxxxxxx.deb

РЕД ОС

Имя устанавливаемого пакета: alpha.rmap-x.x.x+bx.rxxxxxx.rpm.

Находясь в папке с установочным пакетом, запустите установку. Команда установки с помощью пакетного менеджера dnf:

sudo dnf install ./alpha.rmap-x.x.x+bx.rxxxxxx.rpm

ОС семейства "Альт"

Имя устанавливаемого пакета: alpha.rmap-x.x.x+bx.rxxxxxx.rpm.

Находясь в папке с установочным пакетом, запустите установку командой:

rpm -i alpha.rmap-x.x.x+bx.rxxxxxx.rpm

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

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

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

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

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

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

  1. Выберите 0 (Другая).
  2. Введите номер редакции PostgreSQL из списка, совместимой с целевой.
  3. Введите путь до папки с расширениями, в каталоге установки требуемого PostgreSQL, например, /usr/share/postgresql/15/extension.

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

Откройте любым текстовым редактором файл скрипта init_rmap_history.sql.

Расположение файла скрипта зависит от используемой ОС:

  • Astra Linux - директория /usr/share/postgresql/xx/extension/init_rmap_history.sql
  • Ubuntu - директория /usr/share/postgresql/xx/extension/init_rmap_history.sql
  • РЕД ОС - директория /usr/pgsql-xx/share/extension/init_rmap_history.sql
  • ОС семейства "Альт" - директория /usr/share/pgsql/extension/init_rmap_history.sql

где xx - используемая версия СУБД PostgreSQL.

Расположение файла скрипта при использовании СУБД Tantor BE - директория /opt/tantor/db/xx/share/postgresql/extension/init_rmap_history.sql, где xx - используемая версия СУБД Tantor BE.

Если пользователей СУБД несколько, то пропишите команды 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;

Чтобы получать данные 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 должны быть закомментированы символами --.

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

PostgreSQL

Astra Linux и Ubuntu

  1. Запустите консольный клиент PostgreSQL. Для этого от суперпользователя root выполните команду:

    sudo -u postgres psql
  2. Запуcтите инициализацию скрипта Alpha.RMap командой:

    \i /usr/share/postgresql/xx/extension/init_rmap_history.sql

    где xx - номер версии СУБД PostgreSQL.

РЕД ОС

  1. Запустите консольный клиент PostgreSQL. Для этого от суперпользователя root выполните команду:

    sudo -u postgres psql
  2. Запуcтите инициализацию скрипта Alpha.RMap командой:

    \i /usr/pgsql-xx/share/extension/init_rmap_history.sql

    где xx - номер версии СУБД PostgreSQL.

ОС семейства "Альт"

  1. Запустите консольный клиент PostgreSQL. Для этого выполните команду:

    psql -U postgres
  2. Запуcтите инициализацию скрипта Alpha.RMap командой:

    \i /usr/share/pgsql/extension/init_rmap_history.sql

Tantor BE

  1. Подключитесь к Tantor BE командой:

    sudo -u postgres /opt/tantor/db/15/bin/psql
  2. Выполните скрипт Alpha.RMap командой:

    \i /opt/tantor/db/15/share/postgresql/extension/init_rmap_history.sql

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

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

Драйвер ODBC для PostgreSQL совместим с Tantor BE.

Запустите установку драйвера ODBC для PostgreSQL командой:

sudo apt-get install unixodbc odbc-postgresql

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

  1. Перейдите в папку /etc и откройте файл odbcinst.ini.
  2. Убедитесь, что в файле есть записи о драйверах PostgreSQL ANSI (если требуется кодировка ANSI) и PostgreSQL Unicode (если требуется кодировка Unicode). Если записей нет, создайте их.

    Astra Linux и Ubuntu:

    [PostgreSQL ANSI]
    Description=PostgreSQL ODBC driver (ANSI version)
    Driver=/usr/lib/x86_64-linux-gnu/odbc/psqlodbca.so
    Setup=libodbcpsqlS.so
    Debug=0
    CommLog=1
    UsageCount=1
    
    [PostgreSQL Unicode]
    Description=PostgreSQL ODBC driver (Unicode version)
    Driver=/usr/lib/x86_64-linux-gnu/odbc/psqlodbcw.so
    Setup=libodbcpsqlS.so
    Debug=0
    CommLog=1
    UsageCount=1
  3. Создайте подключение к базе данных. Откройте файл odbc.ini (из папки /etc) и пропишите параметры подключения к БД:

    [PostgreSQL-connector]
    Description      = PostgreSQL connection
    Driver           = PostgreSQL Unicode
    Database         = user_db //укажите имя БД
    Servername       = localhost
    Username         = user
    Password         = MyPassword1 //укажите пароль
    Port             = 5432
    ReadOnly         = No
    RowVersioning    = No
    ShowSystemTables = No
    ShowOidColumn    = No
    FakeOidIndex     = No
    ConnSettings     =
  4. Откройте файл pg_hba.conf, расположение которого зависит от ОС:

    • Astra Linux - /etc/postgresql/xx/main
    • Ubntu - /etc/postgresql/xx/main
    • РЕД ОС - /var/lib/pgsql/xx/data/
    • ОС семейства "Альт" - /var/lib/pgsql/data

    Файл pg_hba.conf должен содержать следующую запись:

    host    all             all             ::1/128                 md5

    Если данная запись отсутствует, её необходимо добавить в конец файла и перезапустить PostgreSQL.

    Команда перезапуска PostgreSQL в Astra Linux и Ubuntu:

    sudo systemctl restart postgresql.service