====== ПОНізатор ======

{{:ponizer0.png?|}}

Модуль ПОНізатор призначений для контролю рівнів сигналів у встановлених в PON користувачів ONU. Також ПОНізатор вміє вести облік рівнів сигналів ONU за попередній час, і зручно їх відображати в розрізі дня/місяця/всього часу існування ONU. На даний момент з коробки надаються шаблони опитування та підтримуються:

  * BDcom
  * ZTE
  * Huawei
  * Eltex
  * Stels
  * Extralink
  * V-Solution
  * C-Data
  * SmartFiber
  * GCOM
  * і всіляке інше невідоме нікому гівно.\\

Що потрібно, щоб він запрацював? Все досить просто. Для початкового налаштування потрібно усього 5 простих кроків.

====== Початкове налаштування ======

1. вмикаємо модуль в [[alteriniconf|alter.ini]]
<code ini>
;ПОНізатор увімкнено?
PON_ENABLED=1
;Показувати як моделі ONU, тільки моделі пристроїв з рядком "ONU" у назві моделі?
ONUMODELS_FILTER=1
</code>

2. У довіднику моделей обладнання додаємо нашу OLT

{{:ponizer1.png?400|}}

3. У довіднику активного мережевого обладнання aka "Комутатори" реєструємо нашу ОЛТ-у, вдумливо вказавши в примітках буквально "OLT". Також не забуваємо вказати валідне SNMP ком'юніті.

{{:ponizer2.png?400|}}

4. Переконуємося, що ми правильно позначили наш пристрій як OLT проскроливши довідник комутаторів донизу.

{{:ponizer3.png?400|}}

5. Переконуємось, чи є в crontab -e відповідний виклик [[remoteapi|RemoteAPI]].

<code bash>
*/10 * * * *    /bin/ubapi "oltpoll"
</code>


====== Використання ======

Додаємо у "довіднику ONU" нашу ONU. І відповідаючи на всі наступні питання: так - їм теж потрібні моделі обладнання з відповідного довідника, так - MAC теж потрібно вказувати.

{{:ponizer4.png?400|}}

Асоціювати ONU з конкретним користувачем ми можемо прямо з профілю цього користувача, скориставшись чорною магією:

{{:ponizer5.png?400|}}

{{:ponizer6.png?400|}}

Надалі, таким же чином, у два кліки мишею, ви з профілю користувача, зможете потрапляти прямо до його ONU.

Через деякий час, якщо ми все зробили правильно, отримуємо ось якусь таку картину з історичними рівнями сигналів:

{{:ponizer7.png?400|}}

Также ПОНізатор для OLT BDcom/Eltex/Stels вміє виявляти ще незареєстровані пристрої ONU і надавати можливості для їх швидкої реєстрації. Для OLT ZTE для цього призначений модуль [[zteonureg|Регистрация ONU/ONT на ZTE OLT]].

{{:ponizer086.png?400|}}

{{:ponizerunknownonu.png?400|}}


====== Трохи про SNMP на OLT ======

**ZTE 220**

<code>
snmp-server community changeme view allview rw
snmp-server view allview internet included 
snmp-server view DefaultView system included 
</code>

**BDCOM**

<code>
 snmp-server community 0 changeme RO
</code>


====== Для Huawei/ZTE/ELTEX GPON======

У snmp шаблонах є опція, яка регулює в якому форматі обробляти серійні номери.
<code>
SNMODE
</code>
Може приймати два значення PURE та STRING.\\
PURE - повністю HEX від серійника, приклад: 54504C47D8826100.\\
STRING - спрощений вигляд, приклад: TPLGD8826100.\\
\\
Дуже важливо вводити серійний номер у ПОНізатор у відповідності до значення опції.

====== Різні фічі (потрібні та не дуже) ======
==== Починаючи з релізу 1.0.3 ====
   * додана можливість валідації МАСів ONU та виключення невалідних з обробки або заміна їх на рандомно згенеровані, типу: FF:00:XX:XX:XX:00. Регулюється наступними опціями [[alteriniconf|alter.ini]]: PON_ONU_MAC_VALIDATE, PON_ONU_MAC_MAKE_RANDOM_IF_INVALID.

==== Починаючи з релізу 1.0.5 ====
   * додано можливість відображення опису (port description) PON-портів в основній таблиці зі списком ONU та у статистиці по OLT. На даний момент це реалізовано для SNMP-шаблонів BDCOM P3310C та V-Solution V1600D. Керується наступними необов'язковими опціями alter.ini: PON_IFACE_DESCRIPTION_IN_MAINTAB, PON_IFACE_DESCRIPTION_IN_STATSTAB.

==== Починаючи з релізу 1.1.3 ====
   * при додаванні слова NOFDBQUERY в опис девайсу в модулі "Комутатори" (так-так, саме там, де ми вказуємо слово OLT) для цього OLT не буде проводитись отримання та розбір FDB кешу. Поки що працює тільки для OLT C-Data/Stels FD11xx і V-Solution V1600D.\\ З релізу **1.2.7** - також для OLT BDCOM.

==== Починаючи з релізу 1.3.2 ====
   * для C-DATA FD12XX додана можливість відображати префікс назви інтерфейсу, наприклад “pon/0/0/”. Регулюється опцією SNMP шаблону INTERFACEADDPONPREFIX

==== Починаючи з релізу 1.3.6 ==== 
   * SNMP шаблони OLTів відтепер підтримують опцію SERIAL_CASE_MODE, призначену для контролю регістру символів серійників GPON ONU в файлах SNMP-кешу опитувань OLT.\\ Може приймати такі значення:\\ 
     * 0 - no case convert
     * 1 - lowercase 
     * 2 - uppercase\\ Задумувалась ця опція для роботи в купі з опцією [[alteriniconf|alter.ini]] PON_ONU_SERIAL_CASE_MODE і головна ідея полягає в слідуючому:
       * опція в alter.ini відповідає виключно за встановлення регістру серійного номера на інтерфейсі, тобто всілякі реєстрації ONU людьми
       * з іншого боку, опція в шаблонах SNMP відповідає за встановлення регістру серійного номера під час опитування SNMP пристроїв OLT\\ Бажаний результат полягає в тому, що ми можемо чітко встановити єдинообразність регістрів серійних номерів ONU в БД для зареєстрованих ONU, а також у файлах кешу опитування SNMP OLTів.\\ Окремо варто відмітити, що для коректної роботи даної опції її підтримка має бути реалізована в HAL-бібліотеці вашого девайсу.\\

   * C-Data/Stels FD11xx також підтримують опцію INTERFACEADDPONPREFIX