Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
SUR CETTE PAGE
 

Gérer les packages, modules et scripts YANG sur les équipements Junos

RÉSUMÉ  Chargez des packages YANG personnalisés sur les équipements Junos pour ajouter vos propres appels de procédure à distance (RPC) et vos modèles de données à l’équipement.

Vous pouvez charger des modules YANG personnalisés sur les équipements Junos pour ajouter des RPC et des modèles de données qui ne sont pas pris en charge nativement par le système d’exploitation, mais peuvent être pris en charge par la traduction. Lorsque vous chargez des modèles de données YANG non-atifs sur l’équipement, vous devez également charger les scripts de traduction, les scripts d’action et les modules d’écart requis par ces modèles de données.

Note:

À partir de la version 17.3R1 de Junos OS, lorsque vous chargez des modèles de données YANG personnalisés sur l’équipement, vous n’avez pas besoin de charger explicitement les modules d’extension Junos OS requis. Dans les versions précédentes, vous devez charger les modules d’extension Junos OS pour tous les packages qui utilisent les modules.

Les équipements Junos utilisent des packages pour identifier une collection de modules YANG, de scripts de traduction et de scripts d’action associés. Chaque paquet possède un identifiant unique. Lorsque vous ajoutez des modules et des scripts YANG à l’équipement, vous devez les associer à un package nouveau ou existant. Cette rubrique explique comment créer, mettre à jour et supprimer des packages YANG et ajouter ou mettre à jour leurs modules et scripts associés.

Note:

Pour éviter les erreurs liées aux CLI ou à la base de données de configuration, nous vous recommandons de ne pas effectuer d’opérations CLI, de modifier la configuration ou de mettre fin à l’opération pendant qu’un équipement est en train d’ajouter, de mettre à jour ou de supprimer un package YANG et de modifier le schéma.

Création d’un package YANG et ajout de modules et de scripts

Pour valider les modules et scripts YANG et les ajouter à un nouveau package :

  1. Téléchargez les modules YANG et tous les scripts nécessaires dans n’importe quel répertoire de l’équipement.
  2. Assurez-vous que les scripts d’action Python non signés appartiennent soit à la racine soit à un utilisateur dans la classe de connexion Junos OS super-user et que seul le propriétaire du fichier ait l’autorisation d’écrire le fichier.
    Note:

    Les utilisateurs ne peuvent exécuter des scripts Python non signés sur les équipements Junos que lorsque les autorisations de fichier du script incluent l’autorisation de lecture pour la première classe dans laquelle l’utilisateur relève, dans l’ordre de l’utilisateur, du groupe ou d’autres.

  3. (Facultatif) Validez la syntaxe des modules et scripts.
  4. Créez un package YANG avec un identifiant unique et spécifiez les chemins de fichier pour les modules et les scripts qui font partie de ce package, ainsi que pour tous les modules de déviation qui identifient les écarts pour les modules de ce package.
    Note:

    Vous pouvez spécifier le chemin absolu ou relatif vers un seul fichier, ou ajouter plusieurs fichiers en spécifiant une liste de chemins de fichiers délimitée par l’espace, jointe entre crochets.
    Note:

    Pour installer des modules OpenConfig qui sont présentés sous la forme d’un fichier tar compressé, utilisez la request system software add commande. Les modules et scripts OpenConfig installés par l’émission de la request system software add commande sont toujours associés à l’identifiant openconfigdu package .
    Note:

    À partir de la version 18.3R1 de Junos OS, l’ajout, la suppression ou la mise à jour de paquets YANG en mode configuration avec la run commande n’est pas prise en charge.
  5. Lorsque le système vous invite à redémarrer l’interface cli Junos OS, appuyez sur Enter pour accepter la valeur par défaut de yes.
  6. Vérifiez que le package a été créé et contient les modules et scripts appropriés.
  7. Si le package comprend des scripts de traduction ou des scripts d’action écrits en Python, autorisez l’équipement à exécuter des scripts Python non signés en configurant l’instruction language python ou language python3 , selon le cas pour la version Junos OS.
    Note:

    À partir de Junos OS version 20.2R1 et Junos OS Evolved version 22.3R1, l’équipement utilise Python 3 pour exécuter des actions YANG et des scripts de traduction. Dans les versions précédentes, Junos OS utilise uniquement Python 2.7 pour exécuter ces scripts, et Junos OS Evolved utilise Python 2.7 par défaut pour exécuter les scripts.
  8. Sur les systèmes multichassis, répétez les étapes 1 à 7 sur chaque nœud du système.

Lorsque vous créez un nouveau package, l’équipement stocke des copies du module et des fichiers de script dans un nouvel emplacement. L’équipement stocke également des copies des fichiers de script d’action et de traduction sous les répertoires /var/db/scripts/action et /var/db/scripts/traduction , respectivement. Une fois les modules et les scripts validés et ajoutés à l’équipement, Junos OS reconstruit son schéma pour inclure les nouveaux modèles de données, puis valide la configuration active par rapport à ce schéma. Les RPC et les hiérarchies de configuration nouvellement ajoutés sont immédiatement disponibles.

Note:

Les équipements qui utilisent la base de données de configuration éphémère supprimeront toutes les données de configuration éphémères en cours de reconstruction du schéma.

Note:

Junos OS ne prend pas en charge le configure private mode de configuration d’instructions correspondant à des modèles de données YANG tiers, par exemple OpenConfig ou des modèles de données YANG personnalisés.

Mise à jour d’un package YANG avec des modules et scripts nouveaux ou modifiés

