Сетевой сервер LoRa

Совет

Выберите вкладку в соответствии с используемым семейством ОС.

Windows

После установки сетевого сервера LoRa необходимо отредактировать следующие параметры в файле конфигурации(по умолчанию C:\ReVizor\NetworkServer\appsettings.production.json):

• HostArray — массив содержащий строки вида «<host>:<port>», где host — это IP-адрес, port — это номер порта для входящих UPD-соединений для базовых станций
• MaxOfflineLatency — максимальное время нахождения базовых станций, по истечении которого, если от базовой станции не было никаких данных, последняя переходит в статус «офлайн»
• MaxContextDwellTime — максимальное время на обработку контекста
• AllowJoinRequests — true, если необходимо обрабатывать входящие JOIN_REQ запрос
• AllowDownlink — true, если необходимо включить обратную связь(между сервером и конечным устройствами)
• MinPreferredSnr — минимальное предпочитаемое значение SNR для выбора базовой станции из списка для отправки downlink-сообщений
• AdrHistoryCount — количество анализируемых записей в истории для расчёта индекса мощности TX при использовании ADR
• AdrExtraMargin — дополнительное значение для расчёта требуемого SNR при использовании ADR
• MaxTxAckTime — максимальное время ожидания в секундах подтверждения downlink-пакетов, после чего они будут удалены из очереди
• ClassCReactTime — время реакции для устройств класса C
• ClassCJoinDelay — указывает, необходимо ли добавлять паузу для JOIN_DELAY_1 для устройств класса C
• GarbageCollectionPeriod — период сбора «мусора» в миллисекундах
• NwkID — идентификатор сети; каждая сеть(каждый сетевой сервер LoRa) должен иметь уникальный идентификатор сети

Debian/Ubuntu/AstraLinux

Примечание

Во время установки приложения в папку /opt/dotnet/ будет установлены runtime-библиотеки .NET Core.

1. Под пользователем revizor перейдите в домашнюю директорию и запустите установку ранее подготовленного пакета приложения сервера:

sudo apt-get install ./revizor-network-server-linux-x64-*.deb

2. После установки будут доступны следующие файлы и директории: /etc/opt/revizor/network-server/appsettings.production.json — файл конфигурации сетевого сервера, /etc/systemd/system/revizor-network-server.service — файл systemd настроек службы сетевого сервера, /opt/revizor/network-server/ — папка с установленным приложением службы сетевого сервера, /opt/revizor/network-server/logs/ — папка с журналами работы службы сетевого сервера
3. При первоначальной установке приложения на сервере PostgreSQL необходимо создать базу данных ReVizorNetworkServerDb, пользователя revizor(пользователя в СУБД, а не в ОС) и предоставить пользователю права доступа к базе. Если база и пользователь уже имеются, то этот шаг можно пропустить**(если компонент сервера уже установлен на текущей машине, то можно использовать того же пользователя revizor)**, однако нужно убедиться, что у пользователя revizor есть права доступка к базе ReVizorNetworkServerDb(либо выполнить комманду GRANT ниже). Для создания необходимо запустить консоль psql и выполнить следующие команды

Внимание

Необходимо соблюдать регистр имён пользователей и БД, а также кавычки и точка-запятые в конце запросов!

sudo -u postgres psql postgres

CREATE DATABASE "ReVizorNetworkServerDb";

CREATE USER "revizor" WITH ENCRYPTED PASSWORD '*' CREATEDB SUPERUSER;

— где * — это пароль пользователя revizor, который необходимо будет далее внести в файл конфигурации в поле Password секции DbConfig

GRANT ALL PRIVILEGES ON DATABASE "ReVizorNetworkServerDb" TO "revizor";

\q — для выхода из консоли psql

Для корректной работы службы необходимо изменить настроечные параметры в файле конфигурации /etc/opt/revizor/network-server/appsettings.production.json. В секции AppConfig:

