Page 1 reference manual version 2.4 Fabric OS www.hp.com...
Page 2: Safety Notices
Safety notices fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or Any servicing, adjustment, maintenance, or repair must be consequential damages in connection with the furnishing, performed only by authorized service-trained personnel.
Page 3: Table Of Contents
CONTENTS Revision History ..........9 Preface .
Page 4 configure ..........40 Arbitrated Loop Settings .
Page 5 iodShow ..........104 ipAddrSet .
Page 6 portLogDump ..........159 portLogShow .
Page 7 tempShow ..........235 timeOut .
Page 8 Fabric OS Reference Manual...
Page 9: Revision History
Revision History July 2001 First release.
Page 10 Fabric OS Reference Manual...
Page 11: Preface
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 Provides a detailed description of the telnet Telnet Commands commands in the Fabric OS.
Page 12: Getting Help
Title Part Number HP Surestore FC Switch 6164 Documentation CD A7326-11011 HP Surestore FC Switch 6164 Installation and A7326-90902 Reference Guide 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...
Page 13: Telnet Commands
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: • - The default value is sysDescr Fibre Channel Switch •...
Page 14 • - The default value is 0 (off). swEventTrapLevel • - The default value is 0 (off). authTraps • 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...
Page 15 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>...
Page 16: Agtcfgset
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: • - Specify the switch description (in MIB-II definition). The sysDescr default value is Fibre Channel Switch...
Page 17 • 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'.
Page 18 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 <Return> to accept current value, o enter the appropriate new value, o <Control-D>...
Page 19: Agtcfgshow
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: • - Displays the switch description. sysDescr • - Displays the location of the switch. sysLocation •...
Page 20 • 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.
Page 21 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)
Page 22: Aliasshow
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. This command is not related to the Zoning feature.
Page 23: Backspace
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...
Page 24: Bcastshow
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).
Page 25 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 ----------------------------------------------------------- 0x00012083 0x00002080 0x00000000 See Also mcastShow portRouteShow Telnet Commands...
Page 26: Camtest
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 Note must first disable the switch using the switchDisable command.
Page 27: Centralmemorytest
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 Note must first disable the switch using the switchDisable command.
Page 28 Errors There are four possible error messages if failures are detected: DIAG-TIMEOUT DIAG-BADINT DIAG-CMERRTYPE DIAG-CMERRPTN See Also camTest cmemRetentionTest portLoopbackTest portRegTest ramTest spinSilk sramRetentionTest Fabric OS Reference Manual...
Page 29: Cmemretentiontest
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 Note must first disable the switch using the switchDisable command.
Page 30: Cmitest
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.
Page 31 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: Specify the number of times to execute this test. The passCount default value is 1.
Page 32: Configdefault
configDefault Restore system configuration to default settings. Synopsis configDefault Availability admin Description Use this command to reset system configuration to default values. All configuration parameters, with the following exceptions, are reset to default values: • Ethernet MAC address, IP address, and subnetmask •...
Page 33: Configdownload
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.
Page 34 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.
Page 35 Example To download switch configuration from the server , username citadel , and host file name jdoe 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. •...
Page 36: Configshow
configShow Display system configuration settings. Synopsis configShow ["textfilter"] Availability All users Description Use this command to view system configuration settings set by the command, as well as these two settings: configure • Ethernet MAC address • NVRAM boot settings Operands This command has the following operand: Specify a text string, in quotation marks, that limits the textfilter...
Page 37 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 e=192.168.1.62 g=192.168.1.254 u=user tn=switch Type <CR> to continue, Q<CR> to stop: diag.postDisable: fabric.domain: fabric.ops.BBCredit: fabric.ops.E_D_TOV: 2000 fabric.ops.R_A_TOV: 10000 fabric.ops.dataFieldSize: 2112 fabric.ops.mode.fcpProbeDisable: fabric.ops.mode.isolate: fabric.ops.mode.tachyonCompat: fabric.ops.mode.unicastOnly: fabric.ops.mode.useCsCtl: fabric.ops.mode.vcEncode: fabric.ops.vc.class.2: fabric.ops.vc.class.3: fabric.ops.vc.config:...
Page 38: Configupload
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).
Page 39 Specify a file name in quotation marks; for example, file “ ”. Absolute path names may be specified config.txt 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.
Page 40: Configure
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.
Page 41: Arbitrated Loop Settings
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.
Page 42: Switch Fabric 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...
Page 43 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.
Page 44 Sequence Level When this feature is set to 1, frames of the same Switching 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.
Page 45: System Services Settings
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 Boolean On/Off rstatd Boolean On/Off rusersd 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...
Page 46: Virtual Channel Settings
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.
Page 47 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.
Page 48 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...
Page 49: Crossporttest
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.
Page 50 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.
Page 51: Switchenable Switchdisable Mode
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.
Page 52: Singleportalso Mode
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.
Page 53 For example, disable the switch, set the GBIC mode to 1, and execute crossPortTest with and the singlePortAlsoactivated to limit testing to: crossPortTest 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...
Page 54 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: switchState: Testing switchRole: Disabled switchDomain: 1 (unconfirmed) switchId: fffc01 switchWwn: 10:00:00:60:69:00:73:71 port 0: cu Testing Loopback->15 port...
Page 55: Date
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 operand to set the date and time. Date and time are specified as a newdate quoted string in the format: "mmddhhmmyy"...
Page 56 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 errLogShow portLogShow uptime Fabric OS Reference Manual...
Page 57: Diagclearerror
diagClearError Clear the software flag to allow for retest. diag Synopsis diagClearError [port] Availability admin Description Use this command to clear the software flag that indicates whether a diag port is BAD or OK. The current flag settings are displayed by using the command.
Page 58: Diagdisablepost
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 command.
Page 59 Operands None. Example To disable the POST during future power ons: switch:admin> diagDisablePost Committing configuration...done. On next reboot, POST will be skipped. See Also diagEnablePost Telnet Commands...
Page 60: Diagenablepost
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 command.
Page 61: Diaghelp
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 None. Example To display diagnostic help commands: switch:admin>...
Page 62: Diagshow
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.
Page 63 It can also be looped by specifying the operand. This operand nseconds 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, executes every 4 seconds unless diagShow 4 diagShow stopped by a keyboard interrupt.
Page 64 Example To print the diagnostic results since the last boot: switch:admin> diagShow Diagnostics Status: Wed Apr 5 03:09:20 2000 port#: 11 12 13 14 15 diags: OK OK OK OK OK state: UP UP UP UP UP lm0: 100 frTx 100 frRx 0 LLI_errs.
Page 65: Dlsreset
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 for a full description of load sharing. dlsSet Use this command only if devices connected to the fabric cannot handle occasional routing changes.
Page 66: Dlsset
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.
Page 67: Dlsshow
Operands None. Example 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 None.
Page 68: Errdump
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 , but errShow errShow enables you to scroll through the entries using the Enter button. for a description of the error log.
Page 69: Errshow
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 to display the errDump same information without line breaks. Each entry in the log follows this format: Error Number ------------...
Page 70: Diagnostic Error Codes
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.
Page 71 Table 3. Diagnostic Error Codes (continued) Error Number Test Error Type 1021 centralMemoryTest DIAG-CMBISRF 1025 centralMemoryTest DIAG-LCMRS 1026 centralMemoryTest DIAG-LCMTO 1027 centralMemoryTest DIAG-LCMEM 1028 centralMemoryTest DIAG-LCMEMT 1029 centralMemoryTest DIAG-CMNOBUF 102A centralMemoryTest DIAG-CMERRTYPE 102B centralMemoryTest DIAG-CMERRPTN 102C centralMemoryTest DIAG-INTNOTCLR 1030 centralMemoryTest DIAG-BADINT 106F centralMemoryTest...
Page 72 Table 3. Diagnostic Error Codes (continued) Error Number Test Error Type 2641 portLoopbackTest DIAG-ERRSTAT (CRC) 2642 portLoopbackTest DIAG-ERRSTAT (TRUNC) 2643 portLoopbackTest DIAG-ERRSTAT (2LONG) 2644 portLoopbackTest DIAG-ERRSTAT (BADEOF) 2645 portLoopbackTest DIAG-ERRSTAT (ENCOUT) 2646 portLoopbackTest DIAG-ERRSTAT (BADORD) 2647 portLoopbackTest DIAG-ERRSTAT (DISCC3) 264F portLoopbackTest DIAG-INIT 265F...
Page 73 Table 3. Diagnostic Error Codes (continued) Error Number Test Error Type 305F crossPortTest DIAG-PORTDIED 3060 crossPortTest DIAG-STATS (FTX) 3061 crossPortTest DIAG-STATS (FRX) 3062 crossPortTest DIAG-STATS (C3FRX) 306E crossPortTest DIAG-DATA 306F crossPortTest DIAG-TIMEOUT 3070 crossPortTest DIAG-PORTABSENT 3071 crossPortTest DIAG-XMIT 3078 crossPortTest DIAG-PORTWRONG 3840 spinSilk...
Page 74 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. switch:admin> errShow Error 02 -------- 0x10fbd880 (tSwitch): Feb 5 17:03:19 Error DIAG-POST_SKIPPED, 3, Skipped POST tests: assuming all ports are healthy, Err# 0004...
Page 75: Fabricshow
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 attached to the alias server; typically no groups are N_Ports listed.
Page 76 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 -------------------------------------------------------------------------...
Page 77: Fanshow
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: Fan is functioning correctly.
Page 78: Fastboot
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.
Page 79: Firmwaredownload
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).
Page 80 Operands This command has the following operands: Specify a host name or IP address in quotation marks; host for example, “ ” or “ ”. The citadel 192.168.1.48 configuration file is downloaded from this host system. This operand is optional. Specify a user name in quotation marks;...
Page 81 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. •...
Page 82: Fspfshow
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.
Page 83 Table 6. fspfShow display fields (continued) Field Description FSPF scheduled events bit map. event_sch: Internal variable. lsrRefreshCnt: Operands None. Example To display FSPF protocol information: switch:admin> fspfshow version domainID isl_ports = 0x00000020 minLSArrival minLSInterval LSoriginCount startTime = 16784 fspfQ = 0x10f48f10 fabP = 0x10f49f90 agingTID...
Page 84: Gbicshow
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.
Page 85 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. Serial No: 103960 port 3: sw port 4: sw...
Page 86 Display shell history. Synopsis 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 displays the 20 most recent commands typed into the shell;...
Page 87: Help
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, “...
Page 88 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.
Page 89 The fields in the following table indicate task status. Table 8. Field Description READY Task is not waiting for any resource other than the PEND Task is blocked due to the unavailability of a resource DELAY Task is asleep for a duration SUSPEND Task is unavailable for execution (but not delayed or ended)
Page 90 Example To display the task summary: switch:admin> i tFcp NAME ENTRY STATUS ERRNO DELAY ---------- ---------- -------- --- -------- ------- -------- ----- ---- tFcp _fcpTask 103ad660 150 PEND+T 10191b78 103ad9e0 3d0004 switch:admin> i NAME ENTRY STATUS ERRNO DELAY ---------- ---------- -------- --- -------- ------- -------- ----- ---- tExcTask _excTask...
Page 91: Ifmodeset
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. to list network interfaces available on the system. ifShow An operating mode is confirmed with a “ ”...
Page 92: Ifmodeshow
Example To force the link for the “ ” Ethernet interface from auto-negotiate fei0 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...
Page 93: Ifshow
ifShow Display network interface information. Synopsis ifShow ["ifName"] Availability All users Description Use this command to display network interface status. If the operand is provided, only that interface is displayed. If is omitted, ifName ifName all interfaces are displayed. Each switch has three interfaces: “ei”...
Page 94 Operands This command has the following operand: Specify the name of an interface, in quotation marks. ifName This operand is optional. Example 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.255...
Page 95: Interfaceshow
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 .
Page 96 Number of times this interface came up, with upCount respect to FSPF. Last time this interface came up. lastUpTime Number of times this interface went down. downCount Last time this interface went down. lastDownTime Type of last State Change Notification that caused downReason this interface to go down.
Page 97 LSR retransmission timer ID. lsrRtxTID Inactivity time-out value, in milliseconds. When inactTo 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. Hello time-out value, in milliseconds. When this helloTo time-out expires, a Hello frame is sent to the neighbor switch through this port.
Page 98 Number of times this interface came up, with upCount respect to FSPF. Last time this interface came up. lastUpTime Number of times this interface went down. downCount Last time this interface went down. lastDownTime Type of last State Change Notification that caused downReason this interface to go down.
Page 99 Number of times this interface came up, with upCount respect to FSPF. Last time this interface came up. lastUpTime Number of times this interface went down. downCount Last time this interface went down. lastDownTime Type of last State Change Notification that caused downReason this interface to go down.
Page 100 LSR retransmission timer ID. lsrRtxTID Inactivity time-out value, in milliseconds. When inactTo 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. Hello time-out value, in milliseconds. When this helloTo time-out expires, a Hello frame is sent to the neighbor switch through this port.
Page 101 Number of attempted transmissions of LSUs to attLsuOut the neighbor switch. Number of LSUs transmitted to the neighbor nLsuOut switch. Number of attempted transmissions of LSAs to attLsaOut the neighbor switch. Number of LSAs transmitted to the neighbor nLsaOut switch. Operands This command has the following operand: Specify the port number for which you want to...
Page 102: Iodreset
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 None.
Page 103: Iodset
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.
Page 104: Iodshow
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 None. Example To display the current setting of the in-order delivery option: switch:admin>...
Page 105: Ipaddrset
ipAddrSet Set Ethernet and FC IP addresses. Synopsis ipAddrSet Availability admin Description Use this command to set Ethernet and FC IP addresses. You are prompted for address end mask information: • Ethernet IP Address: IP address of the Ethernet port •...
Page 106 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. Set IP addresses now? [y = set now, n = next reboot]: y See Also ifShow ipAddrShow...
Page 107: Ipaddrshow
ipAddrShow Display Ethernet and FC IP addresses. Synopsis ipAddrShow Availability All users Description Use this command to display Ethernet and fibre channel IP addresses. Address and mask information is shown: • Ethernet IP Address: IP address of the ethernet port •...
Page 108: Isltopocheck
islTopoCheck Display ISL sgroup connections for a switch. Synopsis islTopoCheck 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.
Page 109 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. switch:admin> islTopoCheck ISL data for type: S32_6_1, sgroup: My_group domain expected wwn name...
Page 110: Isltoposhow
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.
Page 111 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. switch:admin> islTopoShow ISL data for type: S32_6_1, sgroup: My_group domain expected wwn name...
Page 112: Licenseadd
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 command to check licenseShow that the key has been correctly entered and the licensed product installed.
Page 113: Licensehelp
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 None. Example To display license commands: switch:admin> licenseHelp licenseAdd Add a license key to this switch licenseRemove Remove a license key from this switch licenseShow...
Page 114: Licenseremove
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 command to check licenseShow...
Page 115: Licenseshow
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; is displayed if no license none keys are installed. Operands None.
Page 116: Linkcost
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.
Page 117: Login
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...
Page 118: Logout
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:”...
Page 119: Loopdiagclear
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: The physical port number where loopdiag executes.
Page 120: Loopdiagdone
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: The physical port number where loopdiag executes.
Page 121: Lsdbshow
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.
Page 122 The display shows the fields in the following table. Table 9. LSDbShow display fields Field Description Domain number described by this LSR. A (self) Domain keyword after the domain number indicates LSR describes the local switch. Pointer to LSR. lsrP Number of LSRs accepted even though they were earlyAccLSRs not sufficiently spaced apart.
Page 123 Table 9. LSDbShow display fields (continued) Field Description ID (domain number) of the switch that originated advertiser this LSR. Incarnation number of this LSR. incarn Total length (in bytes) of this LSR. Includes header length and link state information for all links. Checksum of total LSR, with exception of chksum lsAge...
Page 124 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 = 0x1035bb30...
Page 125: Mcastshow
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;...
Page 126 Operands This command has the following operand: Specify the multicast group to be displayed. group_ID Example To display multicast routing information: switch:admin> mcastShow 9 Group Member Ports Member ISL Ports Static ISL Ports ----------------------------------------------------------- 0x00002083 0x00002080 0x00000000 See Also bcastShow portRouteShow Fabric OS Reference Manual...
Page 127: Msconfigure
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.
Page 128 Example To display the Management Server access control list: switch:admin> msConfigure Done Display the access list Add member based on its Port/Node WWN 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...
Page 129: Msplatshow
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.
Page 130: Msplcleardb
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. Since this operation is non-recoverable (once issued, the database will be erased), it should not be used unless it is intended to resolve a database conflict between two joining fabrics or to establish an entire new fabric with an empty database.
Page 131: Msplcapabilityshow
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.
Page 132: Msplmgmtactivate
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.
Page 133: Msplmgmtdeactivate
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.
Page 134: Nbrstatsclear
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: Specify the port number for the counters to be reset.
Page 135 Example To display how to reset the counters on port 4: switch:admin> interfaceShow 4 idbP = 0x10f61f40 Interface 4 data structure: nghbP = 0x10f61d90 ifNo defaultCost = 1000 cost = 1000 delay lastScn lastScnTime = Mar 29 12:57:52.833 upCount lastUpTime = Mar 29 12:57:52.833 downCount lastDownTime...
Page 136: Nbrstateshow
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.
Page 137 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 ------------------------------------------------------- NB_ST_FULL NB_ST_FULL NB_ST_FULL NB_ST_FULL See Also interfaceShow Telnet Commands...
Page 138: Nsallshow
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 is supplied, only type devices of specified FC-PH type are displayed. If is omitted, all type devices are displayed.
Page 139: Nsshow
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.
Page 140 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 •...
Page 141 Example To display local name server information: switch:admin> nsShow The Local Name Server has 7 entries { Type Pid PortName NodeName TTL(sec) 011200; 2,3;10:00:00:60:69:00:ab:ba;10:00:00:60:69:00:ab:ba; 60 FC4s: FCIP 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; na FC4s: FCIP 021300; 3;10:00:00:60:69:00:02:d6;20:00:00:60:69:00:02:d6; na 0214e2; 3;21:00:00:fa:ce:00:21:1e;20:00:00:fa:ce:00:21:1e; na FC4s: FCP [STOREX RS2999FCPH3 MT09] 0214e4;...
Page 142: Paritycheck
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.
Page 143: Passwd
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 “ ”...
Page 144 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 user whom the login name and password are to be changed.
Page 145 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. You have not correctly verified the new password.
Page 146: Portcfgeport
portCfgEport Enable or disable a port from becoming an E_Port. Synopsis portCfgEport [<port_number>, <mode>] 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.
Page 147 Example To disable port 3 from becoming an E_Port: switch:admin> portCfgEport 3, 0 Committing configuration...done. switch:admin> portCfgEport Ports: -------------------------------- See Also portShow switchShow Telnet Commands...
Page 148: Portcfggport
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.
Page 149: Portcfglport
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.
Page 150: Portcfglongdistance
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.
Page 151 Operands This command has the following operands: The port number to be configured: 0-7 or 0-15. This portnumber operand is required. This operand indicates the distance to the connected 0|1|2 port. This operand is optional. The valid values for this operand are: 0 = reconfigure port to be regular switch port 1 = level one long distance (up to 50 km)
Page 152: Portcfgmcastloopback
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.
Page 153 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.
Page 154: Portdisable
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.
Page 155: Portenable
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.
Page 156: Porterrshow
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: frames tx Frames transmitted.
Page 157 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 bad enc disc link loss loss frjt fbsy in err shrt long eof out fail sync ---------------------------------------------------------------- 2.5m...
Page 158: Portlogclear
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 a description of the port log.
Page 159: Portlogdump
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 , but prompts the user to enter “returns”...
Page 160 Example To display the port log: switch:admin> portlogdump 10 task event port args ---------------------------------------------- 16:51:15.499 tShell ioctl 10f9bb90,0 16:51:15.499 tShell ioctl 10f9bb90,0 16:51:15.499 tShell ioctl 10f9bb90,0 16:51:15.499 tShell ioctl 10f9bb90,0 16:51:15.499 tShell ioctl 10f9bb90,0 16:51:15.499 tShell ioctl 10f9bb90,0 16:51:15.499 tShell ioctl 10f9bb90,0 16:51:15.499...
Page 161: Portlogshow
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. displays the same information as , but it portLogShow portLogDump 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 for details):...
Page 162 Table 11. PortLogShow fields (continued) Field Description received frame is rejected rejec received frame is busied busy CT based request is received ctin CT based response is transmitted ctout message is added to the error log errlog loop state change notification is posted loopscn task is created create...
Page 163 Table 11. PortLogShow fields (continued) Field Description received frame is rejected rejec received frame is busied busy CT based request is received ctin CT based response is transmitted ctout message is added to the error log errlog loop state change notification is posted loopscn task is created create...
Page 164 Table 11. PortLogShow fields (continued) Field Description received frame is rejected rejec received frame is busied busy CT based request is received ctin CT based response is transmitted ctout message is added to the error log errlog loop state change notification is posted loopscn task is created create...
Page 165 Table 11. PortLogShow fields (continued) Field Description args The command arguments – description depends on event type: start type: = enable ports, = disable ports star state (see codes) disable state mode: = normal, non-zero = loopback enable I/O control arguments ioctl &...
Page 166 Table 11. PortLogShow fields (continued) Field Description description depends on loop state: loopscn offline reason code, usually zero reason code for LIPs initiated by , if the code FL_Port 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 usually zero BMP: memory address for the loop...
Page 167 Active State pstate Link Reset: LR Transmit State Link Reset: LR Receive State Link Reset: LRR Receive State Link Failure: NOS Transmit State Link Failure: NOS Receive State Offline: OLS Transmit State Offline: OLS Receive State Offline: Wait for OLS State Get virtual channel credits ioctl Set virtual channel credits...
Page 168 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...
Page 169 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 task event port args ---------------------------------------------- 06:48:01.623 interrupt 06:48:02.359 tFspf ioctl ffffff,10...
Page 170: Portloopbacktest
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.
Page 171 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.
Page 172 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 camTest centralMemoryTest cmemRetentionTest cmiTest crossPortTest portRegTest ramTest spinSilk sramRetentionTest Fabric OS Reference Manual...
Page 173: Portperfshow
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 , or...
Page 174: Portregtest
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 to register N, read, and compare to be sure that the 0x00000001...
Page 175 13.0x1000 14.0x2000 15.0x4000 16.0x8000 Repeat the preceding steps until all ASIC SRAMs and registers have been tested. Operands None. Example To run a bit write/read test of the ASIC SRAMs and registers: switch:admin> portRegTest Running Port Register Test ..passed. Errors There are three possible error messages if failures are detected: DIAG-REGERR...
Page 176: Portrouteshow
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 Shows unicast frame routing to another switch routing table element in the fabric.
Page 177 Multicast routing Shows multicast frame routing to the destination table multicast group. Output format is : (mcast_group_id) mcast_group_number ports_bitmap where: is the multicast group mcast_group_number number. is the multicast frame destination mcast_group_id is a hex bitmap of all output port ports_bitmap numbers that can forward a multicast frame from the portnumber...
Page 178 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 bcastShow...
Page 179: Portshow
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...
Page 180 Table 12. PortShow display fields (continued) 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.
Page 181 Example To display the status for a specified E_Port: switch:admin> portShow 1 portFlags: 0x20041 PRESENT U_PORT LED portType: portState: 2 Offline portPhys: No_Light portScn: portRegs: 0x80020000 portData: 0x10fa70a0 portId: 011100 portWwn: 20:01:00:60:69:00:73:71 Distance: normal Interrupts: Link_failure: 0 Frjt: Unknown: Loss_of_sync: 0 Fbsy: Lli: Loss_of_sig:...
Page 182: Portstatsshow
portStatsShow Display port hardware statistics. Synopsis portStatsShow portnumber Availability All users Description Use this command to display port hardware statistics counters. 4-byte words transmitted. stat_wtx 4-byte words received. stat_wrx Frames transmitted. stat_ftx Frames received. stat_frx Class 2 frames received. stat_c2_frx Class 3 frames received.
Page 183 Number of OPNyx received. fl_opened Number of OPNfr sent. fl_openfr CLS sent due to loop idle. fl_cls_idle CLS received when OPEN. fl_cls_rx OPN/CLS BB_Credit stalls. fl_bb_stall Number of CFIFOs allocated. fl_cf_alloc CFIFOs delivered when OPENED. fl_cf_opn Number of CFIFOs full stalls. fl_cf_full CFIFO not available stalls.
Page 184 Example To display a port with only the basic set of statistics: switch:admin> portStatsShow 3 stat_wtx 1181994 4-byte words transmitted stat_wrx 1188458 4-byte words received stat_ftx 95830 Frames transmitted stat_frx 15564 Frames received stat_c2_frx Class 2 frames received stat_c3_frx Class 3 frames received stat_lc_rx 7735 Link control frames received...
Page 185: Psshow
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: Power supply present and functioning correctly.
Page 186: Quietmode
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.
Page 187: Ramtest
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.
Page 188 – 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.
Page 189: Reboot
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.
Page 190: Routehelp
routeHelp Display routing help commands. Synopsis routeHelp Availability admin Description Use this command to display routing help commands. Operands None. Example To view a list of routing related commands: switch:admin> routeHelp bcastShow Print broadcast tree information dlsReset Turn off Dynamic Load Sharing dlsSet Turn on Dynamic Load Sharing dlsShow...
Page 191: Setgbicmode
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 GBIC mode is enabled; if the mode operand is , 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.
Page 192: Setsplbmode
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 and disable the SPLB mode if the operand is . 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.
Page 193 Operands This command has the following operand: Specify whether to enable or disable SPLB mode. mode Specify 1 to enable GBIC mode or 0 to disable SPLB mode. The default value (if no operand specified) is Example To enable or disable a 2-port loopback: switch:admin>...
Page 194: Sgroupdelete
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.
Page 195: Sgrouprename
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.
Page 196 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. switch:admin> sgroupShow Group Type Group Name Member WWN ========== ============================= ======================= S32_6_1 MyNewGroupName 10:00:00:60:69:00:00:20...
Page 197: Sgroupset
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: Specify a character string in quotation marks containing...
Page 198 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. To create an sgroup using the interactive form of the sgroupSet command: switch:admin> sgroupSet Here are the valid sgroup types: S32_6_1 Please Enter Group Type: [S32_6_1] S32_6_1 Please Enter Group Name: [ ] MyGroup...
Page 199: Sgroupshow
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 that contain the given sgType sgName...
Page 200 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 contains the key word “Group”, it is Note MyNewGroupName displayed.
Page 201: Sgroupsupportshow
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 is specified or “all” is commandName specified in place of a command name, all the supported commands are displayed for the all the switches within a switch group.
Page 202 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 data! value = 0...
Page 203 Information from Domain 10 ======================================== Centigrade Fahrenheit ======================================== Information from Domain 11 ======================================== Centigrade Fahrenheit ======================================== Information from Domain 12 ======================================== Centigrade Fahrenheit ====================DONE================== See Also sgroupDelete sgroupRename sgroupSet sgroupShow sgroupSwReplace Telnet Commands...
Page 204: Sgroupswreplace
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.
Page 205 Example The example shows the noninteractive form of sgroupSwReplace. The sgroupShow command is used to illustrate the changes made with the sgroupSwReplace command. To replace a member of an sgroup: switch:admin> sgroupShow Group Type Group Name Member WWN ================ ================================ ======================= S32_6_1 NewGroup 10:00:00:60:69:20:15:71...
Page 206: Snmpmibcapset
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.
Page 207: Spinsilk
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 , set up the routing hardware so that frames received by spinSilk port M are retransmitted through port N and frames received by port N are retransmitted through port M.
Page 208 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.
Page 209: Gbic Mode
GBIC Mode is executed with GBIC mode activated, only ports containing spinSilk GBICs are tested. To activate GBIC mode, execute the following command prior to executing spinSilk switch:admin> setGbicMode 1 The state of the GBIC mode is saved in flash memory and remains active (even after reboots or power cycles) until it is disabled: switch:admin>...
Page 210 Example To verify the functionality of a switch: switch:admin> spinSilk 2 Running Spin Silk ..... One moment please ... switchName: switch switchType: switchState: Testing switchRole: Disabled switchDomain: 1 (unconfirmed) switchId: fffc01 switchWwn: 10:00:00:60:69:00:73:71 port 0: cu Testing Loopback->15 port 1: sw Testing Loopback->11 port...
Page 211 Diagnostics Status: Tue Apr 6 04:10:12 1999 port#: diags: OK state: UP lm0: 2059619 frTx 2052666 frRx LLI_errs. <looped-15> lm1: 2054565 frTx 2052620 frRx LLI_errs. <looped-11> lm2: 2050424 frTx 2048321 frRx LLI_errs. <looped-6> lm3: 2053094 frTx 2042762 frRx LLI_errs. <looped-4> lm4: 2042957 frTx 2053290 frRx...
Page 212: Sramretentiontest
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.
Page 213 Errors There are three possible error messages if failures are detected: DIAG-REGERR DIAG-REGERR_UNRST DIAG-BUS_TIMEOUT See Also camTest centralMemoryTest cmemRetentionTest cmiTest crossPortTest portLoopbackTest ramTest spinSilk Telnet Commands...
Page 214: Supportshow
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.
Page 215 23.faultShow 24.traceShow 25.portLogDump Operands This command has the following operands: Specify the first port, of a range of ports, to dump firstPort information. The default (if no operand is specified) is to print state of port 0. If only is specified, firstPort only information for is printed.
Page 216 Example To display switch information for debugging: switch:admin> supportShow Kernel: 5.3.1 Fabric OS: v2.1 Made on: Tue Apr 6 16:57:22 PDT 1999 Flash: Thu Apr 1 10:23:43 PST 1999 BootProm: Thu Oct 1 13:34:29 PDT 1998 Up for: 12 secs Powered for: 472 days, 19:15 Last up at: Tue May...
Page 217: Switchbeacon
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.
Page 218: Switchdisable
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.
Page 219: Switchenable
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.
Page 220: Switchname
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.
Page 221: Switchshow
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.
Page 222 The switch summary is followed by one line per port: Port number. Valid values are 0-7 or 0-15 depending port numbe on the switch type. Port module type (GBIC or other): module type - no module present - shortwave laser - longwave laser - copper - serial ID...
Page 223 The comment field may be blank, or it may display: comment - port is disabled Disabled - port is bypassed (loop only) Bypassed - port is in loopback mode Loopback - fabric port, shows WWN of attached switch E-Port - point-to-point port, shows WWN of attached F-Port N_Port - point-to-point but not yet...
Page 224 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: switchState: Online...
Page 225: Switchstatuspolicyset
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.
Page 226 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.
Page 227 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. switch:admin> switchStatusPolicySet To change the overall switch status policy parameters The current overall switch status policy parameters: Down Marginal ----------------------------------...
Page 228: Switchstatuspolicyshow
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.
Page 229 Operands None. Example To display the switch status policy: switch:admin> switchStatusPolicyShow The current overall switch status policy parameters: Down Marginal ---------------------------------- FaultyPorts MissingGBICs PowerSupplies Temperatures Fans PortStatus sgroup ISLStatus See Also switchStatusShow switchStatusPolicySet Telnet Commands...
Page 230: Switchstatusshow
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. The overall status is calculated based on the most severe status of all contributors: • internal switch status •...
Page 231 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. switch:admin> switchStatusShow The overall switch status is Marginal/Warning Contributing factors: 1 missing power supply triggered the Marginal/Warning status 2 bad fans, 4 good fans triggered the Marginal/Warning status 1 missing GBIC triggered the Marginal/Warning status switch:admin>...
Page 232: Syslogdipadd
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.
Page 233: Syslogdipremove
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 process. syslogd Operands This command has the following operand:...
Page 234: Syslogdipshow
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 None. Example To display all syslog daemon IP addresses: switch:admin> syslogdIpShow syslog.IP.address.1: 192.168.1.60 syslog.IP.address.2: 192.168.1.88...
Page 235: Tempshow
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.
Page 236: Timeout
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.
Page 237: Topologyshow
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.
Page 238 Bit map of input ports to use the corresponding In Ports: 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 uRouteShow...
Page 239: Trackchangesset
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. There are several trackable changes: • successful login •...
Page 240 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.
Page 241: Uptime
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.
Page 242 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. The items marked with an asterisk (*) are usually caused by Note hardware or firmware failures.
Page 243: Urouteconfig
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 is a usable output_portnumber...
Page 244 Specify the output port where traffic is to be outputportnumber forwarded. This operand is required. Example 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>...
Page 245: Urouteremove
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 may not change. It does not change if the previous static portnumber route was along a minimum cost path.
Page 246: Urouteshow
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.
Page 247 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. Displays routing information for port portnumber to all the domains in the portnumber fabric.
Page 248: Version
version Display firmware version information. Synopsis version Availability All users Description Use this command to display firmware version information and build dates. The following information is displayed: Kernel: Version of switch kernel operating system Fabric OS: Version of switch Fabric OS Made on: Build date of firmware running in switch Flash:...
Page 249: Error Messages
ERROR MESSAGES This chapter explains the Fabric OS error message format and possible errors: • “System Error Message Formats” page 250 • “Displaying Error Messages Using Telnet” page 251 • “Resetting Bad Ports” page 252 • “POST Test Commands” page 252 •...
Page 250: System Error Message Formats
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.
Page 251: Displaying Error Messages Using Telnet
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 command.
Page 252: Resetting Bad Ports
Resetting Bad Ports If any port fails during a diagnostic test, it is marked in the status display. To retest a port that has been marked , clear the port and set to OK using the command. This command clears diagClearError (port#) the port status only and does not clear the logs or change the port’s condition.
Page 253: Post Test Failure And Recovery Actions
POST Test Failure and Recovery Actions This section provides information on what actions to perform if the switch fails any of the POST tests. If you run the portStatsShow or the diagShow command prior to Note running an individual test, errors may appear as a result of the normal synchronization process.
Page 254: Error Message Numbers
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 Table 17.
Page 255 Table 17. Error Message Numbers (continued) Error Number Test Name Error Name 1020 centralMemoryTest* DIAG-CMBISRTO 1021 DIAG-CMBISRF 1025 DIAG-LCMRS 1026 DIAG-LCMTO 1027 DIAG-LCMEM 1028 DIAG-LCMEMTX 1029 DIAG-CMNOBUF 102A DIAG-CMERRTYPE 102B DIAG-CMERRPTN 102C DIAG-INTNOTCLR 103O DIAG-BADINT 106F DIAG-TIMEOUT 2030 cmiTest* DIAG-BADINT 2031 DIAG-INTNIL 2032...
Page 256 Table 17. Error Message Numbers (continued) Error Number Test Name Error Name 2640 portLoopbackTest* DIAG-ERRSTAT (ENCIN) 2641 DIAG-ERRSTAT (CRC) 2642 DIAG-ERRSTAT (TRUNC) 2643 DIAG-ERRSTAT (2LONG) 2644 DIAG-ERRSTAT (BADEOF) 2645 DIAG-ERRSTAT (ENCOUT) 2646 DIAG-ERRSTAT (BADORD) 2647 DIAG-ERRSTAT (DISCC3) 264F DIAG-INIT 265F DIAG-PORT_DIED 266E DIAG-DATA...
Page 257 Table 17. Error Message Numbers (continued) Error Number Test Name Error Name 3040 crossPortTest DIAG-ERRSTAT(ENCIN) 3041 DIAG-ERRSTAT(CRL) 3042 DIAG-ERRSTAT(TRUNC) 3043 DIAG-ERRSTAT(2LONG) 3044 DIAG-ERRSTAT(BADEOF) 3045 DIAG-ERRSTATENCOUT) 3046 DIAG-ERRSTAT(BADORD) 3047 DIAG-ERRSTAT(DISC3) 304F DIAG-INIT 305F DIAG-PORTDIED 3060 DIAG-STATS (FTX) 3061 DIAG-STATS (FRX) 3062 DIAG-STATS (C3FRX) 306E DIAG-DATA...
Page 258 Table 17. Error Message Numbers (continued) Error Number Test Name Error Name 3080 spinSilk DIAG-PORTM2M 3081 DIAG-NOSEGMENT 384F DIAG-INIT 385F DIAG-PORTDIED 3840 DIAG-ERRSTAT (ENCIN) 3841 DIAG-ERRSTAT (CRC) 3842 DIAG-ERRSTAT (TRUNC) 3843 DIAG-ERRSTAT (2LONG) 3844 DIAG-ERRSTAT (BADEOF) 3845 DIAG-ERRSTAT (ENCOUT) 3846 DIAG-ERRSTAT (BADORD) 3847 DIAG-ERRSTAT (DISCC3)
Page 259: Diagnostic Error Messages
Diagnostic Error Messages This section provides information on the probable cause of a diagnostic error and what actions to take. Table 18. Diagnostic Error Messages Message Description Probable Cause Action DIAG-BADINT Port received an unexpected ASIC failure Replace interrupt mainboard Err#1030, 2030 assembly [centralMemoryTest,...
Page 260 Table 18. Diagnostic Error Messages (continued) Message Description Probable Cause Action DIAG-CLEAR_ERR Port diag error flag (OK or BAD) Informational None required is cleared only Err#0001 DIAG-CMBISRF ASIC Central Memory SRAMs ASIC failure Replace did not complete the BISR within mainboard Err#1021 the time-out period...
Page 261 Table 18. Diagnostic Error Messages (continued) Message Description Probable Cause Action DIAG-CMIINVCAP Unintended ASIC erroneously ASIC or Replace got CMI capture flag mainboard mainboard Err#2034 failure assembly [cmiTest] DIAG-CMINOCAP CMI intended receiver ASIC ASIC or Replace failed to get CMI capture flag mainboard mainboard Err#2033...
Page 262 Table 18. Diagnostic Error Messages (continued) Message Description Probable Cause Action DIAG-ERRSTAT Port Error Statistics counter is ASIC, Replace nonzero, meaning an error was mainboard, mainboard Err#2640-2647, detected when receiving frames. GBIC module, assembly, GBIC 3040-3047, 3840-3847 or fibre cable module, or fibre One of the following status errors failure...
Page 263 Table 18. Diagnostic Error Messages (continued) Message Description Probable Cause Action DIAG-INTNOTCLR The interrupt bit could not be ASIC failure Replace cleared mainboard Err#102C assembly [centralMemoryTest] DIAG-LCMEM Data read from the Central ASIC failure Replace Memory location did not match mainboard Err#1027 data previously written into the...
Page 264 Table 18. Diagnostic Error Messages (continued) Message Description Probable Cause Action DIAG-MEMSZ Memory size to be tested is less mainboard Replace than or equal to zero failure mainboard Err#0111 assembly [ramTest] DIAG-MEMORY Data read from RAM location did CPU RAM Replace not match previously written data failure...
Page 265 Table 18. Diagnostic Error Messages (continued) Message Description Probable Cause Action DIAG-PORTSTOPPED Port is no longer transmitting, as ASIC, GBIC Replace indicated by the Number Of module, or fibre mainboard Err#3874 Frames Transmitted counter cable failure assembly, GBIC being stuck at N frames module, or fibre [spinSilk] cable...
Page 266 Table 18. Diagnostic Error Messages (continued) Message Description Probable Cause Action DIAG-STATS Port counter value did not match ASIC, GBIC Replace the number of frames actually module, or fibre mainboard Err#2660-2662, 3060 - transmitted. Possible counters cable failure assembly, GBIC 3062 reporting: module, or fibre...
Page 267: System Error Messages
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, ASIC Failure Bad mainboard Contact customer LOG_WARNING support CONFIG CORRUPT The switch configuration OS error...
Page 268 Table 19. System Error Messages (continued) Message Description Probable Cause Action FANS, 1_FAILED, Switch overheated Fan failure Contact customer LOG_WARNING support FANS, 2_FAILED, Switch overheated Fan failure Contact customer LOG_ERROR support FANS, 3_FAILED, Switch overheated Fan failure Contact customer LOG_CRITICAL support FANS, 4_FAILED, Switch overheated...
Page 269 Table 19. System Error Messages (continued) Message Description Probable Cause Action FLOOD, INVLSR, Unknown LSR type OS error Contact customer LOG_WARNING support FLOOD, LSRLEN, Excessive LSU length OS error Contact customer LOG_ERROR support FSPF, INPORT, Input port out of range OS error Contact customer LOG_ERROR...
Page 270 Table 19. System Error Messages (continued) Message Description Probable Cause Action LSDB, NOLSR, No Link State Record for domain OS error Contact customer LOG_WARNING support MCAST, ADDBRANCH, Add Branch failed OS error Contact customer LOG_ERROR support MCAST, ADDPORT, Add Port failed OS error Contact customer LOG_WARNING...
Page 271 Table 19. System Error Messages (continued) Message Description Probable Cause Action PANIC, QCREATE, Message queuer failed OS error Contact customer LOG_PANIC support PANIC, QDELETE, Message queuer deletion failed OS error Contact customer LOG_PANIC support PANIC, MALLOC, Memory allocation failed OS error Contact customer LOG_PANIC support...
Page 272 Table 19. System Error Messages (continued) Message Description Probable Cause Action RPC, SVC_EXIT An RPC service daemon has OS error Contact customer terminated prematurely or support unexpectedly. RPC, SVC_REG An RPC service daemon could OS error Contact customer not establish service for a support particular protocol handler.
Page 273 Table 19. System Error Messages (continued) Message Description Probable Cause Action TEMP, 4_FAILED, Switch overheated Fan Failure Contact customer LOG_CRITICAL support TEMP, 5_FAILED, Switch overheated Fan Failure Contact customer LOG_CRITICAL support TIMERS, ENQFAIL, Invalid timeout value OS error Contact customer LOG_CRITICAL support TIMERS, MSG,...
Page 274 Fabric OS Reference Manual...
Page 275: Feature Telnet Commands
FEATURE TELNET COMMANDS This chapter summarizes commands for Zoning, Quicklook, Extended Fabrics, Fabric Watch, and FC 6164: • “Zoning Commands” page 276 • “QuickLoop Commands” page 277 • “Extended Fabric Command” page 278 • “Fabric Watch Commands” page 278 • “FC 6164 Commands”...
Page 276: Zoning Commands
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.
Page 277: Quickloop Commands
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.
Page 278: Extended Fabric Command
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.
Page 279: Fc 6164 Commands
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 Command Description islTopoCheck Displays ISL switch group connections for a...
Page 280 Fabric OS Reference Manual...
Page 281: Glossary
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.
Page 282 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. Bit Error Rate. Rate at which bits are expected to be received in error. Expressed as ratio of error bits to total bits transmitted.
Page 283 Community (SNMP) Relationship between a group of SNMP managers and an SNMP agent, in which authentication, access control, and proxy characteristics are defined. 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.
Page 284 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 The currently enabled zone configuration. Only one configuration can be configuration enabled at a time.
Page 285 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.
Page 286 Fx_Port Fabric port that can operate either as F Port or FL Port. See also F Port, 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.
Page 287 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.
Page 288 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.
Page 289 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.
Page 290 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.
Page 291 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.
Page 292 Fabric OS Reference Manual...
Page 293: Index
INDEX agtcfgDefault 13 date 55 agtcfgSet 16 diagClearError 57 agtcfgShow 19 diagDisablePost 58 aliasShow 22 diagEnablePost 60 diagHelp 61 diagnostic error messages 259 BadEOF 262 diagShow 62 BadOrdSet 262 DiscC3 262 bcastShow 24 displaying error messages 251 dlsReset 65 dlsSet 66 camTest 26 dlsShow 67 centralMemoryTest 27...
Page 294 loopdiagClear 119 fabricShow 75 loopdiagDone 120 fanShow 77 LSDbShow 121 fastboot 78 Fibre Channel Association 12 mcastShow 125 firmwareDownload 79 msConfigure 127 FrmTooLong 262 msPlatShow 129 fspfShow 82 msPlCapabilityShow 131 msPlClearDB 130 gbicShow 84 msPlMgmtActivate 132 msPlMgmtDeactivate 133 h command 86 help 87 nbrStateShow 136 nbrStatsClear 134...
Page 295 quietMode 186 technical support 12 tempShow 235 timeOut 236 ramTest 187 topologyShow 237 reboot 189 trackChangesSet 239 resetting bad ports 252 TruncFrm 262 routeHelp 190 updates, software 12 setGbicMode 191 uptime 241 setSplbMode 192 uRouteConfig 243 sgroupDelete 194 uRouteRemove 245 sgroupRename 195 uRouteShow 246 sgroupSet 197...
Page 296 Fabric OS Reference Manual...

HP Surestore 6164 - Switch Reference Manual

Preface

1 Telnet Commands

2 Error Messages

3 Feature Telnet Commands

Glossary

Index

Quick Links

Related Manuals for HP Surestore 6164 - Switch

Summary of Contents for HP Surestore 6164 - Switch