Integrando a ONT 142N W com o servidor GenieACS

Este documento tem como objetivo apresentar como levantar um servidor GenieACS utilizando a ferramenta
docker-compose e como realizar configurações básicas na ONT por meio deste servidor

Premissas:
 Uplink já deve estar configurado na OLT e acessível ao servidor GenieACS

DISPOSITIVOS E VERSÕES

Dispositivo Versão de Hardware Versão de Software

GenieACS 1.2.0
GC8B - WKE2.200.012R1P RP1000
OLT FiberHome - AN5516-04B GCOB - WKE2.201.168S1B RP1000
HSUB - WKE2.201.341R1C RP1000
ONT 142N W 1.0 1.0.200710

PREPARANDO O AMBIENTE

Primeiramente será necessário instalar as ferramentas docker e docker-compose. A seguir será explicado como
instalar estas ferramentas tanto no Linux quanto no Windows.

Instalando as ferramentas no Linux

As ferramentas docker e docker-compose devem estar disponíveis no repositório da distribuição utilizada. Neste
sentido, a forma de instalação pode variar de distribuição para distribuição. No Debian 10, ambas as ferramentas
podem ser instaladas com o seguinte comando:

apt install docker.io docker-compose

Instalando as ferramentas no Windows

No Sistema Operacional Microsoft Windows, as ferramentas docker e docker-compose estão disponíveis no Docker
Desktop para Windows. Para instalá-lo, verifique a sua versão do Windows e realize o download do instalador
compatível.

Para saber a sua versão do Windows, vá até o menu iniciar e digite Informações do Sistema. Na janela que abrir,
verifique na segunda coluna o valor dos campos Nome do Sistema Operacional e Versão. O número da versão
poderá ser útil nas próximas etapas.

Se a sua versão do Windows é o Windows 10 Pro, Enterprise ou Education, realize o download e instalação do
programa seguindo as instruções em https://docs.docker.com/docker-for-windows/install/. Se a sua versão do

intelbras.com.br
Sistema Operacional é o Windows 10 Home, realize o download e instalação do programa seguindo as instruções em
https://docs.docker.com/docker-for-windows/install-windows-home/. Neste documento, o Sistema Operacional
utilizado é o Microsoft Windows 10 Home versão 10.0.19041 Compilação 19041 e o Docker Desktop for Windows é o
2.3.0.5.

Caso, no início da instalação do docker, algum pré-requisito de versão não esteja satisfeito conforme ilustrado na
figura abaixo, provavelmente há alguma atualização do Windows pendente. Certifique-se de que todas as
atualizações do Sistema Operacional tenham sido realizadas e reinicie-o conforme for solicitado durante o processo
para que o Docker Desktop for Windows possa ser instalado em seguida. Este processo pode ser um pouco
demorado e o sistema pode ser reiniciado várias vezes.

Durante a instalação do Docker Desktop for Windows, após a reinicialização do computador, é possível que apareça
uma mensagem informando que o WSL 2 não foi instalado corretamente. Para solucionar este problema, siga os
passos descritos no link fornecido na própria mensagem de erro. Nas versões de Windows e Docker usadas durante
a escrita deste documento, o usuário foi direcionado para seguir as instruções na página https://docs.microsoft.com/
en-us/windows/wsl/install-win10#step-4---download-the-linux-kernel-update-package (é preferível acessar a página
em inglês, pois sua versão em português, na data corrente, contém um dos passos faltando). De maneira resumida,
as instruções do link contêm comandos para as seguintes ações:

 Habilitar o recurso opcional Subsistema do Windows para Linux;

 Habilitar o recurso opcional Plataforma de máquina Virtual;
 Fazer download e instalar a atualização do WSL 2;
 Configurar como padrão a versão 2 do WSL recém instalada.

Após a resolução das etapas anteriores e a instalação do Docker Desktop for Windows com sucesso, é provável que
o serviço do docker esteja habilitado para funcionar na inicialização do Windows. Sendo assim, será possível ver o
ícone do docker na barra de tarefas, semelhante à figura a seguir.

intelbras.com.br
Caso não encontre o ícone do docker, inicialize o serviço clicando no menu Iniciar, digitando Docker Desktop e
clicando na opção que for exibida.

