The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The Cisco Connected Mobile Experiences (Cisco CMX) DETECT & LOCATE service enables you to view and track devices in your deployment.
Using the DETECT & LOCATE service, you can either view all the access points (APs) deployed in all the buildings of a campus or view the APs deployed on the individual floors of each building. You can also locate Wi-Fi tags, Wi-Fi interferers, and Bluetooth low energy (BLE) Tags.
In order to use the DETECT & LOCATE service, the following initial configurations have to be performed:
Import maps—For information about this, see Importing Maps and Cisco Wireless Controllers.
Add controllers—For information about concept, see Adding Controllers.
 Note |
To enable DETECT & LOCATE service, run the cmxctl enable location command followed by the cmxctl start -a command. |
|
Step 1 |
Log in to Cisco Connected Mobile Experiences (Cisco CMX). |
||||||||||||
|
Step 2 |
Click DETECT & LOCATE. |
||||||||||||
|
Step 3 |
Using the left pane of the Activity Map window, navigate to the desired building and floor.  |
||||||||||||
|
Step 4 |
Choose any combination of the following icons to customize your view of the devices:
|
Associated clients probe less in the network to save battery power and this prevents Cisco CMX to track them efficiently. This behavior is more significant with the static associated clients and determining their location in the absence of probes becomes more challenging to Cisco CMX.
The following is a list of additional improvements done in this area to better track the ability to track such static associated clients:
Cisco CMX would leverage the Associated AP information location from the maps and use that as the primary location for the associated client. This can be identified by checking the Compute Type field and it display the value as Associated AP. For taking benefit from this feature, ensure that the Cisco CMX map has all the Access Points information, so that Associated AP location would be available to Cisco CMX.
After the associated device sends the regular probe, its location would be determined from the reported APs and the Compute Type field would be set to RSSI or AoA depending on the source of the location.
Note |
This feature is disabled by default. |
Cisco CMX would poll the Associated Clients information periodically every hour. This feature is enabled by default.
To poll the Associated Clients on demand, run the cmxctl config pollconnectedclients info command.
The following example shows how to poll an associated client:
icon to show or hide all the client devices (connected and detected) that are being tracked by your Cisco CMX. Client devices
are displayed either as red dots (probing clients) or green dots (connected clients). Clicking on connected clients show the
AP that the client is associated with (blue lines) and the APs that are participating in the location calculation (red lines),
and while clicking on a probing of unassociated client displays the APs that are being used to detect the clients (red lines).
icon to show or hide areas with varying concentrations of client devices. Areas with a high concentration of client devices
are marked bright red, as shown in this figure.
icon to show or hide the zones on a specific floor.
icon to show or hide all the APs that have been deployed on a specific floor. APs are displayed as circular objects, with
a number in the center. This number indicates the number of clients connected to that specific AP. Inactive access points
(red circle with a hyphen) are also detected when there is no RSSI probe packets coming to Cisco CMX. Inactive APs are detected
usually in the following scenarios:
icon to show or hide all the RF interferers that have been detected by the wireless network, and their zone of impact.
icon to show or hide the rogue access points. Rogue access points are those access points that are not part of the Cisco
CMX infrastructure access points and not managed by Cisco CMX. They are classified as Unclassified, Malicious, Friendly, and
Custom and indicated by different colors on the Activity Map. Cisco CMX uses the pre-defined zone of impact (3.28 feet) for
all rogue aps. This happens because Cisco CMX does not receive the Transmit Power (Tx) information from controller which is
needed to compute zone of impact dynamically.
icon to show or hide rogue clients. Rogue clients are clients connected to rogue access points.
icon to show or hide BLE-transmitting devices that have been detected by the wireless network.
icon to show or hide Wi-Fi tags. The vendor specific information related to the tags are displayed in raw format.
icon to filter the display of devices based on parameters such as Connection Status, Manufacturer, and Service Set Identifier
(SSID).
icon to view the inclusion and exclusion regions on a floor. The inclusion and exclusion regions are created in Cisco Prime
Infrastructure. In Cisco CMX, you can view these regions, but you cannot modify them. The inclusion regions are shown in green,
and the exclusion regions are shown in gray.
[cmxadmin@server]# cmxctl config pollconnectedclients info
+--------------+---------+
| Controller | Status |
+--------------+---------+
| 10.22.243.39 | Success |
+--------------+---------+
To enable enahnced associated clients tracking, follow the steps:
|
Step 1 |
To set the featureflag configuration, run the following command: cmxctl config location.computelocthroughassociatedap true |
|
Step 2 |
To restart Cisco CMX agent, run the following command: cmxctl agent restart |
|
Step 3 |
To stop location and NMSP services, run the following commands: cmxctl location stop cmxctl nmsplb stop |
|
Step 4 |
To start location and NMSP services, run the following commands: cmxctl location start cmxctl nmsplb start |
|
Step 1 |
Log in to Cisco Connected Mobile Experiences (Cisco CMX). |
|
Step 2 |
Click DETECT & LOCATE . |
|
Step 3 |
Using the left pane of the Activity Map window, navigate to the desired building and floor. The Activity Map window displays a list of icons to the right. |
|
Step 4 |
Click the corresponding icon to show the desired devices, for example, client devices, APs, beacons, and so on. |
|
Step 5 |
Click the corresponding device on the map. A pane displaying details of the device, such as MAC address, IP address, status, and so on is displayed. |
The DETECT & LOCATE service enables you to configure the refresh rate for clients’ position on a floor map. The refresh interval can be used to configure how frequently a client’s positions will be polled to determine their positions. The default refresh rate is five seconds. The refresh rate gets automatically reset when you navigate to another tab or log in again. The client refresh rates are temporary and is not stored in the CMX.
|
Step 1 |
Log in to Cisco Connected Mobile Experiences (Cisco CMX) either as an admin user or a user with Location role. |
|
Step 2 |
Click DETECT & LOCATE . |
|
Step 3 |
Using the left pane of the Activity Map window, navigate to the desired building and floor. The Activity Map window displays a list of icons to the right. |
|
Step 4 |
Click the Gear icon to configure the client refresh rate. |
|
Step 5 |
Use the + or - icon to increase or decrease the client refresh rates. The refresh rates are in seconds. The range is one to 30 seconds. |
|
Step 6 |
Click OK . The client, represented by dots on the map, will be refreshed with the new configured rate. |
|
Step 1 |
Log in to Cisco Connected Mobile Experiences (Cisco CMX) either as an admin user or a user with Location role. |
|
Step 2 |
Click DETECT & LOCATE . |
|
Step 3 |
Using the left pane of the Activity Map window, navigate to the desired building and floor. The Activity Map window displays a list of icons to the right. |
|
Step 4 |
Click the corresponding icon to show the desired devices, for example, client devices, APs, beacons, and so on. The more icons you click, the more filtering options are enabled. |
|
Step 1 |
Log in to Cisco Connected Mobile Experiences (Cisco CMX). |
|
Step 2 |
Click DETECT & LOCATE . |
|
Step 3 |
Using the left pane of the Activity Map window, navigate to the desired building and floor. The Activity Map window displays a list of icons to the right. |
|
Step 4 |
Click the corresponding icon to show the desired devices, for example, client devices, APs, beacons, and so on. The more icons you click, the more filtering options are enabled. |
|
Step 5 |
Click the
Filter |
|
Step 6 |
In the Filters dialog box that is displayed, you can add or remove client filters based on the following parameters:
|
|
Step 1 |
Log in to Cisco Connected Mobile Experiences (Cisco CMX). |
||
|
Step 2 |
Click DETECT & LOCATE . |
||
|
Step 3 |
Using the left pane of the Activity Map window, navigate to the desired building and floor. |
||
|
Step 4 |
In the Search field of the Activity Map window, enter any of the following parameters to search for or filter a desired device:
|
The Client Playback feature enables you to locate and track the movement of clients in a venue. You can track the activity of one client at a time.
Note |
(CSCvn33059) When you click the Client movement history playback icon on the window, you can select a day—up to 30 days from the current date—to track the history of a client. This window of 30 days is independent of the Data Retention - Client History Pruning Interval. |
|
Step 1 |
Log in to Cisco Connected Mobile Experiences (Cisco CMX). |
|
Step 2 |
Click DETECT & LOCATE . |
|
Step 3 |
Using the left pane of the Activity Map window, navigate to the desired building and floor. |
|
Step 4 |
Search the client you want to track using the its MAC ID. For more information about how to search client devices, see Searching for a Device. |
|
Step 5 |
Click the
Client
Movement History Playback icon The Client Playback (see the image below) pane is displayed .
|
|
Step 6 |
Click the Play icon to start client playback. |
In Europe, a new law, General Data Protection Regulation (GDPR) is in force effective May 25, 2018. GDPR intends to strengthen and unify data protection for individuals.
Cisco CMX 10.5 introduces the Data Privacy feature to be compliant with the GDPR requirements. This feature allows Cisco CMX to ensure data protection by not disclosing clients details such as MAC address, username, and IP address.
Note |
By default, the Data Privacy feature is disabled. |
The Data Privacy feature works with the Mac Hashing On/Off options. This feature is applicable only for wireless clients. Other connected devices such as interferers, rogue clients, and RFID and BLE tags are not affected. When Data Privacy feature is enabled, Cisco CMX will not process client username, IP address, and will not determine the device manufacturer from the mac address of the device.
Mac Hashing On—Cisco CMX hashes MAC address of all the clients. As a customer you need not explicitly opt to record the consent for this action. Active client count on the Cisco CMX Detect and Locate dashboard and Systems Service Dashboard will appear as double the actual number for the initial 5 to 10 minutes when clients already exist. After this duration, the active client count resumes to the correct count.
If MAC Hashing is on, the MAC addresses of all the clients are hashed on the nmsplb service, and the location computed with the hashed MAC addresses.
Mac Hashing Off—You must enter the MAC address of all the devices that have a location calculated manually to Cisco CMX. Alternatively, Cisco CMX can fetch the details from a CMX Connect interaction where a customer explicitly accepts the Terms and Conditions that allow customers' MAC address to have a calculated location associated with them. All Analytics and Connect data is based on the data from MAC addresses in which specific tracking has been enabled. If a customer does not explicitly approve, or a MAC address is not manually entered, Cisco CMX does not record the location of that MAC address.
After enabling Data Privacy, you can choose to delete all the history data by using the cmxctl config data deleteAll command. You may have to restart Cisco CMX if you delete history data.
The Data Privacy feature has 4 components:
Mac Hashing—If Mac Hashing is turned on, you must input the SALT value (alphanumeric text used to safeguard passwords in storage) that is being used to anonymize the real MAC addresses. This is referred as current SALT. Cisco CMX uses the SHA1 one-way cryptographic function for MAC hashing. This helps to protect the user identity and the real MAC addresses are not stored in Cisco CMX. The Opt In client list is not checked in this mode and all client devices are tracked.
You can specify a future date as SALT. Cisco CMX runs a job that checks for the SALT to be applied for that particular day. If a new SALT is available, this is used for MAC hashing. Cisco CMX requires the current SALT if MAC hashing is turned on.
Opt In—This is used to collect user consent. As a Cisco CMX admin, you can decide the way you want to collect the consent. Cisco CMX stores the Location and Analytics consent separately. Also, because the Location service is the single source for Analytics data, devices that have not given consent for Location tracking will not be tracked for Analytics too.
Note |
Consent is stored in the database, and unless explicitly removed, will always be available in the system. |
Data Retention—This offers a configurable way to retain or purge long-live data such as location history and analytics raw data. When the Data Privacy feature is turned on for the first time, the database contains the real MAC addresses. As an administrator, you can decide to either back up the data and then purge it or directly purge it. Run the cmxctl config data delete command to purge this data. Restart the Cisco CMX after purging the data.
Disk Encryption—Cisco CMX 10.5 supports CentOS7. You cannot upgrade to Cisco CMX 10.5.x from releases earlier than Cisco CMX Release 10.5. You must install and depoly the Cisco CMX 10.5.x OVA or ISO file on your system. For more information, see the Cisco Mobility Services Engine Virtual Appliance Installation Guide for Cisco CMX Release 10.5 at:
The CMX Grouping feature (formerly known as AP Grouping) allows Cisco CMX to form an Access Point (AP) group consisting of all the APs learned from maps.
Note |
By default this feature is disabled. |
The CMX Grouping feature helps to improve Cisco CMX performance in the following scenarios:
Cisco CMX learns about the APs from the maps to compute the APs' location. However, in some instances, Cisco CMX will not have all the APs from the controller. In such a scenario, Cisco CMX will have to discard the RSSI probes received from the APs that are not available on maps.
For Hyperlocation, Cisco CMX supports 1000 APs. Only 1 Cisco CMX with Hyperlocation enabled can be added to the controller. However, a large controller such as a Cisco 8500 Series Wireless Controller, managing 15,000 APs, has a lot to offer.
Cisco CMX supports the exclusion of probing clients filter. This indicates that Cisco CMX discards the RSSI probes that is used for probing clients. However this filtering adds significant load on Cisco CMX when the probing clients are too many.
In Cisco WLC 8.7 or later, Cisco CMX communicates about the AP group to the controller, and the controller sends NMSP and UDP data for APs participating in the group. In Cisco WLC 8.7 or later, support is added to send only the required NMSP data to Cisco CMX. Note that Cisco CMX can subscribe to NMSP data of specific APs or AP groups based on the active services in Cisco WLC.
The performance of Cisco CMX can be optimized in the following ways:
Cisco CMX will not receive the NMSP and UDP data for the APs that are not available on maps.
This helps Cisco CMX to form AP groups uniquely (no AP should be duplicated across AP groups) to receive the Hyperlocation data, which in turn helps leverage Cisco WLC's capacity to full extent.
When exclude probing client filter is enabled, Cisco WLC 8.7 and later perform filtering and will do not send the NMSP data to Cisco CMX.
For more information on how Cisco WLC supports NMSP by AP Groups, see the "NMSP by AP Groups with Subscription List from CMX" section in the Cisco Wireless Controller Configuration Guide.
This figure shows a sample architecture of a Cisco CMX Grouping:
 Tip |
