Upgrading and Managing Cisco IOS XR Software

Cisco IOS XR software is divided into software packages so that you can select which features run on your router. This module describes the concepts and tasks necessary to add feature packages, upgrade the active set of packages, roll back to a previously active set of packages, and perform other related package management tasks.

For complete descriptions of the commands listed in this module, see Related Documents. To locate documentation for other commands that might appear in the course of performing a configuration task, search online in Cisco ASR 9000 Series Aggregation Services Router Commands Master List.

Table 1. Feature History for Upgrading and Managing Cisco IOS XR Software
Release	Modification
Release 3.7.2	The feature was introduced.
Release 3.9.0	No modification.
Release 4.0.0	A procedure to upgrade software from Cisco IOS XR Release 3.x was introduced. See Upgrading to Cisco IOS XR Software Release 4.0. Support for installation commands was removed from EXEC mode. The ability to install software on a specific SDR was removed.
Release 6.0.1	Support was added for digitally signed images. See Digitally Signed Images
Release 6.3.1	Support for parallel FPD upgrade for power modules was added.

This module contains the following topics:

Overview of Cisco IOS XR Software Packages

Cisco IOS XR software is divided into software packages so that you can select which features run on your router. Each package contains the components to perform a specific set of router functions, such as routing, security, or modular services card (MSC) support. Bundles are groups of packages that can be downloaded as a set. For example, Cisco IOS XR Unicast Routing Core Bundle (known as mini) provides the main packages for use on every router.

Adding a package to the router does not affect the operation of the router—it only copies the package files to a local storage device on the router, known as the boot device (such as the compact flash drive). To make the package functional on the router, you must activate it for one or more cards.

To upgrade a package, you activate a newer version of the package. When the automatic compatibility checks have been passed, the new version is activated, and the old version is deactivated.

Note

Activating a software maintenance upgrade (SMU) does not cause any earlier SMUs or the package to which the SMU applies to be automatically deactivated.

Note

If an interface on a router does not have a configuration and is brought up by performing no-shut operation, then upon router reload, the interface state changes to admin-shutdown automatically.

To downgrade a package, you activate an older version of the package. When the automatic compatibility checks have been passed, the older version is activated, and the newer version is deactivated.

Caution

Do not perform any install operations when the router is reloading.

Note

For more information on the features and components included in each package, refer to the release notes.

Package Installation Envelopes

Package Installation Envelopes (PIEs) are nonbootable files that contain a single package or a set of packages (called a composite package or bundle). Because the files are nonbootable, they are used to add software package files to a running router.

PIE files have a pie extension. When a PIE file contains software for a specific bug fix, it is called a software maintenance upgrade (SMU).

Note

Files with the vm extension are bootable installation files used only to replace all current Cisco IOS XR software. These files are installed from ROM Monitor mode, which causes significant router downtime. Cisco Systems recommends installing or upgrading software packages only using PIE files as described in this document. For more information on vm files, see ROM Monitor Configuration Guide for Cisco ASR 9000 Routers.

Summary of Cisco IOS XR Software Packages

Every router includes a basic set of required packages contained in the Cisco IOS XR Unicast Routing Core Bundle. Additional optional packages can be added and activated on the router to provide specific features.

Packages in the Cisco IOS XR Unicast Routing Core Bundle

The packages contained in the Cisco IOS XR Unicast Routing Core Bundle are as follows:

Operating system (OS) and minimum boot image (MBI)—Kernel, file system, memory management, and other slow changing core components.
Base—Interface manager, system database, checkpoint services, configuration management, other slow-changing components.
Infra—Resource management: rack, fabric.
Routing—RIB, BGP, ISIS, OSPF, EIGRP, RIP, RPL, and other routing protocols.
Forwarding—FIB, ARP, QoS, ACL, and other components.
LC— Line card drivers.

The filename for this bundle is: asr9k-mini.pie-version.

Refer to the release notes for additional information on the specific features provided by each package.

Software Maintenance Upgrades

A software maintenance upgrade (SMU) is a PIE file that contains fixes for a specific defect. A composite SMU is a PIE file that contains SMUs for more than one package. SMUs are added and activated using the same procedures as other PIE files. SMUs are created to respond to immediate issues and do not include new features. Typically, SMUs do not have a large impact on router operations. SMU versions are synchronized to the package major, minor, and maintenance versions they upgrade.

The affect of an SMU depends on its type:

Process Restart SMU—Causes a process or group of processes to restart on activation.
Reload SMU—Causes a parallel reload (of RPs and line cards).

SMUs are not an alternative to maintenance releases. They provide quick resolution of immediate issues. All bugs fixed by SMUs are integrated into the maintenance releases. For information on available SMUs, contact Cisco Technical Support, as described in Obtaining Technical Assistance in the monthly What’s New in Cisco Product Documentation.

Note

Activating a software maintenance upgrade (SMU) does not cause any earlier SMUs, or the package to which the SMU applies, to be automatically deactivated.

Third-party SMUs

Consider these points while activating and deactivating third-party SMUs:

To activate a third-party SMU you should have a corresponding base package.
When you activate a third-party SMU, the corresponding third-party base package state is inactive, this is an expected behavior.
To deactivate a third-party SMU, you should activate corresponding third-party base package.

PIE Filenames and Version Numbers

PIE filenames have two formats: one for composite-package PIEs (bundles) and one for single-package PIEs. A composite-package file is a PIE file that contains multiple packages.

Note

Hyphens in the filename are part of the filename.

Table 1 shows the filenames for available PIE types.

Table 2. PIE Filenames

Software Delivery Type

Filename

Example

Composite (Bundle) PIE

platform-composite_name.pie- major.minor.maintenance

asr9k-mini.pie-3.7.2

Single package PIE

platform-package_type.-p.pie- major.minor.maintenance

asr9k-mpls.pie-3.7.2

Composite SMU

comp-platform-composite_name.ddts.pie

comp-asr9k-001.CSCec98xxx.pie

Single package SMU

platform-package_type- major.minor.maintenance.ddts.pie

asr9k-base-3.7.2.CSCei45xxx.pie

Note

A SMU composite name usually is “001”, which means the SMU is the first SMU for that DDTS. In rare cases in which the same DDTS requires multiple composite SMUs, a second composite version number is released as “002”. In the previous example, a second composite SMU “comp-002.CSCec98766” would be created for DDTS CSCec98766.

Filename Component Description

The filename components for all packages are described in Table 1.

Table 3. Composite- and Single-Package Filename Components
Component	Description
platform	Identifies the platform for which the software package is designed. The platform designation is “asr9k.”
composite_name	Identifies a specific composite package. The only composite PIE file at this time is named “mini” and includes all packages described in the Cisco IOS XR Unicast Routing Core Bundle.
package_type	Identifies the type of package the file supports (package_type applies only to single-package PIEs). Package types include: mcast—Multicast package mgbl—Manageability package mpls—MPLS package k9sec—Security package diags—Diagnostics package fpd—Field-programmable device package doc—Documentation package
major	Identifies the major release of this package. A major release occurs when there is a major architectural change to the product (for example, a major new capability is introduced). All packages operating on the router must be at the same major release level. A major release is the least frequent release and may require a router reboot.
minor	Identifies the minor release of this package. A minor release contains one or more of the following: New features Bug fixes The minor release version does not have to be identical for all software packages operating on the router, but the operating packages must be certified by Cisco as compatible with each other. A minor release may require a router reboot.
maintenance	Identifies the maintenance release of this package. A maintenance release contains a collection of bug fixes for a package. The maintenance release version does not have to be identical for all software packages operating on the router, but the major and minor versions of the maintenance release must match those of the package being updated. A maintenance release does not usually require a router reboot.
ddts	SMUs only. Identifies a DDTS¹ number that describes the problem this SMU addresses. DDTS is the method used to track known bugs and the resolutions or workarounds for those issues.
px	Identifies images that are compatible with hardware that uses the x86 architecture. Starting with Cisco IOS XR Release 4.2, -px releases replace the -p releases.

¹ distributed defect tracking system

Copying the PIE File to a Local Storage Device or Network Server

To add an optional package or upgrade or downgrade a package, you must copy the appropriate PIE file to a local storage device or to a network file server to which the router has access.

If you need to store PIE files on the router, we recommended storing PIE files on the hard disk. Flash disk0: serves as the boot device for packages that have been added or activated on the system. Flash disk1: is used as a backup for disk0:.

Tip

Before copying PIE files to a local storage device, use the dir command to check to see if the required PIE files are already on the device.

Information About Package Management

Summary of Package Management

The general procedure for adding optional packages, upgrading a package or package set, or downgrading packages on the router is as follows:

Copy the package file or files to a local storage device or file server.
Add the package or packages on the router using the command install add .
Activate the package or packages on the router using the install activate command.
Commit the current set of packages using the install commit command.

Process to Add, Activate, and Commit Cisco IOS XR Software Packages illustrates key steps in the package management process.

Figure 1. Process to Add, Activate, and Commit Cisco IOS XR Software Packages

Adding Packages

Use the install add command to unpack the package software files from a PIE file and copy them to the boot device (usually disk0:) of your router.

From administration EXEC mode, the package software files are added to the boot device of the DSC of the router, as well as all active and standby Route Processors (RPs) and fabric shelf controllers (SCs) installed on the router.

Note

The disk that holds the unpacked software files is also known as the boot device. By default, flash disk0: is used as the boot device. To use an alternate storage device, such as flash disk1:, see the Router Recovery with ROM Monitor module of ROM Monitor Configuration Guide for Cisco ASR 9000 Routers. Remember that all RSPs in a system must use the same boot device. If the boot device on the primary RSP is flash disk0:, then the standby RSP must also have a flash disk0:.

Verifying Package Details

Before you activate a package on the router, you can verify the type of upgrade that is required for the package and whether the package requires a router reload or not. Use the show install package pie detail command in admin mode.


RP/0/RSP0/CPU0:router(admin)# show install package disk0:asr9k-px-4.x.x.04I.CSCuc66088-0.0.4.i detail

Mon Nov 19 09:44:24.036 UTC
disk0:asr9k-px-4.x.x.04I.CSCuc66088-0.0.4.i
    asr9k-px-4.x.x.04I.CSCuc66088 V0.0.4.i[SMU]  User specified bundle 
        iosxr-infra-asr9k-px1-4.x.x.04I.CSCuc66088.pi.pie.
     [composite package]
     [root package, grouped contents]
    Vendor : Cisco Systems
    Desc   : User specified bundle iosxr-infra-asr9k-px1-4.x.x.04I.CSCuc66088.pi.pie.
    Build  : Built on Fri Nov  9 11:00:11 UTC 2012
    Source : By iox-bld27 in /scratch1/SMU_BLD_WS/ci-431_206626_CSCuc66088_121109102249 for pie
    Card(s): RP, CRS-RP-X86, CRS8-RP-x86, CRS16-RP-x86, ASR9001-RP, RP-STARSCREAM, NP24-4x10GE, 
             NP24-40x1GE, NP40-40x1GE, NP40-4x10GE, NP40-8x10GE, NP40-2_20_COMBO, NP80-8x10GE, 
             NP80-16x10GE, NP200-24x10GE, NP200-36x10GE, NP200-2x100GE, NP200-1x100GE, NP200-5x40GE, 
             NP200-8x10GE, NP200-MOD-SMEM, NP200-MOD-LMEM, ASR9001-LC, A9K-SIP-700, A9K-SIP-500, A9K-SIP-AVSM
    Restart information:
      Default:
        parallel impacted processes restart
    Size Compressed/Uncompressed: 1744KB/1830KB (95%)
    Components in package disk0:asr9k-px-4.x.x.04I.CSCuc66088-0.0.4.i, package  asr9k-px-4.x.x.04I.CSCuc66088:
    disk0:iosxr-infra-4.x.x.04I.CSCuc66088-0.0.4.i
        iosxr-infra-4.x.x.04I.CSCuc66088 V0.0.4.i[SMU]  IOS-XR Infra Package Definition
        Vendor : Cisco Systems
        Desc   : IOS-XR Infra Package Definition
        Build  : Built on Fri Nov  9 11:00:10 UTC 2012
        Source : By iox-bld27 in /scratch1/SMU_BLD_WS/ci-431_206626_CSCuc66088_121109102249 for pie
        Card(s): RP, CRS-RP-X86, CRS8-RP-x86, CRS16-RP-x86, ASR9001-RP, RP-STARSCREAM, NP24-4x10GE, 
                 NP24-40x1GE, NP40-40x1GE, NP40-4x10GE, NP40-8x10GE, NP40-2_20_COMBO, NP80-8x10GE, 
                 NP80-16x10GE, NP200-24x10GE, NP200-36x10GE, NP200-2x100GE, NP200-1x100GE, 
                 NP200-5x40GE, NP200-8x10GE, NP200-MOD-SMEM, NP200-MOD-LMEM, ASR9001-LC, 
                 A9K-SIP-700, A9K-SIP-500, A9K-SIP-AVSM
        
        Size Compressed/Uncompressed: 1744KB/1830KB (95%)
        Components in package disk0:iosxr-infra-4.x.x.04I.CSCuc66088-0.0.4.i, 
            package  iosxr-infra-4.x.x.04I.CSCuc66088:
            platforms-spa-chopper V[ci-4x-bugfix/8]  This component contains Platform Independent 
            Chopper SPA Code.
            iosxr-infra-4.x.x.04I.CSCuc66088-package V[Default]  Manifest information for package 
            iosxr-infra-4.x.x.04I.CSCuc66088
            iosxr-infra-4.x.x.04I.CSCuc66088-package-compatibility V[Default]  
            Package Compatibility information for package iosxr-infra-4.x.x.04I.CSCuc66088

Activating Packages

Software packages remain inactive until activated with the install activate command.

After a package has been added to the router , use the install activate command to activate the package or SMUs 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 programming interface (API) compatibility checks have been passed.

Activating a Package on the Router

To activate a package on your router, use the install activate command in administration EXEC mode. The install activate command also activates the package on all administration plane nodes and resources, including service processors (SPs), fabric SCs, fan controllers, alarm modules, and power modules.

Activating Multiple Packages or SMUs

To install multiple packages or software maintenance upgrades (SMUs) with a single command, use the install activate command and either specify up to 16 packages by repeating device: package arguments or use wildcard syntax to specify multiple packages. Some SMUs may require a reload. If the operation requires a node reload, the user is prompted before the installation operation occurs.

Note

After activating SMU CSCwc03813, ensure that you either reload the Line Card or remove and reapply the existing Access Control Lists, for the updates to take effect.

