Date created: Tuesday, August 18, 2015 1:24:59 PM. Last modified: Thursday, June 30, 2022 10:42:39 AM

IOS-XR Downgrade

These are steps for downgrading between IOS-XR versions

Note: Downgrade requires at least equal number of matching packages for downgrade to be successful. Any additional packages that are not needed need to be deactivated first.

Note: Downgrade can be performed via 2 methods. "install activate" or rollback via "install rollback" option. Both the options requires an least equal number of matching packages to be present as part of inactive packages. If packages aren’t present, they will need to be added to the router before proceeding with the downgrade.

Note: The router will reload at the end of activation/rollback to start using the new packages. Under idle conditions, this operation may take at least 30 minutes to complete.

Pre-checks:


# Check existing software versions

#show fpd packag
#show version


# Enter admin mode

admin


# Verify that all RSPs/CPUs are in "IOS XR RUN" state, SPAs & MPAs in "OK" state, Fan Tray and Power Modules are in "READY" state

(admin)# show platform


# Verify that Active & Standby RSP are available and in "ACTIVE role" & "is ready" states

(admin)# show redundancy


# Verify that the proper set of packages are active

(admin)# show install active
(admin)# show install committed summary


# Check/fix the configuration file system

(admin)# cfs check
(admin)# clear configuration inconsistency


# Make sure you have enought disk space to perform the downgrade. A minimum of 500MB-750MB of free disk0: disk space is required for a typical downgrade, hopefully a the downgrade shouldn't use much extra space.

(admin)# show filesystem


# Back up the running config:

#copy running-config tftp://x.x.x.x/running_config.txt
#admin
(admin)#copy running-config tftp://x.x.x.x/admin-running_config.txt
(admin)#exit


# Disable disk mirroring if enabled on the router before going to next step. Disk mirroring can increase the upgrade time.

(admin)# no mirror location 0/rsp0/cpu0 disk0:disk1:
(admin)# show mirror

 

Downgrade commands:

After trying to remove the package below, this ASR9001 wouldn't boot, had to use the complete erase and install method starting with ROMMON

#
# Short of space, delete some active packages that aren't required:
#
RP/0/RSP0/CPU0:ios(admin)#show system verify start # Capture current system integrity before bugger about with packages

RP/0/RSP0/CPU0:ios(admin)#install deactivate disk0:asr9k-9000v-nV-px-5.2.2 disk0:asr9k-asr901-nV-px-5.2.2 disk0:asr9k-asr903-nV-px-5.2.2 disk0:asr9k-bng-px-5.2.2 disk0:asr9k-mcast-px-5.2.2

Fri Jan 22 09:39:16.010 UTC
Install operation 14 '(admin) install deactivate disk0:asr9k-9000v-nV-px-5.2.2
disk0:asr9k-asr901-nV-px-5.2.2 disk0:asr9k-asr903-nV-px-5.2.2
disk0:asr9k-bng-px-5.2.2 disk0:asr9k-mcast-px-5.2.2' started by user 'admin'
via CLI at 09:39:16 UTC Fri Jan 22 2016.
Info:     The following sequence of sub-operations has been determined to
Info:     minimize any impact:
Info:
Info:     Sub-operation 1:
Info:         Install Method: Parallel Process Restart
Info:         asr9k-asr903-nV-px-5.2.2
Info:
Info:     Sub-operation 2:
Info:         Install Method: Parallel Process Restart
Info:         asr9k-asr901-nV-px-5.2.2
Info:
Info:     Sub-operation 3:
Info:         Install Method: Parallel Process Restart
Info:         asr9k-9000v-nV-px-5.2.2
Info:
Info:     Sub-operation 4:
Info:         Install Method: Parallel Process Restart
Info:         asr9k-bng-px-5.2.2
Info:
Info:     Sub-operation 5:
Info:         Install Method: Parallel Process Restart
Info:         asr9k-mcast-px-5.2.2
Info:
The install operation will continue asynchronously.

RP/0/RSP0/CPU0:ios(admin)#show install request
Fri Jan 22 09:42:37.030 UTC
Install operation 14 '(admin) install deactivate disk0:asr9k-9000v-nV-px-5.2.2
disk0:asr9k-asr901-nV-px-5.2.2 disk0:asr9k-asr903-nV-px-5.2.2
disk0:asr9k-bng-px-5.2.2 disk0:asr9k-mcast-px-5.2.2' started by user 'admin'
via CLI at 09:39:16 UTC Fri Jan 22 2016.
The operation is 23% complete
The operation can still be aborted.

# Check the system software integrity is still OK
RP/0/RSP0/CPU0:ios(admin)#show system verify

# Commit the software changes
RP/0/RSP0/CPU0:ios(admin)#install commit

