Alpha.Community

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

Приложение A: Установка и настройка PostgreSQL

ОС Windows

  1. Установите PostgreSQL.

    Скачайте с официального сайта (https://www.postgresql.org/) и установите:

    При установке PostgreSQL подтвердите установку инструмента pgAdmin: данный инструмент потребуется для создания и настройки БД.

  2. Создайте и настройте БД

    1. В pgAdmin создайте новую БД.

    2. Для созданной БД запустите скрипт создания таблиц, необходимых для хранения данных.

      Файл скрипта называется postgresql.9.5.sql и находится в папке C:\Program Files\Automiq\Alpha.Server\Server\SQLScripts.

    3. Создайте системный источник данных для БД:

      1. Запустите окно администратора источников данных Панель управления → Администрирование → Источники данных (ODBC).
      2. На вкладке Системный DSN создайте новый источник данных.

        При создании выберите установленный драйвер ODBC.

        Параметры источника данных:

        Параметр Описание
        DataSource Название нового системного источника данных.
        Description Описание источника данных, необязательное поле.
        Database Название БД, созданной в PostgreSQL.
        SSL Mode Алгоритм шифрования данных.
        Server Хост, на котором расположен PostgreSQL.
        Port Номер порта для подключения к PostgreSQL.
        UserName Имя пользователя PostgreSQL.
        Password Пароль пользователя PostgreSQL.
    4. В настройки PostgreSQL добавьте разрешённую для подключения сеть:

      1. Перейдите в папку в зависимости от разрядности ОС: C:\Program Files\PostgreSQL\xx\data или C:\Program Files (x86)\PostgreSQL\xx\data, где xx - версия PostgreSQL.
      2. В файл pg_hba.conf добавьте строку в формате:

        host <database> <user> <address> <auth-method>
        Значения полей
        Поле Значение
        <database>

        Имя базы данных.

        all – все базы данных.

        <user>

        Имя пользователя.

        all – все пользователи.

        <address>

        Имя компьютера, ip-адрес или диапазон ip-адресов.

        all – любые ip-адреса.

        <auth-method>

        Метод аутентификации:

        trust – без аутентификации.

        Полное описание файла, полей и их возможных значений смотрите в документации PostgreSQL: https://postgrespro.ru/docs/postgrespro/10/auth-pg-hba-conf.

        Разрешить доступ ко всем БД любым пользователям с любых ip-адресов, но с аутентификацией методом md5:

        host all all all md5
    5. Настройте прослушивание ip-адресов:

      1. В той же папке C:\Program Files\PostgreSQL\xx\data или C:\Program Files (x86)\PostgreSQL\xx\data в файле postgresql.conf найдите строку:

        listen_address = ’localhost’
      2. В строке измените значение localhost на *:

        listen_address = ’*’
    6. Перезапустите PostgreSQL.

После окончания настройки, базу данных можно подключать в качестве хранилища в модуле истории.

ОС Linux

Установка и настройка

Пакет установки PostgreSQL не поставляется вместе с комплектом установочных пакетов Альфа платформы.

  1. Установите PostgreSQL.

    sudo apt-get install postgresql

    При установке будет создан пользователь postgres.

  2. Войдите под автоматически созданным пользователем:

    sudo -u postgres psql

    или создайте нового пользователя и войдите под ним:

    CREATE USER rootuser WITH password 'MyPassword';
    ALTER USER rootuser WITH SUPERUSER;

    Автоматически созданному пользователю можно установить пароль, но при потере пароля доступ будет закрыт:

    ALTER USER postgres with PASSWORD 'password';
  3. Запустите консольный клиент PostgreSQL. Для этого от суперпользователя root выполните команду:

    sudo -u postgres psql
  4. Для созданной БД запустите скрипт создания таблиц, необходимых для хранения данных. Для этого от суперпользователя root выполните команду:

    \i /opt/Automiq/Alpha.Server/SQLScripts/postgresql.9.5.sql
  5. В настройки PostgreSQL добавьте разрешённую для подключения сеть:

    1. Перейдите в директорию PostgreSQL: /etc/postgresql/xx/main, где xx - версия PostgreSQL.
    2. В файл pg_hba.conf добавьте строку в формате:

      host <database> <user> <address> <auth-method>
      Значения полей
      Поле Значение
      <database>

      Имя базы данных.

      all – все базы данных.

      <user>

      Имя пользователя.

      all – все пользователи.

      <address>

      Имя компьютера, ip-адрес или диапазон ip-адресов.

      all – любые ip-адреса.

      <auth-method>

      Метод аутентификации:

      trust – без аутентификации.

      Полное описание файла, полей и их возможных значений смотрите в документации PostgreSQL: https://postgrespro.ru/docs/postgrespro/10/auth-pg-hba-conf.

      Разрешить доступ ко всем БД любым пользователям с любых ip-адресов, но с аутентификацией методом md5:

      host all all all md5
  6. Настройте прослушивание ip-адресов:

    1. В той же директории /etc/postgresql/xx/main найдите файл postgresql.conf.
    2. В файле найдите строку

      listen_address = ’localhost’
    3. В строке измените значение localhost на *:

      listen_address = ’*’
  7. Перезапустите PostgreSQL:

    systemctl restart postgresql
  8. Если Alpha.Server, который будет подключаться к PostgreSQL, установлен в ОС Windows, то добавьте системный источник данных ОС Windows для базы данных PostgreSQL, как описано выше.

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

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

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

sudo apt-get install unixodbc odbc-postgresql

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

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

    [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, 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:

    sudo systemctl restart postgresql.service

Указание переменных среды сервису alpha.server

Для корректной работы модуля истории с источником данных укажите переменные среды сервису alpha.server:

  1. Откройте unit-файл сервиса alpha.server командой:

    sudo systemctl edit alpha.server
  2. В открывшемся редакторе пропишите сервису alpha.server переменные среды в разделе Service:

    [Service]
    Environment=ODBCSYSINI=/etc //укажите путь до папки, в которой находится файл odbc.ini
  3. Сохраните изменения и перезапустите сервис alpha.server командой:

    sudo systemctl restart alpha.server

Описание таблиц

Скрипт postgresql.9.5.sql при выполнении добавляет в БД PostgreSQL следующие таблицы:

  • Items;
  • History;
  • EventHistory.

Каждая таблица содержит свой набор столбцов определенных типов данных.

Типы данных в таблицах

Типы данных, используемые в таблицах, приведены ниже:

Тип данных Описание
bigint Знаковое целое из 8 байт [-9×10–18; 9×1018].
bigserial Большое целое с автоувеличением из 8 байт [1; 9 223 372 036 854 775 807].
boolean Логическое значение [true; false].
double precision Значение с плавающей точкой из 8 байт [±5.0×10-324; ±1.7×10308], точность 15-17 цифр.
integer, int Знаковое целое из 4 байт [-2 147 483 648; 2 147 483 647].
smallint Знаковое целое из 2 байт [32 768; 32 767].
text Символьная строка переменной длины.
timestamp Дата и время по UTC.

Таблица Items

Таблица Items отображает список сигналов в БД.

Столбец Тип данных Описание
Id bigserial Идентификатор сигнала, первичный ключ.
Parent bigint Идентификатор родительского сигнала из этой же таблицы.
Name text Имя сигнала.
Description text Описание сигнала.
EngUnits text Единицы измерения.

Таблица History

Таблица History отображает историю значений сигналов.

Столбец Тип данных Описание
Id bigserial Первичный ключ.
ItemId bigint Идентификатор сигнала (Id) в таблице Items.
ItemTimestamp timestamp Метка времени сигнала (дата и время по UTC).
RegTimestamp timestamp Метка времени сервера (дата и время по UTC).
ValInt bigint Значение сигнала (знаковое).
ValDouble double precision Значение сигнала (с плавающей точкой).
ValBool boolean Значение сигнала (логическое).
ValString text Значение сигнала (текстовое).
Quality integer Качество сигнала.

Таблица EventHistory

Таблица EventHistory отображает историю событий.

Столбец Тип данных Описание
Id bigserial Первичный ключ.
Version smallint Версия событий.
Time bigint Время генерации уведомления о событии (по UTC).
Source text Полное имя сигнала, от которого произошло событие.
EventType int

Тип события:

  • 1 – простое событие (например, ошибки устройств или системные сообщения);
  • 2 – событие отслеживания (например, действия оператора или изменение настроек);
  • 4 – событие, связанное с изменением состояния условия генерации событий.
EventCategory int

Категория события:

  • 0 – Дискретное (Discrete);
  • 1 – Перечисление (Enumeration);
  • 2 – Динамическое (Dynamic);
  • 3 – По уровню (Level);
  • 4 – Отклонение (Deviation);
  • 7 – Внешние события (Foreign).
Severity int Важность события.
Condition text Условие генерации события.
SubCondition text Подусловие генерации события.
Message text Текст сообщения о событии.
ChangeMask smallint

Побитовая маска изменений свойств условия генерации событий:

  • 1 – активация события (для новых событий всегда устанавливается только это значение);
  • 2 – квитирование события;
  • 4 – изменение состояния разрешения генерации события;
  • 8 – изменение качества значения;
  • 16 – изменение важности события;
  • 32 – изменение подусловия;
  • 64 – изменение сообщения;
  • 128 – изменение атрибута события.
NewState smallint

Индикатор нового состояния условия:

  • 1 – событие неактивно и неквитировано;
  • 3 – событие активно и неквитировано;
  • 5 – событие неактивно и квитировано;
  • 7 – событие активно и квитировано.
Quality int Качество.
ActiveTime bigint Время перехода состояния события в активное.
Cookie int Текстовая информация о событии, хранящаяся в сервере.
ActorId text Идентификатор клиента, который квитирует событие.
AckRequired boolean

Требуется ли квитирование события:

  • 0 – не требуется;
  • 1 – требуется.
ValInt bigint Значение сигнала (знаковое).
ValDouble double precision Значение сигнала (с плавающей точкой).
ValBool boolean Значение сигнала (логическое).
ValString text Значение сигнала (текстовое).
AttrSound text Звук события.
AttrAckComment text Комментарий квитирования.
AttrAreaPath text Зона, которой принадлежит источник события.
AttrObjId bigint Идентификатор объекта, которому принадлежит источник события.
AttrSuppressed boolean

Состояние подавления события:

  • false – подавление отсутствует;
  • true – подавление активно.
AttrSuppressedUntil bigint Подавление события до указанной метки времени.

Ускорение получения истории значений из БД PostgreSQL

Если БД была создана с использованием более ранних версий Alpha.Server, то при большом объёме истории значений получение истории из БД может замедлиться. Чтобы ускорить получение истории значений, обновите имеющуюся БД истории.

Обновите БД, если Модуль истории при запуске сообщает в журнал приложений о возможности ускорения получения истории значений путём обновления БД.

Обновление имеющейся БД не повлияет на хранящуюся в БД историю. Однако перед обновлением рекомендуем создать резервную копию БД. Это поможет предотвратить потерю истории, например, при внезапном отключении электропитания во время обновления.

Чтобы обновить имеющуюся БД:

  1. Остановите Alpha.Server.
  2. Обновите структуру БД:

    1. Подключитесь к имеющейся БД с помощью pgAdmin, при этом используйте учётную запись с правом создания индексов таблиц.
    2. Выполните скрипт postgresql.9.5.sql.
  3. В pgAdmin выполните запрос:

    VACUUM FREEZE

    Дождитесь окончания выполнения запроса.

После выполнения запроса обновление БД будет завершено, а доступ к истории значений будет ускорен.

Ускорение получения истории значений достигается за счёт использования индексов таблицы history, которые создаются во время обновления БД.