About the Release Notes

We recommend that you use the latest version of Cisco DNA Spaces: Connector.

This release notes document describes what is new or changed, instructions to upgrade to the latest version of the Cisco DNA Spaces: Connector, and open and resolved caveats for each release. Unless otherwise noted, in this document, Cisco DNA Spaces: Connector is referred to as Connector.


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 standards documentation, or language that is used by a referenced third-party product.


Introduction to Cisco DNA Spaces: Connector

The Cisco DNA Spaces: Connector (referred to as Connector in all subsequent references in this document) enables Cisco DNA Spaces to communicate with multiple controllers and switches efficiently, by allowing each controller to transmit client data without missing any client information.

The Connector gathers and aggregates data from controllers, access points (APs), and switches efficiently and sends aggregated data to Cisco DNA Spaces. The Connector architecture allows multiple controllers, APs, and switches to connect to Cisco DNA Spaces through a single point (the Connector). A single Connector can connect to a Cisco Wireless Controller, Cisco Catalyst 9800 Series Wireless Controller, and a Cisco Catalyst 9300 Series and Cisco Catalyst 9400 Series Switches at the same time.


Note

The term controller is used in this document to refer to the following. See Compatibility Matrix for specific details.

  • Cisco Wireless Controller (indicated on the Cisco DNA Spaces dashboard as WLC AireOS)

  • Cisco Catalyst 9800 Series Wireless Controller (indicated on the Cisco DNA Spaces dashboard as Catalyst WLC)

  • Cisco Embedded Wireless Controller on Catalyst Access Points (Cisco EWC-AP)


The Connector sends data to Cisco DNA Spaces over HTTPS; data can also be routed through a proxy.


Note

We recommend that you upgrade to the latest version of the Connector.


What's New in Docker Release v2.0.619

Table 1. Resolved Caveats

Caveat

Description

CSCwb28513 Air quality data is not updated on Cisco DNA Spaces Web UI after controller upgrades AP.
CSCwb43159

Enable gRPC stream for AP profiles fails.

What's New in Docker Release v2.0.609

What's New in Docker Release v2.0.589

Cisco DNA Spaces: Connector uses Java library Apache log4j for logging. Docker v2.0.589 now uses Apache log4j version 2.17 and addresses vulnerability CVE-2021-45105.

What's New in Docker Release v2.0.588

Cisco DNA Spaces: Connector uses Java library Apache log4j for logging. Docker v2.0.588 now uses Apache log4j version 2.16 and addresses vulnerability CVE-2021-45046.

What's New in Docker Release v2.0.587

Cisco DNA Spaces: Connector uses Java library Apache log4j for logging. Vulnerability CVE-2021-44228 currently impacts Apache log4j versions from 2.0 to version 2.14.1. Docker v2.0.587 now uses Apache log4j version 2.15.

What's New in Docker Release v2.0.586

  • Connectivity issues with Cisco Catalyst 9800 Series Wireless Controllers are resolved.

  • The connectivity testing is enhanced.

  • FIPS mode is now supported for Cisco Catalyst 9800 Series Wireless Controllers.

  • SNMPv3 issues are resolved.

Table 2. Open Caveats

Caveat

Description

CSCvz67366 Connector is unable to establish a Cisco Network Mobility Services Protocol (NMSP) connection with Cisco Catalyst 9800 Series Wireless Controllers release 17.5.1 running in the Federal Information Processing Standards (FIPS) mode. However, the Connector is able to establish an NMSP connection with Cisco Catalyst 9800 Series Wireless Controllers releases 16.12.x, 17.3.x and 17.6.x running in FIPS mode.

What's New in Docker Release v2.0.555

  • Fast-packet drops ocurring due to out-of-sync sequence numbers is now fixed.

  • You can now observe more detailed error messages if a failure occurs during the download of an IOx application bundle.

  • The IoT devices scanning feature has improved due to fixes in the performance of the IoX application.

  • You can now collect information about the switchport user.

What's New in Docker Release v2.0.539

  • Connector can now establish Network Mobility Service Protocol (NMSP) connection with each controller in parallel. This reduces the startup time required after a docker is restarted or upgraded.

  • Earlier, controllers that were periodically polling associated clients could cause load hikes and data drops. Now, this polling is evenly distriubted in time per controller.

