Сервер

Сервер ОИК является центральным компонентом системы. Он выполняет сбор данных с оборудования, обработку данных реального времени, архивирование, регистрацию событий и обслуживание клиентских подключений. Сервер работает под Windows и Linux (в виде системных служб или в консольном режиме; смотрите Развертывание под Linux).

Пакеты Сервера версии 2.6 (установщик для Windows и пакеты для Linux) еще не опубликованы; до их выхода можно установить только Сервер 2.5.7 (смотрите Загрузка).

Сервер состоит из отдельных процессов: scada-config, scada-proxy, scada-historian, scada-filesystem, процессов протокольного уровня и др. Их назначение и типовые установки описаны в разделе Состав Сервера. Все процессы запускаются и настраиваются одинаково, поэтому ниже под «Сервером» понимается любой из них, а под server.json — файл параметров конкретного процесса.

Подразделы:

Запуск и управление

Службы Windows

Каждый процесс Сервера устанавливается отдельной системной службой — Telecontrol SCADA Config, Telecontrol SCADA Proxy, Telecontrol SCADA Historian, Telecontrol SCADA IEC 104 и т.д. (полный список — в разделе Состав Сервера). Службы регистрирует scada-setup; они работают от имени учетной записи SYSTEM и запускаются автоматически при загрузке Windows. Остановить и запустить все службы компьютера в правильном порядке можно командами scada-setup stop и scada-setup start (start — с параметрами компьютера: процессы, служб которых на компьютере нет, он пропускает, а с ошибкой завершается, только если на компьютере нет ни одной из запрошенных служб); отдельную службу — стандартными средствами Windows (Панель управления — Службы).

Если на компьютере есть Telecontrol SCADA Config, остальные его службы зависят от нее, а Telecontrol SCADA Proxy — также от Telecontrol SCADA Filesystem: Windows запускает зависящие службы после них, а остановить службу, пока работают зависящие от нее, Панель управления предлагает только вместе с ними.

Восстановление после сбоя. scada-setup настраивает для каждой службы перезапуск при сбое: через 5 секунд после первого сбоя, через 10 секунд после второго и через 60 секунд после последующих; счетчик сбоев сбрасывается через сутки. Сбоем считается и завершение процесса с ненулевым кодом. Процесс, остановившийся из-за отсутствия лицензии, завершается штатно и автоматически не перезапускается — запустите его командой scada-setup start с параметрами компьютера.

Перезапуск процесса протокольного уровня

Если служба процесса протокольного уровня перезапускается, пока работает scada-proxy, — в том числе автоматически после сбоя или при остановке и запуске процессов компьютера, на котором нет scada-proxy, — ничего перезапускать не нужно. Пока процесс недоступен, его объекты в открытых окнах Клиента помечаются как недостоверные, а новые значения в архив не записываются. Обычно в течение минуты после запуска процесса scada-proxy подключается к нему снова: значения в окнах Клиента снова обновляются, а запись в архив возобновляется сама. Перезапускать службу Telecontrol SCADA Historian или Клиент для этого не требуется.

После запуска процесса его объекты получают последние значения из архива: пока устройства не передадут новые значения, объект показывает значение, достоверность и время своей последней записи в архиве. Это относится к объектам, значения которых записываются в архив. Если scada-historian в этот момент недоступен, процесс ждет его не дольше 10 секунд и запускается без этих значений: тогда объекты остаются недостоверными, пока устройства не передадут новые значения.

Если вместе с ним перезапускались scada-proxy и scada-historian (например, scada-setup stop и start на одномашинной установке), Historian запускается заново, а Клиенты переподключаются сами (смотрите Связь с Сервером). Смотрите также Наблюдение за работой.

Консольный режим

Для диагностики процесс Сервера можно запустить в консольном окне: он работает так же, как служба, и выводит журнал на экран. Пиктограммы для этого установщик не создает.

  1. Остановите службу процесса (например, Telecontrol SCADA IEC 104): процесс и его служба не могут работать одновременно — они используют одни и те же порты и файлы.
  2. Откройте командную строку с правами администратора: без них процесс не может прочитать закрытый ключ сертификата Сервера и не запускается.
  3. Задайте пароль svc, который служба получает от scada-setup, и запустите процесс с его файлом параметров:

    set SCADA_SVC_PASSWORD=<пароль svc>
    "C:\Program Files\Telecontrol SCADA\bin\scada-iec104.exe" --param "%ProgramData%\Telecontrol\SCADA Server\iec104\server.json"
    

    Имя исполняемого файла — scada-<процесс>.exe, папка файла параметров — config, proxy, historian, filestore (для scada-filesystem), modbus, iec104, iec61850, opc или vidicon.

  4. Для завершения закройте окно или нажмите Ctrl+C, затем снова запустите службу процесса (Панель управления — Службы) или все процессы компьютера командой scada-setup start с параметрами компьютера.

