Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

<load-configuration>

Utilisation

Description

Demandez que le serveur NETCONF ou Junos XML charge les données de configuration dans la base de configuration du candidat ou dans la base de données de configuration ouverte.

Si une application cliente exécute le protocole <open-configuration> Junos XML pour ouvrir une base de données de configuration spécifique avant d’exécuter l’opération <load-configuration> , le serveur charge les données de configuration dans la base de données de configuration ouverte. Sinon, le serveur charge les données de configuration dans la configuration du candidat.

Fournissez les données à charger de l’une des façons suivantes :

  • Définissez l’attribut de configuration-revision la balise vide <load-configuration/> sur l’identifiant de révision de configuration d’une configuration précédemment validée. La configuration spécifiée remplace complètement la configuration du candidat.

  • Définissez l’attribut de rescue la balise vide <load-configuration/> sur la valeur rescue. La configuration de sauvetage remplace complètement la configuration du candidat.

  • Définissez l’attribut de rollback la balise vide <load-configuration/> sur l’index de restauration d’une configuration précédemment validée. L’équipement stocke une copie de la dernière configuration validée et jusqu’à 49 configurations précédentes. La configuration spécifiée remplace complètement la configuration du candidat.

  • Définissez l’attribut de url la balise vide <load-configuration/> sur le nom du chemin d’un fichier contenant les données de configuration à charger. Définissez l’attribut format jsonsur , textou xml pour charger une configuration dans le format-JavaScript Object Notation (JSON), le texte ASCII au format respectif ou les éléments de balise Junos XML (par défaut). Pour fournir les données de configuration en tant que commandes du mode de configuration, incluez l’attribut action="set" et omettez l’attribut format ou définissez la valeur sur text.

    Dans l’exemple suivant, l’attribut url identifie que les données de configuration doivent être chargées à partir du fichier /tmp/add.conf .

  • Enfermer les données de configuration en tant que flux de données dans une balise d’ouverture <load-configuration> et de fermeture </load-configuration> . Si vous fournissez les données de configuration sous forme de texte ASCII, enfermez les données dans un <configuration-text> élément de balise et définissez l’attribut format sur text. Si vous fournissez les données de configuration en tant qu’éléments de balise XML Junos, enfermez les données dans un <configuration> élément de balise et omettez l’attribut format ou définissez la valeur sur xml. Si vous fournissez les données de configuration en tant que commandes de mode de configuration, enfermez les données dans un <configuration-set> élément de balise, définissez l’attribut action sur set, et omettez l’attribut format ou définissez la valeur sur text. Si vous fournissez les données de configuration dans JSON, enfermez les données dans un <configuration-json> élément de balise et définissez l’attribut format sur json.

Attributs

action

Spécifiez comment charger les données de configuration, en particulier lorsque la base de données de configuration cible et la configuration chargée contient des instructions contradictoires.

La base de données de configuration éphémère prend en charge les valeurs d’attribut suivantes sur les action équipements pris en charge dans les versions spécifiées :

  • merge et set— pris en charge dans Junos OS version 16.2R2 et versions ultérieures

  • override et replace— pris en charge dans Junos OS version 18.1R1 et versions ultérieures

  • update— compatible avec Junos OS version 21.1R1 et versions ultérieures

Les valeurs acceptables sont les suivantes :

  • merge: combinez les données de la configuration chargée avec les données de la configuration cible. Si les instructions de la configuration chargée sont en conflit avec celles de la configuration cible, les instructions chargées remplacent celles de la configuration cible. Il s’agit du comportement par défaut si l’attribut action est omis.

  • override: éliminez toute la configuration du candidat et remplacez-la par la configuration chargée. Lorsque la configuration est validée ultérieurement, tous les processus système analysent la nouvelle configuration.

  • replace: remplacez chaque niveau hiérarchique ou objet de configuration défini dans la configuration chargée par le niveau ou l’objet correspondant dans la configuration candidate.

    Si vous fournissez les données de configuration en tant que texte ASCII (soit dans le fichier nommé par l’attribut url ou joint à un <configuration-text> élément de balise), placez également l’instruction sur la replace: ligne qui précède directement les instructions qui représentent le niveau hiérarchique ou l’objet à remplacer. Pour plus d’informations, consultez la discussion sur le chargement d’un fichier de données de configuration dans le Guide de l’utilisateur CLI.

    Si vous fournissez les données de configuration en tant qu’éléments de balise XML Junos, incluez l’attribut replace="replace" dans les balises d’ouverture des éléments qui représentent les niveaux hiérarchiques ou les objets à remplacer.

  • set— Chargez les données de configuration en tant que commandes du mode de configuration Junos OS. Cette option exécute les instructions de configuration ligne par ligne dès qu’elles sont stockées dans un fichier nommé par l’attribut url ou joint à un <configuration-set> élément de balise. Les instructions peuvent contenir n’importe quelle commande de mode de configuration, telle que set, delete, editou deactivate. Lorsque vous fournissez les données de configuration sous la forme d’un ensemble de commandes, la seule valeur acceptable pour l’attribut format est « text ». Si la valeur de l’attribut action est « set » et que l’attribut format est omis, l’attribut format passe automatiquement par défaut à « text » plutôt qu’à xml.

  • update— Comparez une configuration chargée complète avec la configuration du candidat. Pour chaque niveau hiérarchique ou objet de configuration différent dans les deux configurations, la version de la configuration chargée remplace la version dans la configuration du candidat. Lorsque la configuration est validée ultérieurement, seuls les processus système affectés par les éléments de configuration modifiés analysent la nouvelle configuration.