Table 3. Resolved Caveats

Caveat

Description

CSCvy12041 Cisco Catalyst 9800 Series Wireless Controller to Connector session not established on 17.3.2a as alphanumeric in version string is not parsed.
CSCvy30330 Connector supports Diffie-Hellman KEX with SHA-1 to ensure backward compatibility with eWLC 16.x
CSCvy14010

TDL issue due to which customer is unable to deploy IOT Gateways

Cisco DNA Spaces: Connector Compatibility Matrix

Hardware or Application Name

Support for Cisco DNA Spaces: Connector

Cisco Wireless Controller
  • 8.5

  • 8.8

  • 8.9

  • 8.10

Note 

Use the latest software or maintenance release version for each listed release.

Cisco Catalyst 9800 Series Wireless Controllers
  • 16.12.4a

  • 16.12.5

  • 17.3.1

  • 17.3.2

  • 17.3.3

  • 17.3.4

  • 17.4.1

  • 17.5.1

  • 17.6.1

  • 17.6.2

  • 17.7.1

Note 

Use the latest software version or maintenance release for each listed release.

Cisco Embedded Wireless Controller on Catalyst Access Points (Cisco EWC-AP)

Supported versions are:
  • 16.12.5

  • 17.3.1

  • 17.3.2a,

  • 17.3.3

  • 17.3.4

  • 17.4.1

  • 17.5.1

  • 17.6.1

Note 

Use the latest software version or maintenance release for each listed release.

Supported access points are:

  • Cisco Aironet 9115 Series Access Points

  • Cisco Aironet 9117 Series Access Points

  • Cisco Aironet 9120 Series Access Points

  • Cisco Aironet 9130 Series Access Points

Cisco Catalyst 9300 Series and Cisco Catalyst 9400 Series Switches

Supported versions are 17.3.3 and later

Cisco Prime Infrastructure

Cisco DNA Center

Cisco DNA Spaces: IoT Services

  • Supported on Cisco Catalyst 9800 Series Wireless Controllers, Release 17.3.1 and later

  • Not supported on Cisco Wireless Controller

  • Not supported on Cisco Embedded Wireless Controller on Catalyst Access Points (Cisco EWC-AP)

OpenRoaming

  • Supported on Cisco Catalyst 9800 Series Wireless Controllers, Release 16.12 and later

  • Supported on Cisco Wireless Controller 8.3 and later

Supported controllers for Cisco FastLocate

  • Supported on Cisco Wireless Controller, Release 8.1.123.0

  • Supported on all releases of Cisco Catalyst 9800 Series Wireless Controllers

Supported controllers for Cisco Hyperlocation

  • Supported on Cisco Wireless Controller

  • Supported on Cisco Catalyst 9800 Series Wireless Controllers

Connector Active-Active

  • Not supported on Cisco Embedded Wireless Controller on Catalyst Access Points (Cisco EWC-AP)

  • Supported on Cisco Catalyst 9800 Series Wireless Controllers

  • Supported on Cisco Wireless Controller

Tested VMware Environments

  • VMware ESXi: 6.5.0 Update 2 (Build 13004031), 6.7.0 Update 2 (Build 13006603), 6.7.0 Update 3 (Build 16316930)

  • VMware vSphere Client Version 6.7.0

  • VMware vCenter Server Appliance 6.7.0

Tested Hyper-V Environments

Hyper-V version 10.0.17763.1

Tested Proxies

  • Squid Proxy

    • Forward-only mode (SSL Tunneling)

    • Squid-in-the-Middle mode (SSL tunneling with intercept capabilities)

  • McAfee

  • Cisco web security appliance

Tested Access Points for Cisco FastLocate

  • Cisco Aironet 2800 Series Access Points

  • Cisco Aironet 3800 Series Access Points

  • Cisco Aironet 4800 Series Access Points

Tested Access Points for Cisco FastLocate (Wi-Fi 6)

  • Cisco Aironet 9120 Series Access Points

  • Cisco Aironet 9130 Series Access Points

