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 por padrão é atualizado a porta do cliente no OZmap. Porém pode ocorrer atualização de forma bilateral, dependendo da configuração do cliente no OLT Cloud. | 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 possuir poucas Caixas em sua base, ou podendo ocorrer 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 realiza a importação das Caixas OZmap para sua base no OLT Cloud, definindo no OLT Cloud quais tipos de Caixas OZmap devem ser importadas e a partir de quais Projetos.
As Caixas OZmap importadas irão conter informações no OLT Cloud como: quantidade de portas, nome, status de implementação e coordenadas.
Uma rotina é executada periodicamente (ocorrendo no intervalo de tempo determinado pelo time da OLT Cloud como ja explicado anteriormente), 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 é desvinculado de uma Caixa 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