Activating All Packages Added in a Specific Operation

To install all packages that were added in a specific install add operation, use the install activate command with the id add-id keyword and argument, specifying the operation ID of the install add operation. You can specify up to 16 operations in a single command.

Adding and Activating a Package with a Single Command

To add and activate a package with a single command, use the install add command with the activate keyword from administration EXEC mode.

Digitally Signed Images

From Release 6.0.1 onwards, all Cisco IOS XR images are digitally signed to ensure the authenticity of the software. If the ROMMON/BIOS image on the line card is digitally signed, then ensure that the Cisco IOS XR image on the router is also digitally signed, as the ROMMON/BIOS checks the Cisco IOS XR image for a digital signature.

Note

The Cisco IOS XR Release 5.3.x images are not digitally signed. If you are running Cisco IOS XR Release 5.3.x, then ensure that you install the Abraxas based SMU for successful operation of the router with the latest line cards.

The digitally signed images are supported on the following line cards:

A99-RP2-TR
A99-RP2-SE
A9K-RSP880-TR
A9K-RSP880-SE
A9K-8X100GE-SE
A9K-8X100GE-TR
A9K-4X100GE-SE
A9K-4X100GE-TR
A99-8X100GE-SE
A99-8X100GE-TR
A9K-MOD400-SE
A9K-MOD400-TR
A9K-MOD200-SE
A9K-MOD200-TR
A9K-400G-DWDM-TR
A99-12X100GE

For more information on installing line cards, see Cisco ASR 9000 Series Aggregation Services Routers Ethernet Line Card Installation Guide.

Validation Messages

When image credentials, signature, and other attributes of the signature envelope are matched, the router reboots.

The following message is displayed on successful image validation.

File reception completed.**** check image validation ****.......BIOS CODE SIGN ENTRY ...Image ASR9K-Tomahawk verified successfully~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If image validation is unsuccessful, the boot process is interrupted, and the router enters the ROMMON CLI mode.

The following message is displayed on unsuccessful image validation.

**** check image validation ****.......BIOS CODE SIGN ENTRY ... Image ASR9K-Tomahawk Verification Failed Invalid signature offset ************************************ ASR9K image validation failed, cannot boot image, contact tech support ************************************

Upgrading and Downgrading Packages

To upgrade a package, activate the latest version of the package; the previous version is automatically deactivated. To downgrade a package, activate the previous version of the package; the latest version is automatically deactivated.

Actual activation is performed only after compatibility checks have been passed.

Note

Activating a software maintenance upgrade (SMU) does not cause previous versions of the SMUs, or the package to which the SMU applies, to be automatically deactivated.
If you upgrade an ASR 9000 router with low RSP card memory, then the RSP440-TR route-switch processor and Cisco ASR 9000 2nd Generation line card can become inaccessible due to insufficient memory. Power cycling the router may help bring the router back to the up state.

Committing the Active Software Set

When a package is activated on the router , it becomes part of the current running configuration. To make the package activation persistent across reloads, enter the install commit command in administration EXEC mode. On startup, the designated shelf controller (DSC) of the secure domain router (SDR) loads the committed software set.

Note

If the system is restarted before the active software set is saved with the install commit command, the previously committed software set is used.

Rolling Back to a Previous Installation Operation

Although the term commit sounds final, the Cisco IOS XR software provides the flexibility to roll back the selected package set to previously saved package sets. Each time a package is activated or deactivated, a rollback point is created that defines the package set that is active after the package activation or deactivation. The software also creates a rollback point for the last committed package set. If you find that you prefer a previous package set over the currently active package set, you can use the install rollback command to make a previously active package set active again.

Multiple Disks Support during Installations

In installations on platforms where Cisco IOS XR Software is supported, only a single disk is used as an install device; that is, either disk0 or disk1. When multiple packages are installed on a single disk, it results in space constraints. To resolve this space limitation, the disk supported for the install operations has been extended to another disk called the disk1. When installing multiple packages, this feature enables you to choose between disk0 and disk1.

To add packages to a specific disk name, use the install media command in the admin configuration mode.

RP/0/RSP0/CPU0: router (admin) # install media disk1

Restrictions

Before enabling the addition of disk1 through the install media command, the disk mirroring feature should be explicitly disabled. For details regarding disk mirroring, see the Disk Mirroring chapter.
All single version packages should be installed into one disk; that is, either disk0 or disk1.
When downgrading to an image that does not support extended disk, the rollback points of the extended disk will not be available on the downgraded image. For example, assume a case where the version1 (V1) image does not support the extended disk functionality and version2 (V2) image supports the functionality. Upgrading from V1(disk0) to V2(disk1), in such a case, makes the rollback points of V1 available on V2. However, when downgrading from V2(disk1) to V1(disk0), the rollback points of V2 will not be available on V1. For more information about the rollback feature and rollback points, see the Upgrading and Managing Software chapter.

Deactivation of fully superseded SMUs

Cisco IOS XR Software will accumulate a set of Software Maintenance Upgrades (SMUs) over time, where an older SMU gets superceded by the latest SMU. For example, if SMU A was initially delivered to you, and subsequently, as a result of a bug resolution, SMU B was delivered, then SMU A becomes the subset of SMU B and SMU A is superceded by SMU B. In this case, SMU A is redundant and can be deactivated to clean up the software package.

Note

When an older SMU gets superceded their code is no longer used but it can be used for rollback purposes which consumes the disk space.

When you install a reload SMU which supercedes the existing SMU the router reboots and SMU is placed in the superceded list automatically. If the superceded reload SMU is deactivated and fully supercedes the existing SMU, then router will not reboot when you run the install deactivate superceded command and the install remove inactive command.

Note

Removing the superceded SMUs will increase the disk space and it will not affect the functionality.

To deactivate all the fully superseded SMUs, use the install deactivate superseded command in the admin mode.

RP/0/RSP0/CPU0: router(admin) # install deactivate superseded

To display the details of the SMUs that are superseded, use the show install superseded command in the EXEC mode.

RP/0/RSP0/CPU0: router # show install superseded
Thu Feb 3 17:37:20.379 UTC
disk0:asr9k-px-4.3.0.CSCud93518-1.0.0 is fully superseded by disk0:asr9k-px-4.3.0.CSCue23747-1.0.0

Support for the Ignore Package Presence Check Option

During any software package upgrade in Cisco IOS XR Software, two versions of the packages get stored, both the previous version and the upgraded version. In Route Switch Processor 2 (RSP2), the disk space is insufficient to hold all packages of these two versions. To address this, a new optional keyword, ignore-pkg-presence-check , is added to the install activate command, which allows upgrading with lesser number of packages. For example, assume a case where version1 (V1) of the software consists of packages A, B, C, and D, and you want to upgrade to the version2 (V2) with only 3 packages (A, B, and C). The ignore-pkg-presence-check option allows only packages A, B, and C to be upgraded to V2 and deactivates package D of V1. Thus, an explicit deactivation of package D is not required and the user can add package D of V1 after upgrading to V2.

To upgrade software with lesser number of packages, use the install activate [ignore-pkg-presence-check] command in the admin mode.

RP/0/RSP0/CPU0: router(admin) # install activate [ignore-pkg-presence-check] V2 packages

Restrictions

The restrictions for this option are:

The ignore-pkg-presence-check keyword is supported only with the install activate command and is not supported with the install add activate command.
When you upgrade using the ignore-pkg-presence-check option, the deactivation of packages always happens synchronously, using the synchronous keyword in the install deactivate command.

Upgrading Packages

To upgrade a package that is currently active on your router, add and activate a newer version of the same package (see Example of a Maintenance Release Package Upgrade). The older version of the software package is deactivated automatically. These actions are permitted only after the package compatibility checks and API version compatibility checks have been passed.

Deactivated packages are not removed from the router. To remove inactive package files, use the install remove command.

Caution

Upgrading or downgrading a software package can cause a process to restart or a new process to start. Use the test option to preview the impact of the package activation.

Figure 2. Example of a Maintenance Release Package Upgrade

Downgrading Packages

To downgrade a software package, activate an older version on one or more cards for which that package is already active. The newer version of the same software package is deactivated automatically. These actions are performed only after the package compatibility checks and API version compatibility checks have been passed.

Deactivated packages are not removed from the router. To remove inactive package files, use the install remove command. See the Related Topics section for links to more information.

Note

If type 8,9, or 10 is the secret key configured, then before downgrading to 6.6.3 and earlier versions, perform either of the following methods:

Type a combination of secret type and encrypted key instead of plain text for the password. Example:
```
username root
group root-lr
group cisco-support
secret 10 $6$Mwaqg/jdBPOn4g/.$PrJP2KjsCbL6bZqmYOej5Ay67S/sSWJNlkiYhCTc/B/35E1kJBqffmBtn.ddQEH0O2CU7V.ZEMmqIg7uE8cfz0
```
This is because 6.6.3 and earlier versions do not support type 8,9, or 10 key type.
Ensure that there are secret type 5 users on the system.

Impact of Package Version Changes

Each package version change has a different impact on the operation of the router, depending on the type of package and whether the upgrade is for a major, minor, or maintenance release. The following resources can provide more information on the impact of a package version change:

See Related Topics for more information on the typical impact for major, minor, and maintenance releases.
For specific information about the impact of an upgrade, consult the release notes for the package release, and test the impact of the package activation by adding the test option to the install activate command.
The Cisco IOS XR Software Selector tool also contains information on package version compatibility.

Impact of Package Activation and Deactivation

Activation or deactivation of a package can have an immediate impact on the system. The system can be affected in the following ways:

When a new package is activated, any new CLI commands for the package are added to the router. The router need not be restarted or reloaded.
When a package is deactivated, the commands associated with the features being deactivated are removed from the router. The commands are no longer available to the user.
During a software package deactivation, upgrade, or downgrade, any incompatible configurations are removed from the running configuration of the router, and saved to a file. Messages for incompatible configurations are displayed. Incompatible configurations are those configurations that are not supported by the new version of the software package.

Note

You must address any issues that result from the revised configuration and reapply the configuration, if necessary.

New processes may be started.
Running processes may be stopped or restarted.
All processes in the cards may be restarted. Restarting processes in the cards is equivalent to a soft reset.
The cards may reload.
No impact: no processes in the card may be affected.

Tip

When activating and deactivating packages, use the test option to test the effects of a command without impacting the running system. After the activation or deactivation process completes, enter the show install log command to display the process results.

Delaying the Return of the CLI Prompt

By default, the CLI prompt is returned to the screen before the installation operation is complete, which allows you to enter other commands that are not installation commands. If additional installation requests are attempted before the first operation is complete, they are not run.

To delay the return of the CLI prompt until an installation operation is complete, enter the install command with the synchronous keyword. For example:

install add disk1:/pie-file synchronous 
install activate disk0:package synchronous

To determine if an install command is currently running, enter the show install request command.

Displaying Installation Log Information

The install log provides information on the history of the installation operations. Each time an installation operation is run, a number is assigned to that operation.

Use the show install log command to display information about both successful and failed installation operations.
The show install log command with no arguments displays a summary of all installation operations. Specify the request-id argument to display information specific to an operation. Use the detail or verbose keywords to display details for specific operation.
Use the detail or verbose keywords to display detailed information, including file changes, nodes that could be reloaded, impact to processes, and impact to Dynamic Link Libraries (DLLs).

Tip

By default, the install log stores up to 50 entries. Use the clear install log-history command to reset the number of entries to any value from 0 to 255.

Examples

Displaying install log Entries: Example

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 DLLs.


RP/0/RSP0/CPU0:router(admin)# show install log verbose

Install operation 1 started by user 'labuser' at 17:48:51 UTC Sat Jun 03 2009.
install add /disk1:asr9k-diags-p.pie-PD34-06.06.07
/disk1:asr9k-k9sec-p.pie-PD34-06.06.07 /disk1:asr9k-mcast-p.pie-PD34-06.06.07
/disk1:asr9k-mgbl-p.pie-PD34-06.06.07 /disk1:asr9k-mpls-p.pie-PD34-06.06.07
Install operation 1 completed successfully at 17:51:32 UTC Sat Jun 03 2009.

