2 Handling a Cisco IOS Upgrade

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

Prerequisites

Before performing the Cisco IOS 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 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 the discussion about audit trails in IP Service Activator System Administrator's Guide.
Stop all provisioning on the device.
Unmanage the device.

Upgrading the Cisco IOS

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

Post-upgrade Tasks

After performing the Cisco IOS 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.
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/IPServiceActivator/AuditTrails/npCisco.audit.log
  
  For more information on 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 the "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 once it is debugged. To access the Network Processor logs to confirm processing of the configuration after managing the device:
  /opt/OracleCommunications/IPServiceActivator/logs/networkprocessor.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.
Change the command delivery mode for the device to online:

Right-click the device, select Command Delivery, select Online, then select Commit. IP Service Activator will retry 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.
  
  Compare this audit with the audit generated in the "Prerequisites" step. Use similar steps as given above to reconcile any new discrepancies.

Note:

If the audit fails and the post-upgrade audit results show discrepancies between the IP Service Activator configuration and the device configuration, you must verify and update the Cisco IOS options using the IP Service Activator Cisco IOS Cartridge configuration utility. This tool shows you the options available for your device and IOS combination. For more information, see "Cisco Cartridge Configuration Utility". For more information about Device Audit Color Codes, see IP Service Activator online Help. For additional help, you can contact Oracle Global Customer Support.