﻿Внешняя задача для мониторинга состояния АРМ (Автоматизированных Рабочих Мест) "ОИК Диспетчер НТ" (ARIS SCADA)



Основной функционал задачи состоит в мониторинге состояния АРМ и сетевых серверов "ОИК Диспетчер НТ"
Задача умеет определять состояние компьютера АРМ или другого устройства в локальной сети, для этого требуется указать IP-адрес, адрес сигнала для установки состояния компьютера или адрес измерения для установки времени ответа, а также опциональный адрес сигнала для запрета проверки компьютера (при состоянии 0).
Кроме непосредственного состояния компьютера, есть возможность проверить работу конкретного порта.
Частным случаем проверки работы порты является проверка работоспособности сервера базы данных SQL:
- для проверки MS SQL по умолчанию следует проверить порт 1433;
- PostgreSQL - порт 5432;
- MySQL - порт 3306.
Обратите внимание, в зависимости от ваших настроек базы данных порт может отличаться.



В конфигурационном файле "_ARMstatus.cfg" задаются параметры: идентификатор клиента, адрес сигнала для установки состояния клиента и т.д.

Обратите внимание! Файл "_ARMstatus.cfg" следует скопировать в конфигурационный каталог сервера "ОИК Диспетчер НТ", по следующему относительному пути:
CfShare\TM_SERVER\<наименование_сервера_динамических данных>\
Например:
C:\Program Files\InterfaceSSH\Server\CfShare\TM_SERVER\TMS\


Файл следует редактировать в любом текстовом редакторе, например, "Блокнот" или Notepad++.

В тексте файла каждому устройству соответствует одна строка. Строка содержит ряд параметров:
- /client-name="..."
Идентификатор клиента. Соответствует наименованию в трассировке сервера "ОИК Диспетчер НТ" (см. файл readme.png). Обязательно обрамляется кавычками с двух сторон!
- /ts-client-result=...
Адрес сигнала для установки состояния клиента
- /server-name="..."
Имя сетевого сервера "ОИК Диспетчер НТ" для проверки (например, RBS, TMS). Обязательно обрамляется кавычками с двух сторон!
- /ts-server-result=...
Адрес сигнала для установки состония сетевого сервера
- /ip-addr=...
IP-адрес компьютера
- /port=...
Порт для проверки
- /ti-ping-time=...
Адрес измерения для установки времени ответа компьютера
- /ts-ping-result=...
Адрес сигнала для установки состояния компьютера
- /ts-enable-ping=...
Адрес сигнала для проверки необходимости контроля компьютера. Если значение сигнала равно "0", то устройство временно не будет контролироваться (до установки состояния "1")

Адреса сигналов и измерения выглядят следующим образом:
<канал>:<кп>:<объект>
Например:
21:1:18

Дополнительно для наглядности можно указать наименование устройства или любой другой комментарий, хотя это необязательно, и в работе наименование нигде не будет фигурировать.

Пример корректного задания строк конфигурационного файла:
/ip-addr=8.8.8.8 /ti-ping-time=24:2:6 /ts-ping-result=24:2:1 /ts-enable-ping=24:2:6     // Мониторинг состояния компьютера
/client-name="TMCONN: ALEXEID" /ts-client-result=0:1:19       // Мониторинг состояния клиента "ОИК Диспетчер НТ"
/client-name="TMCONN: ALEXEID" /ts-client-result=0:1:19 /ip-addr=8.8.8.8 /ti-ping-time=24:2:6 /ts-ping-result=24:2:1 /ts-enable-ping=24:2:6      // Одновременный мониторинг состояния компьютера и клиента "ОИК Диспетчер НТ"
/ip-addr=10.0.0.1 /port=1433 /ts-ping-result=100:1:1         // Мониторинг состояния MySQL сервера (с помощью TCP-порта)
/server-name="RBS" /ts-server-result=24:2:311           // Мониторинг состояния сетевого сервера RBS

Допускается проверка до 128 устройств в одном файле



В зависимости от результата мониторинга клиента может быть установлено состояние сигнала:
- "1", если клиент запущен;
- "0", если клиент не запущен.

В зависимости от результата мониторинга сетевого сервера может быть установлено состояние сигнала:
- "1", если сервер запущен;
- "0", если сервер не запущен.
Обратите внимание, что состояние сервера определяется по успешному соединению, для этого следует обеспечить и успешную авторизацию задачи с сервером с помощью настроек безопасности сервера.

В зависимости от результата пинга может быть установлено значения измерения:
- Время ответа в мс, если пинг был успешен;
- Значение "-1", если пинг был неуспешен.
В зависимости от результата пинга или проверки порта может быть установлено состояние сигнала:
- "1", если пинг был успешен;
- "0", если пинг был неуспешен.
Если состояние сигнала запрета равно нулю, значение заданных сигнала и/или измерения не будет изменяться.



При запуске в качестве внешней задачи сервера "ОИК Диспетчер НТ" допускается не копировать файл "_ARMstatus.cfg", а воспользоваться встроенным механизм редактирования конфигурации задачи (пункт "Настройка" контекстного меню). При этом допускается любое именование конфигурационного файла в соответствующем поле "Настройки Серверов".

Проверить логику запущенной внешней задачи можно с помощью встроенной трассировки сервера. Для этого открывается окно серверов, выбирается задача ARMStatus, открывается вкладка "Трассировка" и устанавливается флаг "Отладка".



Аргументы запуска задачи:
1) /server=...
Для указания имени компьютера сервера в сети. Если программа запускается как внешняя задача, можно не указывать.

2) /pipe=...
Для указания имени сервера динамических данных. Если сервер называется "TMS" или программа запускается как внешняя задача, можно не указывать.

3) /interval=...
Период запуска проверок, в миллисекундах. По умолчанию 5000 (5 секунд).

4) /pingtimeout=...
Время таймаута пинга, в миллисекундах. По умолчанию 500 (полсекунды).

5) /ignorefails=...
Количество неудачных попыток пинга и проверки TCP-порта перед установкой соответствующего значения. По умолчанию 0 (устанавливать неуспешную попытку сразу). Для минимизации ложных срабатываний из-за кратковременных проблем с каналом и особенностей работы Windows рекомендуется устанавливать значение 2 или 3.