Release Notes for Cisco CMX Release 10.4.x
Introduction to Cisco CMX Release 10.4.x
Resolved Caveats in Cisco CMX Release 10.4.1-34
Resolved Caveats in Cisco CMX Release 10.4.1-15
Resolved Caveats in Cisco CMX Release 10.4.1-2
Resolved Caveats in Cisco CMX Release 10.4.0
Communications, Services, and Additional Information
First Published: November 27, 2017
This document describes what is new and important in Cisco Connected Mobile Experiences (Cisco CMX) Release 10.4.0 and later, and provides the system requirements and caveats. Unless otherwise noted, Cisco Connected Mobile Experiences is referred to as Cisco CMX in this document.
Explore the Content Hub, the all new portal that offers an enhanced product documentation experience.
Get started with the Content Hub at content.cisco.com to craft a personalized documentation experience. Do provide feedback about your experience with the Content Hub.
Cisco CMX Release 10.4.x is a high-performing scalable software solution that addresses the mobility services requirements of high-density Wi-Fi deployments.
This release is suitable for deployments where the following features are required:
This release is not suitable for deployments where the following are required:
This release provides critical bug fixes. No features were added or enhanced. We recommend this release to all Cisco CMX users. |
This release provides critical bug fixes. No features were added or enhanced. We recommend this release to all Cisco CMX users. |
Cisco CMX Release 10.4.x can be installed on the Cisco MSE 3365 platform.
Note Cisco CMX Release 10.4.x and later does not support the Cisco MSE 3355 platform.
Cisco CMX Release 10.4.x can be installed as a Virtual Cisco MSE appliance, which requires either VMware ESXi 5.1 to ESXi 6.5 versions, or Microsoft Hyper-V. For information about installing a Cisco MSE Virtual Appliance, see the Cisco MSE Virtual Appliance Installation Guide at: https://www.cisco.com/c/en/us/support/wireless/connected-mobile-experiences/products-installation-guides-list.html
Table 5 lists the Cisco CMX Release 10.4.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 at: https://www.cisco.com/c/en/us/solutions/enterprise-networks/connected-mobile-experiences/white-paper-listing.html
Note ● Before you deploy Cisco CMX, we strongly recommend that you refer to the VM sizing guidelines described in the Cisco CMX Dimensioning Calculator at: http://calculator.cmxcisco.com/aspnet_client/system_web/2_0_50727/CMX_calculator_v2.07/CMX_calculator_v2.07.aspx
Note If you are using Google Chrome version 72 or above, we recommend that you use Mozilla Firefox as your browser, or downgrade to Google Chrome version 63.
Note By default, Cisco Prime Infrastructure maps—including client location and client counts—refresh every 2 minutes. To manually refresh, click Refresh on the user interface.
|
||
Cisco Prime Infrastructure performs the Cisco CMX API query when the Cisco Prime Infrastructure Map page is displayed. |
Two weeks before the evaluation license expires, you will receive a daily alert to obtain a permanent or term 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 or term license and regain access to it.
– Option 1: Copy the Cisco CMX image to the Cisco CMX node, and then use the cmxos upgrade < cmx-file > command from the command line to perform the upgrade.
– Option 2: Use the web installer on port 1984, and choose Remote File to download the Cisco CMX image from a hosted site, for example, the Cisco CMX image could be placed on an internal web server for the download.
– Option 3: Use the web installer on port 1984, and choose Local File to upload the Cisco CMX image from your local machine through the web browser.
Note We recommend that you use Option 1.
With Option 3, the upload of the Cisco CMX image might fail. This is due to a memory leak in a third-party library used in the installer. However, this library is fixed in subsequent versions of the installer.
However, if you chose Option 3 and the upload fails, restart the installer program by using the cmxos adminui stop command and then the cmxos adminui start command. Option 3 might succeed after several tries.
– We recommend that you run Cisco CMX Release 10.4.x in parallel with the existing Cisco MSE Release 8.0 or earlier, and utilize the evaluation license for 120 days. After the evaluation period, the older Cisco MSE release can be decommissioned.
– No database migration or inline upgrade is supported from Cisco MSE Release 8.0 or earlier to Cisco CMX Release 10.4.x.
– To use the Cisco CMX Connect portal page in HTTP, disable the SSL mode by entering the cmxctl node sslmode disable command.
– If SSL is enabled and you enable HTTPS for Cisco CMX Analytics (generally, Cisco CMX as a whole), make sure that a valid SSL certificate is installed. Otherwise, slower UI performance will occur.
If you do not have a valid SSL certificate to install, you need a self-signed certificate.
If neither a valid SSL certificate nor a self-signed certificate is present, Cisco CMX Analytics might not work as expected.
This is because the Cisco CMX agent cannot start the Matlab package. Use the following commands to resolve this:
Blocked writes to the Cassandra database can result in errors in Cisco CMX, such as this analytics error message:
You can prevent untimely memtable flushes by scheduling the flush during off-peak hours and running the /opt/apache-cassandra-2.1.13/bin/nodetool flush command.
If an imported floor map image is not an RGB/Truecolor image, Cisco CMX might take longer to prepare its image tiles, causing the floor map image to not display immediately after being imported. While the tiling process is in progress, the Detect & Locate window displays this warning message: This image is currently being processed, it will be ready for viewing shortly
.
The average time for a failover condition is 7 minutes, depending on your systems.
The failback time is dependent on the amount of data to resynchronize. For example, for 5 GB of data, the expected time for failback to complete is 1.5 hours.
Note If you change the repeat history setting, existing history will be deleted.
– The P resence Metrics window displays the number of clients being tracked and the number of clients reported with locally administered MAC addresses.
– The System Summary window displays metrics that mainly describe the incoming message rate, data persistence rate, and so on.
Note If HA is configured, first disable HA and then turn off the Cisco CMX services.
ERROR com.cisco.mse.matlabengine.heatmap.BaseMatlabHeatmapBuilder - MatlabHeatmapBuilder#createApInterfaceHeatmap Number of heavy walls used by Matlab: <nn> not equal to count reported by Java: <nn> during heatmap calculation for AP Interface: 88:f0:31:08:06:70-5.0-2
.
The heatmaps are correctly generated and stored.
This error occurs because MATLAB only counts heavy walls for location calculation, while Java counts all obstacles on the floor map.
– Bluetooth Paging Inquiry—A Bluetooth discovery (802.11b/g/n only)
– Bluetooth Sco Acl—A Bluetooth link (802.11b/g/n only)
– Generic DECT—A digital enhanced cordless communication (DECT)-compatible phone
– Generic TDD—A time division duplex (TDD) transmitter
– Generic Waveform—A continuous transmitter
– Microwave—A microwave oven (802.11b/g/n only)
– Canopy—A canopy bridge device
– Spectrum 802.11 FH—An 802.11 frequency-hopping device (802.11b/g/n only)
– Spectrum 802.11 inverted—A device using spectrally inverted Wi-Fi signals
– Spectrum 802.11 non std channel—A device using nonstandard Wi-Fi channels
– Spectrum 802.11 SuperG—An 802.11 SuperAG device
– Spectrum 802.15.4—An 802.15.4 device (802.11b/g/n only)
– Video Camera—An analog video camera
– WiMAX Fixed—A WiMAX fixed device (802.11a/n/ac only)
– WiMAX Mobile—A WiMAX mobile device (802.11a/n/ac only)
– XBox—A Microsoft Xbox (802.11b/g/n only)
For the data to match, set the Dwell Threshold filter either to 0 Minutes To 24 Hours or to No filter, and then check the Include stationary devices check box.
Note these considerations about Analytics PDF reports on Cisco CMX:
– Scheduled PDF reports, which have widgets that use the table view and have a large number of rows, do not display long tables. Pages containing long tables appear blank.
To view a PDF report with long tables, we recommend that you use the direct PDF download instead of a scheduled PDF report.
– Adobe Acrobat Reader DC has a limit of pages being 200 in. and does not display tables that go over this limit. If a table in the report is larger than this limit, you will not be able to view it using Adobe Acrobat Reader DC. Other viewers without this limit, such as Chrome, do not have this problem.
– Large tables, even if they do not reach the 200 in. limit might not be immediately viewed on Adobe Acrobat Reader DC. This can be remedied by enabling the Show large images and Show art, trim, & bleed settings. To do this, select to Edit > Preferences > Page Display > Page Content and Information. Check the check boxes next to Show large images and Show art, trim, & bleed settings. Click Confirm. You will sometimes need to uncheck the check boxes, confirm, go back, check them again, and confirm.
– Download the PDF to view extremely long tables.
– Adobe Acrobat Reader DC has a limit of pages being 200 inches, and does not display tables that go over this limit. This does not occur with other viewers such as Chrome.
– With Adobe Acrobat Reader, sometimes if you check the Show large images check box and the Show art, trim, & bleed check box on Edit > Preferences > Page Display > Page Content and Information, the changes are not saved. If this occurs, uncheck the check boxes, save, and confirm. Then, check the check boxes, save, and confirm. This problem occurs in scheduled PDF reports if you change a widget to a table view and it has a lot of rows.
1. Enter the cmxctl stop –a command to shutdown the Cisco CMX services.
2. Enter the cmxctl start command to start the services.
If you need to change the IP addresses of your primary or secondary Cisco CMX servers configured with the High Availability (HA) feature, follow these steps:
1. From the Cisco CMX CLI on the primary server (as cmxadmin user), enter the cmxha config disable command to disable HA on servers.
2. Enter the cmxctl stop -a command to shut down the Cisco CMX services.
3. Enter the cmxctl status command to verify that the Cisco CMX services are not running.
If the services are still running, enter the cmxos kill command to shut down the services, and then enter the cmxctl status command to verify the services are not running.
4. Edit the Cassandra YAML files to update the seeds information with the correct IP address:
/opt/cmx/sw/confd/templates/cassandra.template.yaml
/opt/cmx/etc/cassandra/cassandra.yaml
5. Verify the changes to the YAML files by using these command:
egrep -i "listen_address|seeds" /opt/cmx/etc/cassandra/cassandra.yaml
egrep -i "listen_address|seeds" /opt/cmx/sw/confd/templates/cassandra.template.yaml
6. Enter the cmxctl start command to start the Cisco CMX services.
7. From the Cisco CMX CLI on the primary server (as cmxadmin user), enter the cmxha config enable command to re-enable HA on the servers.
Note As of Cisco CMX Release 10.4.1-15, the feature flags setting is disabled by default. If your system is running an earlier release of Cisco CMX, we recommend that you disable the feature flags setting.
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.
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.
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.
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.
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.
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.
Cisco Support Community is a forum for you to ask and answer questions, share suggestions, and collaborate with your peers. Join the forum at https://supportforums.cisco.com/index.jspa.
Get Cisco CMX Cloud support at: https://support.cmxcisco.com/hc/en-us
For additional information on Cisco CMX, see:
To receive timely, relevant information from Cisco, sign up at Cisco Profile Manager.
To get the business impact you’re looking for with the technologies that matter, visit Cisco Services.
To submit a service request, visit Cisco Support.
To discover and browse secure, validated enterprise-class apps, products, solutions and services, visit Cisco Marketplace.
To obtain general networking, training, and certification titles, visit Cisco Press.
To find warranty information for a specific product or product family, access Cisco Warranty Finder.
Cisco Bug Search Tool (BST) is a web-based tool that acts as a gateway to the Cisco bug tracking system that maintains a comprehensive list of defects and vulnerabilities in Cisco products and software. BST provides you with detailed defect information about your products and software.