Install logs:
 Install operation 1 'install add /disk1:asr9k-diags-p.pie-PD34-06.06.07
 /disk1:asr9k-k9sec-p.pie-PD34-06.06.07 /disk1:asr9k-mcast-p.pie-PD34-06.06.07
 /disk1:asr9k-mgbl-p.pie-PD34-06.06.07 /disk1:asr9k-mpls-p.pie-PD34-06.06.07'
 started by user 'labuser' at 17:48:51 UTC Sat Jun 03 2009.
 Info:     The following packages are now available to be activated:
    Info:
    Info:         disk0:asr9k-diags-3.7.2.1I
    Info:         disk0:asr9k-k9sec-3.7.2.1I
    Info:         disk0:asr9k-mcast-3.7.2.1I
    Info:         disk0:asr9k-mgbl-3.7.2.1I
    Info:         disk0:asr9k-mpls-3.7.2.1I
    Info:      
  Install operation 1 completed successfully at 17:51:32 UTC Sat Jun 03 2009.
  Install operation 2 started by user 'labuser' at 18:06:32 UTC Sat Jun 03 2009.
  install activate disk0:asr9k-diags-3.7.2.1I disk0:asr94k-k9sec-3.7.2.1I
  disk0:asr9k-mcast-3.7.2.1I disk0:asr9k-mgbl-3.7.2.1I disk0:asr9k-mpls-3.7.2.1I
  Install operation 2 completed successfully at 18:07:48 UTC Sat Jun 03 2009.
    Summary:
      Install method: parallel
      Summary of changes on nodes 0/1/SP, 0/6/SP, 0/SM0/SP, 0/SM1/SP, 
      0/SM2/SP,0/SM3/SP:
          Activated:    asr9k-diags-3.7.2.1I
          No processes affected

      Summary of changes on nodes 0/1/CPU0, 0/6/CPU0:
          Activated:    asr9k-diags-3.7.2.1I
                        asr9k-mcast-3.7.2.1I
                        asr9k-mpls-3.7.2.1I
         1 asr9k-mpls processes affected (0 updated, 1 added, 0 removed, 0 impacted)
         2 asr9k-mcast processes affected (0 updated, 2 added, 0 removed, 0 impacted)

      Summary of changes on nodes 0/RP0/CPU0, 0/RP1/CPU0:
          Activated:    asr9k-diags-3.7.2.1I
                        asr9k-k9sec-3.7.2.1I
                        asr9k-mcast-3.7.2.1I
                        asr9k-mgbl-3.7.2.1I
                        asr9k-mpls-3.7.2.1I
         6 asr9k-mgbl processes affected (0 updated, 6 added, 0 removed, 0 impacted)
         8 asr9k-mpls processes affected (0 updated, 8 added, 0 removed, 0 impacted)
         7 asr9k-k9sec processes affected (0 updated, 7 added, 0 removed, 0 impacted)
        14 asr9k-mcast processes affected (0 updated, 14 added, 0 removed, 0 impacted)
  
  Install logs:
    Install operation 2 'install activate disk0:asr9k-diags-3.7.2.1I
      disk0:asr9k-k9sec-3.7.2.1I disk0:asr9k-mcast-3.7.2.1I disk0:asr9k-mgbl-3.7.2.1I
      disk0:asr9k-mpls-3.7.2.1I' started by user 'labuser' at 
      18:06:32 UTC Sat Jun 03 2009.
      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:
      Info:         show system verify
   --More--

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/RSP0/CPU0:router(admin)# show install log 2 detail
  
  Install operation 2 started by user 'labuser' at 18:06:32 UTC Sat Jun 03 2009.
  install activate disk0:asr9k-diags-3.7.2.1I disk0:asr9k-k9sec-3.7.2.1I
  disk0:asr9k-mcast-3.7.2.1I disk0:asr9k-mgbl-3.7.2.1I disk0:asr9k-mpls-3.7.2.1I
  Install operation 2 completed successfully at 18:07:48 UTC Sat Jun 03 2006.
  
  Summary:
      Install method: parallel
      Summary of changes on nodes 0/1/SP, 0/6/SP, 0/SM0/SP, 0/SM1/SP, 
      0/SM2/SP, 0/SM3/SP:
          Activated:    asr9k-diags-3.7.2.1I
          No processes affected
      
      Summary of changes on nodes 0/1/CPU0, 0/6/CPU0:
          Activated:    asr9k-diags-3.7.2.1I
                        asr9k-mcast-3.7.2.1I
                        asr9k-mpls-3.7.2.1I
           1 asr9k-mpls processes affected (0 updated, 1 added, 0 removed, 0 impacted)
           2 asr9k-mcast processes affected (0 updated, 2 added, 0 removed, 0 impacted)
      
      Summary of changes on nodes 0/RP0/CPU0, 0/RP1/CPU0:
          Activated:    asr9k-diags-3.7.2.1I
                        asr9k-k9sec-3.7.2.1I
                        asr9k-mcast-3.7.2.1I
                        asr9k-mgbl-3.7.2.1I
                        asr9k-mpls-3.7.2.1I
           6 asr9k-mgbl processes affected (0 updated, 6 added, 0 removed, 0 impacted)
           8 asr9k-mpls processes affected (0 updated, 8 added, 0 removed, 0 impacted)
           7 asr9k-k9sec processes affected (0 updated, 7 added, 0 removed, 0 impacted)
          14 asr9k-mcast processes affected (0 updated, 14 added, 0 removed, 0 impacted)
  
  Install logs:
      Install operation 2 'install activate disk0:asr9k-diags-3.7.2.1I
      disk0:asr9k-k9sec-3.7.2.1I disk0:asr9k-mcast-3.7.2.1I disk0:asr9k-mgbl-3.7.2.1I
      disk0:asr9k-mpls-3.7.2.1I' started by user 'labuser' at 18:06:32 UTC 
      Sat Jun 03 2006.
      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:
      Info:         show system verify
      Info:         install verify packages
      Install operation 2 completed successfully at 18:07:48 UTC Sat Jun 03 2006.

Package Management Procedures

Note

Review the concepts about package management before performing the tasks described in this module.

Activation and Deactivation Prerequisites

These prerequisites must be met for a package to be activated or deactivated:

You must be in a user group associated with a task group that includes the proper task IDs. The command reference guides include the task IDs required for each command. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Verify that all cards are installed and operating properly. For example, do not activate or deactivate packages while cards are booting, while cards are being upgraded or replaced, or when you anticipate an automatic switchover activity.
If a ROM Monitor upgrade is required for the software package, the upgrade must be completed before the package is activated. For ROM Monitor upgrade information and procedures, see ROM Monitor Configuration Guide for Cisco ASR 9000 Routers.

Check the sanity of the configuration file system and recover from any internal inconsistencies by using the cfs check command.

RP/0/RSP0/CPU0:router# cfs check 

Tue Sep 20 07:22:03.374 DST

Creating any missing directories in Configuration File system...OK
Initializing Configuration Version Manager...OK
Syncing commit database with running configuration...OK

Clear any inconsistency alarms and remove any failed configurations using the clear configuration inconsistency command.

An inconsistency alarm is set when there is a failure to restore the configuration; this can occur during router startup, or when a line card or route switch processor (RSP) card is inserted or removed. If an inconsistency alarm is set, a message similar to the one in this example is displayed:
```
RP/0/0/CPU0:May 26 11:58:40.662 : cfgmgr-rp[130]: %MGBL-CONFIGCLI-3 
   BATCH_CONFIG_FAIL : 28 config(s) failed during startup. To view 
   failed config(s) use the command - "show configuration failed startup"
  
```
When the inconsistency alarm is set, all configuration commit operations fail until the alarm is cleared.
Although more than one version of a software package can be added to a storage device, only one version of a package can be active for any card.
Some packages require the activation or deactivation of other packages.
The package being activated must be compatible with the current active software set.

Activation is performed only after the package compatibility checks and API version compatibility checks have been passed. If a conflict is found, an on-screen error message is displayed.

While a software package is being activated, other requests are not allowed to run on any of the impacted nodes. Package activation is completed when a message similar to this one appears:

Install operation 2 completed successfully at 20:30:29 UTC Mon Nov 14 2005.

Each CLI install request is assigned a request ID, which can be used later to review the events.

Obtaining and Placing Cisco IOS XR Software

This section contains information to locate the available software packages and to transfer them either to a local storage device or to a network server. When this is done, the package or packages can be added and activated on the router .

There are two primary ways to obtain packages in Cisco IOS XR software:

Request the software from Cisco on a flash disk that you can insert into the removable flash disk slot (usually flash disk1:). Flash disk1: is optional. When it is installed, flash disk1: can be used to store PIE files, which can then be used to add new software to the boot device (usually flash disk0:).
Download the Cisco IOS XR software packages to a local storage device of the DSC, such as flash disk1:, or to a remote server, such as a tftp or rcp server.

The boot device is the local disk on the DSC where Cisco IOS XR software is added and activated. PIE files should not be stored on this boot device. The default boot device is disk0:. All PIE files should be stored on flash disk1:.

Transferring Installation Files from a Network File Server to a Local Storage Device

If the Cisco IOS XR software PIE files are located on a remote TFTP, FTP, SFTP, or rcp server, you can copy the files to a local storage device such as disk1:. When the PIE files are located on a local storage device, the software packages can be added and activated on the router from that storage device. Table 1 describes the supported server protocols, and the CLI syntax used copy files from each server type to the local storage device.

Tip

Cisco IOS XR software PIE files can also be added to the router boot device directly from the remote server.

Note

Consult your system administrator for the location and availability of your network server.

Table 4. Download Protocols Supported by Cisco IOS XR Software

Name

Description

Trivial File Transfer Protocol

TFTP allows files to be transferred from one computer to another over a network, usually without the use of client authentication (for example, username and password). It is a simplified version of FTP.

Note

Some Cisco IOS XR software images may be larger than 32 MB, and the TFTP services provided by some vendors 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.

File Transfer Protocol

FTP is part of the TCP/IP protocol stack and requires a username and password.

Remote Copy Protocol

The rcp protocol uses TCP to ensure the reliable delivery of data, and rcp downloads require a usernames.

SSH File Transfer Protocol

SFTP is part of the SSHv2 feature in the Security package and provides for secure file transfers. For more information, see the System Security Configuration Guide for Cisco ASR 9000 Series Routers.

The router commands listed in Table 2 show how to copy package files to the router using three types of file transfer protocols.

Table 5. Commands for Copying Package Files to the Router
Server Type	Command and Examples
TFTP	The following command syntax is used: copy tftp:// `hostname_or_ipaddress` `/` `directory-path` `/` `pie-name` disk1: Example: `RP/0/RSP0/CPU0:router# copy tftp://10.1.1.1/images/comp- asr9k-mini.pie disk1:`
FTP	The following command syntax is used: copy ftp:// `username` `:` `password` @ `hostname_or_ipaddress` `/` `directory-path` `/` `pie-name` disk1: Example: `RP/0/RSP0/CPU0:router# copy ftp://john:secret@10.1.1.1/images/ comp-asr9k-mini.pie disk1:`
rcp	The following command syntax is used: copy rcp:// `username` @ `hostname_or_ipaddress` `/` `directory-path` `/` `pie-name` disk1: Example: `RP/0/RSP0/CPU0:router# copy rcp://john@10.1.1.1/images/ comp-asr9k-mini.pie disk1:`

Table 3 describes the command variables for copying packages from a network server.

Table 6. Command Variables for Copying and Adding Packages from a Network Server

Variable

Description

hostname_or_ipaddress

Host name or IP address of the server that stores the source file.

pie-name

Name of the PIE file (package). See the Overview of Cisco IOS XR Software Packages for descriptions of the available packages.

username

Required for FTP and rcp only and must be a valid username on the FTP or rcp server.

password

Required for FTP only. If a password is not provided, the networking device accepts anonymous FTP.

directory-path

The specified directory should be a directory under the home directory of the user. In the rcp and FTP examples in Table 2, the file being downloaded is in a subdirectory called “images” in the home directory of the user “john.”

Note

For FTP and rcp services, directory-path is the directory relative to the username home directory. If you want to specify an absolute path for the directory, you must add a "/" following the server address.

When the installation files have been transferred to a network file server or the router, you are ready to activate or upgrade the software.

Note

Files with the vm extension are bootable installation files used only to replace all current Cisco IOS XR software. These files are installed from ROM monitor mode and cause significant router downtime. We recommend installing or upgrading software packages using PIE files only, as described in this chapter. See ROM Monitor Configuration Guide for Cisco ASR 9000 Routers for information on installing from vm files.

Preparing for Software Installation Operations

This section includes instructions to prepare for software installation operations.

Note

Activation is performed only after the automatic package compatibility and API version compatibility checks have been passed. If a conflict is found, an on-screen error message is displayed.

Before you begin

Before adding or activating Cisco IOS XR software:

Update the ROM Monitor software, if necessary.
Determine if a software change is required.
Verify that the new package is supported on your system. Some software packages require that other packages or package versions be activated, and some packages only support specific cards.
Review the release notes for important information related to that release and to help determine the package compatibility with your router configuration.
Verify that the system is stable and prepared for the software changes.

SUMMARY STEPS

admin
show diag
Update the ROMMON software if necessary.
show install active
show install pie-info device:package [ brief | detail | verbose ]
verify packages
exit
(Optional) show system verify start
(Optional) show system verify [ detail | report ]
show clock

DETAILED STEPS

Command or Action Purpose

Step 1

admin

Example:


RP/0/RSP0/CPU0:router# admin

Enters administration EXEC mode.

Step 2

show diag

Example:


RP/0/RSP0/CPU0:router(admin)# show diag

Displays the ROMMON software version for all cards in the system. Verify that the correct ROMMON software version is installed before upgrading a Cisco IOS XR software package.

Note

See Related Topics for information regarding the required ROM Monitor (ROMMON) software version.

Step 3

Update the ROMMON software if necessary.

Updates the ROMMON software. For instructions, see ROM Monitor Configuration Guide for Cisco ASR 9000 Routers.

Step 4

show install active

Example:


RP/0/RSP0/CPU0:router(admin)# show install active

Displays the active software on the router for the owner SDR. Use this command to determine what software should be added, upgraded or downgraded on the router, and to compare to the active software report after installation operations are complete.

Note

You can also display the active packages for a specific node, and view results in detailed or summary mode. See the Software Package Management Commands on the Cisco ASR 9000 Series Router module of System Management Command Reference for Cisco ASR 9000 Series Routers for more information.

Step 5

show install pie-info device:package [ brief | detail | verbose ]

Example:


RP/0/RSP0/CPU0:router(admin)# show install pie-info
disk1:/asr9k-mcast-p.pie-3.8.30

Displays information imbedded in the package. The following keywords provide three levels of information:

brief (default)—Displays the expiration date of the file, the size, and the installed package name. The expiration date is used for certifying the package.
detail —Displays the package components, the compatible cards, the expiration date, file size, and the installed package name.
verbose —Displays information from the detail display and sub-component information.

Note

Always review the release notes for the software package for important information related to that release and to help determine the package compatibility with your router configuration.

Step 6

verify packages

Example:


RP/0/RSP0/CPU0:router(admin)# install verify packages

Verifies that there are no corrupted software files. The consistency of a previously installed software set is verified against 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 also checks for corruptions of installation state files and MBI image 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 packages command can take up to two minutes per package to process.

Step 7

exit

Example:


RP/0/RSP0/CPU0:router(admin)# exit

Exits administration EXEC mode and returns to EXEC mode.

Step 8

(Optional) show system verify start

Example:


RP/0/RSP0/CPU0:router# show system verify start

(Optional)

Starts the system status check.

Step 9

(Optional) show system verify [ detail | report ]

Example:


RP/0/RSP0/CPU0:router# show system verify

(Optional)

Displays system status information. A variety of information is displayed including the memory and CPU usage, process status, protocol status, and other status information. Use this information to verify that the system is stable.

detail —Displays additional information at the card and processor level, including actual numbers.
report —Displays the same information as the default show system verify command

Note

Although most of the output should display the status “OK,” some processes may show other output, such as “Warning.” This does not specifically indicate a problem. Contact your Cisco technical support representative for more information on the output of this command.

Step 10

show clock

Example:


RP/0/RSP0/CPU0:router# show clock

Verifies that the system clock is correct. Software operations use certificates based on router clock times.

Examples

Verifying That the ROM Monitor Version Is Correct: Example

In the following example, the ROM Monitor software version is displayed in the “ROMMON:” field for each card.

Note

For instructions to upgrade the ROM Monitor software, see ROM Monitor Configuration Guide for Cisco ASR 9000 Routers.


RP/0/RSP0/CPU0:router# admin
RP/0/RSP0/CPU0:router(admin)# show diag

Mon Jun 22 12:55:10.554 PST

