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.

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).

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.

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

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.

A execução do Script no provisionamento é separada em alguns passos, sendo eles:

1. Ambiente (env):
   1. 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;
2. Adicionar ONU (add_onu)
   1. 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;
3. Habilitar Internet (enable_internet)
   1. 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;
4. VoIP (voip):
   1. Etapa adicional, executada apenas em casos onde a conexão do cliente tenha 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.

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:

1. Parceiro Rede Neutra
2. Escopo de OLTs
3. Escopo de ONUs

Os filtros utilizam o operador 'AND', ou seja, o Script será executado somente quando TODAS as condições forem cumpridas.

Válido para portais com licença Rede Neutra habilitada. Permite associar o Script implementado a um Parceiro Rede Neutra específico.

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

Indica a quais Modelos de ONU o Script será atribuído. É possível escolher N Modelos.

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.

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.

Os scripts fornecidos aqui estão escritos da seguinte forma:

## Ambiente ##

<Objeto JSON>

## Adicionar ONU ##

<Script de OLT>

## Habilitar Internet ##

<Script de OLT>

## VoIP ##

<Script de OLT>

Nas OLTs Datacom é possível apenas criar Scripts de provisionamento CLI. Exemplos utilizam profiles Int6, que são criados nas OLTs automaticamente.

Apenas VLAN de Internet mapeada em todas as portas ETH.

## Adicionar ONU ##

conf t
 interface gpon {{ chassis }}/{{ slot }}/{{ port }}
  onu {{ onu }}
  name {{ description }}
  serial-number {{ short_serial }}
  service-profile INT6-SRV line-profile INT6-LINE-BRIDGE
  ethernet 1
   negotiation
   no shutdown
   native vlan vlan-id {{ vlan }}
 top
 commit
exit

## Habilitar Internet ##

conf t
  service-port {{ service_port }} gpon {{ chassis }}/{{ slot }}/{{ port }} onu {{ onu }} gem 3 match vlan vlan-id {{ vlan }} action vlan replace vlan-id {{ vlan }}
  exit
  commit
exit

Apenas VLAN de Internet, sem translate.

## Ambiente ##
{
  "tagged_vlan_required": true,
  "tagged_vlan": {{ vlan }}
}

## Adicionar ONU ##

conf t
 interface gpon {{ chassis }}/{{ slot }}/{{ port }}
  onu {{ onu }}
  name {{ description }}
  serial-number {{ short_serial }}
  service-profile INT6-SRV line-profile INT6-LINE-ROUTER-VLAN
  veip 1
   native vlan vlan-id {{ vlan }}
 top
 commit
exit

## Habilitar Internet ##

conf t
 service-port {{ service_port }} gpon {{ chassis }}/{{ slot }}/{{ port }} onu {{ onu }} gem 3 match vlan vlan-id {{ vlan }} action vlan replace vlan-id {{ vlan }}
 exit
 commit
exit

Exemplos utilizam profiles Int6, criados automaticamente nas OLTs.

Apenas VLAN de Internet na ETH1.

## Adicionar ONU ##
configure terminal

interface gpon_olt-{{ chassis }}/{{ slot }}/{{ port }}
  onu {{ onu }} type i6-ZTE-F601 sn {{ short_serial }}
!
interface gpon_onu-{{ chassis }}/{{ slot }}/{{ port }}:{{ onu }}
  name {{ description }}
  description {{ description }}
  tcont 1 profile i6-1GB
  gemport 1 tcont 1
!
exit

## Habilitar Internet ##
configure terminal
pon-onu-mng gpon_onu-{{ chassis }}/{{ slot }}/{{ port }}:{{ onu }}
  dhcp-ip ethuni eth_0/1 from-internet
  loop-detect ethuni eth_0/1 enable
  service 1 gemport 1 vlan {{ vlan }}
  vlan port eth_0/1 mode tag vlan {{ vlan }}
!
interface vport-{{ chassis }}/{{ slot }}/{{ port }}.{{ onu }}:1
  service-port 1 user-vlan {{ vlan }} vlan {{ vlan }}
!
exit

Apenas VLAN de Internet, sem translate.

## Ambiente ##
{
  "tagged_vlan_required": true,
  "tagged_vlan": {{ vlan }}
}

