Release Notes for Cisco DNA Center Platform, 2.3.2.x
This document describes the features, limitations, and bugs for the Cisco DNA Center platform, 2.3.2.x.
Change History
The following table lists the changes in this document since its initial release.
Date | Change | Location |
---|---|---|
2022-05-25 |
Added a new section: What's New in the Cisco DNA Center Platform, 2.3.2.3. |
|
Added a new section: Open Bugs for the Cisco DNA Center Platform, 2.3.2.3. |
||
Added a new section: Resolved Bugs for the Cisco DNA Center Platform, 2.3.2.3. |
||
2021-12-15 |
Initial release. |
— |
Overview
Cisco DNA Center provides an extensible platform that Cisco customers and partners can use to create value-added applications that can be built on top of its native capabilities. You can leverage the following Cisco DNA Center platform features to enhance the overall network experience by optimizing end-to-end IT processes, reducing Total Cost of Ownership (TCO), and developing new value networks:
-
Intent APIs
-
Integration Flows
-
Events and Notification Services
What's New in the Cisco DNA Center Platform, 2.3.2.3
This release resolves several bugs to improve the performance and stability of the Cisco DNA Center platform. For additional information, see Resolved Bugs for the Cisco DNA Center Platform, 2.3.2.3.
What's New in the Cisco DNA Center Platform, 2.3.2.0
The following are the new features and functionalities for the Cisco DNA Center platform, 2.3.2.0.
New API Features
Cisco SD-Access API
This Cisco DNA Center platform release supports new options in the SDA API to get, add, and delete the list of Cisco SD-Access devices:
-
GET <cluster-ip>/dna/intent/api/v1/business/sda/multicast
Use this API to get multicast details from the SDA fabric.
-
POST <cluster-ip>/dna/intent/api/v1/business/sda/multicast
Use this API to add multicast in the SDA fabric.
-
DELETE <cluster-ip>/dna/intent/api/v1/business/sda/multicast
Use this API to delete multicast from the SDA fabric.
To access the new SDA API, click the menu icon () and choose .
Expand the Connectivity drop-down list and choose SDA.
LAN Automation API
-
This Cisco DNA Center platform release supports new options in the LAN Automation API to perform LAN automation operations:
-
GET <cluster-ip>/dna/intent/api/v1/lan-automation/log/${id}
Use this API to get the LAN automation session logs based on the given LAN automation session ID.
-
GET <cluster-ip>/dna/intent/api/v1/lan-automation/status/${id}
Use this API to get the LAN automation session status based on the given LAN automation session ID.
-
GET <cluster-ip>/dna/intent/api/v1/lan-automation/log
Use this API to get the LAN automation session logs.
-
GET <cluster-ip>/dna/intent/api/v1/lan-automation/status
Use this API to get the LAN automation session status.
-
GET <cluster-ip>/dna/intent/api/v1/lan-automation/count
Use this API to get the total count of LAN automation sessions.
-
POST <cluster-ip>/dna/intent/api/v1/lan-automation
Use this API to start LAN automation for the given site.
-
DELETE <cluster-ip>/dna/intent/api/v1/lan-automation/${id}
Use this API to stop LAN automation for the given site.
-
-
This Cisco DNA Center platform release support an enhancement in the Upload API that allows you to upload the LAN automation files.
-
Post <cluster-ip>/dna/intent/api/v1/file/{namespace}
Use this API to upload the LAN automation files via Cisco DNA Center platform.
-
To access the new LAN Automation API, click the menu icon () and choose .
Expand the Site Management drop-down list and choose LAN Automation.
Devices API
This Cisco DNA Center platform release supports new options in the Devices API to perform devices operations:
-
GET <cluster-ip>/dna/intent/api/v1/interface/${interfaceUuid}/legit-operation
Get the list of all properties & operations valid for an interface.
-
PUT <cluster-ip>/dna/intent/api/v1/interface/${interfaceUuid
Add/Update interface description, VLAN membership, and change interface admin status (UP/DOWN) from request body.
-
POST <cluster-ip>/dna/intent/api/v1/interface/${interfaceUuid}/operation
Clear Mac-Address on an individual port. In request body, operation needs to be specified as 'ClearMacAddress'.
To access the new Devices API, click the menu icon () and choose .
Expand the Know Your Network drop-down list and choose Devices.
New ITSM Integration Features
Endpoint Attribute Retrieval with ITSM (ServiceNow) Bundle
-
With this release, the Endpoint Attribute Retrieval with ITSM (ServiceNow) bundle does not require Management, Instrumentation, and Discovery (MID) server setup.
-
For the Recurring schedule-based integration flow, you can now set the repeating interval for the Endpoint Attribute Retrieval with ITSM (ServiceNow) bundle on an hourly basis.
For more information, see Cisco DNA Center Endpoint Attribute Retrieval with ServiceNow in the Cisco DNA Center ITSM Integration Guide.
ServiceNow Cisco DNA Center App Support
ServiceNow Cisco DNA Center app support is extended for the Quebec, Paris, Orlando, and Rome versions.
New Reports GUI Features
The Cisco DNA Center platform support is extended for the following enhancements in the AP Radio report:
-
Cisco DNA Center support is extended for sorting and top N filter in existing AP Radio report that allows you to identify and capture the metrics of busiest AP radio.
The AP radio report data displays the number of rows equals to the number of radios in an AP.
-
In the Setup Report Scope page, Sort by filter supports the following options:
-
AP Name
-
Max Radio Utilization
-
Max Tx Utilization
-
Max Rx Utilization
-
Max Client Count
-
-
Select File Type page, the following new fields are added:
-
WLC IP Address
-
Max TX Utilization (%)
-
Max RX Utilization (%)
-
-
Supported report file formats include CSV, TDE, and JSON.
For more information about creating reports, see the Cisco DNA Center Platform User Guide.
Performance and Stability Improvements
Resolution of several bugs that enhances the performance and stability of the Cisco DNA Center platform.
Cisco DNA Center Scale
For Cisco DNA Center scale numbers, see the Cisco DNA Center Data Sheet.
Install the Cisco DNA Center Platform
When installing Cisco DNA Center, 2.3.2.x, you also install the Cisco DNA Center platform, 2.3.2.x. A separate installation procedure for the Cisco DNA Center platform is no longer required. For information about installing Cisco DNA Center, see the Cisco DNA Center Installation Guide.
After the installation, click the Platform link in the slide-in pane to access the Cisco DNA Center platform. The Cisco DNA Center platform is accessible to a user with a SUPER-ADMIN-ROLE. You can log in and view the Cisco DNA Center platform, as well as perform actions through its GUI after logging in as a user with a SUPER-ADMIN-ROLE. The NETWORK-ADMIN-ROLE and the OBSERVER-ROLE have more limited and restricted capabilities with the Cisco DNA Center platform.
Note |
If you have already installed an earlier version of the Cisco DNA Center platform, you can also upgrade to the most recent release by upgrading your current Cisco DNA Center release to 2.3.2.x. A separate upgrade procedure for the Cisco DNA Center platform is no longer required. |
Configure Integration Settings
In cases where firewalls or other rules exist between Cisco DNA Center and any third-party apps that need to reach the Cisco DNA Center platform, you must configure Integration Settings. These cases occur when the IP address of Cisco DNA Center is internally mapped to another IP address that connects to the internet or an external network.
Important |
After a backup and restore of Cisco DNA Center, you must access the Integration Settings window and update (if necessary) the Callback URL Hostname or IP Address using this procedure. |
Before you begin
You have installed the Cisco DNA Center platform as described in the previous section.
Procedure
Step 1 |
Click the menu icon () and choose . |
||
Step 2 |
Enter the Callback URL Hostname or IP Address that the third-party app needs to connect to when communicating with the Cisco DNA Center platform.
|
||
Step 3 |
Click Apply. |
Upgrade the Cisco DNA Center Platform
You can upgrade to Cisco DNA Center platform, 2.3.2.x from an earlier release by upgrading to Cisco DNA Center, 2.3.2.x. A separate upgrade procedure for the Cisco DNA Center platform is no longer required. For information about upgrading Cisco DNA Center, see the Cisco DNA Center Upgrade Guide.
Note |
The Cisco DNA Center platform is accessible to a user with a SUPER-ADMIN-ROLE. You can log in and view the Cisco DNA Center platform, as well as perform actions through its GUI after logging in as a user with a SUPER-ADMIN-ROLE. The NETWORK-ADMIN-ROLE and the OBSERVER-ROLE have more limited and restricted capabilities with the Cisco DNA Center platform. |
Bugs
Open Bugs for the Cisco DNA Center Platform, 2.3.2.3
The following table lists open bugs for the Cisco DNA Center platform for this release.
Bug ID Number |
Headline |
---|---|
When you fresh install Cisco DNA Center setup and click Test to validate the email after setting the primary SMTP server including sender and receiver, Cisco DNA Center fails to validate the email and displays the following error message:
Workaround: There is no workaround at this time. |
|
When you implement the ticket in ServiceNow, Cisco DNA Center displays the ticket pending status and later the ticket fails to implement. Workaround: There is no workaround at this time. |
Open Bugs for the Cisco DNA Center Platform, 2.3.2.0
The following table lists open bugs for the Cisco DNA Center platform for this release.
Bug ID Number |
Headline |
---|---|
In the Cisco DNA Center platform, FieldGroup name is missing in .csv file reports Workaround: There is no workaround at this time. |
|
The Cisco DNA Center platform displays the following error, when you generate the report for SWIM:
Workaround: There is no workaround at this time. |
|
When you save a notification to include a new event, the Cisco DNA Center platform does not prompt you to fill the required off-screen WebEx token field. Workaround: There is no workaround at this time. |
Resolved Bugs for the Cisco DNA Center Platform, 2.3.2.3
The following table lists the resolved bugs for the Cisco DNA Center platform, 2.3.2.3.
Bug ID Number |
Headline |
---|---|
When you generate a report manually, in the Location name field when you choose Scope, Cisco DNA Center displays only Global Services option and does not allow you to choose any other location. |
Resolved Bugs for the Cisco DNA Center Platform, 2.3.2.0
The following table lists resolved bugs for the Cisco DNA Center platform for this release.
Bug ID Number |
Headline |
---|---|
Cisco DNA Center platform and DR data on Mongodb hosting application stack results the following in MongoDB store.
|
|
The Client Detail, Client Session, and AP Radio report may fail to run/timeout or return to no data in Cisco DNA Center when you set the time frame of report for one month. |
|
Cisco DNA Center may encounter errors while attempting to integrate with ServiceNow over its business API. The errors are not displayed in the Cisco DNA Center GUI but the systems does not exchange any data. |
|
Cisco DNA Center may fail to save the email parameters after the first entry in the destinations. |
Limitations and Restrictions
The following sections describe the limitations and restrictions for this release.
IP Address Manager Integration
The following are the limitations and workarounds for IP Address Manager integration with Cisco DNA Center:
-
Infoblox:
-
Infoblox does not expose a name attribute; therefore, the comment field in Infoblox is populated by the IP pool name during a sync.
-
For a pool import, the first 50 characters of the comment field are used. If there are spaces in the comments, they are replaced by underscores.
-
If an IP pool name is updated for an imported pool, the comments are overwritten and the new name is reflected.
-
-
BlueCat: There are no limitations identified with BlueCat integration at this time.
Reports
Reports with significant data can sometimes fail to generate in the Cisco DNA Center platform. If this occurs, we recommend that you use filters to reduce the report size to prevent such failures.
Communications, Services, and Additional Information
-
To receive timely, relevant information from Cisco, sign up at Cisco Profile Manager.
-
To get the business impact you’re looking for with the technologies that matter, visit Cisco Services.
-
To submit a service request, visit Cisco Support.
-
To discover and browse secure, validated enterprise-class apps, products, solutions, and services, visit Cisco DevNet.
-
To obtain general networking, training, and certification titles, visit Cisco Press.
-
To find warranty information for a specific product or product family, access Cisco Warranty Finder.
Cisco Bug Search Tool
Cisco Bug Search Tool (BST) is a gateway to the Cisco bug-tracking system, which maintains a comprehensive list of defects and vulnerabilities in Cisco products and software. The BST provides you with detailed defect information about your products and software.
Documentation Feedback
To provide feedback about Cisco technical documentation, use the feedback form available in the right pane of every online document.
Cisco DNA Center Platform Resources and Documentation
The following table lists the resources and documentation that you can use when working with the Cisco DNA Center platform.
Resource | Link |
---|---|
Cisco DNA Center Platform User Guide Use this guide when working with the Cisco DNA Center platform GUI. |
|
Cisco DNA Center ITSM Integration Guide Use this guide with working with the Cisco DNA Center platform and ServiceNow. |
|
Cisco DNA Center Platform Overview Use this resource to access overview information about intent APIs and integration APIs. |
|
Getting Started with the Cisco DNA Center Platform Intent API Use this resource when working with the intent APIs and the Cisco DNA Center platform. |
Getting Started with the Cisco DNA Center Platform Intent API |
Cisco Code Exchange Code repositories related to Cisco technologies. |
Related Documentation
We recommend that you read the following documents relating to Cisco DNA Center.
For This Type of Information... | See This Document... |
---|---|
Release information, including new features, limitations, and open and resolved bugs. |
|
Installation and configuration of Cisco DNA Center, including postinstallation tasks. |
|
Upgrade information for your current release of Cisco DNA Center. |
|
Use of the Cisco DNA Center GUI and its applications. |
|
Configuration of user accounts, security certificates, authentication and password policies, and backup and restore. |
|
Security features, hardening, and best practices to ensure a secure deployment. |
|
Supported devices, such as routers, switches, wireless APs, and software releases. |
|
Hardware and software support for Cisco SD-Access. |
|
Use of the Cisco DNA Assurance GUI. |
|
Use of the Cisco DNA Center platform GUI and its applications. |
|
Cisco DNA Center platform release information, including new features, deployment, and bugs. |
|
Use of the Cisco Wide Area Bonjour Application GUI. |
|
Use of the Stealthwatch Security Analytics Service on Cisco DNA Center. |
|
Use of Rogue Management functionality as a dashboard within Cisco DNA Assurance in the Cisco DNA Center GUI. |
Cisco DNA Center Rogue Management Application Quick Start Guide |