Mover ONU de PON na OLT Huawei sem perder a configuração

Toda semana alguma ONU troca de PON sem ninguém avisar o NOC. O técnico faz uma manobra na CTO, pluga o drop no splitter de outra caixa ou o cliente muda de endereço levando o equipamento. Para a OLT Huawei, a ONU caiu numa porta e apareceu como desconhecida em outra. Saber mover ONU de PON sem perder a configuração evita o pior cenário: cliente sem internet enquanto alguém refaz o provisionamento do zero, de memória.

Eu opero OLTs Huawei MA5800 em produção, e o sistema que eu escrevi para acompanhar as ONUs tem uma tela só para trocas de PON. Este guia mostra o roteiro que uso: como detectar a troca, o que anotar da posição antiga, a ordem dos comandos para remover e adicionar de novo e o que conferir no fim. Os exemplos usam um cenário anônimo: uma ONU que estava na PON 0/1/2 como ONT 5 e apareceu no autofind da PON 0/1/3.

Resposta rápida: como mover ONU de PON na OLT Huawei

1. Confirme a troca: o SN aparece no display ont autofind all numa PON e o display ont info by-sn mostra a mesma ONU registrada, offline, em outra.
2. Decida se a troca foi intencional. Cordão trocado na CTO se resolve no campo, não na OLT.
3. Anote a posição antiga: perfis, descrição e os service-ports com display service-port port 0/1/2 ont 5.
4. Remova os service-ports com undo service-port e apague a ONU com ont delete.
5. Adicione na nova PON com ont add, leia o ONTID novo e refaça WAN e service-ports com ele.
6. Confira estado, service-ports e WAN, grave com save e deixe o TR-069 terminar o resto.

Quando a ONU muda de PON

Antes de mover ONU de PON, vale entender o que a OLT enxerga. Ela não sabe que a ONU mudou de lugar. Ela só vê duas coisas: uma ONU registrada parou de responder numa porta, e um SN desconhecido começou a pedir autorização em outra. As causas que eu mais vejo:

• Manobra na CTO. O técnico precisou de uma porta livre e passou o drop para o splitter de outra caixa, que pertence a outra PON.
• Cordões trocados. Duas ONUs da mesma caixa trocam de PON no mesmo minuto. É quase sempre um par de cordões invertido no splitter ou no DIO.
• Mudança de endereço. O cliente levou a ONU para a casa nova, atendida por outra PON. Aqui a troca é esperada e existe uma ordem de serviço por trás.
• Equipamento reaproveitado. A ONU de um cliente cancelado foi recolhida e instalada em outro endereço. Não é troca: é um cliente novo usando um SN conhecido.

Os dois últimos casos mudam a decisão. Na mudança de endereço, mover ONU de PON é exatamente o trabalho a fazer. No reaproveitamento, o certo é apagar o cadastro antigo e provisionar o cliente novo com os dados dele, não copiar a configuração de quem cancelou.

Cordão trocado: corrija no campo

Quando duas ONUs da mesma CTO trocam de PON no mesmo minuto, eu não mexo na OLT. Peço para a equipe que estava na caixa voltar os cordões para a posição original. Reprovisionar as duas resolve o cliente, mas deixa a documentação da rede errada: a CTO passa a ter ONUs de duas PONs, e o próximo diagnóstico de rompimento vai apontar para o lugar errado.

Detectar a troca: autofind e display ont info by-sn

O primeiro sinal costuma ser uma ONU nova no autofind com um SN que você já conhece. Os dois comandos abaixo rodam no modo config, fora da interface gpon:

enable
config

display ont autofind all
display ont info by-sn 48575443B5C6D7E8

O display ont autofind all lista as ONUs que pedem autorização. Leia o F/S/P, que é a PON nova, o modelo em Ont EquipmentID e o Ont autofind time, que diz quando a ONU apareceu ali. Saída de exemplo, resumida:

  Number              : 1
  F/S/P               : 0/1/3
  Ont SN              : 48575443B5C6D7E8 (HWTC-B5C6D7E8)
  Ont Version         : 1A2B.A
  Ont EquipmentID     : EG8145V5
  Ont autofind time   : 2026-10-11 14:09:35-03:00
  The number of GPON autofind ONT is 1

