Розбіжності

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

--- zteonureg [2019/02/27 12:40]
+++ zteonureg [2023/06/16 12:26]
skybetik [Как включить?]
@@ Рядок 1: / Рядок 1: @@
+====== Реєстрація ONU/ONT на ZTE/Huawei OLT ======
+[[http://ubilling.net.ua/?module=fnpages&pid=lightpay|{{ :buy-100.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>

Ubilling Wiki

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

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

Розбіжності

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