Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

--- zteonureg [2020/05/19 14:36]
+++ zteonureg [2025/10/07 15:11] (поточний)
pautina [Не очевидні моменти]
@@ Рядок 1: / Рядок 1: @@
+====== Реєстрація 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
+  - EFTL
+  - EFTM
+</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>

Ubilling Wiki

Користувальницькькі налаштування

Налаштування сайту

Розбіжності

Налаштування сторінки