Como integrar OLT com ERP: passo a passo para provedores

Como integrar OLT com ERP e por qual caminho o sistema fala com a OLT

O ERP conversa com a OLT por um de quatro caminhos: linha de comando, SNMP, API do sistema de gerência do fabricante ou um serviço intermediário. O caminho define o que dá para automatizar e o que pode quebrar quando a OLT troca de firmware.

Integrar a OLT com o ERP significa que o que o atendimento faz no cadastro do cliente acontece na OLT sem ninguém digitar de novo. Os ERPs de provedor mais usados no Brasil, como IXC Soft, MK-Auth, SGP e Hubsoft, trazem algum módulo de OLT, mas cada um cobre marcas e recursos diferentes [CONFIRMAR na documentação do ERP].

Este guia trata da ligação entre os dois sistemas: acesso, mapa de planos, eventos e conciliação. O resultado dessa ligação é o provisionamento automático de ONU, e a integração do ERP com o resto da rede, como RADIUS e ACS, está na integração com ERP de provedor.

Por que o Telnet ainda aparece nas integrações?

Porque muitos módulos antigos foram escritos para Telnet, e algumas OLTs vinham com ele ligado de fábrica. O problema é que o Telnet manda usuário e senha sem criptografia, legíveis por qualquer um no caminho.

Sempre que a OLT e o ERP aceitarem, use SSH na integração e desligue o Telnet. Se o módulo do ERP só fala Telnet, mantenha o tráfego dentro da VLAN de gerência e restrinja o acesso ao endereço do servidor do ERP.

O que preparar na OLT antes de integrar

A OLT precisa de um usuário só para o ERP, de acesso liberado apenas a partir do servidor dele e de perfis com nomes que não mudam. Sem isso, a integração repete em escala os erros de quem configurava à mão.

A preparação costuma levar mais tempo que a integração em si. Uma OLT com quarenta perfis para seis planos não tem como ser integrada antes de os perfis serem unificados, porque o ERP não sabe qual dos parecidos usar.

Usuário exclusivo e acesso restrito

O ERP ganha um usuário próprio, nunca o do técnico nem o administrador de fábrica. Assim, cada comando que ele grava aparece no log com um nome que diz de onde veio.

• Permissão mínima: o usuário do ERP cria, altera e remove ONUs e service-ports, mas não mexe em uplink, VLAN nem usuários.
• Origem fixa: a OLT só aceita esse usuário vindo do endereço do servidor do ERP, pela rede de gerência.
• Senha própria: senha longa, guardada no cofre do provedor e trocada quando alguém com acesso sai da equipe.
• Log ligado: cada comando do ERP vai para o servidor de syslog, para auditoria e para diagnóstico.

Perfis com nomes que o ERP reconhece

Cada plano vendido corresponde a um conjunto fixo de perfis na OLT, sempre com o mesmo número em todas as OLTs da rede. Quando o ERP pede o plano de 300 Mbps, ele precisa encontrar o mesmo perfil no centro e no bairro.

Se a OLT ainda não tem esse padrão, o guia de como configurar OLT mostra como organizar perfis de banda, de linha e de serviço por plano antes da integração.

Como integrar OLT com ERP em oito etapas

São oito etapas, e a integração só entra em produção depois que um cliente fictício passou por todos os eventos do contrato. A ativação manual continua disponível durante todo o processo.

1. Levantamento: marca, modelo e firmware de cada OLT, versão do ERP e quais marcas o módulo dele suporta.
2. Usuário da integração: criado na OLT com permissão mínima e acesso só a partir do servidor do ERP.
3. Cadastro da OLT no ERP: nome, endereço de gerência, porta de acesso, marca, modelo e as portas PON em uso.
4. Mapa de planos: cada plano do ERP apontando para os perfis de banda, de linha e de serviço da OLT.
5. Mapa de VLANs: a VLAN de internet de cada OLT ou de cada porta PON, conforme o modelo da rede.
6. Teste de acesso: o servidor do ERP abre sessão na OLT e lê o estado de uma ONU de teste.
7. Cliente fictício: um contrato de teste passa por ativação, troca de plano, suspensão, reativação e cancelamento.
8. Conciliação e virada: ERP e OLT comparados, divergências corrigidas e a integração ligada uma OLT por vez.

A Táquion Tech integra OLTs ao sistema de cobrança à distância e mantém o caminho manual documentado, para a instalação não parar se o ERP sair do ar.

