Manual do FiberControl

O FiberControl conecta o PlenoAgent às OLTs da sua rede de fibra. Ele lê o inventário de ONUs e o sinal óptico, autoriza ONUs novas com a configuração do assinante, aplica suspensões e reativações a partir do faturamento e permite mudar o WiFi do cliente sem ir até a casa dele. Toda mudança na OLT passa por uma fila com novas tentativas, é verificada lendo a OLT depois da escrita e fica registrada na auditoria.

Na aba OLTs, o botão Adicionar OLT abre o assistente de configuração. O assistente tem cinco etapas e não grava nada na OLT até a última.

1. Conectar. Escolha o Fabricante e informe o nome, o host privado (o IP de gerência da OLT dentro da sua rede), a porta, o transporte, o usuário e a senha. Use Detectar modelo: o PlenoAgent entra na OLT pelo transporte escolhido, identifica o equipamento e o firmware e confirma que as credenciais funcionam. Você também pode escolher o modelo na lista de compatíveis: ao fazer isso, o transporte e a porta se ajustam ao que esse modelo usa (por exemplo, Telnet na porta 23 nas V-SOL de firmware antigo; veja o item 2.3).

2. Ler a OLT. O PlenoAgent lê a OLT uma única vez: confirma a conexão, lista as ONUs e faz um backup da configuração. As etapas seguintes trabalham sobre esse backup, sem voltar a tocar na OLT.

3. Rede. Defina a VLAN pela qual a OLT leva o tráfego dos assinantes, o gateway e a máscara que cada ONU recebe. Com A partir de um roteador de faturamento você escolhe o roteador do qual a OLT depende, lê as sub-redes dele e, ao escolher uma, esses dados são preenchidos sozinhos. Aqui você também escolhe ou cria o perfil de linha, o perfil DBA e, se quiser, um limite de velocidade para a OLT inteira.

4. Modelos de ONU. Cada modelo de ONU recebe um perfil de serviço e as portas LAN que roteia. Um perfil adaptável serve para todos os modelos e evita o aviso de perfil incompatível. Marque apenas as portas que o modelo realmente tem.

5. Revisar. Você vê exatamente o que o PlenoAgent vai criar na OLT. Ao clicar em Aplicar, ele faz um backup novo, cria só o que falta, verifica e salva o modelo de serviço da OLT.

2.1O que o PlenoAgent não toca

Os perfis que já existiam na OLT são seus e aparecem como Externo · somente leitura. O PlenoAgent só cria e administra objetos com nome PLENO_*, nunca modifica uma configuração do operador e interrompe a preparação se um ID de que precisa já estiver ocupado por outra definição: você verá o conflito e poderá escolher outro ID.

2.2Modelo não identificado

Se a sua OLT não está na lista de compatíveis, ou a detecção não a reconhece, você ainda pode registrá-la como Modelo não identificado — ainda sem driver. Ela fica salva sem ser consultada nem escrita e aparece na lista como Aguardando driver. Testar continua disponível para confirmar que o PlenoAgent chega até ela.

2.3V-SOL: por que a conexão é por Telnet

Muitas OLTs V-SOL de firmware antigo (V2.1 e V2.2) não liberam as sessões SSH: cada conexão deixa uma sessão ocupada mesmo quando é encerrada corretamente, até a tabela encher. A partir daí a OLT aceita o usuário e a senha, mas se recusa a abrir a sessão, e ninguém (nem o PlenoAgent nem seus técnicos) consegue entrar por SSH até essas sessões serem liberadas, o que em alguns equipamentos só acontece com uma reinicialização. Pelo Telnet, a linha é liberada ao sair.

Por isso esses modelos usam Telnet na porta 23 por padrão. O Telnet trafega dentro do seu túnel VPN privado, nunca pela internet. Se preferir SSH na sua OLT, você pode mudar o transporte na edição da OLT: é uma opção por OLT.

