cc/td/doc/product/rtrmgmt/cw2000/cw2000e/e_2_x/rm_2_0
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Software Management

Software Management

The Software Management application helps you save time and effort when upgrading the devices in your network inventory. This chapter describes a common software management workflow scenario.

The software management tasks include:

You can use the software management tasks to perform the following:

Depending on the network complexity, you can configure upgrades for groups of devices to the same or different software images. You can specify these groups using your static and dynamic views and search criteria or some other selection criterion such as running software version.
Software Management maintains information about the software image. Using this information, this application can determine, for a given hardware configuration, the software image that can run on the hardware, whether the device has enough DRAM or Flash memory, and so on.
Software Management also keeps track of each device's image history; if you upgrade to a new image, you have a record of what has been installed on the device. This enables you to "roll back" to the previous image if needed.
Software Management compares the hardware requirements of images available in the Library and CCO with the device hardware, and recommends only images that satisfy those requirements. Hardware requirements include Flash memory, random-access memory (RAM), boot ROM, and so on.
Software Management lets you download a software image from CCO or another system device, or add an image from various types of removable media. You can then validate the image and store it in the software library.
Software Management provides upgrade status reports. It also reports on deployed system software for switches: firmware revisions, software revisions, and cards (ATM, FDDI, Token Ring, and so on).

The following sections are presented in this chapter:

For detailed information on Software Management, refer to the online help.

Software Management Change Process

The following sections describe a typical software management workflow. In this scenario, the network administrator performs the necessary steps to set up, identify, plan, and execute a software upgrade for a group of devices, then performs the necessary maintenance tasks. Figure 10-1 shows the Software Management workflow.


Figure 10-1: Software Management Workflow



Setup

Setting up your environment is crucial to successfully update your software. Setting up your environment includes:

For a complete description of the required tasks, refer to the online help.

Adding Images to Your Software Library

The Add Image to Library function lets you import images from all Software Management-supported devices in your network into the software image library. This function shows the images running on the network and the devices running each image. You can select any image to import into the software image library.

Use this function and the Synchronize Report option to ensure that the images running on your network always exist in the software image library.


Note This function does not support ATM, FDDI, CDDI, Token Ring modules on Catalyst devices, or 700 Series devices.

Scenario: You want to add images running on devices on your network to your software image library.

To create a baseline of your software library, perform the following steps:

Step 1 Select Tasks > Software Management > Add Image to Library. (See Figure 10-2.)


Figure 10-2: Select Image Source Dialog Box


Step 2 Select Network, then click Next.

The Select Device Type dialog box displays network options. (See Figure 10-3.)


Figure 10-3: Select Device Type Dialog Box


Step 3 Select the device type, then click Next.

The Network Baseline Status Summary displays the valid software images and devices on which they are running. (See Figure 10-4.)


Figure 10-4: Network Baseline Status Summary


Step 4 Click Update to display summary status progress, until devices processed are completed. (See Figure 10-5.)


Figure 10-5: Network Baseline Status Summary


Step 5 Click Next.

The Network Baseline dialog box displays a summary of valid software images and the devices on which they are running.

Step 6 Click Next.

The Verify Network Baseline dialog box appears. (See Figure 10-6.)


Figure 10-6: Verify Network Baseline Dialog Box


Step 7 Click Next to continue.

The Job Control Information dialog box appears.

Step 8 Enter the job description, optional e-mail address, and download time, then click Finish.

The Import Image Summary appears. (See Figure 10-7.)


Figure 10-7: Import Image Summary


Step 9 Make a note of the job identification number. You will use this number to track the job progress.

Step 10 Click Browse Job Status to display the Job Status Report. (See Figure 10-8.)


Figure 10-8: Job Status Report


Step 11 Click the job identification number for this job to display job details.

Use this report to move the images to the software image library.

Step 12 Click Close to close the report.

Synchronizing the Images in Your Software Library

The Schedule Synchronization Job option allows you to specify the time and frequency of the software synchronization job. This job finds Software Management-supported devices that are running software images not in the software image library.