O horário do autofind é a melhor pista para achar quem mexeu na rede. Eu cruzo esse horário com as ordens de serviço abertas para a região naquele dia. Na maioria das vezes, a troca bate com uma equipe que estava na caixa minutos antes.

A ONU continua registrada na PON antiga

Aqui está o detalhe que mais confunde. A ONU movida fisicamente não some da PON antiga: ela continua registrada lá, offline, enquanto aparece no autofind da nova. O display ont info by-sn mostra isso. Exemplo resumido, só com os campos que interessam:

  F/S/P                   : 0/1/2
  ONT-ID                  : 5
  Run state               : offline
  Description             : CLI0001_JOAO_RUA_A_123
  Last down cause         : LOSi/LOBi
  Service profile name    : SRV_EG8145V5

A ONT 5 da PON 0/1/2 está offline com LOSi/LOBi, porque alguém tirou a fibra dela. Para entender essa leitura em detalhe, veja o guia de ONU com LOS ou offline. Rode o by-sn sempre fora da interface gpon: dentro dela a MA5800 responde Parameter error, o que não quer dizer que o SN não exista.

Uma consequência prática: enquanto o registro antigo existir, você não consegue adicionar a ONU na PON nova. O ont add falha com SN already exists. Por isso a ordem do roteiro é sempre remover primeiro e adicionar depois.

Salvar a configuração antes de apagar

Para mover ONU de PON sem perder nada, você precisa anotar tudo o que vai sumir com o ont delete. São duas leituras na posição antiga:

display ont info 0 1 2 5
display service-port port 0/1/2 ont 5

Do display ont info eu anoto a descrição, o line profile e o service profile; o exemplo acima foi resumido e mostra só o service profile. O Service profile name diz o modelo para o qual a ONU foi cadastrada. Se você não lembra a diferença entre os dois perfis, o guia de line profile e service profile explica o papel de cada um. Do display service-port saem os índices, as VLANs, as GEM ports e as traffic tables. Exemplo, com as colunas alinhadas de forma aproximada:

 INDEX VLAN VLAN   PORT F/ S/ P VPI VCI FLOW  FLOW RX  TX  STATE
       ID   ATTR   TYPE                  TYPE  PARA
 ---------------------------------------------------------------
    58  100 common gpon 0/1 /2  5   1   vlan  100  46  47  down
    59   40 common gpon 0/1 /2  5   2   vlan  40   45  45  down

O PPPoE configurado por OMCI não aparece nessas duas saídas. Eu pego usuário e senha no cadastro do cliente, no sistema de gestão do provedor, antes de começar. Se você provisiona por script, guarde o script usado em cada ONU: refazer a partir dele é mais seguro do que reconstruir na mão.

Remover a ONU da PON antiga

Para mover ONU de PON, a remoção segue a mesma ordem de um deprovisionamento comum: primeiro os service-ports, depois a ONU. O passo a passo completo, com as variações, está no guia de como deletar ONU na OLT Huawei.

undo service-port 58
undo service-port 59
interface gpon 0/1
ont delete 2 5
quit

Linha a linha: os dois undo service-port apagam o serviço de dados e o de gestão pelo índice anotado. Rode no modo config, fora da interface. O interface gpon 0/1 entra na placa do slot 1. O ont delete 2 5 apaga a ONT 5 da PON 2. O quit volta para o config. Os índices mudam de uma ONU para outra: nunca copie o undo service-port de um chamado antigo sem rodar o display antes.

Adicionar a ONU na nova PON e refazer o serviço

Ao mover ONU de PON, esta é a metade do trabalho que o cliente sente. Antes do ont add, duas conferências rápidas: a VLAN de dados existe e o SN já não está registrado em lugar nenhum.

display vlan 100
display ont info by-sn 48575443B5C6D7E8

Se o by-sn ainda mostrar a posição antiga, o ont delete não passou. Com as duas respostas certas, adicione a ONU na PON 3 usando os mesmos perfis e a mesma descrição:

