Workflow for Installing Cisco IOS XR Software

Upgrade the Current Active Version

version change, if too many processes need restarting, there is configuration in the GISO to apply or if the
bugfix is marked as requiring a reload.

Note The ztp.ini is an initialization file for ZTP that is provided when building a golden ISO (GISO). This
file defines the GISO ZTP configuration. If the .ini file is used, the next time ZTP starts, this custom
.ini file that was used is picked up. For example, if the install starts a reload operation or when ZTP is
initiated manually, the ZTP runs with the custom ini. This file is carried over during install replace and
install rollback, as long as both the from-version and the to-version are Cisco IOS XR, Release 7.3.1
or higher.

From Cisco IOS XR Release 7.5.1, you can use the Automatic Bridging of Bug Fix RPMs feature to
automatically install the bridging bug fix RPMs that are prerequisite for a system upgrade or a downgrade.
The GISO can include bridging SMUs for multiple source releases, and installs only the specific bridging
SMUs required for the target release. The bridging bug fix RPMs can be used in the following scenarios:
• To resolve a bug that might stop upgrade.
• The latest version has new prerequisite requirements that are not met by the earlier version.

The install replace command adds and applies the highest version of any bridging bugfix RPMs for the
currently active XR version.
If you start an install replace or install package replace operation with a GISO that has a ztp.ini file, the
GISO ZTP configuration is updated on both RPs when the operation is applied. To undo this install operation
and also the change in GISO ZTP configuration, use install package abort command. If you replace the
image using an ISO without a ztp.ini file, the GISO ZTP configuration is removed from both RPs, if it exists,
when the operation is applied.

Step 1 Copy the ISO (or GISO) image to the /harddisk: location on the router.
Step 2 Upgrade the system to replace the current software with the 8000-x64.iso image.
Example:
Router#install package replace /harddisk:/8000-x64.iso

Step 3 Activate the new .iso image on the router by applying the changes.
Example:
Router#install apply {reload | restart} [noprompt]

Note You can use a single command to perform both the packaging operation and activating the applying the changes
using install replace /harddisk:/8000-x64.iso noprompt command.

To identify whether a reload is required or only process restart is needed, use either show install history last transaction
verbose command or show install request command.
Include the keyword noprompt in the command to enable the system to bypass your permission to reload the router.
Applying the change gives you the flexibility to test the operation of the new software before committing the changes.
If you reload the router, the router reverts the software to its previous software state.

Software Installation Guide for Cisco 8000 Series Routers, IOS XR Release 7.3.x
13
 Workflow for Installing Cisco IOS XR Software
Upgrade the System and Install RPMs

All operations that automatically apply the new software are prohibited when an atomic change is already in progress.
You must address the current atomic-change before performing this operation. To address the change, apply the current
atomic-change, or cancel it with the install package abort all-since-apply command.

Step 4 View the install log.

Example:
Router#show install log detail
Fri Nov 12 09:43:49.702 UTC
2021-11-12 09:33:47 UTC Transaction 1 started
2021-11-12 09:33:47 UTC Atomic change 1.1 started
2021-11-12 09:33:47 UTC Packaging operation 1.1.1 started
2021-11-12 09:33:47 UTC Replace

2021-11-12 09:35:58 UTC Packaging operation 1.1.1 success

2021-11-12 09:36:04 UTC Apply by reload started
2021-11-12 09:38:48 UTC Atomic change 1.1 successfully applied by reload

Step 5 Verify that the image is activated successfully.

Example:
Router#show install request

Step 6 Commit the transaction.

Example:
Router#install commit

Note Any action requests may be run synchronously from the CLI. During this request, you are updated with the
status of the request whenever it changes. The following example shows the output from a synchronous action
request:
Router#install commit synchronous
Starting:
install commit
Transaction 1
The install operation will continue in the background
Press Ctrl-C to return to the exec prompt. This will not cancel the install operation

Current activity: Initializing ....

Current activity: Commit transaction ......

Transaction 4: 'install commit' completed without error

Upgrade the System and Install RPMs

In this scenario, you replace the current software with the 8000-x64.iso image and have the possibility to
install or remove optional RPMs before applying the changes. You can perform this operation while an
atomic-change is already in progress. However, all packaging operations before this command are discarded.
The installed software is an exact copy of the software in the ISO after this packaging operation is complete.
You can perform all additional packaging operations after this operation and before applying and committing
the changes.

Step 1 Copy the ISO (or GISO) image to the /harddisk: directory on the router.

Software Installation Guide for Cisco 8000 Series Routers, IOS XR Release 7.3.x
14