Table Of Contents
Configuring and Using Location Appliances
Configuring Location Appliances
Adding a Location Appliance to the Cisco WCS Database
Editing a Contact, User Name, Password, and HTTP/HTTPS Selection
Synchronizing Location Appliance and Cisco WCS Network Designs
Synchronizing Controllers and Location Appliances
Editing Location Appliance Polling Parameters
Editing Location Appliance History Parameters
Editing Location Appliance Location Parameters
Managing Location Appliance User Groups
Adding Location Appliance Host Access
Deleting Location Appliance Host Access
Editing Location Appliance Advanced Parameters
Clearing Location Appliance Configurations
Deleting a Location Appliance from the Cisco WCS Database
Operating Location Appliances
Managing Location Appliance Alarms and Events
Backing Up Location Appliance Historical Data
Restoring Location Appliance Historical Data
Viewing Controller and Location Appliance Synchronization Status
Re-Synchronizing Controller and Location Appliance Databases
Viewing Location Appliance Current Status
Downloading Location Appliance Log Files to Your Cisco WCS Terminal
Downloading Application Code to a Location Appliance using Cisco WCS
Defragmenting the Location Appliance Database
Running Java GC on the Location Appliance Memory
Restarting the Location Appliance Application Software
Rebooting the Location Appliance
Configuring and Using Location Appliances
Cisco 2700 Series Location Appliances are servers that collect and store up to 30 days of historical location data for up to 1,500 laptop clients, palmtop clients, VoIP telephone clients, Radio Frequency Identifier (RFID) asset tags, rogue access points, and rogue access point clients.
Each location appliance must be initially configured using a CLI console session as described in the Cisco 2700 Series Location Appliance Quick Start Guide. After the location appliance is initially configured, the rest of the configuration and operation tasks are controlled using Cisco WCS.
This chapter describes how to configure and use location appliances. This chapter contains these sections:
•
Configuring Location Appliances
• Operating Location Appliances
Configuring Location Appliances
After initial configuration, location appliances are easy to configure using Cisco WCS version 3.0 or later. These sections describe the tasks required to complete the location appliance configuration:
• Adding a Location Appliance to the Cisco WCS Database
• Editing a Contact, User Name, Password, and HTTP/HTTPS Selection
• Synchronizing Location Appliance and Cisco WCS Network Designs
• Synchronizing Controllers and Location Appliances
• Editing Location Appliance Polling Parameters
• Editing Location Appliance History Parameters
• Editing Location Appliance Location Parameters
• Managing Location Appliance User Groups
• Adding Location Appliance Host Access
• Deleting Location Appliance Host Access
• Editing Location Appliance Advanced Parameters
• Clearing Location Appliance Configurations
• Deleting a Location Appliance from the Cisco WCS Database
Adding a Location Appliance to the Cisco WCS Database
Log into WCS and follow these steps to add a location appliance to the WCS database:
Step 1 Verify that you can ping the location appliance from the Cisco WCS Server. If not, correct the connection between WCS and the location appliance.
Step 2 Select LOCATE to display the All Location Appliances page.
Step 3 In the right-hand command drop-down menu, select Add Server and click GO to display the Location Appliance > General Properties > New page.
Step 4 (Optional) Enter a name for the location appliance.
Step 5 Enter the location appliance IP Address.
Step 6 (Optional) Enter a contact name for the location appliance.
Step 7 Change the username and password for the location appliance. The default username and password are both admin.
Step 8 Change the port setting. The default port is 8001.
Step 9 Enable or disable HTTPS. HTTPS is disabled by default.
Step 10 Click Save. Cisco WCS searches for the location appliance and adds it to the Cisco WCS database.
Note When the WCS database has network designs (campus, building, or outdoor maps) or controllers that are not yet assigned to a location appliance, WCS might redirect you to the Synchronize Cisco WCS and Location Appliance(s) page. When Cisco WCS does this, complete the steps in the Synchronizing Location Appliance and Cisco WCS Network Designs section or in the Synchronizing Cisco Wireless LAN Controllers and Location Appliances section.
Step 11 Navigate to the All Location Appliances page and click Refresh. Verify that the location appliance appears on the page.
Editing a Contact, User Name, Password, and HTTP/HTTPS Selection
After you add a location server to the WCS database, follow these steps in the Cisco WCS interface to edit the general properties of the location server:
Step 1 Select LOCATE to display the All Location Appliances page.
Step 2 Click a Server Name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Make the required changes to the Contact Name, User Name, Password, and/or HTTP/HTTPS settings.
Step 4 Click Save to update the Cisco WCS and location appliance databases.
Synchronizing Location Appliance and Cisco WCS Network Designs
After you add a location appliance to the WCS database you can add (synchronize) Cisco WCS campus, building, and outdoor maps (Network Designs) to the location appliance database. After the Network Designs are stored in the Cisco WCS and location appliance databases, you can re-synchronize the two databases at any time.
Follow these steps to synchronize the WCS network designs with the location server network designs:
Step 1 Select LOCATE to display the All Location Appliances page.
Step 2 In the right-hand command drop-down menu, select Synchronize Servers and click GO to display the Synchronize Cisco WCS and Location Appliance(s) page.
Step 3 Select Synchronize Network Designs.
Step 4 In the required Network Design row, click Assign to display the Assign to servers popup window.
Step 5 In the Assign to servers window, check the required location appliance(s).
Step 6 Click OK to return to the Synchronize Cisco WCS and Location Appliance(s) page. The Assign button in the assigned Network Design row now has a star next to it.
Step 7 Click Synchronize to update the Cisco WCS and location appliance databases. When the Controller and location appliance databases are synchronized, the Sync. Status shows a green two-arrow icon.
Synchronizing Controllers and Location Appliances
After you add location appliances and controllers to the Cisco WCS database, you can synchronize controller databases with location appliance databases. After the controllers and location appliances are synchronized, you can re-synchronize any two databases at any time.
Note Before a location appliance can collect any data, it must be associated with one or more controllers.
Assigning Location Appliances to Controllers
Follow these steps to assign a location server to a controller:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 In the right-hand command drop-down menu, select Synchronize Servers and then click GO to display the Synchronize Cisco WCS and Location Appliance(s) page.
Step 3 In the Synchronize Cisco WCS and Location Appliance(s) page, select Synchronize Switches.
Step 4 Highlight the controller name and select the required location appliance name.
Step 5 Click Synchronize to associate (assign) the Controller and location appliance databases. When the Controller and location appliance databases are synchronized the Sync. Status shows a green two-arrow icon.
Unassigning Location Appliances to Controllers
Follow these steps to disassociate a location appliance from a controller:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 In the right-hand command drop-down menu, select Synchronize Servers and click GO to display the Synchronize Cisco WCS and Location Appliance(s) page.
Step 3 Select Synchronize Switches.
Step 4 Highlight the controller name and select --Unassigned-- for the location appliance name.
Step 5 Click Synchronize to unassign (disassociate) the Controller and location appliance databases. When you have successfully unassigned the Controller and location appliance databases, the Sync. Status shows a red two-arrow icon.
Editing Location Appliance Polling Parameters
After you add a location appliance to the WCS database you can modify the independent Client, Rogue Access Point, Asset Tag, and Statistics polling periods that the location appliance uses to poll its associated controllers. Note that these polling periods are independent of the number of times that WCS users request a data refresh from the location appliance.
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Polling Parameters to display the Location Appliance > Polling Parameters > appliance-name page.
Step 4 Configure these settings:
•Retry Count: Enter the number of times to retry a polling cycle between 1 and 99999. The default setting is 3. The Retry Count generally does not need to be changed from the default.
•Timeout: Enter the number of seconds for a polling timeout between 1 and 99999. The default setting is 5 seconds. The Timeout generally does not need to be changed from the default.
•Client Station Polling and Interval: Select the check box to turn Polling on, and enter the number of seconds between Client polling attempts between 1 and 99999. Polling is disabled by default with a 300-second interval. You might want to leave Client Polling disabled, and you might want to change the Polling Interval to a shorter value for more granular data collection or to a longer value for less granular data collection.
Note The Polling Interval is the period between the end of a preceding polling cycle and the beginning of the next polling cycle. That is, if the polling cycles take five minutes to complete, and the Polling Interval is ten minutes, the time between the start of polling cycles is fifteen minutes.
•Rogue AP Polling and Interval: Select the check box to turn Polling on, and enter the number of seconds between rogue access point polling attempts between 1 and 99999. Polling is disabled by default with a 600-second interval. You might want to leave rogue access point Polling off, and you might want to change the Polling Interval to a shorter or longer value for more or less granular data collection, respectively.
•Asset Tag Polling and Interval: Select the check box to turn Polling on, and enter the number of seconds between Asset Tag polling attempts between 1 and 99999. Polling is disabled by default with a 600-second interval. You might want to leave Asset Tag Polling off, and you might want to change the Polling Interval to a shorter or longer value for more or less granular data collection, respectively.
Note Before the location appliance can collect asset tag data, the controllers to which it is associated must have RFID status enabled through this CLI command: config rfid status enable.
•Statistics Polling and Interval: Select the check box to turn Polling on, and enter the number of seconds between Statistics polling attempts between 1 and 99999. Polling is disabled by default with a 900-second interval. You might want to leave Statistics Polling off, and you might want to change the Polling Interval to a shorter or longer value for more or less granular data collection, respectively.
Step 5 When you have made the required selections, click Save to store your selections in the Cisco WCS and location appliance databases.
Editing Location Appliance History Parameters
After you add a location appliance to the Cisco WCS database you can modify the client, rogue access point, and asset tag histories that the location appliance collects from its associated controllers. You can also program the location appliance to periodically prune duplicate data from its historical files to reduce the amount of data stored on its hard drive. WCS users can display the location appliance historical data at any time. Follow these steps to modify location appliance history settings:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the desired Server Name to have Cisco WCS display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click History Parameters to have Cisco WCS display the Location Appliance > History Parameters > appliance-name page.
Step 4 Configure these settings:
•Archive for: Enter the number of days for the location appliance to retain a history of each enabled category between 1 and 30 days. The default setting is 30 days.
•Prune data starting at: Enter the number of hours and minutes (between 0 and 23 hours, and between 1 and 59 minutes) for the location appliance to collect historical data before starting pruning, and enter the number of minutes between each pruning operation. Enter a setting between 0 (never) and 99900000. The default setting is 23 hours and 50 minutes, and the default interval is 1440 minutes.
•Client Station History and Interval: Select the check box to turn historical data collection on, and enter the number of minutes between historical data storage events between 1 and 99999. History collection is disabled by default, and the default interval is 360 minutes.
•Rogue AP History and Interval: Select the check box to turn historical data collection on, and enter the number of minutes between historical data storage events between 1 and 99999. History collection is disabled by default, and the default interval is 720 minutes.
•Asset Tag History and Interval: Select the check box to turn Historical data collection on, and enter the number of minutes between historical data storage events between 1 and 99999. History collection is disabled by default, and the default interval is 720 minutes.
Note Before the location appliance can collect asset tag data, the controllers to which it is associated must have RFID status enabled through this CLI command: config rfid status enable.
Step 5 Click Save to store your selections in the Cisco WCS and location appliance databases.
Editing Location Appliance Location Parameters
After you add a location appliance to the Cisco WCS database you can specify whether the location appliance retains its heatmap persistence, whether the location appliance retains its calculation times, and how soon the location appliance deletes its collected RSSI measurement times. WCS users can display the location appliance historical data at any time.
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Location Parameters to have Cisco WCS display the Location Appliance > Location Parameters > appliance-name page.
Step 4 Configure these settings:
•Enable heatmap persistence: Select the check box to have the location appliance retain its heatmap persistence. Heatmap persistence is disabled by default.
•Enable calculation time: Select the check box to have the location appliance retain its calculation times. Calculation time retention is disabled by default.
•Discard RSSI measurement time: Enter the number of minutes (between 0 and 99999 minutes) for the location appliance to retain its collected RSSI values. The default setting is 480 minutes. When the retention time elapses the location appliance purges its older RSSI values.
Step 5 Click Save to store your selections in the Cisco WCS and location appliance databases.
Managing Location Appliance User Groups
This section describes how to add, change, and delete users and user groups on location appliances.
Adding Location Appliance User Groups
WCS SuperUsers can add or delete user groups for location appliances. Follow these steps to add or delete a user group:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Groups to display the Location Appliance > Groups > appliance-name page.
Step 4 In the right-hand command drop-down menu, select Add Group and click GO to display the New Group page.
Step 5 Enter the new group name and assign a Read Access, Write Access, or Full Access permission for the group.
Step 6 Click Save to add the new group to the location appliance.
Changing Location Appliance User Group Permissions
WCS SuperUsers can change existing user group permissions on location appliances.
Note Group permissions override individual user permissions. A superuser could be configured with full read and write permissions, but if the superuser is assigned to a group with read-only permissions, the superuser cannot edit the location appliance configuration.
Follow these steps to change user group permissions:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Groups to display the Location Appliance > Groups > appliance-name page.
Step 4 Click a Group Name to have Cisco WCS display the Modify Group > group-name page.
Step 5 Change the group permission to Read Access, Write Access, or Full Access.
Step 6 Click Save to save the new user group permission to the location appliance.
Deleting Location Appliance User Groups
Log into WCS as a SuperUser and follow these steps to delete an existing user group from a location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Groups to display the Location Appliance > Groups > appliance-name page.
Step 4 Check the desired Group.
Step 5 In the right-hand command drop-down menu, select Delete Group and click GO to delete the group.
Step 6 Click OK to complete the deletion.
Adding Location Appliance Users
Log into WCS as a SuperUser and follow these steps to add a new user to the location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Users to have Cisco WCS display the Location Appliance > Users > appliance-name page.
Step 4 In the right-hand command drop-down menu, select Add User and click GO to display the New User page.
Step 5 Enter the new username, password, and an existing group name. Assign a Read Access, Write Access, or Full Access permission for the user.
Note Group permissions override individual user permissions. A superuser could be configured with full read and write permissions, but if the superuser is assigned to a group with read-only permissions, the superuser cannot edit the location appliance configuration.
Step 6 Click Save to add the new user to the location appliance.
Changing Location Appliance User Passwords, Group Names, and Permissions
Log into WCS as a SuperUser and follow these steps to change user values on the location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Users to have Cisco WCS display the Location Appliance > Users > appliance-name page.
Step 4 Click a Username to display the Modify User > username page.
Step 5 Change the User Password, the Group Name, or the user permission.
Step 6 Click Save to save the new user values to the location appliance.
Deleting Location Appliance Users
Log into WCS as a SuperUser and follow these steps to delete an existing user from the location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Users to have Cisco WCS display the Location Appliance > Users > appliance-name page.
Step 4 Select a user.
Step 5 In the right-hand command drop-down menu, select Delete User and click GO to delete the user.
Step 6 Click OK to complete the deletion.
Adding Location Appliance Host Access
WCS SuperUsers can add and delete host access on location appliances. Follow these steps to add a new host access:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Host Access to display the Location Appliance > Host Access > appliance-name page.
Step 4 In the right-hand command drop-down menu, select Add Host Access and click GO to display the New Host Access page.
Step 5 Enter the new host access and netmask, whether it is permitted (by default, host access is not permitted), a priority from 0 to 99999 (the default priority is 0), and start and end access from 0 to 23 Hours and 0 to 59 Minutes (the default access times are 0 hours and 0 minutes).
Step 6 Click Save to add the new host access to the location appliance.
Deleting Location Appliance Host Access
Log into WCS as a SuperUser and follow these steps to delete an existing host access:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Host Access to display the Location Appliance > Host Access > appliance-name page.
Step 4 Check the desired IP Address/netmask.
Step 5 In the right-hand command drop-down menu, select Delete Host Access and click GO to delete the host access.
Step 6 Click OK to complete the deletion.
Editing Location Appliance Advanced Parameters
Follow these steps to change these advanced parameters on the location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Advanced Parameters to display the Location Appliance > Advanced Parameters > appliance-name page.
Step 4 Change these settings as required:
•Current Logging Level (Trace, Information, Error, or Off). The default setting is Information. Leave this setting as Information unless directed to do otherwise by Cisco Technical Assistance Center (TAC).
•Enable or Disable Advanced Debugging. The default setting is Disabled. Leave this setting as Disabled unless directed to do otherwise by Cisco Technical Assistance Center (TAC).
•Current Number of Days to Keep Events. The default setting is 7 days. Change this value as required for monitoring and troubleshooting.
•Current Session Timeout in minutes. The default setting is 30 minutes. Change this value as required for monitoring and troubleshooting.
•Current Cleanup Data Interval in minutes. The default setting is 7 days. Change this value as required for monitoring and troubleshooting.
Step 5 Click Save to update the Cisco WCS and location appliance databases.
Clearing Location Appliance Configurations
Follow these steps to clear the location appliance configuration and restore the factory defaults:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Advanced Parameters to display the Location Appliance > Advanced Parameters > appliance-name page.
Step 4 Select Clear Configuration.
Step 5 Click OK to clear the location appliance configurations.
Deleting a Location Appliance from the Cisco WCS Database
Follow these steps in the Cisco WCS interface to delete a location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Select the desired location appliance check boxes.
Step 3 Select Delete Server(s) and click GO. WCS displays this message:
Are you sure you want to delete the selected Location Appliance(s)?
Step 4 Click OK to delete the location appliance(s) from the WCS database.
Operating Location Appliances
This section describes how to operate the location appliance. This section contains these sections:
• Managing Location Appliance Alarms and Events
• Backing Up Location Appliance Historical Data
• Restoring Location Appliance Historical Data
• Viewing Controller and Location Appliance Synchronization Status
• Re-Synchronizing Controller and Location Appliance Databases
• Viewing Location Appliance Current Status
• Downloading Location Appliance Log Files to Your Cisco WCS Terminal
• Downloading Application Code to a Location Appliance using Cisco WCS
• Defragmenting the Location Appliance Database
• Running Java GC on the Location Appliance Memory
• Restarting the Location Appliance Application Software
• Rebooting the Location Appliance
Managing Location Appliance Alarms and Events
This section describes how to view, assign, and clear alarms and events on the location appliance.
Viewing Location Appliance Alarms
Follow these steps to view location appliance alarms:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Alarms to display the Alarms page.
Step 4 In the Alarms page left navigation bar, select the required Alarm Severity and Alarm Category, and click Search to display the selected alarms page.
Assigning and Unassigning Location Appliance Alarms
Follow these steps to assign and unassign an alarm to yourself:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Alarms to display the Alarms page.
Step 4 In the left navigation bar, select the required Alarm Severity and Alarm Category, and click Search to display the selected alarms page.
Step 5 Select the check box(es) of the alarm(s) you are assigning to or unassigning from yourself.
Step 6 In the selected Alarms page right drop-down menu, select Assign to Me or Unassign.
Deleting and Clearing Location Appliance Alarms
Follow these steps to delete or clear an alarm from a location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Alarms to display the Alarms page.
Step 4 In the left navigation bar, select the required Alarm Severity and Alarm Category, and click Search to display the selected alarms page.
Step 5 Select the check box(es) of the alarm(s) you are deleting or clearing.
Step 6 In the selected Alarms page right drop-down menu, select Delete or Clear.
Viewing Location Appliance Alarm Events
The location appliance database retains up to 1000 alarm events, so you can view the most recent 1000 events on the appliance. Follow these steps to view alarm events:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 Click Events to display the Alarm > Events page.
Step 4 In the left navigation bar, select the required Event Severity and Event Category, and click Search to display the selected Alarm > Events page.
Step 5 To view more detail for an event, click on a Failure Object name to display the selected Alarm > Events > Location Appliance appliance-name page.
Viewing Location Appliance Events
Follow these steps to download a zipped log file from a location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Events to display the Location Appliance > Events > appliance-name page. The Events include a Timestamp, Severity, the Event, and associated Facility.
Backing Up Location Appliance Historical Data
Follow these steps to back up the historical data from location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Backup to display the Location Appliance > Backup Operation > appliance-name page. The backup is always stored in the
C:\Program Files\Cisco WCS30\webnms\.\ftp-server\root Windows Cisco WCS directory.
Step 4 In the Location Appliance > Backup Operation > appliance-name page, verify or change the Backup filename. Do not include spaces in the filename.
Step 5 Enter the number of seconds for a backup timeout between 1 and 999. The default setting is 5 seconds. The Timeout generally does not need to be changed from the default.
Step 6 Click Submit to back up the historical data to the Cisco WCS Server hard drive. The backup is completed when Cisco WCS displays this message:
Backup has been completed.
Restoring Location Appliance Historical Data
You can restore backed-up historical data from Cisco WCS to location appliance. Follow these steps to restore historical data to a location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Restore to display the Location Appliance > Restore Operation > appliance-name page. The backup is always stored in the C:\Program Files\Cisco WCS30\webnms\.\ftp-server\root Windows Cisco WCS directory.
Step 4 In the Location Appliance > Backup Operation > appliance-name page, select the backed-up historical data file to restore.
Step 5 Enter the number of seconds for a restore timeout between 1 and 999. The default timeout is 5 seconds. The Timeout generally does not need to be changed from the default.
Step 6 Click Submit to start the restore process.
Step 7 Click OK to restore the historical data from the Cisco WCS Server hard drive.
The restoration is complete is task is completed when Cisco WCS displays this message:
Restore has been completed.
Viewing Controller and Location Appliance Synchronization Status
After synchronizing (associating) controller and location appliance databases you can follow these steps to view their synchronization status:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 In the right-hand command drop-down menu, select Synchronize Servers and click GO to display the Synchronize Cisco WCS and Location Appliance(s) page.
Step 3 Select Synchronize Switches. When the Controller and location appliance databases are synchronized, the Sync. Status shows a green two-arrow icon. When the Controller and location appliance databases are not synchronized, the Sync. Status shows a red two-arrow icon.
Re-Synchronizing Controller and Location Appliance Databases
After synchronizing (associating) controller and location appliance databases, follow these steps to re-synchronize them:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 In the right-hand command drop-down menu, select Synchronize Servers and click GO to display the Synchronize Cisco WCS and Location Appliance(s) page.
Step 3 Select Synchronize Switches.
Step 4 Highlight the controller name and select the required location appliance name.
Step 5 Click Synchronize to synchronize the Controller and location appliance databases.
When the Controller and location appliance databases are synchronized, the Sync. Status shows a green two-arrow icon. When the Controller and location appliance databases are unsynchronized, the Sync. Status shows a red two-arrow icon.
Viewing Location Appliance Current Status
Follow these steps to view the current status of a location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Advanced Parameters to display the Location Appliance > Advanced Parameters > appliance-name page. You can view these settings:
•Product Name
•Application Code Release
Note After you upgrade the location appliance software the old release version might show in the Cisco WCS User Interface. However, the version is refreshed when WCS contacts the location appliance at the next refresh interval.
•Time the location appliance Started
•Current location appliance Time
•Number of location appliance Restarts
•Number of active User Sessions
•Current Logging Level (Trace, Information, Error, or Off)
•Current Number of Days to Keep Events
•Whether or not Advanced Debugging is Enabled or Disabled
•Current Session Timeout in minutes
•Current Cleanup Data Interval in minutes
•Memory Used by the location appliance
•Memory Allocated to the location appliance
•Maximum Memory in the location appliance
•Database Virtual Memory Allocated to the location appliance
Downloading Location Appliance Log Files to Your Cisco WCS Terminal
Follow these steps to download a zipped log file from a location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Logs to display the Location Appliance > Log Files > appliance-name page.
Step 4 Click Download Logs to start the download process. To view the downloaded file, click Open.
Step 5 Click Save to download the zipped log files to your Cisco WCS terminal. To view the downloaded file, click Open.
Downloading Application Code to a Location Appliance using Cisco WCS
Follow these steps to download software to a location appliance:
Step 1 Verify that you can ping the location appliance from the Cisco WCS Server or an external FTP server, whichever you are going to use for the application code download. If not, correct the connection between Cisco WCS or the FTP server and the location appliance.
Step 2 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 3 Click the server to display the Location Appliance > General Properties > appliance-name page.
Step 4 In the left navigation bar, click Download Software to display the Location Appliance > Transfer Software > appliance-name page.
Step 5 To use software in the WCS directory, select the Select from uploaded images to transfer into the Location Appliance radio button and use the drop-down menu to select the required location appliance application code (ls-install-x-x-x-x.bin, where x-x-x-x is the application code revision) from those already in the Windows Cisco WCS C:\Program Files\Cisco WCS30\webnms\ftp-server\root directory or the Linux Cisco WCS directory.
To use software in an FTP directory, select the Browse a new software image to transfer into the Location Appliance radio button and use the drop-down menu to select the required location appliance application code (ls-install-x-x-x-x.bin, where x-x-x-x is the application code revision) from those already in an FTP server root directory.
Step 6 Enter the number of seconds for a restore timeout between 1 and 999. The default timeout is 5 seconds. The timeout generally does not need to be changed from the default.
Step 7 Click Download to send the application code to the location appliance /opt/locserver/installers directory.
Defragmenting the Location Appliance Database
Follow these steps to defragment the location appliance database:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Advanced Parameters to display the Location Appliance > Advanced Parameters > appliance-name page.
Step 4 Select Defragment Database.
Step 5 Click OK to defrag the location appliance database.
Running Java GC on the Location Appliance Memory
Follow these steps to run Java General Cleanup to free up memory on a location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Advanced Parameters to display the Location Appliance > Advanced Parameters > appliance-name page.
Step 4 Select Run Java GC.
Restarting the Location Appliance Application Software
Follow these steps to restart the location appliance software at any time:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Advanced Parameters to display the Location Appliance > Advanced Parameters > appliance-name page.
Step 4 Select Restart Server.
Step 5 Click OK to restart the location appliance application software. The reboot takes a few minutes to complete.
Rebooting the Location Appliance
Follow these steps to reboot the location appliance:
Step 1 In the Cisco WCS interface, select LOCATE to display the All Location Appliances page.
Step 2 Click the server name to display the Location Appliance > General Properties > appliance-name page.
Step 3 In the left navigation bar, click Advanced Parameters to display the Location Appliance > Advanced Parameters > appliance-name page.
Step 4 Select Reboot Hardware.
Step 5 Click OK to reboot the location appliance. The reboot takes a few minutes to complete.
