Cisco Prime Nerk 43 User Guide

							  
9-13
Cisco Prime Network 4.3.2 User Guide
Chapter 9      Manage Device Configurations and Software Images
  Managing Device Software Images
Step 9Click Finished. You are redirected to the Jobs page, where you can check the status of the distribution 
job.
NoteDistribution fails if a timeout occurs after 30 minutes. You can view the job results for 
information on why the distribution failed. Remember to delete older images and packages from 
the staging directory.
File System Clean Up
While performing upgrade analysis, if the available storage space in the device is lesser than the selected 
image size, then the user can increase the storage space by following the procedure provided below:Install Add 
Package(s)(Optional) Adds packages during distribution for Cisco IOS XR devices.
NoteWhile adding tar file(s) in the Select Packages page of the wizard, you 
can select the Install Add Package(s) and Schedule Activation check 
boxes separately and then schedule the jobs.
NoteIf you have selected pie files in the Select Packages page in the wizard, 
CCM generates a tar file, which will be copied and added to the IOS XR 
devices.
Schedule 
Activation(Optional) Starts an activation job once the images or packages are distributed 
(immediately or at future time). For multiple devices, we recommend that you 
perform the activation separately from the distribution. Not applicable to ONU 
image distribution.
Process For multi-device jobs, controls the job processes for both distribution and 
activation. If you chose Sequentially, you can also do the following:
Specify the order in which the operations should be processed, by moving 
the items up and down in the Reorderable Rows box.
Stop the job if an error is encountered by checking the Stop if an error 
occurs check box.
NoteIf the job includes a reload, choose Sequentially. Otherwise, routers in 
the connectivity path of other routers may reload and cause problems.
Commit Commits the packages after activation for Cisco IOS XR devices.
Warm Upgrade (For Cisco IOS only) Activates the Warm Upgrade feature to reduce the device 
downtime during the distribution process.
ISSU Activates in-service software upgrade (ISSU) to update the router software with 
minimal service interruption.
For information on devices that support ISSU, see the Cisco Prime Network 4.3.2 
Supported VNEs - Addendum. For its Supported Protocols see the Support for 
Change and Configuration Management in 4.3.2 tables. Field Description 
						

							  
9-14
Cisco Prime Network 4.3.2 User Guide
EDCS-1524415
Chapter 9      Manage Device Configurations and Software Images
  Managing Device Software Images
Step 1Click the Action link under the Delete Images option in the Select Storage page. This opens the Delete 
Image Table window with a list of files.
Step 2Check the check box near each file to select the files to be deleted in the Delete Image Table window. 
Step 3Click Apply. This deletes the files that are selected, thus increasing the storage space. 
NoteYou can view the increased storage space by clicking the Upgrade Analysis Result option in the Select 
Storage page without repeating the upgrade analysis process.The selected files in the Action window 
are actually not deleted when you click the Apply button. File deletion in device happens only when you 
schedule the distribution job.
Activating Cisco IOS Software Images
These topics describe the tasks you can perform from the Activate page:
Activating Cisco IOS Software Images
Activating After Performing Boot Priority Modification for Cisco StarOS Devices
When a new Cisco IOS image is activated on a device, it becomes the running image on the disk. 
Deactivated images remain on the disk to be removed by a user. Older images are automatically 
deactivated.
Before You Begin
Make sure you have the permissions to perform the activate operation. You will not be allowed to 
schedule an activation job, if you do not have permissions.
Distributing and activating the images should not be done from standby or alias boot flash. For example, 
for Cisco Catalyst 6500 Virtual Switching System (VSS), you must use the images from sup-boot disk 
for activation. Similarly, for Cisco ASR 903 Series Aggregation Services Routers, you must use the 
images from boot flash for activation.
Activating Cisco IOS Software Images
To activate a Cisco IOS image on a network element:
Step 1Choose Images > Activate.
Step 2From the Cisco Devices tab, choose IOS by activation method (IOS by Images or IOS by Devices). It 
is often easier to start with devices due to the sometimes cryptic nature of software image names. In this 
example we start with devices.
Step 3CCM displays all managed devices. It also displays the images that are currently running on the devices. 
You can filter by device name, IP address, element type, running image, or software version.
a.To choose devices of a specific device group, click Select Groups in the table header. Click the 
hyperlinked device group name to view the list of devices that belong to the group.
b.Select the required device group in the Device Groups page and click OK. 
NoteIf you selected CPT devices, upon choosing the devices, CCM directs you to the Schedule Activation 
page directly. You will not be able to choose specific images for CPT devices.  
						

							  
9-15
Cisco Prime Network 4.3.2 User Guide
Chapter 9      Manage Device Configurations and Software Images
  Managing Device Software Images
