Field Notice: FN - 70515 - ASD APIs Used to Direct Download Prime Infrastructure Software Might No Longer Function – Manual Download Recommended - Workaround Provided

Notice

THIS FIELD NOTICE IS PROVIDED ON AN "AS IS" BASIS AND DOES NOT IMPLY ANY KIND OF GUARANTEE OR WARRANTY, INCLUDING THE WARRANTY OF MERCHANTABILITY. YOUR USE OF THE INFORMATION ON THE FIELD NOTICE OR MATERIALS LINKED FROM THE FIELD NOTICE IS AT YOUR OWN RISK. CISCO RESERVES THE RIGHT TO CHANGE OR UPDATE THIS FIELD NOTICE AT ANY TIME.

Revision History

Revision	Publish Date	Comments
1.0	05-Mar-20	Initial Release

Products Affected

Affected OS Type	Affected Software Product	Affected Release	Affected Release Number	Comments
NON-IOS	Prime Infrastructure Software	3	3.0.0, 3.1.0, 3.1.5, 3.2, 3.2.0-FIPS, 3.3.0, 3.4.0, 3.5.0, 3.6.0, 3.7.0

Defect Information

Defect ID	Headline
CSCvt06576	ASD V3 support in PI

Problem Description

Until further notice, a Prime Infrastructure related software update (and/or device package) posted on www.cisco.com will not be automatically listed on Prime Infrastructure’s Software Update page. An administrative user will have to first manually download the update from www.cisco.com to their local machine and then upload it to the Software Image Repository in Prime Infrastructure.

Cisco's Automatic Software Distribution (ASD) Version 2 APIs used for Software Image Management (SWIM) and software updates on www.cisco.com for Prime Infrastructure are End of Life (EoL). This results in the inability for customers to direct download UBF patches from the Prime Infrastructure Software Update page, or to direct download Cisco IOS^®, Cisco IOS XE, and other device images from www.cisco.com through the Inventory > Software Images page.

Prime Infrastructure releases earlier than 3.4 will not be able to direct download Cisco IOS related images using SWIM and Prime Infrastructure releases earlier than 3.8 will not be able to direct download UBF files from the Software Update page.

Release	Can Download UBF Files From the Software Update Page?	Can Download Cisco IOS Images Using SWIM?
3.2	No	No
3.3	No	No
3.4	No	Yes
3.5	No	Yes
3.6	No	Yes
3.7	No	Yes
3.8	Yes	Yes

Background

As of 2020-03-01, there was a deprecation of the ASD Version 2 APIs that allow customers to seamlessly download and install code from www.cisco.com. The loss of functionality requires that customers manually download and install the code. Instead of having the ability to view a list of available software images on www.cisco.com and download them to the server/appliance, customers will need to take the image name, go to Cisco Software Central, find the image, download it to their local machine, and then upload it back to the server/appliance.

Problem Symptom

A customer might not be able to install Prime Infrastructure UBF patches from the Administration > Software Update Prime Infrastructure page or Cisco IOS, Cisco IOS XE, and other device images through the Inventory > Software Images page from www.cisco.com. Functionality is based upon the customer's current release version.

Workaround/Solution

Option 1. Upgrade to Prime Infrastructure 3.8 or Later Which Supports the ASD API Version 3

Option 2. Use the Software Update Page to Install UBF Files

1. Log in to the Software Download page and provide your credentials.

   

2. Click Browse All. Choose Cloud and Systems Management > Routing and Switching Management > Network Management Solutions > Prime Infrastructure > desired Prime Infrastructure release.

   

3. Click Prime Infrastructure Patches to list the UBF patches applicable for that particular release of Prime Infrastructure.

   

   

4. Alternately, use the appropriate navigation path provided and click Prime Infrastructure Patches.
   • Cisco Prime Infrastructure 3.4
   • Cisco Prime Infrastructure 3.5
   • Cisco Prime Infrastructure 3.6
   • Cisco Prime Infrastructure 3.7
5. This displays the most recent maintenance release and update available for the selected Prime Infrastructure release. Click the Download icon to download the required update to your local machine.

   

6. Log in to the Prime Infrastructure user interface.
7. Choose Administration > Licenses and Software Updates > Software Update. Click upload and click Browse to choose the UBF file that you downloaded to your local machine in step 5. Click OK.

   

   

Note: An FTP server is not required for this process and no Prime Infrastructure restart is required.

Option 3. Use SWIM to Install Cisco IOS Files

Manual Software Image Download and Installation

1. Open the Software Download Page. In the Select a Product field, enter the product name. Choose the appropriate product release.

   

2. Click the appropriate software type.

   

3. Click the Download icon to download the required update to your local machine.

   

4. Log in to Prime Infrastructure and choose Inventory > Device Management > Software Images.

   

5. In the Software Image Upgrade/Downgrade Workflow diagram, click Add/Import.

   

6. In the Image Source tab, click the File radio button.

   

7. Click the Collection Options tab. Choose the downloaded image from your local machine. Click Open.

   

8. Click the Schedule Import tab. Click Submit to submit the job now.

   

   The file is uploaded to the Software Image Repository.

   

9. Once the job is completed successfully, you can view the image.

   

10. The image will be displayed in the Software Image Repository. You can now distribute it to your intended devices.

    

How To Identify Affected Products

The current software version can be found via the CLI or the Prime Infrastructure user interface.

CLI

From the CLI, enter the show version command.

mas-tardis/admin# show version

    Cisco Application Deployment Engine OS Release: 4.1
	ADE-OS Build Version: 4.1.0.001
	ADE-OS System Architecture: x86_64
	

	Copyright (c) 2009-2018 by Cisco Systems, Inc.
	All rights reserved.
	...
	
	Cisco Prime Infrastructure
	********************************************************
	Version : 3.5.0 [FIPS not Enabled]Build : 3.5.0.0.550
	Critical Fixes:
	        PI 3.5 Update 03 ( 3.0.0 )
	        PI 3.5.1 Maintenance Release ( 1.0.0 )
	Device Support:
	        Prime Infrastructure 3.5 Device Pack 3 ( 3.0 )

Prime Infrastructure User Interface

Complete these steps:

1. Click the Gear icon in the upper right-hand corner of the interface.
2. Choose About Prime Infrastructure in order to display the build version.

   

   

For More Information

If you require further assistance, or if you have any further questions regarding this field notice, please contact the Cisco Systems Technical Assistance Center (TAC) by one of the following methods:

• Open a service request on Cisco.com
• By email
• By telephone

Receive Email Notification For New Field Notices

My Notifications—Set up a profile to receive email updates about reliability, safety, network security, and end-of-sale issues for the Cisco products you specify.