====== Реєстрація ONU/ONT на ZTE/Huawei OLT ======

[[http://ubilling.net.ua/?module=fnpages&pid=lightpay|{{ :buy-100u.png?nolink&|}}]]

===== Що варто очікувати від модуля? =====
  - Показує список незареєстрованих ONU/ONT
  - Реєструє ONU/ONT на OLT ZTE
  - Реєструє ONU/ONT на OLT Huawei
  - Реєструє ONU/ONT в [[ponizer|ПОНизаторі]]
  - Інтеграція с [[vlanmanagement|Менеджером VLAN]] для реалізації QINQ

===== Плани =====
  - QINQ (зроблено в 1.0.3)
  - Дереєстрація онушок


===== Як увімкнути? =====

Цей модуль керується опцією в **alter.ini** ONUREG_ZTE. І відповідні права: ONUREGZTE і ZTEVLANBINDS.
<file ini alter.ini>
ONUREG_ZTE=1
</file>

Дуже важливо перевірити наявність встановленого **expect** в системі та перевірити що шлях до нього в **billing.ini** співпадає з реальністю.
<code bash>
$ whereis expect
expect: /usr/local/bin/expect /usr/local/man/man1/expect.1.gz /usr/ports/lang/expect
$
</code>

<file ini billing.ini>
EXPECT_PATH="/usr/local/bin/expect -f"
</file>

Так само вимагає увімкненого [[ponizer|ПОНізатора]] і SWITCH_AUTOCONFIG в **alter.ini** 
<file ini alter.ini>
PON_ENABLED=1
SWITCH_AUTOCONFIG=1
</file>

Обов'язково вимкнути SNMPWALK_BACKGROUND
<file ini alter.ini>
SNMPWALK_BACKGROUND=0
</file>

Інші опції
<file ini alter.ini>
ONUREG_QINQ_ENABLED
ONUREG_HUAWEI_NATIVE_VLAN
ONUREG_DHCP_SNOOPING_DEFAULT
ONUREG_LOOPDETECT_DEFAULT
</file>
\\
Варто зазначити, що цей модуль працює як з EPON так і з GPON. 
\\ 

===== Налаштування модуля =====

Після увімкнення опції в **alter.ini** і встановлення відповідного ключа ліцензії в ПОНізаторі 
з'явитися посилання на модулі "Редагувати карти" і "Перевірити незареєстровані ONU/ONT".
\\
\\
{{:ponizer_screen.png?direct&800|}} 
\\
\\

Створити модель свіча з потрібним шаблоном zte\ zte gpon або Huawei-MA. 
\\
\\
{{:switchmodel_olt_screen.png?direct&800|}}
\\ 
\\

Слідом потрібно створити спосіб підключення до OLT. Важливо розуміти, що реєстрація онушек (на жаль) відбувається через telnet\ssh. 
За замовчуванням у ZTE відключена можливість підключення по SSH, тож будьте уважні під час вибору методу підключення. 
Створити підключення потрібно в модулі Свічі -> Switch login вибравши метод Connect і додавши потрібну OLT з правильними логіном і паролем. 
\\
\\
{{:switch_login_screen.png?direct&800|}} 
\\
\\

Для того щоб побачити в списку наші OLT, потрібно привести довідник свічів у відповідний вигляд: 
Перейшовши в нього, побачимо наш список доступних OLT. OLT-и фільтруються за ознакою: містить OLT в описі
і в імені snmp шаблону містить підрядок ZTE або Huawei-MA. 
Тобто спочатку розрахунок на те, що OLT уже налаштована для роботи з ПОНізатором. 
\\
\\
{{:switch_olt_screen.png?direct&500|}}
\\
\\

Якщо все зроблено правильно, відкривши модуль "Редагувати карти", ми повинні побачити приблизно таке:
\\
\\
{{:zte_card_edit_screen.png?direct&800|}} 
\\
\\

Далі потрібно заповнити доступні карти, встановлені в OLT. Для цього натискаємо на кнопку "редагувати карти" 
(іконка шасі) для обраного OLT. Щоб побачити всі встановлені карти в графі "Список встановлених карт" 
Натисніть "Запросить" і побачите список усіх карт на OLT. 
Дуже важливий момент: номер шасі. За замовчуванням для ZTE c220 номер шасі буде 0, для ZTE c300\c320 буде 1.
Якщо ви вручну повністю налаштовували OLT, вкажіть там потрібну цифру. Зазвичай вона являє собою першу цифру 
у назві інтерфейсів, наприклад, для EPON карти в 1 слоті, якщо номер шасі 0, pon-інтерфейси називатимуться
як epon-olt_0/1/1. Для Huawei за замовчуванням номер шасі 0.
Відповідно потрібно "зареєструвати" всі epon або gpon карти.
\\ 
\\
{{:zte_card_edit_full_screen.png?direct&800|}} 
\\
\\

Після реєстрації всіх карт можна "забиндити" VLAN-и до потрібних PON-портів. Навіщо це потрібно? Наприклад, 
за тим, що людина, яка розуміє, що таке VLAN, і людина, яка реєструє ONU, - можуть бути
різними людьми. Тобто ми можемо отримати такий собі preset, що б працівники могли в три кліки 
зареєструвати ONU. Цей функціонал доступний у модулі "Редагувати карти" після натискання кнопки 
"Редагувати закріплені VLAN-и" (іконка скріпки) для обраного OLT. Це необов'язковий крок, 
під час реєстрації ONU у формі можна вказати довільний VLAN.
\\
\\
{{:zte_vlan_bind_screen.png?direct&800|}}
\\
\\

Тепер якщо все зроблено правильно ми можемо вирушити в модуль "Перевірити незареєстровані ONU/ONT". 
За умови, що OLT сконфігурований правильно і є реальні незареєстровані ONU, то ми побачимо щось таке:
\\
\\
{{:zte_unreg_onu_screen.png?direct&800|}}
\\
\\

Після натискання на іконку плюса ми перейдемо в меню реєстрації ONU.
\\
\\
{{:zte_reg_onu_screen.png?direct&400|}}
\\
\\
Тут ми бачимо раніше заповнений VLAN, який знову ж таки ніхто не заважає замінити на довільний.
Дуже важливий момент із вибором моделі для ONU. Це зроблено не для краси, дуже важливо створити 
правильну модель для ONU. У список вибору потрапляє обладнання з довідника "Моделі обладнання"
з підрядком ONU в імені. Чому це так важливо: У ZTE є трохи особлива логіка щодо реєстрування 
ONU. Дуже важливо вказати правильну кількість портів для ONU. Якщо для чотирьох портової ONU ви вкажете 
модель однопортової ONU, то на вихлопі отримаєте лише один робочий порт із 4. Якщо для 1-но портової 
вкажіть чотирьох портову модель, найімовірніше, взагалі нічого працювати не буде.
\\
\\
Отже, приклад правильної моделі це: \\
<code>
Имя:   Fora NA-1001B ONU 
Порти: 1 
</code>
\\ \\ 
Так само варто зазначити, що якщо вказати логін наявного користувача - то для цієї ONU 
створиться запис у ПОНізаторі. Можна залишити порожнім, тоді в ПОНізатор нічого не додасться. 
Ще один важливий нюанс - пункт "Зберегти налаштування". Якщо вибрати цей пункт, слідом після 
реєстрації ONU запуститься скрипт, який збереже нову конфігурацію. Оскільки це досить
тривалий процес, за наявності великої кількості ONU, то в разі послідовної реєстрації відразу 
декількох ONU варто зберегти конфігурацію лише під час реєстрації останньої ONU. 
При реєстрації GPON ONT так само з'являється пункт "ONU в режимі роутера". Думаю очевидно навіщо
він там потрібен, будьте акуратніше: не кожна ONT підтримує такий функціонал.
===== Не очевидні моменти =====
  - Через обмеження ПОНізатора, якщо у вас на одній OLT і GPON, і EPON, то їх варто вказати в БД як різні OLT зі своїми snmp-шаблонами.
  - Наразі для реєстрації підтримуються ONU на 1 і 4 порти. Якщо вам потрібно більше - звертайтеся, зробимо для потрібної кількості портів, або можете створити потрібні скрипти самі за аналогією зі згаданими нижче скриптами.
  - Дуже важливо розуміти, який саме конфіг заливається на ONU. Ознайомитеся зі скриптами в папці billing/config/scripts/EPON_* і billing/config/scripts/GPON_*, можливо вам їх треба буде виправити під свої реалії.
  - Тестувалося і перевірялося на версії прошивок 1.2.3 для ZTE C220 і 1.2.5/2.1 для C300/C320, V1.2.2 для C610 x8/x16, V1.2.2 для C620 x16. На інших версіях прошивок найімовірніше працювати не буде.
  - Хостнейм у ОЛТ обов'язково має бути ZXAN (дефолтний). Актуально тільки для EPON через специфіку обробки помилок. 
<code>
ZXAN#conf t
Enter configuration commands, one per line.  End with CTRL/Z.
ZXAN(config)#hostname ZXAN
ZXAN#
</code>

Невелика ремарка. Оскільки в мене немає можливості знати за іменами ВЗАГАЛІ всі типи карт, що застосовуються в даних OLT, то ось список, які ми підтримуємо:

ZTE GPON:
<code>
  - GPFA 
  - GPFAE 
  - GTGO 
  - GTGH 
  - GTGHG 
  - GVGH / c610x16
  - GVGO / c610x8
  - GFGL / c620x16
</code>

HUAWEI GPON:
<code>
  - GPBD
  - GPFD
  - GPBH 
  - GPMD
  - H806G 
  - H803G
  - H805G
</code>

EPON:
<code>
  - EPFC 
  - EPFCB 
  - ETGO 
  - ETGOD 
  - ETGH 
  - ETGHG 
  - ETGHK
</code>

Якщо ви не побачили в списку свою улюблену карту - не варто відразу впадати у відчай. 
Наприклад GTGOG - повний аналог GTGO і можете сміливо використовувати його. 
Потрудіться дізнатися, чи є у вашої карти старші брати, цілком можливо, 
що ваша карта буде працювати під личиною її більш старших родичів.
===== Конфігурація OLT =====

==== ZTE ====

У ZTE є неочевидний момент із SNMP... [[http://wiki.ubilling.net.ua/doku.php?id=ponizer&#%D0%BD%D0%B5%D0%BC%D0%BD%D0%BE%D0%B3%D0%BE_%D0%BE_snmp_%D0%BD%D0%B0_olt|якось так]] і далі \\
модуль очікує побачити наступну конфігурацію для EPON:

<code>
epon
  onu-sla-profile profile-name create 1G
  onu-sla-profile profile-set 1G upstream fixed 0 fixedpkt 1500 assured 10000 maximum 1000000 maxburst 1000000 priority 0
  onu-sla-profile profile-set 1G downstream maximum 1000000 maxburst 1000000
pon
  onu-type 1GE epon description 1_ge_port
  onu-type 4GE epon description 4_ge_ports
  onu-type-if 1GE eth_0/1
  onu-type-if 4GE eth_0/1
  onu-type-if 4GE eth_0/2
  onu-type-if 4GE eth_0/3
  onu-type-if 4GE eth_0/4
  uncfg-onu-display-info mac sn model version
</code>

Для GPON:

<code>
gpon
  profile tcont unlim type 4 maximum 1000000
  profile traffic unlim sir 1000000 pir 1000000
pon
  onu-type 1ETH gpon description 1ETH
  onu-type 4ETH gpon description 4ETH
  onu-type-if 1ETH eth_0/1
  onu-type-if 4ETH eth_0/1
  onu-type-if 4ETH eth_0/2
  onu-type-if 4ETH eth_0/3
  onu-type-if 4ETH eth_0/4
  uncfg-onu-display-info mac sn model version
</code>

Ви можете змінити параметри під свої реалії, головне залишити імена профілів і ONU такими ж.

=== ZTE QINQ ===

QINQ у ZTE OLT може працювати у двох режимах. \\
Перший це vlan-smart-qinq, налаштовується приблизно [[http://ngoptics.com.ua/materials/reference_information/konfiguratsiya-qinq-na-zte-s320/|так]]. \\
Для коректної роботи варто вибирати тільки призначення C-VLAN на ONU. \\
\\
Другий варіант - service-port, це коли обидва теги будуть одразу навішуватися на ONU. Такий варіант гнучкіший, але вимагає більше вдумливості. \\
Налаштування гранично просте: досить створити на OLT тільки S-VLAN-и і віддати їх в аплінк.

==== Huawei MA 5600 ====
Важно выставить опцию ONUREG_HUAWEI_NATIVE_VLAN (в alter.ini) равной VLAN-у из строки "gem mapping 1 1 vlan 101" (да вы можете заменить его на тот что вам нужен). \\
Там должен быть VLAN который вы не используете нигде. Дальше магия трансляции вланов сделает из ненужного VLAN-а нужный. \\
\\
Для GPON:

<code>
xpon mode switch-to profile-mode

dba-profile add profile-id 20 profile-name "1G" type4 max 1024000

ont-srvprofile gpon profile-id 100 profile-name "ALL"
 ont-port pots adaptive eth adaptive
 port vlan eth 1 transparent
 commit

ont-lineprofile gpon profile-id 100 profile-name "ONU"
 tcont 4 dba-profile-id 20
 gem add 1 eth tcont 4
 gem mapping 1 1 vlan 101
 commit
 quit
</code>