Alpha.Community

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

Сервисное приложение Управляющий

Обзор приложения

Сервисное приложение Управляющий предназначено для ручного управления серверами резервной пары.

Сервисное приложение Управляющий входит в состав клиентской части Alpha.Server и может быть установлено только на компьютере под управлением ОС Windows.

Для запуска приложения выполните команду Пуск → Automiq → Управляющий. Если серверы резервной пары защищены от несанкционированного управления, то для доступа к функциям приложения введите пароль.

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

Основные элементы приложения Управляющий приведены на рисунке ниже.

Конфигурирование

Настройки, необходимые для работы приложения Управляющий, прописываются в файле конфигурации APIOServerManager.xml (по умолчанию путь к файлу конфигурации: C:\Program Files\Automiq\Alpha.Server\Service. Конфигурация содержит параметры резервных пар серверов. Ниже приведен пример настройки двух резервных пар (Сервер 1 – Сервер 2 и Сервер 3 – Сервер 4).

<?xml version="1.0" encoding="windows-1251"?>
<serversPairs>
  <servers
    SyncronizeDataBetweenServers = "true"
    ServerPairDescription = "Сервер 1 - Сервер 2">
    <server
      DisplayName = "Сервер 1"
      ServiceName = "Alpha.Server"
      NetworkName = "127.0.0.1"
      Port="4572"
      SnapShotDirectory = "C:\FSModule\"
      SnapShotFile="C:\FSModule\Templates\1.xml"
      ServerDirectory = "C:\Program Files\Automiq\Alpha.Server\Server"
      ServerXmlFileName = "Alpha.Server.xml"
      OPCServer = "AP.OPCDAServer" />
    <server
      DisplayName = "Сервер 2"
      ServiceName = "Alpha.Server"
      NetworkName = "127.0.0.1"
      Port="4572"
      SnapShotDirectory = "C:\FSModule\"
      SnapShotFile="C:\FSModule\Templates\1.xml"
      ServerDirectory = "C:\Program Files\Automiq\Alpha.Server\Server"
      ServerXmlFileName = "Alpha.Server.xml"
      OPCServer = "AP.OPCDAServer" />
  </servers> 
  <servers
    SyncronizeDataBetweenServers = "false"
    ServerPairDescription = "Сервер 3 - Сервер 4">
    <server
      DisplayName = "Сервер 3"
      ServiceName = "Alpha.Server2"
      NetworkName = "127.0.0.1"
      Port="4572"
      SnapShotDirectory = "C:\FSModule"
      SnapShotFile="C:\FSModule\Templates\1.xml"
      ServerDirectory = "C:\Program Files\Automiq\Alpha.Server2\Server"
      ServerXmlFileName = "Alpha.Server.xml"
      OPCServer = "AP.OPCDAServer2" />
    <server
      DisplayName = "Сервер 4" 
      ServiceName = "Alpha.Server2"
      NetworkName = "127.0.0.1"
      Port="4572"
      SnapShotDirectory = "C:\FSModule"
      SnapShotFile="C:\FSModule\Templates\1.xml"
      ServerDirectory = "C:\Program Files\Automiq\Alpha.Server2\Server"
      ServerXmlFileName = "Alpha.Server.xml"
      OPCServer = "AP.OPCDAServer2" />
  </servers>
</serversPairs>

Параметры резервной пары серверов описаны в элементе <servers></servers> следующими атрибутами:

Атрибут Описание
SyncronizeDataBetweenServers Флаг активности синхронизации данных между серверами резервной пары.
ServerPairDescription Название резервной пары в заголовке вкладки Управляющего.

Параметры каждого сервера резервной пары описаны в элементах <server></server> следующими атрибутами:

Атрибут Описание

DisplayName

Название сервера, отображаемое в Управляющем.

ServiceName

Имя службы сервера.

NetworkName

Сетевое имя компьютера, на котором установлен Alpha.Server.
Port Номер порта, через который происходит подключение к серверу (указан в файле Alpha.Server.xml в параметре Connection Port).
SnapShotDirectory Путь к папке для размещения файл-срезов.

SnapShotFile

Xml-шаблон для генерации файла-среза.

ServerDirectory

Каталог расположения файлов Alpha.Server.

ServerXmlFileName

Имя файла настроек Alpha.Server.

OPCServer

Программный идентификатор Alpha.Server (указан в файле Alpha.Server.xml в параметре OPCDA ProgID).

Чтобы добавить новую резервную пару серверов в Управляющий, скопируйте параметры существующей резервной пары серверов (элемент <servers></servers>) и задайте значения атрибутов.

После внесения изменений в файл APIOServerManager.xml перезапустите Управляющий.

Функции Управляющего

Резервное копирование конфигурации

Чтобы создать резервную копию текущей конфигурации сервера, нажмите кнопку Резервное копирование.

Резервная копия конфигурации в формате *.backup сохраняется в папку, указанную в файле настроек Alpha.Server.xml в атрибуте Backup Path. По умолчанию резервные копии конфигурации сохраняются:

  • в ОС Windows в папке C:\Program Files\Automiq\Alpha.Server\Backups;
  • в ОС Linux в директории /opt/Automiq/Alpha.Server/Backups.

Синхронизация данных с помощью файла-среза

Для синхронизации данных с помощью файлов-срезов в состав конфигурации каждого сервера резервной пары должен входить настроенный модуль Snapshot.

Функция позволяет сгенерировать файл-срез с текущими значениями сигналов на активном сервере, а затем отправить и развернуть файл-срез на резервном сервере. Синхронизация проводится по направлению от рабочего (активного) к резервному серверу.

Для создания файла-среза по умолчанию используется шаблон, указанный в параметре SnapShotFile файла APIOServerManager.xml.

Чтобы синхронизировать данные с помощью файла-среза, нажмите кнопку Синхронизировать данные.

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

Папка с шаблонами файлов-срезов задаётся в настройках модуля Snapshot.

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

Синхронизация конфигураций

Функция служит для приведения к идентичному состоянию конфигураций серверов резервной пары. Синхронизация проводится по направлению от рабочего (активного) к резервному серверу.

Если конфигурации серверов синхронизированы, то номера версий конфигураций совпадают и выделены зеленым цветом.

Если конфигурации серверов не синхронизированы, то номера версий конфигураций отличаются и выделены желтым цветом. Стрелка указывает направление возможной синхронизации (от активного к резервному серверу).

При нажатии кнопки Синхронизировать происходит синхронизация конфигурации и файла с внешними объектами Alpha.ServerExternalObjects.xml (при наличии).

Ручной резервный переход или остановка серверов

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

Для принудительной остановки сервера нажмите кнопку Остановить под индикатором сервера. Принудительная остановка сервера не допускается, когда сервер находится в состоянии РАБОТА в составе резервной пары.