====== Scripts GPON ====== A funcionalidade de Scripts GPON permite que o provedor personalize os comandos enviados para a OLT e/ou gerenciador durante o processo de provisionamento de ONTs/ONUs. É possível ajustar os comandos para cada etapa do provisionamento e associá-los a diferentes combinações de OLTs, ONUs e Parceiros Rede Neutra. ===== Permissões necessárias ===== {{:videos:pasted:20250131-113738.png}} Para acesso a página e visualização dos Scripts o usuário deve ter a permissão ''Gpon Scripts (Read)'' e para a edição ''Gpon Scripts (Write)''. ===== Como acessar? ===== Considerando que o usuário tenha as permissões necessárias, a tela de Scripts GPON pode ser acessada através do menu lateral, em ''Infra GPON -> Scripts''. ===== Campos da Tabela ===== {{:videos:pasted:20250131-113627.png}} Na página principal dos Scripts GPON há uma tabela que exibe os Scripts criados no Portal. Abaixo segue o significado de cada coluna: * **ID**: ID do Script no BD do Portal * **Nome**: Nome do Script * **Descrição**: Descrição do Script * **Passos**: Indica quais passos/opções o Script contempla * **OLTs**: Se associação do Script por OLT, indica quais * **Modelos de OLT**: Se associação do Script por Modelo de OLT, indica quais * **ONUs**: Indica a quais Modelos de ONU o Script está associado \\ ====== Criação de Scripts ====== {{:videos:pasted:20250131-113457.png}} A criação de Scripts GPON exige conhecimento da interface TL1 e/ou CLI das OLTs as quais se deseja realizar a personalização. Hoje não há nenhuma trava indicando quais comandos são permitidos para cada Modelo de OLT, portanto o desenvolvimento de Scripts deve estar habilitado apenas para colaboradores com experiência. A execução de comandos indevidos pode resultar na parada dos serviços. ===== Passos/Opções ===== A execução do Script no provisionamento é separada em alguns passos, sendo eles: - **Ambiente** (env): - Objeto JSON com variáveis de ambiente do Script, com possibilidade de definir qual VLAN o APP irá configurar na WAN do Roteador/ONT __nos casos onde o técnico acessa o WIFI padrão do dispositivo para configuração__; - **Adicionar ONU** (add_onu) - Primeira etapa do provisionamento, onde a ONU/ONT é autorizada na OLT, já permitindo a coleta de potência, porém a navegação ainda está bloqueada; - **Habilitar Internet** (enable_internet) - Segunda etapa do provisionamento, onde o restante dos comandos de provisionamento são enviados a OLT. Com a execução destes comandos a ONU/ONT já deve conseguir enviar e receber pacotes na VLAN de dados; - **VoIP** (voip): - Etapa adicional, executada apenas em casos onde a conexão do cliente tenha [[autoisp:telefonia#habilitar_a_telefonia_em_um_assinante|dados SIP preenchidos]]. > Nas etapas que envolvem o acesso à OLT, é importante garantir que, ao final do Script, ele esteja na raiz da OLT (fora do ''configure''), pois em alguns casos a sessão com a OLT é reaproveitada. ===== Associação ===== A associação é a maneira na qual podemos indicar ao Portal em quais situações o Script desenvolvido será executado. Hoje há 3 possibilidades de filtro: - **Parceiro Rede Neutra** - **Escopo de OLTs** - **Escopo de ONUs** > Os filtros utilizam o operador 'AND', ou seja, o Script será executado somente quando **TODAS** as condições forem cumpridas. ==== Parceiro Rede Neutra ==== Válido para portais com licença ''Rede Neutra'' habilitada. Permite associar o Script implementado a um Parceiro Rede Neutra específico. ==== Escopo de OLTs ==== Indica a quais OLTs o Script será atribuído. Existem duas formas de realizar o filtro: * **Por Modelo de OLT**: * Qualquer OLT cadastrada no Portal com os modelos selecionados. * **Por OLT**: * Filtro por OLTs específicas ==== Escopo de ONUs ==== Indica a quais Modelos de ONU o Script será atribuído. É possível escolher N Modelos. ===== Variáveis ===== No desenvolvimento de Scripts GPON de acesso à OLT é possível inserir variáveis, que durante o provisionamento são substituídas por valores daquela instalação em específico. A lista de variáveis disponíveis pode ser encontrada ao lado direito da caixa de texto. Abaixo são apresentadas as mais relevantes. ^ Variável ^ Exemplo ^ Observações ^ |acs_url|https://acs.int6tech.com.br:7547|URL de ACS configurada no Portal| |chassis|0|ID do chassis| |description|int6-2325|Descrição da ONU. Para customização, entrar em contato| |internal_ip|192.168.5.2|''IP Interno'' da OLT. Válido para OLTs Fiberhome com gerenciador ANM/UNM| |mac|18:3D:5E:7C:D7:B1|MAC da ONU, utilizado em provisionamentos EPON| |olt|192.168.15.2|''Endereço IP'' da OLT| |onu|127|ONUID| |onu_model|HG260|''Tipo (para OLT Fiberhome)'' do Modelo de ONU| |onu_name|HG8145V5|''Nome'' do Modelo de ONU| |outer_vlan|2000|''VLAN QinQ / outer VLAN'' do Perfil de VLAN que atende o provisionamento. Válido para OLTs Huawei| |port|15|ID do PON| |pots_1_password|as32rg|Porta FXS 1: Senha SIP| |pots_1_profile|SIP_INT6|Porta FXS 1: ''Nome'' do Perfil SIP| |pots_1_server|192.168.100.10|Porta FXS 1: ''IP do Servidor'' do Perfil SIP| |pots_1_username|5135000000|Porta FXS 1: Usuário SIP| |pots_1_vlan|25|Porta FXS 1: ''VLAN'' do Perfil SIP| |pots_2_password|9ad123j|Porta FXS 2: Senha SIP| |pots_2_profile|SIP_INT6|Porta FXS 2: ''Nome'' do Perfil SIP| |pots_2_server|192.168.100.10|Porta FXS 2: ''IP do Servidor'' do Perfil SIP| |pots_2_username|5130000000|Porta FXS 2: Usuário SIP| |pots_2_vlan|25|Porta FXS 2: ''VLAN'' do Perfil SIP| |pppoe_password|senhaint6123|Senha PPPoE| |pppoe_username|int6pppoe2@int6tech|Usuário PPPoE| |serial|485754431815509E|Numero de Série da ONU no formato longo (hexadecimal). Utilizado em OLTs Huawei| |service_port|16999|Service Port. Para uso em OLTs Huawei e Datacom| |short_serial|HWTC1815509E|Numero de Série da ONU no formato curto.| |slot|4|ID do SLOT| |vlan|2600|''VLAN'' do Perfil de VLAN que atende o provisionamento| |vlan_dhcp|2500|''VLAN DHCP'' do Perfil de VLAN que atende o provisionamento| |vlan_iptv|2501|''VLAN IPTV'' do Perfil de VLAN que atende o provisionamento| |vlan_mgmt|2502|''VLAN de Gerência'' do Perfil de VLAN que atende o provisionamento| |vlan_tr69|2503|''VLAN do TR069'' do Perfil de VLAN que atende o provisionamento| |vlan_voice|2504|''VLAN de telefonia'' do Perfil de VLAN que atende o provisionamento. Não é necessário ter [[autoisp:telefonia#habilitar_a_telefonia_em_um_assinante|dados SIP preenchidos]].| |wifi_password|12345678|Senha do WIFI 2.4G| |wifi_password_5g|12345678|Senha do WIFI 5G| |wifi_ssid|teste_int6|SSID do WIFI 2.4G| |wifi_ssid_5g|teste_int6_5G|SSID do WIFI 5G| |i6VeipTag|1|Retorna o ID do Service Model Profile ''i6VeipTag''. Válido para OLTs Fiberhome, utilizado normalmente no provisionamento via CLI.| |i6VeipTransparent|2|Retorna o ID do Service Model Profile ''i6VeipTransparent''. Válido para OLTs Fiberhome, utilizado normalmente no provisionamento via CLI.| |i6VeipTranslate|3|Retorna o ID do Service Model Profile ''i6VeipTranslate''. Válido para OLTs Fiberhome, utilizado normalmente no provisionamento via CLI.| ====== Exemplos ====== Este tópico consolida exemplos de Scripts GPON para cada Modelo de OLT, com o intuito de auxiliar na elaboração de novos Scripts. Há casos ainda não testados, marcados como ''TO-DO''. Caso necessite de algum deles, entre em contato através dos canais de suporte. ===== Sintaxe ===== Os scripts fornecidos aqui estão escritos da seguinte forma: ## Ambiente ## ## Adicionar ONU ##