Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 21 Next »

Essa documentação trata da integração com o sistema INT6. A integração é realizada por chamadas de API partindo do INT6 utilizando a API disponibilizada pelo OZmap e partindo do OZmap utilizando a API disponibilizada pelo INT6.

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, OZmap buscando informações de potência do INT6 e INT6 buscando informações de rede do OZmap.

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:

  • 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 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;

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.

10 minutos

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.

autoisp.exemplo.com.br

Email

Email provido pelo cliente para acessar o serviço.

ozmap@int6tech.com.br

Token

Token provido pelo cliente para acessar o serviço.

aMshEhZtyK-7AyQTZM5v

OZmap

Parâmetro

Descrição

Exemplo

Token

Token associado a conta do usuário de integração cadastrado no ozmap. (O usuário deve ter acesso aos projetos que a integração irá trabalhar (Escolha do usuário). Tutorial de como gerar usuário/chave.)

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE

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:

  • 54.207.162.199

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”;

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.

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.