Setting RAD Rollback

Use the rollback section of a RAD to set criteria for subsequent device changes.

Syntax

The following example shows the XML elements used in the rollback section of a RAD. This rollback is for the TELNET protocol that is specified in the access order section of a RAD.

<access-order>
	<name>telnet</name>
</access-order>

<rollback-options>

	<option name="NO_ROLLBACK">
		<description>No rollback</description>
		<required>false</required>
		<recommended>false</recommended>
	</option>

	<option name="MODELLED_ROLLBACK">
		<description>Use modelled rollback</description>
		<required>false</required>
		<recommended>true</recommended>
	</option>

	<option name="REBOOT_ROLLBACK">
		<description>Reload the configuration and reboot thedevice.</description>
		<required>false</required>
		<recommended>false</recommended>
	</option>

</rollback-options>

Description

The rollback XML elements define which options are available for devices using this RAD. The options apply for all access types. Therefore, there is no need to set one for each access type. That is, you do not need to set one rollback for TELNET, another rollback for SSH, and so forth.

The options define what to do in case of an error while applying a CommandSet or NativeCommandSet. If the configuration was partially changed, ITNCM - Base needs to know what action to take in order to restore the device.

The following table describes each of the XML elements used in the rollback section of a RAD.

XML element	Description
`<rollback-options>`	Specifies the rollback section of a RAD. The `<rollback-options>` XML tag is typically followed by one or more `<option name>` XML tags.
`<option name>`	Specifies the name of a rollback option. Specify one of the following values: `NO_ROLLBACK` — Leave as is. `MODELLED_ROLLBACK` — Determines how to restore the device. This feature only applies to devices that use SmartModels and allows an intelligent rollback. `SPECIAL_ROLLBACK` — Determines how to restore Juniper devices. This feature only applies to devices that use SmartModels and allows an intelligent rollback. `REBOOT_ROLLBACK` — Pushes the original configuration to the box and reboots the device. Each `<option name>` tag has three options that are specified with the following XML tags: `<description>` `<required>` `<recommended>`
`<description>`	Specifies the text that is displayed in the GUI.
`<required>`	Specifies that the option is forced selected. Specify the value `true` to force select the option. Otherwise, specify the value `false`.
`<recommended>`	Specifies that the option is selected by default, but the user may deselect. Specify the value `true` to select the option by default. Otherwise, specify the value `false`.

Notes

For a Command Set or Native Command Set change, the GUI queries the server to get the rollback options allowed for the device. If the user selects more than one device with different VTMOS, the options at the VT level are selected. This allows the GUI to display more options than a particular device supports. Despite what the user selects from the GUI, ITNCM - Base applies only the options allowed for a particular device, in the order specified by the RAD.

ITNCM - Base attempts the rollback options in the order specified, until one succeeds, or it runs out of options. After the RADs have been completed, the user can specify how far back to rollback the device using the GUI. ITNCM - Base can either rollback to the starting config, or rollback to after the last successful command set.

See the ITNCM User Guide for additional information on the help text for information on applying Command Sets or Native Command Sets.