Related Documentation
- <load-configuration-results>
- <rpc>
- entries for <configuration> and <configuration-text>, and <configuration-set> in the Junos XML API Configuration Reference
- Junos XML Management Protocol Guide
<load-configuration>
Usage
<rpc>
<load-configuration rescue="rescue"/>
<load-configuration rollback="index"/>
<load-configuration url="url" [action="(merge | override | replace | update)"]
[format="(text | xml)"] />]
<load-configuration url="url" action="set" format="text" />
<load-configuration [action="(merge | override | replace | update)"]
[format="xml"]>
<configuration>
<!-- tag elements for configuration elements to load -->
</configuration>
</load-configuration>
<load-configuration [action="(merge | override | replace | update)"]
format="text"> <configuration-text>
<!-- formatted ASCII configuration statements to load -->
</configuration-text>
</load-configuration>
<load-configuration action="set" format="text">
<configuration-set>
<!-- set configuration mode commands to load -->
</configuration-set>
</load-configuration>
</rpc>
Release Information
This is a Junos XML management protocol operation. It is a Juniper Networks proprietary extension to NETCONF and is identified in the capabilities exchange by the URI http://xml.juniper.net/netconf/junos/1.0 . This operation is only supported in NETCONF sessions on Juniper Networks devices running the Junos OS.
Description
Request that the NETCONF server load configuration data into the candidate configuration. Provide the data to load in one of four ways:
- Set the empty <load-configuration/> tag’s rescue attribute to the value rescue. The rescue configuration completely replaces the candidate configuration.
- Set the empty <load-configuration/> tag’s rollback attribute to the numerical index of a previous configuration. The routing platform stores a copy of the most recently committed configuration and up to 49 previous configurations. The specified previous configuration completely replaces the candidate configuration.
- Set the empty <load-configuration/> tag’s url attribute to the pathname
of a file that contains the configuration data to load. If providing
the configuration data as formatted ASCII text, set the format attribute to text. If providing the
configuration data as Junos XML tag elements, either omit the format attribute or set the value to xml.
If providing the configuration data as a set of configuration mode
commands, set the action attribute to set, and either omit the format attribute
or set the value to text.
In the following example, the url attribute identifies
/tmp/add.conf
as the file to load.<load-configuration url="/tmp/add.conf"/> - Enclose the configuration data within an opening <load-configuration> and closing </load-configuration> tag. If providing the configuration data as formatted ASCII text, enclose it in a <configuration-text> tag element, and set the format attribute to text. If providing the configuration data as Junos XML tag elements, enclose it in a <configuration> tag element, and either omit the format attribute or set the value to xml. If providing the configuration data as a set of configuration mode commands, enclose it in a <configuration-set> tag element, set the action attribute to set, and either omit the format attribute or set the value to text.
Attributes
For detailed information on the attributes, see the Junos XML Management Protocol Guide
action | — | Specifies how to load the configuration data, particularly when the candidate configuration and loaded configuration contain conflicting statements. The following are acceptable values:
|
format | — | Specifies the format used for the configuration data. There are two acceptable values:
|
rescue | — | Specifies that the rescue configuration replace the current candidate configuration. The only valid value is rescue. |
rollback | — | Specifies the numerical index of the previous configuration to load. Valid values are 0 (zero, for the most recently committed configuration) through one less than the number of stored previous configurations (maximum is 49). |
url | — | Specifies the full pathname of the file that contains the configuration data to load. The value can be a local file path, an FTP location, or a Hypertext Transfer Protocol (HTTP) URL:
In each case, the default value for the |
Usage Guidelines
Related Documentation
- <load-configuration-results>
- <rpc>
- entries for <configuration> and <configuration-text>, and <configuration-set> in the Junos XML API Configuration Reference
- Junos XML Management Protocol Guide
Published: 2013-07-26
Related Documentation
- <load-configuration-results>
- <rpc>
- entries for <configuration> and <configuration-text>, and <configuration-set> in the Junos XML API Configuration Reference
- Junos XML Management Protocol Guide