Esta documentación trata del servicio externo SmartOLT. El servicio externo se accede vía API. Las funcionalidades aquí descritas indican las capacidades y los requisitos de integración, así como el cuestionario y las funcionalidades relacionadas.
Tipo de Integración
La integración OZmap-SmartOLT es del tipo Activa.
Descripción
SmartOLT es una herramienta de software para la gestión de OLT y ONU. La adición, eliminación, provisión, gestión y monitoreo de las ONUs están entre las principales funcionalidades de este sistema.
Las funcionalidades de integración entre OZmap y SmartOLT se basan en la lectura de potencias y estado de ONUs en el SmartOLT para actualizar estos datos en los clientes de OZmap, además de la activación de los clientes no implantados en el OZmap. La integración se encuentra con las ONUs SmartOLT en OZmap a través de la serie (“sn” en SmartOLt debe ser igual a la “serial” del cliente en OZmap para que se encuentre y actualice).
Resumen de funcionalidades
Funcionalidades | Descripción | Dirección de la integración |
---|---|---|
Actualización de estado | Actualización del valor de estado del cliente en OZmap basado en la lectura informada por SmartOLT. | SmartOLT => OZmap |
Actualización de potencia | Actualización del valor de potencia leída en OZmap basado en la lectura informada por SmartOLT. | SmartOLT => OZmap |
Implantación de clientes | Activación (implantación) del cliente en OZmap al reconocer una potencia válida leída por SmartOLT. | SmartOLT => OZmap |
Funcionalidades
A continuación se describen las funcionalidades presentadas en el resumen para comprender cómo funciona el flujo de sincronización.
Actualización de estados
Actualización del valor de estado del cliente en OZmap basado en la lectura informada por SmartOLT. El campo “estado” se actualiza en OZmap siguiendo las reglas de abajo.
Se leen los valores de estado de todas las ONUs que se encuentran en SmartOLT.
Para cada ONU, buscamos en OZmap a un cliente que posea la ONU con número de serie similar.
Si se encuentra, y el valor presente en OZmap es diferente del valor aportado por SmartOLT, se actualiza el campo de OZmap. El valor de estado sigue el siguiente estándar:
Estado SmartOLT | Estado OZmap |
---|---|
Online | OK (0) |
Offline | ERROR (1) |
Power fail | ERROR (1) |
LOS | ERROR (1) |
Actualización de potencia
Actualización del valor de potencia leída en OZmap basado en la lectura informada por SmartOLT. El campo “Potencia leída” se actualiza en OZmap siguiendo las reglas de abajo.
Se leen los valores de potencia (atributo signal_1310) de todas las ONU encontradas en el SmartOLT
Para cada ONU, buscamos en OZmap a un cliente que posea la ONU con número de serie similar.
Si se encuentra, el campo de "Potencia leída" del cliente en OZmap se actualizará con el valor de potencia leído en la ONU en el SmartOLT, siempre y cuando se cumpla la siguiente condición:
La potencia leída de la ONU en el SmartOLT debe tener un valor con una diferencia mayor que 0,5dBm (potencia 0,5 mejor o 0,5 peor) con respecto al valor del campo “Potencia leída” del cliente en OZmap para que se actualice.
Implantación de clientes
Actualización del estado de implantación del cliente en OZmap basado en la lectura de potencia informada por SmartOLT.
Se leen los valores de potencia de todas las ONUs encontradas en SmartOLT..
Para cada ONU con potencia válida (es decir, que posean potencia de valor numérico diferente de 0), buscamos en OZmap a un cliente que posea la ONU con número de serie similar.
En caso de que se encuentre, y el cliente esté con el estado de implantación "No implantado" en OZmap, el campo se actualizará a "Implantado".
Configuraciones Base
Parámetro | Descripción | Estándar |
---|---|---|
Tiempo entre sincronizaciones | Tiempo esperado entre las sincronizaciones realizadas por la integración | 15 minutos |
Configuraciones Específicas
Parámetro | Descripción | Estándar |
---|---|---|
Límite de cambio de potencia | Limite mínimo de cambio de potencia en SmartOLT para que se actualice la potencia leída por el cliente en OZmap. | 0.5 |
Datos Acceso
No posee cuestionario.
SmartOLT
Datos de acceso necesarios para buscar información vía API en el sistema SmartOLT. (Estos datos deben incluirse en el cuestionario inicial)
Parámetro | Descripción | Ejemplo |
---|---|---|
URL | Dirección del servidor SmartOLT. | |
Clave API | Clave API para acceso al SmartOLT. | - |
OZmap
Parámetro | Descripción | Ejemplo |
---|---|---|
Token | Token asociado a la cuenta de usuario de integración registrado en OZmap. (El usuario debe tener acceso a los proyectos que la integración va a trabajar (Elección del usuario). Tutorial de cómo generar usuario/chave.) | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE |
Liberación de IPs
Para la validación y ejecución de la integración en el entorno de producción, es necesario que se liberen en el servidor del cliente los IPs utilizados por OZmap:
Servidor OZmap del cliente (ping cliente.ozmap.com.br)
54.207.162.199
También se hace necesaria la liberación de los mismos IPs arriba en el propio SmartOLT, que se puede hacer de esta forma:
En la pantalla de inicio, seleccione “Settings”.
En la pestaña “General”, seleccione “Edit general settings”.
Agregar las IPs en el campo “IPs allowed to access SMARTOLT” (por ejemplo: 54.207.162.199, 10.10.10.10) y guardar (botón “Save”):
Logs
Los logs de integración están disponibles en la dirección:
https://cliente.ozmap.com.br/integrations/smartolt/logs
Cuestionario
Pregunta | Respuesta | Funcionalidad |
---|---|---|
¿Es posible utilizar solo algunas de las funcionalidades anteriores? | No, en este momento aún no es posible elegir sólo una o más de las funcionalidades descritas. | - |
¿Es posible cambiar el estado del cliente en OZmap en función de la potencia recibida de SmartOLT? | No, en este momento la actualización de estado en OZmap se produce sólo por el valor de estado leído en SmartOLT. | - |
¿Es posible integrar más de una SmartOLT con un mismo OZmap? | No, por el momento no es posible, pero el cliente puede realizar esa solicitud con el CS para evaluar la viabilidad para que la integración funcione así. | - |
¿Es posible reducir el intervalo de tiempo entre sincronizaciones? | Sí, es posible reducir el intervalo, pero no recomendamos menos de 10 minutos, ya que esto puede aumentar el consumo de recursos de la máquina y afectar el rendimiento de OZmap. |
//Anotar las preguntas y posibles respuestas y cuáles son las funcionalidades relacionadas con las Respuestas.
0 Comments