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.

A integração OZmap x INT6 é feita em duas direções e via API, com o OZmap buscando informações de potência do INT6 e INT6 buscando informações de rede do OZmap.

OBS: Por padrão, o 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, sendo necessariamente, um valor numérico. Porém, também é possível usar o pppoe_username do INT6 como código, via configuração específica, devendo ser ajustado nos dois lados da integração (OZmap e INT6).

Resumo das funcionalidades - Serviço de integração OZmap

Resumo das funcionalidades - Serviço de integração INT6

Serviço de integração OZmap

Funcionalidades

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:

• São lidos todos os clientes OZmap;

• É feita a busca de clientes no INT6 de acordo com o parâmetro “Código INT6 a ser considerado na integração”, ocorrendo da seguinte forma:

  • Caso seja o gpon_client_id:

    • Para cada cliente OZmap que possui um código numérico, é buscado um cliente com “gpon_client_id” igual no INT6;

  • Case seja o pppoe_username:

    • Para cada cliente OZmap, é buscado um cliente com “pppoe_username” 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 do INT6 for um valor numérico positivo ou negativo, o status de conexão do cliente no OZmap é atualizado para OK;

  • Se a nova potência for zero ou textual, o status de conexão é atualizado para ERROR no OZmap;

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;

• É feita a busca de clientes no INT6 de acordo com o parâmetro “Código INT6 a ser considerado na integração”, ocorrendo da seguinte forma:

  • Caso seja o gpon_client_id:

    • Para cada cliente OZmap que possui um código numérico, é buscado um cliente com “gpon_client_id” igual no INT6;

  • Case seja o pppoe_username:

    • Para cada cliente OZmap, é buscado um cliente com “pppoe_username” 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 (considerando o parâmetro “Limite de alteração de potência“), é atualizado o campo de potência lida da ONU no OZmap com o valor encontrado no INT6. Abaixo uma tabela exemplificando os casos de atualização de potência, considerando o “Limite de alteração de potência“ sendo 0.5:

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;

• É feita a busca de clientes no INT6 de acordo com o parâmetro “Código INT6 a ser considerado na integração”, ocorrendo da seguinte forma:

  • Caso seja o gpon_client_id:

    • Para cada cliente OZmap que possui um código numérico, é buscado um cliente com “gpon_client_id” igual no INT6;

  • Case seja o pppoe_username:

    • Para cada cliente OZmap, é buscado um cliente com “pppoe_username” 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;

• É feita a busca de clientes no INT6 de acordo com o parâmetro “Código INT6 a ser considerado na integração”, ocorrendo da seguinte forma:

  • Caso seja o gpon_client_id:

    • Para cada cliente OZmap que possui um código numérico, é buscado um cliente com “gpon_client_id” igual no INT6;

  • Case seja o pppoe_username:

    • Para cada cliente OZmap, é buscado um cliente com “pppoe_username” 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

Configurações Específicas OZmap

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)

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)

• 54.207.162.199

Logs

No momento a integração OZmap 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 é dada 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, pppoe_username ou circuit_id_integration da ONU no INT6 (dependendo de como estiver configurado no serviço 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 ou pppoe_username da ONU no INT6 (dependendo de como estiver configurado no serviço 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”

Cancelar Cliente no OZmap

O cancelamento de clientes no OZmap é dado da seguinte forma:

• No momento do desprovisionamento de um cliente no INT6, é buscado um cliente no OZmap com código igual ao gpon_client_id ou pppoe_username da ONU no INT6 (dependendo de como estiver configurado no serviço INT6);

• Se o cliente for encontrado no OZmap, o INT6 remove o cliente por completo do OZmap (cliente, imóvel e drop são excluídos).

Dados Acesso - Serviço de integração INT6

Dados de acesso necessários para as operações realizadas pelo integrador são:

OZmap

Liberação de IPs

Caso o servidor OZmap esteja em ambiente ON-Premisses, é necessário liberar nos firewalls o IP do servidor onde está o INT6 para acessar as portas 80 e 9994 no ambiente do OZmap.

Caso seu servidor seja hospedado pelo OZmap, essas portas já estarão liberadas para o integrador.

Questionário