release notes for cisco dna center platform, release 1.3.1 ·...

Release Notes for Cisco DNA Center Platform,Release 1.3.1.x

First Published: 2019-09-05

Last Modified: 2020-04-28

Release Notes for Cisco DNA Center Platform, Release 1.3.1.xThis document describes the features, limitations, and bugs for the Cisco DNA Center platform, Release1.3.1.x.

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

Table 1: Document Change History

LocationChangeDate

What's New in the Cisco DNA Center Platform,Release 1.3.1.6, on page 3

Added new section: What's New in the Cisco DNACenter Platform, Release 1.3.1.6.

2020-04-28

Upgrade to Cisco DNA Center Platform, Release1.3.1.6, on page 13

Added new section: Upgrade Cisco DNA CenterPlatform, Release 1.3.1.6.

Resolved Bugs for Cisco DNA Center Platform,Release 1.3.1.6, on page 25

Added new section: Resolved Bugs for Cisco DNACenter Platform, Release 1.3.1.6.

Open Bugs for Cisco DNACenter Platform, Release1.3.1.6, on page 16

Added new section: Open Bugs for Cisco DNACenter Platform, Release 1.3.1.6.



2020-02-20







Release Notes for Cisco DNA Center Platform, Release 1.3.1.x1

LocationChangeDate



2019-12-06









2019-10-10







—Changed title from Cisco DNA Center PlatformRelease 1.3.1.0 to Release 1.3.1.x to accommodatefor patch release versions.

2019-10-04

—Initial release.2019-9-04

OverviewCisco DNA Center provides an extensible platform that Cisco customers and partners can use to createvalue-added applications that can be built on top of its native capabilities. You can leverage the followingCisco DNA Center platform features to enhance the overall network experience by optimizing end-to-end ITprocesses, reducing Total Cost of Ownership (TCO), and developing new value networks:

• Intent APIs: The Intent APIs are Northbound REST APIs that expose specific capabilities of Cisco DNACenter platform. The Intent APIs provide policy-based abstraction of business intent, allowing you tofocus on an outcome to achieve instead of struggling with the mechanisms that implement that outcome.The APIs conform to the REST API architectural style that are simple, extensible, secure to use andsupport the standard REST methods which includes the GET, POST, PUT and DELETE operationsthough HTTPS. For additional information, see Getting Started with the Cisco DNA Center PlatformIntent API.

• Integration Flows: Integration capabilities are part of Westbound Interfaces. To meet the need to scaleand accelerate operations in modern data centers, IT operators require intelligent, end-to-end workflowsbuilt with open APIs. Cisco DNA Center platform provides mechanisms for integrating Cisco DNAAssurance workflows and data with third-party IT ServiceManagement (ITSM) solutions. For additionalinformation, see Integration APIs.


Overview

https://developer.cisco.com/docs/dna-center/#!preface


https://developer.cisco.com/dnacenter/integrationapis/

• Multivendor Support: CiscoDNACenter allows customers tomanage their non-Cisco devices.Multivendorsupport comes to Cisco DNACenter through the use of an SDK that can be used to create device packagesfor third-party devices. A device package enables Cisco DNA Center to communicate to third-partydevices bymapping Cisco DNACenter features to their southbound protocols. For additional information,see Getting Started with Cisco DNA Center Multivendor SDK.

• Events and Notifications Services: Supported services are available for Cisco DNAAssurance and CiscoDNA Center Automation (SWIM) events to be captured and forwarded onto third-party applications viaa webhook URL. For additional information, see Getting Started with Webhooks on the Cisco DNACenter Platform.

What's New in the Cisco DNA Center Platform, Release 1.3.1.6This release resolves several bugs to improve the performance and stability of the Cisco DNACenter platform.For additional information, see Resolved Bugs for Cisco DNA Center Platform, Release 1.3.1.6, on page 25.




What's New in the Cisco DNA Center Platform, Release 1.3.1.0The following are the new features and functionalities for the Cisco DNA Center platform, Release 1.3.1.0.

Bundle Install and Upgrade Enhancements

Cisco DNA Center platform supports the following new installation and upgrade enhancements:

• Installation Enhancement:When installing Cisco DNACenter, Release 1.3.1.0, you also install the CiscoDNA Center platform, Release 1.3.1.0. After installing Cisco DNA Center and Cisco DNA Centerplatform for this release, the Cisco DNA Center REST API bundle is enabled and activated by default.

• Upgrade Enhancement: After an upgrade from Cisco DNA Center platform, Release 1.3 to Release1.3.1.0, the Cisco DNA Center the REST API bundle is enabled and activated by default. Upgradingfrom any earlier Cisco DNA Center platform release still requires that you disable and then re-enablethe Cisco DNA Center REST API bundle.

Updated API GUI

Cisco DNA Center platform supports the following updated API GUI changes with this release:

• Authentication domain is moved to the top of the hierarchy in the APIs GUI.


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

https://developer.cisco.com/docs/dna-center/#!overview

https://developer.cisco.com/docs/dna-center/#!getting-started-with-webhooks-on-the-cisco-dna-center-platform/getting-started-with-webhooks-on-the-cisco-dna-center-platform

https://developer.cisco.com/docs/dna-center/#!getting-started-with-webhooks-on-the-cisco-dna-center-platform/getting-started-with-webhooks-on-the-cisco-dna-center-platform

