jcs:load-configuration Template
SLAX Syntax
call jcs:load-configuration( $action="(merge | override | replace)", $commit-options=node-set, $configuration=configuration-data, $connection=connection-handle, $rescue="rescue", $rollback=number);
XSLT Syntax
<xsl:call-template name="jcs:load-configuration"> <xsl:with-param name="action" select="(merge | override | replace)"/> <xsl:with-param name="commit-options" select="node-set"/> <xsl:with-param name="configuration" select="configuration-data"/> <xsl:with-param name="connection" select="connection-handle"/> <xsl:with-param name="rescue" select=""rescue""/> <xsl:with-param name="rollback" select="number"/> </xsl:call-template>
Description
Make structured changes to the Junos OS configuration using an op script or event script. When called, the template locks the configuration database, loads the configuration changes, commits the configuration, and then unlocks the configuration database.
The jcs:load-configuration
template
makes changes to the configuration in configure exclusive mode. In this mode, Junos OS locks the candidate global configuration for as long as the script accesses the shared database
and makes changes to the configuration without interference from other
users.
Parameters
action
—Specifies how to load the configuration changes with
respect to the candidate configuration. The following options are supported:merge—Combine the candidate configuration and the incoming configuration changes. If the candidate configuration and the incoming configuration contain conflicting statements, the incoming statements override those in the candidate configuration.
override—Replace the entire candidate configuration.
replace—Replace existing statements in the candidate configuration with the tags of the same name that are marked with
replace:
in the incoming configuration. If there is no existing statement of the same name in the candidate configuration, the statement is added to the candidate configuration.
commit-options
—Node set defining options that customize the commit
operation. The default value is null. Supported commit options are:check—Check the correctness of the candidate configuration syntax, but do not commit the changes.
force-synchronize—Force the commit on the other Routing Engine (ignore any warnings).
log—Write the specified message to the commit log.
synchronize—Synchronize the commit on both Routing Engines.
configuration
—XML configuration changes. The configuration changes
are incorporated into the candidate configuration as specified by
the action
parameter. connection
—Connection handle generated by a call to the jcs:open()
function.rescue
—Load and commit the rescue configuration, if one exists.
The only acceptable value for this parameter is "rescue"
. The rescue
parameter is available starting
in Junos OS Release 20.1R1.rollback
—Revert to a previously committed configuration. Specify
the rollback number of the configuration. The rollback
parameter is available starting in Junos OS Release 12.2.