NODE module 0/RSP0/CPU0 : 

  MAIN:  board type 0x100302
  S/N:   FOC1230803H
  Top Assy. Number:   68-3160-04
  PID:   A2K-RSP-4G-HDD=
  UDI_VID:   VP4
  HwRev: V4.8
  New Deviation Number: 0
  CLEI:  IPUCARJBAA
  Board State : IOS XR RUN
  PLD:    Motherboard: N/A, Processor: 0x8004 (rev: 2.2), Power: N/A
  MONLIB: QNXFFS Monlib Version 3.2
  ROMMON: Version 1.0(20081208:173612) [ASR9K ROMMON]
  Board FPGA/CPLD/ASIC Hardware Revision:
    Compact Flash : V1.0
     XbarSwitch0  : V1.3
     XbarSwitch1  : V1.3
     XbarArbiter  : V1.0
     XbarInterface  : V0.0
     IntCtrl  : V1.14
     ClkCtrl  : V1.13
     PuntFPGA  : V1.5
     HD  : V3.0
     USB0  : V77.20
     USB1  : V77.20
     CPUCtrl  : V1.17
     UTI  : V1.6
     LIU  : V1.0
     MLANSwitch  : V0.0
     EOBCSwitch  : V2.0
     CBC (active partition)  : v1.2
     CBC (inactive partition)  : v1.1

NODE fantray 0/FT0/SP : 

  MAIN:  board type 0x900211
  S/N:   
  Top Assy. Number:   32-0000-00
  PID:   
  UDI_VID:   
  HwRev: V32.0
  New Deviation Number: 0
  CLEI:  
  PLD:    Motherboard: N/A, Processor: N/A, Power: N/A
  ROMMON: 
  Board FPGA/CPLD/ASIC Hardware Revision:
     CBC (active partition)  : v4.0
     CBC (inactive partition)  : v0.13

NODE fantray 0/FT1/SP : 

  MAIN:  board type 0x900211
  S/N:   
  Top Assy. Number:   32-0000-00
  PID:   
  UDI_VID:   
  HwRev: V32.0
  New Deviation Number: 0
  CLEI:  
  PLD:    Motherboard: N/A, Processor: N/A, Power: N/A
  ROMMON: 
  Board FPGA/CPLD/ASIC Hardware Revision:
     CBC (active partition)  : v4.0
     CBC (inactive partition)  : v0.13

NODE module 0/1/CPU0 :  

   MAIN:  board type 0x20207
  S/N:   FOC123081J6
  Top Assy. Number:   68-3182-03
  PID:   A9K-40GE-B
  UDI_VID:   V1D
  HwRev: V0.0
  New Deviation Number: 0
  CLEI:   
  Board State : IOS XR RUN
  PLD:    Motherboard: N/A, Processor: 0x8004 (rev: 2.2), Power: N/A
  ROMMON: Version 1.0(20081208:174521) [ASR9K ROMMON]
  Board FPGA/CPLD/ASIC Hardware Revision:
     NP0  : V3.194
     NP1  : V3.194
     NP2  : V3.194
     NP3  : V3.194
     XbarInterface  : V18.4
     Bridge0  : V0.38
     Bridge1  : V0.38
     CPUCtrl  : V0.15
     USB  : V77.20
     PortCtrl  : V0.8
     PHYCtrl  : V0.6
     40 Port Gigabit Ethernet Daughter board  : V0.0
     CBC (active partition)  : v2.2
     CBC (inactive partition)  : v2.1

NODE module 0/4/CPU0 :  

  MAIN:  board type 0x2020a
  S/N:   FOC123081JA
  Top Assy. Number:   68-3183-02
  PID:   A9K-8T/4-B
  UDI_VID:   V1D
  HwRev: V0.0
  New Deviation Number: 0
  CLEI:  IPU3AE0CAA
  Board State : IOS XR RUN
  PLD:    Motherboard: N/A, Processor: 0x8004 (rev: 2.2), Power: N/A
  ROMMON: Version 1.0(20081208:174521) [ASR9K ROMMON]
  Board FPGA/CPLD/ASIC Hardware Revision:
     NP0  : V3.194
     NP1  : V3.194
     NP2  : V3.194
     NP3  : V3.194
     XbarInterface  : V18.4
     Bridge0  : V0.38
     Bridge1  : V0.38
     CPUCtrl  : V0.15
     USB  : V77.20
     PortCtrl  : V0.10
     PHYCtrl  : V0.7
     PHY0  : V0.16
     PHY1  : V0.16
     PHY2  : V0.16
     PHY3  : V0.16
     PHY4  : V0.16
     PHY5  : V0.16
     PHY6  : V0.16
     PHY7  : V0.16
     8 Port Ten Gigabit Ethernet Daughter board  : V0.0
     CBC (active partition)  : v2.2
     CBC (inactive partition)  : v2.1

NODE module 0/6/CPU0 :  

  MAIN:  board type 0x20208
  S/N:   FHH12250033
  Top Assy. Number:   68-3184-02
  PID:   A9K-4T-B
  UDI_VID:   V1D
  HwRev: V0.0
  New Deviation Number: 0
  CLEI:   
  Board State : IOS XR RUN
  PLD:    Motherboard: N/A, Processor: 0x8004 (rev: 2.2), Power: N/A
  ROMMON: Version 1.0(20081208:174521) [ASR9K ROMMON]
  Board FPGA/CPLD/ASIC Hardware Revision:
     NP0  : V3.194
     NP1  : V3.194
     NP2  : V3.194
     NP3  : V3.194
     XbarInterface  : V18.4
     Bridge0  : V0.38
     Bridge1  : V0.38
     CPUCtrl  : V0.15
     USB  : V77.20
     PHY0  : V0.16
     PHY1  : V0.16
     PHY2  : V0.16
     PHY3  : V0.16
     PortCtrl  : V0.10
      PHYCtrl  : V0.7
     4 Port Ten Gigabit Ethernet Daughter board  : V0.0
     CBC (active partition)  : v2.2
     CBC (inactive partition)  : v2.1

NODE power-module 0/PM0/SP : 

  MAIN:  board type 0xf00188
  S/N:   
  Top Assy. Number:   341-00032-01
  PID:   A9K-3KW-AC
  UDI_VID:   V00
  HwRev: V0.0
  New Deviation Number: 0
  CLEI:  ACACACACAC
  PLD:    Motherboard: N/A, Processor: N/A, Power: N/A
  ROMMON: 
  Board FPGA/CPLD/ASIC Hardware Revision:

NODE power-module 0/PM1/SP : 

  MAIN:  board type 0xf00188
  S/N:   
  Top Assy. Number:   341-00032-01
  PID:   A9K-3KW-AC
  UDI_VID:   V00
  HwRev: V0.0
  New Deviation Number: 0
  CLEI:  ACACACACAC
  PLD:    Motherboard: N/A, Processor: N/A, Power: N/A
  ROMMON: 
  Board FPGA/CPLD/ASIC Hardware Revision:

NODE power-module 0/PM2/SP : 

  MAIN:  board type 0xf00188
  S/N:   
  Top Assy. Number:   341-00032-01
  PID:   A9K-3KW-AC
  UDI_VID:   V00
  HwRev: V0.0
  New Deviation Number: 0
  CLEI:  ACACACACAC
  PLD:    Motherboard: N/A, Processor: N/A, Power: N/A
  ROMMON: 
  Board FPGA/CPLD/ASIC Hardware Revision:

Rack 0 - ASR-9010 Chassis, Includes Accessories
  RACK NUM: 0
  S/N:   
  PID:   ASR-9010 Backplane
  VID:   0.1
  Desc:  ASR-9010 Chassis, Includes Accessories
  CLEI:  NOCLEI
  Top Assy. Number:   68-1234-56

Displaying the Active Software for the Entire System: Example

The following example displays the active packages for the entire system. Use this information to determine if a software change is required:


RP/0/RSP0/CPU0:router(admin)# show install active summary

Mon Jun 22 13:01:46.438 PST
Default Profile:
  SDRs:
    Owner
  Active Packages:
    disk0:comp-asr9k-mini-3.9.0.12I
    disk0:asr9k-fpd-3.9.0.12I
    disk0:asr9k-k9sec-3.9.0.12I
    disk0:asr9k-mcast-3.9.0.12I
    disk0:asr9k-mgbl-3.9.0.12I
    disk0:asr9k-mpls-3.9.0.12I

Displaying Information About the Contents of a PIE File: Example

In the following example, information is displayed about the manageability PIE. This command displays the expiry date of the package, the cards supported by the package, and other details. Use this information to verify the compatibility of the package with your system and other software packages.

Note

A software activation is performed only after the automatic package compatibility and API version compatibility checks have been passed. If a conflict is found, an on-screen error message is displayed.


RP/0/RSP0/CPU0:router(admin)# show install pie-info disk1:/
asr9k-mgbl-p.pie-3.8.0 detail         

Contents of pie file '/disk1:/asr9k-mgbl-p.pie-3.8.0':
    Expiry date       : Jan 19, 2007 02:55:56 UTC
    Uncompressed size : 17892613

    asr9k-mgbl-3.8.0
        asr9k-mgbl V3.8.0[00]  Manageability Package
        Vendor : Cisco Systems
        Desc   : Manageability Package
        Build  : Built on Wed May 10 08:04:58 UTC 2006
        Source : By edde-bld1 in /vws/aga/production/3.8.0/asr9k/workspace for c28
        Card(s): RP, DRP, DRPSC
        Restart information:
          Default:
            parallel impacted processes restart
        Components in package asr9k-mgbl-3.8.0, package  asr9k-mgbl:
            manageability-cwi V[r33x/2]  Craft Web Interface related binaries ae
            asr9k-feature-ipsla V[r33x/1]  IPSLA time stamping feature
            doc-asr9k-mgbl V[r33x/2]  Contains the man page documentation for asr9ks
 --More--

Verifying That There Are No Corrupted Software Files: Example

The following sample output verifies the consistency of the currently active software against the file from which it originated:


RP/0/RSP0/CPU0:router(admin)# install verify packages

Mon Jun 22 13:19:08.590 PST
Install operation 3 '(admin) install verify packages' started by user 'user'
via CLI at 13:19:08 DST Mon Jun 22 2009.
The install operation will continue asynchronously.
RP/0/RSP0/CPU0:router(admin)#Info:     
This operation can take up to 2 minutes per package being verified.
Info:     Please be patient.

Info:     0/6/CPU0 [LC] [SDR: Owner]
Info:         meta-data: [SUCCESS] Verification Successful.
Info:         /install/asr9k-scfclient-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-os-mbi-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-mpls-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-mcast-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-lc-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-fwdg-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-fpd-3.9.0.12I: [ERROR] Detected anomalies.
Info:         /install/asr9k-diags-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-base-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-admin-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:     0/1/CPU0 [LC] [SDR: Owner]
Info:         meta-data: [SUCCESS] Verification Successful.
Info:         /install/asr9k-scfclient-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-os-mbi-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-mpls-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-mcast-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-lc-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-fwdg-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-fpd-3.9.0.12I: [ERROR] Detected anomalies.
Info:         /install/asr9k-diags-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-base-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-admin-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:     0/4/CPU0 [LC] [SDR: Owner]
Info:         meta-data: [SUCCESS] Verification Successful.
Info:         /install/asr9k-scfclient-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-os-mbi-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-mpls-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-mcast-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-lc-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-fwdg-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-fpd-3.9.0.12I: [ERROR] Detected anomalies.
Info:         /install/asr9k-diags-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-base-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-admin-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:     0/RSP0/CPU0 [RP] [SDR: Owner]
Info:         meta-data: [SUCCESS] Verification Successful.
Info:         /install/asr9k-fpd-3.9.0.12I: [ERROR] Detected anomalies.
Info:         /install/asr9k-mpls-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-mgbl-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-mcast-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-k9sec-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-os-mbi-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-base-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-admin-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-fwdg-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-lc-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-rout-3.9.0.12I: [SUCCESS] Verification Successful.
Info:         /install/asr9k-diags-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:         /install/asr9k-scfclient-3.9.0.12I: [SUCCESS] Verification
Info:     Successful.
Info:     Verification Summary:
Info:         0/6/CPU0: ERROR. Anomalies found.
Info:         0/1/CPU0: ERROR. Anomalies found.
Info:         0/4/CPU0: ERROR. Anomalies found.
Info:         0/RSP0/CPU0: ERROR. Anomalies found.
Info:         Anomalies found on the primary RP.
Info:         No standby RP is present.
Info:         Please contact your technical services representative to repair
Info:     the system.
Install operation 3 completed successfully at 13:21:29 DST Mon Jun 22 2009.

Verifying the Current System Status: Example

The following example shows how to prepare for system verification:


RP/0/RSP0/CPU0:router# show system verify start
  
  Storing initial router status ...
  done.

The following example shows output from running the show system verify command.

Note


RP/0/RSP0/CPU0:router# show system verify 
  
  Getting current router status ... 
  System Verification Report
  ==========================
  - Verifying Memory Usage
  - Verified Memory Usage                                 : [OK]     
  - Verifying CPU Usage
  - Verified CPU Usage                                    : [OK]     
  
  - Verifying Blocked Processes
  - Verified Blocked Processes                            : [OK]     
  - Verifying Aborted Processes
  - Verified Aborted Processes                            : [OK]     
  - Verifying Crashed Processes
  - Verified Crashed Processes                            : [OK]     
  
  - Verifying LC Status
  - Verified LC Status                                    : [OK]     
  - Verifying QNET Status
  Unable to get current LC status info
  - Verified QNET Status                                  : [FAIL]   
  
  - Verifying GSP Fabric Status
  - Verified GSP Fabric Status                            : [OK]     
  - Verifying GSP Ethernet Status
    gsp WARNING messages for router 
    Current set of gsp ping nodes does not match initial set of nodes
  - Verified GSP Ethernet Status                          : [WARNING]
  
  - Verifying POS interface Status
  - Verified POS interface Status                         : [OK]     
  - Verifying TenGigE interface Status
  - Verified TenGigE interface Status                     : [OK]     
  
  - Verifying TCP statistics
  - Verified TCP statistics                               : [OK]     
  - Verifying UDP statistics
    tcp_udp_raw WARNING messages for router 
    UDP Packets sent has not increased during this period.
  - Verified UDP statistics                               : [WARNING]
  - Verifying RAW statistics
  - Verified RAW statistics                               : [OK]     
  
  - Verifying RIB Status
  - Verified RIB Status                                   : [OK]     
  - Verifying CEF Status
  - Verified CEF Status                                   : [OK]     
  - Verifying CEF Consistency Status
  - Verified CEF Consistency Status                       : [OK]     
  - Verifying BGP Status
  - Verified BGP Status                                   : [OK]     
  - Verifying ISIS Status
  - Verified ISIS Status                                  : [OK]     
  - Verifying OSPF Status
  - Verified OSPF Status                                  : [OK]     
  
  - Verifying Syslog Messages
  - Verified Syslog Messages                              : [OK]     
  
  System may not be stable. Please look into WARNING messages.

