Remplacer la configuration du candidat à l’aide de NETCONF
Dans une session NETCONF avec un équipement exécutant Junos OS, une application cliente peut remplacer l’intégralité de la configuration du candidat ou toutes les données de la base de données de configuration ouverte, soit par de nouvelles données, soit en revenir à une configuration précédente ou à une configuration de sauvetage.
Si une application cliente exécute le protocole <open-configuration>
Junos XML pour ouvrir une base de données de configuration spécifique avant de charger les données de configuration, Junos OS effectue l’opération demandée sur la base de données de configuration ouverte. Dans le cas contraire, l’opération est effectuée sur la configuration du candidat.
Les sections suivantes expliquent comment remplacer les données de configuration du candidat ou la base de données de configuration ouverte. L’application cliente doit valider la configuration après avoir remplacé les données pour en faire la configuration active sur l’équipement.
À l’aide de <copy-config> remplacer la configuration
L’une des méthodes de remplacement de l’ensemble de la configuration du candidat ou de toutes les données de la base de données de configuration ouverte consiste à utiliser l’opération <copy-config>
. La <target>
balise renferme la <candidate/>
balise pour indiquer que les nouvelles données de configuration remplacent soit les données de la base de données de configuration ouverte (si l’application cliente a émis l’opération du protocole <open-configuration>
Junos XML avant l’exécution de l’opération <copy-config>
), ou s’il n’y a pas de base de données ouverte, les données dans la configuration du candidat.
L’élément <source>
contient l’élément <url>
, qui spécifie le nom de fichier qui contient les nouvelles données de configuration. Lorsque les données de configuration sont mises en forme en tant qu’éléments de balise XML Junos, définissez l’attribut <url>
format
xml
ou omettez l’attribut. Lorsque les données de configuration sont mises en forme en tant qu’instructions de configuration CLI, définissez l’attribut format <url>
sur text
.
<rpc> <copy-config> <target> <candidate/> </target> <source> <url format="(xml | text)"> <!-- location specifier for file containing the new configuration --> </url> </source> </copy-config> </rpc> ]]>]]>
À l’aide de <edit-config> remplacer la configuration
Une autre méthode pour remplacer l’ensemble de la configuration du candidat ou toutes les données de la base de données de configuration ouverte consiste à utiliser l’opération <edit-config>
et à définir le mode replace
de configuration de modification comme une variable globale. L’application inclut l’élément <default-operation>
de balise avec la valeur replace
de l’élément <edit-config>
de balise, comme décrit dans Définir le mode de configuration de modification dans une session NETCONF. La <target>
balise renferme la <candidate/>
balise pour indiquer que les nouvelles données de configuration remplacent soit les données de la base de données de configuration ouverte (si l’application cliente a émis l’opération du protocole <open-configuration>
Junos XML avant l’exécution de l’opération <edit-config>
), ou s’il n’y a pas de base de données ouverte, les données dans la configuration du candidat.
Pour spécifier les nouvelles données de configuration, l’application inclut un ou un <config>
<config-text>
élément de balise qui contient les données, ou un <url>
élément de balise qui nomme le fichier contenant les données, comme indiqué dans Télécharger et mettre en forme les données de configuration dans une session NETCONF.
<rpc> <edit-config> <target> <candidate/> </target> <default-operation>replace</default-operation> <!-- EITHER --> <config> <configuration> <!-- Junos XML configuration data --> </configuration> </config> <!-- OR --> <config-text> <configuration-text> <!-- configuration data in text format --> </configuration-text> </config-text> <!-- OR --> <url> <!-- location specifier for file containing changes --> </url> </edit-config> </rpc> ]]>]]>
Retour à une configuration précédemment engagée
Les équipements exécutant Junos OS stockent une copie de la dernière configuration validée et jusqu’à 49 configurations précédentes, selon la plate-forme. Vous pouvez revenir à n’importe quelle configuration stockée. Cela est utile lorsque les modifications de configuration donnent des résultats indésirables et que vous souhaitez revenir à une configuration de travail connue. La restauration de la configuration est similaire au processus de modification de configuration sur l’équipement, mais au lieu de charger les données de configuration, vous effectuez une restauration, qui remplace l’ensemble de la configuration du candidat par une configuration précédemment validée.
À partir de la version 18.1R1 de Junos OS, une application NETCONF peut exécuter le <rollback-config>
RPC pour remplacer la configuration du candidat ou toutes les données de la base de données de configuration ouverte par une configuration précédemment validée. Pour restaurer la configuration, l’application émet l’élément <rollback-config>
avec l’élément <index>
enfant, qui spécifie l’index numérique de la configuration précédente à charger. 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).
Les applications NETCONF peuvent également utiliser le protocole <load-configuration>
Junos XML avec l’attribut rollback
pour restaurer la configuration.
Par exemple, pour charger la configuration avec un index de restauration de 1, l’application cliente émet le RPC suivant :
<rpc> <rollback-config> <index>1</index> </rollback-config> </rpc> ]]>]]>
Le serveur NETCONF indique que l’opération de charge a réussi en renvoyant les <rollback-config-results>
éléments et <ok/>
dans sa réponse RPC.
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/18.1R1/junos"> <rollback-config-results> <ok/> </rollback-config-results> </rpc-reply> ]]>]]>
Si l’opération de charge est réussie, l’application cliente doit valider la configuration pour en faire la configuration active sur l’équipement. Si le serveur rencontre une erreur lors du chargement de la configuration de restauration, il renvoie un <rpc-error>
élément avec des informations sur l’erreur.
Remplacer la configuration du candidat par la configuration de sauvetage
Une configuration de sauvetage vous permet de définir une configuration de travail connue ou une configuration avec un état connu que vous pouvez restaurer à tout moment. Vous utilisez la configuration de sauvetage lorsque vous devez revenir à une configuration connue ou en dernier recours si la configuration de l’équipement et les fichiers de configuration de sauvegarde sont endommagés au-delà de toute réparation. Lorsque vous créez une configuration de sauvetage, l’équipement enregistre la dernière configuration validée en tant que configuration de sauvetage.
À partir de la version 18.1R1 de Junos OS, une application NETCONF peut exécuter le <rollback-config>
RPC pour remplacer la configuration du candidat ou toutes les données de la base de données de configuration ouverte par la configuration de sauvetage de l’équipement. Pour charger la configuration de sauvetage, l’application émet l’élément et <rescue/>
la <rollback-config>
balise enfant. La configuration de sauvetage doit exister sur l’équipement avant de pouvoir le charger.
Les applications NETCONF peuvent également utiliser le protocole <load-configuration>
Junos XML avec l’attribut rescue
pour charger la configuration de sauvetage.
Par exemple, pour charger la configuration de sauvetage, l’application cliente émet le RPC suivant :
<rpc> <rollback-config> <rescue/> </rollback-config> </rpc> ]]>]]>
Le serveur NETCONF indique que l’opération de charge a réussi en renvoyant les <rollback-config-results>
éléments et <ok/>
dans sa réponse RPC.
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/18.1R1/junos"> <rollback-config-results> <ok/> </rollback-config-results> </rpc-reply> ]]>]]>
Si l’opération de charge est réussie, l’application cliente doit valider la configuration pour en faire la configuration active sur l’équipement. Si la configuration de sauvetage n’existe pas ou si le serveur rencontre une autre erreur lors du chargement des données de configuration, il renvoie un <rpc-error>
élément avec des informations sur l’erreur.