Release Notes for Cisco DNA Center Platform, 2.1.2.x

This document describes the features, limitations, and bugs for the Cisco DNA Center platform, 2.1.2.x.

Change History

The following table lists the changes in this document since its initial release.

Table 1. Document Change History
Date Change Location

2021-06-11

Added new section: What's New in the Cisco DNA Center Platform, Release 2.1.2.7.

What's New in the Cisco DNA Center Platform, Release 2.1.2.7

Added new section: Open Bugs for Cisco DNA Center Platform, Release 2.1.2.7.

Open Bugs for Cisco DNA Center Platform, Release 2.1.2.7

Added new section: Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.7.

Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.7

2021-03-19

Added new section: Open Bugs for Cisco DNA Center Platform, Release 2.1.2.6.

Open Bugs for Cisco DNA Center Platform, Release 2.1.2.6

2021-01-15

Added new section: What's New in the Cisco DNA Center Platform, Release 2.1.2.5.

What's New in the Cisco DNA Center Platform, Release 2.1.2.5

Added new section: Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.5.

Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.5

Added new section: Open Bugs for Cisco DNA Center Platform, Release 2.1.2.5.

Open Bugs for Cisco DNA Center Platform, Release 2.1.2.5

2020-11-25

Added new section: What's New in the Cisco DNA Center Platform, Release 2.1.2.4.

What's New in the Cisco DNA Center Platform, Release 2.1.2.4

Added new section: Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.4.

Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.4

Added new section: Open Bugs for Cisco DNA Center Platform, Release 2.1.2.4.

Open Bugs for Cisco DNA Center Platform, Release 2.1.2.4

2020-10-16

Added new section: What's New in the Cisco DNA Center Platform, Release 2.1.2.3.

What's New in the Cisco DNA Center Platform, Release 2.1.2.3

Added new section: Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.3.

Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.3

Added new section: Open Bugs for Cisco DNA Center Platform, Release 2.1.2.3.

Open Bugs for Cisco DNA Center Platform, Release 2.1.2.3

2020-08-31

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

  • Multivendor Support

  • Events and Notification Services

What's New in the Cisco DNA Center Platform, Release 2.1.2.4

The following are the new features and functionalities for the Cisco DNA Center platform, 2.1.2.4.

New Events

This Cisco DNA Center platform release supports a new client tracing event.

You can subscribe to an event to be notified when a client has been in close proximity to a specific user. Once activated, you will receive notification for all devices that were in close physical proximity for greater than 5 minutes to that user (at the floor level).

The event states: "Trace clients in a close proximity of a specific user" and will be reachable for any devices within a 14-day period.

To subscribe to the new client tracing event, click the Menu icon and choose Platform > Developer Toolkit > Events > Client Tracing (NETWORK-CLIENTS-3-506).

New APIs

This Cisco DNA Center platform release supports the following new APIs:

  • New client proximity API to support client tracing.

    The following new client proximity API method is supported:

    • GET <cluster-ip>/dna/intent/api/v1/client-proximity

  • Updated the wireless API to support client tracing.

To view the new client proximity API, click the Menu icon and choose Platform > Developer Toolkit > APIs > Know Your Network > Clients > Client Proximity.

The client proximity API workflow requires the following steps:

  1. Subscribe to the new event, NETWORK-CLIENTS-3-506 (Client Tracing, Trace clients in a close proximity of a specific user.)

  2. Call the API:

    GET <cluster-ip>/dna/intent/api/v1/client-proximity

  3. Provide the username, number of days to track the proximity until the current date, and time resolution (time interval to measure proximity).


Note

The following are the defaults and range values for the API:

  • number_days – default 14, maximum 14

  • time_resolution – default 15 minutes, minimum 5 minutes

There is a maximum of one API call per 10 minutes.


Performance and Stability Improvements

Resolution of several bugs that enhances the performance and stability of the Cisco DNA Center platform.

What's New in the Cisco DNA Center Platform, Release 2.1.2.0

The following are the new features and functionalities for the Cisco DNA Center platform, 2.1.2.0.

Audit Log Support for Cisco DNA Center Platform

This release provides for audit log support for the Cisco DNA Center platform. New Cisco DNA Center platform audit logs capture the following critical activities:

  • User actions to configure, enable, and disable any of the Cisco DNA Center platform bundles.

  • User actions to view, edit, duplicate, delete, download, and run any reports in Cisco DNA Center.

  • User actions to subscribe to any of the events or notifications.

  • User actions to create, update, and change any preference for an instance.

  • User actions to invoke both successful and unsuccessful API methods (POST / PUT/ GET / DELETE).

The following data is captured in the audit logs:

  • User Role: SUPER-ADMIN-ROLE, NETWORK-ADMIN-ROLE, OBSERVER-ROLE, or user-created role.

  • Who took the action: Captured data includes user group, username, and user role (could be same as user-group).

  • When action occurred: Time that modification was made (UTC time).

  • What type of action occurred: An abstract or high level view of the action performed and if the action was successful or failed.

To access the audit logs using the Cisco DNA Center GUI, click the Menu icon () > Activity > Audit Logs.


Note

See the Cisco Digital Network Architecture Center Administrator Guide for detailed information about the audit logs.


Cisco DNA Center Platform Role-Based Access Control (RBAC) Support

This Cisco DNA Center platform release supports role-based access control (RBAC) for the following features:

  • APIs

  • Bundles

  • Events

  • Reports

