Yang Suite implementeren en XPath testen op Catalyst 9800 WLC

Inleiding

In dit document wordt beschreven hoe u Yang Suite kunt implementeren in een Python-omgeving en XPath kunt testen op Cisco Catalyst 9800 WLC.

Voorwaarden

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

- Catalyst 9800 WLC-configuratie

- Basiskennis van Python en virtuele omgevingen

Gebruikte componenten

De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:

• Cisco Catalyst9800 WLC Cisco IOS® XE versie 17.15.3

• Microsoft Windows 11 Enterprise met Python 3.8.2 geïnstalleerd

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.

Configureren

Stap 1. Installeer Python op Windows PC.

Download en installeer Python 3.8.2 voor Windows.

Download Link: Python Releases voor Windows

Uitleg:
Python is nodig om YANG Suite te kunnen gebruiken. Versie 3.8.2 wordt hier gebruikt voor compatibiliteit.

Stap 2. Controleer de installatie van Python en PIP.

Controleer na de installatie of Python en PIP correct werken.

Opdrachten:

C:\Users\Administrator>python --version
C:\Users\Administrator>pip --version

Verwacht resultaat (voorbeeld):

C:\Users\Administrator>python --version
Python 3.8.2

C:\Users\Administrator>pip --version
pip 25.0.1 from c:\users\administrator\appdata\local\programs\python\python38-32\lib\site-packages\pip (python 3.8)

Stap 3. Upgrade PIP naar de nieuwste versie om compatibiliteit met YANG Suite te garanderen.

Opdracht:

C:\Users\Administrator>python -m pip install --upgrade pip

Uitleg:
Deze opdracht verwijdert de oude versie van PIP en installeert de nieuwste versie om compatibiliteit met YANG Suite te garanderen.
Verwacht resultaat (voorbeeld):
- Oude versie (bijvoorbeeld pip 19.2.3) is verwijderd.
- Nieuwe versie (bijvoorbeeld pip 25.0.1) is geïnstalleerd.

Stap 4. Maak een virtuele omgeving om afhankelijkheden te isoleren van het Python-systeem.

Opdracht:

C:\Users\Administrator>python -m venv yangsuitevenv

Verwacht resultaat:
Een nieuwe map met de naam yangsuitevenv wordt gemaakt op uw pc C:\Users\Administrator.

Stap 5. Activeer de virtuele omgeving.

Activeer de omgeving voordat u pakketten installeert.

Opdracht:

C:\Users\Administrator>.\yangsuitevenv\Scripts\activate

Verwacht resultaat:
De opdrachtprompt verandert om de actieve omgeving weer te geven, bijvoorbeeld:

(Yangsuitevenv) C:\Users\Administrator>

Stap 6. Installeer YANG Suite.

Installeer YANG Suite en de vereiste modules om ervoor te zorgen dat YANG Suite en de afhankelijkheden ervan zonder fouten worden geïnstalleerd.

Opdracht:

(yangsuitevenv) C:\Users\Administrator>pip install yangsuite[core]

Als u proxyfouten tegenkomt:

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ProxyError('Your proxy appears to only use HTTP and not HTTPS, try changing your proxy URL to be HTTP. See: https://xxx.xxx.xx/en/1.26.x/advanced-usage.html#https-proxy-error-http-proxy', SSLError(SSLError(1, '[SSL: WRONG_VERSION_NUMBER] wrong version number (_ssl.c:1108)')))': /simple/yangsuite/

Controleer de netwerkconnectiviteit of proxy. Als uw omgeving het gebruik van een proxy vereist, gebruikt u in plaats daarvan deze opdracht:

Opdracht:

(yangsuitevenv) C:\Users\Administrator>pip install yangsuite[core] --proxy http://x.x.x.x:port

Stap 7. Upgrade YANG Suite-modules.

Werk alle YANG Suite-modules bij om de volledige functionaliteit te garanderen.

Opdracht:

pip3 install --upgrade yangsuite yangsuite-devices yangsuite-filemanager yangsuite-yangtree yangsuite-coverage yangsuite-gnmi yangsuite-grpc-telemetry yangsuite-netconf yangsuite-restconf

Uitleg:
Deze stap zorgt ervoor dat YANG Suite de nieuwste plug-ins heeft voor NETCONF, RESTCONF, gNMI en telemetrie.

Stap 8. Initialiseer YANG Suite.

Voer het initialisatieproces uit om de interactieve configuratiemodus in te voeren.

Opdracht:

(yangsuitevenv) C:\Users\Administrator>yangsuite

Stap 9. Configureer de YANG Suite-instellingen.

Tijdens de initialisatie wordt u gevraagd om de servicepoort, hostnaam, gebruikersnaam en wachtwoord te configureren:

Maak een map met de naam yangsuitespecifieke gegevens om de gebruikersspecifieke gegevens op te slaan (YANG-modules, apparaatprofielen enzovoort).

