reference manual version 2.4 Fabric OS www.hp.
Notice © Hewlett-Packard Company, 2001. All rights reserved. Edition: E0801 Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
CONTENTS Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Arbitrated Loop Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Switch Fabric Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 System Services Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Virtual Channel Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 crossPortTest .
iodShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ipAddrSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ipAddrShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . islTopoCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . islTopoShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
portLogDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . portLogShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . portLoopbackTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . portPerfShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . portRegTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
tempShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . timeOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . topologyShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . trackChangesSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . uptime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fabric OS Reference Manual
Revision History July 2001 First release.
Fabric OS Reference Manual
PREFACE Fabric OS Reference Manual contains descriptions for the telnet commands used to administer and configure switches. About This Guide This guide provides the following information about Fabric OS: Chapter 1 Telnet Commands Provides a detailed description of the telnet commands in the Fabric OS. Chapter 2 Error Messages Provides error message formats as well as a list of error messages with descriptions.
Title Part Number HP Surestore FC Switch 6164 Documentation CD A7326-11011 HP Surestore FC Switch 6164 Installation and Reference Guide A7326-90902 HP Surestore FC Switch 6164 Quick Start Guide A7326-90901 Distributed Fabrics User’s Guide, version 2.2 Available only on CD Fabric Watch User’s Guide, version 2.2 Available only on CD MIB Reference Manual, version 2.3 Available only on CD QuickLoop User’s Guide, version 2.3 Available only on CD Web Tools User’s Guide, version 2.
1 TELNET COMMANDS agtcfgDefault Reset the SNMP agent configuration to default values. Synopsis agtcfgDefault Availability admin Description Use this command to reset the configuration of the SNMP agent to default values: • sysDescr - The default value is Fibre Channel Switch. • sysLocation - The default value is End User Premise. • sysContact - The default value is Field Support.
• swEventTrapLevel - The default value is 0 (off). • authTraps - The default value is 0 (off). • The IP addresses of the trap recipient for each community default to 0.0.0.0 or no trap recipient. There are six communities: Community 1: Secret C0de Community 2: OrigEquipMfr Community 3: private Community 4: public Community 5: common Community 6: FibreChannel For more information about these SNMP configuration parameters, see agtcfgset command. Note Operands 14 None.
Example In the following example, the agtcfgDefault command is run to set the SNMP agent configuration parameters to the default value; then the agtcfgShow command is run to verify that the default values are set. switch:admin> agtcfgDefault Committing configuration...done. agent configuration reset to factory default switch:admin> agtcfgShow Current SNMP Agent Configuration Customizable MIB-II system variables: sysDescr = Fibre Channel Switch. sysLocation = End User Premise sysContact = Field Support.
agtcfgSet Modify the SNMP agent configuration. Synopsis agtcfgSet Availability admin Description Use this command to modify the configuration of the SNMP agent in the switch. Set the values for the following items: • sysDescr - Specify the switch description (in MIB-II definition). The default value is Fibre Channel Switch. • sysLocation - Specify the location of the switch (in MIB-II). The default value is End User Premise. • sysContact - Specify the contact information for this switch.
• There are six communities, each with a respective trap recipient, supported by the agent. The first three communities are for read-write access (rw) and the last three are for read-only access (ro). Specify the IP address for each management station: Community 1: Secret C0de - The default value for this trap recipient is '0.0.0.0'. Community 2: OrigEquipMfr - The default value for this trap recipient is '0.0.0.0'. Community 3: private - The default value for this trap recipient is '0.0.0.0'.
Example The current value for each item is displayed in brackets. To modify the SNMP configuration values: switch:admin> agtcfgSet Customizing MIB-II system variables ... At each prompt, do one of the following: o o o o to accept current value, enter the appropriate new value, to skip the rest of configuration, or to cancel any change.
agtcfgShow Display the SNMP agent configuration. Synopsis agtcfgShow Availability All users Description Use this command to display the configuration of the SNMP agent in the switch. The following information is displayed: • sysDescr - Displays the switch description. • sysLocation - Displays the location of the switch. • sysContact - Displays the contact information for this switch. • swEventTrapLevel - Displays the event trap level.
• There are six communities, each with a respective trap recipient, supported by the agent. The first three communities are for read-write access (rw) and the last three are for read-only access (ro). For an SNMP Management Station to receive a trap generated by the agent, the admin user must configure a trap recipient IP address of the Management Station. Community 1: Secret C0de - Displays the IP address for this trap recipient. Community 2: OrigEquipMfr - Displays the IP address for this trap recipient.
Example To display SNMP agent configuration information: switch:admin> agtcfgShow Current SNMP Agent Configuration Customizable MIB-II system variables: sysDescr = FC Switch sysLocation = End User Premise sysContact = Field Support. swEventTrapLevel = 3 authTraps = 1 (ON) SNMPv1 community and trap recipient configuration: Community 1: Secret C0de (rw) Trap recipient: 192.168.1.51 Community 2: OrigEquipMfr (rw) Trap recipient: 192.168.1.
aliasShow Display alias server information. Synopsis aliasShow Availability All users Description Use this command to display local alias server information. If there is no local alias group, a message is displayed. If there are multiple entries in the local alias group, they are displayed. Note This command is not related to the Zoning feature. The following fields are displayed: Alias ID Multicast address presented in format FFFBxx, where xx is the name of the multicast group.
Example To display the entries in the local alias server, enter the following command: switch:admin> aliasShow The Local Alias Server has 1 entry Alias ID Creator Token [rb, type, grptype, qlfr] Member List fffb01 fffffd [40, 05, 10, 60000010 12000069] {021200 0208e2} See Also fabricShow switchShow backSpace Set or clear alternate backspace character.
bcastShow Display broadcast routing information. Synopsis bcastShow Availability All users Description Use this command to display the broadcast routing information for all ports in the switch (known to the FSPF path selection/routing task). The broadcast routing information indicates all ports that are members of the broadcast distribution tree (that is, ports that are able to send and receive broadcast frames). Normally, all F_Ports and FL_Ports are members of the broadcast distribution tree.
Example To display the broadcast routing information for all ports in the switch: switch:admin> bcastShow Group Member Ports Member ISL Ports Static ISL Ports ----------------------------------------------------------256 0x00012083 0x00002080 0x00000000 See Also Telnet Commands mcastShow portRouteShow 25
camTest Functional test of the CAM memory. Synopsis camTest [passCount] Availability admin Description Use this command to verify that Content Addressable Memory (CAM) is functionally correct. The CAM is used by QuickLoop to translate the SID. This command cannot be executed on an operational switch. You must first disable the switch using the switchDisable command. Note Operands This command has the following operand: passCount Example Specify the number of times to execute this test.
centralMemoryTest Bit write/read test of the ASIC central memory. Synopsis centralMemoryTest [passCount, dataType, dataSeed] Availability admin Description Use this command to verify the address and data bus of the ASIC SRAMs that serve as the central memory. This command cannot be executed on an operational switch. You must first disable the switch using the switchDisable command. Note Operands This command has the following operands: passCount Specify the number of times to execute this test.
Errors There are four possible error messages if failures are detected: DIAG-TIMEOUT DIAG-BADINT DIAG-CMERRTYPE DIAG-CMERRPTN See Also 28 camTest cmemRetentionTest portLoopbackTest portRegTest ramTest spinSilk sramRetentionTest Fabric OS Reference Manual
cmemRetentionTest Data retention test of the central memory SRAMs. Synopsis cmemRetentionTest [passCount] Availability admin Description Use this command to verify for data retention in the central memory SRAMs in the ASIC. This command cannot be executed on an operational switch. You must first disable the switch using the switchDisable command. Note Operands This command has the following operand: passCount Example Specify the number of times to execute this test. The default value is 1.
cmiTest ASIC to ASIC connection test of the CMI bus. Synopsis cmiTest [passCount] Availability admin Description Use this command to verify that the multiplexed 4-bit Control Message Interface (CMI) point-to-point connection between two ASICs is functioning properly. Also use it to verify that a message with a bad checksum sets the error and interrupt status bits of the destination ASIC and that a message with a good checksum does not set an error or interrupt bit in any ASIC.
4. Check that all ASICs (other than Y) do not have: – The capture flag set. – The CMI error bit set. – The CMI error interrupt status bit set. Operands This command has the following operand: passCount Example Specify the number of times to execute this test. The default value is 1. This operand is optional. To run the ASIC to ASIC connection test of the CMI bus: switch:admin> cmiTest Running CMI Test .............. passed.
configDefault Restore system configuration to default settings. Synopsis configDefault Availability admin Description Use this command to reset system configuration to default values.
Example To restore the system configuration to default values: switch:admin> configDefault Committing configuration...done. See Also agtcfgDefault configure switchDisable switchEnable configDownload Download the switch configuration from a host file. Synopsis configDownload ["host","user","file"[,"passwd"]] Availability admin Description Use this command to download the switch configuration file from a host system.
Note that the switch’s identity cannot be changed by configDownload. These parameters (such as the switch’s name and IP address) are ignored. They are the lines in the configuration file that begin with “boot”. Also note that the download process is additive; that is, the lines read from the file are added to the current switch configuration. This enables you to change a single configuration variable by downloading a file with a single line. All other variables remain unchanged.
Example To download switch configuration from the server citadel, username jdoe, and host file name config.txt: switch:admin> configDownload "citadel","jdoe","config.txt" Committing configuration...done. download complete Errors There are several possible reasons for a failure of this command: • The host name is not known to the switch. • The host IP address cannot be contacted. • The user does not have permission on the host. • The user runs a script that prints something at login.
configShow Display system configuration settings. Synopsis configShow ["textfilter"] Availability All users Description Use this command to view system configuration settings set by the configure command, as well as these two settings: • Ethernet MAC address • NVRAM boot settings Operands This command has the following operand: textfilter 36 Specify a text string, in quotation marks, that limits the output of the command to only those entries that contain the text string.
Example To display system configuration settings: switch:admin> configShow Ethernet address: 0:60:69:0:60:10 Nvram data: fei(0,0)host:/usr/switch/firmware u=user tn=switch Type to continue, Q to stop: diag.postDisable: 0 fabric.domain: 1 fabric.ops.BBCredit: 16 fabric.ops.E_D_TOV: 2000 fabric.ops.R_A_TOV: 10000 fabric.ops.dataFieldSize: 2112 fabric.ops.mode.fcpProbeDisable: 0 fabric.ops.mode.isolate: 0 fabric.ops.mode.tachyonCompat: 0 fabric.ops.mode.unicastOnly: 0 fabric.ops.mode.
configUpload Back up the switch configuration to an ASCII file on a host workstation. Synopsis configUpload ["host","user","file"[,"passwd"]] Availability admin Description Use this command to upload the switch configuration to a host file. The upload process uses either FTP or the RSHD protocol (TPC service 514). Both of these services are widely available on UNIX hosts, but less so on Windows hosts.
Example file Specify a file name in quotation marks; for example, “config.txt”. Absolute path names may be specified using forward slash (/). Relative path names create the file in the user’s home directory on UNIX hosts, and in the directory where the FTP server is running on Windows hosts. This operand is optional. passwd Specify a password in quotation marks. If present, the command uses FTP to transfer the file. This operand is optional.
See Also configDefault configDownload configShow configure configure Change system configuration settings. Synopsis configure Availability admin Description Use this command to change the system configuration settings: • arbitrated loop settings • switch fabric settings • system services settings • virtual channel settings Do not run this command on an operational switch. First disable the switch using the switchDisable command. Note The configure command is navigated using a series of menus.
End-of-file (control-D) When entered at a prompt with no preceding input, terminates the command and saves changes made.This keystroke is common on many computers, but can be different on your system. The tables in the next section define those settings that may be changed. Arbitrated Loop Settings This section provides information on arbitrated loop settings.
Switch Fabric Settings There are a number of settings control the overall behavior and operation of the fabric. Some of these values, such as the domain, are assigned automatically by the fabric and may differ from one switch to another in the fabric. Other parameters, such as the buffer-to-buffer credit or the time-out values, can be changed for specific applications or operating environments, but must be in agreement among all switches to allow formation of the fabric.
Domain The domain number uniquely identifies the switch in a fabric. This value is automatically assigned by the fabric. The range of allowed values varies depending on the switch model and other system settings (see VC Encoded Address Mode). BB Credit The buffer-to-buffer (BB) credit represents the number of buffers available to attached devices for frame receipt. The range of allowed values varies depending on other system settings (see Unicast-only Operation).
Sequence Level Switching When this feature is set to 1, frames of the same sequence from a particular source are transmitted together as a group. When this feature is set to 0, frames are transmitted interleaved among multiple sequences. Under normal conditions, Sequence Level Switching should be disabled for better performance. However, some host adapters have performance issues when receiving interleaved frames from multiple sequences.
System Services Settings There are two fields that are used to specify the system service settings. Table 1. System Service Settings Field Type Default Range rstatd Boolean Off On/Off rusersd Boolean Off On/Off This section provides a description of the system service setting fields: rstatd Dynamically enables or disables a server that returns information about system operation information through remote procedure calls (RPC).
Virtual Channel Settings The switch provides the ability to tune it in a specific application, by configuring the parameters for its eight virtual channels. Note that the first two virtual channels are reserved for switch internal functions and are not user-configurable. The default virtual channel settings have already been optimized for switch performance. Changing the default values can improve switch performance, but it can also degrade performance.
Operands Telnet Commands VC Class 2 Specifies the Virtual Channel used for class 2 frame traffic. This setting is configurable only when VC Encoded Address Mode is set. VC Class 3 Specifies the Virtual Channel used for class 3 frame traffic. This setting is configurable only when VC Encoded Address Mode is set. VC Multicast Specifies the Virtual Channel used for multicast frame traffic. This setting is configurable only when VC Encoded Address Mode is set.
Example To set the system configuration variables for a switch: switch:admin> configure Configure... Fabric parameters (yes, y, no, n): [no] yes Domain: (1..239) [1] BB credit: (1..16) [16] R_A_TOV: (4000..120000) [10000] E_D_TOV: (1000..5000) [2000] 5000 Data field size: (256..2112) [2112] Non-SCSI Tachyon Mode: (0..1) [0] 1 Disable Device Probing: (0..1) [0] VC Encoded Address Mode: (0..1) [0] 1 Disable Translative Mode: (0..1) [0] Per-frame Route Priority: (0..
crossPortTest Functional test of port M->N path. Synopsis crossPortTest [passCount, singlePortAlso] Availability admin Description Use this command to verify the functional operation of the switch. This command verifies operation by sending frames from the port M transmitter and looping the frames back through an external fiber cable into another port N receiver.
6. Check the eight statistic error counters for nonzero values: ENC_in, CRC_err, TruncFrm, FrmTooLong, BadEOF, Enc_out, BadOrdSet, DiscC3 7. Check the transmit, receive, or class 3 receiver counters to see if they are stuck at some value. 8. Check that the number of frames received is equal to the number of frames transmitted. 9. Repeat steps 3 through 8 for all ports present until the number of frames (or passCount) requested is reached or all ports are marked bad.
switchEnable switchDisable Mode This mode can be run in one of two states, ONLINE or OFFLINE. In the ONLINE state, the switch is enabled prior to executing the test. In this state, only ports that are cable loopbacked to ports from the same switch are tested. Ports connected outside of the switch are ignored. To run, at least one port (if singlePortAlso is active) or two ports (if singlePortAlso is not active) must be cable loopbacked to each other.
or cables, bad GBICs or cables, or improper connection of SWL to LWL, etc.), the following message is sent to the telnet shell: One or more ports are not active, please double check fibres on all ports. The following message displays on the front panel: One or more ports not cabled.
For example, disable the switch, set the GBIC mode to 1, and execute crossPortTest with singlePortAlsoactivated and the crossPortTest to limit testing to: only ports containing GBICs that _all_ GBIC ports that are cable loopbacked ports connected to themselves (single port connections) Because this test includes the GBIC and the fiber cable in the test path, use the results from this test, in conjunction with the results from the portLoopbackTest and the spinSilk test to determine those switch components t
Example To execute a functional test of port M->N path 100 times: switch:admin> crossPortTest 100 Running Cross Port Test ....... One moment please ... switchName: switch switchType: 2.
date Display or set system date and time. Synopsis date ["newDate"] Availability All users (display) admin (set) Description Use this command with no operands to display date and time. Use the newdate operand to set the date and time.
Example To display the current date and time, and then change it to Feb 27 12:30:00 2001: switch:admin> date Fri Jan 29 17:01:48 1999 switch:admin> date "0227123001" Thu Feb 27 12:30:00 2001 See Also 56 errLogShow portLogShow uptime Fabric OS Reference Manual
diagClearError Clear the diag software flag to allow for retest. Synopsis diagClearError [port] Availability admin Description Use this command to clear the diag software flag that indicates whether a port is BAD or OK. The current flag settings are displayed by using the diagShow command. This command resets the flag to allow the bad port to be retested; otherwise the test skips the port. This command does not clear the error log entry.
diagDisablePost Disable POST execution at reboot. Synopsis diagDisablePost Availability admin Description Use this command to disable Power On Self Test (POST) execution at switch reboot. This mode is saved in flash memory, and POST remains disabled until it is enabled using the diagEnablePost command.
Operands Example None. To disable the POST during future power ons: switch:admin> diagDisablePost Committing configuration...done. On next reboot, POST will be skipped.
diagEnablePost Enable POST execution at next reboot. Synopsis diagEnablePost Availability admin Description Use this command to enable Power On Self Test (POST) execution at the next switch reboot. This mode is saved in flash memory, and POST remains enabled until it is disabled using the diagDisablePost command. POST includes the following tests: • ramTest - Bit write / read test of SDRAMS in the switch. • portRegTest - Bit write / read test of the ASIC SRAMs and registers.
See Also camTest centralMemoryTest cmiTest diagDisablePost portLoopbackTest portRegTest ramTest diagHelp Display available diagnostic help commands. Synopsis diagHelp Availability All users Description Use this command to display a list of the diagnostic help commands for troubleshooting switch problems. Operands Example None.
diagShow Print diagnostic results since the last boot. Synopsis diagShow [nSeconds] Availability All users Description Use this command to print the following information generated since the last switch reboot: • State of all ports in the switch resulting from diagnostics run since the last reboot. Ports that passed diagnostic testing are marked OK. Ports that failed one or more diagnostic tests are marked BAD. • Current state of ports. Active ports are UP and inactive ports are DN.
It can also be looped by specifying the nseconds operand. This operand enables you to specify a repeat interval for this command. If a repeat interval is specified, the command continues to execute until interrupted. For example, diagShow 4 executes diagShow every 4 seconds unless stopped by a keyboard interrupt. Also use this command to isolate a bad GBIC. A changing “LLI_errs” value prefixed by “**” indicates a port is continuing to detect errors.
Example To print the diagnostic results since the last boot: switch:admin> diagShow Diagnostics Status: port#: diags: state: lm0: lm1: lm2: lm3: lm4: lm5: lm6: lm7: lm8: lm9: lm10: lm11: lm12: lm13: lm14: lm15: 0 OK UP 1 OK UP 2 OK UP 100 100 100 100 100 100 100 100 100 100 100 100 100 100 100 100 Wed Apr 5 03:09:20 2000 3 OK UP 4 OK UP 6 OK UP 100 100 100 100 100 100 100 100 100 100 100 100 100 100 100 100 frRx frRx frRx frRx frRx frRx frRx frRx frRx frRx frR frRx frR frRx frRx frRx frTx frTx fr
dlsReset Turn off dynamic load sharing option. Synopsis dlsReset Availability admin Description Use this command to disable dynamic load sharing when a fabric change occurs. See dlsSet for a full description of load sharing. Use this command only if devices connected to the fabric cannot handle occasional routing changes. Operands Example None. To disable the dynamic load sharing option: switch:admin> dlsReset Committing configuration...done.
dlsSet Turn on dynamic load sharing option. Synopsis dlsSet Availability admin Description Use this command to enable dynamic load sharing when a fabric change occurs. Routing is done on a per source port basis. This means that all the traffic coming in from a port (either E_Port or Fx_Port) directed to the same remote domain is routed through the same output E_Port. To optimize fabric utilization, when there are multiple equivalent paths to a remote switch, traffic is shared among all the paths.
Operands Example None. To enable the dynamic load sharing option: switch:admin> dlsSet Committing configuration...done. switch:admin> dlsShow DLS is set See Also dlsReset dlsShow dlsShow Display the state of the Dynamic Load Sharing option. Synopsis dlsShow Availability All users Description Use this command to display whether Dynamic Load Sharing is on or off. Operands Example None.
errDump Display the error log without page breaks. Synopsis errDump Availability All users Description Use this command to display the error log without page breaks. This command displays the same information as errShow, but errShow enables you to scroll through the entries using the Enter button. See errShow for a description of the error log. Operands Example None.
errShow Scroll through the error log. Synopsis errShow Availability All users Description Use this command to display the error log. This command enables you to scroll through the entries using the Enter key. Use errDump to display the same information without line breaks. Each entry in the log follows this format: Error Number -----------taskId (taskName): Time Stamp (count) Error Type, Error Level, Error Message Diag Err# where: Telnet Commands Error Number Beginning at one.
Error Level 0 = panic (the switch reboots) 1 = critical 2 = error 3 = warning 4 = information 5 = debug Error Message Additional information about the error. Diag Err# The number of the error. This is a hexadecimal 4-digit code representing the error type. Diagnostic Error Codes The following table lists the error numbers, the POST test that generates the error number, and the type of error. Table 3.
Table 3.
Table 3.
Table 3.
Example The following example illustrates a log with two entries. The first entry is the most recent; it is a diagnostic failure. The second entry is the oldest; it displays the switch restart reason.
fabricShow Displays fabric membership information. Synopsis fabricShow Availability All users Description Use this command to display information about switches and multicast alias groups in the fabric. Multicast alias groups are created on demand by request from N_Ports attached to the alias server; typically no groups are listed. If the switch is initializing, or disabled, the message “no fabric” is displayed. If the fabric is reconfiguring, some or all switches may not be shown.
Example The following example shows a fabric of four switches. “sw180” is the principal switch. Three of the switches are configured to run IP over fibre channel. There is one multicast alias group. switch:admin> fabricShow Switch ID worldwide name Enet IP Addr FC IP Addr Name ------------------------------------------------------------------------0: fffc40 10:00:00:60:69:00:06:56 192.168.64.59 192.168.65.59 "sw5" 1: fffc41 10:00:00:60:69:00:02:0b 192.168.64.180 192.168.65.
fanShow Display fan status. Synopsis fanShow Availability All users Description Use this command to display the current status of the switch fans.The format of the display varies according to the switch model and number of fans. Some switch models show fan speed measured in RPM. The current fan status is shown: Operand Example OK Fan is functioning correctly. absent Fan is not present. below minimum Fan is present but rotating too slowly or stopped. None.
fastboot Reboot the switch, bypassing POST. Synopsis fastboot Availability admin Description Use this command to reboot the switch, bypassing POST. The reboot takes effect immediately as the switch resets and executes normal power-on booting sequence. However, Power On Self Test (POST) is skipped. This reduces boot time significantly. If POST has been disabled using the diagDisablePost command, then fastboot is the same as reboot.
firmwareDownload Download a switch firmware file from a host. Synopsis firmwareDownload ["host","user","file" [,"passwd"]] Availability admin Description Use this command to download a switch firmware file from a host into the switch flash memory. The download process uses either FTP (File Transfer Protocol) or the RSHD protocol (TCP service 514). Both of these services are widely available on UNIX hosts, but less so on Windows hosts.
Operands Example This command has the following operands: host Specify a host name or IP address in quotation marks; for example, “citadel” or “192.168.1.48”. The configuration file is downloaded from this host system. This operand is optional. user Specify a user name in quotation marks; for example, “jdoe”. This user name is used to gain access to the host. This operand is optional. file Specify a file name in quotation marks; for example, “firmware.txt”.
Errors There are many reasons why the download can fail: • The host name is not known to the switch. • The host IP address cannot be contacted. • The user does not have permission on the host. • The user runs a script that prints something at login. • The path to the firmware may be case sensitive. • The file does not exist on the host. • The file is not a switch firmware file. • The file is corrupted. • The RSHD or FTP server is not running on the host.
fspfShow Display FSPF protocol information. Synopsis fspfShow Availability All users Description Use this command to display the Fibre Channel Shortest Path First (FSPF) protocol information, and internal data structures. FSPF is implemented by a single task, called tFspf. The display shows the fields in the following table. Table 6. fspfShow display fields 82 Field Description version: Version of FSPF protocol. domainID: Domain number of local switch. isl_ports: Bit map of all E_Ports.
Table 6. fspfShow display fields (continued) Operands Example Field Description event_sch: FSPF scheduled events bit map. lsrRefreshCnt: Internal variable. None.
gbicShow Display serial ID GBIC information. Synopsis gbicShow [portnumber] Availability All users Description Use this command to display information about Serial Identification GBICs (also known as module definition “4” GBICs). These GBICs provide extended information that describes GBIC capabilities, interfaces, manufacturer, and other information. Use this command with no operand to display a summary of all GBICs in the switch.
Example To display GBIC summary information for an eight-port switch, followed by detailed information for a Finisar “smart” GBIC: switch:admin> gbicShow port 0: id Vendor: FINISAR CORP. Serial No: 103980 port 1: id Vendor: HEWLETT-PACKARD Serial No:9809100953460702 port 2: id Vendor: FINISAR CORP.
h Display shell history. Synopsis h Availability All users Description Use this command to view the shell history. The shell history mechanism is similar to the UNIX Korn shell history facility; it has a built-in line-editor similar to UNIX vi that allows previously typed commands to be edited. The command h displays the 20 most recent commands typed into the shell; old commands fall off the top as new ones are entered. To edit a command, press ESC to access edit mode, and then use vi commands.
help Display help information for commands. Synopsis help [command] Availability All users Description Use this command without an operand to display an alphabetical list of commands that provide help information. At the end of the list are additional commands that display groups of commands; for example, “diagHelp” displays a list of diagnostic commands.
i Display task summary. Synopsis i [taskId] Availability All users Description Use this command to display a synopsis of all tasks in the switch, or for a specific task if a task ID is supplied. One line is displayed for each task; it contains the fields in the following table. Table 7.
The fields in the following table indicate task status. Table 8.
Example To display the task summary: switch:admin> i tFcp NAME ENTRY TID PRI STATUS PC SP ERRNO DELAY ---------- ---------- -------- --- -------- ------- -------- ----- ---tFcp _fcpTask 103ad660 150 PEND+T 10191b78 103ad9e0 3d0004 32 switch:admin> i NAME ---------tExcTask tLogTask tShell tRlogind tTelnetd tTimers tErrLog tNetTask tSwitch tPBmenu tReceive tTransmit tFabric tFspf tFcph tFcp tNSd tASd ENTRY TID ---------- -------_excTask 103f7eb0 _logTask 103f5f30 _shellTask 103b8970 _rlogind 103de0e0 _teln
ifModeSet Set the link operating mode for a network interface. Synopsis ifModeSet ["interface"] Availability admin Description Use this command to set the link operating mode for a network interface. Use ifShow to list network interfaces available on the system. An operating mode is confirmed with a “y” or “yes” at the prompt. If the operating mode selected differs from the current mode, the change is saved and the command exits. The system must be rebooted for changes to take effect.
Example To force the link for the “fei0” Ethernet interface from auto-negotiate operation to 10 Mbps / Half duplex operation: switch:admin> ifModeSet "fei0" Auto-negotiate (yes, y, no, n): [no] 100 Mbps / Full Duplex (yes, y, no, n): [no] 100 Mbps / Half Duplex (yes, y, no, n): [no] 10 Mbps / Full Duplex (yes, y, no, n): [no] 10 Mbps / Half Duplex (yes, y, no, n): [no] yes Committing configuration...done. See Also ifModeShow ifShow ifModeShow Display the link operating mode for a network interface.
ifShow Display network interface information. Synopsis ifShow ["ifName"] Availability All users Description Use this command to display network interface status. If the operand ifName is provided, only that interface is displayed. If ifName is omitted, all interfaces are displayed. Each switch has three interfaces: “ei” or “fei” is the 10BaseT or 100BaseT Ethernet interface. “lo” is the loopback interface. “fc” is the fibre channel interface.
Operands This command has the following operand: ifName Example Specify the name of an interface, in quotation marks. This operand is optional. To display Ethernet interface information for a switch with a 10BaseT connection: switch:admin> ifShow "ei" ei (unit number 0): Flags: (0x63) UP BROADCAST ARP RUNNING Internet address: 192.168.1.65 Broadcast address: 192.168.1.
interfaceShow Display FSPF interface information. Synopsis interfaceShow [portnumber] Availability All users Description Use this command to display data structures associated with FSPF interfaces (E_Ports) on the switch. There are two data structures – the permanently allocated Interface Descriptor Block (IDB) and the neighbor data structure that is allocated when a switch port becomes an E_Port.
upCount Number of times this interface came up, with respect to FSPF. lastUpTime Last time this interface came up. downCount Number of times this interface went down. lastDownTime Last time this interface went down. downReason Type of last State Change Notification that caused this interface to go down. iState Current state of this interface. The state can be UP or DOWN.
Telnet Commands lsrRtxTID LSR retransmission timer ID. inactTo Inactivity time-out value, in milliseconds. When this time-out expires, the adjacency with the neighbor switch is broken and new paths are computed to all possible destination switches in the fabric. helloTo Hello time-out value, in milliseconds. When this time-out expires, a Hello frame is sent to the neighbor switch through this port. rXmitTo Retransmission time-out value, in milliseconds.
upCount Number of times this interface came up, with respect to FSPF. lastUpTime Last time this interface came up. downCount Number of times this interface went down. lastDownTime Last time this interface went down. downReason Type of last State Change Notification that caused this interface to go down. iState Current state of this interface. The state can be UP or DOWN.
Telnet Commands upCount Number of times this interface came up, with respect to FSPF. lastUpTime Last time this interface came up. downCount Number of times this interface went down. lastDownTime Last time this interface went down. downReason Type of last State Change Notification that caused this interface to go down. iState Current state of this interface. The state can be UP or DOWN.
lsrRtxTID LSR retransmission timer ID. inactTo Inactivity time-out value, in milliseconds. When this time-out expires, the adjacency with the neighbor switch is broken and new paths are computed to all possible destination switches in the fabric. helloTo Hello time-out value, in milliseconds. When this time-out expires, a Hello frame is sent to the neighbor switch through this port. rXmitTo Retransmission time-out value, in milliseconds.
Operands attLsuOut Number of attempted transmissions of LSUs to the neighbor switch. nLsuOut Number of LSUs transmitted to the neighbor switch. attLsaOut Number of attempted transmissions of LSAs to the neighbor switch. nLsaOut Number of LSAs transmitted to the neighbor switch. This command has the following operand: portnumber Example Specify the port number for which you want to display the interface data structures. This operand is required.
iodReset Turn off the in-order delivery option. Synopsis iodReset Availability admin Description Use this command to allow out-of-order delivery of frames during fabric topology changes. This is the default behavior, and allows fast rerouting after a fabric topology change. Operands Example None.
iodSet Turn on the in-order delivery option. Synopsis iodSet Availability admin Description Use this command to enforce in-order delivery of frames during a fabric topology change. In a stable fabric, frames are always delivered in order, even when the traffic between switches is shared among multiple paths. However, when topology changes occur in the fabric (for instance, a link goes down), traffic is rerouted around the failure.
iodShow Display the state of the in-order delivery option. Synopsis iodShow Availability All users Description Use this command to display whether the In-Order Delivery option is on or off. Operands Example None.
ipAddrSet Set Ethernet and FC IP addresses. Synopsis ipAddrSet Availability admin Description Use this command to set Ethernet and FC IP addresses.
Example To enable IP over fibre channel: switch:admin> ipAddrSet Ethernet IP Address [192.168.1.65]: Ethernet Subnetmask [none]: Fibre Channel IP Address [none]: 192.168.65.65 Fibre Channel Subnetmask [none]: Gateway Address [192.168.1.1]: Committing configuration...done.
ipAddrShow Display Ethernet and FC IP addresses. Synopsis ipAddrShow Availability All users Description Use this command to display Ethernet and fibre channel IP addresses.
islTopoCheck Display ISL sgroup connections for a switch. Synopsis Availability admin Description This command displays the ISL sgroup connections and status for this switch. This command is used to verify that the switch is properly cabled and configured. Each port that is specified in the ISL definition corresponding to an ISL sgroup that this switch is a member of will be displayed. A switch with properly configured ISL connections will report a status of “OK” for each of these ports.
Example The following example shows the results of islTopoCheck on a mis-configured switch. In a proper configuration, all of the switches would have valid domains and names and the status of each port would be OK.
islTopoShow Display ISL switch group topology and status. Synopsis islTopoShow [sgroup] Availability All users Description This command displays the current connections and status for all the switches in the ISL switch groups that the current switch is a member of. The status for every port and switch combination in each active ISL group is displayed.
Example The following example shows the results of islTopoShow on a mis-configured switch. In a proper configuration, all of the switches would have valid domains and names and the status of each port would be OK.
licenseAdd Add license key to switch. Synopsis licenseAdd "license" Availability admin Description Use this command to add a license key to a switch. The license key string is case sensitive; it must be entered exactly as issued. When the key has been entered, use the licenseShow command to check that the key has been correctly entered and the licensed product installed. Once the key has been installed, the product is immediately available.
licenseHelp Display commands used to administer license keys. Synopsis licenseHelp Availability admin Description Use this command to display a list of the commands used to administer license keys. Operands Example None.
licenseRemove Remove the license key from a switch. Synopsis licenseRemove "license" Availability admin Description Use this command to remove an existing license key from a switch. The existing license key must be entered exactly as shown by licenseShow, including case. When the key has been entered, use the licenseShow command to check that the key has been removed and the licensed product uninstalled. Once the license key has been removed, the switch must be rebooted.
licenseShow Display current license keys. Synopsis licenseShow Availability All users Description Use this command to display current license keys along with a list of licensed products enabled by these keys; none is displayed if no license keys are installed. Operands Example None.
linkCost Set or print the FSPF cost of a link. Synopsis linkCost [portnumber], [cost] Availability admin Description Use this command to set or display the cost of an Inter-Switch Link (ISL). The cost of a link is a dimensionless positive number. It is used by the FSPF path selection protocol to determine the path that a frame takes going from the source to the destination switch. The chosen path is the path with minimum cost.
Example To display the FSPF cost of a link, and reset the cost: switch:admin> linkCost 1 Interface: 1 cost 1000 switch:admin> linkCost 1,2000 Committing configuration...done. switch:admin> linkCost 1 Interface: 1cost 2000 See Also interfaceShow LSDbShow topologyShow uRouteShow login Log in as a new user. Synopsis login Availability All users Description Use this command to log in to the switch with another user name and password, without first logging out from the original session.
logout Log out from a telnet, rlogin, or serial port session. Synopsis logout Availability All users Description Use this command to log out from a telnet, rlogin, or serial port session. Telnet and rlogin connections are closed, and the serial port returns to the “login:” prompt. The commands exit and quit are accepted as synonyms for logout, as is control-D entered at the beginning of a line. Operands Example None. To log out from a rlogin session: switch:admin> logout Connection closed.
loopdiagClear Clear information from management layers. Synopsis loopdiagClear port Availability admin Description This command will clean up any residue information from a previous failed session in management layers. It releases all the resources created for the port specified. Operands This command has the following operand: port Example The physical port number where loopdiag executes. This operand is required.
loopdiagDone Completes loopdiag application. Synopsis loopdiagDone port Availability admin Description This command completes loopdiag application at the port specified. It releases all the resources created for loopdiag and sets the port ONLINE before resetting the loop. Operands The following operand is required: port Example The physical port number where loopdiag executes.
LSDbShow Display the FSPF Link State Database. Synopsis LSDbShow [domain] Availability All users Description Use this command to display a link state database record for switches in the fabric. There are two data structures – the permanently allocated Link State Database Entry and the Link State Record (LSR) that is allocated when a switch is connected to the fabric. The LSR for domain ‘n’ describes the links between the switch with domain number ‘n’ and its neighbor switches.
The display shows the fields in the following table. Table 9. LSDbShow display fields 122 Field Description Domain Domain number described by this LSR. A (self) keyword after the domain number indicates LSR describes the local switch. lsrP Pointer to LSR. earlyAccLSRs Number of LSRs accepted even though they were not sufficiently spaced apart. ignoredLSRs Number of LSRs not accepted because they were not sufficiently spaced apart. lastIgnored Last time an LSR was ignored.
Table 9. LSDbShow display fields (continued) Operands Field Description advertiser ID (domain number) of the switch that originated this LSR. incarn Incarnation number of this LSR. length Total length (in bytes) of this LSR. Includes header and link state information for all links. chksum Checksum of total LSR, with exception of lsAge field. linkCnt Number of links in this LSR. Each link represents a neighbor in NB_ST_FULL state. flags Always 0. LinkId ID of this link.
Examples To display the Link State Record for the local switch, as indicated by self keyword (the local switch has four links in NB_ST_FULL state, three of them connected to switch 5, and one connected to switch 4): switch:admin> LSDbShow 7 Domain = 7 (self), Link State Database Entry pointer = 0x103946a0 lsrP earlyAccLSRs ignoredLSRs lastIgnored installTime lseFlags uOutIfs uPathCost uHopsFromRoot mOutIfs parent mPathCost mHopsFromRoot = = = = = = = = = = = = = 0x1035bb30 1 0 Never 0x4f20a (324106) 0xa
mcastShow Display multicast routing information. Synopsis mcastShow [group_ID] Availability All users Description Use this command to display the multicast routing information, as it is known by the FSPF path selection and routing task, for all ports in the switch. The multicast routing information indicates, for each multicast group, all the ports that are members of that group; that is, ports that are able to send and receive multicast frames on that group.
Operands This command has the following operand: group_ID Example Specify the multicast group to be displayed.
msConfigure Configure the Management Server. Synopsis msConfigure Availability admin Description Use this command to display and configure parameters used to access the Management Server. The Management Server allows a storage area network (SAN) management application to retrieve and administer fabric and interconnect elements such as switches. It is located at the fibre channel address, FFFFFAh.
Example To display the Management Server access control list: switch:admin> msConfigure 0 Done 1 Display the access list 2 Add member based on its Port/Node WWN 3 Delete member based on its Port/Node WWN select : (0..3) [1] MS Access List consists of (5): { 20:01:00:60:69:00:60:10 20:02:00:60:69:00:60:10 20:03:00:60:69:00:60:10 20:02:00:60:69:00:60:03 20:02:00:60:69:00:60:15 } 0 1 2 3 Done Display the access list Add member based on its Port/Node WWN Delete member based on its Port/Node WWN select : (0..
msPlatShow Displays the Management Server Platform Database. Synopsis msPlatShow Availability admin Description This command enables an admin user to display the Management Server Platform Database. It displays the Platform name and associated attributes of each Platform object in the database. Platform Database Management is available in firmware v2.3 and above. Lower level firmware releases do not support Platform Database Management. Operands Example None.
msPlClearDB Clears the Management Server Platform Database on all switches in the fabric. Synopsis msPlClearDB Availability admin Description This command enables an admin user to clear the entire Management Server Platform Database on all switches in the fabric.
msPlCapabilityShow Display the Platform Database Management Capability. Synopsis msPlCapabilityShow Availability admin Description This command enables an admin user to query a fabric for the Platform Database Management capability. Based on the result of this command, the admin user can then decide if it is okay to activate the Platform database management service on all switches in the fabric.
msPlMgmtActivate Activates the Platform DB Management service on all switches in the fabric. Synopsis msPlMgmtActivate Availability admin Description This command enables an admin user to activate the Management Server Platform Database Management service on all switches in the fabric. It is recommended that the admin user run the msPlCapabilityShow command before issuing this command. If any switch within the fabric is not capable of handling the Platform Management service, this command is rejected.
msPlMgmtDeactivate Deactivates the Platform DB Management service on all switches in the fabric. Synopsis msPlMgmtDeactivate Availability admin Description This command enables an admin user to deactivate the Platform DB Management service. This command deactivates the Platform DB Management service of each switch in the fabric and commits the changes to the non-volatile storage of each switch. Once deactivated, even in the event of a reboot, the switch will initialize with the service DISABLED.
nbrStatsClear Reset FSPF interface counters. Synopsis nbrStatsClear [portnumber] Availability All users Description Use this command to reset the counters of FSPF frames transmitted and received on an interface. Use this command with no operand to reset counters on all interfaces. Operands This command has the following operand: portnumber 134 Specify the port number for the counters to be reset. This operand is optional.
Example To display how to reset the counters on port 4: switch:admin> interfaceShow 4 idbP = 0x10f61f40 Interface 4 data structure: nghbP = 0x10f61d90 ifNo = 4 defaultCost = 1000 cost = 1000 delay = 1 lastScn = 5 lastScnTime = Mar 29 12:57:52.833 upCount = 2 lastUpTime = Mar 29 12:57:52.833 downCount = 1 lastDownTime = Mar 29 12:57:47.566 downReason = 2 iState = UP Type to continue, Q to stop: Neighbor 4 data structure: state = NB_ST_FULL lastTransition = Mar 29 12:57:52.
nbrStateShow Display FSPF neighbor’s state. Synopsis nbrStateShow [portnumber] Availability All users Description Use this command to display information about neighbors to the local switch, or information about a specific neighbor if a port number is supplied. A neighbor is a switch that is directly attached to the local switch. The display shows the fields in the following table. Table 10. nbrStateShow display fields Operands Field Description Local Domain ID: Domain number of local switch.
Example To display information about switches directly connected to the local switch: switch:admin> nbrStateShow Local Domain ID: 15 Local Port Domain Remote Port State ------------------------------------------------------2 13 13 NB_ST_FULL 6 13 9 NB_ST_FULL 7 13 8 NB_ST_FULL 13 3 7 NB_ST_FULL See Also Telnet Commands interfaceShow 137
nsAllShow Display global Name Server information. Synopsis nsAllShow [type] Availability All users Description Use this command to display the 24-bit fibre channel addresses of all devices in all switches in the fabric. If the operand type is supplied, only devices of specified FC-PH type are displayed. If type is omitted, all devices are displayed. Operands This command has the following operand: type Example Specify the FC-PH type code.
nsShow Display local Name Server information. Synopsis nsShow Availability All users Description Use this command to display local Name Server information, including information about devices connected to this switch, and cached information about devices connected to other switches in the fabric. The following message is displayed if there is no information in this switch: There is no entry in the Local Name Server There still may be devices connected to other switches in the fabric.
There may be additional lines if the device has registered any of the following information (the switch automatically registers SCSI inquiry data for FCP target devices): • FC4s supported • IP address • IPA • port and node symbolic names • fabric port name • hard address and/or port IP address Operands 140 None.
Example To display local name server information: switch:admin> nsShow The Local Name Server has 7 entries { Type Pid COS PortName *N 011200; NodeName TTL(sec) 2,3;10:00:00:60:69:00:ab:ba;10:00:00:60:69:00:ab:ba; 60 FC4s: FCIP N 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; na FC4s: FCIP N 021300; 3;10:00:00:60:69:00:02:d6;20:00:00:60:69:00:02:d6; na NL 0214e2; 3;21:00:00:fa:ce:00:21:1e;20:00:00:fa:ce:00:21:1e; na FC4s: FCP [STOREX NL 0214e4; 0214e8; 0214ef; RS2999FCPH3 C
parityCheck Enable or disable DRAM parity checking. Synopsis parityCheck [ mode ] Availability admin Description This command enables DRAM parity checking. The mode is saved in flash memory and stays in that mode until the next execution of parityCheck. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. The DRAM parity checking, when enabled, causes ramTest to perform several additional tests of the parity memory.
passwd Change system login name and password. Synopsis passwd ["user"] Availability All users Description Use this command to change the system login name and password. To change the login name and password for a specific user, enter the command with the optional “user” operand. To change the login names and passwords for all users up to and including the current user’s security level, enter the command without the “user” operand. In either case, the user is first prompted to change the login name.
Control-D (end of file)* When entered at a prompt with no preceding input, terminates the command and saves changes made. * On most computers; however, your settings could be different. Operands This command has the following operand: Specify the name of the user, in quotation marks, for whom the login name and password are to be changed. This operand is optional.
Password unchanged. You have entered the carriage return special input case, choosing not to change the password. Number of failure attempts exceeded. You have made 3 unsuccessful attempts to enter and verify a new password. Passwords do not match; try again. See Also Telnet Commands You have not correctly verified the new password.
portCfgEport Enable or disable a port from becoming an E_Port. Synopsis portCfgEport [, ] Availability admin Description This command allows a user to enable/disable a port from becoming an E_Port. The E_Port capability is enabled by default unless this command is used to disable it. When a port is configured as a non-E_Port through this command, an ISL connected to this port will be segmented. No data traffic between two switches will be routed through this port.
Example To disable port 3 from becoming an E_Port: switch:admin> portCfgEport 3, 0 Committing configuration...done.
portCfgGport Designates a port as a locked G_Port. Synopsis portCfgGport portnumber, mode Availability admin Description This command enables a user to designate a port as a locked G_Port. Once this is done, the switch attempts to initialize that port as an F_Port only, and does not attempt loop initialization (FL_Port) on the port. However, if the device attached to the port initiates loop communication, then the switch responds accordingly and the port can then become an FL_Port.
portCfgLport Lock a port as an L_PORT. Synopsis portCfgLport port_number mode Availability admin Description This command enables a user to designate a port as an L_PORT. The switch will then only attempt to initialize that port as an FL_PORT. The switch will never attempt point-to-point (F_PORT) initialization on the port. However, if the device attached to the port initiates point-to-point communication, then the switch will respond accordingly, and the port may then become an F_PORT.
portCfgLongDistance Configure a port to support long distance links. Synopsis portCfgLongDistance portnumber [0|1|2] Availability admin The Extended Fabric license key is required to use this command. Description Use this command to specify the allocation of enough full size frame buffers on a particular port to support a long distance link of up to 100 km. The port can be used as either an Fx_Port or an E_Port.
Operands This command has the following operands: portnumber The port number to be configured: 0-7 or 0-15. This operand is required. 0|1|2 This operand indicates the distance to the connected port. This operand is optional.
portcfgMcastLoopback Configure a port to receive multicast frames. Synopsis portCfgMcastLoopback portnumber, 0|1 Availability admin Description Use this command to configure a port to receive multicast frames. This command allows a user to dedicate an unused port in a leaf (edge) switch, with no F_Port belonging to a multicast group, to receive multicast frames.
There are several things that occur when a port is configured as a multicast loopback port: • The green port LED will blink slowly, indicating a loopback state. If optical GBIC is applied, the laser will be disabled and will not respond to any attempt to connect to any device.
portDisable Disable a switch port. Synopsis portDisable portnumber Availability admin Description Use this command to disable a switch port. If the port is connected to another switch, the fabric may reconfigure. If the port is connected to one or more devices, the devices can no longer communicate with the fabric. If the port was online before being disabled, the following indicate a state transition: RSCN, SNMP trap, Web pop-up window.
portEnable Enable a switch port. Synopsis portEnable portnumber Availability admin Description Use this command to enable a switch port. If the port is connected to another switch, the fabric may reconfigure. If the port is connected to one or more devices, the devices can communicate with the fabric. For ports that come online after being enabled, the following may be sent to indicate a state transition: RSCN, SNMP trap, Web pop-up window. The front panel LED of an enabled and online port is green.
portErrShow Display port error summary. Synopsis portErrShow Availability All users Description Use this command to display an error summary for all ports. The display contains one output line per port and shows error counters in ones, thousands (K), or millions (M). The following fields are displayed: Operands 156 frames tx Frames transmitted. frames rx Frames received. enc in Encoding errors inside frames. crc err Frames with CRC errors. too shrt Frames shorter than minimum.
Example The following example shows an eight-port switch. Notice in the example that port 6 has a high number of errors and should be examined. switch:admin> portErrShow frames enc crc too too bad enc disc link loss loss frjt fbsy tx rx in err shrt long eof out c3 fail sync sig ---------------------------------------------------------------0: 0 0 0 0 0 0 0 0 0 0 0 1 0 1: 2.
portLogClear Clear the port log. Synopsis portLogClear Availability admin Description Use this command to clear the port log. You may want to clear the port log before triggering an activity so that the log displays only the activity related to that activity. See portLogShow for a description of the port log. If the port log is disabled, portLogClear enables it.
portLogDump Display the port log without page breaks. Synopsis portLogDump [count[, saved]] Availability All users Description Use this command to display the port log, listing all entries in the log without page breaks. This command displays the same information as portLogShow, but portLogShow prompts the user to enter “returns” between each page. See portLogShow for a description of the port log.
Example To display the port log: switch:admin> portlogdump 10 May 1 task event port cmd args ---------------------------------------------16:51:15.499 tShell ioctl 7 de 10f9bb90,0 16:51:15.499 tShell ioctl 8 de 10f9bb90,0 16:51:15.499 tShell ioctl 9 de 10f9bb90,0 16:51:15.499 tShell ioctl 10 de 10f9bb90,0 16:51:15.499 tShell ioctl 11 de 10f9bb90,0 16:51:15.499 tShell ioctl 12 de 10f9bb90,0 16:51:15.499 tShell ioctl 13 de 10f9bb90,0 16:51:15.499 tShell ioctl 14 de 10f9bb90,0 16:51:15.
portLogShow Display the port log. Synopsis portLogShow [count[, saved]] Availability All users Description Use this command to display the port log; 22 entries are displayed at a time. portLogShow displays the same information as portLogDump, but it allows you to enter a “return” after each page of output. If the port log is disabled, the following message appears as the first line (see portLogClear for details): WARNING: port log is disabled The fields in the following table are shown. Table 11.
Table 11. PortLogShow fields (continued) Field Description rejec received frame is rejected busy received frame is busied ctin CT based request is received ctout CT based response is transmitted errlog message is added to the error log loopscn loop state change notification is posted create task is created port Port number of the affected port.
Table 11. PortLogShow fields (continued) Field Description rejec received frame is rejected busy received frame is busied ctin CT based request is received ctout CT based response is transmitted errlog message is added to the error log loopscn loop state change notification is posted create task is created port Port number of the affected port.
Table 11. PortLogShow fields (continued) Field Description rejec received frame is rejected busy received frame is busied ctin CT based request is received ctout CT based response is transmitted errlog message is added to the error log loopscn loop state change notification is posted create task is created port Port number of the affected port.
Table 11.
Table 11. PortLogShow fields (continued) Field Description loopscn description depends on loop state: OLP offline reason code, usually zero LIP reason code for LIPs initiated by FL_Port, if the code value is 800x (x = [1,0xc]; see “Codes:”), or the lower two bytes of the LIP received, if the code value is other than 800x LIM usually zero BMP: memory address for the loop bitmap OLD usually zero TMO encoded value of state when loop initialization timed out.
pstate ioctl Telnet Commands AC Active State LR1 Link Reset: LR Transmit State LR2 Link Reset: LR Receive State LR3 Link Reset: LRR Receive State LF1 Link Failure: NOS Transmit State LF2 Link Failure: NOS Receive State OL1 Offline: OLS Transmit State OL2 Offline: OLS Receive State OL3 Offline: Wait for OLS State 90 Get virtual channel credits 91 Set virtual channel credits a1 Port is an E_Port a2 Port is an F_Port a3 Port is segmented a4 Domain name is known a5 Port enable
Operands 168 LIP 8001 Retry loop init reason 8002 Start loop after gaining sync 8003 Restart loop after port reset 8004 LIP when a loop hangs 8005 Restart loop if LIP received when sending out ARB(F0) 8006 LIP when an OPN returns 8007 Restart loop when LIPs received in OLD_PORT AC state 8008 Restart loop if loop not empty but E_Port loopback 8009 LIP as requested by the LINIT ELS received 800a LIP as requested by the LPC ELS received 800b Restart loop for QuickLoop looplet setup 80
Example The following example illustrates a section of the port log with an E_Port coming online. The ELP and EFP exchanges are shown; a name service request was processed. switch:admin> portLogShow 5 May 1 task event port cmd args ---------------------------------------------06:48:01.623 interrupt scn 13 2 06:48:02.359 tFspf ioctl 13 ab ffffff,10 06:48:04.699 tReceive Rx 13 0 c0fffffd,00fffffd,00bb0045 06:48:07.616 tReceive Rx 13 40 02fffffd,00fffffd,0046ffff,14000000 06:48:07.
portLoopbackTest Functional test of port N->N path. Synopsis portLoopbackTest [passCount] Availability admin Description Use this command to verify the functional operation of the switch by sending frames from the port N transmitter, and looping the frames back into the same port N receiver. The loopback is done at the parallel loopback path. The path exercised in this test does not include the GBIC nor the fiber cable. Only one frame is transmitted and received at any one time.
At each pass, the frame is created from a different data type. If seven passes are requested, seven different data types are used in the test. If eight passes are requested, the first seven frames use unique data types, and the eighth is the same as the first. There are seven data types: 1. CSPAT: 0x7e, 0x7e, 0x7e, 0x7e, ... 2. BYTE_LFSR: 0x69, 0x01, 0x02, 0x05, ... 3. CHALF_SQ: 0x4a, 0x4a, 0x4a, 0x4a, ... 4. QUAD_NOT: 0x00, 0xff, 0x00, 0xff, ... 5. CQTR_SQ: 0x78, 0x78, 0x78, 0x78, ... 6.
Errors There are seven possible error messages if failures are detected: DIAG-INIT DIAG-PORTDIED DIAG-XMIT DIAG-TIMEOUT DIAG-ERRSTAT DIAG-STATS DIAG-DATA See Also 172 camTest centralMemoryTest cmemRetentionTest cmiTest crossPortTest portRegTest ramTest spinSilk sramRetentionTest Fabric OS Reference Manual
portPerfShow Display port throughput performance in bytes, kilobytes, or megabytes. Synopsis portPerfShow [interval] Availability All users Description Use this command to display throughput information for all ports on the switch (8 or 16 columns depending on the switch model). One output line is displayed per interval (or second if no interval is specified) until return, control-C, or control-D is entered. Shown are the number of bytes received plus the number of bytes transmitted per interval.
portRegTest Bit write/read test of the ASIC SRAMs and registers. Synopsis portRegTest Availability admin Description Use this command to verify that SRAM and register data bits in each ASIC can be independently written and read. To verify the data bits, write a walking 1 pattern to each location – write a pattern of 0x00000001 to register N, read, and compare to be sure that the pattern is the same. Shift the pattern one bit to the left (to 0x00000002), and repeat the write, read, and compare cycle.
13.0x1000 14.0x2000 15.0x4000 16.0x8000 Repeat the preceding steps until all ASIC SRAMs and registers have been tested. Operands Example None. To run a bit write/read test of the ASIC SRAMs and registers: switch:admin> portRegTest Running Port Register Test .... passed.
portRouteShow Display routing tables for a port. Synopsis portRouteShow portnumber Availability All users Description Use this command to display the port address ID and the contents of the following port routing tables: External unicast routing table Shows unicast frame routing to another switch element in the fabric. Output format is domainnumber: ports_bitmap where: domainnumber is the switch element number that a unicast frame can reach from the portnumber port.
Multicast routing table Shows multicast frame routing to the destination multicast group. Output format is mcast_group_number: (mcast_group_id) ports_bitmap where: mcast_group_number is the multicast group number. mcast_group_id is the multicast frame destination ID. ports_bitmap is a hex bitmap of all output port numbers that can forward a multicast frame from the portnumber to mcast_group_id. Broadcast routing A bitmap, containing all ports reachable by a received table broadcast frame.
Example To display the port routing tables for switch port 3: switch:admin> portRouteShow 3 port address ID: 0x604300 external unicast routing table: 0: 0x10000 1: 0x2 internal unicast routing table: 0: 0x1 3: 0x4 6: 0x40 multicast routing table: broadcast routing table: 0x10045 See Also 178 bcastShow fabricShow mcastShow switchShow topologyShow uRouteShow Fabric OS Reference Manual
portShow Display port status. Synopsis portShow portnumber Availability All users Description Use this command to display status information for a port. Information varies with the switch model and port type. The display shows the fields in the following table. Table 12. PortShow display fields Field Description portFlags Bit map of port status flags. portType Port type and revision numbers.
Table 12. PortShow display fields (continued) Operands Field Description portScn Last state change notification for port. portRegs Address of the port hardware registers. portData Address of the port driver private data. portId 24-bit D_ID for port. portWwn Port worldwide name. Distance Ports long distance level. Interrupts Total number of interrupts. Unknown Interrupts that are not counted elsewhere. Lli Low-level interface (physical state, primitive seqs).
Example To display the status for a specified E_Port: switch:admin> portShow 1 portFlags: 0x20041 PRESENT U_PORT LED portType: 3.
portStatsShow Display port hardware statistics. Synopsis 182 portStatsShow portnumber Availability All users Description Use this command to display port hardware statistics counters. stat_wtx 4-byte words transmitted. stat_wrx 4-byte words received. stat_ftx Frames transmitted. stat_frx Frames received. stat_c2_frx Class 2 frames received. stat_c3_frx Class 3 frames received. stat_lc_rx Link control frames received. stat_mc_rx Multicast frames received. stat_mc_to Multicast timeouts.
Operands fl_opened Number of OPNyx received. fl_openfr Number of OPNfr sent. fl_cls_idle CLS sent due to loop idle. fl_cls_rx CLS received when OPEN. fl_bb_stall OPN/CLS BB_Credit stalls. fl_cf_alloc Number of CFIFOs allocated. fl_cf_opn CFIFOs delivered when OPENED. fl_cf_full Number of CFIFOs full stalls. fl_cf_na CFIFO not available stalls. fl_trig_age Number of age count triggers. fl_trig_lp Number of loop not busy triggers. open Number of times the FL_Port entered OPEN state.
Example To display a port with only the basic set of statistics: switch:admin> stat_wtx stat_wrx stat_ftx stat_frx stat_c2_frx stat_c3_frx stat_lc_rx stat_mc_rx stat_mc_to stat_mc_tx tim_rdy_pri tim_txcrd_z er_enc_in er_crc er_trunc er_toolong er_bad_eof er_enc_out er_disc_c3 See Also 184 portStatsShow 3 1181994 4-byte words transmitted 1188458 4-byte words received 95830 Frames transmitted 15564 Frames received 0 Class 2 frames received 93 Class 3 frames received 7735 Link control frames received 0 Mul
psShow Display power supply status. Synopsis psShow Availability All users Description Use this command to display the switch power supply status. The display format varies with switch model and number of power supplies present. The status of each supply is shown: OK Power supply present and functioning correctly. absent Power supply not present. faulty Power supply present but faulty (no power cable, power switch turned off, fuse blown, or other internal error).
quietMode Toggles shell quiet mode on and off. Synopsis quietMode [0|1] Availability All users (display) admin (set/clear) Description Use this command to change the output displayed on the switch console (serial port or telnet session). By default, quiet mode is off and all switch tasks can send output to the console, including output caused by asynchronous events, such as the fabric reconfiguring, or devices logging in.
ramTest Bit write/read test of SDRAMs in the switch. Synopsis ramTest [patternSize] Availability admin Description Use this command to verify the address and data bus of the SDRAMs that serve as the 16 MB CPU memory in the switch. The test consists of two subtests: 1. The address subtest verifies that SDRAM locations can be uniquely accessed. The method used is to write a unique pattern to each location in the SDRAMs.
– 0x14284281 – 0x137ffec8 – 0x0f0f0f0f – 0x00000000 Since the test requires the operating system to operate which is loaded in the same memory, it does not and cannot test all 16 MB of the memory. Instead it tests the largest portion as given by the OS, which is typically about 13 MB. Operands This command has the following operand: patternSize Example If 0 (default), ramTest executes all nine patterns in the data subtest. If N, ramTest executes N patterns in the data subtest.
reboot Reboot the switch. Synopsis reboot Availability admin Description Use this command to reboot the switch. The reboot takes effect immediately as the switch resets, and then executes the normal power-on booting sequence. While the switch is rebooting, the telnet session is closed and all fibre channel ports are inactive. If the switch was part of a fabric, the remaining switches reconfigure. Operands Example None. To reboot the switch: switch:admin> reboot Rebooting...
routeHelp Display routing help commands. Synopsis routeHelp Availability admin Description Use this command to display routing help commands. Operands Example None.
setGbicMode Enable or disable GBIC mode. Synopsis setGbicMode [0|1] Availability admin Description Use this command to enable or disable the GBIC mode. If the mode operand is 1, GBIC mode is enabled; if the mode operand is 0, GBIC mode is disabled. The mode is saved in flash memory and stays in the GBIC mode until the next execution of setGbicMode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
setSplbMode Enable or disable 2-port loopback. Synopsis setSplbMode [0|1] Availability admin Description Use this command to enable SPLB mode if the operand is 1 and disable the SPLB mode if the operand is 0. The mode is saved in flash memory and stays in that mode until the next execution of setSplbMode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
Operands This command has the following operand: mode Example Specify whether to enable or disable SPLB mode. Specify 1 to enable GBIC mode or 0 to disable SPLB mode. The default value (if no operand specified) is 0. To enable or disable a 2-port loopback: switch:admin> setSplbMode 1 Committing configuration...done. SPLB mode is now ON. switch:admin> setSplbMode 0 Committing configuration...done. SPLB mode is now OFF.
sgroupDelete Delete a switch group. Synopsis sgroupDelete sgName [, force] Availability admin Description This command deletes a switch group. If the parameter is not specified, the command will become an interactive session and the necessary parameters will be prompted. This command makes the same change to all switches in the specified group. It executes on every switch in the group if and only if each switch in the group can perform the action.
This example shows what happens when an invalid group is entered: switch:admin> sgroupDelete "MyPrevGroup" Group Name "MyPrevGroup" does not exist. See Also sgroupRename sgroupSet sgroupShow sgroupSupportShow sgroupSwReplace sgroupRename Rename a switch group. Synopsis sgroupRename ["old_sgName", "new_sgName"] Availability admin Description This command renames a specified sgroup name to the given new name. The member list for the renamed group is not modified.
Example To rename an sgroup: switch:admin> sgroupShow Group Type Group Name Member WWN ========== ============================= ======================= S32_6_1 MyPrevGroupName 10:00:00:60:69:00:00:20 10:00:00:60:69:20:15:81 10:00:00:60:69:10:02:18 10:00:00:60:69:20:15:71 10:00:00:60:69:00:30:05 10:00:00:60:69:00:60:11 switch:admin> sgroupRename "MyPrevGroupName", "MyNewGroupName" Committing configuration...done.
sgroupSet Create a switch group. Synopsis sgroupSet ["sgType", "sgName", "sgMemberList"] Availability admin Description This command creates a switch group. If any parameter is not specified, the session will become an interactive session for which all the parameters will be prompted. Operands This command has the following operands: sgType Specify a character string in quotation marks containing the sgroup type, for example, “S32_6_1”. The given type MUST be a valid type.
Examples To set a group called “My Group” of type “S32_6_1” using Domain IDs 1 through 6: switch:admin> sgroupSet "S32_6_1", "MyGroup", "1,2,3,4,5,6" Committing configuration...done.
sgroupShow Display switch group configuration information. Synopsis sgroupShow ["sgType" | "sgName"] Availability all users Description This command displays switch group information. If no parameter is specified, ALL sgroup definitions will be displayed. If a parameter is specified, ALL sgroups with sgType or sgName that contain the given parameter string will be displayed.
To display ALL switch groups that contain the key word “Group”: switch:admin> sgroupShow "Group" Group Type Group Name Member WWN ========== ============================== ======================= S32_6_1 MyNewGroupName 10:00:00:60:69:00:00:20 10:00:00:60:69:20:15:81 10:00:00:60:69:10:02:18 10:00:00:60:69:20:15:71 10:00:00:60:69:00:30:05 10:00:00:60:69:00:60:11 Since MyNewGroupName contains the key word “Group”, it is displayed.
sgroupSupportShow Displays switch information for all switches within the specified group. Synopsis sgroupSupportShow "sgroupName" [, "commandName"] Availability All users Description This command can display a range of debugging information for all the switches in a switch group. If no commandName is specified or “all” is specified in place of a command name, all the supported commands are displayed for the all the switches within a switch group.
portErrShow faultShow mqShow traceShow portSemShow portLogDump portShow Example To display the temperature in all the switch components of a SilkWorm 6400: sw5:admin>sgroupsupportshow "starbase", "tempshow" Group Type Group Name Member WWN ================ ================================ ======================= S32_6_1 starbase 10:00:00:60:69:10:57:91 10:00:00:60:69:10:56:79 10:00:00:60:69:10:58:89 10:00:00:60:69:10:57:dd 10:00:00:60:69:10:58:63 10:00:00:60:69:10:58:3f Please wait for remote
Information from Domain 10 ======================================== 26 30 31 34 31 Centigrade 78 86 87 93 87 Fahrenheit ======================================== Information from Domain 11 ======================================== 28 29 31 33 32 Centigrade 82 84 87 91 89 Fahrenheit ======================================== Information from Domain 12 ======================================== 28 31 34 35 33 Centigrade 82 87 93 95 91 Fahrenheit ====================DONE==========
sgroupSwReplace Replace a member of a switch group. Synopsis sgroupSwReplace ["sgName", "oldWwn", "newWwn"] Availability admin Description This command replaces the member with oldWwn in group sgName with the member with newWwn. The order of members within the member list will not be changed by this operation. If any parameter is not specified, the session will become an interactive session and all the parameters will be prompted.
Example The example shows the noninteractive form of sgroupSwReplace. The sgroupShow command is used to illustrate the changes made with the sgroupSwReplace command.
snmpMibCapSet View and modify options for configuring SNMP MIB/Trap Capability. Synopsis snmpMibCapSet Availability admin Description This command enables a user to turn on or off certain MIBS and TRAPS. This command also enables a user to turn on or off group information and SSN in SW trap messages. It first displays current settings and then prompts the user to change the values for each parameter. • FA-MIB – Specifying yes means the user can access FA MIB variables with an SNMP manager.
spinSilk Functional test of port M->N path at maximum switch speed. Synopsis spinSilk [nMillionFrames] Availability admin Description Use this command to verify the functional operation of the switch at the maximum speed of 1 Gbps. To run spinSilk, set up the routing hardware so that frames received by port M are retransmitted through port N and frames received by port N are retransmitted through port M.
4. Transmit 4 frames of different lengths using port M: 2112 bytes of BYTE_LFSR 1000 bytes of CSPAT 128 bytes of RANDOM 512 bytes of RDRAM_PAT The partner port N eventually sends 4 similar frames: 2112 bytes of BYTE_LFSR 928 bytes of CSPAT 200 bytes of RANDOM 480 bytes of RDRAM_PAT 5.
GBIC Mode If spinSilk is executed with GBIC mode activated, only ports containing GBICs are tested.
Example To verify the functionality of a switch: switch:admin> spinSilk 2 Running Spin Silk ............. One moment please ... switchName: switch switchType: 2.
Diagnostics Status: Tue Apr 6 04:10:12 1999 port#: 0 1 2 3 4 5 6 7 8 9 diags: OK OK OK OK OK OK OK OK OK OK state: UP UP UP UP UP UP UP UP UP UP lm0: lm1: lm2: lm3: lm4: lm5: lm6: lm9: lm10: lm11: lm12: lm13: lm14: lm15: 2059619 2054565 2050424 2053094 2042957 2056586 2048992 2039595 2050130 2054678 2049707 2053410 2053358 2056132 frTx frTx frTx frTx frTx frTx frTx frTx frTx frTx frTx frTx frTx frTx 2052666 2052620 2048321 2042762 2053290 2053910 2048569 2051975 2052565 2056622 2050131 2050976 2040971 20
sramRetentionTest Data retention test of the miscellaneous SRAMs in ASIC. Synopsis sramRetentionTest [passCount] Availability admin Description Use this command to verify that data written into the miscellaneous SRAMs in the ASIC are retained after a 10-second wait. The method used is to write a fill pattern to all SRAMs, wait 10 seconds, and then read all SRAMs checking that data read matches data previously written. Repeat using the complementary version of the pattern.
Errors There are three possible error messages if failures are detected: DIAG-REGERR DIAG-REGERR_UNRST DIAG-BUS_TIMEOUT See Also Telnet Commands camTest centralMemoryTest cmemRetentionTest cmiTest crossPortTest portLoopbackTest ramTest spinSilk 213
supportShow Print switch information for debugging purposes. Synopsis supportShow [firstPort, lastPort, nLog] Availability All users Description Use this command to print the switch information for debugging purposes. This command executes the listed commands in the following order: 1. version 2. uptime 3. tempShow 4. psShow 5. licenseShow 6. diagShow 7. errDump 8. switchShow 9. portFlagsShow 10.portErrShow 11.mqShow 12.portSemShow 13.portShow 14.portRegShow 15.portRouteShow 16.fabricShow 17.
23.faultShow 24.traceShow 25.portLogDump Operands This command has the following operands: firstPort Specify the first port, of a range of ports, to dump information. The default (if no operand is specified) is to print state of port 0. If only firstPort is specified, only information for firstPort is printed. lastPort Specify the last port, of range of ports, to dump information.
Example To display switch information for debugging: switch:admin> supportShow Kernel: 5.3.1 Fabric OS: Made on: Flash: BootProm: v2.1 Tue Apr 6 16:57:22 PDT 1999 Thu Apr 1 10:23:43 PST 1999 Thu Oct 1 13:34:29 PDT 1998 Up for: 12 secs Powered for: 472 days, 19:15 Last up at: Tue May 2 10:48:21 2000 Reason: Reboot 37 98 34 93 37 98 45 113 49 120 Centigrade Fahrenheit Power Supply #1 is absent Power Supply #2 is absent byRdzdSRxyczSe0D: Web license Diagnostics Status: Tue Apr 6 16:22:34 1999 < .
switchBeacon Set switch beaconing mode on or off. Synopsis switchBeacon 0|1 Availability admin Description Use this command to set the switch beaconing mode on (if the operand is 1) or off (if the operand is 0). When beaconing mode is turned on, the port LEDs flash amber in a running pattern from port 0 to port 15, and then back again. The user sees a running pattern in amber LEDs, from left to right and right to left. The pattern continues until turned off by the user.
To turn beaconing mode OFF: switch:admin> switchBeacon 0 See Also switchShow switchDisable Disable the switch. Synopsis switchDisable Availability admin Description Use this command to disable the switch. All fibre channel ports are taken offline; if the switch was part of a fabric, the remaining switches reconfigure. The switch must be disabled before making configuration changes (using configure or configDefault) or before running many of the diagnostic tests.
switchEnable Enable the switch. Synopsis switchEnable Availability admin Description Use this command to enable the switch. All fibre channel ports that passed POST are enabled. They can come online if connected to a device, or remain offline if disconnected. A switch may need to be enabled if it was previously disabled to make configuration changes or to run diagnostics. If the switch is connected to a fabric, it rejoins the fabric.
switchName Display or set switch name. Synopsis switchName ["newName"] Availability All users (display) admin (set) Description Use this command without an operand to display the current switch name. This name is also shown in the telnet prompt, under each switch icon on the Web Tools Fabric View, and in the output of many telnet commands. Use this command with the newName operand to assign a new switch name.
switchShow Display switch and port status. Synopsis switchShow Availability All users Description Use this command to display switch and port status information. Information may vary by switch model (see list that follows). The first section provides switch summary information; it is followed by a section covering summary information by port. Telnet Commands switchName Switch symbolic name. switchType Switch model and revision numbers. switchState Switch state: online, offline, testing, faulty.
The switch summary is followed by one line per port: port number Port number. Valid values are 0-7 or 0-15 depending on the switch type.
comment The comment field may be blank, or it may display: Disabled - port is disabled Bypassed - port is bypassed (loop only) Loopback - port is in loopback mode E-Port - fabric port, shows WWN of attached switch F-Port - point-to-point port, shows WWN of attached N_Port G-Port - point-to-point but not yet E-Port or F-port L-Port - loop port, shows number of NL_Ports Operands Telnet Commands None.
Example The following example illustrates a 16-port switch. Two ports are F_Ports (point-to-point connections to N_Ports), two ports are loop ports (one has 8 private loop devices), and two ports are connected to another switch “sw6”. switch:admin> switchshow switchName: switch switchType: 2.
switchStatusPolicySet Set the policy parameters that determine the overall switch status. Synopsis switchStatusPolicySet Availability admin Description Use this command to set the policy parameters for calculating the overall status of the switch enclosure. The policy parameter values determine how many failed or faulty units of each contributor are allowed before triggering a status change in the switch from HEALTHY to MARGINAL or DOWN.
This command enables you to set a threshold for each contributor, so that a certain number of failures are allowed before changing the status of the switch. If the value of a policy parameter is set to 0, it means that this factor is not used to determine the status of the switch. If the range of values for a particular contributor are set to 0 for both MARGINAL and DOWN, that contributor is not used in the calculation of the overall switch status.
Example Notice that in the following example, the only parameters modified are the number of FaultyPorts allowed before the status of the switch changes to MARGINAL and DOWN.
switchStatusPolicyShow Displays the policy parameters that determine the overall switch status. Synopsis switchStatusPolicyShow Availability All users Description Use this command to view the current policy parameters set for the switch. These policy parameters determine the number of failed or nonoperational units allowed for each contributor before triggering a status change in the switch. The command will print the current parameters in a three-column table format.
Operands Example None.
switchStatusShow Displays the overall status of the switch. Synopsis switchStatusShow Availability All users Description Use this command to display the overall status of the switch.
Examples Two examples are shown: The first shows a switch with a status of MARGINAL; the second shows the same switch after all the errors have been fixed.
syslogdIpAdd Add the IP address of a syslog daemon. Synopsis syslogdIpAdd IP_address Availability admin Description Use this command to add the IP address of a syslog daemon, that is, the IP address of the server that is running the syslogd process. Syslog daemon (syslogd) is a process available on most UNIX systems that reads and forwards system messages to the appropriate log files and/or users, depending on the system configuration.
syslogdIpRemove Remove the IP address of a syslog daemon. Synopsis syslogdIpRemove IP_address Availability admin Description Use this command to remove the IP address of a syslog daemon, that is, the IP address of the server that is running the syslogd process. Operands This command has the following operand: IP_address Example Specify the IP address of the server running syslogd. To remove the address 192.168.1.
syslogdIpShow Display all syslog daemon IP addresses. Synopsis syslogdIpShow Availability All users Description Use this command to display all syslog daemon IP addresses in the configuration database. Operands Example None. To display all syslog daemon IP addresses: switch:admin> syslogdIpShow syslog.IP.address.1: syslog.IP.address.2: syslog.IP.address.3: See Also 234 192.168.1.60 192.168.1.88 192.168.2.
tempShow Display temperature readings. Synopsis tempShow Availability All users Description Use this command to display the current temperature readings from each of five temperature sensors located on the main printed circuit board of the switch. The sensors are located, approximately, one in each corner and one at the center of the PCB. Operands Example None.
timeOut Used to set or clear idle telnet connection time-out value. Synopsis timeOut [0 | minutes] Availability All users (display) admin (set/clear) Description This command changes the telnet time-out value used by the shell. The default value of zero means that telnet time outs are disabled. A nonzero value specifies the number of minutes to wait before an idle telnet session is timed out. The minimum value is 1 minute, the maximum is 512640 minutes (1 year).
topologyShow Display the unicast fabric topology. Synopsis topologyShow [domainnumber] Availability All users Description Use this command to display the fabric topology, as it appears to the local switch: • A list of all domains that are part of the fabric, and to each of those domains, all possible paths from the local switch.
Operands In Ports: Bit map of input ports to use the corresponding Out Port to reach the destination domain. A bit set to 1 indicates the port is being routed through the corresponding Out Port. The least significant bit represents port 0. This is the same information provided in a different format by portRouteShow and uRouteShow. Flags: Always ‘D’, indicating a dynamic path. A dynamic path is discovered automatically by the FSPF path selection protocol. Name: Name of destination switch.
trackChangesSet Enables configuring of track-changes feature. Synopsis trackChangesSet [ mode ], [ snmptrapmode ] Availability admin Description This command enables or disables the track-changes feature. An SNMP-TRAP mode can also be enabled.
Example Two examples are shown: The first sets the track-changes feature and disables SNMP TRAP messages. The second disables both the track-changes feature and SNMP TRAP messages. switch:admin> trackChangesSet 1, 0 0x10f9bcd0 (tShell): Feb 10 15:04:38 Error TRACK-TRACK_ON, 4, Track-changes on Committing configuration...done.
uptime Display length of time the system has been operational. Synopsis uptime Availability All users Description Use this command to display the length of time the system has been in operation (also known as “up time”), the total cumulative amount of up time since the system was first powered-on, the date and time of the last reboot, and the reason for the last reboot. For up and powered-on times less than 60 seconds, the time is displayed in seconds.
Powerfail NMI* Power supply caused a nonmaskable interrupt. Watchdog NMI* Watchdog timer caused a nonmaskable interrupt. PushButton NMI* Push buttons 2 and 4 were depressed for 2 seconds, causing a nonmaskable interrupt. Software NMI* Firmware caused a nonmaskable interrupt. Note The items marked with an asterisk (*) are usually caused by hardware or firmware failures. Information on the failure is stored in the switch. Follow the procedures in the switch manual. Operands Example None.
uRouteConfig Configure a static route. Synopsis uRouteConfig portnumber, domainnumber, outputportnumber Availability admin Description Use this command to configure static routes. A static route is assigned a specific path; the path does not change with a topology change unless the path becomes unavailable. After this command is issued, and if output_portnumber is a usable port, all frames coming in from port portnumber addressed to domainnumber are forwarded through port output_portnumber.
outputportnumber Example Specify the output port where traffic is to be forwarded. This operand is required. To configure a static route for all traffic coming in from port 1 and addressed to domain 2 to go through port 5: switch:admin> uRouteConfig 1,2,5 The configuration will now contain the static route: switch:admin> configShow "route" route.ucastRoute.1.2: 5 route.
uRouteRemove Remove a static route. Synopsis uRouteRemove portnumber, domainnumber Availability admin Description Use this command to remove a statically configured route. When this command is issued, the route to domainnumber for portnumber may not change. It does not change if the previous static route was along a minimum cost path. After this command is issued, the load sharing to domain domainnumber is revaluated.
uRouteShow Display unicast routing information. Synopsis uRouteShow [portnumber],[domainnumber] Availability All users Description Use this command to display the unicast routing information for a port, as it is known by the FSPF path selection/routing task. The routing information describes how a frame, which is received from a port on the local switch, is to be routed to reach a destination switch. The following information is displayed: Local Domain ID: Domain number of local switch.
Operands This command has the following operands: No Operand Displays routing information for all active ports on the local switch, to all the domains in the fabric. portnumber Displays routing information for port portnumber to all the domains in the fabric. portnumber, domainnumber Displays routing information for port portnumber to domain domainnumber.
version Display firmware version information. Synopsis version Availability All users Description Use this command to display firmware version information and build dates.
2 ERROR MESSAGES This chapter explains the Fabric OS error message format and possible errors: • “System Error Message Formats” on page 250 • “Displaying Error Messages Using Telnet” on page 251 • “Resetting Bad Ports” on page 252 • “POST Test Commands” on page 252 • “POST Test Failure and Recovery Actions” on page 253 • “Error Message Numbers” on page 254 • “Diagnostic Error Messages” on page 259 • “System Error Messages” on page 267 249
System Error Message Formats Error message formats for the switch are the same whether you are accessing the information from the local RS-232 serial port or using a remote telnet session. Errors are listed in reverse chronological order. Up to 64 messages can be held in the buffer. Once the buffer limit is exceeded, the oldest message is deleted. The errShow command displays all detected errors. The errShow command output provides more information than the front panel display.
Figure 1. errShow Command Example Displaying Error Messages Using Telnet To display the error messages compiled by your system, perform the following procedure: 1. Log in as an admin user to the switch, using a telnet connection. 2. From the prompt, enter the errShow command. 3. To scroll through the error list, type CR. 4. Scroll through error log to view the error messages. If no errors are encountered, this command displays “No Error”.
Resetting Bad Ports If any port fails during a diagnostic test, it is marked BAD in the status display. To retest a port that has been marked BAD, clear the port and set to OK using the diagClearError (port#) command. This command clears the port status only and does not clear the logs or change the port’s condition. The diagClearError (port#) command should only be used during diagnostic procedures to reset a bad port for retest.
POST Test Failure and Recovery Actions This section provides information on what actions to perform if the switch fails any of the POST tests. Note If you run the portStatsShow or the diagShow command prior to running an individual test, errors may appear as a result of the normal synchronization process. These errors should be addressed if the number of errors found increases after running the portStatsShow command again. Table 16.
Error Message Numbers An error number (ERR#xxxx) appears at the end of a diagnostic error message. Table 17 matches each error number with the test that caused the error and the name of the error. Look up the complete definition of the error name and the actions that will correct it in Table 18. Table 17.
Table 17.
Table 17.
Table 17.
Table 17.
Diagnostic Error Messages This section provides information on the probable cause of a diagnostic error and what actions to take. Table 18.
Table 18.
Table 18.
Table 18. Diagnostic Error Messages (continued) Message Description DIAG-ERRSTAT Port Error Statistics counter is nonzero, meaning an error was detected when receiving frames.
Table 18.
Table 18.
Table 18.
Table 18. Diagnostic Error Messages (continued) Message Description Probable Cause Action DIAG-STATS Err#2660-2662, 3060 3062 Port counter value did not match the number of frames actually transmitted.
System Error Messages This section provides information on the probable cause of a system error and what actions to take. Table 19. System Error Messages Message Description Probable Cause Action ASIC, MINI_BUFFER, LOG_WARNING ASIC Failure Bad mainboard Contact customer support CONFIG CORRUPT The switch configuration information has become irrevocably corrupted.
Table 19.
Table 19.
Table 19.
Table 19.
Table 19. System Error Messages (continued) Message Description Probable Cause Action RPC, SVC_EXIT An RPC service daemon has terminated prematurely or unexpectedly. OS error Contact customer support RPC, SVC_REG An RPC service daemon could not establish service for a particular protocol handler.
Table 19.
Fabric OS Reference Manual
3 FEATURE TELNET COMMANDS This chapter summarizes commands for Zoning, Quicklook, Extended Fabrics, Fabric Watch, and FC 6164: • “Zoning Commands” on page 276 • “QuickLoop Commands” on page 277 • “Extended Fabric Command” on page 278 • “Fabric Watch Commands” on page 278 • “FC 6164 Commands” on page 279 For detailed information about the telnet commands for Zoning, Quickloop, Extended Fabrics, or Fabric Watch, see the specific user’s guide for that feature.
Zoning Commands For detailed information about these commands, see the Zoning User’s Guide. Table 20. Zoning Commands Command Description Zone Alias aliAdd Adds a member to a zone alias. aliCreate Creates a zone alias. aliDelete Deletes a zone alias. aliRemove Removes a member from a zone alias. aliShow Shows zone alias definition. Zoning zoneAdd Adds a member to a zone. zoneCreate Creates a zone. zoneDelete Deletes a zone. zoneRemove Removes a member from a zone.
Table 20. Zoning Commands (continued) Command Description Zone Configuration and Management cfgAdd Adds a zone to a zone configuration. cfgClear Clears all zone configurations. cfgCreate Creates a zone configuration. cfgDelete Deletes a zone configuration. cfgDisable Disables a zone configuration. cfgEnable Enables a zone configuration. cfgRemove Removes a zone from a zone configuration. cfgSave Saves zone configurations in flash memory. cfgShow Shows zone configuration definition.
Table 21. QuickLoop Commands (continued) Command Description qlPortEnable Enables a QuickLoop port to QuickLoop mode. qlShow Displays QuickLoop information. qlStatsShow Displays QuickLoop statistics. qlPortShowAll Displays QuickLoop port information. Extended Fabric Command For detailed information about this command, see the Distributed Fabrics User’s Guide. Table 22. Extended Fabric Commands Command Description portCfgLongDistance Configures a port to support long distance links.
FC 6164 Commands The following commands are specific to the administration of the FC 6164 switch. For more detailed information on these commands, see the HP Surestore FC Switch 6164 Installation and Reference Guide. Table 24. FC 6164 Commands Feature Telnet Commands Command Description islTopoCheck Displays ISL switch group connections for a switch. islTopoShow Displays ISL switch group topology and status. sgroupDelete Deletes a switch group. sgroupRename Renames a switch group.
Fabric OS Reference Manual
GLOSSARY 8b/10b encoding Encoding scheme that converts each 8-bit data byte into a 10-bit transmission character. Used to balance ones and zeros in high-speed transports. Address identifier Value used to identify source or destination of a frame. AL_PA Arbitrated Loop Physical Address. Unique 8-bit value assigned during loop initialization to each port in an arbitrated loop. Alias server Fabric software facility that supports multicast group management. ANSI American National Standards Institute.
BB_Credit Buffer-to-buffer credit. The number of frames that can be transmitted to a directly connected recipient or within an arbitrated loop. Determined by number of available receive buffers. See also Buffer-to-buffer flow control, EE_Credit. BER Bit Error Rate. Rate at which bits are expected to be received in error. Expressed as ratio of error bits to total bits transmitted. See also Error. Bit synchronization The delivery of correctly clocked bits at the required Bit Error Rate. See also BER.
Community (SNMP) Relationship between a group of SNMP managers and an SNMP agent, in which authentication, access control, and proxy characteristics are defined. CRC Cyclic Redundancy Check. A check for transmission errors; included in every data frame. Credit As applies to fibre channel, the number of receive buffers available for transmission of frames between ports. See also BB_Credit and EE_Credit.
EE_Credit End-to-end credit. The number of receive buffers allocated by recipient port to originating port. Used by Class 1 and 2 services to manage exchange of frames across intervening ports in fabric. See also End-to-end flow control, BB_Credit. Enabled configuration The currently enabled zone configuration. Only one configuration can be enabled at a time. See also Defined configuration, Zone configuration. End-to-end flow control Governs flow of Class 1 and 2 frames between N_Ports.
FC-PH-1, 2, 3 The Fibre Channel Physical and Signaling Interface standards. FC-PI The Fibre Channel Physical Interface standard. FC-PLDA The Fibre Channel Private Loop Direct Attach standard. Applies to operation of peripheral devices on private loops. FC-SW-2 The Fibre Channel Switch Fabric standard, second generation. Specifies tools and algorithms for interconnection and initialization of fibre channel switches.
Fx_Port Fabric port that can operate either as F_Port or FL_Port. See also F_Port, FL_Port. G_Port Generic Port. Port that can operate either as E_Port or F_Port. Ports are defined as G_Ports when disconnected or have not assumed a specific function within fabric. Gateway IP address assignment that provides translation for incompatible networks. For example, ATM gateway can connect a fibre channel link to an ATM connection. GBIC Gigabit Interface Converter.
IU Information Unit. An individual set of information as defined by higher-level process protocol definition, or upper-level protocol mapping. JBOD Just a Bunch Of Disks. A number of disks connected in a single chassis to one or more controllers. See also RAID. K28.5 Special 10-bit character used to indicate beginning of transmission words that perform fibre channel control and signaling functions. First seven bits are comma pattern. See also Comma. L_Port Loop Port.
Multicast Transmission of data from a single source to a number of specified N_Ports. See also Broadcast, Unicast. Multimode Fibre-optic cabling specification allowing up to 500 meters between devices. N_Port Node Port. Port that can attach to a fibre channel port. See also NL_Port, Nx_Port. Name server Service of storing names, addresses, and attributes for up to 15 minutes, provided by a switch to other entities in fabric. Defined by fibre channel standards, and existing at a well-known address.
Port_Name Unique FC identifier for port, communicated during login and port discovery. POST Power On Self Test. Series of self-tests run after a switch is rebooted or reset. Private NL_Port NL_Port that does not log into the fabric and communicates only with private NL_Ports in same loop. Private device Device that supports arbitrated loop protocol and understands 8-bit addresses, but cannot log into fabric. Private loop An arbitrated loop with no fibre channel attachment.
SAN Storage Area Network. Network of systems and storage devices that usually communicate using fibre channel protocols. See also Fabric. Sequence A fibre channel structure containing one or more frames transmitted in a unidirectional manner between N_Ports. See also Exchange, Frame. Single mode Fibre-optic cabling standard that provides for distances of up to 10 kilometers between devices. SNMP Simple Network Management Protocol.
Trap (SNMP) Message sent by SNMP agent to inform SNMP management station of critical error. See also SNMP. Tunneling Technique for enabling source and destination hosts to communicate when on same type of network but connected by a different type of network. U_Port Universal Port. Switch port that can operate as G_Port, E_Port, F_Port, or FL_Port. A port is defined as a U_Port if not connected or if it has not assumed a specific function in the fabric. ULP Upper Layer Protocol.
Fabric OS Reference Manual
INDEX A agtcfgDefault 13 agtcfgSet 16 agtcfgShow 19 aliasShow 22 B BadEOF 262 BadOrdSet 262 bcastShow 24 C camTest 26 centralMemoryTest 27 cmemRetentionTest 29 cmiTest 30 configDefault 32 configDownload 33 configShow 36 configUpload 38 configure 40 CRC_err 262 crossPortTest 49 D date 55 diagClearError 57 diagDisablePost 58 diagEnablePost 60 diagHelp 61 diagnostic error messages 259 diagShow 62 DiscC3 262 displaying error messages 251 dlsReset 65 dlsSet 66 dlsShow 67 E Enc_in 262 Enc_out 262 errDump 68 err
F fabricShow 75 fanShow 77 fastboot 78 Fibre Channel Association 12 firmwareDownload 79 FrmTooLong 262 fspfShow 82 G gbicShow 84 H h command 86 help 87 I i command 88 ifModeSet 91 ifModeShow 92 ifShow 93 interfaceShow 95 iodReset 102 iodSet 103 iodShow 104 ipAddrSet 105 ipAddrShow 107 islTopoCheck 108 islTopoShow 110 L licenseAdd 112 licenseHelp 113 licenseRemove 114 licenseShow 115 linkCost 116 login 117 logout 118 294 loopdiagClear 119 loopdiagDone 120 LSDbShow 121 M mcastShow 125 msConfigure 127 msPlat
Q quietMode 186 R ramTest 187 reboot 189 resetting bad ports 252 routeHelp 190 S setGbicMode 191 setSplbMode 192 sgroupDelete 194 sgroupRename 195 sgroupSet 197 sgroupShow 199 sgroupSupportShow 201 sgroupSwReplace 204 snmpMibCapSet 206 software, updates 12 spinSilk 207 sramRetentionTest 212 support, technical 12 supportShow 214 switchBeacon 217 switchDisable 218 switchEnable 219 switchName 220 switchShow 221 switchStatusPolicySet 225 switchStatusPolicyShow 228 switchStatusShow 230 syslogdIpAdd 232 syslogdIp
Fabric OS Reference Manual
