Cisco Spaces: Connector 3 Overview

About Release Notes


Note


Cisco DNA Spaces is now Cisco Spaces. We are in the process of updating our documentation with the new name. This includes updating GUIs and the corresponding procedures, screenshots, and URLs. For the duration of this activity, you might see occurrences of both Cisco DNA Spaces and Cisco Spaces. We take this opportunity to thank you for your continued support.


We recommend that you use the latest version of Cisco Spaces: Connector. To migrate from connector 2.x to connector 3, see Migrate from Connector 2.x to Connector 3.

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

Introduction to Connector 3

Cisco Spaces: Connector Release 3 (subsequently referred to as Connector 3) is a fully redesigned version of the Cisco Spaces: Connector Release 2.x, with the capability to efficiently manage multiple services that connect to different network devices such as wireless controllers, access points (APs), and switches. connector gathers and aggregates data from these devices and sends the data to Cisco Spaces.

With connector 3, you can do the following:

  • Add or remove new services from Cisco Spaces.

  • Perform advanced troubleshooting with the debugging, log upload, and restart functionalities in Cisco Spaces.

  • Obtain detailed metrics for each service, such as, CPU, memory, connectivity, and up or down status.

  • Configure Virtual IP address (VIP) pairs or active-active pairs that allow for high availability. You can view details of each instance that is a part of a high-availability pair.

  • Monitor connector 3 and device status that are aggregated from each instance of connector.

  • View how services are running on each instance, their upgrade status, and so on.

  • Perform actions on an instance, such as restarting of services.

  • Configure instances for connector. Device status is aggregated from each connector instance for monitoring.

Connector 3 sends data to Cisco Spaces over HTTPS; a proxy can also be used to route data.

See Initial Setup, Upgrading the Connector, and Migrating from Connector 2.x to Connector 3.


Note


The term wireless controller is used in this document to collectively refer to the following:

  • Cisco AireOS Wireless Controller or AireOS controller

  • Cisco Catalyst 9800 Series Wireless Controller or Catalyst 9800 controller

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


Upgrade Path for Release 3

Cisco Spaces: Connector supports various upgrade options.

You can verify the current connector version using the CLI or Cisco Spaces: Connector GUI.


Note


The minimum recommended connector version to upgrade to the June 2025 is the Jan 2025 release.


Run the connectorctl version command to verify using the CLI or navigate to Cisco Spaces: Connector > Dashboard and hover over the Package details to view the current connector version.

Figure 1. Connector GUI

Note


A patch upgrade is not required if you have successfully upgraded from the Jan 2025 to the June 2025 connector release. We recommend that you ignore the docker restart error displayed in the upgrade logs. After the upgrade is successfully complete, the system reboots and the docker is available.


Table 1. Upgrade Path for Release 3
From Version

To Version

Upgrade Method

Connector 3.2 Jan 2025

Connector 3.2 Jun 2025

To perform the version upgrade, use the GUI inline upgrade, the CLI inline upgrade, or the connectoros upgrade command. Follow these steps:

  1. Upgrade to the June 2025 patch release.

  2. Upgrade to the June 2025 release.

Connector 3.1 builds between May 2023 - Jan 2025

Connector 3.2 Jun 2025

To perform the version upgrade, use the GUI inline upgrade, the CLI inline upgrade, or the connectoros upgrade command. Follow these steps:

  1. Upgrade to the January 2025 release.

  2. Upgrade to the June 2025 patch release.

  3. Upgrade to the June 2025 release.

Connector 3.0 build prior to May 2023

Connector 3.2 Jun 2025

Upgrade to the May 2023 release using the connectoros upgrade command.

To perform the version upgrade, use the GUI inline upgrade, the CLI inline upgrade, or the connectoros upgrade command. Follow these steps:

  1. Upgrade to the January 2025 release.

  2. Upgrade to the June 2025 patch release.

  3. Upgrade to the June 2025 release.

Connector 2.x

Connector 3.2 Jun 2025

New connector instance needs to be deployed with latest build.

For more information about migrating the controllers from existing connector to latest connector, see Migrate Connector 2.x to Connector 3.