Click Platform > Manage > Developer Toolkit > APIs to view the hierarchy.

• NewEvent Management domain that contains API methods for events, notifications, and subscriptions.

• New Policy domain.

For information about the new APIs for the Policy domain, see Application Policy API, on page 9.

• Operational Tools domain is renamed to Operational Tasks.

• Under the Know your Network domain, Networks is renamed to Topology.

• Under the Site Management domain:

• Site Profile is renamed to Site Design.

• PnP is renamed to Device Onboarding (PnP).

• SWIM is renamed to Software Image Management (SWIM).

• Template Programmer is renamed to Configuration Templates.

Assurance Event Notifications

The following Assurance event notification functionality is supported with this release:

• Cisco DNA Center platform publishes a list of Assurance issues in the GUI that are important enoughfor the user to receive an email or REST API endpoint notification.

• Ability for users to select from the published list of Assurance issues for which they want to be notified.

• Ability for the users to choose the notification mechanism using the GUI, such as email and REST APIendpoint.

• Based on the selection, if an issue occurs that matches the selection criteria an external notification isautomatically sent out.

The following data is sent to the user for an Assurance event notification:

• Type (Network Device, Client, Application, or Sensor)

• Issue Identifier for API callback (the event receiver can query back to get additional details about theissues of their interest)

• Unique Identifier (name or MAC address as appropriate) for the device or client or application or sensorthat is involved in the issue (event receiver can make an API call to get additional details about thatentity)

• Issue summary: This will be Event Name

• Issue description: This will be Event Summary

• Issue URL: Cisco DNA Center issue detail URL page (event context link)

• Issue Category: Assurance issue category will be used as part of email body

• Issue API details: Deep link to issue enrichment APIs on Cisco DNA Center


Assurance Event Notifications

You can view and subscribe to the Assurance events in Events in the Cisco DNA Center platform GUI. ClickPlatform >Developer Toolkit >Events to access this window and subscribe to events. For detailed informationabout these procedures, see the Cisco DNA Center Platform User Guide.

Email Event Notifications

Cisco DNA Center platform supports the following email event features:

• Supports an option in Events where the user selects the events for notification.

• Supports an upper threshold of 1000 emails a day.

• Supports up to 20 email addresses or email aliases.

• Supports an audit log of all the events that resulted in a notification.

You configure email event notifications in Settings in the Cisco DNA Center GUI. Click System Settings >Settings > Email configuration to access the GUI window and configure email event notifications. Yousubscribe to email event notifications in Events in the Cisco DNA Center platform GUI. Click Platform >Developer Toolkit > Events to access this window and subscribe to events. For detailed information aboutthese procedures, see the Cisco DNA Center Platform User Guide.

ITSM Integration Updates for Cisco DNA Center

The following are the updates and changes for IT Service Management (ITSM) integration for this CiscoDNA Center release:

• TheNetwork Events for REST API Endpoint bundle has been deprecated. If you have configured thisbundle for an earlier Cisco DNA Center platform release and are using it for scheduled events, be awarethat it will not work with this release and that you need to reconfigure the individual RESTAPI endpointsfor specific network events.

Additionally, the Scheduler for this bundle will not show up in IntegrationFlows under the Developer Toolkit.

Note

You reconfigure REST API endpoints for events using the new GUI. Click Platform > DeveloperToolkit > Events. Review the listed events in this window and click a specific event (name) that youwish to configure. After clicking on an event name in this window, review the event details and thenclick Subscribe to create a REST API endpoint. For additional information about configuring RESTAPI endpoints for an event, see the Cisco DNA Center Platform User Guide.

Event notifications now occur when the event actually occurs and not accordingto any scheduled time that you configure.

Important

• Event settings lose the preferences previously selected after you upgrade to this release. You will alsoneed to reconfigure the preferences again. Click Platform >Manage >Configurations >Event Settingsto access a GUI window and reconfigure the preferences.

• TheDevice Image Outdated event setting preference (which is for a SWIM event), if selected previouslywill be lost when upgrading to this release. You will need to reconfigure this SWIM event again. Click


Email Event Notifications

Platform > Manage > Configurations > Event Settings to access the GUI window and reconfigurethe preferences for this SWIM event.

• For the SWIM Events for REST API Endpoint bundle, the configuration settings will be removed bydefault after upgrading to this release. You need to click the update for this bundle to get the latestconfiguration settings and for this to work. See Update the Bundles, on page 15 for information aboutupdating the bundles.

• If the Network Issue Monitor and Enrichment for ITSM (ServiceNow) bundle was running on CiscoDNACenter Platform release version 1.3, then perform the following steps for it to work after an upgrade:

1. From the Cisco DNA Center home page, click Platform > Manage > Bundles.

2. Locate the Network Issue Monitor and Enrichment for ITSM (ServiceNow) bundle and clickthe Update button.

3. Next, click the Configure button.

4. Click the Activate button to save your configuration and for this bundle to work after the upgrade.

• Several network event APIs have moved from the Network Issue Monitor and Enrichment for ITSM(ServiceNow) bundle to theCisco DNA Center REST API bundle. If you are using these network eventAPIs from a previous release, they will not work for this release and you need to recreate them for yourpurposes using the data and samples located within the Cisco DNA Center REST API bundle.

Additionally, the Scheduler for this bundle will not show up in IntegrationFlows under the Developer Toolkit.