configuration-revision

Chargez une configuration précédemment validée en faisant référence à son identifiant de révision de configuration. La configuration spécifiée remplace complètement la configuration du candidat.

format

Spécifiez le format utilisé pour les données de configuration. Les valeurs acceptables sont les suivantes :

  • json–Indiquez que les données de configuration sont formatées à l’aide de JavaScript Object Notation (JSON).

  • text: indiquez que les données de configuration sont formatées en tant que texte ASCII ou sous la forme d’un ensemble de commandes de mode de configuration.

    Le format de texte ASCII utilise le caractère de nouvelle ligne, les onglets et d’autres espaces blancs, accolades et crochets pour indiquer les relations hiérarchiques entre les déclarations. Il s’agit du format utilisé dans les fichiers de configuration stockés sur la plate-forme de routage et affiché par la commande CLI show configuration . Le set format de commande se compose d’une série de commandes du mode de configuration Junos OS et est affiché par la show configuration | display set commande CLI. Pour charger un ensemble de commandes de mode de configuration, vous devez définir l’attribut action « set ».

  • xml: indiquez que les données de configuration sont formatées à l’aide d’éléments de balise XML Junos. Si l’attribut format est omis, « xml » est le format par défaut de toutes les valeurs de l’attribut, à l’exception action de « set », qui met par défaut en forme « text ».

rescue

Spécifiez que la configuration de sauvetage remplace la configuration candidate actuelle. La seule valeur valable est « rescue ».

Note:

À partir de la version 18.1R1 de Junos OS, vous pouvez également utiliser le <rollback-config> RPC pour charger une configuration précédemment validée, ce qui est utile pour les applications qui ne prennent pas en charge l’exécution de RPC qui incluent des attributs XML.

rollback

Chargez une configuration précédemment engagée en faisant référence à son index de restauration numérique. Les valeurs valides sont 0 (zéro, pour la configuration la plus récemment validée) et une de moins que le nombre de configurations précédentes stockées (maximum de 49).

Note:

À partir de la version 18.1R1 de Junos OS, vous pouvez également utiliser le <rollback-config> RPC pour charger une configuration précédemment validée, ce qui est utile pour les applications qui ne prennent pas en charge l’exécution de RPC qui incluent des attributs XML.

url

Spécifiez le nom de chemin complet du fichier qui contient les données de configuration à charger. La valeur peut être un chemin de fichier local, un emplacement FTP ou une URL HTTP (Hypertexte Transfer Protocol) :

  • Un nom de fichier local peut avoir l’une des formes suivantes :

    • /path/filename—Fichier sur un système de fichiers monté, sur le disque flash local ou sur le disque dur.

    • Un:filename ou un:path/filename—Fichier sur le lecteur local. Le chemin par défaut est / (le répertoire racine). Les supports amovibles peuvent être au format MS-DOS ou UNIX (UFS).

  • Un nom de fichier sur un serveur FTP se présente sous la forme suivante :

  • Un nom de fichier sur un serveur HTTP se présente sous la forme suivante :

Dans chaque cas, la valeur par défaut de la variable est le path répertoire d’origine du nom d’utilisateur. Pour spécifier un chemin absolu, l’application démarre le chemin avec les caractères %2F ; par exemple, ftp://username:password@hostname/%2Fpath/filename.

Informations de publication

Il s’agit d’une opération de protocole de gestion Junos XML. Il est pris en charge dans les sessions du protocole Junos XML, et il est pris en charge en tant qu’extension propriétaire de Juniper Networks dans les sessions NETCONF sur les équipements exécutant Junos OS qui identifient l’URI http://xml.juniper.net/netconf/junos/1.0 dans l’échange de fonctionnalités.

action valeur set ajoutée de Junos OS version 11.4.

format valeur json ajoutée de Junos OS version 16.1.

configuration-revision ajouté à Junos OS Version 20.4R1 et Junos OS Evolved Version 20.4R1.