Welcome to our new CMX Mobility Services website on Cisco DevNet!

 

We are proud to announce the release of our newly redesigned website.   We have improved the structure of our content, so you’ll get more from a quick read.

You can find us at https://developer.cisco.com/site/cmx-mobility-services/

 

In addition to the changed design and layout of the pages, new functions have been implemented in this version.

 

Design and Navigation

The design of the web pages and the structure of information have been changed to improve overview and usability.  The new design and colors now reflect the general Cisco DevNet image and ambiance.

 

Product Overview

We have created three new Learning Labs for CMX Mobility Services. Try them!

 

Access to Sample Code and Scripts
The presentation of the code repositories in this section has been improved with more information and an optimized navigation structure.

 

CMX Sandboxes

It is now possible to view the Sandbox topology and to read about CMX user interface, as a place to get started learning CMX REST APIs.

 

Blogs and Forum Posts

See what others are saying about CMX Mobility Services.  The blogs and other user resources are still available, and only a single click away.

 

We hope you will enjoy our new site. If you have questions, comments or suggestions please send them to Matthew Farrell at matfarre@cisco.com

With CMX Analytics, people often ask how long the data is kept for.

 

The answer is "it depends", but here is some more details.

 

First, in memory we keep the ACTIVE clients list, this is the list of clients that we are actively getting data from the WLC from until the following


PURGE TIME = TIME WE LAST RECEIVED MESSSAGE FROM CONTROLLER(mac) + 600 Seconds


The second duration of devices that are kept is the location history table.


PURGE TIME = Screen Shot 2016-10-05 at 4.44.27 PM.png

Job run at Midnight for all MAC address > Days configured in History Pruning Interval.


This is the BIG table that is purged daily.


The THIRD set of purging is for REPEAT visitors.  Each MAC address is classified as a NEW or REPEAT visitor.

To do that, we need to who has been here before, for that we maintain a list of MAC addresses and say where the device has been in the ZONE at a MONTHLY level


For example, we would keep that MAC address aa:bb:cc:dd:ee:ff has been in the venue in July, August and Sept and then in the month of Jan, we would delete the data from July.


For example, this query that show over 6534 devices, over 3384 are new and 3150 are devices which have been seen more then once.


Screen Shot 2016-10-05 at 4.48.33 PM.png


Finally, when we do have analytics data about a zone, we can keep the aggregated data for a total of up to 8 years back so you can look at year one vs year two.  CMX is not that old, but the data is still there.


The only limit here is based on harddrive space.




dsladden

CMX Analytics Heatmaps

Posted by dsladden Oct 4, 2016

Author: Darryl Sladden, Senior TME Manager

Date:   October, 2016

Subject: CMX 10.2.x HEATMAPS

 

Cisco CMX Analytics has the capability to create an hourly heatmap of client activity for any floor as part of the analytics capabilities.

 

 

 

 

 

 

The heatmap is generated hourly and is in the format of a JPG image which is accessible via the GUI. As part of the GUI you can play the hourly generated heatmaps back to form an understanding of what has happened on the floor during the day.

 

The heatmap is generated by a dataset of devices that have had a locations calculated during the last hour.  It is important to note the following;

 

  • - With Standard location, a datapoint for location is generated when the client decides to send a PROBE packet out.  This is normally done when a client first enters a venue, and is done less frequently when a device is in a venue and is in a static location.  This would mean location such as lounges that have static devices may not have as many devices shown with standard location as would be shown with HyperLocation.  In addition, places where devices first encounter WIFI access points will be shown hotter.
  • - A new location is usually determined when a device has moved, as such for a large number of static devices, there will not be a lot of location calculated.
  • - With Hyperlocation, a datapoint is calculated much more frequently, approximately one time each 15 seconds.  These datapoints give a more realistic view in the heatmaps of where devices are.
  • - The data in a heatmap and the colors are based on a logarithmic scale where the specific color will not associate to a specific number.
  • - The primary uses cases for HEATMAP is as a comparison tool for two different events or two different days.  Given the same pattern of visitors the heat map would appear in the same way.

 

 

USE CASES FOR HEATMAP GENERATED WITH STANDARD LOCATION

 

  1. 1) Compare different days of the weeks to see if different days have specific times or places then a benchmark day
  2. 2) Compare different events to see if the timing of the event resulted in different enterances uses or different location of devices

 

 