Nos passos seguintes, recomenda-se utilizar o terminal Windows PowerShell para manipulação dos containers
docker. Os comandos são os mesmos tanto para Windows quanto para Linux, portanto não haverá mais
diferenciação de sistema operacional.

INICIALIZANDO O GENIEACS

Para inicializar o servidor é necessário descompactar o arquivo genieacs-v1.2.0_i01.tar.gz. Então, utilizando o

terminal, deve-se acessar a pasta descompactada (a pasta que contém o arquivo docker-compose.yml) e executar o
comando docker-compose up. Depois de alguns segundos o servidor deverá entrar em funcionamento.

Para acessar o servidor GenieACS basta, por meio do navegador, acessar a página http://127.0.0.1:3000 e preencher
tanto o username quanto o password com admin. Os dispositivos que se autenticarem ao servidor GenieACS
aparecerão na aba “Devices”.

CONFIGURANDO A ONT 142N W

Para configurar a ONT 142N W com o GenieACS é necessário realizar duas configurações, conforme a seguir.

 Configuração de interface WAN

O GenieACS utiliza o TR-069 para se comunicar com a ONT. Para que haja essa comunicação, primeiramente
é necessário configurar uma interface WAN com este tipo de conexão. Para isso, na página de configuração
da ONT, deve-se ir no menu “WAN” e clicar em “Configuração WAN”. Por padrão a ONT 121N W vem com
uma interface WAN configurada na VLAN 7, assim, em vez de criar uma nova, será utilizada esta mesma
interface para a comunicação com o GenieACS.

intelbras.com.br
 Para configurar a VLAN 7 deve-se: 1. alterar o tipo de conexão para TR069; 2. configurar a rede WAN
conforme a necessidade; e 3. aplicar as configurações. Na imagem abaixo pode ser visto um exemplo de
configuração da interface.

 Configuração do TR-069

Para configurar o TR-069 no dispositivo, na página de configuração, no menu esquerdo deve-se selecionar o
menu "serviços” e depois acessar o submenu “TR-069". Em “ACS”, no campo “URL”, deve-se colocar o IP do
servidor GenieACS seguido da porta 7547 conforme a imagem a seguir. Por fim, é necessário aplicar as
modificações realizadas.

intelbras.com.br
UTILIZANDO O GENIEACS

Depois de configurar algum equipamento, em poucos minutos ele já deve aparecer na aba “Devices”. Para ver as
configurações de algum dispositivo é necessário: 1. Selecionar a aba “Devices”; e 2. clicar no dispositivo desejado na
coluna “Serial number” ou em “Show”.

Depois de clicar no dispositivo, para atualizar as informações deve-se clicar no botão “Summon”. Na figura a seguir
são mostrados valores de configuração de uma ONT 142N W.

intelbras.com.br
CONFIGURAÇÃO DO WIFI

É possível configurar os parâmetros SSID, senha e canal do WiFi na janela que mostra os valores de configuração da
ONT. Para isso deve-se clicar no ícone azul, conforme a imagem abaixo, de acordo com qual parâmetro deseja-se
atualizar.

Em seguida, na janela que aparecerá, deve-se colocar o novo valor de configuração, clicar no botão “Queue” e
depois em “Commit”.

Por segurança a senha do WiFi não ficará visível na tela de configuração, ainda assim, é possível atualizá-la
realizando procedimento equivalente ao anterior.

intelbras.com.br
No caso do canal WiFi, caso ele esteja configurado como “0”, isso significa que a ONT irá escolher um canal
automaticamente.

CONFIGURAÇÃO DE LAN

 IP fixo

Para que a configuração dos equipamentos conectados à LAN se dê por IP fixo é necessário desativar o servidor
DHCP, configurar o endereço IP e a configurar máscara da interface LAN da ONT.

Para desativar o servidor DHCP na LAN é necessário alterar a configuração do parâmetro

“InternetGatewayDevice.LANDevice.1.LANHostConfigManagement.DHCPServerEnable” encontrado na seção
"All parameters” nas configurações do dispositivo. Este parâmetro faz parte do modelo de dados da TR-069.

Se um parâmetro buscado não for encontrado, isso significa que a árvore do modelo de dados precisa ser
atualizada. Para isso, deve-se ir eliminando da direita para a esquerda os parâmetros filhos até encontrar um
valor válido. Depois de encontrado, é necessário atualizá-lo clicando no ícone de atualização localizado a direita.

