Gerouteerde PON-implementatie valideren 24.1.2

Inleiding

Dit document beschrijft de validatie van de Cisco Routed PON (Passive Optical Network)-oplossing op een virtuele machine (VM) en XR-router.

Voorwaarden

Vereisten

Cisco raadt kennis over deze onderwerpen aan.

• Cisco IOS® XR-software
• Linux
• virtuele-machineomgeving

Gebruikte componenten

De informatie in dit document is gebaseerd op de vermelde software- en hardwareversies:

• NCS-540-28Z4C-SYS-A XR-router
• Cisco IOS® XR Software 24.1.2
• Gerouteerde PON versie 24.1.2
• Ubuntu versie 20.04.06 LTS

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Valideringsstappen - XR-router

Configuratiecontroles

Linux-netwerken

Zorg ervoor dat de Virtual Routing and Forwarding (VRF) die wordt gebruikt voor connectiviteit, wordt weerspiegeld in de Linux-netwerkconfiguratie. Voor dit voorbeeld is VRF Management-intf geconfigureerd. Zorg er daarnaast voor dat de standaardroute source-hint is ingesteld voor de juiste uplinkinterface. Connectiviteit in het genoemde voorbeeld gebruikt de interface MgmtEth0/RP0/CPU0/0.

Configuratievoorbeeld:

linux networking
 vrf Mgmt-intf
  address-family ipv4
   default-route software-forwarding
    source-hint default-route interface MgmtEth0/RP0/CPU0/0

Configuratie van fysieke en subinterface

Zorg ervoor dat de interface waarin de OLT-stekker (Optical Line Terminal) is geplaatst correct is en niet wordt afgesloten in de configuratie. Bevestig bovendien dat de subinterface dot1q is gelabeld met 4090 en wordt toegepast op de bijbehorende fysieke interface.

Configuratievoorbeeld:

interface TenGigE0/0/0/0
description PON OLT
!
interface TenGigE0/0/0/0.4090
encapsulation dot1q 4090

Opdrachtverificatie:

RP/0/RP0/CPU0:F340.16.19.N540-1#show ip interface brief
Tue Jul 16 15:08:28.786 UTC

Interface            IP-Address  Status Protocol Vrf-Name
TenGigE0/0/0/0       unassigned  Up     Up       default 
TenGigE0/0/0/0.4090  unassigned  Up     Up       default

RP/0/RP0/CPU0:F340.16.19.N540-1#show interface TenGigE0/0/0/0.4090
Wed Jul 17 13:17:07.754 UTC
TenGigE0/0/0/0.4090 is up, line protocol is up 
Interface state transitions: 5
Hardware is VLAN sub-interface(s), address is c47e.e0b3.9b04
Internet address is Unknown
MTU 1518 bytes, BW 10000000 Kbit (Max: 10000000 Kbit)
reliability 255/255, txload 0/255, rxload 0/255
Encapsulation 802.1Q Virtual LAN, VLAN Id 4090, loopback not set

Zorg ervoor dat LLDP is ingeschakeld in globale configuratie.

RP/0/RP0/CPU0:F340.16.19.N540-1#show run | include lldp
Thu Jul 18 20:16:12.073 UTC
lldp

Configuratie PON-controller

Zorg ervoor dat de xr-pon-ctrl RPM is geïnstalleerd en actief is. Zo niet, bevestig dan dat de NCS540l-iosxr-optional-RPMs-24.2.11.tar bestaat op de harddisk (in de Linux-shell is het pad /misc/disk1/), en dat de local-repo met de overeenkomende software-RPMs correct wordt gerefereerd.

Opmerking: Informatie over de installatie en het beheer van systeembrede RPM's kunt u vinden op deze link: Installatiehandleiding voor systeeminstellingen en software voor Cisco NCS 540 Series Routers, IOS XR Release 24.1.x, 24.2.x

Voorbeeld:

RP/0/RP0/CPU0:F340.16.19.N540-2#show install active summary | include xr-pon
Tue Jul 16 14:59:16.082 UTC
xr-pon-ctlr 24.1.2v1.0.0-1