Verifying That the System Clock Is Correct: Example

The following example displays the current system clock setting:


RP/0/RSP0/CPU0:router# show clock 
  
02:14:51.474 PST Wed Jan 28 2009

Adding and Activating Packages

The procedure in this section describes how to upgrade or add Cisco IOS XR software PIE files that are stored on a local storage device, such as a flash disk, or on a remote TFTP, FTP, SFTP, or rcp server. The PIE software file can include any of the following:

The Cisco IOS XR Unicast Routing Core Bundle (six packages in one composite PIE file)
Any of the optional packages (one package per PIE file)
Software maintenance upgrades (SMUs)

When you need to add and activate two or more of the preceding package types, you should add and activate them in the order listed above.

Note

When adding and activating two or more packages, optional packages can be activated together. Also, if the operation is a reload, multiple packages can be activated together. For example, five reload SMUs can be activated together or the Cisco IOS XR Unicast Routing Core Bundle plus the SMUs and optional packages can be activated together.

For a description of the software management process, see the Related Topics section.

These instructions are also used to downgrade software packages.

Note

By default, installation operations are performed asynchronously: the CLI prompt is returned before the operation is complete, allowing the operator to continue work while the installation is completed in the background. Use the synchronous keyword at the end of install commands to delay the return of the CLI prompt until an installation operation is complete. See the Related Topics section for more information.

Before you begin

Before upgrading or adding packages, verify that these prerequisites have been met:

Verify that the ROMMON version is correct. For instructions on upgrading ROM Monitor, see ROM Monitor Configuration Guide for Cisco ASR 9000 Routers.
All packages to be upgraded or added are present on a local storage device (for example a flash disk), or a network file server.
Prerequisites for the activation of packages are met as described in the Prerequisites section.
Complete the procedures described in the Preparing for Software Installation Operations section.

Note

To use the automatic FPD upgrade feature, the fpd auto-upgrade command must be enabled in administration configuration mode.

SUMMARY STEPS

Connect to the console port and log in.
(Optional) dir flash-disk :
admin
install add [source source-path | tar] file [activate ]
(Optional) show install inactive summary
install activate {id add-id | device package} [test] [location node-id] [pause sw-change] [prompt-level {all | none}] [auto-abort-timer {time | off}]
Repeat 4 through 6 until all packages are activated.
(Optional) show install active summary
(Optional) install verify packages
(Optional) exit
(Optional) show system verify start
admin
(Optional) install commit
Upgrade the field-programmable device (FPD) software, if necessary.

DETAILED STEPS

Command or Action Purpose

Step 1

Connect to the console port and log in.

Establishes a CLI management session with the SDR. Connect to the console port for the active DSC.

For more information on console connections, see Cisco ASR 9000 Series Aggregation Services Router Getting Started Guide.

Step 2

(Optional) dir flash-disk :

Example:


RP/0/RSP0/CPU0:router# dir disk1:

(Optional)

Displays the package files that are available for package upgrades and additions.

Note

Only PIE files can be added and activated using this procedure.

Step 3

admin

Example:


RP/0/RSP0/CPU0:router# admin

Enters administration EXEC mode.

Note

Some show install commands can be entered in EXEC mode on an SDR.

Step 4

install add [source source-path | tar] file [activate ]

Example:


RP/0/RSP0/CPU0:router(admin)# install add 
disk1:/asr9k-mgbl-px.pie-6.0.1


RP/0/RSP0/CPU0:router(admin)# install add source 
  tftp://10.1.1.1/images/ asr9k-k9sec-p.pie 
  asr9k-mpls-p.pie asr9k-mcast-p.pie


RP/0/RSP0/CPU0:router(admin)# install add 
  ftp://john:secret@10.1.1.1/images/asr9k-k9sec-p.pie


RP/0/RSP0/CPU0:router(admin)# install add tar 
  rcp://john@10.1.1.1/images/asr9k-iosxr-3.6.0.tar

Unpacks a PIE file from local storage device or network server and adds the package files to the boot device of the router. The boot device is located on the DSC.

If the source keyword is used, the source-path specifies the directory path that is used for multiple filenames in the same directory.
If the tar keyword is used, all PIE files contained in the tar file are unpacked.

The file argument can take any of these formats:

device filename
tftp://hostname_or_ipaddress /directory-path /filename
ftp:// username:password@hostname_or_ipaddress /directory-path/filename
rcp://username@hostname_or_ipaddress/ directory-path/filename

These are descriptions for each of the terms used here:

device —Name of the local storage device where the PIE file is stored, such as disk1:/.
filename —Name of the PIE file you want to add. If the tar keyword is used, the file argument is the name of a tar file containing one or more PIE files, or directories containing PIE files.
tftp:// —Unpacks the PIE file from a network server using Trivial File Transfer Protocol.
ftp:// —Unpacks the PIE file from a network server using File Transfer Protocol.
rcp:// —Unpacks the PIE file from a network server using Remote Copy Protocol
hostname_or_ipaddress —Host name or IP address of the network file server.
directory-path —Network file server path that leads to the PIE file to be added.
username —Username of user that has access privileges to the directory in which the PIE file is stored.
password —Password associated with the username of user that has access privileges to the directory in which the PIE file is stored.
activate —Automatically activates the software package after it is successfully added.

Note

Multiple versions of a software package can be added to the storage device without impacting the running configuration, but only one version of a package can be activated for a card.

Tip

The automatic FPD upgrade occurs only when the FPD pie is added and activated together with the install PIE.

Step 5

(Optional) show install inactive summary

Example:


RP/0/RSP0/CPU0:router(admin)# show install inactive summary

(Optional)

Displays the inactive packages on the router. Verify that the package added in the previous step appears in the display.

Step 6

install activate {id add-id | device package} [test] [location node-id] [pause sw-change] [prompt-level {all | none}] [auto-abort-timer {time | off}]

Example:

RP/0/RSP0/CPU0:router(admin)# install activate
  disk0:asr9k-mini-px-4.3.99

Activates a package that was added to the router. (Skip this step if the package was activated earlier with the install add command.)

id add-id —Specifies the package using the operation ID of the install add operation in which you added the package. The operation ID is provided in the output of the install add command. You can also use show install log to display installation operation IDs.

device:package —Specifies the package by name. Replace the device:package argument with the name of the boot device and inactive package, which can be displayed as described in the previous step.

Note

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.

location node-id —Activates a package for a specific card (node). To display a list of node IDs for the entire system, enter the show platform command in administration EXEC mode. A package cannot be activated on a single node unless some version of the package being activated is already active on all nodes.

Note

By default, packages are activated for all cards supported by that package.

pause sw-change —Pauses the operation after preparatory checks and before the configuration is locked for the actual activation. This action enables you to hold the operation while you perform configuration changes, and proceed with the activation whenever you choose. This operation is useful, for example, if your workflow involves configuring a router out of the network during software installation and you want to minimize the time that the router is out of the network. Follow onscreen instructions to control the pausing and completion of the operation.
prompt-level —Use a prompt-level of all to view all stages of the installation process and to specify whether to continue, or not.
auto-abort-timer —Specifies an abort timer value, in minutes, which when expired loads the last committed loadpath. The default is 60. The timer is enabled by default. After the installation, if the activated software is working correctly, use the install commit command to cancel the timer and commit the new loadpath.

Note

The package being activated must be compatible with the currently active software to operate. When an activation is attempted, the system runs an automatic compatibility check to ensure that the package is compatible with the other active software on the router. The activation is permitted only after all compatibility checks have been passed.

Tip

When activating packages, use the test option to test the effects of a command without impacting the running system. After the activation process finishes, enter the show install log command to display the process results.

Tip

The automatic FPD upgrade occurs only when the FPD pie is added and activated together with the install PIE.

Step 7

Repeat 4 through 6 until all packages are activated.

Activates additional packages as required.

Step 8

(Optional) show install active summary

Example:


RP/0/RSP0/CPU0:router(admin)# show install active

(Optional)

Displays all active packages. Use this display to determine if the correct packages are active:

Step 9

(Optional) install verify packages

Example:


RP/0/RSP0/CPU0:router(admin)# install verify packages

(Optional)

Verifies the consistency of a 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 whether there are any corrupted files. This command also checks for corruptions of installation state files and MBI image 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 packages command can take up to two minutes for each package to process.

Step 10

(Optional) exit

Example:


RP/0/RSP0/CPU0:router(admin)# exit

(Optional)

Exits administration EXEC mode and returns to EXEC mode.

Step 11

(Optional) show system verify start

Example:


RP/0/RSP0/CPU0:router# show system verify start

(Optional)

Starts the system status check.

Step 12

admin

Example:


RP/0/RSP0/CPU0:router# admin

Enters administration EXEC mode.

Step 13

(Optional) install commit

Example:


RP/0/RSP0/CPU0:router# dir disk1:


RP/0/RSP0/CPU0:router(admin)# install commit

(Optional)

Commits the current set of packages on the router so that these packages are used if the router is restarted.

For more information, see the Related Topics section.

Step 14

Upgrade the field-programmable device (FPD) software, if necessary.

Whenever a Cisco IOS XR software image that supports SPAs and SIPs is released, a companion SPA or SIP FPD image is bundled with the Cisco IOS XR software release. Generally, the FPD image is not automatically upgraded. You must manually upgrade the FPD image running on the SPA or SIP when you upgrade the Cisco IOS XR software image. FPD versions must be compatible with the Cisco IOS XR software that is running on the router.

Note

If you have enabled the fpd auto-upgrade command and add and activate the FPD PIE together with the software installation PIE, the FPD image is automatically upgraded before the router is rebooted.

For information on FPDs, including instructions to upgrade FPD images, see the Upgrading FPD Cisco IOS XR Software section.

Examples

Adding a Package: Example

The following example shows how to add the contents of a PIE file on disk1: to the boot device. Because the software package is added to the boot device by default, it is not necessary to specify the destination device in the CLI.

Note

From Cisco IOS XR Software Release 6.0.1 and later, you must append a forward slash ('/') to the source location (for example, disk1:/ ) of the PIE file in the install add command.


RP/0/RSP0/CPU0:router(admin)# install add disk1:/asr9k-mpls-px.pie-6.0.1 synchronous 
  
Install operation 4 'install add /disk1:/asr9k-mpls.pie-mpls-px.pie-6.0.1 synchronous' started by user
'cisco' at 18:10:18 UTC Sat Apr 08 2009.
Info:     The following package is now available to be activated:
Info:      
Info:         disk0:asr9k-mpls-px.pie-6.0.1
Info:      
Install operation 4 completed successfully at 18:14:11 UTC Sat Apr 08 2009.

The following example shows how to add the contents of a PIE file on a TFTP server to the boot device:


RP/0/RSP0/CPU0:router(admin)# install add tftp://209.165.201.1/
asr9k-mpls.pie synchronous 
  
Install operation 4 '(admin) install add /tftp://209.165.201.1/asr9k-mpls.pie synchronous' 
  started by user 'cisco' at 18:16:18 UTC Thu Jan 03 2009.
Info:     The following package is now available to be activated:
Info:      
Info:         disk0:asr9k-mpls-3.7.2
Info:      
Install operation 4 completed successfully at 18:19:10 UTC Thu Jan 03 2009.

Activating a Package: Example

The following example shows the activation of the MPLS package. The package is activated on the boot device disk0:.


RP/0/RSP0/CPU0:router(admin)# install activate disk0:
asr9k-mpls-3.7.2 synchronous
  
Install operation 15 'install activate disk0:asr9k-mpls-3.7.2 synchronous'
started by user 'lab' at 19:15:33 UTC Sat Apr 08 2009.
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:
Info:         show system verify
Info:         install verify packages
Install operation 5 completed successfully at 19:16:18 UTC Sat Apr 08 2009.

Activating a Package by Specifying an Operation ID: Example

The following example shows the activation of the MPLS package using the operation ID of the install add operation that added the package:


RP/0/RSP0/CPU0:router(admin)# install activate id 4
  
Install operation 5 '(admin) install activate id 4' started by user 'lab' via
CLI at 18:20:17 UTC Thu Jan 03 2009.
Info:     This operation will activate the following package:
Info:         disk0:asr9k-mpls-3.7.2
Info:     Install Method: Parallel Process Restart
The install operation will continue asynchronously.
Info:     The changes made to software configurations will not be persistent
Info:     across system reloads. Use the command '(admin) install commit' to
Info:     make changes persistent.
Info:     Please verify that the system is consistent following the software
Info:     change using the following commands:
Info:         show system verify
Info:         install verify packages
Install operation 5 completed successfully at 18:21:30 UTC Thu Jan 03 2009.

Adding and Activating a Package from an FTP File Server with One Command: Example

To add and activate a package with a single command, enter the install add command with the activate keyword. In the following example, the Manageability PIE located on disk1: is verified, unpacked, and added to the boot device disk0. Because this operation is performed in administration EXEC mode, the package is activated for all SDRs in the system.


RP/0/RSP0/CPU0:router(admin)# install add disk1:/
asr9k-mgbl-px.pie-6.0.1 activate
  
Install operation 4 'install add /disk1:/asr9k-mgbl-px.pie-6.0.1 activate' started
by user 'cisco' at 07:58:56 UTC Wed Mar 01 2009.
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:      
Info:         disk0:asr9k-mgbl-px.pie-6.0.1
Info:      
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:
Info:         show system verify
Info:         install verify packages
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 2009.

Displaying the Active Packages: Example

The following example displays a summary of the active packages on a router. Because this operation is performed in administration EXEC mode, the active packages for all SDRs are displayed.


RP/0/RSP0/CPU0:router(admin)# show install active summary
Mon Jun 22 23:41:19.509 PST
Default Profile:
  SDRs:
    Owner
  Active Packages:
    disk0:comp-asr9k-mini-3.9.0.12I
    disk0:asr9k-fpd-3.9.0.12I
    disk0:asr9k-k9sec-3.9.0.12I
    disk0:asr9k-mcast-3.9.0.12I
    disk0:asr9k-mgbl-3.9.0.12I
    disk0:asr9k-mpls-3.9.0.12I

Committing the Active Package Set

When a package is activated, it becomes part of the current running configuration. To make the package activation persistent across system-wide reloads, enter the install commit command. On startup, DSC of the owner SDR loads this committed software set. If the system is reloaded before the current active software is committed with the install commit command, the previously committed software set is used.