## Adicionar ONU ##
configure terminal

interface gpon_olt-{{ chassis }}/{{ slot }}/{{ port }}
  onu {{ onu }} type i6-ZTE-F670L sn {{ short_serial }}
!
interface gpon_onu-{{ chassis }}/{{ slot }}/{{ port }}:{{ onu }}
  name {{ description }}
  description {{ description }}
  tcont 1 profile i6-1GB
  gemport 1 tcont 1
!
exit

## Habilitar Internet ##
configure terminal

pon-onu-mng gpon_onu-{{ chassis }}/{{ slot }}/{{ port }}:{{ onu }}
  service 1 gemport 1 vlan {{ vlan }}
!
interface vport-{{ chassis }}/{{ slot }}/{{ port }}.{{ onu }}:1
  service-port 1 user-vlan {{ vlan }} vlan {{ vlan }}
!
exit

Exemplos utilizam profiles Int6, criados automaticamente nas OLTs.

Apenas VLAN de Internet na ETH1.

## Adicionar ONU ##
configure terminal
 interface gpon-olt_{{ chassis }}/{{ slot }}/{{ port }}
  onu {{ onu }} type i6-ZTE-F601 sn {{ short_serial }}
 exit
 interface gpon-onu_{{ chassis }}/{{ slot }}/{{ port }}:{{ onu }}
  name {{ description }}
  description {{ description }}
  sn-bind enable sn
  tcont 1 profile i6-1GB
  gemport 1 tcont 1
  service-port 1 vport 1 user-vlan {{ vlan }} vlan {{ vlan }}
 exit
exit

## Habilitar Internet ##
config t
 pon-onu-mng gpon-onu_{{ chassis }}/{{ slot }}/{{ port }}:{{ onu }}
  flow mode 1 tag-filter vlan-filter untag-filter discard
  flow 1 pri 0 vlan {{ vlan }}
  gemport 1 flow 1
  switchport-bind switch_0/1 veip 1
  loop-detect ethuni eth_0/1 enable
  vlan port eth_0/1 mode tag vlan {{ vlan }}
 exit
exit

Apenas VLAN de Internet, sem translate.

## Ambiente ##
{
  "tagged_vlan_required": true,
  "tagged_vlan": {{ vlan }}
}

## Adicionar ONU ##
config t
 interface gpon-olt_{{ chassis }}/{{ slot }}/{{ port }}
  onu {{ onu }} type i6-ZTE-F670L sn {{ short_serial }}
 exit
 interface gpon-onu_{{ chassis }}/{{ slot }}/{{ port }}:{{ onu }}
  name {{ description }}
  description {{ description }}
  sn-bind enable sn
  tcont 1 profile i6-1GB
  gemport 1 tcont 1
  service-port 1 vport 1 user-vlan {{ vlan }} vlan {{ vlan }}
 exit
exit

## Habilitar Internet ##
config t
 pon-onu-mng gpon-onu_{{ chassis }}/{{ slot }}/{{ port }}:{{ onu }}
  service 1 gemport 1 vlan {{ vlan }}
  switchport-bind switch_0/1 iphost 1
  switchport-bind switch_0/1 veip 1
 exit
exit

Válido para OLTs Fiberhome com gerenciador UNM/ANM associado, e Modelos de OLT Fiberhome AN5516 (via ANM2000), Fiberhome AN5516 (via ANM2000) e Fiberhome AN6000 (via UNM2000).

Apenas VLAN de Internet na ETH1.

## Adicionar ONU ##
ADD-ONU::OLTID={{ olt }},PONID=NA-NA-{{ slot }}-{{ port }}:CTAG::AUTHTYPE=MAC,ONUID={{ short_serial }},ONUTYPE={{ onu_model }},ONUNO={{ onu }},NAME={{ description }};

## Habilitar Internet ##
CFG-LANPORTVLAN::OLTID={{ olt }},PONID=NA-NA-{{ slot }}-{{ port }},ONUIDTYPE=MAC,ONUID={{ short_serial }},ONUPORT=NA-NA-NA-1:CTAG::CVLAN={{ vlan }},CCOS=0;

Apenas VLAN de Internet, sem translate.