One important requirement for Cisco CMX grouping to work is that AP groups must always contain unique APs. This means that no AP should be repeated across the AP groups. If you have same APs in multiple AP groups, you must correct this error manually. |
Note |
Caveats CSCvj54236 and CSCvi63871 provide information about Cisco WLC 8.7 and 8.7 special have limitations identified with respect to Cisco CMX. Cisco CMX Grouping does not work with hyperlocation deployments because of these limitations. The CMX Grouping feature only supports wireless clients. Rogue clients are not supported. |
|
Step 1 |
Enable the Cisco CMX Grouping feature by entering this command: cmxctl config feature flags nmsplb.cmxgrouping true
|
||
|
Step 2 |
Restart Cisco CMX by entering this command: cmxctl restart agent |
||
|
Step 3 |
Stop the Load Balancer service, used for NMSP messages to Location services by entering this command: cmxctl nmsplb stop |
||
|
Step 4 |
Restart the Load Balancer service used for NMSP messages by running this command:cmxctl nmsplb start To verfiy if the CMX Grouping feature is enabled, run the cmxctl config featureflags command and verify the value for nmsplb.cmxgrouping. In WLC 8.7 and later, run the show nmsp subscription group detail services <ip address> CMX_<ip address> command to verify the subscription. In the command, replace <ip address> with your Cisco CMX IP address. |
The Cisco Hyperlocation solution is a suite of technologies that enables advanced location capabilities through a mix of software and hardware innovations. The Cisco Hyperlocation Solution substantially increases the location accuracy for connected clients of the Connected Mobile Experiences. The FastLocate technology boosts the refresh rate so CMX captures more location data points. And the Angle-of-Arrival capabilities increases location accuracy to as close as one meter (50% Error Distance). The improved accuracy provides more granular analytics data compared to RSSI based location.
Cisco CMX Release 10.2.1 supports the Angle of Arrival (AoA) technology available on Cisco Aironet 3600, 3700, and 4800 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 up to one meter accuracy in an optimal deployment.
Cisco Hyperlocation is an enhanced location solution that takes advantage of the specialized hardware that is available on the Cisco Aironet 4800 Series wireless Access Points. It uses Angle-of-Arrival of Wi-Fi signals to determine the location of connected mobile devices. For more information about best practices to follow when deploying the AP4800 Hyperlocation solution, see https://www.cisco.com/c/en/us/td/docs/wireless/controller/technotes/8-8/b_ap_4800_hyperlocation_deployment_guide.html.
The Cisco Hyperlocation module with advanced security also integrates Bluetooth Low Energy (BLE) beacons with the module. Customers can take advantage of 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 module enabled the capability for a single AP to beacon out five different BLE values to trigger different consumer applications.
Cisco CMX FastLocate technology enables quick location refresh for connected Wi-Fi clients. RSSI from data packets and probe frames, when available, are used for calculating a location. This technology is available with both centrally switched WLANs and FlexConnect (locally switched WLANs).
The following Wi-Fi6 access points support Cisco FastLocate:
Cisco Aironet 9120 Series Access Points
Cisco Aironet 9130 Series Access Points
The following access points support Cisco FastLocate:
Cisco Aironet 2800 Series Access Points
Cisco Aironet 3800 Series Access Points
Cisco Aironet 4800 Series Access Points
Cisco Aironet 700, 1700, 2600, 2700, 3600, 3700 and 2800 APs support Cisco CMX FastLocate when used with Cisco WLC Release 8.1.123.0 or later. Cisco Aironet 3800 APs support Cisco CMX FastLocate when used with Cisco WLC Release 8.7.102.0 or later.
Accuracy results for the Cisco FastLocate feature are reflected in the Cisco CMX Accuracy Tool under the 50% and 75% Error Distance columns. Accuracy is considered good if the distance displayed under those columns is 10 meters or less, meaning the client will be detected less than 10 meters from its actual position. For information about configuring Cisco FastLocate, see “FastLocate for Cisco Wave 2 Access Points” section in the Cisco Wireless Controller Configuration Guide, Release 8.6 at:
Note |
|
The following 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—APs scan on 2.4 and 5 GHz bands.
Modular Mode—Cisco 3600 and 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.
Note |
|
|
Step 1 |
Log in to Cisco Connected Mobile Experiences (Cisco CMX). |
||
|
Step 2 |
Choose SYSTEM > Dashboard . |
||
|
Step 3 |
Click the Gear icon at the top-right corner of the window. |
||
|
Step 4 |
Click the Location Setup tab. |
||
|
Step 5 |
In the Location Calculation Parameters window, check the Enable Hyperlocation / FastLocate/ BLE Management check box. |
||
|
Step 6 |
Add Cisco WLC to Cisco CMX.
|
Cisco CMX Release 10.4 now supports a mixed deployment of Cisco Hyperlocation access points (AP) and non-Hyperlocation AP on the same floor map. If the client is associted to a regular access point but has a hyperlocation enabled access point near by, AoA computation is performed to provide an an acceptable accuracy. All Cisco Hyperlocation APs must be within a contiguous area. Increased accuracy on the floor is only within the convex hull of the Hyperlocation contiguous are
Hyperlocation groups are formed consisting both hyperlocation and regular access points. The floor mode is decided when generating the hyperlocation group. There following are the three supported modes:
RSSI mode-All access points on the floor are regular APs.
Mixed mode: Few APs on the floor are Halo APs.
Note |
Use the cmxctl config hyperlocation mixmodeFloor ID command to enable hyperlocation mixed mode. We recommend that you use this command in a deployment senario where there are both Hyperlocation enabled APs and non Hyperlocation APs on the same floor map. The improved location accuracy that comes from the use of Hyperlocation AP will occur within the convex hull of the Hyperlocation APs. Outside of this convex standard location accuracy results will occur. At the edges of the convex hull there may also be lower accuracy then when clients are at least 10M inside of the convex hull. This command does not support the interspersion of Hyperlocation AP with non Hyperlocation AP. If this is type of deployment is used, then there will be no improvement in location over standard probe RSSI based location. An example of an supported deployment is as follows:  |
Halo mode: All APs on the floor are Halo APs.
Hyperlocation Diagnostics is a tool that can find common issues in a Hyperlocation deployment.
Hyperlocation Diagnostics executes a set of tests to verify any common issues with Hyperlocation. These tests are executed against an existing Hyperlocation setup on a floor. The floor should have clients associated to Hyperlocation access points to validate complete functionality.
|
Step 1 |
Log in to Cisco Connected Mobile Experiences (Cisco CMX) either as an admin user or a user with Location role. |
|
Step 2 |
Choose . The Hyperlocation Diagnostics window is displayed. As this is a floor-level test, select a building and floor. Note that only floors with hyperlocation access points are populated here.  |
|
Step 3 |
(Optional) Add the details and credentials of a controller and an access point for a more detailed report.  |
|
Step 4 |
Click Run Diagnostics and wait for a few minutes.
|
|
Step 5 |
Observe a sample test result. The Test Type indicates which deployment component is being tested, and it can be CMX, WLC, or AP.  |
|
Step 6 |
If a test has failed, click Fix Issue for instructions on how to resolve the issue.  |
|
Step 7 |
Expand a passed test result to see further details of the test.  |
|
Step 8 |
If the Check AoA messages increasing for access points test has failed, expand the test. This may happen if there aren’t clients to communicate with the access point, and hence the message count does not increase.
|
|
Step 1 |
Open the CMX Dashboard, Detect and Locate>Troubleshooting. As this is a floor-level test, select a building and floor. Note that only floors with hyperlocation access points are populated here. |
||
|
Step 2 |
Click View Hyperlocation Groupings to configure a different primary for a slot.
|
||
|
Step 3 |
Click a frequency band, and select a slot. You can observe the primary access point for the site marked by M, and the subordinates marked by S. You can also change the primary to a more appropriate one in this page. 
|
||
|
Step 4 |
Observe details of the primary access point of a slot, like bandwidth, channel and client count. 
|
||
|
Step 5 |
Observe the distance of a subordinate AP from the respective primary. 
|
||
|
Step 6 |
Observe that each slot has an allocated time which is listed below the slot. There are also two frequency bands, 2.4 and 5 GHz, each with scan times. Scan time is the total time allocated to scan every slot of a band at least once. Since there are two such bands, 2.4 and 5 GHz, the total Refresh time is the sum of these two, and is the time taken to scan all slots of all bands.  |
Probing clients count is usually more visible on CMX than compared to Wireless LAN Controller (WLC). WLC tracks the clients until the client no longer probes for more than five minutes, whereas CMX maintains the probing client for 10 minutes.
Connected Clients do not have this behavior because, WLC notifies CMX when the clients are disconnected from the network. You can perform additional configuration changes on CMX, if you want to minimize the probing client count on CMX.
 Caution |