If the system is reloaded before the current active software is committed with the install commit command, the previously committed software set is used.

Tip

Before committing a package set, verify that the SDR is operating correctly and is forwarding packets as expected.

SUMMARY STEPS

admin
install commit
show install committed [detail | summary | verbose] [location node-id]

DETAILED STEPS

Command or Action Purpose

Step 1

admin

Example:


RP/0/RSP0/CPU0:router# admin

Enters administration EXEC mode.

Step 2

install commit

Example:


RP/0/RSP0/CPU0:router(admin)# install commit

Commits the current set of packages on the router so that these packages are used if the router is restarted.

Step 3

show install committed [detail | summary | verbose] [location node-id]

Example:


RP/0/RSP0/CPU0:router(admin)# show install committed

Displays which packages are committed.

Examples

Committing the Active Package Set: Example

In the following example, the active software packages are committed on the router:


RP/0/RSP0/CPU0:router(admin)# install commit
  
Install operation 16 'install commit' started by user 'lab' at 19:18:58 UTC
Sat Apr 08 2009.
Install operation 16 completed successfully at 19:19:01 UTC Sat Apr 08 2009.

Displaying the Committed Package Versions: Example

In the following example, the committed packages are shown for the owner SDR:


RP/0/RSP0/CPU0:router(admin)# show install committed 

Tue Jun 23 05:11:29.968 PST
Secure Domain Router: Owner

  Node 0/RSP0/CPU0 [RP] [SDR: Owner]
    Boot Device: disk0:
    Boot Image: /disk0/asr9k-os-mbi-3.9.0.12I/mbiasr9k-rp.vm
    Committed Packages: 
      disk0:comp-asr9k-mini-3.9.0.12I
      disk0:asr9k-fpd-3.9.0.12I
      disk0:asr9k-k9sec-3.9.0.12I
      disk0:asr9k-mcast-3.9.0.12I
      disk0:asr9k-mgbl-3.9.0.12I
      disk0:asr9k-mpls-3.9.0.12I

  Node 0/1/CPU0 [LC] [SDR: Owner]
    Boot Device: mem:
    Boot Image: /disk0/asr9k-os-mbi-3.9.0.12I/lc/mbiasr9k-lc.vm
    Committed Packages: 
      disk0:comp-asr9k-mini-3.9.0.12I
      disk0:asr9k-fpd-3.9.0.12I
      disk0:asr9k-mcast-3.9.0.12I
      disk0:asr9k-mpls-3.9.0.12I

  Node 0/4/CPU0 [LC] [SDR: Owner]
    Boot Device: mem:
    Boot Image: /disk0/asr9k-os-mbi-3.9.0.12I/lc/mbiasr9k-lc.vm
    Committed Packages: 
      disk0:comp-asr9k-mini-3.9.0.12I
      disk0:asr9k-fpd-3.9.0.12I
      disk0:asr9k-mcast-3.9.0.12I
      disk0:asr9k-mpls-3.9.0.12I

  Node 0/6/CPU0 [LC] [SDR: Owner]
    Boot Device: mem:
    Boot Image: /disk0/asr9k-os-mbi-3.9.0.12I/lc/mbiasr9k-lc.vm
    Committed Packages: 
      disk0:comp-asr9k-mini-3.9.0.12I
      disk0:asr9k-fpd-3.9.0.12I
      disk0:asr9k-mcast-3.9.0.12I
      disk0:asr9k-mpls-3.9.0.12I

As with the show install active command, the show install committed command may display a composite package that represents all packages in the Cisco IOS XR Unicast Routing Core Bundle.

Upgrading to Cisco IOS XR Software Release 4.0

In Cisco IOS XR Software Release 4.0, the software packages were reorganized into functionally well-defined and independently-releasable packages. For this reason, when you upgrade from a software release prior to Release 4.0, you must perform the following procedure in order to synchronize all of the software packages according to the reorganized structure. General information regarding the the addition and activation of software packages is not covered in this procedure.

The main difference between the standard upgrade procedure and the procedure required to upgrade from Release 3.x to 4.x is that the later requires the addition of one additional software package, known as the upgrade package (asr9k-upgrade-p.pie).

Before you begin

Before performing this procedure, see the adding and activating software package procedures described in this module.

SUMMARY STEPS

admin
install add tftp:// hostname_or_ipaddress / directory-path / mandatory-bundle-pie
install add tftp:// hostname_or_ipaddress / directory-path / asr9k -upgrade-p.pie
install activate device:mandatory-bundle-pie device:upgrade-package
install deactivate device:upgrade-package
(Optional) install commit
install remove device:upgrade-package

DETAILED STEPS

Command or Action Purpose

Step 1

admin

Example:


RP/0/RSP0/CPU0:router# admin

Enters administration EXEC mode.

Step 2

install add tftp:// hostname_or_ipaddress / directory-path / mandatory-bundle-pie

Example:


RP/0/RSP0/CPU0:router(admin)# install add 
tftp://10.1.1.1/auto/tftpboot/usr/400/asr9k-mini-p.pie

Unpacks the mandatory bundle PIE file from a network server and adds the package file to the boot device of the router.

Note

Refer to the standard procedure to add and activate packages to see other options of PIE file locations and a description of the various arguments for the install add command.

Step 3

install add tftp:// hostname_or_ipaddress / directory-path / asr9k -upgrade-p.pie

Example:


RP/0/RSP0/CPU0:router(admin)# install add 
tftp://10.1.1.1/auto/tftpboot/usr/400/asr9k-upgrade-p.pie

Unpacks the upgrade PIE file from a network server and adds the package file to the boot device of the router.

Step 4

install activate device:mandatory-bundle-pie device:upgrade-package

Example:


RP/0/RSP0/CPU0:router(admin)# install activate
disk0:asr9k-mini-p-4.0.0 disk0:asr9k-upgrade-p-4.0.0

Activates the package that was added to the router together with the upgrade package.

Note

The bundle of mandatory packages and the upgrade bundle are activated together to perform the successful upgrade from release 3.x to 4.x.

Step 5

install deactivate device:upgrade-package

Example:


RP/0/RSP0/CPU0:router(admin)# install deactivate
disk0:asr9k-upgrade-p-4.0.0

Deactivates the upgrade package on the router . For specific information regarding the deactivation and removal of software packages, refer to the general procedure.

Step 6

(Optional) install commit

Example:


RP/0/RSP0/CPU0:router(admin)# install commit

(Optional)

Commits the current set of packages so that these packages are used if the router is restarted. Packages can be removed only if the deactivation operation is committed.

Step 7

install remove device:upgrade-package

Example:


RP/0/RSP0/CPU0:router(admin)# install remove
disk0:asr9k-upgrade-p-4.0.0

Removes the inactive upgrade package.

Example

The following example illustrates the upgrade operation:


RP/0/RSP0/CPU0:router(admin)# install add /tftp://223.255.254.254/auto/tftpboot/users/user/
asr9k-mini-p.pie

Fri Jul  9 03:53:11.052 UTCRP/0/RP1/CPU0:Jul  9 03:53:12.053 : 
instdir[235]: %INSTALL-INSTMGR-6-INSTALL_OPERATION_STARTED : 
Install operation 4 '(admin) install add 
/tftp://223.255.254.254/auto/tftpboot/users/user/asr9k-mini-p.pie' 
started by user 'lab'
Install operation 4 '(admin) install add 
/tftp://223.255.254.254/auto/tftpboot/users/user/asr9k-mini-p.pie' 
started by user 'lab' via CLI at 03:53:12 UTC Fri Jul 09 2010.
The install operation will continue asynchronously.
RP/0/RSP0/CPU0:router(admin)# 
Info:    The following package is now available to be activated:
Info:    disk0:asr9k-mini-p-4.0.0     
Info:    The package can be activated across the entire router.
Info:    RP/0/RP1/CPU0:Jul  9 04:32:26.152 : instdir[235]: %INSTALL-INSTMGR-6-INSTALL_OPERATION_COMPLETED_SUCCESSFULLY : 
Info:    Install operation 4 completed successfully 
Info:    Install operation 4 completed successfully at 04:32:26 UTC Fri Jul 09 2010.
RP/0/RSP0/CPU0:router(admin)# install add /tftp://223.255.254.254/auto/tftpboot/users/user/
asr9k-mpls-p.pie

Fri Jul  9 05:07:52.237 UTCRP/0/RP1/CPU0:Jul  9 05:07:53.710 : instdir[235]: %INSTALL-INSTMGR-6-INSTALL_OPERATION_STARTED : 
Info:    Install operation 5 '(admin) install add 
Info:    /tftp://223.255.254.254/auto/tftpboot/users/user/asr9k-mpls-p.pie' 
Info:    started by user 'lab'
Info:    Install operation 5 '(admin) install add 
Info:    /tftp://223.255.254.254/auto/tftpboot/users/user/asr9k-mpls-p.pie' 
Info:    started by user 'lab' via CLI at 05:07:53 UTC Fri Jul 09 2010.
Info:    The install operation will continue asynchronously.
RP/0/RSP0/CPU0:router(admin)#
Info:    RP/0/RP1/CPU0:Jul  9 05:09:08.854 : instdir[235]: %INSTALL-INSTMGR-6-INSTALL_OPERATION_COMPLETED_SUCCESSFULLY : 
Install operation 5 completed successfully 
Info:    The following package is now available to be activated:
Info:    disk0:asr9k-mpls-p-4.0.0
Info:    The package can be activated across the entire router.
Info:    Install operation 5 completed successfully at 05:09:08 UTC Fri Jul 09 2010.
RP/0/RSP0/CPU0:router# install add /tftp://223.255.254.254/auto/tftpboot/users/user/
asr9k-upgrade-p.pie

Fri Jul  9 05:10:31.133 UTCRP/0/RP1/CPU0:Jul  9 05:10:32.156 : instdir[235]: %INSTALL-INSTMGR-6-INSTALL_OPERATION_STARTED : 
Info:    Install operation 6 '(admin) install add 
Info:    /tftp://223.255.254.254/auto/tftpboot/users/user/asr9k-upgrade-p.pie' 
Info:    started by user 'lab'
Info:    Install operation 6 '(admin) install add 
Info:    /tftp://223.255.254.254/auto/tftpboot/users/user/asr9k-upgrade-p.pie' 
Info:    started by user 'lab' via CLI at 05:10:32 UTC Fri Jul 09 2010.
Info:    The install operation will continue asynchronously.
RP/0/RSP0/CPU0:router(admin)#RP/0/RP1/CPU0:
   Jul  9 05:11:55.634 : instdir[235]: %INSTALL-INSTMGR-6-INSTALL_OPERATION_COMPLETED_SUCCESSFULLY : 
Info:    Install operation 6 completed successfully 
Info:    The following package is now available to be activated:
Info:    disk0:asr9k-upgrade-p-4.0.0
Info:    The package can be activated across the entire router.
Info:    Install operation 6 completed successfully at 05:11:55 UTC Fri Jul 09 2010.
RP/0/RSP0/CPU0:router(admin)# install activate disk0:asr9k-mini-p-4.0.0 disk0:asr9k-upgrade-p-4.0.0 disk0:asr9k-mpls-p-4.0.0

Fri Jul  9 05:23:23.150 UTC
Install operation 7 '(admin) install activate disk0:asr9k-mini-p-4.0.0 
Info:    disk0:asr9k-upgrade-p-4.0.0 disk0:asr9k-mpls-p-4.0.0' 
Info:    started by user 'lab'RP/0/RP1/CPU0:Jul  9 05:23:24.161 : instdir[235]: %INSTALL-INSTMGR-6-INSTALL_OPERATION_STARTED : 
Info:    Install operation 7 '(admin) install activate disk0:asr9k-mini-p-4.0.0 
Info:    disk0:asr9k-upgrade-p-4.0.0 disk0:asr9k-mpls-p-4.0.0' 
Info:    started by user 'lab' via CLI at 05:23:24 UTC Fri Jul 09 2010.\ 1% complete: 
Info:    The operation can still be aborted (ctrl-c for options)
Info:    This operation will reload the following nodes in parallel:
Info:    0/RP1/CPU0 (HRP) (SDR: Owner)
Info:    0/SM0/SP (Fabric-SP) (Admin Resource)Proceed with this install operation (y/n)? [y]| 
Info:    1% complete: The operation can still be aborted (ctrl-c for options)
Info:    Install Method: Parallel Reload/ 1% complete: The operation can still be aborted (ctrl-c for options)
Info:    The install operation will continue asynchronously.
RP/0/RSP0/CPU0:router(admin)#SP/0/SM0/SP:
   Jul  9 05:36:41.152 : insthelper[62]: %INSTALL-INSTHELPER-6-RELOAD_NODE_INFO : 
