Verrouiller, déverrouiller ou créer une copie privée de la configuration du candidat à l’aide du protocole XML Junos
Lorsqu’une application client demande ou modifie des informations de configuration, elle peut utiliser l’une des méthodes suivantes pour accéder à la configuration du candidat:
Verrouiller la configuration du candidat, ce qui empêche les autres utilisateurs ou applications de modifier la base de données de configuration partagée jusqu’à ce que l’application libère la verrou (équivalente à CLI
configure exclusivecommande).Créez une copie privée de la configuration du candidat, qui permet à l’application d’afficher ou de modifier les données de configuration sans affecter le candidat ou la configuration active jusqu’à ce que la copie privée soit commise (équivalente à la commande
configure privateCLI).Modifiez la configuration du candidat sans la verrouiller. En raison du risque de conflits avec des modifications apportées par d’autres applications ou utilisateurs qui modifient en même temps la base de données de configuration partagée, nous ne recommandons pas cette méthode.
Si une application demande simplement des informations de configuration et ne les modifie pas, il n’est pas nécessaire de verrouiller la configuration ou de créer une copie privée. L’application peut commencer à demander des informations immédiatement. Toutefois, s’il est important que les informations renvoyées ne changent pas pendant la session, il est approprié de verrouiller la configuration. Les informations provenant d’une copie privée sont garanties de ne pas changer, mais elles peuvent s’iverger de la configuration du candidat si d’autres utilisateurs ou applications modifient la configuration du candidat.
Les restrictions et les interactions entre les opérations se rapportant à la configuration du candidat régulier verrouillée et à une copie privée sont les mêmes que pour les CLI configure exclusive configure private et les commandes. Pour plus d’informations, consultez la série Committing a Private Copy of the Configuration Using the Junos XML Protocol and the CLI User Guide.
Pour plus d’informations sur le verrouillage et le déverrouillage de la configuration du candidat ou la création d’une copie privée, consultez les sections suivantes:
Verrouillage de la configuration du candidat
Pour verrouiller la configuration du candidat, une application client émet la <lock-configuration/> balise au sein d’une <rpc> balise.
<rpc>
<lock-configuration/>
</rpc>
La verrouillage de la configuration du candidat empêche les autres utilisateurs ou applications de modifier la configuration du candidat jusqu’à ce que la verrou soit libérée. Cela équivaut à la commande CLI configure exclusive commande. Il est recommandé de verrouiller la configuration avant d’apporter des modifications, en particulier sur les équipements où plusieurs utilisateurs sont autorisés à modifier la configuration. Une opération de validation s’applique à toutes les modifications de la configuration du candidat, et pas seulement à celles apportées par l’utilisateur ou l’application qui la demande. En permettant à plusieurs utilisateurs ou applications d’apporter des modifications simultanément, vous pouvez obtenir des résultats inattendus.
Le protocole XML De Junos confirme avoir verrouillé la configuration du candidat en renvoyant une balise ouvrante et fermant n’ayant aucune lien <rpc-reply> </rpc-reply> entre ces deux configurations.
<rpc-reply xmlns:junos="URL"> </rpc-reply>
Si le serveur de protocole XML Junos ne peut pas verrouiller la configuration, la balise verrouille plutôt un élément expliquant le <rpc-reply> <xnm:error> motif de la défaillance. Les raisons de cette défaillance peuvent inclure les raisons suivantes:
Un autre utilisateur ou application a déjà verrouillé la configuration du candidat. Le message d’erreur indique l’identité de l’utilisateur ou de l’application.
La configuration du candidat inclut déjà des modifications qui n’ont pas encore été engagées. Pour valider les modifications, consultez La validation de la configuration du candidat à l’aide du protocole XML Junos. Pour écarter les modifications non apportées, consultez la procédure de remplacement de la configuration à l’aide du protocole XML Junos.
Une seule application peut verrouiller la configuration du candidat à la fois. D’autres utilisateurs et applications peuvent lire la configuration du candidat pendant sa verrouillée ou modifier leurs copies privées. La verrouille persiste jusqu’à ce que la session de protocole XML de Junos se termine ou que l’application client libère la configuration en émettre la balise, comme décrit dans <unlock-configuration/> Locking and Unlocking the Candidate Configuration ou Creating a Private Copy Using the Junos XML Protocol.
Si la configuration du candidat n’est pas engagée avant que l’application client la déverrouiller, ou si la session de protocole XML De Junos se termine pour une raison quelconque avant que les modifications soient engagées, les modifications sont automatiquement écartées. Les configurations des candidats et des candidats restent inchangées.
Unlocking the Candidate Configuration
Tant qu’une application client est verrouillée dans la configuration du candidat, les autres applications et utilisateurs ne peuvent pas modifier le candidat. Pour déverrouiller la configuration du candidat, l’application client inclut la <unlock-configuration/> balise sur une <rpc> balise:
<rpc>
<unlock-configuration/>
</rpc>
Le serveur de protocoles XML De Junos confirme qu’il a bien déverrouillé la configuration en renvoyant une balise ouvrante et de fermeture sans aucune autre <rpc-reply> </rpc-reply> marque.
<rpc-reply xmlns:junos="URL"> </rpc-reply>
Si le serveur de protocole XML Junos ne peut pas déverrouiller la configuration, la balise joint plutôt un élément expliquant le <rpc-reply> <xnm:error> motif de la panne.
Création d’une copie privée de la configuration
Pour créer une copie privée de la configuration du candidat, une application client émet la balise jointe <private/> et <rpc> les <open-configuration> balises.
<rpc>
<open-configuration>
<private/>
</open-configuration>
</rpc>
L’application client peut ensuite effectuer les mêmes opérations sur la copie privée que sur la configuration régulière du candidat.
Après avoir apporté des modifications à la copie privée, l’application client peut valider les modifications de configuration active sur l’équipement en Junos OS en émettent l’élément de balise, comme pour la configuration du <commit-configuration> candidat régulier. Toutefois, l’opération de validation d’une copie privée est l’une des restrictions qui s’appliquent. Pour plus d’informations, consultez la série Committing a Private Copy of the Configuration Using the Junos XML Protocol.
Pour écarter la copie privée sans la mettre en pratique, une application client émet la balise jointe <close-configuration/> à un <rpc> tag.
<rpc>
<close-configuration/>
</rpc>
Toute modification de la copie privée est perdue. Les modifications apportées à la copie privée sont également perdues si la session de protocole XML de Junos se termine pour une raison quelconque avant que ces modifications ne soient commises. Il n’est pas possible d’enregistrer les modifications sur une autre copie privée qu’en émettre <commit-configuration> l’étiquette.
À partir Junos OS version 18.2R1, le protocole XML de Junos n’envoie aucun « message d’avertissement » lors de l’ouverture d’une copie privée de <open-configuration> uncommitted changes will be discarded on exit la configuration du candidat. Toutefois, Junos OS toujours écarter les modifications non convenues lors de la fermeture de la copie privée.
L’exemple suivant indique comment créer une copie privée de la configuration. Le serveur de protocoleSML Junos inclut un rappel dans sa réponse de confirmation que les modifications sont éliminées d’une copie privée si elles ne sont pas engagées avant la fin de la session.
