Table 1. Feature History Table
Feature Name
|
Release Information
|
Description
|
Supported Software Upgrade or Downgrade IOS XR Versions
|
Release 7.5.2
|
You can determine whether a software version can be upgraded or downgraded to another version using this functionality. Before
an actual upgrade or downgrade process, you can also view the hardware or software limitations that could cause the upgrade
or downgrade to fail. This feature helps you plan successful software upgrades or downgrades.
This feature introduces the show install upgrade-matrix command.
|
Your Cisco router comes preinstalled with IOS XR software. You either upgrade the software release to use new features and
software fixes, or you downgrade the software. To leverage new features that are added or software fixes that are provided,
it is important that you upgrade your router to a current version.
To help you select a Cisco IOS XR software release that aligns with Cisco-certified upgrade and downgrade paths, this feature
provides answers to the following questions:
-
What upgrade or downgrade releases are supported for the current release?
-
I plan to upgrade from Release X to Release Y. Does my router support upgrade to Release Y?
-
Are there any bridging SMUs that must be installed before I upgrade the software?
This feature provides a mechanism to determine whether the current release supports an upgrade to a target release. This task
is run at the start of a software upgrade or downgrade through the install replace command. If the validation fails, the software upgrade is blocked, and the system notifies the reason for the failure. This
feature allows you to proactively examine whether you can upgrade or downgrade to a certain release, saving time and effort
involved in planning and upgrading the software.
The feature provides the following information to help you understand the prerequisites or limitations related to the specific
software upgrade or downgrade:
You can overwrite the automatic validation using the force keyword in the install replace command. With this option, the system displays warning messages when the upgrade fails but does not block the software upgrade.
Use the force ? keyword to understand any other impact to system functionalities apart from the disabling of this process that determines
the supported releases for software upgrade or downgrade.
You can view the support information using the following show commands or through the operational data.
Command
|
Description
|
show install upgrade-matrix running
|
Displays all supported software upgrades from the current version according to the support data installed on the running system
|
show install upgrade-matrix running
v1 v2
|
Displays details about the software upgrades from version 1 to version 2 according to the support data installed on the running
system
|
show install upgrade-matrix running all
|
Displays all supported software upgrades from any version according to the support data installed on the running system
|
show install upgrade-matrix iso
path-to-ISO
|
Displays details about the software upgrade from the current version to the version of the target ISO according to the support
data in both the running system and the ISO image
|
show install upgrade-matrix iso
path-to-ISO v1 v2
|
Displays details about the software upgrade from version 1 to version 2 according to the support data in the target ISO image
|
show install upgrade-matrix iso
path-to-ISO
all
|
Displays all supported software upgrades from any version according to the support data in the target ISO image
|
show install upgrade-matrix iso
path-to-ISO
running
|
Displays details about the software upgrade from the current version to the version of ISO according to the support matrices
in both the running system and the target ISO image
|
show install upgrade-matrix rollback
ID
|
Displays details about the software upgrade from the current version to a version of a specific rollback point (indicated
by an ID) according to the support matrices in both the running system and the rollback ID
|
show install upgrade-matrix rollback
ID v1 v2
|
Displays details about the software upgrade from version 1 to version 2 according to the support data in the specific rollback
ID
|
show install upgrade-matrix rollback
ID
all
|
Displays all supported software upgrades from any version according to the support data in the specific rollback ID
|
show install upgrade-matrix rollback
ID
running
|
Displays details about the software upgrade from the current version to the version of the specific rollback ID according
to the support matrices in both the running system and the rollback ID
|
View All Supported Software Upgrade from Running Version
The following example shows all supported releases for upgrade from the current version 7.5.2 on the router:
Router#show install upgrade-matrix running
Tue Jun 7 06:36:06.865 UTC
This may take a while ...
The current software [7.5.2] can be upgraded from and downgraded to the following releases:
================================================================================
From To Bridge SMUs Required Caveats
================================================================================
7.5.2 7.6.1 None - Caveat string
--------------------------------------------------------------------------------
View the Release Support for Software Upgrade Between Two Releases
The following example shows the support information for an upgrade from one release to another—7.5.2 and 7.3.1:
Router#show install upgrade-matrix running 7.5.2 7.3.1
Tue May 10 19:33:59.135 UTC
------------------------------------------------------------
Upgrade matrix information for system upgrade: 7.5.2->7.3.1
------------------------------------------------------------
XR system upgrade is supported, with the following restrictions:
The following fixes must be installed if any version of the package is installed.
-------------------------------
Ddts Name Version
----------- ----------- ------------------
CSCab54345 xr-bgp 7.5.2
View All Releases that Support Software Upgrade from Current Software
The following example shows all releases that support upgrades or downgrades for the current release:
Router#show install upgrade-matrix running all
Tue May 10 19:33:59.135 UTC
------------------------------------------------------------
Matrix: XR Version: 7.5.2, File version: 1.0
The upgrade matrix indicates that the following system upgrades are supported:
------------------------------------------------------------------------------
From To Restrictions
----------- ----------- ------------------
7.3.0 7.5.2 -
7.3.1 7.5.2 -
7.3.2 7.5.2 -
7.3.3 7.5.2 -
7.3.4 7.5.2 -
7.5.1 7.5.2 -
7.5.2 7.3.0 -
7.5.2 7.3.1 Bridging fixes
7.5.2 7.3.2 -
7.5.2 7.3.3 -
7.5.2 7.3.4 -
7.5.2 7.5.1 -
7.5.2 7.6.1 -
7.6.1 7.5.2 -
View Supported Releases to Upgrade Software From Current Version to Target Version
This example shows the supported release to upgrade software from the current version to a target version.
Router#show install upgrade-matrix iso /harddisk\:ncs5500-mini-x-7.5.2.iso
-----------------------------------------------------------
Upgrade matrix information for system upgrade: 7.5.2->7.6.1
-----------------------------------------------------------
XR system upgrade is supported with no additional restrictions
The current image has the upgrade matrix that specifies only its supported upgrade or downgrade versions up to a certain version.
If you want to determine the upgrade path of a newer version of ISO that is higher than the version in the current matrix,
the upgrade matrix from the new ISO will provide the supported upgrade or downgrade paths.
View Supported Releases from Current Version to an ISO Version
The following example shows the software upgrade paths, downgrade paths, and restrictions to an upgrade from the current version
to the target ISO version:
Router#show install upgrade-matrix iso /harddisk\:/ncs5500-x64-7.5.2.iso all
Tue Jun 7 06:40:43.973 UTC
This may take a while ...
7.5.2 can be upgraded from and downgraded to the following releases:
================================================================================
From To Bridge SMUs Required Caveats
================================================================================
7.6.1 7.5.2 None None
--------------------------------------------------------------------------------
7.4.2 7.5.2 None None
--------------------------------------------------------------------------------
7.4.1 7.5.2 None None
--------------------------------------------------------------------------------
7.3.2 7.5.2 None None
--------------------------------------------------------------------------------
7.3.1 7.5.2 None None
--------------------------------------------------------------------------------
7.2.2 7.5.2 None None
--------------------------------------------------------------------------------
7.2.1 7.5.2 None None
--------------------------------------------------------------------------------
7.5.2 7.6.1 None None
--------------------------------------------------------------------------------
7.5.2 7.4.2 None None
--------------------------------------------------------------------------------
7.5.2 7.4.1 None None
--------------------------------------------------------------------------------
7.5.2 7.3.2 None None
--------------------------------------------------------------------------------
7.5.2 7.3.1 None None
--------------------------------------------------------------------------------
7.5.2 7.2.2 None None
--------------------------------------------------------------------------------
7.5.2 7.2.1 None None
--------------------------------------------------------------------------------
Replacing a Software Release with an Unsupported Release
In this example, consider you attempt to replace version 7.4.2 with an unsupported version 7.5.1. This operation fails and
a message is displayed to notify the reason for the failure.
Router#install package replace /harddisk\:/ncs5500-x64-7.4.2.iso synchronous
Tue May 10 19:33:59.135 UTC
Starting:
install package replace /harddisk:/ncs5500-x64-7.4.2.iso
Packaging operation 1.1.1
Press Ctrl-C to return to the exec prompt. This will not cancel the install operation
Current activity: Initializing ...
Current activity: Verify input and download ISO ..........
Packaging operation 1.1.1: 'install package replace /harddisk:/ncs5500-x64-7.4.2.iso' failed -
Software upgrade 7.5.1->7.4.2 not listed as permitted.
Automatically recovered after failure, ready for next user request.
View All Releases that Support Rollback from Current Software
The following example shows all releases that support upgrades or downgrades for the current release:
Router#show install upgrade-matrix rollback 130 all
Mon Jun 6 10:42:23.013 UTC
Matrix: XR version: 7.5.2, File version: 1.0
The upgrade matrix indicates that the following system upgrades are supported:
From To Restrictions
---------- ---------- --------------
7.3.1 7.5.2 Bridging fixes
7.3.2 7.5.2 -
7.4.1 7.5.2 -
7.4.2 7.5.2 -
7.5.1 7.5.2 -
7.6.1 7.5.2 -
7.5.2 7.3.1 -
7.5.2 7.3.2 -
7.5.2 7.4.1 -
7.5.2 7.5.1 -
View the Release Support for Software Upgrade Between Two Releases with Specific Rollback ID
The following example shows the support information for an upgrade from one release to another—7.5.2 and 7.3.1, with specific
rollback ID 130:
Router#show install upgrade-matrix rollback 130 7.3.1 7.5.2
Mon Jun 6 10:42:55.052 UTC
-----------------------------------------------------------
Upgrade matrix information for system upgrade: 7.3.1->7.5.2
-----------------------------------------------------------
XR system upgrade is supported, with the following restrictions:
The following fixes must be installed if any version of the package is installed.
---------------
Ddts Name Version
---------- --------------- -----------
CSCvy66646 xr-install 7.3.1v1.0.1