Note

The following APIs moved to the Cisco DNA Center REST API bundle:

• Get Issue Enrichment Details

• Get User Enrichment Details

• Get Device Enrichment Details

• Get Client Enrichment Details

Click Platform > Manage > Bundles > Cisco DNA Center REST API. In the Cisco DNA CenterREST API window that opens, click the Contents tab > APIs, and then scroll down the list of APIsuntil you locate one of the preceding APIs. Proceed to use the data and samples to recreate the API.

You can also access the APIs by clicking Platform >Developer Toolkit >APIs >Know Your Networkand the appropriate subdomain (Devices, Clients, Users, or Issues).

For additional information about these bundles, see the Cisco DNA Center Platform User Guide.

• The number of Assurance events that are available for notification in the Cisco DNA Center platform isreduced for this release. You can view the available Assurance events by either clicking Platform >Manage > Configurations > Event Settings or Platform > Developer Toolkit > Events.

• TheRuntime Dashboardwill show previous priorities (P1…P5) until 6 hours after the upgrade (minimumtime filter).


ITSM Integration Updates for Cisco DNA Center

ITSM Integration Enhancements

The Cisco DNA Center platform supports the following updated ITSM enhancements with this release:

• Enhanced Exception Handling between the ServiceNow (ITSM) tools and Cisco DNACenter, including:

• Timeouts between Cisco DNA Center and ServiceNow.

• Errors that may occur when tickets are meant to be created from Cisco DNA Center to ServiceNowand the tickets are not created.

• Errors that may occur during the change window stage when Cisco DNA Center does not receivethe change window information.

• Errors that may occur when the tickets have to be closed on ServiceNow from Cisco DNA Center.

• Active sync between Cisco DNA Assurance issues and the events listed under the Cisco DNA Centerplatform.

This release ensures that the events displayed under the Platform tab are in syncwith the total list of Assurance issues. For example, if Assurance has 50 issues,then 50 events are displayed in the Platform page that you can configure to mapto ITSM and not have a mismatch in numbers.

Note

For detailed information about Cisco DNA Center ITSM integration, see the Cisco DNA Center ITSMIntegration Guide.

Cisco DNA App Certification

The Cisco DNA app is now certified to work with the following Cisco DNACenter and ServiceNow releases.

Cisco DNA Center release versions:

• GA 1.2.8

• GA 1.2.10

• GA 1.2.12

• GA 1.3

• GA 1.3.0.3

• GA 1.3.1.0

ServiceNow release versions:

• Madrid

• London

• Kingston

For detailed information about Cisco DNA Center ITSM integration, see the Cisco DNA Center ITSMIntegration Guide.


ITSM Integration Enhancements

Reporting Features

The Cisco DNA Center platform supports the following new reporting features with this release:

• You can now select a subset of reporting fields to be included into a report to be exported as a CSV,JSON, or Tableau Data Extract file.

For SWIM data and reports, you can select specific fields for both CSV and Tableau Data Extract filetypes. For Client data and reports, you can select Client Detail and then select specific fields for CSV,Tableau Data Extract, and JSON file types. For Inventory data and reports, you can select specificfields for both CSV and Tableau Data Extract file types.

• You can now download a report from an email sent from the Cisco DNA Center platform.

The email will contain a link from where you can download the report.

You configure the email when scheduling the actual report in the GUI. Click Platform > DeveloperToolkit > Data and Reports. In the Catalog window in Data and Reports, click Schedule for thereport type (SWIM, Client, or Inventory). Enter an email address at the bottom of the GUI window inthe Send to field for applying filters and schedules. For detailed information about these procedures, seethe Cisco DNA Center Platform User Guide.

New and Updated APIs

Non-Fabric Wireless API

The Cisco DNA Center platform supports a new Non-Fabric Wireless API. The Non-Fabric Wireless APIdocumentation is accessible using either the Cisco DNA Center platform GUI or via Cisco DevNet.

To access the new API using the GUI, choose Platform > Developer Toolkit > APIs > Connectivity >Non-Fabric Wireless. The following new methods are supported:

Access Point Provisioning and Reprovisioning

• POST <cluster-ip>/dna/intent/api/v1/wireless/ap-provision

Method used to provision or reprovision an access point.

The following are prerequisites for this method:

• Must be a managed AP location, RF profile, controller with the access point.

• The site value must be with full hierarchy (for example, Global/zzz/ccc/aaa).

Create, Read, Update, and Delete (CRUD) RF Profiles or Retrieve RF Profiles

• GET <cluster-ip>/dna/intent/api/v1/wireless/rf-profile

GET <cluster-ip>/dna/intent/api/v1/wireless/rf-profile?rf-profile=<RF Profile Name>

Methods used to retrieve one or more RF profiles.

• POST <cluster-ip>/dna/intent/api/v1/wireless/rf-profile

Method used to create or update an RF profile or profiles.

• DELETE <cluster-ip>/dna/intent/api/v1/wireless/rf-profile/${rf-profile-name}

Method used to delete an RF profile.


Reporting Features

For information about the Cisco DNACenter platformNon-FabricWireless APIs on Cisco DevNet, see CiscoDNA Center Platform Intent APIs. For information about accessing and viewing the APIs using the CiscoDNA Center platform GUI, see the Cisco DNA Center Platform User Guide.