The following roles are supported in this release:

  • SUPER-ADMIN-ROLE

  • NETWORK-ADMIN-ROLE

  • OBSERVER-ROLE

  • User-created or custom role(s)

All of the functionality of the above features are accessible for users with a SUPER-ADMIN-ROLE. Users with a SUPER-ADMIN-ROLE can create custom roles with deny, read, or write permissions for these features. Click System > User & Roles > Role Based Access Control to access the GUI workflow to create a custom role.


Note

The NETWORK-ADMIN-ROLE and the OBSERVER-ROLE have more limited and restricted capabilities with the Cisco DNA Center platform than the SUPER-ADMIN-ROLE. For example, these two roles do not permit the user to perform the following platform actions:

  • Generate reports

  • Subscribe to events

  • Configure event settings

  • Enable and configure bundles

  • Configure users and their roles


See the Cisco Digital Network Architecture Center Administrator Guide for detailed information about managing users and roles, including the new feature of creating roles.

New Settings Option: SysLog

This release supports a new Settings configuration option in the Cisco DNA Center GUI: SysLog. Use this new configuration option to configure the syslog server settings for event notifications.


Note

Credentials are required to validate that the syslog server is reachable.


To configure SysLog support for event notifications in the Cisco DNA Center GUI, click the Menu icon and choose System > Settings > External Services > Destination > SysLog.

See the Cisco DNA Center Platform User Guide for additional information about syslog server support for issue notifications.

Syslog Server Support for Event Notifications

This release supports the ability of Cisco DNA Center to forward an event notification to a syslog server. You use the Cisco DNA Center GUI to subscribe an event to a syslog server.

To subscribe an event to a syslog server, in the Cisco DNA Center GUI click the Menu icon and choose Platform > Developer Toolkit > Event. Next, select an event from the displayed list. If the selected event supports this new feature, choose SYSLOG from the Subscription Type drop down. Configure the additional Subscribe parameters and click the Subscribe button.

See the Cisco DNA Center Platform User Guide for additional information about syslog server support for issue notifications.

New Reports GUI Features

This Cisco DNA Center platform release supports the following new features for Reports:

  • A new GUI landing page for Reports that provides a list view of templates used to create the reports (All, Access Point, Client, Executive Summary, Inventory, and SWIM).

  • Reporting and scheduling configuration activities are now workflow based using the GUI.

  • Support to visualize generated reports within the Cisco DNA Center GUI.

  • Support to attach a scheduled report to an email that can be sent out.


    Note

    Emails can also be customized so that different reports can be sent to different users.


  • Support for a new Cisco DNA Center GUI option to send the report using either email or webhook.


    Note

    When webhook is selected in the GUI, Cisco DNA Center queries the webhook URL list and displays the results in a drop-down menu list. You can then select one of the webhook URLs from the list to use when creating the report.


  • New GUI option (Custom) to select the date and time range for a report generation.

  • New GUI option (Select Timezone) to choose the timezone for a custom report or a report to be generated in the future.

See the Cisco DNA Center Platform User Guide for information about creating reports.

New Reports

This Cisco DNA Center platform release supports the following new reports:

  • New channel report that provides visibility into the channel changes observed on an Access Point radio. Supported report file formats include CSV, TDE, and JSON.

    To access the new channel report, click the Menu icon and choose Reports > Reports Templates > Network Devices > Channel Change Count.

  • New PoE port availability and power budget reports. These reports provide detailed information about the switch ports and power. Supported report file formats include CSV, TDE, and JSON.

    To access the new PoE report, click the Menu icon and choose Reports > Reports Templates > Network Devices > PoE. To access the new power budget report, click the Menu icon and choose Reports > Reports Templates > Network Devices > Transmit Power Change Count.

  • New client usage report (from highest to lowest usage). This report provides data about the busiest clients by usage, transmit (TX) bytes, or Receive (RX) bytes. Supported report file formats include CSV, TDE, and JSON.

    To access this new report, click the Menu icon and choose Reports > Reports Templates > Client > Busiest Client.

  • New network devices availability report that provides detailed information about the average availability of devices. Supported report file formats include CSV, TDE, and JSON.

    To access this new report, click the Menu icon and choose Reports > Reports Templates > Network Devices > Network Device Availability.

  • New Rogue and aWIPS reports for network threats. These reports provide detailed information about any new rogue AP and aWIPS threats that are seen in the network. Supported report file formats include CSV, TDE, and JSON.

    To access the new threat report, click the Menu icon and choose Reports > Reports Templates > Rogue and aWIPS > New Threat. To access the new threat detail report, click the Menu icon and choose Reports > Reports Templates > Rogue and aWIPS > Threat Detail.

See the Cisco DNA Center Platform User Guide for information about creating reports.

New Event Features

New Events

This Cisco DNA Center platform release supports the following new events:

  • Drop in radio throughput for Cloud Applications

  • Drop in radio throughput for Media Applications

  • Drop in radio throughput for Social Applications

  • Drop in total radio throughput

  • Wireless clients took a long time to connect - Total time above baseline

  • Excessive failures to get Authenticated - High deviation from baseline

  • Excessive time to get Authenticated - High deviation from baseline

  • Excessive time to get Associated - High deviation from baseline

  • Excessive failures to get an IP address - High deviation from baseline

  • Excessive time to get an IP Address - High deviation from baseline

  • Excessive failures to connect - High deviation from baseline

  • Excessive time to connect - High deviation from baseline

  • Excessive failures to Associate - High deviation from baseline

  • CMX Connectivity failure

  • External IPAM provider connectivity failure

  • ISE AAA trust establishment failure

  • ISE PAN ERS connectivity failure

  • System Hardware health state change notification