USE CASES FOR HEATMAP GENERATED WITH HYPERLOCATION

 

  1. 1) Determine and compare different areas of the venue to see where CONNECTED devices are more likely to be.
  2. 2) Determine the flow of devices in and out of a venue during an event.

 

 

 

NOTE:

 

HyperLocation refers to the uses of Datapackets and if available Angle of Arrival for the determination of a client location.  HyperLocation can be accomplished with either a standard AP in Enhanced Local Mode where it scans for other clients, it can be accomplished with a dedicated monitor mode radio such as the RM3010 or, in the most advanced method is accomplished with a dedicated HyperLocation Antenna Array and a RM3010L module.

Author: Darryl Sladden, Senior TME Manager

Date:   October, 2016

Subject: CMX 10.2.x ANALYTICS Device Counts

 

Change from 10.2.0 to 10.2.2

 

REPORT AGGREGATION OF DUPLICATES

 

Reports with the selection of multiple Zones or multiple Floors in 10.2.0 DEDUPLICATE visits.  For example, when the same device visits ZONE 1 and ZONE 2.

 

With 10.2.0 it is counted as 1 VISIT in a report of ZONE 1 and ZONE 2.

 

With 10.2.2 we do NOT DEDUPLICATE visits when the same device visits ZONE 1 and ZONE 2.

 

With 10.2.2 it is counted as 2

 

This can result in the exact same report showing a much higher number of devices with CMX 10.2.2 vs CMX 10.2.0.

 

This issues occurs with a CAMPUS report if you have multiple top level CAMPUS, but is not the case if you have a single top level CAMPUS for campus level reporting.

 

If you select a report with more than one zone/floor/campus, you will have this issue.

 

The workaround is to TAG multiple CAMPUS/BUILDINGS/FLOORS/ZONE with the same TAG and report at the TAG level.

 

This change is NOT retroactive.

 

HEAT MAP CHANGES

 

In 10.2.0 there were some errors in calculating location of some devices due to heat map failure.

This resulted in devices that had not been in the venue for a long time to not be counted.

 

With 10.2.0 the total number of devices with locations calculated is lower due to this error.

 

In 10.2.2 we have corrected and expanded the HEATMAPS (an internal construct that is used for calculating how far from an AP a client is), this results in more device having a valid location calculated.

 

With this change you will see more devices that are seen for a short period of time if the AP are in public spaces.  You will need to filter devices that are seen for a short period of time if you want this removed from your dataset.   This should be done by setting the DWELL TIME FILTER to 30 mins

 

With 10.2.2 device count in analytics will be higher due to this correction.

 

This change will persist in all future releases.

 

CHANGE IN EXIT NOTIFICATION (Does not impact counts or Dwell time)

 

In 10.2.0 we exit devices from zones when a device is not reported from WLC after 20 mins.

 

In 10.2.2 we exit devices from a zone when a device is not reported from WLC after 10 mins.

 

This change will impact the DETECT and LOCATION page device counts.

 

 

FILTERING OF UNREGISTERD OUI AND RANDOM MAC ADDRESSES – MAC ADDRESS VENDOR

 

A small number of devices have unrecognized OUI and send locally administered (ie RANDOM) MAC addresses.  These should be filtered out by the location engine.  This filter remains constant in 10.2.0 and 10.2.2 and will remain the same in 10.2.3.

 

The OUI list of valid MAC addresses is updated as part of the ongoing system updates.

 

Please note, Apple devices, when they are not associated to WIFI do not send out a valid MAC addresses and are not included in PROBING device counts by default.

 

SHORT DURATION DEVICES

 

There can be a large number of short duration devices in the any CMX analytics dataset if the AP are outdoors and can hear devices that are very infrequent, such as a car driving by. The method to filter these short duration devices would be to use the DWELL TIME FILTER and set the minimum DWELL time for a report to 30 mins. 

 

 

 

 

RSSI STRENGTH FILTERING

 

The Filtering for RSSI signal strength is based on at least one AP reporting the signal at a value of which is higher than a preset value.    The default value in 10.2.0 was -128.  The default value in 10.2.2 was set to -85.  The user can configure this value to what is appropriate to the specific venues.  If the values where changed when the report was created, then you would have resulted in different values from 10.2.0 vs 10.2.2.  A recommended value for this setting in many WIFI networks is -75.

 

PRESENCE vs LOCATION ANALYTICS

 

In Presence the calculation of a VISITORS in a specific ZONE is based on the device being present in a ZONE for 8 minutes in the last 20 mins.  The device count widget also shows the total number of detected visitors. The visitors have to be in a zone for a specific length of time (configured) and at a specific signal strength.

 

 

