Table Of Contents
Software Package Management Commands on Cisco IOS XR Software
clear install rollback oldest
install abort
install activate
install add
install attach
install commit
install deactivate
install log-history size
install remove
install resume
install rollback to
install suspend
install verify
show install
show install active
show install committed
show install inactive
show install log
show install package
show install pie-info
show install request
show install rollback
show install suspend
show install which
Software Package Management Commands on Cisco IOS XR Software
This chapter describes the Cisco IOS XR commands used to add packages to a router storage device, activate or deactivate packages, upgrade or downgrade existing packages, and display information about packages.
For detailed information about the concepts and tasks necessary to manage the Cisco IOS XR software, see the Cisco IOS XR Getting Started Guide.
clear install rollback oldest
To delete saved installation points from the installation buffer, use the clear install rollback oldest command in Administration EXEC mode.
clear install rollback oldest points
Syntax Description
points
|
Number of saved installation points to delete, beginning with the oldest saved installation point.
|
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 3.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router.The command was made available in Administration EXEC mode.
|
Release 3.3.0
|
No modification.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear install rollback oldest command to delete saved installation points from the installation buffer.
Use the show install rollback command to display the software set associated with a saved installation point.
RP/0/RP0/CPU0:router(admin)# show install rollback ?
0 ID of the rollback point to show package information for
2 ID of the rollback point to show package information for
4 ID of the rollback point to show package information for
9 ID of the rollback point to show package information for
10 ID of the rollback point to show package information for
RP/0/RP0/CPU0:router(admin)# show install rollback 0
Secure Domain Router: Owner
Node 0/1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/1/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-mini-3.3.30
Node 0/6/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/6/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-mini-3.3.30
Node 0/RP0/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/RP1/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM0/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM2/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM3/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Note
When clearing saved installation points from the installation buffer, note that the clear install rollback oldest command ignores secure domain router (SDR) boundaries and performs the operation in global scope.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read, write
|
Examples
In the following example, the command show install rollback ? is used to display the available rollback points. The command clear install rollback oldest 2 is then used to delete the two oldest rollback points. The command show install rollback ? is used again to display the remaining rollback points.
RP/0/RP0/CPU0:router(admin)# show install rollback ?
0 ID of the rollback point to show package information for
2 ID of the rollback point to show package information for
4 ID of the rollback point to show package information for
9 ID of the rollback point to show package information for
10 ID of the rollback point to show package information for
RP/0/RP0/CPU0:router(admin)# clear install rollback oldest 2
Install operation 11 'clear install rollback oldest 2' started by user 'lab'
at 18:11:19 UTC Sat Apr 08 2006.
Info: Successfully deleted the following rollback points:
Install operation 11 completed successfully at 18:11:21 UTC Sat Apr 08 2006.
RP/0/RP0/CPU0:router(admin)# show install rollback ?
4 ID of the rollback point to show package information for
9 ID of the rollback point to show package information for
10 ID of the rollback point to show package information for
Related Commands
Command
|
Description
|
install rollback to
|
Rolls back the software set to a saved installation point or to the last committed installation point.
|
show install log
|
Displays the entries stored in the logging installation buffer.
|
show install rollback
|
Displays the software set associated with a saved installation point.
|
install abort
To abort an installation transaction, use the install abort command in Administration EXEC mode.
install abort [request-id]
Syntax Description
request-id
|
(Optional) Request ID assigned to an installation operation.
|
Defaults
Abort the current install operation.
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Routers.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the install abort command to halt a software installation operation that is in process or that has been suspended.
Only activation, deactivation and rollback operations can be aborted. Specifically, the operation install add can not be aborted, but the operation install add...activate can be aborted.
Use the install abort command with the request-id argument to halt a specific install operation if the request-id is currently in process.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read, write
|
Examples
The following example shows how to halt a specific install operation:
RP/0/RP0/CPU0:router(admin)# install abort
Info: Please confirm your 'install abort' request by pressing Enter or y, or pressing
n to cancel it.
Do you really want to abort install operation 15? [confirm] <enter>
Please check console to verify the operation is aborted.
Related Commands
install activate
To add software functionality to the active software set, use the install activate command in Administration EXEC mode.
install activate device:package [asynchronous] [synchronous] [sdr sdr-name] [noprompt]
[location node-id] [test]
Syntax Description
device:package
|
Device and package, expressed in concatenated form (for example, disk0:hfr-mgbl-1.0.0).
For the device argument, the value is a specified storage device, typically disk0:.
Press ? after a partial package name to display all possible matches available for activation. If there is only one match, press [TAB] to fill in the rest of the package name.
Note Multiple packages can be activated at a time. If multiple Software Maintenance Upgrades (SMUs) are activated, then the operation will involve a node reload and the user will be prompted before the install operation occurs
|
asynchronous
|
(Optional) Performs the command in asynchronous mode. In asynchronous mode, the command runs in the background, and the EXEC prompt is returned as soon as possible. This is the default mode.
|
synchronous
|
(Optional) Performs the command in synchronous mode. This mode allows the installation process to finish before the prompt is returned.
|
sdr sdr-name
|
(Optional) Activates a package for a specific secure domain router (SDR). The sdr-name argument is the name assigned to the secure domain router.
|
location node-id
|
(Optional) Activates a package on the designated node. The node-id argument is expressed in the rack/slot/module notation.
Note A package cannot be activated on a single node unless some version of the package being activated is already active on all nodes. For example, a Multiprotocol Label Switching (MPLS) package cannot be active on only one node. If a version of the MPLS package is already active on all nodes, an MPLS package then could be upgraded or downgraded on a single node.
|
noprompt
|
(Optional) Automatically ignores any reload confirmation prompts that result from a package activation. The router reloads if required.
|
test
|
(Optional) Verifies the effects of proposed operations without making changes to the Cisco IOS XR software.
|
Defaults
The package is activated on all supported nodes.
The operation is performed in asynchronous mode: The install activate command runs in the background, and the EXEC prompt is returned as soon as possible. Packages are activated for all SDRs.
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. This command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
Support was added for the SDR keyword and sdr-name argument.
Support was added for the noprompt keyword.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the install activate command to add software packages or SMUs to the active software set for all valid cards. Information within the package is used to verify compatibility with the target cards and with the other active software. Actual activation is performed only after the package compatibility and application program interface (API) compatibility checks have passed. To upgrade a package, activate the newer version of the package, and the older version is automatically deactivated.
Package activation for a specific secure domain router (SDR)
To activate a package only for a specific SDR, use the install activate command with the sdr keyword and sdr-name argument.
Note
In Release 3.3.0, SDR-specific activation is supported for specific packages and upgrades, such as optional packages and SMUs. Packages that do not support SDR-specific activation can only be activated for all SDRs in the system. For detailed instructions, see the "Managing Cisco IOS XR Software Packages" module of the Cisco IOS XR Getting Started Guide.
Router reload
If the activation requires a router reload, a confirmation prompt appears. Use the install activate command with the noprompt keyword to automatically ignore any reload confirmation prompts and proceed with the package activation. The router reloads if required.
Node reloads
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.
Note
The changes made to the active software set are not persistent during route processor (RP) reloads. Use the install commit command to make changes persistent.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
execute
|
Examples
The following example shows how to display the packages available for activation using the online help system. In this example, ? is entered after a partial package name to display all possible matches
RP/0/RP0/CPU0:router(admin)# install activate disk0:?
disk0:comp-hfr-mini-3.4.0.1I disk0:hfr-admin-3.4.0.1I disk0:hfr-base-3.4.0.1I
disk0:hfr-fwdg-3.4.0.1I disk0:hfr-k9sec-3.4.0.1I disk0:hfr-lc-3.4.0.1I
disk0:hfr-mgbl-3.4.0.1I disk0:hfr-mpls-3.4.0.1I disk0:hfr-os-mbi-3.4.0.1
I disk0:hfr-rout-3.4.0.1I
The following example shows how to activate a package on all nodes. Use the install commit command to make the changes persistent across RP reloads.
RP/0/RP0/CPU0:router(admin)# install activate disk0:hfr-mpls-3.3.30 synchronous
Install operation 15 'install activate disk0:hfr-mpls-3.3.30 synchronous'
started by user 'lab' at 19:15:33 UTC Sat Apr 08 2006.
Info: The changes made to software configurations will not be persistent
Info: across system reloads. Use the command 'admin install commit' to make
Info: changes persistent.
Info: Please verify that the system is consistent following the software
Info: change using the following commands:
Install operation 15 completed successfully at 19:16:18 UTC Sat Apr 08 2006.
RP/0/RP0/CPU0:router(admin)# install commit
Install operation 16 'install commit' started by user 'lab' at 19:18:58 UTC
Install operation 16 completed successfully at 19:19:01 UTC Sat Apr 08 2006.
The following example shows how to activate a package for a specific secure domain router:
RP/0/RP0/CPU0:router(admin)# install activate disk0:hfr-mpls-3.3.80 SDR CE1b
Install operation 2 'install activate disk0:hfr-mpls-3.3.80 on SDR: CE1b' started by user
'lab'
Install operation 2 'install activate disk0:hfr-mpls-3.3.80 on SDR: CE1b' started by user
'lab' at 15:31:23 GMT Mon Nov 14 2005.
Info: SDR CE1b: Checking running configuration version compatibility with newly
activated software ...
Info: SDR CE1b: No incompatibilities found between the activated software and router
running configuration.
Info: The changes made to software configurations will not be persistent across system
reloads. Use the command 'admin install commit' to make changes persistent.
Info: Please verify that the system is consistent following the software change using
the following commands:
Install operation 2 completed successfully at 15:32:28 GMT Mon Nov 14 2005.
Related Commands
install add
To copy the contents of a Package Installation Envelope (PIE) file to a storage device, use the install add command in Administration EXEC mode.
install add pie-file [asynchronous] [synchronous] [[activate [sdr sdr-name] [noprompt]
[location node-id]]
Syntax Description
pie-file
|
Name and location of the PIE file (composite package) to install. Location options are as follows:
• disk0:
• disk1:
• ftp://username:password@hostname or ip-address/directory-path/
• rcp://username@hostname or ip-address/directory-path/
• tftp://hostname or ip-address/directory-path/
Note Multiple PIE files can be added to a device at a time.
|
asynchronous
|
(Optional) Performs the command in asynchronous mode. In asynchronous mode, this command runs in the background, and the EXEC prompt is returned as soon as possible. This is the default mode.
|
synchronous
|
(Optional) Performs the command in synchronous mode. This mode allows the installation process to finish before the prompt is returned.
|
activate
|
(Optional) Activates the package or packages. This option is run only if the install add operation is successful.
|
sdr sdr-name
|
(Optional) Activates a package for a specific secure domain router (SDR). The sdr-name argument is the name assigned to the secure domain router.
|
location node-id
|
(Optional) Activates a package on the designated node. The node-id argument is expressed in the rack/slot/module notation.
Note A package cannot be activated on a single node unless some version of the package being activated is already active on all nodes. For example, a Multiprotocol Label Switching (MPLS) package cannot be active on only one node. If a version of the MPLS package is already active on all nodes, an MPLS package then could be upgraded or downgraded on a single node.
|
noprompt
|
(Optional) Automatically ignores any reload confirmation prompts that result from a package activation. The router reloads if required.
|
Defaults
Packages are added to the storage device, but not activated.
The operation is performed in asynchronous mode: The install add command runs in the background, and the EXEC prompt is returned as soon as possible.
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
Support was added for the optional activate keywords and arguments: [sdr sdr-name] [noprompt] and [location node-id].
Support was removed for the to device keyword and argument.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the install add command to extract and store packages on the designated storage device. The default storage device for software packages is disk0:.
Note
When adding a PIE file to a storage device, note that the install add command ignores secure domain router (SDR) boundaries and performs the operation in global scope.
Adding and activating a package
Software packages remain inactive until activated with the install activate command.
To add and activate a package at the same time, use the install add command with the activate keyword. When this command is used, the keywords and rules for package activation apply. See the "install activate" section for more information.
Note
In Release 3.3.0, SDR-specific activation is supported for specific packages and upgrades, such as optional packages and SMUs. Packages that do not support SDR-specific activation can only be activated for all SDRs in the system. For detailed instructions, see the "Managing Cisco IOS XR Software Packages" module of the Cisco IOS XR Getting Started Guide.
Note
If a software activation 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 add 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)
TFTP services and image size
Some Cisco IOS XR images may be larger than 32 MB, and the TFTP services provided by some vendors (such as Sun Solaris) may not support a file this large. If you do not have access to a TFTP server that supports files larger than 32 MB:
•
Download the software image using FTP or rcp.
•
Use a third-party or freeware TFTP server that supports file sizes larger than 32 MB.
Download a patch from Sun Microsystems to correct this limitation (http://www.sun.com).
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
execute
|
Examples
The following example shows how to add a PIE file. In the following example, a Multiprotocol Label Switching (MPLS) package is added in synchronous mode. This operation copies the files required for the package to the storage device. This package remains inactive until it is activated with the install activate command.
RP/0/RP0/CPU0:router(admin)# install add tftp://209.165.201.1/hfr-mpls.pie synchronous
Install operation 4 'install add /tftp://209.165.201.1/hfr-mpls.pie synchronous' started
by user
'lab' at 03:17:05 UTC Mon Nov 14 2005.
Info: The following package is now available to be activated:
Info: disk0:hfr-mpls-3.3.80
Install operation 4 completed successfully at 03:18:30 UTC Mon Nov 14 2005.
In the following example, a package is added and activated with a single command:
RP/0/RP0/CPU0:router(admin)# install add disk1:hfr-mgbl-p.pie-3.3.0 activate
Install operation 4 'install add /disk1:hfr-mgbl-p.pie-3.3.0 activate' started
by user 'lab' at 07:58:56 UTC Wed Mar 01 2006.
The install operation will continue asynchronously.
:router(admin)#Part 1 of 2 (add software): Started
Info: The following package is now available to be activated:
Info: disk0:hfr-mgbl-3.3.0
Part 1 of 2 (add software): Completed successfully
Part 2 of 2 (activate software): Started
Info: The changes made to software configurations will not be persistent across
system reloads. Use the command 'admin install
Info: commit' to make changes persistent.
Info: Please verify that the system is consistent following the software change
using the following commands:
Part 2 of 2 (activate software): Completed successfully
Part 1 of 2 (add software): Completed successfully
Part 2 of 2 (activate software): Completed successfully
Install operation 4 completed successfully at 08:00:24 UTC Wed Mar 01 2006.
Related Commands
install attach
To attach a terminal to an install operation, use the install attach command in Administration EXEC configuration mode.
install attach [request-id] [asynchronous] [synchronous]
Syntax Description
request-id
|
(Optional) Request ID assigned to an installation operation.
|
asynchronous
|
(Optional) Performs the command in asynchronous mode. In asynchronous mode, this command runs in the background, and the EXEC prompt is returned as soon as possible. This is the default mode.
|
synchronous
|
(Optional) Performs the command in synchronous mode. This mode allows the installation process to finish before the prompt is returned.
|
Defaults
The command operates in synchronous mode.
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Routers.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the install attach command to attach a terminal to an install operation. This is similar to making the install operation synchronous, and is used for the following reasons:
•
To change a asynchronous install operation to a synchronous install operation.
•
The install operation is asynchronous but the terminal that ran the command has been lost (due to a failover or terminal timeout).
Note
An asynchronous operation runs in the background, and the EXEC prompt is returned as soon as possible. This is the default mode. A synchronous operation allows the installation process to finish before the prompt is returned.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read, write
|
Examples
The following example, a software package is activated in asynchronous mode. In asynchronous mode, the command runs in the background, and the CLI prompt is returned as soon as possible.
Use the install attach command to attach the terminal to an install operation. This switches the operation to synchronous mode, which allows the installation process to finish before the prompt is returned.
In the following example, the install activate command is entered in asynchronous mode. The CLI prompt returns before the operation is complete.
RP/0/RP0/CPU0:router(admin)#install activate disk0:hfr-mcast-3.7.6
Install operation 14 'install activate disk0:hfr-mcast-3.7.6' started by user
'lab' at 08:04:31 UTC Mon Nov 14 2005.
The install operation will continue asynchronously.
RP/0/RP0/CPU0:router(admin)#Info: SDR Owner: Checking running configuration version
compatibility with
Info: newly activated software ...
Info: SDR Owner: No incompatibilities found between the activated software
Info: and router running configuration.
In the following example, the install attach command is used to attach the terminal to the install operation and complete the operation in synchronous mode. The CLI prompt is returned only after the install operation is complete:
RP/0/RP0/CPU0:router(admin)# install attach
Install operation 14 'install activate disk0:hfr-mcast-3.7.6' started by user
'lab' at 08:04:31 UTC Mon Nov 14 2005.
Info: SDR Owner: Checking running configuration version compatibility with
Info: newly activated software ...
Info: SDR Owner: No incompatibilities found between the activated software
Info: and router running configuration.
Info: The changes made to software configurations will not be persistent
Info: across system reloads. Use the command 'admin install commit' to make
Info: changes persistent.
Info: Please verify that the system is consistent following the software
Info: change using the following commands:
The currently active software is not committed. If the system reboots then the committed
software will be used. Use 'install commit' to commit the active software.
Install operation 14 completed successfully at 08:06:12 UTC Mon Nov 14 2005.
Related Commands
Command
|
Description
|
install activate
|
Adds a software package to the active software set.
|
install add
|
Adds the package encapsulated in a specific PIE file to a storage device.
|
install deactivate
|
Removes a package from the active software set.
|
install commit
To save the active software set to be persistent across designated system controller (DSC) reloads, use the install commit command in Administration EXEC mode.
install commit
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
No modification.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
On startup, the primary RP loads the active software set saved with the install commit command.
When a package is activated, it becomes part of the current running configuration. To make the package activation persistent across RP reloads, you must enter the install commit command. If the system is restarted before the active software set is saved with the install commit command, the previously committed software set is used.
Note
When a committing the active software set, note that the install commit ignores secure domain router (SDR) boundaries and performs the operation in global scope.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read, write
|
Examples
The following example shows how to make the current active software set persistent across RP reloads:
RP/0/RP0/CPU0:router(admin)# install commit
Install operation 16 'install commit' started by user 'lab' at 19:18:58 UTC
Install operation 16 completed successfully at 19:19:01 UTC Sat Apr 08 2006.
Related Commands
install deactivate
To remove a package from the active software set, use the install deactivate command in Administration EXEC mode.
install deactivate device:package [asynchronous] [synchronous] [sdr sdr-name] [noprompt]
[location node-id] [test]
Syntax Description
device:package
|
Device and package, expressed in concatenated form (for example, disk0:hfr-mgbl-1.0.0). For the device argument, the value is disk0:.
Press ? after a partial package name to display all possible matches available for activation. If there is only one match, press [TAB] to fill in the rest of the package name.
|
asynchronous
|
(Optional) Performs the command in asynchronous mode. In asynchronous mode, this command runs in the background, and the EXEC prompt is returned as soon as possible. This is the default mode.
|
synchronous
|
(Optional) Performs the command in synchronous mode. This mode allows the installation process to finish before the prompt is returned.
|
sdr sdr-name
|
(Optional) Deactivates a package for a specific secure domain router (SDR). The sdr-name argument is the name assigned to the secure domain router.
|
noprompt
|
(Optional) Automatically ignores any reload confirmation prompts that result from a package deactivation. The router reloads if required.
|
location node-id
|
(Optional) Deactivates a package from the designated node. The node-id argument is entered in the rack/slot/module notation.
Note In most cases, a package cannot be deactivated from a node, because some version of that package must be running on all supported nodes after the deactivation operation finishes.
|
test
|
(Optional) Verifies the effects of proposed operations without making changes to the Cisco IOS XR software.
|
Defaults
The package is deactivated on all supported nodes.
The operation is performed in asynchronous mode. The install deactivate command runs in the background, and the EXEC prompt is returned as soon as possible.
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
Support was added for the sdr keyword and sdr-name argument.
Support was added for the noprompt keyword.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Deactivating a package removes the activated package from the active software set from all nodes or from a single node. When a deactivation is attempted, the system runs an automatic check to ensure that the package is not required by other active packages. The deactivation is permitted only after all compatibility checks have passed.
The following restrictions and conditions apply to software deactivation:
•
A feature package cannot be deactivated if active packages need it to operate.
•
To downgrade a package, activate the older version. The newer package version will be deactivated automatically.
Note
To deactivate a package only for a specific secure domain router (SDR), use the install activate command with the SDR keyword and sdr-name argument.
Router reloads
If the deactivation requires a router reload, a confirmation prompt appears. Use the install deactivate command with the noprompt keyword to automatically ignore any reload confirmation prompts and proceed with the package deactivation. The router reloads if required.
Node reloads
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 operation
Use the install deactivate 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)
Test option
Use the test keyword to verify the effects of the deactivation without making changes to the system. Use this option to determine if the deactivation 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.
Use the install commit command to make changes persistent across route processor (RP) reloads.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
execute
|
Examples
The following example shows how to display the packages available for deactivation using the online help system. In this example, ? is entered after a partial package name to display all possible matches
RP/0/RP0/CPU0:router(admin)# install deactivate disk0:?
disk0:comp-hfr-mini-3.4.0.1I disk0:hfr-admin-3.4.0.1I disk0:hfr-base-3.4.0.1I
disk0:hfr-fwdg-3.4.0.1I disk0:hfr-k9sec-3.4.0.1I disk0:hfr-lc-3.4.0.1I
disk0:hfr-mgbl-3.4.0.1I disk0:hfr-mpls-3.4.0.1I disk0:hfr-os-mbi-3.4.0.1
I disk0:hfr-rout-3.4.0.1I
The following example shows how to deactivate a package on all supported nodes in synchronous mode.
RP/0/RP0/CPU0:router(admin)# install deactivate disk0:hfr-mpls-3.3.30 synchronous
Install operation 14 'install deactivate disk0:hfr-mpls-3.3.30 synchronous'
started by user 'lab' at 18:38:37 UTC Sat Apr 08 2006.
Info: The changes made to software configurations will not be persistent
Info: across system reloads. Use the command 'admin install commit' to make
Info: changes persistent.
Info: Please verify that the system is consistent following the software
Info: change using the following commands:
Install operation 14 completed successfully at 18:39:20 UTC Sat Apr 08 2006.
In the following example, the Security package is deactivated for the SDR named "LR1".
RP/0/RP0/CPU0:router(admin)# install deactivate disk0:hfr-k9sec-3.3.0 sdr LR1
Install operation 11 'install deactivate disk0:hfr-k9sec-3.3.0 on SDR: LR1'
started by user 'lab' at 03:25:26 est Thu Mar 02 2006.
- 1% complete: The operation can still be aborted (ctrl-c for options)
The install operation will continue asynchronously.
The changes made to software configurations will
Info: across system reloads. Use the command 'admin install commit' to make
Info: changes persistent.
Info: Please verify that the system is consistent following the software
Info: change using the following commands:
The currently active software is not committed. If the system reboots then the committed
software will be used. Use 'install commit' to commit the active software.
Install operation 11 completed successfully at 03:25:56 est Thu Mar 02 2006.
You cannot deactivate a package if other packages or nodes require that package. In the following example, an attempt to deactivate a package is rejected:
RP/0/RP1/CPU0:router(admin)#install deactivate disk0:hfr-diags-3.3.90 locati$
Install operation 25 'install deactivate disk0:hfr-diags-3.3.90 on node
0/6/CPU0' started by user 'lab' at 23:01:38 UTC Sat Apr 15 2006.
Error: Cannot proceed with the deactivation because of the following package
Error: incompatibilities:
Error: hfr-diags-3.3.90 on nodes of type RP needs hfr-diags-3.3.90, or
Error: equivalent, to be active on node 0/6/CPU0 on secure domain router
Error: hfr-diags-3.3.90 on nodes of type DRP needs hfr-diags-3.3.90, or
Error: equivalent, to be active on node 0/6/CPU0 on secure domain router
Error: hfr-diags-3.3.90 on nodes of type SP needs hfr-diags-3.3.90, or
Error: equivalent, to be active on node 0/6/CPU0 on secure domain router
Error: hfr-diags-3.3.90 on nodes of type LC needs hfr-diags-3.3.90, or
Error: equivalent, to be active on node 0/6/CPU0 on secure domain router
Error: Suggested steps to resolve this:
Error: - check the installation instructions.
Error: - activate or deactivate the specified packages on the specified
Install operation 25 failed at 23:01:44 UTC Sat Apr 15 2006.
Related Commands
install log-history size
To set the maximum number of entries to be stored in the logging installation buffer, use the install log-history size command in Administration configuration mode. To restore the default, use the no form of this command.
install log-history size entries
no install log-history size
Syntax Description
entries
|
Maximum number of log entries. Valid values are 0 to 255.
|
Defaults
No default behavior or values
Command Modes
Administration configuration
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
No modification.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use install log-history command to set the maximum number of entries to be stored in the logging installation buffer.
Use the show install log to display the entries stored in the logging installation buffer and the details of install requests.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read, write
|
Examples
The following example shows how to set the maximum size of the logging installation buffer to 100 entries:
RP/0/RP0/CPU0:router(admin-config)# install log-history size 100
Related Commands
Command
|
Description
|
show install log
|
Displays the entries stored in the logging installation buffer.
|
install remove
To delete inactive packages from a storage device, use the install remove command in Administration EXEC mode.
install remove {[device:package] [inactive [device]]} [asynchronous] [synchronous] [noprompt]
[test]
Syntax Description
device:package
|
(Optional) Device and package, expressed in concatenated form (for example, disk0:hfr-mgbl-1.0.0). For the device argument, the value is disk0:.
Note Multiple packages can be removed at the same time.
|
inactive
|
(Optional) Removes all inactive packages from all storage device.
|
device
|
(Optional) Removes all inactive packages from a specific storage device.
|
asynchronous
|
(Optional) Performs the command in asynchronous mode. In asynchronous mode, this command runs in the background, and the EXEC prompt is returned as soon as possible. This is the default mode.
|
synchronous
|
(Optional) Performs the command in synchronous mode. This mode allows the installation process to finish before the prompt is returned.
|
noprompt
|
(Optional) Automatically ignores any confirmation prompts for a package removal. The specified packages are removed with no further user input.
|
test
|
(Optional) Verifies the effects of proposed operations without making changes to the Cisco IOS XR software.
|
Defaults
The operation is performed in asynchronous mode: The install remove command runs in the background, and the EXEC prompt is returned as soon as possible.
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
Support was added to enable removal of multiple packages at the same time and to enable removal of inactive packages from a storage device.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
Support was added for the noprompt keyword.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Packages can be removed only if they are deactivated and not in the committed software set.
•
Use the command install remove with the inactive keyword to remove all inactive packages from all nodes in the system.
•
Use the command install remove with the inactive keyword and the device argument to remove all inactive packages from a specific storage device, such as disk0:.
•
Use the command install remove with the device:package argument t o remove a specific inactive package from a specific node.
If the operation requires a router reload, a confirmation prompt appears. Use the install remove command with the noprompt keyword to automatically ignore any reload confirmation prompts and proceed with the package removal. The router reloads if required.
Use the test keyword to verify the effects of the package removal operation and determine whether the operation 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.
Note
When removing a package, note that the install remove command ignores secure domain router (SDR) boundaries and performs the operation in global scope.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
execute
|
Examples
The following example shows how to remove an inactive package. In this example, the operation is run in test mode. The operation is confirmed and the package is removed.
RP/0/RP1/CPU0:router(admin)# install remove disk0:hfr-diags-3.3.90 test
Install operation 30 'install remove disk0:hfr-diags-3.3.90 test' started by
user 'lab' at 23:40:22 UTC Sat Apr 15 2006.
Warning: No changes will occur due to 'test' option being specified. The
Warning: following is the predicted output for this install command.
Info: This operation will remove the following package:
Info: disk0:hfr-diags-3.3.90
Info: After this install remove the following install rollback points will
Info: no longer be reachable, as the required packages will not be present:
Info: 4, 9, 10, 14, 15, 17, 18
Proceed with removing these packages? [confirm] y
The install operation will continue asynchronously.
Install operation 30 completed successfully at 23.
Related Commands
Command
|
Description
|
install add
|
Installs a package on a storage device.
|
show install log
|
Displays the entries stored in the logging installation buffer.
|
show install request
|
Displays the list of incomplete installation manager requests.
|
install resume
To resume a suspended install activation operation, use the install resume command in Administration EXEC mode.
install resume {sw-change | location node-id}
Syntax Description
sw-change
|
Resumes an activation operation for all nodes.
|
location node-id
|
Resumes an activation operation for a specific node. The node-id argument is entered in the rack/slot/module notation.
|
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Routers.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the install resume command to resume a suspended install operation. If the operation is not suspended, then the command has no effect.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read, write
|
Examples
The following example shows how to resume an install operation:
RP/0/RP0/CPU0:router(admin)# install resume
Install operation 9 has been resumed.
Info: Install operation 9 has been resumed.
RP/0/RP0/CPU0:router(admin)#Info: The changes made to software configurations will not
be persistent
Info: across system reloads. Use the command 'admin install commit' to make
Info: changes persistent.
Info: Please verify that the system is consistent following the software
Info: change using the following commands:
The currently active software is not committed. If the system reboots then the committed
software will be used. Use 'install commit' to commit the active software.
Install operation 9 completed successfully at 07:47:18 UTC Mon Nov 14 2005.
Related Commands
install rollback to
To roll back the software set to a saved installation point or to the last committed installation point, use the install rollback to command in Administration EXEC mode.
install rollback to {point-id | committed} [asynchronous] [synchronous] [noprompt] [test]
Syntax Description
point-id
|
Installation point ID number.
|
committed
|
Rolls the Cisco IOS XR software back to the last committed installation point.
|
asynchronous
|
(Optional) Performs the command in asynchronous mode. In asynchronous mode, this command runs in the background, and the EXEC prompt is returned as soon as possible. This is the default mode.
|
synchronous
|
(Optional) Performs the command in synchronous mode. This mode allows the installation process to finish before the prompt is returned.
|
noprompt
|
(Optional) Automatically ignores any reload confirmation prompts that result from a rollback operation. The router reloads if required.
|
test
|
(Optional) Verifies the effects of proposed operations without making changes to the Cisco IOS XR software.
|
Defaults
The operation is performed in asynchronous mode: The install rollback to command runs in the background, and the EXEC prompt is returned as soon as possible.
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
Support was added to enable roll back to a saved installation point.
|
Release 3.2
|
This command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
Support was removed for the reload keyword.
Support was added for the noprompt keyword.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the install rollback command to roll back the configuration to a saved installation point or to the last committed installation point. Rollback points are created when the router is booted and when packages are activated or deactivated. When an installation point is created, the Cisco IOS XR software assigns an ID number to that rollback point. To roll back to a saved installation point, enter the installation point ID number assigned to it for the point-id argument. When a software configuration is committed with the install commit command, that configuration is saved as the last committed installation point. Use the committed keyword to roll back to the last committed installation point.
To display the saved rollback points available, use the online help function:
RP/0/RP0/CPU0:router(admin)# install rollback to ?
0 Specify the id for the install point to rollback to
1 Specify the id for the install point to rollback to
12 Specify the id for the install point to rollback to
15 Specify the id for the install point to rollback to
2 Specify the id for the install point to rollback to
4 Specify the id for the install point to rollback to
6 Specify the id for the install point to rollback to
7 Specify the id for the install point to rollback to
8 Specify the id for the install point to rollback to
9 Specify the id for the install point to rollback to
committed Rollback to the last committed installation point
If a rollback operation requires that the software set be rolled back beyond two saved installation points, a message appears in the output of the install rollback command, indicating that the attempted rollback operation requires the Cisco IOS XR software to be reloaded. You are required to reload the Cisco IOS XR software to protect the system from multiple package activation and deactivation operations (as a result of rolling back beyond the saved installation points), which could cause system instability. For the rollback operation to be completed, you must reenter the install rollback command with the reload keyword.
If a rollback operation requires that a package be activated that is no longer on the system (because the package had been removed), a message appears in the output of the install rollback command indicating that the specified installation point is unavailable and that the required package must be added to roll back the software set to the specified installation point.
If a rollback operation requires a router reload, a confirmation prompt appears. Use the install rollback command with the noprompt keyword to automatically ignore any reload confirmation prompts and proceed with the rollback operation. The router reloads if required.
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.
Use the test keyword to verify the effects of the proposed operations and determine whether the rollback operation 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.
Note
When rolling back to a saved installation point, note that the install rollback command ignores secure domain router (SDR) boundaries and performs the operation in global scope.
Use the clear install rollback oldest to delete saved installation points from the installation buffer.
Use the show install rollback command to display the software set associated with a saved installation point.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read, write
|
Examples
The following example shows how to roll back to a saved installation point:
RP/0/RP0/CPU0:router(admin)# install rollback to 8
Install operation 10 'install rollback to 8' started by user 'lab' at 07:49:26
The install operation will continue asynchronously.
RP/0/RP0/CPU0:router(admin)#Info: The changes made to software configurations will not
be persistent
Info: across system reloads. Use the command 'admin install commit' to make
Info: changes persistent.
Info: Please verify that the system is consistent following the software
Info: change using the following commands:
The currently active software is the same as the committed software.
Install operation 10 completed successfully at 07:51:24 UTC Mon Nov 14 2005.
Related Commands
install suspend
To suspend a software activation, deactivation, or rollback, use the install suspend command in Administration EXEC mode.
install suspend {sw-change | location node-id}
Syntax Description
sw-change
|
Suspends the operation after the software download to all nodes is complete, but before to any software changes are implemented.
|
location node-id
|
Suspends the operation for a specific node. If the software change for the node is already in process, the command has no effect. The node-id argument is entered in the rack/slot/module notation.
|
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Routers.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the install suspend command to temporarily suspend an activation, deactivation, or rollback operation. To resume the operation, use the install resume command.
Use the install suspend with the location node-id keyword and argument to suspend the software change for a specific node. If the change for the node is already in process, the command has no effect.
Use the install suspend with the sw-change keyword to suspend the operation after the software download to all nodes is complete, but before any software changes are implemented.
The install suspend command can be run multiple times to set multiple suspension points. Use the show install suspend command to view all suspension points.
Suspension points are valid for the current install operation, or the next install operation if no install operation is currently in progress. Suspension points are cleared after the transaction has been completed.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read, write
|
Examples
The following example shows how to suspend a software activation.
Use the command show install suspend to display the suspended operation. Use the command install resume to cancel the suspension and resume the install operation:
RP/0/RP0/CPU0:router(admin)#install suspend sw-change
RP/0/RP0/CPU0:router(admin)#install activate disk0:hfr-mcast-3.7.6
Install operation 9 'install activate disk0:hfr-mcast-3.7.6' started by user
'lab' at 07:44:53 UTC Mon Nov 14 2005.
The install operation will continue asynchronously.
Install operation 9 has been suspended. Use the command 'install resume' in admin mode to
resume the operation.
Info: Install operation 9 has been suspended. Use the command 'install
Info: resume' in admin mode to resume.
RP/0/RP0/CPU0:router(admin)#show install suspend
State: install 9 suspended before software change
Related Commands
install verify
To verify the consistency of a previously installed software set with the package file from which it originated, use the install verify command in Administration EXEC mode.
install verify [asynchronous] [synchronous] [sdr sdr-name] [location node-id]
Syntax Description
asynchronous
|
(Optional) Performs the command in asynchronous mode. In asynchronous mode, this command runs in the background, and the EXEC prompt is returned as soon as possible. This is the default mode.
|
synchronous
|
(Optional) Performs the command in synchronous mode. This mode allows the installation process to finish before the prompt is returned.
|
sdr sdr-name
|
(Optional) Performs the command for a specific secure domain router (SDR). The sdr-name argument is the name assigned to the secure domain router.
|
location node-id
|
(Optional) Verifies the consistency of previously installed software from the designated node with the package file from which it originated. The node-id argument is expressed in the rack/slot/module notation.
|
Defaults
The operation is performed in asynchronous mode: The install verify command runs in the background, and the EXEC prompt is returned as soon as possible.
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 3.1
|
This command was introduced on the Cisco XR 12000 Series Router.
|
Release 3.2
|
No modification.
|
Release 3.3.0
|
Support was added for the sdr keyword and sdr-name argument.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the install verify command to verify the consistency of a previously installed software set with the package file from which it originated. This command can be used as a debugging tool to verify the validity of the files that constitute the packages to determine if there are any corrupted files. This command is particularly useful when issued after the activation of a package or upgrading the Cisco IOS XR software to a major release.
Note
The install verify command can take up to two minutes per package to process.
Note
To perform the command for a specific secure domain router (SDR), use the install verify command with the sdr keyword and sdr-name argument.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
execute
|
Examples
The following example shows how to verify the consistency of a previously installed software set with the package file from which it originated. This command is run in synchronous mode:
RP/0/RP0/CPU0:router(admin)# install verify synchronous
Install operation 7 'install verify synchronous' started by user 'lab' at
17:04:06 UTC Sat Apr 08 2006.
Info: This operation can take up to 2 minutes per package being verified.
Info: Verify operation successful, no anomalies found.
Info: [SUCCESS] /bootflash/hfr-diags-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-admin-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-base-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-os-mbi-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-diags-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-mcast-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-mpls-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-lc-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-fwdg-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-admin-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-base-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-os-mbi-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-diags-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-admin-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-base-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-os-mbi-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-diags-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-mcast-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-mpls-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-lc-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-fwdg-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-admin-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-base-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-os-mbi-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-diags-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-mgbl-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-k9sec-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-rout-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-mcast-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-mpls-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-lc-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-fwdg-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-admin-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-base-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-os-mbi-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-diags-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-mgbl-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-k9sec-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-rout-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-mcast-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-mpls-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-lc-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-fwdg-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-admin-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-base-3.3.30: Verification Successful.
Info: [SUCCESS] /disk0/hfr-os-mbi-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-diags-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-admin-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-base-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-os-mbi-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-diags-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-admin-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-base-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-os-mbi-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-diags-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-admin-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-base-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-os-mbi-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-diags-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-admin-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-base-3.3.30: Verification Successful.
Info: [SUCCESS] /bootflash/hfr-os-mbi-3.3.30: Verification Successful.
Install operation 7 completed successfully at 17:09:29 UTC Sat Apr 08 2006.
Related Commands
Command
|
Description
|
show install log
|
Displays the entries stored in the logging installation buffer.
|
show install request
|
Displays the list of incomplete installation manager requests.
|
show install
To display active packages, use the show install command in EXEC mode or Administration EXEC mode.
show install [all | sdr sdr-name | location node-id] [[detail [sdr sdr-name | location node-id]
[summary [sdr sdr-name]]
Syntax Description
all
|
(Optional) Displays the active packages from all locations.
|
sdr sdr-name
|
(Optional) Displays the active packages for a specific secure domain router (SDR). The sdr-name argument is the name assigned to the secure domain router.
|
location node-id
|
(Optional) Displays the active packages for a designated node. The node-id argument is expressed in the rack/slot/module notation.
|
summary
|
(Optional) Displays a summary of the active packages in a system or secure domain router. Use this command to display the default software profile for SDRs
|
detail
|
(Optional) Displays a detailed summary of the active packages for a system, secure domain router, or node.
|
Defaults
Displays active packages for the system.
Command Modes
EXEC
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1 router.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
Support was added for the optional keywords and arguments: summary, detail and sdr sdr-name.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Note
This command displays output that is similar to the show install active command.
Displaying Information for a Specific Node
Use the location keyword and node-id argument to display information for a specific node. If you do not specify a location with the location keyword and node-id argument, this command displays information from all nodes.
Displaying the Default SDR Software Profile
When an SDR is created, the nodes assigned to that SDR are configured with the default software profile. To view a summary of the default SDR software configuration, enter the show install summary command. Any new nodes that are configured to become a part of an SDR will boot with the default software profile listed in the output of this command.
Displaying Information for a Specific SDR
Use the sdr keyword and sdr-name argument to display information for a specific SDR.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read
|
Examples
Use the location node-id keyword and argument to display the active packages for a designated node.
RP/0/RP0/CPU0:router# show install location 0/rp0/cpu0
Node 0/RP0/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-mini-3.3.30
Use the summary keyword to display a summary of the active packages in the system. This command
also shows the default software profile used for new SDRs.
RP/0/RP0/CPU0:router# show install summary
Table 1 describes the significant fields shown in the display.
Table 1 show install Field Descriptions
Field
|
Description
|
Boot Image:
|
Active Minimum Boot Image (MBI) used to boot the node.
|
Active Packages:
|
Active packages loaded on the node.
|
Related Commands
show install active
To display active packages, use the show install active command in EXEC mode or Administration EXEC mode.
show install active [sdr sdr-name | location node-id] [[detail [sdr sdr-name | location node-id]
[summary [sdr sdr-name]] [[verbose [sdr sdr-name | location node-id]
Syntax Description
sdr sdr-name
|
(Optional) Displays the active packages for a specific secure domain router (SDR). The sdr-name argument is the name assigned to the secure domain router. This option is available from Administration EXEC mode only.
|
location node-id
|
(Optional) Displays the active packages for a designated node. The node-id argument is expressed in the rack/slot/module notation.
|
summary
|
(Optional) Displays a summary of the active packages in a system or secure domain router.
|
detail
|
(Optional) Displays a detailed summary of the active packages for a system, secure domain router, or node.
|
verbose
|
(Optional) Displays a detailed summary of the active packages for a system, secure domain router, or node, including component and file information for each package.
|
Defaults
No default behavior or values
Command Modes
EXEC
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was made available in Administration EXEC mode. The detail keyword was added.
|
Release 3.3.0
|
Support was added for the optional keywords and arguments: detail, verbose, and sdr sdr-name.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show install active command to display the active software set from all nodes. If you do not specify a node with the location keyword and node-id argument, this command displays the active software set from all nodes.
When run in Administration EXEC mode, this command displays data for the entire system. When run in the EXEC mode of a secure domain router this command displays data for that secure domain router only.
Use the location keyword and node-id argument to display information for a specific node. If you do not specify a location with the location keyword and node-id argument, this command displays information from all nodes.
Use the sdr keyword and sdr-name argument to display information for a specific secure domain router.
Use the summary keyword to display a summary of the committed packages in a system or secure domain router. Use the detail keyword to display a summary of the committed packages in a system, secure domain router, or node.
Note
This command displays output that is similar to the show install command.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read
|
Examples
The following is sample output from the show install active command with the location keyword and node-id argument specified:
The following is sample output from the show install active command with the summary keyword specified:
RP/0/RP0/CPU0:router(admin)#show install active summary
disk0:comp-hfr-mini-3.3.30
The following is sample output from the show install active summary command for a specific SDR:
RP/0/RP0/CPU0:router(admin)# show install active summary sdr owner
disk0:comp-hfr-mini-3.3.30
The following is sample output from the show install active command for a specific SDR:
RP/0/RP0/CPU0:router(admin)#show install active SDR Owner
RP/0/RP0/CPU0:router(admin)#show install active SDR Owner
Node 0/1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/1/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-mini-3.3.30
Node 0/6/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/6/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-mini-3.3.30
Node 0/RP0/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/RP1/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM0/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM2/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM3/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Table 2 describes the significant fields shown in the display.
Table 2 show install active Field Descriptions
Field
|
Description
|
Boot Image:
|
Active Minimum Boot Image (MBI) used to boot the node.
|
Active Packages:
|
Active packages loaded on the node.
|
Related Commands
show install committed
To display committed software packages, use the show install committed command in EXEC mode or in Administration EXEC mode.
show install committed [sdr sdr-name] [location node-id] [[detail [sdr sdr-name | location
node-id]] [[summary [sdr sdr-name]] [[verbose [sdr sdr-name | location node-id]
Syntax Description
sdr sdr-name
|
(Optional) Displays the committed packages for a specific secure domain router (SDR). The sdr-name argument is the name assigned to the secure domain router.
|
location node-id
|
(Optional) Displays the committed packages for a designated node. The node-id argument is expressed in the rack/slot/module notation.
|
summary
|
(Optional) Displays a summary of the committed packages in a system or secure domain router.
|
detail
|
(Optional) Displays a detailed summary of the committed packages for a system, secure domain router, or node.
|
verbose
|
(Optional) Displays a detailed summary of the committed packages for a system, secure domain router, or node, including component and file information for each package.
|
Defaults
No default behavior or values
Command Modes
Administration EXEC
EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1 router.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
This command was supported in both EXEC mode and Administration EXEC mode.
Support was removed for the all keyword.
Support was added for the keywords and arguments: sdr sdr-name, detail, summary, and verbose.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show install committed command to display the software committed using the install commit command. This command is useful for verifying that the desired set of packages is committed.
Use the location keyword and node-id argument to display information for a specific node. If you do not specify a location with the location keyword and node-id argument, this command displays information from all nodes.
Use the sdr keyword and sdr-name argument to display information for a specific secure domain router.
Use the summary keyword to display a summary of the committed packages in a system or secure domain router. Use the detail keyword to display a summary of the committed packages in a system, secure domain router, or node.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read
|
Examples
The following is sample output from the show install committed command:
RP/0/RP0/CPU0:router# show install committed
Secure Domain Router: Owner
Node 0/1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/1/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-mini-3.3.30
Node 0/6/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/6/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-mini-3.3.30
Node 0/RP0/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/RP1/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM0/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM2/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM3/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Table 3 describes the significant fields shown in the display.
Table 3 show install committed Field Descriptions
Field
|
Description
|
Boot Image:
|
Active Minimum Boot Image (MBI) committed on the node.
|
Active Packages:
|
Active packages committed on the node.
|
Related Commands
show install inactive
To display inactive packages, use the show install inactive command in EXEC mode or in Administration EXEC mode.
show install inactive [sdr sdr-name | location node-id] [detail | verbose]
Syntax Description
sdr sdr-name
|
(Optional) Displays the inactive packages for a specific secure domain router (SDR). The sdr-name argument is the name assigned to the secure domain router. This option is available from Administration EXEC mode only.
|
location node-id
|
(Optional) Displays the inactive software set from a designated node. The node-id argument is expressed in the rack/slot/module notation.
|
detail
|
(Optional) Displays summary and component information for inactive packages.
|
verbose
|
(Optional) Displays summary, component, and file information for inactive packages.
|
Defaults
No default behavior or values
Command Modes
EXEC
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was made available in Administration EXEC mode. The components, files, and none keywords were removed and replaced by the detail, verbose, and brief keywords, respectively. The summary keyword was removed. The default output display was changed to match the output that displayed when the optional summary keyword was entered in previous releases.
|
Release 3.3.0
|
No modification.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read
|
Examples
The following is sample output from the show install inactive command:
RP/0/RP0/CPU0:router# show install inactive
Secure Domain Router: Owner
Node 0/1/SP [SP] [SDR: Owner]
Node 0/1/CPU0 [LC] [SDR: Owner]
Node 0/6/SP [SP] [SDR: Owner]
Node 0/6/CPU0 [LC] [SDR: Owner]
Node 0/RP0/CPU0 [RP] [SDR: Owner]
Node 0/RP1/CPU0 [RP] [SDR: Owner]
Node 0/SM0/SP [SP] [SDR: Owner]
Node 0/SM1/SP [SP] [SDR: Owner]
Node 0/SM2/SP [SP] [SDR: Owner]
Node 0/SM3/SP [SP] [SDR: Owner]
The following is sample output from the show install inactive command with the summary keyword:
RP/0/RP0/CPU0:router# show install inactive summary
The following is sample output from the show install inactive command with the detail keyword:
RP/0/RP0/CPU0:router# show install inactive detail
Secure Domain Router: Owner
Node 0/1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
Node 0/1/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-full-3.3.30
Node 0/6/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
Node 0/6/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-full-3.3.30
Node 0/RP0/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-full-3.3.30
Node 0/RP1/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-full-3.3.30
Node 0/SM0/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
Node 0/SM1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
Node 0/SM2/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
Node 0/SM3/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
The following is sample output from the show install inactive command with the location keyword and node-id argument:
RP/0/RP0/CPU0:router# show install inactive location 0/2/cpu0
Node 0/RP0/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-full-3.3.30
Table 4 describes the significant fields shown in the display.
Table 4 show install inactive Field Descriptions
Field
|
Description
|
disk0:hfr-mgbl-3.3.30
|
Storage device and the name of the package that is inactive.
|
hfr-mgbl V3.3.30 Manageability Package
|
Name of the package that is inactive.
|
Vendor
|
Name of the manufacturer.
|
Desc
|
Name of the package.
|
Build
|
The date and time when the inactive package was built.
|
Source
|
The source directory where the inactive package was built.
|
Related Commands
show install log
To display the details of installation requests, use the show install log command in Administration EXEC mode.
show install log [request-id] [detail | verbose]
Syntax Description
request-id
|
(Optional) Request ID assigned to an installation operation.
|
detail
|
(Optional) Displays detailed information for all previous installs for all request-ids, or for a specific request-id.
|
verbose
|
(Optional) Displays verbose information for all previous installs for all request-ids, or for a specific request-id.
|
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1 router.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
Support was added for the keywords detail and verbose.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show install log command to display the details of each install request, including the changes to files and the processes impacted by each request.
The show install log command with no arguments displays a summary of all installation operations. Specify the request-id argument to display details for a specific operation.
Note
Issue this command with the installation commands that support the test keyword when previewing the effects of an installation command without impacting the running system. The install activate, install deactivate, install remove, and install rollback to commands support the test keyword.
Use the show install log detail command to display detailed information for all previous installs. The detailed information is a subset of show install log verbose information.
Specify the request-id argument to display details for a specific operation. The request-id argument is listed beside each operation in the show install log summary and is also attached to messages from that operation. For example, the third installation operation has "Install 3:" attached to all of its status messages.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read
|
Examples
The following example displays information for all install requests:
RP/0/RP1/CPU0:router(admin)# show install log
Install operation 1 started by user 'cisco' at 09:14:49 UTC Tue Mar 28 2006.
install add /disk1:hfr-k9sec-p.pie-3.3.90.1I
/disk1:hfr-mcast-p.pie-3.3.90.1I /disk1:hfr-mgbl-p.pie-3.3.90.1I
Install operation 1 completed successfully at 09:15:57 UTC Tue Mar 28 2006.
Install operation 2 started by user 'cisco' at 09:16:53 UTC Tue Mar 28 2006.
install activate disk0:hfr-k9sec-3.3.90 disk0:hfr-mcast-3.3.90
Install operation 2 completed successfully at 09:17:34 UTC Tue Mar 28 2006.
Install operation 3 started by user 'cisco' at 09:19:42 UTC Tue Mar 28 2006.
install add /disk1:hfr-diags-p.pie-3.3.90.1I
Install operation 3 completed successfully at 09:20:13 UTC Tue Mar 28 2006.
Install operation 4 started by user 'cisco' at 09:20:26 UTC Tue Mar 28 2006.
install activate disk0:hfr-diags-3.3.90
Install operation 4 completed successfully at 09:21:05 UTC Tue Mar 28 2006.
Install operation 5 started by user 'cisco' at 09:21:34 UTC Tue Mar 28 2006.
Install operation 5 completed successfully at 09:21:36 UTC Tue Mar 28 2006.
Install operation 6 started by user 'lab' at 16:30:53 UTC Sat Apr 08 2006.
Install operation 6 completed successfully at 16:36:15 UTC Sat Apr 08 2006.
Install operation 7 started by user 'lab' at 17:04:06 UTC Sat Apr 08 2006.
install verify synchronous
Install operation 7 completed successfully at 17:09:29 UTC Sat Apr 08 2006.
Install operation 8 started by user 'lab' at 17:58:34 UTC Sat Apr 08 2006.
Install operation 8 failed at 17:58:34 UTC Sat Apr 08 2006.
Install operation 9 started by user 'lab' at 17:59:23 UTC Sat Apr 08 2006.
install deactivate disk0:hfr-mpls-3.3.90
Install operation 9 completed successfully at 18:05:17 UTC Sat Apr 08 2006.
Install operation 10 started by user 'lab' at 18:06:22 UTC Sat Apr 08 2006.
install activate disk0:hfr-mpls-3.3.90
Install operation 10 completed successfully at 18:07:09 UTC Sat Apr 08
Install operation 11 started by user 'lab' at 18:11:19 UTC Sat Apr 08 2006.
clear install rollback oldest 2
Install operation 11 completed successfully at 18:11:21 UTC Sat Apr 08
Install operation 12 started by user 'lab' at 18:17:21 UTC Sat Apr 08 2006.
install activate disk0:hfr-mpls-3.3.90
Install operation 12 failed at 18:17:26 UTC Sat Apr 08 2006.
Install operation 13 started by user 'lab' at 18:37:22 UTC Sat Apr 08 2006.
install activate disk0:hfr-mpls-3.3.90
Install operation 13 failed at 18:37:24 UTC Sat Apr 08 2006.
Install operation 14 started by user 'lab' at 18:38:37 UTC Sat Apr 08 2006.
install deactivate disk0:hfr-mpls-3.3.90 synchronous
Install operation 14 completed successfully at 18:39:20 UTC Sat Apr 08
Install operation 15 started by user 'lab' at 19:15:33 UTC Sat Apr 08 2006.
install activate disk0:hfr-mpls-3.3.90 synchronous
Install operation 15 completed successfully at 19:16:18 UTC Sat Apr 08
Install operation 16 started by user 'lab' at 19:18:58 UTC Sat Apr 08 2006.
Install operation 16 completed successfully at 19:19:01 UTC Sat Apr 08
Install operation 17 started by user 'lab' at 19:22:15 UTC Sat Apr 08 2006.
install deactivate disk0:hfr-mpls-3.3.90
Install operation 17 completed successfully at 19:22:59 UTC Sat Apr 08
Install operation 18 started by user 'lab' at 19:23:28 UTC Sat Apr 08 2006.
install activate disk0:hfr-mpls-3.3.90
Install operation 18 completed successfully at 19:24:13 UTC Sat Apr 08
Install operation 19 started by user 'lab' at 23:46:10 UTC Sat Apr 08 2006.
install add /disk1:hfr-mpls-p.pie-3.3.90 synchronous
Install operation 19 failed at 23:46:10 UTC Sat Apr 08 2006.
Install operation 20 started by user 'lab' at 23:46:36 UTC Sat Apr 08 2006.
install add /disk1:hfr-mpls-p.pie synchronous
Install operation 20 failed at 23:46:36 UTC Sat Apr 08 2006.
Install operation 21 started by user 'lab' at 23:47:32 UTC Sat Apr 08 2006.
install add /disk1:hfr-mcast-p.pie-3.3.90.I
Install operation 21 failed at 23:47:32 UTC Sat Apr 08 2006.
Install operation 22 started by user 'lab' at 23:47:51 UTC Sat Apr 08 2006.
install add /disk1:/hfr-mcast-p.pie-3.3.90.I
Install operation 22 failed at 23:47:51 UTC Sat Apr 08 2006.
Install operation 23 started by user 'lab' at 23:48:57 UTC Sat Apr 08 2006.
install rollback to committed
Install operation 23 failed at 23:49:03 UTC Sat Apr 08 2006.
Install operation 24 started by user 'lab' at 23:50:11 UTC Sat Apr 08 2006.
Install operation 24 failed at 23:50:15 UTC Sat Apr 08 2006.
Install operation 25 started by user 'lab' at 23:01:38 UTC Sat Apr 15 2006.
install deactivate disk0:hfr-diags-3.3.90 on node 0/6/CPU0
Install operation 25 failed at 23:01:44 UTC Sat Apr 15 2006.
Install operation 26 started by user 'lab' at 23:29:08 UTC Sat Apr 15 2006.
Install operation 26 failed at 23:29:08 UTC Sat Apr 15 2006.
Install operation 27 started by user 'lab' at 23:29:37 UTC Sat Apr 15 2006.
install deactivate disk0:hfr-diags-3.3.90
Install operation 27 completed successfully at 23:30:22 UTC Sat Apr 15
Install operation 28 started by user 'lab' at 23:35:39 UTC Sat Apr 15 2006.
Install operation 28 failed at 23:35:39 UTC Sat Apr 15 2006.
Install operation 29 started by user 'lab' at 23:39:21 UTC Sat Apr 15 2006.
Install operation 29 completed successfully at 23:39:24 UTC Sat Apr 15
Install operation 30 started by user 'lab' at 23:40:22 UTC Sat Apr 15 2006.
install remove disk0:hfr-diags-3.3.90 test
Install operation 30 completed successfully at 23:40:45 UTC Sat Apr 15
Install operation 31 started by user 'lab' at 23:59:12 UTC Sat Apr 15 2006.
Install operation 31 completed successfully at 23:59:28 UTC Sat Apr 15
31 entries shown (max log size 50 entries)
The following example displays the details for a specific install request:
RP/0/RP1/CPU0:router(admin)# show install log 31
Install operation 31 started by user 'lab' at 23:59:12 UTC Sat Apr 15 2006.
Install operation 31 completed successfully at 23:59:28 UTC Sat Apr 15
The following example displays information for the install requests. Use the verbose keyword to display detailed information, including files changes, impact to processes, and impact to dynamic link libraries (DLL).
RP/0/RP0/CPU0:router(admin)# show install log verbose
Install operation 1 started by user 'labuser' at 17:48:51 UTC Sat Jun 03 2006.
install add /disk1:hfr-diags-p.pie-PD34-06.06.07
/disk1:hfr-k9sec-p.pie-PD34-06.06.07 /disk1:hfr-mcast-p.pie-PD34-06.06.07
/disk1:hfr-mgbl-p.pie-PD34-06.06.07 /disk1:hfr-mpls-p.pie-PD34-06.06.07
Install operation 1 completed successfully at 17:51:32 UTC Sat Jun 03 2006.
Install operation 1 'install add /disk1:hfr-diags-p.pie-PD34-06.06.07
/disk1:hfr-k9sec-p.pie-PD34-06.06.07 /disk1:hfr-mcast-p.pie-PD34-06.06.07
/disk1:hfr-mgbl-p.pie-PD34-06.06.07 /disk1:hfr-mpls-p.pie-PD34-06.06.07'
started by user 'labuser' at 17:48:51 UTC Sat Jun 03 2006.
Info: The following packages are now available to be activated:
Info: disk0:hfr-diags-3.4.0.1I
Info: disk0:hfr-k9sec-3.4.0.1I
Info: disk0:hfr-mcast-3.4.0.1I
Info: disk0:hfr-mgbl-3.4.0.1I
Info: disk0:hfr-mpls-3.4.0.1I
Install operation 1 completed successfully at 17:51:32 UTC Sat Jun 03 2006.
Install operation 2 started by user 'labuser' at 18:06:32 UTC Sat Jun 03 2006.
install activate disk0:hfr-diags-3.4.0.1I disk0:hfr-k9sec-3.4.0.1I
disk0:hfr-mcast-3.4.0.1I disk0:hfr-mgbl-3.4.0.1I disk0:hfr-mpls-3.4.0.1I
Install operation 2 completed successfully at 18:07:48 UTC Sat Jun 03 2006.
Summary of changes on nodes 0/1/SP, 0/6/SP, 0/SM0/SP, 0/SM1/SP, 0/SM2/SP,
Activated: hfr-diags-3.4.0.1I
Summary of changes on nodes 0/1/CPU0, 0/6/CPU0:
Activated: hfr-diags-3.4.0.1I
1 hfr-mpls processes affected (0 updated, 1 added, 0 removed, 0
2 hfr-mcast processes affected (0 updated, 2 added, 0 removed, 0
Summary of changes on nodes 0/RP0/CPU0, 0/RP1/CPU0:
Activated: hfr-diags-3.4.0.1I
6 hfr-mgbl processes affected (0 updated, 6 added, 0 removed, 0
8 hfr-mpls processes affected (0 updated, 8 added, 0 removed, 0
7 hfr-k9sec processes affected (0 updated, 7 added, 0 removed, 0
14 hfr-mcast processes affected (0 updated, 14 added, 0 removed, 0
Install operation 2 'install activate disk0:hfr-diags-3.4.0.1I
disk0:hfr-k9sec-3.4.0.1I disk0:hfr-mcast-3.4.0.1I disk0:hfr-mgbl-3.4.0.1I
disk0:hfr-mpls-3.4.0.1I' started by user 'labuser' at 18:06:32 UTC Sat Jun
Info: The changes made to software configurations will not be
Info: persistent across system reloads. Use the command 'admin install
Info: commit' to make changes persistent.
Info: Please verify that the system is consistent following the
Info: software change using the following commands:
The following example displays information for a specific install request. Use the detail keyword to display additional information, including impact to processes and nodes impacted.
RP/0/RP0/CPU0:router(admin)# show install log 2 detail
Install operation 2 started by user 'labuser' at 18:06:32 UTC Sat Jun 03 2006.
install activate disk0:hfr-diags-3.4.0.1I disk0:hfr-k9sec-3.4.0.1I
disk0:hfr-mcast-3.4.0.1I disk0:hfr-mgbl-3.4.0.1I disk0:hfr-mpls-3.4.0.1I
Install operation 2 completed successfully at 18:07:48 UTC Sat Jun 03 2006.
Summary of changes on nodes 0/1/SP, 0/6/SP, 0/SM0/SP, 0/SM1/SP, 0/SM2/SP,
Activated: hfr-diags-3.4.0.1I
Summary of changes on nodes 0/1/CPU0, 0/6/CPU0:
Activated: hfr-diags-3.4.0.1I
1 hfr-mpls processes affected (0 updated, 1 added, 0 removed, 0
2 hfr-mcast processes affected (0 updated, 2 added, 0 removed, 0
Summary of changes on nodes 0/RP0/CPU0, 0/RP1/CPU0:
Activated: hfr-diags-3.4.0.1I
6 hfr-mgbl processes affected (0 updated, 6 added, 0 removed, 0
8 hfr-mpls processes affected (0 updated, 8 added, 0 removed, 0
7 hfr-k9sec processes affected (0 updated, 7 added, 0 removed, 0
14 hfr-mcast processes affected (0 updated, 14 added, 0 removed, 0
Install operation 2 'install activate disk0:hfr-diags-3.4.0.1I
disk0:hfr-k9sec-3.4.0.1I disk0:hfr-mcast-3.4.0.1I disk0:hfr-mgbl-3.4.0.1I
disk0:hfr-mpls-3.4.0.1I' started by user 'labuser' at 18:06:32 UTC Sat Jun
Info: The changes made to software configurations will not be
Info: persistent across system reloads. Use the command 'admin install
Info: commit' to make changes persistent.
Info: Please verify that the system is consistent following the
Info: software change using the following commands:
Install operation 2 completed successfully at 18:07:48 UTC Sat Jun 03 2006.
Related Commands
Command
|
Description
|
install activate
|
Adds a software package or SMU to the active software set.
|
install add
|
Installs a package on a storage device.
|
install commit
|
Makes the current active software set persistent across reloads.
|
install deactivate
|
Removes a package from the active software set.
|
install remove
|
Deletes inactive packages from a storage device.
|
install rollback to
|
Rolls back the software set to a saved installation point or to the last committed installation point.
|
install verify
|
Verifies the consistency of a previously installed software set with the package file from which it originated.
|
show install package
To display information about a package, use the show install package command in EXEC mode or Administration EXEC mode.
show install package {device:package | all} [brief | detail | verbose]
Syntax Description
device:package
|
Device and package, expressed in concatenated form (for example, disk0:hfr-mgbl-1.0.0). For the device argument, the value is disk0:.
|
all
|
Displays all installed packages on the system.
|
brief
|
(Optional) Displays only the name and version of packages.
|
detail
|
(Optional) Displays summary and component information for packages.
|
verbose
|
(Optional) Displays summary, component, and file information for packages.
|
Defaults
No default behavior or values
Command Modes
EXEC
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was made available in Administration EXEC mode. The components, files, and none keywords were removed and replaced by the detail, verbose, and brief keywords, respectively. The summary keyword was removed. The default output display was changed to match the output that displayed when the optional summary keyword was entered in previous releases.
|
Release 3.3.0
|
No modification.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show install package command to display information about packages. The output displays the version of the package, name of the manufacturer, name of the package, date and time when the package was built, and source directory where the package was built.
This command returns the same data in EXEC mode and Administration EXEC mode.
For additional information about the status of installed software packages, use the show install active and show install inactive commands.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read
|
Examples
The following is sample output from the show install package command:
RP/0/RP0/CPU0:router(admin)#show install package disk0:comp-hfr-full-3.3.30
disk0:comp-hfr-full-3.3.30
Table 5 describes the significant fields shown in the display.
Table 5 show install package Field Descriptions
Field
|
Description
|
disk0:hfr-rout-3.3.30
|
Storage device and the name of the package that has been installed.
|
hfr-rout V3.3.30 Routing Package
|
Name of the package.
|
Vendor
|
Name of the manufacturer.
|
Desc
|
Name of the package.
|
Build
|
Date and time the package was built.
|
Source
|
Source directory where the package was built.
|
The following is sample output from the show install package command with the all keyword:
RP/0/RP0/CPU0:router# show install package all
disk0:comp-hfr-full-3.3.30
Related Commands
show install pie-info
To display information about a Package Installation Envelope (PIE) installation file, use the show install pie-info command in Administration EXEC mode.
show install pie-info device:package [summary | detail | verbose]
Syntax Description
device:package
|
Device, directory path, and package, expressed in concatenated form.
|
summary
|
(Optional) Displays summary information.
|
detail
|
(Optional) Displays detailed information.
|
verbose
|
(Optional) Displays comprehensive information.
|
Defaults
Displays summary information.
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1 router.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
Support was added for the keywords detail, and verbose.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show install pie-info command to display information about a specified PIE installation file.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read
|
Examples
The following is sample output from the show install pie-info detail command:
RP/0/RP0/CPU0:router(admin)#show install pie-info disk1:/hfr-mcast-p.pie-3.3.0 detail
Contents of pie file '/disk1:/hfr-mcast-p.pie-3.3.0':
Expiry date : Jan 19, 2007 02:55:56 UTC
Uncompressed size : 9539249
hfr-mcast V3.3.0[1I] Multicast Package
Build : Built on Fri Feb 24 08:18:54 UTC 2006
Source : By edde-bld1 in /vws/aga/production/3.3.0/hfr/workspace for c2.95.3-p8
Card(s): RP, DRP, DRPSC, OC3-POS-4, OC12-POS, GE-3, OC12-POS-4, OC48-POS,
E3-OC48-POS, E3-OC12-POS-4, E3-OC3-POS-16, E3-OC3C
Components in package hfr-mcast-3.3.0, package hfr-mcast:
platform-ipv4-mrib V[fwd-33/9] HFR platform dependent DLL for MRIB
doc-hfr-mcast V[ci-33/5] Contains the man page documentation for HFR
multicast package commands
package-compat V[fwd-33/7] This is to collect package compatibility info from
other contributing components
package-multicast V[fwd-33/4] This is to collect package compatibility info
snmp-mcast V[fwd-33/20] Multicast MIBS on IOS XR
Related Commands
show install request
To display the list of incomplete installation requests, running and queued, use the show install request command in Administration EXEC mode.
show install request
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
Command syntax was changed from show install requests to show install request.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The Cisco IOS XR software processes only one installation request at a time. The default of installation commands is asynchronous mode, meaning that the command runs in the background and the EXEC prompt is returned as soon as possible. The show install request command displays any incomplete request that is currently running.
These requests cannot be stopped by pressing Ctrl-C.
Note
Performing a command in synchronous mode allows the installation process to finish before the prompt is returned.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read
|
Examples
The following is sample output from the show install request command:
RP/0/RP0/CPU0:router(admin)# show install request
Install operation 17 'install add /tftp://172.31.255.255/dir/19mcast'
started by user 'lab' at 14:38:45 UTC Thu Mar 30 2006.
The operation is 1% complete
The operation can still be aborted.
The following is sample output from the show install request command when no install operations are running:
RP/0/RP0/CPU0:router(admin)# show install request
There are no install requests in operation.
Related Commands
Command
|
Description
|
install activate
|
Adds a software package or an SMU to the active software set.
|
install add
|
Installs a package on a storage device.
|
install deactivate
|
Removes a package from the active software set.
|
install remove
|
Deletes inactive packages from a storage device.
|
install rollback to
|
Rolls back the software set to a saved installation point or to the last committed installation point.
|
install verify
|
Verifies the consistency of a previously installed software set with the package file from which it originated.
|
show install rollback
To display the software set associated with a saved installation point, use the show install rollback command in Administration EXEC mode.
show install rollback point-id [sdr sdr-name | location node-id] [[detail [sdr sdr-name | location
node-id] [summary [sdr sdr-name]]
Syntax Description
point-id
|
Installation point ID number.
|
sdr sdr-name
|
(Optional) Displays information for a specific secure domain router (SDR). The sdr-name argument is the name assigned to the secure domain router.
|
location node-id
|
(Optional) Displays information for a designated node. The node-id argument is expressed in the rack/slot/module notation.
|
summary
|
(Optional) Displays a summary of information in a system or secure domain router.
|
detail
|
(Optional) Displays a detailed summary of information for a system, secure domain router, or node, including the packages contained in a composite package.
|
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 3.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was made available in Administration EXEC mode.
|
Release 3.3.0
|
The command was moved to Administration EXEC mode only.
Support was added for the keywords and arguments: sdr sdr-name, detail, and summary.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show install rollback command to display the software set associated with a saved installation point. This command can be used with the install rollback to command to verify the software set associated with a saved installation point before rolling back to the saved installation point.
Use the location keyword and node-id argument to display information for a specific node. If you do not specify a location with the location keyword and node-id argument, this command displays information from all nodes.
Use the sdr keyword and sdr-name argument to display information for a specific secure domain router.
Use the summary keyword to display a summary of the committed packages in a system or secure domain router. Use the detail keyword to display a summary of the committed packages in a system, secure domain router, or node.
Use the clear install rollback oldest command to delete saved installation points from the install buffer.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read
|
Examples
The following is sample output from the show install rollback command:
RP/0/RP0/CPU0:router(admin)#show install rollback 0
Secure Domain Router: Owner
Node 0/1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/1/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-mini-3.3.30
Node 0/6/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/6/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-mini-3.3.30
Node 0/RP0/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/RP1/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM0/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM2/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
Node 0/SM3/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-mini-3.3.30
The following is sample output from the show install rollback detail command:
RP/0/RP0/CPU0:router(admin)#show install rollback 0 detail
Secure Domain Router: Owner
Node 0/1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
Node 0/1/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-full-3.3.30
Node 0/6/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
Node 0/6/CPU0 [LC] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/lc/mbihfr-lc.vm
disk0:comp-hfr-full-3.3.30
Node 0/RP0/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-full-3.3.30
Node 0/RP1/CPU0 [RP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/mbihfr-rp.vm
disk0:comp-hfr-full-3.3.30
Node 0/SM0/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
Node 0/SM1/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
Node 0/SM2/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
Node 0/SM3/SP [SP] [SDR: Owner]
Boot Image: /disk0/hfr-os-mbi-3.3.30/sp/mbihfr-sp.vm
disk0:comp-hfr-full-3.3.30
Table 6 describes the significant fields shown in the display.
Table 6 show install rollback Field Descriptions
Field
|
Description
|
Boot Image:
|
Minimum Boot Image (MBI) used to boot the node.
|
Rollback Packages:
|
Packages that will be rolled back.
|
Related Commands
show install suspend
To display the suspension points for an install activation operation, use the show install suspend command in Administration EXEC mode.
show install suspend
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Administration EXEC
Command History
Release
|
Modification
|
Release 3.3.0
|
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Routers.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The install suspend command may be run multiple times to set multiple suspension points. Use the show install suspend command to view all suspension points.
The suspension points are valid only for the duration of the current install operation. They are cleared after the transaction has been completed.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read
|
Examples
The following example shows output for the command show install suspend:
RP/0/RP0/CPU0:router(admin)#show install suspend
Note: The suspension points set below will be used only for
the participating nodes in an incremental activation, deactivation,
rollback install operation.
Future suspension points:
Related Commands
show install which
To display the origin of a named process, component, or package, use the show install which command in EXEC mode or Administration EXEC mode.
show install which {component name [verbose] | file filename} [sdr sdr-name | location node-id]
Syntax Description
component name
|
Displays the package information for the component specified in the name argument.
|
verbose
|
(Optional) Displays summary, component, and file information for each component.
|
file filename
|
Displays the package information for the file specified in the filename argument.
|
location node-id
|
(Optional) Displays information for the designated node. The node-id argument is expressed in the rack/slot/module notation.
|
sdr sdr-name
|
(Optional) Displays information for a specific secure domain router (SDR). The sdr-name argument is the name assigned to the secure domain router.
|
Defaults
The default search is performed for the active software set.
Command Modes
EXEC
Administration EXEC
Command History
Release
|
Modification
|
Release 2.0
|
This command was introduced on the Cisco CRS-1.
|
Release 3.0
|
No modification.
|
Release 3.2
|
This command was first supported on the Cisco XR 12000 Series Router. The command was moved from EXEC mode to Administration EXEC mode.
|
Release 3.3.0
|
This command was supported in both EXEC mode and Administration EXEC mode.
Support was removed for the files keyword.
Support was added for the verbose keyword.
Support was added for the SDR SDR-name keyword and argument.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
This command returns the same data in EXEC mode and Administration EXEC mode.
Task ID
Task ID
|
Operations
|
pkg-mgmt
|
read
|
Examples
The following is sample output from the show install which command with the file and location keywords specified:
RP/0/RP0/CPU0:router# show install which file bgp location 0/RP0/CPU0
Node 0/RP0/CPU0 has file bgp for boot package /disk0/hfr-os-mbi-3.3.30/mbihfr-rt
hfr-rout V3.3.30[1I] Routing Package
Build : Built on Mon Mar 27 10:01:45 UTC 2006
Source : By edde-bld1 in /vws/aga/production/3.3.30.1I/hfr/workspace fo8
parallel impacted processes restart
ipv4-bgp V[fwd-33/69] IPv4 Border Gateway Protocol (BGP)
Table 7 describes the significant fields shown in the display.
Table 7 show install which Field Descriptions
Field
|
Description
|
Package:
|
Version of the package, name of the manufacturer, name of the package, date and time when the package was built, and source directory where the package was built.
|
Component:
|
Component name and version number.
|
Related Commands