Valider la configuration candidate à l’aide de NETCONF
Lorsque vous validez la configuration candidate sur un équipement exécutant Junos OS, elle devient la configuration active sur la plate-forme de routage, de commutation ou de sécurité. Pour plus d’informations sur les opérations de validation, notamment une discussion sur l’interaction entre les différentes variantes de l’opération, reportez-vous au Guide de l’utilisateur de l’interface de ligne de commande.
Dans une session NETCONF avec un équipement exécutant Junos OS, pour valider la configuration candidate, une application cliente entoure la <commit/>
balise dans un <rpc>
élément tag.
<rpc> <commit/> </rpc> ]]>]]>
Nous recommandons à l’application cliente de verrouiller la configuration candidate avant de la modifier et d’émettre la balise tant que la <commit/>
configuration est toujours verrouillée. Ce processus évite de valider par inadvertance les modifications apportées par d’autres utilisateurs ou applications. Après avoir validé la configuration, l’application doit la déverrouiller pour que les autres utilisateurs et applications puissent apporter des modifications.
Le serveur NETCONF confirme que l’opération de validation a réussi en renvoyant la <ok/>
balise dans l’élément <rpc-reply>
tag.
<rpc-reply xmlns="URN" xmlns:junos="URL"> <ok/> </rpc-reply> ]]>]]>
Si l’opération de validation échoue, le serveur renvoie l’élément et <rpc-error>
l’élément enfant, ce qui explique la raison de l’échec<rpc-reply>
. Les causes les plus courantes sont des erreurs sémantiques ou syntaxiques dans la configuration candidate.
Vous pouvez configurer l’instruction rfc-compliant
au niveau de la hiérarchie pour appliquer certains comportements par le serveur NETCONF, ce qui inclut des modifications dans la [edit system services netconf]
réponse du serveur NETCONF aux <commit>
opérations. Le tableau 1 décrit les modifications apportées aux sessions conformes aux RFC.
Valider la réponse RPC | Réponsepar défaut Réponse | de session conforme à la RFC |
---|---|---|
Une opération réussie <commit> renvoie une réponse avec des avertissements. |
Le serveur NETCONF renvoie un élément et peut également renvoyer un ou plusieurs <rpc-error> éléments avec un <ok/> niveau de gravité d’avertissement. |
À partir de Junos OS versions 17.4R3, 18.2R2, 18.3R2 et 18.4R1, le serveur NETCONF renvoie un <ok/> élément mais omet tout avertissement. Dans Junos OS version 21.2R1 et ultérieure, les avertissements sont également redirigés vers le fichier journal du système. |
Une <commit> réponse d’opération renvoie un élément qui inclut un <rpc-error> <source-daemon> élément. |
La réponse du serveur NETCONF émet l’élément <source-daemon> en tant qu’enfant de <rpc-error> . |
À partir de Junos OS version 21.2R1, la réponse du serveur NETCONF émet l’élément en tant qu’enfant <source-daemon> de <error-info> . |
Une <commit> réponse d’opération inclut un <commit-results> élément. |
Le serveur NETCONF inclut la <commit-results> sous-arborescence XML en plus d’un élément ou <rpc-error> d’un <ok/> élément enfant. |
Si vous configurez également l’instruction flatten-commit-results au niveau de la hiérarchie, le serveur NETCONF supprime la [edit system services netconf] sous-arborescence XML et émet uniquement un <commit-results> <ok/> élément or <rpc-error> dans sa réponse. |