To view the new events, click the Menu icon () and choose Platform > Developer Toolkit > Events.

New SNMP Event Notification Type

This Cisco DNA Center platform release supports a new event notification type: SNMP. You are now able to subscribe to an event using the following three notification types:

  • REST API endpoint

  • Email

  • SNMP trap


    Important

    The SNMP trap notification is only available for a system hardware event. A system hardware event publishes notifications to a subscriber, when there is a change to the state of the hardware components. Hardware components monitored for changes include: CPU, Memory, Disk, NIC, fan, power supply, and RAID Controller.


You subscribe to an event using the Cisco DNA Center GUI. In the Cisco DNA Center GUI, click the Menu icon () and choose Platform > Developer Toolkit > Events. The Events window appears and you can now view and subscribe to events. For detailed information about the subscription process, see the Cisco DNA Center Platform User Guide.

Event Simulation Support

This Cisco DNA Center platform release supports a new event simulation feature. With an event simulation, you can try out and test an event's subscription (email, REST API, SNMP trap notification). After running an event simulation, the results (success or failure) are provided in the GUI.

To run an event simulation, access the Events window. To access the Events window, click the Menu icon () and choose Platform > Developer Toolkit > Events.

Click on event for the simulation. Review the Event Details and Active Subscription tabs. In the Active Subscription tab, click Try It. The Notification field for the event appears. Review and edit (if necessary) the event's configuration. Click Publish to run the event simulation and review results.

See the Cisco DNA Center Platform User Guide for additional information about event simulations.

New Events: Assurance

The Cisco DNA Center platform supports the following new Assurance events:

  • NETWORK-DEVICES-3-106: The Access Point (AP) has gone down.

  • NETWORK-DEVICES-3-107: The Access Point (AP) has flapped.

The events are viewable in the Cisco DNA Center GUI Events window. Click the Menu icon and choose Platform > Developer Toolkit > Events to access the list of events.

New Event: CIMC

The Cisco DNA Center platform supports the following new CIMC event:

  • SYSTEM-CIMC: This event publishes notifications to any subscriber when the state of CIMC connectivity changes.

The events are viewable in the Cisco DNA Center GUI Events window. Click the Menu icon and choose Platform > Developer Toolkit > Events to access the list of events.

New Event: Disaster Recovery

The Cisco DNA Center platform supports the following new disaster recovery event:

  • SYSTEM-DISASTER-RECOVERY: This event publishes notifications to any subscriber when the state of disaster recovery changes.

The events are viewable in the Cisco DNA Center GUI Events window. Click the Menu icon and choose Platform > Developer Toolkit > Events to access the list of events.

New Event: External IPAM provider connectivity failure

The Cisco DNA Center platform supports a new monitoring event for an IPAM server:

  • SYSTEM-EXTERNAL-IPAM: This event publishes notifications to any subscriber, when the connectivity to the external IPAM server has failed. When the IPAM server is back up, a clear event message is automatically sent out.

The event is viewable in the Cisco DNA Center GUI Events window. Click the Menu icon and choose Platform > Developer Toolkit > Events to access the list of events.

New Events: License

The Cisco DNA Center platform supports the following new license events:

  • LICMGMT-DEV-DEREG-FAILURE: Device failed to de-register itself from Cisco Smart Software Manager.

  • LICMGMT-DEV-DEREG-SUCCESS: Device has been successfully de-registered from Cisco Smart Software Manager.

  • LICMGMT-DEV-REG-FAILURE: Device could not register itself to Cisco Smart Software Manager.

  • LICMGMT-DEV-REG-SUCCESS: Device has been successfully registered in Cisco Smart Software Manager.

  • LICMGMT-DEV-VA-CHANGE-FAILURE: Device virtual account change has failed.

  • LICMGMT-DEV-VA-CHANGE-SUCCESS: Device virtual account has been changed successfully.

  • LICMGMT-DLC-FAILURE: Device-led license conversion failed.

  • LICMGMT-DLC-SUCCESS: Device-led license conversion succeeded.

  • LICMGMT-DLC-SUCCESS: Device-led license conversion has completed successfully.

  • LICMGMT-DNA-ADV-TO-ESS-FAILURE: Device license level downgrade from Advantage to Essentials failed.

  • LICMGMT-DNA-ADV-TO-ESS-SUCCESS: Device license level downgrade from Advantage to Essentials succeeded.

  • LICMGMT-DNA-ESS-TO-ADV-FAILURE: Device license level upgrade from Essentials to Advantage has failed.

  • LICMGMT-DNA-ESS-TO-ADV-SUCCESS: Device license level has been successfully upgraded from Essentials to Advantage.

  • LICMGMT-LIC-ALMOST-EXPIRED: This notification is sent for devices whose licenses will expire in 30 days, 7 days or 1 day.

  • LICMGMT-LIC-RESERV-CANCEL-FAILURE: Cancellation of license reservation failed.

  • LICMGMT-LIC-RESERV-CANCEL-SUCCESS: Cancellation of license reservation succeeded.

  • LICMGMT-LIC-RESERV-ENABLE-FAILURE: Failed to enable license reservation.

  • LICMGMT-LIC-RESERV-ENABLED-SUCCESS: License reservation succeeded.

