### Tutorial de Comandos Essenciais para Gerenciamento de OLT HUAWEI

Este tutorial apresenta os comandos mais utilizados para diagnosticar e gerenciar ONUs em uma OLT Huawei. Utilize este guia como referência para suas atividades diárias.

-----

#### 🔎 1. Buscar ONU por Serial Number (SN) ou Descrição

Para localizar uma ONU específica na OLT, você pode usar o número de série (SN) ou a descrição (login) cadastrada.

##### Pelo Serial Number (SN):

Utilize este comando para encontrar informações da ONU a partir do seu número de série.

```bash
display ont info by-sn #ONU-SN#
```
![wiki_by-sn.png](./wiki_by-sn.png)

  * **\#ONU-SN\#**: Substitua pelo Serial Number completo da ONU (geralmente encontrado na etiqueta do equipamento).

##### Pela Descrição (Login):

Se você cadastrou um login ou uma descrição para a ONU, pode usá-la para a busca.

```bash
display ont info by-desc #ONU-LOGIN#
```
![wiki_by-desc.png](./wiki_by-desc.png)



  * **\#ONU-LOGIN\#**: Substitua pela descrição ou login exato que foi configurado para a ONU.

-----

#### 🔌 2. Verificar o Status da Porta da ONU

Este comando permite verificar o estado das portas Ethernet de uma ONU específica, ajudando a diagnosticar problemas de conectividade física.

```bash
config
interface gpon 0/#SLOT#
display ont port state #PON# #ONU-ID# eth-port [#ETH-NUM#/all]
```

**Passo a passo:**

1.  Acesse o modo de configuração com `config`.
2.  Entre na interface da placa com `interface gpon 0/#SLOT#`.
      * **\#SLOT\#**: Número do slot onde a placa GPON está instalada.
