Symbol WS5000 Troubleshooting Manual
Hide thumbs Also See for WS5000:

Advertisement

WS5000 Series Switch
Troubleshooting Guide

Advertisement

Table of Contents
loading

Summary of Contents for Symbol WS5000

  • Page 1 WS5000 Series Switch Troubleshooting Guide...
  • Page 2 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., intellectual property rights. An implied license only exists for equipment, circuits, and subsystems contained in Symbol products.
  • Page 3: Table Of Contents

    1.1.8 WS5000 CLI Prompt Displays DIAG> ....... . . 1-5...
  • Page 4 2.1.2 Basic Conventions..........2-2 2.2 SM-WS5000> Command Review ........2-2 2.2.1 ? or help.
  • Page 5 2.2.22 shell ............2-15 2.2.23 show .
  • Page 6 WS5000 Series Switch Troubleshooting Guide...
  • Page 7: About This 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.
  • Page 8: How To Use This Guide

    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...
  • Page 9: Notational Conventions

    Sequential lists (those describing step-by-step procedures) appear as numbered lists. Service Information If a problem is encountered with the WS5000 Series Switch, review the details within this guide to see if you can resolve the problem yourself. If you are still having troubles, contact Symbol Customer Support. See Symbol’s Web site (http://www.symbol.com) for Symbol Customer Support contact information and policies.
  • Page 10 WS5000 Series Switch Troubleshooting Guide...
  • Page 11: Chapter 1. System Troubleshooting

    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. The following sections are included: • Wireless Switch Issues •...
  • Page 12: Wireless Switch Issues

    1.1.3 Switch Does Not Obtain an IP Address through DHCP The WS5000 Series Switch requires a routable IP address for the administrator to manage it via Telnet or a Web browser. By default, the switch boots up with a non-routable static IP address.
  • Page 13: Switch Is Stuck In A Booting Loop

    All else... Contact the Symbol Support. 1.1.5 Unable to Telnet into the Switch The WS5000 Series Switch is physically connected to the network, but telneting into the switch does not work. Table 1.4 provides suggestions to troubleshoot this issue. Table 1.4 Unable to Telnet into the Switch Troubleshooting Notes...
  • Page 14: Gui Applet Is Sluggish, Does Not Refresh Properly, Or Does Not Respond

    When configuring the switch, it is easy to overlook the fact that the host computer is running the browser while the WS5000 Series Switch is providing the data to the browser. Occasionally, while using the Applet (GUI) the switch does not respond or appears to be running very slow; this could be a symptom of the host computer or the network, and not the switch itself.
  • Page 15: Console Port Is Not Responding

    System Troubleshooting 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.
  • Page 16: Access Port Issues

    4. 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.
  • Page 17: Mobile Unit Issues

    • Verify the encryption keys that the switch is using. Go to the Security Policy instance (WS5000.(Cfg).SecurityPolicy.[Name]>) that was applied to the WLAN and verify that the same encryption keys are being used at the MU. Ethernet port configuration •...
  • Page 18: Mus Cannot Associate And/Or Authenticate With Access Ports

    Long preamble not used on Verify that a long preamble is used with Spectralink phones. Spectralink phones 1.4 Failover Issues This section describes various issues related to the failover capabilitie of the WS5000 Series Switch. Possible issues include: • Switch is Not Failing Over •...
  • Page 19: Switch Is Not Failing Over

    Mismatch configurations are not allowed. Verify that the Primary and Secondary switches have mismatched switches have the same software versions running. software versions Use the show system command at the WS5000> prompt. Primary and Standby Verify that the Primary and Secondary switch are configured properly and attempt to switches cannot ping each switch (using the ping command) from each switch.
  • Page 20: Installation Issues

    Contact Symbol Support. 1.5 Installation Issues Upgrading and downgrading the WS5000 Series Switch is possible only on the WS5000 platform. Before upgrading or downgrading any system, save a copy of the system configuration to an FTP or TFTP system. Possible upgrade issues are: •...
  • Page 21: Miscellaneous Issues

    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 •...
  • Page 22: System Logging Mechanism

    Contact Symbol Support. 1.7 System Logging Mechanism The WS5000 Series Switch provides subsystem logging through commands in the Syslog context (in both normal CLI mode and CLI Service Mode) and GUI interface. There are two Syslog systems, local and remote. Local Syslog records system information locally, on the switch.
  • Page 23: Chapter 2. Service Mode Cli Commands

    To enter Service Mode Configuration context, invoke the service command within the System or Configuration context (WS5000> or WS5000.(Cfg}> prompts, for example). The CLI user can either output the data to the standard display, or capture the data in a file stored in the default system directory. The user can immediately access the file, or transport it to another host.
  • Page 24: Logging Into The Service Mode

    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..
  • Page 25: Or Help

    Enable/disable watch dog page 2-16 2.2.1 ? or help Displays a list of available commands. Identical to "help" command. Syntax Parameters None. Example SM-WS5000> help System Context. ---------------------------------------------- Commands Brief Description ---------------------------------------------- ? or help To get the command information.
  • Page 26: Logout Or Bye

    This command saves the current system status of various tables, files and processes of the switch to a file, for use by Symbol engineers during problem resolution. The file name, ssm_report, appears in the WS5000/ scripts/service/ directory. Any previous ssm_report file gets renamed to ssm_report.prev.
  • Page 27: Check

    Syntax capture <sysstat> Parameters <sysstat> 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.
  • Page 28 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>...
  • Page 29: Copy

    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 , and files. FTP can be used to transfer *.sys.img...
  • Page 30: Debug

    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... 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.
  • Page 31: Delete

    , sharedmem - 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.
  • Page 32: Directory

    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...
  • Page 33: Install

    Specifying a valid Kerberos file to update (*.krb) does not require the Kerberos enabled switches to reset. Example SM-WS5000> install primary test.sym Begin command file processing... Begin parsing command file for download and logging parameters... /butterfly/scripts/cmd_process: tr: command not found /butterfly/scripts/cmd_process: tr: command not found...
  • Page 34: Name

    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 <new_name> Parameters <new_name> The name for the switch (32 characters) . To enter new name with a multiple string, use the format: "string1 string2"...
  • Page 35 The name or IP address of the host to which the request packets are sent. Example WS5000> ping WS5000 PING WS5000 (10.1.1.101): 56 data bytes 64 bytes from 10.1.1.101: icmp_seq=0 ttl=255 time=0.037 ms 64 bytes from 10.1.1.101: icmp_seq=1 ttl=255 time=0.042 ms 64 bytes from 10.1.1.101: icmp_seq=2 ttl=255 time=0.05 ms...
  • Page 36: Restore

    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. The Standby file for the Standby switch is a .cfg type file.
  • Page 37: 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. Syntax show <display_parameter> Parameters display_parameter The keyword used with the show command displays details related to the display_parameter. See the Example, below, for a list of all available parameters and brief descriptions.
  • Page 38: Watchdog

    2-16 WS5000 Series Switch Troubleshooting Guide show https Display the Applet access type (http/https). show interfaces Display interface details show kdc Display KDC details show knownap Display known APs in the neighborhood. show logfolder Display the current Log folder contents...
  • Page 39 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.1 Network Event Message/Parameter Description Lookup...
  • Page 40 WS5000 Series Switch Troubleshooting Guide Table 3.1 Network Event Message/Parameter Description Lookup (Continued) Event Message Parameters Packet discard Discarded Packet: Wrong NIC <XX> <XX> vs XX = Ethernet port that received the packet [wrong NIC] <YY> from access port ZZ.
  • Page 41 Network Events Table 3.1 Network Event Message/Parameter Description Lookup (Continued) Event Message Parameters 12 AP status Adopted an access port <XX>. XX = MAC (xx:xx:xx:xx:xx:xx) address of the [adopted] access port. Radio <XX> with Mac <YY> is adopted. XX = Access port name (string). YY = MAC (xx:xx:xx:xx:xx:xx) address of the access port.
  • Page 42 WS5000 Series Switch Troubleshooting Guide Table 3.1 Network Event Message/Parameter Description Lookup (Continued) Event Message Parameters 24 MU status Mobile Unit <XX> with MAC <YY> roamed XX = Name (string) of the MU. [roamed] from access port <ZZ> to (Name of the...
  • Page 43 Network Events Table 3.1 Network Event Message/Parameter Description Lookup (Continued) Event Message Parameters 34 WLAN auth failed WLAN <WLAN name> (ESS <ID>) could not [WLAN name] be authenticated with KDC at <KDC MAC [ESSID] address> <port> after <#> attempts - still [MAC xx:xx:xx:xx:xx of KDC server] trying...
  • Page 44 WS5000 Series Switch Troubleshooting Guide Table 3.1 Network Event Message/Parameter Description Lookup (Continued) Event Message Parameters 50 Standby auto- Standby Auto Reverting revert 51 Primary auto-revert Primary Auto Reverting 52 Auto channel ACS failed to find a valid channel, err...
  • Page 45 Network Events Table 3.1 Network Event Message/Parameter Description Lookup (Continued) Event Message Parameters 56 Miscellaneous Internal Failure, out of ethernet buffers. debug events The license key on a WS-Lite cannot be KerberosWlanAuth upgraded. Operation::OnStart WSLiteValidation:FAILURE:%s is invalid [XML error string(if any)] %d-port license for WS-Lite.
  • Page 46 WS5000 Series Switch Troubleshooting Guide Table 3.2 Network Event Course of Action Lookup (Continued) Event Description Possible Course of Action Packet discard When an access port is adopted, the switch The access port may have been [wrong NIC] remembers which Ethernet port the access port removed and reconnected to another was adopted from.
  • Page 47 Network Events Table 3.2 Network Event Course of Action Lookup (Continued) Event Description Possible Course of Action AP adopt failure Switch ran out of licenses and could not adopt There are more AP devices than there [license disallow] this AP. are licenses.
  • Page 48 3-10 WS5000 Series Switch Troubleshooting Guide Table 3.2 Network Event Course of Action Lookup (Continued) Event Description Possible Course of Action 19 Ether port A previously disconnected Ethernet port was re- If you see excessive amounts of this connected connected.
  • Page 49 Network Events 3-11 Table 3.2 Network Event Course of Action Lookup (Continued) Event Description Possible Course of Action 35 WLAN max MU This is an incorrect message. It is not really the count reached ACL that denied association; it is really that the 802.11 limit has been exceeded.
  • Page 50 3-12 WS5000 Series Switch Troubleshooting Guide Table 3.2 Network Event Course of Action Lookup (Continued) Event Description Possible Course of Action 50 Standby auto- The Standby switch is auto-reverted from Active revert to Monitoring. This event is reported by the Standby switch.
  • Page 51 MU Disassociation Codes Table 4.1 provides reason codes for 802.11 mobile unit disassociation. Table 4.1 802.11 Mobile Unit Disassociation Codes 802.11 or Symbol/WPA Reason Code Description REASON_CODE_80211_SUCCESS Reserved internally to indicate success. REASON_CODE_80211_UNSPECIFIED_ERROR Unspecified reason. DISASSOCIATION_REASON_CODE_STATION_LEAVING_ESS Deauthenticated because sending station has left or is leaving IBSS or ESS.
  • Page 52 WS5000 Series Switch Trubleshooting Guide Table 4.1 802.11 Mobile Unit Disassociation Codes (Continued) 802.11 or Symbol/WPA Reason Code Description DISASSOCIATION_REASON_CODE_CLASS_2_PKT_FROM_NON_AUTH Class 2 frame received from non- authenticated station. DISASSOCIATION_REASON_CODE_CLASS_3_PKT_FROM_NON_ASSOC Class 3 frame received from non- associated station. DISASSOCIATION_REASON_CODE_STATION_LEAVING_BSS Disassociated because sending station has left or is leaving BSS.
  • Page 53 MU Disassociation Codes Table 4.1 802.11 Mobile Unit Disassociation Codes (Continued) 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.
  • Page 54 WS5000 Series Switch Trubleshooting Guide...
  • Page 56 Symbol Technologies, Inc. One Symbol Plaza Holtsville, New York 11742-1300 http://www.symbol.com 72E-71560-01 Revision A March 2005...

Table of Contents