2 Upgrading to Cisco IOS XR

This chapter explains the steps you need to perform before and after upgrading to Cisco IOS XR.

Note:

It is not recommended for customers to perform a device IOS upgrade in a production network, unless they have performed acceptance testing prior to the upgrade.

Prerequisites

Before performing the Cisco IOS XR upgrade, complete the following tasks for the device you are upgrading:

It is recommended that you resolve as many concretes as possible that are in a conflict or disabled state. Keep a record of those which you can resolve.
Run an audit to determine whether Oracle Communications IP Service Activator and the device configuration are synchronized. If there are missing commands, consider re-issuing them to clean up the audit. Preserve the audit output.

For more information on viewing audit logs, see IP Service Activator System Administrator's Guide.
Stop all provisioning on the device.
Unmanage the device.

Upgrading to Cisco IOS XR

For instructions on upgrading to Cisco IOS XR, see the Cisco documentation.

Post-upgrade Tasks

After performing the Cisco IOS XR upgrade, complete the following tasks for the device you have upgraded:

Reset the device capabilities:
1. Right-click the device and select Properties.
2. Select the Capabilities property page.
3. Click Reset Device Capabilities.
4. In the confirmation popup, click Yes.
5. Click OK and then Commit.
Modify AutoDiscovery.cfg by adding the following statement:
```
NoAutoPersistant:9;0;
```
This statement prevents configuration changes to interface name or interface snmp index number on a device when it is rediscovered.

See IP Service Activator System Administrator's Guide for more information about AutoDiscover.cfg.
Rediscover the device:
1. Right-click the device.
2. Select Discover.
Verify that the new IOS version was picked up by IP Service Activator:
1. Right-click the device.
2. Select Properties.
  
  The Description field displays the new IOS version.
Manage the device and set it to offline test mode:
1. Right-click the device and select Properties.
2. Select the Management property page.
3. Select Offline Maintenance on the Command Delivery list.
4. Right-click the device and select Manage.
5. Click OK and then Commit.
  
  You can access the audit log at the following location to confirm commands were processed in offline maintenance mode:
  
  /opt/OracleCommunications/ServiceActivator/AuditTrails/npIosXr.audit.log
  
  For more information about checking an audit trail log for a cartridge, see IP Service Activator System Administrator's Guide.
  
  The audit log must be empty. If there are rejected concretes in step 1 of "Prerequisites" (based on the reason for rejection), you can view commands. These commands configure the service for the concrete and are related to rejected concretes. If so, you can continue.
  
  If there are other commands, refer to the options documentation, and confirm that all the concretes used in installation are not in conflict. You must check if the capabilities were fetched correctly. If not, it may be because the registry was not set up correctly to point to the specific capabilities file.
  
  If you view commands for non-rejected concretes, check the options. Review the options and see if there is an entry that controls the behavior you view. It is possible that the MIPSA registry entry you made for Device/IOS combination is not being applied. You must check the Network Processor logs to assist you in tracking this down.
  
  Note:
  Ideally for every new Device/IOS combination, you must perfect the Network Processor configuration on a lab system, and then apply the changes to the live system after it is debugged. To access the Network Processor logs to confirm processing of the configuration after managing the device:
  /opt/OracleCommunications/ServiceActivator/AuditTrails/npIosXr.audit.log
  
  When you manage the device in offline maintenance mode, the following message appears in the Current Faults pane for concretes associated with the managed device:
```
Changes to configuration were attempted while in an Offline Mode;some configuration has not been applied to the device.
```
  You can safely ignore this message.
Right-click the device, select Command Delivery, select Online, and then select Commit.

IP Service Activator retries sending any rejected configuration.
Run an audit to verify that IP Service Activator and the device configuration are synchronized:
1. Right-click the device and select Properties.
2. Select the Audit/Migrate property page.
3. Click the Initiate Audit button.
4. When the audit is finished, click Detach Audit. Then right-click in the new window that appears, choose Select All and copy-paste the text to another application or file.
  
  The device is ready for provisioning through IP Service Activator.