Bloquear, desbloquear o crear una copia privada de la configuración de candidato mediante el protocolo XML de Junos
Cuando una aplicación cliente solicita o cambia información de configuración, puede usar uno de los métodos siguientes para tener acceso a la configuración de candidato:
Bloquee la configuración del candidato, 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 (equivalente al comando cli
configure exclusive
).Cree una copia privada de la configuración del candidato, lo que permite que la aplicación vea o cambie los datos de configuración sin afectar a la configuración del candidato o activo hasta que se confirma la copia privada (equivalente al comando CLI
configure private
).Cambie la configuración del candidato sin bloquearla. No recomendamos este método, debido a la posibilidad de conflictos con los cambios realizados por otras aplicaciones o usuarios que editen 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 o crear una copia privada. 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. Se garantiza que la información de una copia privada no cambiará, pero puede divergir de la configuración del candidato si otros usuarios o aplicaciones cambian la configuración de candidato.
Las restricciones en las operaciones de la configuración de candidato regular bloqueada y una copia privada son las mismas que para la CLI configure exclusive
y configure private
los comandos. Para obtener más información, consulte Confirmar una copia privada de la configuración con el protocolo XML de Junos y la Guía del usuario de CLI.
Para obtener más información acerca de cómo bloquear y desbloquear la configuración del candidato o crear una copia privada, consulte las siguientes secciones:
Bloqueo de la configuración de candidato
Para bloquear la configuración de candidato, una aplicación cliente emite la <lock-configuration/>
etiqueta dentro de una <rpc>
etiqueta.
<rpc> <lock-configuration/> </rpc>
El bloqueo de la configuración de candidato impide que otros usuarios o aplicaciones cambien la configuración de candidato hasta que se libera el bloqueo. Esto es equivalente al comando de CLI configure exclusive
. 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 la solicita. Permitir que varios usuarios o aplicaciones realicen cambios simultáneamente puede dar lugar a resultados inesperados .
El protocolo XML de Junos confirma que ha bloqueado la configuración candidata mediante la devolución de una etiqueta de apertura <rpc-reply>
y cierre </rpc-reply>
sin nada entre ellos.
<rpc-reply xmlns:junos="URL"> </rpc-reply>
Si el servidor de protocolo XML de Junos no puede bloquear la configuración, en su lugar, la <rpc-reply>
etiqueta encierra un <xnm:error>
elemento que explica el motivo del error. Las razones de la falla pueden incluir las siguientes:
Otro usuario o aplicación ya bloqueó la configuración del candidato. El mensaje de error informa la identidad de inicio de sesión del usuario o aplicación.
La configuración del candidato ya incluye cambios que aún no se han comprometido. Para confirmar los cambios, consulte Confirmar la configuración del candidato con el protocolo XML de Junos. Para descartar cambios no confirmados, consulte Reemplazo de la configuración mediante el protocolo XML de Junos.
Solo una aplicación puede mantener el bloqueo en la configuración candidata a la vez. Otros usuarios y aplicaciones pueden leer la configuración del candidato mientras está bloqueada o pueden cambiar sus copias privadas. El bloqueo persiste hasta que termina la sesión del protocolo XML de Junos o la aplicación cliente desbloquea la configuración emitiendo la <unlock-configuration/>
etiqueta, como se describe en Bloqueo y desbloqueo de la configuración del candidato o Creación de una copia privada con el protocolo XML de Junos.
Si la configuración del candidato no se confirma antes de que la aplicación cliente la desbloquee o si la sesión del protocolo XML de Junos termina por cualquier motivo antes de confirmar los cambios, los cambios se descartan automáticamente. Las configuraciones candidatas y confirmadas permanecen inalteradas.
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 la <unlock-configuration/>
etiqueta en una <rpc>
etiqueta:
<rpc> <unlock-configuration/> </rpc>
El servidor de protocolo JUnos XML confirma que ha desbloqueado correctamente la configuración al devolver una etiqueta de apertura <rpc-reply>
y cierre </rpc-reply>
sin nada entre ellos.
<rpc-reply xmlns:junos="URL"> </rpc-reply>
Si el servidor de protocolo XML de Junos no puede desbloquear la configuración, en su lugar, la <rpc-reply>
etiqueta encierra un <xnm:error>
elemento que explica el motivo del error.
Creación de una copia privada de la configuración
Para crear una copia privada de la configuración del candidato, una aplicación cliente emite la <private/>
etiqueta adjunta <rpc>
y <open-configuration>
las etiquetas.
<rpc> <open-configuration> <private/> </open-configuration> </rpc>
A continuación, la aplicación cliente puede realizar las mismas operaciones en la copia privada que en la configuración de candidato normal.
Después de realizar cambios en la copia privada, la aplicación cliente puede confirmar los cambios en la configuración activa en el dispositivo que ejecuta Junos OS mediante la emisión del <commit-configuration>
elemento tag, como para la configuración candidata normal. Sin embargo, hay algunas restricciones en la operación de confirmación para una copia privada. Para obtener más información, consulte Confirmar una copia privada de la configuración con el protocolo XML de Junos.
Para descartar la copia privada sin confirmarla, una aplicación cliente emite la <close-configuration/>
etiqueta adjunta en un <rpc>
elemento tag.
<rpc> <close-configuration/> </rpc>
Se pierden los cambios realizados en la copia privada. Los cambios en la copia privada también se pierden si la sesión del protocolo XML de Junos termina por cualquier motivo antes de confirmar los cambios. No es posible guardar los cambios en una copia privada excepto mediante la emisión del <commit-configuration>
elemento tag.
A partir de Junos OS versión 18.2R1, la operación del protocolo <open-configuration>
XML de Junos no emite un mensaje de advertencia "uncommitted changes will be discarded on exit
" al abrir una copia privada de la configuración candidata. Sin embargo, Junos OS aún descarta los cambios no comprometidos al cerrar la copia privada.
En el ejemplo siguiente se muestra cómo crear una copia privada de la configuración. El servidor de protocolo XML de Junos incluye un recordatorio en su respuesta de confirmación de que los cambios se descartan de una copia privada si no se confirman antes de que finalice la sesión.

<open-configuration>
XML de Junos no emite un mensaje de advertencia " "
uncommitted changes will be discarded on exit
al abrir una copia privada de la configuración candidata.