Scenario: To synchronize the running images and the software image library, you schedule a synchronization job. This job generates a report of devices that are running images not in the library. You can then optionally add these images to the library.

To schedule the synchronization job, perform the following steps:

Step 1 Select Admin > Software Management > Schedule Synchronization Job.

The Schedule Periodic Job for Synchronization Report dialog box appears. (See Figure 10-9.)


Figure 10-9: Schedule Periodic Job for Synchronization Dialog Box


Step 2 Select from the drop-down list boxes:

Step 3 Click Finish.

A confirmation message appears.

To view the Synchronization report, perform the following steps:

Step 1 Select Tasks > Software Management > Synchronization Report.

The Synchronization Report appears. (See Figure 10-10.)


Figure 10-10: Synchronization Report


Step 2 Initiate importing images by clicking Synchronize Cisco IOS Images or Synchronize Catalyst Images.

The Image Synchronization report appears in the original browser window. (See Figure 10-11.)


Figure 10-11: Image Synchronization Report


Step 3 Click Next.

The Verify Synchronization summary appears. (See Figure 10-12.)


Figure 10-12: Verify Synchronization


Step 4 Click Next.

The Job Control Information dialog box appears. (See Figure 10-13.)


Figure 10-13: Job Control Information Dialog Box


Step 5 Select from the drop-down list boxes:

Step 6 Click Finish.

The Image Import Summary appears. (See Figure 10-14.)


Figure 10-14: Image Import Summary


Step 7 Click Browse Job Status.

Step 8 Click the job identification number for this job to display job details.

Use this report to move the images to the software image library. See online help for more information.

Creating an Approver List

You can assign different people to perform different steps of the software upgrade process. This is done using the Create Approver List option to create one or more Maker Checker approver lists.The Maker Checker feature allows you to require job upgrade approvals before running a scheduled job. It enforces the approval process by sending upgrade job requests via e-mail to the individuals who authorize network changes. For example:

Scenario: You decide to use the Create Approver List option to create a list of people who are authorized to approve image upgrades.


Note Before you begin, use the Add Users option to add approver names to the Users admin option.

To create an approver list, perform the following steps:

Step 1 Select Admin > Software Management > Create Approver List.

The Create Approver List dialog box appears. (See Figure 10-15.)


Figure 10-15: Create Approver List Dialog Box


Step 2 Assign a name to the list, then click Next.

Step 3 Use this dialog box to do the following:

Step 4 Click Finish.

Identification

Identification means:

Identifying the Required Change

To identify the required change, you must determine which new features or fixes are available. The following resources are available to you:

Identifying the Effects of a Change

Consider the ramifications of the changes you are planning. Some of the factors you should consider are presented in the following sections.

Temporary Network Disruption

Depending on when and how you schedule your upgrade, you might disrupt network operation. Schedule the reboot to accommodate minimum downtime for your users. Make the appropriate preparations and notify users of possible disruption.

RAM and Flash Memory Requirements

Scenario: Before you perform an upgrade, you must ensure that RAM and Flash memory are sufficient.

To determine memory sizes, perform the following steps:

Step 1 Select Tasks > Inventory > Hardware Report.

The Hardware Report dialog box appears. (See Figure 10-16.)


Figure 10-16: Hardware Report Dialog Box


Step 2 Select device view from the Views column, click All to highlight the devices in the Devices column, then click Finish.

The Hardware Report displays information about the selected devices. (See Figure 10-17.)


Figure 10-17: Hardware Report


Step 3 Click RAM Size (MB) to sort by RAM size or Flash Size (MB) to sort by Flash memory size, then print the report. You might have to scroll to the right to view these table heading options.

Step 4 Select Tools > CCO Tools, then select either Browse CCO IOS Software or Browse CCO Switch Software, depending on the device type. You need login privileges to CCO to gain access. Browse CCO to determine the memory requirements for the images you want to upgrade.