• SecurityKey — секретный симметричный ключ JWT(ключ обязательно нужно заменить на другой), который, например, можно сгенерировать командой openssl rand -hex 32
• Host и Port — IP-адрес и порт для входящих TCP-подключений и веб-интерфейса
• WebAppUri — ссылка на приложение для внешних источников(например, если имеется домен и через него требуется доступ из сети Интернет, например, https://example.com), либо ссылка вида http://{Host}:{Port}

В секции DbConfig:

Server — IP-адрес сервера PostgreSQL Port — порт сервера PostgreSQL(по умолчанию 5432) UserID и Password — имя пользователя и пароль для входа на сервер PostgreSQL созданные выше

В секции PacketForwarder:

• HostArray — массив содержащий строки вида «<host>:<port>», где host — это IP-адрес, port — это номер порта для входящих UPD-соединений для базовых станций
• MaxOfflineLatency — максимальное время нахождения базовых станций, по истечении которого, если от базовой станции не было никаких данных, последняя переходит в статус «офлайн»
• MaxContextDwellTime — максимальное время на обработку контекста
• AllowJoinRequests — true, если необходимо обрабатывать входящие JOIN_REQ запрос
• AllowDownlink — true, если необходимо включить обратную связь(между сервером и конечным устройствами)
• MinPreferredSnr — минимальное предпочитаемое значение SNR для выбора базовой станции из списка для отправки downlink-сообщений
• AdrHistoryCount — количество анализируемых записей в истории для расчёта индекса мощности TX при использовании ADR
• AdrExtraMargin — дополнительное значение для расчёта требуемого SNR при использовании ADR
• MaxTxAckTime — максимальное время ожидания в секундах подтверждения downlink-пакетов, после чего они будут удалены из очереди
• ClassCReactTime — время реакции для устройств класса C
• ClassCJoinDelay — указывает, необходимо ли добавлять паузу для JOIN_DELAY_1 для устройств класса C
• GarbageCollectionPeriod — период сбора «мусора» в миллисекундах NwkID — идентификатор сети; каждая сеть(каждый сетевой сервер LoRa) должен иметь уникальный идентификатор сети

Далее службу можно запустить средствами операционной системы командой:

sudo systemctl start revizor-network-server.service

Fedora/РЕД ОС

СУБД

Для работы службы сервера необходимо установить СУБД PostgreSQL. Для установки следуйте инструкциям с официального сайта PostgreSQL. Для РЕД ОС можно воспользоваться инструкцией с сайта РЕД ОС Установка PostgreSQL.

Совет

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

Перед первоначальной установкой службы сетевого сервера LoRa в установленной СУБД необходимо создать базу данных ReVizorNetworkServerDb, пользователя revizor и предоставить пользователю права доступа к базе. Если база и пользователь уже имеются, то этот шаг можно пропустить. Для создания необходимо запустить консоль psql и выполнить следующие команды:

1. Переключитесь на пользователя root и введите пароль:

su -

2. Переключитесь на пользователя postgres

su - postgres

3. Запустите psql и выполните следующие команды ниже. После ввода команд для выхода из консоли psql введите \q.

CREATE DATABASE "ReVizorNetworkServerDb";

CREATE USER "revizor" WITH ENCRYPTED PASSWORD '*' CREATEDB SUPERUSER;

, где * — это пароль пользователя revizor, который необходимо будет далее внести в файл конфигурации в поле Password секции DbConfig

Совет

Если ранее уже была установлена служба сервера ReVizor с СУБД, то можно использовать существующего пользователя revizor.

GRANT ALL PRIVILEGES ON DATABASE "ReVizorNetworkServerDb" TO "revizor";

Установка и настройка

1. Скопируйте пакет службы сетевого сервера LoRa на машину, где требуется установка, и запустите процесс командой(замените * - на имеющуюся версию):

sudo dnf install ./revizor-network-server-*.x86_64.rpm

2. После установки будут доступны следующие файлы и директории:

• /etc/opt/revizor/network-server/appsettings.production.json — файл конфигурации сетевого сервера,
• /etc/systemd/system/revizor-network-server.service — файл systemd настроек службы сетевого сервера,
• /opt/revizor/network-server/ — папка с установленным приложением службы сетевого сервера,
• /var/log/revizor/network-server/ — папка с журналами работы службы сетевого сервера.

3. При первоначальной установке для корректной работы службы сетевого сервера LoRa необходимо изменить настроечные параметры в файле конфигурации /etc/opt/revizor/network-server/appsettings.production.json.

   В секции AppConfig:

• SecurityKey — секретный симметричный ключ JWT(ключ обязательно нужно заменить на другой), который, например, можно сгенерировать командой openssl rand -hex 32
• Host и Port — IP-адрес и порт для входящих TCP-подключений и веб-интерфейса
• WebAppUri — ссылка на приложение для внешних источников(например, если имеется домен https://example.com, либо ссылка вида http://{Host}:{Port})

Внимание

Ключ SecurityKey обязательно должен быть заменен, так как от него зависит безопасноть входа в систему! Рекомендуется использовать криптографически случайную последовательность байт. Ключ нужно хранить в тайне и только в файле конфигурации.

В секции DbConfig:

• Server — IP-адрес сервера PostgreSQL

• Port — порт сервера PostgreSQL(по умолчанию 5432)

• UserID и Password — имя пользователя и пароль для входа на сервер PostgreSQL созданные выше

  В секции PacketForwarder:

• HostArray — массив содержащий строки вида «<host>:<port>», где host — это IP-адрес, port — это номер порта для входящих UPD-соединений для базовых станций

• MaxOfflineLatency — максимальное время нахождения базовых станций, по истечении которого, если от базовой станции не было никаких данных, последняя переходит в статус «офлайн»

• MaxContextDwellTime — максимальное время на обработку контекста

• AllowJoinRequests — true, если необходимо обрабатывать входящие JOIN_REQ запрос

• AllowDownlink — true, если необходимо включить обратную связь(между сервером и конечным устройствами)

• MinPreferredSnr — минимальное предпочитаемое значение SNR для выбора базовой станции из списка для отправки downlink-сообщений

• AdrHistoryCount — количество анализируемых записей в истории для расчёта индекса мощности TX при использовании ADR

• AdrExtraMargin — дополнительное значение для расчёта требуемого SNR при использовании ADR

• MaxTxAckTime — максимальное время ожидания в секундах подтверждения downlink-пакетов, после чего они будут удалены из очереди

• ClassCReactTime — время реакции для устройств класса C

• ClassCJoinDelay — указывает, необходимо ли добавлять паузу для JOIN_DELAY_1 для устройств класса C

• GarbageCollectionPeriod — период сбора «мусора» в миллисекундах NwkID — идентификатор сети; каждая сеть(каждый сетевой сервер LoRa) должен иметь уникальный идентификатор сети

Далее службу можно запустить средствами операционной системы командой:

sudo systemctl start revizor-network-server.service

Запуск и остановка

Запуск службы:

sudo systemctl start revizor-network-server.service

Остановка службы:

sudo systemctl stop revizor-network-server.service