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

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

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:

  1. Install Prime Infrastructure 3.8 from an OVA or ISO distribution.

  2. 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.

Note 
Do not manually restart the server while the installation is in progress.
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:


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.

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:

http://www.cisco.com/c/en/us/support/cloud-systems-management/prime-infrastructure/products-device-support-tables-list.html

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 .

Table 1. Open Caveats

Identifier

Description

CSCvd50705

Select all devices using the “Select All” checkbox doesn't work on Windows 10 and Chrome browser.

CSCvh69027

Seamless login from Prime Web to MSE stopped working after upgrade.

CSCvi44815

Duplicate entry in Inventory for each wireless controller which got migrated to Prime Infrastructure 3.2.2 update 2.

CSCvi50467

Deletion of 1000+ APs does not reflect in Front end (UI).

CSCvi58374

Interface details are not displayed while using Prime Infrastructure in Japanese.

CSCvm11769

In Topology page, the pie chart does not show the severity on cross launching from alarm summary.

CSCvm82204

Table view is displayed instead of Template view while creating a template.

CSCvn16172

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.

CSCvn23789

Internal Temperature for Dao (9800-80) displays 0 in the Device Details page.

CSCvn24943

Non-AP Meraki devices are categorized as Access points in Prime Infrastructure.

CSCvn27150

In Prime Infrastructure, certain functions are not virtual domain aware which causes the users across different virtual domains to save or change values.

CSCvn28363

After password recovery, an unwanted message is printed while startup.

CSCvn28372

Reboot issue in Gen-3 Appliance.

CSCvn31203

Issues in deploying a configuration template.

CSCvv47916

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

Bug Search Tool

Table 2. Resolved Bugs

Identifier

Description

CSCvg46100

Prime Infrastructure's performance is impacted when the Data Cleanup job fails to clean job entries.

CSCvr94553

Prime Infrastructure 3.7 - Constraint violations encountered during pruning.

CSCvs32965

Jobs are not triggering for the next iteration.

CSCvt03789

Prime Infrastructure: ISSU image upgrade is not working.

CSCvt09684

Unable to upload .dwg image into Prime Infrastructure New Maps due to size of OBJECTS section.

CSCvt13996

Interface Utilization report shows wrong interface details when we save and run it.

CSCvt17634

Cannot edit position information for AP in Prime Infrastructure 3.6.

CSCvt23969

Importing CAD unique block instances failed under certain circumstances.

CSCvt29418

Lightweight AP status thread is taking a longer time to complete an iteration.

CSCvt29488

Prime Infrastructure generates wrong cleared alarm for radio interface admin state reset event.

CSCvt32206

Exporting devices triggers slowness over a period of time.

CSCvt32795

Prime Infrastructure Operations Center consuming incorrect license.

CSCvt33826

Refresh Clients and Users page with filter "Detected on MSE" may display no data available.

CSCvt36064

Copy and replace access point functionality not working.

CSCvt36130

Login returns "Access is denied to Prime Infrastructure please contact the network administrator".

CSCvt41074

WLC traps get enabled when synchronized from Prime Infrastructure 3.7.

CSCvt42792

Prime Infrastructure 3.7 - Unable to see data in Device 360 view: Security > TrustSec > Wired 802_1x.

CSCvt54028

Export incorrect device lists for selected Virtual-Domain in OpCenter Server.

CSCvt54166

Credential Profile field does not load profiles into OpsCenter from those already created in Prime Infrastructure.

CSCvt60920

"When loading a raster floor image, width/length are not modified according to the image aspect ratio".

CSCvt62950

eWLC: APs not discovered by Prime Infrastructure when controller version 17.3.

CSCvt66566

Root Privilege Escalation via Cron Job.

CSCvt69488

Cisco Prime Infrastructure SQL injection vulnerability.

CSCvt70660

Prime Infrastructure 3.7 gives error on templates based off of 3rd-party MIB monitoring policies.

CSCvt72562

Some doors appear mirrored in imported CAD file.

CSCvt73237

Interface availability report not showing any data for access point.

CSCvt74247

Rogue in LRAD state (managed APs) are reported as malicious rogue in Prime Infrastructure.

CSCvt79718

Lightweight client status job is not able to update client status info in upgrade setup.

CSCvt80480

vPC status dashlet does not return data.

CSCvt93808

Popup window is blank and does not fully load when requesting CDP data from AP.

CSCvt97995

Monitoring wireless dashboard > Attacks Detected - alarm count.

CSCvu01626

Apache 2.4.x < 2.4.42 multiple vulnerabilities.

CSCvu01822

Prime Infrastructure 3.x - Cannot import .csv file which contains IP ranges in discovery job settings.

CSCvu04650

Scheduled configuration archive rollback job may fail for Catalyst 9300 device.

CSCvu12157

Cisco Prime Infrastructure Cross-Site Scripting Vulnerability.

CSCvu53524

NMTG SmartServices For OAM To PingAccess Migration.

CSCvu68865

AP model 9120 auxiliary radio status may not show correct status.

CSCvu75372

Prime Infrastructure may generate interface not exist alarm for APs which have auxiliary radios.

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.