## Ambiente ##
{
  "tagged_vlan_required": true,
  "tagged_vlan": {{ vlan }}
}

## Adicionar ONU ##
ADD-ONU::OLTID={{ olt }},PONID=NA-NA-{{ slot }}-{{ port }}:CTAG::AUTHTYPE=MAC,ONUID={{ short_serial }},ONUTYPE={{ onu_model }},ONUNO={{ onu }},NAME={{ description }};

## Habilitar Internet ##
CFG-VEIPSERVICE::OLTID={{ olt }},PONID=NA-NA-{{ slot }}-{{ port }},ONUIDTYPE=MAC,ONUID={{ short_serial }},ONUPORT=NA-NA-NA-1:CTAG::ServiceId=1,CVLANID={{ vlan }},CCOS=0,ServiceModelProfile=i6VeipTransparent,ServiceType=DATA;

Válido para OLTs Fiberhome sem gerenciador UNM/ANM associado, e Modelo de OLT Fiberhome AN5516.

Exemplos compatíveis com OLTs Fiberhome de Firmware mais recente (RP1000+).

Apenas VLAN de Internet na ETH1.

## Adicionar ONU ##
cd onu
set whitelist phy_addr address {{ short_serial }} password null action add slot {{ slot }} pon {{ port }} onu {{ onu }} type {{ onu_model }}
cd ..

## Habilitar Internet ##
cd onu
cd lan
set epon slot {{ slot }} pon {{ port }} onu {{ onu }} port 1 service number 1
set epon slot {{ slot }} pon {{ port }} onu {{ onu }} port 1 service 1 vlan_mode tag 255 33024 {{ vlan }}
apply onu {{ slot }} {{ port }} {{ onu }} vlan
cd ..
cd ..

Apenas VLAN de Internet, sem translate.

## Ambiente ##
{
  "tagged_vlan_required": true,
  "tagged_vlan": {{ vlan }}
}

## Adicionar ONU ##
cd onu
set whitelist phy_addr address {{ short_serial }} password null action add slot {{ slot }} pon {{ port }} onu {{ onu }} type {{ onu_model }}
cd ..

## Habilitar Internet ##
cd onu
cd lan
set ep {{ slot }} p {{ port }} o {{ onu }} p 1 onuveip 1 33024 {{ vlan }} 0 33024 65535 65535 33024 65535 65535 0 1 65535
cd ..
cd ..

Válido para OLTs Fiberhome com gerenciador UNM/ANM associado, e Modelos de OLT Fiberhome AN5516 (via ANM2000), Fiberhome AN5516 (via ANM2000) e Fiberhome AN6000 (via UNM2000).

Na versão 25.01.1 do Portal foi introduzida a possibilidade de realizar a definição de Scripts GPON mistos em OLT Fiberhome, isto é, CLI e TL1 no mesmo Script!

## Adicionar ONU ##
<cli>
Comandos CLI aqui
</cli>
<tl1>
Comandos TL1 aqui
</tl1>
<cli>
Comandos CLI aqui
</cli>

## Habilitar Internet ##
<tl1>
Comandos TL1 aqui
</tl1>
<cli>
Comandos CLI aqui
</cli>
<tl1>
Comandos TL1 aqui
</tl1>

Note acima que é possível, num mesmo Passo/Opção, executar CLI → TL1 → CLI ou TL1 → CLI → TL1.

Pontos relevantes:

• As sessões CLI e TL1 são reaproveitadas, portanto valem as considerações pontuadas em Passos/Opções;
• Não há limite de TAGs CLI/TL1 por Passo/Opção;

Na Parks as configurações de VLAN ficam dentro do flow-profile e vlan-translation-profile, uma sugestão é substituir a variável vlan no nome dos perfis.

Exemplo: “onu {{ short_serial }} flow-profile profile_V{{ vlan }}”

VLAN depende dos profiles utilizados.

## Adicionar ONU ##
configure t
 interface gpon{{ slot }}/{{ port }}
  onu add serial-number {{ short_serial }}
  onu {{ short_serial }} alias {{ description }}
 exit
exit

## Habilitar Internet ##
configure t
 interface gpon{{ slot }}/{{ port }}
  onu {{ short_serial }} flow-profile NOME-DO-FLOWPROFILE-AQUI
  onu {{ short_serial }} vlan-translation-profile NOME-DO-VLANTRANSPROFILE-AQUI
 exit