If your device does not have sufficient RAM or Flash memory, you need to upgrade the memory before you upgrade the software image.

Summarizing the Change

You have identified the devices you want to upgrade and the upgrades that will cause memory or compatibility conflicts. You must resolve all conflicts before you prepare your final upgrade list.

Now you are ready to plan the software management workflow.

Planning

During the planning phase, consider the following:

Determining the Impact of and Prerequisites for an Upgrade

You can run the CCO Upgrade Analysis and Library Upgrade Analysis options to determine the impact of and prerequisites for deploying new software. These options allow you to compare your current network images to the images available on CCO and show you the boot ROM, Flash, RAM, and Telnet upgrades necessary for the devices you select.

Scenario: You are going to upgrade the software images on your network devices and you want to compare the images available on CCO to your current network images and thereby determine the scope of the upgrade. To do this, you use the CCO Upgrade Analysis option.


Note You
must have CCO login privileges. If you do not have a user account and password on CCO, contact your channel partner or enter a request on the standard CCO web site (www.cisco.com).

Step 1 Select Tasks > Software Management > CCO Upgrade Analysis.

The Select Filtering Criteria dialog box appears. (See Figure 10-18.)


Figure 10-18: Select Filtering Criteria Dialog Box


Step 2 Select any or all of the following filtering criteria, then click Next:

The Select Devices dialog box appears. (See Figure 10-19.)


Figure 10-19: Select Devices Dialog Box


Step 3 Select the views and devices to display, then click Next.

The Image Selection dialog box displays the images that are running on the selected devices. (See Figure 10-20.)


Figure 10-20: Image Selection Dialog Box


Step 4 Select images, then click Finish.

The Upgrade Analysis Report displays upgrade recommendations. (See Figure 10-21.)


Figure 10-21: Upgrade Analysis Report


You can switch between List Format and Table Format by clicking the appropriate button at the top of the report.

Step 5 Click Close to close the report.

Running the Library Upgrade Analysis

Scenario: Before you continue with the upgrade, you want to ensure that you have satisfied all prerequisites for the devices whose software you want to upgrade. To do this, you run the Library Upgrade Analysis option to show you the boot ROM, Flash memory, RAM, and Telnet upgrades necessary for your selected devices.

To run the Library Upgrade Analysis option, perform the following steps:

Step 1 Select Tasks > Software Management > Library Upgrade Analysis.

The Library Upgrade Analysis dialog box appears.(See Figure 10-22.)


Figure 10-22: Library Upgrade Analysis Dialog Box


Step 2 Select the image to analyze from the drop-down list box, then click Next.

The Select Devices dialog box appears. (See Figure 10-23.)


Figure 10-23: Select Devices Dialog Box


Step 3 Select the devices to upgrade, then click Next.

The Image Selection dialog box displays the images that are running on the selected devices. (See Figure 10-24.)


Figure 10-24: Image Selection Dialog Box


Step 4 Click Finish.

The Upgrade Analysis Report appears. (See Figure 10-25.)


Figure 10-25: Upgrade Analysis Report


You can switch between List Format and Table Format by clicking the appropriate button at the top of the report.

Step 5 Click Close to close the report.

Determining the Upgrade Sequence and Timing

Schedule your upgrades and reboots so you do not compromise your device path. For example, you have three devices on a path. Device A depends on Device B and Device B depends on Device C. Ensure that you reboot from the bottom of the path up so Device C is the first to reboot, followed by Device B, and then Device A. (See Figure 10-26.)


Figure 10-26: Device Path Example


Schedule your upgrades so you do not have too many devices out of service at one time. The recommended maximum number of devices you should schedule per job is 12. More than 12 devices out of service at a time could affect your network performance adversely.

Rollback Option

If you want the rollback option to be available, you must check out a backup copy of the current software image for each device you want to back up into the software library. See "Retrieving Software Images" for more information.

If you decide later to use the previous software image, you can perform or schedule a device upgrade, specifying the old revision. See "Setting Up a Software Image Upgrade" for more information.

Prerequisites

