Release Notes for Cisco Mobility Services Engine, Release 7.6.132.0
Available Languages
Table of Contents
Release Notes for Cisco Mobility Services Engine, Release 7.6.132.0
Cisco Mobility Services Engine and Services
Cisco MSE Compatibility Matrix
Upgrading the MSE to 7.6.132.0 from 7.x Release
Restoring an Old Database to 7.6.132.0
Updated Software Version Shown in the Prime Infrastructure After Polling
Base Location, CMX, and wIPS License Requirements
MSE License Product Numbers and SKUs
Ordering Support for Physical and Virtual Appliance
Base Location Services Licenses
CMX Licenses (Previously known as Advanced Location Services)
Base Location Services to CMX Upgrade License
wIPS Enhanced Local Mode License
wIPS Monitor Mode/Monitor Module License
Operational Notes for a Mobility Services Engine
How and When to Use the db.tar installer
Reboot MSE After Fresh Installation or Upgrade
Automatic Installation Script for Initial Setup
Parameter Changes During Upgrade from 6.0.x to 7.0.x
Mandatory Default Root Password Change
Configuring the Prime Infrastructure Communication Username and Password Using MSE setup.sh
Configuration Changes for Greater Location Accuracy
AeroScout Engine Module Changes
Ports to be Opened for High Availability Between MSEs
Synchronizing Floor Maps in Location Service
Operational Notes for Connected Mobile Experiences
Synchronization Required When Upgrading to Release 7.6.132.0 or Importing CAD Floor Images
Floor Change or Minimum Distance Required for Location Transitions to Post to the History Log
Non-Cisco Compatible Extensions Tags Not Supported
Cisco Compatible Extensions Version 1 Tags Required at a Minimum
Monitoring Information Varies for Clients and Tags
Location History Time stamps Match Browser Location
Tablets and Smartphone with Limited Probe Requests Might Affect Location
Operational Notes for CMX Analytics
Obtaining Documentation and Submitting a Service Request
Release Notes for Cisco Mobility Services Engine, Release 7.6.132.0
First Published: October, 2014
These release notes describe what is new in this release, instructions to upgrade to this release, open and resolved caveats for this release, and related information for release 7.6.132.0 of the Cisco Mobility Services Engine and its services.
- Location Service
- Wireless Intrusion Protection System (wIPS)
- Mobile Concierge Service
- CMX Analytics Service
- CMX Browser Engage
- CMX HTTP Proxy Service
Note
Before installing this software, see the “Upgrading the MSE” section for details on compatibility with the Cisco Wireless LAN controllers (WLC) and the Cisco Prime Infrastructure.
Note
Note
Introduction
This section introduces the Cisco Mobility Services Engine (MSE) and the various services that it supports.
Cisco Mobility Services Engine and Services
The Cisco Mobility Services Engine supports various services within the overall Cisco Unified Wireless Network (CUWN).
The Cisco Mobility Services Engine currently supports the following services in Release 7.6.132.0:
- Location Service—Also known as Context Aware Service (CAS). This is the core service of the Mobility Services Engine (MSE) that turns on Wi-Fi client tracking and location API functionality. Allows MSE to simultaneously track thousands of mobile assets and clients by retrieving contextual information such as presence, location, telemetry data, and historical information.
- Wireless Intrusion Protection Service—Provides wireless-specific network threat detection and mitigation against malicious attacks, security vulnerabilities, and sources of performance disruption within the CUWN infrastructure. wIPS visualizes, analyzes, and identifies wireless threats, and centrally manages mitigation and resolution of security and performance issues using Cisco monitor mode and Enhanced Local Mode (ELM) Access Points. Proactive threat prevention is also supported to create a hardened wireless network core that is impenetrable by most wireless attacks.
- Mobile Concierge—Mobile Concierge enables the Cisco Mobility Services Advertisement Protocol (MSAP). This protocol enables direct communication between the MSE and mobile devices, allowing content to be pushed directly to the mobile device pre-association. This functionality is dependent on the mobile device supporting 802.11u and MSAP.
- CMX Analytics Service—The CMX Analytics service analyzes wireless device location information in a particular network. The CMX Analytics service uses the data provided by the Cisco Mobility Services Engine (MSE) to calculate the location of Wi-Fi devices in the Wireless Local Area Network (WLAN).
When a wireless device is enabled in a network, it transmits probe request packets to identify the wireless network in its neighborhood. Even after connecting to the access point in the WLAN, the client devices continue to transmit probe request packets to identify other access points for better quality of service. The access points gather these request and the associated RSSI from the various wireless devices and forwards them to the Wireless LAN Controller (WLC). The controller then forwards this information to the MSE.
The basic data that is collected from various APs, when analyzed, produces information and knowledge about the movement and behavior patterns of people who are using Wi-Fi devices in the building. For example, the building can be an airport, shopping mall, city center, and so on. The CMX Analytics service helps the airport authorities or the building owners to understand the movement of passengers or customers within their building. This helps them improve the signage, make changes to the under utilized areas, and so on.
- CMX Browser Engage Service—The CMX Browser Engage is a new way to transform the in-venue experience through browser engagement. This enables organizations to communicate with opt-in mobile users - shoppers, guests, and visitors - through their mobile browser. The CMX Dashboard is the back-end tool designed for administrative users to manage the CMX Browser engage experience. It allows the admin users to configure venue-specific menus, banners, and icons as well as content-aware search.
Note Consult your Cisco account team before deploying CMX Browser Engage.
- HTTP Proxy Service—Currently, CMX Dashboard relies on HTTP traffic flows to provide value added services and messages to the customers at the venue. The router intercepts the HTTP traffic and CMX Dashboard inserts a script at the end of the HTTP traffic. The HTTP Proxy is enabled on the MSE. The HTTP Proxy on the MSE terminates all HTTP traffic intercepted using Policy Based Routing (PBR) and acts as a forward proxy by pulling contents on behalf of wireless clients.
Note
Note
Note
Software Compatibility Matrix
Table 1 lists the Cisco MSE compatibility matrix.
Table 2 lists the Cisco MSE compatibility matrix for legacy software versions.
Cisco MSE Compatibility Matrix
Table 1 lists the Cisco MSE compatibility matrix.
Note
Note
Note
Upgrading the MSE
For instructions on automatically downloading the software using the Prime Infrastructure or for manually downloading the software using a local or remote connection, see the “Updating Mobility Services Engine Software” section in Chapter 2 of the Cisco Mobility Services Engine Getting Started Guide.
You can find these documents at the following URL:
http://www.cisco.com/en/US/products/ps9742/prod_installation_guides_list.html
This section contains the following topics:
- Upgrade Scenarios
- Compressed Software Image
- Updated Software Version Shown in the Prime Infrastructure After Polling
- Base Location, CMX, and wIPS License Requirements
- Licensing Information for MSE
Upgrade Scenarios
The following scenarios are available to upgrade MSE to 7.6.132.0 from 7.x releases:
Note
Upgrading the MSE to 7.6.132.0 from 7.x Release
To upgrade from 7.x release to 7.6.132.0, follow these steps:
Step 1
Step 2
Step 3
Step 4
Step 5
- To download software listed in the Prime Infrastructure directory, select the Select from uploaded images to transfer into the Server radio button. Choose a binary image from the drop-down list.
Prime Infrastructure downloads the binary image to the FTP server directory you specified during the Prime Infrastructure installation.
- To use download software available locally or over the network, select the Browse a new software image to transfer into the Server radio button, and click Choose File. Locate the file, and click Open.
Step 6
Step 7
Step 8
gunzip CISCO-MSE-K9-7-6-132-0-64.bit.bin.gz
The decompression yields the following files:–
–
–
–
Step 9
chmod +x CISCO-MSE-L-K9-7-6-132-0-64.bin
Step 10
/etc/init.d/msed stop or service msed stop
Step 11
/opt/installers/CISCO-MSE-L-K9-7-6-132-0-64.bin
Step 12
Note
Restoring an Old Database to 7.6.132.0
To restore an old database, follow these steps:
Note
Step 1
Step 2
Step 3
Step 4
Step 5
Compressed Software Image
If you download the Mobility Services Engine image *.gz file using the Prime Infrastructure, the Mobility Services Engine automatically decompresses (unzips) it, and you can proceed with the installation as before.
If you manually download the compressed *.gz file using FTP, you must decompress the files before running the installer. These files are compressed under the LINUX operating system and must be decompressed using the gunzip utility program.
To make the bin file executable, use the chmod +x filename.bin command.
The MSE virtual appliance is distributed as:
- Open Virtualization Format (OVF) for VMware
- Virtual Hard Disk (VHD) for Microsoft Hyper-V
- Open Virtualization Format (OVF) for Citrix XenServer
For more information on deploying the MSE virtual appliance, see the Cisco MSE Virtual Appliance Configuration Guide, Release 7.6 .
Updated Software Version Shown in the Prime Infrastructure After Polling
After a software update, the new Mobility Services Engine software version does not immediately appear in Mobility Services Engine queries on the Prime Infrastructure. Up to 5 minutes is required for the new version to appear. Prime Infrastructure, by default, queries the Mobility Services Engine for status every 5 minutes.
Base Location, CMX, and wIPS License Requirements
Client and wIPS licenses are installed from the Prime Infrastructure UI (Administration > License Center). See, Chapter 2: “Adding and Deleting Mobility Services Engines and Licenses” in the Cisco Connected Mobile Experiences Configuration Guide, Release 7.6, Cisco Wireless Intrusion Prevention System, Release 7.6 , and Cisco Location Analytics Configuration Guide, Release 7.6 respectively.
For complete details on ordering and downloading licenses, see the Cisco Mobility Services Engine Licensing and Ordering Guide at the following URL: http://www.cisco.com/en/US/prod/collateral/wireless/ps9733/ps9742/data_sheet_c07-473865.html
Licensing Information for MSE
The Cisco Mobility Services Engine (MSE) provides a wide variety of location-based services. To enable these services, the following are required:
–
–
There are three types of MSE licenses available:
Client and wIPS licenses are installed from the Prime Infrastructure UI (Administration > License Center). See, Chapter 2: “Adding and Deleting Mobility Services Engines and Licenses” in the Cisco Connected Mobile Experiences Configuration Guide, Release 7.6, Cisco Wireless Intrusion Prevention System, Release 7.6 , and Cisco Location Analytics Configuration Guide, Release 7.6 respectively.
For complete details on ordering and downloading licenses, see the Cisco Mobility Services Engine Licensing and Ordering Guide at the following URL: http://www.cisco.com/en/US/prod/collateral/wireless/ps9733/ps9742/data_sheet_c07-473865.html
Base Location license
The Base Location Services License is equivalent to the Location Services license in software release 7.4, which itself replaced the Context Aware Services (CAS) license in the software versions prior to release 7.4. This license is used for device endpoint tracking, enabling basic calculation of the x,y coordinates of a tracked device. The license count is based on the number of APs supported since release 7.4.
The part number format of this license is L-LS-100AP. Here 'LS' refers to Location Services and '100AP' refers to 100 AP count.
CMX License
The CMX license, called Advanced Location license in release 7.4, supports new features, such as:
The CMX license includes the Base Location license features used for device tracking and the new additional features of CMX.
The part number format of this license is L-AD-LS-100AP. Here 'AD-LS' refers to Advanced Location services license and '100AP' gives the AP count supported.
wIPS License
There are 3 deployment options:
- Enhanced Local mode: Number of wIPS licenses required equals the number of access points in local mode (data serving) deployed in the network.
- Monitor mode: Number of wIPS licenses required equals the number of access points configured in the full-time monitor mode.
- Monitor module: Number of wIPS licenses required equals the number of wireless security and spectrum intelligence modules deployed in the network.
- Provides advanced spectrum capability and the ability to detect presence and track rogue device, interferers, Wi-Fi clients and RFID tags. Cisco Base Location also enables third-party solutions that use the MSE API.
Licensing is based on the number of access points in the environment. The licenses are additive.
Note
MSE License Product Numbers and SKUs
Ordering Support for Physical and Virtual Appliance
The MSE Virtual appliance activation license is required for every instance of an MSE Virtual Appliance. No separate license is required for high availability. To enable high availability, you need to deploy a primary Cisco MSE appliance with Cisco Connected Mobile Experiences and wIPS licenses, and a secondary Cisco MSE appliance without any Cisco Connected Mobile Experiences or wIPS license
Table 8 lists the ordering support for physical and virtual appliance.
CMX Licenses (Previously known as Advanced Location Services)
The CMX licenses include the Base Location Service licenses. There is no need to purchase a separate Base Location Service license when purchasing a CMX license.
What’s New in This Release
There are no new features or enhancements in this release. For more information about updates in this release, see the Caveats section.
Important Notes
This section describes the operational notes and navigation changes for Connected Mobile Experiences, wIPS, and the Mobility Services Engine for Release 6.0.103.0 and later releases.
Features and operational notes are summarized separately for the Mobility Services Engine, Connected Mobile Experiences, and wIPS.
Operational Notes for a Mobility Services Engine
This section lists the operational notes for the Mobility Services Engine and contains the following topics:
- How and When to Use the db.tar installer
- Reboot MSE After Fresh Installation or Upgrade
- Automatic Installation Script for Initial Setup
- Parameter Changes During Upgrade from 6.0.x to 7.0.x
- Controller and Associated Mobility Services Engine Must be Mapped to the Same NTP and Prime Infrastructure Server
- Mandatory Default Root Password Change
- Configuring the Prime Infrastructure Communication Username and Password Using MSE setup.sh
- Configuration Changes for Greater Location Accuracy
- WSSI Module with 3600 AP
- AeroScout Engine Module Changes
- Ports to be Opened for High Availability Between MSEs
- wIPS Profile
- Synchronizing Floor Maps in Location Service
How and When to Use the db.tar installer
Note
Reboot MSE After Fresh Installation or Upgrade
After a new installation or upgrade of the MSE software, you must reboot the MSE using the “reboot” command.
Automatic Installation Script for Initial Setup
An automatic setup wizard is available to help you initially set up the Mobility Services Engine.
An example of the complete automatic setup script is provided in the Cisco Mobility Services Engine Getting Started Guide.
You can find these documents at the following URL:
http://www.cisco.com/en/US/products/ps9742/prod_installation_guides_list.html
Parameter Changes During Upgrade from 6.0.x to 7.0.x
You will notice a change in the tracking limits when you do the following:
1.
If limits are greater than licensed counts, limits are removed and licensed counts are enforced instead.
Controller and Associated Mobility Services Engine Must be Mapped to the Same NTP and Prime Infrastructure Server
Communication between the Mobility Services Engine, the Prime Infrastructure, and the controller are in Coordinated Universal Time (UTC). Configuring the Network Time Protocol (NTP) on each system provides devices with the UTC time. An NTP server is required to automatically synchronize time between the controller, Prime Infrastructure, and the Mobility Services Engine.
The Mobility Services Engine and its associated controllers must be mapped to the same NTP server and the same Prime Infrastructure server.
Local time zones can be configured on a Mobility Services Engine to assist network operations center personnel in locating events within logs.
Note
http://www.cisco.com/en/US/products/ps9742/prod_installation_guides_list.html
Mandatory Default Root Password Change
You must change the default root password of the Mobility Services Engine while running the automatic installation script to ensure optimum network security.
You can also change the password using the Linux passwd command.
Note
Configuring the Prime Infrastructure Communication Username and Password Using MSE setup.sh
You can configure the Prime Infrastructure Communication username and password using the MSE setup.sh script file.
Scenarios which you might encounter while configuring the Prime Infrastructure username and password are as follows:
- If you configure a new Prime Infrastructure username and password, the password provided is applicable for the new Prime Infrastructure username created.
- If you only configure the Prime Infrastructure username without configuring the Prime Infrastructure password, then the default password admin is applied to the configured username.
- If you only configure the Prime Infrastructure password without configuring the Prime Infrastructure username, then the password for the admin user is changed.
- If you configure an existing username for the Prime Infrastructure username and also configure the password, then the password for that existing user is changed.
Note
Configuration Changes for Greater Location Accuracy
In some RF environments, where location accuracy is around 60 to 70% or where incorrect client or tag floor location map placements occur, you might need to modify the moment RSSI thresholds in the Context Aware Service > Advanced > Location Parameters page on the Prime Infrastructure.
The following RSSI parameters might require modification:
- locp-individual-rssi-change-threshold
- locp-aggregated-rssi-change-threshold
- locp-many-new-rssi-threshold-in-percent
- locp-many-missing-rssi-threshold-in-percent
WSSI Module with 3600 AP
If you are attempting to deploy WSSI module with 3600 APs, then APs should be placed in monitor mode with submode wIPS and advanced wIPS engine enabled on the Prime Infrastructure.
AeroScout Engine Module Changes
Starting Release 7.5, the AeroScout engine module is removed from both the Connected Mobile Experiences setup and location code. During installation, if you are upgrading from Release 7.2 and later to Release 7.5, then you will be prompted to remove the AeroScout engine. If you agree to remove, the it removes the AeroScout engine and by default, the Cisco Tag Engine is started as part of Connected Mobile Experiences. If you do not agree to remove the AeroScout engine, then installation will exit.
Ports to be Opened for High Availability Between MSEs
The following is the list of ports to be opened for High Availability between MSEs:
wIPS Profile
wIPS profile cannot be pushed to Cisco Wireless LAN Controller (WLC) Version 7.5 or prior using the Prime Infrastructure 1.4.x or 2.x with MSE 7.6 Release.
Synchronizing Floor Maps in Location Service
While synchronizing floor maps in location service, we recommend that you synchronize floor maps in batches of 1000 access points at a time.
Operational Notes for Connected Mobile Experiences
This section lists the operational notes for a Mobility Services Engine and contains the following topics:
- Synchronization Required When Upgrading to Release 7.6.132.0 or Importing CAD Floor Images
- Floor Change or Minimum Distance Required for Location Transitions to Post to the History Log
- Non-Cisco Compatible Extensions Tags Not Supported
- Cisco Compatible Extensions Version 1 Tags Required at a Minimum
- Calibration Models and Data
- Advanced Location Parameters
- Location History Time stamps Match Browser Location
Synchronization Required When Upgrading to Release 7.6.132.0 or Importing CAD Floor Images
When upgrading to Release 7.6.132.0 from Release 7.x, you must synchronize after the software upgrade and also when CAD-generated floor images are imported into the Prime Infrastructure.
Floor Change or Minimum Distance Required for Location Transitions to Post to the History Log
When history logging is enabled for any or all elements (client stations, asset tags, rogue clients, and access points), a location transition for an element is posted only if it changes floors or the new location of the element is at least 30 feet (10 meters) from its original location.
Note The other conditions for history logging are as follows:
- Clients: Association, authentication, re-association, re-authentication, or disassociation.
- Tags: Tag Emergency button.
- Interferers: Interferer severity change, cluster center change, or merge.
See Services > Mobility Services > Device Name > Context Aware Service > Administration > History Parameters.
Logs can be viewed at Services > Mobility Services > Device Name > Systems > Log.
Non-Cisco Compatible Extensions Tags Not Supported
The Mobility Services Engine does not support non-Cisco CX Wi-Fi tags. Additionally, these non-compliant tags are not used in location calculations or shown on the Prime Infrastructure maps.
Cisco Compatible Extensions Version 1 Tags Required at a Minimum
Only Cisco CX Version 1 (or later) tags are used in location calculations and mapped in the Prime Infrastructure.
Monitoring Information Varies for Clients and Tags
In the Monitor > Clients page (when Location Debug is enabled), you can view information on the last heard access point and its corresponding Received Signal Strength Indicator (RSSI) reading.
Calibration Models and Data
Calibration models always applies to Wireless clients, Interferers, Rogue APs, and Rogue Clients.
See Chapter 7, “Context-Aware Planning and Verification” in the Cisco Connected Mobile Experiences Configuration Guide, Release 7.6 for more details on client calibration.
Advanced Location Parameters
Settings for advanced location parameters related to RSSI, chokepoint usage, location smoothing, and assignment of outside walls on floors, are not applicable to tags.
See the “Editing Advanced Location Parameters” section in Chapter 7 of the Cisco Connected Mobile Experiences Configuration Guide, Release 7.6 .
See Services > Mobility Services > Device Name > Context Aware Service > Advanced > Location Parameters.
Location History Time stamps Match Browser Location
The Prime Infrastructure time stamp is based on the browser location and not on the Mobility Services Engine settings. Changing the time zone on the Prime Infrastructure or on the Mobility Services Engine does not change the time stamp for the location history.
Tablets and Smartphone with Limited Probe Requests Might Affect Location
Many tablets, smartphones, and other Wi-Fi devices with power save mode do not continuously send out probe requests after an initial association to the CUWN. Therefore, calculating the location accuracy of such PDAs using RSSI readings is not always optimal.
Operational Notes for CMX Analytics
This section lists the operational notes for CMX Analytics service and contains the following topics:
WebGL Compatibility
The CMX Analytics in Release 7.5 provides ability to view the analytic results in both 2D (Open Street Maps) and 3D (WebGL) environments. This provides improved understanding of results on multiple floor paths or when dwell times are calculated throughout a multi-storey building. The 3D environment presents the same information as the 2D environment.
WebGL is an advanced feature that provides graphic capabilities. All browsers do not support WebGL on a particular hardware. Verify your browser compatibility in the Get WebGL website. If your browser supports WebGL, then you must see a spinning cube.
If your browser does not support WebGL, you must do the following:
- Update your latest drivers for video card.
- For Google Chrome, follow the instructions given for WebGL and 3D Graphics in the Google Chrome support website.
- For Firefox, follow these steps to enable WebGL:
–
–
–
–
–
–
–
–
Note
Caveats
Cisco Bug Search Tool
The Bug Search Tool (BST), which is the online successor to Bug Toolkit, is designed to improve the effectiveness in 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 provide external and internal bug views for the search input.
To view the details of a caveat listed in this document:
1.
Open Caveats
Use the BST to view the details of a caveat listed in this section. For more information about the BST, see the “Cisco Bug Search Tool” section.
Resolved Caveats
Use the BST to view the details of a caveat 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 at the following URL:
http://www.cisco.com/cisco/web/support/index.html
Click Troubleshooting,
choose your product, and then click the Troubleshoot and Alerts heading on the product page to find information on the problem you are experiencing and other service advisories.Related Documentation
The following documents are related to the Mobility Services Engine:
http://www.cisco.com/en/US/products/ps9742/tsd_products_support_series_home.html
http://www.cisco.com/en/US/products/ps9817/products_installation_and_configuration_guides_list.html
http://www.cisco.com/en/US/products/ps9742/products_installation_and_configuration_guides_list.html
http://www.cisco.com/en/US/products/ps9742/products_installation_and_configuration_guides_list.html
http://www.cisco.com/en/US/products/ps9742/products_installation_and_configuration_guides_list.html
http://www.cisco.com/en/US/products/ps9742/prod_installation_guides_list.html
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What’s New in Cisco Product Documentation , which also lists all new and revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What’s New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS Version 2.0.
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.
FeedbackContact Cisco
- Open a Support Case
- (Requires a Cisco Service Contract)