Table of Contents

Сервер ЛЭРС УЧЁТ

Сервер ЛЭРС УЧЁТ представляет собой службу с названием "ЛЭРС УЧЁТ - сервер" (имя службы LERSServer). Устанавливается в папку %ProgramFiles%\LERS\Server и работает под учетной записью NETWORK SERVICE. Для достижения наилучшей производительности, Сервер ЛЭРС УЧЁТ рекомендуется ставить на отдельный более мощный компьютер.

К Серверу ЛЭРС УЧЁТ подключаются рабочие места операторов и службы опроса. Сам Сервер ЛЭРС УЧЁТ подключается к серверу баз данных.

Назначение Сервера ЛЭРС УЧЁТ

  • Обмен данными между компонентами системы (Служба опроса, сервер баз данных, Рабочее место оператора).
  • Проверка прав доступа при подключении пользователя к системе и прав на выполнение операций.
  • Уведомление клиентских приложений о событиях. Например, при создании нового объекта учета или удалении имеющегося, на всех Рабочих местах оператора, подключенных к Серверу ЛЭРС УЧЁТ, автоматически обновится список объектов.
  • Загрузка обновлений компонентов системы с сайта разработчика.
  • Формирование очереди заданий для управления опросом точек учета.
  • Протоколирование работы в журналах приложения и в системном журнале работы Windows.
  • Анализ данных опроса и уведомление клиентских приложений о нештатных ситуациях.
  • Предоставляет REST API для взаимодействия с системой из внешних программ.
  • Предоставляет Web-интерфейс для просмотра данных и управлением системой

Перед запуском Сервера ЛЭРС УЧЁТ должен быть запущен сервер баз данных (MS SQL Server или Postgres).

Протоколирование работы Сервера ЛЭРС УЧЁТ ведется в журнале сервера.

Параметры конфигурации

Основная конфигурация сервера ЛЭРС УЧЁТ находится в файле Lers.Server.xml. Он находится в папке %ProgramFiles%\LERS\Server на Windows и /etc/LERS на Linux. Если файла нет, то будут использоваться параметры Сервера ЛЭРС УЧЁТ по умолчанию. Файл должен быть набран в кодировке UTF-8.

Файл поделен на секции, каждая из которых имеет свой набор параметров. Ниже показан пример содержимого файла Lers.Server.xml

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <network>
        <listenPort>10000</listenPort>
        <listenAddress></listenAddress>
    </network>
    <dataBase>
        <sqlServer>(local)\LERS</sqlServer>
        <dataBaseName>LERS</dataBaseName>
    </dataBase>
</configuration>

Секция Advanced

Параметр По умолчанию Описание
enableErrorReporting True Отправлять отчет об ошибках.
EnableIPBanLog True Включить ведение журналов IPBan.

Секция DataBase

Параметры подключения к базе данных ЛЭРС.

sqlServer Имя сервера баз данных. Можно использовать (local)\LERS, если сервер баз данных установлен на одном компьютере с Сервером ЛЭРС УЧЁТ. По умолчанию sqlServer = (local)\LERS.

databaseName Наименование базы данных на сервере баз данных. По умолчанию databaseName = LERS.

commandTimeout Таймаут на выполнение запроса к базе данных (в секундах). По умолчанию commandTimeout = 60.

Секция NetWork

listenAddress Параметр определяет адрес сервера По умолчанию listenAddress не задан.

listenPort Параметр определяет порт сервера По умолчанию listenPort = 10000.

Командная строка

Сервер предоставляет интерфейс командной строки для того, чтобы можно было автоматизировать различные операции.

На Windows команды запускаются следующим образом:

Lers.Server.exe cli КОМАНДА [АРГУМЕНТЫ]

На Linux команды запускаются так:

dotnet /usr/LERS/Server/Lers.Server.dll cli КОМАНДА [АРГУМЕНТЫ]

Ниже описаны команды и аргументы, поддерживаемые сервером.

Примечание

Все операции интерфейса командной строки сервера выполняются и протоколируются журналах как действия от имени встроенной учётной записи администратора.

Сброс пароля администратора

Команда: reset-admin-pass.

Сбрасывает пароль встроенной учётной записи администратора в значение по умолчанию admin. Смотрите подробности в статье Сброс пароля администратора.

Экспорт данных в формате XML

Команда: export.

Экспортирует данные по точкам учёта, или группам объектов учёта. Точно так же экспортируются данные из АРМ оператора и веб-интерфейса.

Параметры:

  • OutFile: путь к файлу для экспорта. Если не указан, файл будет выведен в консоль.
  • NodeGroup: идентификатор, или наименование группы объектов, данные по всем точкам учёта которой будут экспортированы.
  • MeasurePoints: номера точек учёта, данные по которым будут экспортированы. Задаются через запятую без пробелов.
  • From: дата начала периода экспорта данных.
  • To: дата окончания периода экспорта данных. Если не задана, берётся текущая дата.
  • DataType: типы данных, которые нужно экспортировать. Задаются через запятую без пробелов. Типы могут быть Month, Day, Hour для месячных, суточных и часовых архивов.

Дата начала и окончания периода могут задаваться в явном виде, или в виде ссылки относительно сегодняшнего дня. Например, ссылка может быть задана в виде 30d, или 30h, где d или h — дни или часы, а число задаёт число дней или часов.

Импорт данных в формате XML

Команда: import

Импортирует данные в формате XML в систему. Операция аналогично импорту в АРМ оператора и веб-интерфейсе.

Параметры:

  • InFile: путь к файлу
  • Overwrite: значение true или false. Определяет будут ли перезаписаны существующие данные
  • TimeoutMin: таймаут (в минутах) на окончание операции импорта По умолчанию 30 минут.

Для того, чтобы операция завершилась полностью успешно, должен быть запущен сервер ЛЭРС. В этом случае после импорта данных будут:

  • Обновлены последние данные
  • Отправлены уведомления открытым мнемосхемам
  • Отправлены уведомления подключенным клиентам об обновлении последних данных
  • Запущена диагностика

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

См. также