You need to know the following before you schedule your upgrades:

Use the Essentials Inventory options to determine the specifics.

Retrieving Software Images

Scenario: After you determine which devices on your network require an upgrade, you can retrieve the appropriate software images from CCO and add them to your library.

To add software images to your library, perform the following steps:

Step 1 Select Tasks > Software Management > Add Image to Library.

The Select Image Source dialog box appears. (See Figure 10-27.)


Figure 10-27: Select Image Source Dialog Box


Step 2 Select CCO, then click Next.

The Select Devices dialog box appears. (See Figure 10-28.)


Figure 10-28: Select Devices Dialog Box


Step 3 Enter the names of the devices to add to your library, then click Next.

As an alternative, you can select a view from the Views column that contains devices you want to upgrade, and select the devices from the Devices column, then click Next.

Selecting one or more devices from the Devices column identifies a subset of device software images and helps you narrow your options in subsequent dialog boxes.

The Login for CCO dialog box appears. (See Figure 10-29.)


Figure 10-29: Login for CCO Dialog Box


Step 4 Enter your CCO login name and password, then click Next.

The main CCO web site appears.

Step 5 Select the device/platform, software image, subset image, software subset image, and image to add to the library, then click Next.

The Select Images to Add to Library dialog box appears. (See Figure 10-30.)


Figure 10-30: Select Images To Add to Library Dialog Box


This dialog box verifies whether the device has enough memory for the selected image. If the device does not have enough memory, the word "Fail" appears in the Pass/Fail column. If the device does have enough memory to run the selected software image, the word "Pass" appears in the Pass/Fail column and you can proceed with the download.

Step 6 Ensure that the Download check box is selected, then click Next.

The Verify Images to Add to Library dialog box appears. (See Figure 10-31.)


Figure 10-31: Verify Images to Add to Library Dialog Box


Step 7 Verify that the information is correct, then click Schedule Download or Download Now.

If you click Schedule Download, the Job Control Information dialog box appears. (See Figure 10-32.)


Figure 10-32: Job Control Information Dialog Box


Step 8 Enter the job description and optional e-mail address, schedule the job, then click Finish.

A confirmation message appears.

If you click Download Now, a message notifies you that the job will take a while as the files are downloaded from CCO. The message also tells you how much disk space is required for the image. Click OK to continue.

Essentials downloads the software image and a confirmation message appears. (See Figure 10-33.)


Figure 10-33: Add-To-Library Summary Dialog Box


Step 9 Verify that the information is correct.

The download is complete.

Scheduling

The procedures in this section describe the tasks required to perform a software image upgrade.

Setting Up a Software Image Upgrade

Scenario: You have downloaded the required software images to your software library and you are prepared to set up your upgrade. You do not need authorization to perform this function, so you do not have Maker Checker enabled.

To set up an upgrade, perform the following steps:

Step 1 Select Tasks > Software Management > Distribute Images.

The Select Device Type dialog box appears. (See Figure 10-34.)


Figure 10-34: Select Device Type Dialog Box


Step 2 Select one of the following, then click Next. (This example is using the Cisco IOS option.)

The Select Cisco IOS Devices dialog box appears. (See Figure 10-35.)


Figure 10-35: Select Cisco IOS Devices Dialog Box


Step 3 Select Device Family, Current Cisco IOS Versions, and Boot ROM Version from the View windows, click Query to add the items to the Devices list, then select the devices.

Step 4 Click Next.

If your CCO username and password have not been added to the database, the CCO login dialog box appears. Enter your CCO username and CCO password to update the user profile, then click Next. Click Skip if you do not want images from CCO included in the recommended images list.

The Recommended Image Upgrade dialog box appears. (See Figure 10-36.)


Figure 10-36: Recommended Image Upgrade Dialog Box


To view the running status of the selected devices (running image, Flash details, and so on), click Details. The Details report appears. Click Close to close the report.

Step 5 Select the devices to upgrade, then click Next.