c.Choose one or more devices and click Next. CCM displays all images or packages which are valid 
for the selected devices from the internal image repository (for example, kickstart images for 
Cisco Nexus 5000 or Cisco Nexus 7000, and boot configs for Cisco ASR 5000). You can also 
choose From External Repository from the drop-down list (in the table header) to display the 
images or packages from the external image repository.
Step 4CCM displays all images or packages which are valid for the selected devices from the internal image 
repository. CCM displays only root level bin files for selection. 
Step 5Choose the image that you want to activate on the devices, and click Next.
Step 6CCM performs an image analysis. Check the Image Analysis page to see if analysis was successful. 
Click the icon in the Analysis column to get information about why the operation can or cannot proceed.
If it cannot proceed, you will not be permitted to continue. Otherwise, click Next.
Step 7Enter the scheduling information in the Schedule Activation page. By default, jobs are scheduled to run 
as soon as possible.
NoteThe time you specify here to schedule the activation job is the gateway time.
Step 8Enter the e-mail ID(s) to which to send a notification after the scheduled activation job is complete. For 
two or more users, enter a comma-separated list of e-mail IDs. A notification e-mail is sent based on the 
e-mail option specified in the Image Management Settings page.
Step 9(For Cisco IOS only) Activate the Warm Upgrade option, which allows a Cisco IOS image to read in 
and decompress another Cisco IOS image and transfer control to this new image (thus reducing the 
downtime of a device during planned software upgrades and downgrades). 
Step 10Check the ISSU option, to update the router software with minimal service interruption.
Step 11Click one of the following to specify the operation mode, if you have selected two or more devices in 
the Select Devices page.
In Parallel—Activates all packages for the devices at the same time. 
Sequentially—Allows you to define the order of the devices to activate the packages for.
Step 12Click Finished to schedule the activation.
SymbolDescription
In  Device  Status  Column In Distribution Upgrade Analysis Column 
or Activation Analysis Results
Device is available for upgrade analysis and 
distribution. Device passed without warnings.
Device is not available for upgrade analysis or 
distribution. Most likely the device is in the 
Maintenance investigation state or the Unreachable 
communication state. Click the device hyperlink and 
open the device properties popup to see details about 
the device. Device passed with warnings. Click 
the icon to get more information.
n/a Device did not pass analysis. Click 
the icon to get more information. 
						

							  
9-16
Cisco Prime Network 4.3.2 User Guide
EDCS-1524415
Chapter 9      Manage Device Configurations and Software Images
  Managing Device Software Images
