Essa documentação trata da integração com o sistema OLT Cloud. A integração é realizada através de chamadas API partindo do integrador e utilizando a API disponibilizada pelo OZmap.
Tipo de Integração
A integração OZmap-OLT Cloud é do tipo Passiva-direta, desenvolvida pela equipe OLT Cloud.
Descrição
O OLT Cloud é um sistema de provisionamento e monitoramento focado no gerenciamento de PONs, CTOs, OLTs e ONUs de maneira isolada ou compartilhada.
Resumo de funcionalidades
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Sincronização de Caixas | Atualização dos dados da Caixa no OLT Cloud com base nos dados deste elemento no OZmap. | OZmap => OLT Cloud |
Criação de Clientes | Criação no OZmap de clientes que se encontram cadastrados no OLT Cloud. | OLT Cloud => OZmap |
Atualização de Porta de Clientes | Ao trocar um cliente de porta no OLT Cloud é atualizado a porta do cliente no OZmap e vice-versa. | OZmap => OLT Cloud |
Cancelamento de Clientes | Remoção no OZmap de clientes que tiveram a porta removida no OLT Cloud. | OLT Cloud => OZmap |
Funcionalidades
Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.
Sincronização de Caixas
A sincronização de caixas no OLT Cloud tem como objetivo manter as informações de Caixas e suas portas sempre atualizadas, com base nos dados obtidos do OZmap. O processo permite configurar quais tipos de caixas do OZmap devem ser sincronizados e de quais projetos elas devem ser extraídas. As caixas são vinculadas ao OLT Cloud por meio de seus respectivos IDs no OZmap.
A frequência dessa sincronização depende da quantidade de caixas do cliente, podendo ocorrer a cada 1 hora se o Cliente tiver poucas Caixas, ou podendo ocrrer apenas duas vezes ao dia caso o Cliente possua um número elevado de Caixas (ocorrendo às 5h e às 17h).
O funcionamento dessa sincronização ocorre da seguinte forma:
O cliente define no OLT Cloud quais tipos de Caixas OZmap devem ser importadas e partir de quais Projetos.
As Caixas OZmap importadas irão contêm informações no OLT Cloud como: quantidade de portas, nome, status de implementação e coordenadas.
Uma rotina é executada periodicamente, podendo ocorrer de hora em hora ou até mesmo duas vezes ao dia dependendo da quantidade de Caixas do cliente, e realiza as seguintes funções:
Atualiza os dados das Caixas no OLT Cloud caso tenham sido alterados no OZmap, como nome coordenadas ou quantidade de portas.
Atualiza os Clientes associados a cada porta da caixa, caso haja mudanças no OZmap.
Criação de Clientes
A Criação de Clientes no OZmap ocorre quando um cliente é vinculado a uma caixa no OLT Cloud. Nesse momento, a integração verifica se o cliente já existe no OZmap, e caso não exista, o cliente é criado no OZmap na caixa e porta correspondentes, com o status "implantado", incluindo os dados de ONU (número de série, usuário PPPoE e endereço MAC) e uma observação indicando que foi criado pelo OLT Cloud.
Atualização de Porta de Clientes
Por padrão, a atualização das portas dos clientes no OLT Cloud é feita com base nos dados do OZmap, dessa forma caso o Cliente tenha sua porta alterada no OZmap essa informação será replicada no OLT Cloud. No entanto, caso o cliente tenha a configuração "Gravar dados no OZmap" ativada no OLT Cloud, essa atualização ocorrerá de forma bilateral, ou seja, caso o cliente tenha sua porta alterada no OLT Cloud a informação será replicada no OZmap e vice-versa.
Cancelamento de Clientes
O Cancelamento de Clientes ocorre quando o cliente é removido de uma porta no OLT Cloud. Isso resulta na remoção do Cliente e de sua Propriedade no OZmap, mas ele continuará existindo no OLT Cloud.
Dados Acesso
Dados de acesso necessários para as operações realizadas pelo integrador são:
Saiba mais como configurar esses dados acionando o suporte do OLT Cloud.
OZmap
Parâmetro | Descrição | Exemplo |
|---|---|---|
API URL | Endereço da API OZmap | |
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
Caso o servidor OZmap esteja em ambiente ON-Premisses, é necessário liberar nos firewalls o IP do servidor onde está o OLT Cloud 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
Pergunta | Resposta | Funcionalidade |
|---|---|---|
Add Comment