Usm radio: различия между версиями

Материал из WiKi - UserSide
Нет описания правки
Нет описания правки
 
(не показана 1 промежуточная версия 1 участника)
Строка 1: Строка 1:
[[Usm_radio_EN|en]] | [[Usm_radio|ru]]
'''USM_RADIO''' ''- это модуль, который осуществляет периодический опрос радиооборудования, определяет подключенных радиоабонентов и уровни сигналов к ним. В случае выхода уровня сигналов из допустимых значений на [[Главная страница|главную страницу]] системы будет выведено уведомление.''  
'''USM_RADIO''' ''- это модуль, который осуществляет периодический опрос радиооборудования, определяет подключенных радиоабонентов и уровни сигналов к ним. В случае выхода уровня сигналов из допустимых значений на [[Главная страница|главную страницу]] системы будет выведено уведомление.''  


Строка 10: Строка 12:
* UBNT
* UBNT
* ELTEX
* ELTEX
* Cambium


[[Файл:Screenshot_radio.PNG|thumb|800px|center]]
[[Файл:Screenshot_radio.PNG|thumb|800px|center]]

Текущая версия от 16:42, 1 ноября 2023

en | ru

USM_RADIO - это модуль, который осуществляет периодический опрос радиооборудования, определяет подключенных радиоабонентов и уровни сигналов к ним. В случае выхода уровня сигналов из допустимых значений на главную страницу системы будет выведено уведомление.


Данный модуль является заменой устаревшему модулю us_radio


ВАЖНО: На данный момент модуль поддерживается радиооборудование производителей

  • MikroTik
  • UBNT
  • ELTEX
  • Cambium


Если уровень сигнала находится в пределах -79...-73, то уведомления будут выведены желтым цветом

Если уровень сигнала менее -80 или более -40, то уведомления будут выведены красным цветом

При запуске модуль опрашивает все подходящие радиоустройства.


Язык модуля: Perl

Текущая версия: см. на странице: Модули

Статус модуля: Платный

Необходимые модули Perl:

Time::Local
FindBin
URI
URI::Escape
LWP::UserAgent
JSON
Data::Dumper

Общую информацию для всех модулей см. на странице: Модули

Установка и настройка модуля

  1. Выделите отдельный каталог. Абсолютно произвольный. Лучше его не размещать в каталоге, доступном через web. Взаимодействие с ERP "UserSide" осуществляется средствами API по http/s-протоколу. Таким образом модуль полностью автономен и может работать на любом отдельном компьютере в любой подсети. Также создайте отдельный каталог для логов модуля. Не забудьте указать для него права на запись.
  2. Перенесите туда файлы из архива модуля. Пример файла конфигурации "usm_radio.conf-example" переименуйте в "usm_radio.conf". В нём выполните настройку параметров. Перечень возможных параметров указан ниже.
  3. Проверьте наличие дополнительных perl-пакетов, которые требуются для запуска модуля. Их список приведён выше. Если у вас они не установлены - модуль выдаст ошибку при запуске и perl-пакет необходимо будет установить (с помощью CPAN или PPM).
  4. В разделе "Настройка - Модули" включите работу с модулем usm_radio
  5. Запустите модуль руками
perl usm_radio.pl

Он должен запуститься и отработать без ошибок.

7. Впишите запуск модуля в системный cron раз в 30-60 минут

Параметры

Настройка модуля осуществляется в файле usm_radio.conf

$usUrl - URL к ERP "UserSide"
$usApiKey - API-ключ к ERP "UserSide"
$logsPath - Путь к каталогу для логов модуля

$isSilence - Флаг - скрывать уведомления в консоль при работе модуля

Модуль usm_radio можно запускать с параметрами (указать конкретное устройство, которое необходимо опросить)

Пример:

perl usm_radio 998

опросит радиооборудование с ID 998

Если информация не снимается/модуль не работает

1. Необходимо разграничить и понять - не работает модуль или не снимается информация. В карточке оборудования - следует проверить лог запусков модуля usm_radio по устройству.

2. Следует убедиться, что верны community доступа, пароли и само устройство физически подключено и работает.

3. В самой ERP "UserSide" откройте карточку оборудования и перейдите по ссылке "Подключенные радиоабоненты"

4. Для теста - следует запустить модуль конкретно для определенного устройства. Например:

perl usm_radio.pl s 998

запустит модуль для оборудования ID: 998

Проверяем нет ли ошибок в выводе информации.

В файлах логов анализируем полученную информацию.