install
 repository local-repo
  url file:///harddisk:/optional-RPMs-2412

Zorg ervoor dat de PON-controller is geconfigureerd met het correct gekoppelde bestand, bestandspad en VRF.

Voorbeeld:

pon-ctlr
 cfg-file harddisk:/PonCntlInit.json vrf Mgmt-intf

Verificaties

JSON-bestand

Opmerking: het bestandsvoorbeeld PonCentlInit.json wordt meegeleverd bij de installatie van Routed PON Manager-software op de VM.

Opmerking: bij een enkele installatie van PON Manager op de VM zijn de MongoDB IP en de VM IP één op dezelfde.

Opmerking: in het vermelde voorbeeld wordt GEEN TLS gebruikt. Als u TLS gebruikt, moet u ervoor zorgen dat de gebruikersnaam en het wachtwoord correct zijn ingesteld voor uw installatie.

Zorg ervoor dat het IP-adres van de MongoDB in de host: sectie is ingesteld om overeen te komen met waar de PON-controller verbinding mee maakt. Bevestig bovendien dat de geconfigureerde poort overeenkomt met die van het bestand mongod.conf in de VM.

Voorbeeld:

{
   "CNTL": {
       "Auth": false,
       "CFG Version": "R4.0.0",
       "DHCPv4": true, <- DHCP set to true for CPE devices, Default is false. 
       "DHCPv6": true, <- DHCP set to true for CPE devices, Default is false.
       "PPPoE": false,
       "UMT interface": "tibitvirt",
       "Maximum CPEs Allowed": 0,
       "Maximum CPE Time": 0
   },
   "DEBUG": {},
   "JSON": {
       "databaseDir": "/opt/tibit/poncntl/database/",
       "defaultDir": "/opt/tibit/poncntl/database/"
   },
   "Local Copy": {
       "CNTL-STATE": false,
       "OLT-STATE": false,
       "ONU-STATE": false
   },
   "Logging": {
       "Directory": "/var/log/tibit",
       "FileCount": 3,
       "FileSize": 10240000,
       "Tracebacks": false,
       "Timestamp": false,
       "Facility" : "user"
   },
   "MongoDB": {
       "auth_db": "tibit_users",
       "auth_enable": false,
       "ca_cert_path": "/etc/cisco/ca.pem",
       "compression": false,
       "write_concern": "default",
       "host": "10.122.140.232", <- MongoDB IP
       "name": "tibit_pon_controller",
       "password": "", <- Left Empty - Not using TLS
       "port": "27017", <- MongoDB TCP Port
       "tls_enable": false, <- Set to False to leave TLS disabled
       "username": "", <- Left Empty - Not using TLS
       "dns_srv": false,
       "db_uri": "",
       "replica_set_enable": false,
       "validate_cfg": true
   },
   "databaseType": "MongoDB",
   "interface": "veth_pon_glb"
}

Connectiviteitscontroles

Ping de MongoDB/VM Hosting Routed PON Manager vanaf de XR-router. Als u een VRF gebruikt, bron van de VRF.

Voorbeeld:

RP/0/RP0/CPU0:F340.16.19.N540-1#ping vrf Mgmt-intf 10.122.140.232
Tue Jul 16 15:09:52.780 UTC
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 10.122.140.232 timeout is 2 seconds:
!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/3 ms
RP/0/RP0/CPU0:F340.16.19.N540-1#

Containerstatus

De PON-controller wordt uitgevoerd op een dockercontainer op de XR-router. Controleer de status van de container door in te loggen op de linux shell in de XR router en voer vervolgens de opdracht docker ps. Dit toont de momenteel actieve en actieve container als er een is.

Voorbeeld:

RP/0/RP0/CPU0:F340.16.19.N540-1#run
Tue Jul 16 15:14:26.059 UTC
[node0_RP0_CPU0:~]$docker ps
CONTAINER ID   IMAGE                   COMMAND                CREATED    STATUS PORTS   NAMES
2e700f202ee3   tibit-poncntl.xr:R4.0.0 "/usr/bin/supervisor…" 3 days ago Up     3 days  pon_ctlr