O botão Manual do usuário do cabeçalho abre este manual no idioma ativo.

4.1O que é lido e com que frequência

Com o Monitoramento ativo ligado na OLT, o PlenoAgent registra o sinal óptico das ONUs a cada 5 minutos e faz um inventário completo (ONUs novas e ausentes, modelo, porta PON, distância e MACs do equipamento do cliente) a cada 15 minutos. Ao desligá-lo, as duas leituras param; ao religá-lo, um teste de conexão e um inventário são executados na hora.

Os botões da linha da OLT forçam uma leitura sem esperar: Testar abre uma sessão de gerência e confirma rede, credenciais e CLI; Sincronizar coloca um inventário na fila.

4.2Qualidade do sinal

O detalhe de cada ONU tem o histórico de sinal (RX e TX) em 24 horas, 7 dias ou 30 dias. As lacunas no gráfico são períodos sem leitura, não sinal zero. Algumas OLTs não conseguem ler a potência de uma ONU antes de autorizá-la; nesse caso as amostras históricas são mantidas.

4.3Monitoramento da OLT

O botão Monitorar abre a telemetria óptica de cada porta PON física: potência TX, temperatura, tensão e bias TX ao longo do tempo. Serve para detectar um módulo SFP que está se degradando antes que os assinantes percebam.

4.4Alarmes

A fila de alarmes da Visão geral pode ser pesquisada e filtrada por status e severidade. Um alarme Aberto passa a Reconhecido com Reconhecer, para que a equipe saiba que alguém está cuidando dele, e a Resolvido sozinho quando a causa desaparece. Por exemplo, Perfil de ONU incompatível abre quando o inventário vê uma ONU cujas capacidades físicas não coincidem com o perfil de serviço, e se resolve no primeiro inventário depois da correção.

Busque por serial, cliente ou modelo. Filtros restringe por OLT, slot, PON, status operacional, status de registro, vínculo e faixa de sinal; as ONUs sem leitura ficam de fora quando você define um limite de sinal. Cada linha mostra até quatro indicadores:

• Status operacional: online, offline, desligamento inesperado (dying gasp, a ONU avisou que ficou sem energia) ou desconhecido.
• Vínculo / sincronização com a assinatura (tabela abaixo).
• Perfil incompatível: a ONU está online, mas suas portas não coincidem com o perfil de serviço atribuído.
• WiFi: se a gestão de WiFi está sendo ativada, está ativa ou falhou nessa ONU.

O botão ONUs não autorizadas conta as ONUs que a OLT vê conectadas mas que ninguém autorizou ainda: são as instalações novas esperando ativação.

Abra uma ONU não autorizada na lista (o botão ONUs não autorizadas as filtra). Há duas formas de ativá-la, e a diferença está em quem configura a conexão do assinante:

6.1IP fixo ou PPPoE pela OLT (Autorizar para assinatura)

O técnico chega, conecta a ONU e vai embora: o IP, o gateway e os DNS (ou o usuário e a senha PPPoE) viajam da OLT para a ONU. Antes de começar, confira três coisas:

• A assinatura tem os dados de conexão. Em Faturamento, no editor da assinatura, o Tipo de Conexão deve ser IP fixo com o IP atribuído, ou PPPoE com Usuário PPPoE e Senha PPPoE.
• A OLT tem modelo de serviço com máscara, gateway, DNS, VLAN, portas LAN roteadas e um service profile para o modelo desta ONU (veja a seção 7).
• O driver da OLT tem certificada a escrita de IP fixo ou de PPPoE. Se não tiver, o formulário avisa e não deixa continuar.

1. No detalhe da ONU, clique em Autorizar para assinatura.

2. Busque e escolha a assinatura. Só aparecem as que têm IP fixo ou conta PPPoE e ainda não estão vinculadas a outra ONU.