3.  Execute o comando de verificação.
      * **\#PON\#**: Número da porta PON onde a ONU está conectada.
      * **\#ONU-ID\#**: ID da ONU na respectiva porta PON.
      * **[\#ETH-NUM\#/all]**: Especifique o número da porta Ethernet (ex: `1`) ou use `all` para ver todas as portas.

![wiki_status_porta.png](./wiki_status_porta.png)

-----

#### 🌐 3. Consultar o(s) Endereço(s) IP da ONU

Para verificar os endereços IP (IPv4 ou IPv6) que a ONU obteve, seja para gerência (TR-069) ou para a conexão do cliente.

### Informações completas da WAN:

```bash
display ont wan-info 0/#SLOT# #PON# #ONU-ID#
```
![wiki_ip.png](./wiki_ip.png)
##### Filtrando apenas por endereços IPv4:

Este comando é um atalho útil para visualizar rapidamente apenas os endereços IPv4, facilitando a identificação.

```bash
display ont wan-info 0/#SLOT# #PON# #ONU-ID# | include IPv4 add
```
![wiki_ipv4.png](./wiki_ipv4.png)

  * **\#SLOT\#**: Número do slot da placa GPON.
  * **\#PON\#**: Número da porta PON.
  * **\#ONU-ID\#**: ID da ONU.

-----

#### 📡 4. Consultar o Status de uma Porta PON

Verifica o status de todas as ONUs (ou uma específica) dentro de uma porta PON, mostrando quais estão online, offline ou em outros estados.

```bash
config
interface gpon 0/#SLOT#
display port state [#ONU-ID#/all]
```

**Passo a passo:**

1.  Acesse o modo de configuração com `config`.
2.  Entre na interface da placa com `interface gpon 0/#SLOT#`.
3.  Execute o comando.
      * **[\#ONU-ID\#/all]**: Especifique um ID de ONU para ver o status dela ou use `all` para listar todas as ONUs daquela PON.

-----

#### ✨ 5. Consultar a Potência Óptica de uma ONU

Essencial para diagnosticar problemas de sinal. Este comando mostra a potência óptica que a ONU está recebendo da OLT e a potência que a OLT está recebendo da ONU.

```bash
config
interface gpon 0/#SLOT#
display ont optical-info #PON# [#ONU-ID#/all]
```

  * **\#SLOT\#**: Número do slot da placa.
  * **\#PON\#**: Número da porta PON.
  * **[\#ONU-ID\#/all]**: O ID da ONU específica ou `all` para verificar todas as ONUs na PON.

-----

#### 📶 6. Consultar as Potências de Todas as ONUs de uma PON (Resumo)

Para uma visão geral e rápida dos níveis de sinal de todas as ONUs em uma porta PON.

```bash
display ont info summary 0/#SLOT#/#PON#
```

  * **\#SLOT\#**: Número do slot.
  * **\#PON\#**: Número da porta PON.

##### Filtrando apenas por termos especificos:

Existem comandos, como esse, que ao utilizarmos a extenção "Include", podemos gerar filtros adicionais à busca, como o mostrado com "| include IPv4 add" em "🌐 3. Consultar o(s) Endereço(s) IP da ONU".
Mas temos mais opções, abaixo citarei algumas ao usar o comando "display ont info summary 0/#SLOT#/#PON#":

- Para buscar a partir de um termo:

Usando essa variação, pode buscar por resultados que contenham esse termpo, por exemplo:

```bash
display ont info summary 0/#SLOT#/#PON# | include ^  60
```

No caso acima, o comando filtra para incluir qualquer resultado que contenha "duplo espaço, 60", como os resultados do "info summary" tem espaço duplo no inicio, ele vai trazer apenas o ONU ID 60.
No caso acima, se usarmos apenas o "6" ao invés do "60", teremos os ONU ID 6 e do 60 ao 69, pois todos tem "duplo espaço, 6" com ou sem algo após o 6.

- Para buscar a partir de um termo exato:

No caso abaixo, o filtro não irá separa apenas os que incluem o termpo, mas sim o resultado exato para o termo entre aspas

```bash
display ont info summary 0/#SLOT#/#PON# | include "^  6"
```

Nesse caso, o resultado será a busca dentro das aspas, então, a resposta é apenas linhas que contenham "duplo espaço, 6", mas apenas até o 6, sendo assim, do ONU ID 60 para frente, não se enquadra.

-----

#### 🚫 7. Bloquear o Serviço de um Cliente

Este comando remove a `service-port` associada à ONU, efetivamente interrompendo o serviço do cliente (bloqueio) sem remover a ONU da OLT.

```bash
config
undo service-port port 0/#SLOT#/#PON# ont #ONU-ID#
```

  * **\#SLOT\#**: Número do slot.
  * **\#PON\#**: Número da porta PON.
  * **\#ONU-ID\#**: ID da ONU que será bloqueada.

**Nota:** Para reativar o serviço, você precisará recriar a `service-port` com os parâmetros originais do cliente.

-----

#### 🔢 8. Consultar a Quantidade de ONUs por Placa

Útil para ter uma visão geral da ocupação de uma placa GPON.

```bash
display board 0/#SLOT# | include In port
```

  * **\#SLOT\#**: Número do slot da placa que deseja consultar.
  * O comando filtra a saída para mostrar a linha que contém a contagem de ONUs habilitadas e online.

-----

#### 🏷️ 9. Consultar a Descrição das Portas PON de uma Placa

Mostra as descrições que foram configuradas para cada porta PON em uma determinada placa. Ajuda na identificação de áreas, anéis ou concentradores.

```bash
display port desc 0/#SLOT#
```

  * **\#SLOT\#**: Número do slot da placa.

-----

#### 🗑️ 10. Remover Definitivamente uma ONU da OLT

Este é um procedimento de duas etapas que primeiro remove a configuração de serviço e depois apaga a ONU da OLT.

**Passo 1: Remover a `service-port`**
Garante que todos os serviços associados sejam desfeitos.

```bash
config
undo service-port port 0/#SLOT#/#PON# ont #ONU-ID#
```

**Passo 2: Deletar a ONU**
Após remover o serviço, entre na interface GPON e delete a ONU.

```bash
interface gpon 0/#SLOT#
  ont delete #PON# #ONU-ID#
```

  * **\#SLOT\#**: Número do slot.
  * **\#PON\#**: Número da porta PON.
  * **\#ONU-ID\#**: ID da ONU a ser removida.

**Atenção:** Este procedimento remove completamente a ONU. Para reconectá-la, será necessário provisioná-la novamente.

-----

#### 🔄 11. Reinício de ONU

Este comando tem a função de reiniciar remotamente uma ONU, o que pode resolver problemas temporários de conectividade ou configuração.

```bash
config
interface gpon 0/#SLOT#
 ont reset #PON# #ONU-ID#
```

  * **\#SLOT\#**: Número do slot.
  * **\#PON\#**: Número da porta PON.
  * **\#ONU-ID\#**: ID da ONU a ser reiniciada.

-----

#### ⏱️ 12 . Alterar tempo de conexão do usuário

Essa ação tem a função de modificar o tempo limite de inatividade para as sessões de usuário na OLT, o que afeta por quanto tempo uma sessão pode permanecer inativa antes de ser desconectada.

```bash
enable
idle-timeout #MINUTOS#
```

  * **\#MINUTOS\#**: Coloque o tempo que deseja manter a conexão (evite o uso de números altos, 60 é o recomendado)

-----

#### 🔁 13. Trocar ONU sem a necessidade de desautorizar

Este comando é usado para substituir uma ONU existente por uma nova sem a necessidade de desautorizar e reautorizar o serviço, o que agiliza o processo de substituição de hardware.

```bash
config
interface gpon 0/#SLOT#
 ont modify #PON# #ONU-ID# sn #MAC-ID#
```

  * **\#SLOT\#**: Número do slot.
  * **\#PON\#**: Número da porta PON.
  * **\#ONU-ID\#**: ID da ONU a ser trocada.
  * **\#MAC-ID\#**: MAC da nova ONU (utilize o padrão apresentado na OLT).

-----

#### ⚙️ 14. Reset de Fábrica na ONT

Este comando tem a função de restaurar as configurações de fábrica de uma ONT (Optical Network Terminal) remotamente, o que é útil para solucionar problemas complexos ou preparar o dispositivo para um novo uso.

```bash
config
interface gpon 0/#SLOT#
 ont factory-setting-restore #PON# #ONU-ID#
```

  * **\#SLOT\#**: Número do slot.
  * **\#PON\#**: Número da porta PON.
  * **\#ONU-ID\#**: ID da ONU que será resetada.

-----

#### 🌐 14. Liberar acesso remoto da ONT

Este comando realiza a liberação do acesso remoto à ONT via HTTP

```bash
diagnose
ont wan-access http 0/#SLOT#/#PON# #ONU-ID# enable
```

  * **\#SLOT\#**: Número do slot.
  * **\#PON\#**: Número da porta PON.
  * **\#ONU-ID\#**: ID da ONU que deseja realizar a liberação.
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9