Als de dockercontainer NIET actief is, controleert u de inhoud en bestandsstructuur van het JSON-bestand. Controleer de logs van de dockercontainer op actieve fouten. In het logboekvoorbeeld wordt een ONU-registratie bij de controller weergegeven. Dit drukt ook eventuele fouten op dockerniveau af met betrekking tot de container en OLT. Bovendien kan begeleiding worden verkregen door een eenvoudige show-logboekregistratie uit te voeren om te controleren op foutmeldingen.

Opmerking: het gebruik van --follow geeft de nieuwste logboekinhoud in de docker weer.

Voorbeeld:

[node0_RP0_CPU0:~]$docker logs pon_ctlr

2024-07-16 15:05:11.630 PonCntl System Status
{
"e0:9b:27:36:aa:76": {
"OLT State": "Primary",
"ONU Active Count": 1,
"ONUs": {
"CIGG2410503f": "Registered"

Datum en tijd

Zorg ervoor dat de tijd en datum op de XR-router en de VM-hosting Routed PON Manager overeenkomen. Gebruik indien mogelijk dezelfde NTP-servers voor optimale nauwkeurigheid.

Let op: NTP is niet synchroon tussen de VM en XR Router en heeft directe invloed op OLT-zichtbaarheid in Routed PON Manager.

Voorbeeld:

RP/0/RP0/CPU0:F340.16.19.N540-1#show clock
Tue Jul 16 15:25:03.781 UTC
15:25:03.827 UTC Tue Jul 16 2024

Configuratievoorbeeld:

ntp
 server vrf Mgmt-intf 172.18.108.14 source MgmtEth0/RP0/CPU0/0
 server vrf Mgmt-intf 172.18.108.15 prefer source MgmtEth0/RP0/CPU0/0

Trace-berichten

Het PON-proces genereert extra logboekregistratie via Ltrace. Controleer deze logboeken op eventuele fouten met betrekking tot dit proces.

Voorbeeld:

RP/0/RP0/CPU0:F340.16.19.N540-1#show pon-ctlr ltrace all reverse location all
Wed Jul 17 13:25:43.747 UTC
670 wrapping entries (4224 possible, 896 allocated, 0 filtered, 670 total)
Jul 10 19:17:55.066 pon_ctlr/event 0/RP0/CPU0 t6986 pon_ctlr_config_sysdb.c:117:Successfully connected to sysdb
Jul 10 19:17:55.039 pon_ctlr/event 0/RP0/CPU0 t6986 pon_ctlr_main.c:372:Succeessfully registered with install manager
Jul 10 19:17:55.006 pon_ctlr/event 0/RP0/CPU0 t7082 pon_ctlr_utls.c:353:IP LINK: ip link delete veth_pon_xrns

Validatiestappen - Linux VM

Verificaties

status.sh-script

In de installatiedirectory van Routed PON Manager is er een shell-script (status.sh) om de huidige status van elk gekoppeld proces weer te geven. Voer dit script met verhoogde bevoegdheden uit om te controleren of alle vermelde services actief zijn. Als een van de services niet wordt uitgevoerd, controleert u eerst het installatiescript dat is uitgevoerd tijdens de installatie en controleert u of de juiste argumenten zijn ingesteld volgens de installatiehandleiding.

Opmerking: De installatiehandleiding voor Cisco Routed PON Manager vindt u op deze link: Installatiehandleiding voor Cisco Routed PON Manager

mongod.service
Apache2.service
netconf.service
netopeer2-server.service

Voorbeeld:

rpon@rpon-mgr:~/PON_MANAGER_SIGNED_CCO/R4.0.0-Cisco-UB2004-sign/R4.0.0-Cisco-UB2004$ sudo ./status.sh
[sudo] password for rpon: 
MCMS Component Versions:
PON Manager: R4.0.0
PON NETCONF: R4.0.0
PON Controller: Not Installed

● mongod.service - MongoDB Database Server
Loaded: loaded (/lib/systemd/system/mongod.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2024-06-27 08:46:25 EDT; 2 weeks 5 days ago
Main PID: 52484 (mongod)
Memory: 1.5G
CGroup: /system.slice/mongod.service
└─52484 /usr/bin/mongod --config /etc/mongod.conf

● apache2.service - The Apache HTTP Server
Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
Active: active (running) since Fri 2024-07-12 06:33:30 EDT; 4 days ago
Process: 103015 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS)
Main PID: 96525 (apache2)
Tasks: 123 (limit: 9403)
Memory: 27.0M
CGroup: /system.slice/apache2.service
├─ 96525 /usr/sbin/apache2 -k start
├─103029 /usr/sbin/apache2 -k start
├─103030 /usr/sbin/apache2 -k start
└─103031 /usr/sbin/apache2 -k start

● tibit-netconf.service - Tibit Communications, Inc. NetCONF Server
Loaded: loaded (/lib/systemd/system/tibit-netconf.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2024-06-27 08:47:44 EDT; 2 weeks 5 days ago
Main PID: 60768 (tibit-netconf)
Tasks: 17 (limit: 9403)
Memory: 60.7M
CGroup: /system.slice/tibit-netconf.service
├─60768 /opt/tibit/netconf/bin/tibit-netconf
└─60786 /opt/tibit/netconf/bin/tibit-netconf

● tibit-netopeer2-server.service - Tibit Communications, Inc. Netopeer2 Server
Loaded: loaded (/lib/systemd/system/tibit-netopeer2-server.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2024-06-27 08:47:44 EDT; 2 weeks 5 days ago
Main PID: 60772 (netopeer2-serve)
Tasks: 7 (limit: 9403)
Memory: 6.0M
CGroup: /system.slice/tibit-netopeer2-server.service
└─60772 /opt/tibit/netconf/bin/netopeer2-server -v 1 -t 55

Netplan

Valideer het Netplan en controleer of de IP-gegevens geldig zijn, of de naam van de VM-netwerkinterface correct is, of VLAN-id 4090 is gemaakt en toegewezen en of deze een geldige Netplan YAML-boomstructuur gebruikt.

Opmerking: Het netplan YAML-bestand bevindt zich in /etc/netplan/.

Voorbeeld:

rpon@rpon-mgr:~/PON_MANAGER_SIGNED_CCO/R4.0.0-Cisco-UB2004-sign/R4.0.0-Cisco-UB2004$ cat /etc/netplan/01-network-manager-all.yaml 
network:
  version: 2
  Renderer: Network Manager
  ethernets:
    ens192: <- VM Network Adapter
      dhcp4: no <- No DHCP as the IP is set statically
      dhcp6: no
      addresses: [10.122.140.232/28] <- IP of the VM Network adapter
      gateway4: 10.122.140.225 <- GW of the IP Network
      nameservers:
        addresses: [172.18.108.43,172.18.108.34] <- Network DNS
  vlans:
    vlan.4090:
      id: 4090
      link: ens192 <- VM Network adapter
      dhcp4: no
      dhcp6: no 

Controleer de IP-configuratie van de VM en of de geconfigureerde netwerkadapter overeenkomt met wat wordt vermeld in het YAML-bestand van het netplan.

Opmerking: gebruik van sudo netplan --debug apply is handig bij het testen van het netplan voorafgaand aan de toepassing.

Voorbeeld:

rpon@rpon-mgr:~$ ifconfig
ens192: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500
        inet 10.122.140.232 netmask 255.255.255.240 broadcast 10.122.140.239
        inet6 fe80::df4d:8d4d:4836:82aa prefixlen 64 scopeid 0x20<link>
        ether 00:50:56:84:3f:8f txqueuelen 1000 (Ethernet)
        RX packets 68933231 bytes 21671670389 (21.6 GB)
        RX errors 0 dropped 129 overruns 0 frame 0
        TX packets 36820200 bytes 71545432788 (71.5 GB)
        TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
-- snipped for brevity --

vlan.4090: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500
           inet6 fe80::250:56ff:fe84:3f8f prefixlen 64 scopeid 0x20<link>
           ether 00:50:56:84:3f:8f txqueuelen 1000 (Ethernet)
           RX packets 0 bytes 0 (0.0 B)
           RX errors 0 dropped 0 overruns 0 frame 0
           TX packets 1044 bytes 140547 (140.5 KB)
           TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0

IP-connectiviteit

Verifieer de IP-connectiviteit met de XR-router waarop de PON-controller wordt gehost via ping.

Voorbeeld:

rpon@rpon-mgr:~/PON_MANAGER_SIGNED_CCO/R4.0.0-Cisco-UB2004-sign/R4.0.0-Cisco-UB2004$ ping 10.122.140.226
PING 10.122.140.226 (10.122.140.226) 56(84) bytes of data.
64 bytes from 10.122.140.226: icmp_seq=1 ttl=255 time=1.01 ms
64 bytes from 10.122.140.226: icmp_seq=2 ttl=255 time=1.03 ms
64 bytes from 10.122.140.226: icmp_seq=3 ttl=255 time=1.13 ms
^C
--- 10.122.140.226 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2002ms
rtt min/avg/max/mdev = 1.009/1.054/1.128/0.052 ms

Controleer of de MongoDB TCP-poort 27017 is geopend. Als u een niet-standaard poort voor de MongoDB gebruikt, controleert u of deze open is/luistert via netstat -tunl.

Opmerking: De standaard MongoDB TCP-poort is 27017.

Opmerking: In het configuratiebestand in stap 4 wordt ook de TCP-poortconfiguratie voor de MongoDB ingesteld.

Voorbeeld:

rpon@rpon-mgr:~/PON_MANAGER_SIGNED_CCO/R4.0.0-Cisco-UB2004-sign/R4.0.0-Cisco-UB2004$ netstat -tunl
Active Internet connections (only servers)
Proto Recv-Q Send-Q  Local Address        Foreign Address State 
tcp   0      0       127.0.0.53:53        0.0.0.0:*       LISTEN 
tcp   0      0       127.0.0.1:27017      0.0.0.0:*       LISTEN 
tcp   0      0       10.122.140.232:27017 0.0.0.0:*       LISTEN 

MongoDB-configuratiebestand

Controleer of het bestand mongod.conf juist is en of het juiste IP-adres wordt vermeld onder bindIP:.

Opmerking: het configuratiebestand van MongoDB bevindt zich op /etc/mongod.conf

Voorbeeld:

rpon@rpon-mgr:~/PON_MANAGER_SIGNED_CCO/R4.0.0-Cisco-UB2004-sign/R4.0.0-Cisco-UB2004$ cat /etc/mongod.conf 
# mongod.conf

storage:
dbPath: /var/lib/mongodb
journal:
enabled: true

systemLog:
destination: file
logAppend: true
path: /var/log/mongodb/mongod.log
logRotate: reopen

# network interfaces
net:
port: 27017
bindIp: 127.0.0.1,10.122.140.232

processManagement:
pidFilePath: /var/run/mongodb/mongod.pid
timeZoneInfo: /usr/share/zoneinfo

replication: 
replSetName: "rs0"

-- snipped for brevity --

Loglocaties op systeemniveau

Logboeken op systeemniveau voor elke service worden beheerd binnen linux. Deze logs worden opgeslagen in de /var/log directory, specifiek onder deze bomen.

MongoDB-logs: /var/log/mongod/mongod.log
Apache-logs: /var/log/apache2/<bestandsnaam>.log
Virtual Machine-syslog: /var/log/syslog

referentiedocumentatie

• Pagina Ondersteuning en downloads voor Cisco
• PON-oplossingspagina voor routeringen van Cisco
• Installatiehandleiding voor gerouteerde Cisco PON
• Cisco Routed PON Deployment Guide
• Release Notes voor Cisco Routed PON, Cisco IOS XR Release 24.1.1 en 24.1.2