The events are viewable in the Cisco DNA Center GUI Events window. Click the Menu icon and choose Platform > Developer Toolkit > Events to access the list of events.

New Event: PxGrid

The Cisco DNA Center platform supports the following new PxGrid event:

  • SYSTEM-EXTERNAL-ISE-PXGRID: This event publishes notifications to any subscriber when the health state of the ISE PxGrid connections changes.

The events are viewable in the Cisco DNA Center GUI Events window. Click the Menu icon and choose Platform > Developer Toolkit > Events to access the list of events.

New GUI Locations (Settings)

In the Cisco DNA Center GUI, click the Menu icon () and choose System > Settings to access new locations for the following features:

  • Events Catalog

  • Webhook

  • Email

In Settings, click Events and Subscriptions to access the Events Catalog. In the Events Catalog window, you can select an event and subscribe to it. Supported subscription types include email, REST API endpoints, and SNMP trap notifications.

In Settings, click External Services > Destinations to access the Webhook and Email tabs. You can configure webhooks (REST API endpoints) and email using these tabs.

New API Features

Application API

The Cisco DNA Center platform supports a new Application API.

The following new methods are supported:

  • GET <cluster-ip>/dna/intent/api/v1/application-health

    Returns a list of applications for a specific site, a device, or a client device's MAC address.

To access the new API using the GUI, choose Platform > Developer Toolkit > APIs >Know Your Network > Applications.

Assurance APIs

The Cisco DNA Center platform supports enhancements to the Assurance APIs.

The following new Assurance API methods are supported:

  • GET <cluster-ip>/dna/intent/api/v1/site-health

    Returns overall health information for all sites.

    To access the new API using the GUI, choose Platform > Developer Toolkit > APIs > Know Your Network > Sites.

  • GET <cluster-ip>/dna/intent/api/v1/issues

    Returns a list of global issues, issues for a specific device, or issue for a specific client device's MAC address.

    To access the new API using the GUI, choose Platform > Developer Toolkit > APIs > Know Your Network > Issues.

  • GET <cluster-ip>/dna/intent/api/v1/device-health

    Accesses Assurance Device object for generating reports, creating dashboards or creating additional value added services.

    To access the new API using the GUI, choose Platform > Developer Toolkit > APIs > Know Your Network > Devices.

Assurance Sensor APIs

The Cisco DNA Center platform supports new Assurance Sensor APIs.

The following new methods are supported:

  • POST <cluster-ip>/dna/intent/api/v1/AssuranceCreateSensorTestTemplate

    Create a sensor test template.

  • DELETE <cluster-ip>/dna/intent/api/v1/AssuranceDeleteSensorTest

    Delete an existing sensor test.

  • PUT <cluster-ip>/dna/intent/api/v1/AssuranceDuplicateSensorTestTemplate

    Duplicate an existing sensor test template.

  • GET <cluster-ip>/dna/intent/api/v1/AssuranceGetSensor

    Return a list of sensor devices.

  • PUT <cluster-ip>/dna/intent/api/v1/AssuranceScheduleSensorTest

    Deploy, schedule, or edit a sensor test.

  • PUT <cluster-ip>/dna/intent/api/v1/AssuranceRunNowSensorTest

    Run a sensor test.

To access the new APIs using the GUI, choose Platform > Developer Toolkit > APIs > Know Your Network > Sensors.

Configuration Archive API

The Cisco DNA Center platform supports a new Configuration Archive API. The following new method is supported:

  • POST <cluster-ip>/dna/intent/api/v1/network-device-archive/cleartext

    Export device configurations to an encrypted zip file.

To access the new API using the GUI, choose Platform > Developer Toolkit > APIs > Site Management > Configuration Archive.


Note

Only a user with SUPER-ADMIN-ROLE permissions can access this API in the GUI.


Device Replacement APIs

The Cisco DNA Center platform supports new device replacement APIs.

The device replacement API documentation is accessible using either the Cisco DNA Center platform GUI or via Cisco DevNet. To access the new APIs using the GUI, choose Platform > Developer Toolkit > APIs > Site Management > Device Replacement. The following new methods are supported:

  • PUT <cluster-ip>/dna/intent/api/v1/device-replacement

    Method that unmarks the device for replacement.

  • POST <cluster-ip>/dna/intent/api/v1/device-replacement

    Method that marks the device for replacement.

  • POST <cluster-ip>/dna/intent/api/v1/device-replacement/workflow

    Method that triggers an RMA workflow that replaces the faulty device with a replacement device with the same configuration and images.

  • GET <cluster-ip>/dna/intent/api/v1/device-replacement/count

    Method that retrieves the replacement device count.

  • GET <cluster-ip>/dna/intent/api/v1/device-replacement

    Method that retrieves the replacement list of devices with details and filters the results based on Faulty Device Name, Faulty Device Platform, Replacement, and so on.

Event Retry APIs

This release supports new retry (resend and reprocess) APIs for an ITSM (ServiceNow) event. The following new methods are available to support retry:

  • GET <cluster-ip>/dna/intent/api/v1/integration/events

    Method to retrieve the list of all event or event instances that have failed to create incidents (RFCs) in ServiceNow (ITSM status = NA).

  • POST <cluster-ip>/dna/intent/api/v1/integration/events

    Method that once given the list of event instance IDs is able to resend the request to the ITSM (ServiceNow).