3. Revise O que a OLT vai receber. Com IP fixo: o endereço com a máscara, o gateway e os DNS. Com PPPoE: o usuário da assinatura (a senha vem da assinatura e não é exibida). Nos dois casos: VLAN, portas LAN roteadas, line profile, service profile conforme o modelo e traffic tables.

4. Clique em Autorizar. O trabalho entra na fila; a assinatura fica vinculada só quando a OLT confirma o serviço. Se algo falhar no meio do caminho, o PlenoAgent desfaz o que chegou a escrever e o erro aparece em Provisionamento.

6.2Autorizar com perfis (bridge)

Autorizar registra a ONU com o line profile e o service profile que você escolher. Se houver ONUs comparáveis já autorizadas, o PlenoAgent propõe os mesmos perfis. Para criar também a VLAN de Internet e o service-port, ative Provisionar Internet após a autorização e informe a VLAN e os perfis de tráfego de subida e descida. Sem essa opção, a ONU fica registrada mas sem serviço. Nesse modo a ONU fica em bridge: o IP fixo ou o PPPoE é configurado no roteador do cliente, e a ONU é vinculada à assinatura separadamente (seção 8).

6.3Operar uma ONU autorizada

• Alterar perfis reatribui line e service profile. Pode interromper o serviço por alguns segundos: o FiberControl faz um backup antes, verifica a nova atribuição e tenta restaurar os perfis anteriores se a verificação falhar.
• Reiniciar reinicia a ONU pela OLT.
• Desautorizar remove a ONU da OLT. É destrutivo e corta o serviço, por isso pede confirmação.
• Sincronizar descrição escreve na OLT a descrição esperada do cliente quando ela não coincide com a da ONU.

Enquanto uma operação está em andamento, o detalhe e a lista mostram Autorizando… ou Alterando perfis… e os botões ficam ocultos, para que duas mudanças nunca entrem na fila para a mesma ONU.

Em Perfis você escolhe uma OLT e vê seus perfis DBA, de linha, de serviço e de tráfego. Com Importar perfis o PlenoAgent os lê de novo na OLT; se a OLT estiver ocupada com outra operação, a importação acontece assim que ela ficar livre e a lista se atualiza sozinha.

O Modelo de serviço define como um assinante é ativado nessa OLT: VLAN, máscara, gateway, DNS, portas LAN em modo roteado, line profile e um service profile por modelo de ONU. O IP vem da assinatura; todo o resto vem do modelo.

1. Abra Modelo de serviço e use Propor a partir do último backup: o PlenoAgent lê como estão configuradas as ONUs que já existem na OLT, sem se conectar a ela, e informa quantas seguem essa receita.

2. Revise os campos e adicione um service profile para cada modelo de ONU que você instala, escrito exatamente como a OLT o informa. Uma ONU de um modelo que não esteja na lista não pode ser autorizada para uma assinatura.

3. Salve. A partir daí aparece Autorizar para assinatura nas ONUs não autorizadas dessa OLT.

Na visão de perfis de tráfego, Mapeamentos dos planos de faturamento mostra a velocidade desejada de cada plano frente à tabela de tráfego observada na OLT e seu status de sincronização.

O vínculo ONU ↔ assinatura é o que permite ao faturamento agir sobre a OLT: saber qual ONU é de qual cliente, suspendê-la por inadimplência e reativá-la no pagamento. Se você autorizou a ONU com Autorizar para assinatura, o vínculo já foi criado sozinho. Caso contrário, há duas formas:

• No detalhe da ONU, no bloco Assinatura: clique no lápis, busque a assinatura e clique em Vincular assinatura. É um vínculo rápido: identifica o cliente, mas a suspensão continua sendo feita pelo RouterOS e o FiberControl não controla a velocidade.
• No editor da assinatura em Faturamento, no bloco Acesso de fibra, onde você também escolhe quem controla cada coisa.

No editor:

1. Ative Gerenciar acesso com FiberControl.

