Télécharger et mettre en forme les données de configuration dans une session NETCONF
Lors d’une session NETCONF avec un équipement exécutant Junos OS, une application cliente peut spécifier le mécanisme de livraison et le format des données de configuration utilisées lors de la transmission des modifications de configuration à l’équipement. Les applications clientes peuvent utiliser un fichier texte ou des données en streaming pour télécharger des données de configuration dans l’un des formats acceptés dans la base de données de configuration du candidat ou ouverte.
Un client peut choisir de diffuser les modifications de configuration dans la session ou de référencer des fichiers de données qui incluent les modifications de configuration souhaitées. Chaque méthode présente des avantages et des inconvénients. Le streaming de données vous permet d’envoyer vos données de modification de configuration en ligne à l’aide de votre connexion NETCONF. Cela est utile lorsque l’équipement se trouve derrière un pare-feu et que vous ne pouvez pas établir une autre connexion pour télécharger un fichier de données. Avec les fichiers texte, vous pouvez garder les commandes de configuration de modification simples; avec les fichiers de données, il n’est pas nécessaire d’inclure le flux de données de configuration éventuellement complexe.
Les <copy-config> opérations et <edit-config> acceptent l’un des deux formats pour les données de configuration Junos OS : les déclarations de configuration Junos XML ou CLI. Le choix entre un format de données plutôt que l’autre est une préférence personnelle.
Lorsqu’elle gère des équipements exécutant Junos OS, une application cliente peut utiliser le protocole <load-configuration> Junos XML dans une session NETCONF pour télécharger des données de configuration formatées à l’aide de commandes JSON ou du mode set de configuration, en plus des formats d’énoncés de configuration Junos XML ou CLI.
Le mécanisme de livraison et le format sont abordés en détail dans les sections suivantes :
Référence aux fichiers de données de configuration
Pour télécharger les données de configuration stockées dans un fichier, une application cliente émet l’emplacement du fichier entre les <url> balises au sein du <rpc> ou <copy-config> des <edit-config> éléments de balise.
<rpc> <copy-config> <target> <candidate/> </target> <source> <url> <!-- location and name of file containing configuration data --> </url> </source> </copy-config> </rpc> ]]>]]>
<rpc> <edit-config> <target> <candidate/> </target> <url> <!-- location and name of file containing configuration data --> </url> </edit-config> </rpc> ]]>]]>
Les données de ces fichiers peuvent être formatées sous forme d’éléments XML Junos ou d’instructions de configuration CLI. Lorsque les données de configuration sont mises en forme en tant qu’instructions de configuration CLI, incluez l’attribut format="text" dans la <url> balise.
<url format="text">
<!-- location and name of file containing configuration data -->
</url>
Le fichier de configuration peut être placé localement ou en tant que ressource réseau.
-
Une fois placé localement, le chemin du fichier de configuration peut être relatif ou absolu :
-
Chemin relatif du fichier : l’emplacement du fichier est basé sur le répertoire de base de l’utilisateur.
-
Chemin de fichier absolu : l’emplacement du fichier est basé sur la structure de répertoire de l’équipement, par exemple <drive>:filename ou <drive>/:path/filename, Si vous utilisez un support amovible, le lecteur peut être au format MS-DOS ou UNIX (UFS).
-
-
Lorsqu’il est situé sur le réseau, le fichier de configuration est accessible à l’aide de FTP ou HTTP :
-
Exemple FTP :
ftp://username:password@hostname/path/filename
Note:La valeur par défaut de la variable FTP path est le répertoire d’origine de l’utilisateur. Ainsi, par défaut, le chemin du fichier de configuration est relatif au répertoire utilisateur. Pour spécifier un chemin absolu lors de l’utilisation de FTP, démarrez le chemin avec les caractères %2F ; par exemple : ftp://username:password@hostname/%2Fpath/filename.
-
Exemple HTTP :
http://username:password@hostname/path/filename
-
Avant de charger le fichier, l’application cliente ou un administrateur enregistre les éléments de balise XML Junos ou les déclarations de configuration CLI dans le contenu du fichier. Le fichier inclut les éléments de balise ou les déclarations de configuration représentant tous les niveaux de la hiérarchie de configuration, de la racine (représentée par l’élément <configuration> de balise) à chaque élément à modifier. La notation est la même que celle utilisée pour demander des informations de configuration. Pour plus d’informations sur la représentation XML Junos des instructions de configuration Junos OS, voir Mapper les déclarations de configuration aux éléments de balise XML Junos.
L’exemple suivant montre comment intégrer les données de configuration stockées dans le fichier /var/tmp/configFile sur le serveur FTP appelé ftp.myco.com :
Données de configuration en streaming
Pour fournir des données de configuration en tant que flux de données, une application cliente émet des <config> éléments de balise dans <config-text> les éléments et de <rpc> <edit-config> balise. Pour spécifier les éléments de configuration à modifier, l’application émet des déclarations de configuration Junos XML ou CLI représentant tous les niveaux de la hiérarchie de configuration depuis la racine (représentée par l’élément ou <configuration-text> balise<configuration>) jusqu’à chaque élément à modifier. La notation Junos XML est la même que celle utilisée pour demander des informations de configuration.
<rpc> <edit-config> <target> <candidate/> </target> <config> <configuration> <!-- configuration changes --> </configuration> </config> </edit-config> </rpc> ]]>]]>
<rpc> <edit-config> <target> <candidate/> </target> <config-text> <configuration-text> <!-- configuration changes --> </configuration-text> </config-text> </edit-config> </rpc> ]]>]]>
Pour plus d’informations sur les mappages entre les éléments de configuration Junos OS et les éléments de balise XML Junos, consultez Mapper les déclarations de configuration aux éléments de balise XML Junos. La notation des déclarations de configuration CLI est décrite plus en détail dans le Guide de l’utilisateur CLI.
L’exemple suivant montre comment fournir des données de configuration Junos XML dans un flux de données pour configurer le fichier journal du système de messages :
Données de formatage : déclarations de configuration Junos XML et CLI
Le NETCONF <copy-config> et <edit-config> les opérations acceptent l’un des deux formats pour les données de configuration Junos OS : les déclarations de configuration Junos XML ou CLI. Le choix entre un format de données plutôt que l’autre est une préférence personnelle.
Lorsqu’elle gère des équipements exécutant Junos OS, une application cliente peut utiliser le protocole <load-configuration> Junos XML dans une session NETCONF pour télécharger des données de configuration formatées à l’aide de commandes JSON ou du mode set de configuration, en plus des formats d’énoncés de configuration Junos XML ou CLI.
Si vous fournissez les modifications de configuration sous forme de fichiers de données, vous enfermez le nom et le chemin des données dans <url> les balises. Par défaut, ces balises spécifient que les fichiers de données référencés contiennent des données de configuration au format Junos XML. Ainsi, le code suivant déclare que les données du fichier sont des éléments Junos XML :
<url>dataFile</url>
Pour spécifier que le fichier de données contient des instructions de configuration CLI, incluez l’attribut format="text" dans la <url> balise.
<url format="text">dataFile</url>
Lorsque vous diffusez des données, vous spécifiez le format des données en sélectionnant l’une des deux balises : <config> pour les éléments XML Junos et <config-text> pour les instructions de configuration CLI.
Dans l’exemple suivant, l’élément <configuration> contient des données de configuration au format Junos XML :
<config>
<configuration>
<system>
<services>
<ssh>
<protocol-version>v2</protocol-version>
</ssh>
</services>
</system>
</configuration>
</config>
Dans l’exemple suivant, l’élément <configuration-text> contient les mêmes données formatées que les instructions de configuration CLI :
<config-text>
<configuration-text>
system {
services {
ssh {
protocol-version v2;
}
}
}
</configuration-text>
</config-text>