To access the new APIs in the Cisco DNA Center platform GUI, click Platform > Developer Toolkit > APIs > Ecosystem Integrations > ITSM.

IP Pool APIs

The Cisco DNA Center platform supports new bulk functionality for IP and Global Pools. The new functionality includes:

  • Enhanced GET API to support filtering of inherited IP pools.

  • Support for bulk DELETE and PUT API (edit) of Global IP Pools.

  • Support for bulk release/remove and edit of Site IP Pools.

To access the APIs and view the new functionality using the GUI, choose Platform > Developer Toolkit > APIs > Site Management > Network Settings and Platform > Developer Toolkit > APIs > SDA.

NFV Profile APIs

The Cisco DNA Center platform supports new Network Functions Visualization (NFV) Profile APIs.

The NFV Profile API documentation is accessible using either the Cisco DNA Center platform GUI or via Cisco DevNet. To access the new APIs using the GUI, choose Platform > Developer Toolkit > APIs > Site Management > Site Design. The following new methods are supported:

  • POST <cluster-ip>/dna/intent/api/v1/nfv/network-profile

    Method that creates a network profile for different Network Functions Visualization (NFV) topologies.

  • PUT <cluster-ip>/dna/intent/api/v1/nfv/network-profile/${id}

    Method that updates an existing NFV profile. You can provide a site profile ID as a mandatory path parameter to update. If an ID is not provided, then the site profile name is expected as a query parameter. Either input is required for updating the NFV profile.

  • GET <cluster-ip>/dna/intent/api/v1/nfv/network-profile/${id}

    Method that retrieves the NFV network profile details. The ID of the profile to be retrieved is provided as the path parameter. If the ID is not provided, then you can provide the site profile name to retrieve the details.

  • DELETE <cluster-ip>/dna/intent/api/v1/nfv/network-profile/${id}

    Method to delete the NFV network profile. You are expected to provide either the ID or the site profile name.

Rogue Management Threat APIs

The Cisco DNA Center platform supports new Rogue Management Threat APIs.

The following new methods are supported:

  • GET <cluster-ip>/dna/intent/api/v1/security/threats/summary

    The threat summary for the Rogues and aWIPS.

  • GET <cluster-ip>/dna/intent/api/v1/security/threats/details/count

    The detail counts for the Rogue and aWIPS threats.

  • GET <cluster-ip>/dna/intent/api/v1/security/threats/details

    The details for the Rogue and aWIPS threats.

The Rogue Management Threat APIs will only be registered and accessible after the Rogue and aWIPS package is installed. For information about downloading and installing a package, see 'Manage Applications' in the Cisco DNA Center Administrator Guide.

To access the new APIs using the GUI, choose Platform > Developer Toolkit > APIs >Know Your Network > Devices. You must first enable the Rogue and aWIPS bundle to view the APIs. Click the Menu icon > Platform > Manage > Bundles > Rogue and aWIPS > Enable.

SDA APIs

The Cisco DNA Center platform supports new SDA APIs. The following new methods are supported:

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/fabric/count

    Retrieve the number of fabrics.

  • GET <cluster-ip>/dna//intent/api/v1/business/sda/device/role

    Retrieve the SDA role of a device.

To access the new APIs using the GUI, choose Platform > Developer Toolkit > APIs >Connectivity > SDA.

New ITSM Integration Features

Endpoint Attribute Retrieval with ITSM (ServiceNow)

With this Cisco DNA Center release, you can schedule a synchronization or trigger an update between your ITSM (ServiceNow) configuration management database (CMDB) and endpoint inventory. Endpoint attribute information from ServiceNow can be used to help profile endpoints in your network. ServiceNow appears in the endpoint profiling workspace as an additional probe. You may create custom profiling rules leveraging the attributes sent by ServiceNow.


Note

Mapping between the CMDB fields and endpoint attributes occurs at the platform level and is accomplished using the new Endpoint Attribute Retrieval with ITSM (ServiceNow) bundle. See the Cisco DNA Center ITSM Integration Guide for information about the new bundle.


ITSM (ServiceNow) Events Retry

This Cisco DNA Center platform release supports a new retry mechanism for ITSM (ServiceNow) events.

In the Events Summary window, you can select an ITSM event to retry (resend and reprocess) to the ITSM (ServiceNow). To access the Events Summary window in the Cisco DNA Center platform GUI, click the Menu icon () > Platform > Runtime Dashboard > Events Summary. Click an ITSM event name (link) in Events Summary to view additional detailed data about the event and to access the Retry icon. Click the Retry icon to resend and reprocess the event.

See the Cisco DNA Center Platform User Guide for additional information about events retry.

Performance and Stability Improvements

Resolution of several bugs that enhances the performance and stability of the Cisco DNA Center platform.

Install the Cisco DNA Center Platform

For this release, when installing Cisco DNA Center, 2.1.2.7, you also install the Cisco DNA Center platform, 2.1.2.7. 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 version by upgrading your current Cisco DNA Center release version to 2.1.2.7. A separate upgrade procedure for the Cisco DNA Center platform is no longer required. For additional information and depending on your upgrade path, see:


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 will need to 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 need to access the Integration Settings page and update (if necessary) the Callback URL Host Name 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

