User Guide for the CiscoWorks Wireless LAN Solution Engine, 2.5
FAQs and Troubleshooting
Downloads: This chapterpdf (PDF - 447.0KB) The complete bookPDF (PDF - 7.77MB) | Feedback

FAQs and Troubleshooting

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:

LILO boot:

3. Press the Tab key. The following prompt appears:

boot:

4. Enter the following command. This puts the WLSE in maintenance image mode.

CiscoBreR
[root@CiscoMaintImage/]#

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:

# services status

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:

# services stop

7. Restart the system services by entering the following:

# services start

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:

ping hostname

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:

# write memory

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
Username:
Password:
prompt >enable
Password:
enable prompt #

User Name

User Password

Enable Password

Password:
prompt > enable
Password:
enable prompt #

User Password

Enable Password

(leave the User Name field empty)

prompt > enable
Password:
enable prompt #

Enable Password

(leave User Name and User Password fields empty)

enable prompt #

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.