Integrate Cisco CMX for Wireless Maps
“
Product Information
Specifications:
- Product Name: Cisco CMX for Wireless Maps Integration
- Integration: Cisco Connected Mobile Experiences
- Security: CMX should be anonymized for security purposes
Product Usage Instructions
Add a User for the Cisco CMX API Server:
- SSH to Cisco CMX using a cmxadmin account. Enter this command:
ssh -l cmxadmin (cmx-ip-address) - Start the Cisco CMX API server. Enter this command: # cmxos
apiserver start - Add a user for the Cisco CMX API server. Enter this command:
cmxos apiserver user add - At the password prompt, use the same password as the Cisco CMX
web admin user password.
Create Cisco CMX Settings:
- From the main menu, choose System > Settings.
- From the External Services section, click Cisco Spaces/CMX
Servers. - Click Add in the CMX Servers table.
- Complete the fields in the Add CMX Server slide-in pane.
- To assign a CMX server to a site, building, or floor, ensure
you have Write permission on Network Hierarchy. - Click Add to save the settings.
- If the CMX was down when changes were made, synchronize
manually by selecting Sync: Cisco Spaces/CMX Servers in the Network
Hierarchy window.
FAQ
How do I troubleshoot Cisco CMX integration?
To troubleshoot Cisco CMX integration, follow these steps:
- From the main menu, choose System > Settings.
- Click on Cisco Spaces/CMX Servers under the External Services
section. - Select the CMX server you want to edit or delete.
- Make necessary changes and click Update or click Delete to
remove the server. - Confirm the deletion by clicking OK.
“`
Integrate Cisco CMX for Wireless Maps
· About Cisco Connected Mobile Experiences integration, on page 1 · Add a user for the Cisco CMX API server, on page 1 · Create Cisco CMX settings, on page 2 · Troubleshoot Cisco CMX, on page 4
About Cisco Connected Mobile Experiences integration
Catalyst Center supports the integration of on-premises Cisco 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 Catalyst 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 Catalyst Center Network Settings, you must add a user for the Cisco CMX API server.
Procedure
Step 1 Step 2
SSH to Cisco CMX using a cmxadmin account. Enter this command:
ssh -l cmxadmin (cmx-ip-address)
Start the Cisco CMX API server. Enter this command:
# cmxos apiserver start
Integrate Cisco CMX for Wireless Maps 1
Create Cisco CMX settings
Integrate Cisco CMX for Wireless Maps
Step 3
Example The following example shows how to start the Cisco CMX API server: [root@server]# cmxos apiserver start Starting CMX API Server…
Add a user for the Cisco CMX API server. Enter this 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: Cisco_CMX_web_admin_password Please re-enter the password for the CMX API Server: Cisco_CMX_web_admin_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 Catalyst Center. See Create Cisco CMX settings, on page 2.
Create Cisco CMX settings
Before you begin · Ensure that CMX is configured with a valid SSL/TLS certificate. See the CMX 10.5 SSL certificate installation procedure. · Add a Cisco CMX API user. See Add a user for the Cisco CMX API server, on page 1.
Procedure
Step 1 Step 2
Step 3 Step 4
From the main menu, choose System > Settings. From the External Services section, click Cisco Spaces/CMX Servers. The Cisco Spaces/CMX Servers window opens.
From the CMX Servers table, click Add. Complete the fields in the Add CMX Server slide-in pane:
· IP Address: Enter the valid IP address of the CMX web GUI. · Username: Enter the CMX web GUI username.
Note
Integrate Cisco CMX for Wireless Maps 2
Integrate Cisco CMX for Wireless Maps
Create Cisco CMX settings
Step 5
Step 6 Step 7 Step 8 Step 9 Step 10 Step 11
Step 12
Step 13 Step 14
To assign a CMX server to a site, building, or floor, you must have Write permission on Network Hierarchy. For more information, see the “Catalyst Center User Role and Permissions” section in the Cisco Catalyst Center Administrator Guide.
· Password: Enter the password credentials.
Note Ensure CMX is reachable.
Click Add. The connection status is shown in these three stages:
· Initiating Connection: Verifies connectivity to the server.
· Establishing Trust: Establishes trust to the CMX server. The CMX server must have a valid SSL/TLS certificate configured to establish trust. If the certificate is not yet stored in Catalyst Center Trusted Certificates, you will be prompted to Accept the certificate to continue.
· Connecting CMX Server: Validates the user credentials provided.
To assign a CMX server to a site, building, or a floor, click the menu icon and choose Design > Network Settings. Click the Wireless tab. From the left hierarchy tree, select either Global or the required area, building, or floor. Click Cisco Spaces/CMX Servers. In the Cisco Spaces/CMX Servers section, from the Location Settings drop-down list, select the CMX server. Click Save. The Create CMX Settings window opens. 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, Catalyst Center starts querying the CMX for the client location and displays the location on the floor map.
From the floor map, you can do these tasks: · View the location of the client, which is shown as a blue dot.
· Hover your cursor over an AP. A dialog box appears 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.
· Do real-time client tracking when Intelligent Capture and CMX are integrated.
If the CMX was down when you made changes, you must synchronize manually. To do so, on the Network Hierarchy window, hover your cursor over the ellipsis next to the building or floor on which you made the changes in the left hierarchy tree, and then select Sync: Cisco Spaces/CMX Servers to push the changes manually. To edit the CMX server details or delete a CMX server: a) From the main menu, choose System > Settings. b) From the External Services section, click Cisco Spaces/CMX Servers.
Integrate Cisco CMX for Wireless Maps 3
Troubleshoot Cisco CMX
Integrate Cisco CMX for Wireless Maps
c) Select the CMX server that you want to edit, make any changes, and click Update. d) Select the CMX server that you want to delete and click Delete. e) 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 Catalyst 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 Catalyst 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
Integrate Cisco CMX for Wireless Maps 4
Documents / Resources
 |
cisco Integrate Cisco CMX for Wireless Maps [pdf] Owner's Manual Integrate Cisco CMX for Wireless Maps, Cisco CMX for Wireless Maps, CMX for Wireless Maps, Wireless Maps, Maps |