For each device, select the desired image upgrade. Deselect check boxes for any devices you do not want to upgrade. If you selected images located on CCO, a message informs you that the images will be downloaded to the software image library at the scheduled time before the device is upgraded. Click OK to continue.

Step 6 Verify that the information is correct, then click Next.

The Verify Image Upgrade dialog box appears. (See Figure 10-37.)


Figure 10-37: Verify Image Upgrade Dialog Box


Step 7 Check the verification status, make any necessary changes by going back to the Image Upgrade dialog box, then click Next.

The Distribution Sequence dialog box appears if more than one upgrade is being scheduled. (See Figure 10-38.)

The Job Control Information dialog box appears if only one upgrade is being scheduled. (See Figure 10-39.)


Figure 10-38: Distribution Sequence Dialog Box


Step 8 Move the upgrades up or down the distribution sequence list as desired, then click Next.

The Job Control Information dialog box appears. (See Figure 10-39.)


Figure 10-39: Job Control Information Dialog Box


Step 9 Enter the job description and optional e-mail address, schedule the job, then click Next.

The Work Order Report appears.

Step 10 Click Finish.

The Schedule Time Verification box appears. (See Figure 10-40.)


Figure 10-40: Schedule Time Verification Box


Step 11 Click Finish.

If the job was scheduled successfully, the Distribute Image Summary dialog box appears. (See Figure 10-41.)


Figure 10-41: Distribute Image Summary Dialog Box


Step 12 Click Browse Job Status to see the job details and change schedule options (if required).

The Job Details report appears. (See Figure 10-42.)

This report has two parts:


Figure 10-42: Job Details Report


Step 13 You can optionally change the schedule, then close the report.


Note When the Maker Checker option is on, you cannot change the upgrade time and date.

Setting Up a Device Upgrade

Scenario: You want to upgrade your devices, but you need the approval of your network administrator. This scenario assumes you have selected the appropriate Maker Checker option(s) using Admin > Software Management > Edit Preferences.

To set up the upgrade, perform the following steps:

Step 1 Select Tasks > Software Management > Distribute Images.

The Job Approval Information dialog box appears (See Figure 10-43.)


Figure 10-43: Job Approval Information Dialog Box


Step 2 Select the job approver from the drop-down list box and add any comments, then click Next.

The Distribute Image Summary appears. (Figure 10-44.)


Figure 10-44: Distribute Image Summary


Step 3 Click Browse Job Status.

The job status report appears. (See Figure 10-45.)


Figure 10-45: Job Status Report (Top Page Portion Only)


The approver is sent the request notification, which contains the http address used to launch the job request. The approver can open the request using any supported browser. The job request appears. (See Figure 10-46.)


Figure 10-46: Job Request (Top Page Portion)


After reviewing the request, the approver can scroll to the bottom of the page and click Approve or Reject. (See Figure 10-47.)


Figure 10-47: Job Request (Lower Page Portion)


The approval or rejection notification is sent to the job request originator. (See Figure 10-48.)


Figure 10-48: Approval Notification


Step 4 Click Close.

Job Control

Scenario: One of your company's key product teams is at a critical stage of a project. You are informed that they will be working into the night and that this would not be a good time to interrupt network operation. You have scheduled your upgrades for tonight, but you need to reschedule them.

To reschedule upgrades, perform the following steps:

Step 1 Select Admin > Software Management > Browse Job Status.

A new browser window displays the Job Status report.

Step 2 Click on an underlined job number.

The Job Details report displays information about the job and access to any tasks that might apply.

Step 3 Click Browse Jobs to change another job, or Close to close the report.

Tracking a Scheduled Software Upgrade

Change Audit lets you filter messages from Essentials applications. You can use Change Audit to filter messages from Software Management and thereby confirm that a scheduled upgrade occurred.

Scenario: At 1600, you scheduled a Software Management task to update the Cisco IOS image on routers R1 through Rn to occur at 0200 the following day. You want to confirm that the update occurred as planned.

To track a scheduled upgrade, perform the following steps:

Step 1 Select Tasks > Change Audit > Search Change Audit.

The Change Audit --- Filter Options dialog box appears. (See Figure 10-49.)


Figure 10-49: Change Audit --- Filter Options Dialog Box


Step 2 Select the views and devices, then click Next. A second Change Audit --- Filter Options dialog box appears. (See Figure 10-50.)


Figure 10-50: Change Audit --- Filter Options Dialog Box


Step 3 Select All from the Application drop-down list box; then select Custom and enter the date and time the upgrade was to occur. For this example, select 0200 and yesterday's date, then click Finish.

The Change Audit --- Searching report displays. (See Figure 10-51.)


Figure 10-51: Change Audit --- Searching Report


Step 4 Select highlighted Details text in the View Details column to view the details of a particular device.

Step 5 Select highlighted More Records text in the Grouped Records column to view records that stem from the same event.

Step 6 Click Close to close the report.

When you complete an upgrade task on Essentials, the following actions occur:

    1. [Function_Id:Job_Id] of this job is registered with Change Audit by the scheduler.

    2. The Software Management job is run by the scheduler at 0200.

    3. Software Management updates the Change Audit log. Router R1 through Rn are locked. If Software Management knows the finish times of the job for each device, it communicates them to the Change Audit log. Software Management logs information to the Change Audit log. It also sends out a root direct event.

    4. Software Management begins image update on router R1, logs to the Change Audit log, and sends out a direct event.

    5. Software Management completes the image update on router R1. Software Management logs the job details to the Change Audit log and the Software Management Details table. It also sends a direct event to Device Configuration to update the router R1 configuration.

    6. Device Configuration gets the direct event from Software Management, updates the configuration on router R1, and logs the job details to the Change Audit log and the Configuration Management Details table. It also sends a direct event announcing this configuration update.

    7. Steps 4 through 6 are repeated for all routers on the list, one at a time.

    8. When all routers are updated, Software Management updates the Change Audit log and sends an event announcing "Job Complete."

At the end of this operation, the Change Audit log will have received the following messages:

Verification

After you upgrade device software images, you should check the status of your upgrades to verify that the process has been completed successfully.

The verification options are:

Scenario: After your upgrade, you need to know the upgrade status to ensure that it was performed properly.

To verify upgrades, perform the following steps:

Step 1 Select Tasks > Software Management > Search History by Device.

The Select Devices dialog box appears. (See Figure 10-52.)


Figure 10-52: Select Devices Dialog Box


Step 2 In the Devices field, enter the names of the devices for which you scheduled an upgrade, then click Next.

Alternatively, select the view and the devices in the view for which you set up an upgrade, then click Next.

The Select Search Options dialog box appears. (See Figure 10-53.)


Figure 10-53: Select Search Options Dialog Box


Step 3 Select the date range and time, then click Finish.

The Software Modification History report appears for the selected devices. (See Figure 10-54.)


Figure 10-54: Software Modification History Report


Step 4 Verify that scheduled upgrades were performed and take corrective action, if necessary.

Maintenance

After completing the upgrade, you must clean up and prepare for future upgrades.

Library Size

The images in the software library and the history records take up space on your drives. Depending upon the capacity at your site, you need to determine the following:

Software Image Library

Scenario: You have viewed the status of your most recent upgrade and you want to clear some space on your hard drive by deleting old software images.

To delete software images from your library, perform the following steps:

Step 1 Select Tasks > Software Management > Browse Library.

The Image Summary Report opens. You can use this report in the following ways:

Caution If you delete software images from the Essentials server, you cannot restore them. You must download them from CCO or the server where your images are stored.

Step 2 Click Close to close the report.

Report Maintenance

Over time, the Job Control report can become filled with data about old, completed jobs. You should remove some of these jobs.

You should maintain history reports for at least a year. Keep at least one previous software image version for each upgrade so you can roll back to the previous version if necessary. You can optionally delete images that are two or more versions back.

This completes the chapter on Software Management.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Oct 6 12:11:25 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.