Integrate Cisco CMX for Wireless Maps

About Cisco Connected Mobile Experiences Integration

Cisco DNA Center supports the integration of on-premises Connected Mobile Experiences (CMX) for wireless maps. With the CMX integration, you can get the exact location of your wireless clients, rogue access points and interferers on the floor map within the Cisco DNA Center user interface.

Depending on your requirements, you can create CMX settings either at the global level or at the site, building, or floor level. For a small enterprise, you can assign CMX at the global level, which is the parent node. All children inherit their settings from the parent node. For a medium enterprise, you can assign CMX at the building level, and for a large enterprise, you can assign CMX at the floor level.


Note

CMX should be anonymized for security purposes.

Add a User for the Cisco CMX API Server

Before adding a Cisco CMX instance to Cisco DNA Center Network Settings, you must add a user for the Cisco CMX API server.

Procedure

Step 1

SSH to Cisco CMX using a cmxadmin account. Enter the following command:

ssh -l cmxadmin (cmx-ip-address)

Step 2

Start the Cisco CMX API server. Enter the following command:

# cmxos apiserver start
Example
The following example shows how to start the Cisco CMX API server: 
[root@server]# cmxos apiserver start
Starting CMX API Server...

Step 3

Add a user for the Cisco CMX API server. Enter the following command:

cmxos apiserver user add

At the password prompt, use the same password as the Cisco CMX web admin user password.

Example
The following example shows how to add a user for the Cisco CMX API server: 
[root@server]# cmxos apiserver user add
Please enter the userid for the CMX API Server: user1
Please enter the password for the CMX API Server: password
Please re-enter the password for the CMX API Server: password
Restarting CMX API Server...
Stopping CMX API Server...
Starting CMX API Server...
Successfully updated userid/password and restarted the CMX API Server

What to do next

Create Cisco CMX settings in Cisco DNA Center. See Create Cisco CMX Settings.

Create Cisco CMX Settings

Before you begin

Add a Cisco CMX API user. See Add a User for the Cisco CMX API Server.

Procedure

Step 1

Click the menu icon () and choose System > Settings.

Step 2

From the External Services section, click DNA Spaces/CMX Servers.

Result: The DNA Spaces/CMX Servers window appears.

Step 3

From the CMX Servers table, click Add.

Step 4

Complete the fields in the Add CMX Server slide-in pane:

  • IP Address: Enter the valid IP address of the CMX web GUI.

  • User Name: Enter the CMX web GUI username.

  • Password: Enter the password credentials.

  • SSH User Name: Enter the CMX admin username.

  • SSH Password: Enter the CMX admin password credentials.

Note

 
Make sure that CMX is reachable.

Step 5

Click Add.

Result: The CMX server is added successfully.

Step 6

To assign a CMX server to a site, building, or a floor, click the Menu icon and choose Design > Network Settings.

Step 7

Click the Wireless tab.

Step 8

In the left tree view menu, select either Global or the area, building, or floor that you are interested in.

Step 9

In the DNA Spaces/CMX Servers section, use the drop-down list, choose the CMX server.

Step 10

Click Save.

Result: The Create CMX Settings page appears.

After the CMX is added, if you make any changes to the floor on the Network Hierarchy page, the changes are synchronized automatically with the CMX.

When the CMX is synced, Cisco DNA Center starts querying the CMX for the client location and displays the location on the floor map.

Step 11

From the floor map, you can do the following:

  • View the location of the client, which is shown as a blue dot.

  • Hover your cursor over an AP. A dialog box is displayed with Info, Rx Neighbor, and Clients tabs. Click each tab for more information. Click Device 360 to open the Device 360 window and view issues. Click an issue to see the location of the issue and the location of the client device.

  • Click an AP to open a side bar with details about the AP.

  • Perform real-time client tracking when Intelligent Capture and CMX are integrated.

Step 12

If the CMX was down when you made changes, you must synchronize manually. To do so, on the Network Hierarchy page, hover your cursor over the ellipsis next to the building or floor on which you made the changes in the left tree pane, and then choose Sync: DNA Spaces/CMX to push the changes manually.

Step 13

To edit the CMX server details or delete a CMX server, do the following:

  1. Click the menu icon () and choose System > Settings.

  2. From the External Services section, click DNA Spaces/CMX Servers.

  3. Select the CMX server that you want to edit, make any changes, and click Update.

  4. Select the CMX server that you want to delete and click Delete.

  5. Click OK to confirm the deletion.

Troubleshoot Cisco CMX

CMX Authentication Failure

  • Check if you are able to log in to the CMX web UI with the credentials that you provided at the time of CMX settings creation on Cisco DNA Center.

  • Check if you are able to log in to the CMX console using SSH.

  • Check if you are able to exercise CMX REST APIs using the API Documentation link on the CMX UI.

Clients Do not Appear on the Floor Map

  • Check if the Cisco Wireless Controller on the particular floor is configured with CMX and is active.

  • Check if the CMX UI shows clients on the floor map.

  • Use the Cisco DNA Center Maps API to list the clients on the floor: curl -k -u <user>:<password> -X GET /api/v1/dna-maps-service/domains/<floor group id>/clients?associated=true