Servicepoortnummer: standaard is 8480.

Hostnaam: aanbevolen om localhost of 127.0.0.1 te gebruiken.

Instellingen opslaan: bevestigen met y.

Maak gebruikersnaam en wachtwoord: voor toegang tot de YANG Suite web UI.

Verwacht resultaat:
Configuratie wordt opgeslagen en services kunnen worden gestart met de opdracht yangsuite:

(yangsuitevenv) C:\Users\Administrator>yangsuite

Stap 10. Meld u aan bij Yang Suite via de browser: http://localhost:8480/ voor toegang tot Cisco Yang Suite:

Verifiëren

Stap 1. De Catalyst 9800 WLC configureren.

Zorg ervoor dat de Netconf Yang-status en SSH-poort zijn ingeschakeld op de WLC.

Navigeer naar WLC > Beheer > Beheer > HTTP/HTTPS/Netconf/VTY om de Netconf Yang-configuratiestatus in te schakelen en SSH-poort 830 in te schakelen.

CLI-configuratie:

9800(config)#netconf-yang

Configureer de AAA-instellingen.

CLI-configuratie:

9800(config)#aaa authentication login default local
9800(config)#aaa authorization exec default local

Stap 2. Voeg de WLC toe aan YANG Suite.

Navigeer in YANG Suite naar Instellen > Apparaatprofielen > Nieuw apparaat maken.

 Voer de profielnaam, WLC-IP-adres, gebruikersnaam en wachtwoord in.

Activeer netconf door te klikken op Apparaat ondersteunt NETCONF en te klikken op SSH-sleutelvalidatie voor dit apparaat overslaan.

Activeer Terugzetten door te klikken op Apparaat ondersteunt RESTCONF en wissel de standaard RESTCONF basis-URL leeg.

Activeer SSH door te klikken op Apparaat staat SSH-aanmelding toe en verifieer de WLC-informatie.

Stap 3. Controleer de bereikbaarheid van het apparaat.

Klik op de bereikbaarheid van het geselecteerde apparaat controleren en selecteer het apparaatprofiel om te controleren of de WLC kan worden bereikt vanuit YANG Suite.

Stap 4. Maak een YANG Suite Repository aan.

Maak een repository om de benodigde WLC YANG-modellen op te slaan.

Selecteer NETCONF en selecteer apparaatprofiel om de schemalijst te krijgen om alle schema's van WLC te downloaden

Stap 5. Maak een nieuwe YANG-module die is ingesteld op de bijbehorende YANG-bestandsrepository.

Als bijvoorbeeld de draadloze informatie van Catalyst 9800-specifieke YANG-modellen vereist is, voert u draadloos in om alle modules te kiezen en klikt u op Toevoegen geselecteerd.

Als u meer nodig hebt dan alleen de draadloze componenten, kunt u bij deze stap eenvoudig op Gehele repository toevoegen klikken. 

Als u alleen de draadloze modules toevoegt, is er ook een knop met de naam Lokaliseren en ontbrekende afhankelijkheden toevoegen. Als u erop klikt, worden automatisch alle extra modules die voor de draadloze module zijn vereist, ingehaald.

Stap 6. XPath-zoekopdrachten testen.

Gebruik de XPath die door YANG Suite wordt geleverd om gegevens van WLC te verkrijgen.

Krijg de benodigde XPath in YANG Suite.

Hier neem je de naam van de controller management interface als voorbeeld.

Telemetriediëtef configureren op WLC CLI

C9800(config)#telemetry ietf subscription <subscription-id>
C9800(config-mdt-subs)#encoding encode-kvgpb
C9800(config-mdt-subs)#filter xpath <xpath-expression>
C9800(config-mdt-subs)#source-address <wlc-ip>
C9800(config-mdt-subs)#stream yang-push
C9800(config-mdt-subs)#update-policy periodic <interval-in-centiseconds>
C9800(config-mdt-subs)#receiver ip address <collector-ip> <collector-port> protocol grpc-tcp

Voorbeeld:

C9800(config)#telemetry ietf subscription 104
C9800(config-mdt-subs)#encoding encode-kvgpb
C9800(config-mdt-subs)#filter xpath /general-oper-data/mgmt-intf-data/intf-name
C9800(config-mdt-subs)#source-address 10.124.38.111
C9800(config-mdt-subs)#stream yang-push
C9800(config-mdt-subs)#update-policy periodic 2500
C9800(config-mdt-subs)#receiver ip address 10.124.41.144 18800 protocol grpc-tcp

Schakel bewaking in gRPC-telemetrie in om de benodigde gegevens te ontvangen die door WLC worden verzonden.

Gerelateerde informatie

• Catalyst 9800 Programmability and Telemetry Deployment Guide
• Welkom bij Cisco YANG Suite!
• Cisco Community voor DevNet