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

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


zteonureg

Розбіжності

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

Посилання на цей список змін

Порівняння попередніх версій Попередня ревізія
Попередня ревізія
zteonureg [2019/11/19 16:34]
zteonureg [2023/07/29 13:36] (поточний)
nightfly [Що варто очікувати від модуля?]
Рядок 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
 +</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>