Usm pon: различия между версиями
Admin (обсуждение | вклад) (Перенаправление на Us pon) |
Admin (обсуждение | вклад) |
||
(не показано 18 промежуточных версий 4 участников) | |||
Строка 1: | Строка 1: | ||
# | [[Usm_pon_EN|en]] | [[Usm_pon|ru]] | ||
{{activ}} | |||
'''USM_PON''' ''- это модуль для опроса OLT с целью мониторинга работоспособности PON-сети (см. "[[PON]]").'' | |||
'''Данный модуль является заменой устаревшему модулю [[us_pon]]''' | |||
'''Язык модуля:''' Perl | |||
'''Текущая версия:''' см. на странице: [[Модули]] | |||
'''Статус модуля:''' [http://userside.ua/price.php Платный] | |||
Необходимые модули 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 - [[UserSide_API_Key|API]]-ключ к ERP "UserSide" | |||
$logsPath - Путь к каталогу для логов модуля | |||
$isSilence - Флаг - скрывать уведомления в консоль при работе модуля | |||
Модуль usm_pon можно запускать с параметрами ''(указать конкретное устройство, которое необходимо опросить)'' | |||
Пример: | |||
perl usm_pon 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