Usm pon

Материал из WiKi - UserSide

Эта функция является одной из возможностью
обновления даты активности у объекта

USM_PON - это модуль для опроса OLT с целью мониторинга работоспособности PON-сети (см. "PON").

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


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

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

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

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

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

Установка в Debian:

sudo apt install -y liburi-perl libwww-perl libjson-perl

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

Основные функции

  • выход оптического сигнала с OLT на ONU за допустимые пределы
  • выявление на OLT ONU, которые не внесены в ERP "UserSide" (неизвестных)
  • обнаружение ONU, которые зарегистрированы одновременно на двух OLT

В случае выявления несоответствий - информация будет выведена на главную страницу ERP "UserSide". Более подробнее - см. страницу "PON"

У обнаруженных и опознанных ONU-устройств будет обновлена дата активности в сети.

Метод съема данных - SNMP.

За один запуск модуль по порядку обходит все OLT-устройства.

Поддерживаемое оборудование

Стоит отметить, что в PON толком нет стандартов выдачи информации средствами SNMP и все производители придумывают собственные таблицы хранения и методы интерпретации информации по ONU/ONT. Ниже указаны вендора оборудования, модели которых мы изучили и добавили поддержку. С разных вендоров/моделей мы имеем возможность снимать разный набор информации. Возможно какие-то отдельные модели OLT указанных не будут работать - подобное решается в рабочем порядке в рамках тех.поддержки. Добавление новых OLT осуществляется по запросу и в сотрудничестве с клиентом.

- BDCOM (EPON/GPON)
- C-Data/Gateray/Topvision (GPON)
- Eltex (EPON/GPON)
- GCOM (EPON/GPON)
- GWDelight (EPON)
- Huawei (EPON/GPON)
- Iskratel (GPON)
- QTECH (EPON)
- Raisecom (EPON/GPON)
- Spectra (EPON)
- Stels (EPON)
- V-Solution (EPON/GPON)
- ZTE (EPON/GPON)

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

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

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

6. Впишите запуск модуля в системный cron, с рекомендованной частотой 1 раз в 30 минут

*/30 * * * *    root    perl /home/usm_pon/usm_pon.pl &> /dev/null

Параметры

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

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

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

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

Пример:

perl usm_pon 998

опросит OLT с ID 998

Запуск в окружении Docker

Обратитесь к инструкции по ссылке: https://github.com/userside/usm_pon-docker-env