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

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


Строка 13: Строка 15:


Необходимые модули Perl:
Необходимые модули Perl:
DBI
  Time::Local
  Time::Local
  Net::SNMP
  Socket
  FindBin
  FindBin
  LWP::Simple
URI
URI::Escape
  LWP::UserAgent
JSON
Data::Dumper
 
Установка в Debian:
sudo apt install -y liburi-perl libwww-perl libjson-perl


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


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


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


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


За один запуск модуль по порядку обходит все OLT-устройства.
За один запуск модуль по порядку обходит все 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


== Параметры ==
== Параметры ==


Настройка модуля осуществляется в файле '''us_config.tmp'''
Настройка модуля осуществляется в файле usm_pon.conf
 
$usUrl - URL к ERP "UserSide"
$usApiKey - [[UserSide_API_Key|API]]-ключ к ERP "UserSide"
$logsPath - Путь к каталогу для логов модуля
$isSilence - Флаг - скрывать уведомления в консоль при работе модуля
 
Модуль usm_pon можно запускать с параметрами ''(указать конкретное устройство, которое необходимо опросить)''
 
Пример:


  $zuserver - адрес сервера с UserSide
  perl usm_pon 998
$zubase - имя базы данных UserSide
$zuuser - имя пользователя для доступа к базе UserSide
$zupass - пароль для доступа к базе UserSide
$zusqlport - порт подключения к базе данных ''(по-умолчанию 3306)''
$ps_us_path - URL к САП "UserSide" ''(например http://your_net.com/userside/)''
$ps_logpath - путь к логам модуля
$zsilence - не выводить уведомления о работе модуля в консоль


== Рекомендации по настройке модуля ==
опросит OLT с ID 998


# В системный cron следует записать вызов модуля us_pon. Рекомендуется - 1 раз в 10 минут
== Запуск в окружении Docker ==


/10 * * * * perl /home/userside_pon/us_pon.pl &> /dev/null
Обратитесь к инструкции по ссылке: https://github.com/userside/usm_pon-docker-env

Версия от 18:20, 22 декабря 2023

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.

За один запуск модуль по порядку обходит все 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

Источник — https://wiki.userside.eu/index.php?title=Usm_pon&oldid=16806