Requisitos previos
Antes de arrancar hay que tener claro:
- Acceso SSH o consola serie a la OLT MA5800 con usuario que tenga permisos de configuración.
- Slot y puerto PON donde está conectado el drop del cliente (ejemplo:
0/3/0= frame 0, board slot 3, port 0). - Serial de la ONU (o mejor, la ONU conectada y encendida para detectarlo automáticamente).
- Line-profile y srv-profile ya creados en la OLT (los crea el que instaló la OLT — si no existen, hay que crearlos primero).
- VLAN del servicio del cliente definida.
Paso 1 — Detectar la ONU (autofind)
Cuando una ONU nueva se conecta a la fibra, la OLT la detecta pero no la registra automáticamente (a menos que esté configurada en modo auto-provisioning, que en producción no se recomienda por seguridad).
Para ver qué ONUs están intentando registrarse:
# Entrar en modo config
enable
config
# Ver ONUs sin autorizar de un puerto PON específico
display ont autofind 0/3/0
# O ver todas las ONUs sin autorizar de la OLT completa
display ont autofind all
Ejemplo de salida:
Number : 1
F/S/P : 0/3/0
Ont SN : 48575443F022B7AB (HWTCF022B7AB)
Password : 0x30303030303030303030 ("0000000000")
Loid : 0000000000
Checkcode :
VendorID : HWTC
Ont Version : G-142W-CA V1.0
Ont SoftwareVersion : V5R022C10SPC100
Ont EquipmentID : EG8145X6
Ont autofind time : 2026-07-20 14:32:15
El campo importante es Ont SN: 48575443F022B7AB. Los primeros 4 caracteres 4857 5443 corresponden al vendor ID (HWTC = Huawei). Los ocho hex restantes (F022B7AB) son el serial único de esa ONU.
La forma corta usada en los comandos siguientes: HWTCF022B7AB.
Paso 2 — Autorizar con ont add
Ahora se agrega la ONU al inventario de la OLT y se le asigna un ONT-ID (número del 0 al 127 dentro de ese puerto PON).
# Entrar al modo de configuración del puerto PON
interface gpon 0/3
# Autorizar la ONU en el ONT-ID 12 (siguiente libre del puerto 0)
ont add 0 12 sn-auth HWTCF022B7AB omci ont-lineprofile-id 10 ont-srvprofile-id 10 desc "Juan Perez - Contrato 245"
Desglose del comando:
0= número del puerto PON dentro del board (el board 3 tiene puertos 0-15)12= ONT-ID asignado (número interno de esa ONU dentro de la PON)sn-auth HWTCF022B7AB= autenticación por serial (la más común)omci= protocolo de gestión (siempre OMCI en instalaciones nuevas)ont-lineprofile-id 10= profile de capacidades (TCONT, GEM ports). Se crea aparte y se reutiliza.ont-srvprofile-id 10= profile de servicios (native VLAN, mapeo Ethernet). Se crea aparte.desc= descripción libre. Siempre poner nombre + contrato — a los 3 meses no vas a acordarte quién es laHWTCF022B7AB.
Si todo va bien, la respuesta es:
Number of ONTs that can be added: 1, success: 1
Paso 3 — Crear el service-port
El ont add registra la ONU en la OLT, pero todavía no hay tráfico pasando. El service-port es lo que asocia la ONU a una VLAN y crea el "cable virtual" que lleva el tráfico entre el cliente y el uplink.
# Salir del modo interface gpon primero
quit
# Crear el service-port con un índice único (típicamente PON*1000 + ONT_ID para evitar choques)
service-port 3012 vlan 100 gpon 0/3/0 ont 12 gemport 1 multi-service user-vlan 100 tag-transform translate
Desglose:
3012= índice único del service-port (convención: PON=3, ONT=12 → 3012)vlan 100= VLAN interna en la OLT (uplink hacia el core)gpon 0/3/0 ont 12= a qué ONU aplicagemport 1= GEM port del line-profileuser-vlan 100 tag-transform translate= la ONU recibe frames sin VLAN, la OLT le pone/quita la 100 automáticamente
Ojo con el índice del service-port: si asignas manualmente el mismo número a dos ONUs distintas, el segundo service-port falla con error de duplicado. Por eso la convención PON*1000+ONT_ID evita choques.
Paso 4 — Verificar que quedó online
# Ver estado de la ONU
display ont info 0 3 0 12
# Salida esperada:
# F/S/P : 0/3/0
# ONT-ID : 12
# Control flag : active
# Run state : online <-- LO IMPORTANTE
# Config state : normal
# Match state : match
# ...
# Rx optical power(dBm) : -22.44
# Tx optical power(dBm) : 2.04
# Ver que el service-port esté up
display service-port port 3012
# Ver tráfico en tiempo real
display port statistics gpon 0/3/0 ont 12
Si Run state = online y Match state = match, la ONU está lista.
Guardar la configuración
Un olvido clásico: si no guardas, con el próximo reinicio de la OLT se pierden todos los cambios.
save
Errores comunes al autorizar
Error: "ONT not exist" al crear el service-port
Significa que el service-port se intentó crear antes de que la ONU terminara de registrarse. Esperar 15-30 segundos después del ont add y reintentar.
Error: "service-port index is being used"
El índice del service-port ya está tomado. Verificar con display service-port all y usar otro número (o adoptar la convención PON*1000+ONT_ID).
ONU aparece online pero cliente no navega
Suele ser problema de VLAN mal mapeada. Verificar:
- La VLAN del service-port coincide con la VLAN del uplink de la OLT.
- El srv-profile tiene mapeada correctamente la native-vlan hacia el puerto Ethernet de la ONU.
- Si el cliente tiene su propio router, ese router debe estar en modo DHCP (obtener IP desde el MikroTik del ISP).
"Ranging failed" después del ont add
Problema físico: señal óptica insuficiente o excesiva. Ver por qué mi ONU se desconecta — mismos criterios de umbral.
Cómo se ve automatizado
Hacer esto manualmente para 20 clientes nuevos por semana es tedioso y propenso a error. Un solo dígito mal en el service-port y el cliente no navega.
En GestionaISP este proceso se ejecuta desde la web: en la ficha del contrato hay un botón "Autorizar ONU". El sistema detecta la ONU en autofind, elige el próximo ONT-ID libre, aplica automáticamente el line-profile y srv-profile correctos según el plan del cliente, genera el service-port con la convención, y verifica que quede online. Todo con auditoría de quién ejecutó qué y cuándo.
El resultado es el mismo (los comandos exactos son los que están arriba), pero sin la fricción de conectarse por SSH, escribir los comandos, y esperar 30 segundos. Y sin errores de tipeo.
El módulo OLT de GestionaISP ejecuta estos comandos por ti con 1 click desde el navegador. Con auditoría, sin errores de tipeo.