Getting Started with Cisco CMX

Introduction to Cisco Connected Mobile Experiences

Cisco Mobility Services Engine (Cisco MSE) acts as a platform to deploy and run Cisco Connected Mobile Experiences (Cisco CMX). Cisco MSE is delivered in two modes, the physical appliance mode and the virtual appliance mode. Using your Cisco wireless network and location intelligence from Cisco MSE, Cisco CMX helps you create personalized mobile experiences for end users and gain operational efficiency with location-based services.

For more information about Cisco CMX features, see the Release Notes for Cisco CMX, Release 10.1, at:

http://www.cisco.com/c/en/us/td/docs/wireless/mse/release/notes/cmx_10_1_rn.html

Overview of Cisco CMX Services

Cisco CMX enables you to access the following services:

  • DETECT & LOCATE —This service provides a global view of all the campuses that are deployed. For more information, see Chapter2, “The Cisco CMX Detect & Locate Service”
  • ANALYTICS —This service provides a set of data analytic tools packaged for analyzing Wi-Fi device locations. It functions as a data visualization engine that helps organizations use their network as a data source for business analysis to understand behavior patterns and trends, which can help them take decisions on how to improve visitor experience and boost customer service. For more information, see Chapter3, “The Cisco CMX Analytics Service”
  • CONNECT & ENGAGE —This service provides intuitive, simple, highly customizable and location-aware guest services in the form of a captive portal that offers two types of guest on-boarding experiences:

– Facebook Wi-Fi

– Custom Portal

For more information, see Chapter4, “The Connect & Engage Service”

Prerequisites for Configuring Cisco CMX 10.1

The following components are mandatory for you to configure Cisco CMX 10.1:

  • Exported maps (in the form of files) from Cisco Prime Infrastructure 2.x
  • Cisco Wireless Controller (Cisco WLC) 7.x or 8.x
  • Cisco CMX 10.1 License (Cisco CMX 10.1 ships with a fully functional 120-day evaluation license that is activated after Cisco CMX is installed and started for the first time. For information about adding permanent licenses, see the “Managing Licenses” section.)

Importing Maps and Cisco Wireless Controllers

Cisco CMX relies on incoming Network Mobility Service Protocol (NMSP) data from any of the Cisco Wireless Controllers (Cisco WLCs) added to the system. The following sections describe the process to follow:

1. Exporting Cisco Prime Infrastructure Maps

2. Copying the Exported Maps

3. Importing Maps

4. Adding Cisco WLCs from CLI

Exporting Cisco Prime Infrastructure Maps

To obtain maps for Cisco CMX, you have to export maps from Cisco Prime Infrastructure.

Step 1 Log in to Cisco Prime Infrastructure.

Step 2 Choose Site Maps from the Maps menu in the Converged Theme.

Step 3 Choose Export Maps and click Go.

Step 4 Select the map to be exported and click Export.

This downloads the selected maps to a compressed tar file named ImportExport_ xxxx.tar.gz (for example, ImportExport_4575dcc9014d3d88.tar.gz) to your browser’s download directory.

 

Copying the Exported Maps

Use Secure Copy Protocol (SCP) to copy the exported maps to a directory of a server accessible by Cisco CMX.

Importing Maps

To import maps, perform one of the following tasks:

    • Import all the maps directly from Cisco Prime Infrastructure using the following command:

cmxctl config maps import

    • Import the exported maps into Cisco CMX using the following command:

cmxctl config maps import --type FILE --path <path to.tar.gz file>

For more information about Cisco CMX commands, see the Cisco Connected Mobile Experiences (CMX) Command Reference Guide, Release 10.1, at:

http://www.cisco.com/c/en/us/td/docs/wireless/mse/10-1/cmx_command/guide/cmxcli10.html

Adding Cisco WLCs from CLI

To add Cisco WLCs from the Cisco CMX CLI, run one of these commands:

  • cmxctl config controllers add
  • cmxctl config controllers import [PI/FILE]

For more information about Cisco CMX commands, see the Cisco Connected Mobile Experiences (CMX) Command Reference Guide, Release 10.1, at:

http://www.cisco.com/c/en/us/td/docs/wireless/mse/10-1/cmx_command/guide/cmxcli10.html

Logging In to the Cisco CMX User Interface

Step 1 Launch the Cisco CMX user interface using Google Chrome 40 or later.

Step 2 In the browser’s address line, enter https:// ipaddress, where ipaddress is the IP address of the server on which you installed Cisco CMX.

The Cisco CMX user interface displays the Login window.

Step 3 Enter your username and password.

The default username is admin and the default password is admin.

 

Adding and Managing Licenses

Cisco CMX 10.1 ships with a fully functional 120-day evaluation license that is activated after Cisco CMX is installed and started for the first time.

For information about adding permanent licenses, see the “Managing Licenses” section.

For details about procuring licenses, see the Cisco Connected Mobile Experiences (CMX) Version 10 Ordering and Licensing Guide.

Enabling or Disabling Cisco CMX Services

  • To enable all Cisco CMX services using Cisco CMX GUI, in the Actions columns of the System tab, click Enable All.
  • To enable a Cisco CMX service using the CLI, run the following command:

cmxctl enable {analytics | cache_6379 | cache_6380 | cassandra | configuration | confd | consul | database | haproxy | location | matlabengine | metrics | nmsplb | influxdb | iodocs | qlesspyworker | nmspproxy}

  • To disable a Cisco CMX service using the CLI, run the following command:

cmxctl disable {analytics | cache_6379 | cache_6380 | cassandra | configuration | confd | consul | database | haproxy | location | matlabengine | metrics | nmsplb | influxdb | iodocs | qlesspyworker | nmspproxy}

Adding Users and Managing Roles

Using the MANAGE service in Cisco CMX, you can create new users and assign roles to them based on the tasks they have to perform, that is, enabling role-based access control.

The following are the types of users:

  • Admin users—An admin user can access all the services and functionalities (based on the license type) of Cisco CMX.
  • Others—An admin user can create other users and assign roles to them.

The following is a list of roles that can be assigned to users:

  • System
  • Manage
  • Analytics
  • Read Only
  • Location
  • Admin
  • ConnectExperience
  • Connect

For more information about the creation of users and assignment of roles, see the “Managing Users” section.

Using the Cisco CMX Setup Assistant

The Cisco CMX Setup Assistant pop-up helps you through the basic steps before you start using your system. The Cisco CMX Setup Assistant is automatically displayed when you log in to Cisco CMX. To relaunch the Cisco CMX Setup Assistant, click the Help () icon.

Getting APIs

To obtain the following APIs, use the https:// cmx-ip-address /apidocs/ URL:

  • Configuration REST APIs for configuring different aspects of Cisco CMX.
  • Location-based REST APIs for finding location-specific details about visitors.
  • Analytics-based REST APIs for finding analytical data on visitors.
  • Connect-based REST APIs for finding user session information.