Compatibility Matrix for Cisco Spaces: Connector: Location service

This section covers the following:

Location Service (Non-FIPS)

Table 2. Location Service (Non-FIPS)

Hardware or Application Name

Support for Cisco Spaces: Connector

Cisco Catalyst 9800 Series Wireless Controllers
  • Supported on 17.6.8 and later releases.

Note

 
Cisco AireOS Wireless Controller

Note

 

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

Supported versions are:
  • 17.6.1

Note

 

Supported access points are:

  • Cisco Catalyst 9115 Series Access Points

  • Cisco Catalyst 9117 Series Access Points

  • Cisco Catalyst 9120 Series Access Points

  • Cisco Catalyst 9130 Series Access Points

Cisco Catalyst 9300 and 9400 Series Switches

Supported versions are 17.3.3 and later

Cisco Prime Infrastructure

Supported
Catalyst Center Supported

Supported wireless controllers for Cisco FastLocate

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

Supported wireless controllers for Cisco Hyperlocation

  • Supported on Cisco Catalyst 9800 Series Wireless Controllers

Connector Active-Active Mode

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

  • Supported on Cisco Catalyst 9800 Series Wireless Controllers

  • Supported on Cisco AireOS Wireless Controller

Tested VMware Environments

  • VMware vSphere Client Version 7.0.x and 8.0

  • VMware vCenter Server Appliance 7.0.x and 8.0

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 7)

  • Cisco Wireless 9178 Series Access Points

  • Cisco Wireless 9176 Series Access Points

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

  • Cisco Catalyst 9120 Series Access Points

  • Cisco Catalyst 9130 Series Access Points

  • Cisco Catalyst 9164 Series Access Points

  • Cisco Catalyst 9166 (I/D1) Series Access Points

  • Cisco Catalyst IW9167I Heavy Duty Access Points

Tested Access Points for Cisco Hyperlocation

  • Cisco Aironet 4800 Series Access Point

Tested Access Points

  • Cisco Catalyst 9105AX (I/W) Series Access Points

  • Cisco Catalyst 9115AX (I/E) Series Access Points

  • Cisco Catalyst 9117AX (I) Series Access Points

  • Cisco Catalyst 9136 (I) Series Access Points

  • Cisco Catalyst 9162 (I) Series Access Points

  • Cisco Catalyst 9164 (I) Series Access Points

  • Cisco Catalyst 9166 (I/D1) Series Access Points

  • Cisco Catalyst IW9167 (E/I) Heavy Duty Series Access Points

  • Cisco Catalyst IW9165D Heavy Duty Access Points

  • Cisco Catalyst IW9165E Rugged Access Points

  • Cisco Wireless 9172 Series Access Points

Location Service (FIPS)

Table 3. Location Service (FIPS)

Hardware or Application Name

Support for Cisco Spaces: Connector

Cisco Catalyst 9800 Series Wireless Controllers
  • 17.15.3

  • 17.12.6

Note

 

Use the latest software version or maintenance release for each listed release.  See Recommended Cisco IOS XE Releases for Catalyst 9800 Wireless LAN Controllers.

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

  • Cisco Wireless 9178 Series Access Points

  • Cisco Wireless 9176 Series Access Points

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

  • Cisco Catalyst 9120 Series Access Points

  • Cisco Catalyst 9130 Series Access Points

  • Cisco Catalyst 9164 Series Access Points

  • Cisco Catalyst 9166 (I/D1) Series Access Points

  • Cisco Catalyst IW9167I Heavy Duty Access Points

Tested Access Points

  • Cisco Catalyst 9105AX (I/W) Series Access Points

  • Cisco Catalyst 9115AX (I/E) Series Access Points

  • Cisco Catalyst 9117AX (I) Series Access Points

  • Cisco Catalyst 9136 (I) Series Access Points

  • Cisco Catalyst 9162 (I) Series Access Points

  • Cisco Catalyst 9164 (I) Series Access Points

  • Cisco Catalyst 9166 (I/D1) Series Access Points

  • Cisco Catalyst IW9167 (E/I) Heavy Duty Series Access Points

  • Cisco Catalyst IW9165D Heavy Duty Access Points

  • Cisco Catalyst IW9165E Rugged Access Points

  • Cisco Wireless 9172 Series Access Points