In the Cisco DNA Center GUI, click the Menu icon () and choose System > Settings > System Configuration > Integration Settings.

Step 2

Enter the Callback URL Host Name or IP Address that the third-party app needs to connect to when communicating with the Cisco DNA Center platform.

Note 

The Callback URL Host Name or IP Address is the external-facing host name or IP address that is mapped internally to Cisco DNA Center. Configure the VIP address for a three-node cluster setup.

Step 3

Click the Apply button.


Upgrade to Cisco DNA Center Platform, Release 2.1.2.x

You can upgrade to Cisco DNA Center platform, Release 2.1.2.7 from an earlier release by upgrading to Cisco DNA Center, Release 2.1.2.7. 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 Cisco DNA Center Platform, Release 2.1.2.7

The following table lists open bugs for the Cisco DNA Center platform Release 2.1.2.7.

Table 2. Open Bugs for Cisco DNA Center platform, Release 2.1.2.7

Bug ID Number

Headline

CSCvx41364

Cisco DNA Center MongoDB instance hosts the following:

  • Application stack data including Cisco DNA Center platform.

  • Disaster Recovery (DR) with an ongoing implementation of new features.

This results in an increased size of the MongoDB store. The observed impacts of the larger store are:

  • Increase backup size and restore time.

  • In an HA environment, the downstream/secondary instances fail to sync with the primary MongoDB instance and cause the MongoDB instances to degrade into CrashLoopBackOff states.

Workaround: There is no workaround available at this time.

CSCvy32991

The Cisco DNA Center reports expire in one or two days after they are generated.

Cisco DNA Center does not allow you to download the expired reports. The reports contain less user information when downloaded prior to the expiration.

Workaround: There is no workaround available at this time.

Open Bugs for Cisco DNA Center Platform, Release 2.1.2.6

The following table lists open bugs for the Cisco DNA Center platform Release 2.1.2.6.

Table 3. Open Bugs for Cisco DNA Center Platform, Release 2.1.2.6

Bug ID Number

Headline

CSCvx38069

Cisco DNA Center may break some of the kong entries for the Cisco DNA Center REST API Bundle. This occurs when Cisco DNA Center is upgraded from its current version to a higher version.

Workaround:

Disable and then re-enable the Cisco DNA Center REST API bundle after a fresh install or upgrade.

CSCvx10360

Some of the APIs in the GUI (Developer Toolkit > APIs) are active but API endpoints issue an error message with following details:

"error" : "BAPI not found with technicalName <url path> and restMethod GET"

Workaround:

Disable and then re-enable the Cisco DNA Center REST API bundle after a fresh install or upgrade.

Open Bugs for Cisco DNA Center Platform, Release 2.1.2.5

The following table lists open bugs for the Cisco DNA Center platform Release 2.1.2.5.

Table 4. Open Bugs for Cisco DNA Center Platform, Release 2.1.2.5

Bug ID Number

Headline

CSCvr70208

Some of the APIs in the GUI (Developer Toolkit > APIs) issue an error message with following details:

"error" : "BAPI not found with technicalName <url path> and restMethod GET"

This occurs when Cisco DNA Center is either installed or upgraded from its current version to a higher version, and the Cisco DNA Center REST API Bundle is not auto-upgraded (since there is no change in the bundle version).

Workaround:

Disable and then re-enable the Cisco DNA Center REST API bundle after a fresh install or upgrade.

Open Bugs for Cisco DNA Center Platform, Release 2.1.2.4

The following table lists open bugs for the Cisco DNA Center platform Release 2.1.2.4.

Table 5. Open Bugs for Cisco DNA Center Platform, Release 2.1.2.4

Bug ID Number

Headline

CSCvr70208

Some of the APIs in the GUI (Developer Toolkit > APIs) issue an error message with following details:

"error" : "BAPI not found with technicalName <url path> and restMethod GET"

This occurs when Cisco DNA Center is either installed or upgraded from its current version to a higher version, and the Cisco DNA Center REST API Bundle is not auto-upgraded (since there is no change in the bundle version).

Workaround:

Disable and then re-enable the Cisco DNA Center REST API bundle after a fresh install or upgrade.

Open Bugs for Cisco DNA Center Platform, Release 2.1.2.3

The following table lists open bugs for the Cisco DNA Center platform Release 2.1.2.3.

Table 6. Open Bugs for Cisco DNA Center Platform, 2.1.2.3

Bug ID Number

Headline

CSCvr70208

Some of the APIs in the GUI (Developer Toolkit > APIs) issue an error message with following details:

"error" : "BAPI not found with technicalName <url path> and restMethod GET"

This occurs when Cisco DNA Center is either installed or upgraded from its current version to a higher version, and the Cisco DNA Center REST API Bundle is not auto-upgraded (since there is no change in the bundle version).

Workaround:

Disable and then re-enable the Cisco DNA Center REST API bundle after a fresh install or upgrade.

CSCvv17779

Cisco DNA Center event runtime pod crashes while accessing the audit logs page.

Workaround:

There is no workaround at this time.

Open Bugs for Cisco DNA Center Platform, Release 2.1.2.0

The following table lists open bugs for the Cisco DNA Center platform for this release.

Table 7. Open Bugs for Cisco DNA Center Platform, 2.1.2.0

