Distribuire Yang Suite e testare XPath su Catalyst 9800 WLC

Introduzione

Questo documento descrive come distribuire Yang Suite in ambiente Python e testare XPath su Cisco Catalyst 9800 WLC.

Prerequisiti

Requisiti

Cisco raccomanda la conoscenza dei seguenti argomenti:

- Catalyst 9800 WLC configurazione

- Conoscenze base di Python e ambienti virtuali

Componenti usati

Le informazioni fornite in questo documento si basano sulle seguenti versioni software e hardware:

• Cisco Catalyst9800 WLC Cisco IOS® XE versione 17.15.3

• Microsoft Windows 11 Enterprise con Python 3.8.2 installato

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

Passaggio 1. Installare Python su un PC Windows.

Scaricare e installare Python 3.8.2 per Windows.

Link al download: versioni Python per Windows

Spiegazione:
Python deve eseguire YANG Suite. Per la compatibilità viene utilizzata la versione 3.8.2.

Passaggio 2. Verificare l'installazione di Python e PIP.

Dopo l'installazione, verificare che Python e PIP funzionino correttamente.

Comandi:

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

Risultato previsto (esempio):

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)

Passaggio 3. Aggiornare PIP alla versione più recente per garantire la compatibilità con YANG Suite.

Comando:

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

Spiegazione:
Questo comando disinstalla la versione precedente di PIP e installa quella più recente per garantire la compatibilità con YANG Suite.
Risultato previsto (esempio):
- La versione precedente (ad esempio, pip 19.2.3) è disinstallata.
- Installazione della nuova versione (ad esempio, pip 25.0.1) completata.

Passaggio 4. Creare un ambiente virtuale per mantenere le dipendenze isolate dal sistema Python.

Comando:

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

Risultato previsto:
Una nuova cartella denominata yangsuitevenv viene creata sul tuo PC C:\Users\Administrator.

Passaggio 5. Attivare l'ambiente virtuale.

Attivare l'ambiente prima di installare i pacchetti.

Comando:

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

Risultato previsto:
Il prompt dei comandi viene modificato per visualizzare l'ambiente attivo, ad esempio:

(yangsuitevenv) C:\Users\Administrator>

Passaggio 6. Installare YANG Suite.

Installare YANG Suite e i relativi moduli necessari per garantire che YANG Suite e le relative dipendenze siano installati senza errori.

Comando:

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

Se si verificano errori del proxy:

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/

Verificare la connettività di rete o il proxy. Se l'ambiente richiede l'utilizzo di un proxy, utilizzare questo comando:

Comando:

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

Passaggio 7. Aggiornare i moduli della suite YANG.

Aggiornare tutti i moduli di YANG Suite per garantirne la piena funzionalità.

Comando:

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

Spiegazione:
Questo passaggio garantisce che YANG Suite disponga dei più recenti plugin per NETCONF, RESTCONF, gNMI e telemetria.

Passaggio 8. Inizializzare YANG Suite.

Eseguire il processo di inizializzazione per accedere alla modalità di configurazione interattiva.

Comando:

(yangsuitevenv) C:\Users\Administrator>yangsuite

Passaggio 9. Configurare Le Impostazioni Di YANG Suite.

Durante l'inizializzazione, viene richiesto di configurare la porta del servizio, il nome host, il nome utente e la password:

Creare una cartella denominata yangsuitespecificdata per memorizzare i dati specifici dell'utente (moduli YANG, profili dispositivo e così via).

Numero porta servizio: il valore predefinito è 8480.

Nome host: si consiglia di utilizzare localhost o 127.0.0.1.

Salva impostazioni: confermare con y.

Crea nome utente e password: per accedere all'interfaccia utente Web di YANG Suite.

Risultato previsto:
La configurazione viene salvata e i servizi possono essere avviati con il comando yangsuite:

(yangsuitevenv) C:\Users\Administrator>yangsuite

Passaggio 10. Accedere a Yang Suite tramite il browser: http://localhost:8480/ per accedere a Cisco Yang Suite:

Verifica

Passaggio 1. Configurare Catalyst 9800 WLC.

verificare che Netconf Yang Status e la porta SSH siano abilitati sul WLC.

Selezionare WLC > Administration > Management > HTTP/HTTPS/Netconf/VTY per abilitare lo stato di configurazione di Netconf Yang e abilitare la porta SSH 830.

Configurazione dalla CLI:

9800(config)#netconf-yang

Configurare le impostazioni AAA.

Configurazione dalla CLI:

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

Passaggio 2. Aggiungere il WLC a YANG Suite.

In YANG Suite, selezionare Setup > Device Profiles > Create New Device (Impostazione > Profili dispositivo > Crea nuovo dispositivo).

 Immettere il nome del profilo, l'indirizzo IP del WLC, il nome utente e la password.

Attivare netconf facendo clic su Il dispositivo supporta NETCONF e facendo clic su Ignora convalida chiave SSH per il dispositivo.

Attivare Restconf facendo clic su Il dispositivo supporta RESTCONF e cancellare l'URL di base predefinito di RESTCONF per svuotarlo.

Per attivare SSH, fare clic su Device allowed SSH login (Il dispositivo consente l'accesso SSH) e verificare le informazioni WLC.

Passaggio 3. Verificare la raggiungibilità del dispositivo.

Fare clic su Controlla raggiungibilità del dispositivo selezionato e selezionare il profilo del dispositivo per verificare se il WLC può essere raggiunto da YANG Suite.

Passaggio 4. Creare un repository di YANG Suite.

Creare un repository per archiviare i modelli WLC YANG necessari.

Selezionare NETCONF e Select device profile per ottenere l'elenco degli schemi per scaricare tutti gli schemi dal WLC

Passaggio 5. Creare un modulo New YANG impostato sul repository di file YANG associato.

Ad esempio, se sono richieste le informazioni wireless di modelli YANG specifici di Catalyst 9800, immettere wireless per scegliere tutti i moduli e fare clic su Aggiungi selezionati.

Se sono necessari più componenti wireless, è sufficiente fare clic su Aggiungi intero repository in questa fase. 

Se si aggiungono solo i moduli wireless, è disponibile anche un pulsante denominato Individua e aggiungi dipendenze mancanti. Facendo clic su di esso vengono automaticamente inseriti tutti i moduli aggiuntivi richiesti dal modulo wireless.

Passaggio 6. Verificare le query XPath.

Utilizzare l'espressione XPath fornita da YANG Suite per ottenere i dati dal WLC.

Ottenere l'espressione XPath necessaria in YANG Suite.

Di seguito è riportato un esempio di nome dell'interfaccia di gestione del controller.

Configura elemento di telemetria nella CLI del WLC

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

Ad esempio:

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

Abilitare il monitoraggio nella telemetria RPC per ottenere i dati necessari inviati dal WLC.

Informazioni correlate

• Guida alla programmabilità e telemetria di Catalyst 9800
• Benvenuto alla Cisco YANG Suite!
• Cisco Community per DevNet