interface gpon 0/1
ont add 3 sn-auth "48575443B5C6D7E8" omci ont-lineprofile-name "LINE_FTTH_PADRAO" ont-srvprofile-name "SRV_EG8145V5" desc "CLI0001_JOAO_RUA_A_123"
quit

  Number of ONTs that can be added: 1, success: 1
  PortID :3, ONTID :7

O segundo bloco é a resposta de exemplo do ont add. O ONTID que a OLT devolve é o número novo da ONU, e ele quase nunca é igual ao antigo. No exemplo, a ONT 5 da PON 2 virou ONT 7 da PON 3. Todo comando seguinte usa a posição nova: PON 3, ONT 7. Este é o ponto em que a maioria dos erros acontece, porque quem copia o script antigo leva junto o número velho.

WAN e portas da ONU roteadora

Se a ONU é roteadora e o PPPoE é configurado pela OLT, refaça a WAN com a posição nova. Os comandos são os mesmos do provisionamento, explicados um a um no guia de como provisionar ONU na OLT Huawei:

interface gpon 0/1
ont ipconfig 3 7 ip-index 0 pppoe vlan 100 priority 0 user-account username "joao123" password "senha123"
ont ipconfig 3 7 ip-index 1 dhcp vlan 40 priority 2
ont internet-config 3 7 ip-index 0
ont wan-config 3 7 ip-index 1 profile-name "WAN-NAT"
ont port route 3 7 eth 1-4 enable
quit

O ip-index 0 é a WAN PPPoE do cliente na VLAN 100. O ip-index 1 é a WAN de gestão por DHCP na VLAN 40, que leva a ONU até o servidor TR-069. O internet-config marca a WAN de internet, o wan-config aplica o perfil de NAT e o port route libera as portas LAN em modo roteado. Em ONU bridge, pule este bloco. No lugar dele, dentro da interface gpon 0/1, rode ont port native-vlan 3 7 eth 1 vlan 100 priority 0 e depois crie só o service-port de dados.

Service-ports na posição nova

service-port vlan 100 gpon 0/1/3 ont 7 gemport 1 multi-service user-vlan 100 tag-transform translate inbound traffic-table name PLANO_1G_UP outbound traffic-table name PLANO_1G_DOWN
service-port vlan 40 gpon 0/1/3 ont 7 gemport 2 multi-service user-vlan 40 tag-transform translate inbound traffic-table name GESTAO outbound traffic-table name GESTAO
save

Os service-ports usam as VLANs, as GEM ports e as traffic tables anotadas antes, agora apontando para gpon 0/1/3 ont 7. O save grava a configuração. Sem ele, um reboot da OLT devolve a ONU para o autofind.

TR-069 devolve o Wi-Fi e o resto

O último passo de mover ONU de PON acontece sozinho, se o ACS estiver bem configurado. Com a WAN de gestão de pé, a ONU volta a falar com o servidor TR-069. No GenieACS, o identificador do equipamento é formado pelo fabricante, pelo modelo e pelo número de série. A PON não entra nessa conta, então o ACS reconhece a ONU como o mesmo equipamento de antes.

Se o seu ACS aplica Wi-Fi, senha de administração ou outros parâmetros por provision ligada ao equipamento, eles voltam no primeiro inform depois da troca. Confira no ACS o horário do último inform e se a provision rodou sem erro. A configuração do servidor e das provisions está no guia de GenieACS e TR-069 para ONU Huawei.

Conferir o serviço e fechar o chamado

display ont info 0 1 3 7
display service-port port 0/1/3 ont 7
display ont wan-info 0/1 3 7

No display ont info, a ONU tem de estar online, com Config state normal e Match state match. failed indica perfil que não foi aplicado e mismatch indica modelo diferente do service profile. No display service-port, os dois serviços têm de aparecer com up. O display ont wan-info mostra se o PPPoE autenticou e se a WAN de gestão pegou IP.

Checklist do NOC para mover ONU de PON

O último item é o que mais fica para trás. Se o cadastro continua dizendo que a ONU está na CTO antiga, o próximo alarme de PON vai contar essa ONU no lugar errado.

