Сервер ЛЭРС УЧЁТ
Сервер ЛЭРС УЧЁТ представляет собой службу с названием "ЛЭРС УЧЁТ - сервер" (имя службы 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 минут.
Для того, чтобы операция завершилась полностью успешно, должен быть запущен сервер ЛЭРС. В этом случае после импорта данных будут:
- Обновлены последние данные
- Отправлены уведомления открытым мнемосхемам
- Отправлены уведомления подключенным клиентам об обновлении последних данных
- Запущена диагностика
Если сервер не запущен, или по какой-то причине к нему не удаётся подключиться, архивы будут импортированы напрямую в БД, но часть дополнительных данных может остаться не обновлённой.