2. Escolha a OLT e a ONU. A busca aceita serial, descrição, porta PON ou MAC e só oferece ONUs livres. A VLAN de Internet vem do modelo de serviço da OLT e não muda por assinatura.

3. Defina quem é a autoridade de cada responsabilidade (tabela abaixo) e salve a assinatura.

8.1O que acontece ao suspender e ao reativar

1. A assinatura muda de status: o ciclo de cobrança a suspende por inadimplência, alguém a bloqueia manualmente, ou um pagamento, uma prorrogação ou um ajuste de saldo a reativa.

2. Se o Controle de suspensão for o FiberControl, o PlenoAgent coloca a mudança na fila da OLT: suspende o serviço dessa ONU sem desautorizá-la (o assinante não perde a configuração) ou o restabelece. O roteador deixa o cliente ativo, para que o corte seja feito só pela OLT.

3. O movimento fica no Histórico da Assinatura (filtro Serviço) como Serviço suspenso ou Serviço reativado, com canal FiberControl e status Pendente, Aplicado ou Falhou.

4. Se a OLT não responder (túnel caído, OLT ocupada), o trabalho tenta de novo sozinho. Se ficar como Falhou, o motivo está em Provisionamento; corrija a causa e use Tentar novamente. Se o módulo FiberControl não estiver ativo, o movimento fica como Falhou na hora: ative o módulo ou mude a autoridade para o RouterOS.

Se o Controle de banda for o FiberControl, a fila do roteador é criada sem as velocidades do plano e a OLT aplica a velocidade com a sua tabela de tráfego (veja Mapeamentos dos planos de faturamento na seção 7). Cancelar uma assinatura não desautoriza a ONU: se ela não for mais usada, desautorize-a pelo FiberControl.

Permite ver e mudar o nome e a senha do WiFi de cada assinante pelo PlenoAgent. A OLT indica a cada ONU onde está o seu ACS (o servidor TR-069), que é exclusivo da sua empresa e só escuta dentro do seu túnel VPN: nada fica exposto à internet. O botão WiFi aparece na linha da OLT quando o driver dela permite.

9.1Ativar na OLT

1. Perfis de linha. Uma ONU só aceita um ACS se o perfil de linha dela tiver o TR-069 ativado. Para cada perfil de linha que você usa, escolha a cópia com TR-069 ativado (o PlenoAgent propõe a que encontrar). Se não houver nenhuma, crie-a na OLT e importe os perfis novamente. Antes de escrever, o PlenoAgent compara os dois perfis na OLT e rejeita uma cópia que mudaria o serviço do assinante.

2. Regra no roteador. As ONUs chegam ao ACS passando pelo seu MikroTik, que precisa permitir TCP 7547 até o ACS. Com Deixar o Pleno adicionar a regra, o PlenoAgent escreve a regra pleno-acs abaixo da regra de suspensão, assim os suspensos continuam cortados. Se preferir fazer você mesmo, copie a regra mostrada.

3. Clique em Ativar nesta OLT. Leva cerca de um minuto.

4. Ative a gestão nas ONUs: todas de uma vez com Ativar em N ONUs, ou uma a uma no detalhe de cada uma. Cada ONU se reconecta por alguns segundos ao passar para o perfil TR-069. ONUs novas autorizadas com WAN roteada já a recebem automaticamente.

9.2Mudar o WiFi de um assinante

No detalhe da ONU, a seção WiFi mostra cada rede com nome, segurança, se está ligada e quantos dispositivos estão conectados. Edite o nome (1 a 32 caracteres) ou a senha (8 a 63 caracteres, sem acentos; vazia para mantê-la) e clique em Salvar WiFi. Os dispositivos conectados são desconectados e precisam entrar de novo com os dados novos.

Se a ONU não responder na hora, a mudança fica em Aguardando a ONU e é aplicada quando ela voltar a se reportar, normalmente em menos de cinco minutos. Você pode cancelá-la enquanto estiver pendente. Ler novamente pede os dados à ONU outra vez.