RP/0/RSP0/CPU0:ios(admin)#install verify packages
...
Info:     Verification Summary:
Info:         0/0/CPU0: SUCCESSFUL. No anomalies found.
Info:         0/RSP0/CPU0: SUCCESSFUL. No anomalies found.
Info:         The system needs no repair.

RP/0/RSP0/CPU0:ios(admin)#show install inactive
Fri Jan 22 10:07:50.359 UTC
Secure Domain Router: Owner

  Node 0/RSP0/CPU0 [RP] [SDR: Owner]
    Boot Device: disk0:
    Inactive Packages:
      disk0:asr9k-asr903-nV-px-5.2.2
      disk0:asr9k-mcast-px-5.2.2
      disk0:asr9k-9000v-nV-px-5.2.2
      disk0:asr9k-bng-px-5.2.2
      disk0:asr9k-asr901-nV-px-5.2.2

  Node 0/0/CPU0 [LC] [SDR: Owner]
    Boot Device: mem:
    Inactive Packages:
      disk0:asr9k-mcast-px-5.2.2
      disk0:asr9k-bng-px-5.2.2


RP/0/RSP0/CPU0:ios(admin)#install remove inactive



#
# Downgrade via "install activate" method
#

# Test the installtion of the previous version of IOS-XR software
(admin)# install acivate disk0:ASR9K-iosxr-px-k9-4.3.4.tar sync test

# Install the previous version of the IOS-XR software
(admin)# install acivate disk0: disk0: disk0: sync
or
(admin)# install activate disk0:*5.1.2* sync



#
# Downgrade via "install rollback" method
#


# List available rollback points

(admin)#show install rollback ?
  0   ID of the rollback point to show package information for
  35  ID of the rollback point to show package information for
  36  ID of the rollback point to show package information for
  38  ID of the rollback point to show package information for
  39  ID of the rollback point to show package information for


# View the details of a specific rollback point

(admin)#show install rollback 39
ID: 39, Label:
Timestamp: 05:57:01 UTC Tue May 27 2014

Secure Domain Router: Owner

  Node 0/RSP0/CPU0 [RP] [SDR: Owner]
    Boot Device: disk0:
    Boot Image: /disk0/asr9k-os-mbi-4.3.4/0x100000/mbiasr9k-rp.vm
    Rollback Packages:
      disk0:asr9k-mini-px-4.3.4
      disk0:asr9k-mpls-px-4.3.4
      disk0:asr9k-mgbl-px-4.3.4
      disk0:asr9k-mcast-px-4.3.4
      disk0:asr9k-fpd-px-4.3.4
      disk0:asr9k-optic-px-4.3.4
      disk0:asr9k-doc-px-4.3.4
      disk0:asr9k-k9sec-px-4.3.4

  Node 0/0/CPU0 [LC] [SDR: Owner]
    Boot Device: mem:
    Boot Image: /disk0/asr9k-os-mbi-4.3.4/lc/mbiasr9k-lc.vm
    Rollback Packages:
      disk0:asr9k-mini-px-4.3.4
      disk0:asr9k-mpls-px-4.3.4
      disk0:asr9k-mcast-px-4.3.4
      disk0:asr9k-optic-px-4.3.4


# If the packages listed in the rollback point are not present as part of the inactive package list, then you will need to add the pies/packages to the router via “install add  before downgrade via rollback method is attempted.


#Test  Rollback  procedure

(admin)# install rollback to <rollback point> sync test


# Perform rollback procedure

(admin)# install rollback to <rollback point> sync 

 

Post-checks:

# Check new software versions

#show fpd packag
#show version


# Verify that all RSPs/CPUs are in “IOS XR RUN” state, SPAs & MPAs in “OK” state, Fan Tray and Power Modules are in “READY” state

(admin)# show platform


# Verify that Active & Standby RSP are available and in “ACTIVE role” & “is ready” states

(admin)# show redundancy


# Verify that the proper set of packages are active

(admin)# show install active

(admin)# show install committed summary


# Check to see if there was any failed startup configuration

(admin)# show configuration failed startup


# Upon Sucessful upgrade check for package and image integrity. Any anamolies found will need to be repaired.

(admin)# show install verify packages
(admin)# install verify package XYZ


# For packages with anomalies, we can attempt to repair them

(admin)# install verify packages repair


# Failing that we can restart the install process (which is a non-service affecting operation)

(admin)# process restart instdir


# Check/fix the configuration file system

(admin)# cfs check
(admin)# clear configuration inconsistency


# Enable disk mirroring after the downgrade has completed (if it was disabled)  

(admin)# mirror location 0/rsp0/cpu0 disk0: disk1:


# Check if any line cards need firmware upgraing/downgrading

(admin)# show hw-module fpd location all


# List inactive software packages

(admin)# show install inactive summary


# Test removing the inactive packages

(admin)# install remove inactive sync test


# Remove the inactive packages

(admin)# install remove disk0:package1 disk0:package2 sync
or
(admin)# install remove inactive sync