Table of Contents
Release Notes for Cisco CMX, Release 10.1.2
Upgrading Cisco CMX 10.0 to Cisco CMX 10.1.2
Upgrading Cisco CMX 10.1 or 10.1.1 to Cisco CMX 10.1.2
Software Release Recommendation
Installing a Cisco MSE Virtual Appliance
Obtaining Documentation and Submitting a Service Request
Release Notes for Cisco CMX, Release 10.1.2
These release notes describe what is new in Cisco Connected Mobile Experiences (Cisco CMX), Release 10.1.2, and the system requirements, upgrade scenarios, and open caveats for this release. Unless otherwise noted, Cisco Connected Mobile Experiences is referred to as Cisco CMX in this document.
Introduction
Cisco CMX is a newly redesigned, high-performing scalable software platform that addresses the mobility services requirements of high-density Wi-Fi deployments.
System Requirement
Cisco CMX can be installed on a physical or virtual Cisco Mobility Services Engine (Cisco MSE) appliance. Virtual Cisco MSE appliances require VMware ESXi 5.1 or later.
Hardware Guidelines
Table 1 lists the Cisco CMX, Release 10.1.2 hardware guidelines for a virtual Cisco MSE appliance.
Solution Compatibility Matrix
Table 2 lists the Cisco CMX 10.1.2 solution compatibility matrix.
Cisco MSE Virtual Appliance cisco_cmx-10.1.2.tar.gz
Cisco MSE Virtual Appliance cisco_cmx-10.1.1-2.tar.gz
Any maps exported from Cisco Prime Infrastructure are imported into the Cisco CMX.
See the “Important Notes” section.
Upgrading Cisco CMX
Cisco CMX is available as software that can be run on physical or virtual Cisco MSE appliances. No database migration on inline upgrade is supported from Cisco MSE 8.0 or earlier to CMX 10.1. You can upgrade from Cisco CMX 10.0, 10.1, or 10.1.1 to Cisco CMX 10.1.2. We recommend that you run Cisco CMX 10.1.2 in parallel with the existing Cisco MSE 8.0 or earlier, and utilize the evaluation license for 120 days. After the evaluation period, you have an option to decommission the older Cisco MSE system.
This section contains the following topics:
Upgrading Cisco CMX 10.0 to Cisco CMX 10.1.2
You can upgrade Cisco CMX 10.0 to Cisco CMX 10.1.2, which is the Cisco-supported version of Cisco CMX, by using one of the following options:
Step 1 Complete the reinstallation of the new OVA file.
Step 2 Contact your local SE or Account team and obtain an RPM and information about the procedure to upgrade to 10.1.2.
Upgrading Cisco CMX 10.1 or 10.1.1 to Cisco CMX 10.1.2
To upgrade a Release 10.1 or 10.1.1 deployment to Release 10.1.2, perform the following steps:
Step 1 Take a snapshot of the Virtual Machine if restore is required.
Step 2 Enter the following commands:
![]()
Note Ensure that all Cisco CMX services are stopped, if not, you need to kill the services.
Step 3 Download the CMX 10.1.2 tar ball and enter the following commands:
![]()
Note Manually enter these commands and do not copy/paste them.
tar xvfz cisco_cmx-10.1.2.tar.gz
rpm -Uvh cisco_cmx_connect-10.1.2-33.x86_64.rpm
rpm -Uvh cisco_cmx-10.1.2-1.x86_64.rpm
![]()
Note To download the .tar file from Cisco.com to your CMX /tmp location, enter the following command using Secure Copy Protocol (SCP):
scp user@serverip:filename /tmp/filename
![]()
Note It will take some time to upgrade the services and databases. Ensure that all preceding commands return success. In case of any failures, contact Cisco Technical Support.
Step 4 Enter the following commands:
cmxctl start (if all services are not started)
Licensing Information
- Cisco CMX 10.1.2 continues to use two-tier licensing—Cisco CMX Base and Cisco CMX Advanced. The Cisco CMX Connect service is now included as part of Cisco CMX Base license.
The Cisco 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
The Cisco CMX Advanced license provides the following services:
– Includes all the CMX Base services—Detect and Locate, APIs, Connect
- Starting with Cisco CMX 10.1, Cisco CleanAir is natively built-in with MSE appliance (physical and virtual) and does not require a license.
- The Evaluation License of Cisco CMX 10.1.2 provides full functionality for an evaluation period of 120 days. Evaluation of Cisco CMX Base and Cisco CMX Advanced licenses are built in with every Cisco CMX 10.1 instance. There are no limitations with regard to the functionalities when you use the Evaluation License in the current release.
- Every Cisco CMX 10.1.2 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.
- Accounting starts from the day you start using the Cisco CMX 10.1.2 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 Compliance” message is displayed. But the service is still allowed to run. The out-of-compliance licenses running in Cisco CMX 10.1.2 will not receive any support from TAC/Cisco in case of any issues.
- You can add any license file from Cisco MSE 8.0 or earlier to Cisco CMX 10.1.2.
- In Cisco CMX 10.1.2, the licenses are not node-locked to a box.
![]()
Note For more information about Cisco CMX ordering and licensing, see the Cisco Connected Mobile Experiences (CMX) Version 10 Ordering and Licensing Guide.
Software Release Recommendation
Table 3 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, Cisco CMX Release 10.1 at:
http://www.cisco.com/c/en/us/td/docs/wireless/mse/10-1/installation/guide/installation_guide.html
What’s New in This Release
This is a patch release for Cisco CMX 10.1. This release delivers a number of bug fixes. No new features have been added in this release.
Important Notes
- From Cisco CMX, Release 10.1, Cisco CMX, Cisco Wireless LAN Controller (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 10.1 is loosely coupled with Cisco Prime Infrastructure, which is the network management platform. Cisco Prime Infrastructure discovers access points and offers tools to place them on site maps. These populated maps are reused by Cisco CMX using an export and import process supported by Cisco Prime Infrastructure and Cisco CMX respectively. This process is performed during setup, and is repeated when maps are modified or added to the system. After the process of importing maps on Cisco CMX is complete, the Cisco CMX and Cisco Prime Infrastructure do not have run-time dependencies.
- Unlike in releases earlier than Cisco CMX 10.1, zones are created in Cisco CMX 10.1.2 after the maps have been imported from Cisco Prime Infrastructure.
Caveats
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 to:
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.
Resolved 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.
Troubleshooting
For the most up-to-date, detailed troubleshooting information, see the Cisco TAC website:
http://www.cisco.com/cisco/web/support/index.html
1. Choose Product Support > Wireless .
3. Click Troubleshoot and Alerts to find information on the problem you are experiencing.
Obtaining Documentation and Submitting 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 at: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html .
Subscribe to What’s New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation as an RSS feed and delivers content directly to your desktop using a reader application. The RSS feeds are a free service.
This document is to be used in conjunction with the documents listed in the “Related Documentation” section. Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at 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. (1110R)
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.