Table Of Contents
Release Notes for Cisco 2700 and 2710 Location Appliances for Software Release 3.0.37.0
Upgrading to this Software Release
Backup of Release 2.0.x or Later Cannot be Restored on Earlier Releases
Location Appliance Image is Compressed
Secure Shell V1.0 is No Longer Supported
Updated Location Appliance Software Version Shown in WCS After Polling
Mandatory Default Root Password Change
Mandatory Upgrade of Location Software Required to Reflect New 2007 Daylight Saving Time Dates
Automatic Installation Script for Initial Setup
Location History Timestamps Match Browser's Locale
Recommended Settings for Absolute and Relative Discard RSSI Times (Location Parameters)
Recommended Wireless Adapter Clients for Calibration
Chokepoint and Emergency Notifications for CCXv1 Asset Tags (NEW Notification Parameter)
Chokepoint Mapping to Enhance Tag Location Reporting (NEW Configure Parameter)
Email Notifications for Location Server Alarms (NEW Alarm Parameter)
Excluding Ad Hoc Client Tracking and Reporting (NEW Polling Parameter)
Location Protocol (LOCP) (NEW Advanced Menu Parameter)
Location Server Utilization Report (NEW Report)
Overlapping Tags (NEW Monitor Parameter)
Query and Display of Telemetry Data for CCX v1 Compliant Tags (NEW Monitor Parameter)
Cisco Product Security Overview
Reporting Security Problems in Cisco Products
Obtaining Technical Assistance
Cisco Technical Support & Documentation Website
Definitions of Service Request Severity
Obtaining Additional Publications and Information
Release Notes for Cisco 2700 and 2710 Location Appliances for Software Release 3.0.37.0
November 6, 2007
These release notes describe features, enhancements, and caveats for software release 3.0.37.0 for Cisco Location Appliances. This release of location appliance software supports both Cisco 2700 and 2710 location appliances and operates with Cisco Wireless LAN Solution versions 4.1, 4.0, 3.2, and 3.1.
Note
Refer to the online version of the Cisco 2700 Series Location Appliance Installation and Configuration Guide for details on the physical installation and initial configuration of the location appliance at http://www.cisco.com/en/US/products/ps6386/prod_installation_guides_list.html
Contents
These release notes contain the following sections:
•
•
•
Introduction
Location appliance software release 3.0.37.0 supports Cisco 2700 and 2710 location appliances that operate with Cisco Wireless LAN Solution versions 4.1, 4.0, 3.2, and 3.1.
Location appliances compute, collect, and store historical location data using Cisco wireless LAN controllers and access points to track the physical location of wireless devices. The collected location data can be viewed in GUI format in the Cisco Wireless Control System (WCS), the centralized WLAN management platform.
System Requirements
You can install this software release on any 2700 or 2710 location appliance.
Compatibility Matrix
Table 1 describes compatibility between WCS and location server versions.
Table 1 WCS and Location Server Compatibility Matrix
WCS 3.0
Supported
Supported1
Not supported
Not supported
Not supported
WCS 3.1
Supported2
Supported
Supported from WCS 3.1.35.0 onward3
Supported from WCS 3.1.35.0 onward3
Supported from WCS 3.1.35.0 onward3,6,8
WCS 3.2
Supported3, 4, 5
Supported
Supported6
Supported6,8
WCS 4.0
Supported2, 3, 4, 5,6
Supported3, 4, 5, 7
Supported7
Supported
Supported8
WCS 4.1
Supported2,3,4,5,6,9
Supported3,4,5,7, 9
Supported7,9
Supported9
Supported
1 Certain antenna attributes are ignored by WCS.
2 Certain antenna attributes are ignored by the location server.
3 Asynchronous notification features are ignored by the location server.
4 Backup and restore operations for the location server may time out.
5 Searching for elements by a specific MAC address or asset name will not work until the location server SW is upgraded.
6 Battery level and location notification update features are ignored by the location server. Location smoothing parameters and contributing access point debug options are ignored by the location server.
7 Battery level and location notification update features are ignored by Cisco WCS. Location smoothing parameters and contributing access point debug options are ignored by Cisco WCS.
8 CCX tags, telemetry, chokepoint, and emergency capabilities are ignored by Cisco WCS.
9 CCX tags, telemetry, chokepoint, and emergency capabilities are ignored by the location server.
Upgrading to this Software Release
For instructions on using either Cisco WCS or a console port to download this software on location appliances, refer to the "Updating Location Appliance Software" section in the "Installation and Configuration" chapter of the Cisco 2700 Series Installation and Configuration Guide (78-17180-02 and later).
Click this link to browse to that document:
http://www.cisco.com/en/US/products/ps6386/prod_installation_guides_list.html
Backup of Release 2.0.x or Later Cannot be Restored on Earlier Releases
A backup of location appliance software releases 2.0.x and later cannot be restored on any location appliance running an earlier software release. Before you upgrade a location appliance to 2.0.x release or later, Cisco recommends that you create a backup of the earlier release and archive it. This will enable you to convert an upgraded system to an earlier release, if necessary.
Location Appliance Image is Compressed
If you download the server image *.gz file using WCS, the location appliance 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 first decompress the files before running the installer. These files have been compressed under the LINUX operating system and must be decompressed using the gunzip utility program. The unzip method you use is defined by the filename you are trying to unzip. To make the bin file executable, use the following command:
chmod +x filename.bin
Secure Shell V1.0 is No Longer Supported
Support for secure shell (SSH) version 1 (v1) is not supported in releases 2.1.x and later due to known security issues; however, SSH v2 is supported.
Note
Note
#override default of no subsystems
Subsystem sftp /usr/libexec/openssh/sftp-serverProtocol 2
•
•
Updated Location Appliance Software Version Shown in WCS After Polling
After a software update, the new location appliance software version does not immediately appear in location server queries on WCS. Up to five minutes is required for the new version to appear. WCS, by default, queries the location appliance every five minutes for status.
Important Notes
This section describes important information about new features and operational notes for software release 3.0.37.0 for location appliances.
Operational Notes
The following operational notes are relevant to this release.
Mandatory Default Root Password Change
You must change the default root password during initial configuration of the location appliance to ensure optimum network security.
•
•
Mandatory Upgrade of Location Software Required to Reflect New 2007 Daylight Saving Time Dates
The United States has changed the start and end dates of Daylight Saving Time (DST) for 2007. In 2007, DST within the US will begin on the second Sunday in March and end on the first Sunday in November. A mandatory upgrade to release 2.1.42.0 or greater which incorporates support for this new DST period is required to prevent incorrect time reporting during certain periods of DST. Specifically, not upgrading your location appliance to version 2.1.42.0 will result in incorrect time reporting from March 11, 2007 through April 2, 2007 and from October 29, 2007 through November 4, 2007.
Automatic Installation Script for Initial Setup
Beginning with release 2.1.34, an automatic setup wizard is available to step you through the initial setup of the location appliance. You also have the option of setting up the location appliance manually.
An example of the complete automatic setup script (and manual setup process) is provided in the Cisco 2700 Series Installation and Configuration Guide. You can find this document online at http://www.cisco.com/en/US/products/ps6386/prod_installation_guides_list.html.
Location History Timestamps Match Browser's Locale
The WCS timestamp is based on the browser's location and not on the location appliance settings. Changing the time zone of the WCS or on the location appliance does not change the timestamp for the location history.
Recommended Settings for Absolute and Relative Discard RSSI Times (Location Parameters)
No value less than the default value of 3 minutes should be set for Relative Discard RSSI Time.
No value less than the default value of 60 minutes should be set for Absolute Discard RSSI Time.
Path: Location > Location Server > Location Server > Advanced> Location Parameters
Recommended Wireless Adapter Clients for Calibration
We recommend using Cisco Aironet 802.11 a/b/g Wireless Cardbus Adapter Clients (AIR-CB21AG) with the latest drivers for calibrating location models. The client should be CCX compatible and version 2 or greater. Adapter client versions less than 2.0 are not ideal for calibration.
Recovering Lost Root Password
If you lose or forget the root password for the location appliance, do the following:
Step 1
Step 2
Step 3
At the end of the line enter a space and the number one (1). Press Enter to save this change.
Step 4
At the end of the boot sequence, a shell prompt appears.
Step 5
Step 6
Step 7
Synchronization Notes
Assign a Controller/Network Design/Event Group to a Location Appliance Before Using Auto-Synch
With auto-synchronization, controllers, network designs, and event groups that are detected as unsynchronized are synchronized automatically. Before this automatic synchronization can be enabled, you must assign a controller, event group, or network design to a location appliance.
Controller Name Must be Unique Before Synchronization
The assigned controller names must be unique. If the controller names are duplicated, the synchronization process occurs only on one controller.
Verify WCS and Location Server Software Compatibility Before Synchronization
The software versions for WCS and the location server must be compatible for synchronization to perform properly. Please see the compatibility matrix noted in Table 1 of this release note for WCS and location server compatibility.
New Feature Support
Please note the new feature support added in release 3.0:
Chokepoint and Emergency Notifications for CCXv1 Asset Tags (NEW Notification Parameter)
You can add chokepoint and emergency event definitions on a per-group basis and define what conditions trigger an event notification. Chokepoint and emergency notifications are only reported for CCXv.1 compliant tags.
Refer to the "Adding an Event Definition" section in Chapter 6 of the Cisco Location Appliance Configuration Guide, Software Release 3.0.
Path: Location > Notifications > Settings > Group Name > Add Event Definition
Chokepoint Mapping to Enhance Tag Location Reporting (NEW Configure Parameter)
Installation of chokepoints within a network provides enhanced location information for active RFID tags. When an active CCX version 1 compliant RFID tag enters the range of a chokepoint, it is stimulated by the chokepoint. The MAC address of this chokepoint is then included in the next beacon sent by the stimulated tag. All access points that detect this tag beacon then forward the information to the controller and location appliance.
Using chokepoints in conjunction with active CCX compliant tags provides immediate location information on a tag and its asset. When a CCX tag moves out of the range of a chokepoint, its subsequent beacon frames do not contain any identifying chokepoint information. Location determination of the tag defaults to the standard calculation methods based on RSSIs reported by access point associated with the tag.
Note
Refer to the "Refer to the "Adding Chokepoints to the WCS Database and Map" section in Chapter 7 of the Cisco Location Appliance Configuration Guide, Software Release 3.0."
Path: Configure > Chokepoints > Add Chokepoint
Email Notifications for Location Server Alarms (NEW Alarm Parameter)
Cisco WCS lets you send alarm notifications to a specific email address. Sending notifications through
email enables you to take prompt action when needed.You can select the alarm severity types (critical, major, minor and warning) that are emailed to you.
Refer to the "Emailing Alarm Notifications" section in Chapter 8 of the Cisco Location Appliance Configuration Guide, Software Release 3.0.
Path: Monitor > Alarms > Email Notifications
Excluding Ad Hoc Client Tracking and Reporting (NEW Polling Parameter)
You can turn off tracking of ad hoc rogue clients so that they are not displayed on Cisco WCS maps or their events and alarms reported.
Refer to the "Editing Polling Parameters" section in Chapter 4 of the Cisco Location Appliance Configuration Guide, Software Release 3.0.
Path: Location > Location Servers > Location Server > Polling Parameters
Location Protocol (LOCP) (NEW Advanced Menu Parameter)
LOCP is the location protocol that manages communication between the location server and the controller. Transport of telemetry, emergency and chokepoint information between the location server and the controller is managed by this protocol.
You can configure its parameters to adjust for slow response in latency in the network.
Refer to the "Editing LOCP Parameters" section in Chapter 4 of the Cisco Location Appliance Configuration Guide, Software Release 3.0.
Path: Location > Location Servers > Location Server > Advanced > LOCP Parameters
Location Server Utilization Report (NEW Report)
In Cisco WCS, you can generate a utilization report for a location server. By default, reports are stored on the Cisco WCS server.
The location utilization report summarizes and charts the following information in two separate charts for a prescribed period of time:
•
•
You can generate a utilization report for the location server on both an immediate and scheduled basis. Once defined, the report can be saved for future diagnostic use on an ad hoc basis or scheduled to run and report on a regular basis.
Refer to the "Generating Reports" section in Chapter 8 of the Cisco Location Appliance Configuration Guide, Release 3.0.
Path: Report > Performance Reports > Location Server Utilization
Overlapping Tags (NEW Monitor Parameter)
When multiple tags are within close proximity of one another a summary tag is used to represent their location on a WCS map. The summary tag is labeled with the number of tags at that location. When you move the mouse over the overlapping tag on the map, a panel appears with summary information for the overlapping tags. A distinct panel exists for each overlapping tag.
Refer to the "Overlapping of Tags" section in Chapter 8 of the Cisco Location Appliance Configuration Guide, Release 3.0.
Path: Monitor > Maps
Query and Display of Telemetry Data for CCX v1 Compliant Tags (NEW Monitor Parameter)
You can query for telemetry capable data tags in WCS and display in the Tag Properties page those CCXv1 compliant attributes transmitted by the tags. Attributes which might display for the tags are GPS location, battery extended information, pressure, temperature, humidity, motion, status and emergency code.
Refer to the "Querying of Tags" section in Chapter 8 of the Cisco Location Appliance Configuration Guide, Release 3.0.
Path: Monitor > Tags > New Search
Screen and Path Changes
The following location appliance features are found on different Cisco WCS screens than in release 4.0 and release 2.1 for the location appliance.
•
You can use this feature to validate location accuracy of rogue and non-rogue clients and asset tags information generated either automatically by access points or manually by calibration.
Refer to the "Analyzing Element Location Accuracy Using Testpoints" section in Chapter 7 of the Cisco Location Appliance Configuration Guide, Software Release 3.0 for more details
Path: Location > Location Servers > Advanced > Advanced Parameters and Monitor > Maps
•
Configuring polling frequency for all elements is centrally managed on the Polling Parameters page.
Refer to the "Editing Polling Parameters" section in Chapter 4 of the Cisco Location Appliance Configuration Guide, Software Release 4.1 for more details.
Path: Location > Location Servers > Location Server > Polling Parameters
Caveats
This section lists open and resolved caveats in location appliance release 3.0.37.0.
Open Caveats
The following caveats are open (unresolved) in this release:
•
Workaround: Operate in local mode for the most accurate operation, if possible.
•
Workaround: There is no known workaround.
•
•
•
Workaround: Check for connectivity between the location appliance and the controller. Also, check the location events table for SNMP unreachable messages.
•
Workaround: Use another browser or another version of the Internet Explorer.
•
Workaround: Manually close all open ports on the location appliance and upgrade the location appliance SSH to version 4.2.
•
Workaround: To immediately reboot a location appliance, use SSH to reboot the location appliance from within the shell using the following command: reboot - h.
•
Workaround: Do not manually adjust the time on the location appliance for daylight savings time. The system adjusts automatically to daylight savings time.
CSCsi19341—When using SNMP version 1 with Cisco WCS, the location appliance fails to track clients.
Workaround: Use either SNMP version 2c or version 3 with Cisco WCS and the controller.
•
Workaround: None.
•
Workaround: None.
•
Workaround: None.
•
Workaround: None.
•
Workaround: Click on the history item individually to retrieve information for the desired asset tag. You can access this information by selecting the Location History option from the Select a command drop-down menu on the Tag Properties page ((Path: Monitor > Tags > Tag).
•
Workaround: None.
Resolved Caveats
The following caveats are resolved in this release:
•
•
•
•
•
•
•
•
•
–
–
•
The following caveats were resolved in release 2.1.42 and are incorporated into this release:
•
•
•
•
•
The following caveats were resolved in earlier releases of 2.1.x and are incorporated into this release:
•
•
•
•
This issue was addressed by adding specific documentation in the 2.048.0 and 2.1.34.0 location appliance release notes and onward and in the location appliance configuration guide (June 2006 and onward.)
•
•
•
•
•
•
•
If You Need More Information
If you need information about a specific caveat that does not appear in these release notes, you can use the Cisco Bug Toolkit to find caveats of any severity. Click this URL to browse to the Bug Toolkit:
http://www.cisco.com/pcgi-bin/Support/Bugtool/launch_bugtool.pl
(If you request a defect that cannot be displayed, the defect number might not exist, the defect might not yet have a customer-visible description, or the defect might be marked Cisco Confidential.)
Troubleshooting
For the most up-to-date, detailed troubleshooting information, refer to the Cisco TAC website at http://www.cisco.com/tac. Click Technology Support, choose Wireless from the menu on the left, and click Wireless LAN.
Documentation Updates
Structural Changes
A chapter was added to the Cisco Location Appliance Configuration Guide, Release 3.0 version to address location planning and verification. Refer to the Chapter 7 of that manual for details.
Related Documentation
The following documents are related to location appliances:
•
•
•
•
Note
Obtaining Documentation
Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several ways to obtain technical assistance and other technical resources. These sections explain how to obtain technical information from Cisco Systems.
Cisco.com
You can access the most current Cisco documentation at this URL:
http://www.cisco.com/techsupport
You can access the Cisco website at this URL:
You can access international Cisco websites at this URL:
http://www.cisco.com/public/countries_languages.shtml
Product Documentation DVD
Cisco documentation and additional literature are available in the Product Documentation DVD package, which may have shipped with your product. The Product Documentation DVD is updated regularly and may be more current than printed documentation.
The Product Documentation DVD is a comprehensive library of technical product documentation on portable media. The DVD enables you to access multiple versions of hardware and software installation, configuration, and command guides for Cisco products and to view technical documentation in HTML. With the DVD, you have access to the same documentation that is found on the Cisco website without being connected to the Internet. Certain products also have pdf versions of the documentation available.
The Product Documentation DVD is available as a single unit or as a subscription. Registered Cisco.com users (Cisco direct customers) can order a Product Documentation DVD (product number DOC-DOCDVD=) from Cisco Marketplace at this URL:
http://www.cisco.com/go/marketplace/
Ordering Documentation
Beginning June 30, 2005, registered Cisco.com users may order Cisco documentation at the Product Documentation Store in the Cisco Marketplace at this URL:
http://www.cisco.com/go/marketplace/
Nonregistered Cisco.com users can order technical documentation from 8:00 a.m. to 5:00 p.m. (0800 to 1700) PDT by calling 1 866 463-3487 in the United States and Canada, or elsewhere by calling 011 408 519-5055. You can also order documentation by e-mail at tech-doc-store-mkpl@external.cisco.com or by fax at 1 408 519-5001 in the United States and Canada, or elsewhere at 011 408 519-5001.
Documentation Feedback
You can rate and provide feedback about Cisco technical documents by completing the online feedback form that appears with the technical documents on Cisco.com.
You can send comments about Cisco documentation to bug-doc@cisco.com.
You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address:
Cisco Systems
Attn: Customer Document Ordering
170 West Tasman Drive
San Jose, CA 95134-9883We appreciate your comments.
Cisco Product Security Overview
Cisco provides a free online Security Vulnerability Policy portal at this URL:
http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html
From this site, you can perform these tasks:
•
•
•
A current list of security advisories and notices for Cisco products is available at this URL:
If you prefer to see advisories and notices as they are updated in real time, you can access a Product Security Incident Response Team Really Simple Syndication (PSIRT RSS) feed from this URL:
http://www.cisco.com/en/US/products/products_psirt_rss_feed.html
Reporting Security Problems in Cisco Products
Cisco is committed to delivering secure products. We test our products internally before we release them, and we strive to correct all vulnerabilities quickly. If you think that you might have identified a vulnerability in a Cisco product, contact PSIRT:
•
An emergency is either a condition in which a system is under active attack or a condition for which a severe and urgent security vulnerability should be reported. All other conditions are considered nonemergencies.
•
In an emergency, you can also reach PSIRT by telephone:
•
•
Tip
Never use a revoked or an expired encryption key. The correct public key to use in your correspondence with PSIRT is the one linked in the Contact Summary section of the Security Vulnerability Policy page at this URL:
http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html
The link on this page has the current PGP key ID in use.
Obtaining Technical Assistance
Cisco Technical Support provides 24-hour-a-day award-winning technical assistance. The Cisco Technical Support & Documentation website on Cisco.com features extensive online support resources. In addition, if you have a valid Cisco service contract, Cisco Technical Assistance Center (TAC) engineers provide telephone support. If you do not have a valid Cisco service contract, contact your reseller.
Cisco Technical Support & Documentation Website
The Cisco Technical Support & Documentation website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The website is available 24 hours a day, at this URL:
http://www.cisco.com/techsupport
Access to all tools on the Cisco Technical Support & Documentation website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a user ID or password, you can register at this URL:
http://tools.cisco.com/RPF/register/register.do
Note
Submitting a Service Request
Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3 and S4 service requests are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Service Request Tool provides recommended solutions. If your issue is not resolved using the recommended resources, your service request is assigned to a Cisco engineer. The TAC Service Request Tool is located at this URL:
http://www.cisco.com/techsupport/servicerequest
For S1 or S2 service requests or if you do not have Internet access, contact the Cisco TAC by telephone. (S1 or S2 service requests are those in which your production network is down or severely degraded.) Cisco engineers are assigned immediately to S1 and S2 service requests to help keep your business operations running smoothly.
To open a service request by telephone, use one of the following numbers:
Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227)
EMEA: +32 2 704 55 55
USA: 1 800 553-2447For a complete list of Cisco TAC contacts, go to this URL:
http://www.cisco.com/techsupport/contacts
Definitions of Service Request Severity
To ensure that all service requests are reported in a standard format, Cisco has established severity definitions.
Severity 1 (S1)—Your network is "down," or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.
Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your business operation are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.
Severity 3 (S3)—Operational performance of your network is impaired, but most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels.
Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.
Obtaining Additional Publications and Information
Information about Cisco products, technologies, and network solutions is available from various online and printed sources.
•
http://www.cisco.com/go/marketplace/
•
•
•
http://www.cisco.com/go/iqmagazine
or view the digital edition at this URL:
http://ciscoiq.texterity.com/ciscoiq/sample/
•
•
http://www.cisco.com/en/US/products/index.html
•
http://www.cisco.com/discuss/networking
•
http://www.cisco.com/en/US/learning/index.html
This document is to be used in conjunction with the documents listed in the Related Documentation section.
CCSP, CCVP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, The Fastest Way to Increase Your Internet Quotient, and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or Website 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. (0601R)
Copyright © 2007 Cisco Systems, Inc. All rights reserved.
Guest