Без SCADA_SVC_PASSWORD процесс не сможет подключиться к остальным процессам. Переменная SCADA_ROOT_PASSWORD в консольном режиме не нужна: без нее процесс оставляет пароль root, сохраненный службой, без изменений (смотрите Пароль root).

Параметры командной строки

Параметр Описание
--install Установить Сервер как службу Windows (только при ручной настройке без scada-setup)
--uninstall Удалить службу Windows (только при ручной настройке без scada-setup)
--service Запуск в режиме службы (используется системой)
--param <путь> Указать путь к файлу параметров. По умолчанию на Windows — %ProgramData%\Telecontrol\SCADA <процесс>\<имя>.json (например, %ProgramData%\Telecontrol\SCADA IEC 104\scada-iec104.json), на Linux — <имя>.json в папке data рядом с папкой исполняемого файла
--name <имя> Задать имя службы Windows вместо стандартного — позволяет установить на одном компьютере несколько служб одного процесса
--display-name <имя> Задать отображаемое имя службы и заголовок консольного окна
--log-severity <уровень> Наименьший уровень сообщений журнала, как у параметра log.severity; имеет приоритет над ним

Процессы, установленные scada-setup, запускаются с --param, указывающим на %ProgramData%\Telecontrol\SCADA Server\<папка процесса>\server.json.

Развертывание под Linux

Под Linux Сервер устанавливается пакетом .deb или архивом .tar.gz в папку /opt/telecontrol-scada и настраивается той же программой scada-setup (запускайте ее через sudo): apply создает файлы параметров в /var/lib/scada/<процесс>/server.json, конфигурационные БД, сертификат Сервера в /opt/telecontrol-scada/data/Certificates и по службе systemd на процесс — /etc/systemd/system/scada-<процесс>.service, — включает их и запускает в нужном порядке; status, start, stop, remove и set-password управляют этими службами. Пошаговая установка — в разделе Установка под Linux.

  • Службы работают от имени системной учетной записи scada, запускаются при загрузке компьютера и перезапускаются через 10 секунд после сбоя. Как и под Windows, на компьютере с scada-config остальные службы зависят от scada-config.service, а scada-proxy.service — также от scada-filesystem.service: остановка службы останавливает и зависящие от нее.
  • Пакет (после распаковки архива — apply) создает учетную запись scada и добавляет ее в группу dialout, которой принадлежат последовательные порты, в том числе если учетная запись уже существовала. Если apply сообщает, что добавил ее в dialout, перезапустите службы (stop, затем start с параметрами компьютера): уже работающий процесс получает доступ к портам только после перезапуска. Если адаптер RS-485 принадлежит другой группе, добавьте в нее scada (sudo usermod -aG <группа> scada) и перезапустите службы. Процессы протоколов могут принимать соединения на портах ниже 1024 (например, на порту 502 для ретрансляции по MODBUS TCP).
  • Пароли svc и root хранятся в файле /var/lib/scada/secrets/service-secrets.env, который может прочитать только root (смотрите Где хранятся пароли).
  • scada-setup status выводит состояние служб так, как его называет systemd: active — работает, inactive — остановлена, failed — остановилась из-за ошибки.
  • Файл службы apply создает заново при каждом запуске: свои изменения вносите не в него, а в файл параметров server.override.json (смотрите Свои параметры) или в дополнительный файл systemd (systemctl edit scada-<процесс>).
  • Состояние службы — systemctl status scada-<процесс>, сообщения процесса — journalctl -u scada-<процесс> и журнал в папке /var/lib/scada/<процесс>/Logs.
  • migrate --execute под Linux недоступна: Сервер версии 2.5 работал только под Windows.

Запуск без scada-setup

Исполняемые файлы процессов можно запускать и вручную, например в контейнере Docker. Каждый процесс читает свой файл параметров data/<имя>.json (путь к папке data отсчитывается от папки исполняемого файла: <папка программы>/../data) или файл, указанный параметром --param.

В файле параметров можно подставлять переменные окружения ($ENV{ИМЯ}, смотрите Справочник параметров), например, чтобы не хранить в нем пароль root открытым текстом. Установка в Docker-контейнерах выполняется по запросу.