Vous créez un nouveau package YANG en exécutant la request system yang add commande. Pour mettre à jour un package existant afin d’ajouter de nouveaux modules et scripts au package ou de mettre à jour des modules et scripts existants dans le package, vous devez utiliser la request system yang update commande.

Pour mettre à jour un package YANG avec des modules et scripts nouveaux ou modifiés :

  1. Téléchargez les modules et les scripts sur n’importe quel répertoire de l’équipement.
  2. Assurez-vous que les scripts d’action Python non signés appartiennent soit à la racine soit à un utilisateur dans la classe de connexion Junos OS super-user et que seul le propriétaire du fichier ait l’autorisation d’écrire le fichier.
    Note:

    Les utilisateurs ne peuvent exécuter des scripts Python non signés sur les équipements Junos que lorsque les autorisations de fichier du script incluent l’autorisation de lecture pour la première classe dans laquelle l’utilisateur relève, dans l’ordre de l’utilisateur, du groupe ou d’autres.

  3. (Facultatif) Validez la syntaxe des modules et scripts.
  4. Mettez à jour le package YANG en publiant la request system yang update commande et spécifiez les chemins des fichiers pour les nouveaux modules et scripts modifiés.
    Note:

    Vous pouvez spécifier le chemin absolu ou relatif vers un seul fichier, ou mettre à jour plusieurs fichiers en spécifiant une liste de chemins de fichiers délimitées par l’espace entre parenthèses.
    Note:

    À partir de la version 18.3R1 de Junos OS, l’ajout, la suppression ou la mise à jour de paquets YANG en mode configuration avec la run commande n’est pas prise en charge.
  5. Lorsque le système vous invite à redémarrer l’interface cli Junos OS, appuyez sur Enter pour accepter la valeur par défaut de yes.
  6. Si le package comprend des scripts de traduction ou des scripts d’action écrits en Python, autorisez l’équipement à exécuter des scripts Python non signés en configurant l’instruction language python ou language python3 , selon le cas pour la version Junos OS, si elle n’est pas déjà configurée.
    Note:

    À partir de Junos OS version 20.2R1 et Junos OS Evolved version 22.3R1, l’équipement utilise Python 3 pour exécuter des actions YANG et des scripts de traduction. Dans les versions précédentes, Junos OS utilise uniquement Python 2.7 pour exécuter ces scripts, et Junos OS Evolved utilise Python 2.7 par défaut pour exécuter les scripts.
  7. Sur les systèmes multichassis, répétez les étapes 1 à 6 sur chaque nœud du système.

Lorsque vous mettez à jour un package, l’équipement stocke des copies du nouveau module et des fichiers de script modifiés. Junos OS reconstruit ensuite son schéma pour inclure toutes les modifications apportées aux modèles de données associés à ce package et valide la configuration active par rapport à ce schéma.

Note:

Les équipements qui utilisent la base de données de configuration éphémère supprimeront toutes les données de configuration éphémères en cours de reconstruction du schéma.

Suppression d’un paquet YANG

ATTENTION:

Avant de supprimer un package YANG d’un équipement Junos, assurez-vous que la configuration active ne contient pas de données de configuration qui dépendent des modèles de données ajoutés par ce package.

Pour supprimer un package YANG et tous les modules et scripts associés à ce package d’un équipement Junos :

  1. Examinez la configuration active pour déterminer s’il y a des dépendances sur les modules YANG qui seront supprimés.
  2. Si la configuration contient des dépendances sur les modules, mettez à jour la configuration pour supprimer les dépendances.
  3. Supprimez le package et les modules et scripts associés en émettant la request system yang delete commande avec l’identifiant de package approprié.
    Note:

    Vous devez utiliser la request system software delete commande pour supprimer les paquets OpenConfig installés d’un fichier tar compressé en mettant la commande en place request system software add .
    Note:

    À partir de la version 18.3R1 de Junos OS, l’ajout, la suppression ou la mise à jour de paquets YANG en mode configuration avec la run commande n’est pas prise en charge.
  4. Si le système vous invite à redémarrer l’interface cli Junos OS, appuyez sur Enter pour accepter la valeur par défaut de yes.

Lorsque vous supprimez un package, Junos OS reconstruit son schéma pour supprimer les modèles de données associés à ce package, puis valide la configuration active par rapport à ce schéma. L’équipement supprime les copies des fichiers de module et de script qui ont été générés lors de la création du package. L’équipement supprime également les copies des fichiers de script d’action et de traduction du package qui sont stockés dans les répertoires /var/db/scripts/action et /var/db/scripts/traduction . Si vous avez téléchargé les fichiers de module et de script d’origine sur un autre emplacement, les fichiers d’origine restent inchangés.

Note:

Les équipements qui utilisent la base de données de configuration éphémère supprimeront toutes les données de configuration éphémères en cours de reconstruction du schéma.

Documentation connexe

Tableau de l’historique des versions
Libération
Description
22.3R1-EVO
À partir de La version 22.3R1 de Junos OS Evolved, Junos OS Evolved utilise Python 3 pour exécuter des actions YANG et des scripts de traduction.
20.2R1
À partir de la version 20.2R1 de Junos OS, Junos OS utilise Python 3 pour exécuter des actions YANG et des scripts de traduction. Dans les versions précédentes, Junos OS utilise Python 2.7 pour exécuter ces scripts.
18.3R1
À partir de la version 18.3R1 de Junos OS, l’ajout, la suppression ou la mise à jour de paquets YANG en mode configuration avec la run commande n’est pas prise en charge.
17.3R1
À partir de la version 17.3R1 de Junos OS, lorsque vous chargez des modèles de données YANG personnalisés sur l’équipement, vous n’avez pas besoin de charger explicitement les modules d’extension Junos OS requis.