...
| Table of Contents | ||||
|---|---|---|---|---|
|
Tipo de Integração
A integração OZmap-INT6 é do tipo Híbrida.
Descrição
O INT6 é um sistema de monitoramento e provisionamento de equipamentos GPON, bem com suporte para redes neutras.
...
OBS: “gpon_client_id“ no INT6 deve ser igual ao “código” do cliente no OZmap para ser encontrado e tratado pelos dois lados da integração. Atualmente esse deve ser um valor numérico.
Resumo das funcionalidades - Serviço de integração OZmap
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Atualização de Status de Conexão dos Clientes OZmap | O status dos clientes OZmap é atualizado conforme a leitura de potência verificada no INT6. | INT6 => OZmap |
Atualização de Potência dos Clientes OZmap | A potência dos clientes OZmap é atualizada conforme a leitura de potência verificada no INT6. | INT6 => OZmap |
Atualização de Estado de Implantação dos Clientes OZmap | O estado de implantação dos clientes OZmap é atualizado conforme a leitura de potência verificada no INT6. | INT6 => OZmap |
Atualização dos Dados da ONU OZmap | Os dados da ONU OZmap são atualizados conforme a leitura dos dados da ONU no INT6. | INT6 => OZmap |
Resumo das funcionalidades - Serviço de integração INT6
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Consulta de Potência do Cliente OZmap | A INT6 busca no OZmap a potência calculada de um cliente. | OZmap => INT6 |
Consultar CTOs OZmap Disponíveis para Provisionamento | A INT6 realiza busca de CTOs OZmap próximas do cliente OZmap e disponibiliza para provisionamento. | OZmap => INT6 |
Ativação e Atualização dos Dados do Cliente no OZmap | A INT6 atualiza no OZmap os dados de splitter, porta, coordenada e estado de implantação do cliente com base no que foi escolhido para provisionamento no INT6. | INT6 => OZmap |
Criar Cliente no OZmap | A INT6 verifica se o cliente existe no OZmap, se não existir, ele é criado com as informações de splitter e porta escolhidos no provisionamento. | INT6 => OZmap |
Serviço de integração OZmap
Funcionalidades OZmap
Abaixo serão descritas as funcionalidades do OZmap, apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.
Atualização de Status de Conexão dos Clientes OZmap
Sincronização dos status de conexão dos clientes INT6 existentes no OZmap:
...
Valor Potência INT6 | Status Conexão OZmap |
|---|---|
0 | ERROR |
0.1, 1, 1.5 … | OK |
-0.5, -1, -1.5 … | OK |
Atualização de Potência dos Clientes OZmap
Sincronização de potência dos clientes INT6 existentes no OZmap:
São lidos todos os clientes OZmap;
Para cada cliente OZmap que possui um código numérico, é buscado um cliente com “gpon_client_id” igual no INT6;
Para cada cliente OZmap encontrado no INT6 que possua algum valor de potência, é feito o seguinte tratamento:
Se a potência do cliente no INT6 divergir da potência no cliente OZmap, é atualizado o campo de potência lida da ONU no OZmap com o valor encontrado no INT6;
Atualização do Estado de Implantação dos Clientes OZmap
Sincronização dos status de conexão dos clientes INT6 existentes no OZmap:
São lidos todos os clientes OZmap;
Para cada cliente OZmap que possui um código numérico, é buscado um cliente com “gpon_client_id” igual no INT6;
Para cada cliente OZmap encontrado no INT6 que possua algum valor de potência, é feito o seguinte tratamento:
Se a nova potência for um valor numérico positivo ou negativo, e o cliente estiver como “não implantado” no OZmap, o estado de implantação dele é mudado para “implantado” no OZmap.
Atualização dos Dados da ONU OZmap
Atualização dos dados da ONU OZmap com base na leitura da ONU do INT6:
São lidos todos os clientes OZmap;
Para cada cliente OZmap que possui um código numérico, é buscado um cliente com “gpon_client_id” igual no INT6;
Para cada cliente OZmap encontrado no INT6 que possua algum valor de potência, é feito o seguinte tratamento:
É verificado se há divergência entre os dados de serial number, user pppoe e mac address no OZmap e no INT6, e havendo divergência, os dados da ONU no OZmap são atualizados com as informaçoes encontradas no INT6;
Nessa atualização de dados, é possível habilitar a configuração de utilizar no OZmap o short serial number do INT6, ao invés do serial number completo;
Configurações Base OZmap
Parâmetro | Descrição | Padrão | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tempo entre Sincronizações | Tempo aguardado entre as sincronizações realizadas pela integração. |
|
Configurações Específicas OZmap - ONUs
Parâmetro | Descrição | Padrão |
|---|---|---|
Atualizar os Dados da ONU no OZmap | Se o serial number, user pppoe ou mac de uma ONU no OZmap divergir do INT6, são atualizados os dados da ONU no OZmap, com base nos dados lidos do INT6. | Desativado. |
Utilizar o Short Serial Number na ONU OZmap | Na ONU OZmap, pode ser utilizado o short serial number ao invés do serial number completo, lido da ONU INT6. Essa funcionalidade só pode ser ativa, caso a funcionalidade de atualizar os dados da ONU também estiver ativa. | Desativado. |
Dados Acesso - Serviço de integração OZmap
https://docs.google.com/forms/d/1Ma6wF8XOaeKOSetxfbcR0Qkv6N4iJ4CAraxyyZpj2-0/edit
INT6
Dados de acesso necessários para buscar informações via API no sistema INT6. (Estes dados devem ser fornecidos no questionário inicial)
Parâmetro | Descrição | Exemplo |
|---|---|---|
URL | URL do servidor que contém o serviço externo para conexão. | |
Email provido pelo cliente para acessar o serviço. | ||
Token | Token provido pelo cliente para acessar o serviço. | aMshEhZtyK-7AyQTZM5v |
OZmap
| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Liberação de IPs
Para validação e execução da integração no ambiente de produção, é necessário serem liberados no servidor do cliente os IPs utilizados pelo OZmap:
Servidor OZmap do cliente (ping cliente.ozmap.com.br)
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
Logs - Serviço de integração OZmap
No momento a integração INT6 não possui logs.
Serviço de integração INT6
Funcionalidades INT6
Abaixo serão descritas as funcionalidades do INT6, apresentadas no resumo para entender como funciona o fluxo das funcionalidades.
Consulta de Potência Calculada do Cliente OZmap
A consulta de informações de potência do cliente OZmap é realizado na seguinte forma:
No momento do provisionamento, INT6 busca no OZmap as informações de potência calculada, slot, pon e olt do cliente;
Essa potência calculada do OZmap é comparada com a potência lida da ONU no INT6, e caso a diferença seja maior que o limite definido no INT6, essa ativação não é autorizada;
Consultar CTOs OZmap Disponíveis para Provisionamento
A consulta das CTOs OZmap disponíveis para realizar provisionamento, é dado da seguinte forma:
A partir da coordenada do cliente no INT6, é feito uma consulta no OZmap por splitters de CTOs e condomínios próximos ao cliente no OZmap;
Uma lista de splitters OZmap disponíveis é exibida para ser escolhido para realizar provisionamento da ONU no INT6;
Ativação e Atualização dos Dados do Cliente no OZmap
A atualização de dados dos clientes no OZmap, é feito da seguinte forma:
No momento do provisionamento, é buscado um cliente no OZmap com código igual ao “gpon_client_id” da ONU no INT6;
Se o cliente for encontrado no OZmap, os dados de CTO, splitter, porta e coordenada são atualizados no OZmap com base nos dados definidos na hora do provisionamento no INT6;
Caso o estado de implantação do cliente esteja como “não implantado” no OZmap, é atualizado para “implantado”;
Criar Cliente no OZmap
A criação de clientes no OZmap, é dada da seguinte forma:
No momento do provisionamento, é buscado um cliente no OZmap com código igual ao “gpon_client_id” da ONU no INT6;
Se o cliente não for encontrado no OZmap, é feita a criação de um novo cliente no OZmap, com os dados de CTO, splitter, porta e coordenadas definidos na hora do provisionamento no INT6;
O cliente é criado no OZmap já com o estado de implantação “implantado”;
Configurações Base OZmap
...
Parâmetro
...
Descrição
...
Padrão
...
Tempo entre Sincronizações
...
Tempo aguardado entre as sincronizações realizadas pela integração.
...
Configurações Específicas OZmap - ONUs
...
Parâmetro
...
Descrição
...
Padrão
...
Atualizar os Dados da ONU no OZmap
...
Se o serial number, user pppoe ou mac de uma ONU no OZmap divergir do INT6, são atualizados os dados da ONU no OZmap, com base nos dados lidos do INT6.
...
Desativado.
...
Utilizar o Short Serial Number na ONU OZmap
...
Na ONU OZmap, pode ser utilizado o short serial number ao invés do serial number completo, lido da ONU INT6. Essa funcionalidade só pode ser ativa, caso a funcionalidade de atualizar os dados da ONU também estiver ativa.
...
Desativado.
Dados Acesso
https://docs.google.com/forms/d/1Ma6wF8XOaeKOSetxfbcR0Qkv6N4iJ4CAraxyyZpj2-0/edit
INT6
Dados de acesso necessários para buscar informações via API no sistema INT6. (Estes dados devem ser fornecidos no questionário inicial)
...
Parâmetro
...
Descrição
...
Exemplo
...
URL
...
URL do servidor que contém o serviço externo para conexão.
...
...
...
Email provido pelo cliente para acessar o serviço.
...
...
Token
...
Token provido pelo cliente para acessar o serviço.
...
aMshEhZtyK-7AyQTZM5v
OZmap
...
Liberação de IPs
Para validação e execução da integração no ambiente de produção, é necessário serem liberados no servidor do cliente os IPs utilizados pelo OZmap:
Servidor OZmap do cliente (ping cliente.ozmap.com.br)
...
Logs
No momento a integração INT6 não possui logs.
...
Questionário - Serviço de integração OZmap
Pergunta | Resposta | Funcionalidade |
|---|---|---|
É possível utilizar apenas algumas das funcionalidades acima? | Sim, atualmente são opcionais algumas funcionalidades | Atualizar os Dados da ONU, Utilizar Short Serial Number na ONU. |