Manual de FiberControl

FiberControl conecta PlenoAgent con las OLT de tu red de fibra. Lee el inventario de ONU y su señal óptica, autoriza ONU nuevas con la configuración del abonado, aplica suspensiones y reactivaciones desde facturación y te deja cambiar el WiFi del cliente sin ir a su casa. Cada cambio en la OLT pasa por una cola con reintentos, se verifica leyendo la OLT después de escribir y queda en la auditoría.

En la pestaña OLT, el botón Agregar OLT abre el asistente de configuración. El asistente trabaja en cinco pasos y no guarda nada en la OLT hasta el último.

1. Conectar. Elige el Fabricante y escribe el nombre, el host privado (la IP de gestión de la OLT dentro de tu red), el puerto, el transporte, el usuario y la contraseña. Usa Detectar modelo: PlenoAgent entra a la OLT por el transporte elegido, identifica el equipo y el firmware y confirma que las credenciales funcionan. También puedes elegir el modelo de la lista de compatibles: al hacerlo, el transporte y el puerto se ajustan solos a lo que ese modelo usa (por ejemplo, Telnet y puerto 23 en las V-SOL de firmware antiguo; ver 2.3).

2. Leer la OLT. PlenoAgent lee la OLT una sola vez: confirma la conexión, lista las ONU y toma un respaldo de la configuración. Los pasos siguientes trabajan sobre ese respaldo, sin volver a tocar la OLT.

3. Red. Define la VLAN por la que la OLT lleva el tráfico de los abonados, la puerta de enlace y la máscara que recibe cada ONU. Con Desde un router de facturación eliges el router del que cuelga la OLT, lees sus subredes y al elegir una se completan solos estos datos. Aquí también eliges o creas el perfil de línea, el perfil DBA y, si quieres, un tope de velocidad para toda la OLT.

4. Modelos de ONU. Cada modelo de ONU lleva un perfil de servicio y los puertos LAN que enruta. Un perfil adaptable sirve para todos los modelos y evita el aviso de perfil incompatible. Marca solo los puertos que el modelo realmente tiene.

5. Revisar. Ves exactamente lo que PlenoAgent creará en la OLT. Al pulsar Aplicar, toma un respaldo nuevo, crea solo lo que falta, lo verifica y guarda la plantilla de servicio de la OLT.

2.1Lo que PlenoAgent no toca

Los perfiles que ya existían en la OLT son tuyos y se muestran como Externo · solo lectura. PlenoAgent solo crea y administra objetos con nombre PLENO_*, nunca modifica una configuración del operador y detiene la preparación si un ID que necesita ya está ocupado por otra definición: verás el conflicto y podrás elegir otro ID.

2.2Modelo no identificado

Si tu OLT no está en la lista de compatibles, o la detección no la reconoce, puedes registrarla igual como Modelo no identificado — todavía sin driver. Queda guardada sin sondearse ni escribirse y en la lista aparece como Esperando driver. Probar sigue disponible para confirmar que PlenoAgent llega a ella.

2.3V-SOL: por qué se conecta por Telnet

Muchas OLT V-SOL de firmware antiguo (V2.1 y V2.2) no liberan las sesiones SSH: cada conexión deja una sesión ocupada aunque se cierre bien, hasta que la tabla se llena. A partir de ahí la OLT acepta el usuario y la contraseña, pero se niega a abrir la sesión, y nadie (ni PlenoAgent ni tus técnicos) puede entrar por SSH hasta que esas sesiones se liberan, lo que en algunos equipos solo ocurre con un reinicio. Por Telnet, en cambio, la línea se libera al cerrar sesión.

Por eso esos modelos usan Telnet y el puerto 23 por defecto. Telnet viaja dentro de tu túnel VPN privado, nunca por internet. Si en tu OLT prefieres SSH, puedes cambiar el transporte en la edición de la OLT: es una opción por OLT.