Info:    As part of install operation 7 this node (0/SM0/SP) will now reload. 
Info:    The changes made to software configurations will not be persistent
Info:    across system reloads. Use the command '(admin) install commit' to
Info:    make changes persistent.
Info:    Please verify that the system is consistent following the software
RP/0/RP1/CPU0:Jul  9 05:36:43.962 : instdir[235]: %INSTALL-INSTMGR-6-INSTALL_OPERATION_COMPLETED_SUCCESSFULLY : 
Info:    Install operation 7 completed successfully 
Info:    change using the following commands:
Info:    show system verify
Info:    install verify packages
Info:    Install operation 7 completed successfully at 05:36:43 UTC Fri Jul 09 2010.
rebooting .........................Initializing DDR SDRAM...found 4096 MB
Initializing ECC on bank 0Initializing ECC on bank 1
Initializing ECC on bank 2
Initializing ECC on bank 3
Turning off data cache, using DDR for first time
Initializing NVRAM...Testing a portion of DDR SDRAM ...done
Reading ID EEPROMs ............................
Initializing SQUID ...
Initializing PCI ...PCI0 device[1]: Vendor ID 0x10eePCI0 device[1]: Device ID 0x300ePCI1 device[1]: 
Device ID 0x1100PCI1 device[1]: Vendor ID 0x1013PCI1 device[2]: Device ID 0x680PCI1 device[2]: 
Vendor ID 0x1095PCI1 device[3]: Device ID 0x5618PCI1 device[3]: Vendor ID 0x14e4Configuring MPPs ...
Configuring PCMCIA slots ...System Bootstrap, Version 1.53(20090311:225342) [CRS-1 ROMMON], 
Copyright (c) 1994-2009 by Cisco Systems, Inc.
Acquiring backplane mastership ... successful
Preparing for fan initialization............. ready
Setting fan speed to 4000 RPMs  successfulReading backplane EEPROM ...
Released backplane mastership ...Board type is 0x100002 (1048578)
Switch 0 initialized
Switch 0 Port fe1: link up (100Mb Full Duplex Copper)
Enabling watchdogG4(7457-NonSMP-MV64360 Rev 3) platform with 4096 MB of main memory....    
CARD_RACK_NUMBER: 0    CARD_SLOT_NUMBER: 1        CPU_INSTANCE: 1  
RACK_SERIAL_NUMBER: TBC08052402
MBI Validation starts ... using Control Plane Ethernet.
DEBUG : Driving up signal strength for Intel LXT971
Our MAC address is 0005.9a3e.89da
Interface link changed state to UP.
Interface link state up.
MBI validation sending request.
HIT CTRL-C to abort
MBI validation sending request.
HIT CTRL-C to abort
MBI validation sending request.
HIT CTRL-C to abort
MBI validation sending request.
HIT CTRL-C to abort
MBI validation sending request.
HIT CTRL-C to abort
No MBI confirmation received from dSCboot: booting from 
bootflash:disk0/asr9k-os-mbi-4.0.0/mbiasr9k-rp.vm
....................................................................................
##################################################################################              
Restricted Rights LegendUse, duplication, or disclosure by the Government is
subject to restrictions as set forth in subparagraph(c) of the Commercial Computer Software - Restricted
Rights clause at FAR sec. 52.227-19 and subparagraph(c) (1) (ii) of the Rights in Technical Data and Computer
Software clause at DFARS sec. 252.227-7013.           
cisco Systems, Inc.           
170 West Tasman Drive           
San Jose, California 95134-1706
Cisco IOS XR Software for the Cisco XR Router, Version 4.0.0 Copyright (c) 2010 by Cisco Systems, Inc.
Jul 09 05:39:21.334 : Install (Node Preparation): Booting with software activated by previous install 
operation,errno=2
RP/0/RP1/CPU0Jul  9 05:44:45.941: syslogd_helper: [89]: dsc_event_handler: Got SysMgr dSC event : 1
RP/0/RP1/CPU0:Jul  9 05:45:11.354 : shelfmgr[306]: %PLATFORM-SHELFMGR-3-POWERDOWN_RESET : 
Node 0/2/SP is powered off due to admin power off request ios con0/RP1/CPU0 is now available
Press RETURN to get started.
RP/0/RP1/CPU0:Jul  9 05:45:27.453 : instdir[216]: %INSTALL-INSTMGR-4-ACTIVE_SOFTWARE_COMMITTED_INFO : 
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. SYSTEM CONFIGURATION IN PROCESS
The startup configuration for this device is presently loading.
This may take a few minutes. You will be notified upon completion.
Please do not attempt to reconfigure the device until this process is complete.
User Access VerificationUsername: labPassword: 
RP/0/RSP0/CPU0:router# admin
Fri Jul  9 05:45:55.941 UTC
RP/0/RSP0/CPU0:router(admin)# show platform

