Table Of Contents
FAQs and Troubleshooting
General FAQs and Troubleshooting
General FAQs
General Troubleshooting
Faults FAQs and Troubleshooting
Faults FAQs
Faults Troubleshooting
Devices FAQs and Troubleshooting
Devices FAQs
Devices Troubleshooting
Configuration FAQs and Troubleshooting
Configuration FAQs
Configuration Troubleshooting
Firmware FAQs and Troubleshooting
Firmware FAQs
Firmware Troubleshooting
Reports FAQs and Troubleshooting
Reports FAQ
Reports Troubleshooting
Radio Manager FAQs and Troubleshooting
Radio Manager FAQs
Radio Manager Troubleshooting
Administration FAQs and Troubleshooting
Administration FAQs
Administration Troubleshooting
FAQs and Troubleshooting
This chapter provides troubleshooting and FAQs for WLSE software.
Note 
For the most up to date FAQs and troubleshooting information, see the FAQ and Troubleshooting Guide for the Wireless LAN Solution Engine, Release 2.5 on Cisco.com.
This chapter provides the following frequently asked questions and troubleshooting information:
•General Questions—See General FAQs and Troubleshooting
•Faults Tab—Faults FAQs and Troubleshooting
•Devices Tab—Devices FAQs and Troubleshooting
•Configuration Tab—Configuration FAQs and Troubleshooting
•Firmware Tab—Firmware FAQs and Troubleshooting
•Reports Tab—Reports FAQs and Troubleshooting
•Radio Manager Tab—Radio Manager FAQs and Troubleshooting
•Administration Tab—Administration FAQs and Troubleshooting
General FAQs and Troubleshooting
•General FAQs
•General Troubleshooting
General FAQs
•Can several users be logged on and managing the same access point at once?
•What ports and protocols does the WLSE use?
•Can I use a different HTTP port to manage the access point?
•Is Telnet enabled or disabled by default on the WLSE?
•Can SSH be disabled?
•Can I run a job to convert a number of access points from non-IOS to IOS?
Q. Can several users be logged on and managing the same access point at once?
A. Yes, several users can view data and reports on the same access point. More than one user can create configuration and firmware update jobs for the same access point and these will be run in the order they are scheduled. Configuration templates may be modified by more than one user at the same time and the last write will overwrite the others.
Q. What ports and protocols does the WLSE use?
A. For discovery and fault monitoring, the WLSE primarily uses SNMP (UDP port 161). For applying configuration changes, the WLSE uses SNMP, HTTP (TCP port 80 or as configured), and TFTP (UDP port 69).
Q. Can I use a different HTTP port to manage the access point?
A. Yes, the HTTP port can be changed on the access point. The change will be reflected in WLSE after the next inventory cycle, or if you choose to run inventory now for the devices on which HTTP port was changed. This is assuming the inventory is done by SNMP and not HTTP.
Q. Is Telnet enabled or disabled by default on the WLSE?
A. Telnet is disabled by default for security reasons. SSH is enabled by default.
Q. Can SSH be disabled?
A. It cannot be disabled on the WLSE itself, but you can use the firewall command to deny all SSH connections. For example, the following CLI command will cause the WLSE to reject all incoming SSH connections on the Ethernet 0 interface but allows connections through other protocols and other ports:
firewall ethernet0 private firewall ethernet0 private ssh
Q. Can I run a job to convert a number of access points from non-IOS to IOS?
A. Yes, you can run a firmware job, using a special IOS upgrade image that is available on Cisco.com. For more information, see the firmware upgrade information in the online help or the User Guide for the CiscoWorks Wireless LAN Solution Engine, Release 2.5.
General Troubleshooting
This section provides the following troubleshooting information:
•After the WLSE reboots, the login screen appears, followed by an Internal Server Error message.
•A search for an access point using APs Based on Client IP, displays the following message, "search yielded no results."
•When I try to access an access point web page through the WLSE, the following error message appears: Action Cancelled.
•Cannot recover after incorrect setup program entry.
•Cannot log into the system.
•Cannot log in as a system administrator.
•After the WLSE starts up, the setup login prompt appears. The WLSE cannot connect to the network.
•Cannot connect to the WLSE using a Web browser.
•The system time or date is incorrect.
•The system cannot boot from the hard drive during a reboot.
Symptom After the WLSE reboots, the login screen appears, followed by an
Internal Server Error message.
Possible Cause The servlet engine in the WLSE is starting up.
Recommended Action Wait for 20 to 30 seconds, then log in again.
Symptom A search for an access point using APs Based on Client IP, displays the
following message, "search yielded no results."
Possible Cause The device you are searching for is an IOS device. This type
of search only works for non-IOS devices.
Recommended Action None.
Symptom When I try to access an access point web page through the WLSE, the
following error message appears: Action Cancelled.
Possible Cause The SNMP user on the access point does not have enough
rights.
Recommended Action Log in to the access point web interface, select Setup >
Security > User Information, and make sure that the user corresponding to the
SNMP community (which is set up in the WLSE under Discovery > Device
Credentials) has been granted rights for the following: firmware, admin, and
snmp.
Symptom Cannot recover after incorrect setup program entry.
Possible Cause You entered incorrect text during the initial setup and want to
fix the entry.
Recommended Action Exit setup by pressing Ctrl-c. Then run erase config to
remove the incorrect installation information and rerun the setup program. If
you use the erase config command to erase the previous WLSE configuration,
and run the setup program again, you will be required to get a new certificate.
Use the mkcert command or Administration > Appliance > Security > SSL
(HTTPS).
Symptom Cannot log into the system.
Possible Cause You did not run the setup program to create an initial system
configuration or you lost all the user account passwords.
Recommended Action
1. Did you run the setup program after booting the system for the first time?
If no, run the setup program.
If yes, continue to the next step.
2. Do you know the password for any system user accounts?
If no, see Cannot log in as a system administrator..
If yes, continue to the next step.
3. If you are certain you entered a valid username and password, contact Cisco's Technical Assistance Center for assistance.
Symptom Cannot log in as a system administrator.
Possible Cause All administrator passwords have been lost.
Recommended Action Perform the following procedure:
1. Connect a console to the WLSE's console port.
For the WLSE 1105, use the serial port on the front panel; do not use the serial port on the back panel as a console port.
For the WLSE 1130, the serial/console port is on the back panel.
2. Power the system off, then power it back on. The following prompt appears:
3. Press the Tab key. The following prompt appears:
4. Enter the following command. This puts the WLSE in maintenance image mode.
5. Enter the following command. This erases the WLSE's configuration, returns the WLSE to factory defaults, and reloads the WLSE.
[root@CiscoMaintImage/]# erase config
Symptom After the WLSE starts up, the setup login prompt appears. The WLSE
cannot connect to the network.
Possible Cause
–The network cable is not connected to the Ethernet 0 port.
–The Ethernet 0 interface is disabled or misconfigured.
–The system is configured correctly, but the network is down or misconfigured.
–DNS is misconfigured. Ping commands will result in a 50-70% failure rate in Pings from the WLSE (Web interface and CLI).
Recommended Action
1. Verify that the network cable is connected to the Ethernet 0 port and the Ethernet indicator is lit.
–If the network cable is not connected, connect it.
–If the network cable is connected but the Ethernet indicator is not lit, these are the probable causes:
The network cable is faulty.
The network cable is the wrong type (for example, a cross-over type, rather than the required straight-through type).
The port on the default gateway to which the system connects is down.
–If the network cable is connected and the Ethernet indicator is on but the system cannot connect to the network, continue to the next step.
2. Use the ping command to perform the following tests:
–Try to ping a well-known host on the network. A DNS server is a good target host.
If the ping command gets a response, the system is connected to the network. If the system cannot connect to a particular host, the problem is either with the network configuration or that host. Contact your network administrator for assistance.
If the ping command does not get a response, continue.
–Attempt to connect to another host on the same subnet as the system.
If the ping command can connect to a host on the same subnet, but cannot connect to a host on a different subnet, the default gateway is probably down.
If the ping command cannot connect to any hosts, continue to the next step.
3. Use the show interfaces command to determine if the Ethernet 0 interface is disabled or misconfigured.
If the Ethernet 0 interface is disabled, enable it. If it is misconfigured, configure it correctly. For more information, see the Installation and Configuration Guide for the CiscoWorks Wireless LAN Solution Engine.
If the interface is enabled and correctly configured, continue to the next step.
4. Contact your network administrator to verify that there are no conditions on the network that prevent the system from connecting to the network.
If conditions prevent the system from connecting to the network, have your network administrator correct them.
5. If no conditions are preventing the system from connecting to the network, contact Cisco's Technical Assistance Center.
Symptom Cannot connect to the WLSE using a Web browser.
Possible Cause
–The system cannot connect to the network.
–HTTP or HTTPS is not enabled
–If connecting via HTTP, the IP address was not appended with :1741.
–The client system is not configured.
Recommended Action
1. Make sure that the system can connect to the network. Attempt to connect the system using a Web browser.
If you cannot connect, continue.
2. If you are attempting to connect via HTTP, verify that the IP address is appended with :1741.
3. If you are attempting to connect via HTTP, verify that HTTP is enabled. If you are attempting to connect via HTTPS, verify that HTTPS is enabled. For more information, see the Installation and Configuration Guide for the CiscoWorks Wireless LAN Solution Engine.
4. Verify that the browser is configured correctly, and attempt to connect to the WLSE. For more information, see these Installation and Configuration Guide for the CiscoWorks Wireless LAN Solution Engine. If you cannot connect, continue to step 5.
5. At the system console, or through Telnet, verify that the Web Server and tomcat are running by entering the following:
If they are running, go to step 7. If they are not running
continue to step 6.
6. Stop the system services by entering the following:
7. Restart the system services by entering the following:
8. Try to connect the system using a Web browser.
If you cannot connect, continue to the next step.
9. Reboot the system by entering the reload command.
d. If you still cannot connect to the system using a Web browser, contact Cisco's Technical Assistance Center for assistance.
Symptom The system time or date is incorrect.
Possible Cause
–NTP is misconfigured.
–The system clock is set incorrectly.
Recommended Action Make sure NTP is configured correctly and that the
system clock is set correctly.
Symptom The system cannot boot from the hard drive during a reboot.
Possible Cause
–The disk has a physical error.
–The disk image is corrupted.
Recommended Action If the WLSE cannot boot from the hard drive, the hard
drive needs to be reimaged. Use the Recovery CD to reimage your WLSE. For
more information, see .
Symptom Cannot connect to system with Telnet or Telnet interaction is slow.
Possible Cause
–Telnet is disabled or configured incorrectly.
–The WLSE cannot recognize host names.
If you are not using name recognition, slow or non-existent telnet interaction is an expected problem.
Note Telnet is disabled by default. SSH is enabled by default.
Recommended Action
If the problem is not the network, perform the following steps. Connect to the console port if you cannot Telnet to the WLSE.
1. Check the Telnet settings to be sure Telnet is enabled and configured correctly. For more information, see the following
To check the Telnet settings, or to enable or disable Telnet on specific domains or IP addresses, use the telnetenable CLI command.
To enable or disable Telnet on individual ports, use the firewall CLI command.
2. If you have specified hosts using the telnetenable CLI command, make sure the host from which you are attempting to Telnet is on the list.
3. If you are using a DNS server, perform the following step:
Configure the system to use a functioning DNS server by entering:
# ip name-server ip-address
where ip-address is the IP address of the DNS server.
If you are using the import CLI command, proceed to the next step.
4. Verify that the system can get DNS services from the network by entering the following command:
# nslookup dns-name {hostname | ip-address}
where dns-name is the DNS name of a host on the network that is registered in DNS and hostname and ip-address is the same IP address specified in 2. The command returns the IP address of the host.
5. If the system cannot resolve DNS names to IP addresses, the DNS server it is using is not working properly.
Resolve the network DNS problem, then continue.
6. If you are using the import CLI command to resolve host names, verify that the WLSE can resolve host names by entering the following command:
where hostname is a host name that has been mapped to an IP address, or imported in a host file, using the import command.
7. If the system can resolve DNS names to IP addresses but you still cannot connect to the system using Telnet, or Telnet interaction with the system is extremely slow, contact Cisco's Technical Assistance Center.
Faults FAQs and Troubleshooting
Note For an explanation of the faults displayed under Faults > Display Faults, see the FAQ and Troubleshooting Guide for the Wireless LAN Solution Engine, Release 2.5 on Cisco.com.
•Faults FAQs
•Faults Troubleshooting
Faults FAQs
•Does acknowledging a fault clear it?
•What traps are sent from the WLSE?
•What trap types are forwarded by the WLSE?
•Does a MIB or trap definition file exist for the WLSE?
•What information is emailed in a fault notification?
Q. Does acknowledging a fault clear it?
A. No, it only removes it from the Active list. For a description of fault states, see the information on understanding fault states in the online help.
Q. What traps are sent from the WLSE?
A. Traps are sent based on fault policy and threshold settings on the WLSE. The WLSE only sends out v2c traps, so make sure your trap listener is configured to accept v2c traps.
Solaris 2.8- based NetView 7.1 receives and displays the SNMP v2c fault notification traps from WLSE, but Windows-based NetView 7.1 supports only v1 traps and cannot receive and display any v2c traps from the WLSE.
Q. What trap types are forwarded by the WLSE?
A. No traps are forwarded from other devices.
Q. What information is emailed in a fault notification?
A. For a description see the online help.
Q. Does a MIB or trap definition file exist for the WLSE?
A. Yes, from the Cisco.com download site, download MIB CISCO-DEVICE-EXCEPTION-REPORTING-MIB.my and load it into the trap receiver.
Faults Troubleshooting
•The Display Fault view is blank.
•Email fails to arrive at its destination.
•No VLAN fault information is displayed for IOS access points.
Symptom The Display Fault view is blank.
Possible Cause There are no faults to report based on the filtering criteria you
entered.
Recommended Action Not applicable.
Symptom Email fails to arrive at its destination.
Possible Cause The SMTP server is not configured properly.
Recommended Action Configure the SMTP server by selecting Administration
> Appliance > Configure Mailroute.
Symptom No VLAN fault information is displayed for IOS access points.
Possible Cause WEP keys have not been configured in each VLAN. When the
WEP keys are configured in the IOS access points, VLAN information is
accessible by SNMP.
Recommended Action Configure the WEP keys for the corresponding VLAN.
Devices FAQs and Troubleshooting
•Devices FAQs
•Devices Troubleshooting
Devices FAQs
•Why is hostname (device name), sysContact, and sysLocation information not updated in the WLSE after I change these parameters on the access point?
•What is an invalid CDP seed?
•Can I discover devices if CDP is disabled?
•What are the extra inventories listed in the Run Now folder?
•What are the results of adding or removing an interface from an access point?
Q. Why is hostname (device name), sysContact, and sysLocation information not updated in the WLSE after I change these parameters on the access point?
A. The hostname (device name), sysContact, and sysLocation parameters are updated during discovery, not during inventory. Make sure you schedule a periodic discovery under Administration > Discover > Scheduled Discovery.
Q. What is an invalid CDP seed?
A. An invalid seed is a device that does not run Cisco Discovery Protocol (CDP), such as a PC or workstation). Such a device does not function as a seed because it does not allow the WLSE to traverse the network and find other devices. In the discovery run log, invalid seeds are shown as SNMP unreachable.
Q. Can I discover devices if CDP is disabled?
A. If CDP is disabled on network devices, you can still discover access points by entering the IP addresses of all of them on the WLSE as seed values. However, the WLSE cannot discover switches directly attached to such access points, and switch-related reports will be empty.
Q. What are the extra inventories listed in the Run Now folder?
A. The radio management module runs periodic immediate inventories.
Q. What are the results of adding or removing an interface from an access point?
A. If you physically remove an interface (for example, removing 11b from a dual-interface AP 1200), the WLSE will automatically detect the change during the next inventory cycle. If you physically add an interface, you must delete the device and rediscover it. Otherwise, the inventory data might be invalid.
Devices Troubleshooting
This section contains the following troubleshooting information:
•Devices were discovered but are not displayed in the GUI; for example, in Reports.
•There is a time discrepancy in the scheduled discovery jobs.
•Devices are placed in Misconfigured Devices group after discovery.
•The SNMP Query Authorization Exception is recorded in the discovery log.
•Frequent client inventories are causing too much network traffic or degrading WLSE performance.
•Inventory is taking longer than expected and a message about no logs available appears in the inventory log.
Symptom Devices were discovered but are not displayed in the GUI; for example,
in Reports.
Possible Cause The devices have not been moved to the Managed state.
Recommended Action Select Administration > Discover > Managed Devices.
Move the devices from New or Unmanaged to Managed.
Intermediate switches with no access points directly connected to them are shown to be discovered in the Administration > Tasks History > Discovery logs but will not show up in Administration > Discover > Managed Devices > Manage/Unmanage.
Symptom There is a time discrepancy in the scheduled discovery jobs.
Possible Cause The local or system time is not set correctly on the WLSE.
Recommended Action
a. Reset the WLSE system time (UTC) using CLI commands as follows:
Enter services stop to stop services.
Enter the clock command to reset the time.
Enter services start to restart the services.
b. Set the local browser time. Select Administration > Appliance > Time/NTP/Name.
Symptom Devices are placed in Misconfigured Devices group after discovery.
Possible Cause IOS devices are not configured correctly with an ISO view.
The dot11mib fault appears for these devices.
Recommended Action Perform the following tasks on the devices and the
WLSE. Either configure the devices individually or create a configuration
template with the relevant custom values and create a job for the devices.
To configure devices individually:
a. Use Telnet or SSH to log in to the device, then enter enable mode.
b. In global configuration mode, enter the following commands in sequence:
# snmp-server view iso iso included
# snmp-server community community_string view iso RO
where community_string is the device's read-only community string. This is the same string that should exist in the WLSE's SNMP credentials screen (Devices > Discover > Device Credentials > SNMP Communities). If it is not entered there, see the following instructions for entering device credentials in the WLSE.
c. Exit from the global configuration mode, and enter the following command:
To configure devices by using a template:
a. Use the procedures in the configuration template instructions in the online help or the User Guide for the CiscoWorks Wireless LAN Solution Engine, 2.5 to create a template.
b. Enter the following custom values in the template:
snmp-server view iso iso included
snmp-server community community_string view iso RO
Run a configuration job on the devices in the Misconfigured Devices group:
Select the template created in the previous step.
Either select the Misconfigured Devices group or the devices in the group.
Schedule the job to run at the desired time.
c. After the configuration job finishes successfully, the dot11 mib fault will be cleared after the next discovery cycle. You can run a manual discovery immediately after the configuration job finishes; select Devices > Discover > Run Inventory > Run Now.
–Perform the following steps on the WLSE:
a. If the device's ISO community string has not been entered on the WLSE, select Devices > Discover > Device Credentials > SNMP Communities. Then, enter the same community strings that you configured on the devices in the previous procedure.
Otherwise, the devices will be placed back in the Misconfigured Devices group after the next discovery cycle.
b. Rediscover the devices by using them as seed devices in an immediate discovery. Select Devices > Discover > Run Inventory > Run Now. For more information on discovery, see the online help discovery section or the User Guide for the CiscoWorks Wireless LAN Solution Engine, Release 2.5.
Symptom The SNMP Query Authorization Exception is recorded in the
discovery log.
Possible Cause The community string on the access point does not have admin
and firmware rights.
Recommended Action In the configuration template or on the access point,
assign the missing rights to the community string. For more information, see
the information on setting up devices in the online help or the User Guide for
the CiscoWorks Wireless LAN Solution Engine, Release 2.5.
Symptom Frequent client inventories are causing too much network traffic or
degrading WLSE performance.
Possible Cause Running frequent client inventories when managing large
numbers of access points (1,000 or more) generates a great deal of traffic and
may degrade WLSE performance.
Recommended Action Increasing the Wireless Client Poll Interval in Devices >
Discover > Inventory > Polling will reduce the polling frequency. If you need
more frequent client polling for a subset of your access points, use the
Scheduled Inventory feature instead (Devices > Discover > Inventory > Run
Inventory).
Symptom Inventory is taking longer than expected and a message about no logs
available appears in the inventory log.
No logs available. Waiting for resources to start job.
Possible Cause If there are also SNMP timeouts on the network, inventory
jobs will take much longer. Other jobs may be using all of the available
resources. Also, the next scheduled inventory will not run until the current
inventory finishes.
Recommended Action None.
Configuration FAQs and Troubleshooting
•Configuration FAQs
•Configuration Troubleshooting
Configuration FAQs
•If I create a configuration template that includes WEP key settings how can I verify that they were set on the access point (the access point does not show WEP key settings on its web interface)?
•Can you undo a configuration update?
•How long is the configuration job history kept in the WLSE?
•Do jobs use HTTP or SNMP to initiate a configuration upload?
•Is it necessary to validate a job?
•What kinds of job logs are available?
•What is startup configuration?
•If I make changes to the startup template, will those modifications be automatically uploaded to the access points that already had that startup template applied?
•What is auto configuration?
Q. If I create a configuration template that includes WEP key settings how can I verify that they were set on the access point (the access point does not show WEP key settings on its web interface)?
A. For security reasons, the access point does not show or send WEP key information. One of the ways to verify the update is to look at the WEP Key length. The only way to verify the contents of the WEP key is to try associating a client that uses that WEP key.
Q. Can you undo a configuration update?
A. Yes, but only for successful jobs and device versions 11.23T and above for the 340 and 350 access points and bridges, and versions 11.56 and above for AP1200. The Undo feature cannot be used for IOS devices.
To undo a job, view the Job Run Details table under Configuration > Jobs, select the job you want to undo, and click Undo. For more specific information, see the online help.
Q. How long is the configuration job history kept in the WLSE?
A. The default time is 30 days.You can change this by navigating to Devices > Discover > Inventory > Polling > Job History Truncation Interval. Also, by default, for the recurring jobs, the last 30 runs are maintained in the database.
Q. Do jobs use HTTP or SNMP to initiate a configuration upload?
A. WLSE Configuration jobs can use either HTTP or SNMP as the mechanism to initiate a configuration template upload to an access point.
•The HTTP mechanism is valid for all supported device versions. The following setup parameters must be in place for HTTP mechanism to function properly:
–HTTP credentials for the device (with admin and firmware privileges on the access point) must match those entered on the WLSE HTTP device credentials screen.
–TFTP server settings on the access point (Setup > FTP), must refer to the WLSE's IP address.
Note Both username and password in the device credentials are case sensitive.
•The SNMP mechanism is valid for versions 11.08T and higher.The following setup parameters must be in place for SNMP to function properly:
–SNMP credentials for the device (with admin and firmware privileges on the access point) must match those entered on the WLSE SNMP device credentials screen.
–There is no need to change TFTP server settings for the SNMP mechanism, although you can use the SNMP mechanism to change the TFTP server settings on the AP to be used in the HTTP mechanism. Enter valid credentials in the Security > Local Admin Access template screen.
The SNMP job mechanism can be used to update TFTP settings, which are needed by HTTP-based jobs. This setting is available under Service > FTP in the configuration templates screens.
Q. Is it necessary to validate a job?
A. We recommend that you always validate a job before saving it. This will help in locating any possible problems before applying the job.
Q. What kinds of job logs are available?
A. There are two kinds of job logs: Job run log and the jobvm log.
•The job run log is where events are logged for a particular job's run. This log can be used to check what went wrong with the job and make any required corrections. The job run log can be viewed by selecting a particular job from the job list, then clicking Job Run Detail. From the window that pops up, select a particular run for the job, then click Job Run Log.
•The jobvm.log is a global log for all types of jobs. It is used mainly for development troubleshooting. The jobvm.log can be viewed by selecting Administration > Appliance > View Log File, then clicking jobvm.log.
Q. What is startup configuration?
Startup configuration is used right after a device (access point) reboots. It requires DHCP server to be properly set up to allow the access point to pick its startup configuration from WLSE. For this to work, you must set up the following:
a. Enter the <IP address of the WLSE> in the Boot Server Host Name field (option number 066) on the DHCP server.
b. Enter <startup file name> in the BootfileName field (option number 067) on the DHCP server.
For additional information, or for information about configuring a router as a DHCP server, see the online help.
Q. What is auto configuration?
A. Auto configuration is used after the device has been discovered and inventory has been collected for it. This template can be applied based on criteria you define while saving your auto-configuration template.
Q. If I make changes to the startup template, will those modifications be automatically uploaded to the access points that already had that startup template applied?
A. No. If you make modifications to the startup template, you will have to reapply the template.
Configuration Troubleshooting
•An IOS template job failed.
•A message indicates that the device version to which I am assigning a template is not supported.
•Configuration jobs fail because the Telnet/SSH credentials are not valid, even though credentials have been entered on the WLSE.
Symptom An IOS template job failed.
Possible Cause The template has the hostname configured instead of the IP
address, and the DNS name resolution is not configured correctly on the
access point.
Recommended Action Use the IP address or configure the DNS name correctly
on the access point.
Symptom A message indicates that the device version to which I am assigning a
template is not supported.
Possible Cause The device version was not supported at the time the WLSE
was released.
Recommended Action Import the updated list of devices to the WLSE, select
Administration > System > New Version Support.
Symptom Configuration jobs fail because the Telnet/SSH credentials are not valid,
even though credentials have been entered on the WLSE.
Possible Cause The credentials entered on the WLSE do not exactly match the
data entered in Devices > Discovery > Device Credentials > Telnet/SSH
User/Password.
Recommended Action Make sure that the Telnet/SSH credentials data entered
on the WLSE show the correct device login response. Match the device login
sequence with the credential fields, as shown in Firmware and configuration
jobs fail because the Telnet/SSH credentials are not valid..
Firmware FAQs and Troubleshooting
•Firmware FAQs
•Firmware Troubleshooting
Firmware FAQs
•How can firmware images be imported?
•Are firmware jobs run by using both HTTP and SNMP?
•What kinds of job logs are available?
•How many devices can I have in one firmware job?
Q. How can firmware images be imported?
A. Firmware images can be imported to WLSE from the desktop as well as Cisco.com.While importing any image from Cisco.com, the WLSE reads the version string and the device type for the image attributes. For imports from the desktop, you must make sure that the version and the device type strings are correctly entered in the image attributes. For example, for an AP350, image version 12.00T, the image string must be entered as 12.00T; not 12.0 or 12.00 or 12.0T.
Q. Are firmware jobs run by using both HTTP and SNMP?
A. Yes. Firmware jobs use both HTTP and SNMP protocols.
•HTTP is valid for all supported device versions. The following setup parameters must be in place for HTTP to function properly:
–HTTP credentials for the device (with admin and firmware privileges on the AP) must match those entered on the WLSE HTTP device credentials screen.
–TFTP server settings on the access point must reference the WLSE's IP address.
Note Both username and password in the device credentials are case sensitive.
•SNMP is valid for versions 11.08T and higher.The following setup parameters must be in place for SNMP to function properly:
–SNMP credentials for the device (with admin and firmware privileges on the AP) must match those entered on the WLSE SNMP device credentials screen.
–There is no need to change TFTP server settings for the SNMP mechanism, although you can use the SNMP mechanism to change the TFTP server settings on the AP to be used in the HTTP mechanism. Enter valid credentials in the Security > Local Admin Access template screen.
Note NOTE: Make sure to provide a numeric value in the user ID field (template screen).
Q. What kinds of job logs are available?
A. There are two kinds of job logs: Job run log and the jobvm log.
•The job run log is where events are logged for a particular job's run. This log can be used to check what went wrong with the job and make any required corrections. The job run log can be viewed by selecting a particular job from the job list, then clicking Job Run Detail. From the window that pops up, select a particular run for the job, then click Job Run Log.
•The jobvm.log is a global log for all types of jobs. It is used mainly for development troubleshooting. Thejobvm.log can be viewed by selecting Administration > Appliance > View Log File, then clicking jobvm.log.
Q. How many devices can I have in one firmware job?
A. There is no limit, although it is recommended that you work with device groups and set up jobs accordingly (for example, by location or building). While a job is running, the WLSE allocates resources for updating 20 devices in parallel. At any given time, 20 devices will be upgrading and the remainder will be waiting for resources to become available.
Firmware Troubleshooting
•There is a time discrepancy in a job.
•Email about job completion fails to arrive at destination.
•Firmware is not updated on all the devices included in a job.
•For more information on upating firmware, sAn SNMP job fails..
•A firmware job ends with status "not verified."
•Firmware jobs over slow links do not succeed.
•When downloading firmware from Cisco.com, an error message about cryptography permissions appears.
•When downloading firmware from Cisco.com, an error message about connectivity failure appears.
•Firmware and configuration jobs fail because the Telnet/SSH credentials are not valid.
Symptom There is a time discrepancy in a job.
Possible Cause The time was not set correctly on the WLSE.
Recommended Action
a. Reset the WLSE time to Universal Coordinated Time (UTC) using CLI commands as follows:
Enter services stop to stop services.
Enter the clock command to reset the time.
Enter services start to restart the services.
b. Set the time in local browser time, select Administration > Appliance > Time/NTP/Name.
Symptom Email about job completion fails to arrive at destination.
Possible Cause The SMTP server is not specified.
Recommended Action Configure the mail route by selecting Administration >
Appliance > Configure Mailroute.
Symptom Firmware is not updated on all the devices included in a job.
Possible Cause There were warnings displayed when the job was saved. Jobs
for devices with warnings do not run; the job runs only for devices that do not
have any warnings.
Recommended Action Solve the problems indicated in the warning messages
before running the job.
Possible Cause If two firmware jobs were scheduled closely together, the
second job contained some of the same devices as the first job. Those devices
could not be updated because the first job was already running.
Recommended Action It is recommended that firmware jobs be run on groups
of devices. Each group should be exclusive; that is, no device should be a
member of more than one group.
Symptom For more information on upating firmware, sAn SNMP job fails.
Possible Cause The read community string does not have sufficient
permissions.
Recommended Action The access point must have a user with at least SNMP,
FIRMWARE, and ADMIN permissions for read-only access.
Access points with software releases prior to 12.01(T) must have a user with SNMP, FIRMWARE, ADMIN, and IDENT permissions for read-only access.
Symptom A firmware job ends with status "not verified."
Note The "not verified" status may not mean that the job has failed. The WLSE may time out before confirming whether the upgrade succeeded. To make sure, you can run an on-demand inventory on the devices in question to find out whether the firmware upgrade was installed. For more information, see the Inventory online help, or select Devices > DISCOVER > Inventory > Run Inventory Now.
Possible Cause The device may be taking a long time to reboot.
Caution Do not take the following action for firmware jobs that you are running to convert non-IOS access points to IOS. See the special conversion instructions in the online help or the
User Guide for the CiscoWorks Wireless LAN Solution Engine, Release 2.5.
Recommended Action Increase the value of the Device Reboot Wait Timeout
parameter by accessing the WLSE through the following URL:
http://your_wlse:1741/debug/jobprops.jsp
where your_wlse is the name of the WLSE.
Increase the value of the Device Reboot Wait Timeout parameter and run the job again.
Note Do not make this value extremely high. It is advisable to keep this value to something slightly higher than the actual reboot time of the slowest access point.
Symptom Firmware jobs over slow links do not succeed.
Possible Cause The access points being upgraded are connected to the WLSE
over a slow link (less than 1.544 Mbps) and the job is timing out.
Caution Do not take the following action for firmware jobs that you are running to convert non-IOS access points to IOS. See the special conversion instructions in the online help or the
User Guide for the CiscoWorks Wireless LAN Solution Engine, 2.5.
Recommended Action
a. Access the WLSE through the following URL:
http://your_wlse:1741/debug/jobprops.jsp
b. Increase the value of the Per device job operation timeout parameter. For example, for a 56kbps link, the recommended value is 2400 seconds (40 minutes). On a 128kbps link, the recommended value is 1200 seconds (20 minutes).
Symptom When downloading firmware from Cisco.com, an error message about
cryptography permissions appears.
Possible Cause The first time you attempt to download firmware, the WLSE
displays this message: Error while selecting or displaying image
details. Please log into cisco.com and make sure your username has
acknowledged cryptography permissions for downloading IOS images.
Recommended Action Log into Cisco.com and acknowledge the cryptography
permissions. After you have acknowledged these permissions, you can import
IOS images to the WLSE.
Symptom When downloading firmware from Cisco.com, an error message about
connectivity failure appears.
Possible Cause DNS is not configured on the WLSE.
Recommended Action Configure DNS on the WLSE and make sure the WLSE
can resolve the cisco.com domain name. For information about configuring
DNS, see the User Guide for the CiscoWorks Wireless LAN Solution Engine,
Release 2.5 or the Installation and Configuration Guide for the CiscoWorks
Wireless LAN Solution Engine, Release 2.5.
Symptom Firmware and configuration jobs fail because the Telnet/SSH
credentials are not valid.
Possible Cause The credentials entered on the WLSE do not exactly match the
data entered in Devices > Discovery > Device Credentials > Telnet/SSH
User/Password.
Recommended Action Make sure that the Telnet/SSH credentials data entered
on the WLSE show the correct device login response. Match the device login
sequence with the credential fields as follows.
Device Login Sequence
|
Telnet Credential Fields Required
|
|
User Name
User Password
Enable Password
|
|
User Password
Enable Password
(leave the User Name field empty)
|
|
Enable Password
(leave User Name and User Password fields empty)
|
|
Not supported. Configure the device accordingly.
|
Reports FAQs and Troubleshooting
•Reports FAQ
•Reports Troubleshooting
Reports FAQ
Q. Are any of the reports real-time reports?
A. The reports are not real time. They are based on data that is collected periodically. The frequency with which the data is collected is user configurable (see Devices > Discover > Inventory > Polling). The data shown in reports is as current as the time the data was collected from the devices.
Reports Troubleshooting
•The Top N Busiest Clients report and the Client Statistics report display 0 (zero) values.
•Some report fields are blank.
•The client association data in the Group Client Association report differs from the data shown in the Current Client Associations report.
•The access point data in the Historical Associations report is not accurate.
•The Summary and/or Detailed report for access points is empty.
•The group report for a user-defined group contains no data.
•After running a job, the updated data does not appear in a report.
•Email fails to arrive at its destination.
•There is a time discrepancy in the scheduled email jobs.
•No VLAN information is displayed for IOS access points.
Symptom The Top N Busiest Clients report and the Client Statistics report display
0 (zero) values.
Possible Cause Wireless client polling frequency is set to 51 minutes by
default. The counters could reset between two polling cycles which would
cause zero values when the reports are run.
Recommended Action Increase the polling frequency by selecting Devices >
Discover > Inventory > Polling.
Caution Increasing the polling frequency could have an effect on performance.
Symptom Some report fields are blank.
Possible Cause The device is not configured properly for management by the
WLSE; the ISO view has not been created.
Recommended Action See Devices are placed in Misconfigured Devices group
after discovery. for information about how to correct the problem.
Symptom The client association data in the Group Client Association report
differs from the data shown in the Current Client Associations report.
Possible Cause The data for the Group Client Association report is collected
using performance attributes polling and the data shown in the Current Client
Association report uses wireless client polling.
Whichever report has a higher polling frequency will contain the most up to date data. Select Devices > Discover > Inventory > Polling to view polling frequency.
Recommended Action None.
Symptom The access point data in the Historical Associations report is not
accurate.
Possible Cause The wireless client was associated with an access point
managed by the WLSE, but subsequently associated with an access point that
was added to the network, but not yet managed by the WLSE.
Recommended Action Verify that the associated access points are in the
managed devices folder by selecting Devices > Discover > Managed Devices
> Manage/Unmanage.
Symptom The Summary and/or Detailed report for access points is empty.
Possible Cause The SNMP user may not have the correct rights assigned.
Recommended Action
a. Open a browser window to the access point, and select Setup > Security > User Information.
b. Make sure that the user corresponding to the SNMP community (which is set up in WLSE in Discovery > Device Credentials) has been granted rights for the following: Ident, firmware, admin, snmp, and write.
c. If not, click on the user and assign all these rights.
Symptom The group report for a user-defined group contains no data.
Possible Cause Reports cannot be displayed for a user-defined group that
contains another group.
Recommended Action Display individual reports for the sub-groups or devices
within the user-defined group.
Symptom After running a job, the updated data does not appear in a report.
Possible Cause A full polling cycle has not completed and the new data has
not been entered in the database.
Recommended Action Verify that the polling cycle has completed as follows:
a. Select Administration > Appliance > Status > View Log File.
b. Click jobvm.log.
c. Scroll through the log to find the message: "Finished Inventory" for your particular job.
Symptom Email fails to arrive at its destination.
Possible Cause The SMTP server is not configured properly.
Recommended Action Configure the SMTP server by selecting Administration
> Appliance > Configure Mailroute.
Symptom There is a time discrepancy in the scheduled email jobs.
Possible Cause The time is not set correctly on the WLSE.
Recommended Action
a. Reset the WLSE time to Universal Coordinated Time (UTC) using CLI commands as follows:
Enter services stop to stop services.
Enter the clock command to reset the time.
Enter services start to restart the services.
b. Set the time in local browser time, select Administration > Appliance > Time/NTP/Name.
Symptom No VLAN information is displayed for IOS access points.
Possible Cause WEP keys have not been configured in each VLAN. When the
WEP keys are configured in the IOS access points, VLAN information is
accessible by SNMP.
Recommended Action Configure the WEP keys for the corresponding VLAN.
Radio Manager FAQs and Troubleshooting
•Radio Manager FAQs
•Radio Manager Troubleshooting
Radio Manager FAQs
•Why don't I see the building or floor node in the device tree in the Assisted Site Survey Wizard?
•Why don't I see the device that I am looking for in the Assisted Site Survey device tree?
•When I select devices in the Assisted Site Survey Wizard, why are some shown in red?
•When I'm using the Assisted Site Survey Wizard, why is the Next button disabled after I complete step one?
•In the Assisted Site Survey Wizard, why is Use Old Radio Scan Data disabled?
•In the Assisted Site Survey Wizard, what does None mean in the Last Scan Time field?
•In the Assisted Site Survey Wizard, why is the Next button disabled on the radio scan step?
•Why did my radio scan job fail in the Assisted Site Survey Wizard?
•When I'm using the Assisted Site Survey Wizard, the radio scan progress advances very slowly. How long does it radio scan normally take?
•Can I skip client walkabout in the Assisted Site Survey Wizard even though the number of data shown is zero?
•In the client walkabout step in the Assisted Site Survey Wizard, what is the Recall button for?
•What is the difference between the Number of Location Data and Number of New Location Data fields?
•In the Constraints and Goals step in the Assisted Site Survey Wizard, how do I select multiple channels in the channel list?
•How long should the Constraints and Goals calculation step take in the Assisted Site Survey Wizard?
•Where can I see the result of the Constraints and Goals calculation in the Assisted Site Survey Wizard?
•If I don't like result of the Constraints and Goals calculation in the Assisted Site Survey Wizard, what can I do?
•When I apply the configuration in the Assisted Site Survey Wizard, where do I see the results?
•In the last step of the Assisted Site Survey Wizard, why is the Next button disabled?
Q. Why don't I see the building or floor node in the device tree in the Assisted Site Survey Wizard?
A. Expand the building node to see all floors that belong to the building. If you expand the building node and the floors still do not appear, close the Wizard and make sure the building and floor exist in the Location Manager navigation tree. If the building or floor does not exist in the Location Manager navigation tree, you first need to create them and then restart the Assisted Site Survey Wizard.
Q. Why don't I see the device that I am looking for in the Assisted Site Survey device tree?
A. Expand the building and floor nodes to see all devices that belong to a building or floor. If the device still does not appear, close the Assisted Site Survey Wizard and make sure the device appears in the Location Manager navigation tree. If the device does not appear in the Location Manager navigation tree, select Tools > Find Device to locate it. If you find the device, move it to the desired location. The device does not appear in Location Manager, it might not have been discovered by the system. After adding the device and specifying its location, restart the Assisted Site Survey Wizard.
Q. When I select devices in the Assisted Site Survey Wizard, why are some shown in red?
A. The devices might be red if:
–The devices are not in the Managed state. Select Devices > Discover > Manage/Unmanage to verify that the devices are Managed.
–The devices are not in infrastructure mode. Go to the AP configuration for the individual device and verify that it is in "Infrastructure Mode" with the proper WDS assigned.
Q. When I'm using the Assisted Site Survey Wizard, why is the Next button disabled after I complete step one?
A. You have not selected any acceptable devices that are required for the next step. If any of the selected devices are shown in red, you need to deselect them before you can go to the next step.
Q. In the Assisted Site Survey Wizard, why is Use Old Radio Scan Data disabled?
A. You might not have previously run radio scan for the selected devices. You must start a new radio scan.
Q. In the Assisted Site Survey Wizard, what does None mean in the Last Scan Time field?
A. The selected device was not included in a previous radio scan.
Q. In the Assisted Site Survey Wizard, why is the Next button disabled on the radio scan step?
A. You need to run radio scan by clicking Start. When the radio scan is complete, you will be able to click Next.
Q. Why did my radio scan job fail in the Assisted Site Survey Wizard?
A. Look at the log window to find out exact failure cause. If radio scan failed:
–Make sure the devices have the correct setup for WDS. Also verify that WDS is authenticated to WLSE and that WDS has an IP address pointing to WLSE.
–Make sure the devices have the correct SNMP read/write community strings that match the WLSE setting.
Q. When I'm using the Assisted Site Survey Wizard, the radio scan progress advances very slowly. How long does it radio scan normally take?
A. Radio scan normally takes about 5 to 10 minutes to complete. If you suspect the program has stalled, check its status by selecting Radio Manager > AP Radio Scan and viewing the progress of the job.
Q. Can I skip client walkabout in the Assisted Site Survey Wizard even though the number of data shown is zero?
A. Yes, you can skip client walkabout. However, performing a client walkabout will generate better parameters for your wireless network.
Q. In the client walkabout step in the Assisted Site Survey Wizard, what is the Recall button for?
A. You can click Recall to display a list of the last five client MAC addresses that were used for the previous client walkabout. To retrieve a previously used MAC address, click Recall and select a MAC address from the list.
Q. What is the difference between the Number of Location Data and Number of New Location Data fields?
A. Number of Location Data is the total number of data found by client walkabout for the current session plus any previous sessions. Number of New Location Data is the total number of data found by client walkabout for the current session only. The numbers in these two fields can increase at the same time during a client walkabout.
Q. In the Constraints and Goals step in the Assisted Site Survey Wizard, how do I select multiple channels in the channel list?
A. For Windows users, control-click on the channels to add them to the selection. The selected channels are highlighted.
Q. How long should the Constraints and Goals calculation step take in the Assisted Site Survey Wizard?
A. It varies depending on the amount of radio scan and client walkabout data. The more data you have, the longer it will take to calculate.
Q. Where can I see the result of the Constraints and Goals calculation in the Assisted Site Survey Wizard?
A. If the calculation was successful, you can click Next to view the result.
Q. If I don't like result of the Constraints and Goals calculation in the Assisted Site Survey Wizard, what can I do?
A. Go back and specify different constraints and goals, and then recalculate the constraints and goals.
Q. When I apply the configuration in the Assisted Site Survey Wizard, where do I see the results?
A. Check Location Manager to view the configuration changes. You might need to refresh the Location Manager window by selecting View > Refresh Data. In rare cases, the wizard might have failed to apply the configuration. In that case, check your SNMP settings, particularly the WRITE community string, for the devices.
Q. In the last step of the Assisted Site Survey Wizard, why is the Next button disabled?
A. This is the last step in Assisted Site Survey Wizard. You can close the Wizard unless you want to repeat any previous steps.
Radio Manager Troubleshooting
•After completing the Assisted Site Survey, Location Manager did not update to include the applied configurations.
Symptom After completing the Assisted Site Survey, Location Manager did not
update to include the applied configurations.
Possible Cause You did not refresh the Location Manager window.
Recommended Action In the Location Manager window, select View >
Refresh Data.
Administration FAQs and Troubleshooting
•Administration FAQs
•Administration Troubleshooting
Administration FAQs
Q. How can I verify the status of the database?
A. You can verify that the WLSE database is running by using the show process CLI command. If the command output includes the db2sync process, the database is running.
Administration Troubleshooting
This section contains the following troubleshooting information:
•Users cannot log in after failure of the alternative authentication source.
•Some users are not listed under User Admin > Manage Users.
•When using Internet Explorer 6.0 to install a new image on a WLSE from a repository located on a Windows XP machine, the progress bar does not appear in the Install Software Updates window. This problem also occurs when you use Internet Explorer 6.0 and a Windows XP system as a client to install a new image on a WLSE.
•Cannot back up the WLSE configuration to a Windows 2000 or Windows XP Server.
•Cannot log in with a username and password created in the CLI.
Symptom Users cannot log in after failure of the alternative authentication source.
Possible Cause The WLSE falls back to the Local authentication module.
Recommended Action
–Users can log in using their local passwords.
–The system administrator can log in using the admin log in.
–All users with CLI access can log in using the CLI.
–If you still cannot log in, follow the procedure on recovering from the loss of all admin passwords in the User Guide for the CiscoWorks Wireless LAN Solution Engine, Release 2.5.
Symptom Some users are not listed under User Admin > Manage Users.
Possible Cause Only the creator of a user can view that user's name in the list.
The admin user, however, can view all users.
Recommended Action None.
Symptom When using Internet Explorer 6.0 to install a new image on a WLSE
from a repository located on a Windows XP machine, the progress bar does not
appear in the Install Software Updates window. This problem also occurs when
you use Internet Explorer 6.0 and a Windows XP system as a client to install a
new image on a WLSE.
Possible Cause The Internet Explorer 6.0 browser on Windows XP does not
come with the Java plug-in installed.
Recommended Action Before using a Windows XP machine as a remote
repository to update WLSE software, perform the following on the
repository:
a. Install the JRE version 1.3.1_08 or later browser plug-in.
b. In the browser, select Tools > Internet Options > Privacy. Lower the slider all the way down to achieve the Accept All Cookies setting.
Before using a Windows XP machine as a client to update WLSE software, install the JRE 1.3.1_08 or later browser plug-in on the client machine.
You can download the plug-in from third-party sources such as Sun Microsystems or IBM.
Symptom Cannot log in with a username and password created in the CLI.
Possible Cause The password is too long.
Recommended Action Reset the password by using the CLI username
command, or log in by using the first 8 characters of the password. Passwords
should be from 5 to 8 characters long.
Symptom Cannot back up the WLSE configuration to a Windows 2000 or
Windows XP Server.
Possible Cause The backup directory is not writable.
Recommended Action Set the directory to UNIX mode and make it
write-enabled. For more information, see the backup and restore instructions
in the online help or the User Guide for the CiscoWorks Wireless LAN
Solution Engine, Release 2.5.
