Release Notes for Cisco Connected Mobile Experiences (CMX), Release 10.2.0 and Later
Available Languages
Table of Contents
Release Notes for Cisco CMX Release 10.2.0 and Later
What’s New in Cisco CMX Release 10.2.3
Cisco Aironet 1800, 2800, and 3800 Series Access Points Support
Analytics Report Filtered for Associated Devices
SSID Filtering in the Location Service
Northbound Notifications Improvements
Feature Flag and UI Responsiveness
What’s New in Cisco CMX Release 10.2.2
Property Management System Integration
What’s New in Cisco CMX Release 10.2.1
What’s New in Cisco CMX Release 10.2.0
Software Release Recommendations
Installing a Cisco MSE Virtual Appliance
Resolved Caveats in Cisco CMX Release 10.2.3
Resolved Caveats in Cisco CMX Release 10.2.2
Resolved Caveats in Cisco CMX Release 10.2.1
Resolved Caveats in Cisco CMX Release 10.2.0
Create New Notification Window
Changing the Portal Login Frequency
Creating an Analytics Report Based on Connected or Detected Devices
Configuring SSID Filtering in the Location Service
Creating an Inclusion or Exclusion Region
Viewing Northbound Notifications
Creating New Virtual Machines Using Hyper-V Manager
Adding and Deleting Perimeters Managing Perimeters and Zones on Location Maps
Viewing a Device Count and Average Dwell Time Report
Obtain Documentation and Submit a Service Request
Release Notes for Cisco CMX Release 10.2.0 and Later
First Published: September 25, 2015
Last Modified: March 28, 2016This document describes what is new in Cisco Connected Mobile Experiences (Cisco CMX) Release 10.2.0 and later, and the system requirements, upgrade scenarios, and caveats. Unless otherwise noted, Cisco Connected Mobile Experiences is referred to as Cisco CMX in this document.
Introduction
Cisco CMX Release 10.2.x is a high-performing scalable software solution that addresses the mobility services requirements of high-density Wi-Fi deployments.
What’s New
- What’s New in Cisco CMX Release 10.2.3
- What’s New in Cisco CMX Release 10.2.2
- What’s New in Cisco CMX Release 10.2.1
- What’s New in Cisco CMX Release 10.2.0
What’s New in Cisco CMX Release 10.2.3
- Cisco Aironet 1800, 2800, and 3800 Series Access Points Support
- Portal Login Frequency
- Analytics Report Filtered for Associated Devices
- SSID Filtering in the Location Service
- Inclusion/Exclusion Region
- Northbound Notifications Improvements
- Feature Flag and UI Responsiveness
- Hyper–V Support
- Real-Time Analytics Reports
Cisco Aironet 1800, 2800, and 3800 Series Access Points Support
Cisco CMX Release 10.2.3 supports the Cisco Aironet 1800, 2800, and 3800 Series Access Points.
Portal Login Frequency
You can define how often your login page is displayed to a visitor each time their device associates with the SSID in your network. By default, a repeat visitor does not need to go through the portal login process for 180 days from the day the visitor associated with the SSID. For the configuration procedure, see the “Changing the Portal Login Frequency” section.
Analytics Report Filtered for Associated Devices
You can create filtered analytics reports based on all visitor devices connected to the network (regardless of SSID) and on all visitor devices detected by the network. These are categorized as CONNECTED and DETECTED devices. In addition, any devices filtered by the Location service is also excluded from analytics reports. For the configuration procedure, see the “Creating an Analytics Report Based on Connected or Detected Devices” section.
SSID Filtering in the Location Service
You can configure filtering in the Cisco CMX Location Service to exclude all visitor devices that are associated to a particular SSID. For the configuration procedure, see the “Configuring SSID Filtering in the Location Service” section.
Inclusion/Exclusion Region
The Create Inclusion/Exclusion feature allows you to create inclusion and exclusion regions on a floor.
- Inclusion regions define areas within a floor where wireless devices will be either inside or snapped on the boundary (due to weak coverage). There will be one inclusion region per floor only. When there is no inclusion region defined in the floor maps, Cisco CMX creates a default inclusion region that is the same as the floor dimension. We recommend having one inclusion region on a floor to correctly bound the clients on floor area.
- Exclusion regions define areas within a floor which are inside an inclusion region. In an exclusion region, wireless devices will be ignored. There could be multiple exclusion regions per floor.
Defining inclusion and exclusion regions can help you focus Cisco CMX processing to just those areas of the map where you want to manage your wireless devices, and ignore others.
For the configuration procedure, see the “Creating an Inclusion or Exclusion Region” section.
Northbound Notifications Improvements
You can now view northbound notifications from the Cisco CMX UI and CLI. For the procedure, see the “Viewing Northbound Notifications” section.
Feature Flag and UI Responsiveness
You can use the cmxctl config featureflags command to enable and disable Cisco CMX Analytics features. For example, the CMX system includes an ALERT tab, to have these alerts configured you need to set the feature flag to enable alerts. This tab also displays hashtags and statistics information.
For more information about the cmxctl config featureflags command, see the “cmxctl config featureflags” section.
Hyper–V Support
You can now run Cisco CMX on Microsoft Hyper-V virtualization hosts. This enables you to use Cisco CMX on virtual machines using any Hyper-V capable host running Windows Server 2008 R2 or later. You can create a new virtual machine using Hyper-V Manager application. Ensure to specify 24 GB of memory or higher when creating the virtual machine in Hyper-V manager, and to subsequently increase the processor count for the virtual machine to 8 vCPU or higher before starting the new virtual machine.
If you are running Windows Server 2012 or later, we recommend you to convert the Cisco CMX .vhd disk image to .vhdx format before adding it to the new virtual machine. For the configuration procedure, see the “Creating New Virtual Machines Using Hyper-V Manager” section.
Real-Time Analytics Reports
You can now view real-time analytics reports in the Cisco CMX GUI. This is a new tab that shows you a WIFI adoption widget based off of the REAL TIME information. The NOW parameter for Analytics has been removed.
What’s New in Cisco CMX Release 10.2.2
The Cisco CMX Release 10.2.2 underwent extensive validation to improve quality and includes these feature enhancements:
License Enforcement
Cisco CMX displays an alert when the 120-day Cisco CMX evaluation license expires. The alert includes a link to add a permanent license. You must upload a permanent license to CMX before the evaluation license expires. Otherwise, you will not be able to access the Cisco CMX GUI or APIs. Cisco CMX will continue to run in the background and collect data until you add a permanent license.
After the evaluation license expires, only users with admin privileges can log in to add additional licenses.
Property Management System Integration
Using the Cisco CMX Connect service in Cisco CMX Release 10.2.2, you can integrate a Property Management Systems (PMS) solution (for example, a PMS solution used by a hospitality industry). The PMS solution in Cisco CMX:
- Provides a guest WiFi portal at a hotel
- Provides flexibility to assign different WiFi plans to different portals at different locations
Currently, the Cisco CMX Connect service only integrates with the Nevotek Property Management System accounts. The Nevotek Property Management System is a paid service for which the customer must establish their own account or subscription.
Policy Plans
The Cisco CMX Policy Plans feature gives you the option to specify location-specific bandwidth and to control the bandwidth assigned to the client as they move from one location to the next. Use the CMX Policy Plans window to configure this feature.
For example, the bandwidth provided to clients in a hotel room is higher than the bandwidth provided in a hotel lobby. If the CMX Policy Plans feature is active, the bandwidth to the client is automatically increased when the client moves from the lobby to their hotel room. In addition, if the Keep Highest Bandwidth check box on the CMX Policy Plans window is selected, the client retains the higher bandwidth when returning to the lobby.
Note To use the Cisco CMX Policy Plans feature, make sure the Cisco CMX Property Management System (PMS) feature is disabled. In addition, adding a PMS server disables the Cisco CMX Policy Plans feature. By default, the Cisco CMX PMS feature is disabled.
User Opt-Out Option
The Cisco CMX Connect service allows the user to opt-out from having their mobile device location history maintained and used by CMX.
Hyperlocation Diagnostics
The Hyperlocation Diagnostics tool executes a set of tests to verify common issues found on the Cisco WLC, Cisco AP, and Cisco CMX when deploying Cisco HyperLocation. These tests are executed against an existing Cisco Hyperlocation setup on a floor. The floor should have clients associated to Cisco Hyperlocation access points to validate complete functionality. Execution of the full set of tests requires credentials for the Cisco WLC and the HyperLocation-enabled Cisco APs.
Queue Analytics
A specialized analytics widget that calculates Queue Time instead of Average Dwell Time is available when an instance is configured with the airport vertical.
Presence Notification
The CMX Presence Notifications feature provides notifications when the presence of passersby is detected, when passersby become visitors, when visitors have left the network, and when the site entry changes.
Cisco Hyperlocation
The Cisco Hyperlocation solution is a suite of technologies that enable advanced location capabilities through a mix of software and hardware innovations. Cisco CMX Release 10.2.1 supports Angle of Arrival (AoA) technology available on Cisco Aironet 3600/3700 access points with a Hyperlocation module and a Hyperlocation antenna. Cisco CMX uses advanced location algorithms to extract phase differences to accurately locate associated wireless clients within 1 meter accuracy.
Note Cisco Aironet 3600/3700 APs Release 8.1.131.20 or later support CMX Hyperlocation. In addition, Hyperlocation is not supported on the Cisco Virtual Wireless LAN Controller (vWLC).
The Cisco Hyperlocation module with advanced security also integrates Bluetooth Low Energy (BLE) Beacons with the module. Customers can take advantage of hassle-free BLE Beacon deployment powered over Ethernet and centrally managed from the convenience of a data center. This eliminates the need for local IT engineers to perform an inspection walk of BLE beacon health, using an app on their Smart devices. Cisco Hyperlocation brings configurable BLE beacon technology since a single Hyperlocation module can be configured to beacon out five different BLE beacons to enable applications.
Cisco CMX FastLocate
Cisco CMX FastLocate technology enables quick location refresh for connected WiFi clients. RSSI from data packets and probe frames when available are used for calculating location. It is available with both centrally switched WLANs as well as FlexConnect (locally switched WLANs).
Note Cisco Aironet 700, 1700, 2600/2700, and 3600/3700 APs support Cisco CMX FastLocate when used with Cisco WLC Release 8.1.131.18 or later, and with Enhanced Local Mode enabled. Cisco 3600/3700 APs also support Cisco CMX Fastlocate with dedicated radio modules.
These are the recommended AP modes:
- Enhanced Local Mode: APs scan opportunistically on-current channel and off-channel with up to ~15 percent performance impact to data serving radios.
- Monitor Mode AP: APs scan on 2.4 and 5 GHz bands.
- Modular AP: Cisco 3600/3700 APs with Hyperlocation Module or Wireless Security Module (WSM) scan on 2.4 and 5 GHz bands with no impact to data serving radios.
Presence Analytics
Note You cannot run both the Location and Presence Analytics services on the same Cisco CMX instance.
The Presence Analytics service uses the received signal strength indicator (RSSI) along with the duration of the RSSI from a client device to determine whether a client device is in the site or is a passer-by. Presence Analytics takes input directly from the Network Management Services Protocol (NMSP) load balancer in the form of a MAC address and observed RSSI values for the MAC address.
There are two RSSI threshold values defined for a site, low (default of -95 dBm) and high (default of 65 dBm).
- Clients with RSSI below the low threshold are discarded.
- Clients with RSSI above the low threshold are classified as passer-by .
- Clients with RSSI above the high threshold plus x minutes (default of 5) in the past 20 minutes are classified as visitors.
Note Clients associated with an access point (AP) in a site are classified as visitors at the site.
Presence Analytics does not require APs to be placed on a map; they should only be associated with a site. The Presence Analytics feature neither uses nor requires maps. Therefore, all the configurations are accomplished from the Dashboard rather than the Manage tab.
Table 1 lists the Presence Analytics features.
Social Analytics
Cisco CMX provides the ability to use data collected from social media to provide analytics, which can be used to enhance decision-making capabilities. Business organizations can analyze their online reputation and view trends relating to positive and negative comments about their events or services.
Social Analytics is currently limited to interaction with Twitter only, with Cisco CMX making API calls to Twitter servers. Cisco CMX establishes a connection to the Twitter server public search API filtered for the configured tags.
The Social menu option on the Analytics service provides access to the collected data. Tweets are collected using a background process. The process starts every hour and collects for 90 percent of the hour (nonconfigurable). The process stops at the end of the hour and a new process starts.
In the Social Analytics window, you can perform the following operations:
– From either a single location or multiple locations combined
– Daily, weekly, monthly, or yearly
– For a predefined portion of the day
- Click the Configure icon to open the Term Definition window.
- Define the hash tags or terms to look for.
The upper half of the Social Analytics UI provides the current statistics gathered from the tweets matching the currently configured hashtags. The lower half of the UI provides a day-to-day detail comparison.
Verticalization
The Verticalization capabilities provide the ability to change the names or terms associated with each level of the hierarchy used in the Analytics report generation.
Although you can change the names of the hierarchy levels, the names of the existing elements, if any, cannot be changed once they are created. The renaming process is global and will impact all users.
To configure verticalization, perform the following procedure:
2. Choose Manage > Verticalization .
Detect and Locate Features
Cisco CMX uses advanced RSSI-based trilateration algorithms to locate Wi-Fi and non-Wi-Fi assets.
Connect Features
Analytics Features
Cisco CMX has three new widgets that can be added to a custom Analytics report:
Platform Features
Table 4 lists the Platform features.
Cisco CMX Release 10.2.0 introduces two new user accounts to prevent any potential misuse of the root user account.
The installation process uses an open source configuration and management tool called SaltStack. This enables standardization, such as International Organization for Standardization (ISO), Open Virtualization Archive (OVA), cloud virtual machines (VMs), and upgrade packages.
The Salt-base installation model consists of the following components and packaged in a single file named CISCO_CMX$$$.cmx:
- The base operating system, which is a minimal installation of CentOS 6.6.
- The Cisco CMX repository, which contains both the necessary cmx rpm files and other files to install and upgrade any mandatory operating system or third-party dependencies.
- The Salt configuration.
The Cisco CMX software is packaged as follows:
- .iso—File for initial install on a physical appliance such as Cisco MSE 3365.
- .ova—File for use with the VMware vSphere client for initial installation of a virtualized Cisco MSE appliance on customer-provided hardware.
- .cmx—New installation and upgrade package that contains a mountable CD image (mounted at /mnt/cmx), which contains the Cisco CMX repository, Salt configuration information, and an .md5 file to verify the integrity of the repository.
Note Users do not have to make changes to the operating system manually beyond the network configuration and node type choice.
Cisco CMX Release 10.2.x software can be installed on a Cisco MSE 3365 that is currently running 8.0 code, using the .iso image. file (CISCO_CMX-10.2.0-213-3365.iso).
Note All data on the MSE 8.0 system will be erased and no data migration is supported.
Note Cisco CMX Release 10.2.x is supported on the MSE 3355 but on a limited scale in terms of number of tracked clients and number of WLCs synchronized. Cisco Hyperlocation is not be supported on the MSE 3355. Scale numbers for Location and Presence Analytics will be published at a later date.
Cisco WLC Release 8.1.131.0 or later is required to use with CMX Hyperlocation.The .iso image can be loaded on a USB stick or mounted as a virtual drive using the Cisco Integrated Management Controller (CIMC). For more information, see the “ Installing the CIMC Firmware Update Utility ” chapter in the Cisco CIMC Firmware Update Utility User Guide .
Cisco CMX Release 10.2.x software is deployed on a new Cisco MSE Virtual Appliance (vMSE) by using the VMware vSphere client to deploy the .ova file available on Cisco.com.
A new first-boot script determines if the initial configuration has been completed or not. If it is not completed, the script prompts for a default login or a normal login.
Note Initial login requires password configuration for both the root and new cmxadmin user.
The Network configuration information can be changed after deployment by issuing the cmxos reconfigure command from the Cisco CMX CLI.
This feature allows you to change the IP address, netmask, default gateway, and Domain Name System (DNS) server information.
The Network Time Protocol (NTP) server information can be changed by using the vi editor to manually edit the etc/ntp.conf file to change the server line to reflect the new NTP server fully qualified domain name (FQDN).
Cisco CMX uses a single user mode to reset the root or cmxadmin user password.
Entry into the single user mode requires:
The GUI admin user password can be reset to the default admin password from the Cisco MSE CLI with the cmxctl reset ui-password command.
CLI access requires that you to know the password of the cmxadmin user.
Upgrading Cisco CMX Release 10.2.x to Future Releases Using Cisco CMX Web UI
After you install Cisco CMX Release 10.2.x, future updates can be performed through the Cisco CMX GUI or by using the cmxos upgrade command and the .cmx file, while you are logged in as cmxadmin, for example, cmxos upgrade < CISCO_CMX$$$.cmx >
System Scaling
For information, see the Cisco Connected Mobile Experiences Data Sheet : http://www.cisco.com/c/en/us/solutions/collateral/enterprise-networks/connected-mobile-experiences/datasheet-c78-734648.html .
System Requirements
Cisco CMX Release 10.2.x can be installed on a physical or virtual Cisco MSE appliance. Virtual Cisco MSE appliances require either VMware ESXi 5.1 or later, or Microsoft Hyper-V.
Note Cisco CMX Release 10.2.x is supported on the MSE 3355 and 3365 but on a limited scale in terms of number of tracked clients and number of WLCs synchronized. Cisco Hyperlocation is not be supported on the MSE 3355. Scale numbers for Location and Presence Analytics are included in the Cisco Connected Mobile Experiences Data Sheet: http://www.cisco.com/c/en/us/solutions/collateral/enterprise-networks/connected-mobile-experiences/datasheet-c78-734648.html.
Cisco WLC Release 8.1.131.20 or later is required to use with CMX Hyperlocation.
Computing Requirements
Table 5 lists the Cisco CMX Release 10.2.x hardware guidelines for a virtual Cisco MSE appliance, such as VMWare or Microsoft Hyper-V.
For complete requirements, see the Cisco Connected Mobile Experiences Data Sheet : http://www.cisco.com/c/en/us/solutions/collateral/enterprise-networks/connected-mobile-experiences/datasheet-c78-734648.html .
Solution Compatibility Matrix
For information, see the “Cisco Connected Mobile Experiences (CMX) Compatibility Matrix” section in the Cisco Wireless Solutions Software Compatibility Matrix : http://www.cisco.com/c/en/us/td/docs/wireless/compatibility/matrix/compatibility-matrix.html .
Upgrading Cisco CMX
Cisco CMX Release 10.2.x is available as software that can be run on physical or virtual Cisco MSE appliances. No database migration or inline upgrade is supported from Cisco MSE 8.0 or earlier to Cisco CMX Release 10.2.x. You can upgrade from Cisco CMX Release 10.1.x to Cisco CMX Release 10.2.x. We recommend that you run Cisco CMX Release 10.2.x in parallel with the existing Cisco MSE 8.0 or earlier, and utilize the evaluation license for 120 days. After the evaluation period, the older Cisco MSE can be decommissioned.
- For information about upgrading from Cisco CMX Release 10.2.0 to 10.2.1 or later, see http://www.cisco.com/c/en/us/td/docs/wireless/mse/10-2/installation/guide/installation_guide/MSE_Installation_Using_Vsphere_Client.html#pgfId-1255361
- For information about upgrading from Cisco CMX Release 10.1.x to 10.2.x, see http://www.cisco.com/c/en/us/td/docs/wireless/mse/10-2/installation/guide/installation_guide/MSE_Installation_Using_Vsphere_Client.html#pgfId-1291078
Note Information related to Cisco CMX Release 10.2.x upgrades is described in the Cisco MSE Virtual Appliance Installation Guide for CMX Release 10.2.
Note In Cisco CMX Release10.2.2, the analytics client count trend was corrected to reflect the actual counts. After upgrading from Cisco CMX Release 10.2.1 to 10.2.2, the analytics client count trend is higher.
Licensing Information
Note For information about procuring Cisco CMX licenses, see the Cisco Connected Mobile Experiences (CMX) Version 10 Ordering and Licensing Guide.
For information about adding and deleting licenses, see the “Managing Licenses” section in the Cisco Connected Mobile Experiences Configuration Guide, Release 10.2.
- Cisco CMX Release 10.2.x continues to use two-tier licensing—Cisco CMX Base and Cisco CMX Advanced. (The Connect service is now included as part of the Cisco CMX Base license.)
The CMX Base license provides the following services:
– Detect and Locate —The ability to determine the location of Wi-Fi clients, Bluetooth Low Energy (BLE) beacons, devices, and Radio Frequency Identification (RFID) tags
– Connect—Visitor Wi-Fi onboarding platform
– APIs—Third-party integration using standard REST APIs
– Location, Connect, and Configuration APIs
The CMX Advanced license provides the following services:
– Includes all the Cisco CMX Base services—Detect and Locate, APIs, Connect
– Location Analytics\Presence Analytics
- The Evaluation License of Cisco CMX Release 10.2.x provides full functionality for a period of 120 days. Evaluation of Cisco CMX Base and Cisco CMX Advanced licenses are built in with every Cisco CMX Release 10.2.x instance. There are no limitations with regard to the functionalities when you use the Evaluation License in a current release.
- Every Cisco CMX Release 10.2.x box or image ships with a 120-day evaluation license for all the services. The countdown starts when you start Cisco CMX and enable a service.
Note Two weeks before the evaluation license expires, you will receive a daily alert to obtain a permanent license. If the evaluation license expires, you will not be able to access the Cisco CMX GUI or APIs. Cisco CMX will continue to run in the background and collect data until you add a permanent license and regain access to it. For information about adding and deleting licenses, see the “Managing Licenses” section in the Cisco Connected Mobile Experiences Configuration Guide, Release 10.2.
- Accounting starts from the day you start using the Cisco CMX Release 10.2.x software. Each day, the evaluation license is decremented by one.
- The license page shows a summary of the current licenses and their state. If a service is running and its license has expired, an
Out of Compliancemessage is displayed. However, the service is still allowed to run.
Note Out-of-compliance licenses running in Cisco CMX Release 10.2.x will not receive any support from the Cisco Technical Assistance Center.
Note For information about adding and deleting licenses, see the “Managing Licenses” section in the Cisco Connected Mobile Experiences Configuration Guide, Release 10.2.
Software Release Recommendations
Table 6 lists the recommended Cisco CMX software releases and their benefits.
Installing a Cisco MSE Virtual Appliance
For information about installing a Cisco MSE Virtual Appliance, see the Cisco MSE Virtual Appliance Installation Guide, CMX Release 10.2 at:
http://www.cisco.com/c/en/us/td/docs/wireless/mse/10-2/installation/guide/installation_guide.html
Important Notes
- From Cisco CMX Release 10.1.x, Cisco CMX, Cisco Wireless LAN Controller (Cisco WLC) and Cisco Prime Infrastructure will be independently version numbered. See the “Solution Compatibility Matrix” section to identify release numbers of individual components for your deployment.
- Cisco CMX Release 10.2.x requires interaction with Cisco Prime Infrastructure only during the initial installation stage. After the maps and controllers are imported from Cisco Prime Infrastructure, the two do not have run-time dependencies.
- Unlike in releases earlier than Cisco CMX Release 10.1.x, zones are created in Cisco CMX Release 10.1.x or Cisco CMX Release 10.2.x after the maps are imported from Cisco Prime Infrastructure.
- Changing the hostname through command line is not supported. Use the cmxos reconfigure command to change a hostname, IP address, or any of the network parameters.
- The Analytics service supports input and output only in English.
- Do not use Internet Explorer 8.0 to edit the wireless LAN controller (WLC) SNMPv3 credentials. Use Chrome 40 or later (“Browser Support” section).
- The device name must start with a letter (for example, cmx01). The setup script fails if the device name starts with a numeric (for example, 01cmx).
- In Cisco CMX Release 10.1, the SSL mode is disabled by default. In Cisco CMX Release 10.2, the SSL mode is enabled by default and therefore to offer Cisco CMX Connect portal page in HTTP, you should disable the SSL mode by entering the following command:
- To observe the disk space utilization, refer to the Memory details from the Systems tab. For details on increasing hard disk space, see the “Increasing the Hard Disk Space” section in the “Performing Administrative Tasks” chapter in the Cisco Connected Mobile Experiences Configuration Guide, Release 10.2.
When more than 85 percent of the disk space is consumed, all CMX services shut down. For details, see the “Troubleshooting Cisco CMX Server Shutdown Problems” section in the “Performing Administrative Tasks” chapter in the Cisco Connected Mobile Experiences Configuration Guide, Release 10.2.
- After installing the ISO file on the Cisco MSE 3355 or 3365, use the cmxctl status command to check if the CMX services are running. If they are not running, use the cmxctl start command.
- The following information applies only if you have SSL enabled: If you enable HTTPS for Cisco CMX Analytics (generally Cisco CMX as a whole), make sure a valid SSL certificate is installed. Otherwise, slower UI performance will occur and reporting will not work as expected.
If you do not have a valid SSL certificate to install, you need at least a self-signed certificate.
If neither a valid SSL certificate or self-signed certificate is present, Cisco CMX analytics might not work as expected.
- (CSCvb64651) If you have HTTPS enabled and if you do not have a valid certificate (meaning, a screen was displayed where you accepted the risk to continue), reports do not work. This is a limitation from the Google Chrome browser, not from Cisco CMX.
If you do not need HTTPS, disable it so that reports work.If you need HTTPS, install a valid SSL certificate on the box. Note that having a valid SSL certificate also improves the interface speed.
- (CSCvb24320) In Cisco CMX Release 10.2.2 and 10.2.3, changes were made related to Cisco CMX Analytics device count. For detailed information, see the CMX 10.2.2 and CMX 10.2.3 - Changes in Analytics Numbers document: https://communities.cisco.com/docs/DOC-69845 .
- (CSCva36827) Instead of the /api/location/v2/clients API or /api/location/v2/clients/count API, use the /api/location/v1/clients API to get a report on the number of active clients.
- (CSCuw73675) For security, Cisco CMX Release 10.3.0 blocks a list of ports, such as port 5555.
Caveats
- Cisco Bug Search Tool
- Open Caveats
- Resolved Caveats in Cisco CMX Release 10.2.3
- Resolved Caveats in Cisco CMX Release 10.2.2
- Resolved Caveats in Cisco CMX Release 10.2.1
- Resolved Caveats in Cisco CMX Release 10.2.0
Cisco Bug Search Tool
The Bug Search Tool (BST), which is the online successor to the Bug Toolkit, is designed to improve the effectiveness of network risk management and device troubleshooting. The BST allows partners and customers to search for software bugs based on product, release, and keyword, and aggregates key data such as bug details, product, and version. The tool has a provision to filter bugs based on credentials. Perform the following task:
1. Access the BST (using your Cisco user ID and password) at:
https://tools.cisco.com/bugsearch/
2. Enter the bug ID in the Search For: field.
Note Using the BST, you can also find information about the bugs that are not listed in this document.
Open Caveats
Use the BST to view the details of the caveats listed in this section. For more information about the BST, see the “Cisco Bug Search Tool” section.
Resolved Caveats in Cisco CMX Release 10.2.3
Use the BST to view the details of the caveats listed in this section. For more information about the BST, see the “Cisco Bug Search Tool” section.
Resolved Caveats in Cisco CMX Release 10.2.2
Use the BST to view the details of the caveats listed in this section. For more information about the BST, see the “Cisco Bug Search Tool” section.
Resolved Caveats in Cisco CMX Release 10.2.0
Use the BST to view the details of the caveats listed in this section. For more information about the BST, see the “Cisco Bug Search Tool” section.
Documentation Errata
The following information will be incorporated in the applicable Cisco CMX Release 10.2 document at its next revision.
Node Details Window
(CSCuz67492) The “Viewing Cisco CMX Node Details” section in the configuration guide will be updated with this information:
In Cisco CMX Release 10.2.1, the Node Details window was changed to display this information: Node ID, IP Address, Hostname, and System Time.
Previously, the Node Details window displayed this information: Node ID, Name, Hostname, and Type.
Create New Notification Window
(CSCuz67492) The “Creating a New Notification” section in the configuration guide will be updated with this information:
In Cisco CMX Release 10.2.1, the Device Type field on the Create New Notification window was changed to provide these options: All , Tag , Client , and Interferer . The Rogue Client and Rogue AP options now have been removed.
In addition, if the In option is selected in the Condition field, this warning message is displayed:
Please make sure to add 'Out' condition with same Hierarchy. Conversely, if the Out option is selected in the Condition field, this warning message is displayed:Please make sure to add 'In' condition with same Hierarchy.Create New Report Window
(CSCuz67492) The “Creating and Managing Customized Reports” section in the configuration guide will be updated with this information:
In Cisco CMX Release 10.2.1, the maximum number of widgets you can include when creating a new report is 9. If you add more than 9 widgets, this message is displayed: Analytics only supports 9 widgets in a report. Please reduce the number of widgets.
Activity Map Window
(CSCuz67492) Step 4 in the “Viewing or Tracking Devices” section in the configuration guide will be updated with this information:
In Cisco CMX Release 10.2.1, when you select an access point icon from a floor map displayed on the Activity Map window, the Access Point information area includes Angles information.
Analytics Dashboard
(CSCuz67492) The “Analytics Reports” section in the configuration guide will be updated with this information:
Note In Cisco CMX Release 10.2.2, the Unique Device widget is no longer available for analytics reports.
Maps Window
(CSCuz67492) The “Importing Maps and Adding Controllers” section in the configuration guide will be updated with this information:
In Cisco CMX Release 10.2.2, these fields on the Maps window changed:
– Select this option to delete existing maps by replacing them with the uploaded maps.
– Select this option to delete existing zones by replacing them with the uploaded maps.
Changing the Portal Login Frequency
A new section about the Portal Login Frequency feature will be added to the configuration guide. See the “Portal Login Frequency” section for the feature description. Below is the configuration procedure.
Step 1 Log in to Cisco Connected Mobile Experiences (Cisco CMX).
Step 2 Choose Connect & Engage > Settings > General to display the Connect Settings window.
Step 3 From the Connect Settings window, change the value in the Visitor: Portal Frequency field. The range is 0 to 1000 days. The default is 180 days.
- If the login frequency is set to 0, the portal is displayed is each time the visitor’s device associates with the SSID.
- If the login frequency is set to 1, the portal is displayed when the visitor’s device first associates with the SSID and is not displayed again until after a 24-hour period. Within that 24-hour period, the portal is not displayed regardless of the number of times the visitor’s device disassociates and associate to the SSID.
Creating an Analytics Report Based on Connected or Detected Devices
A new section about creating a filtered analytics report based on connected or detected devices will be added to “The Analytics Dashboard” section in the configuration guide. See the “Analytics Report Filtered for Associated Devices” section for the feature description. Below is the configuration procedure.
Step 1 Log in to Cisco Connected Mobile Experiences (Cisco CMX).
Step 2 Choose Analytics > Reports to display the Create New Report window.
Step 3 From the Connect/Detected Devices widget, select Connected or Detected , or select both.
If both are selected, all connected and detected devices will be displayed (meaning, no filtering) in the Visitor Count area on the Analytics Dashboard.
The Visitor Count information on the Analytics Dashboard reflects the following:
- If the Connected option is selected, a green WiFi icon appears next to the Visitor Count heading. The visitor count displayed is the number of devices connected to the SSID.
- If the Detected option is selected, a gray WiFi icon appears next to the Visitor Count heading. The visitor count displayed is the number of devices detected by the SSID.
- If both options are selected (meaning, no filtering), no icon appears.
Configuring SSID Filtering in the Location Service
See the “SSID Filtering in the Location Service” section for the feature description. Step 4 in the “Setting Filter Parameters” section in the configuration guide will be updated to include the following bullet and procedure:
- Enable SSID Filtering —Check this check box to so that the Location service excludes all visitor devices associated to a particular SSID:
a. Click Enable SSID Filtering .
b. Click Select SSID , and select a particular SSID.
If no SSIDs appear in the list, make sure that a Cisco WLC is active, and then click Fetch SSIDs to refresh the list.
c. Click Filter SSID to add the selected SSID to the filter list.
Creating an Inclusion or Exclusion Region
A new section about creating inclusion and exclusion regions will be added to the “The Cisco CMX Detect and Locate Service” section in the configuration guide. See the “Inclusion/Exclusion Region” section for the feature description.
Step 1 Log in to Cisco Connected Mobile Experiences (Cisco CMX).
Step 2 Choose Manage > Locations .
Step 3 In the left pane, click Floor .
Step 4 To go to the map view of the floor, click the arrow on the top right of the floor tile view. The Zone Editor window is displayed with a list of icons to the right.
Step 5 To add a new inclusion region:
a. Click the + icon to create an inclusion region on the map.
b. Double-click to finish creating the inclusion area. The inclusion region is displayed in green.
c. In the Create a Inclusion dialog box, click Add .
To add an exclusion region, click the – icon and draw the exclusion area on the inclusion area.
Viewing Northbound Notifications
The “Editing a Notification” section in the configuration guide will be updated to include viewing northbound notifications.
Step 1 Log in to Cisco Connected Mobile Experiences (Cisco CMX).
Step 2 Choose Manage > Notifications .
Step 3 Under the Actions column for an existing notification, click Details to view additional information about the notification.
You can also view the northbound notification details in the Edit Notifications window. Optionally, from the CLI, use the cmxctl metrics notification command to view the northbound notifications.
Creating New Virtual Machines Using Hyper-V Manager
Step 1 Download the CMX .vhd file to the location on the drive where it will reside.
Step 2 (Optional) Convert the .vhd file to .vhdx format.
Step 3 Open the Hyper-V Manager application and verify the Hyper-V virtual network switch configuration.
Note To configure a Hyper-V virtual network switch, click Virtual Switch Manager at the right side of the Hyper-V Manager screen.
Step 4 To create a new VM, choose Action > New > Virtual Machine .
Step 5 Enter the name for the new virtual machine.
Step 6 Select to store the virtual machine in a different location, browse to the folder containing the .vhd or converted .vhdx file, and then click Next .
Step 7 Choose Generation 1 as the machine type, and then click Next .
Note Only certain Windows guests support Generation 2.
Step 8 Specify 8192 or greater for the VM memory, and then click Next .
Note Do not enable Dynamic Memory.
Step 9 Under Connections , choose the appropriate virtual network switch to connect the VM, and then click Next .
Step 10 Select Use an existing hard disk , and then navigate to the .vhd or .vhdx file on your hard disk.
Step 11 In the Summary screen, click Finish .
Step 12 Edit the new VM settings and change the processor count to a minimum of 4.
Adding and Deleting Perimeters Managing Perimeters and Zones on Location Maps
The “Managing Perimeters and Zones on Location Maps” section in the configuration guide will be updated with this information.
Note In Cisco CMX Release 10.2.3, the ability to create and delete a perimeter on location maps is no longer available.
Viewing Patterns
The “Viewing Patterns” section in the configuration guide will be updated with this information:
Note In Cisco CMX Release 10.2.3:
- The following pattern details are no longer available: Incoming Rate, Dropped Notifications, and NMSP LB Read Operations.
- In the Select Criteria drop-down list, the iOS8 Devices option is renamed to Locally Administered MAC count .
Viewing a Device Count and Average Dwell Time Report
The “Viewing a Device Count and Average Dwell Time Report” section in the configuration guide will be updated with this information:
Note In Cisco CMX Release 10.2.3, the Now option in the Date & Time Filters drop-down list is no longer available.
cmxctl debug
(CSCva94257) Usage guidelines for this command should state: This command should to be run using the cmxadmin (non-root) account.
In addition, the prompt in the CLI example should be
[cmxadmin@10.10.10.10:~]$, not[root@server]#.cmxctl config featureflags
The command reference will be updated with this information.
To list and toggle feature flags, use the cmxctl config featureflags command.
Usage GuidelinesTo enable analytics social media analytics feature flag, use the cmxctl config featureflags analytics.sma true command, and then use the cmxctl restart analytics command to restart the Analytics service.
After making changes to any feature flag configuration, use the cmxctl restart analytics command to restart the Analytics service.
cmxos backup
The prompt in the CLI example should be
[cmxadmin@10.10.10.10:~]$, not[root@server]#.cmxos monit
(CSCuy91949) The command reference will be updated with this information.
To manage the monitoring of Cisco CMX services, use the cmxos monit command.
ExamplesThe following example shows how to display the monitoring settings:
The following example shows how to enable monitoring of Cisco CMX services:
cmxos reconfig
(CSCuz95185) The following note will be added to the Usage Guidelines section for the cmxos reconfigure command:
Note Do not execute the cmxos reconfigure command when Cisco CMX services are not installed. This will prevent execution failures.
Importing Maps
(CSCvb31782) The Importing Maps section in the configuration guide will be updated with this information.
In Cisco CMX Release 10.2.2, overwriting an existing map with an imported map is no longer the default. If you want to overwrite your map during import, you must select the D elete & replace existing maps and analytics data check box on the Settings > Advanced > Maps window.
Note Previous data that existed before maps are overwritten can be only accessed through the API and not through UI.
Troubleshooting
For the most up-to-date, detailed troubleshooting information, see the Cisco TAC website at:
http://www.cisco.com/cisco/web/support/index.html
1. Choose Product Support > Wireless .
3. Click Troubleshoot and Alerts to find information about the problem you are experiencing.
Obtain Documentation and Submit a Service Request
For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service request, and gathering additional information, see What’s New in Cisco Product Documentation .
To receive new and revised Cisco technical content directly to your desktop, you can subscribe to the What’s New in Cisco Product Documentation RSS feed . The RSS feeds are a free service.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks . Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1721R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
FeedbackContact Cisco
- Open a Support Case
- (Requires a Cisco Service Contract)