Cisco Prime Infrastructure 3.8.1 Release Notes
Introduction
This is the first maintenance release for Cisco Prime Infrastructure 3.8
You can install Cisco Prime Infrastructure 3.8.1 on Cisco Prime Infrastructure 3.8 and Prime Infrastructure 3.8 Update 02. Prime Infrastructure 3.8.1 file PI_3_8_1-1.0.26.ubf is approximately 250 MB. The downloading time depends on the available network connection in the enterprise environment. Ensure that you have adequate bandwidth and are not running into high latency issues.
Cisco End User License Agreement
This software is governed by the Cisco End User License Agreement available at the following URL:
http://www.cisco.com/c/en/us/td/docs/general/warranty/English/EU1KEN_.html
Cisco Prime Infrastructure 3.8 collects anonymous usage data to help improve the product. By using this product, you are providing your consent to collect your usage data.
For more information, or to opt out at any time, go to Administration > Settings > System Settings > General > Help Us Improve.
System Requirements
Supported Physical Appliance Environments
-
Prime Infrastructure 3.8.1 is supported on the Cisco Prime Infrastructure Physical Appliance (Gen 2 and Gen 3). For more information, see the Physical Appliance Options section in the Cisco Prime Infrastructure 3.8 Quick Start Guide.
-
Prime Infrastructure 3.8.1 is not supported in the Cisco Prime Infrastructure Physical Appliance (Gen 1). For more information on installation, upgrade, and migration from Prime Infrastructure 3.0.x to Prime Infrastructure 3.8.1 Gen 1 Appliance, see the Prime Infrastructure 3.1.4 Generation 1 Upgrade and Migration Guide.
Supported Virtual Appliance Environments
-
Prime Infrastructure 3.8.1 is supported on the Cisco Prime Infrastructure Virtual Appliance (VMware). For more information, see the Understand System Requirements section in the Cisco Prime Infrastructure 3.8 Quick Start Guide.
-
Prime Infrastructure 3.8.1 is supported on the Cisco Prime Infrastructure Virtual Appliance (Microsoft Hyper-V) For more details, see the Cisco Prime Infrastructure 3.8 Installation and Migration Guide for Microsoft Hyper-V Virtual Machine .
Supported Web Client Requirements
For more information on the web client requirements, see the Web Client Requirements section in the Cisco Prime Infrastructure 3.8 Quick Start Guide.
Installation Guidelines
The following sections explain how to install the maintenance release.
Before You Begin Installing the Maintenance Release
Caution |
Once you install this maintenance release, you cannot un-install or remove it. |
You can directly install Prime Infrastructure 3.8.1 on top of 3.8, without any prerequisite. To download, see Software download page.
Since the maintenance release is not removable, it is important to have a way to revert your system to the original version in case hardware or software problems cause the maintenance release installation to fail.
To ensure you can do this, take a backup of your system before downloading and installing this UBF maintenance release.
If the backup is a Prime Infrastructure 3.8 backup, restore the backup on Prime Infrastructure 3.8 server before applying the 3.8.1 release.
Similarly, if you are running Prime Infrastructure 3.8 in a Virtual Machine (VM) and your organization permits taking VM snapshots, stop Prime Infrastructure and use the VMware client to take a VM snapshot before applying this maintenance release. Store the snapshot in an external storage repository, and restore from the snapshot if the maintenance release installation is unsuccessful. For more details, see Restore an Application Backup in the Cisco Prime Infrastructure 3.8 Administrator Guide .
To restore the backup of the Prime Infrastructure 3.8 installation, follow these steps:
-
Install Prime Infrastructure 3.8 from an OVA or ISO distribution.
-
Clear the Cache and log in to Prime Infrastructure GUI again and proceed with the Prime Infrastructure 3.8.1 upload.
If you are installing this release as part of a High Availability (HA) implementation, see Before You Begin Setting Up High Availability in the Cisco Prime Infrastructure 3.8 Administrator Guide .
Installing the Release from Local Storage
Caution |
If you have a High Availability (HA) environment, remove the HA setup before proceeding to install this release. For more details, see Installing the Maintenance Release in High Availability Mode. |
Make sure that you have completed the recommended preparation steps given in Before You Begin Installing the Maintenance Release.
To install Cisco Prime Infrastructure 3.8.1 from the local storage, follow these steps:
Note |
You can only install Cisco Prime Infrastructure 3.8.1 by manual download from Cisco.com and upload and install through Cisco Prime Infrastructure UI. |
Procedure
Step 1 |
Download the Prime Infrastructure 3.8.1 PI_3_8_1-1.0.26.ubf from Home > Products > Cloud and Systems Management > Routing and Switching Management > Network Management Solutions > Prime Infrastructure > Prime Infrastructure 3.8 > Prime Infrastructure Patches-3.8.1 and save the file in your local system. |
||
Step 2 |
Log in to Prime Infrastructure 3.8 server. |
||
Step 3 |
Choose Administration > Licenses and Software Updates > Software Update. |
||
Step 4 |
Click Upload and browse to the location where you have saved the maintenance release file. Click OK to upload the file. |
||
Step 5 |
In the Status of Updates pane, click the Files tab and check whether PI_3_8_1-1.0.26.ubf is listed under FileName column. |
||
Step 6 |
In the Critical Fixes pane, click Install. |
||
Step 7 |
Click Yes in the pop-up dialogue box to install Cisco Prime Infrastructure 3.8.1. It may take approximately 1 hour for the installation process to complete.
|
||
Step 8 |
You can verify the release installation from Prime Infrastructure Login under Critical Fixes by clicking View Installed Updates and also by logging into the server and choosing Administration > Software Update. You should see a listing for the release in the Updates tab, with Installed in the Status column. |
Installing the Maintenance Release in High Availability Mode
Download the Prime Infrastructure 3.8.1 PI_3_8_1-1.0.26.ubf from Home > Products > Cloud and Systems Management > Routing and Switching Management > Network Management Solutions > Prime Infrastructure > Prime Infrastructure 3.8 > Prime Infrastructure Patches-3.8.1 and save the file in your local system .
To install the downloaded Prime Infrastructure 3.8.1 PI_3_8_1-1.0.26.ubf in High Availability mode follow the below prerequisites:
-
Make sure that you have completed the recommended preparation steps given in Before You Begin Installing the Maintenance Release.
Note |
Prime Infrastructure 3.8.1 can be applied only in primary and secondary standalone servers. The server will restart automatically once the installation is complete. The restart typically takes 25 to 35 minutes. You cannot apply Prime Infrastructure 3.8.1 when HA is enabled. |
-
If you are installing Cisco Prime Infrastructure 3.8.1 on High Availability (HA) paired servers, you will get the following error message:
For more details, see Remove HA Via the GUI in the Cisco Prime Infrastructure 3.8 Administrator Guide.
-
Continue the patching once HA removed completely. For more details, see the How to Patch New HA Servers section in the Cisco Prime Infrastructure 3.8 Administrator Guide .
Troubleshooting Maintenance Release Installs in High Availability Implementations
If you are unable to apply this maintenance release in a High Availability (HA) implementation, check whether your network bandwidth, throughput and latency meets the network requirements recommended in Network Throughput Restrictions on HA section in the Cisco Prime Infrastructure 3.8 Administrator Guide. In a few cases, continued or intermittent throughput problems can cause a complete failure. If you believe this has occurred, contact Cisco TAC for support.
If you are unable to verify that this maintenance release has been successfully installed on a Prime Infrastructure server, or one or both of the servers fails to restart properly after installing the maintenance release, you may need to re-image the server as explained in Before You Begin Installing the Maintenance Release before continuing.
In all cases, you can use the backup-logs command on one or both servers to get information on the source of the failure. For more information, see the back-logs section in the Cisco Prime Infrastructure 3.8 Command Reference Guide .
Renewing AAA Settings After Installing a New Prime Infrastructure Version
If you are using external RADIUS or TACACS+ user authentication, before migrating your existing data to a new version of Prime Infrastructure, you must transfer the expanded Prime Infrastructure user task list to your AAA server. After you upgrade Prime Infrastructure, you must re-add any permissions on the TACACS+ or RADIUS server and update the roles in your TACACS server with the tasks from the Prime Infrastructure server. For more details, Configure External Authentication section in the Cisco Prime Infrastructure 3.8 Administrator Guide.
Cisco Prime Infrastructure with Cisco Digital Network Architecture (DNA) Center
You can now integrate Cisco Prime Infrastructure with Cisco Digital Network Architecture (DNA) Center and utilize the intent-based networking solution for managing application user experience in the enterprise.
To know more about Cisco Prime Infrastructure to DNAC Migration, visit Cisco Prime Infrastructure to Cisco Digital Network Architecture (DNA) Center Co-existence Guide.
Migrating from Previous Releases of Cisco Prime Infrastructure
You can restore the backup from the following Prime Infrastructure versions to Prime Infrastructure 3.8.1:
-
Cisco Prime Infrastructure 3.0.0.78
-
Cisco Prime Infrastructure 3.0.1
-
Cisco Prime Infrastructure 3.0.2
-
Cisco Prime Infrastructure 3.0.3
-
Cisco Prime Infrastructure 3.1.0.0.132
-
Cisco Prime Infrastructure 3.1.1
-
Cisco Prime Infrastructure 3.1.2
-
Cisco Prime Infrastructure 3.1.3
-
Cisco Prime Infrastructure 3.1.4
-
Cisco Prime Infrastructure 3.1.5
-
Cisco Prime Infrastructure 3.1.6
-
Cisco Prime Infrastructure 3.1.7
-
Cisco Prime Infrastructure 3.2
-
Cisco Prime Infrastructure 3.2.1
-
Cisco Prime Infrastructure 3.2.2
-
Cisco Prime Infrastructure 3.3.1
-
Cisco Prime Infrastructure 3.4
-
Cisco Prime Infrastructure 3.4.1
-
Cisco Prime Infrastructure 3.4.2
-
Cisco Prime Infrastructure 3.5
-
Cisco Prime Infrastructure 3.5.1
-
Cisco Prime Infrastructure 3.6
-
Cisco Prime Infrastructure 3.7
-
Cisco Prime Infrastructure 3.8
Note |
You can restore backup on 3.8.1 only from the 3.6 and later versions . For example: You cannot directly restore 3.0/3.1/3.2/3.3/3.4/3.5 on top of 3.8.1. You have to update to 3.6 or 3.7 or 3.8 version and then restore backup on the 3.8.1 version. |
If you are running multiple previous releases of Prime Infrastructure (for example, you are running version 3.0.0.78 and 3.0.1, 3.0.2, 3.0.3, 3.1.0.0.132), you must select one version from which to restore data.
See Before You Migrate Your Data in the Cisco Prime Infrastructure 3.8 Quick Start Guide before you restore your data from Prime Infrastructure 3.0.x or 3.1 to your newly installed Prime Infrastructure 3.8 server:
You can apply the Cisco Prime Infrastructure 3.8.1 over Cisco Prime Infrastructure 3.8 upgraded server. For detailed information about upgrading from previous releases of Prime Infrastructure, including the list of versions from which you can upgrade, see the How to Upgrade From Previous Releases of Prime Infrastructure section of the Cisco Prime Infrastructure 3.8 Quick Start Guide.
Submitting Feedback
Your feedback will help us improve the quality of our product. You must configure the email server and then enable data collection to configure the feedback tool. To send your feedback, follow these steps:
Procedure
Step 1 |
If you have configured your mail server, go to Step 4. |
Step 2 |
Choose Administration > Settings > System Settings > Mail and Notification > Mail Server Configuration. |
Step 3 |
In the Mail Server Configuration page, enter the mail server details, then click Save to save the configuration settings. |
Step 4 |
Choose Administration > Settings > System Settings > General > Help Us Improve. |
Step 5 |
In the Help Us Improve Cisco Products page, select Yes, collect data periodically, then click Save. |
Step 6 |
Click the Settings icon, then select Feedback > I wish this page would ... . |
Step 7 |
Enter your feedback, then click Submit Feedback. |
Prime Infrastructure Licenses
Supported Devices
To see the list of devices supported in this release of Prime Infrastructure, follow these steps:
Procedure
Step 1 |
Log in to Prime Infrastructure. |
Step 2 |
Click Settings to see the list of settings options |
Step 3 |
Click Supported Devices List under Help. |
What to do next
You can also view the Cisco Prime Infrastructure 3.8.1 Supported Devices list at the following URL:
For detailed information on the software compatibility for the Cisco wireless devices, see the following URL:
https://www.cisco.com/c/en/us/td/docs/wireless/compatibility/matrix/compatibility-matrix.html
New Features and Enhancements
-
Migrate CLI Templates applicable for the devices (from selected groups) to Cisco DNA Center.
-
New AP Support Unified AP – Somerset 9105AX
-
Physical USB port on recent 11AX AP’s
-
USB - PoE separation feature on Somerset WP (9105AXW)
Important Notes
-
You can directly install Prime Infrastructure 3.8.1 on top of 3.8, without any prerequisite.
-
In addition to installing Prime Infrastructure 3.8.1 on Prime Infrastructure instances, make sure that you also install Prime Infrastructure 3.8.1 on Prime Operations Center.
-
Prime Infrastructure 3.8.x will not be able to manage a C9800 controller running 16.12.x version
-
Prime Operations Center 3.8.1 manages Prime Infrastructure 3.8.1. You must ensure that Prime Operations Center version is the same as the version of the Prime infrastructure instances that it manages. For more details, see Set Up Operations Center in Cisco Prime Infrastructure 3.8 Administrator Guide .
-
Prime Infrastructure services might go down due to high memory swapping in oracle process because of oracle internal defect 19509982. This issue is addressed in Prime Infrastructure version 3.8.1 and above.
You can install Prime Infrastructure 3.8.1 on operations center from the Cisco Site, or local storage. You can also install the update in high availability mode if the high availability is available on Prime Operations Center. For more details on how to install the update, see Installation Guidelines.
After installing the update, enable HA for Operations Center. For more details, see Enable HA for Operations Center in Cisco Prime Infrastructure 3.8 Administrator Guide .
-
If the email address contains numeric value (e.g. 123456@xyz.com), the email notification sent to the email destination will contain only the alarm instance ID.
-
CLI templates and Guest users cannot be deployed from Wireless Configuration Groups.
-
Cisco Prime Infrastructure does not support monitoring for Cisco Application Control Engine (ACE) module, because ACE has been moved to end-of-life and does not respond to related monitoring MIBs.
-
If the Boot Option in the BIOS settings is enabled with UEFI shell, deployment gets completed. Once deployment gets completed, it fails to enter the configuration mode, instead enters the shell mode in the CIMC console. UEFI shell option must be disabled in the BIOS settings to access configuration mode.
-
If VIP is enabled, after failover or fallback, SSO server should be added again in Prime Infrastructure for the auto login to work.
-
It is recommended to use different web browsers to avoid from menus getting affected while loading in ISE, during the cross launching of ISE reports from Cisco Prime Infrastructure and logging in to ISE Admin.
Open Caveats
Table 1 lists the Open Caveats in Cisco Prime Infrastructure Release 3.8.1.
Click the identifier to view the impact and workaround for the caveat. This information is displayed in the Bug Search Tool. You can track the status of the open caveats using the Bug Search Tool .
Identifier |
Description |
---|---|
Select all devices using the “Select All” checkbox doesn't work on Windows 10 and Chrome browser. |
|
Seamless login from Prime Web to MSE stopped working after upgrade. |
|
Duplicate entry in Inventory for each wireless controller which got migrated to Prime Infrastructure 3.2.2 update 2. |
|
Deletion of 1000+ APs does not reflect in Front end (UI). |
|
Interface details are not displayed while using Prime Infrastructure in Japanese. |
|
In Topology page, the pie chart does not show the severity on cross launching from alarm summary. |
|
Table view is displayed instead of Template view while creating a template. |
|
While executing a Configuration Deploy job in Prime Infrastructure, the job status displays the status as successful even though the commands are not deployed successfully on the device. |
|
Internal Temperature for Dao (9800-80) displays 0 in the Device Details page. |
|
Non-AP Meraki devices are categorized as Access points in Prime Infrastructure. |
|
In Prime Infrastructure, certain functions are not virtual domain aware which causes the users across different virtual domains to save or change values. |
|
After password recovery, an unwanted message is printed while startup. |
|
Reboot issue in Gen-3 Appliance. |
|
Issues in deploying a configuration template. |
|
Prime Infrastructure performance slows while opening the device detail page when there is a mismatch between the AP and client. |
Resolved Caveats
Table 2 lists the bugs resolved in Prime Infrastructure 3.8.1.
Click the identifier to view the impact and workaround for the caveat. This information is displayed in the Bug Search Tool. You can track the status of the resolved caveats using the
Identifier |
Description |
---|---|
Prime Infrastructure's performance is impacted when the Data Cleanup job fails to clean job entries. |
|
Prime Infrastructure 3.7 - Constraint violations encountered during pruning. |
|
Jobs are not triggering for the next iteration. |
|
Prime Infrastructure: ISSU image upgrade is not working. |
|
Unable to upload .dwg image into Prime Infrastructure New Maps due to size of OBJECTS section. |
|
Interface Utilization report shows wrong interface details when we save and run it. |
|
Cannot edit position information for AP in Prime Infrastructure 3.6. |
|
Importing CAD unique block instances failed under certain circumstances. |
|
Lightweight AP status thread is taking a longer time to complete an iteration. |
|
Prime Infrastructure generates wrong cleared alarm for radio interface admin state reset event. |
|
Exporting devices triggers slowness over a period of time. |
|
Prime Infrastructure Operations Center consuming incorrect license. |
|
Refresh Clients and Users page with filter "Detected on MSE" may display no data available. |
|
Copy and replace access point functionality not working. |
|
Login returns "Access is denied to Prime Infrastructure please contact the network administrator". |
|
WLC traps get enabled when synchronized from Prime Infrastructure 3.7. |
|
Prime Infrastructure 3.7 - Unable to see data in Device 360 view: Security > TrustSec > Wired 802_1x. |
|
Export incorrect device lists for selected Virtual-Domain in OpCenter Server. |
|
Credential Profile field does not load profiles into OpsCenter from those already created in Prime Infrastructure. |
|
"When loading a raster floor image, width/length are not modified according to the image aspect ratio". |
|
eWLC: APs not discovered by Prime Infrastructure when controller version 17.3. |
|
Root Privilege Escalation via Cron Job. |
|
Cisco Prime Infrastructure SQL injection vulnerability. |
|
Prime Infrastructure 3.7 gives error on templates based off of 3rd-party MIB monitoring policies. |
|
Some doors appear mirrored in imported CAD file. |
|
Interface availability report not showing any data for access point. |
|
Rogue in LRAD state (managed APs) are reported as malicious rogue in Prime Infrastructure. |
|
Lightweight client status job is not able to update client status info in upgrade setup. |
|
vPC status dashlet does not return data. |
|
Popup window is blank and does not fully load when requesting CDP data from AP. |
|
Monitoring wireless dashboard > Attacks Detected - alarm count. |
|
Apache 2.4.x < 2.4.42 multiple vulnerabilities. |
|
Prime Infrastructure 3.x - Cannot import .csv file which contains IP ranges in discovery job settings. |
|
Scheduled configuration archive rollback job may fail for Catalyst 9300 device. |
|
Cisco Prime Infrastructure Cross-Site Scripting Vulnerability. |
|
NMTG SmartServices For OAM To PingAccess Migration. |
|
AP model 9120 auxiliary radio status may not show correct status. |
|
Prime Infrastructure may generate interface not exist alarm for APs which have auxiliary radios. |
Related Documentation
You can access additional Cisco Prime Infrastructure documentation at:
http://www.cisco.com/en/US/products/ps12239/tsd_products_support_series_home.html
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information, see What’s New in Cisco Product Documentation at: http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html .
Subscribe to What’s New in Cisco Product Documentation , which lists all new and revised Cisco technical documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSS feeds are a free service.
This document is to be used in conjunction with the documents listed in the “Related Documentation” section.