Installazione di Routed PON - versione 5.1 - Single VM Lab

Introduzione

Questo documento descrive una procedura dettagliata per l'installazione del software Cisco Routed PON Manager nel laboratorio locale.

Prerequisiti

Requisiti

• Conoscenza dell'ambiente server Linux
• Conoscenza degli editor di testo Linux
• Strumenti Linux - openssh-server, net-tools, ntp, vsftp
  
  

Componenti usati

• Macchina virtuale Linux (VM)
  • 2 vCPU
  • 8 GB di RAM
  • 20 GB di spazio (minimo)
• Ubuntu 20.04.06 LTS

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Configurazione

Macchina virtuale

Strumenti

In questo documento si presume che la VM sia stata configurata per l'accesso, che il sistema operativo Ubuntu sia stato installato e configurato con la connettività di rete, che gli strumenti elencati in Requisiti siano stati installati e che il file zip Routed PON sia stato scaricato. Per facilitare l'operazione, sono stati forniti i comandi Ubuntu apt per scaricare e installare gli strumenti consigliati.

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

Disimballaggio

1) Creare una directory di installazione in cui decomprimere il file zip Routed PON versione 5.1.

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

2) Decomprimere R5.1.1-Cisco-UB2004.zip nella directory assegnata.

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) Spostarsi nella directory (cd) della cartella R5.1.1-Cisco-UB2004 appena creata ed elencare (ls) i file.

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

Installazione

Visualizzare il file README.txt per le fasi di installazione. Questa installazione utilizza l'opzione 2 per la nuova installazione.

Nota: Questa installazione utilizza Netplan e NetworkManager per gestire le informazioni di rete sulla VM, come illustrato di seguito. Non è necessario completare l'installazione se la VM dispone di accesso a Internet.

NetPlan

Utilizzando un editor di file di testo linux (nano, vi), modificare il file YAML situato nella directory /etc/netplan/usando il modello fornito nel file README.txt nella cartella di installazione. Popolare le informazioni IP specifiche della rete e della 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)]

Nota: Utilizzo di nano per la modifica, una volta completato; premere Ctrl + O per salvare il file, quindi Ctrl + X per uscire da nano. In VIM, utilizzare :wq! per salvare e uscire.

Nota: Uso di sudo netplan: debug apply è utile quando si esegue il test di netplan prima dell'applicazione.

Verificare che la configurazione di netplan sia corretta visualizzando il file tramite cat. Questo output è solo un esempio lab. Utilizzare gli indirizzi IP specifici per la rete. Una volta completati e usciti dall'editor di testo, eseguire sudo netplan apply.

Esempio Lab:

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

Installazione pacchetto

Eseguire l'installazione utilizzando gli argomenti scelti. Per questa installazione, utilizzare -m. Come indicato nel file README.txt, -m consente di installare PON Manager, MongoDB e NETCONF.

Nota: Se si tratta di una nuova VM, i tempi di installazione possono variare fino a 5 minuti durante l'aggiunta e l'aggiornamento delle dipendenze. Al termine dell'installazione, viene generato un messaggio di registro.

Esempio:
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 

Nota: Il controller PON è ospitato sul router XR, pertanto non è necessaria un'installazione sulla VM.

MongoDB

È necessario apportare una modifica al file di configurazione MongoDB generato per associare gli indirizzi IP sul sistema. Il file si trova in /etc/mongod.conf e richiede l'accesso sudo per la modifica. Utilizzare l'editor di testo desiderato per modificare i valori elencati.

"bindIP: 127.0.0.1" a "bindIpAll: vero"

Esempio:

# network interfaces
net:
port: 27017
bindIpAll: true

Riavviare il servizio monGod.service con questo comando.

systemctl restart mongood

Verifica

Controllo dello stato del servizio

Eseguire un controllo dello stato sui servizi installati per verificare che siano attivi e in esecuzione tramite lo script status.sh, situato nella stessa directory di installazione.

• servizio.mondio

• apache2.service

• cisco-confd.service

• cisco-netconf.service

  Esempio:

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

Aprire un browser e passare all'indirizzo IP della macchina virtuale.

Benvenuti in Routed PON 5.1

Documentazione di riferimento

• Pagina di supporto e download di Cisco

• Pagina Soluzione Cisco Routed PON

• Guida all'installazione di Cisco Routed PON

• Note sulla versione per Cisco Routed PON, Cisco IOS® XR release 24.1.1 e 24.1.2