An administrator user should not change the sensitive parameters without Cisco's instructions and contact Cisco TAC or BU escalation to decide the appropriate operation. We do not recommend to set the value less than five minutes because some clients may not sent probe and in that case CMX will lose such clients. This configuration change could also increase the Analytics service processing time. |
|
Step 1 |
Log in to Cisco Connected Mobile Experiences (Cisco CMX). |
||
|
Step 2 |
Click DETECT & LOCATE. |
||
|
Step 3 |
Choose SYSTEM > Settings > Filtering. |
||
|
Step 4 |
Specify the RSSI Cutoff value as -75.
|
||
|
Step 5 |
Navigate to /opt/cmx/etc/ and open the node.conf file. |
||
|
Step 6 |
To set the expiry time, at the end of the Location Services section, add user_options=-Dredis_ttl=5.
|
||
|
Step 7 |
To restart the CMX agent, run the command cmxctl agent restart . |
||
|
Step 8 |
To restart the Location Services, run the command cmxctl location restart . |
The following table lists the Cisco CMX 10.5 Location features and the APs that support these features:
|
Location Feature |
Supported Marvel-Based Cheetah Access Points |
Supported Cisco IOS Access Points (2700, 3700, 3600) |
|---|---|---|
|
FastLocate |
2800, 3800 |
2700, 3700, 3600 |
|
Hyperlocation |
4800 |
3602E and 3702E with HALO radio module 3010 (RM3010L) |
|
Hyperlocation Mix mode |
HALO (3602E and 3702E with HALO radio module 3010 - RM 3010L) and non-HALO (all Cisco IOS) |
|
|
Tuna antenna support |
Not supported |
3602E, 3702E |
|
BLE |
Integrated BLE: 1800, 1810, 1815, AP1542 (Outdoor) 5 dynamic beacons for AP 4800. Floor beacons are available as beta version only. |
Not supported |
From Cisco CMX 10.2, you can perform a location accuracy test for a single device with multiple location points. You can use the Location Accuracy Test tool to validate the placement and number of access points to ensure that the CMX deployment is giving the best location accuracy experience. The Location Accuracy tool provides an administrator the ability to quantify the location accuracy for a specific location by using a Wi-FI device to measure the difference between the actual and calculated location of a device
To run a location accuracy test, perform the following task:
|
Step 1 |
Log in to Cisco Connected Mobile Experiences (Cisco CMX). |
||
|
Step 2 |
Click DETECT & LOCATE . |
||
|
Step 3 |
Using the left pane of the Activity Map window, navigate to the desired building and floor. |
||
|
Step 4 |
Use the search option on the Activity Map window to search for a device, for example, Client, RFID Tag, or BLE Tag. In this task, we will choose a client. |
||
|
Step 5 |
Click the corresponding connected client, indicated by a green dot.  The Client dialog box is displayed. |
||
|
Step 6 |
Click the
LOCATION ACCURACY
TEST |
||
|
Step 7 |
In the Enter a test name text box, type a name for the location accuracy test, and then press the Enter . A dialog box,
asking you to place the
|
||
|
Step 8 |
Drag the marker to the correct position.  |
||
|
Step 9 |
Click Run .  |
||
|
Step 10 |
Refresh your client frequently so that it exchanges information with the access points around it. |
||
|
Step 11 |
Click Pause when you finish testing of the current location. |
||
|
Step 12 |
After you complete testing all the location points, click Finished? View Result to fetch the test results. A dialog box, showing 10 m accuracy and Average Error Distance is displayed.   |
||
|
Step 13 |
Click
View accuracy test
report
The Location Accuracy Test window is displayed with the test details such as test name, status, MAC address, floor, start time, location computation frequency, measurements on correct floor (in percentage), accuracy and error distance. Click Export All to export the test results as CSV files. 
|
||
|
Step 14 |
Analyze the test results. |
Observe the test results in the figure below.
The test results displayed indicate that for 100% of the time, Cisco CMX locates the client within this many meters from where the client is actually located.
It also indicates that for 50% of the time, Cisco CMX locates the client within this many meters from where the client is actually located. A good location accuracy test result for an RSSI deployment is 10 meters, and should be within 10M for FASTLocate with update rate of better then 1 update per 30 seconds.
Location Accuracy testing is not supported on Axel-E APs with external antennas (for example, Marlin 1,2,3,4). However, Location detection is supported on Axel-E APs.
Observe the complete location-accuracy test below:
Ensure that Measurements on Correct Floor should be at 100%. This is an indicator of whether the client has been detected by the access points on the same floor, and not on a different floor. You can delete the test and the corresponding log files using the cross buttons here.
Client diagnostics is a way to understand whether the tested client is sending messages to Cisco CMX for location-accuracy calculations.You can view Client Diagnostics during the location accuracy test.
It is best to ensure that all the tests here are in Passed status.
You can also email a summary of the messages to your Technical Support department for troubleshooting. Given below are some of the outputs of individual tests.
This task analyzes the Location Accuracy log files stored in /opt/cmx/srv/location/accuracy.
|
Step 1 |
Telnet into the CMX box and navigate to the /opt/cmx/srv/location/accuracy directory where location accuracy results are stored by default.  |
|
Step 2 |
Navigate to the folder named after your test.  |
|
Step 3 |
Navigate into the logs folder, where the log files are stored.  |
|
Step 4 |
Use the grep command to find entries with COMPUTE in this log file. The following is a sample output that is displayed. You can see new entries added to the log file, while the location-accuracy test is performed. Activate your device to see the addition of fresh entries.  |
You can also run Location accuracy tests to test the efficiency of your hyperlocation deployment. Run the test from the Map Tab of Detect and Locate. Here are some points that will help improve the test results.
As samples are collected every 3-5 seconds, set the refresh rate of the dashboard to five minutes before running the test.
A good location accuracy result for a hyperlocation deployment has an Average Error Distance of around one meter.
Convex hull is the perimeter formed by drawing lines connecting 3 or more APs in a AP group. Ensure that a test client is within the convex hull of an AP group.
Do not choose a client that is in a spot between AP groups, our outside the convex hull of AP groups.
You can use the Location Accuracy test to calculate latency in a Hyperlocation deployment. This is especially useful if you would like to know when clients visit your store in order to send personnel to greet them. You can find the latency by moving a test client, and observing how many seconds it takes for your Cisco CMX location accuracy dashboard to update itself with the new client location. Usually, it takes around 2-3 seconds to update its location. Ideally, latency should not be more than 5 seconds for a hyperlocation deployment.
You need at least one connected client for accuracy testing. Creating a 5 GHz only WLAN SSID will ensure you have the most accurate location test.
Accuracy testing is done with a static device. Make sure your test points are inside the convex hull of your AP coverage. It is recommended to collect 25-50 samples per point. Repeat the test in multiple locations throughout your coverage area. Accuracy tests will not improve location accuracy as the results will not be used for any kind of calibration. You might want to use different clients at the same location to understand the client impact on accuracy.
Choose a client for your accuracy test
Pick multiple points across your venue, note the X, Y of your test points
Execute the test on each of the points and collect 25-50 measurements per point
Finish the test and review the test results
You can execute the tests using GUI or CLI. GUI is a bit more comfortable, while CLI gives you a few more details while the test is executed.
To execute accuracy tests, via the GUI on CMX navigate to the Detect & Locate tab. Selecting the client (green dot on the map) will expand the Client details pane on the left. Use the pin icon to start the test. The number of samples will be updated. After collecting enough sampled click pause and then finish to end the test.
Test results can be viewed by clicking on the green icon .
You need the X, Y of your test points. You can use the CMX GUI Detect & Locate tab, select the map and move your mouse pointer to the test point, you can read the X and Y coordinates on the bottom right of your map.
Login using console or SSH to your CMX. To start a location accuracy test, use the cmxloc start command. You will be prompted to enter the client MAC address, a test name and the X, Y of the real location. You can also select the duration of the test.
During the test you will see the computation method of each data point: RSSI, AoA or FUSION.
To view the test results, use the cmxloc list, cmxloc download can be used to prepare a zip file which is helpful for troubleshooting. Use the provided URL, replace the server_IP with the IP of your CMX server to download the zip file.
On CMX GUI navigate to Detect & Locate and click the green icon to view the test results table.
The table shows the following columns:
Test: allows you to relaunch, download and send an e-mail with the test results
Name: Name of the test
Status: running, paused or finished. You can pause and finish a running test from here.
Mac Address of the test device
Floor of the accuracy test
Start Time of the test
Location Computation Frequency: Average time between location updates / calculations during the test. Should be better than 10s for Hyperlocation
Measurements on Correct Floor in %: In some situation, especially when there are atriums / open ceilings the client will be detected from APs on other floors as well and the algorithm might choose the wrong floor
10m Accuracy in %: How many of the calculations are within 10 meters of the real location during the test
Average distance error in meters: averaged location error during the test
90% / 75% / 50% error distance in meters: This indicates the radius of 90% / 75% and 50% of the calculated locations around the real location. Good deployments should be in the range of 1-3m for the 50% error distance
.
icon to start the location accuracy test.
icon on the top-right corner of the window to view the list of accuracy tests
that you performed. This report enables you to restart a test, download the
latest log or all logs, or email the test results.
Feedback