Compatibility Matrix for IoT Service (Wireless)

Application Name

Support for Cisco Spaces: IoT Service

Supported wireless controllers

  • Supported on Cisco Catalyst 9800 Series Wireless Controllers, Release 17.9.6 or 17.12.4

  • Not supported on Cisco AireOS Wireless Controller

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

  • Supported on Catalyst 9800 Controller running on Catalyst Switches in SD-Access mode (ECA)

    Note

     

    This support is conditional, and dependent on whether you have applied the fix described in CSCwk66790

Cisco Spaces: Connector Docker

2.0.455 and later

Cisco Spaces: Connector OVA

3.x and later

Cisco Prime Infrastructure

Cisco Prime Infrastructure Release 3.8 MR1 and later

Catalyst Center (for map import)

Catalyst Center Release 2.1.1 and later

Access Points for advanced BLE gateway (Wi-Fi 6)

  • Cisco Catalyst 9105 Series Access Points

  • Cisco Catalyst 9115 Series Access Points

  • Cisco Catalyst 9117 Series Access Points

  • Cisco Catalyst 9120 Series Access Points

  • Cisco Catalyst 9130 Series Access Points

  • Cisco Catalyst 9136 Series Access Points

  • Cisco Catalyst 9162 Series Access Points

  • Cisco Catalyst 9164 Series Access Points

  • Cisco Catalyst 9166 Series Access Points

  • Cisco Aironet 4800 Series Access Points

  • Cisco Catalyst IW9167 (E/I) Heavy Duty Series Access Points

Access points for basic BLE gateway

  • Cisco Aironet 1815 Series Access Points

  • Cisco Aironet 2800 Series Access Points (USB dongle needed. No in-built USB radio)

  • Cisco Aironet 3800 Series Access Points (USB dongle needed. No in-built USB radio)

Cisco IOx App Version

1.0.46 and later

Note

 

For Cisco Catalyst 9800 Series Wireless Controllers Cisco IOS XE Cupertino 17.7.x, ensure that the IoX Application version is upgraded to Version 1.3.x


Note


IoT Service (Wireless) is not supported with a directly connected controller, CMX Tethering, and AireOS connector. The only supported configuration is the Cisco Catalyst 9800 Wireless Controller and the connector.


The following table lists the compatibility of the Advanced BLE Gateway for BLE and the Base BLE Gateway App with various AP modes. This table is not applicable to Cisco Embedded Wireless Controller on Cisco Catalyst Access Points (Cisco EWC-AP).

Table 4. AP Modes and App Support

AP Mode

Advanced BLE Gateway App

Base BLE Gateway App

PI: Local

  • 802.11ax: Supported

  • Wave 2: Not supported

  • 802.11ax: Supported

  • Wave 2: Supported

P1: Flex

  • 802.11ax: Supported

  • Wave 2: Not supported

  • 802.11ax: Supported

  • Wave 2: Supported

P2: Fabric

  • 802.11ax: Supported

  • Wave 2: Not supported

  • 802.11ax: Supported

  • Wave 2: Supported

P3: Mesh

  • 802.11ax: Supported

  • Wave 2: Not supported

  • 802.11ax: Supported

  • Wave 2: Supported

Compatibility Matrix for IoT Service (Wired)

Application Name

Support for IoT Service (Wired)

Cisco Catalyst 9300 Series Switches

  • Cisco IOS XE Cupertino 17.9.5

  • Cisco IOS XE Dublin 17.12.4

Cisco Catalyst 9400 Series Switches

  • Cisco IOS XE Cupertino 17.9.5

  • Cisco IOS XE Dublin 17.12.4

Wired Docker Service

3.2.0.15 and later

Wired IOX Application

1.2.3 and later

IoT service (wired) is not supported with Cisco Spaces tenants or deployments leveraging the following configurations:

  • Connecting directly with controller

  • CMX Tethering