# Documentação de Variáveis do Sistema IXC Soft para Provisionamento de ONUs

### Introdução
Esta documentação tem como objetivo fornecer uma compreensão clara das variáveis utilizadas nos scripts de provisionamento de ONUs no Sistema. O uso correto dessas variáveis é fundamental para garantir que os scripts funcionem adequadamente e que as ONUs sejam provisionadas de forma eficiente.
### Variáveis Comuns

1. `#onu_numero#`
   - **Descrição**: Representa o número da ONU que está sendo provisionada.
   - **Uso**: O Sistema efetua a substituição pelo número específico da ONU que você deseja configurar. 
   - **Exemplo**: Se a ONU a ser provisionada é a número 12, o script deve incluir `#onu_numero#` como `12`.

2. `#onu_mac#`
   - **Descrição**: Refere-se ao endereço Serial Number da ONU.
   - **Uso**: Deve ser preenchido com o serial number da ONU que está sendo configurada.
   - **Exemplo**: Para uma ONU com MAC `4857544396C3699D`, o script deve incluir `#onu_mac#` como `4857544396C3699D`.
   - **Nota**: O sistema compreende a coleta de acordo com o que a OLT fornece e geralmente é o Serial number.

3.  `#pon#`
   - **Descrição**: Indica a porta de rede na OLT onde a ONU está conectada.
   - **Uso**: Deve ser substituído pelo identificador da porta PON.
   - **Exemplo**: Se a ONU está conectada na porta 0/1, o script deve incluir `#pon#` como `0/1`.
   - **Nota**: Erros nesta variável podem resultar na conexão da ONU na porta errada, causando falhas na rede.

4. `#vlan#`
   - **Descrição**: Representa a VLAN (Virtual Local Area Network) que será utilizada para a ONU.
   - **Uso**: Deve ser preenchido com o número da VLAN que você deseja configurar.
   - **Exemplo**: Para uma VLAN 202, o script deve incluir `#vlan#` como `202`.
   - **Nota**: Certifique-se de que a VLAN está configurada corretamente na rede para evitar problemas de comunicação.

5. `#service_port#`
   - **Descrição**: Refere-se à porta de serviço que será utilizada para a ONU.
   - **Uso**: Deve ser substituído pelo número da porta de serviço.
   - **Exemplo**: Se a porta de serviço é 1405, o script deve incluir `#service_port#` como `1405`.
   - **Nota**: Fique atento para evitar a reutilização de portas de serviço já alocadas.

6. `#pon_id#`
   - **Descrição**: Indica o identificador da porta PON na OLT.
   - **Uso**: Deve ser preenchido com o ID da porta PON.
   - **Exemplo**: Para um PON ID de 0/1/12, o script deve incluir `#pon_id#` como `0/1/12`.
   - **Nota**: Certifique-se de que este ID é compatível com a estrutura de sua OLT.
### Exemplos de Uso
#### Exemplo de Script de Provisionamento
```
interface gpon #pon_id#;
onu #onu_numero#;
serial-number #onu_mac#;
service-port #service_port# vlan #vlan# gpon #pon_id# onu #onu_numero# gemport 1 multi-service user-vlan #vlan# tag-transform translate;
exit;
commit;
```
## Comentários Inline
### Configuração de Interface GPON
#### 1. Configurar a interface GPON

Defina a interface GPON usando o ID da porta PON:

```
interface gpon #pon_id#;
```
### 2. Atribuir a ONU
Atribua o número da ONU na interface definida:

```
onu #onu_numero#;
```
### 3. Configurar o número de série da ONU
Defina o endereço MAC específico para a ONU:

```
serial-number #onu_mac#;
```
### 4. Associar a porta de serviço e VLAN
Configure a porta de serviço e associe a VLAN:

```
service-port #service_port# vlan #vlan#
```
### 5. Configurar a VLAN e gemport
Configure a gemport para serviços de múltiplos usuários e defina as transformações de VLAN:

```
gpon #pon_id# onu #onu_numero# gemport 1 multi-service user-vlan #vlan# tag-transform translate;
```
### 6. Sair do modo de configuração
Finalize a configuração e saia:
```
exit;
```
### 7. Aplicar alterações
Confirme e aplique todas as alterações realizadas:
```
commit;
```
## Notas

- #**pon_id#**: Identificador único da porta PON.
- #**onu_numero**#: Número atribuído à ONU.
- #**onu_mac**#: Endereço MAC específico da ONU.
- #**service_port**#: Porta de serviço associada.
- #**vlan**# Identificação da VLAN a ser usada.
### Solução de Problemas Comuns

- **Erro no MAC Address**: Verifique novamente o MAC fornecido e certifique-se de que está correto.
- **Conflito de Número de ONU**: Assegure que o número fornecido não está em uso pela mesma porta PON.
- **VLAN Incorreta**: Revise as configurações de VLAN no sistema para garantir compatibilidade.
### Considerações de Segurança

- Sempre mantenha os dados sensíveis, como endereços MAC e VLANs, protegidos e acessíveis apenas a pessoas autorizadas.
- Realize provisionamentos em um ambiente seguro para evitar mitigações ou interceptações de dados.
### Conclusão
O uso correto das variáveis é essencial para o sucesso do provisionamento de ONUs no Sistema. Certifique-se de substituir cada variável pelo valor correspondente antes de executar o script. Para mais informações ou dúvidas, entre em contato com o suporte técnico.
## Etiquetas

#RAID #Redundancia #Autorizacao #ClienteFibra #OLT #Transmissores #ArmazenamentoDeDados #ToleranciaAFalhas
## Leia Também

- [[autorizacao de onus|Autorização de ONUs]]
- [[autorizacao em massa|Autorização em massa]]
- [[erro - falha na autorizacao de onu|Erro - Falha na Autorização de ONU]]
- [[autorizacao de onu via rede neutra ixc hub|Autorização de ONU via Rede Neutra IXC Hub]]
- [[perfil para olts|Perfil para OLTs]]
- [[perfil clientes fibra|Perfil de Clientes Fibra]]