Tested Access Points for Cisco Hyperlocation

  • Cisco Aironet 3700 Series Access Points (Requires hyperlocation antenna)

  • Cisco Aironet 4800 Series Access Points

Connector minimum requirement and sizing

  • 2 vCPU

  • 4-GB RAM

  • 60-GB Hard Disk

Upgrade the Cisco DNA Spaces: Connector Docker

You can upgrade the Connector docker to the latest version from the Connector GUI. Note that the upgrade link appears only if a new upgrade image is available.


Note

This procedure does not upgrade the Connector OVA.


Figure 1. Docker Upgrade Link on the Connector

You can also upgrade the Connector docker to the latest version from the Cisco DNA Spaces dashboard. The upgrade link appears only if a new upgrade image is available.

Figure 2. Docker Upgrade Link Appears Only If New Image Is Available

FAQs

Which Are the Tested Browsers?

Cisco DNA Spaces: Connector is tested on the following browser:

  • Google Chrome

Which are the Proxies Tested with Cisco DNA Spaces: Connector?

The following proxies have been tested with Cisco DNA Spaces: Connector:

  • Squid Proxy

    • Forward-only mode (SSL Tunneling)

    • Squid-in-the-Middle mode (SSL Tunneling with Intercept Capabilities)


    Note

    When using Squid Proxy in the Squid-in-the-Middle mode, you must disable interception of the WebSocket domains. Add the following lines to your Squid config file before the “ssl_bump bump all” section.

    • acl websocket_sites ssl::server_name .location-data.cisco.com

    • acl websocket_sites ssl::server_name .dms.cisco.com

    • ssl_bump splice websocket_sites


  • McAfee

  • Cisco Web Security Appliance

Troubleshooting Cisco DNA Spaces: Connector

The following are some of the troubleshooting scenarios you may experience on Cisco DNA Spaces: Connector.

How do I Reprovision Cisco DNA Spaces: IoT Services after Failover

This task describes how to you reprovision Cisco DNA Spaces: IoT Services after a Connector failover. After a failover, only one Connector is active. Ensure that you perform this task for the active Connector (Step 3).

Procedure


Step 1

From the left-navigation pane of the Cisco DNA Spaces dashboard, choose Setup > Wireless Network.

Step 2

In the Configure Spaces Connector area, click View Connectors.

Figure 3. View Connectors
Step 3

Click the three-dot icon of an active Connector, and select Manage IoT Streams.

Figure 4. Manage IoT Streams
Step 4

On the displayed Manage IoT Streams window, do the following:

  1. In the Manage Controller area, click the three-dot icon of the Cisco Catalyst 9800 Series Wireless Controller, and select Disable Stream.

    The status is changed to Not Initiated.
  2. Click the three-dot icon of the Cisco Catalyst 9800 Series Wireless Controller again, and select Enable Stream.

    Figure 5. Enabling IoT Streams for Connector and the Respective Cisco Catalyst 9800 Series Wireless Controller
    The gRPC channel between the APs and the Connector is re-established.
Step 5

To re-enable telemetry between the Cisco Catalyst 9800 Series Wireless Controller and the Connector, restart the Connector from the Connector GUI.

The Connector can now create telemetry subscriptions on the Cisco Catalyst 9800 Series Wireless Controller for Cisco DNA Spaces: IoT Services.

Communications, Services, and Additional Information

  • To receive timely, relevant information from Cisco, sign up at Cisco Profile Manager.

  • To get the business impact you’re looking for with the technologies that matter, visit Cisco Services.

  • To submit a service request, visit Cisco Support.

  • To discover and browse secure, validated enterprise-class apps, products, solutions, and services, visit Cisco DevNet.

  • To obtain general networking, training, and certification titles, visit Cisco Press.

  • To find warranty information for a specific product or product family, access Cisco Warranty Finder.

Cisco Bug Search Tool

Cisco Bug Search Tool (BST) is a gateway to the Cisco bug-tracking system, which maintains a comprehensive list of defects and vulnerabilities in Cisco products and software. The BST provides you with detailed defect information about your products and software.

Documentation Feedback

To provide feedback about Cisco technical documentation, use the feedback form available in the right pane of every online document.