Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

<load-configuration>

Uso

Descripción

Solicite que el servidor de protocolo XML NETCONF o Junos cargue los datos de configuración en la configuración candidata o en la base de datos de configuración abierta.

Si una aplicación cliente emite la operación de protocolo <open-configuration> XML de Junos para abrir una base de datos de configuración específica antes de ejecutar la operación, el servidor carga los datos de configuración en la <load-configuration> base de datos de configuración abierta. De lo contrario, el servidor carga los datos de configuración en la configuración candidata.

Proporcione los datos para cargar de una de las siguientes maneras:

  • Establezca el atributo de la etiqueta vacía <load-configuration/> en el identificador de revisión de configuración de configuration-revision una configuración confirmada anteriormente. La configuración especificada reemplaza completamente la configuración candidata.

  • Establezca el atributo de rescue la etiqueta vacía <load-configuration/> en el valor rescue. La configuración de rescate reemplaza completamente la configuración candidata.

  • Establezca el atributo de la etiqueta vacía <load-configuration/> en el índice de reversión de rollback una configuración confirmada anteriormente. El dispositivo almacena una copia de la configuración confirmada más reciente y hasta 49 configuraciones anteriores. La configuración especificada reemplaza completamente la configuración candidata.

  • Establezca el atributo de la etiqueta vacía <load-configuration/> en el nombre de ruta de un archivo que contenga los datos de url configuración que se van a cargar. Establezca el atributo en , o para cargar una configuración en jsonel format formato respectivo: textnotación de objetos JavaScript (JSON), texto ASCII con formato o xml elementos de etiqueta XML de Junos (valor predeterminado). Para proporcionar los datos de configuración como comandos del modo de configuración, incluya el atributo y omita el atributo o establezca el action="set" format valor en text.

    En el ejemplo siguiente, el atributo identifica que los datos de configuración deben cargarse desde el url archivo /tmp/add.conf.

  • Incluya los datos de configuración como un flujo de datos dentro de una etiqueta de apertura <load-configuration> y cierre</load-configuration>. Si proporciona los datos de configuración como texto ASCII con formato, encierre los datos en un <configuration-text> elemento de etiqueta y establezca el format atributo en text. Si proporciona los datos de configuración como elementos de etiqueta XML de Junos, encierre los datos en un <configuration> elemento de etiqueta, omita el atributo o establezca el format valor en xml. Si proporciona los datos de configuración como comandos del modo de configuración, encierre los datos en un <configuration-set> elemento de etiqueta, establezca el atributo en , omita el atributo o establezca el action format valor en settext. Si proporciona los datos de configuración en JSON, encierre los datos en un <configuration-json> elemento de etiqueta y establezca el format atributo en json.

Atributos

action

Especifique cómo cargar los datos de configuración, especialmente cuando la base de datos de configuración de destino y la configuración cargada contienen instrucciones contradictorias.

La base de datos de configuración efímera admite los siguientes action valores de atributo en dispositivos compatibles en las versiones especificadas:

  • merge y —compatible con Junos OS versión 16.2R2 y setposteriores)

  • override y —compatible con Junos OS versión 18.1R1 y replaceposteriores

  • update: compatible con Junos OS versión 21.1R1 y posteriores

Los siguientes son valores aceptables:

  • merge: combina los datos de la configuración cargada con los datos de la configuración de destino. Si las instrucciones de la configuración cargada entran en conflicto con las instrucciones de la configuración de destino, las instrucciones loaded reemplazan a las de la configuración de destino. Este es el comportamiento predeterminado si se omite el action atributo.

  • override: descarte toda la configuración candidata y sustitúyala por la configuración cargada. Cuando la configuración se confirma posteriormente, todos los procesos del sistema analizan la nueva configuración.

  • replace: sustituye cada nivel de jerarquía u objeto de configuración definido en la configuración cargada por el nivel u objeto correspondiente en la configuración candidata.

    Si proporciona los datos de configuración como texto ASCII con formato (ya sea en el archivo denominado por el atributo o incluido en un <configuration-text> elemento de etiqueta), coloque también la instrucción en la línea que precede directamente a las instrucciones que representan el nivel de replace: jerarquía o el url objeto que se va a reemplazar. Para obtener más información, consulte la explicación de la carga de un archivo de datos de configuración en la Guía del usuario de CLI.

    Si proporciona los datos de configuración como elementos de etiqueta XML de Junos, incluya el replace="replace" atributo en las etiquetas de apertura de los elementos que representan los niveles de jerarquía u objetos que se van a reemplazar.

  • set: cargue los datos de configuración formateados como comandos del modo de configuración de Junos OS. Esta opción ejecuta las instrucciones de configuración línea por línea, ya que se almacenan en un archivo denominado por el url atributo o encerrado en un elemento de <configuration-set> etiqueta. Las instrucciones pueden contener cualquier comando de modo de configuración, como set, delete, edito deactivate. Al proporcionar los datos de configuración como un conjunto de comandos, el único valor aceptable para el format atributo es "texto". Si el valor del atributo es "establecido" y se omite el atributo, el action format atributo automáticamente se format convierte de forma predeterminada en "texto" en lugar de xml.

  • update: compare una configuración cargada completa con la configuración candidata. Para cada nivel de jerarquía u objeto de configuración que sea diferente en las dos configuraciones, la versión de la configuración cargada sustituye a la versión de la configuración candidata. Cuando la configuración se confirma posteriormente, solo los procesos del sistema que se ven afectados por los elementos de configuración modificados analizan la nueva configuración.