Exemplo: teste de acesso e mapa de planos

O primeiro bloco testa, a partir do servidor do ERP, se a OLT responde por SSH e por SNMP. O segundo mostra como fica um mapa de planos que o ERP consulta a cada ativação.

Os endereços são de documentação, reservados para exemplos. O objeto SNMP consultado é a descrição do sistema, padrão em qualquer equipamento com MIB-II, e serve só para provar que a comunidade e a origem estão liberadas.

# A partir do servidor do ERP (198.51.100.15)
ssh erp-provisiona@192.0.2.30
# Leitura da descrição do sistema por SNMP v2c
snmpget -v2c -c COMUNIDADE-LEITURA 192.0.2.30 1.3.6.1.2.1.1.1.0
# O mesmo teste a partir de outro endereço deve falhar

OLT: OLT-POP-CENTRO   gerencia: 192.0.2.30   vlan-internet: 100
plano ERP          perfil-banda   perfil-linha   perfil-servico
FIBRA-100M         DBA-100M       LINHA-INTERNET SRV-BRIDGE-1ETH
FIBRA-300M         DBA-300M       LINHA-INTERNET SRV-BRIDGE-1ETH
FIBRA-500M         DBA-500M       LINHA-INTERNET SRV-ROTEADOR
EMPRESA-200M-GAR   DBA-200M-GAR   LINHA-INTERNET SRV-BRIDGE-4ETH

Repare que o nome do perfil é igual em todas as OLTs. Quando uma OLT nova entra na rede, ela só precisa ganhar os mesmos perfis e ser cadastrada no ERP; o mapa de planos não muda.

Quais eventos do contrato a integração precisa cobrir?

A integração cobre todos os momentos em que o contrato muda, não só a primeira ativação. Cada evento tem um efeito na OLT e um ponto a conferir depois.

Na maioria dos provedores, a suspensão acontece no RADIUS, que derruba ou redireciona a sessão PPPoE, e a OLT nem é tocada. Decidir onde o bloqueio acontece é parte do desenho; a configuração de RADIUS cobre esse lado.

Conciliação quando ERP e OLT discordam

Conciliação é comparar periodicamente a lista de ONUs da OLT com os contratos ativos do ERP. As diferenças mostram ONU de cliente cancelado ainda ligada, contrato ativo sem ONU e número de série digitado errado.

Faça a primeira conciliação antes de ligar a integração, porque a base antiga quase sempre tem divergências. Depois, uma conferência semanal ou mensal mantém os dois sistemas contando a mesma coisa.

Erros comuns ao integrar OLT com ERP

Os erros de integração não aparecem como falha na tela; aparecem como cliente com plano errado, cancelado navegando ou instalação parada. Quase todos vêm de pular a preparação da OLT ou os testes com cliente fictício.

• Usuário administrador no ERP: um erro de regra apaga ONUs ou altera VLAN em toda a OLT, e o log não mostra quem foi.
• Integrar antes de unificar perfis: o ERP aponta clientes para perfis antigos e cada OLT passa a ter um comportamento.
• Testar só a ativação: troca de plano e cancelamento ficam sem teste e só falham quando um cliente reclama.
• Atualizar o firmware sem avisar o ERP: a saída de um comando muda e o módulo deixa de entender a resposta da OLT.
• Sem caminho manual: o ERP sai do ar num sábado e nenhuma instalação é concluída até segunda.
• Não conciliar: a OLT acumula ONUs de quem cancelou e as portas parecem cheias sem estar.

Atualizar o firmware da OLT integrada pede um cuidado extra: testar o módulo do ERP com a versão nova antes da janela. O guia de como atualizar firmware da OLT trata da janela; inclua nela um teste de ativação pelo ERP.

Como saber se a integração está saudável?

Uma integração saudável deixa rastro de cada ação e avisa quando falha. Confira estes pontos uma vez por mês.

Perguntas frequentes

Thiago Manoel

Responsável técnico da Táquion Tech · Registro profissional [PREENCHER]

Mais de 15 anos em operações de rede, com gestão de infraestruturas de TI, administração de data centers e condução de equipes em migrações de TI e telecomunicações, com foco em alta disponibilidade e segurança.

A Táquion Tech é uma empresa de engenharia de redes de Balneário Camboriú (SC) que projeta, opera e dá suporte a redes de provedores de internet e de empresas.

Conheça a equipe da Táquion Tech