Application Policy API

The Cisco DNA Center platform supports a new Application Policy API. The Application Policy API has thefollowing functionality:

• Support for creating applications and application sets.

• Support for editing applications and applications sets.

• Support for deleting applications and application sets.

The Application Policy API documentation is accessible using either the Cisco DNA Center platform GUIor via Cisco DevNet. To access the new API using the GUI, choose Platform > Developer Toolkit > APIs> Policy > Application Policy. The following new methods are supported:

• GET <cluster-ip>/dna//intent/api/v${majorVersion}/applications

Method that gets the application by offset/limit or by name.

• GET <cluster-ip>/dna/intent/api/v${majorVersion}/applications-count

Method that gets the number of existing applications.

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

Method that gets all applications sets as a list.

• GET <cluster-ip>/dna/intent/api/v1/application-policy-application-set-count

Method that gets the number of existing application sets.

• POST <cluster-ip>/dna/intent/api/v${majorVersion}/applications

Method that creates new custom application or applications.

• POST <cluster-ip>/dna/intent/api/v1/application-policy-application-set

Method that creates a new application set.

• PUT <cluster-ip>/dna/intent/api/v${majorVersion}/applications

Method that edits an existing application or applications.

• DELETE <cluster-ip>/dna/intent/api/v${majorVersion}/applications

Method that deletes an existing application by ID. The query parameters are:

• id = [application_id]

• As an example, id = 0ba43f74-caa3-4a80-a9b8-fc5e64260dc2

• DELETE <cluster-ip>/dna/intent/api/v1/application-policy-application-set

Method that deletes an existing application set by ID. The query parameters are:

• id = [application_set_id]

• As an example, id = 02260050-2313-4768-8696-78de240d0db3


Application Policy API

https://developer.cisco.com/site/dna-center-rest-api/


For information about Cisco DNACenter platformApplication Policy APIs on Cisco DevNet, see Cisco DNACenter Platform Intent APIs. For information about accessing and viewing the APIs using the Cisco DNACenter platform GUI, see the Cisco DNA Center Platform User Guide.

SDA API (BETA)

The Cisco DNA Center platform supports an updated SDA API. The SDA API documentation is accessibleusing either the Cisco DNA Center platform GUI or via Cisco DevNet. The SDA API has the followingfunctionality:

• Support for managing default Authentication Template (Profile) selection for a host onboarding in theSDA fabric.

• Support for adding IP address pools to virtual networks.

• Support for managing port assignments for user devices and access points.

• Support for edge device lifecycle management in the SDA fabric.

To access the updated API using the GUI, choose Platform > Developer Toolkit > APIs> Connectivity >Fabric Wired. The following new methods are supported:

Default Authentication Template (Profile) selection for host onboarding in SDA fabric

• PUT <cluster-ip>/dna/intent/api/v1/business/sda/authentication-profile

Update default authentication profile template in SDA Fabric.

• POST <cluster-ip>/dna/intent/api/v1/business/sda/authentication-profile

Add default authentication profile in SDA Fabric.

• GET <cluster-ip>/dna/intent/api/v1/business/sda/authentication-profile

Get default authentication profile from SDA Fabric.

• DELETE <cluster-ip>/dna/intent/api/v1/business/sda/authentication-profile

Delete default authentication profile from SDA Fabric.

Adding IP Pools to Virtual Networks (SDA Segment life management)

• POST <cluster-ip>/dna/intent/api/v1/business/sda/virtualnetwork/ippool

Add IP Pool in SDA Virtual Network.

• GET <cluster-ip>/dna/intent/api/v1/business/sda/virtualnetwork/ippool

Get IP Pool from SDA Virtual Network.

• DELETE <cluster-ip>/dna/intent/api/v1/business/sda/virtualnetwork/ippool

Delete IP Pool from SDA Virtual Network.

Port Assignment for User Devices

• POST <cluster-ip>/dna/intent/api/v1/business/sda/hostonboarding/user-device

Add Port assignment for user device in SDA Fabric.

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


SDA API (BETA)



Get Port assignment for user device in SDA Fabric.

• DELETE <cluster-ip>/dna/intent/api/v1/business/sda/hostonboarding/user-device

Delete Port assignment for user device in SDA Fabric.

Edge-Device life cycle management in SDA fabric

• POST <cluster-ip>/dna/intent/api/v1/business/sda/edge-device

Add edge device in SDA Fabric.

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

Get edge device from SDA Fabric.

• DELETE <cluster-ip>/dna/intent/api/v1/business/sda/edge-device

Delete edge device from SDA Fabric.

Border Device Business APIs

• POST <cluster-ip>/dna/intent/api/v1/business/sda/border-device

Adds border device in SDA Fabric.

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

Gets border device detail from SDA Fabric.

• DELETE <cluster-ip>/dna/intent/api/v1/business/sda/border-device

Deletes border device from SDA Fabric.

For information about Cisco DNA Center platform SDA APIs on Cisco DevNet, see Cisco DNA CenterPlatform Intent APIs. For information about accessing and viewing the APIs using the Cisco DNA Centerplatform GUI, see the Cisco DNA Center Platform User Guide.

Network Settings API

The Cisco DNA Center platform supports a new Network Settings API. The Network Settings APIdocumentation is accessible using either the Cisco DNA Center platform GUI or via Cisco DevNet.

