Script personalizado de OLT

Os perfis de ONU guardam o script que o Atlaz envia à OLT na autorização. Os perfis globais são um ponto de partida, mas cada rede tem VLANs, service ports e tráfegos próprios. Neste tutorial você cria um perfil personalizado com os comandos da sua rede e o testa com segurança.

flowchart TD
    INICIO([Início]) --> A[Obter o script que já funciona na OLT]
    A --> B[Criar o perfil]
    B --> C[Colar o script e adicionar variáveis]
    C --> D[Salvar]
    D --> E[Testar com ONU de homologação]
    E --> F{Funcionou na OLT?}
    F -- Não --> C
    F -- Sim --> G[Liberar para a operação]
    G --> FIM([Fim])

    style INICIO fill:#8724fb,stroke:#8724fb,color:#fff
    style FIM fill:#8724fb,stroke:#8724fb,color:#fff
    style A fill:#4ea1ff,stroke:#4ea1ff,color:#fff
    style B fill:#4ea1ff,stroke:#4ea1ff,color:#fff
    style C fill:#4ea1ff,stroke:#4ea1ff,color:#fff
    style D fill:#4ea1ff,stroke:#4ea1ff,color:#fff
    style E fill:#ff9a3d,stroke:#ff9a3d,color:#fff
    style F fill:#49d0e2,stroke:#49d0e2,color:#fff
    style G fill:#49d0e2,stroke:#49d0e2,color:#fff

Acesso à página

Caminho: Rede → OLTs → Perfis de onus. É preciso a permissão Gerenciar perfis de ONUs.

Pré-requisitos

• A OLT integrada. Veja Integrar uma OLT ao Atlaz.
• O script que o técnico já usa para autorizar uma ONU na linha de comando da OLT, funcionando.
• Uma ONU de homologação, fora de qualquer contrato em uso, e um contrato de teste.
• Se a sua rede pede ajuda para montar o script, o suporte do Atlaz participa da parametrização: envie a sequência que funciona na OLT e as VLANs, service ports e tráfegos da sua rede.

Entenda driver, perfil e script

O driver é a forma de falar com a OLT e é escolhido no cadastro da OLT. O perfil é um nome com um Fabricante/Modelo, um Status e um script. O script é o texto dos comandos, com variáveis entre #. Um perfil só aparece na autorização se estiver Ativo e for do mesmo fabricante e modelo da OLT. Mais detalhes em Perfis de ONUs.

Passo 1 — Abra Perfis de onus e clique em Novo

Acesse Rede → OLTs → Perfis de onus. Na lista, clique em Novo (1).

Passo 2 — Identifique o perfil e cole o script

Preencha Nome, Fabricante/Modelo (o mesmo da OLT) e Status. Cole no campo Script a sequência de comandos que você já usa na OLT.

Use um nome que o operador reconheça na hora de autorizar, como o fabricante, a VLAN ou a região.

Como obter o script

Peça ao técnico o histórico de uma autorização que funcionou na linha de comando. Sem um script que já funciona na OLT, o perfil não tem o que automatizar.

Passo 3 — Troque valores fixos por variáveis

Clique em Adicionar variáveis. O Atlaz procura no script os valores que costumam ser variáveis para aquele fabricante, como serial e VLAN, e os troca pelo nome da variável. A ação pede confirmação, porque altera o texto: revise o script depois. Você também pode digitar as variáveis à mão, com o nome entre #.

exemplo: onu add serial-number #onu_mac# vlan #vlan#

No bloco Referência de variáveis, no fim da tela, o Atlaz lista todas as variáveis aceitas.

Variáveis aceitas

Origem	Variáveis	Observação
ONU (preenchidas pelo Atlaz)	#onu_mac#, #onu_tipo#, #slot#, #pon#, #onu_numero#	Serial ou MAC, tipo, posição da ONU e número livre sugerido na porta
Janela Autorizar ONU	#vlan#, #gemport#, #service_port#, #digistar_gem_port#	Informadas pelo operador ou vindas dos padrões da PON
Contrato	#pppoe_login#, #pppoe_login_sem_caracteres_especiais#, #pppoe_senha#, #router_ssid#, #router_chave_wifi#, #plano_nome#	Dados do contrato escolhido em Cliente
Campos personalizados	#customizado_ID_nome#	Um para cada campo personalizado marcado para aparecer nos perfis de ONU
Somente ZTE	#zte_tcont#, #zte_traffic#, #zte_type#, #zte_vlan_profile#	Informados na janela de autorização
Somente Huawei	#line_profile#, #srv_profile#	Informados na janela ou vindos da PON
Somente Intelbras G16	#intelbras_g16_line_name#	Informado na janela de autorização

Use os nomes exatamente como aparecem na referência. Uma variável com nome errado não é substituída e o comando segue incompleto para a OLT.

Senhas do cliente no script

#pppoe_senha# e #router_chave_wifi# colocam a senha PPPoE e a senha do Wi-Fi do cliente no script gerado. Use só se o comando exigir e não compartilhe o script em chamados ou capturas de tela.

Passo 4 — Salve

Defina o Status como Ativo quando quiser que o perfil apareça na autorização e clique em Criar (ou Salvar, ao editar).

Passo 5 — Teste com uma ONU de homologação

1. Em Ver ONUs não autorizadas, escolha a ONU de homologação e clique em Autorizar.
2. Selecione o perfil novo, informe VLAN e o contrato de teste.
3. Clique em Gerar script e revise linha a linha: serial, VLAN, login e service port. Procure texto entre # que sobrou sem substituir.
4. Clique em Autorizar e leia a Resposta da OLT.
5. Na OLT, confirme que a ONU ficou com a VLAN, o service port e o perfil esperados.
6. Teste a navegação do contrato de teste.
7. Se tudo estiver certo, desautorize a ONU de homologação.

Veja o fluxo completo em Autorizar e desautorizar uma ONU.

Não pule o teste

Um script errado deixa a ONU sem serviço, cria service port ou VLAN indevidos ou configura a ONU pela metade. Homologue sempre antes de liberar o perfil.

Resultado esperado

O perfil aparece na janela Autorizar ONU, o script gerado vem completo e a ONU de homologação autoriza e navega com a configuração da sua rede.

Problemas comuns

Sintoma	O que conferir
O perfil não aparece na autorização	O Status está Desativado ou o Fabricante/Modelo do perfil é diferente do da OLT
O script sai com #nome# sem trocar	O nome da variável não existe ou o dado correspondente não foi informado
Autorizou, mas a ONU não tem serviço	VLAN, service port e tráfego do script em relação à realidade da OLT
Funciona em uma região e falha em outra	Crie um perfil por padrão de rede distinto
Quero apagar um perfil global	Perfis globais não são editáveis: desative-os alterando o Status

Boas práticas

• Mantenha poucos perfis ativos e nomeie com fabricante e região.
• Depois de editar um script, repita o teste com a ONU de homologação.
• Desativar um perfil não altera ONUs já autorizadas: só impede novas autorizações com ele.
• Excluir um perfil personalizado pede a sua senha e não pode ser desfeito.

Checklist

• Script que já funciona na OLT em mãos
• Fabricante/Modelo igual ao da OLT
• Variáveis revisadas depois de Adicionar variáveis
• Teste feito com ONU de homologação
• Perfil ativado só depois do teste

Veja também

• Perfis de ONUs
• Autorizar e desautorizar uma ONU
• PONs
• Integrar Cianet G8PSX