REPEAT VISITOR COUNTS

 

There is an error in the repeat visitor count in CMX 10.2.2.  They show as 100% repeats in many cases.  This is fixed in 10.2.3. 

 

There is no workaround to correct in CMX 10.2.2

This blog was generated from CDN blog

Created by: Seetharaman Renganathan on 13-09-2010 08:00:56 AM
Hey Developers , 

Need to add Cisco Unified Presence functionality to your Context-Aware Service Application? 

Here comes the best solution for you. ContextAware  Sample application  has now been extended to support Cisco Unified Presence functionality , check out the
ContextAware_CUP Integrated Sample application.

This  Sample Application

  1)Helps you understand the integration of 2 different technologies, the ContextAware Mobility and Cisco Unified Presence,

  2)Its a simple webclient application, which gets the single/multiple user location details along with the users presence information.


This sample Application documentations can be found under the Resources section of the Context-Aware Mobility server Tech Center.
http://developer.cisco.com/web/contextaware/home

So why are you waiting still, just download this web  application & deploy in any web server like tomcat have fun to  add CUP functionality to your Context-Aware Service Application .

Regards,
Seetha
This blog was generated from CDN blog

Created by: Seetharaman Renganathan on 13-09-2010 07:39:20 AM
Hi Fellow Developers,

Are you looking for samples to help you understand the use of Context Aware API¿s?

The Context Aware technology now provides a solution to view the SOAP messages and sample JAVA source code for these Context Aware APIs. To find out more, check the MSE API LookUp Sample application.
The goal of this sample application is to demonstrate the ease of use of MSE APIs and provide SOAP messages that are ready to use.

The documentation for the Context Aware API LookUp Sample Application can be found under the Resources section of the Context-Aware Mobility server Tech Center.
http://developer.cisco.com/web/contextaware/home

Download the Context Aware MSE API LookUp Sample Application and deploy it in your web server (preferably tomcat) and have fun testing the functionalities in your Context-Aware Service Enabled Wireless building.

Thanks,
Seetha
This blog was generated from CDN blog

Created by: Seetharaman Renganathan on 21-06-2010 09:05:27 AM
Hi Fellow Developers,

Are you looking for a Cisco Context-Aware Service Sample Application to understand the use of Context Aware APIs in a real time scenario?

The Context Aware technology has created a solution to:

1. Track stolen assets like laptops, PDAs, smartphones, etc.
2. Monitor wired critical network assets, such as switches, routers, etc.

To find out more, check out the University Asset Tracker Sample Application.

The goal of this sample application is to demonstrate the following:

    *     Ease of integration with MSE.
    *     Monitor the Wireless/Wired Assets.
    *     Send notifications to external users or systems when stolen/missing assets are located.
    *     Send notifications  to external users or systems when wired assets are no longer detected on the network.

The University Asset Tracker is a simple web client application, which tracks down the stolen assets when they reappear on the university network.

This application is supported in two formats:

1.    CISCO_University_Asset_Tracker.exe for windows, it supports the following versions of windows.

    * Windows XP
    * Windows 7
    * Windows Vista

2.    CISCO_University_Asset_Tracker.bin for Linux, it supports Linux with UI enabled option.

The documentation for the University Asset Tracker Sample Application can be found under the MSE Context Aware platform Sample Application section of the Context-Aware Mobility Tech Center.

Download the University Asset Tracker Sample Application and deploy it in your web server (preferably tomcat) and to start testing the functionalities in Context-Aware Service.

Thanks,
Seetha
This blog was generated from CDN blog

Created by: Prabhu Punniamurthy on 09-02-2009 10:25:33 AM
Hey Context-Aware API developers , are you confused or not sure how to start with Context-Aware Mobility APIs?

Here comes the best solution for you, Popular Integrated Development Environment(IDE) such as Eclipse and Microsoft Visual Studio has now been extended to support Context-Aware APIs .

These IDE Plug-ins will

  • Reduces the initial learning of Development Environment
  • Simplifies application integration
  • Accelerate partners adoption of Cisco Wired/Wireless technologies
  • Provides Features such as Templates , Code Snippets and InteliiSense /Starter Kits
  • Auto generation of codes
IDE Plug-ins and their documentations can be found under the Resources section of the Context-Aware Mobility Tech Center.

So why are you waiting still,  just download these pug-ins and have fun in playing with the Context-Aware APIs .

Regards,
Prabhu

Filter Blog

By date:
By tag: