Page 1 reference manual version 3.0 fabric os www.hp.com...
Page 2 Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Page 3: Table Of Contents
Contents Preface About This Guide ......... . Related Publications .
Page 4 cfgEnable ..........1-23 cfgRemove .
Page 5 fspfShow ..........1-75 fwAlarmsFilterSet.
Page 6 licenseRemove ..........1-116 licenseShow .
Page 7 perfCfgSave ..........1-153 perfClrAlpaCrc .
Page 8 psShow ..........1-202 qloopAdd .
Page 9 statsTest..........1-245 supportShow .
Page 10 zoneDelete ..........1-285 zoneRemove .
Page 11: About This Guide
Preface Fabric OS Reference contains descriptions for the telnet commands used to administer and configure HP Brocade switches (HP Surestore FC 1Gb/2Gb Entry Switch 8B, HP Surestore FC 1Gb/2Gb Switch 8B, HP Surestore FC 1Gb/2Gb Switch 16B, HP Brocade 2400 and 2800 switches, and HP Surestore FC Switch 6164).
Page 12 Provided on the FC Entry Switch 8B and FC Switch 8B Documentation CD, and at the HP Web site http://www.hp.com/support/fc8B • HP Surestore FC 1Gb/2Gb Entry Switch 8B and FC 1Gb/2Gb Switch 8B Getting Started Guide (A7346-90902) • HP Surestore FC 1Gb/2Gb Entry Switch 8B and FC 1Gb/2Gb Switch 8B Installation and Reference Guide •...
Page 13: System Requirements And Compatibility
System Requirements and Compatibility Compatibility with other Products Fabric OS version 3.0.1b or later can be installed and run on the FC Entry Switch 8B, FC Switch 8B, and FC 16B products. The FC Entry Switch 8B, FC Switch 8B, and the FC 16B switch running Fabric OS version 3.0.1b or later can operate in the same fabric with the HP Brocade 2400/2800 and FC 6164 switches running the a2.4.1 or later versions of Fabric OS.
Page 14 Fabric OS Reference...
Page 15: Agtcfgdefault
Chapter Telnet Commands agtcfgDefault Reset the SNMP agent configuration to default values. Synopsis agtcfgDefault Availability admin Description Use this command to reset the configuration of the SNMP agent to default values: • sysDescr - The default value is Fibre Channel Switch. •...
Page 16 Telnet Commands Example To set the SNMP agent configuration parameters to default values, and verify they were set: switch:admin> agtcfgDefault Committing configuration...done. agent configuration reset to factory default switch:admin> switch:admin> agtcfgShow Current SNMP Agent Configuration Customizable MIB-II system variables: sysDescr = Fibre Channel Switch. sysLocation = End User Premise sysContact = Field Support.
Page 17: Agtcfgset
Telnet Commands agtcfgSet Modify the SNMP agent configuration. Synopsis agtcfgSet Availability admin Description Use this command to modify the configuration of the SNMP agent in the switch. Set the values for the following items: • sysDescr - Specify the switch description (in MIB-II definition). The default value is Fibre Channel Switch.
Page 18 Telnet Commands Operands None. Example 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> to skip the rest of configuration, or o <Control-C>...
Page 19: Agtcfgshow
Telnet Commands agtcfgShow Display the SNMP agent configuration. Synopsis agtcfgShow Availability All users Description Use this command to display the configuration of the SNMP agent in the switch. The following information is displayed: • sysDescr - Displays the switch description. •...
Page 20 Telnet Commands 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 21: Aliasshow
Telnet Commands 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, the following message is displayed: There is no entry in the Local Alias Server If there are multiple entries in the local alias group, they are displayed.
Page 22: Aliadd
Telnet Commands aliAdd Add a member to a zone alias. Synopsis aliAdd "aliName", "member; member" Availability admin Description Use this command to add one or more members to an existing zone alias. The alias member list cannot contain another zone alias. Operands This command has the following operands: Specify the name of a zone alias in quotation marks.
Page 23: Alicreate
Telnet Commands aliCreate Create a zone alias. Synopsis aliCreate "aliName", "member; member" Availability admin Description Use this command to create a new zone alias. A zone alias name must begin with a letter and can be followed by any number of letters, digits and underscore characters.
Page 24: Alidelete
Telnet Commands aliDelete Delete a zone alias. Synopsis aliDelete "aliName" Availability admin Description Use this command to delete a zone alias. This command changes the Defined Configuration. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command. For the change to be preserved across switch reboots, it must be saved to flash memory using the cfgSave command.
Page 25: Aliremove
Telnet Commands aliRemove Remove a member from a zone alias. Synopsis aliRemove "aliName", "member; member" Availability admin Description Use this command to remove one or more members from an existing zone alias. The member list is located by an exact string match, therefore, it is important to maintain the order when removing multiple members.
Page 26: Alishow
Telnet Commands aliShow Display zone alias information. Synopsis aliShow ["pattern"] Availability All users Description Use this command to display zone configuration information. If no parameters are specified, all zone configuration information (both defined and enabled) is displayed. See cfgShow for a description of this display. If a parameter is specified, it is used as a pattern to match zone alias names;...
Page 27: Backspace
Telnet Commands backSpace Set an alternate backspace character. Synopsis backSpace [0 | 1] Availability All users (display) admin (modify) Description This command changes the backspace character used by the shell between the default value of BACKSPACE (hex 08) and an alternate value of DEL (hex 7F). Operands This command has the following operand: Specify 0 to use the standard backspace character (BACKSPACE).
Page 28: Bcastshow
Telnet Commands 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. 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 29: Camtest
Telnet Commands camTest Test the functionality of Content Addressable Memory (CAM). 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. Note: This command may not be executed on an enabled switch.
Page 30: Centralmemorytest
Telnet Commands centralMemoryTest Preform a bit write and 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 central memory.
Page 31 Telnet Commands See Also ramTest portRegTest cmiTest sramRetentionTest turboRamTest camTest statsTest filterTest portLoopbackTest spinSilk Fabric OS Reference 1-17...
Page 32: Cfgadd
Telnet Commands cfgAdd Add a member to a zone configuration. Synopsis cfgAdd "cfgName", "member; member" Availability admin Description Use this command to add one or more members to an existing zone configuration. Quickloop names can be added as members with the restriction that all Note: This command requires a Zoning License.
Page 33: Cfgclear
Telnet Commands cfgClear Clears all zone configurations. Synopsis cfgClear Availability admin Description Use this command to clear all zone information in the transaction buffer. All defined zone objects in the transaction buffer are deleted. If an attempt is made to commit the empty transaction buffer while a zone configuration is enabled, a warning is displayed, to first disable the enabled zone configuration or to provide a valid configuration with the same name.
Page 34: Cfgcreate
Telnet Commands cfgCreate Create a zone configuration. Synopsis cfgCreate "cfgName", "member; member" Availability admin Description Use this command to create a new zone configuration. A zone configuration name must begin with a letter and can be followed by any number of letters, digits and underscore characters.
Page 35: Cfgdelete
Telnet Commands cfgDelete Delete a zone configuration. Synopsis cfgDelete "cfgName" Availability admin Description Use this command to delete a zone configuration. This command changes the Defined Configuration. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command. For the change to be preserved across switch reboots, it must be saved to flash memory using the cfgSave command.
Page 36: Cfgdisable
Telnet Commands cfgDisable Disables an effective zone configuration. Synopsis cfgDisable Availability admin Description This command disables the current zone configuration. The fabric returns to non-zoning mode where all devices see each other. It also commits the zone configuration in the transaction buffer to volatile and non-volatile memory.
Page 37: Cfgenable
Telnet Commands cfgEnable Enables a zone configuration. Synopsis cfgEnable "cfgName" Availability admin Description Use this command to commit any zone configuration in the transaction buffer to the volatile and non-volatile memory and enable the specified zone configuration. This command ends the current zoning transaction.
Page 38: Cfgremove
Telnet Commands cfgRemove Remove a member from a zone configuration. Synopsis cfgRemove "cfgName", "member; member" Availability admin Description Use this command to remove a member from an existing zone configuration. The member list is located by an exact string match, therefore, it is important to maintain the order when removing multiple members.
Page 39: Cfgsave
Telnet Commands cfgSave Save zone configuration to flash memory. Synopsis cfgSave Availability admin Description Use this command to save the current zone configuration. The defined configuration and the name of the enabled configuration are written to flash memory in all switches in the fabric. The saved configuration is automatically reloaded by the switch on power up and, if a configuration was enabled at the time it was saved, the same configuration is reinstalled with an automatic cfgEnable command.
Page 40: Cfgshow
Telnet Commands cfgShow Display zone configuration information. Synopsis cfgShow ["pattern"] Availability All users Description Use this command to display zone configuration information. If no operand is specified, all zone configuration information (both defined and enabled) is displayed. If an operand is specified, it is used as a pattern to match zone configuration names in the defined configuration;...
Page 41 Telnet Commands To show all configuration information: switch:admin> cfgShow Defined configuration: cfg: USA1 Blue_zone cfg: USA_cfg Red_zone; Blue_zone zone: Blue_zone 1,1; array1; 1,2; array2 zone: Red_zone 1,0; loop1 alias: array1 21:00:00:20:37:0c:76:8c; 21:00:00:20:37:0c:71:02 alias: array2 21:00:00:20:37:0c:76:22; 21:00:00:20:37:0c:76:28 alias: loop1 21:00:00:20:37:0c:76:85; 21:00:00:20:37:0c:71:df Enabled configuration: cfg: USA_cfg...
Page 42: Cfgtransabort
Telnet Commands cfgTransAbort Aborts the current zoning transaction. Synopsis cfgTransAbort Availability admin Description Use this command to abort the current zoning transaction. All changes made since the transaction was started will be removed and the zone configuration database restored to the state before the transaction was started.
Page 43: Cmemretentiontest
Telnet Commands cmemRetentionTest Test the data retention of the central memory SRAMs. Synopsis cmemRetentionTest [passCount] Availability admin Description Use this command to verify data retention in the central memory SRAMs in the ASIC. Note: This command may not be executed on an enabled switch. You must first disable the switch using the switchDisable command.
Page 44: Cmitest
Telnet Commands cmiTest Test the quad connections between two ASIC connections. 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 four quads located between two ASICs is functioning properly. This command is also used to verify that a message with a bad checksum sets the error and interrupt status bits of the destination quad and that a message with a good checksum does not set an error or interrupt bit in any ASIC.
Page 45 Telnet Commands Errors Below are possible error messages if failures are detected: DIAG-CMISA1 DIAG-CMINOCAP DIAG-CMICKSUM DIAG-CMIINVCAP DIAG-CMIDATA DIAG-INTNIL DIAG-BADINT See Also ramTest portRegTest centralMemoryTest sramRetentionTest turboRamTest camTest statsTest filterTest portLoopbackTest spinSilk Fabric OS Reference 1-31...
Page 46: Configdefault
Telnet Commands configDefault Reset a subset of configuration settings to the default values. Synopsis configDefault Availability admin Description Use this command to reset certain configuration settings to the default values. All configuration parameters, with the following exceptions, are reset to default values: •...
Page 47: Configdownload
Telnet Commands configDownload Load the switch configuration file from a host system. Synopsis configDownload ["host","user","file"[,"passwd"]] Availability admin Description Use this command to load the switch configuration file from a host system. The configuration file is ASCII text and may have been generated using configUpload, or it may have been created by a user to download specific configuration changes.
Page 48 Telnet Commands Example To load a backup configuration file from a host system: switch:admin> configDownload "citadel","jdoe","config.txt" Committing configuration...done. download complete Errors Listed below are possible reasons for a failure of this command: • The host name is not known to the switch •...
Page 49: Configshow
Telnet Commands configShow Display system configuration settings. Synopsis configShow ["textfilter"] Availability All users Description Use this command to view system configuration settings set by the configure command, as well as the following settings: • Ethernet MAC address • NVRAM boot settings Operands This command has the following operand: Specify a text string in quotation marks that limits the output of the command to...
Page 50 Telnet Commands See Also agtcfgShow configure diagDisablePost diagEnablePost ipAddrShow licenseShow syslogdIp 1-36 Fabric OS Reference...
Page 51: Configupload
Telnet Commands configUpload Create a backup file of switch configuration information on a host workstation. Synopsis configUpload ["host","user","file"[,"passwd"]] Availability admin Description Use this command to upload the switch configuration to a host file. The upload process uses either FTP or the RSHD protocol (TPC service 514). Both of these services are widely available on UNIX hosts, but less so on WIndows hosts.
Page 52 Telnet Commands If you enter the command with no operands, you are prompted for the appropriate values: switch:admin> configUpload Server Name or IP Address [citadel]: 192.168.15.42 User Name [None]: user21 File Name [config.txt]: config-switch.txt Protocol (RSHD or FTP) [FTP]: ftp Password: xxxxxx upload complete switch:admin>...
Page 53: Configure
Telnet Commands configure Modify system configuration settings. Synopsis configure Availability admin Description Use this command to change the following system configuration settings: • Fabric parameters • Virtual channel settings • Switch Operating Mode • Zoning Operation parameters • RSCN Transmission Mode •...
Page 54 Telnet Commands The Fabric parameters are as follows: Table 1-1 Configure Command Fabric parameters Field Default Range Domain 1..239 BB Credit 1 to 27 R_A_TOV 10000 4000..120000 E_D_TOV 2000 1000 to 5000 Data Field Size 2112 256 to 2112 Sequence Level Switching 0 or 1 Disable Device Probing 0 or 1...
Page 55 Telnet Commands Data Field Size The data field size specifies the largest possible value, in bytes, and advertises this value to other switches in the fabric during construction of the fabric as well as to other devices when they connect to the fabric. Setting this to a value smaller than 2112 may result in decreased performance.
Page 56: Virtual Channel Settings
Telnet Commands Virtual Channel Settings The switch enables fine tuning for a specific application, by configuring the parameters for eight virtual channels. The first two virtual channels are reserved for switch internal functions and are not available for modification. The default virtual channel settings have already been optimized for switch performance. Changing the default values can improve switch performance, but can also degrade performance.
Page 57: Arbitrated Loop Settings
Telnet Commands NS Pre-zoning Mode The NS Pre-zoning Mode fields are as follows: Pre-zoned responses Mode Specify 0 for Standard Mode, or 1 for Pre-zoning On. Arbitrated Loop Settings The Arbitrated Loop Setting fields are as follows: Table 1-3 Configure Command Arbitrated Loop Settings Field Default Range...
Page 58: System Services
Telnet Commands System Services The System Services fields are as follows: Table 1-4 Configure Command System Services Parameters Field Default Range On/Off rstatd On/Off rusersd On/Off rapid On/Off Disable RLS probing Descriptions of the system service setting fields are as follows: Dynamically enables or disables a server that returns information about system rstatd operation information through remote procedure calls (RPC).
Page 59 Telnet Commands Portlog Events Enable Use these parameters to specify which events create an entry in the port log. The Portlog Events fields are as follows: Table 1-5 Configure Command Portlog Events parameters Field (Valid Values) Default Value start: a switch start or re-start event (on, off): [on] disable: a port is disabled (on, off): [on]...
Page 60 Telnet Commands Example To set the configuration parameters for a switch: switch:admin> configure Configure... Fabric parameters (yes, y, no, n): [no] yes Domain: (1..239) [1] BB credit: (1..27) [16] R_A_TOV: (4000..120000) [10000] E_D_TOV: (1000..5000) [2000] 5000 Data field size: (256..2112) [2112] Sequence Level Switching: (0..1) [0] Disable Device Probing: (0..1) [0] Suppress Class F Traffic: (0..1) [0] 1...
Page 61: Crossporttest
Telnet Commands crossPortTest Test the functional operation of the switch. Synopsis crossPortTest [passCount, loopbackmode, speedmode] Availability admin Description Use this command to verify the functional operation of the switch. This command verifies operation by sending frames from a port transmitter and looping the frames back through an external fiber cable into another port receiver.
Page 62 Telnet Commands SwitchOnline and SwitchOffline Mode The crossPortTest command can be executed when the switch is enabled or disabled. In ONLINE mode (where the switch is enabled prior to executing the crossPortTest command) only ports which are cable loopbacked to ports in the same switch are tested. Ports connected outside of the switch are ignored.
Page 63 Telnet Commands The state of GBIC mode is saved in flash memory and remains active after reboots or power cycles until it is disabled as follows: switch:admin> setGbicMode 0 Operands This command has the following operands: Specify the number of times (or number of frames per port) to execute this test. passCount This number can be entered in either decimal or hex.
Page 64 Telnet Commands Example To execute a functional test of all the ports on a switch 100 times: switch:admin> crossPortTest 100, 1 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...
Page 65: Date
Telnet Commands date Display or set the switch date and time. Synopsis date ["newDate"] Availability All users (display) admin (set) Description Use this command with no operands to display date and time. Use the newdate operand to set the date and time. Date and time are specified as a string in the format: "mmddhhmmyy"...
Page 66: Diagclearerror
Telnet Commands diagClearError Clear the diag software flag to allow for retest. Synopsis diagClearError [port] Availability admin Description Use this command to clear the diagnostic software flag that indicates whether a port is BAD or OK. The current flag settings are displayed by using the diagShow command. This command resets the flag to allow the bad port to be retested;...
Page 67: Diagdisablepost
Telnet Commands diagDisablePost Disable POST execution at reboot. Synopsis diagDisablePost Availability admin Description Use this command to disable Power On Self Test (POST) execution at switch reboot. This mode is saved in flash memory and POST remains disabled until it is enabled using the diagEnablePost command.
Page 68: Diagenablepost
Telnet Commands diagEnablePost Enable POST execution at next reboot. Synopsis diagEnablePost Availability admin Description Use this command to enable Power On Self Test (POST) execution at the next switch reboot. This mode is saved in flash memory and POST remains enabled until it is disabled using the diagDisablePost command.
Page 69: Diaghelp
Telnet Commands diagHelp Display diagnostic command information. Synopsis diagHelp Availability all users Description Use this command to display diagnostic command information. Operands None. Example To display information about diagnostic commands: switch:admin> diagHelp ramTest System DRAM diagnostic portRegTest Port register diagnostic centralMemoryTest Central memory diagnostic cmiTest...
Page 70: Diagshow
Telnet Commands diagShow Print diagnostic results since the last boot. Synopsis diagShow [nSeconds] Availability All users Description Use this command to print the following information generated since the last switch reboot: • State of all ports in the switch resulting from diagnostics run since the last reboot. Ports that passed diagnostic testing are marked OK.
Page 71 Telnet Commands Example To print the diagnostic results since the last boot. switch:admin> diagShow Diagnostics Status: Wed Apr 5 03:09:20 2000 port#: diags: state: speed: lm0: 100 frTx 100 frRx 0 LLI_errs. <looped-15> lm1: 100 frTx 100 frRx 0 LLI_errs. <looped-11> lm2: 100 frTx 100 frRx...
Page 72: Dlsreset
Telnet Commands dlsReset Turn off Dynamic Load Sharing (DLS) option. Synopsis dlsReset Availability admin Description Use this command to turn off DLS when a fabric change occurs. Routing is generally based on the incoming port and the destination domain. 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 73: Dlsset
Telnet Commands dlsSet Turn on Dynamic Load Sharing (DLS) option. Synopsis dlsSet Availability admin Description Use this command to turn on DLS when a fabric change occurs. Routing is generally based on the incoming port and the destination domain. 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 74: Dlsshow
Telnet Commands dlsShow Display the setting of the Dynamic Load Sharing (DLS) option. Synopsis dlsShow Availability All users Description Use this command to display whether DLS is on or off. There can be two messages displayed: The DLS option is turned on. Load sharing is reconfigured with every change in DLS is set the fabric.
Page 75: Errdisplayfilter
Telnet Commands errDisplayFilter Display or set the level of error filtering. Synopsis errDisplayFilter [level] Availability All users (display) admin (set) Description Use this command to view or configure the error levels that are displayed on the front panel. Errors with a higher level (lower severity) than the value specified are stored in the error log but are not displayed on the front panel.
Page 76: Errdump
Telnet Commands errDump Display the error log without page breaks. Synopsis errDump Availability All users Description Use this command to display the error log without page breaks. This command displays the same information as errShow, but errShow enables you to scroll through the entries using the Enter button.
Page 77: Errshow
Telnet Commands errShow Scroll through the error log. Synopsis errShow Availability All users Description Use this command to display the error log. This command enables you to scroll through the entries using the Enter key. Use errDump to display the same information without line breaks. Each entry in the log follows the format below: Error Number ------------...
Page 78: Diagnostic Error Codes
Telnet Commands Diagnostic Error Codes The following table lists the error code numbers, the POST test that generates this error number, and the type of error. Table 1-6 Diagnostic Error Codes Error Number Test Error Type 0001 DIAG-CLEAR_ERR 0002 DIAG-BURNIN_START 0003 DIAG-BURNIN_STOP 0004...
Page 79 Telnet Commands Table 1-6 Diagnostic Error Codes (Continued) Error Number Test Error Type 1F27 cmemRetentionTest DIAG-LCMEM 2030 cmiTest DIAG-BADINT 2031 cmiTest DIAG-INTNIL 2032 cmiTest DIAG-CMISA1 2033 cmiTest DIAG-CMINOCAP 2034 cmiTest DIAG-CMIINVCAP 2035 cmiTest DIAG-CMIDATA 2036 cmiTest DIAG-CMICKSUM 223B camTest DIAG-CAMINIT 223C camTest DIAG-CAMSID...
Page 80 Telnet Commands Table 1-6 Diagnostic Error Codes (Continued) Error Number Test Error Type 3045 crossPortTest DIAG-ERRSTAT (ENCOUT) 3046 crossPortTest DIAG-ERRSTAT (BADORD) 3047 crossPortTest DIAG-ERRSTAT (DISCC3 304F crossPortTest DIAG-INIT 305F crossPortTest DIAG-PORTDIED 3060 crossPortTest DIAG-STATS (FTX 3061 crossPortTest DIAG-STATS (FRX 3062 crossPortTest DIAG-STATS (C3FRX 306E...
Page 81 Telnet Commands Example The following illustrates two entries in the error log: 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 Type <CR> to continue, Q<CR> to stop: Error 01 -------- 0x103e9500 (tSwitch): Feb...
Page 82: Fabricshow
Telnet Commands fabricShow Displays fabric membership information. Synopsis fabricShow Availability All users Description Use this command to display information about switches and multicast alias groups in the fabric. Multicast alias groups are created on demand by request from N_Ports attached to the alias server; typically no groups are listed.
Page 83: Fanshow
Telnet Commands 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 (revolutions per minute).
Page 84: Fastboot
Telnet Commands fastboot Reboot the switch, bypassing POST. Synopsis fastboot Availability admin Description Use this command to reboot the switch, bypassing Power On Self Test (POST). The reboot takes effect immediately as the switch resets and executes normal power-on booting sequence. However, POST is skipped.
Page 85: Filtertest
Telnet Commands filterTest Frame Filter test for Silkworm 3000 ASICs. Synopsis filterTest [passCount] Availability admin Description This command verifies that the Silkworm 3000 ASIC frame level filtering logic including every type of filter actions: • FLTACT_LIST_A - action to handle the subgroup A based filtering •...
Page 86 Telnet Commands Example To run the filterTest: switch:admin> filterTest Running Filter Test ... passed. See Also ramTest portRegTest cmiTest centralMemoryTest sramRetentionTest turboRamTest camTest statsTest portLoopbackTest spinSilk 1-72 Fabric OS Reference...
Page 87: Firmwaredownload
Telnet Commands 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 88 Telnet Commands Example To download a firmware file: switch:admin> firmwareDownload "citadel","jdoe","/home/firmware/v2.2" 55696+6984+133172, csum 7eca writing flash 0 ....writing flash 1 ....download complete Errors The following can cause the download to fail: • The host name is not known to the switch •...
Page 89: Fspfshow
Telnet Commands 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 following fields: Table 1-8 fspfShow display fields...
Page 90 Telnet Commands Examples To display FSPF protocol information: switch:admin> fspfshow version domainID isl_ports = 0x00000020 minLSArrival minLSInterval LSoriginCount startTime = 16784 fspfQ = 0x10f48f10 fabP = 0x10f49f90 agingTID = 0x10f3c100 agingTo = 10000 lsrDlyTID = 0x10f3c0b0 lsrDelayTo = 5000 lsrDelayCount ddb_sem = 0x10f48ee0 fabP:...
Page 91: Fwalarmsfilterset
Telnet Commands fwAlarmsFilterSet This command determines whether alarms are enabled for Fabric Watch. Synopsis fwAlarmsFilterSet [0|1] Availability admin Description Use this command to configure alarm filtering for Fabric Watch. By turning off the alarms, all non-environment class alarms are suppressed. By turning on the alarms, all class alarms are generated.
Page 92: Fwalarmsfiltershow
Telnet Commands fwAlarmsFilterShow Shows alarm filtering for Fabric Watch. Synopsis fwAlarmsFilterShow Availability All users Description Use this command to display whether alarm filtering is enabled or disabled. Note: This command requires a Fabric Watch License. Operands none Example To display the status of alarm filtering in Fabric Watch: switch:admin>...
Page 93: Fwclassinit
Telnet Commands fwClassInit Initializes all classes under Fabric Watch. Synopsis fwClassInit Availability admin Description Use this command to initialize all classes under Fabric Watch. Note: This command requires a Fabric Watch License. Operands None Example To initialize all classes under Fabric Watch: switch:admin>...
Page 94: Fwconfigure
Telnet Commands fwConfigure Displays and allows modification of the Fabric Watch configuration and status. Synopsis fwConfigure Availability admin Description Use this command to display and modify threshold information for the Fabric Watch configuration. Switch elements monitored by Fabric Watch are divided into classes, which are further divided into areas.
Page 95 Telnet Commands Table 1-9 fwConfigure Fabric Watch classes and areas (Continued) Class Area E_Port Link failure count Loss of synchronization count Loss of signal count Primitive sequence protocol error Invalid transmission word Invalid CRC count Receive performance Transmit performance State changes F/FL_Port (optical) Link failure count Loss of synchronization count...
Page 96 Telnet Commands Example To display the Fabric Watch configuration and status: switch:admin> fwConfigure 1 : Environment class 2 : GBIC class 3 : Port class 4 : Fabric class 5 : E-Port class 6 : F/FL Port (Copper) class 7 : F/FL Port (Optical) class 8 : quit Select a class =>...
Page 97: Fwconfigreload
Telnet Commands fwConfigReload Reloads the Fabric Watch configuration. Synopsis fwConfigReload Availability admin Description Use this command to reload the Fabric Watch configuration. This command should only be used after downloading a new Fabric Watch configuration file from a host. Note: This command requires a Fabric Watch License.
Page 98: Fwhelp
Telnet Commands fwHelp Display Fabric Watch command information. Synopsis fwHelp Availability all users Description Use this command to display commands used to configure Fabric Watch. Operands None. Example To display a summary of Fabric Watch telnet commands: switch:admin> fwHelp fwAlarmsFilterSet Configure alarms filtering for Fabric Watch fwAlarmsFilterShow Show alarms filtering for Fabric Watch...
Page 99: Fwmailcfg
Telnet Commands fwMailCfg Configures email alerts in Fabric Watch. Synopsis fwMailCfg Availability All users. Description Use this command to configure email alerts in Fabric Watch. When this command is executed a menu of configuration tasks are displayed. Select the configuration task by entering a value 1 through 6: : Show Mail Configuration Information : Disable EmailAlert : Enable EmailAlert...
Page 100 Telnet Commands Example To configure an email address recipient in Fabric Watch: switch:admin> fwMailCfg : Show Mail Configuration Information : Disable EmailAlert : Enable EmailAlert : Send Test Mail : Set Mail Address for EmailAlert : quit Select an item =>...
Page 101: Fwsettocustom
Telnet Commands fwSetToCustom Sets boundary and alarm levels to custom values. Synopsis fwSetToCustom Availability admin Description Use this command to set boundary and alarm levels to custom for all classes and areas for Fabric Watch. Note: This command requires a Fabric Watch License. Operands none Example...
Page 102: Fwsettodefault
Telnet Commands fwSetToDefault Sets boundary and alarm levels to the default values. Synopsis fwSetToDefault Availability admin Description Use this command to set boundary and alarm levels to default for all classes and areas for Fabric Watch. Note: This command requires a Fabric Watch License. Operands none.
Page 103: Fwshow
Telnet Commands fwShow Displays the thresholds monitored by Fabric Watch. Synopsis fwShow [pattern] Availability All users Description Use to display the thresholds monitored by Fabric Watch. If no parameters are entered, a summary of all thresholds is displayed and printed. If a valid threshold name is entered as a parameter, detailed information pertaining only to that threshold is displayed and printed.
Page 104 Telnet Commands Example To display the thresholds monitored by Fabric Watch: switch:admin> fwShow =========================================================== Name Label Last Value ---------------- ------------------------ --------------- envTemp001 Env Temperature 1 33 C envTemp002 Env Temperature 2 33 C envTemp003 Env Temperature 3 36 C envTemp004 Env Temperature 4 35 C envTemp005...
Page 105: Gbicshow
Telnet Commands gbicShow Display serial ID GBIC/SFP information. Synopsis gbicShow [port] 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 the GBICs capabilities, interfaces, manufacturer, and other information.
Page 106 Finisar "smart" GBIC or SFP: 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 107 Telnet Commands 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.
Page 108: Help
Telnet Commands help Display help information for commands. Synopsis help [command] Availability All users Description Use this command without a operand to display an alphabetical list of commands. At the end of the list are additional commands that display groups of commands, for example diagHelp displays a list of diagnostic commands.
Page 109 Telnet Commands 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 taskID is supplied. One line is displayed for each task; it contains the following fields: Table 1-10 Field Description Field Description...
Page 110 Telnet Commands Example To display the task summary: switch:admin> i tFabric NAME ENTRY STATUS ERRNO DELAY ---------- ---------- -------- --- -------- ------- -------- ----- ---- tFabric _fabricTask 103aae20 100 PEND 10191b78 103ab1e0 switch:admin> i NAME ENTRY STATUS ERRNO DELAY ---------- ---------- -------- --- -------- ------- -------- ----- ---- tExcTask _excTask...
Page 111: Ifmodeset
Telnet Commands ifModeSet Set the link operating mode for a network interface. Synopsis ifModeSet ["interface"] Availability admin Description Use this command to set the link operating mode for a network interface. Use ifShow to list network interfaces available on the system. An operating mode is confirmed with a "y"...
Page 112: Ifmodeshow
Telnet Commands ifModeShow Display the link operating mode for a network interface. Synopsis ifModeShow ["interface"] Availability All users Description Use this command to display the link operating mode for a network interface. Operands This command has the following operand: Specify the name of the interface in quotation marks. For example, "fei0", interface where fei is the network interface and 0 is the physical unit.
Page 113: Ifshow
Telnet Commands ifShow Display network interface information. Synopsis ifShow ["ifName"] Availability All users Description Use this command to display network interface status. If the operand ifName is provided, only the that interface is displayed. If ifName is omitted, all interfaces are displayed. Each switch has three interfaces: “ei”...
Page 114: Interfaceshow
Telnet Commands interfaceShow Display FSPF interface information. Synopsis interfaceShow [port] 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 that save data associated with FSPF interfaces: •...
Page 115 Telnet Commands IDB number. Should be equal to portnumber idbNo Port number on the remote switch connected to this port. remPort nflags Internal FSPF flags. Number of times this neighbor was initialized, without the interface going down. initCount &dbRetransList Pointer to the database retransmission list. &lsrRetransList Pointer to the Link State Records (LSR) retransmission list.
Page 116 Telnet Commands Operands This command has the following operand: Specify the port number to display the interface data structures for. Valid values port for port number vary depending on the switch type. This operand is required. Examples To display FSPF interface information: switch:admin>...
Page 117: Interopmode
Telnet Commands InteropMode Enables or disables switch interoperability with switches from other manufacturers. Synopsis interopMode [mode] Availability admin Description Use this command to enable or disable interoperability mode for individual switches. This feature enables other manufacturer’s switches to be used in a fabric of switches. Interoperability mode allows switches to operate in a heterogeneous fabric (a fabric containing switches from different manufacturers).
Page 118 Telnet Commands • Zoning must be consistently and entirely managed from a single selected switch type for the lifetime of the “Effective Configuration”. Attempting to manage from other vendor switches results in the loss of zoning information. There is no indicator of which method has been previously used.
Page 119: Iodreset
Telnet Commands iodReset Turn off the In Order Delivery (IOD) option. Synopsis iodReset Availability admin Description Use this command to allows 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 120: Iodset
Telnet Commands iodSet Turn on In Order Delivery (IOD) 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.
Page 121: Iodshow
Telnet Commands iodShow Display the state of the In Order Delivery (IOD) option. Synopsis iodShow Availability All users Description Use this command to display whether the IOD option is on or off. Operands None. Example To display the current setting of the IOD option: switch:admin>...
Page 122: Ipaddrset
Telnet Commands ipAddrSet Set ethernet and FC IP addresses. Synopsis ipAddrSet Availability admin Description Use this command to set the ethernet and FC IP addresses. You are prompted for: Ethernet IP Address IP address of the ethernet port. Ethernet Subnetmask IP subnet mask of the ethernet port.
Page 123: Ipaddrshow
Telnet Commands ipAddrShow Display ethernet and FC IP addresses. Synopsis ipAddrShow Availability All users Description Use this command to display ethernet and Fibre Channel IP addresses. The following are shown: Ethernet IP Address IP address of the ethernet port. Ethernet Subnetmask IP subnet mask of the ethernet port.
Page 124: Islshow
Telnet Commands islShow Display ISL information. Synopsis islShow Availability all users Description Use this command to display the current connections and status of the ISL of each port on this switch. The following information is displayed: • the WWN where the ISL is connected to •...
Page 125: Isltopocheck
Telnet Commands 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. A switch with properly configured ISL connections reports a status of OK for each of these ports.
Page 126: Isltoposhow
Telnet Commands islTopoShow Displays 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 127 Telnet Commands Switch idx: 1 Domain: 1, wwn: 10:00:00:60:69:20:02:9f isl port expected switch port actual switch port status 00 -> es_6 : 08 es_6 : 08 01 -> es_6 : 09 es_6 : 09 02 -> es_6 : 10 -UNKNOWN- :-01 No record 03 ->...
Page 128: Licenseadd
Telnet Commands licenseAdd Add license key to switch. Synopsis licenseAdd "license" Availability admin Description Use this command to add a license key to a switch. The license key string is case sensitive; it must be entered exactly as issued. When the key has been entered, use the licenseShow command to check that the key has been correctly entered and the licensed product installed.
Page 129: Licensehelp
Telnet Commands 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...
Page 130: Licenseremove
Telnet Commands licenseRemove Remove the license key from a switch. Synopsis licenseRemove "license" Availability admin Description Use this command to remove an existing license key from a switch. The existing license key must be entered exactly as shown by licenseShow, including case. When the key has been entered, use the licenseShow command to check that the key has been removed and the licensed product uninstalled.
Page 131: Licenseshow
Telnet Commands licenseShow Display current license keys. Synopsis licenseShow Availability All users Description Use this command to display current license keys along with a list of licensed products enabled by these keys; none is displayed if no license keys are installed. Operands None.
Page 132: Linkcost
Telnet Commands linkCost Set or print the FSPF cost of a link. Synopsis linkCost [port], [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.
Page 133: Login
Telnet Commands login Login as a new user. Synopsis login Availability All users Description Use this command to login to the switch with another user name and password, without first logging out from the original session. If the user was originally connected using a telnet or rlogin session, that session is left open.
Page 134: Logout
Telnet Commands logout Logout from a telnet, rlogin or serial port session. Synopsis logout Availability All users Description Use this command to logout from a telnet, rlogin or serial port session. Telnet and rlogin connections are closed, the serial port returns to the “login:” prompt. The commands exit and quit are accepted as synonyms for logout, as is control-D entered at the beginning of a line.
Page 135: Lsdbshow
Telnet Commands 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 136 Telnet Commands Table 1-12 LSDbShow display fields (Continued) Field Description Type of the LSR. Always 1. type Always 0. options ID of this LSR. It is identical to the domain number. lsId advertiser ID (domain number) of the switch that originated this LSR. Incarnation number of this LSR.
Page 137 Telnet Commands 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>...
Page 138: Mcastshow
Telnet Commands mcastShow Display multicast routing information. Synopsis mcastShow [group_ID] Availability All users Description Use this command to display the multicast routing information, as it is known by the FSPF path selection and routing task, for all ports in the switch. The multicast routing information indicates, for each multicast group, all the ports that are members of that group, that is ports that are able to send and receive multicast frames on that group.
Page 139: Msconfigure
Telnet Commands 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 140 Telnet Commands 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 141: Msplatshow
Telnet Commands 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 142: Msplcleardb
Telnet Commands 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 143: Msplcapabilityshow
Telnet Commands 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 ok to activate the Platform database management service on all switches in the fabric.
Page 144: Msplmgmtactivate
Telnet Commands 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 145: Msplmgmtdeactivate
Telnet Commands 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 146: Mstdenable
Telnet Commands msTDEnable Enable the Management Server Topology Discovery Management service. Synopsis msTdEnable ["ALL"] Availability admin Description Use this command to enable the Management Server Topology Discovery Management Service locally or fabric-wide. This command enables the Topology Discovery Management Service on the local switch and commits the change to the flash memory of the local switch.
Page 147: Mstddisable
Telnet Commands msTDDisable Disable the Management Server Topology Discovery Management service. Synopsis msTdDisable ["ALL"] Availability admin Description Use this command to disable the Management Server Topology Discovery Management Service locally or fabric-wide. This command will disable the Topology Discovery Management Service of the local switch and commit the changes to flash memory of the local switch.
Page 148: Nbrstatsclear
Telnet Commands nbrStatsClear Reset FSPF interface counters. Synopsis nbrStatsClear [port] 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 149: Nbrstateshow
Telnet Commands nbrStateShow Display FSPF neighbor's state. Synopsis nbrStateShow [port] 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.
Page 150: Nsallshow
Telnet Commands nsAllShow Display global Name Server information. Synopsis nsAllShow [type] Availability All users Description Use this command to display the 24-bit Fibre Channel addresses of all devices in all switches in the fabric. If the operand type is supplied, only devices of specified FC-PH type are displayed. If type is omitted, all devices are displayed.
Page 151: Nsshow
Telnet Commands 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.
Page 152 Telnet Commands 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]...
Page 153: Paritycheck
Telnet Commands parityCheck Enable or disable DRAM parity checking. Synopsis parityCheck [0|1] 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 154: Passwd
Telnet Commands passwd Change system login name and password. Synopsis passwd ["user"] Availability All users Description Use this command to change the system login name and password. To change the login name and password for a specific user, enter the command with the optional "user"...
Page 155 Telnet Commands Errors All error messages are preceded by the command name with one of the following messages appended: user is not a valid user name. You have not specified a user name that is a valid, " " recognized user name on the system. Permission denied.
Page 156: Perfaddeemonitor
Telnet Commands perfAddEEMonitor Add end-to-end monitor to a port. Synopsis perfAddEEMonitor port, "SourceID", "DestID" Availability admin Description Use this command to add an End-to-End monitor to a port. The monitor counts the number of words received, number of words transmitted and number of CRC errors detected with frames qualified using either of following two conditions.
Page 157 Telnet Commands Example To add an end-to-end monitor to port 2: switch:admin> perfAddEEMonitor 2, "0x058e0f", "0x1182ef" End-to-End monitor number 0 added. switch:admin> See Also perfAddIPMonitor perfAddReadMonitor perfAddRWMonitor perfAddSCSIMonitor perfAddUserMonitor perfAddWriteMonitor Fabric OS Reference 1-143...
Page 158: Perfaddipmonitor
Telnet Commands perfAddIPMonitor Add a filter-based monitor for IP frame count. Synopsis perfAddIPMonitor port[, "alias"] Availability admin Description Use this command to define filter-based monitors to count the number of IP traffic frames. After a successful execution of this command, a monitor number is displayed. The monitor number is provided for easy manipulation of these filter-based performance monitors.
Page 159: Perfaddreadmonitor
Telnet Commands perfAddReadMonitor Add a filter-based monitor for the SCSI Read command. Synopsis perfAddReadMonitor port[, "alias"] Availability admin Description Use this command to define filter-based monitors to count the number of SCSI FCP Read commands in Fibre Channel frames. After a successful execution of this command, a monitor number is displayed. The monitor number is provided for easy manipulation of these filter-based performance monitors.
Page 160: Perfaddrwmonitor
Telnet Commands perfAddRWMonitor Add a monitor for the SCSI Read and Write commands. Synopsis perfAddRWMonitor port[, "alias"] Availability admin Description Use this command to define filter-based monitors to count the number of SCSI FCP Read and Write commands in Fibre Channel frames. After a successful execution of this command, a monitor number is displayed.
Page 161: Perfaddscsimonitor
Telnet Commands perfAddSCSIMonitor Add a monitor for SCSI frame count. Synopsis perfAddSCSIMonitor port[, "alias"] Availability admin Description Use this command to define filter-based monitors to count the number of SCSI traffic frames. After a successful execution of this command, a monitor number is displayed. The monitor number is provided for easy manipulation of these filter-based performance monitors.
Page 162: Perfaddusermonitor
Telnet Commands perfAddUserMonitor Add a user-defined filter-based monitor. Synopsis perfAddUserMonitor port, "grouplist" [, "alias"] Availability admin Description Use this command to define a special mechanism to qualify frames for statistics gathering to fit your own special need. Each group of elements with same offset will have their comparison result (OR-ed) together before the combined result of each group get (AND-ed) together for final comparison result.
Page 163 Telnet Commands SOFx frames are considered a special case. The Offset is specified as 0x0, valueList are specified with: 0 - SOFf 1 - SOFc1 2 - SOFi1 3 - SOFn1 4 - SOFi2 5 - SOFn2 6 - SOFi3 7 - SOFn3 alias Specify a name for this monitor.
Page 164: Perfaddwritemonitor
Telnet Commands perfAddWriteMonitor Add a filter-based monitor for the SCSI Write command. Synopsis perfAddWriteMonitor port [, "alias"] Availability admin Description Use this command to define filter-based monitors to count the number of SCSI FCP Write commands in Fibre Channel frames. After a successful execution of this command, a monitor number is displayed.
Page 165: Perfcfgclear
Telnet Commands perfCfgClear Clear the previously saved performance monitoring configuration settings from flash memory. Synopsis perfCfgClear Availability admin Description Use this command to clear the previously saved end-to-end and filter configuration settings (data structures) of performance monitoring from flash memory. Operands None.
Page 166: Perfcfgrestore
Telnet Commands perfCfgRestore Restore performance monitoring configuration settings from flash memory. Synopsis perfCfgRestore Availability admin Description Use this command to restore the performance monitoring configuration information from flash memory. Operands None. Example To restore the performance monitoring configuration information from flash memory: switch:admin>...
Page 167: Perfcfgsave
Telnet Commands perfCfgSave Save performance monitoring configuration settings to flash memory. Synopsis perfCfgSave Availability admin Description Use this command to save the current end-to-end and filter configuration settings (data structures) of performance monitoring into flash memory. This enables the performance monitoring configuration to be saved over power off cycles.
Page 168: Perfclralpacrc
Telnet Commands perfClrAlpaCrc Clear an ALPA device’s CRC count by the port and ALPA. Synopsis perfClrAlpaCrc port[, ALPA] Availability admin Description Use this command to clear specific ALPA device's CRC error counter. If the ALPA is provided as an operand only the counters for that device are reset; if no ALPA is specified this command clears the CRC counters for all ALPA devices on the specified port.
Page 169: Perfdeleemonitor
Telnet Commands perfDelEEMonitor Delete an end-to-end monitor on port. Synopsis perfDelEEMonitor port[, monitor] Availability admin Description Use this command to delete an end-to-end monitor on a port. Operands This command has the following operands: Specify the port number where you want to delete an end-to-end monitor. This port operand is required.
Page 170: Perfhelp
Telnet Commands perfHelp Display performance monitoring help information. Synopsis perfHelp Availability All users. Description Use this command to display the available performance monitoring help commands. Operands None. Example To display commands related to performance monitoring: switch:admin> perfHelp perfCfgSave Save Performance configuration perfCfgRestore Restore Performance configuration perfCfgClear...
Page 171: Perfdelfiltermonitor
Telnet Commands perfDelFilterMonitor Delete a filter-based monitor. Synopsis perfDelFilterMonitor port[, monitor] Availability admin Description Use this command to delete a filter-based monitor. After a successful execution of this command, the telnet shell confirms that this monitor has successfully been deleted. Prior to issuing this command, verify all the valid monitor numbers and user-defined aliases on a specific port using the perfShowFilterMonitor command to make sure that the right monitor will be deleted.
Page 172: Perfsetporteemask
Telnet Commands perfSetPortEEMask Set overall mask for end-to-end (EE) monitors. Synopsis perfSetPortEEMask port,"TxSIDMsk","TxDIDMsk","RxSIDMsk","RxDIDMsk" Availability admin Description Use this command to set the mask for the EE monitors of a port. This command enables a user to selectively choose the kind of Fibre Channel frames in which the number of words are to be counted.
Page 173 Telnet Commands Example To set the overall mask for end-to-end monitors: switch:admin> perfSetPortEEMask 6, "00:00:00", "ff:ff:ff", "00:00:ff", "ff:00:00" The EE mask on port 6 is set and EE counters are reset. switch:admin> See Also perfAddEEMonitor Fabric OS Reference 1-159...
Page 174: Perfshowalpacrc
Telnet Commands perfShowAlpaCrc Display the ALPA CRC count by port or by ALPA. Synopsis perfShowAlpaCrc port[, ALPA] Availability admin Description Use this command to display a specific ALPA device CRC error count by the port or ALPA. If the ALPA operand is specified, only the CRC count for that ALPA device is displayed. If the ALPA operand is not specified, the CRC count for all the ALPA devices on a specified port are displayed.
Page 175: Perfshoweemonitor
Telnet Commands perfShowEEMonitor Display end-to-end monitor information and frame traffic on a port. Synopsis perfShowEEMonitor port[, interval] Availability admin Description Use this command to display end-to-end monitor information and frame traffic on a port. This command can display (if no interval operand is specified): •...
Page 176: Telnet Commands
Telnet Commands Example To display end to end monitor frame traffic on port 5 at an interval of once a second: switch:admin> perfShowEEMonitor 5, 1 perfShowEEMonitor 4 1: Tx/Rx are # of bytes and crc is # of crc errors ------------- ------------- -------------...
Page 177: Perfshowfiltermonitor
Telnet Commands perfShowFilterMonitor Display filter-based monitor information and frame traffic for a port. Synopsis perfShowFilterMonitor port[, interval] Availability admin Description Use this command to display all the filter-based monitors defined on the specified port and the traffic count values. This command can display (if no interval operand is specified): •...
Page 178 Telnet Commands Example To display filter monitor traffic on port 5 at an interval of once a second: switch:admin> perfshowfiltermonitor 5, 1 perfShowFilterMonitor 5 1 #Frames #CMDs #CMDs #Frames #Frames #CMDs #CMDs --------------------------------------------------------------- To display filter monitor information on port 5: switch:admin>...
Page 179: Perfshowporteemask
Telnet Commands perfShowPortEEMask Displays the current end-to-end mask of a port. Synopsis perfShowPortEEMask port Availability admin Description Use this command to display the current end-to-end mask of a port. There are only two commands that can modify the value of the EE mask, perfSetPortEEMask and perfCfgRestore. The end-to-end mask has 12 fields: TxSID Domain: TxSID Area:...
Page 180 Telnet Commands See Also perfAddEEMonitor perfDelEEMonitor perfShowEEMonitor perfSetPortEEMask perfShowPortEEMask 1-166 Fabric OS Reference...
Page 181: Portcfgeport
Telnet Commands portCfgEport Enable or disable a port from becoming an E_Port. Synopsis portCfgEport [port, 0|1] Availability admin Description This command allows a user to enable/disable a port from becoming an E_Port. The E_Port capability is enabled by default unless this command is used to disable it. When a port is configured as a non-E_Port through this command, an ISL connected to this port will be segmented.
Page 182: Portcfggport
Telnet Commands portCfgGport Designates a port as a locked G_Port. Synopsis portCfgGport port, 0|1 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 183: Portcfglport
Telnet Commands portCfgLport Lock a port as an L_PORT. Synopsis portCfgLport port, lockmode, [,privatemode] Availability admin Description Use this command to designate a port as an L_PORT. The switch will then only attempt to initialize that port as an FL_PORT. The switch never attempts point-to-point (F_PORT) initialization on the port.
Page 184: Portcfglongdistance
Telnet Commands portCfgLongDistance Configure a port to support long distance links. Synopsis portCfgLongDistance portnumber [0|1|2] Availability admin 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 185 Telnet Commands Example To configure switch port 3 to support a 100 km link: switch:admin> portCfgLongDistance 3 Please enter the long distance level -- : (0..2) [0] 2 Committing configuration...done. See Also configure portShow switchShow Fabric OS Reference 1-171...
Page 186: Portcfgmcastloopback
Telnet Commands portcfgMcastLoopback Configure a port to receive multicast frames. Synopsis portCfgMcastLoopback port, 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 187 Telnet Commands Example To configure switch port 3 as a multicast loopback port: switch:admin> portCfgMcastLoopback 3, 1 Committing configuration...done. See Also portShow switchShow mcastShow configure Fabric OS Reference 1-173...
Page 188: Portcfgshow
Telnet Commands portCfgShow Display port configuration settings. Synopsis portCfgShow Availability all users Description Use this command to display the current configuration of all ports. The following configuration information is displayed: • Port Speed is displayed as 1G, 2G, or AN (when in Auto speed Negotiation mode). This value is set by the portCfgSpeed command.
Page 189 Telnet Commands portCfgLongDistance portCfgTrunkport portCfgSpeed Fabric OS Reference 1-175...
Page 190: Portcfgspeed
Telnet Commands portCfgSpeed Configure the port speed level. Synopsis portCfgSpeed port[, speed_level] Availability admin Description Use this command to configure the speed of a port to a particular level. After this command is issued, the port is disabled and enabled so that the port comes up with the new speed setting. The configuration is saved in the non-volatile memory and is persistent across switch reboot or power cycle.
Page 191: Portcfgtrunkport
Telnet Commands portCfgTrunkport Configure a port to be enabled or disabled for trunking. Synopsis portCfgTrunkport port, 1|0 Availability admin Description Use this command to configure a port to be enabled or disabled for trunking. Note: This command requires a Trunking license. Operands This command has the following operand: Specify the port number where you want to enable or disable trunking.
Page 192: Portdisable
Telnet Commands portDisable Disable a switch port. Synopsis portDisable port 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.
Page 193: Portenable
Telnet Commands portEnable Enable a switch port. Synopsis portEnable port 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.
Page 194: Porterrshow
Telnet Commands 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 195 Telnet Commands Example The following example shows an eight port switch. Notice in the example below that port six 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 ----------------------------------------------------------------...
Page 196: Portlogclear
Telnet Commands portLogClear Clear the port log. Synopsis portLogClear Availability admin Description Use this command to clear the port log. You may want to clear the port log before triggering an activity so that the log displays only the activity related to that activity. See portLogShow for a description of the port log. If the port log is disabled, portLogClear enables it.
Page 197: Portlogdump
Telnet Commands portLogDump Display the port log without page breaks. Synopsis portLogDump [count[, saved]] Availability All users Description Use this command to display the port log, listing all entries in the log without page breaks. This command displays the same information as portLogShow, but portLogShow prompts the user to enter ‘returns”...
Page 198: Portlogshow
Telnet Commands 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. The portLogShow command displays the same information as portLogDump, but it allows you to enter a “return”...
Page 199 Telnet Commands Table 1-13 portLogShow Command Field Descriptions (Continued) Field Possible Values event Possible events are: switch start or re-start event start port is disabled disable port is enabled enable port I/O control is executed ioctl frame is transmitted (class is indicated) frame is received (class is indicated) state change notification is posted port changes physical state...
Page 200 Telnet Commands Table 1-13 portLogShow Command Field Descriptions (Continued) Field Possible Values args The command arguments description depends on event type: start type: 0 = enable ports, 100 = disable ports star state can be one of the following: 1 - Online, 2 - Offline, 3 - Testing, 4 - Faulty, disable 5 - E_Port, 6 - F_Port, 7 - Segmented.
Page 201 Telnet Commands Table 1-14 Pstate Codes Pstate Code Description Active State 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 Table 1-15 ioctl Codes...
Page 202 Telnet Commands Table 1-16 LIP Reason Codes LIP Code Description 8001 Retry loop init 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...
Page 203 Telnet Commands Operands This command has the following operands: Specify the maximum number of lines to display. Only the most recent count count entries are displayed. This operand is optional. Specify a non-zero value to display the saved port log from the last switch fault. saved See uptime for a list of conditions that cause a fault.
Page 204: Portloopbacktest
Telnet Commands 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 205 Telnet Commands Operands This command has the following operand: Specify the number of times (or number of frames per port) to execute this test. passCount The default value is 0xfffffffe. This operand is optional. Example To run the portLoopbackTest 100 times: switch:admin>...
Page 206: Portperfshow
Telnet Commands portPerfShow Display port throughput performance in bytes, kilobytes, or megabytes. Synopsis portPerfShow [interval] Availability All users Description Use this command to display throughput information for all ports on the switch (8 or 16 columns depending on the switch model). One output line is displayed per interval (or second if no interval is specified) until return, control-C, or control-D is entered.
Page 207: Portregtest
Telnet Commands portRegTest Bit write/read test of the ASIC SRAMs and registers. Synopsis portRegTest Availability admin Description Use this command to verify that SRAM and register data bits in each ASIC can be independently written and read. To verify the data bits, write a walking 1 pattern to each location - write a pattern of 0x00000001 to register N, read, and compare to be sure that the pattern is the same.
Page 208 Telnet Commands Errors Below are possible error messages if failures are detected: DIAG-REGERR DIAG-REGERR_UNRST DIAG-BUS_TIMEOUT See Also ramTest centralMemoryTest cmiTest sramRetentionTest turboRamTest camTest statsTest filterTest portLoopbackTest spinSilk 1-194 Fabric OS Reference...
Page 209: Portrouteshow
Telnet Commands portRouteShow Display routing tables for a port. Synopsis portRouteShow port Availability All users Description Use this command to display the port address ID and the contents of the following port routing tables: External unicast routing Shows unicast frame routing to another switch element in the fabric. table Output format is domain_number: ports_bitmap...
Page 210 Telnet Commands Specify the port number to be displayed. Valid values for port number vary port depending on the switch type. This operand is required. 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...
Page 211: Portshow
Telnet Commands portShow Display port status. Synopsis portShow port 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: Table 1-18 PortShow display fields Field Description portFlags...
Page 212 Telnet Commands Table 1-18 PortShow display fields (Continued) Field Description Speed The port's fixed speed level or negotiated speed level: 1Gbps - fixed speed of 1Gb per second. N1Gbps - negotiated speed of 1Gb per second. 2Gbps - fixed speed of 2Gb per second. N2Gbps - negotiated speed of 2Gb per second.
Page 213 Telnet Commands 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 Speed: 2Gbps Interrupts: Link_failure: 0 Frjt: Unknown: Loss_of_sync: 0...
Page 214: Portstatsshow
Telnet Commands portStatsShow Display port hardware statistics. Synopsis portStatsShow port Availability All users Description Use this command to display port hardware statistics counters. The first section, below, is common to all hardware; one of the last two sections (depending on switch type) is shown for loop ports: 4-byte words transmitted.
Page 215 Telnet Commands Number of CFIFOs full stalls. fl_cf_full CFIFO not available stalls. fl_cf_na Number of age count triggers. fl_trig_age Number of loop not busy triggers. fl_trig_lp Number of times the FL_Port entered OPEN state. open transfer Number of times the FL_Port entered TRANSFER state. Number of times the FL_Port entered OPENED state.
Page 216: Psshow
Telnet Commands 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 as: Power supply present and functioning correctly.
Page 217: Qloopadd
Telnet Commands qloopAdd Add a member to a QuickLoop. Synopsis qloopAdd "qloopname", "member;member" Availability admin Description Use this command to add one or more members to an existing QuickLoop. When a configuration is enabled, all QuickLoops defined in the configuration must resolve to one or two switch worldwide names.
Page 218: Qloopcreate
Telnet Commands qloopCreate Create a QuickLoop. Synopsis qloopCreate "qloopname", "member;member" Availability admin Description Use this command to create a QuickLoop. A QuickLoop name must begin with a letter and be followed by any number of letters, digits, and underscore characters. Names are case sensitive, for example “Qloop_1” indicates a different QuickLoop than “qloop_1”.
Page 219: Qloopdelete
Telnet Commands qloopDelete Delete a QuickLoop. Synopsis qloopDelete "qloopName" Availability admin Description Use this command to delete a QuickLoop. When a configuration is enabled, all QuickLoops defined in the configuration must resolve to a maximum of two switch worldwide names. Operands The following operand is required: Specify the name of QuickLoop, in quotation marks.
Page 220: Qloopremove
Telnet Commands qloopRemove Remove a member from a QuickLoop. Synopsis qloopRemove "qloopName", "member;member" Availability admin Description Use this command to remove one or more members from a QuickLoop. The member list is identified through an exact string match; therefore, when removing multiple members, order is important.
Page 221: Qloopshow
Telnet Commands qloopShow Display QuickLoop information. Synopsis qloopShow [pattern] Availability All users Description Use this command to display QuickLoop configuration information. If no parameters are specified, all zone configuration information (defined and enabled) is displayed. See cfgShow for a description of this display. If a parameter is specified, it is used as a pattern to match QuickLoop names;...
Page 222 Telnet Commands Example To display all QuickLoops beginning with the letter “q”: switch:admin> qloopShow "q*" qloop: qlp1 10:00:00:60:69:00:60:11 10:00:00:60:69:00:30:02 qloop: qlp2 10:00:00:60:69:00:60:13 See Also qloopAdd qloopCreate qloopDelete qloopRemove 1-208 Fabric OS Reference...
Page 223: Qldisable
Telnet Commands qlDisable Disables QuickLoop mode. Synopsis qlDisable Availability admin Description Use this command to disable QuickLoop mode on a switch. All QuickLoop ports are re-initialized to fabric mode, allowing public devices to perform fabric login. If QuickLoop is being run on dual switches, this command disables the local switch and causes the partner switch to re-initialize to a single-switch QuickLoop, containing only the devices connected to the partner switch.
Page 224: Qlenable
Telnet Commands qlEnable Enables QuickLoop mode. Synopsis qlEnable Availability admin Description Use this command to enable QuickLoop mode on a switch. All devices connected to QuickLoop ports are re-initialized to form a single loop. If a partner switch is configured, qlEnable causes re-initialization of the partner if it is in QuickLoop mode.
Page 225: Qlpartner
Telnet Commands qlPartner Sets QuickLoop partner or displays information about partner. Synopsis qlPartner [0|wwn] Availability admin Description Use this command to set the QuickLoop to single/dual switch mode or to display the QuickLoop scope setting. If no argument is specified, this command displays the current QuickLoop mode, which can be single or dual switch.
Page 226: Qlportdisable
Telnet Commands qlPortDisable Disables a QuickLoop port. Synopsis qlPortDisable port Availability admin Description Use this command to change the specified port from QuickLoop mode to fabric mode. This excludes any devices connected to the port from the QuickLoop, and causes the switch to re-initialize the QuickLoop.
Page 227: Qlportenable
Telnet Commands qlPortEnable Enables a QuickLoop port. Synopsis qlPortEnable port Availability admin Description Use this command to change the specified port from fabric mode to QuickLoop mode. This includes any devices connected to this port in the QuickLoop, and causes the switch to re-initialize the QuickLoop.
Page 228: Qlportshowall
Telnet Commands qlPortShowAll Displays QuickLoop port information. Synopsis qlPortShowAll Availability All users Description Use this command to display the following QuickLoop port information: QuickLoop Mode: QuickLoop mode enabled Enabled QuickLoop mode disabled Disabled Looplet state: Online Completed loop initialization NL_port lipped Lipped FL_port lipped Lipping...
Page 229: Qlshow
Telnet Commands qlShow Displays QuickLoop information. Synopsis qlShow Availability All users Description Use this command to display the following QuickLoop information: Self: Worldwide name and domain ID of this switch Peer: Worldwide name and domain ID of partner switch. Peer is displayed only if the switch has a partner configured State: The state of the QuickLoop...
Page 230 Telnet Commands Example The following entry displays QuickLoop information: switch:admin> qlShow Self: 10:00:00:60:69:20:26:2a domain 1 State: Online Scope: single AL_PA bitmap: 00000000 00000000 00000000 00000000 Local AL_PAs (not available) Local looplet states Member: 0 1 2 3 4 5 6 7 Online: - - - - - - - - Looplet 0:...
Page 231: Qlstatsshow
Telnet Commands qlStatsShow Displays QuickLoop statistics. Synopsis qlStatsShow Availability All users Description Use this command to display the following QuickLoop switch statistics: Last QL init time: Time of last QuickLoop initialization QL init attempted: Number of QuickLoop initialization attempts QL init succeeded: Number of times QuickLoop is initialized Single switch QL: Number of times as single switch QuickLoop.
Page 232: Quietmode
Telnet Commands 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 233: Ramtest
Telnet Commands ramTest Bit write and 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 CPU memory in the switch. The test consists of two subtests: The address subtest verifies that SDRAM locations can be uniquely accessed.
Page 234 Telnet Commands Example To run the RAM test on a switch: switch:admin> ramTest Running System DRAM Test ..passed. Errors Listed below are possible error messages if failures are detected: DIAG-MEMORY DIAG-MEMSZ DIAG-MEMNULL See Also portRegTest centralMemoryTest cmiTest sramRetentionTest turboRamTest camTest statsTest filterTest...
Page 235: Reboot
Telnet Commands 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, then executes the normal power-on booting sequence. While the switch is rebooting, the telnet session is closed and all Fibre Channel ports are inactive. If the switch was part of a fabric, the remaining switches reconfigure.
Page 236: Routehelp
Telnet Commands 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 237: Setgbicmode
Telnet Commands setGbicMode Enable or disable GBIC mode. Synopsis setGbicMode [0|1] Availability admin Description Use this command to enable or disable the GBIC mode. If the mode operand is 1, GBIC mode is enabled; if the mode operand is 0, GBIC mode is disabled. The mode is saved in flash memory and stays in the GBIC remains in that mode until the next execution of setGbicMode.
Page 238: Setsplbmode
Telnet Commands setSplbMode Enable or disable 2 port loop-back. Synopsis setSplbMode [0|1] Availability admin Description Use this command to enable or disable SPLB mode. 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 239: Sgroupdelete
Telnet Commands 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 240: Sgrouprename
Telnet Commands sgroupRename Rename a switch group. Synopsis sgroupRename ["oldsgName", "newsgName"] 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. If any parameter is not specified, the session will become an interactive session for which all the parameters will be prompted.
Page 241: Sgroupset
Telnet Commands 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. Note: This command is for the FC 6164 switch only.
Page 242 Telnet Commands Example 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...
Page 243: Sgroupshow
Telnet Commands sgroupShow Display switch group configuration information. Synopsis sgroupShow ["sgType" | "sgName"] Availability all users Description This command displays switch group information. If no parameter is specified, ALL sgroup definitions will be displayed. If a parameter is specified, ALL sgroups with sgType or sgName that contain the given parameter string will be displayed.
Page 244 Telnet Commands See Also sgroupDelete sgroupRename sgroupSet sgroupSupportShow sgroupSwReplace 1-230 Fabric OS Reference...
Page 245: Sgroupsupportshow
Telnet Commands sgroupSupportShow Displays switch information for all switches within the specified group. Synopsis sgroupSupportShow "sgroupName"[, "commandName"] Availability All users Description This command can display a range of debugging information for all the switches in a switch group. If no commandName is specified or all is specified in place of a command name, all the supported commands are displayed for the all the switches within a switch group.
Page 246 Telnet Commands Example To display the temperature in all the switch components of an FC 6164 : switch: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! sw5:admin>...
Page 247: Sgroupswreplace
Telnet Commands sgroupSwReplace Replace a member of a switch group. Synopsis sgroupSwReplace ["sgName", "oldWwn", "newWwn"] Availability admin Description This command replaces the member with the WWN of oldWwn in group sgName with the member with newWwn. The order of members within the member list will not be changed by this operation.
Page 248 Telnet Commands Example The example shows the non-interactive 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...
Page 249: Snmpmibcapset
Telnet Commands snmpMibCapSet View and modify options for configuring SNMP MIB/Trap Capability. Synopsis snmpMibCapSet Availability admin Description This command enables a user to turn on or off certain MIBS and TRAPS. This command also enables a user to turn on or off group information and SSN in SW trap messages. It first displays current settings and then prompts the user to change the values for each parameter.
Page 250: Spinfab
Telnet Commands spinFab Test for Cascaded switch ISL links. Synopsis spinFab [ nMillionFrames [, ePortBeg [, ePortEnd [, setFail]]]] Availability admin Description Used to verify the intended functional operation of the ISL links between switches at the maximum speed of 2Gbps by setting up the routing hardware such that test frames received by each E_port retransmitted on the same E_port.
Page 251 Telnet Commands The last port to test. The test will be performed on ePortBeg to ePortEnd ePortEnd inclusive. If ePortEnd is omitted then the default will be to test all ports if ePortBeg is also omitted or to test only ePortBeg if it is specified. This operand is optional.
Page 252 Telnet Commands Example In the following examples ports 0-3 are active ISL links. Port 4 is an F_port so the test skips it. switch:admin> spinfab 3,0,4 spinFab running... spinFab: Completed 3 megs, status: passed. port 0 test status: 0x00000000 -- passed.
Page 253: Spinsilk
Telnet Commands spinSilk Functional test of port to port path at maximum switch speed. Synopsis spinSilk [nmegs, gbic_mode, lb_mode, spd_mode] Availability admin Description Use this command to verify the functional operation of the switch components. Note: The spinsilk command may not be executed on an operational switch. You must first disable the switch using the switchDisable command.
Page 254: Gbic Mode
Telnet Commands LoopBack Mode There are four loopback modes that can be used when executing the spinSilk command. The modes are specified by entering: • 0 for cable mode. This loopback mode is the default mode and tests only M->N connections. It requires that the user connect a cable from one port to a different port.
Page 255 Telnet Commands Operands This command has the following operands: Specify the number of million frames per port to execute this test. If omitted, the nmegs default value is 0xfffffffe. This operand is optional. Specify 1 to activate GBICmode, where only ports containing GBICs are tested. gbic_mode Specify 0 to deactivate GBICmode.
Page 256 Telnet Commands 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...
Page 257 Telnet Commands 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.
Page 258: Sramretentiontest
Telnet Commands 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 test method 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 259: Statstest
Telnet Commands statsTest Run a statistics counter diagnostic test. Synopsis statsTest Availability admin Description Use this command to run a statistics counter diagnostic test on a switch. This command may not be executed on an operational switch. You must first disable the switch using the switchDisable command.
Page 260: Supportshow
Telnet Commands 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.
Page 261 Telnet Commands Operands This command has the following operands: Specify the first port of a range of ports to dump information. The default (if no firstPort operand specified) is to print state of port 0. If only firstPort is specified, only information for firstPort is printed.
Page 262: Switchbeacon
Telnet Commands 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 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 263: Switchcfgspeed
Telnet Commands switchCfgSpeed Configure all ports of the switch to a particular speed level. Synopsis switchCfgSpeed speed_level Availability admin Description Use this command to configure the speed of all the ports on a switch to a particular level. The configuration is saved in the non-volatile memory and persists across switch reboot or power cycle. If the command is specified without an operand, you are prompted to enter the speed value.
Page 264: Switchcfgtrunk
Telnet Commands switchCfgTrunk Enable or disable trunking on all the ports of a switch. Synopsis switchCfgTrunk 0|1 Availability admin Description Use this command to enable or disable trunking on all the ports of a switch. Note: This command requires the Trunking license. Operands This command has the following operand: Specify 1 to enable trunking on all the ports on this switch.
Page 265: Switchdisable
Telnet Commands switchDisable Disable the switch. Synopsis switchDisable Availability admin Description Use this command to disable the switch. All Fibre Channel ports are taken offline; if the switch was part of a fabric, the remaining switches reconfigure. The switch must be disabled before making configuration changes (using configure or configDefault) or before running many of the diagnostic tests.
Page 266: Switchenable
Telnet Commands 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 267: Switchname
Telnet Commands switchName Display or set switch name. Synopsis switchName ["newName"] Availability All users (display) admin (set) Description Use this command without a 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 268: Switchshow
Telnet Commands 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. Below is the information provided. The first section provides switch summary information; it is followed by a section covering summary information by port.
Page 269 Telnet Commands No_Sync - module receiving light but out of sync In_Sync - module receiving light and in sync Laser_Flt - module signaling a laser fault Port_Flt - port marked faulty Diag_Flt - port failed diagnostics Lock_Ref - locking to the reference signal Testing - running diagnostics Online - port is up and running comment...
Page 270 Telnet Commands Example The following example shows a 16 port switch: sw14:admin> switchshow switchName: sw14 switchType: switchState: Online switchRole: Subordinate switchDomain: switchId: fffc02 switchWwn: 10:00:00:60:69:50:02:8f switchBeacon: port 0: id 2G No_Light port 1: id 2G No_Light port 2: id 2G No_Light port 3: id 2G No_Light port...
Page 271: Switchstatuspolicyset
Telnet Commands 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 272 Telnet Commands When PortStatus monitoring is set to values of (0,0), port status changes are not logged to the event log and console. Similarly, GBIC removal does not generate a message to the event log and console if MissingGBICs is set to (0,0). By configuring these options, the user can more closely monitor for port status and/or removal of GBICs.
Page 273: Switchstatuspolicyshow
Telnet Commands 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 non-operational units allowed for each contributor before triggering a status change in the switch.
Page 274 Telnet Commands 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 1-260 Fabric OS Reference...
Page 275: Switchstatusshow
Telnet Commands 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: •...
Page 276: Syslogdipadd
Telnet Commands syslogdIpAdd Add the IP address of a syslog daemon. Synopsis syslogdIpAdd IPaddress Availability admin Description Use this command to add the IP address of a syslog daemon, that is the IP address of the server which 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 277: Syslogdipremove
Telnet Commands syslogdIpRemove Remove the IP address of a syslog daemon. Synopsis syslogdIpRemove IPaddress Availability admin Description Use this command to remove the IP address of a syslog daemon, that is the IP address of the server which is running the syslogd process. Operands This command has the following operand: Specify the IP address of the server running syslogd.
Page 278: Syslogdipshow
Telnet Commands 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: 191.168.1.60 syslog.IP.address.2:...
Page 279: Tempshow
Telnet Commands tempShow Display temperature readings. Synopsis tempShow Availability All users Description Use this command to display the current temperature readings from each of the 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 280: Timeout
Telnet Commands timeOut Used to set or clear idle telnet connection timeout value. Synopsis timeOut [0 | minutes] Availability all users (display) admin (set/clear) Description This command changes the telnet timeout value used by the shell. The default value of zero means that telnet timeouts are disabled.
Page 281: Topologyshow
Telnet Commands 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. This includes: • 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 282 Telnet Commands Examples To display the unicast fabric topology: switch:admin> topologyShow Local Domain ID: 1 Domain Metric Hops Out Port In Ports Flags Name -------------------------------------------------------------- 1000 0x00002000 "sw25 0x00000000 0x00000000 1000 0x000000c4 "sw4" 2000 0x00002000 "sw10" 0x00000000 0x00000000 2000 0x00002000 "sw16"...
Page 283: Trackchangesset
Telnet Commands trackChangesSet Enables configuring of track-changes feature. Synopsis trackChangesSet [ 0|1 ], [ snmptrapmode ] Availability admin Description This command enables or disables the track-changes feature. An SNMP-TRAP mode can also be enabled. Trackable changes are: • Successful login •...
Page 284: Trackchangesshow
Telnet Commands trackChangesShow Displays status of track-changes Synopsis trackChangesShow Availability All users Description Use this command to display status of the track changes feature. It shows if the feature is turned on or off and if SNMP trap are generated. The output from the Track Changes feature is dumped to the error log for the switch.
Page 285: Trunkdebug
Telnet Commands trunkDebug Debug a trunk link failure. Synopsis trunkDebug port1, port2 Availability admin Description Use this command to debug a trunk link failure. This command reports one of the following messages based on the trunking properties of the two specified ports: •...
Page 286: Trunkshow
Telnet Commands trunkShow Display trunking information. Synopsis trunkShow Availability all users Description Use this command to display trunking information. The fields displayed are as follows: Trunking Group Number Displays each trunking group on a switch. All the ports that are part of this trunking group are displayed.
Page 287: Turboramtest
Telnet Commands turboRamTest Turbo SRAM logic test for 2Gb ASICs. Synopsis turboRamTest [passcount] Availability admin Description This command verifies the on chip SRAM located in the 2Gb ASIC using the Turbo-Ram BIST circuitry. These same SRAMS are tested by portRegTest and sramRetentionTest using PCI operations, but for this test the BIST controller is able to perform the SRAM write and read operations at a much faster rate.
Page 288 Telnet Commands The test flow for each SRAM is as follows: Fill RAM with alternating FFFF 0000 pattern. (Subtest 1: turboram memory fill) For each incrementing address read FFFF 0000 pattern and write 0000 FFFF. (Subtest 2: turbo-ram r-m-w inc 1) For each incrementing address read 0000 FFFF pattern and write FFFF 0000.
Page 289: Uptime
Telnet Commands 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 290 Telnet Commands Example To display the uptime for a switch: switch:admin> uptime Up for: 3 days, 18:35 Powered for: 30 days, 16:05 Last up at: Mon Mar 22 12:00:00 1999 Reason: Power-on See Also date errShow fastboot reboot 1-276 Fabric OS Reference...
Page 291: Urouteconfig
Telnet Commands uRouteConfig Configure a static route. Synopsis uRouteConfig port, domain, outputport 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 outputport is a usable port, all frames coming in from a specified port addressed to the specified domain are routed through the specified outputport.
Page 292: Urouteremove
Telnet Commands uRouteRemove Remove a static route. Synopsis uRouteRemove port, domainnumber Availability admin Description Use this command to remove a configured static route. When this command is issued, the route to the specified port and domain may not change. It does not change if the previous static route was along a minimum cost path.
Page 293: Urouteshow
Telnet Commands uRouteShow Display unicast routing information. Synopsis uRouteShow [port],[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 and routing task. The routing information describes how a frame, that is received from a port on the local switch, is to be routed to reach a destination switch.
Page 294 Telnet Commands Examples To display the unicast routing information: switch:admin> uRouteShow Local Domain ID: 1 In Port Domain Out Port Metric Hops Flags Next(Dom,Port) -------------------------------------------------------------------- 1000 Type <CR> to continue, Q<CR> to stop: 1000 Type <CR> to continue, Q<CR> to stop: 1000 Type <CR>...
Page 295: Version
Telnet Commands version Display firmware version information. Synopsis version Availability All users Description Use this command to display firmware version information and build dates. The following 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 296: Zoneadd
Telnet Commands zoneAdd Add a member to the zone. Synopsis zoneAdd "zoneName", "member;member" Availability admin Description Use this command to add one or more members to an existing zone. Operands The following operands are required: Name for the existing zone, in quotation marks. zoneName List of members to be added, in quotation marks, separated by semi-colons.
Page 297: Zonecreate
Telnet Commands zoneCreate Create a zone. Synopsis zoneCreate "zoneName", "member;member" Availability admin Description Use this command to create a new zone. A zone name is a C-style name beginning with a letter and followed by any number of letters, digits, and underscore characters. Names are case sensitive, for example “Zone_1” indicates a different zone than “zone_1”.
Page 298 Telnet Commands Name for a zone to be created, in quotation marks. This name cannot be used for zoneName any other zone object. List of members to be included in zone, in quotation marks, separated by member semi-colons. Can be one or more of the following: •...
Page 299: Zonedelete
Telnet Commands zoneDelete Delete a zone. Synopsis zoneDelete "zoneName" Availability admin Description Use this command to delete a zone. Operands This command has the following operands: Name of the zone to be deleted, in quotation marks. This operand is required. zoneName Example To delete the zone “Blue_zone”:...
Page 300: Zoneremove
Telnet Commands zoneRemove Remove a member from a zone. Synopsis zoneRemove "zoneName", "member;member" Availability admin Description Use this command to remove one or more members from an existing zone. The member list is located by an exact string match, therefore, it is important to maintain the order when removing multiple members.
Page 301: Zoneshow
Telnet Commands zoneShow Display zone information. Synopsis zoneShow [pattern] Availability All users Description Use this command to display zone configuration information. If no parameters are specified, all zone configuration information (both defined and enabled) is displayed. See cfgShow for a description of this display. If a parameter is specified, it is used as a pattern to match zone configuration names, and those that match in the defined configuration are displayed.
Page 302 Telnet Commands 1-288 Fabric OS Reference...
Page 303: System Error Message Formats
Chapter Error Messages This chapter explains the Fabric OS error message format and possible errors, including: • System Error Message Formats page 2-1 • Displaying Error Messages Using Telnet page 2-2 • Resetting Bad Ports page 2-3 • Post Test Commands page 2-3 •...
Page 304: Displaying Error Messages Using Telnet
Error Messages The display halts after each error is displayed, prompting you to either press <Enter> to continue or type a Q to quit. Continue pressing Enter until the prompt (=>) is displayed. In Figure 4-1, Error 02 represents a system error and Error 01 represents a diagnostic error (error number #004). Only diagnostic errors are assigned error numbers.
Page 305: Resetting Bad Ports
Error Messages Resetting Bad Ports If any port fails during a diagnostic test, it is marked BAD in the status display. To retest a port which has been marked BAD, clear the port and set to OK using the diagClearError command. This command clears the port status only and does not clear the logs or change the port’s condition.
Page 306: Diagnostic Test Failure And Recovery Actions
Error Messages Diagnostic Test Failure and Recovery Actions The table below lists what actions to perform if the switch fails any of the diagnostic tests. Note: If you run the portStatsShow or the diagShow command prior to running an individual test, errors may appear as a result of the normal synchronization process.
Page 307 Error Messages Table 2-3 Error Message Numbers (Continued) Error Number Test Name Error Name 0110 ramTest * DIAG-MEMORY 0111 DIAG-MEMSZ 0112 DIAG-MEMNULL 0415 portRegTest * DIAG-REGERR 0416 DIAG-REGERR_UNRST 040F DIAG-BUS_TIMEOUT 1020 centralMemoryTest * DIAG-CMBISRTO 1021 DIAG-CMBISRF 1025 DIAG-LCMRS 1026 DIAG-LCMTO 1027 DIAG-LCMEM 1028...
Page 308 Error Messages Table 2-3 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...
Page 309 Error Messages Table 2-3 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...
Page 310 Error Messages Table 2-3 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...
Page 311: Diagnostic Error Messages
Error Messages Diagnostic Error Messages This section provides information on the probable cause of a diagnostic error and what actions to take. Table 2-4 Diagnostic Error Messages Message Description Probable Cause Action DIAG-BADINT Port received an unexpected interrupt ASIC failure Replace mainboard assembly Err#1030, 2030...
Page 312 Error Messages Table 2-4 Diagnostic Error Messages (Continued) Message Description Probable Cause Action DIAG-CMERRTYPE Port got the wrong CMEM error type ASIC failure Replace mainboard assembly Err#102A [centralMemoryTest] DIAG-CMICKSUM CMI message received failed bad ASIC or mainboard Replace mainboard checksum test failure assembly Err#2036...
Page 313 Error Messages Table 2-4 Diagnostic Error Messages (Continued) Message Description Probable Cause Action DIAG-ERRSTAT Port Error Statistics counter is non-zero, ASIC, mainboard, Replace mainboard meaning an error was detected when SFP module or fiber assembly, SFP Err#2640-2647, 3040-3047, receiving frames. cable failure module or fiber 3840-3847...
Page 314 Error Messages Table 2-4 Diagnostic Error Messages (Continued) Message Description Probable Cause Action DIAG-LCMRS Central Memory Read Short: M bytes ASIC failure Replace mainboard requested but not received assembly Err#1F25, 1025 [centralMemoryTest, cmemRetentionTest] DIAG-LCMTO Central Memory Timeout: Data transfer ASIC failure Replace mainboard initiated did not complete within the assembly...
Page 315 Error Messages Table 2-4 Diagnostic Error Messages (Continued) Message Description Probable Cause Action DIAG-PORTSTOPPED Port is no longer transmitting, as ASIC, GBIC module Replace mainboard indicated by the Number Of Frames or fiber cable failure assembly, GBIC Err#3874 Transmitted counter being stuck at N module or fiber [spinSilk] frames...
Page 316: System Error Messages
Error Messages System Error Messages This section provides information on the probable cause of a system error and what actions to take. Table 2-5 System Error Messages Message Description Probable Cause Action ASIC, MINI_BUFFER, ASIC Failure Bad main board Contact HP technical LOG_WARNING support CONFIG CORRUPT...
Page 317 Error Messages Table 2-5 System Error Messages (Continued) Message Description Probable Cause Action FCPH, EXCHBAD, L, S Bad exchange OS error Contact HP technical support FCPH, EXCHFREE, L, S Unable to free an exchange OS error Contact HP technical support FLANNEL, PHANTOM, Port’s PLT limit exceeded OS error...
Page 318 Error Messages Table 2-5 System Error Messages (Continued) Message Description Probable Cause Action LSDB, NOLSR, LOG_WARNING No Link State Record for OS error Contact HP technical domain support MCAST, ADDBRANCH, Add Branch failed OS error Contact HP technical LOG_ERROR support MCAST, ADDPORT, Add Port failed OS error...
Page 319 Error Messages Table 2-5 System Error Messages (Continued) Message Description Probable Cause Action PANIC, INTCONTEXT, Data out of sync OS error Contact HP technical LOG_PANIC support PANIC, ZOMTIMSET, Attempt to set a zombie OS error Contact HP technical LOG_PANIC timer support PANIC, ZOMTIMKILL, Zombie timer destroyed...
Page 320 Error Messages Table 2-5 System Error Messages (Continued) Message Description Probable Cause Action SYS, INTRPT, LOG_CRITICAL Bad system interrupt OS error Contact HP technical support SYS, FLASHRD, LOG_ERROR FLASH memory read error OS error Contact HP technical support SYS, FLASHWR, LOG_ERROR FLASH memory write error OS error Contact HP technical support TEMP, 1_FAILED,...
Page 321: Fabric Watch Error Messages
Error Messages Fabric Watch Error Messages Below are six sample Fabric Watch error messages. The threshold name in the first error message is fopportState003. The threshold label in the first error message is (FOP Port State Changes 3). 0x1003f2d0 (tThad): May 22 19:20:23 Error FW-BELOW, 3, fopportState003 (FOP Port State Changes 3) is below low boundary.
Page 322 Error Messages The table below explains the threshold and area abbreviations used in Fabric Watch error messages. Table 2-6 Fabric Watch Threshold Class and Area Abbreviations Class Name: Class Abbreviation Area Name: Area Abbreviation Environment: env Power supply: Ps Temperature (sensor): Temp Fan speed sensor: Fan Gigabit Interface Converter: gbic Temperature (sensor): Temp...
Page 323: Zoning Commands
Chapter Licensed Telnet Commands This chapter summarizes the commands that are only available with a license key. • Zoning Commands page 3-1 • QuickLoop Commands page 3-2 • QuickLoop Fabric Assist Mode Commands page 3-3 • Extended Fabric Command page 3-3 •...
Page 324: Quickloop Commands
Licensed Telnet Commands Table 3-1 Zoning Commands (Continued) Command Description zoneShow Show zone information. QuickLoop Zoning qloopAdd Add a member to a QuickLoop. qloopCreate Create a QuickLoop. qloopDelete Delete a QuickLoop. qloopRemove Remove a member from a QuickLoop. qloopShow Show QuickLoop information. Zone Configuration cfgAdd Add a zone to a zone configuration.
Page 325: Quickloop Fabric Assist Mode Commands
Licensed Telnet Commands Table 3-2 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 QuickLoop Fabric Assist Mode Commands The following commands are for QuickLoop Fabric Assist Mode. For detailed information about QuickLoop Fabric Assist refer to the QuickLoop User’s Guide.
Page 326: Fabric Watch Commands
Licensed Telnet Commands Fabric Watch Commands The following commands are available with the standard Fabric Watch license key. For detailed information about Fabric Watch refer to the Fabric Watch User’s Guide. Table 3-5 Fabric Watch Commands Command Description fwClassInit Initializes all classes under Fabric Watch. fwConfigReload Reloads the Fabric Watch configuration.
Page 327: Trunking Commands
Licensed Telnet Commands Trunking Commands The following commands are available with the purchase of a Trunking license key. For more detailed information about trunking refer to the ISL Trunking User’s Guide. Table 3-7 Trunking Commands Command Description portCfgTrunkport Configure a port for trunking. switchCfgTrunk Configure a switch for trunking.
Page 328 Licensed Telnet Commands Table 3-8 Performance Monitoring Commands Command Description perfDelFilterMonitor Delete a filter-based monitor. perfHelp Display performance monitoring help information. perfSetPortEEMask Set overall mask for end-to-end (EE) monitors. perfShowAlpaCrc Display the ALPA CRC count by port or by ALPA. perfShowEEMonitor Display user-defined end-to-end monitors on a port.
Page 329 Glossary 8b/10b An encoding scheme that converts each 8-bit byte into 10 bits. Used to balance Encoding ones and zeros in high-speed transports. Address A 24-bit or 8-bit value used to identify the source or destination of a frame. Identifier Advanced A software product that provides error and performance information to the Performance...
Page 330 Bit Error Rate; the rate at which bits are expected to be received in error. Expressed as the ratio of error bits to total bits transmitted. See also Error. Block As applies to Fibre Channel, upper-level application data that is transferred in a single sequence.
Page 331 Disparity The relationship of ones and zeros in an encoded character. “Neutral disparity” means an equal number of each, “positive disparity” means a majority of ones, and “negative disparity” means a majority of zeros. Distributed The combined user’s guides for the software products Extended Fabrics and Fabrics Remote Switch.
Page 332 Fabric A software product that works in conjunction with Web Tools to provide a Manager graphical user interface for managing switch groups as a single unit, instead of as separate switches. Fabric Manager is installed on and run from a computer workstation.
Page 333 FSPF Fabric Shortest Path First. Routing protocol for Fibre Channel switches. Full-duplex A mode of communication that allows the same port to simultaneously transmit and receive frames. See also Half-duplex. Fx_Port A fabric port that can operate as either an F_Port or FL_Port. See also F_Port, FL_Port.
Page 334 JBOD Just a Bunch Of Disks; indicates a number of disks connected in a single chassis to one or more controllers. See also RAID. K28.5 A special 10-bit character used to indicate the beginning of a transmission word that performs Fibre Channel control and signaling functions. The first seven bits of the character are the comma pattern.
Page 335 Multimode A fiber optic cabling specification that allows up to 500 meters between devices. N_Port Node Port; a port on a node that can connect to a Fibre Channel port or to another N_Port in a point-to-point connection. See also NL_Port, Nx_Port. Name Server Frequently used to indicate Simple Name Server.
Page 336 Private Device A device that supports arbitrated loop protocol and can interpret 8-bit addresses, but cannot log into the fabric. Private Loop An arbitrated loop that does not include a participating FL_Port. Protocol A defined method and a set of standards for communication. Public An NL_Port that logs into the fabric, can function within either a public or a NL_Port...
Page 337 Sequence Initiative. Single Mode The fiber optic cabling standard that corresponds to distances of up to 10 km between devices. SNMP Simple Network Management Protocol. An internet management protocol that uses either IP for network-level functions and UDP for transport-level functions, or TCP/IP for both.
Page 338 U_Port Universal Port; a switch port that can operate as a G_Port, E_Port, F_Port, or FL_Port. A port is defined as a U_Port when it is not connected or has not yet assumed a specific function in the fabric. User Datagram Protocol; a protocol that runs on top of IP and provides port multiplexing for upper-level protocols.
Page 339 Index 1-56 diagShow 3-11 DiscC3 agtcfgDefault displaying error messages agtcfgSet 1-58 dlsReset agtcfgShow 1-59 dlsSet aliasShow 1-60 dlsShow 3-11 BadEOF 3-11 Enc_in 3-11 BadOrdSet 3-11 Enc_out 1-14 bcastShow 1-61 errDisplayFilter 1-283 broadcast zone 1-62 errDump error message numbers error messages, displaying 1-63, 3-1 errShow 1-170...
Page 340 1-93 1-135 h command nbrStateShow 1-94 1-134 help nbrStatsClear 1-136 nsAllShow 1-137 nsShow 1-95 i command 1-97 ifModeSet 1-98 1-139 ifModeShow parityCheck 1-99 1-140 ifShow passwd 1-100 1-170 interfaceShow portCfgLongDistance 1-105 1-172 iodReset portCfgMcastLoopback 1-106 1-178 iodSet portDisable 1-107 1-179 iodShow portEnable 1-108...
Page 341 1-215 qlShow 1-217 qlStatsShow xiii technical support 1-218 quietMode telnet commands xiii supportShow command 1-265 tempShow 1-266 timeOut 1-219 ramTest 1-267 topologyShow 1-221 reboot 1-269 trackChangesSet resetting bad ports 3-11 TruncFrm 1-222 routeHelp 1-275 uptime 1-223 setGbicMode 1-277 uRouteConfig 1-224 setSplbMode 1-278 uRouteRemove...
Page 342 Index-4 Fabric OS Reference...

This manual is also suitable for:

Fabric os Storageworks fc entry switch 8b

HP StorageWorks 8B - FC Entry Switch Reference Manual

Chapter 1 Telnet Commands

Chapter 2 Error Messages

Chapter 3 Licensed Telnet Commands

Quick Links

Related Manuals for HP StorageWorks 8B - FC Entry Switch

Summary of Contents for HP StorageWorks 8B - FC Entry Switch