Déployer Yang Suite et tester XPath sur le WLC Catalyst 9800

Introduction

Ce document décrit comment déployer Yang Suite dans un environnement Python et tester XPath sur le WLC Cisco Catalyst 9800.

Conditions préalables

Exigences

Cisco vous recommande de prendre connaissance des rubriques suivantes :

- Configuration WLC du Catalyst 9800

- Connaissance de base de Python et des environnements virtuels

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• WLC Cisco Catalyst9800 Cisco IOS® XE Version 17.15.3

• Microsoft Windows 11 Entreprise avec Python 3.8.2 installé

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Configurer

Étape 1. Installer Python sur un PC Windows

Téléchargez et installez Python 3.8.2 pour Windows.

Lien de téléchargement : Versions Python pour Windows

Explication:
Python est requis pour exécuter YANG Suite. La version 3.8.2 est utilisée ici pour la compatibilité.

Étape 2 : vérification de l’installation de Python et PIP

Après l'installation, vérifiez que Python et PIP fonctionnent correctement.

Commandes :

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

Résultat prévu (exemple) :

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)

Étape 3. Mise à niveau de PIP vers la dernière version pour assurer la compatibilité avec YANG Suite.

commande :

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

Explication:
Cette commande désinstalle l'ancienne version de PIP et installe la dernière pour assurer la compatibilité avec YANG Suite.
Résultat prévu (exemple) :
- L'ancienne version (par exemple, pip 19.2.3) est désinstallée.
- La nouvelle version (par exemple, pip 25.0.1) est correctement installée.

Étape 4. Créer un environnement virtuel pour isoler les dépendances du système Python.

commande :

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

Résultat prévu :
Un nouveau dossier nommé yangsuitevenv est créé sur votre PC C:\Users\Administrator.

Étape 5 : activation de l'environnement virtuel

Activez l'environnement avant d'installer les packages.

commande :

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

Résultat prévu :
L'invite de commande change pour afficher l'environnement actif, par exemple :

(yangsuitevenv) C:\Users\Administrator>

Étape 6. Installation de YANG Suite

Installez YANG Suite et ses modules requis pour vous assurer que YANG Suite et ses dépendances sont installés sans erreurs.

commande :

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

Si vous rencontrez des erreurs de 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/

Vérifiez la connectivité réseau ou le proxy. Si votre environnement requiert l'utilisation d'un proxy, utilisez plutôt cette commande :

commande :

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

Étape 7. Mise à niveau des modules de la suite YANG

Mettre à jour tous les modules de la suite YANG pour garantir la fonctionnalité complète.

commande :

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

Explication:
Cette étape permet de s'assurer que YANG Suite dispose des derniers plugins pour NETCONF, RESTCONF, gNMI et la télémétrie.

Étape 8. Initialisation de la suite YANG

Exécutez le processus d'initialisation pour passer en mode de configuration interactif.

commande :

(yangsuitevenv) C:\Users\Administrator>yangsuite

Étape 9 : configuration des paramètres de la suite YANG

Lors de l'initialisation, vous êtes invité à configurer le port de service, le nom d'hôte, le nom d'utilisateur et le mot de passe :

Créez un dossier nommé yangsuitspecificdata pour stocker les données spécifiques à l'utilisateur (modules YANG, profils de périphériques, etc.).

Numéro du port de service : le défaut est 8480.

Nom de l´hôte : recommandé d'utiliser localhost ou 127.0.0.1.

Enregistrer les paramètres : confirmez avec y.

Créer un nom d'utilisateur et un mot de passe : pour accéder à l'interface utilisateur Web de YANG Suite.

Résultat prévu :
La configuration est enregistrée, et les services peuvent être démarrés avec la commande yangsuite :

(yangsuitevenv) C:\Users\Administrator>yangsuite

Étape 10. Connectez-vous à Yang Suite via le navigateur : http://localhost:8480/ pour accéder à Cisco Yang Suite :

Vérifier

Étape 1 : configuration du WLC Catalyst 9800

Assurez-vous que l'état Yang Netconf et le port SSH sont activés sur le WLC.

Accédez à WLC > Administration > Management > HTTP/HTTPS/Netconf/VTY pour activer l'état de configuration de Yang Netconf et activer le port SSH 830.

Configuration CLI :

9800(config)#netconf-yang

Configurez les paramètres AAA.

Configuration CLI :

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

Étape 2 : ajout du WLC à la suite YANG

Dans YANG Suite, accédez à Setup > Device Profiles > Create New Device.

 Saisissez le nom du profil, l'adresse IP du WLC, le nom d'utilisateur et le mot de passe.

Activez netconf en cliquant sur Device supported NETCONF et en cliquant sur Skip SSH key validation for this device.

Activez Restconf en cliquant sur Device supporte RESTCONF et effacez l'URL de base RESTCONF par défaut pour la vider.

Activez SSH en cliquant sur Device allow SSH login et vérifiez les informations du WLC.

Étape 3. Vérification de l’accessibilité du périphérique

Cliquez sur le Vérifier l'accessibilité du périphérique sélectionné et sélectionnez le profil du périphérique pour vérifier si le WLC peut être atteint à partir de la suite YANG.

Étape 4 : création d'un référentiel de la suite YANG.

Créez un référentiel pour stocker les modèles YANG WLC nécessaires.

Sélectionnez NETCONF et Select device profile pour obtenir la liste de schémas afin de télécharger tout le schéma à partir du WLC

Étape 5. Créer un nouveau module YANG défini sur le référentiel de fichiers YANG associé.

Par exemple, si les informations sans fil des modèles YANG spécifiques au Catalyst 9800 sont requises, entrez wireless pour choisir tous les modules et cliquez sur Add selected.

Si vous avez besoin de plus que des composants sans fil, vous pouvez simplement cliquer sur Ajouter un référentiel entier à cette étape. 

Si vous ajoutez uniquement les modules sans fil, il y a aussi un bouton appelé Locate et ajouter les dépendances manquantes. Si vous cliquez dessus, tous les modules supplémentaires requis par le module sans fil sont automatiquement ajoutés.

Étape 6. Test des requêtes XPath

Utilisez le XPath fourni par YANG Suite pour obtenir des données du WLC.

Obtenez le XPath nécessaire dans YANG Suite.

Prenons l'exemple du nom de l'interface de gestion du contrôleur.

Configurer l'ietf de télémétrie sur CLI 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

Exemple :

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

Activez la surveillance dans la télémétrie gRPC pour obtenir les données nécessaires envoyées par le WLC.

Informations connexes

• Guide de déploiement programmabilité et télémétrie du Catalyst 9800
• Bienvenue dans la suite Cisco YANG !
• Communauté Cisco pour DevNet