Fri Jul  9 05:45:59.805 UTCNode            Type                 PLIM             State           Config State
---------------------------------------------------------------------------------------
0/2/SP          MSC(SP)              N/A              UNPOWERED       NPWR,NSHUT,MON
0/RP1/CPU0      RP(Active)           N/A              IOS XR RUN      PWR,NSHUT,MON
0/SM0/SP        FC-40G/S(SP)         N/A              MBI-RUNNING     PWR,NSHUT,MON
0/SM1/*         UNKNOWN              N/A              PRESENT         PWR,NSHUT,MON

RP/0/RP1/CPU0:ios(admin)#
RP/0/RP1/CPU0:Jul  9 05:46:08.411 : instdir_lr[217]: %INSTALL-INSTMGR-4-ACTIVE_SOFTWARE_COMMITTED_INFO : 
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. 
RP/0/RP1/CPU0:Jul  9 05:50:40.918 : placed[283]: LR-PLANE-READY DECLARATIONSYSTEM CONFIGURATION COMPLETED
RP/0/RP1/CPU0:Jul  9 05:50:57.293 : ifmgr[213]: %PKT_INFRA-LINK-3-UPDOWN : 
Interface MgmtEth0/RP1/CPU0/0, changed state to Down 
RP/0/RP1/CPU0:Jul  9 05:50:57.313 : ifmgr[213]: %PKT_INFRA-LINK-3-UPDOWN : 
Interface MgmtEth0/RP1/CPU0/0, changed state to Up 
RP/0/RSP0/CPU0:router(admin)# show platform

Fri Jul  9 05:59:36.266 UTC
Node            Type                 PLIM             State           Config State
---------------------------------------------------------------------------------------
0/2/SP          MSC(SP)              N/A              UNPOWERED       NPWR,NSHUT,MON
0/RP1/CPU0      RP(Active)           N/A              IOS XR RUN      PWR,NSHUT,MON
0/SM0/SP        FC-40G/S(SP)         N/A              IOS XR RUN      PWR,NSHUT,MON
0/SM1/*         UNKNOWN              N/A              PRESENT         PWR,NSHUT,MON

RP/0/RSP0/CPU0:router(admin)# install commit

Fri Jul  9 05:59:41.851 UTC
Install operation 8 '(admin) install commit' started by user 'lab' via CLI at
05:59:43 UTC Fri Jul 09 2010./ 
20% complete: The operation can no longer be aborted (ctrl-c for options)- 
20% complete: The operation can no longer be aborted (ctrl-c for options)\ 
100% complete: 
The operation can no longer be aborted (ctrl-c for options)
RP/0/RP1/CPU0:Jul  9 05:59:46.402 : instdir[216]: %INSTALL-INSTMGR-4-ACTIVE_SOFTWARE_COMMITTED_INFO : 
The currently active software is now the same as the committed software. 
Install operation 8 completed successfully at 05:59:46 UTC Fri Jul 09 2010.
RP/0/RSP0/CPU0:router(admin)# install deactivate disk0:
asr9k-upgrade-p-4.0.0 

Fri Jul  9 05:59:58.082 UTC
Install operation 9 '(admin) install deactivate disk0:asr9k-upgrade-p-4.0.0'started 
   by user 'lab' via CLI at 05:59:59 UTC 
Fri Jul 09 2010.
1% complete: The operation can still be aborted (ctrl-c for options)- 
1% complete: The operation can still be aborted (ctrl-c for options)
Info:     Install Method: Parallel Process Restart\ 
1% complete: The operation can still be aborted (ctrl-c for options)
The install operation will continue asynchronously.
RP/0/RSP0/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
Info:     make changes persistent.
Info:     Please verify that the system is consistent following the software
Info:     change using the following commands:
Info:         show system verify
Info:         install verify packages
RP/0/RP1/CPU0:Jul  9 06:01:45.662 : instdir[216]: %INSTALL-INSTMGR-4-ACTIVE_SOFTWARE_COMMITTED_INFO : 
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 06:01:45 UTC Fri Jul 09 2010.
RP/0/RSP0/CPU0:router(admin)# install commit 

Fri Jul  9 06:01:53.583 UTC
Install operation 10 '(admin) install commit' started by user 'lab' via CLI at06:01:54 UTC Fri Jul 09 2010./ 
20% complete: The operation can no longer be aborted (ctrl-c for options)- 
20% complete: The operation can no longer be aborted (ctrl-c for options)\ 
100% complete: The operation can no longer be aborted (ctrl-c for options)
RP/0/RP1/CPU0:Jul  9 06:01:57.807 : instdir[216]: %INSTALL-INSTMGR-4-ACTIVE_SOFTWARE_COMMITTED_INFO : 
The currently active software is now the same as the committed software. 
Install operation 10 completed successfully at 06:01:57 UTC Fri Jul 09 2010.
RP/0/RSP0/CPU0:router(admin)#
RP/0/RSP0/CPU0:router(admin)#
RP/0/RSP0/CPU0:router(admin)# install remove disk0:
asr9k-upgrade-p-4.0.0 

Fri Jul  9 06:04:57.676 UTC
Install operation 11 '(admin) install remove disk0:asr9k-upgrade-p-4.0.0'started 
   by user 'lab' via CLI at 06:04:58 UTC 
Fri Jul 09 2010./ 
1% complete: The operation can no longer be aborted (ctrl-c for options)
Info:     This operation will remove the following packages:
Info:         disk0:asr9k-fpd-4.0.0
Info:         disk0:asr9k-doc-4.0.0
Info:         disk0:asr9k-k9sec-4.0.0
Info:         disk0:asr9k-sbc-4.0.0
Info:         disk0:asr9k-diags-4.0.0
Info:         disk0:asr9k-mgbl-4.0.0
Info:         disk0:asr9k-mcast-4.0.0
Info:         disk0:asr9k-mpls-4.0.0
Info:         disk0:asr9k-rout-4.0.0
Info:         disk0:asr9k-fwdg-4.0.0
Info:         disk0:asr9k-lc-4.0.0
Info:         disk0:asr9k-admin-4.0.0
Info:         disk0:asr9k-upgrade-p-4.0.0- 
1% complete: The operation can no longer be aborted (ctrl-c for options)
Info:     After this install remove the following install rollback point will
Info:     no longer be reachable, as the required packages will not be present:
Info:         7\ 
1% complete: The operation can no longer be aborted (ctrl-c for options)
Proceed with removing these packages? [confirm]| 
1% complete: The operation can no longer be aborted (ctrl-c for options)
The install operation will continue asynchronously.
RP/0/RSP0/CPU0:router(admin)#SP/0/SM0/SP:Jul  
    9 06:05:03.902 : envmon[117]: %PLATFORM-ENVMON-4-ALARM : MINOR_HI alarm 
cleared by host__temp__Inlet0 
Install operation 11 completed successfully at 06:05:33 UTC 
Fri Jul 09 2010.
RP/0/RSP0/CPU0:router(admin)#
RP/0/RSP0/CPU0:router(admin)# show install act
Fri Jul  9 06:08:11.372 UTC
Secure Domain Router: Owner  Node 0/RP1/CPU0 [HRP] [SDR: Owner]    
Boot Device: disk0:    Boot Image: /disk0/asr9k-os-mbi-4.0.0/mbiasr9k-rp.vm    
Active Packages:       disk0:asr9k-mpls-p-4.0.0      disk0:asr9k-mini-p-4.0.0
Admin Resources:  Node 0/SM0/SP [Fabric-SP] [Admin Resource]    
Boot Device: bootflash:    Boot Image: /disk0/asr9k-os-mbi-4.0.0/sp/mbiasr9k-sp.vm    
Active Packages:       disk0:asr9k-mini-p-4.0.0
RP/0/RSP0/CPU0:router(admin)#

Deactivating and Removing Cisco IOS XR Software Packages

When a package is deactivated, it is no longer active on the router, but the package files remain on the boot disk. The package files can be reactivated later, or they can be removed from the disk.

A package is deactivated using the following methods:

When a newer version of a package is activated, the earlier version of the package is automatically deactivated. See Related Topics for more information.

Note

Activating a software maintenance upgrade (SMU) does not cause any earlier SMUs or the package to which the SMU applies to be automatically deactivated.

When an earlier version of a package is activated, the newer version is deactivated automatically. See Related Topics for more information.
A specific package is deactivated using the install deactivate command. This command turns off the package features for a card or card type.

Before you begin

The following are the restrictions when deactivating and removing Cisco IOS XR Software packages:

A package cannot be deleted if it is part of the running or committed software of the SDR.
A package cannot be deactivated if that package is required by another active package. 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 been passed.
Router reloads: If the deactivation requires a router reload, a confirmation prompt appears. Use the install deactivate command with the prompt-level none keywords 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 configuration 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.
FPD versions must be compatible with the Cisco IOS XR software that is running on the router; if an incompatibility exists between an FPD version and the Cisco IOS XR software, the device with the field-programmable gate array (FPGA) may not operate properly until the incompatibility is resolved. For information on FPDs, including instructions to upgrade FPD images, see the Upgrading FPD Cisco IOS XR Software module of Interface and Hardware Component Configuration Guide for Cisco ASR 9000 Series Routers.

SUMMARY STEPS

Connect to the console port and log in.
admin
install deactivate { id add-id | device : package } [ location node-id ][ test ] [ pause sw-change ]
(Optional) show install inactive summary
(Optional) install verify packages
exit
(Optional) show system verify start
(Optional) show system verify [ detail | report ]
admin
(Optional) install commit
(Optional) install remove { id add-id | device : package | inactive }[ test ]

DETAILED STEPS

Command or Action Purpose

Step 1

Connect to the console port and log in.

Establishes a CLI management session with the SDR.

Connect to the console port for the active DSC.

For more information on console connections, see Cisco ASR 9000 Series Aggregation Services Router Getting Started Guide.

Step 2

admin

Example:


RP/0/RSP0/CPU0:router# admin

Enters administration EXEC mode.

Step 3

install deactivate { id add-id | device : package } [ location node-id ][ test ] [ pause sw-change ]

Example:

RP/0/RSP0/CPU0:router(admin)# install deactivate
    disk0:asr9k-diags-3.7.2

Deactivates a package on all SDRs a router.

To deactivate all packages that were added in one or more specific install add operations, or specify packages by name, use the id add-id keyword and argument. The operation ID of an install add operation is indicated in the syslog displayed during the operation and in the output of the show install log command.
Use the location node-id keyword and argument to deactivate the package for a specific node, if supported.
Use the pause sw-change keywords to pause the operation after preparatory checks and before the configuration is locked for the actual deactivation. This enables you to hold the operation while you perform configuration changes, and proceed with the deactivation whenever you choose. This is useful, for example, if your workflow involves configuring a router out of the network during software changes and you want to minimize the time that the router is out of the network. Follow the onscreen instructions to control the pausing and completion of the operation.

Note

Press ? after a partial package name to display all possible matches available for deactivation. If there is only one match, press [TAB] to fill in the rest of the package name.

When a package is deactivated for an SDR from administration EXEC mode, a notification message appears on the console for that SDR, with information on the impact of the deactivation.

Step 4

(Optional) show install inactive summary

Example:


RP/0/RSP0/CPU0:router(admin)# show install inactive summary

(Optional)

Displays the inactive packages on the router.

Step 5

(Optional) install verify packages

Example:


RP/0/RSP0/CPU0:router(admin)# install verify packages

(Optional)

Verifies the consistency of an 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 also checks for corruptions of installation state files and MBI image 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 packages command can take up to two minutes per package to process.

Step 6

exit

Example:


RP/0/RSP0/CPU0:router(admin)# exit

Exits administration EXEC mode and returns to EXEC mode.

Step 7

(Optional) show system verify start

Example:


RP/0/RSP0/CPU0:router# show system verify start

(Optional)

Starts the system status check.

Step 8

(Optional) show system verify [ detail | report ]

Example:


RP/0/RSP0/CPU0:router# show system verify

(Optional)

detail —Displays additional information at the card and processor level, including actual numbers.
report —Displays the same information as the default show system verify command

Note

Step 9

admin

Example:


RP/0/RSP0/CPU0:router# admin

Enters administration EXEC mode.

Step 10

(Optional) install commit

Example:


RP/0/RSP0/CPU0:router(admin)# install commit

(Optional)

Commits the current set of packages so that these packages are used if the router is restarted. Packages can be removed only if the deactivation operation is committed.

Note

This command is entered in administration EXEC mode.

Step 11

(Optional) install remove { id add-id | device : package | inactive }[ test ]

Example:


RP/0/RSP0/CPU0:router(admin)# install remove
    disk0:asr9k-diags-3.8.30

(Optional)

Removes the inactive package.

Only inactive packages can be removed.
Packages can be removed only if they are deactivated from all cards in the router.
The package deactivation must be committed.
To remove a specific inactive package from a storage device, use the install remove command with the device: package arguments.
To remove all packages that were added in one or more specific install add operations, use the id add-id keyword and argument. The operation ID of an install add operation is indicated in the syslog displayed during the operation and in the output of the show install log command. If you specify packages according to operation ID, all the packages that were added by the specified operation must still be on the router.
To remove all inactive packages from all nodes in the system, use the install remove command with the inactive keyword.

Examples

In the following examples, a package is deactivated from the router. The changes are committed and the inactive package is removed from the router.

Deactivating the Package: Example


RP/0/RSP0/CPU0:router(admin)# install deactivate disk0:asr9k
-diags-.7.2
  
Install operation 27 'install deactivate disk0:asr9k-diags-3.7.2' started by
user 'lab' at 23:29:37 UTC Sat Apr 15 2009.
The install operation will continue asynchronously.
Info:     The changes made to software configuration
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:
Info:         show system verify
Info:         install verify packages
Install operation 27 completed successfully at 23:30:22 UTC Sat Apr 15 2009.

Committing the Active Software Set: Example


RP/0/RSP0/CPU0:router(admin)# install commit 
  
Install operation 29 'install commit' started by user 'lab' at 23:39:21 UTC
Sat Apr 15 20090.
Install operation 29 completed successfully at 23:39:24 UTC Sat Apr 15 2009.

Displaying the Inactive Packages: Example


RP/0/RSP0/CPU0:router(admin)# show install inactive summary 
  
Default Profile:
  SDRs:
  Owner
  Inactive Packages:
    disk0:asr9k-diags-3.7.2

Removing the Inactive Package from the Router: Example

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/RSP0/CPU0:router(admin)# install remove disk0:asr9k-diags-3.7.2 test
  
Install operation 30 'install remove disk0:hfr-diags-3.7.2 test' started by
user 'lab' at 23:40:22 UTC Sat Apr 15 2009.
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:asr9k-diags-3.7.2
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.

Pausing Before Configuration Lock: Example

The following example shows how to deactivate a package, pausing the operation before locking the configuration for the actual software deactivation. While the operation is paused, you can enter a configuration mode and perform configurations. When you want to complete the operation, enter the install operation id complete command, or the install operation id attach synchronous command.


RP/0/RSP0/CPU0:router(admin)# install deactivate disk0:comp-asr9k
-3.7.2.07I.CSCsr09575-1.0.0 pause sw-change

Install operation 12 '(admin) install deactivate 
  disk0:comp-asr9k-3.7.2.07I.CSCsr09575-1.0.0 pause sw-change' 
  started by user 'admin' via CLI at 09:06:26 BST Mon Jul 07 2009.
Info: This operation will reload the following nodes in parallel:
Info: 0/0/CPU0 (RP) (SDR: Owner)
Info: 0/1/CPU0 (LC(E3-GE-4)) (SDR: Owner)
Info: 0/5/CPU0 (LC(E3-OC3-POS-4)) (SDR: Owner)
Proceed with this install operation (y/n)? [y]
The install operation will continue asynchronously.
Info: Install Method: Parallel Reload
Info: Install operation 12 is pausing before the config lock is applied for 
Info:    the software change as requested by the user.
Info: No further install operations will be allowed until the operation is resumed.
Info: Please continue the operation using one of the following steps:
Info: - run the command '(admin) install operation 12 complete'.
Info: - run the command '(admin) install operation 12 attach synchronous' and then 
Info:      answer the query.

Rolling Back to a Previous Software Set

Cisco IOS XR software allows you to roll back one or more SDRs to a previous committed or uncommitted software set. Use the show install rollback ? command to view the available rollback points and use the install rollback to command to roll back the SDR to a previous software set. You can also use the install rollback to committed command to roll back to the most recent committed software set.

Note

Rollback operations can be performed by running the command in administration EXEC or EXEC mode.

Note

If type 8,9, or 10 is the secret key configured, then before downgrading to 6.6.3 and earlier versions, perform either of the following methods:

Type a combination of secret type and encrypted key instead of plain text for the password. Example:
```
username root
group root-lr
group cisco-support
secret 10 $6$Mwaqg/jdBPOn4g/.$PrJP2KjsCbL6bZqmYOej5Ay67S/sSWJNlkiYhCTc/B/35E1kJBqffmBtn.ddQEH0O2CU7V.ZEMmqIg7uE8cfz0
```
This is because 6.6.3 and earlier versions do not support type 8,9, or 10 key type.
Ensure that there are secret type 5 users on the system.

Displaying Rollback Points

A rollback point is created every time a software package is activated, deactivated, or committed. Use the show install rollback ? command to display the eligible rollback points.


RP/0/RSP0/CPU0:router# admin
RP/0/RSP0/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

In this example, the rollback points are 0 and 2. The rollback point with the highest number is the current software point. For example, if the last installation operation was operation 3 (activating the MPLS package) then the highest rollback point is 3, which is the same as the current software (MPLS package activated).

To easily identify specific rollback points, you can assign a label or description to a rollback point using the install label command.

You can enter the command in either administration EXEC mode or EXEC mode.

Displaying the Active Packages Associated with a Rollback Point

To display the active packages associated with a rollback point, use the show install rollback command with the point-id argument. This command displays the packages that are active if you roll back one or more SDRs to that installation point. For example, the show install rollback 2 command displays the packages that are active if you roll back to rollback point 2.



RP/0/RSP0/CPU0:router(admin)# show install rollback 0

Tue Jun 23 06:25:06.493 PST
ID: 0, Label: 
Timestamp: 23:11:20 UTC Sat Oct 28 2000

Secure Domain Router: Owner

  Node 0/RSP0/CPU0 [RP] [SDR: Owner]
    Boot Device: disk0:
    Boot Image: /disk0/asr9k-os-mbi-3.9.0.12I/mbiasr9k-rp.vm
    Rollback Packages: 
      disk0:comp-asr9k-mini-3.9.0.12I

  Node 0/1/CPU0 [LC] [SDR: Owner]
    Boot Device: mem:
    Boot Image: /disk0/asr9k-os-mbi-3.9.0.12I/lc/mbiasr9k-lc.vm
    Rollback Packages: 
      disk0:comp-asr9k-mini-3.9.0.12I

  Node 0/4/CPU0 [LC] [SDR: Owner]
    Boot Device: mem:
    Boot Image: /disk0/asr9k-os-mbi-3.9.0.12I/lc/mbiasr9k-lc.vm
    Rollback Packages: 
      disk0:comp-asr9k-mini-3.9.0.12I

  Node 0/6/CPU0 [LC] [SDR: Owner]
    Boot Device: mem:
    Boot Image: /disk0/asr9k-os-mbi-3.9.0.12I/lc/mbiasr9k-lc.vm
    Rollback Packages: 
      disk0:comp-asr9k-mini-3.9.0.12I

You can enter the command in either administration EXEC mode or EXEC mode.

Note

For more information on the command options, see the Software Package Management Commands on Cisco IOS XR Software module of System Management Command Reference for Cisco ASR 9000 Series Routers.

Rolling Back to a Specific Rollback Point

You can roll back to a specific rollback point, including a noncommitted software set:

If you roll back to the most recent noncommitted rollback point (with the highest number), you do not need to reload the router.
You can repeat the rollback process one rollback point at a time without reloading if you always choose the most recent rollback point.
If you choose a rollback point that is older than the most recent point, the impacted nodes reload, interrupting data traffic on those nodes. Before the reload occurs, you are prompted to confirm the install rollback operation.

In the following example, the system is rolled back to noncommitted rollback point 8:


RP/0/RSP0/CPU0:router(admin)# install rollback to 8
  
  Install operation 10 'install rollback to 8' started by user 'cisco' at 07:49:26
  UTC Mon Nov 14 2009.
  The install operation will continue asynchronously.
  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:
  Info:         show system verify
  Info:         install verify packages
  
  The currently active software is the same as the committed software. 
  
  Install operation 10 completed successfully at 07:51:24 UTC Mon Nov 14 2009.

Rolling Back to the Last Committed Package Set

Use the install rollback to committed command to roll back to the last committed package set.

In the following example, the owner SDR is rolled back to the last committed package set:


RP/0/RSP0/CPU0:router(admin)# install rollback to committed
  
  Install operation 27 'install rollback to committed' started by user 'lab' at
  16:41:38 UTC Sat Nov 19 2009.
  Info:     The rollback to committed software will require a reload of impacted
  Info:     nodes because it is over multiple activation & deactivation
  Info:     operations.
  Info:     This operation will reload the following node:
  Info:         0/RP1/CPU0 (RP) (SDR: Owner)
  Info:     This operation will reload all RPs in the Owner SDR, and thereby
  Info:     indirectly cause every node in the router to reload.
  
  Proceed with this install operation? [confirm]
  
  Updating Commit Database.  Please wait...[OK]
  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:
  Info:         show system verify
  Info:         install verify packages
  Install operation 27 completed successfully at 16:42:23 UTC Sat Nov 19 2009.

Resetting Router to Factory Settings

The logical volumes and ROMMON variables of CPU boards on a router can be reset to factory settings using zapdisk feature. After enabling the zapdisk feature on the router, the CPU boards are reset to factory settings in the next reimage of the boards. During the reimage process, all logical volumes of the CPU boards including the files saved in harddisk: are cleaned up, and ROMMON variables of the CPU boards are reset to factory settings.

Procedure

Step 1

admin

Example:

Router# admin

Enters the System Admin EXEC mode.

Step 2

zapdisk set

Example:

sysadmin-vm:0_RP0# zapdisk set
Fri Jul  21 22:32:29.242 UTC
result Zapdisk set command success

Enables zapdisk feature.

Note

To disable the zapdisk feature, run the zapdisk unset command:

sysadmin-vm:0_RP0# zapdisk unset
Fri Jul  21 22:32:29.242 UTC
result Zapdisk unset command success

Step 3

run

Example:

sysadmin-vm:0_RP0# run
 [sysadmin-vm:0_RP0:~]$/opt/cisco/calvados/bin/nvram_dump -a
 PS1=rommon ! >
 ZAPDISK_CARD=1

Verifies status of zapdisk feature on the CPU board. ZAPDISK_CARD=1 indicates that zapdisk feature is enabled; ZAPDISK_CARD=0 indicates that zapdisk feature is disabled.

Additional References

The following sections provide references related to software package management on Cisco IOS XR software.

Standards


Standards	Title
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.	—

MIBs


MIBs	MIBs Link
—	To locate and download MIBs using Cisco IOS XR software, use the Cisco MIB Locator found at the following URL and choose a platform under the Cisco Access Products menu: http://cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml

RFCs


RFCs	Title
No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.	—

Technical Assistance


Description	Link
The Cisco Technical Support website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.	http://www.cisco.com/cisco/web/support/index.html

Related Topic	Document Title
Cisco IOS XR install commands	Software Package Management Commands on the Cisco ASR 9000 Series Router module of System Management Command Reference for Cisco ASR 9000 Series Routers
Cisco IOS XR getting started material	Cisco ASR 9000 Series Aggregation Services Router Getting Started Guide
Cisco IOS XR master command index	Cisco ASR 9000 Series Aggregation Services Router Commands Master List
Information about user groups and task IDs	Configuring AAA Services on the Cisco ASR 9000 Series Router module of System Security Configuration Guide for Cisco ASR 9000 Series Routers
ROM Monitor	ROM Monitor Configuration Guide for Cisco ASR 9000 Routers

System Management Configuration Guide for Cisco ASR 9000 Series Routers, IOS XR Release 7.3.x

Bias-Free Language

Results

Chapter: Upgrading and Managing Cisco IOS XR Software

Upgrading and Managing Cisco IOS XR Software

Overview of Cisco IOS XR Software Packages

Package Installation Envelopes

Summary of Cisco IOS XR Software Packages

Packages in the Cisco IOS XR Unicast Routing Core Bundle

Software Maintenance Upgrades

Third-party SMUs

PIE Filenames and Version Numbers

Filename Component Description

Copying the PIE File to a Local Storage Device or Network Server

Information About Package Management

Summary of Package Management

Adding Packages

Verifying Package Details

Activating Packages

Activating a Package on the Router

Activating Multiple Packages or SMUs

Activating All Packages Added in a Specific Operation

Adding and Activating a Package with a Single Command

Digitally Signed Images

Validation Messages

Upgrading and Downgrading Packages

Committing the Active Software Set

Rolling Back to a Previous Installation Operation

Multiple Disks Support during Installations

Restrictions

Deactivation of fully superseded SMUs

Support for the Ignore Package Presence Check Option

Upgrading Packages

Downgrading Packages

Impact of Package Version Changes

Impact of Package Activation and Deactivation

Delaying the Return of the CLI Prompt

Displaying Installation Log Information

Examples

Displaying install log Entries: Example

Package Management Procedures

Activation and Deactivation Prerequisites

Obtaining and Placing Cisco IOS XR Software

Transferring Installation Files from a Network File Server to a Local Storage Device

Preparing for Software Installation Operations

Before you begin

SUMMARY STEPS

DETAILED STEPS

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Examples

Verifying That the ROM Monitor Version Is Correct: Example

Displaying the Active Software for the Entire System: Example

Displaying Information About the Contents of a PIE File: Example

Verifying That There Are No Corrupted Software Files: Example

Verifying the Current System Status: Example

Verifying That the System Clock Is Correct: Example

Adding and Activating Packages

Before you begin

SUMMARY STEPS

DETAILED STEPS

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Examples