configuration-revision

Cargue una configuración confirmada previamente haciendo referencia a su identificador de revisión de configuración. La configuración especificada reemplaza completamente la configuración candidata.

format

Especifique el formato utilizado para los datos de configuración. Los valores aceptables son:

  • json–Indicar que los datos de configuración están formateados mediante notación de objetos JavaScript (JSON).

  • text: indica que los datos de configuración tienen el formato de texto ASCII o de un conjunto de comandos del modo de configuración.

    El formato de texto ASCII utiliza el carácter de nueva línea, tabulaciones y otros espacios en blanco, llaves y corchetes para indicar las relaciones jerárquicas entre las instrucciones. Este es el formato utilizado en los archivos de configuración almacenados en la plataforma de enrutamiento y es el formato que muestra el comando de la CLI show configuration . El set formato de comando consta de una serie de comandos del modo de configuración de Junos OS y se muestra mediante el comando de la show configuration | display set CLI. Para cargar un conjunto de comandos de modo de configuración, debe establecer el action atributo en "set".

  • xml: indica que los datos de configuración están formateados con elementos de etiqueta XML de Junos. Si se omite el atributo, "xml" es el formato predeterminado para todos los valores del action atributo excepto "set", que tiene el format formato predeterminado "text".

rescue

Especifique que la configuración de rescate reemplace a la configuración candidata actual. El único valor válido es "rescate".

Nota:

A partir de Junos OS versión 18.1R1, también puede utilizar RPC para cargar una configuración previamente confirmada, lo que resulta útil para aplicaciones que no admiten la ejecución de RPC <rollback-config> que incluyan atributos XML.

rollback

Cargue una configuración confirmada previamente haciendo referencia a su índice de reversión numérico. Los valores válidos son 0 (cero, para la configuración confirmada más recientemente) a través de uno menor que el número de configuraciones anteriores almacenadas (el máximo es 49).

Nota:

A partir de Junos OS versión 18.1R1, también puede utilizar RPC para cargar una configuración previamente confirmada, lo que resulta útil para aplicaciones que no admiten la ejecución de RPC <rollback-config> que incluyan atributos XML.

url

Especifique la ruta de acceso completa del archivo que contiene los datos de configuración que se van a cargar. El valor puede ser una ruta de acceso de archivo local, una ubicación FTP o una dirección URL de protocolo de transferencia de hipertexto (HTTP):

  • Un nombre de archivo local puede tener una de las siguientes formas:

    • //pathfilename: archivo en un sistema de archivos montado, ya sea en el disco flash local o en el disco duro.

    • Un:filename o un:path/filename—Archivo en la unidad local. La ruta predeterminada es / (el directorio de nivel raíz). Los medios extraíbles pueden estar en formato MS-DOS o UNIX (UFS).

  • Un nombre de archivo en un servidor FTP tiene el siguiente formato:

  • Un nombre de archivo en un servidor HTTP tiene el siguiente formato:

En cada caso, el valor predeterminado de la path variable es el directorio principal del nombre de usuario. Para especificar una ruta absoluta, la aplicación inicia la ruta con los caracteres %2F; por ejemplo, ftp://username:password@hostname/%2Fpath/filename.

Información de la versión

Se trata de una operación del protocolo de administración XML de Junos. Se admite en sesiones de protocolo XML de Junos y se admite como extensión propietaria de Juniper Networks en sesiones de NETCONF en dispositivos que ejecutan Junos OS que identifican el http://xml.juniper.net/netconf/junos/1.0 de URI en el intercambio de capacidades.

action valor set de atributo agregado en Junos OS versión 11.4.

format valor json de atributo agregado en Junos OS versión 16.1.

configuration-revision atributo agregado en Junos OS versión 20.4R1 y Junos OS Evolved versión 20.4R1.