To access the new API using the GUI, choose Platform > Developer Toolkit > APIs > Site Management> Network Settings. The following new methods are supported:

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

Method that gets all of the service provider profiles.

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

Method that gets the device credential details.

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

Method that gets the global IP pool details.

• DELETE <cluster-ip>/dna/intent/api/v1/device-credential/{id}

Method that deletes device credentials, including CLI, SNMPV3, SNMP READ, SNMPWRITE, HTTPREAD, and HTTP WRITE.


Network Settings API



• DELETE <cluster-ip>/dna/intent/api/v1/sp-profile/{sp-profile-name}

Method that deletes service provider/QoS profiles.

• DELETE <cluster-ip>/dna/intent/api/v1/global-pool/{id}

Method that deletes a global IP pool.

For information about Cisco DNA Center platform Network Setting APIs on Cisco DevNet, see Cisco DNACenter Platform Intent APIs. For information about accessing and viewing the APIs using the Cisco DNACenter platform GUI, see the Cisco DNA Center Platform User Guide.

Know Your Network API

The following enhancements were made to the GET Site and GET Membership APIs in the Know YourNetwork domain for this release.

To access the updated APIs using the GUI, choose Platform > Developer Toolkit > APIs > Know YourNetwork > Sites. The following updated methods are supported:

• GET Site:

• Removed status flag from the response payload.

• Removed runsync attributes in the request header.

• Removed systemGroup, groupTypeList attributes from the response payload.

• Renamed grouphierarchy, groupNamehierarchy to sitehierarchy and siteNameHierarchy

• Get Membership:

• URL parameter is changed to /dna/intent/api/v1/site/{siteId}/device.

• Added description so that it should return both children sites and its devices.

• Removed Instanceid, authEndtityId, displayName, authEntityClass from response payload.

For information about Cisco DNA Center platform Know Your Network APIs on Cisco DevNet, see CiscoDNA Center Platform Intent APIs. For information about accessing and viewing the APIs using the CiscoDNA Center platform GUI, 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 ScaleFor Cisco DNA Center scale numbers, see the Cisco DNA Center Data Sheet.

Install the Cisco DNA Center PlatformFor this release, when installing Cisco DNA Center, Release 1.3.1.x, you also install the Cisco DNA Centerplatform, Release 1.3.1.x. A separate installation procedure for the Cisco DNA Center platform is no longerrequired. For information about installing Cisco DNA Center, see the Cisco DNA Center Installation Guide.


Know Your Network API





https://www.cisco.com/c/en/us/products/cloud-systems-management/dna-center/datasheet-listing.html

https://www.cisco.com/c/en/us/support/cloud-systems-management/dna-center/products-installation-guides-list.html

After the installation, a Platform tab appears in the GUI next to the Assurance tab. Click the Platform tabto access the Cisco DNA Center platform. The Cisco DNA Center platform is only accessible to a SuperAdmin user. You can log in and view the Cisco DNA Center platform capabilities, as well as perform actionsthrough its GUI only after logging in as a Super Admin user.

If you have already installed an earlier version of the Cisco DNA Center platform, you can also upgrade tothe most recent version by upgrading your current Cisco DNA Center release version. A separate upgradeprocedure for the Cisco DNACenter platform is no longer required. For additional information and dependingupon your upgrade path, see one of the following topics:

• Upgrade to Cisco DNA Center Platform, Release 1.3.1.6, on page 13





Note

Configure Integration Settings

In cases where firewalls or other rules exist between Cisco DNA Center and any third-party apps that needto reach the Cisco DNA Center platform, you will need to configure Integration Settings. These cases occurwhen the IP address of Cisco DNA Center is internally mapped to another IP address that connects to theinternet or an external network.

Before you begin

You have installed the Cisco DNA Center platform as described in the previous section.

Procedure

Step 1 Click the gear icon ( ) > System Settings > Settings > 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.

The Callback URL Host Name or IP Address is the external facing hostname or IP address thatis mapped internally to Cisco DNACenter. Configure the VIP address for a three-node cluster setup.

Note

Step 3 Click the Apply button.

Upgrade to Cisco DNA Center Platform, Release 1.3.1.6You can upgrade to Cisco DNACenter platform, Release 1.3.1.6 from an earlier release by upgrading to CiscoDNA Center, Release 1.3.1.6. A separate upgrade procedure for the Cisco DNA Center platform is no longerrequired. For information about upgrading Cisco DNA Center, see the Cisco DNA Center Upgrade Guide.

You can upgrade to Cisco DNA Center, Release 1.3.1.6 from any of the following releases:


Configure Integration Settings


• 1.3.1.x

• 1.3.0.x

The Cisco DNA Center platform is only accessible to a Super Admin user. You can log in and view the CiscoDNA Center platform capabilities, as well as perform actions through its GUI only after logging in as a SuperAdmin user.

Note



• 1.3.1.x

• 1.3.0.x


Note

Upgrade to Cisco DNA Center Platform, Release 1.3.1.4You can upgrade to Cisco DNACenter platform, Release 1.3.1.4 from an earlier release by upgrading to CiscoDNA Center, Release 1.3.1.4. A separate upgrade procedure for the Cisco DNA Center platform is no longerrequired. For information about upgrading Cisco DNA Center, see the Cisco DNA Center Upgrade Guide.After upgrading, the Cisco DNA Center platform application version is 1.2.0.50.


