Bloquee y desbloquee la configuración del candidato mediante NETCONF
Cuando una aplicación cliente solicita o cambia la información de configuración, puede usar uno de los siguientes métodos para acceder a la configuración del candidato:
Bloquee la configuración candidata, lo que impide que otros usuarios o aplicaciones cambien la base de datos de configuración compartida hasta que la aplicación libere el bloqueo. Esto es equivalente al comando de
configure exclusivecli.Cambie la configuración del candidato sin bloquearla. No recomendamos este método, debido al potencial de conflictos con los cambios realizados por otras aplicaciones o usuarios que editan la base de datos de configuración compartida al mismo tiempo.
Si una aplicación simplemente solicita información de configuración y no la cambia, no es necesario bloquear la configuración. La aplicación puede comenzar a solicitar información de inmediato. Sin embargo, si es importante que la información que se devuelve no cambie durante la sesión, es adecuado bloquear la configuración.
Para obtener más información sobre cómo bloquear y desbloquear la configuración del candidato, consulte las siguientes secciones:
Bloqueo de la configuración del candidato
Para bloquear la configuración del candidato, una aplicación cliente emite los <lock> elementos y <target> etiqueta y la <candidate/> etiqueta en el <rpc> elemento tag.
<rpc>
<lock>
<target>
<candidate/>
</target>
</lock>
</rpc>
]]>]]>
El bloqueo de la configuración del candidato impide que otros usuarios o aplicaciones cambien la configuración del candidato hasta que se libere el bloqueo. Esto es equivalente al comando de configure exclusive cli. Se recomienda bloquear la configuración antes de realizar cambios, especialmente en dispositivos en los que varios usuarios están autorizados a cambiar la configuración. Una operación de confirmación se aplica a todos los cambios en la configuración del candidato, no solo a los realizados por el usuario o la aplicación que solicita la confirmación. Permitir que varios usuarios o aplicaciones realicen cambios simultáneamente puede dar lugar a resultados inesperados.
El servidor NETCONF confirma que ha bloqueado al candidato mediante la devolución de la <ok/> etiqueta en el <rpc-reply> elemento de etiqueta.
<rpc-reply xmlns="URN" xmlns:junos="URL">
<ok/>
</rpc-reply>
]]>]]>
Si el servidor NETCONF no puede bloquear la configuración, el <rpc-reply> elemento tag en su lugar encierra un <rpc-error> elemento de etiqueta que explica el motivo del error. Las razones del error pueden incluir lo siguiente:
Otro usuario o aplicación ya bloqueó la configuración del candidato. El mensaje de error notifica el identificador de sesión NETCONF del usuario o la aplicación. Si la aplicación cliente tiene el privilegio de acceso de Junos OS necesario, puede terminar la sesión que contiene el bloqueo. Para obtener más información, consulte Terminar una sesión NETCONF.
La configuración del candidato ya incluye cambios que aún no se han confirmado. Para confirmar los cambios, consulte Confirmar la configuración del candidato mediante NETCONF. Para descartar cambios no confirmados, consulte Revertir cambios no confirmados en la configuración del candidato mediante NETCONF.
Solo una aplicación puede contener el bloqueo en la configuración del candidato a la vez. Otros usuarios y aplicaciones pueden leer la configuración del candidato mientras está bloqueada. El bloqueo persiste hasta que finalice la sesión netCONF o la aplicación cliente desbloquee la configuración emitiendo el <unlock> elemento tag, como se describe en Desbloquear la configuración del candidato.
Si la configuración candidata no se confirma antes de que la aplicación cliente la desbloquee, o si la sesión de NETCONF termina por cualquier motivo antes de que se confirman los cambios, los cambios se descartan automáticamente. Las configuraciones candidatas y confirmadas permanecen sin cambios.
Desbloquear la configuración del candidato
Mientras una aplicación cliente mantenga un bloqueo en la configuración del candidato, otras aplicaciones y usuarios no pueden cambiar el candidato. Para desbloquear la configuración del candidato, la aplicación cliente incluye los <unlock> elementos y <target> etiqueta y la <candidate/> etiqueta en un <rpc> elemento de etiqueta.
<rpc>
<unlock>
<target>
<candidate/>
</target>
</unlock>
</rpc>
]]>]]>
El servidor NETCONF confirma que ha desbloqueado el candidato mediante la devolución de la <ok/> etiqueta en el <rpc-reply> elemento de etiqueta.
<rpc-reply xmlns="URN" xmlns:junos="URL">
<ok/>
</rpc-reply>
]]>]]>
Si el servidor NETCONF no puede desbloquear la configuración, el <rpc-reply> elemento tag en su lugar encierra un <rpc-error> elemento de etiqueta que explica el motivo del error.