Table Of Contents
Managing Software Images
NEIM Administrative Task: Setting Up Image Management Preferences
Logging Into Cisco.com
Understanding the NEIM User Interface
Icons in the Image Browser
Roles Required to Perform NEIM Tasks
Image Repository Management
Adding Images from Vendor Websites to a Local Repository
Adding Images from a File System to a Local Image Repository
Upgrade Analysis
Image Analysis Using the Application Image Repository
Image Analysis Using a Vendor Website
Using the Image Browser
Distributing Images
Image-Centric Distribution
Device-Centric Image Distribution
Device Centric Image Distribution from an External Location
Activating an Image on the Device
Managing Cisco IOS XR Devices
Activating Cisco IOS XR Packages
Deactivating Cisco IOS XR Packages
Rolling Back Cisco IOS XR Packages
Removing Cisco IOS XR Packages
Performing Package Management Tasks
Managing Packages
Performing Rollback
Distributing Packages
NEIM Log Files
Managing Software Images
Manually upgrading your network elements to the latest software version can be an error-prone and time-consuming process. The Network Element Image Management (NEIM) feature ensures rapid, reliable software upgrades, and automates the steps associated with upgrade planning, scheduling, downloadiExpressionsng, and monitoring.
In ANA 4.0, the NEIM feature is supported for Cisco devices only.
Using NEIM, you can:
•
Analyze software upgrades; for example, you can:
–Generate Upgrade Analysis reports.
–Determine prerequisites for a new software deployment.
–Determine the hardware upgrades (device access, boot ROM, Flash memory, RAM, NVRAM and boot Flash, if applicable) required before you can perform the upgrade.
See Upgrade Analysis for more information.
•Import images into the software repository; for example, you can:
–Determine the images missing from your repository and import them into the software repository.
–Keep the repository up-to-date and periodically synchronize it with the images running on your network devices.
–Schedule an image import for a later, more convenient time.
•Distribute software images to groups of network elements; for example, you can:
–Configure upgrades for groups of network elements to the same software image or to different software images, depending on system complexity.
–Run the network element upgrade job sequentially or in parallel.
–Specify the reboot order after upgrading the network elements.
See Distributing Images and Activating an Image on the Device for more information.
Note We recommend that you verify that an image operation is correct on a single device, preferably in a lab, prior to distributing and activating a change in image on multiple devices in a production network.
•Manage packages for IOS XR devices
Along with the NEIM basic functionalities, you can perform tasks specific to Cisco IOS XR.
See Managing Cisco IOS XR Devices and Performing Package Management Tasks for more information.
NEIM Administrative Task: Setting Up Image Management Preferences
You can set the following image management parameters:
•Vendor Credentials— Credentials required to access vendor websites for NEIM tasks.
•Image Import Directory—Directory to which the imported images are saved.
See NEIM Preferences, page 14-22 for details.
Logging Into Cisco.com
Login privileges are required for all NEIM tasks that access Cisco.com. To get access, you must have a Cisco.com account. You can register by going to the following URL:
http://tools.cisco.com/RPF/register/register.do
If you do not have a user account and password on Cisco.com, contact your channel partner or enter a request on the main Cisco website.
To download the cryptographic images on Cisco.com through Software Management tasks, you must have a Cisco.com account with cryptographic access.
After getting the Cisco.com account:
Step 1 Go to the following URL: http://www.cisco.com/pcgi-bin/Software/Crypto/crypto_main.pl
The Enter Network Password dialog box appears.
Step 2 Log in with your Cisco.com account.
The Encryption Software Export Distribution Authorization Form page appears.
Step 3 Select your software from the list and click Submit.
The Encryption Software Export Distribution Authorization form appears.
Step 4 Review and complete the Encryption Software Export Distribution Authorization form and click Submit.
The following message appears:
The Cisco Encryption Software: Crypto Access Granted.
Note It takes approximately 4 hours to process your application. You cannot download the software until the entitlement process is complete. You will not receive any notification for this.
Understanding the NEIM User Interface
Figure 9-1 shows the NEIM Image browser.
Figure 9-1 Image Browser
Icons in the Image Browser
Table 9-1 explains the icons found in the Image browser.
Table 9-1 Image Browser Buttons
Icon
|
Description
|
|
Refresh the image browser.
|
|
Add images.
|
|
Edit existing images.
|
|
Delete images.
|
Roles Required to Perform NEIM Tasks
Table 9-2 lists the roles that are required to perform NEIM functions. For more information on roles, see Creating and Managing ANA User Accounts.
Table 9-2 Roles Required to Perform NEIM Functions
Task
|
Role Required
|
Add image from vendor website
|
Any of the following roles:
•Configurator
•Administrator
|
Add image from file system
|
Any of the following roles:
•Configurator
•Administrator
|
Distribute image by image
|
Any of the following roles:
•Configurator
•Administrator
|
Distribute image by network element
|
Any of the following roles:
•Configurator
•Administrator
|
Distribute image from external location
|
Any of the following roles:
•Configurator
•Administrator
|
Image distribution
|
Any of the following roles:
•Configurator
•Administrator
|
Upgrade analysis
|
Any of the following roles:
•Configurator
•Administrator
|
Activate image
|
Any of the following roles:
•Configurator
•Administrator
|
Manage packages
|
Any of the following roles:
•Configurator
•Administrator
|
Distribute packages
|
Any of the following roles:
•Configurator
•Administrator
|
Rollback
|
Any of the following roles:
•Configurator
•Administrator
|
Image Repository Management
You can maintain a copy of the images in the local repository. You can add, remove, and browse images in the repository. You can also edit and update image attributes.
The image repository stores the binary data and displays image attributes in the Image browser. The images available on vendor websites can be added to the repository.
You can add the images to image repository by:
•Adding them from vendor websites (see Adding Images from Vendor Websites to a Local Repository).
•Adding them from a file system to a local repository (see Adding Images from a File System to a Local Image Repository).
Adding Images from Vendor Websites to a Local Repository
While adding images:
•You can select a network element and download the image for the selected network element. NEIM checks to determine whether Flash and RAM available on the network element are sufficient to deploy the image. A warning message is displayed to the user about the discrepancy, if any.
•You can select an image and download the file. NEIM checks for file size and checksum before adding the image to the repository.
Algorithm for Adding Images from Cisco.com to the Image Repository
The following steps describe the algorithm for adding images from Cisco.com to the image repository:
1. Select the vendor website as the source of the image.
2. (Optional) Select a network element from the device selector.
3. NEIM provides a list of images.
4. Select the platform.
5. NEIM provides all supported versions of the platform. NEIM also displays information on the image deployment status.
6. Select the specific image version.
7. NEIM lists all the features for the selected image version.
8. Select the feature.
9. NEIM adds the selected image.
10. To add multiple images, repeat Steps 2 through 9.
11. NEIM checks to determine whether Flash and RAM available on the device are sufficient to deploy the image. A warning message is displayed to the user about the discrepancy, if any. You can still download the image from the website.
12. Provide the job details. NEIM displays the job ID as reference to the job.
To add image from vendor website:
Step 1 Go to the Tasks tab in the Inventory perspective and select Configuration drawer.
Step 2 Expand the Network Element Image Management and the Add Images nodes and double-click From Vendor Website.
Alternatively, from the main menu choose Configuration > Network Element Image Management > Add Images > From Vendor Website.
The Vendor and Network Element selection page is displayed.
Step 3 Select the vendor from the Vendor drop-down.
Step 4 (Optional) Select the network element and click Add to add it to the Selected Network Elements column.
Step 5 Click Next.
The Image Selection page is displayed.
Step 6 Select a platform
Step 7 Select a version.
Step 8 Select a feature.
Step 9 Scroll down to see the selected images.
You can add multiple images, and you can use the Clear All function to clear all the selected images.
Step 10 Click Next.
The Schedule Job page is displayed.
Step 11 Specify the following details:
•Job description.
•Start date.
If you want to perform the job immediately, click the Perform Now icon provided at the top right of the page.
•The number of times the job should be run.
•Delete interval between jobs.
Step 12 Click Finish.
Adding Images from a File System to a Local Image Repository
Use this method to add software images from a file system to the software repository.
You add an image staged on the gateway file system to the local image repository. NEIM checks for the image family, image version, and image type information before adding it to the repository. Before the image is added, the repository is checked to determine whether the selected image already exists. NEIM does not allow the addition of duplicate images to the image repository.
Algorithm for Adding Images from a File System to a Local Image Repository
The following steps describe the algorithm for adding images from file system to local image repository:
1. Select the file system as the source of the image.
2. NEIM lists available image filename and vendor.
3. You can select a file at a time.
4. Select multiple images from the list, by selecting the check box for Images.
5. NEIM validates the selected files for file size, and for image family, type, and version. The results are displayed.
6. NEIM displays all the errors that occur during the parsing.
7. You can add to the image repository only those image files for which valid information is retrieved.
8. On successful completion of the operation, image can be viewed in the repository browser.
To add image from file system:
Step 1 Go to Tasks tab in the Inventory perspective and select the Configuration drawer.
Expand the Add Images node and double-click From Vendor Website.
Alternatively, from the main menu choose Configuration > Network Element Image Management > Add Images > From File System.
The From File System window is displayed.
Step 2 Select the images to be added and click the Add icon.
A progress bar appears.
A confirmation message is displayed after the operation is complete.
Step 3 Click OK.
The images are added to the local repository.
Upgrade Analysis
Upgrade analysis feature allows you to determine if an image can be deployed on a set of network elements.
Note This feature is not applicable for devices running Cisco IOS XR software.
During analysis, NEIM fetches the attributes of the selected image and checks the amount of RAM and Flash available on the network element. This analysis is based on the network element information available in the ANA inventory. For analysis, the ANA inventory must contain information on active image on the network element, Flash memory, modules, and processor details.
NEIM assumes that while images are added to the repository, information such as minimum RAM, minimum Flash, and so on, is available in the image header. This information is stored in the image repository. NEIM cannot analyze effectively if this information is not available in the image header.
You can perform image analysis using:
•Application Image repository (see Image Analysis Using the Application Image Repository).
•Vendor website (see Image Analysis Using a Vendor Website).
Image Analysis Using the Application Image Repository
Use the Local Repository Analysis feature to analyze images in your software repository and determine the impact to, and prerequisites for, a new software deployment. This feature enables you to get the Upgrade Analysis report, which shows the required boot ROM, Flash memory, and RAM.
Image Analysis helps you answer such questions as:
•Does the network element have sufficient RAM to hold the new software?
•Have the minimum ROM version requirements been met?
•Is the Flash memory large enough to hold the new software?
Algorithm for Upgrade Analysis Using the Local Image Repository
The following steps describe the algorithm for upgrade analysis using the local image repository:
1. Select local repository as the source of image.
2. Select an image from the image repository.
3. Select a network element.
4. NEIM triggers the analysis operation.
5. NEIM generates a discrepancy report. This report contains:
–The name of the image selected.
–Active image information as obtained from the inventory.
–Available and required Flash information along with the amount of Flash that is required to upgrade, to enable you to deploy the image.
–Available and required RAM information along with the amount of RAM that is required to upgrade, to enable you to deploy the image.
To perform upgrade analysis using the application image repository:
Step 1 Go to Tasks tab in the Inventory perspective and select Configuration drawer.
Expand the Network Element Image Management node.
Step 2 Double-click Upgrade Analysis.
Alternatively, from the main menu choose Configuration > Network Element Image Management > Upgrade Analysis.
The Upgrade Analysis window is displayed.
Step 3 Select the Application Image Repository radio button and click Next.
The Device Selector is displayed.
Step 4 Select the network elements and click Next.
The Select Image page is displayed, showing the Network Element Information column that lists the network elements and the Image Information column that lists the details of images in each network element.
Step 5 Select the image from the Image Information drop down list.
Step 6 Click Next.
The Upgrade Analysis Report is displayed.
Image Analysis Using a Vendor Website
Use the Vendor Website feature to determine the impact to, and prerequisites for, a new software deployment using images that reside on vendor websites.
This option allows you to identify only images that meet certain criteria. It then analyzes the images to determine the required hardware upgrades (boot ROM, Flash memory, RAM, and access).
This option helps you answer such questions as:
•Does the device have sufficient RAM to hold the new software?
•Have the minimum ROM version requirements been met?
•Is the Flash memory large enough to hold the new software?
•Do I need to add Telnet access information for the device?
•Have I performed an upgrade path and NVRAM analysis on my Catalyst devices?
Algorithm for Image Analysis Using Cisco.com
The following steps describe the algorithm for image analysis using Cisco.com:
1. Select vendor website as the source of image.
2. Select a network element.
3. NEIM displays all the applicable images on the vendor website for the selected network element.
4. Select an image to analyze.
5. NEIM triggers the analysis operation.
6. NEIM generates a discrepancy report. A separate report is generated for each of the network elements selected for analysis. This report contains:
–The name of the selected network element.
–The name of the selected image.
–Active image information as obtained from the inventory.
–Available and required Flash information along with the amount of Flash that is required to upgrade to deploy the image.
–Available and required RAM information along with the amount of RAM that is required to upgrade to deploy the image.
To perform image analysis using vendor website:
Step 1 Go to Tasks tab in the Inventory perspective and select Configuration drawer.
Expand the Network Element Image Management node.
Step 2 Double-click Upgrade Analysis.
Alternatively, from the main menu choose Configuration > Network Element Image Management > Upgrade Analysis.
The Upgrade Analysis window is displayed.
Step 3 Select the Vendor Website radio button and click Next.
The Device Selector is displayed.
Step 4 Select the network elements and click Next.
The Select Image page is displayed, showing the Network Element Information column that lists the network elements and the Image Information column that lists the details of images in each network element.
Step 5 Select the image from the Image Information drop down list.
Step 6 Click Next.
The Upgrade Analysis Report is displayed.
Using the Image Browser
The Image browser helps you to view all the available images in the image repository and also:
•Edit the image attributes
•Search an image in repository. This is a filter-based search.
•Delete an image
You can view the following image attributes:
•Image Name
•Image Family
•Image Type
•Version
•Size
•Vendor
In the Image browser, you can do a filter operation based on image family; image type, version, size, and status; and time of update. You can sort images in repository based on image family and image types. The Refresh button refreshes the image list and displays the latest list of images.
To view the Image browser:
Step 1 Go to Tasks tab in the Inventory perspective and select Configuration drawer.
Step 2 Expand the Network Element Image Management node and double-click Image Browser.
Alternatively, from the main menu, choose Configuration > Network Element Image Management > Image Browser. The Image browser is displayed.
You can perform the following operations from the Image browser:
•Add Images—Click the Add Images icon to add image to the repository. See Adding Images from Vendor Websites to a Local Repository and Adding Images from a File System to a Local Image Repository for details.
•Edit Images—You can edit or update attributes of the images in the image repository. You can update the unknown image attributes of the images. You can edit the comment, and the values for RAM, NVRAM, BootROM version, and Flash required. To edit an image, select the image from the Image browser and click the Edit icon.
•Delete Images—Select an image from the Image browser and click the Delete icon. The selected images are immediately removed from the database.
Distributing Images
The Image Distribution feature allows you to:
•Copy the image from a specified location to a specified storage location on a network element using the TFTP protocol. We recommended that the /tftpboot subdirectory used by the TFTP server that comes with NEIM be a local disk. If this is a mounted subdirectory, you might face problems.
•Activate the copied image on the network element.
Note This feature is applicable only for devices running Cisco IOS software. For Cisco IOS XR devices, you must go to NEIM > Package Management > Distribute Packages.
NEIM supports both monolithic and patch images distribution on network elements. The network elements with multiple upgrade entities are supported. The module cards or entities with independent IP address are identified as separate network elements.
NEIM uses the instrumentation embedded in the network element and information such as such as, minimum RAM or minimum Flash, encapsulated in image headers, to perform image distribution on the network element.
Image Distribution may be done in two ways:
•Distribution by image. See Image-Centric Distribution for details.
•Distribution by network element. See Device-Centric Image Distribution for details.
Image-Centric Distribution
In Image-Centric mode, you can select an image from a local repository or an external location and perform distribution on one or more network elements. You can specify a destination partition on the device where the image needs to be copied. This is useful when you have to distribute the same image to multiple network elements.
You cannot use this procedure to upgrade:
•Bootloader for IOS
•Catalyst modules other than the Supervisor module
After the image distribution, you can do either of the following:
•As part of image distribution, activate the copied image on the network element to ensure that the network element is using the copied image.
•Schedule the image activation as a different job after the image distribution.
Image-Centric Distribution Using a Local Repository with Image Activation
You can create an image distribution job to deploy and activate the selected image onto a set of managed devices. The images are copied from the local repository.
Algorithm for Image-Centric Distribution Using Local Repository with Image Activation
The following steps describe the algorithm for Image-Centric distribution using local repository. After the image distribution, activation of the image on the selected network elements will be performed as part of the same job:
1. Select an image in the local repository.
2. Select one or more network elements for the distribution.
3. NEIM filters all the irrelevant network elements based on the selected image type and image family.
4. NEIM displays the available upgradeable modules and the storage partitions (if any) on the network element for the image distribution.
5. NEIM verifies the suitability of image for the selected storage destination and displays status of verification operation. NEIM checks on network element type and it includes other generic checks such as valid licensing, Flash overwrite.
6. NEIM displays the details of the verification result.
7. NEIM prevents the user from proceeding further with the distribution operation for the network element. All such network elements are removed from the list of network elements. The Verification report contains all warnings and messages generated during the verification.
8. Apply the job policy and schedule the distribution operation job.
9. NEIM generates a work order report containing a new image selected for distribution, network elements selected and existing image on the selected network elements, image verification details for each network element, and job control options as defined for the job.
10. NEIM schedules the job and displays the job ID as reference to the job.
Image-Centric distribution fails if:
•The job schedule service fails.
•All network elements in the job fail during verification.
•The image activation cannot be scheduled due to failure of image copy operation.
•The image copy operation fails and activation is not performed. If the image distribution is successful for a subset of the selected network elements, then the image is activated only on those network elements.
Image-Centric Distribution Using an External Repository with Image Activation
You can create an image distribution job to deploy, and activate the selected images on a set of managed devices. The images are copied from the external repository.
Algorithm for Image-Centric Distribution Using External Repository
1. Select image in external location.
2. Provide the details of the image residing on external locations.
3. Select one or more network elements for the distribution.
4. NEIM will not perform compatibility checks for the selected image.
5. NEIM will display the available upgradeable modules and all the storage partitions (if any) on the device.
6. Choose a storage partition for the selected image.
7. Define the job policy and schedule the distribution operation job.
8. NEIM will not verify based on the selected image, but generic checks, such as valid licensing, are performed.
9. NEIM generates a work order comprising of new image selected for distribution, network elements selected, existing images on the selected network elements, and job control options as defined for the job.
10. The report for this flow always contains a warning that image compatibility is not checked.
11. NEIM schedules the job and displays the job ID as reference to the job.
12. During job execution, NEIM uses TFTP to transfer images from external location to the device.
To perform Image-Centric distribution:
Step 1 Go to the Tasks tab in the Inventory perspective, and click the Configuration drawer.
Step 2 Expand the Network Element Image Management node and the Image Distribution node.
Step 3 Double-click By Image.
The Image Selection page is displayed.
Alternatively, from the main menu, choose Configuration > Network Element Image Management > Image Distribution > Distribute by Image.
The Image Selection page is displayed.
Note Cisco IOS XR packages will not be displayed here.
Step 4 Select the image and click Next.
The Device Selector is displayed.
Step 5 Select network element and click Next.
The Storage Selection page is displayed. It has the following fields:
•Device—Device name.
•Module—The software you are upgrading; for example, the OS or boot loader.
•Storage—Location at which to store the image. Lists the storage available in the device.
•Error—Errors, if any. Click near the icon to get details. If you have selected an incompatible device, an error is displayed.
Step 6 Select the storage and click Next.
The verification page is displayed.
Step 7 Verify the details, then click Next.
The Schedule Job page is displayed.
Step 8 Specify the following in the Image Copy Options pane:
•Start date.
•The number of times this job should be run. We recommend not clicking the Infinite radio button.
•Delay interval between jobs.
Step 9 Specify the image copy mode. To do this, click either of the two radio buttons:
•Parallel
•Sequential—You can reorder network elements if you select sequential mode.
Step 10 Specify the Activation options. Select from the following options:
•Never—If you do not want to activate the image.
•Immediately—To activate the image immediately.
•Schedule Activation—To schedule activation for a later time. If you select this option, specify the reboot schedule parameters in the Activation Schedule pane.
Step 11 Select the activation mode. This applies only if you want to activate the image. Select either:
•Parallel
•Sequential—You can reorder network elements if you select sequential mode.
When scheduling image operations which can reload the router, we recommend you choose sequential image activation mode. If you choose parallel mode, routers which are in the connectivity path of other routers participating in the job may reload, causing problems.
Step 12 Click Next. A summary of selected image and storage is displayed.
Step 13 Click Finish.
Device-Centric Image Distribution
In Device-Centric mode, you choose a set of network elements, and schedule image distribution.
Before you begin distributing the images, you should:
•Prepare for this upgrade. You must meet all of the prerequisites for loading the software on the network element and verify that whether the necessary software images are present in the software image repository.
•Consider the effect of the upgrade on your network and your network users.
•Supply the information required by Software Management for each network element.
Algorithm for Device-Centric Distribution with Image Activation
The following steps describe the algorithm for Device-Centric distribution:
1. Select the network elements.
2. Select the image and storage partition.
3. NEIM displays a list of images that can be deployed on the network element and the storage partitions available on the network element.
4. NEIM displays only those images stored in the repository.
5. Select an image and the storage partition on the network element where the image is to be deployed.
6. NEIM verifies whether the image is compatible with the network element and allows you to proceed with the flow if the verification is successful. You can specify the job control policies and either perform activation in the same job or schedule it for a later time.
7. Apply the job policy and schedule the distribution operation job.
8. NEIM generates a work order report comprising of new image selected for distribution, network elements selected, existing image on the selected network elements, image verification details for each network element, and job control options as defined for the job.
9. NEIM schedules the job and displays the job ID as reference to the job.
To perform Device-Centric image distribution:
Step 1 Go to the Tasks tab in the Inventory perspective, and click Configuration drawer.
Step 2 Expand the Network Element Image Management and Image Distribution nodes.
Step 3 Double-click By Network Element.
The Device Selector is displayed.
Alternatively, from the main menu, choose Configuration > Network Element Image Management > Image Distribution > By Network Element.
The Device Selector is displayed.
Step 4 Select the network elements and click Next.
The Image and Storage options page is displayed.
Alternatively, go to the Objects tab in the Inventory perspective.
Right-click a managed network element, and select Network Element Image Management > Distribute Image.
The Image and Storage options page is displayed, showing the following details:
•Devices—Device names.
•Module—The software you are upgrading.
•Storage—Location at which to store the image. Lists the storage available in the device.
•Error—Errors, if any. Click near the icon to get details. If you have selected an incompatible device, an error is displayed.
Step 5 Select the storage and click Next.
The Verification page is displayed.
Step 6 Click Next after you verify the details.
The Schedule Job page is displayed.
Step 7 Specify the following in the Image Copy Options pane:
•Start date
•The number of times this job should be run. We recommend not clicking the Infinite radio button.
•Delay interval between jobs.
Step 8 Specify the image copy mode. To do this, click either of the two radio buttons:
•Parallel
•Sequential—You can reorder network elements if you select sequential mode.
Step 9 Specify the Activation options. Select from the following options:
•Never—If you do not want to activate the image.
•Immediately—To activate the image immediately.
•Schedule Activation—To schedule activation for a later time. If you select this option, specify the reboot schedule parameters in the Activation Schedule pane.
Step 10 Select the activation mode. This applies only if you want to activate the image. Select either of the following:
•Parallel
•Sequential—You can reorder network elements if you select sequential mode.
When scheduling image operations which can reload the router, we recommend you choose sequential image activation mode. If you choose parallel mode, routers which are in the connectivity path of other routers participating in the job may reload, causing problems.
Step 11 Click Next. A summary of selected image and storage is displayed.
Step 12 Click Finish.
Device Centric Image Distribution from an External Location
You can perform device centric image distribution of an image stored in any external TFTP server.
Note This feature is supported for Cisco IOS XR devices.
Step 1 Go to the Objects tab in the Inventory perspective.
Step 2 Right-click a managed network element and select Network Element Image Management > Distribute from External Location.
The Image Selection page is displayed, listing the available images.
Step 3 Select the Image or Add an Image location. To add, click Add.
The Add an Image pop-up dialog box is displayed.
Step 4 Enter an image location in the following format:
tftp://servernameorIPAddress/imagename
Note The external location has to be a TFTP server.
A table listing the following details is displayed:
•Devices—Device names.
•Image—The image you selected in the previous step.
•Storage—Location at which to store the image. Lists the storage available in the device. Click the drop-down to select the storage.
•Error—Errors, if any. Click near the icon to get details. If you have selected an incompatible device, an error is displayed.
Step 5 Select the storage and click Next.
The Verification page is displayed.
Step 6 Click Next after you verify the details.
The Schedule Job page is displayed.
Step 7 Specify the following in the Image Copy Options pane:
•Start date.
•The number of times this job should be run. We recommend not clicking the Infinite radio button.
•Delay interval between jobs.
Step 8 Specify the image copy mode. To do this, select either of the two radio buttons:
•Parallel
•Sequential—You can reorder network elements if you select sequential mode.
Step 9 Specify the Activation options. Select from the following options:
•Never—If you do not want to activate the image.
•Immediately—To activate the image immediately.
•Schedule Activation—To schedule activation for a later time. If you select this option, specify the reboot schedule parameters in the Activation Schedule pane.
Step 10 Select the activation mode. This applies only if you want to activate the image. Select either of the following:
•Parallel
•Sequential—You can reorder network elements if you select sequential mode.
When scheduling image operations which can reload the router, we recommend you choose sequential image activation mode. If you choose parallel mode, routers which are in the connectivity path of other routers participating in the job may reload, causing problems.
Step 11 Click Next. A summary of selected image and storage is displayed.
Step 12 Click Finish.
Activating an Image on the Device
Image activation is the process of making a copied image active on a network element. After the image copy is successfully completed, the activation process can be triggered immediately in the context of distribution job, or you can schedule it for a later time.
Note This feature is applicable only for devices running Cisco IOS software.
Algorithm for Image Activation
The following steps describe the algorithm for image activation on the network element:
1. Select the network elements for the image activation.
2. NEIM will display the list of images on the Flash that can be activated for the network element.
3. Select the images existing on the network element; for example, System image on Flash and Bootloader image on bootflash.
4. Schedule the activation either in sequential or parallel mode:
–In sequential mode, when there are multiple network elements in the job, you will be prompted to define the order in which the new image is activated for the network elements in the list.
–In parallel mode, NEIM will activate images on multiple network elements simultaneously, so all the network elements in the list will be activated with the new image at the same time.
5. Apply the job policy and schedule the activation job.
6. NEIM will generate a work order comprising of selected image selected images for activation, network elements selected, existing images on the selected network elements, and job control options as defined for the job.
7. NEIM schedules the job and displays the job ID as reference to the job.
To activate an image on a network element:
Step 1 Go to Tasks tab in the Inventory perspective and select Configuration drawer.
Step 2 Expand the Network Element Image Management node and double-click Activate Images.
Alternatively, from the main menu, choose Configuration > Network Element Image Management > Activate Images.
The Activate Images window is displayed.
Step 3 Select the network element from the Device Selector and click Next.
The Select Image page is displayed. It lists the Network Element Information and the corresponding Image Information.
Step 4 Select the required image and click Next.
The Schedule Job page is displayed.
Step 5 Specify the following details to schedule an image activation job:
•Start date.
•Number of times this job should run. The value should be 1.
•Delay interval between jobs.
Managing Cisco IOS XR Devices
NEIM supports distribution of IOS XR images onto network elements.
Tasks to be performed to populate the repository with packages obtained from vendor websites or transferred to the file system are the same for IOS XR as it is for other device types
Next task is to distribute the packages. We recommend you perform the distribution as one job, and do the activation as a separate job.
A rollback operation can be done if you want to revert to a previous package configuration. After some period of successful operation, you may want to remove inactive packages to save Flash space or make room for a subsequent package install operation.
After you perform operations such as activation, deactivation, or rollback, all of which change the package composition on the router, you must use Command Builder to run the ImageCommit command, a Cisco IOS XR-specific, system-defined command. The commit operation should be done only after you have verified that the new packages are operating correctly. See Using the Image Browser for information running commands.
Note The device must be in a managed state (Communication State=device reachable and Investigation State=Normal or Incomplete) when you run the command.
Along with the core NEIM functionalities such as, image distribution repository, and analysis, capabilities specific to Cisco IOS XR are also supported. The following are the specific IOS XR features:
•List Active Package
•List Installed Packages
•View Rollback Point
•Perform Rollback
•Activate Packages
•Deactivate Packages
•Remove Installed Packages
You can select a single network element or multiple network elements to perform all these tasks.
Note If you attempt a package removal operation after a deactivation without first doing a commit, Cisco IOS XR prevents the operation, because the operation removes a package that the currently committed configuration needs. The required sequence is (a) deactivate, (b) commit, and (c) remove.
See Performing Package Management Tasks for more details.
Additional Notes on Performing Package Management Tasks
Read the following before performing package management tasks using NEIM:
•For Secure Domain Router (SDR) partitions, the owner partition is represented as a separate device, with its own IP address. Similarly, any nonowner (child) partitions are also represented as separate devices with their own IP addresses.
For package management operations that involve upgrading the core packages on the device such as c12k-mini, the operation should be done only on the owner partition. Cisco IOS XR automatically upgrades nonowner partitions and initiates reload on both owner and nonowner partitions.
•If any package management CLI operations are done on the router, they must be done at admin level unless operating on a nonowner SDR partition. This ensures that subsequent image management operations done by NEIM will succeed. NEIM always operates in admin mode unless on a nonowner partition. On nonowner partitions, NEIM always runs in exec mode, because that is the only mode available.
•When doing a version upgrade (which upgrades the core image 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.
•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.
•Performing a clear install rollback oldest x operation from the CLI on the router clears all rollback points and can cause NEIM to be unable to correctly display the package status. Keep at least one rollback point at all times.
•For devices running Cisco IOS XR software, NEIM only operates on .pie files. Files with a .vm extension are for use when initializing the router in common mode, and are not supported by NEIM.
•Currently, NEIM does not support upgrading a router running Cisco IOS software to Cisco IOS XR software. The router must be running Cisco IOS XR software before any NEIM operations involving Cisco IOS XR software are done.
Activating Cisco IOS XR Packages
You can select one or more Cisco IOS XR device on which to perform the activate task. The NEIM user interface displays the list of installed packages that are not activated yet on the selected network element.
You must select the software package that you intend to activate and schedule a job for immediate execution or at a specific time. The result of the activation task can be viewed as job result
For multiple network elements, you must select the packages to be activated for each of the network elements and schedule a job. The job results will contain the details of the packages that were activated and transcript of network element interaction for each network element. See Performing Package Management Tasks for more details.
Deactivating Cisco IOS XR Packages
You can select one or more Cisco IOS XR devices on which to perform a deactivation task. The NEIM user interface displays the list of installed packages that are activated on that network element.
You must select the software package that you intend to deactivate and schedule a job for immediate execution or at specific time. The result of the task can be viewed as job result.
For multiple network elements, you must provide the packages to be deactivated for each of the network elements and schedule a job. The job results will contain the details of the packages that were deactivated and transcript of network element interaction for each network element. The deactivation task can be performed on the device cards and modules. See Performing Package Management Tasks for more details.
Rolling Back Cisco IOS XR Packages
You can select a set of network elements on which to perform a rollback task. The NEIM user interface displays the list of available rollback IDs to which you can roll back on that network element.
You must select the rollback ID and schedule the rollback job. The result of the rollback task can be viewed as a job result. When performing this task on multiple network elements, rollback points for each of the network elements selected are displayed. You can select the rollback ID for each of the network elements and schedule a job. The job results contain the details of the rollback action on each network element and a transcript of interactions with the network element for all the network elements in the job.
The removal of a package can make a rollback point invalid. If a package or version of a package that is associated with a specific rollback point is removed, it is no longer possible to roll back to that point. An error message will be generated by the Cisco IOS XR device and shown in the job status details. See Performing Package Management Tasks for more details.
Removing Cisco IOS XR Packages
You can select one or more network elements for which to remove packages. The NEIM UI displays the list of available packages on each of the selected network elements.
Performing Package Management Tasks
You can perform the following tasks:
•Manage Packages. See Managing Packages for details.
•Perform Rollback. See Performing Rollback for details.
•Distribute Packages. See Distributing Packages for details.
These tasks can be performed only for Cisco IOS XR devices. You might encounter errors on other devices. See Additional Notes on Performing Package Management Tasks before you perform package management tasks.
Managing Packages
To manage packages:
Step 1 Go to Tasks tab in the Inventory perspective and select Configuration drawer.
Step 2 Expand the Network Element Image Management and the Package Management nodes and double-click Manage Packages.
Alternatively, from the main menu, choose Configuration > Network Element Image Management > Manage Packages.
The Manage Packages window is displayed.
Step 3 Select the network elements and click Add to add them to the Selected Network Elements column.
Step 4 Click the View Packages icon.
The Select Packages page is displayed. This page has the following details:
•Device—Device name.
•Package—Available package for the device.
•Status—Status may be Active, or Inactive.
•Operation—Select any of the following operations:
–Activate
–Deactivate
–Remove
Step 5 Select packages.
Step 6 Choose the Operation from the drop-down list.
Step 7 Click the Schedule Job icon.
Step 8 Specify the following details to schedule a package management job:
•Start date.
•Number of times this job should run. The value should be 1.
•Delay interval between jobs.
If you want to perform a package compatibility check, check the Choose Compatibility Test check box. A verification is done, and a report is made available on the Reports page.
This check box controls whether the operation is done normally (by default, box is unchecked) or as a test only (if the check box is checked). A test only job shows the results of doing the job, but does not actually change the configuration of the network element.
Step 9 Click Finish.
Performing Rollback
To perform a rollback operation:
Step 1 Go to Tasks tab in the Inventory perspective and select the Configuration drawer.
Step 2 Expand the Network Element Image Management and the Package Management nodes and double-click Rollback.
Alternatively, from the main menu, choose Configuration > Network Element Image Management > Rollback.
The Rollback window is displayed.
Step 3 Select the network elements and click Next.
The Select Rollback Point page is displayed. It lists the following details:
•Devices—Device name.
•ID—Choose a rollback point from the drop-down list. It is not possible to do rollback to all of the rollback points present. Not all rollback points shown would be reachable. If an attempt is made to roll back to an unreachable rollback point, the operation will fail. An error message is displayed, indicating that the rollback point is invalid. This can be due to a package that has been removed from the system.
•Details—Click the cell for details. For the active rollback point, details about both active and inactive packages are shown.
•Errors—Errors, if any.
Step 4 Select the desired row and click Next.
Step 5 Specify the following details to schedule the rollback job:
•Start date.
•Number of times this job should run. The value should be 1.
•Delay interval between jobs.
Select the Choose Compatibility Test check box if you want to perform an image compatibility check.
This check box controls whether the operation is done normally (by default, box is unchecked) or as a test only (if the check box is checked). A test only job shows the results of doing the job, but does not actually change the configuration of the network element.
Step 6 Click Finish.
Distributing Packages
To distribute package:
Step 1 Go to Tasks tab in the Inventory perspective and select the Configuration drawer.
Step 2 Expand the Network Element Image Management and the Package Management nodes and double-click Distribute Packages.
Alternatively, from the main menu, choose Configuration > Network Element Image Management > Package Management > Distribute Packages.
The Image Selection page is displayed. It has the following details.
•Devices—Device names.
•Image—The software you are upgrading. You can select multiple images, by clicking the check boxes.
•Storage—Location at which to store the image. Lists the storage available in the device
•Error—Errors, if any. Click near the icon to get details. If you have selected an incompatible device, and error is displayed.
Step 3 Select the Images and the storage and click Next.
The Verification page is displayed. It displays the verification results. Status is always shown as Passed.
Step 4 Click Next. The Schedule Job page is displayed.
Step 5 Specify the following in the Image Copy Options pane:
•Start date.
•The number of times this job should be run. We recommend not clicking the infinite radio button.
•Delay interval between jobs.
Step 6 Specify the image copy mode. To do this, select either of the two radio buttons:
•Parallel
•Sequential—You can reorder network elements if you select sequential mode.
Step 7 Specify the Activation options.
Note Devices running Cisco IOS XR software do not have separate Activation flow.
Select from the following options:
•Never—If you do not want to activate the image.
•Immediately—To activate the image immediately.
•Schedule Activation—To schedule activation for a later time. If you select this option, specify the reboot schedule parameters in the Activation Schedule pane.
Step 8 Select the activation mode. This applies only if you want to activate the image. Select either of the following:
•Parallel
•Sequential—You can reorder network elements if you select sequential mode.
When scheduling image operations which can reload the router, we recommend you choose sequential image activation mode. If you choose parallel mode, routers which are in the connectivity path of other routers participating in the job may reload, causing problems.
Step 9 Click Next. A summary of selected image and storage is displayed.
Step 10 Click Finish.
NEIM Log Files
There is no NEIM-specific log file for ANA 4.0.
However, you can check the following to see NEIM debug messages:
•$ANAHOME/Main/logs/jboss.log
•$ANAHOME/Main/logs/avm number.log
On the client, you can check the following log file:
•$CLIENTINSTALLDIR/logs/12.log
