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

Материал из WiKi - UserSide
 
(не показано 9 промежуточных версий 4 участников)
Строка 1: Строка 1:
[[Usm_pon_EN|en]] | [[Usm_pon|ru]]
{{activ}}
{{activ}}


Строка 39: Строка 41:
Метод съема данных - SNMP.
Метод съема данных - SNMP.


За один запуск модуль по порядку обходит все OLT-устройства.
'''С версии 3.19+:''' За один запуск модуль опрашивает одно OLT-устройство.
 
'''До версии 3.19:''' За один запуск модуль по порядку обходит все OLT-устройства.


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


Стоит отметить, что в PON толком нет стандартов выдачи информации средствами SNMP и все производители придумывают собственные таблицы хранения и методы интерпретации информации по ONU/ONT. Ниже указаны вендора оборудования, модели которых мы изучили и добавили поддержку. С разных вендоров/моделей мы имеем возможность снимать разный набор информации. Возможно какие-то отдельные модели OLT указанных не будут работать - подобное решается в рабочем порядке в рамках тех.поддержки. Добавление новых OLT осуществляется по запросу и в сотрудничестве с клиентом.
Стоит отметить, что в PON толком нет стандартов выдачи информации средствами SNMP и все производители придумывают собственные таблицы хранения и методы интерпретации информации по ONU. Ниже указаны вендора оборудования, модели которых мы изучили и добавили поддержку. С разных вендоров/моделей мы имеем возможность снимать разный набор информации. Возможно какие-то отдельные модели OLT указанных не будут работать - подобное решается в рабочем порядке в рамках тех.поддержки. Добавление новых OLT осуществляется по запросу и в сотрудничестве с клиентом.
  - BDCOM ''(EPON/GPON)''
  - BDCOM ''(EPON/GPON)''
  - C-Data/Gateray/Topvision ''(GPON)''
  - C-Data/Gateray/Topvision ''(GPON)''
Строка 50: Строка 54:
  - GWDelight ''(EPON)''
  - GWDelight ''(EPON)''
  - Huawei ''(EPON/GPON)''
  - Huawei ''(EPON/GPON)''
  - Iskratel ''(EPON)''
  - Iskratel ''(GPON)''
  - QTECH ''(EPON)''
  - QTECH ''(EPON)''
  - Raisecom ''(EPON/GPON)''
  - Raisecom ''(EPON/GPON)''
Строка 72: Строка 76:
6. Впишите запуск модуля в системный cron, с рекомендованной частотой 1 раз в 30 минут
6. Впишите запуск модуля в системный cron, с рекомендованной частотой 1 раз в 30 минут


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


== Параметры ==
== Параметры ==
Строка 79: Строка 83:


  $usUrl - URL к ERP "UserSide"
  $usUrl - URL к ERP "UserSide"
  $usApiKey - [[API]]-ключ к ERP "UserSide"
  $usApiKey - [[UserSide_API_Key|API]]-ключ к ERP "UserSide"
  $logsPath - Путь к каталогу для логов модуля
  $logsPath - Путь к каталогу для логов модуля
   
   
Строка 91: Строка 95:


опросит OLT с ID 998
опросит OLT с ID 998
== Запуск в окружении Docker ==
Обратитесь к инструкции по ссылке: https://github.com/userside/usm_pon-docker-env

Текущая версия от 07:25, 1 апреля 2024

en | ru

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

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.

С версии 3.19+: За один запуск модуль опрашивает одно OLT-устройство.

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

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

Стоит отметить, что в PON толком нет стандартов выдачи информации средствами SNMP и все производители придумывают собственные таблицы хранения и методы интерпретации информации по ONU. Ниже указаны вендора оборудования, модели которых мы изучили и добавили поддержку. С разных вендоров/моделей мы имеем возможность снимать разный набор информации. Возможно какие-то отдельные модели 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