• 1.3.1.x

• 1.3.0.x


Note



Upgrade to Cisco DNA Center Platform, Release 1.3.1.5





• 1.3.1.1

• 1.3.1.0

• 1.3.0.x

The Cisco DNA Center platform is only accessible to a Super Admin user. You can log in and view the CiscoDNACenter platform capabilities, as well as perform actions through its GUI, only after logging in as a SuperAdmin user.

Note



• 1.3.0.3

• 1.3

• 1.2.12

• 1.2.10


Note

After upgrading your Cisco DNA Center platform to Release 1.3.1.0, review the information about updatingthe Cisco DNA Center platform bundles in the following procedure.

Update the Bundles

After upgrading the Cisco DNACenter platform to Release 1.3.1.0, you have the option to update the bundlesin the application.

It is not mandatory to update any of the bundles. You can continue to work with the existing bundles if youdecide that you do not want the new features, functionality, or bug fixes.

Important

Before you begin

You have upgraded the Cisco DNACenter platform to Release 1.3.1.0 as described in the previous procedure.


Upgrade to Cisco DNA Center Platform, Release 1.3.1.0


Procedure

Step 1 From the Cisco DNA Center home page, click Platform > Manage > Bundles.Step 2 Review the bundles and their current status.

All of the bundles for this release should display an Update button at the far right of the Bundles window.

Step 3 Click on the link (name) of a bundle that displays an Update button.

For example, click the Basic ITSM (ServiceNow) CMDB synchronization link (name). A bundle windowopens with additional information, including current version, platform, and tags information.

Step 4 Click the Release Notes tab in the bundle window.

Review the information about the bundle update.

Step 5 Click the Update button.

The process to update the bundle starts.

Step 6 Proceed to update the other bundles following the preceding steps.

What to do next

After updating the bundles in this procedure, see the Cisco DNA Center Platform User Guide for detailedinformation about the Cisco DNA Center platform.

Open Bugs

Open Bugs for Cisco DNA Center Platform, Release 1.3.1.6

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

Table 2: Open Bugs for Cisco DNA Center Platform, Release 1.3.1.6

HeadlineBug ID Number

When working with the Basic ITSM (ServiceNow) CMDB synchronizationbundle, you are unable to schedule using the Schedule to Publish InventoryDetails-ServiceNow Connector. The GUI displays an error message "SchedulerRun frequency exceeds allowed limits".

Workaround:

There is no workaround at this time.

CSCvt71341


Open Bugs

https://www.cisco.com/c/en/us/support/cloud-systems-management/dna-center/products-user-guide-list.html

https://tools.cisco.com/bugsearch/bug/CSCvt71341


API entries that are registered by the Cisco DNA Center platform as part of theREST API Bundle enablement are getting removed when there are packageupgrades (whether from Fusion, NDP, or Assurance app stacks) happening inthe cluster.

Workaround:

Disable and enable the REST API Bundle to get all the API registrations backwhich are part of the Cisco DNA Center platform's registration process. Afterre-enabling the bundle, wait 4 minutes before attempting to call a REST API.

CSCvn64908

The followingAPI is required to support updating credentials on devices managedby Cisco DNA Center.

PUT: /api/v1/network-device

Workaround:


CSCvp35527

Email notifications for reports require more meaningful data to be shared.

Workaround:


CSCvp97394

The execution ids for Network Issue Monitor and Enrichment for ITSMbundle are only accessible in the database.

Workaround:


CSCvq58652



https://tools.cisco.com/bugsearch/bug/CSCvn64908

https://tools.cisco.com/bugsearch/bug/CSCvp35527


https://tools.cisco.com/bugsearch/bug/CSCvq58652


Proxy update event not working when done from the Cisco DNA Center GUIProxy Config settings page.

Click System Settings > Settings > Proxy Config to access this GUI settingspage.

Workaround:

A proxy update can be done using the corresponding CLI commands andConfiguration wizard on the Cisco DNA Center appliance. To update the proxyusing the CLI command and Configuration wizard, perform the following steps:

1. Using a Secure Shell (SSH) client, log in to the IP address of the Enterpriseport of the Cisco DNA Center appliance.

2. When prompted, enter the Linux password.

3. Enter the following command to access the Configuration wizard:

sudo maglev-config update

If you are prompted for the Linux password, enter it again.

4. The Configuration wizard appears. Choose [Next], as needed, to proceedthrough the Configuration wizard.

Make changes to the settings presented (proxy server URL address). Afteryou finish making changes on the screen, continue choosing [Next] toproceed through the wizard.

5. At the end of the configuration process, a message appears, stating that theConfiguration wizard is now ready to apply your changes. Choose proceed>>to complete the installation. The Configuration wizard applies the changesyou made.

CSCvq93735






Workaround:


CSCvn64908








Workaround:


CSCvp35527


Workaround:


CSCvp97394

The execution ids for Network Issue Monitor and Enrichment for ITSMbundle are only accessible in the database.

Workaround:


CSCvq58652



Workaround:










CSCvq93735












Workaround:


CSCvn64908



Workaround:


CSCvp35527


Workaround:


CSCvp97394

Network events posting to webhook in Cisco DNA Center platform does notshow up in the Runtime dashboard.

Workaround:


CSCvp97503

The execution ids for Network Issue Monitor and Enrichment for ITSMbundle are only accessible in the Mongo DB.