Activating After Performing Boot Priority Modification for Cisco StarOS Devices
To modify boot priorities for Cisco StarOS devices and then perform activation:
Step 1Choose Images > Activate > IOS and the activation method (by Devices). 
Step 2Choose the Cisco StarOS device family from the table header. CCM displays all managed Cisco StarOS 
devices. It also displays the images that are currently running on the devices. You can filter by device 
name, IP address, element type, running image, or software version.
Step 3Select a Cisco StarOS device, choose the Perform Edit Boot Priorities option from the drop-down 
menu in the table header, and then click Next. The Select Boot Config page appears.
Step 4Click the Edit Boot Priorities hyperlink. The Current Boot Priorities table lists the existing boot 
configuration files with their priorities.
Step 5Provide the following inputs to set up and fetch the desired boot priorities:
Number of boot priority entries to be maintained. Value should be in the range of 1-10.
Boot priority number to start with. Value should be in the range of 1-100. Boot priority starting value 
should be greater than or equal to the number of boot priorities to be maintained.
Step 6Click Go to generate boot priorities based on the inputs provided. The modified boot priorities are listed 
in the table below.
Step 7You can choose to perform one of the following for each row in the table:
Edit—Modify the boot priority value, the image name, and the configuration file, if required. The 
modified boot priority value should be unique.
Delete—Delete the boot configuration priority.
Add Row—Add boot priorities to the existing list. CCM generates boot priority values based on the 
inputs provided. Note that only the top ten boot priorities are considered for the device.
Step 8Click Save. A dialog box appears listing the existing and the modified boot priorities for your 
confirmation.
Step 9Click Save to confirm and apply the boot priority changes.
Step 10You can then schedule the activation as explained in Activating Cisco IOS Software Images, page 9-14.
Activate OLT Images
Step 1Choose Images > Activate.
Step 2Select OLT from the drop-down list. Click Next.
Only one image is present in the OLT device. Upon performing the activation operation, the OLT image 
present in the device is activated. 
You will be directed to the schedule page.
Activate ONU Images in Bulk
OLT images can be activated using two modes—Manual or Auto. Using the Auto mode, you can activate 
an image that is marked as the default image. However, using the Auto mode, you can change the image 
configuration and then activate the image on the selected device. 
						

							  
9-17
Cisco Prime Network 4.3.2 User Guide
Chapter 9      Manage Device Configurations and Software Images
  Managing Device Software Images
Step 1Choose Images > Activate.
Step 2From the Cisco Devices tab, choose IOS by activation method (IOS by Images or IOS by Devices). It 
is often easier to start with devices due to the sometimes cryptic nature of software image names. In this 
example we start with devices.
Step 3Prime Network displays all managed devices. It also displays the images that are currently running on 
the devices. You can filter by device name, IP address, element type, running image, or software version.
a.To choose devices of a specific device group, click Select Groups in the table header. Click the 
hyperlinked device group name to view the list of devices that belong to the group.
a.Select the required device group in the Device Groups page and click OK. 
a.Choose one or more devices and click Next. Prime Network displays all images or packages which 
are valid for the selected devices from the internal image repository. 
Step 4Choose the image that you want to activate on the devices. Choose Bulk Upgrade from the drop-down 
list and then choose the type of mode. Click Next. The following combinations are possible:
Bulk Upgrade and Manual Mode
Bulk Upgrade and Auto Mode
Bulk Upgrade and Manual Mode
Step 1From the Selected OLTs for Manual Upgrade pane, click the Configure ONU Images hyperlink. This 
window displays the ONU images that are present in the OLT device. 
Using this window, the image properties can be configured. To configure image properties, click the 
respective cell in the table, and change the value. Click Save. 
Step 2Choose an image and click Manual Upgrade. Set the slot number, PON number, and ONU ID to which 
the selected image must be applied. To apply the image on all slots, PONs, or ONUs, select All. The 
image is subsequently applied to all ONUs which have the upgrade mode set to Off in the device. 
Step 3Click Commit or Activate, as required. Clicking Commit will activate the image when the ONU is 
restarted. Clicking Activate will active the image immediately. If you choose neither Activate nor 
Commit, the image will overwrite the existing inactive image. Click Manual Upgrade. You are 
redirected to the original pane.
Step 4Click Next. 
You are redirected to the Schedule Activation job page. 
Bulk Upgrade and Auto Mode
Step 1The selected OLTs appear in the Selected OLTs for Auto Upgrade pane. Set the slot and PON to which 
you want the image to be activated. 
Auto—An ONU profile can have several images, of which only one is default. When you activate 
the image in Auto mode, only the image which is the default image for the selected ONU profile is 
applied.
Planned—The image with which the software version matches with that of the selected ONU is 
applied. 
To configure image properties, click the respective cell in the table, and change the value. Click Save. 
						

							  
9-18
Cisco Prime Network 4.3.2 User Guide
EDCS-1524415
Chapter 9      Manage Device Configurations and Software Images
  Managing Device Software Images