exit

VLAN depende dos profiles utilizados.

## Ambiente ##
{
  "tagged_vlan_required": true,
  "tagged_vlan": {{ vlan }} ou VLAN-ID-AQUI
}

## Adicionar ONU ##
configure t
 interface gpon{{ slot }}/{{ port }}
  onu add serial-number {{ short_serial }}
  onu {{ short_serial }} alias {{ description }}
  onu {{ short_serial }} ethernet-profile auto-on uni-port 1
 exit
exit

## Habilitar Internet ##
configure t
 interface gpon{{ slot }}/{{ port }}
  onu {{ short_serial }} flow-profile NOME-DO-FLOWPROFILE-AQUI
 exit
exit

Exemplos utilizam profiles Int6, criados automaticamente nas OLTs.

Apenas VLAN de Internet mapeada em todas as portas ETH.

## Adicionar ONU ##
config
 interface gpon {{ chassis }}/{{ slot }}
  ont add {{ port }} {{ onu }} sn-auth {{ serial }} omci ont-lineprofile-name INT6-LINE ont-srvprofile-name INT6-SRV desc "{{description}}"
 quit
quit

## Habilitar Internet ##
config
 service-port {{ service_port }} vlan {{ vlan }} gpon {{ ponlink }} ont {{ onu }} gemport 0 multi-service user-vlan 1 tag-transform translate
quit

Apenas VLAN de Internet, translate para a VLAN 1.

## Ambiente ##
{
  "tagged_vlan_required": true,
  "tagged_vlan": 1
}

## Adicionar ONU ##
config
 interface gpon {{ chassis }}/{{ slot }}
  ont add {{ port }} {{ onu }} sn-auth {{ serial }} omci ont-lineprofile-name INT6-LINE-ROUTER-VLAN ont-srvprofile-name INT6-SRV desc "{{description}}"
 quit
quit

## Habilitar Internet ##
config
 service-port {{ service_port }} vlan {{ vlan }} gpon {{ ponlink }} ont {{ onu }} gemport 0 multi-service user-vlan 1 tag-transform translate
quit

Exemplos utilizam profiles Int6, criados automaticamente nas OLTs.

Neste Modelo de OLT só está disponível o provisionamento via TL1.

Apenas VLAN de Internet na ETH1.

## Adicionar ONU ##
ENT-ONT::ONT-1-1-{{ slot }}-{{ port }}-{{ onu }}::::DESC1="{{ description }}",DESC2="{{ description }}",SERNUM={{ short_serial }},SWVERPLND=DISABLED,OPTICSHIST=ENABLE;
ED-ONT::ONT-1-1-{{ slot }}-{{ port }}-{{ onu }}:::::IS;

## Habilitar Internet ##
ENT-ONTCARD::ONTCARD-1-1-{{ slot }}-{{ port }}-{{ onu }}-1:::10_100BASET,1,0::IS;
ENT-LOGPORT::ONTL2UNI-1-1-{{ slot }}-{{ port }}-{{ onu }}-1-1:::;
SET-QOS-USQUEUE::ONTL2UNIQ-1-1-{{ slot }}-{{ port }}-{{ onu }}-1-1-0::::USBWPROFNAME=INT6_1G_UP;
ED-ONTVEIP::ONTVEIP-1-1-{{ slot }}-{{ port }}-{{ onu }}-1-1:::::IS;
SET-VLANPORT::ONTL2UNI-1-1-{{ slot }}-{{ port }}-{{ onu }}-1-1:::MAXNUCMACADR=32,CMITMAXNUMMACADDR=1;
ENT-VLANEGPORT::ONTL2UNI-1-1-{{ slot }}-{{ port }}-{{ onu }}-1-1:::0,{{ vlan }}:PORTTRANSMODE=UNTAGGED;
SET-VLANPORT::ONTL2UNI-1-1-{{ slot }}-{{ port }}-{{ onu }}-1-1:::DEFAULTCVLAN={{ vlan }};

Apenas VLAN de Internet, sem translate.

## Ambiente ##
{
  "tagged_vlan_required": true,
  "tagged_vlan": {{ vlan }}
}