Workaround:


CSCvq58652











Workaround:










CSCvq93735

The Cisco DNA Center event link in the Event email notification is missing theIP address after upgrading from Cisco DNA Center release version 1.3.1.0 to1.3.1.2. This occurs intermittently.

Workaround:

Reconfigure the IP address in Integration Settings in the Settings page. Clickthe Settings icon > System Settings > Settings > Integration Settings to accessthis page.

CSCvr52578


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




https://tools.cisco.com/bugsearch/bug/CSCvr52578



API entries that are registered by the Cisco DNA Center platform as part of theREST API Bundle enablement are getting removed when there are packageupgrades (whether from Fusion, NDP, or Assurance app stacks) happening in thecluster.

Workaround:


CSCvn64908

The following API is required to support updating credentials on devices managedby Cisco DNA Center.


Workaround:


CSCvp35527


Workaround:


CSCvp97394

Network events posting to webhook in Cisco DNACenter platform does not showup in the Runtime dashboard.

Workaround:


CSCvp97503

The execution ids forNetwork Issue Monitor and Enrichment for ITSM bundleare only accessible in the Mongo DB.

Workaround:


CSCvq58652











Workaround:








Make changes to the settings presented (proxy server URL address). Afteryou finishmaking changes on the screen, continue choosing [Next] to proceedthrough the wizard.


CSCvq93735

The Cisco DNA Center event link in the Event email notification is missing theIP address after upgrading from Cisco DNA Center release version 1.3.1.0 to1.3.1.2. This occurs intermittently.

Workaround:

Reconfigure the IP address in Integration Settings in the Settings page. Clickthe Settings icon > System Settings > Settings > Integration Settings to accessthis page.

CSCvr52578






For Event notification (JSON schema), the following fields and descriptions needto be updated:

• "ciscoDnaEventLink": "String /Default null and Currently Not in use/",

• "note": "String /Default null and Currently Not in use/",

Additionally the description of the "timestamp" attribute needs to be changed tothe following: "Number - time in epoch milliseconds".

Workaround:


CSCvr52670


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



Network events posting to webhook in Cisco DNA Center platform does notshow up in the Runtime dashboard.

Workaround:


CSCvp97503

The execution ids for Network Issue Monitor and Enrichment for ITSMbundle are only accessible in the Mongo DB.

Workaround:


CSCvq58652


Workaround:


CSCvp97394



Workaround:


CSCvp35527

The catalog search does not match slashes.

Workaround:


CSCvn00714











Workaround:


CSCvn64908



Workaround:










CSCvq93735

Resolved Bugs

Resolved Bugs for Cisco DNA Center Platform, Release 1.3.1.6

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


Resolved Bugs



Table 7: Resolved Bugs for Cisco DNA Center Platform, Release 1.3.1.6


Scheduler with a recurring weekly schedule is not working properly in the ITSMbundle.

CSCvs90003

In the Cisco DNA Center 1.3.1.5 release, the Client Summary report does notdisplay all of the site hierarchy.

CSCvt39849

In the Cisco DNACenter 1.3.1.5 release, theClient Summary report location filtersearch results are ambiguous.

CSCvt41199

Failure to run Inventory report in Cisco DNA Center 1.3.1.5 release.CSCvt41343





Inventory reports (CSV format) are not getting displayed correctly, if there aredevices with multiple serial numbers.

CSCvs60258

There are a couple of formatting issues for Inventory reports (CSV format):

• Uptime is being split into 2 columns.

• Site Name Original is being internally filled, which should not be part of thereport.

CSCvs60269

In Data and Reports, the Uptime field in Inventory reports is being split intomultiple fields in some cases and not in other cases. This inconsistent behavior isbecause the internally invoked automation API returns a response for that field witha comma for some cases, and without a comma for other cases.

CSCvs55839

Updating email configuration fails in a particular scenario.CSCvs53524

Schedule API paused after a CMDB Synchronization bundle update.CSCvs43444

The report name is displayed as instances in the creation of an email-basedsubscription.

CSCvs41907

Cisco DNA Center email notification does not work as expected in release version1.3.1.3.

CSCvs07870

Error messages are missing the context in the save email-config API.CSCvs27412

Email configuration does not save if the mail server rejects the message request.CSCvs24161

In theData and Reports download screen, the word "initiated" is misspelled (CiscoDNA Center, release version 1.3.1.3).

CSCvs29649



https://tools.cisco.com/bugsearch/bug/CSCvs90003















Grammar correction for the Configure Email message in Email Subscription.CSCvs06818

The report name is being displayed as instances in the creation of email-basedsubscription.

CSCvs41907

Unable to create/edit a REST API subscription with a valid HTTPS URL for anendpoint URL.

CSCvs49084

Email notification test tries to send username/password for authentication, eventhough they are not configured.

CSCvs50623





For Event notification (JSON schema), the following fields and descriptions needto be updated:

• "ciscoDnaEventLink": "String /Default null and Currently Not in use/",

• "note": "String /Default null and Currently Not in use/",

Additionally the description of the "timestamp" attribute needs to be changed to thefollowing: "Number - time in epoch milliseconds".

CSCvr52670

The event message header includes key "Content-Type" with a value of"application/json; charset=utf-8".

CSCvr62596