Step 2Click Next.
You are directed to the Schedule Activation job page. 
Activate ONU Image Individually
Step 1Choose Images > Activate.
Step 2Choose an OLT image and click Next.
Step 3From the Select ONU pane, set the slot, PON, and ONU and click on Show ONU Image hyperlink. The 
Show ONU Images dialog box displays the list of images that can be activated for the selected ONU. 
Step 4From the Show ONU Images dialog box, choose an image. Of the two images that are displayed, you 
must choose an image that is currently not active. 
Step 5Click Next.
You are directed to the Schedule Activation job page. 
Activate Nexus OS Image Individually
For Nexus devices you can distribute two images such as System image and Kickstart image. if you want 
to distribute any image to Nexus device (Except Nx9k), in the Select image page, select either of any 
one of the image and in Select Compatible image corresponding compatible image will be shown. This 
is optional page. This page is applicable only for Nexus device.
Step 1Choose Images > Activate.
Step 2Choose an Nexus device and click Next.
Step 3From the Select Image pane, set the slot, PON, and ONU and click on Show ONU Image hyperlink. The 
Show ONU Images dialog box displays the list of images that can be activated for the selected ONU. 
Step 4From the Show ONU Images dialog box, choose an image. Of the two images that are displayed, you 
must choose an image that is currently not active. 
Step 5Click Next. You are directed to the Schedule Activation job page.
Performing Cisco IOS XR Software Package Operations
NoteWe recommend that you do not commit the package change until the device runs with its 
configuration for a period of time, until you are sure the change is appropriate. In that way, the 
change is not yet persisted across device reloads.
These topics explain how to perform package operations:
Notes on Cisco IOS XR Packages, page 9-19
Adding Cisco IOS XR Packages, page 9-19 
						

							  
9-19
Cisco Prime Network 4.3.2 User Guide
Chapter 9      Manage Device Configurations and Software Images
  Managing Device Software Images
Activating, Deactivating, and Deleting Cisco IOS XR Packages, page 9-20
Synchronizing and Upgrading Satellites for Cisco ASR 9000 Devices, page 9-22
Committing Cisco IOS XR Packages Across Device Reloads, page 9-23
Rolling Back Cisco IOS XR Packages, page 9-24
Notes on Cisco IOS XR Packages
Package management includes the add, activate, deactivate, commit, and rollback operations on 
Cisco IOS XR devices. Before you perform any of these operations, read the following:
When doing a version upgrade (which upgrades the core package and involves a router reload) on a 
Cisco IOS XR device, all of the packages on the router should be upgraded at the same time, as part 
of the same job. For example, if the c12k-mini, c12k-mgbl, c12k-mpls, c12k-k9sec, and c12k-mcast 
packages are on the router at version 3.4.1, when upgrading to version 3.5.0, all of the packages 
must be upgraded at the same time to version 3.5.0.
NoteAn upgrade pie is required only when you upgrade Cisco IOS XR devices from version 3.x to 
4.x. You must deactivate and remove the upgrade pie, if you wish to perform any install 
operations, including the install commit operation on the devices upgraded from 3.x to 4.x. 
When upgrading the core router package (such as c12k-mini or comp-hfr-mini), the manageability 
package (such as c12k-mgbl or hfr-mgbl-p) must be upgraded at the same time to ensure that the 
router remains manageable after the reload.
Cisco IOS XR routers support the clear install rollback oldest x command, that allows you to 
manage the number of rollback points maintained on the router. Executing this CLI command 
periodically on the router allows you to limit the number of rollback points. When executing this 
command, you must ensure that at least one valid rollback point is always maintained to enable CCM 
to show the package status correctly. We recommend that you maintain about 20 rollback points on 
the router. 
CCM does not support upgrading a router running Cisco IOS software to Cisco IOS XR software. 
For more information, refer to the System Management Configuration Guide for the Cisco IOS XR 
release and device of interest.
Adding Cisco IOS XR Packages
Image Management supports package addition as a separate operation for Cisco IOS XR devices. To 
complete the package management life cycle, Image Management supports adding a package from a pie 
file and a tar file, which is already present in the Cisco IOS XR device storage.
Before you begin:
Make sure you have the permissions to perform package addition. You will not be allowed to schedule 
a package addition job, if you do not have permissions.
To add packages for Cisco IOS XR devices:
Step 1Choose Images > Package Add. The Package Add wizard displays all the Cisco IOS XR devices in the 
Select Device(s) page. 
Step 2Select a device and click Next to open the Select Package(s) page. CCM displays all the packages 
available for the selected device. 
						

							  
9-20
Cisco Prime Network 4.3.2 User Guide
EDCS-1524415
Chapter 9      Manage Device Configurations and Software Images
  Managing Device Software Images