El botón Manual de usuario de la cabecera abre este manual en el idioma activo.

4.1Qué se lee y cada cuánto

Con Monitoreo activo encendido en la OLT, PlenoAgent registra la señal óptica de las ONU cada 5 minutos y hace un inventario completo (ONU nuevas, ausentes, modelo, puerto PON, distancia y MAC del equipo del cliente) cada 15 minutos. Al desactivarlo se detienen ambas lecturas; al reactivarlo se ejecutan de inmediato una prueba de conexión y un inventario.

Los botones de la fila de la OLT fuerzan una lectura sin esperar: Probar abre una sesión de gestión y confirma red, credenciales y CLI; Sincronizar pone en cola un inventario.

4.2Calidad de señal

El detalle de cada ONU tiene el historial de señal (RX y TX) en 24 horas, 7 días o 30 días. Los huecos en la gráfica son periodos sin lectura, no señal cero. Algunas OLT no pueden leer la potencia de una ONU antes de autorizarla; en ese caso se conservan las muestras históricas.

4.3Monitoreo de la OLT

El botón Monitorear abre la telemetría óptica de cada puerto PON físico: potencia TX, temperatura, voltaje y bias TX en el tiempo. Sirve para detectar un módulo SFP que se degrada antes de que los abonados lo noten.

4.4Alarmas

La cola de alarmas del Resumen se puede buscar y filtrar por estado y severidad. Una alarma Abierta pasa a Reconocida con Reconocer, para que el equipo sepa que alguien la está atendiendo, y a Resuelta sola cuando la causa desaparece. Por ejemplo, Perfil de ONU incompatible se abre cuando el inventario ve una ONU cuyas capacidades físicas no coinciden con su perfil de servicio, y se resuelve en el inventario siguiente a la corrección.

Busca por serial, cliente o modelo. Filtros acota por OLT, slot, PON, estado operativo, estado de registro, vínculo y rango de señal; las ONU sin lectura se excluyen cuando pones un límite de señal. Cada fila muestra hasta cuatro indicadores:

• Estado operativo: en línea, fuera de línea, apagado inesperado (dying gasp, la ONU avisó que se quedó sin energía) o desconocido.
• Vínculo / sincronización con la suscripción (tabla de abajo).
• Perfil incompatible: la ONU está en línea, pero sus puertos no coinciden con el perfil de servicio asignado.
• WiFi: si la gestión WiFi está activándose, activa o falló en esa ONU.

El botón ONUs no autorizadas cuenta las ONU que la OLT ve conectadas pero que nadie autorizó todavía: son las instalaciones nuevas esperando alta.

Abre una ONU no autorizada desde la lista (el botón ONUs no autorizadas las filtra). Hay dos formas de darla de alta, y la diferencia está en quién configura la conexión del abonado:

6.1IP fija o PPPoE desde la OLT (Autorizar para suscripción)

Así el técnico llega, conecta la ONU y se va: la IP, el gateway y los DNS (o el usuario y la contraseña PPPoE) viajan desde la OLT a la ONU. Antes de empezar, revisa tres cosas:

• La suscripción tiene sus datos de conexión. En Facturación, en el editor de la suscripción, el Tipo de Conexión debe ser IP fija con su IP asignada, o PPPoE con Usuario PPPoE y Contraseña PPPoE.
• La OLT tiene plantilla de servicio con máscara, gateway, DNS, VLAN, puertos LAN ruteados y un service profile para el modelo de esta ONU (ver sección 7).
• El driver de la OLT tiene certificada la escritura de IP fija o de PPPoE. Si no, el formulario lo dice y no deja continuar.

1. En el detalle de la ONU, pulsa Autorizar para suscripción.

2. Busca y elige la suscripción. Solo se ofrecen las que tienen IP fija o cuenta PPPoE y todavía no están vinculadas a otra ONU.