The dnacp-formatter-service in not running state. Possible reason for this occurringis that the trial enterprise license expired.

CSCvr52679

The Event email notification is missing the IP address in the DNA event link. Thisoccurs during an upgrade from release version 1.3.1.0 to 1.3.1.1.

CSCvr52578

The CLI package name 'dnac-platform' and GUI package name "DNAC Platform"are not brand compliant.

CSCvr58008


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



The catalog search does not match slashes.CSCvn00714










https://tools.cisco.com/bugsearch/bug/




The Cisco DNA Center platform GUI for APIs (click Platform > DeveloperToolkit > APIs) is slow in displaying API data.

CSCvq57745

Use the Bug Search ToolUse 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:

https://tools.cisco.com/bugsearch

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

The Bug Search window opens.

If you do not have a cisco.com username and password, register athttps://idreg.cloudapps.cisco.com/idreg/guestRegistration.do.

Note

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:

a) In the Search For field, enter Cisco DNA Center and press Return. (Leave the other fields empty.)b) 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 RestrictionsThe 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 DNACenter:

• Infoblox:

• Infoblox does not expose a name attribute; therefore, the comment field in Infoblox is populatedby 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 thecomments, they are replaced by underscores.

• If an IP pool name is updated for an imported pool, the comments are overwritten and the new nameis reflected.

• BlueCat: There are no limitations identified with BlueCat integration at this time.


Use the Bug Search Tool


https://tools.cisco.com/bugsearch

https://idreg.cloudapps.cisco.com/idreg/guestRegistration.do

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 DNACenter platform.

Table 11: Cisco DNA Center Platform Resources and Documentation

LinkResource

Cisco DNA Center Platform User GuideCisco DNA Center Platform User Guide

Use this guide whenworking with the CiscoDNACenter platformGUI.

Cisco DNA Center ITSM Integration GuideCisco DNA Center ITSM Integration Guide

Use this guide with working with the Cisco DNACenter platformand ServiceNow.

Cisco DNA Center Platform OverviewCisco DNA Center Platform Overview

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

Cisco DNA Center Intent API ReferenceCisco DNA Center Intent API Reference

Use this resource to access the intent APIs and the Cisco DNACenter platform.

Getting Started with the Cisco DNA Center Platform Intent APIGetting Started with the Cisco DNA Center Platform Intent API

Use this resource when working with the intent APIs and theCisco DNA Center platform.

Getting Started with Cisco DNA Center Multivendor SDKGetting Started with Cisco DNA Center Multivendor SDK

Use this resource whenworking with the SDK and the Cisco DNACenter platform.

Cisco DNA Center Multivendor SDK Release NotesCisco DNA Center Multivendor SDK Release Notes

Release information about the SDK.

Cisco Code ExchangeCisco Code Exchange

Code repositories related to Cisco technologies.

Related Documentation

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


Reports



https://developer.cisco.com/docs/dna-center/#!cisco-dna-center-platform-overview



https://developer.cisco.com/docs/dna-center/#!overview

https://developer.cisco.com/docs/dna-center/#!downloads-and-release-notes

https://developer.cisco.com/codeexchange/platforms/dnac/

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

Cisco DNA Center Release NotesRelease information, including new features, limitations, and open andresolved bugs.

Cisco DNA Center Installation GuideInstallation and configuration of Cisco DNA Center, includingpostinstallation tasks.

Cisco DNA Center Upgrade GuideUpgrade information for your current release of Cisco DNA Center.

Cisco DNA Center User GuideUse of the Cisco DNA Center GUI and its applications.

Cisco DNA Center Administrator GuideConfiguration of user accounts, security certificates, authentication andpassword policies, and backup and restore.

Cisco DNA Center Security Best Practices GuideSecurity features, hardening, and best practices to ensure a securedeployment.

Supported DevicesSupported devices, such as routers, switches, wireless access points, NFVISplatforms, and software releases.

Cisco SD-Access Hardware and Software CompatibilityMatrix

Hardware and software support for Cisco SD-Access.

Cisco DNA Assurance User GuideUse of the Cisco DNA Assurance GUI.

Cisco DNA Center Platform User GuideUse of the Cisco DNA Center platform GUI and its applications.

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

Cisco Wide Area Bonjour Application User GuideUse of the Cisco Wide Area Bonjour Application GUI.

Cisco Stealthwatch Analytics Service User GuideUse of the Stealthwatch Security Analytics Service on Cisco DNA Center.

Cisco DNA Center Rogue Management ApplicationQuick Start Guide

Use of RogueManagement functionality as a dashboard within Cisco DNAAssurance in the Cisco DNA Center GUI.


Related Documentation

https://www.cisco.com/c/en/us/support/cloud-systems-management/dna-center/products-release-notes-list.html




https://www.cisco.com/c/en/us/support/cloud-systems-management/dna-center/products-maintenance-guides-list.html


https://www.cisco.com/c/en/us/support/cloud-systems-management/dna-center/products-device-support-tables-list.html

https://www.cisco.com/c/en/us/solutions/enterprise-networks/software-defined-access/compatibility-matrix.html

https://www.cisco.com/c/en/us/solutions/enterprise-networks/software-defined-access/compatibility-matrix.html



https://www.cisco.com/c/en/us/support/cloud-systems-management/dna-center/products-release-notes-list.html





release notes for cisco dna center platform, release 1.3.1 ·...

Documents