WS5000 Series Switch Troubleshooting Guide
Copyright Copyright 2005 by Symbol Technologies, Inc. All rights reserved. No part of this publication can be modified or adapted in any way, for any purposes without permission in writing from Symbol. The material in this manual is subject to change without notice. Symbol reserves the right to make changes to any product to improve reliability, function, or design. No license is granted, either expressly or by implication, estoppel, or otherwise under any Symbol Technologies, Inc.
Contents About this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Chapter 1. System Troubleshooting 1.1 Wireless Switch Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 1.1.1 Switch Does Not Boot Up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.2 Switch Takes a Long Time to Start Up. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1.
iv WS5000 Series Switch Troubleshooting Guide 1.3 Mobile Unit Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 1.3.1 Access Port Adopted, but MU is Not Being Associated. . . . . . . . . . . . . . . . . . . 1-7 1.3.2 MUs Cannot Associate and/or Authenticate with Access Ports . . . . . . . . . . . . 1-8 1.3.3 Poor Voice Quality Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 1.4 Failover Issues . . . . . . .
v 2.2.22 shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15 2.2.23 show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15 2.2.24 watchdog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16 Chapter 3. Network Events Chapter 4.
vi WS5000 Series Switch Troubleshooting Guide
About this Guide This preface introduces the WS5000 Series Switch Troubleshooting Guide and contains the following sections: • Who Should Use this Guide • How to Use this Guide • Conventions Used in this Guide • Service Information Who Should Use this Guide The WS5000 Series Switch Troubleshooting Guide is intended for system administrators maintaining and troubleshooting issues encountered with the WS5000 Series Switch within the wireless local area network.
viii WS5000 Series Switch Troubleshooting Guide How to Use this Guide This guide will help you troubleshoot issues encountered with the WS5000 Series Switch and associated network elements. This guide is organized as follows. Table 1 Quick Reference on How This Guide Is Organized Chapter Description Chapter 1, “System Troubleshooting” This chapter is organized categorically, like a “Frequently Asked Questions (FAQ)” chapter, focussing on most common areas of concern.
ix Notational Conventions The following notational conventions are used in this document: • Italics are used to highlight specific items in the general text, and to identify chapters and sections in this and related documents. • Bullets (•) indicate: • • action items • lists of alternatives • lists of required steps that are not necessarily sequential Sequential lists (those describing step-by-step procedures) appear as numbered lists.
x WS5000 Series Switch Troubleshooting Guide
1 System Troubleshooting This chapter describes common system issues and what to look for while diagnosing the cause of a problem. Wherever possible, it includes possible suggestions or solutions to resolve the issues.
1-2 WS5000 Series Switch Troubleshooting Guide 1.1 Wireless Switch Issues This section describes various issues that may occur when working with the WS5000 Series Switch.
System Troubleshooting 1-3 Table 1.2 provides suggestions to troubleshoot this issue. Table 1.2 Switch Does Not Obtain an IP Address through DHCP Troubleshooting Notes Possible Issue Suggestions to Correct DHCP is not configured, or not available on same network as the WS5000 Series Switch • Verify that the configuration for the switch has DHCP enabled. By default, Ethernet NIC 2 is DHCP enabled. Otherwise, use set dhcp enable command at the Ethernet NIC 2 Instance prompt (WS5000.(Cfg).Ethernet.
1-4 WS5000 Series Switch Troubleshooting Guide Table 1.4 Unable to Telnet into the Switch Troubleshooting Notes (Continued) Possible Issue Suggestions to Correct Max sessions have been reached Maximum allowed sessions is 8 concurrent users connected to a switch. Verify that the threshold has not been reached. Use the show users command at the WS5000> prompt. Primary VLAN is not routed Verify Primary VLAN is routed. Use the show VLAN command at the WS5000> prompt.
System Troubleshooting 1-5 1.1.7 Console Port is Not Responding The WS5000 Series Switch console port is physically connected to the host computer’s serial port, but pressing the [Enter] key gets no response from the switch. Table 1.6 provides suggestions to troubleshoot this issue. Table 1.6 Console Port is Not Responding Troubleshooting Notes Possible Issue Suggestions to Correct Cabling issue Ensure that a NULL-modem cable is connected from the WS5000 console port to the host computer’s serial port.
1-6 4. WS5000 Series Switch Troubleshooting Guide If the switch comes up normally, return the switch to a normal operational readiness state. That is, check Ethernet NIC 2 IP configuration, adopt access ports and associate an mobile unit. If the switch continues to go into Diagnostics mode, call Symbol Support or log a Symbol Support Center call. 1.2 Access Port Issues This section describes various issues related to access ports within the WS5000 Series Switch network.
System Troubleshooting 1-7 1.3 Mobile Unit Issues This section describes various issues that may occur when working with the Mobile Units associated with the wireless switch or associated Access Ports. Possible issues include: • Access Port Adopted, but MU is Not Being Associated • MUs Cannot Associate and/or Authenticate with Access Ports • Poor Voice Quality Issues 1.3.1 Access Port Adopted, but MU is Not Being Associated Access port associated with an MU is not yet being adopted. Table 1.
1-8 WS5000 Series Switch Troubleshooting Guide 1.3.2 MUs Cannot Associate and/or Authenticate with Access Ports MUs cannot associate and/or authenticate with access ports. Table 1.9 provides suggestions to troubleshoot this issue. Table 1.9 MUs Cannot Associate and/or Authenticate with Access Ports Troubleshooting Notes Possible Issue Suggestions to Correct Preamble differences Verify that the Preamble matches between switch and MUs. Try a different setting.
System Troubleshooting 1-9 1.4.1 Switch is Not Failing Over Switch is not failing over (Hot Standby) as appropriate. Table 1.11 provides suggestions to troubleshoot this issue. Please verify the latest version of JRE is installed on your system. Table 1.
1-10 WS5000 Series Switch Troubleshooting Guide Table 1.12 Switch is Failing Over Too Frequently Troubleshooting Notes (Continued) Possible Issues Suggestions to Correct Auto-revert setting is causing problems Turn “auto-revert” setting off to see if this is causing the problem. All else... Contact Symbol Support. 1.5 Installation Issues Upgrading and downgrading the WS5000 Series Switch is possible only on the WS5000 platform.
System Troubleshooting 1-11 1.6 Miscellaneous Issues This section describes various miscellaneous issues related to the WS5000 Series Switch, and that don’t fall into any of the previously called out issue categories. Possible issues include: • Excessive Fragmented Data or Excessive Broadcast • Excessive Memory Leak • Administrative Login Does Not Authenticate 1.6.1 Excessive Fragmented Data or Excessive Broadcast Excessive fragmented data or excessive broadcast. Table 1.
1-12 WS5000 Series Switch Troubleshooting Guide Use the local console port to enable access restrictions. Table 1.16 provides suggestions to troubleshoot this issue. Table 1.16 Administrative Login Does Not Authenticate Troubleshooting Notes Possible Issues Suggestions to Correct Cannot login with administrative login • Verify that the RADIUS username, password, IP address and shared secret are identical between the RADIUS server and the WS5000 remote RADIUS login configuration.
2 Service Mode CLI Commands 2.1 CLI Service Mode Overview The CLI Service Mode allows retrieval of system data that includes tables, log files, configuration, status, and operation, for use in debugging and problem resolution while troubleshooting the WS5000 Series Switch configuration. Only Symbol Technologies trained and customer-authorized personnel should use the advanced commands within the CLI Service Mode.
2-2 WS5000 Series Switch Troubleshooting Guide 2.1.1 Logging into the Service Mode Initially, to log into the Service mode, follow these steps: 1. Enter service at the WS5000> System Context prompt. 2. Enter the CLI Service Mode password. The default password is password. WS5000> service Enter CLI Service Mode password:******** Enabling CLI Service Mode commands...... done. SM-WS5000> The customer can allow or deny access to the CLI Service Mode by maintaining the CLI Service Mode password.
Service Mode CLI Commands 2-3 Table 2.1 Service Mode Command Review (Continued) Command Brief Description Ref.
2-4 WS5000 Series Switch Troubleshooting Guide directory emergencymode execute install launch name password ping restore save shell show watchdogtimer Display the available image files in memory. Enable or disable Emergency Mode. CLI Service Mode command file execution. Install primary/standby or Kerberos config. Launches the specified program. Set or change the name. Change the CLI Service Mode password. Ping a network host/IP address. Restore system image or configuration.
Service Mode CLI Commands 2-5 Syntax capture Parameters Saves the system status to a file. Example SM-WS5000> capture sysstat Capturing current system status.... Starting the SSM capture ... Finished the SSM capture ... SM-WS5000> 2.2.5 check This command checks the integrity of the system image installed. It calculates the MD5 check sum of all the files and verifies that it matches with the records supplied with system image.
2-6 WS5000 Series Switch Troubleshooting Guide available in the normal System Context (WS5000> prompt) are the same. One additional command, however, is the launch command, which is also available at the Service Mode root Content (SM-WS5000> prompt). For more details on all of these sub-contexts and available commands, refer to the WS5000 Series Switch System Reference Guide. Syntax configure Example SM-WS5000> configure SM-WS5000.(Cfg)> ? Config Context.
Service Mode CLI Commands switchpolicy telnet user watchdogtimer wlan 2-7 Configure Switch Policy. Configure system Telnet settings. Configure user information. Enable/disable watch dog timer Configure WLAN for the system. SM-WS5000.(Cfg)> 2.2.8 copy Copies a file (system image (*.img) or configuration file (*.cfg) from the WS5000 to a (T)FTP server, or vice versa. TFTP can be used to transfer *.sys.img, *.cfg, and *.sym files. FTP can be used to transfer .krb, .sys.img, .cfg, and .sym files.
2-8 WS5000 Series Switch Troubleshooting Guide IP address of the TFTP server : 10.1.1.1 Copying 'backup.sys.img' from tftp://10.1.1.1 to Switch... or SM-WS5000> ftp://100.10.10.1/ftpimages/DefaultConfig.cfg system Copying 'DefaultConfig.cfg' from ftp://100.10.10.1/ftpimages/ to Switch... 2.2.9 debug Allows enabling or disabling logging of debug messages in the debug log file. User must execute the debug command to see the log of the operating function.
Service Mode CLI Commands errors threads - ERROR messages - Process THREAD info , general , sharedmem 2-9 - GENERAL messages - SHARED MEMEORY data SM-WS5000> 2.2.10 delete Deletes the specified image or config file from the WS5000. As a shortcut, “del” can be used instead of “delete”. Use the directory command to list the files that can be deleted. Syntax delete Parameters filename Name of file to be deleted.
2-10 WS5000 Series Switch Troubleshooting Guide 2.2.12 directory Lists the image and configuration files that are stored on the WS5000. As a shortcut, “dir” can be used instead of “directory”. Syntax directory Parameters None. Example SM-WS5000> directory Date & Time Bytes File Name Sep 24 13:01 1418 CmdProcErrors.txt Sep 21 09:53 0 KerberosErrorLog.txt Sep 10 13:25 16221 WS5000Defaults_v1.4.1.0-003D.cfg Sep 22 08:34 0 WS5000Defaults_v1.4.1.0-003D.cfg.current Sep 17 15:23 16979643 WS5000_v1.4.1.0-003D.
Service Mode CLI Commands 2-11 Executing CLI Service Mode command file.... Enter the command file name: 2.2.15 install Configures the switch as primary or standby, installs Kerberos settings, or runs a CLI command file, depending on the value of the first parameter. Syntax install [file_name] Parameters Specify Primary or Standby to configure the switch as the primary or standby Switch. Specify which command (.sym) file to install.
2-12 WS5000 Series Switch Troubleshooting Guide 2.2.17 name Sets the name for the WS5000 Series Switch. The command prompt in the CLI is updated with the new name. Syntax name Parameters The name for the switch (32 characters) . To enter new name with a multiple string, use the format: "string1 string2" Example WS5000> name "Toledo_WS5000"] Configuring name... Status : Success. Toledo_WS5000> 2.2.18 password Changes the customer password for the CLI Service Mode.
Service Mode CLI Commands 2-13 Parameters -Rdfnqrv These optional flags are can be broken down as follows: • -R: Record route. Includes the RECORD_ROUTE option in the ECHO_REQUEST packet and displays the route buffer on returned packets. Note that the IP header is only large enough for nine such routes. Many hosts ignore or discard this option. • -d: Set the SO_DEBUG option on the socket being used. Essentially, this socket option is not used by Linux kernel. • -f: Flood ping.
2-14 WS5000 Series Switch Troubleshooting Guide 2.2.20 restore This loads a saved configuration or image file and overwrites the active configuration or image on the switch (standby configuration when loaded on the Standby switch). After the file has been selected, the switch reboots and loads the saved configuration or image file. A configuration file is a file that contains the WS5000 Series Switch configuration and ends with the .cfg extension. A system image file ends with the sys.img extension.
Service Mode CLI Commands 2-15 Example SM-WS5000> save configuration backupsystem Saving running configuration in: backupsystem.cfg Saving Wireless Network Management Configuration ... Done. SM-WS5000> 2.2.22 shell The command allows the user to enter into the embedded OS Command prompt and environment. Syntax shell Parameters None. Example SM-WS5000>shell 2.2.23 show Displays a list of details about the WS5000 system related to the chosen display_parameter.
2-16 show show show show show show show show show show show show show show show show show show show show show show show show show show show show show WS5000 Series Switch Troubleshooting Guide https interfaces kdc knownap logfolder mu np ntpservers po radius-server restorelog securitypolicy snmpclients snmpstatus ssh standby switchpolicy sysalerts syslog system sysstat telnet time traphosts users version vlan watchdog wlan Display Display Display Display Display Display Display Display Display Display D
3 Network Events This chapter includes two network event tables to provide detailed information and understanding of the WS5000 Series Switch network events that can occur. These tables are: • Table 3.1, Network Event Message/Parameter Description Lookup • Table 3.2, Network Event Course of Action Lookup on page 3-7 Table 3.
3-2 WS5000 Series Switch Troubleshooting Guide Table 3.1 Network Event Message/Parameter Description Lookup (Continued) ID Event Message Parameters 2 Packet discard [wrong NIC] Discarded Packet: Wrong NIC vs from access port ZZ.
Network Events 3-3 Table 3.1 Network Event Message/Parameter Description Lookup (Continued) ID Event Message Parameters 12 AP status [adopted] Adopted an access port . XX = MAC (xx:xx:xx:xx:xx:xx) address of the access port. Radio with Mac is adopted. XX = Access port name (string). YY = MAC (xx:xx:xx:xx:xx:xx) address of the access port. Radio with MAC was reset. XX = Name (string) of the radio. YY = MAC (xx:xx:xx:xx:xx:xx) address of the radio.
3-4 WS5000 Series Switch Troubleshooting Guide Table 3.1 Network Event Message/Parameter Description Lookup (Continued) ID Event Message Parameters 24 MU status [roamed] Mobile Unit with MAC roamed from access port to (Name of the access port to which the Mobile Unit roamed). XX = Name (string) of the MU. YY = MAC (xx:xx:xx:xx:xx:xx) address of the MU. ZZ = Name (string) of the access port the MU roamed from.
Network Events 3-5 Table 3.1 Network Event Message/Parameter Description Lookup (Continued) ID Event Message Parameters 34 WLAN auth failed WLAN (ESS ) could not be authenticated with KDC at after <#> attempts - still trying... [WLAN name] [ESSID] [MAC xx:xx:xx:xx:xx of KDC server] [port on KDC server] [number of attempts] 35 WLAN max MU count reached ACL denied MU (%s) association.
3-6 WS5000 Series Switch Troubleshooting Guide Table 3.1 Network Event Message/Parameter Description Lookup (Continued) ID Event Message Parameters 50 Standby autorevert Standby Auto Reverting 51 Primary auto-revert Primary Auto Reverting 52 Auto channel select error ACS failed to find a valid channel, err . ACS failed to find a valid channel. Reusing existing channel . ACS success. Setting radio MAC address of the access port to channel.
Network Events 3-7 Table 3.1 Network Event Message/Parameter Description Lookup (Continued) ID Event Message 56 Miscellaneous debug events KerberosWlanAuth Operation::OnStart () RADIO_TYPE_FH != pRadio>GetType() NULL == pCountry>GetFHInfo() CWlan::KerberosCl ientAuth() Internal Failure, out of ethernet buffers. The license key on a WS-Lite cannot be upgraded. WSLiteValidation:FAILURE:%s is invalid %d-port license for WS-Lite. EtherPortManager::EnsureNoCollisions(FO UND PROBLEM: %s).
3-8 WS5000 Series Switch Troubleshooting Guide Table 3.2 Network Event Course of Action Lookup (Continued) ID Event Description Possible Course of Action 2 Packet discard [wrong NIC] When an access port is adopted, the switch remembers which Ethernet port the access port was adopted from. The switch will only accept data from that access port through the Ethernet port which it was adopted from. If the switch receives data from that access port on another Ethernet port, it will be discarded.
Network Events 3-9 Table 3.2 Network Event Course of Action Lookup (Continued) ID Event Description Possible Course of Action 8 AP adopt failure [license disallow] Switch ran out of licenses and could not adopt this AP. There are more AP devices than there are licenses. Either remove the extra APs or purchase more licenses. 9 AP adopt failure [no image] It seems that the switch does not have a valid AP image firmware file to download onto the AP.
3-10 WS5000 Series Switch Troubleshooting Guide Table 3.2 Network Event Course of Action Lookup (Continued) ID Event Description Possible Course of Action 19 Ether port connected A previously disconnected Ethernet port was reconnected. If you see excessive amounts of this message you may have a cable or switch hardware problem. 20 Ether port disconnected A previously connected Ethernet port was disconnected.
Network Events 3-11 Table 3.2 Network Event Course of Action Lookup (Continued) ID Event Description Possible Course of Action 35 WLAN max MU count reached This is an incorrect message. It is not really the ACL that denied association; it is really that the 802.11 limit has been exceeded. 36 Mgt user auth failed [radius] Management user not authenticated on the switch’s local user database. Management user not authenticated on the remote RADIUS server database.
3-12 WS5000 Series Switch Troubleshooting Guide Table 3.2 Network Event Course of Action Lookup (Continued) ID Event Description Possible Course of Action 50 Standby autorevert The Standby switch is auto-reverted from Active to Monitoring. This event is reported by the Standby switch. 51 Primary auto-revert The Primary wireless switch is auto-reverted from Halted to Connected. This event is reported by the Primary wireless switch. 52 Auto channel select error Misleading text.
4 MU Disassociation Codes Table 4.1 provides reason codes for 802.11 mobile unit disassociation. Table 4.1 802.11 Mobile Unit Disassociation Codes ID 802.11 or Symbol/WPA Reason Code Description 0 REASON_CODE_80211_SUCCESS Reserved internally to indicate success. 1 REASON_CODE_80211_UNSPECIFIED_ERROR Unspecified reason. 3 DISASSOCIATION_REASON_CODE_STATION_LEAVING_ESS Deauthenticated because sending station has left or is leaving IBSS or ESS.
4-2 WS5000 Series Switch Trubleshooting Guide Table 4.1 802.11 Mobile Unit Disassociation Codes (Continued) ID 802.11 or Symbol/WPA Reason Code Description 6 DISASSOCIATION_REASON_CODE_CLASS_2_PKT_FROM_NON_AUTH Class 2 frame received from nonauthenticated station. 7 DISASSOCIATION_REASON_CODE_CLASS_3_PKT_FROM_NON_ASSOC Class 3 frame received from nonassociated station. 8 DISASSOCIATION_REASON_CODE_STATION_LEAVING_BSS Disassociated because sending station has left or is leaving BSS.
MU Disassociation Codes 4-3 Table 4.1 802.11 Mobile Unit Disassociation Codes (Continued) ID 802.11 or Symbol/WPA Reason Code Description 77 DISASSOCIATION_REASON_CODE_TRANSMIT_RETRIES_EXCEEDED Symbol defined (non 802.11 standard) codes. The switch has exceeded its retry limit in attempting to deliver a 802.1x EAP message to the mobile unit without receiving a single 802.11 ACK. The retry limit varies according to traffic type but is at least 64 times.
4-4 WS5000 Series Switch Trubleshooting Guide
Symbol Technologies, Inc. One Symbol Plaza Holtsville, New York 11742-1300 http://www.symbol.
