Cisco ASR 14000 Series Management Command Reference page 346

Software Package Management Commands on Cisco IOS XR Software
install activate
C i s c o C o n f i d e n t i a l - B e t a R e v i e w R 3 . 7. 1
Activating New Versions of the Currently Active Packages
Use the install activate command with the if-active keyword to activate the package only on SDRs
where a previous version of the package is already active. This command is available only in
administration EXEC mode.
The if-active keyword is used only for optional packages or SMUs for optional packages.
Router Reloads Following Package Activation
If the activation requires a reload of the SDR or all SDRs, a confirmation prompt appears. Use the install
activate command with the prompt-level none keywords to automatically ignore any reload
confirmation prompts and proceed with the package activation. The router reloads if required.
Node Reloads Following Package Activation
If a software operation requires a node reload, the config-register for that node should be set to autoboot.
If the config-register for the node is not set to autoboot, then the system automatically changes the setting
and the node reloads. A message describing the change is displayed.
Synchronous Mode
Use the install activate command with the synchronous keyword to complete the operation before the
prompt is returned. A progress bar indicates the status of the operation. For example:
- 1% complete: The operation can still be aborted (ctrl-c for options)
\ 10% complete: The operation can still be aborted (ctrl-c for options)
When the install activate command is run in asynchronous mode, the system may stay in synchronous
mode for a short period of time while the system checks for questions to ask the user.
Press Ctrl-C during a synchronous operation to abort the operation or make the operation asynchronous.
Test Option
Use the test keyword to verify the effects of the proposed operations and determine whether the
installation can be completed. After previewing the effects of the proposed operations, use the show
install log command for more details about the effects of the proposed operations.
Auto Abort Option
Use the auto-abort-timer keyword to provide a safety mechanism for the instance that a package is
activated and for some reason access to the router is lost. This option automatically rolls back to the
current committed loadpath, thereby undoing any changes that are activated with the install activate
command. After the installation, if the activated software is working correctly, use the install commit
command to cancel the timer and commit the new loadpath.
The changes made to the active software set are not persistent during route processor (RP) reloads. Use
Note
the install commit command to make changes persistent.
Parallel Reload
Install operations are activated according to the method encoded in the package being activated.
Generally, this method has the least impact for routing and forwarding purposes, but it may not be the
fastest method from start to finish and can require user interaction by default. To perform the installation
procedure as quickly as possible, you can specify the parallel-reload keyword. This forces the
installation to perform a parallel reload, so that all cards on the router reload simultaneously, and then
come up with the new software. This impacts routing and forwarding, but it ensures that the installation
is performed without other issues.
Cisco ASR 14000 Series Router System Management Command Reference
SMR-344
OL-17231-01