Step 3Choose the package(s) that you want to add for the selected device and click Next to open the Schedule 
Package Addition page in the wizard. 
Step 4Enter the scheduling information. By default, jobs are scheduled to run as soon as possible. 
NoteThe time you specify here to schedule the package addition job is the gateway time.
Step 5If you have selected two or more devices in the Select Devices page, click one of the following to specify 
the operation mode:
In Parallel Order—Add packages for all devices at the same time.
In Sequential Order—Allows you to specify the order of the devices to import the packages for.
Step 6Enter the e-mail ID(s) to which to send a notification after the scheduled package addition job is 
complete. For two or more users, enter a comma-separated list of e-mail IDs. A notification e-mail is 
sent based on the e-mail option specified in the Image Management Settings page.
Step 7Click Finished. CCM schedules the job and redirects you to the Jobs page, where you can monitor the 
status of the job.
Activating, Deactivating, and Deleting Cisco IOS XR Packages
NoteFor Cisco IOS XR devices, we recommend that you do not commit the package change until the device 
runs with its configuration for a period of time, until you are sure the change is appropriate. In that way, 
the change is not yet persisted across device reloads.
Before You Begin
If you are doing a Cisco IOS XR version upgrade (which upgrades the core package), see Managing 
Device Software Images, page 9-3 for information about other packages that you should upgrade at 
the same time.
To activate or deactivate a Cisco IOS XR package, or delete a Cisco IOS XR package from a device:
Step 1Choose Images > Activate > IOS-XR and the activation method (by Packages or Devices.). It is often 
easier to start with devices due to the sometimes cryptic nature of software image names. In this example 
we start with devices.
Step 2CCM displays all managed devices. (It also displays the packages that are currently running on the 
devices.) From this page you can also view the running package of the Cisco IOS XR device.
a.To choose devices of a specific device group, click Select Groups. In the Device Groups page, you 
can view the user-defined device groups. Click the hyperlinked device group name to view the list 
of devices that belong to the group. See Setting Up CCM Device Groups, page 3-17 for more 
information on user-defined device grouping.
b.Select the required device group in the Device Groups page and click OK. 
c.Choose one or more devices and click Next. CCM displays all packages which are valid for the 
selected devices. You can filter your results by package name and version.
d.Choose the packages that you want to activate on the devices, and click Next.  
						

							  
9-21
Cisco Prime Network 4.3.2 User Guide
Chapter 9      Manage Device Configurations and Software Images
  Managing Device Software Images
