22. Importación asistida desde SmartOLT mediante CSV
Instrucciones, comprobaciones y pasos de esta sección del manual.
Ruta: Gestión de Red > OLT > OLTs Configuradas > [nombre OLT] > Importar SmartOLT.
El flujo actual no consulta una API en vivo de SmartOLT. Recibe un Export CSV de SmartOLT, lo compara con el snapshot/autofind de la OLT destino y con los servicios locales, crea una vista previa sin escritura y después encola solo filas consideradas seguras.
Se requiere gestion_red.olt.menu para el módulo y
gestion_red.olt.importar para ver y operar Importar SmartOLT.
22.1 Preparación y advertencias
- Capture un backup de la OLT y exporte ONU, VLAN y perfiles actuales.
- En ONUs, pulse Refrescar desde OLT y espere un snapshot reciente.
- Sincronice VLANs y Perfiles.
- Confirme que la OLT destino, fabricante, board/port y seriales son correctos.
- Exporte el CSV desde SmartOLT sin editar seriales.
- Use un lote piloto antes de un archivo completo.
El archivo debe:
- tener extensión
.csv; - pesar como máximo 20 MB;
- contener como máximo 10.000 ONUs;
- incluir encabezados
SNyName; - contener al menos una fila no vacía.
También se reconocen, cuando existen, SN16, PON MAC, MAC,
IP Address, PON Type, ONU Type, Board, Port, Zone y
Service Port VLAN.
Advertencia crítica: una vista previa correcta no valida por sí sola los comandos del firmware, la VLAN, perfiles ni el presupuesto óptico. La importación puede autorizar ONU y modificar el vínculo del servicio.
22.2 Crear la vista previa
- Abra Importar SmartOLT en la OLT correcta.
- En Export CSV de SmartOLT, seleccione el archivo.
- Configure:
- VLAN predeterminada: una VLAN explícita o Usar CSV/perfil;
- Line profile predeterminado;
- Service profile predeterminado;
- Perfil descarga;
- Perfil subida.
- Pulse Analizar y crear vista previa.
- Espere Analizando CSV y resolviendo coincidencias exactas…
- Confirme Vista previa creada; todavía no se ha escrito en la OLT.
- Revise el Lote, los contadores y todas las filas.
Limitación de la versión actual: las opciones Usar CSV/perfil y Automático / no especificado se guardan internamente como
0, y el job recibe esos ceros. No presuponga que el valor del CSV o un perfil se resolverá después. Para un aprovisionamiento, seleccione explícitamente VLAN y perfiles válidos, o valide en laboratorio que el driver de esa OLT interpreta0de la forma esperada. No inicie el lote si el preview no permite demostrar la configuración efectiva.
La tabla muestra Fila, Nombre, SN CSV / OLT, Cliente/Servicio, Ubicación, Estado y Detalle. Descargue Reporte CSV como evidencia.
Si vuelve a cargar el mismo archivo, la OLT y el SHA-256 identifican el mismo lote; no asuma que se creó una vista previa nueva. Corrija el archivo de origen de forma controlada si necesita un hash y lote distintos.
22.3 Cómo se resuelven y clasifican las filas
La ONU debe aparecer en el snapshot/autofind de la OLT destino. La resolución
usa serial, SN16, PON MAC y, para el servicio, vínculo ONU, MAC, IPv4 y nombre.
Un nombre aproximado solo se asigna automáticamente cuando alcanza al menos
85 %, aventaja por 10 puntos al siguiente candidato, identifica un único
servicio y ambos nombres tienen al menos dos palabras. Sugerencias desde 70 %
que no cumplen esos requisitos quedan para revisión.
Estados relevantes:
ready_register: ONU en autofind/Unconfigured, lista para registrar;ready_link: ONU ya autorizada, se vinculará sinont add;already_linked: ya vinculada correctamente; no se encola;ambiguous: nombre o evidencia no identifica un único servicio;conflict: ONU/servicio duplicado, ya ocupado o evidencias contradictorias;onu_not_found: no aparece en snapshot/autofind;no_service: no se encontró servicio suficientemente claro;invalid: faltan SN o nombre;queued,running,completed,failedocancelled: estados de ejecución.
No fuerce filas en revisión editando nombres hasta que “parezcan” coincidir. Corrija primero inventario, snapshot o servicio y genere una vista previa trazable.
22.4 Iniciar y seguir el progreso
- Filtre el reporte y valide cada
ready_registeryready_link. - Confirme VLAN y perfiles contra la OLT.
- Pulse Aprovisionar filas seguras.
- En Iniciar aprovisionamiento, lea Solo se encolarán filas seguras. ¿Iniciar aprovisionamiento?
- Pulse Iniciar.
- Espere Importación enviada al worker OLT.
- Observe la barra y los contadores:
- Total;
- Listas;
- En curso;
- Completadas;
- Fallidas;
- Revisión.
- La pantalla consulta el lote aproximadamente cada tres segundos mientras está en cola o ejecución.
- Abra Jobs/Eventos > Cola de Jobs y correlacione el job
onu_registerde cada fila. Revise estado, porcentaje, mensaje y error. - No cierre la intervención hasta llegar a
completed,completed_with_errorsocancelledy validar las ONU.
Cada fila segura crea un job OLT independiente. Para ready_register se
aprovisiona; para ready_link se relaciona la ONU ya autorizada. El lote guarda
administrador, archivo, SHA-256, opciones, intentos y job por fila.
22.5 Reintentar y cancelar
Reintentar fallidas:
- abra la fila y su job;
- corrija causa, credenciales, perfiles, VLAN, snapshot o conectividad;
- pulse Reintentar fallidas una sola vez;
- confirme que solo las filas
failedvuelven a cola; - supervise el nuevo intento y descargue otro Reporte CSV.
No use reintento como sondeo. Cada intento incrementa el contador y puede repetir comandos parcialmente aplicados si el driver no es idempotente.
Cancelar pendientes:
- pulse Cancelar pendientes;
- lea Se cancelarán únicamente jobs aún pendientes. Lo ya ejecutado no se revierte. ¿Continuar?
- pulse Cancelar pendientes;
- confirme Jobs pendientes cancelados.
Si evalúas el producto, no solo la guía: abre la página comercial de Gestión FTTH y OLT.