3. Revisa Lo que recibirá la OLT. Con IP fija: la dirección con su máscara, el gateway y los DNS. Con PPPoE: el usuario de la suscripción (la contraseña sale de la suscripción y no se muestra). En ambos casos: VLAN, puertos LAN ruteados, line profile, service profile según el modelo y traffic tables.

4. Pulsa Autorizar. El trabajo entra en la cola; la suscripción queda vinculada recién cuando la OLT confirma el servicio. Si algo falla a mitad de camino, PlenoAgent deshace lo que alcanzó a escribir y el error aparece en Aprovisionamiento.

6.2Autorizar con perfiles (bridge)

Autorizar registra la ONU con el line profile y el service profile que elijas. Si hay ONU comparables ya autorizadas, PlenoAgent propone sus mismos perfiles. Para crear también la VLAN de Internet y el service-port, activa Provisionar Internet después de autorizar e indica la VLAN y los perfiles de tráfico de subida y bajada. Sin esa opción, la ONU queda registrada pero sin servicio. En este modo la ONU queda en bridge: la IP fija o el PPPoE los configura el router del cliente, y la ONU se vincula a la suscripción por separado (sección 8).

6.3Operar una ONU autorizada

• Cambiar perfiles reasigna line y service profile. Puede cortar el servicio unos segundos: FiberControl toma antes un respaldo, verifica la asignación nueva e intenta restaurar los perfiles anteriores si la verificación falla.
• Reiniciar reinicia la ONU desde la OLT.
• Desautorizar la elimina de la OLT. Es destructivo y corta el servicio, por eso pide confirmación.
• Sincronizar comentario escribe en la OLT el comentario esperado del cliente cuando no coincide con el que tiene la ONU.

Mientras una operación está en curso, el detalle y la lista muestran Autorizando… o Cambiando perfiles… y los botones se ocultan para que no se encolen dos cambios sobre la misma ONU.

En Perfiles eliges una OLT y ves sus perfiles DBA, de línea, de servicio y de tráfico. Con Importar perfiles PlenoAgent los vuelve a leer de la OLT; si la OLT está ocupada con otra operación, la importación se hace en cuanto se libere y la lista se actualiza sola.

La Plantilla de servicio define cómo se da de alta un abonado en esa OLT: VLAN, máscara, gateway, DNS, puertos LAN en modo ruteo, line profile y un service profile por modelo de ONU. La IP sale de la suscripción; todo lo demás sale de la plantilla.

1. Abre Plantilla de servicio y usa Proponer desde el último backup: PlenoAgent lee cómo están configuradas las ONU que ya existen en la OLT, sin conectarse a ella, y te dice cuántas siguen esa receta.

2. Revisa los campos y agrega un service profile para cada modelo de ONU que instalas, escrito tal como lo reporta la OLT. Una ONU de un modelo que no esté en la lista no se puede autorizar para una suscripción.

3. Guarda. Desde ese momento aparece Autorizar para suscripción en las ONU no autorizadas de esa OLT.

En la vista de perfiles de tráfico, Asignaciones de planes de facturación muestra la velocidad deseada de cada plan frente a la tabla de tráfico observada en la OLT y su estado de sincronización.

El vínculo ONU ↔ suscripción es lo que permite que facturación actúe sobre la OLT: saber qué ONU es de qué cliente, suspenderla por mora y reactivarla al pagar. Si autorizaste la ONU con Autorizar para suscripción, el vínculo ya se creó solo. Si no, hay dos formas:

• Desde el detalle de la ONU, en el bloque Suscripción: pulsa el lápiz, busca la suscripción y pulsa Vincular suscripción. Es un vínculo rápido: identifica al cliente, pero la suspensión la sigue haciendo RouterOS y FiberControl no controla la velocidad.
• Desde el editor de la suscripción en Facturación, en el bloque Acceso de fibra, donde además eliges quién controla cada cosa.

En el editor:

1. Activa Administrar acceso con FiberControl.