9.3Quando não funciona

Comece sempre pelo detalhe da ONU: a seção WiFi mostra o diagnóstico dessa ONU e, se uma tentativa falhou, o erro exato. Os casos mais comuns:

Se a ativação falhar

• Na OLT: a janela de WiFi da OLT mostra quando a última tentativa falhou e por quê. O mais comum: uma cópia de perfil de linha que não coincide com o original ou não tem TR-069 ativado (corrija a atribuição), ou um perfil de servidor PLENO_ACS que já existia na OLT com outros dados e está em uso.
• Numa ONU: o detalhe mostra o erro e o botão Tentar novamente. As causas típicas: a ONU está em bridge (sem WAN roteada), o perfil de linha dela não tem cópia TR-069 atribuída no WiFi da OLT, ou a OLT não confirmou a mudança; nesse último caso a ONU fica como estava.

Para voltar atrás numa ONU, use Desativar gerenciamento WiFi: ela volta ao perfil de linha anterior, se reconecta por alguns segundos e mantém o nome e a senha do WiFi que tinha.

Toda mudança numa OLT é um trabalho na fila de Provisionamento. O FiberControl executa uma única operação por vez em cada OLT, porque as OLTs têm poucas sessões de gerência e uma sessão a mais pode bloquear seus técnicos.

As novas tentativas são seguras: repetir uma autorização ou suspensão que já foi aplicada não duplica nada.

Em Backups, Criar backup salva a configuração completa de uma OLT com o checksum. O PlenoAgent também faz um backup automático antes de preparar uma OLT ou alterar perfis. A Auditoria registra cada operação na OLT com o ator (um usuário ou o sistema), o resultado e o código de erro.

«Não é possível alcançar a OLT pela rede privada»

Confira no NetAdmin se o túnel VPN está conectado, se o host privado está correto e se o roteador encaminha para a rede de gerência da OLT.

«A OLT rejeitou as credenciais salvas»

Edite a OLT e informe usuário e senha novamente. Deixar a senha vazia mantém a anterior.

«A OLT não tem sessões de gerência livres», ou ela fecha a conexão antes de autenticar

A OLT chegou ao limite de sessões CLI. Feche as sessões abertas (PuTTY, a interface web da OLT, outro sistema de gerência) ou espere que expirem e tente de novo. Algumas OLTs não liberam sessões travadas até o tempo de espera acabar.

Uma ONU nova não aparece

Use Sincronizar na OLT e confira o filtro ONUs não autorizadas. Se a OLT estiver com o monitoramento desligado, não há inventário automático.

Não aparece «Autorizar para assinatura»

A OLT não tem modelo de serviço. Configure-o em Perfis.

A ONU mostra «Perfil incompatível»

O modelo dela tem portas diferentes das do service profile atribuído. Use um perfil adaptável, ou o perfil certo para esse modelo, com Alterar perfis.

Um trabalho ficou em «Falhou»

Leia o erro em Provisionamento. Se disser que a OLT está ocupada ou inalcançável, tente de novo quando ela se recuperar; se for um conflito de configuração, corrija-o antes de tentar novamente.

A mudança de WiFi não é aplicada

O detalhe da ONU explica a causa. A tabela completa de mensagens e o que fazer está no item 9.3.

Conectando uma V-SOL: «The OLT refused the connection on this port»

O Telnet não está permitido na lista de acesso da OLT, ou a porta 23 está filtrada. Veja o item 2.3.

Uma suspensão não cortou o cliente

Abra o Histórico da Assinatura e confira o movimento: o canal e o status mostram quem deveria cortar e se conseguiu. Se o canal for FiberControl e estiver como Falhou, o motivo está em Provisionamento.

O modelo da minha OLT não está na lista

Registre-a como modelo não identificado e fale com a gente: construímos o driver com o seu equipamento (item 2.2).