Instalação do PON roteado - Versão 5.1 - Laboratório de VM única

Introdução

Este documento descreve um passo a passo da instalação do software Cisco Routed PON Manager no laboratório local.

Pré-requisitos

Requisitos

• Conhecimento do ambiente de servidor Linux
• Conhecimento dos editores de texto do Linux
• Ferramentas do Linux - openssh-server, net-tools, ntp, vsftp
  
  

Componentes Utilizados

• Máquina virtual Linux (VM)
  • 2 vCPUs
  • 8 GB de RAM
  • Espaço de 20 GB (mínimo)
• Ubuntu 20.04.06 LTS

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Configuração

Máquina virtual

Ferramentas

Este documento começa com a suposição de que a VM foi configurada para acesso, o sistema operacional (SO) Ubuntu foi instalado e configurado com conectividade de rede, as ferramentas listadas em Requisitos foram instaladas e o arquivo zip PON roteado foi baixado. Para facilitar, os comandos Ubuntu apt foram fornecidos para baixar e instalar as ferramentas recomendadas.

sudo apt install net-tools
sudo apt install openssh-server
sudo apt install ntp
sudo apt install vsftpd

Desempacotando

1) Crie um diretório de instalação para descompactar o arquivo zip do PON Roteado Versão 5.1.

rpon@rpon-virtual-machine:~$ mkdir PONMGR

2) Descompacte R5.1.1-Cisco-UB2004.zip no diretório atribuído.

rpon@rpon-virtual-machine:~$ unzip R5.1.1-Cisco-UB2004.zip -d /home/rpon/PONMGR/
Archive: Cisco_Routed_PON_24_1_2_Release.zip
inflating: PON_MANAGER_SIGNED_CCO/R5.1.1-Cisco-UB2004

3) Altere o diretório (cd) para a pasta R5.1.1-Cisco-UB2004 recém-criada e liste (ls) os arquivos.

rpon@rpon-virtual-machine:~/PONMGR$ ls -la
total 161548
drwxrwxr-x 3 rpon rpon 4096 Jan 10 08:52 .
drwxr-xr-x 16 rpon rpon 4096 Jan 10 08:52 ..
drwxr-xr-x 7 rpon rpon 4096 Dec 10 17:34 R5.1.1-Cisco-UB2004
-rw-r--r-- 1 rpon rpon 165411803 Jan 10 08:51 R5.1.1-Cisco-UB2004.zip

rpon@rpon-virtual-machine:~/PONMGR$ cd R5.1.1-Cisco-UB2004/
rpon@rpon-virtual-machine:~/PONMGR/R5.1.1-Cisco-UB2004$ ls -la
total 844
drwxr-xr-x 7 rpon rpon 4096 Dec 10 17:34 .
drwxrwxr-x 3 rpon rpon 4096 Jan 10 08:52 ..
-rw-r--r-- 1 rpon rpon 447620 Jan 10 09:47 install.log
-rwxr-xr-x 1 rpon rpon 23081 Dec 10 17:09 install.sh
drwxrwxr-x 2 rpon rpon 4096 Dec 10 17:09 R5.1.1-Firmware
drwxrwxr-x 5 rpon rpon 4096 Dec 10 17:09 R5.1.1-Netconf-ConfD-UB2004
drwxrwxr-x 4 rpon rpon 4096 Dec 10 17:09 R5.1.1-PonController-UB2004-amd64
drwxrwxr-x 6 rpon rpon 4096 Dec 11 18:22 R5.1.1-PonManager-UB2004
-rw-r--r-- 1 rpon rpon 7931 Dec 10 17:09 README.txt
-rwxr-xr-x 1 rpon rpon 1537 Dec 10 17:09 status.sh
drwxr-xr-x 2 rpon rpon 4096 Dec 10 17:09 tools
-rw-r--r-- 1 rpon rpon 15747 Dec 10 17:36 uninstall.log
-rwxr-xr-x 1 rpon rpon 1394 Dec 10 17:09 uninstall.sh
-rw-r--r-- 1 rpon rpon 312410 Dec 10 17:20 upgrade.log
-rwxr-xr-x 1 rpon rpon 8260 Dec 10 17:09 upgrade.sh

Instalação

Consulte o arquivo README.txt para ver as etapas de instalação. Esta instalação está usando a Opção 2 para nova instalação.

Note: Essa instalação usa o Netplan e o NetworkManager para gerenciar as informações de rede na VM, que é o exemplo apresentado abaixo. Isso não é necessário para concluir a instalação, desde que a VM tenha acesso à Internet.

Netplan

Usando um editor de arquivos de texto do linux (nano, vi), edite o arquivo YAML localizado no diretório /etc/netplan/ usando o modelo fornecido no README.txt na pasta de instalação. Preencha as informações de IP específicas da rede e da VM.

rpon@rpon-virtual-machine:~/PONMGR/R5.1.1-Cisco-UB2004$ sudo nano /etc/netplan/01-network-manager-all.yaml
network:
 version: 2
 renderer: NetworkManager
 network:
  ethernets:
   ens192: <- This VM's network adapter is ens192. If the default is NOT ens192, change this value to the desired network adapter
    dhcp4: False
    dhcp6: False
    addresses: [IPv4 address and subnet]
    gateway4: [V4Gateway]
    nameservers:
      addresses: [DNS Server(s)]

Note: Usando nano para editar, uma vez concluído; pressione Control + O para salvar o arquivo e, em seguida, Control X para sair do nano. No VIM, use :wq! para salvar e sair.

Note: O uso de sudo netplan — debug apply é útil ao testar o netplan antes do aplicativo.