Bug ID Number

Headline

CSCvr70208

Some of the APIs in the GUI (Developer Toolkit > APIs) issue an error message with following details:

"error" : "BAPI not found with technicalName <url path> and restMethod GET"

This occurs when Cisco DNA Center is either installed or upgraded from its current version to a higher version, and the Cisco DNA Center REST API Bundle is not auto-upgraded (since there is no change in the bundle version).

Workaround:

Disable and then re-enable the Cisco DNA Center REST API bundle after a fresh install or upgrade.

CSCvs12050

When selecting Part Number, Building, Location fields as Attributes in the Basic ITSM (ServiceNow) CMDB synchronization bundle (Inventory Fields) , the fields are not mapped in the ServiceNow CMDB table.

Workaround:

There is no workaround at this time.

CSCvt80254

Cisco DNA Center platform APIs cannot act independently.

As an example of a scenario that would cause an issue:

  • User has 'Write' access permissions on the Cisco DNA Center APIs, but cannot get the Cisco DNA Center POST API on inventory working (API responds with an error message).

  • User has only 'Read' access permissions on Inventory (Network Provision > Inventory Management).

Workaround:

Change the permissions using the Cisco DNA Center GUI:

  • Click System > User & Roles > Role Based Access Control > Platform > APIs (should be 'Write' permission).

  • Click System > User & Roles > Role Based Access Control > Network Provision > Inventory Management (change from 'Read' to 'Write' permission).

Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.7

The following table lists the resolved bugs for the Cisco DNA Center platform Release 2.1.2.7.

Table 8. Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.7

Bug ID Number

Headline

CSCvy09474

In the Cisco DNA Center Assurance events, email notifications may not work after an upgrade to release version 2.1.2.6.

CSCvx50695

Cisco DNA Center fails to send test email using NTLM for encryption and authentication. This causes confusion with the customer if they accidentally use an incorrect username or password, because the test email button sends an email without using the username or password.

CSCvx93717

In the Cisco DNA Center, Client Detail, Client Session, and AP Radio report may fail to run, timeout, or return no data when the report's time frame is set for one month. These reports run as expected with shorter time frames. client summary with data collection report may fail because of connection time out.

CSCvy00091

In Cisco DNA Center, when you enable the email notifications for event subscriptions, the email notifications may stop being sent.

In the Cisco DNA Center the Try It feature generates an error message stating Invalid email configuration. This error message occurs even if the email integration test succeeds.

CSCvy02496

When you generate a report, schedule a report, and choose a web-hook notification, Cisco DNA Center fails to display all the webhook destinations in the subscription profile.

Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.5

The following table lists the resolved bugs for the Cisco DNA Center platform Release 2.1.2.5.

Table 9. Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.5

Bug ID Number

Headline

CSCvv17779

Cisco DNA Center's Runtime may occasionally fail under load. This failure can happen when accessing audit logs and tasks pages, and when the audit logs exceed 1 million entries.

CSCvw24685

Cisco DNA Center to ServiceNow CMDB synchronization fails due to inventory including AP sensors.

Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.4

The following table lists the resolved bugs for the Cisco DNA Center platform Release 2.1.2.4.

Table 10. Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.4

Bug ID Number

Headline

CSCvv01668

With the previous release and API, you were not able to reprovision the AP with a different site and different RF profile name. This has been corrected with this release.

CSCvv19462

Inventory report does not display "Time Since Code Update" for eWC, eWLC, or any Polaris devices.

CSCvv27445

The URL in the notification email not working.

CSCvv48998

Three node Cisco DNA Center setup: device registration failure.

CSCvv61712

Updated the throttling policy for retrieve RF profiles.

CSCvv69726

For a POST /dna/intent/api/v1/network/{siteId} method:

Errors will occure if the network_aaa for ISE is different to "ipAddress".

CSCvv69728

For a POST /dna/intent/api/v1/network/{siteId} method:

Errors occure if clientAndEndpoint_aaa is MNT and PSN different IP address.

CSCvv69913

For a POST /dna/intent/api/v1/network/{siteId} method:

Unable to add ISE server with multiple PSN addresses.

CSCvv70800

For a POST /dna/intent/api/v1/network/{siteId} method:

Silently fails if the secondaryIpAddress == primaryIpAddress.

CSCvv87230

Duplicate assurance alerts posted to the REST API webhook.

CSCvv90599

Updated client sample report.

Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.3

The following table lists the resolved bugs for the Cisco DNA Center platform Release 2.1.2.3.

Table 11. Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.3

Bug ID Number

Headline

CSCvv27104

Latest 24 hours fabric operations are missing if filter the audit log by the user ID.

CSCvv48979

Update front-end libraries in Cisco DNA Center app services.

Resolved Bugs for Cisco DNA Center Platform, Release 2.1.2.0

The following table lists resolved bugs for the Cisco DNA Center platform for this release.

Table 12. Resolved Bugs for Cisco DNA Center Platform, 2.1.2.0

Bug ID Number

Headline

CSCvs20363

The following issues are open with this bug:

  • In the Cisco DNA Center Platform GUI, click Manage > Configurations > General Settings > CMDB Synchronization Settings. When you add an instance or edit an instance, the first page side header, Select Destination needs to be moved below the instance name/description or the select destination details needs to be moved to the second page.

  • The mandatory validation for an instance name is missing. If the user does not enter the instance name, the redirection goes to the last page and clicking on the Save button is not working.

  • Creating a duplicate instance with same name is not throwing a validation error (clicking on the Save button is not working).