2. Elige la OLT y la ONU. El buscador acepta serial, descripción, puerto PON o MAC y solo ofrece ONU libres. La VLAN de Internet viene de la plantilla de la OLT y no se cambia por suscripción.

3. Decide quién es la autoridad de cada responsabilidad (tabla de abajo) y guarda la suscripción.

8.1Qué pasa al suspender y al reactivar

1. La suscripción cambia de estado: el ciclo de cobro la suspende por mora, alguien la bloquea a mano, o un pago, una prórroga o un ajuste de saldo la reactiva.

2. Si el Control de suspensión es FiberControl, PlenoAgent pone en cola el cambio para la OLT: suspende el servicio de esa ONU sin desautorizarla (el abonado no pierde su configuración) o lo restablece. El router deja al cliente activo, para que el corte lo haga solo la OLT.

3. El movimiento queda en el Historial de Suscripción (filtro Servicio) como Servicio suspendido o Servicio reactivado, con canal FiberControl y estado Pendiente, Aplicado o Fallido.

4. Si la OLT no responde (túnel caído, OLT ocupada), el trabajo se reintenta solo. Si queda Fallido, el motivo está en Aprovisionamiento; corrige la causa y usa Reintentar. Si el módulo FiberControl no está activo, el movimiento queda Fallido de inmediato: activa el módulo o cambia la autoridad a RouterOS.

Si el Control de ancho de banda es FiberControl, la cola del router se crea sin las velocidades del plan y la velocidad la aplica la OLT con su tabla de tráfico (ver Asignaciones de planes de facturación en la sección 7). Cancelar una suscripción no desautoriza la ONU: si ya no se va a usar, desautorízala desde FiberControl.

Permite ver y cambiar el nombre y la contraseña del WiFi de cada abonado desde PlenoAgent. La OLT le indica a cada ONU dónde está tu ACS (el servidor TR-069), que es exclusivo de tu empresa y solo escucha dentro de tu túnel VPN: nada queda expuesto a internet. El botón WiFi aparece en la fila de la OLT cuando su driver lo permite.

9.1Activar en la OLT

1. Perfiles de línea. Una ONU solo acepta un ACS si su perfil de línea tiene TR-069 activado. Para cada perfil de línea que uses, elige su copia con TR-069 activado (PlenoAgent propone la que encuentra). Si no hay ninguna, créala en la OLT y vuelve a importar los perfiles. Antes de escribir, PlenoAgent compara ambos perfiles en la OLT y rechaza una copia que cambiaría el servicio del abonado.

2. Regla en el router. Las ONU llegan al ACS pasando por tu MikroTik, que debe permitir TCP 7547 hacia el ACS. Con Que Pleno agregue la regla, PlenoAgent escribe la regla pleno-acs debajo de la de suspensión, así los suspendidos siguen cortados. Si prefieres hacerlo tú, copia la regla que se muestra.

3. Pulsa Activar en esta OLT. Tarda alrededor de un minuto.

4. Activa la gestión en las ONU: todas a la vez con Activar en N ONU, o una por una desde su detalle. Cada ONU se reconecta unos segundos al pasar a su perfil TR-069. Las ONU nuevas autorizadas con WAN enrutada la reciben automáticamente.

9.2Cambiar el WiFi de un abonado

En el detalle de la ONU, la sección WiFi muestra cada red con su nombre, seguridad, si está encendida y cuántos dispositivos tiene conectados. Edita el nombre (1 a 32 caracteres) o la contraseña (8 a 63 caracteres, sin tildes; vacía para conservarla) y pulsa Guardar WiFi. Los dispositivos conectados se desconectan y deben volver a entrar con los datos nuevos.

Si la ONU no responde en el momento, el cambio queda en Esperando a la ONU y se aplica cuando vuelva a reportarse, normalmente en menos de cinco minutos. Puedes cancelarlo mientras está pendiente. Leer de nuevo vuelve a pedirle los datos a la ONU.