Verifique se a configuração do netplan está correta exibindo o arquivo via cat. Essa saída é apenas um exemplo de laboratório. Utilize os endereços IP específicos da rede. Quando terminar e sair do editor de texto, execute sudo netplan apply.

Exemplo de laboratório:

rpon@rpon-virtual-machine:~/PONMGR/R5.1.1-Cisco-UB2004$ cat /etc/netplan/01-network-manager-all.yaml 
# Let NetworkManager manage all devices on this system
network:
  version: 2
  renderer: NetworkManager
  ethernets:
   ens192:
    dhcp4: no
    dhcp6: no
    addresses: 
    - 10.122.140.230/28
    gateway4: 10.122.140.225
    nameservers:
     addresses: 
     - 172.18.108.43
     - 172.18.108.34

rpon@rpon-virtual-machine:~/PONMGR/R5.1.1-Cisco-UB2004$ sudo netplan -- debug apply

Instalação do pacote

Execute a instalação usando os argumentos escolhidos. Para esta instalação, use -m. De acordo com o README.txt, -m instala o PON Manager, MongoDB e NETCONF.

Note: Se esta for uma VM nova, os tempos de instalação podem variar até 5 minutos enquanto as dependências são adicionadas e atualizadas. Quando a instalação for concluída, uma mensagem de log será gerada.

Exemplo:
sudo ./install.sh -m

rpon@rpon-virtual-machine:~/PONMGR/R5.1.1-Cisco-UB2004$ sudo ./install.sh -m

--- Installation snipped for brevity ---

Installation complete!

MCMS Component Versions:
PON Manager: R5.1.1
PON NETCONF: R5.1.1
PON Controller: Not Installed 

Note: O controlador PON está hospedado no roteador XR, portanto, uma instalação na VM é desnecessária.

MongoDB

É necessário fazer um ajuste no arquivo de configuração MongoDB que é gerado para vincular os endereços IP no sistema. Esse arquivo está localizado em /etc/mongod.conf e requer acesso sudo para ser editado. Use o editor de texto de sua escolha para alterar os valores listados.

"bindIP: 127.0.0.1" para "bindIpAll: verdadeiro"

Exemplo:

# network interfaces
net:
port: 27017
bindIpAll: true

Reinicie o mongod.service por meio desse comando.

systemctl restart mongod

Verificação

Verificação de Status do Serviço

Execute uma verificação de status nos serviços instalados para verificar se eles estão ativos e em execução por meio do script status.sh, localizado no mesmo diretório de instalação.

• mongod.service

• apache2.service

• cisco-confd.service

• cisco-netconf.service

  Exemplo:

rpon@rpon-virtual-machine:~/PONMGR/R5.1.1-Cisco-UB2004$ sudo ./status.sh

PON Component Versions:
PON Manager: R5.1.1
PON NETCONF: R5.1.1
PON Controller: Not Installed

● mongod.service - MongoDB Database Server
Loaded: loaded (/lib/systemd/system/mongod.service; enabled; vendor preset: enabled)
Active: active (running) since Fri 2025-01-10 09:45:00 EST; 3 days ago
Docs: https://docs.mongodb.org/manual
Main PID: 29588 (mongod)
Memory: 369.9M
CGroup: /system.slice/mongod.service
└─29588 /usr/bin/mongod --config /etc/mongod.conf

● apache2.service - The Apache HTTP Server
Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
Drop-In: /etc/systemd/system/apache2.service.d
└─start_ponmgr.conf
Active: active (running) since Fri 2025-01-10 09:47:08 EST; 3 days ago
Docs: https://httpd.apache.org/docs/2.4/
Main PID: 37804 (apache2)
Tasks: 137 (limit: 9371)
Memory: 123.8M
CGroup: /system.slice/apache2.service
├─37804 /usr/sbin/apache2 -k start
├─37805 /usr/sbin/apache2 -k start
├─37807 /usr/sbin/apache2 -k start
└─37808 /usr/sbin/apache2 -k start

● cisco-netconf.service - Cisco Systems, Inc. NetCONF Server
Loaded: loaded (/lib/systemd/system/cisco-netconf.service; enabled; vendor preset: enabled)
Active: active (running) since Fri 2025-01-10 09:47:40 EST; 3 days ago
Main PID: 38906 (cisco-netconf)
Tasks: 25 (limit: 9371)
Memory: 105.9M
CGroup: /system.slice/cisco-netconf.service
├─38906 /opt/cisco/netconf/bin/cisco-netconf -c /etc/cisco/netconf/NetconfInit.json
└─38929 /opt/cisco/netconf/bin/cisco-netconf -c /etc/cisco/netconf/NetconfInit.json

● cisco-confd.service - Cisco Systems, Inc. Conf-D Service
Loaded: loaded (/lib/systemd/system/cisco-confd.service; enabled; vendor preset: enabled)
Active: active (running) since Fri 2025-01-10 09:47:40 EST; 3 days ago
Main PID: 38884 (confd.smp)
Tasks: 19 (limit: 9371)
Memory: 38.6M
CGroup: /system.slice/cisco-confd.service
├─38884 /opt/cisco/confd/lib/confd/erts/bin/confd.smp -S 1 -K false -MHe true -- -root /opt/cisco/confd/lib/confd -progname confd -- -home / -- -boot confd -delayed-detach -noshell -noinput -yaws embedded true -stacktrace_depth 24 -shutdown_t…
└─38888 erl_child_setup 1024

Abra um navegador e navegue até o IP da VM.

Roteado PON 5.1 Bem-vindo

Documentação de referência

• Página de suporte e downloads da Cisco

• Página da solução Cisco Routed PON

• Guia de instalação do Cisco Routed PON

• Notas de versão para Cisco Routed PON, Cisco IOS® XR Release 24.1.1 e 24.1.2