CSCvt36852

Client detail TDE report KPI field issues.

CSCvt69693

Site Network settings configured through REST API not showing correctly in the GUI.

CSCvt88254

Network setting not getting updated correctly through the REST API.

CSCvt97183

Cisco DNA Center 1.3.3.x - network-device Get Device list documentation.

CSCvu05054

Various pages under Platform tab need to meet Cisco requirements.

CSCvu08526

Discrepencies on issue description between Assurance and events page.

CSCvu09429

Need to synchronize the issue name between Assurance and events page.

CSCvu09430

The "POE powered device flagged faulty" issue is available for subscription via the Platform Events Catalog, but is tagged as "Not Supported" in the Issue Settings page.

CSCvu12055

Cisco DNA Center 2.1.x - Get Interface by IP API documentation.

CSCvu14533

Reports tiles are spaced incorrectly.

CSCvu16985

Documentation update for Get Device List API wildcard.

CSCvu19063

The error message for deleting one PoE report while it is still generating should be more user friendly.

CSCvu23471

Reports details are not appearing in the GUI correctly.

CSCvu24017

Cluster IP address showed in report email is not corrrect.

CSCvu32225

The calendar selection today enables users to select time period beyond 90 days and the error message is only displayed in the last step (run report). Ideally, the calendar should only show the maximum time period available for the report from the start date and rest of the days should be greyed out.

CSCvu37793

Request and response schema should not be displayed in side by side view.

CSCvu47211

API details to be available for ADMIN under Development Toolkit by default.

CSCvu55388

After an upgrade to Cisco DNA Center Release GA 2.1.2, user is not able to update configuration of older report.

CSCvu61950

Authorization failure in subscription API.

CSCvu67290

For a Client Report, the Client Details report are failing with Data Collection.

Use the Bug Search Tool

Use the Bug Search tool to search for a specific bug or to search for all bugs in this release.

Procedure


Step 1

Enter the following URL in your browser:

Step 2

In the Log In window, enter your registered cisco.com username and password and click Log In.

The Bug Search window opens.

Note 
If you do not have a cisco.com username and password, register at https://idreg.cloudapps.cisco.com/idreg/guestRegistration.do.
Step 3

To search for a specific bug, enter the bug ID in the Search For field and press Return.

Step 4

To search for bugs in the current release:

  1. In the Search For field, enter Cisco DNA Center and press Return. (Leave the other fields empty.)

  2. When the search results are displayed, use the filter tools to find the types of bugs you are looking for. You can search for bugs by modified date, status, severity, and so forth.

    To export the results to a spreadsheet, click the Export Results to Excel link.

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.

Service and Support

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.

Table 13. Cisco DNA Center Platform Resources and Documentation

Resource

Link

Cisco DNA Center Platform User Guide

Use this guide when working with the Cisco DNA Center platform GUI.

Cisco DNA Center Platform User Guide

Cisco DNA Center ITSM Integration Guide

Use this guide with working with the Cisco DNA Center platform and ServiceNow.

Cisco DNA Center ITSM Integration Guide

Cisco DNA Center Platform Overview

Use this resource to access overview information about intent APIs, multivendor support, and integration APIs.

Cisco DNA Center Platform Overview

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

Getting Started with Cisco DNA Center Multivendor SDK

Use this resource when working with the SDK and the Cisco DNA Center platform.

Getting Started with Cisco DNA Center Multivendor SDK

Cisco DNA Center Multivendor SDK Release Notes

Release information about the SDK.

Cisco DNA Center Multivendor SDK Release Notes

Cisco Code Exchange

Code repositories related to Cisco technologies.

Cisco Code Exchange

Related Documentation

We recommend that you read the following documents relating to Cisco DNA Center.


Note

The documentation set for this product strives to use bias-free language. For purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product.


For This Type of Information... See This Document...

Release information, including new features, limitations, and open and resolved bugs.

Cisco DNA Center Release Notes

Installation and configuration of Cisco DNA Center, including postinstallation tasks.

Cisco DNA Center Installation Guide

Upgrade information for your current release of Cisco DNA Center.

Cisco DNA Center Upgrade Guide

Use of the Cisco DNA Center GUI and its applications.

Cisco DNA Center User Guide

Configuration of user accounts, security certificates, authentication and password policies, and backup and restore.

Cisco DNA Center Administrator Guide

Security features, hardening, and best practices to ensure a secure deployment.

Cisco DNA Center Security Best Practices Guide

Supported devices, such as routers, switches, wireless access points, NFVIS platforms, and software releases.

Supported Devices

Hardware and software support for Cisco SD-Access.

Cisco SD-Access Hardware and Software Compatibility Matrix

Use of the Cisco DNA Assurance GUI.

Cisco DNA Assurance User Guide

Use of the Cisco DNA Center platform GUI and its applications.

Cisco DNA Center Platform User Guide

Cisco DNA Center platform release information, including new features, deployment, and bugs.

Cisco DNA Center Platform Release Notes

Use of the Cisco Wide Area Bonjour Application GUI.

Cisco Wide Area Bonjour Application User Guide

Use of the Stealthwatch Security Analytics Service on Cisco DNA Center.

Cisco Stealthwatch Analytics Service User Guide

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