Reemplace la configuración del candidato mediante NETCONF
En una sesión DE NETCONF con un dispositivo que ejecuta Junos OS, una aplicación cliente puede reemplazar toda la configuración candidata o todos los datos de la base de datos de configuración abierta, ya sea con datos nuevos o volviendo a una configuración anterior o a una configuración de rescate.
Si una aplicación cliente ejecuta la operación de protocolo <open-configuration>
JUnos XML para abrir una base de datos de configuración específica antes de cargar los datos de configuración, Junos OS realiza la operación solicitada en la base de datos de configuración abierta. De lo contrario, la operación se realiza en la configuración de candidato.
En las siguientes secciones se explica cómo reemplazar los datos de configuración en la base de datos de configuración de candidato o abierta. La aplicación cliente debe confirmar la configuración después de reemplazar los datos para que sea la configuración activa en el dispositivo.
Usar <copy-config> para reemplazar la configuración
Un método para reemplazar toda la configuración del candidato o todos los datos de la base de datos de configuración abierta es usar la <copy-config>
operación. La <target>
etiqueta adjunta la <candidate/>
etiqueta para indicar que los datos de configuración nuevos reemplazan a los datos de la base de datos de configuración abierta (si la aplicación cliente emitió la operación de protocolo <open-configuration>
Junos XML antes de ejecutar la <copy-config>
operación) o, si no hay ninguna base de datos abierta, los datos en la configuración del candidato.
El <source>
elemento encierra el elemento, el <url>
cual especifica el nombre de archivo que contiene los nuevos datos de configuración. Cuando los datos de configuración se formatearán como elementos de etiqueta Junos XML, establezca el <url>
format
atributo xml
en u omita el atributo. Cuando los datos de configuración se formatearán como instrucciones de configuración de CLI, establezca el <url>
atributo format en 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> ]]>]]>
Usar <edit-config> para reemplazar la configuración
Otro método para reemplazar toda la configuración del candidato o todos los datos de la base de datos de configuración abierta es usar la <edit-config>
operación y establecer el modo replace
de configuración de edición en como una variable global. La aplicación incluye el <default-operation>
elemento tag con el valor replace
en el <edit-config>
elemento tag, como se describe en Establecer el modo de configuración de edición en una sesión NETCONF. La <target>
etiqueta adjunta la <candidate/>
etiqueta para indicar que los datos de configuración nuevos reemplazan a los datos de la base de datos de configuración abierta (si la aplicación cliente emitió la operación de protocolo <open-configuration>
Junos XML antes de ejecutar la <edit-config>
operación) o, si no hay ninguna base de datos abierta, los datos en la configuración del candidato.
Para especificar los nuevos datos de configuración, la aplicación incluye un elemento o <config-text>
tag que contiene los datos, o un <url>
elemento tag que nombra el archivo que contiene los datos como se explica en Carga y formato de datos de configuración en una sesión NETCONF.<config>
<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> ]]>]]>
Volver a una configuración previamente confirmada
Los dispositivos que ejecutan Junos OS almacenan una copia de la configuración confirmada más reciente y hasta 49 configuraciones anteriores, según la plataforma. Puede volver a cualquiera de las configuraciones almacenadas. Esto es útil cuando los cambios de configuración provocan resultados no deseados y desea volver a una configuración en funcionamiento conocida. Revertir la configuración es similar al proceso para realizar cambios de configuración en el dispositivo, pero en lugar de cargar los datos de configuración, realice una reposición, que reemplaza toda la configuración candidata por una configuración confirmada previamente.
A partir de Junos OS versión 18.1R1, una aplicación NETCONF puede ejecutar el <rollback-config>
RPC para reemplazar la configuración candidata o todos los datos de la base de datos de configuración abierta por una configuración confirmada previamente. Para revertir la configuración, la aplicación emite el <rollback-config>
elemento con el <index>
elemento secundario, el cual especifica el índice numérico de la configuración anterior que se carga. Los valores válidos son 0 (cero, para la configuración confirmada más reciente) a uno menos que el número de configuraciones anteriores almacenadas (el máximo es 49).
Las aplicaciones NETCONF también pueden usar la operación de protocolo <load-configuration>
XML de Junos con el rollback
atributo para revertir la configuración.
Por ejemplo, para cargar la configuración con un índice de devolución de 1, la aplicación cliente emite la siguiente RPC:
<rpc> <rollback-config> <index>1</index> </rollback-config> </rpc> ]]>]]>
El servidor NETCONF indica que la operación de carga se ha realizado correctamente al devolver los <rollback-config-results>
elementos y <ok/>
en su respuesta de 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 la operación de carga es correcta, la aplicación cliente debe confirmar la configuración para que sea la configuración activa en el dispositivo. Si el servidor encuentra un error durante la carga de la configuración de devolución, devuelve un <rpc-error>
elemento con información sobre el error.
Reemplazo de la configuración de candidato por la configuración de rescate
Una configuración de rescate le permite definir una configuración en funcionamiento conocida o una configuración con un estado conocido que puede restaurar en cualquier momento. Utilice la configuración de rescate cuando necesite revertir a una configuración conocida o como último recurso si la configuración del dispositivo y los archivos de configuración de respaldo se dañan sin reparar. Cuando se crea una configuración de rescate, el dispositivo guarda la configuración confirmada más reciente como configuración de rescate.
A partir de Junos OS versión 18.1R1, una aplicación NETCONF puede ejecutar el <rollback-config>
RPC para reemplazar la configuración candidata o todos los datos de la base de datos de configuración abierta con la configuración de rescate del dispositivo. Para cargar la configuración de rescate, la aplicación emite el elemento y <rescue/>
la <rollback-config>
etiqueta secundaria. La configuración de rescate debe existir en el dispositivo antes de poder cargarlo.
Las aplicaciones NETCONF también pueden usar la operación del protocolo <load-configuration>
XML de Junos con el rescue
atributo para cargar la configuración de rescate.
Por ejemplo, para cargar la configuración de rescate, la aplicación cliente emite la siguiente RPC:
<rpc> <rollback-config> <rescue/> </rollback-config> </rpc> ]]>]]>
El servidor NETCONF indica que la operación de carga se ha realizado correctamente al devolver los <rollback-config-results>
elementos y <ok/>
en su respuesta de 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 la operación de carga es correcta, la aplicación cliente debe confirmar la configuración para que sea la configuración activa en el dispositivo. Si la configuración de rescate no existe o el servidor encuentra otro error al cargar los datos de configuración, devuelve un <rpc-error>
elemento con información sobre el error.