Por exemplo, na figura a seguir vê-se que o campo “DHCPServerEnable” não foi encontrado.

Eliminando o campo “DHCPServerEnable” da busca, verificou-se que o GenieACS encontra o campo

“LANHostConfigManagement”. Assim, é necessário clicar no botão para atualizar o campo e depois confirmar
clicando no botão "Commit”. Caso o campo “LANHostConfigManagement” não tivesse aparecido, seria
necessário removê-lo e buscar por “InternetGatewayDevice.LANDevice.1”.

Depois da atualização da árvore de dados, o campo “DHCPServerEnable” deverá aparecer. Para alterar a
configuração é necessário clicar no lápis azul, conforme a imagem a seguir.

Na janela que aparecerá, deve-se alterar o campo para false, clicar no botão "Queue” e depois em "Commit”.

intelbras.com.br
 De forma similar os campos
“InternetGatewayDevice.LANDevice.1.LANHostConfigManagement.IPInterface.1.IPInterfaceIPAddress” e
"InternetGatewayDevice.LANDevice.1.LANHostConfigManagement.IPInterface.1.IPInterfaceSubnetMask”
devem ser atualizados com os valores de IP e máscara respectivamente.

 Configurando servidor DHCP

Para configurar um servidor DHCP na LAN da ONT é necessário, além de configurar o endereço IP e máscara
de rede nos campos IPInterfaceIPAddress e IPInterfaceSubnetMask, conforme mostrado na configuração de
IP fixo, também deve-se colocar a máscara de rede em
“InternetGatewayDevice.LANDevice.1.LANHostConfigManagement.SubnetMask”. Além disso, o campo
“InternetGatewayDevice.LANDevice.1.LANHostConfigManagement.DHCPServerEnable” deve ser
configurado como “true”.

Caso seja necessário estabelecer uma faixa de IPs para o servidor DHCP, os IPs mínimo e máximo são
estabelecidos pelos parâmetros
“InternetGatewayDevice.LANDevice.1.LANHostConfigManagement.MinAddress” e
“InternetGatewayDevice.LANDevice.1.LANHostConfigManagement.MaxAddress”, respectivamente.

CONFIGURAÇÃO DE VLAN

Para criar uma VLAN utilizando o GenieACS uma série de passos precisam ser realizados.

Primeiramente, é necessário criar uma conexão WAN. Para isto deve-se ir no campo
“InternetGatewayDevice.WANDevice.1.WANConnectionDevice” e clicar no “+” do lado direito e depois clicar no
botão “Commit”. Caso o botão “+” não esteja visível, é necessário atualizar o campo clicando no botão de
atualização ao lado direito.

Depois de adicionado um novo objeto em WANConnectionDevice, um novo campo com o formato

“InternetGatewayDevice.WANDevice.1.WANConnectionDevice.X” aparecerá. Onde, no lugar de “X” deverá estar o
número do último objeto (conexão) criado, aquele com maior valor. Nos exemplos a seguir será considerado que a
conexão criada é a de número 2, ou seja, “InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2”,
porém, nos comandos abaixo, o número “2” deve ser substituído pelo valor adequado de acordo com cada caso.

intelbras.com.br
O próximo passo é clicar no “+” e no "Commit” para adicionar um novo objeto em
“InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2.WANIPConnection”. Então, deve-se atualizar o
campo “InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2”, clicando no botão de atualização.

Feito isso, há uma série de campos que é necessário atualizar:

1. O campo “InternetGatewayDevice.Layer3Forwarding.DefaultConnectionService” deve ser apontado para a

nova interface criada, isso é feito configurando-o com o valor
“InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2.WANIPConnection.1”. Lembrando de
substituir o “2” pelo valor correto e de atualizar a árvore do campo pai, caso o campo
DefaultConnectionService não seja encontrado.
2. Para configurar a interface em modo roteador deve-se colocar
“InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2.WANIPConnection.1.ConnectionType”
com "IP_Routed".
3. Para configurar a interface como cliente DHCP deve-se alterar
“InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2.WANIPConnection.1.AddressingType”
para “DHCP”.
4. Para ativar o nat na interface, o campo
“InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2.WANIPConnection.1.NATEnabled” deve
ficar como “true”.
5. O nome da interface deve ser alterado para “wan.v” seguido do número da VLAN. Neste exemplo está sendo
utilizada a vlan 1000, portando, foi alterado o campo
“InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2.WANIPConnection.1.Enable” para
“wan.v1000”.
6. Caso esta interface seja configurada para prover internet, o campo
“InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2.WANIPConnection.1.X_RTK_ServiceList”
com deve ser modificado para “INTERNET”.
7. Colocando o campo
“InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2.WANIPConnection.1.X_RTK_VLANMode
” em “2” indica que os pacotes que trafegarão pela interface devem conter tag.
8. O campo
“InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2.WANIPConnection.1.X_RTK_VLANIDMar
k” deve conter o número da VLAN na qual a interface está associada. Neste exemplo, “1000”.