9.3Cuando no funciona

Empieza siempre por el detalle de la ONU: la sección WiFi muestra el diagnóstico de esa ONU y, si un intento falló, el error exacto. Los casos más comunes:

Si falla la activación

• En la OLT: la ventana del WiFi de la OLT muestra cuándo falló el último intento y por qué. Lo más común: una copia de perfil de línea que no coincide con su original o no tiene TR-069 activado (corrige la asignación), o un perfil de servidor PLENO_ACS que ya existía en la OLT con otros datos y está en uso.
• En una ONU: el detalle muestra el error y el botón Intentar de nuevo. Las causas típicas: la ONU está en bridge (no tiene WAN enrutada), su perfil de línea no tiene copia TR-069 asignada en el WiFi de la OLT, o la OLT no confirmó el cambio; en ese último caso la ONU queda como estaba.

Para volver atrás en una ONU, usa Desactivar gestión WiFi: regresa a su perfil de línea anterior, se reconecta unos segundos y conserva el nombre y la contraseña del WiFi que tenía.

Todo cambio en una OLT es un trabajo de la cola de Aprovisionamiento. FiberControl ejecuta una sola operación a la vez en cada OLT, porque las OLT tienen pocas sesiones de gestión y una sesión de más puede bloquear a tus técnicos.

Los reintentos son seguros: repetir una autorización o una suspensión que ya se aplicó no duplica nada.

En Respaldos, Crear respaldo guarda la configuración completa de una OLT con su checksum. PlenoAgent también toma un respaldo automático antes de preparar una OLT o cambiar perfiles. La Auditoría registra cada operación en la OLT con su actor (un usuario o el sistema), resultado y código de error.

«No se puede alcanzar la OLT desde la red privada»

Revisa en NetAdmin que el túnel VPN esté conectado, que el host privado sea el correcto y que el router enrute hacia la red de gestión de la OLT.

«La OLT rechazó las credenciales guardadas»

Edita la OLT y vuelve a escribir usuario y contraseña. Dejar la contraseña vacía conserva la anterior.

«La OLT no tiene sesiones de gestión libres» o cierra la conexión antes de autenticar

La OLT llegó a su límite de sesiones CLI. Cierra las sesiones abiertas (PuTTY, la interfaz web de la OLT, otro sistema de gestión) o espera a que expiren, y vuelve a intentar. Algunas OLT no liberan sesiones colgadas hasta su tiempo de espera.

Una ONU nueva no aparece

Usa Sincronizar en la OLT y revisa el filtro de ONUs no autorizadas. Si la OLT tiene el monitoreo desactivado, no se hace inventario automático.

No aparece «Autorizar para suscripción»

La OLT no tiene plantilla de servicio. Configúrala en Perfiles.

La ONU marca «Perfil incompatible»

Su modelo tiene otros puertos que los del service profile asignado. Usa un perfil adaptable o el perfil correcto para ese modelo con Cambiar perfiles.

Un trabajo quedó en «Fallida»

Lee el error en Aprovisionamiento. Si dice que la OLT está ocupada o fuera de alcance, reintenta cuando se recupere; si es un conflicto de configuración, corrígelo antes de reintentar.

El WiFi no se aplica

El detalle de la ONU explica la causa. La tabla completa de mensajes y qué hacer está en el apartado 9.3.

Conectando una V-SOL: «The OLT refused the connection on this port»

Telnet no está permitido en la lista de acceso de la OLT, o el puerto 23 está filtrado. Ver el apartado 2.3.

Una suspensión no cortó al cliente

Abre el Historial de Suscripción y revisa el movimiento: canal y estado te dicen quién debía cortar y si lo logró. Si el canal es FiberControl y está Fallido, el motivo está en Aprovisionamiento.

Mi modelo de OLT no aparece en la lista

Regístrala como modelo no identificado y escríbenos: construimos el driver con tu equipo (apartado 2.2).