## Adicionar ONU ##
ENT-ONT::ONT-1-1-{{ slot }}-{{ port }}-{{ onu }}::::DESC1="{{ description }}",DESC2="{{ description }}",SERNUM={{ short_serial }},SWVERPLND=AUTO,OPTICSHIST=ENABLE,PLNDCFGFILE1=AUTO,DLCFGFILE1=AUTO,VOIPALLOWED=VEIP;
ED-ONT::ONT-1-1-{{ slot }}-{{ port }}-{{ onu }}:::::IS;

## Habilitar Internet ##
ENT-ONTCARD::ONTCARD-1-1-{{ slot }}-{{ port }}-{{ onu }}-14:::VEIP,1,0::IS;
ENT-LOGPORT::ONTL2UNI-1-1-{{ slot }}-{{ port }}-{{ onu }}-14-1:::;
ED-ONTVEIP::ONTVEIP-1-1-{{ slot }}-{{ port }}-{{ onu }}-14-1:::::IS;
SET-QOS-USQUEUE::ONTL2UNIQ-1-1-{{ slot }}-{{ port }}-{{ onu }}-14-1-0::::USBWPROFNAME=INT6_1G_UP;
SET-VLANPORT::ONTL2UNI-1-1-{{ slot }}-{{ port }}-{{ onu }}-14-1:::MAXNUCMACADR=4,CMITMAXNUMMACADDR=1;
ENT-VLANEGPORT::ONTL2UNI-1-1-{{ slot }}-{{ port }}-{{ onu }}-14-1:::0,{{ vlan }}:PORTTRANSMODE=SINGLETAGGED;

Script GPON ainda não foi desenvolvido para este modelo, para mais informações entrar em contato através dos canais de suporte.

Este Modelo de OLT não possui interface TL1.

Equipamento possui autorização automática, portanto Passo/Opção Adicionar ONU não é necessário.

TO-DO

TO-DO

Equipamento possui autorização automática, portanto Passo/Opção Adicionar ONU não é necessário.

TO-DO

VLAN depende dos profiles utilizados.

## Ambiente ##
{
  "tagged_vlan_required": true,
  "tagged_vlan": {{ vlan }} ou VLAN-ID-AQUI
}

## Habilitar Internet ##

configure terminal
 interface gpon {{ slot }}/{{ port }}
  onu-profile {{onu}} NOME-DO-PROFILE-AQUI
  onu description {{ onu }} {{ description }}
  apply
 exit
exit

TO-DO

TO-DO

Apenas VLAN de Internet na ETH1.

## Adicionar ONU ##
configure
 remote ont ont-{{ slot }}-{{ port }}-{{ onu }}
  sn {{ serial }}
  password DEFAULT
  no inactive
  bwgroup 1 usbwprofname PROFILE-AQUI dsbwprofname PROFILE-AQUI
  description {{ description }}
 exit
exit

## Habilitar Internet ##
configure
 remote uniport uniport-{{ slot }}-{{ port }}-{{ onu }}-1-1
  no inactive
  queue tc 0 priority 0 weight 0 usbwprofname PROFILE-AQUI dsbwprofname PROFILE-AQUI dsoption olt bwsharegroupid 1
  vlan {{ vlan }} txtag untag ingprof PROFILE-AQUI
  pvid {{ vlan }}
 exit
exit

Apenas VLAN de Internet, sem translate.

## Ambiente ##
{
  "tagged_vlan_required": true,
  "tagged_vlan": {{ vlan }}
}

## Adicionar ONU ##
configure
 remote ont ont-{{ slot }}-{{ port }}-{{ onu }}
  sn {{ serial }}
  no inactive
  bwgroup 1 usbwprofname PROFILE-AQUI dsbwprofname PROFILE-AQUI
  description {{ description }}
 exit
exit

## Habilitar Internet ##
configure
 remote uniport uniport-{{ slot }}-{{ port }}-{{ onu }}-2-1
  no inactive
  queue tc 1 priority 0 weight 0 usbwprofname PROFILE-AQUI dsbwprofname PROFILE-AQUI dsoption olt bwsharegroupid 1
  vlan {{ vlan }} txtag tag ingprof PROFILE-AQUI aesencrypt disable
 exit
exit