Usm pon: различия между версиями
Admin (обсуждение | вклад) |
Admin (обсуждение | вклад) |
||
(не показано 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 | Стоит отметить, что в 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 ''( | - 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
Эта функция является одной из возможностью |
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)
Установка и настройка модуля
- Выделите отдельный каталог. Абсолютно произвольный. Лучше его не размещать в каталоге, доступном через web. Взаимодействие с ERP "UserSide" осуществляется средствами API по http/s-протоколу. Таким образом модуль полностью автономен и может работать на любом отдельном компьютере в любой подсети. Также создайте отдельный каталог для логов модуля. Не забудьте указать для него права на запись.
- Перенесите туда файлы из архива модуля. Пример файла конфигурации "usm_pon.conf-example" переименуйте в "usm_pon.conf". В нём выполните настройку параметров. Перечень возможных параметров указан ниже.
- Проверьте наличие дополнительных perl-пакетов, которые требуются для запуска модуля. Их список приведён выше. Если у вас они не установлены - модуль выдаст ошибку при запуске и perl-пакет необходимо будет установить (с помощью CPAN или PPM).
- В разделе "Настройка - Модули" включите работу с модулем usm_pon
- Запустите модуль руками
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