O que aprendi automatizando as trocas de PON

Montar a tela de trocas de PON no meu sistema me obrigou a escrever regras para o que antes eu resolvia de cabeça. Algumas valem para quem precisa mover ONU de PON pelo CLI.

• Mover sem refazer o serviço não é mover. A rotina de mover ONU de PON do meu sistema apaga a posição antiga e faz o ont add na nova, com um aviso para recriar os service-ports. A ONU sobe online e o cliente continua sem internet até alguém refazer o serviço. Por isso o roteiro deste guia só termina com o serviço conferido.
• Voltar para a PON antiga não prova nada. Como a ONU movida continua registrada offline na posição antiga, só considero a troca corrigida quando ela está online lá. Estar cadastrada não basta.
• Ler o rodapé do autofind. Com a OLT carregada, a saída pode chegar cortada. Eu só confio na leitura quando a linha The number of GPON autofind ONT is N bate com a quantidade de ONUs listadas.
• Cadastro de CTO envelhece. Num mês de levantamento, cerca de uma em cada cinco ONUs autorizadas estava numa PON diferente da registrada para a CTO dela. Metade era cadastro desatualizado, não troca. Antes de mover ONU de PON por causa do cadastro, confirme no campo.

Erros comuns ao mover ONU de PON

Quase todo erro ao mover ONU de PON vem de pular uma etapa do roteiro:

• Rodar ont add antes do ont delete. A OLT responde SN already exists porque a ONU ainda está registrada na PON antiga.
• Usar o ONTID antigo nos comandos novos. O número muda na nova PON. Leia o ONTID da saída do ont add.
• Apagar sem anotar. Depois do undo service-port, VLAN e traffic table daquela ONU não aparecem em lugar nenhum da OLT.
• Reprovisionar cordão trocado. Resolve o cliente e bagunça a documentação da CTO.
• Copiar a VLAN numa rede com VLAN por PON. O service-port sobe, mas o tráfego cai na VLAN errada.
• Rodar by-sn dentro da interface gpon. O Parameter error não significa que a ONU não existe.
• Esquecer o save. Um reboot da OLT desfaz o trabalho.

Perguntas frequentes

Dá para mover ONU de PON sem apagar e adicionar de novo?

Pelo roteiro que eu uso, não. A posição faz parte do registro da ONU e dos service-ports, então a troca é feita removendo a posição antiga e adicionando na nova. O que você preserva é a configuração, anotada antes e reaplicada depois.

Por que a ONU aparece no autofind se ela já está cadastrada?

Porque ela está cadastrada em outra PON. A OLT autoriza o SN numa porta específica; em qualquer outra porta ele é desconhecido e vai para o autofind. Na porta antiga, a mesma ONU fica offline.

O ONTID muda quando a ONU troca de PON?

Normalmente muda, porque cada PON tem a sua numeração. Use o ONTID que a OLT devolve no ont add em todos os comandos seguintes.

O cliente perde a configuração do Wi-Fi?

Depende de onde ela está guardada. Se o ACS aplica o Wi-Fi por provision, ele volta no primeiro inform depois da troca. Confira o inform no ACS antes de fechar o chamado.

Duas ONUs trocaram de PON ao mesmo tempo. O que fazer?

Desconfie de cordões invertidos na CTO. Peça para a equipe de campo voltar os cordões para a posição original em vez de reprovisionar as duas pela OLT.

Conclusão

Mover ONU de PON na OLT Huawei é um trabalho de ordem e de anotação. Confirme a troca, decida se ela deveria ter acontecido, anote perfis e service-ports, remova a posição antiga, adicione na nova com o ONTID que a OLT devolver e confira o serviço até o ACS. O save fecha a parte da OLT, e o cadastro da CTO fecha a parte da documentação.

Com esse roteiro, a troca deixa de ser um reprovisionamento feito às pressas e vira um procedimento de poucos minutos, sem cliente esperando. Se a ONU não subir na nova PON, o problema já não é de cadastro: volte ao diagnóstico de sinal e de causa de queda.