Step 3Specify the operations you want to perform. You can perform different operations on different devices 
or the same operation on all devices (by selecting the desired operation from the Use the following 
Operation for all Packages drop-down list in the table header). When you select a device, CCM will 
display all of the packages that are installed on the device. 
a.Choose a package operation for each package. Cisco IOS XR packages can be removed from a 
device only if they have been deactivated. If you want to apply the same operation to all packages, 
choose the operation from the Use the following Operation for all Packages drop-down list in the 
table header, and click Apply.
b.(Optional) Check Test Only to run a test of the activation (or deactivation) procedure on the device. 
This will not change the real device configuration. (This is similar to using the Compatibility Check 
option in the rollback process.)
c.Click Next. The Package Analysis page is displayed. Check the Package Analysis page to see if 
analysis was successful. Click the icon in the Analysis column to get information about why the 
operation can or cannot proceed (it will be one of the icons listed in Table 9-1 on page 9-9). If it 
cannot proceed, you will not be permitted to continue. Otherwise, click Next.
Step 4Enter the scheduling information. By default, jobs are scheduled to run as soon as possible.
NoteThe time you specify here to schedule the activation job is the gateway time.
Step 5Enter the e-mail ID(s) to which to send a notification after the scheduled activation job is complete. For 
two or more users, enter a comma-separated list of e-mail IDs. A notification e-mail is sent based on the 
e-mail option specified in the Image Management Settings page.
Step 6Check the ISSU option, to update the router software with minimal service interruption. For information 
on devices that support ISSU, see the Cisco Prime Network 4.3.2 Supported VNEs - Addendum. For its 
Supported Protocols see the Support for Change and Configuration Management in 4.3.2 tables.
Step 7Check the Commit check box to commit the packages after activation.
NoteWe recommend that you do not commit the package change until the device runs with its 
configuration for a period of time, until you are sure the change is appropriate. In that way, the 
change is not yet persisted across device reloads.
Step 8Click one of the following to specify the operation mode, if you have selected two or more devices in 
the Select Devices page.
In Parallel—Activates packages for all devices at the same time. 
Sequentially—Allows you to define the order of the devices to activate the packages for.
Step 9Click Finished to schedule the activation. 
Step 10After the job completes:
For Test Only jobs, repeat this procedure to activate the packages. 
If you activated or deactivated a Cisco IOS XR package, remember to commit your changes. 
However, we recommend that you do not commit the package change until the device runs with its 
configuration for a period of time, until you are sure the change is appropriate. In that way, the 
change is not yet persisted across device reloads. See Committing Cisco IOS XR Packages Across 
Device Reloads, page 9-23. 
						

							  
9-22
Cisco Prime Network 4.3.2 User Guide
EDCS-1524415
Chapter 9      Manage Device Configurations and Software Images
  Managing Device Software Images
Synchronizing and Upgrading Satellites for Cisco ASR 9000 Devices
CCM provides satellite support for Cisco ASR 9000 devices. Satellites are used to enhance performance 
bandwidth of Cisco ASR 9000 devices. Each satellite is a Cisco IOS device connected to the 
Cisco ASR 9000 device. Multiple satellites can be connected to a single Cisco ASR 9000 device and all 
communications to the satellites happen only through the Cisco ASR 9000 device. Each satellite has its 
own configuration and software image.
CCM provides the following support for Cisco ASR 9000 device with satellites:
Synchronization of all satellites together.
Activation of the satellite pie image on Cisco ASR 9000 device with and without synchronization 
of satellites. You must run a CLI/XML command to check for compatibility and then push the image 
to the remote satellite.
Synchronize All Satellites Without Performing an Activation
To synchronize all satellites together without activation:
Step 1Choose Images > Activate > IOS-XR and the activation method (by Devices). 
Step 2Choose the Cisco ASR 9000 device family and the Sync Satellites option from the Select Operations 
drop-down menu in the table header.
CCM displays all managed Cisco ASR 9000 series devices having satellites. (It also displays the 
packages that are currently running on the devices.)
Step 3Click Next to schedule the synchronization for all the satellites together. You cannot select a particular 
satellite for synchronization. The Select Operation function is not applicable for the Sync Satellites 
option.
Step 4In the Schedule Activation page, provide the scheduling information for synchronization of all satellites.
NoteThe time you specify here to schedule the activation job is the gateway time.
Step 5Check the Sync Satellite(s) check box and click Finished. The Sync Satellite(s) check box is available 
only for Cisco ASR 9000 devices having satellites.
Activate Satellite Image on Cisco ASR 9000 Device With or Without Synchronization
To activate a satellite image on the Cisco ASR 9000 device with/without satellite synchronization:
Step 1Choose Images > Activate > IOS-XR and the activation method (by Devices). 
Step 2Choose the Cisco ASR 9000 device family and the Activate and/or Sync Satellites option from the 
Select Operations drop-down menu in the table header.
Step 3Perform Step 3 through Step 7 in Activating, Deactivating, and Deleting Cisco IOS XR Packages, 
page 9-20 topic.