Também é necessário adicionar quais portas devem estar associadas à interface, esta configuração é feita no campo
“InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2.WANIPConnection.1.X_RTK_LanInterface”.
Seguem os valores de configuração para adicionar uma porta LAN ou WiFi na nova interface.

 LAN1 - InternetGatewayDevice.LANDevice.1.LANEthernetInterfaceConfig.1
 LAN2 - InternetGatewayDevice.LANDevice.1.LANEthernetInterfaceConfig.2
 LAN3 - InternetGatewayDevice.LANDevice.1.LANEthernetInterfaceConfig.3
 LAN4 - InternetGatewayDevice.LANDevice.1.LANEthernetInterfaceConfig.4
 WiFi - InternetGatewayDevice.LANDevice.1.WLANConfiguration.1

intelbras.com.br
Caso se deseje colocar mais de uma porta, os valores devem ser separados por vírgula. Sendo assim, caso se queira
colocar todas as portas na nova interface, o campo X_RTK_LanInterface deve ser configurado com
“InternetGatewayDevice.LANDevice.1.LANEthernetInterfaceConfig.1,InternetGatewayDevice.LANDevice.1.LANEth
ernetInterfaceConfig.2,InternetGatewayDevice.LANDevice.1.LANEthernetInterfaceConfig.3,InternetGatewayDevic
e.LANDevice.1.LANEthernetInterfaceConfig.4,InternetGatewayDevice.LANDevice.1.WLANConfiguration.1”.

Depois de enviar todas as configurações anteriores para a ONT clicando no botão “Commit”, deve-se ativar a VLAN
colocando o campo “InternetGatewayDevice.WANDevice.1.WANConnectionDevice.2.WANIPConnection.1.Enable”
como “true”. Feito isso, a nova VLAN deverá estar ativa e funcionando.

ATUALIZAÇÃO DE FIRMWARE

 Fazendo o upload do firmware para o GenieACS

Para atualizar um firmware no GenieACS é necessário fazer primeiro o upload do arquivo. Para isso é
necessário: 1- clicar na aba "Admin”; 2. no menu esquerdo clicar em “Files”; e 3. clicar no botão "New”,
conforme a imagem a seguir.

Na janela que se abrirá, no campo “Type”, deve-se escolher a opção "1 Firmware Upgrade Image”. Os
campos "OUI” e "Product Class” devem ser preenchidos exatamente com os mesmos valores encontrados
na aba devices, conforme mostrado anteriormente. É necessário também informar um valor para a versão
do firmware no campo "Version”. Depois, deve-se clicar no botão "Browse” e selecionar o arquivo com o
firmware. Por fim, é necessário salvar clicando no botão “Save”. O arquivo que deve ser submetido ao
GenieACS é o que possui a extensão “.tar”. Na figura abaixo é possível ver o preenchimento correto para a
ONT 142N W.

intelbras.com.br
 Depois de enviar o firmware para o servidor GenieACS, o novo firmware aparecerá no menu "Files”,
conforme pode ser visto na imagem a seguir.

 Atualizando a ONT 142N W

Para atualizar a ONT devemos voltar para a aba devices e acessar as configurações do dispositivo desejado.
No final da página, abaixo da seção “All parameters”, é necessário clicar no botão “Push file”, conforme a
imagem a seguir.

intelbras.com.br
 Na janela que se abrirá, no campo “Push”, o arquivo contendo o firmware deve ser selecionado. Na
sequência, deve-se clicar no botão "Queue”, depois em "Commit”. Feito isso, o comando de atualização
deverá ser enviado a ONT.

Então, é só aguardar e depois verificar se o campo “Software version” na aba Devices foi atualizado.

intelbras.com.br