reference guide hp StorageWorks fabric OS version 3.1.x/4.1.x Product Version: 3.1.x and 4.1.x Third Edition (June 2003) Part Number: AA–RS24C–TE This reference guide provides a detailed description of the Fabric OS commands. Although this guide is primarily about 4.1.x, it also covers 3.1.x that runs on the StorageWorks SAN Switch 2/16, 2/16 power pak, 2/8-EL, and 2/8 power pack switches.
© Copyright 1999-2003 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
contents Contents About this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents bcastShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 bladeBeacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 bladeDiag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 bladeDiagShort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents diagClearError . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . diagCommandShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . diagDisablePost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . diagEnablePost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents fanDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . fanEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . fanShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . fashow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents hadump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . haEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . haFailover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . haShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents msPlatShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . msPlClearDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . msPlMgmtActivate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . msPlMgmtDeactivate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents perfShowEEMonitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . perfShowFilterMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . perfShowPortEEMask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . pkicreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents portStatsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . portswap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . portswapdisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . portswapenable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents secmodeenable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . secmodeshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . secnonfcspasswd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . secpolicyabort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents stopporttest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . supportShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . switchBeacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . switchcfgpersistentdisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents uRouteRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . uRouteShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . wwn. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Glossary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .945 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .977 Tables 1 Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 2 Configure Command Fabric Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
about this guide About this Guide This reference guide provides information to help you: ■ Understand and use Fabric commands About OS this Guide ■ Manage a switch or fabric ■ Contact technical support for additional assistance “About this Guide” topics include: ■ Overview, page 16 ■ Conventions, page 17 ■ Getting Help, page 19 Fabric OS Version 3.1.x/4.1.
About this Guide Overview This section covers the following topics: ■ Intended Audience ■ Related Documentation Intended Audience This book is intended for use by administrators who are experienced with the following: ■ StorageWorks Fibre Channel SAN switches ■ Fabric Operating System V3.1.x or later Related Documentation For a list of related documents included with this product, see the Related Documents section of the Release Notes that came with your switch.
About this Guide Conventions Conventions consist of the following: ■ Document Conventions ■ Text Symbols Document Conventions The document conventions included in Table 1 apply in most cases.
About this Guide Note: Text set off in this manner presents commentary, sidelights, or interesting points of information. 18 Fabric OS Version 3.1.x/4.1.
About this Guide Getting Help If you still have a question after reading this guide, contact an HP authorized service provider or access our website: http://www.hp.com. HP Technical Support Telephone numbers for worldwide technical support are listed on the following HP website: http://www.hp.com/support/. From this website, select the country of origin. Note: For continuous quality improvement, calls may be recorded or monitored.
About this Guide HP Authorized Reseller For the name of your nearest HP authorized reseller: 20 ■ In the United States, call 1-800-345-1518 ■ In Canada, call 1-800-263-5868 ■ Elsewhere, see the HP website for locations and telephone numbers: http://www.hp.com. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands 1 This chapter lists the Fabric OS commands. It also shows their syntax and operands, and provides examples of their usage. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands agtcfgDefault Reset the SNMP agent configuration to default values. Synopsis agtcfgDefault Availability AdminAdmin Release V3.1.x and V4.1.x Description Use this command to reset the configuration of the SNMP agent to default values. Note: In the StorageWorks Core switch, there is one SNMP agent per logical switch. This command is specific to the logical switch you are logged into. The following values are reset to default: 22 sysDescr The system description.
agtcfgDefault swEventTrapLevel The event trap level in conjunction with the event's severity level. When an event occurs and if its severity level is at or below the set value, the SNMP trap, swEventTrap, is sent to configured trap recipients. By default, this value is set at 0, implying that no swEventTrap is sent.
Fabric OS Commands There are six Access Control Lists (ACLs) to restrict SNMP get/set/trap operations to hosts under a host-subnet-area. Host-subnet-area is defined by comparing non-zero IP octets. For example, an ACL of “192.168.64.x” enables access for any hosts that start with the specified octets. The connecting host is enabled as “192.168.64.xx,” where xx is any number from 0 to99. All ACL entries also have a flag to set each host-subnet-area to be read-write or read-only.
agtcfgDefault SNMPv1 community and trap recipient configuration: Community 1: Secret C0de (rw) Trap recipient: 192.168.15.41 Community 2: OrigEquipMfr (rw) No trap recipient configured yet Community 3: private (rw) No trap recipient configured yet Community 4: public (ro) No trap recipient configured yet Community 5: common (ro) No trap recipient configured yet Community 6: FibreChannel (ro) No trap recipient configured yet SNMP access list configuration: Entry 0: Access host subnet area 192.168.64.
Fabric OS Commands agtcfgSet Modify the SNMP agent configuration. Synopsis agtcfgSet Availability Admin Release V3.1.x and V4.1.x Description Use this command to modify the configuration of the SNMP agent in the switch. Note: In the StorageWorks Core switch, there is one SNMP agent per logical switch. This command is specific to the logical switch you are logged into. Set the values for the following items: 26 sysDescr The system description. The default value is Fibre Channel Switch.
agtcfgSet swEventTrapLevel The event trap level in conjunction with the event's severity level. When an event occurs and if its severity level is at or below the set value, the SNMP trap, swEventTrap, is sent to configured trap recipients. By default, this value is set at 0, implying that no swEventTrap is sent.
Fabric OS Commands ACL entries also have a flag to set each host-subnet-area to be read-write or read-only. Highest privilege matched out of six entries is given to the access. An ACL check is turned off when all six entries contain “0.0.0.0.” Note: When secure mode is enabled, the Access Control List feature is incorporated into the WSNMP and RSNMP security policies. Community strings can be changed on the primary FCS switch only and will propagate changes across the fabric.
agtcfgSet Example To modify the SNMP configuration values in V3.1.x: switch:admin> agtcfgSet Customizing MIB-II system variables ... At each prompt, do one of the following: o to accept current value, o enter the appropriate new value, o to skip the rest of configuration, or o to cancel any change.
Fabric OS Commands To modify the SNMP configuration values in V4.1.x: switch:admin> agtcfgSet Customizing MIB-II system variables ... At each prompt, do one of the following: o to accept current value, o enter the appropriate new value, o to skip the rest of configuration, or o to cancel any change.
agtcfgSet authTraps = 0 (OFF) SNMPv1 community and trap recipient configuration: Community 1: Secret C0de (rw) Trap recipient: 192.168.15.
Fabric OS Commands agtcfgShow Displays the SNMP agent configuration. Synopsis agtcfgShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the configuration of the SNMP agent in the switch. Note: In the StorageWorks Core switch, there is one SNMP agent per logical switch. This command is specific to the logical switch you are logged into. The following information is displayed: 32 sysDescr The system description. The default value is Fibre Channel Switch.
agtcfgShow swEventTrapLevel The event trap level in conjunction with the event's severity level. When an event occurs and if its severity level is at or below the set value, the SNMP trap, swEventTrap, is sent to configured trap recipients. By default, this value is set at 0, implying that no swEventTrap is sent.
Fabric OS Commands There are six ACL (Access Control List) to restrict SNMP get/set operations to hosts under a host-subnet-area. Host-subnet-area is defined by comparing non-zero IP octets. For example, an ACL of “192.168.64.x” enables access for any hosts that start with the specified octets. The connecting host is enabled as “192.168.64.xx,” where xx is any number from 0 to 99. All ACL entries also have a flag to set each host-subnet-area to be read-write or read-only.
agtcfgShow Example To display SNMP agent configuration information: switch:admin> agtcfgShow Current SNMP Agent Configuration Customizable MIB-II system variables: sysDescr = FC Switch sysLocation = End User Premise sysContact = Field Support. swEventTrapLevel = 3 authTraps = 1 (ON) SNMPv1 community and trap recipient configuration: Community 1: Secret C0de (rw) Trap recipient: 192.168.1.51 Community 2: OrigEquipMfr (rw) Trap recipient: 192.168.1.
Fabric OS Commands aliasDelete Delete a port from all local groups. Synopsis aliasDelete portID Availability Admin Release V4.1.x Description Use this command to delete a local port from all local alias groups. A group is automatically deleted if it becomes empty after deleting the local port. Use the aliasShow command to show the existing groups with their corresponding N_Ports. Operands This command has the following operand: portID Specify the port ID (in hexadecimal) to be deleted from an alias group.
aliasDelete Exit Status 0 Indicates successful operation. Non Zero Indicates that the operation has failed. See Also aliasJoin aliasShow fabricShow switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands aliasJoin Create or add a member to a group of N_Ports. Synopsis aliasJoin Availability Admin Release V4.1.x Description Use this command to create an alias group of N_Ports or to add N_Ports to an existing group. Any online N_Port defined in the fabric can be part of a group. An N_Port can be added from any switch that is part of the fabric. This command is interactive, and prompts you to enter data to create or add to the alias group.
aliasJoin Example To create an alias group of N_Ports or to add N_Ports to an existing group enter the following command. switch:admin> aliasJoin aliasJoin: To add ports to an existing or new multicast group Number of ports in the group: (1..64) [1] To set an authorization password? (yes, y, no, n): [no] no password Setting the authorization control Add control: 0 by any, 1 only itself, 2 by creator: (0..2) [0] Del control: 0 by any, 1 only itself, 2 by creator: (0..
Fabric OS Commands aliasPurge Remove an alias group. Synopsis aliasPurge groupID Availability Admin Release V4.1.x Description Use this command to remove an alias group. The alias group must be identified by its hexadecimal value. Operands This command has the following operand: groupID Specify in hexadecimal the alias group to be removed. This operand is required.
aliasPurge See Also aliasJoin aliasShow fabricShow switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands aliasShow Displays local alias server information. Synopsis aliasShow Availability All users. Release V3.1.x and V4.1.x 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. The following fields are displayed: Alias ID (V3.1.
aliasShow Operands None. Example The following example is for V3.1.x: switch:admin> aliasShow The Local Alias Server has 1 entry Alias ID Creator Token [rb, type, grptype, qlfr] Member List fffb01 fffffd [40, 05, 10, 60000010 12000069] {021200 020800} The following example is for V4.1.
Fabric OS Commands aliAdd Add a member to a zone alias. Synopsis aliAdd “aliName”,”member;member” Availability Admin Release V3.1.x and V4.1.x Description Use this command to add one or more members to an existing zone alias. The alias member list cannot contain another zone alias. This command changes the Defined Configuration. For the change to be preserved across switch reboots, it must be saved to non-volatile memory using the cfgSave command.
aliAdd Operands This command has the following operands: aliName Specify the name of a zone alias in quotation marks. This operand is required. member Specify a member or list of members to be added to the alias, in quotation marks, separated by semicolons. An alias member can be specified by one or more of the following methods: ■ For V3.1.x, a switch domain and physical port number pair. ■ For V4.1.x, a switch domain and port area number pair.
Fabric OS Commands aliCreate Create a zone alias. Synopsis aliCreate “aliName”,”member;member” Availability Admin Release V3.1.x and V4.1.x Description Use this command to create a new zone alias. The zone alias member list must have at least one member (empty lists are not allowed). The alias member list cannot contain another zone alias. Refer to the zonecreate command for more information on name and member specifications.
aliCreate Operands This command has the following operands: aliName Specify a name for the zone alias in quotation marks. This operand is required. A zone alias name must begin with a letter and can be followed by any number of letters, digits, and underscore characters (up to a maximum of 64 characters). Names are case-sensitive, for example, “Ali_1” and “ali_1” are different zone aliases. Blank spaces are ignored. This operand is required.
Fabric OS Commands See Also aliAdd aliDelete aliRemove aliShow 48 Fabric OS Version 3.1.x/4.1.
aliDelete aliDelete Delete a zone alias. Synopsis aliDelete “aliName” Availability Admin Release V3.1.x and V4.1.x Description Use this command to delete a zone alias. This command changes the Defined Configuration. For the change to be preserved across switch reboots, it must be saved to non-volatile memory using the cfgSave command. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command. Note: This command requires an Advanced Zoning License.
Fabric OS Commands Example To delete the zone alias array2: switch:admin> aliDelete “array2"“ See Also aliAdd aliCreate aliRemove aliShow 50 Fabric OS Version 3.1.x/4.1.
aliRemove aliRemove Remove a member from a zone alias. Synopsis aliRemove “aliName”,”member;member” Availability Admin Release V3.1.x and V4.1.x Description Use this command to remove one or more members from an existing zone alias. If all members are removed, the zone alias is deleted. This command changes the Defined Configuration. For the change to be preserved across switch reboots, it must be saved to non-volatile memory using the cfgSave command.
Fabric OS Commands Operands This command has the following operands: aliName Specify the name of the zone alias to have members removed in quotation marks. This operand is required. member Specify a member or list of members to be removed from the alias, in quotation marks, separated by semicolons. An alias member can be specified by one or more of the following methods: ■ For V3.1.x, a switch domain and physical port number pair. ■ For V4.1.x, a switch domain and port area number pair.
aliShow aliShow Displays zone alias information. Synopsis aliShow “pattern” Availability All users. Release V3.1.x and V4.1.x Description Use this command to display zone configuration information. If a parameter is specified, it is used as a pattern to match zone alias names; those that match in the defined configuration are displayed. Note: This command requires an Advanced Zoning License. When security is enabled, this command can only be issued from the Primary FCS switch.
Fabric OS Commands Operands This command has the following operands: pattern A POSIX style regular expression used to match zone alias names. This operand must be enclosed in quotation marks. Patterns may contain: ■ Question mark (?) that matches any single character ■ Asterisk (*) that matches any string of characters ■ Ranges that match any character within the range. Ranges must be enclosed in brackets, for example, [0-9] or [a-f] This operand is optional. mode (V4.1.
backplanetest backplanetest Backplane connection test for multiple blade configured system. Synopsis backplanetest [-slot number][-passcnt count][-payload value][-pat type][-ports list][-verbose mode] Availability Admin Release V4.1.x Description Use this command to verify the function of the backplane connection of the blades through the backend external ports. This command is for the StorageWorks Core switch only.
Fabric OS Commands 56 -payload value Specify the byte size of the test frame payload. The payload size must be in multiples of 4 and the minimum size is 16. The default value is 512 bytes. This operand is optional. -pat type Specify the test pattern type used in the test frame payload. The default test is 17(jCRPAT).
backplanetest Examples Test backplane connections on a StorageWorks Core switch: switch:admin> backplanetest -ports 1/16, 18, 20 -payload 2048 -verbose 1 Running Backplane Conn Test .....
Fabric OS Commands backPort Test for back-end miniswitch to miniswitch links. Synopsis backport [-nframes num][-ports list][-lb_mode mode] [-fr_type type][-extonly enable] Availability Admin Release V4.1.x Description Use this command to test the backplane routing and VC allocation. This test applies to single blade as well as multi-blade systems. The following items are tested: ■ Proper back-end port domain routing setup such that every user port has a valid path to every other user port.
backPort ■ ASIC errors along each path. The test will check for CRC and ENC errors for each port used between the source and destination ports to help isolate failures. It will also check that each member of every trunk group along the path has sent or received at least one frame. Note: Area routing between user ports is not tested. Operands This command has the following operands: -nframes num Specify the number of frame sequences to send. The default value is 100.
Fabric OS Commands -extonly enable Specify 1 to enable external test only mode. The default value is 0. This command normally sends bursts of frames from each port under test to every other port in the list. In extonly mode, backPort will send only one burst of frames to each port from each miniswitch to miniswitch link. This tests all of the external connections with only (K*N) frames instead of the N2 frames required in the all to all mode.
backPort See Also crossporttest portloopbacktest spinsilk spinfab Fabric OS Version 3.1.x/4.1.
Fabric OS Commands backSpace Set an alternate backspace character. Synopsis backSpace [mode] Availability All users (display). Admin (modify). Release V3.1.x 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: mode Specify 0 to use the standard backspace character (BACKSPACE). Specify 1 to use the alternate backspace character (DEL).
bannerset bannerset Set the banner on the local switch. Synopsis bannerset [banner] Availability Admin Release V3.1.x and V4.1.x Description Use this command to set the banner on the local switch. The banner is a string of alphanumeric characters. It is displayed whenever a user tries to log into a switch. The banner can be created using the banner operand or by entering the bannerset command without an operand, making the session interactive.
Fabric OS Commands Examples To set a new banner for a switch: switch:admin> bannerset “my banner” Please input context of security banner (press “.” RETURN at the beginning of a newline to finish input): Do not log into this switch if you are not an authorized administrator. . switch:admin> See Also bannershow 64 Fabric OS Version 3.1.x/4.1.
bannershow bannershow Displays the banner text. Synopsis bannershow Availability Admin Release V3.1.x and V4.1.x Description Use this command to display the contents of the banner. Operands None. Examples To display the banner for a switch: switch:admin> bannershow Banner: Do not log into this switch if you are not an authorized administrator. switch:admin> See Also bannerset Fabric OS Version 3.1.x/4.1.
Fabric OS Commands bcastShow Displays broadcast routing information. Synopsis bcastShow Availability All users. Release V3.1.x and V4.1.x 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. Normally, all F_Ports and FL_Ports are members of the broadcast distribution tree.
bcastShow Note: The output from this command varies depending on switch type. Operands None. Examples To display the broadcast routing information for all ports in the switch: switch:admin> bcastShow Group Member Ports Member ISL Ports Static ISL Ports ---------------------------------------------------------------256 0x00012083 0x00002080 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 switch:admin> See Also mcastShow portRouteShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands bladeBeacon Set blade beaconing mode on or off. Synopsis bladeBeacon [slotnumber] mode Availability Admin Release V4.1.x Description Use this command to set the blade beaconing mode on or off. Specify mode 1 to enable beaconing mode or specify mode 0 to disable beaconing. Note: This command is only available on the StorageWorks Core switch. When beaconing mode is enabled, the port LEDs will flash amber in a running pattern from port 0 through port 15 and back again.
bladeBeacon Operands This command has the following operands: slotnumber Specify the slot number on which to enable bladeBeacon. mode Specify a value of 1 to set beaconing mode ON. Specify a value of 0 to set beaconing mode OFF. This operand is required. Example To turn the blade in slot 2 beaconing mode ON and then OFF: switch:admin> bladeBeacon 2 1 switch:admin> bladeBeacon 2 1 See Also switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands bladeDiag Run diagnostics on a switch blade. Synopsis bladediag [[--slot] slotno][-log logfile] Availability Admin Release V4.1.x Description Use this command to run a suite of diagnostics tests on the specified switch blade. To run this command, you must install loopback plugs on every port.
bladeDiag Note: To run this command, you must disable the entire switch with the switchdisable command. Compared to bladediagshort, this is a comprehensive test for blade functionality which also involves backplane connections. Options This command has the following operands: [--slot] slotno Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required.
Fabric OS Commands To run a suite of diagnostics: switch:admin> bladediag --slot 1 Testing slot: 1, user ports: 0 1 2 3 4 5 6 7 8 9 10 ...... PortRegTest Running Port Register Test .... passed. Test Complete: "portregtest" Pass 1 of 1 Duration 0 hr, 2 min & 14 sec (0:2:14:655). passed. Test return status: 0 CentralMemoryTest Running centralmemorytest ............ passed. Test Complete: "centralmemorytest" Pass 1 of 1 Duration 0 hr, 0 min & 18 sec (0:0:18:415). passed.
bladeDiagShort bladeDiagShort Run diagnostics on a switch blade. Synopsis bladediagshort [[--slot] slotno][-log logfile] Availability Admin Release V4.1.x Description Use this command to run a suite of diagnostics tests on the specified switch blade. To run this command you must install loopback plugs on every port.
Fabric OS Commands Note: To run this command, you must disable the entire switch with the switchdisable command. Compared to bladediag, this is a limited test for single blade functionality, which does not involve backplane connections. Options This command has the following operands: 74 [--slot] slotno Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required.
bladeDiagShort Example To run a suite of diagnostics on blade 1: switch:admin> bladediagshort --slot 1 Testing slot: 1, user ports: 0 1 2 3 4 5 6 7 8 9 10 ...... PortRegTest Running Port Register Test .... passed. Test Complete: "portregtest" Pass 1 of 1 Duration 0 hr, 2 min & 14 sec (0:2:14:655). passed. Test return status: 0 CentralMemoryTest Running centralmemorytest ............ passed. Test Complete: "centralmemorytest" Pass 1 of 1 Duration 0 hr, 0 min & 18 sec (0:0:18:415). passed.
Fabric OS Commands See Also backport bladediag camtest centralmemorytest cmitest crossporttest diagshow filtertest portloopbacktest portregtest spinsilk statstest txdpath 76 Fabric OS Version 3.1.x/4.1.
bladedisable bladedisable Disable a blade. Synopsis bladedisable [slotnumber] Availability Admin Release V4.1.x Description Use this command to disable a blade. All Fibre Channel ports are taken offline. If the switch was connected to a Fabric through this blade, the remaining switches reconfigure, and this switch will configure based on the other blade ports. A blade must be disabled before making configuration changes or before running many of the diagnostic tests.
Fabric OS Commands Example Disable a blade in slot 2: switch:admin> bladedisable 2 See Also switchshow bladeenable portdisable protenable 78 Fabric OS Version 3.1.x/4.1.
bladeenable bladeenable Enable a blade. Synopsis bladeenable [slotnumber] Availability Admin Release V4.1.x Description Use this command to enable a blade. All Fibre Channel ports within the blade which did not fail POST are enabled. These ports may come online if connected to a device, or remain offline if disconnected. The switch may need to be enabled if it was previously disabled to make configuration changes or to run diagnostics. If the switch is connected to a Fabric, it rejoins the Fabric.
Fabric OS Commands Example Enable a blade in slot 2: switch:admin> bladeenable 2 10 9 8 7 6 5 4 3 2 1 fabric Principal switch See Also switchshow bladedisable portdisable portenable 80 Fabric OS Version 3.1.x/4.1.
bladePropShow bladePropShow Displays blade property. Synopsis bladePropShow [-slot slot] Availability All users. Release V4.1.x Description Use this command to display the properties of a blade. Operands This command has the following operand: -slot slot Specify the slot number of the blade you want to run diagnostics on.
Fabric OS Commands See Also chippropshow ptpropshow 82 Fabric OS Version 3.1.x/4.1.
bsn bsn Displays the serial number. Synopsis bsn Availability Admin Release V3.1.x Description Use this command to display the serial number. Note: To display the serial number for a component in V4.1.x, use the chassisshow command. Operands None. Examples To display the serial number: switch:admin> bsn FT00X800506 See Also ssn Fabric OS Version 3.1.x/4.1.
Fabric OS Commands camTest Functional test of the CAM memory. Verify QuickLoop's Content Addressable Memory (CAM) SID translation. Synopsis: V3.1.x camtest [passcnt] Synopsis: V4.1.x camtest [--slot number][-passcnt count][-txport itemlist] Availability Admin Release V3.1.x and V4.1.x Description Use this command to verify that the Content Addressable Memory (CAM) is functionally OK by performing hit and miss tests. The CAM is used by QuickLoop to translate the SID.
camTest domain and area fields of the SID zeroed. If a miss is expected (when the walking 1 or walking 0 pattern is used) the original SID in the frame transmitted is received unchanged. Note: This command may not be executed on an enabled switch. You must first disable the switch using the switchDisable command. Operands This command has the following operand: passcnt (V3.1.x only) Specify the number of times to perform this test. The default value is 1. --slot number (V4.1.
Fabric OS Commands Errors When failures are detected, the subtest may report one or more of the following error messages: ■ For V3.1.x DIAG-CAMINIT DIAG-XMIT DIAG-CAMSID ■ For V4.1.x DIAG-CAMFLTR DIAG-CAMINIT DIAG-CAMSID DIAG-CAMSTAT DIAG-CAMXMIT See Also centralmemorytest cmemretentiontest cmitest crossporttest itemlist portloopbacktest portregtest ramtest spinsilk sramretentiontest 86 Fabric OS Version 3.1.x/4.1.
centralMemoryTest centralMemoryTest Test ASIC central memory operation. Synopsis: V3.1.x centralMemoryTest [passcount, datatype, dataseed] Synopsis: V4.1.x centralmemorytest [--slot number][-passcnt count][-datatype type][-ports itemlist][-seed value] Availability Admin Release V3.1.x and V4.1.x Description Use this command to execute an address and data bus verification of the ASIC SRAMs which serve as the Central Memory. Note: This command cannot be executed on an enabled switch.
Fabric OS Commands The test consists of 6 subtests: Subtest 1 The BISR subtest executes the Built-In-Self-Repair (BISR) circuitry in each ASIC. The BISR executes its own BIST, and cells found bad are replaced by redundant rows provided in each SRAM in the ASIC. Once replaced, the BIST is executed again. The firmware merely sets up the hardware for the BISR/BIST operation and checks the results. If the done bit in each SRAM is not set within a time-out period, it reports the DIAG-CMBISRTO.
centralMemoryTest ASIC #3: 0xfff9d389, 0xfff9d388, 0xfff9d387, ... ASIC #4: 0xfff8c609, 0xfff8c608, 0xfff8c607, ... For V4.1.x, the default pattern used (by POST also) is a QUAD_RAMP with a seed value of 0. Subtest 3 The ASIC-to-ASIC connection subtest verifies that any port can read the data from any of the ASICs in the switch; thus verifying both the logic transmitting and receiving the data and the physical transmit data paths on the main board connecting all the ASICs to each other.
Fabric OS Commands Subtest 4 The forced bad parity error subtest verifies that a bad parity can be detected, and that its error flag and interrupt bits are set. The test method is as follows: 1. Clear the error and interrupt bits of all ASICs. 2. Write 64 bytes with bad parity to all ASICs at offset 0. 3. Read each of the ASICs at offset 0 and check that the error and interrupt bits are set. 4. Repeat the steps above for offset 1, 2, 3, ... 10.
centralMemoryTest Subtest 6 The forced bad chip number error subtest verifies that the bad buffer number in the data packet can be detected, its error flag and interrupt bits are set. The test method is as follows: 1. Clear the error and interrupt bits of all ASICs. 2. Set up the hardware so that transmission of data includes a bad buffer number. 3. For each ASIC X in the switch, do: For each of the 11 possible offsets, do: a. Write a 64 byte pattern in the Central Memory. b.
Fabric OS Commands -ports ports Specify a set of ports to test. The data patterns are written into the ports specified and verified by reading from the ports. dataseed Specify the data pattern seed to be used. The default seed value is 0. Some data types, like BYTE_LFSR, do not require any seed value. --slot number (V4.1.x only) Specify the slot number that the diagnostic will operate on. The ports specified will be relative to this slot number.
centralMemoryTest To test the ASIC central memory in V4.1.x: switch:admin> centralmemorytest -ports 1/0-1/15 Running centralmemorytest ............ passed. Test Complete: "centralmemorytest" Pass 1 of 1 Duration 0 hr, 0 min & 5 sec (0:0:5:412). passed. Errors When this command detects failures, each subtest may report one or more of the following error messages: ■ For V3.1.
Fabric OS Commands ■ For V4.1.x: Subtest 2 LCMEM_ERR LCMRS_ERR LCMTO_ERR Subtest 3 CM_NO_BUF LCMEMTX_ERR LCMRS_ERR LCMTO_ERR Subtest 4 BAD_INT CM_ERR_PTN CM_ERR_TYPE TIMEOUT Subtest 5 BAD_INT CM_ERR_PTN CM_ERR_TYPE TIMEOUT Subtest 6 BAD_INT CM_ERR_PTN CM_ERR_TYPE TIMEOUT See Also camtest cmemretentiontest cmitest crossporttest filtertest portloopbacktest portregtest ramtest spinsilk sramretentiontest 94 Fabric OS Version 3.1.x/4.1.
cfgactvshow cfgactvshow Displays Effective zone configuration information. Synopsis cfgactvshow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the Effective zone configuration information. The Effective configuration is a single zone configuration that is currently in effect. The devices that an initiator sees are based on this configuration. The Effective configuration is built when a specified zone configuration is enabled.
Fabric OS Commands Example To show the Effective zone configuration information: switch:admin> cfgactvshow Effective configuration: cfg: c4 zone: z3 33:07:06:05:04:03:02:01 zone: z4 44:01:23:45:67:89:a0:bc switch:admin> See Also cfgclear cfgcreate cfgdelete cfgremove cfgsave cfgshow 96 Fabric OS Version 3.1.x/4.1.
cfgAdd cfgAdd Add a member to a zone configuration. Synopsis cfgAdd “cfgName”,”member;member” Availability Admin Release V3.1.x and V4.1.x Description Use this command to add one or more members to an existing zone. This command changes the Defined Configuration. For the change to be preserved across switch reboots, it must be saved to non-volatile memory using the cfgSave command. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command.
Fabric OS Commands Operands This command has the following operands: cfgName Specify a name for the zone configuration in quotation marks. This operand is required. member Specify a zone member or a list of zone members to be added to the configuration, in quotation marks, separated by semicolons. Members can be specified in one or more of the following ways: ■ Zone names ■ QuickLoop names ■ FA (Fabric Assist) zone names This operand is required.
cfgClear cfgClear Clear all zone configurations. Synopsis cfgClear Availability Admin Release V3.1.x and V4.1.x 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.
Fabric OS Commands Example To clear all zones, and then clear non-volatile memory: switch:admin> cfgClear Do you really want to clear all configurations? (Yes, y, no, n): [no] yes switch:admin> cfgdisable See Also cfgAdd cfgCreate cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgShow cfgTransAbort cfgtransshow 100 Fabric OS Version 3.1.x/4.1.
cfgCreate cfgCreate Create a zone configuration. Synopsis cfgCreate “cfgName”,”member;member” Availability Admin Release V3.1.x and V4.1.x 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, numbers, and the underscore character. Names are case sensitive, for example, “Cfg_1” and “cfg_1” are different zone configurations. Blank spaces are ignored.
Fabric OS Commands Operands This command has the following operands: cfgName Specify a name for the zone configuration in quotation marks. This operand is required. member Specify a member or list of members to be added to zone configuration, in quotation marks, separated by semicolons. Members can be specified in one or more of the following methods: ■ Zone names ■ QuickLoop names ■ FA (Fabric Assist) zone names This operand is required.
cfgDelete cfgDelete Delete a zone configuration. Synopsis cfgDelete “cfgName” Availability Admin Release V3.1.x and V4.1.x 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. This command changes the Defined Configuration.
Fabric OS Commands Example To delete a zone configuration: switch:admin> cfgDelete “Test_cfg” See Also cfgAdd cfgClear cfgCreate cfgDisable cfgEnable cfgRemove cfgSave cfgShow cfgTransAbort cfgtransshow 104 Fabric OS Version 3.1.x/4.1.
cfgDisable cfgDisable Disable a zone configuration. Synopsis cfgDisable Availability Admin Release V3.1.x and V4.1.x Description Use this command to disable 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. This command ends and commits the current zoning transaction.
Fabric OS Commands Example To disable the current zone configuration: switch:admin> cfgDisable Updating flash... switch:admin> See Also cfgAdd cfgClear cfgCreate cfgDelete cfgEnable cfgRemove cfgSave cfgShow cfgTransAbort cfgtransshow 106 Fabric OS Version 3.1.x/4.1.
cfgEnable cfgEnable Enable a zone configuration. Synopsis cfgEnable “cfgName” Availability Admin Release V3.1.x and V4.1.x 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.
Fabric OS Commands Note: This command requires an Advanced Zoning license. When security is enabled, this command can only be issued from the Primary FCS switch. See “Security Commands” on page 941. Operands This command has the following operand: cfgName Specify the name of a zone configuration to enable in quotation marks. This operand is required.
cfgRemove cfgRemove Remove a member from a zone configuration. Synopsis cfgRemove “cfgName”,”member;member” Availability Admin Release V3.1.x and V4.1.x Description Use this command to remove one or more members 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.
Fabric OS Commands Operands The following operands are required: cfgName Specify a name of a zone configuration, in quotation marks. member Specify one or more members to be deleted from the zone configuration, in quotation marks, separated by semicolons. Members can be specified in one or more of the following methods: ■ Zone names ■ QuickLoop names ■ FA (Fabric Assist) zone names This operand is required.
cfgSave cfgSave Save zone configuration to non-volatile memory. Synopsis cfgSave Availability Admin Release V3.1.x and V4.1.x Description Use this command to save the current zone configuration. The defined configuration and the name of the enabled configuration are written to non-volatile memory in all switches in the fabric.
Fabric OS Commands Operands None. Example To enable a zone configuration, then save it: switch:admin> cfgEnable “Test_cfg” zone config “Test_cfg” is in effect switch:admin> cfgSave Updating flash... See Also cfgAdd cfgClear cfgCreate cfgDelete cfgDisable cfgEnable cfgRemove cfgShow cfgTransAbort cfgtransshow 112 Fabric OS Version 3.1.x/4.1.
cfgShow cfgShow Displays zone configuration information. Synopsis: V3.1.x cfgShow [“pattern”] Synopsis: V4.1.x cfgShow [“pattern”][, mode] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display zone configuration information. If no operand is specified, all zone configuration information (both Defined and Effective) is displayed.
Fabric OS Commands Note: This command requires an Advanced Zoning license. When security is enabled, this command can only be issued from the Primary FCS switch. See “Security Commands” on page 941. Operands This command has the following operand: pattern (V3.1.x only) Specify a string of characters enclosed in quotation marks used to match zone configuration names. This operand must be in quotation marks.
cfgShow To show all zone 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 Effective configuration: cfg: USA_cfg zone: Blue_zone 1,1 21:00:00:20:37:0c:76:8c 21:00:00:20:37:0c:71:02
Fabric OS Commands See Also cfgAdd cfgClear cfgCreate cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgTransAbort cfgtransshow 116 Fabric OS Version 3.1.x/4.1.
cfgsize cfgsize Displays size details of the zone database. Synopsis cfgsize [integer] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the size details of the zone database. The size details include the Zone DB max size, the committed size, and the transaction size. All sizes are in bytes. The “Zone DB max size” is the upper limit for the Defined configuration, determined by the amount of flash memory available for storing the Defined configuration.
Fabric OS Commands Operands This command has the following operand: integer If a non-zero integer is specified as the parameter, the size of the flash memory allocated for the zone database is displayed. The zone database includes both the Defined and Effective configurations. This size is in kilobytes. This operand is optional.
cfgTransAbort cfgTransAbort Abort the current zoning transaction. Synopsis cfgTransAbort Availability All users. Release V3.1.x and V4.1.x Description Use this command to abort the current zoning transaction without committing it. 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.
Fabric OS Commands Example To abort the current transaction: switch:admin> cfgtransshow Current transaction token is 271010736 It is abortable switch:admin> cfgtransabort Warning: Current Zoning Transaction was aborted. Reason code = User Command switch:admin> See Also cfgAdd cfgClear cfgCreate cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgShow cfgtransshow 120 Fabric OS Version 3.1.x/4.1.
cfgtransshow cfgtransshow Displays information about current zoning transaction. Synopsis cfgtransshow Availability All users. Release V3.1.x and V4.1.x Description Use this command to show the ID of the current zoning transaction. It will also give the information about whether the transaction can be aborted or not. The transaction can not be aborted if it is an internal zoning transaction. Note: This command requires an Advanced Zoning license.
Fabric OS Commands Example To show the current transaction: switch:admin> cfgtransshow There is no outstanding zone transactions switch:admin> cfgclear Do you really want to clear all configurations? Clearing All zoning configurations... switch:admin> cfgtransshow Current transaction token is 271010736 It is abortable (yes, y, no, n): [no] y switch:admin> See Also cfgAdd cfgClear cfgCreate cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgShow cfgTransAbort 122 Fabric OS Version 3.1.x/4.1.
chassisName chassisName Displays or sets the chassis name for a StorageWorks Core switch. Synopsis chassisName [name] Availability All users (display). Admin (set). Release V4.1.x Description Use this command to change the name associated with the chassis of a StorageWorks Core switch. In the StorageWorks Core switch there are two logical switches associated with a single chassis. Enter this command with no parameter to display the current name.
Fabric OS Commands Example The following command changes the chassis's name to “SW12K”: switch:admin> chassisname Silkworm12000 switch:admin> chassisname SW12K switch:admin> chassisname SW12K switch:admin> See Also switchName 124 Fabric OS Version 3.1.x/4.1.
chassisShow chassisShow Displays all Field Replaceable Units (FRUs). Synopsis chassisShow Availability All users. Release V4.1.x Description Use this command to inventory and display the field replaceable unit (FRU) header content for each object in the chassis. On some platforms for certain FRU types, a few items may not be available. In these cases the lines will be suppressed. Possibly affected are lines 2, 3, 4, 5, 6, 8, and 10 through 13.
Fabric OS Commands 3. This line displays the value used to calculate the object's power consumption, positive for power supplies, negative for consumers: Power Consume Factor: <-xxx> 4. This line displays the part number (up to 14 characters): Part Num: 5. This line displays the serial number (up to 12 characters): Serial Num: 6. This line displays the date the FRU was manufactured: Manufacture: Day: - Month: Year: 7.
chassisShow Example To displays all Field Replaceable Units for a switch: switch12k:admin> chassisshow SW BLADE Slot: 3 Header Version: Power Consume Factor: Brocade Part Num: Brocade Serial Num: Manufacture: Update: Time Alive: Time Awake: ID: Part Num: Serial Num: Revision Num: 1 -180 60-0001532-03 1013456800 Day: 12 Month: 6 Year: 2001 Day: 15 Month: 7 Year: 2001 28 days 16 days 555-374757q> to stop 234-294-12345 2734658 A.
Fabric OS Commands chippropshow Displays ASIC chip property contents. Synopsis chippropshow [slotnumber/]chip | [slotnumber] [all] Availability All users. Release V4.1.x Description Use this command to display the ASIC chip property contents for the specified chip on the specified blade slot. Operands This command has the following operands: 128 slotnumber Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required.
chippropshow Example To view the chip properties on blade 2: switch:admin> chippropshow 2 -all switch:admin> chippropshow 7 -all Looking for chip 0 in path: /proc/fabos/blade/7 Slot: 2 minis: 0 slot: chip: 7, 0 minis: 0, chip: 0 [1657/0001,0104,2/8] [1657/0001,0104,2/8] slot: 7, minis: 0, chip: 1 Slot: 2 minis: 0 [1657/0001,0104,2/8] chip: 1 [1657/0001,0104,2/8] slot: 7, minis: 1, chip: 0 [1657/0001,0104,2/8] Slot: 2 minis: 1 slot: chip: 7, 0 minis: 1, chip: 1 [1657/0001,0104,2/8] [1657/0001,0104,2/8] slot
Fabric OS Commands chipregshow Displays port registers of a given chip number. Synopsis chipregshow [slotnumber/]chip [filter] Availability All users. Release V4.1.x Description Use this command to display the ASIC register contents for the specified chip on the specified blade slot. Operands This command has the following operands: 130 slotnumber Specify the slot number of the chip you want to test. chip Specify the index of the chip within the blade to be displayed. filter Specify a filter string.
chipregshow Example To display the port registers of chip 1 on blade 2: switch:admin> chipregshow 2/1 Port Registers for Slot: 2 port: 8 0xca6ed000: chip_id 0104 0xca6ed004: did_vc_map 0800 0xca6ed00a: int_status 1020 0xca6ed00e: vc_config 00c0 0xca6ed014: mem_bufline 00080008 0xca6ed01a: mem_offset 0000 0xca6ed01e: quad_imask c00f 0xca6ed024: lli_status 00040000 0xca6ed02c: lli_def 00000000 0xca6ed034: prescaler0 000a 0xca6ed038: toc0 0007 0xca6ed03c: toc_ctl 0000 0xca6ed04c: flist_stat 0018037e 0xca6ed05
Fabric OS Commands cmemRetentionTest Test the data retention of the central memory SRAMs. Synopsis: V3.1.x cmemRetentionTest [passcount] Synopsis: V4.1.x cmemretentiontest [--slot number][-passcnt count][-datatype type][-ports itemlist][-seed value] Availability Admin Release V3.1.x and V4.1.x Description Use this command to verify data retention in the central memory SRAMs in the ASIC.
cmemRetentionTest Operands This command has the following operands: passcount (V3.1.x only) Specify the number of times to execute this test. The default value is 1. This operand is optional. --slot number (V4.1.x only) Specify the slot number that the diagnostic will operate on. The ports specified will be relative to this slot number. The default is set to 0 and designed to operate on fixed port count products. -passcnt count Specify the number of test passes to run.
Fabric OS Commands Errors Listed below are possible error messages if failures are detected: ■ For V3.1.x: DIAG-LCMRS DIAG-LCMTO DIAG-LCMEM ■ For V4.1.x: LCMEM_ERR LCMRS_ERR LCMTO_ERR See Also camTest centralMemoryTest cmiTest crossPortTest datatypeshow itemlist portLoopbackTest ramTest spinSilk sramRetentionTest 134 Fabric OS Version 3.1.x/4.1.
cmiTest cmiTest Verify the Control Message Interface (CMI) bus between ASICs. Synopsis V3.1.x cmitest [passcnt] Synopsis V4.1.x cmitest [--slot number][-passcnt count][-txports list][-rxports list][-skip mask] Availability Admin Release V3.1.x and V4.1.x Description Use this command to verify that the multiplexed 4-bit CMI point-to-point connection between two ASICs is OK.
Fabric OS Commands ■ If a good checksum test, check that: — CMI error bit is not set. — CMI error interrupt status bit is not set. ■ if a bad checksum test, check that: — CMI error bit is set. — CMI error interrupt status bit is set. 5. Check that all other ASICs (~Y) do not have its: ■ Capture flag set. ■ CMI error bit set. ■ CMI error interrupt status bit set. Operands This command has the following operands: passcnt Specify the number of times to perform this test. The default value is 1.
cmiTest Example To run a CMI test between two ASICs in V3.1.x: switch:admin> cmiTest Running CMI Test .............. passed. To run a CMI test between two ASICs in V4.1.x: switch:admin> cmitest -txports 1/0-1/7 -rxports 1/8-1/15 Running CMI Test ..............Test Complete: “cmitest” Pass 1 of 1 Duration 0 hr, 0 min & 2 sec (0:0:2:563). passed. Errors When it detects failures, the subtest may report one or more of the following error messages: ■ For V3.1.
Fabric OS Commands See Also camtest centralmemorytest cmemretentiontest crossporttest itemlist portloopbacktest portregtest ramtest spinsilk sramretentiontest 138 Fabric OS Version 3.1.x/4.1.
configDefault configDefault Reset a subset of configuration settings to the default values. Synopsis configDefault Availability Admin Release V3.1.x and V4.1.x Description Use this command to reset certain configuration settings to the default values.
Fabric OS Commands Some configuration parameters are cached by the system. To avoid unexpected switch behavior, reboot the system after executing this command. Operands None. Example To restore the system configuration to default values: switch:admin> configDefault Committing Configuration ...done. See Also agtcfgDefault configure switchDisable switchEnable 140 Fabric OS Version 3.1.x/4.1.
configDownload configDownload Download the switch configuration file from a host system. Synopsis configDownload [“host”,”user”,”file”,”passwd”] Availability Admin Release V3.1.x and V4.1.x 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. The download process uses FTP or Remote Shell Server (RSHD).
Fabric OS Commands remain unchanged. This is particularly important when downloading a zoning configuration. Since the new zoning information is added to the current configuration, there may not be any conflicts. Typically this command is used to add a consistent change to the current zoning configuration, or to replace the current zoning configuration, in which case cfgClear must be invoked before configDownload.
configDownload To load a backup configuration file from a host system in V4.1.x: switch:admin> configdownload "123.123.123.123","jdoe","config.txt", “password1” Committing configuration...done. download complete If you enter the command with no operands, you are prompted for the appropriate valuesin V4.1.x: switch:admin> configdownload Server Name or IP Address [host]: 11.22.33.44 User Name [None]: user21 File Name [config.txt]: config-switch.
Fabric OS Commands configShow Displays system configuration settings. Synopsis configShow [“filter”] Availability All users. Release V3.1.x and V4.1.x Description Use this command to view the system configuration settings set by the configure command. Operands This command has the following operand: filter 144 Specify a text string in quotation marks that limits the output of the command to only those entries that contain the text string. This operand is optional. Fabric OS Version 3.1.x/4.1.
configShow Example To display system configuration settings: switch:admin> configshow Ethernet addresses: 0:60:69:c0:e:88 Nvram datadata: fei(0,0)host:/usr/switch/firmware e=10.32.225.190: fffff000 g=10. 32.224.1 u=user tn=switch Type to continue, Q to stop: diag.postDisable: 0 fabric.domain: 14 fabric.ops.BBCredit: 5 fabric.ops.E_D_TOV: 2000 fabric.ops.R_A_TOV: 10000 fabric.ops.dataFieldSize: 2112 fabric.ops.max_hops: 7 fabric.ops.mode.SeqSwitching: 0 fabric.ops.mode.fcpProbeDisable: fabric.ops.
Fabric OS Commands See Also agtcfgShow configure diagDisablePost diagEnablePost ipAddrShow licenseShow syslogdIpShow 146 Fabric OS Version 3.1.x/4.1.
configUpload configUpload Create a backup file of switch configuration information on a host workstation. Synopsis configUpload [“host”,”user”,”file”[,”passwd”]] Availability Admin Release V3.1.x and V4.1.x Description Use this command to upload the switch configuration to a host file. The upload process uses FTP or RSHD. If the command is entered without operands, it becomes interactive and prompts the user for input. The configuration file is written as three sections.
Fabric OS Commands Operands This command has the following operands: host Specify a host name or IP address in quotation marks; for example, “citadel” or “11.22.33.44.” The configuration file is downloaded from this host system. This operand is optional. user Specify a user name in quotation marks; for example, “jdoe.” This user name is used to gain access to the host. This operand is optional. file Specify a file name in quotation marks; for example, “config.txt.
configUpload ■ The user does not have permission on the host ■ The user runs a script that prints something at login ■ The FTP server is not running on the host See Also configDefault configDownload configShow configure Fabric OS Version 3.1.x/4.1.
Fabric OS Commands configure Modify system configuration settings. Synopsis configure Availability Admin Release V3.1.x and V4.1.x Description Use this command to change the following system configuration settings: ■ Fabric parameters ■ Virtual channel settings ■ Zoning operation parameters ■ RSCN transmission mode ■ NS pre-zoning mode ■ Arbitrated Loop parameters ■ System services ■ Portlog events enable Note: For V3.1.x, do not run this command on an operational switch.
configure The configure command is navigated using a series of menus. Top level menus and associated submenus consist of a text prompt, a list of acceptable values, and a default value (in brackets). Use the following options to control input: Return When entered at a prompt with no preceding input, accepts the default value (if applicable) and moves to the next prompt. Interrupt (Ctrl-C) Aborts the command immediately and ignores all changes made.
Fabric OS Commands Table 2: Configure Command Fabric Parameters (Continued) Field Default Range VC Encoded Address Mode 0 0 or 1 Core Switch PID Format (V3.1.x only) 0 0 or 1 Per-frame Route Priority 0 0 or 1 Long Distance Fabric 0 0 or 1 Descriptions of the switch fabric setting fields are as follows: 152 Domain The domain number uniquely identifies the switch in a fabric. This value is automatically assigned by the fabric.
configure Sequence Level Switching When Sequence Level Switching is set to 1, frames of the same sequence from a particular source are transmitted together as a group. When this feature is set to 0, frames are transmitted interleaved among multiple sequences. Under normal conditions, Sequence Level Switching should be disabled for better performance. However, some host adapters have performance issues when receiving interleaved frames from multiple sequences.
Fabric OS Commands Core Switch PID Format (V3.1.x only) This is used to set the 256 port PID format that is used for core switches. This option enables single Domain port density higher than 16. VC Encoded Address Mode and Core Switch PID Format are mutually exclusive. They cannot both be enabled at the same time. All switches in the fabric must have this parameter set the same.
configure VC Priority Specifies the class of frame traffic given priority for a Virtual Channel. Zoning Operation Parameters The Zoning Operation Parameter field is as follows: Disable NodeName Zone Checking Fabric OS Version 3.1.x/4.1.x Reference Guide Specify 1 to disable using Node WWN when specifying nodes in the zone database, or specify 0 to enable using Node WWN when specifying nodes in the zone data. The default value is 0.
Fabric OS Commands RSCN Transmission Mode The RSCN Transmission Mode field is as follows: End-device RSCN Transmission Mode Specify 0 for RSCN with single PID, 1 for RSCN with multiple PIDs, or 2 fabric RSCN. The default value is 0. NS Operation Parameters The NS Pre-zoning Mode field is as follows: Pre-zoned Responses Mode Specify 0 for Standard Mode, or 1 for Pre-zoning On. The default value is 0.
configure Always send RSCN? Following the completion of loop initialization, a remote state change notification (RSCN) is issued when FL_Ports detect the presence of new devices or the absence of pre-existing devices. When set, a RSCN is issued upon completion of loop initialization, regardless of the presence or absence of new or preexisting devices. Do Not Allow AL_PA 0x00? This option disallows AL_PA values from being 0.
Fabric OS Commands rusersd Dynamically enables or disables a server that returns information about the user logged into the system through remote procedure calls (RPC). The information returned includes user login name, the system name, login protocol or type, login time, idle time, and remote login location (if applicable). The retrieval of this information is supported by a number of operating systems which support RPC. On most UNIX-based systems (HP-UX, Irix, Linux, Solaris, etc.
configure Table 6: Configure Command Portlog Events Parameters (Continued) Field Default Range Rx: a frame is received On On/Off Rx1: a frame is received, class 1 On On/Off Rx2: a frame is received, class 2 On On/Off Rx3: a frame is received, class 3 On On/Off stats: port status or statistics On On/Off scn: a state change notification On On/Off pstate: a port changes physical state On On/Off reject: a received frame is rejected On On/Off busy: a received frame is busied On On/O
Fabric OS Commands Table 6: Configure Command Portlog Events Parameters (Continued) Field Default Range msRemR: inter-sw MS response (V4.1.x only) On On/Off nsRemQ: inter-sw NS query On On/Off nsRemR: inter-sw NS response On On/Off rscn: RSCN On On/Off state: Fibre Channel state (V4.1.x only) On On/Off xalloc: alloc an exchange (V4.1.x only) On On/Off xfree: free an exchange (V4.1.x only) On On/Off xerr: exchange error (V4.1.x only) On On/Off xstate: exchange state (V4.1.
configure 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] 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 SYNC IO mode: (0..1) [0] VC Encoded Address Mode: (0..1) [0] 1 Core Switch PID Format: (0..1) [0] Per-frame Route Priority: (0..
Fabric OS Commands See Also configDefault configShow ifShow ipAddrSet syslogdIp syslogdipshow 162 Fabric OS Version 3.1.x/4.1.
crossPortTest crossPortTest Functional test of port external transmit and receive path. Synopsis: V3.1.x crossporttest [passcount, singleportalso] Synopsis: V4.1.x crossporttest [--slot number][-nframes count][-lb_mode mode][-spd_mode mode][-gbic_mode mode] [-norestore mode][-ports itemlist] Availability Admin Release V3.1.x and V4.1.x Description Use this command to verify the functional operation of the switch.
Fabric OS Commands The test method is as follows: 1. Determine which ports are connected to each other. 2. Enable ports for cabled loopback mode. 3. Create a frame F of maximum data size (2112 bytes). 4. Transmit frame F via port M. 5. Pick up the frame from its cross connected port N. Complain if port other than N actually received the frame. 6. Check if any of the 8 statistic error counters are non-zero: ENC_in, CRC_err, TruncFrm, FrmTooLong, BadEOF, Enc_out, BadOrdSet, DiscC3. 7.
crossPortTest V3.1.x: SwitchEnable and SwitchDisabled Mode / V4.1.x: SwitchOnline and SwitchOffline Mode The crossPortTest command can be executed when the switch is enabled/online or disabled/offline. In SwitchEnabled/SwitchOnline 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.
Fabric OS Commands V3.1.x: SFP Mode Use the setgbicmode command (setGBICMode) to activate SFP mode by executing the following command prior to executing the crossPortTest command: switch:admin> setgbicmode 1 When activated, only ports with SFPs present are tested by the crossporttest command. For example, if only port 0 and port 3 contain SFPs and the SFP mode is activated, the crossporttest command limits testing to port 0 and 3.
crossPortTest Since this test includes the media and the fiber cable in its test path, its results combined with the results of portloopbacktest and spinsilk can be used to determine which components of the switch are faulty. It is also possible to use various loopback modes 3 and 5 to further isolate failures, see to -lb_mode below. Operands This command has the following operands: passnum Specify the number of frames to send.
Fabric OS Commands -lb_mode mode Select the loopback point for the test. By default, crossporttest uses cable loopback as described above. However for debug purposes you can select other loopback modes as follows: 0 Cable Loopback. 1 Port Loopback (loopback plugs). 2 External (series) loopback. 3 Silkscreen loopback. 4 Serial link wrapback. 5 Internal (parallel) loopback. -spd_mode mode Select the speed mode for the test.
crossPortTest -gbic_mode mode The gbic_mode parameter may be used to override the global GBIC mode described above for the duration of this test. Specify 1 enable gbic_mode, and the testing is limited to user ports with GBICs or SFPs installed. -norestore mode Specify 1 to force the test to skip part of the post-test cleanup normally performed. This may be helpful during debug. This parameter should normally be left at the default value of 0. -ports itemlist Specify a list of user ports to test.
Fabric OS Commands Errors Below are possible error messages if failures are detected: ■ For V3.1.x: DIAG-INIT DIAG-PORTDIED DIAG-XMIT DIAG-TIMEOUT DIAG-ERRSTAT DIAG-STATS DIAG-PORTWRONG DIAG-DATA ■ For V4.1.
crossPortTest STATS_FTX TIMEOUT XMIT See Also camTest centralmemorytest cmemretentiontest emitest portLoopbackTest portRegTest ramTest spinSilk sramRetentionTest Fabric OS Version 3.1.x/4.1.
Fabric OS Commands dataTypeShow Displays sample data stream types used in some diagnostic commands. Synopsis: V3.1.x dataTypeShow Synopsis: V4.1.x dataTypeShow [-seed value] Availability All users. Release V3.1.x and V4.1.x Description Displays sample data streams types used in diagnostic commands. There are 19 different sample data types. The command displays an example of each data stream. Operands For V3.1.x, none. For V4.1.
dataTypeShow Example Displays the types of sample data streams you can use with diagnostics: switch:admin> datatypeshow Pattern type Byte Fill 1 Word Fill 2 Quad Fill 3 Byte Not 4 Word Not 5 Quad Not 6 Byte Ramp 7 Word Ramp 8 Quad Ramp 9 Byte LFSR 10 Random 11 CRPAT 12 CSPAT 13 CHALF_SQ 14 CQTR_SQ 15 RDRAM_PAT 16 jCRPAT 17 jCJTPAT 18 jCSPAT 19 switch:admin> example 00 00 00 00 0000 0000 00000000 00 ff 00 ff 0000 ffff 00000000 00 01 02 03 0000 0001 00000000 69 01 02 05 62 39 29 18 bc bc 23 47 7e 7e 7e 7e
Fabric OS Commands date Displays or sets the switch date and time. Synopsis date [“newDate”] Availability All users (display) . Admin (set). Release V3.1.x and V4.1.x Description Use this command to set the date and time for a switch (unless security mode is enabled). All switches maintain the current date and time in non-volatile memory. If the Security feature (Secure Mode) is not enabled, switch operation does not depend on the date and time.
date It may take up to 64 seconds for the switches in the fabric to be synchronized. The date specified is always the local switch time taking into account daylight saving time and the time zone setup of the switch. Each switch takes care of converting the GMT time distributed fabric-wide to its local time.
Fabric OS Commands See Also errLogShow portLogShow tsclockserver tstimezone uptime 176 Fabric OS Version 3.1.x/4.1.
dbgshow dbgshow Displays current values of debug and verbosity levels of the specified module. Synopsis dbgshow module_name Availability Admin Release V3.1.x and V4.1.x Description Use this command to display the current values of debug and verbosity levels of the specified module. If no module name is specified, display debug and verbosity levels of all modules.
Fabric OS Commands See Also setdbg 178 Fabric OS Version 3.1.x/4.1.
diagClearError diagClearError Clear the diag software flag to allow for retest. Synopsis: V3.1.x diagclearerror [port] Synopsis: V4.1.x diagclearerror [[-slot] slot][-switch switch] | -all Availability Admin Release V3.1.x and V4.1.x 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.
Fabric OS Commands Operands This command has the following operands: port Specify the port where you want to clear diagnostic error messages. This operand is optional. -slot slot Specify the slot to clear the diagnostic failure status. This operand is optional. -switch switch (V4.1.x only) Specify the logical switch number to operate on. If omitted, then all blades will be cleared. This operand is optional. -all If specified, all blades will be cleared. (V3.1.x only) (V4.1.x only) (V4.1.
diagCommandShow diagCommandShow Displays a list of diagnostic commands. Synopsis diagCommandShow Availability Admin Release V4.1.x Description Use this command to display a list of diagnostic commands. Operands None. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Example To display a list of diagnostic commands: switch:admin> diagcommandshow diagCommandShow - Display diagnostics command parameter and error info.
diagDisablePost diagDisablePost Disable POST execution at reboot. Synopsis diagDisablePost Availability Admin Release V3.1.x and V4.1.x Description Use this command to disable Power On Self Test (POST) execution at switch reboot. This mode is saved in non-volatile memory and POST remains disabled until it is enabled using the diagEnablePost command. A reboot is not required for this command to take effect.
Fabric OS Commands Example To disable the POST execution at reboot: switch:admin> diagdisablepost Committing configuration...done. On next reboot, POST will be skipped. switch:admin> See Also diaghelp diagEnablePost 184 Fabric OS Version 3.1.x/4.1.
diagEnablePost diagEnablePost Enable POST execution at next reboot. Synopsis diagEnablePost Availability Admin Release V3.1.x and V4.1.x Description Use this command to enable POST execution at the next switch reboot. This mode is saved in non-volatile memory and POST remains enabled until it is disabled using the diagDisablePost command. POST executed after a cold boot (a power cycle of the switch) runs longer than POST executed after warm boot (executing reboot on a powered up switch).
Fabric OS Commands It is recommended that POST always be enabled to ensure the operational status of the switch during the power on stage. The factory default enables POST execution. Operands None. Example To enable the POST during future power ups: switch:admin> diagenablepost Committing configuration...done. On next reboot, POST will be executed. switch:admin> See Also camtest centralmemorytest cmitest diaghelp diagDisablePost ramtest portloopbacktest portregtest 186 Fabric OS Version 3.1.x/4.1.
diagesdports diagesdports Set ESD skip ports list. Synopsis diagesdports [itemlist | -show] Availability Admin Release V4.1.x Description Use this command to set the ESD IDLE PORTS list. The list is saved in non-volatile memory and stays in that mode until the next execution of diagesdports. The ESD IDLE ports are used by several of the functional test methods to disable testing on the specified list of ports when ESD mode is enabled (see setesdmode).
Fabric OS Commands Example To add ports 1 through 3 to the ESD Idle port list: switch:admin> ESD Idle Port Config update switch:admin> ESD Idle Port diagesdports 1-3 list is now 1-3. Succeeded diagesdports -show list is 1-3. See Also diaghelp 188 Fabric OS Version 3.1.x/4.1.
diagfaillimit diagfaillimit Set diagnostics fail limit to a specified value. Synopsis diagfaillimit [limit | -show] Availability Admin Release V4.1.x Description Use this command to set the diagnostics fail limit to a specified value. The fail limit controls the number of failures before certain diagnostics test methods will abort. The normal setting is 1 so that the tests will abort on the first failure. The exact use of this configuration setting depends on the test method.
Fabric OS Commands Example To change the fail limit from 1 to 5: switch:admin> Fail Limit is switch:admin> Fail Limit is Config update switch:admin> diagfaillimit 1. diagfaillimit 5 now 5. Succeeded See Also diaghelp 190 Fabric OS Version 3.1.x/4.1.
diagHelp diagHelp Displays diagnostic command information. Synopsis: V3.1.x diagHelp Synopsis: V4.1.x diagHelp [-name command] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display diagnostic command information. Operands For V3.1.x, none. For V4.1.x, this command has the following operand: -name command Fabric OS Version 3.1.x/4.1.x Reference Guide Specify a command name to display more detailed information.
Fabric OS Commands Example To display information about diagnostic commands: switch:admin> diagHelp ramTest portRegTest centralMemoryTest cmiTest camTest statsTest filterTest portLoopbackTest sramRetentionTest turboRamTest cmemRetentionTest crossPortTest txdPathTest spinSilk diagClearError diagDisablePost diagEnablePost setGbicMode setSplbMode supportShow diagShow parityCheck spinFab loopPortTest fPortTest portTest stopPortTest portTestShow System DRAM diagnostic Port register diagnostic Central memory di
diagloopid diagloopid Set the diagnostics loop ID. Synopsis diagloopid [id | -show] Availability Admin Release V4.1.x Description Use this command to select the loop ID to be used by FL mode diagnostics. The value entered will be converted from a loop ID to the corresponding AL_PA and used as the port address for any diagnostics that operate in FL port mode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
Fabric OS Commands Example To change the loop id from 125 to 120: switch:admin> diagloopid FL mode Loop ID is 125. switch:admin> diagloopid 120 FL mode Loop ID is now 120. Config update Succeeded switch:admin> See Also diaghelp 194 Fabric OS Version 3.1.x/4.1.
diagmodepr diagmodepr Enable or disable mode messages. Synopsis diagmodepr [mode | -show] Availability Admin Release V4.1.x Description Use this command to enable print mode. The mode is saved in non-volatile memory and stays in that mode until the next execution of diagmodepr. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. Print mode, when enabled, will cause extra messages to be displayed in the burn-in and post scripts.
Fabric OS Commands Example To enable print mode messages: switch:admin> diagmodepr Diagnostic Print Mode is switch:admin> diagmodepr Config update Succeeded Diagnostic Print Mode is switch:admin> -show currently disabled. 1 now enabled. See Also diaghelp 196 Fabric OS Version 3.1.x/4.1.
diagpost diagpost Enable or disable POST testing. Synopsis diagpost [mode | -show] Availability Admin Release V4.1.x Description Use this command to enable or disable POST testing. The mode is saved in non-volatile memory and stays in that mode until the next execution of diagpost. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
Fabric OS Commands Example To enable and then disable the POST test: switch:admin> diagpost 1 Config update Succeeded Post disable is now 0 (Enabled). san95:admin> diagpost 0 Config update Succeeded Post disable is now 1 (Disabled). See Also diagdisablepost diagenablepost 198 Fabric OS Version 3.1.x/4.1.
diagretry diagretry Enable or disable retry mode. Synopsis diagretry [mode | -show] Availability Admin Release V4.1.x Description Use this command to enable or disable retry mode. The mode is saved in non-volatile memory and stays in that mode until the next execution of diagretry. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. Retry mode, when enabled, modifies the behavior of the diagnostic test methods, POST, and burn-in scripts.
Fabric OS Commands Example To view the current retry mode value: switch:admin> diagretry -show Diagnostic Retry Mode is currently disabled. switch:admin> diagretry 1 Config update Succeeded Diagnostic Retry Mode is now enabled. switch:admin> See Also diaghelp 200 Fabric OS Version 3.1.x/4.1.
diagsetburnin diagsetburnin Initializes the blade for a burn-in run. Synopsis diagsetburnin [--slot slotnumber][script | -current] Availability Admin Release V4.1.x Description This sets up the blade burnin parameters for the registered burnin script. The name of burnin script can be set with burninname command alternatively. The burnin will start at the next run of POST on the designated blades. The errors and activity logs are stored in non-volatile memory.
Fabric OS Commands Example To view the current burn-in settings for a switch: switch:admin> diagsetburnin --slot 1 -current existing script is: /fabos/share/switchess.sh Burnin mode is Enabled. Removing all log files in /var/log for slot 1 Slot 1 burnin name is now /fabos/share/switchess.sh Config update Succeeded switch:admin> See Also diagsetcycle diagstopburnin 202 Fabric OS Version 3.1.x/4.1.
diagsetcycle diagsetcycle Set diagnostic script parameters. Synopsis diagSetCycle script [-show | -default | [-keyword value]] Availability Admin Release V4.1.x Description This command provides interactive way of updating diagnostic command parameters. With only script specified, it will display all configuration variables used by the specified script and go into an interactive session. Using the full stretched option parameters, variables can be updated non interactively too.
Fabric OS Commands -keyword value The script parameters can be updated non-interactively using this style of option list. keyword is the keyword to update and the value should be specified manually in this case. Example To view the parameters for a script: switch:admin> diagsetcycle switchburnin.
diagshow diagshow Displays diagnostics status. Synopsis: V3.1.x diagshow [nSeconds] Synopsis: V4.1.x diagshow [--slot slotnumber][-uports itemlist][-bports itemlist][-use_bports value] Availability All users. Release V3.1.x and V4.1.x Description For V3.1.x, use this command to display the diagnostics status for switch was last rebooted. For V4.1.x, use this command to display the diagnostics status for the specified list of blade or user ports.
Fabric OS Commands ■ The state of the Central Memory based on the results of diagnostic executions since the last reboot. OK is displayed if previous centralmemorytest executions passed. FAULTY is displayed if the switch failed centralmemorytest. ■ The total diagnostic frames transmitted and received since last reboot.
diagshow Example V4.1.x example to display diagnostic status on switch blade 7: switch:admin> diagshow Diagnostics Status: Fri Feb 08 15:25:24 2002 Slot: 1 UPORTS Port BPort Diag Active Speed 0 15 OK UP 2G Auto 1 14 OK UP 2G Auto 2 13 OK UP 2G Auto 3 12 OK UP 2G Auto 4 31 OK UP 2G Auto 5 30 OK UP 2G Auto 6 29 OK UP 2G Auto 7 28 OK UP 2G Auto 8 47 OK UP 2G Auto ---
Fabric OS Commands diagshowtime Enable or disable elapsed time messages. Synopsis diagshowtime [mode | -show] Availability Admin Release V4.1.x Description Use this command to enable or disable show time mode. The mode is saved in non-volatile memory and stays in that mode until the next execution of diagshowtime. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. Displays the time mode, when enabled, causes each test to display elapsed time messages.
diagshowtime Example To enable show time mode: switch:admin> diagshowtime Show Time mode is 0 (Disabled). switch:admin> diagshowtime 1 Config update Succeeded Show Time mode is now 1 (Enabled). switch:admin> See Also diaghelp Fabric OS Version 3.1.x/4.1.
Fabric OS Commands diagsilkworm Enable or disable silkworm mode. Synopsis diagsilkworm [mode | -show] Availability Admin Release V4.1.x Description Use this command to enable or disable silkworm mode. The mode is saved in non-volatile memory and stays in that mode until the next execution of diagsilkworm. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
diagsilkworm Operands This command has the following operands: mode Specify 1 to enable silkworm mode, specify 0 to disable silkworm mode. This operand is optional. -show Specify this operand to display the current mode setting. This operand is optional. If no operand is specified the current value is displayed. Example To enable silkworm mode: switch:admin> Silkworm mode switch:admin> Config update Silkworm mode san95:admin> diagsilkworm is 0 (Disabled). diagsilkworm 1 Succeeded is now 1 (Enabled).
Fabric OS Commands diagskiptests Enable or disable diagnostics skip test flags. Synopsis diagskiptests [value | -show] Availability Admin Release V4.1.x Description Use this command to enable or disable the diagnostics skip test flags. The skip test flags are saved in non-volatile memory and stay set until the next execution of diagskiptests. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
diagskiptests Example The following is an example of the diagskiptests command: switch:admin> Skip tests is switch:admin> Config update Skip tests is switch:admin> diagskiptests -show 0. diagskiptests 1 Succeeded now 1. See Also diaghelp Fabric OS Version 3.1.x/4.1.
Fabric OS Commands diagstopburnin Terminate a blade burn-in run. Synopsis diagstopburnin [-slot slot] Availability Admin Release V4.1.x Description Use this command to determine which PID is running burn-in on a blade and terminate that activity. It is expected that the burn-in script handles the logging cleanup. This command does not require a reboot to take effect. Operands This command has the following operand: -slot slot 214 Specify the slot to stop burn-in.
diagstopburnin Example To stop burn-in mode on a switch: switch:admin> diagstopburnin --slot 1 No burnin script active on slot 1 1 burninErrShow output: 0x1eea (fabos): Dec 19 14:42:18 Switch: 0, Error DIAG-MANUAL1, 1, " 1 Starting switchess ... Err# 0140042 0100:101:000:001:24:37: 0xc84 (fabos): Dec 20 08:57:27 Switch: 0, Error DIAG-MANUAL1, 1, " 1 switchess: ABORT Err# 0140042 0100:101:000:000:25:41: ... 0x1b61 (fabos): Feb 07 19:02:28 Switch: 0, Error DIAG-MANUAL1, 1, " 1 Starting switchess ...
Fabric OS Commands dlsReset Disable Dynamic Load Sharing (DLS) option. Synopsis dlsReset Availability Admin Release V3.1.x and V4.1.x Description Use this command to turn off Dynamic Load Sharing (DLS) when a fabric change occurs. Refer to dlsset for a full description of load sharing. Routing is generally based on the incoming port and the destination domain.
dlsReset being delivered out of order. No frame loss occurs if IOD is off, but there is still a short period of time when traffic is not forwarded. This period of time is significantly shorter than when IOD is on, and is usually less than 1 second. Use this command only if devices connected to the fabric cannot handle occasional routing changes. Operands None. Examples To disable the dynamic load sharing option: switch:admin> dlsReset Committing configuration...done.
Fabric OS Commands dlsSet Enable Dynamic Load Sharing (DLS) option. Synopsis dlsSet Availability Admin Release V3.1.x and V4.1.x 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.
dlsSet being delivered out of order. No frame loss occurs if IOD is off, but there is still a short period of time when traffic is not forwarded. This period of time is significantly shorter than when IOD is on, and is usually less than 1 second. Operands None. Examples To enable the dynamic load sharing option:. switch:admin> dlsSet Committing configuration...done. switch:admin> dlsShow DLS is set switch:admin> See Also dlsReset dlsShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands dlsShow Displays the setting of the DLS option. Synopsis dlsShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display whether DLS is on or off. There can be two messages displayed: DLS is set The DLS option is turned on. Load sharing is reconfigured with every change in the fabric. DLS is not set The DLS option is turned off. Load sharing is only reconfigured when the switch is rebooted or an Fx_Port comes up. Operands None.
dnsconfig dnsconfig Set or display Domain name service parameters. Synopsis dnsconfig Availability Admin Release V3.1.x and V4.1.x Description Use this command to display or set the domain name service parameters. The domain name service parameters are namely domain name and the name server IP address for primary and secondary name servers. Operands None.
Fabric OS Commands See Also ipaddrset ipaddrshow 222 Fabric OS Version 3.1.x/4.1.
errClear errClear Clear the switch error log. Synopsis: V3.1.x errClear Synopsis: V4.1.x errClear [-p] Availability Admin Release V3.1.x and V4.1.x Description Use this command to clear the error log for a particular switch instance. If no operand is specified, this command clears the error log in RAM; The persistent error log is not cleared. However, if -p option is specified, ONLY the persistent error log is cleared and the error log in RAM is not cleared. Operands For V3.1.x, none. For V4.1.
Fabric OS Commands Example The following example shows how to clear the error log: switch:admin> errclear 0x102ed690 (tShell): Nov 22 15:09:38 INFO SYS-LOGCLRD, 4, Error log cleared switch:admin> To clear the persistent error log on the Active CP using V4.1.x, use the -p operand. See Also errDump errNvLogSizeSet errNvLogSizeShow errShow 224 Fabric OS Version 3.1.x/4.1.
errDump errDump Displays the error log without page breaks. Synopsis: V3.1.x errDump Syntax: V4.1.x errDump [-a][-p] Availability Admin Release V3.1.x and V4.1.x Description Use this command to display the error log; the entries in the log are displayed without any page breaks. It is identical to errshow, except that errshow prompts the user to type return between each log entry.
Fabric OS Commands Operands For V3.1.x, none. For V4.1.x, this command has the following operands: -a Displays messages from the active error log. This displays the error log messages generated during the current run time cycle. -p Displays messages from the persistent error log.
errNvLogSizeSet errNvLogSizeSet Resize the persistent error log. Syntax errNvLogSizeSet number_of_entries Availability Admin Release V4.1.x Description Use this command to resize the persistent error log of a switch to a new size specified by the operand number_of_entries. The persistent error log is resized immediately after the successful execution of this command.
Fabric OS Commands See Also errNvLogSizeShow errSaveLvlShow errShow 228 Fabric OS Version 3.1.x/4.1.
errNvLogSizeShow errNvLogSizeShow Displays the current persistent (non-volatile) error log configuration of a switch. Syntax errNvLogSizeShow Availability Admin Release V4.1.x Description Use this command to show the current maximum size of the persistent error log. Note: The configuration of the persistent error log on the active CP is independent of the configuration on the standby CP. Operands None.
Fabric OS Commands errSaveLvlSet Set the error saving level of a switch. Syntax errSaveLvlSet lvl Availability Admin Release V4.1.x Description Use this command to control types of messages that are saved in the persistent error log. Message types are based on the message severity levels. By default, all messages of type Panic and Critical are saved in the persistent log. If you want to save messages of log levels less severe than Critical, use this command to specify a new message save level.
errSaveLvlSet Example The following example shows how to enable saving of Warning, Critical, Error, and Panic messages in the persistent error log. switch:admin> errSaveLvlSet 3 See Also errDump errNvLogSizeSet errSaveLvlSet errSaveLvlShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands errSaveLvlShow Show current error save level setting of a switch. Syntax errSaveLvlShow Availability Admin Release V4.1.x Description Use this command to find out the current value of the persistent error log save level for a given switch instance. Operands None. Example Following example shows how to display current error log save level.
errShow errShow Displays the error log. Synopsis: V3.1.x errShow Synopsis: V4.1.x errShow [-a][-p] Availability Admin Release V3.1.x and V4.1.x Description Use this command to display the error log, prompting the user to type return between each log entry. It is identical to errdump, except that errdump displays all entries without page breaks.
Fabric OS Commands Diagnostic Error Codes Table 7 lists the error code numbers, the POST test that generates this error number, and the type of error.
errShow Table 7: Diagnostic Error Codes (Sheet 2 of 4) Error Number Test Error Type 1030 centralMemoryTest DIAG-BADINT 106F centralMemoryTest DIAG-TIMEOUT 1F25 cmemRetentionTest DIAG-LCMRS 1F26 cmemRetentionTest DIAG-LCMTO 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 223
Fabric OS Commands Table 7: Diagnostic Error Codes (Sheet 3 of 4) Error Number 236 Test Error Type 266F portLoopbackTest DIAG-TIMEOUT 2670 portLoopbackTest DIAG-PORTABSENT 2671 portLoopbackTest DIAG-XMIT 3040 crossPortTest DIAG-ERRSTAT (ENCIN) 3041 crossPortTest DIAG-ERRSTAT (CRC) 3042 crossPortTest DIAG-ERRSTAT (TRUNC) 3043 crossPortTest DIAG-ERRSTAT (2LONG) 3044 crossPortTest DIAG-ERRSTAT (BADEOF) 3045 crossPortTest DIAG-ERRSTAT (ENCOUT) 3046 crossPortTest DIAG-ERRSTAT (B
errShow Table 7: Diagnostic Error Codes (Sheet 4 of 4) Error Number 3846 Test spinSilk Error Type DIAG-ERRSTAT (BADORD) spinSilk 1 DIAG-ERRSTAT (DISCC3) 847 spinSilk 2 DIAG-ERRSTAT (DISCC3) 384F spinSilk DIAG-INIT 385F spinSilk DIAG-PORTDIED 3870 spinSilk DIAG-PORTABSENT 3871 spinSilk DIAG-XMIT 3874 spinSilk DIAG-PORTSTOPPED 3847 1. 2. V3.1.x only. V4.1.x only. Operands For V3.1.x, none. For V4.1.
Fabric OS Commands See Also errDump errNvLogSizeSet errNvLogSizeShow errSaveLvlSet errSaveLvlShow uptime 238 Fabric OS Version 3.1.x/4.1.
exit exit Logout from a shell session. Synopsis exit Availability All users. Release V3.1.x and V4.1.x 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 a Ctrl-D typed at the beginning of a line. Operands None. Example To exit from a shell session: switch:admin> exit Connection to host lost.
Fabric OS Commands fabportshow Displays fabric port information. Synopsis fabportshow [slotnumber/]portnumber Availability All users. Release V4.1.x Description Use this command to display the contents of a particular port data and also any pending commands (if applicable). The following information is displayed: 240 Port Displays the port number.
fabportshow Flags Port flags: 0x00000001 0x00000002 0x00000004 0x00000008 0x00000010 0x00000020 0x00000040 0x00000080 0x00000200 0x00000800 0x00001000 0x00002000 0x00004000 0x00008000 0x00010000 0x00020000 0x00040000 0x00080000 0x00100000 0x00200000 0x00400000 0x00800000 0x01000000 0x02000000 nbrWWN Neighboring switch's WWN red_ports All E-Ports that are connected to the same neighboring switch.
Fabric OS Commands Example To display fabric port information: switch:admin> fabportshow 4/14 Fabric Port Information: ======================== Port: State: List: List Count: Flags: nbrWWN: red_ports: 10 11 62 63 62 P3 0x10068418 0 0x280120 10:00:00:60:69:80:06:cf Open commands pending: ====================== No commands pending switch:admin> See Also portshow 242 Fabric OS Version 3.1.x/4.1.
fabretryshow fabretryshow Displays the retry count of the fabric commands. Synopsis fabretryshow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the retry count of the fabric commands.
Fabric OS Commands Example To display the retry count of Fabric OS commands: switch:user> fabretryshow E_Ports SW_ILS 0 1 ELP 0 0 EMT 0 0 ETP 0 0 EFP 0 0 AAI 0 0 RDI 0 0 BF 0 0 2 0 0 0 0 0 0 0 3 0 0 0 0 0 0 0 4 0 0 0 0 0 0 0 5 0 0 0 0 0 0 0 6 0 0 0 0 0 0 0 7 0 0 0 0 0 0 0 See Also fabstatsshow 244 Fabric OS Version 3.1.x/4.1.
fabricprincipal fabricprincipal Set the Principal Switch Selection mode. Synopsis fabricprincipal [-fhq][ 1 | 0 ] Availability All users can display current setting. Admin can modify current setting. Release V4.1.x Description Use this command to set Principal Switch Selection Mode for the switch. The implementation of the fabricprincipal command is based solely on mechanisms specified in the Fibre Channel standards.
Fabric OS Commands 1 | 0 Specify 1 to enable principal switch mode, or specify 0 to disable principal switch mode (the mode activates when the fabric rebuilds). This operand is optional.
fabricShow fabricShow Displays fabric membership information. Synopsis fabricShow Availability All users. Release V4.1.x Description Use this command to display information about switches and multicast alias groups in the fabric. If the switch is initializing, or disabled, the message “no fabric” is displayed. If the fabric is reconfiguring, some or all switches may not be shown. Otherwise, the following fields are shown: Switch ID The switch Domain_ID and embedded port D_ID.
Fabric OS Commands Operands None. Example The following example shows a fabric of four switches. “sw180” is the principal switch. Three of the switches are configured to run IP over Fibre Channel. There is one multicast alias group. switch:admin> fabricShow Switch ID Worldwide Name Enet IP Addr FC IP Addr Name ------------------------------------------------------------------------3: fffc43 10:00:00:60:69:10:60:1f 192.168.64.187 0.0.0.0 "sw187" 2: fffc42 10:00:00:60:69:00:05:91 192.168.64.60 192.168.65.
fabstateclear fabstateclear Clears the fabric state information. Synopsis fabstateclear Availability Admin Release V4.1.x Description Use this command to clear the queue of fabric state information logged by the fabric. Operands None.
Fabric OS Commands fabstateshow Displays the fabric state information. Synopsis fabstateshow Availability Admin Release V4.1.x Description Use this command to display the queue of fabric state information logged by the fabric. Operands None. Example To display the fabric state information: switch:admin> fabstateshow Time Stamp Input and *Action S, P Sn,Pn Port Xid =========================================================================== 10:58:35.185 BF Rcv A2,P3 A2,P3 4 0x287 10:58:35.
fabstateshow See Also fabstateclear fabportshow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands fabStatsShow Displays the fabric statistics information. Synopsis fabStatsShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the statistics information of fabric.
fabStatsShow Example To display the fabric statistics information: switch:admin> fabstatsshow Description Count Port Time --------------------------------------------------------------Domain ID forcibly changed: 0 E_Port offline transitions: 0 Reconfigurations: 0 Segmentations due to: Loopback: 2 Incompatibility: 0 Overlap: 0 Zoning: 3 Routing: 6 Licensing: 0 Disabling E_Port: 0 Incompatible platform DB: 0 Security violation: 0 Security incompatibility: 0 switch:admin> See Also psShow tempShow Fabric OS
Fabric OS Commands fabswitchshow Displays the fabric switch state structure information. Synopsis fabswitchshow Availability All users. Release V4.1.x Description Use this command to display the fabric switch state structure information. This command is strictly for debugging purpose. It is not intended as a user command. Operands None. 254 Fabric OS Version 3.1.x/4.1.
fabswitchshow Example To display fabric switch state structure: switch:admin> fabswitchshow Fabric Switch State Structure Information ========================================= State: A2 Rdi Receive Timer: 0x10051b48, IDLE STATE Unconfirmed Sw Timer: 0x10051c50, IDLE STATE Principal Domain: 4 Upstream Port: 4 Principal Wwn: 10:00:00:60:69:00:54:e8 Principal Prioritry: 0x2 Flags: 0x8 inq_sem count: 1 dbg_sem count: 1 fab_q current count: 0 fab_q high water: 16 fab_q age: 0 (sec) dup xid occurance: 0 last mes
Fabric OS Commands fanDisable Disable a fan unit. Synopsis fanDisable unit Availability Admin Release V4.1.x Description Use this command to disable a non-faulty fan unit by setting the RPM speed to 0. Operand This command has the following operand: unit Specify the fan's unit number. View the fan unit numbers using the fanShow command. This operand is required.
fanEnable fanEnable Enable a fan unit. Synopsis fanEnable unit Availability Admin Release V4.1.x Description Use this command to set the fan unit back to the default RPM speed only if the fan unit has been previously disabled using the fanDisable command. Operand This command has the following operand: unit Specify the fan's unit number. View the fan unit numbers using the fanShow command. This operand is required.
Fabric OS Commands See Also fanShow fanDisable 258 Fabric OS Version 3.1.x/4.1.
fanShow fanShow Displays fan status. Synopsis fanShow Availability All users. Release V3.1.x and V4.1.x 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). Fan status is shown as: OK Fan is functioning correctly. absent Fan is not present. below minimum Fan is present but rotating too slowly or stopped.
Fabric OS Commands Example To display the status and RPMs for the fans: switch:admin> Fan #1 is OK, Fan #2 is OK, Fan #3 is OK, switch:admin> fanShow speed is 2721 RPM speed is 2721 RPM speed is 2657 RPM See Also fanDisable fanEnable psShow tempShow 260 Fabric OS Version 3.1.x/4.1.
fashow fashow Displays Fabric Assist Information. Synopsis fashow Availability All users. Release V3.1.x Description This command displays information about Fabric Assist host ports. This command will display the port number and PID for each Fabric Assist host port located on this switch. It will also display a listing of each Target that has a Fabric Assist phantom on the host's port. The target's PID, assigned phantom AL_PA, preferred AL_PA and current online/offline status will all be displayed.
Fabric OS Commands Each line of output shows: Fabric Assist Mode: Enabled or Disabled port The port number of the Fabric Assist host PID The 24-bit Fibre Channel address of the host. Fabric Assist The Online/Offline status of the host. Target The 24-bit Fibre Channel address of a zoned Target that current has a phantom assigned to the host. ALPA The assigned phantom ALPA for the target. PREF_ALPA The preferred ALPA given for the target. Status The Online/Offline status of the target.
fashow See Also fazonecreate fastatsshow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands faStatsShow Displays statistics about Fabric Assist. Synopsis faStatsShow Availability All users. Release V3.1.x Description Use this command to display statistical information about Fabric Assist host ports. This command displays the port number for each Fabric Assist host port located on the switch. It also displays the total number of LIPs performed by the port since activation of Fabric Assist zoning.
faStatsShow Example This example shows three Fabric Assist host ports on the switch. sw1:admin> faStatsShow Port Total LIPs Fabric Assist LIPs Last Caused by -----------------------------------------------------00 3 1 0x011001 01 1 1 0x0511ef 03 1 1 0x0511ef See Also fazoneCreate faShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands fastboot Reboot the switch, bypassing POST. Synopsis fastboot Availability Admin Release V3.1.x and V4.1.x 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. This reduces boot time significantly. If POST has been disabled using the diagDisablePost command, then fastboot is the same as reboot.
fastboot Example This example is for the StorageWorks Core switch: switch:admin>fastboot Warning: This command is being run on a control processor (CP) based system and will cause the active CP to reboot. This will cause disruption to devices attached to both switch 0 and switch 1. To just reboot a logical switch on this system, use command switchreboot(1M) on the logical switch you intend to reboot.
Fabric OS Commands fazoneAdd Add a member to a Fabric Assist zone. Synopsis fazoneAdd “fazoneName”,“member;member” Availability Admin Release V3.1.x and V4.1.x Description This command adds one or more members to an existing Fabric Assist zone. This command does not change the defined configuration (which you can view using the cfgShow command) until the cfgSave command is issued.
fazoneAdd Operands This command has the following operands: fazoneName Specify the name for the Fabric Assist zone in quotation marks. This operand is required. member Specify a list of Fabric Assist Zone members. The list must be enclosed in quotation marks, and each member must be separated by a semicolon. A member can be specified by one or more of the following methods: ■ For V3.1.x, enter a fabric domain and physical port number pair. ■ For V4.1.x, enter a fabric domain and area number pair.
Fabric OS Commands fazoneCreate Create a Fabric Assist zone. Synopsis fazoneCreate “fazoneName”,“member;member” Availability Admin Release V3.1.x and V4.1.x Description This command creates a new Fabric Assist zone (fazone). You must specify a name and member list for a Fabric Assist zone. The FA zone name must be unique from any previously used Fabric Assist zone object. The member list must be enclosed in quotation marks and each member must be separated by a semicolon.
fazoneCreate Zone alias names have the same format as Fabric Assist zone names and are created with the alicreate command. The alias must resolve to a list of one or more physical fabric port numbers, WWNs, or a Fabric Assist host. When a Fabric Assist zone member is specified by Node Name, then all ports on that device are in the Fabric Assist zone. When a Fabric Assist zone member is specified by Port Name, only that single device port is in the Fabric Assist zone.
Fabric OS Commands would contain all devices connected to switch 2, ports 12 and 14, and the device with a WWN of "10:00:00:60:69:00:00:8a" (either Node Name or Port Name) whichever port in the fabric it is connected to. The target connected to switch 2, port 12 would be assigned an ALPA value of 0xE2, and the target connected to port switch 2, port 14 would be assigned an ALPA value of 0xE8. Finally, the ALPA assigned to the target identified by the WWN would be assigned a value of 0xEF.
fazoneCreate Example To create three Fabric Assist zones using a mixture of port numbers and Fabric Assist zone aliases: switch:admin> fazoneCreate “fazone1”, “H{1,0}; loop1” switch:admin> fazoneCreate “fazone2”, “H{1,1}; array1; 1,2; array2” switch:admin> fazoneCreate “fazone3”, “1,0; loop1; H{1,2}; array2” See Also fazoneAdd fazoneDelete fazoneRemove fazoneShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands fazoneDelete Delete a Fabric Assist mode zone. Synopsis fazoneDelete “fazoneName” Availability Admin Release V3.1.x and V4.1.x Description Use this command to delete an existing Fabric Assist mode zone on a fabric. This command does not change the defined configuration (which you can view using the cfgShow command) until the cfgSave command is issued. For the change to become effective, an appropriate Fabric Assist zone configuration must be enabled using the cfgEnable command.
fazoneDelete Example To delete a Fabric Assist zone: switch:admin> fazoneDelete “Blue_fazone” See Also fazoneCreate faShow faStatsShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands fazoneRemove Remove members from a Fabric Assist mode zone. Synopsis fazoneRemove “fazoneName”,“member;member” Availability Admin Release V3.1.x and V4.1.x Description This command removes one or more members from an existing Fabric Assist zone. Each deleted member must be found by an exact string match. Order is important when removing multiple members of a Fabric Assist zone.
fazoneRemove Operands The following operands are required: fazoneName Specify a name for the Fabric Assist zone in quotation marks. This operand is required. member Specify a member or list of members to remove from a Fabric Assist zone. The list must be enclosed in quotation marks, and each member must be separated by a semicolon. A member can be specified by one or more of the following methods: ■ For V3.1.x, enter a fabric domain and physical port number pair. ■ For V4.1.
Fabric OS Commands fazoneShow Displays fazone information. Synopsis fazoneShow ["pattern"[, transflag]] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display fazone information. Specifying this command with no parameters or with the second parameter set to zero displays all fazone configuration information for both Defined and Effective configurations. Defined configuration information is shown from the transaction buffer.
fazoneShow Operands This command has the following operands: pattern Specify a value to search for the name of an fazone. This can be any POSIX style expression. This operand must be in quotation marks for V3.1.x. Patterns can contain: ■ Question mark “?” that matches any single character ■ Asterisk “*” that matches any string of characters ■ Ranges which match any character within the range. For example, [0-9] or [a-f]. This operand is optional.
Fabric OS Commands fcpprobeshow Displays the FCP probe information. Synopsis: V3.1.x fcpprobeshow portnumber Synopsis: V4.1.x fcpprobeshow [slotnumber/]portnumber Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the FCP probing information for a particular device which should be of type F/FL port. If the given port is not either of the above types, then the following message displays: port x is not an FL_Port or an F_Port 280 Fabric OS Version 3.1.x/4.1.
fcpprobeshow Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands fcprlsshow Displays the fcp rls information. Synopsis: V3.1.x fcprlsshow portnumber Synopsis: V4.1.x fcprlsshow [slotnumber/]portnumber Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the fcp rls (read link state) information for a particular device which should be of type F/FL port. If the given port is not either of the above types, then the following is displayed: port x is not an FL_Port or an F_Port 282 Fabric OS Version 3.1.x/4.1.
fcprlsshow Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands fdmicacheshow Displays abbreviated remote FDMI device information according to remote domain ID. Synopsis fdmicacheshow Availability All users. Release V3.1.x and V4.1.x Description Use this command to displays FDMI cache information for remote domains only. The state of each remote domain, identified by its domain ID is shown to be either UNKNOWN, KNOWN or ERROR.
fdmicacheshow Example To view the FDMI cache (V3.1.x example): switch:admin> fdmicacheshow state rev KNOWN v310 HBAs: 10:00:00:00:c9:25:9b:96 Total number of ports: 1 Ports: 10:00:00:00:c9:25:9b:96 Total count of devices on the switch is 1 To display the FDMI cache (V4.1.x example): switch:admin> fdmicacheshow state entry Switch rev for domain 1 KNOWN state v310 rev KNOWN No devices.
Fabric OS Commands fdmishow Displays detailed FDMI device information. Synopsis fdmishow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display FDMI information for all HBAs and ports. Detailed FDMI information are displayed for local HBAs and ports. These includes HBA and port identifiers, HBA registered port list, and all the detailed attributes for HBA and ports. Only abbreviated FDMI information are shown for HBA and ports on remote switches. Operands None.
fdmishow Example For a managing master switch: switch:admin> fdmishow FDMI LOCAL_HBA hash contains: Id: 10:00:00:00:c9:25:9b:96 Port List: total 1 port(s) Id: 10:00:00:00:c9:25:9b:96 Port attributes: FC4 Types: 0x000100000100000000000000000000000000000000000000000000...
Fabric OS Commands filterTest Frame Filter test. Synopsis: V3.1.x filterTest [passcnt] Synopsis: V4.1.x filtertest [-passcnt passcnt][-txports list][-scamoff offset][-dcamoff offset][-fdefoff offset] Availability Admin Release V3.1.x and V4.1.
filterTest In this test, the filter definition covers the following different filtering conditions: Table 8: List of Filter Test Numbers, Definitions, and Action Types Number Filter Definition Action Type 0 unconditional match Forward 1 unconditional match List A 2 unconditional match List B 3 unconditional match Frozen 4 unconditional match Discard 5 SCAM no match and AL_PA match List A 6 SCAM&DCAM match and AL_PA match List A 7 Zone A match and AL_PA match List A 8 Zone B matc
Fabric OS Commands -fdefoff offset (V4.1.x only) Specify the program location to write filter test definition data in filter definition memory. The default value is 0. The maximum offset number is set if the specified number is larger than limit. Errors: V4.1.x When it detects failures, the subtest may report one or more of the following error messages: DIAG-FLTINIT DIAG-FLTXMIT DIAG-FLTRCV DIAG-ACTTEST DIAG-NUMTEST Example To run the filterTest (V4.1.
firmwareCommit firmwareCommit Commit switch firmware update. Synopsis firmwareCommit Availability Admin Release V4.1.x Description Use this command to commit a firmware download to a CP. This command copies an updated firmware image on the primary partition to the secondary partition and commits both partitions of a CP to an updated version of the firmware.
Fabric OS Commands ■ Run the firmwarerestore command to copy the secondary partition (with the old firmware) to the primary, and back out of the new firmware download. Operands None. Example To commit a new version of the firmware: switch:admin> firmwarecommit Doing firmwarecommit now. Please wait ... ........................................ ........................................ ........................................ ........................................ ........................................ .
firmwareDownload firmwareDownload Download switch firmware from a remote host or from a local directory. Synopsis: V3.1.x firmwareDownload [host, user, file [,passwd]] Synopsis: V4.1.x firmwareDownload [[-sbni] host,user,pfile [,passwd]] Availability Admin Release V3.1.x and V4.1.x Description: V3.1.x Use this command to download switch firmware from a remote host or from a local directory to the switch's non-volatile storage area. The firmware download process uses FTP. Note: V3.
Fabric OS Commands For the StorageWorks Core switch, each CP has two partitions of non-volatile storage. The firmwareDownload command will always load the image into the secondary partition and then will swap the secondary to be the new primary. After the system successfully boots up from this partition, run firmwareCommit to replicate the downloaded image in the primary partition to the secondary partition.
firmwareDownload Note: The default action in V4.1 is a full install instead of an incremental install. Operands This command has the following operands: host Specify a host server name or IP address; for example, “tower” or “11.22.33.44”. The configuration file or pfile is downloaded from this host system. If this operand is not used, the pfile is considered to be accessible through a local directory. This operand is required. user Specify a user name for FTP or RSHD server access; for example, “jdoe”.
Fabric OS Commands -n (V4.1.x only) Specify this operand to de-activate auto-commit mode. By default, after running this command and after reboot, the switch will perform a firmwareCommit command automatically. When this mode is disabled, the user needs to issue the firmwareCommit command manually to replicate the downloaded image from the primary partition to the secondary partition of a CP. -i (V4.1.x only) Specify this operand to enable Incremental Install Mode.
firmwareDownload To download the firmware to a V4.1.x switch: switch:admin> firmwaredownload Server Name or IP Address: 11.22.33.44 User Name: foo File Name: /pub/dist/system.plist Password: xxxxxx Full Install (otherwise only install the difference) [Y]: Do Auto-Commit after Reboot [Y]: Reboot system after download [N]: Start to install packages......
Fabric OS Commands firmwaredownloadstatus Displays the status of a firmware download. Synopsis firmwaredownloadstatus Availability Admin Release V4.1.x Description Use this command to display an event log that records the progress and status of the current firmwaredownload command. The event log is created by the current firmwaredownload command and is kept until another firmwaredownload command is issued. There is a timestamp associated with each event.
firmwaredownloadstatus Example To display the status of a firmware download: switch:admin> firmwaredownloadstatus [1]: Mon Jan 24 13:32:07 2005 cp0: FirmwareDownload has completed successfully on Standby CP. [2]: Mon Jan 24 13:32:10 2005 cp0: Standby CP reboots. [3]: Mon Jan 24 13:34:43 2005 cp0: Standby CP boots up. [4]: Mon Jan 24 13:34:45 2005 cp0: Standby CP booted up with new firmware. [5]: Mon Jan 24 13:37:50 2005 cp1: Active CP failed over. Now this CP is becoming Active. ...
Fabric OS Commands firmwarerestore Restore old active firmware image. Synopsis firmwarerestore Availability Admin Release V4.1.x Description Use this command to restore the old active firmware image. After a firmwareDownload and a reboot, the downloaded firmware will become active. If you then do not want to commit the firmware, and instead want to restore the old firmware, run firmwareRestore. After running firmwareRestore, you can run firmwareDownload again.
firmwarerestore See Also firmwareCommit firmwareDownload Fabric OS Version 3.1.x/4.1.
Fabric OS Commands firmwareshow Displays the Fabric OS versions on both partitions of the local and remote CPs. Synopsis firmwareshow Availability Admin Release V4.1.x Description Use this command to display the Fabric OS versions on primary and secondary partitions on the local CP and on the remote CP. This command identifies the status for each CP as Active or Standby, and will also identify the slot number for each CP.
firmwareshow To display the firmware version of a StorageWorks Core switch: switch:admin> firmwareshow Local CP (Slot 5, CP0): Active Primary partition: v4.1.x Secondary Partition: v4.1.x Remote CP (Slot 6, CP1): Standby Primary partition: v4.1.x Secondary Partition: v4.1.x switch:admin> See Also firmwaredownloadstatus Fabric OS Version 3.1.x/4.1.
Fabric OS Commands fporttest Functional test of F->N, N->F point to point path. Synopsis fporttest [-nframes count][-ports itemlist][-seed payload_pattern][-width pattern_width][-size pattern_size] Availability Admin Release V4.1.x Description Use this command to verify the functional operation of the switch by sending els ECHO frames from switch F_Port's transmitter, and receive els ECHO ACC back from N_Port device into F_Port's receiver.
fporttest 5. Compare ECHO data transmitted is equal to the ECHO data received. 6. Repeat step 3 through step 5 for all ports present until: a. The number of frames requested is reached, b. All ports are marked bad. You can specify a payload pattern to be used when executing this test. If the pattern is not user specified, then at every 30 pass, a different data type from a palette of seven is used to generate different data pattern to create the frame.
Fabric OS Commands Errors: V4.1.
fporttest Example To run an fporttest: switch:admin> fporttest -ports 1/0-1/15 Running fPortTest ....... Test Complete: "fporttest" Pass 10 of 10 Duration 0 hr, 0 min & 1 sec (0:0:0:127). assed. switch:admin> See Also itemlist crossporttest loopporttest spinsilk porttest Fabric OS Version 3.1.x/4.1.
Fabric OS Commands fspfShow Displays FSPF protocol information. Synopsis fspfShow Availability All users. Release V3.1.x and V4.1.x 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 9: Display Fields Field 308 Description version Version of FSPF protocol. domainID Domain number of local switch.
fspfShow Table 9: Display Fields (Continued) Field Description startTime Start time of tFspf task (milliseconds from boot). fspfQ FSPF input message queue. fabP Pointer to fabric data structure. agingTID Aging timer ID. agingTo Aging time out value, in milliseconds. lsrDlyTID Link State Record delay timer ID. lsrDelayTo Link State Record delay time out value, in milliseconds. lsrDelayCount Counter of delayed Link State Records. ddb_sem FSPF semaphore ID.
Fabric OS Commands Examples To display FSPF protocol information (V4.1.
fwAlarmsFilterSet fwAlarmsFilterSet Enable or disable alarms for Fabric Watch. Synopsis: V3.1.x fwAlarmsFilterSet [alarm-on/off] Synopsis: V4.1.x fwAlarmsFilterSet [mode] Availability Admin Release V3.1.x and V4.1.x 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. Note: This command requires a Fabric Watch License.
Fabric OS Commands Example To enable alarms in Fabric Watch (V3.1.x example): switch:admin> fwalarmsfilterset Committing configuration...done. FW: Alarms are disabled switch:admin> fwalarmsfilterset 1 Committing configuration...done. FW: Alarms are enabled switch:admin> To enable alarms in Fabric Watch (V4.1.x example): switch:admin> fwalarmsfilterset FW: Alarms are disabled switch:admin> fwalarmsfilterset 1 FW: Alarms are enabled switch:admin> See Also fwAlarmsFilterShow 312 Fabric OS Version 3.1.x/4.
fwAlarmsFilterShow fwAlarmsFilterShow Displays alarm filtering for Fabric Watch. Synopsis fwAlarmsFilterShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display whether alarm filtering is enabled or disabled. Note: This command requires a Fabric Watch License. Operands None.
Fabric OS Commands fwClassInit Initialize all classes under Fabric Watch. Synopsis fwClassInit Availability Admin Release V3.1.x and V4.1.x Description Use this command to initialize all classes under Fabric Watch. This command should only be used after installing a Fabric Watch license to enable the licensed classes. Note: This command requires a Fabric Watch License. Operands None. Example To initialize all classes under Fabric Watch: switch:admin> fwClassInit fwClassInit: Fabric Watch is updating...
fwClassInit See Also fwConfigReload fwConfigure fwShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands fwConfigReload Reload the Fabric Watch configuration. Synopsis fwConfigReload Availability Admin Release V3.1.x and V4.1.x 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. Operands None.
fwConfigReload See Also configUpload configDownload fwClassInit fwConfigure fwShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands fwConfigure Displays and modifies the Fabric Watch configuration and status. Synopsis fwConfigure Availability Admin Release V3.1.x and V4.1.x 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. In addition, each area can include multiple thresholds. Note: This command requires a Fabric Watch License.
fwConfigure Table 10: fwConfigure Fabric Watch Classes and Areas (Continued) Class Area 3 : Port class 1 : Link loss 2 : Sync loss 3 : Signal loss 4 : Protocol error 5 : Invalid words 6 : Invalid CRCS 7 : RXPerformance 8 : TXPerformance 9 : State Changes 4 : Fabric class 1 : E-Port downs 2 : Fabric reconfigure 3 : Domain ID changes 4 : Segmentation changes 5 : Zone changes 6 : Fabric<->QL 7 : Fabric logins 8 : SFP state changes 5 : E-Port class 1 : Link loss 2 : Sync loss 3 : Signal loss 4 : Protoco
Fabric OS Commands Table 10: fwConfigure Fabric Watch Classes and Areas (Continued) Class 320 Area 6 : F/FL Port (Copper) class (V3.1.x only) 1 2 3 4 5 6 7 8 9 : Link loss : Sync loss : Signal loss : Protocol error : Invalid words : Invalid CRCS : RXPerformance : TXPerformance : State Changes (V3.1.x) 7 : (V4.1.x) 6 : F/FL Port (Optical) class 1 2 3 4 5 6 7 8 9 : Link loss : Sync loss : Signal loss : Protocol error : Invalid words : Invalid CRCS : RXPerformance : TXPerformance : State Changes (V3.
fwConfigure Table 10: fwConfigure Fabric Watch Classes and Areas (Continued) Class Area (V3.1.x) 10 : (V4.1.x) 9 : Filter Performance Monitor class 1 : Customer Define (V3.1.x) 11 : (V4.1.
Fabric OS Commands Example To display the Fabric Watch configuration and status: switch:admin> fwConfigure 1 : Environment class 2 : SFP class 3 : Port class 4 : Fabric class 5 : E-Port class 6 : F/FL Port (Copper) class 7 : F/FL Port (Optical) class 8 : Alpa Performance Monitor class 9 : End-to-End Performance Monitor class 10 : Filter Performance Monitor class 11 : Security class 12 : Switch Availability Monitor class 13 : quit Select a class => : (1..
fwFruCfg fwFruCfg Displays or modifies FRU state alert configuration. Synopsis fwFruCfg Availability Admin Release V4.1.x Description Use this command to configure FRU states and actions. Based on these configuration settings Fabric Watch generates action when FRU state changes. To configure e-mail alerts use fwMailCfg. Note: This command requires a Fabric Watch License. Operands None. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Example To change FRU state alert configuration: switch:admin> fwFruCfg 1 : Slot 2 : Power Supply 3 : Fan 4 : WWN 5 : Configure All 6 : Set All to Default 7 : Quit Select an item => : (1..
fwHelp fwHelp Displays Fabric Watch command information. Synopsis fwHelp Availability All users. Release V3.1.x and V4.1.x Description Use this command to display information on commands used to configure Fabric Watch. Operands None. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Example To display a summary of Fabric Watch telnet commands (V3.1.
fwMailCfg fwMailCfg Configure e-mail alerts in Fabric Watch. Synopsis fwMailCfg Availability Admin Release V3.1.x and V4.1.x Description Use this command to display or modify the configuration and status of e-mail alerts in Fabric Watch. Switch elements monitored by Fabric Watch are divided into Classes. You can configure one email address recipient for the alert messages from each class. Note: This command requires a Fabric Watch License.
Fabric OS Commands Operands None. Example To configure an e-mail address recipient for the environmental class in Fabric Watch (V3.1.x example): switch:admin> fwMailCfg 1 : Show Mail Configuration Information 2 : Disable Email Alert 3 : Enable Email Alert 4 : Send Test Mail 5 : Set Mail Address for Email Alert 6 : Quit Select an item => : (1..
fwMailCfg See Also fwconfigure fwclassinit fwshow fwconfigreload Fabric OS Version 3.1.x/4.1.
Fabric OS Commands fwsamshow Displays the switch availability monitor information. Synopsis fwsamshow Availability All users. Release V3.1.x and V4.1.x Description Use this command to displays information about port availability. The information displayed includes: total uptime, total down time, number of faulty occurrences, MTBF (Mean Time Before Failure), and MTTF (Mean Time To Failure) for each port. Note: This command requires a Fabric Watch License. Operands None. 330 Fabric OS Version 3.1.x/4.1.
fwsamshow Example The following example shows the summary information for an StorageWorks 2 Gb SAN switch: switch:admin> fwsamshow Port# Type Total UpTime (Percent) Total DownTime (Percent) Number Of Occurences (Times) MTBF (Hours) Total MTTF OffTime (Hours) (Percent) ============================================================================ 0 E_PORT 89 1 1 1 0 8 1 U_PORT 0 0 0 0 0 100 2 U_PORT 0 0 0 0 0 100 3 U_PORT 0 0 0 0 0 100 4 U_PORT 0 0 0 0 0 100 5 G_PORT 0 0 0 0 0 100 6 U_PORT 0 0 0 0 0 10
Fabric OS Commands fwSetToCustom Set boundary and alarm levels to custom values. Synopsis fwSetToCustom Availability Admin Release V3.1.x and V4.1.x 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 To set alarm levels to custom values: switch:admin> fwSetToCustom Committing configuration...done. See Also fwSetToDefault 332 Fabric OS Version 3.1.x/4.1.
fwSetToDefault fwSetToDefault Set boundary and alarm levels to the default values. Synopsis fwSetToDefault Availability Admin Release V3.1.x and V4.1.x 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. Example To set alarm levels to default values: switch:admin> fwSetToDefault Committing configuration...done. See Also fwSetToCustom Fabric OS Version 3.1.x/4.1.
Fabric OS Commands fwShow Displays the thresholds monitored by Fabric Watch. Synopsis fwShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the thresholds monitored by Fabric Watch. In V3.1.x, 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. In V4.1.
fwShow Example The following in a V3.1.
Fabric OS Commands The following is a V4.1.x example: switch:admin> fwShow 1 : Show class thresholds 2 : Detail threshold information 3 : Quit Select an item => : (1..
fwShow See Also fwClassInit fwConfigReload fwConfigure Fabric OS Version 3.1.x/4.1.
Fabric OS Commands gbicShow Displays serial ID GBIC information. Synopsis: V3.1.x gbicShow [portnumber] Synopsis: V4.1.x gbicShow [slotnumber][portnumber] Availability All users. Release V3.1.x and V4.1.x Description: V3.1.x 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.
gbicShow Description: V4.1.x Use this command to display information about SFPs. Note: The current technology in the StorageWorks Core switch, and StorageWorks 2 Gb SAN switch use SFPs instead of GBICs. This command is now replaced by the sfpshow command. The command is included in the current Fabric OS for backward compatibility of scripts used by some customers. SFPs are polled by a background process. The gbicshow command retrieves the latest information from cache.
Fabric OS Commands Example The following V3.1.
h h Displays shell history. Synopsis h Availability All users. Release V3.1.x and V4.1.x Description Use this command to view the shell history. The shell history mechanism is similar to the UNIX Korn shell history facility. It has a built-in line editor similar to UNIX vi that allows previously typed commands to be edited. The command h displays the 20 most recent commands typed into the shell; old commands fall off the top as new ones are entered.
Fabric OS Commands Operands None. Example To display previous shell commands: switch:admin> h 1 version 2 switchShow 3 portDisable 2 4 portEnable 2 5 switchShow See Also None. 342 Fabric OS Version 3.1.x/4.1.
haDisable haDisable Disable the High Availability feature in the switch. Synopsis haDisable Availability Admin Release V4.1.x Description Use this command to disable the High Availability feature in the Switch. If the HA feature is already disabled, this command does nothing. Operands None. Example To disable the High Availability feature: switch:admin> haDisable Disabling HA ... Done. See Also haEnable hafailover hashow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands hadump Displays High Availability feature information. Synopsis hadump Availability All users. Release V4.1.x Description Use this command to display information about the status of the High Availability feature in the Switch. This command displays the following information: ■ Local CP state (slot number and CP id); ■ Remote CP state (slot number and CP id); ■ High Availability Enabled/Disabled ■ Heartbeat Up/Down ■ Health of Standby CP.
hadump HA State Not In Sync ■ The system is unable to synchronize the two CPs, due to the Standby CP being faulty or another system error. If a fail-over were to take place at this time, the Standby CP would be rebooted, and the fail-over will be disruptive. IP and Fibre Channel addresses configured for the switch. Operands None. Example To displays High Availability feature information: switch:admin> hadump Dump HA Data ...
Fabric OS Commands haEnable Enable the High Availability feature in the switch. Synopsis haEnable Availability Admin Release V4.1.x Description Use this command to enable the High Availability (HA) feature in the switch. If the HA feature is already enabled, this command is ignored. Operands None. Example To enable the High Availability feature in the switch: switch:admin> haEnable Enabling HA ... Done. See Also haDisable haFailover haShow 346 Fabric OS Version 3.1.x/4.1.
haFailover haFailover Forces the failover mechanism so that the Standby CP becomes the Active CP. Synopsis haFailover Availability Admin Release V4.1.x Description Use this command to force the failover mechanism to occur so that the Standby CP becomes the Active CP. Because haFailover results in CP reboot, a warning message and a confirmation are displayed. If the user answers positively, then the failover takes place.
Fabric OS Commands Example To force the failover of the active CP to the standbyCP in the switch: switch:admin> hafailover Local CP (Slot 6, CP1): Active Remote CP (Slot 5, CP0): Standby, Failed HA enabled, Heartbeat Up, HA State Not in Sync Warning: This command is being run on a control processor(CP) based system. If the above status does not indicate HA State synchronized then this operation will cause the active CP to reset.
haShow haShow Displays control processor (CP) status. Synopsis haShow Availability Admin Release V4.1.x Description Use this command to display the control processor status, which includes: ■ Local CP state (slot number and CP id) ■ Remote CP state (slot number and CP id) ■ High Availability Enabled/Disabled ■ Heartbeat Up/Down ■ Health of Standby CP.
Fabric OS Commands HA State Not In Sync The system is unable to synchronize the two CPs, due to the Standby CP being faulty or another system error. If a fail-over were to take place at this time, the Standby CP would be rebooted, and the fail-over will be disruptive. Operands None.
hasyncstart hasyncstart Enable the HA state synchronizing process. Synopsis hasyncstart Availability Admin Release V4.1.x Description Use this command to re-activate the HA State Synchronizing process. Operands None.
Fabric OS Commands hasyncstop Disable the HA state synchronizing process. Synopsis hasyncstop Availability Admin Release V4.1.x Description Use this command to temporarily de-activate the HA Synchronization process.The next fail-over that takes place after may be disruptive as this command will deactivate the synchronization process. Operands None.
help help Displays help information for commands. Synopsis help [command] Availability All users. Release V3.1.x and V4.1.x Description Use this command without an 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.
Fabric OS Commands Example The first example provides help information on the login command. The second example provides help information on the configure command. switch:admin> help login ... switch:admin> help "configure" ... See Also diagHelp licenseHelp routeHelp 354 Fabric OS Version 3.1.x/4.1.
historyLastShow historyLastShow Displays last history log record. Synopsis historyLastShow Availability All users. Release V4.1.x Description Use this command to display the contents of the last history log record. A history record contains three lines of information: The first line of each record contains the following data sets: ■ Object type: CHASSIS, FAN, POWER SUPPLY, SW BLADE (switch), CP BLADE (control processor), WWN (World Wide Name), or UNKNOWN.
Fabric OS Commands Example To display the last history record: switch12K:admin> historyLastShow POWER SUPPLY Unit 2 Inserted at Tue Aug 14 15:52:10 2001 HP Part Number: 60-0001536-02 HP Serial Number: 1013456800 Records: 11 See Also historyShow 356 Fabric OS Version 3.1.x/4.1.
historymode historymode Displays or sets the mode of the history log. Synopsis historymode [mode] Availability Admin Release V4.1.x Description Use this command to display or set the mode (as rotating or first-in) of the history buffer. The history log buffer can have two modes of accepting new entries after it has reached its maximum size: ■ Rotating mode: new messages overwrite the oldest messages in the log.
Fabric OS Commands Example The following command sequence changes the history mode to first-in from rotating: switch:admin> historymode rot History Mode is: Rotating. See Also historyshow historyLastShow 358 Fabric OS Version 3.1.x/4.1.
historyShow historyShow Displays the history log. Synopsis historyShow Availability All users. Release V4.1.x Description Use this command to display the history log. Each history record contains three lines of information: 1. The first line of each record contains the following data sets: ■ Object type: CHASSIS, FAN, POWER SUPPLY, SW BLADE (switch), CP BLADE (control processor), WWN (World Wide Name), or UNKNOWN. ■ Object number: Slot (for blades), Unit (for everything else).
Fabric OS Commands Example To display the entire contents of the history file: switch:admin> historyShow FAN Unit 3 HP Part Number: HP Serial Number: Removed at Tue Aug 14 10:05:37 1970 20-123456-12 1013456800 POWER SUPPLY Unit 1 HP Part Number: HP Serial Number: Inserted at Tue Aug 14 10:52:10 1970 60-0001536-02 Unknown FAN Unit 3 HP Part Number: HP Serial Number: Inserted at Tue Aug 14 10:23:45 2001 20-123456-12 1013456800 WWN Unit 1 HP Part Number: HP Serial Number: Inserted at Tue Aug 14 11:03:4
i i Displays task summary. Synopsis i [Process ID] Availability All users. Release V3.1.x and V4.1.x Description This command displays information of all of the processes or of a specific process if a process ID is supplied. One line is displayed per process. The following table explains the fields displayed with this commands.
Fabric OS Commands Table 11: Command Field Description (Continued) Field Description S Process state codes: D uninterruptible sleep (usually IO) R runnable (on run queue) S sleeping T traced or stopped Z a defunct ("zombie") process UID The effective user ID number of the process. PID The process ID of the process. PPID The process ID of the parent process. C Processor utilization for scheduling. PRI Priority number of the process. Higher numbers mean lower priority.
i Example To display information about process name tSRL: switch:admin> i tSRL NAME ENTRY TID PRI STATUS PC SP ERRNO DELAY -------- ------------ -------- --- ---------- -------- -------- ------- ----tSRL _nssrl_svr 11f9be20 170 PEND 1088a160 11f9c1b0 0 0 switch:admin> See Also diagHelp routeHelp Fabric OS Version 3.1.x/4.1.
Fabric OS Commands ifModeSet Set the link operating mode for a network interface. Synopsis ifModeSet [“interface”] Availability Admin Release V3.1.x and V4.1.x Description: V3.1.x Use this command to set the link operating mode for a network interface. The “interface” argument is of the form , where is the name of the network interface and is the instance of that interface, for example, “fei0.
ifModeSet Description: V4.1.x Use this command to set the link operating mode for a network interface. An operating mode is confirmed with a “y” or “yes” at the prompt. If the operating mode selected differs from the current mode, the change is saved and the command exits. Changing the link mode is not supported for all network interfaces or for all ethernet network interfaces. This command is only functional for the “eth0” interface. Exercise care when using this command.
Fabric OS Commands To force 10 Mbps Half Duplex, follow this scenario for the ifmodeset command: switch:admin> ifModeSet eth0 Exercise care when using this command. Forcing the link to an operating mode not supported by the network equipment to which it is attached may result in an inability to communicate with the system through its ethernet interface. It is recommended that you only use this command from the serial console port.
ifModeShow ifModeShow Displays the link operating mode for a network interface. Synopsis ifModeShow [“interface”] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the link operating mode for a network interface. The network interfaces available on the system can be listed with the ifshow command. Note: The link operating mode is not changeable for all network interfaces and not necessarily for all Ethernet network interfaces.
Fabric OS Commands Example To display the link operating mode for the “fei0” Ethernet interface: switch:admin> ifModeShow "fei0" fei (unit number 0): Link mode: Auto-negotiate switch:admin> See Also ifModeSet ifShow 368 Fabric OS Version 3.1.x/4.1.
ifShow ifShow Displays network interface information. Synopsis ifShow [“ifName”] Availability All users. Release V3.1.x Description Use this command to display network interface status. If the operand ifName is provided, only that interface is displayed. If ifName is omitted, all interfaces are displayed.
Fabric OS Commands Operands This command has the following operand: ifName Specify the name of an interface, in quotation marks. This operand is optional. Example To display Ethernet interface information for a switch with a 10BaseT connection: switch:admin> ifShow "ei" ei (unit number 0): Flags: (0x63) UP BROADCAST ARP RUNNING Internet address: 192.168.1.65 Broadcast address: 192.168.1.
interfaceShow interfaceShow Displays FSPF interface information. Synopsis: V3.1.x interfaceShow [portnumber] Synopsis: V4.1.x interfaceShow [slotnumber/][portnumber] Availability All users. Release V3.1.x and V4.1.x 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: ■ The permanently allocated Interface Descriptor Block (IDB). ■ The neighbor data structure.
Fabric OS Commands 372 masterPort Port number of the trunk master port, if present, of the trunk group this port is a part of. defaultCost The default cost of sending a frame over the ISL connection to this interface. cost Cost of sending a frame over the ISL connected to this interface. A value of 1000 indicates a 1 Gb/s link. A value of 500 indicates a 2 Gb/s link. delay Conventional delay incurred by a frame transmitted on this ISL. A fixed value required by the FSPF protocol.
interfaceShow inactTID Inactivity timer ID. helloTID Hello timer ID. dbRtxTID Database retransmission timer ID. lsrRtxTID LSR retransmission timer ID. inactTo Inactivity time out value, in milliseconds. When this time out expires, the adjacency with the neighbor switch is broken and new paths are computed to all possible destination switches in the fabric. helloTo Hello time out value, in milliseconds. When this time out expires, a Hello frame is sent to the neighbor switch through this port.
Fabric OS Commands Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4 or 7 through 10) and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
interfaceShow See Also portShow switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands iodReset Turn off the In-order Delivery (IOD) option. Synopsis iodReset Availability Admin Release V3.1.x and V4.1.x Description Use this command to turn off the IOD option. The IOD option is turned off by default. If the IOD option was turned on using iodSet, this command can be used to turn it off again. Setting the IOD option to its default value will result in fast re-routing after a fabric topology change.
iodReset Examples To turn off the IOD option: switch:admin> iodshow IOD is set switch:admin> iodreset done. switch:admin> iodshow IOD is not set switch:admin> See Also iodSet iodShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands iodSet Enable the In Order Delivery (IOD) option. Synopsis iodSet Availability Admin Release V3.1.x and V4.1.x Description Use this command to enforce in order delivery of frames during a fabric topology change. In a stable fabric, frames are always delivered in order, even when the traffic between switches is shared among multiple paths. However, when topology changes occur in the fabric (for instance, a link goes down), traffic is rerouted around the failure.
iodSet Examples To turn on the IOD option: switch:admin> iodSet Committing configuration...done. switch:admin> See Also iodReset iodShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands iodShow Displays the In Order Delivery (IOD) option setting. Synopsis iodShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display whether the IOD option is enabled or disabled. Operands None. Example To display the current setting of the IOD option: switch:admin> iodShow IOD is not set switch:admin> See Also iodSet iodReset 380 Fabric OS Version 3.1.x/4.1.
ipAddrSet ipAddrSet Set the IP Address details for a switch or Control Processor. Synopsis: V3.1.x ipAddrSet Synopsis: V4.1.x ipAddrSet [option] Availability Admin Release V3.1.x and V4.1.x Description Use this command to set the Ethernet and Fibre Channel IP addresses on the switch. Note: The option operand is only available on the StorageWorks Core switch. This operand is not available on the StorageWorks 2 Gb SAN switch. Parameters: V3.1.x For V3.1.
Fabric OS Commands Fibre Channel Subnetmask Set the Fibre Channel subnetmask of the switch. Gateway Address Set the gateway IP address for the switch. Parameters: V4.1.x For a StorageWorks Core switch, you must set values for both logical switches and both CP cards. Use the option operand to select the logical switch or CP where you want to configure an IP address. The option operand is only available for the StorageWorks Core switch.
ipAddrSet ■ Press Ctrl-C to cancel changes ■ Press Ctrl-D to accept changes and end input The final prompt allows you to set the new IP addresses immediately. Enter Y to set new addresses immediately; enter N to delay the changes until the next switch reboot. Entering Y closes the telnet session. A change to these values issues a domain address format RSCN; see FC-FLA for a description of RSCNs. Operands For V3.1.x, none. For V4.1.
Fabric OS Commands To set the IP address details for logical switch number 1 (V4.1.x example): switch:admin> ipaddrset 1 Ethernet IP Address [10.77.77.77]: 192.168.166.148 Ethernet Subnetmask [10.77.77.76]: 255.255.255.0 Fibre Channel IP Address [0.0.0.0]: 192.168.58.135 Fibre Channel Subnetmask [0.0.0.0]: 192.168.166.134 Gateway IP Address [0.0.0.0]: IP address being changed... Committing configuration...Done. switch:admin> See Also ipAddrShow 384 Fabric OS Version 3.1.x/4.1.
ipAddrShow ipAddrShow Displays the IP address for a switch or Control Processor. Synopsis: V3.1.x ipAddrShow Synopsis V4.1.x ipAddrShow [option] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the Ethernet and FC IP addresses configured in the system. Note: The option operand is only available on the StorageWorks Core switch. This operand is not available on the StorageWorks 2 Gb SAN switch. Information: V3.1.
Fabric OS Commands Information: V4.1.x For a switch, this command displays the following details: Ethernet IP Address, Ethernet Subnetmask, Fibre Channel IP Address, and Fibre Channel Subnetmask. For a CP, this command displays the following details: Ethernet IP Address, Ethernet Subnetmask, Hostname and Gateway IP address. In the StorageWorks Core switch the CPs communicate to each other through an Ethernet in the backplane.
ipAddrShow Example To display the IP configuration details for the switch (V3.1.x example): switch:admin> ipAddrShow Ethernet IP Address: 11.22.33.44 Ethernet Subnetmask: 55.66.77.88 Fibre Channel IP Address: none Fibre Channel Subnetmask: none Gateway Address: 12.34.56.78 switch:admin> To display the IP address for logical switch number 0 (V4.1.x example): switch:admin> ipAddrShow 0 Ethernet IP Address: 11.22.33.44 Ethernet Subnetmask: 55.66.77.
Fabric OS Commands islshow Displays ISL information. Synopsis islshow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the current connections and status of the ISL of each port on this switch. The WWN where the ISL is connected to, the speed of the connection, and whether this ISL is trunked, are displayed. Operands None.
itemlist itemlist List parameter syntax and grammar information. Synopsis = | = - |
- -
-
- = | [ ] / [ ] = = | = | = 0x | = 0|1|2|3|4|5|6|7|8|9 = |A|B|C|D|E|F|a|b|c|d|e|f = *[“\t\f\r ,”] Release V4.1.
Fabric OS Commands ■ white space like spaces, and tab stops are skipped. ■ ranges using “-” can be mixed with individual values. ■ Each item may be proceeded by an optional slot number and “/”. for example, “0,3,4-6,1”, “0,1,3,4,5,6”, “0 3 4 - 6 1" will all select items 0, 1, 3, 4, 5, 6 and 7.
itemlist Table 12: Object Descriptions Type Grouping Description BPORTS Blade Blade ports, internal and external ports. UPORTS Switch User ports, ports with external connections. QUADS Blade Quadrants, group of (normally 4) ports. CHIPS Blade Chips, Asics within a blade. MINIS Blade Mini switches. SLOTS Chassis Slots. INDEX N/A Anything. Operands None.
Fabric OS Commands killtelnet Terminate an open telnet session. Synopsis killtelnet Availability Admin Release V4.1.x Description Use this command to terminate an open telnet session. The killtelnet command is an interactive menu driven command. Upon invocation, it lists all the current telnet and serial port login sessions. It lists information such as the session number, login name, the idle time, the IP address of the connection, and the time stamp of when the login session was opened.
killtelnet Example To terminate an open telnet connection: switch:admin> killtelnet Collecting login information....Done List of telnet sessions (3 found) ____________________________________________________________________________ Session No USER TTY IDLE FROM LOGIN@ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 0 root0 ttyS0 1:17m 5:13pm 1 admin0 pts/0 16.00s 192.168.130.29 6:29pm 2 admin0 pts/1 3.00s 192.168.130.
Fabric OS Commands Note: The list of open sessions displayed with killtelnet includes the user’s current session. Make sure you do not kill your own telnet session. See Also None. 394 Fabric OS Version 3.1.x/4.1.
ledtest ledtest Run LED diagnostics on a switch blade and WWN. Synopsis ledtest Availability Admin Release V4.1.x Description Use this command to run a suite of LED tests. Operands None. Example To test the LEDs: switch:admin> ledtest Disabling switch launch ledScript.tmp script in background (PID is 17974) Enter to ABORT See Also portledtest Fabric OS Version 3.1.x/4.1.
Fabric OS Commands licenseAdd Add license key to switch. Synopsis licenseAdd “license” Availability Admin Release V3.1.x and V4.1.x Description Use this command to add license keys to the system. Some features of the switch and of the fabric to which it is connected are optional licensed products. Without a license installed for such products, the services are not available. A license key is a string of approximately 16 upper and lower case letters and numbers. Case is significant.
licenseAdd Operands This command has the following operand: license Specify a license key in quotation marks. This operand is required. Example To add a license key to the switch: switch:admin> licenseAdd “bQebzbRdScRfc0iK” adding license key “bQebzbRdScRfc0iK” done. See Also licenseHelp licenseIdShow licenseRemove licenseShow portdisable portenable switchdisable switchenable Fabric OS Version 3.1.x/4.1.
Fabric OS Commands licenseHelp Commands used to administer license keys. Synopsis licenseHelp Availability Admin Release V3.1.x and V4.1.x Description Use this command to display a list of the commands used to administer license keys. Operands None.
licenseHelp See Also licenseAdd licenseIdShow licenseRemove licenseShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands licenseIdShow Displays system license ID. Synopsis licenseIdShow Availability All users. Release V4.1.x Description Use this command to display the license ID of StorageWorks 2 Gb SAN switch or a StorageWorks Core switch chassis. Some features of the switch and the fabric are optional, licensed products. Without a license installed for such products, the services provided by these features are not available.
licenseIdShow Operands None. Example To display the license ID: switch:admin> licenseIdShow a4:f8:69:33:22:00:ea:18 See Also licenseAdd licenseHelp licenseRemove licenseShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands licenseRemove Remove the license key from a switch. Synopsis licenseRemove “license” Availability Admin Release V3.1.x and V4.1.x 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 verify that the key has been removed and the licensed product uninstalled.
licenseRemove See Also licenseAdd licenseHelp licenseIdShow licenseShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands licenseShow Displays current license keys. Synopsis licenseShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display current license keys along with a list of licensed products enabled by these keys. The message No license installed on this switch is displayed when no licenses are installed. Operands None.
licenseShow See Also licenseAdd licenseHelp licenseIdShow licenseRemove Fabric OS Version 3.1.x/4.1.
Fabric OS Commands linkCost Set or print the FSPF cost of a link. Synopsis: V3.1.x linkCost [portnumber][, cost] Synopsis: V4.1.x linkCost [slotnumber/][portnumber][, cost] Availability Admin Release V3.1.x and V4.1.x Description Use this command to set or display the cost of an Inter-Switch Link (ISL). The cost of a link is a dimensionless positive number. It is used by the FSPF path selection protocol to determine the path that a frame takes going from the source to the destination switch.
linkCost If no operands are specified, the command displays the actual cost of all the ISLs in the (logical) switch. Specify the [slotnumber/]portnumber operand to view the cost of that specific port. Specify [slotnumber/]portnumber and cost operands to set the cost of a specific ISL. Setting the cost to zero removes a static cost from the database and reverts the cost of the link to its default value. Operands This command has the following operands: slotnumber (V4.1.
Fabric OS Commands Examples To display the cost of a link, and reset the cost: switch:admin> linkcost Interface Cost ----------------------------------0 500 1 500 2 500 3 500 4 500 5 500 6 500 7 (E_PORT) 500 switch:admin> See Also interfaceShow LSDbShow topologyShow uRouteShow 408 Fabric OS Version 3.1.x/4.1.
login login Log in as a new user. Synopsis login Availability All users. Release V3.1.x and V4.1.x Description Use this command to log in 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. This command allows you to access commands that you cannot access at your current user level. Operands None.
Fabric OS Commands logout Log out from a shell session. Synopsis logout Availability All users. Release V3.1.x and V4.1.x Description Use this command to log out from a shell session. Remote login connections are closed, local serial connections return to the login prompt. The command exit is accepted as synonym for logout, as is a Ctrl-D typed at the beginning of a line.
logout See Also login Fabric OS Version 3.1.x/4.1.
Fabric OS Commands loopPortTest Tests the L_port M->M path on a loop. Synopsis: V3.1.x loopPortTest [passcount, port_number, payload_pattern, pattern_width] Synopsis: V4.1.x loopporttest [--slot number][-nframes count][-ports itemlist][-seed payload_pattern][-width pattern_width] Availability: Admin Release V3.1.x and V4.1.
loopPortTest 3. Create a frame F of data size (1024 bytes). 4. Transmit frame F via port M, with D_ID to the FL port (ALPA = 0). 5. Pick up the frame from port M, the FL port. 6. Check if any of the 8 statistic error counters are non-zero: ENC_in, CRC_err, TruncFrm, FrmTooLong, BadEOF, Enc_out, BadOrdSet, DiscC3. 7. Check if the transmit, receive or class 3 receiver counters are stuck at some value. 8. Check if the number of frames transmitted is not equal to the number of frames received. 9.
Fabric OS Commands payload_pattern Specify the pattern of the test packets payload. pattern_width Specify the width of the pattern which user specified. Valid values are: 1 = byte 2 = word 4 = quad --slot number (V4.1.x only) Specify the slot number in a StorageWorks Core switch. The slot number must be followed by a slash ( / ) and the port number. The StorageWorks Core switch has a total of 10 slots counted from 1 to 10.
loopPortTest Example To run this command 100 times on port 8 (V3.1.x example): switch:admin> loopporttest 100, 8, 0xaa55, 2 Configuring L-port 7 to CableLoopback Port........done. Will use pattern: aa55 aa55 aa55 aa55 aa55 aa55 aa55 aa55 Running Loop Port Test ........ passed. Configuring Loopback L-port(s) back to normal L-port(s)........done. value = 0 switch:admin> To perform a loopback port test (V4.1.x example): switch:admin> loopporttest -ports 1/0-1/15 Running Loop Port Test .......
Fabric OS Commands ERR_STATS_BADOS ERR_STATS_C3DISC ERR_STATS_CRC ERR_STATS_ENCIN ERR_STATS_ENCOUT ERR_STATS_TRUNC ERR_STAT_2LONG ERR_STAT_BADEOF ERR_STAT_BADOS ERR_STAT_C3DISC ERR_STAT_CRC ERR_STAT_ENCIN ERR_STAT_ENCOUT ERR_STAT_TRUNC FDET_PERR FINISH_MSG_ERR FTPRT_STATUS_ERR LESSN_STATUS_ERR MBUF_STATE_ERR MBUF_STATUS_ERR NO_SEGMENT PORT_ABSENT PORT_ENABLE PORT_M2M PORT_STOPPED PORT_WRONG RXQ_FRAME_ERR RXQ_RAM_PERR STATS STATS_C3FRX STATS_FRX STATS_FTX TIMEOUT XMIT 416 Fabric OS Version 3.1.x/4.1.
loopPortTest See Also camtest centralmemorytest cmemretentiontest cmitest crossporttest itemlist portloopbacktest portregtest ramtest spinsilk sramretentiontest Fabric OS Version 3.1.x/4.1.
Fabric OS Commands LSDbShow Displays the FSPF Link State Database. Synopsis LSDbShow [domain] Availability All users. Release V3.1.x and V4.1.x 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 are allocated when a switch is connected to the fabric.
LSDbShow Table 13: LSDbShow Display Fields (Continued) Field Description lastIgnored Last time an LSR was ignored. installTime Time this LSR was installed in the database, in seconds since boot. lseFlags Internal variable. uOutIfs Internal variable uPathCost Internal variable. uOldHopCount Internal variable. uHopsFromRoot Internal variable. mOutIfs Internal variable. parent Internal variable. mPathCos Internal variable. mHopsFromRoot Internal variable.
Fabric OS Commands Table 13: LSDbShow Display Fields (Continued) Field Description cost Cost of this link. The default cost for a 1 Gb/s link is 1000. costCnt Always 0. type Always 1. Operands This command has the following operand: domain 420 Specify the domain number of the LSR to be displayed. This operand is optional. Fabric OS Version 3.1.x/4.1.
LSDbShow Examples To display the Link State Record for the local switch: switch:admin> lsdbshow Domain = 7 (self), lsrP = earlyAccLSRs = ignoredLSRs = lastIgnored = installTime = lseFlags = uOutIfs = uPathCost = uOldHopCount = uHopsFromRoot = mOutIfs = parent = mPathCost = mHopsFromRoot = Link State Database Entry pointer = 0x103946a0 0x1035bb30 1 0 Never 0x4f20a (324106) 0xa 0x0 0 -1161889074 0 0x20 0x4 2000 2 Link State Record: Link State Record pointer = 0x1035bb30 lsAge = 138 reserved = 0 type = 1 op
Fabric OS Commands mcastShow Displays multicast routing information. Synopsis mcastShow [group_ID] Availability All users. Release V3.1.x 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.
mcastShow The following fields are displayed: Table 14: Group Fields Groups Fields Multicast Group ID Member Ports Bit map of all ports in the multicast tree for that multicast group. Member ISL Ports Bit map of all E_Ports in the multicast tree for that multicast group. Static ISL Ports Reserved. It should be all zeroes. Operands This command has the following operand: group_ID Specify the multicast group to be displayed. This operand is optional.
Fabric OS Commands memshow Displays the amount of free and used memory in switch. Synopsis: V3.1.x memshow Synopsis: V4.1.x memshow [ -b | -k | -m ] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display free and used memory on the system as well as the shared memory and buffers used by the kernel. By default the memory usage is displayed in bytes. Operands For V3.1.x, none. For V4.1.
memshow Example To view the memory usage in a StorageWorks Core switch: switch:admin> memshow status bytes blocks avg block max block ------ --------- -------- ---------- ---------current free 22187312 19 1167753 22179008 alloc 5311888 4258 1247 cumulative alloc 314330064 5666735 55 switch:admin> See Also savecore Fabric OS Version 3.1.x/4.1.
Fabric OS Commands mscapabilityshow Displays the service support capability. Synopsis mscapabilityshow Availability All users. Release V3.1.x and V4.1.x Description Use this command to query a fabric for service support capability. This command provides information on what services are supported fabric wide. The following capabilities are shown: 426 ■ Bit 0: Basic Fabric Configuration Service Supported. This bit displays the fabric capability to support Management Server.
mscapabilityshow ■ Bit 4: Fabric Zone Service Supported. This bit displays the fabric capability to support the Fabric Zone Service. This service is described in the FC-GS MS specification. ■ Bit 5: Fabric Lock Service Supported. This service is not currently supported in switches, and defaults to 0. This service is described in the FC-GS MS specification. ■ Bit 6: Time Service Supported. This bit displays the fabric capability to support the Time Service.
Fabric OS Commands Example To display Management Server capability on a fabric: switch:admin> mscapabilityshow Switch WWN ======================== 10:00:00:60:69:90:03:f0 10:00:00:60:69:90:24:f0 10:00:00:60:69:90:31:f0 Capability ========== 0x0000019f 0x0000019f 0x0000008f Switch Name =========== “switch”* “switch123” “switch321” Capability Bit Definitions: Bit 0: Basic Fabric Configuration Service Supported. Bit 1: Platform Service Supported. Bit 2: Topology Discovery Service Supported.
msConfigure msConfigure Configure the Management Server. Synopsis msConfigure Availability Admin Release V3.1.x and V4.1.x Description Use this command to display and configure parameters used to access the Management Server. The Management Server allows a storage area network (SAN) management application to retrieve and administer fabric and interconnect elements such as switches. It is located at the Fibre Channel address, FFFFFAh.
Fabric OS Commands Note: When security is enabled, this command can only be issued from the Primary FCS switch. See “Security Commands” on page 941. Operands None. Example To display the Management Server access control list: switch:admin> msConfigure 0 Done 1 Display the access list 2 Add member based on its Port/Node WWN 3 Delete member based on its Port/Node WWN select : (0..
msConfigure See Also msCapabilityShow msPlMgmtActivate msPlMgmtDeactivate msPlatShow msPlClearDB msTdDisable msTdEnable msTdReadConfig Fabric OS Version 3.1.x/4.1.
Fabric OS Commands msPlatShow Displays the Management Server Platform database. Synopsis msPlatShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display information from the Management Server Platform database. The display shows the Platform name and associated attributes of each Platform object in the database. Platform service is available in firmware v2.3 and above. Lower level firmware releases do not support it. Operands None. 432 Fabric OS Version 3.1.x/4.1.
msPlatShow Example To display the Management Server Platform database for a fabric: switch:admin> msPlatShow ----------------------------------------------------------Platform Name: [9] "first obj" Platform Type: 5 : GATEWAY Number of Associated M.A.: 1 Associated Management Addresses: [35] "http://java.sun.
Fabric OS Commands msPlClearDB Clear the Management Server Platform database on all switches in the fabric. Synopsis msPlClearDB Availability Admin Release V3.1.x and V4.1.x Description This command enables an Admin user to clear the entire Management Server Platform database on all switches in the fabric.
msPlClearDB Example To clear the Management Server Platform database on all switches in the fabric: switch:admin> msplcleardb This will erase MS Platform Service Database in the entire fabric. Would you like to continue this operation? (yes, y, no, n): [no] y Request to MS Platform DB Clear operation in progress..... *Fabric-wide MS Platform DB Clear operation in progress..... switch:admin> See Also msPlMgmtDeactivate msPlatShow msCapabilityShow msPlMgmtActivate Fabric OS Version 3.1.x/4.1.
Fabric OS Commands msPlMgmtActivate Activate the Management Server Platform service on all switches in the fabric. Synopsis msPlMgmtActivate Availability Admin Release V3.1.x and V4.1.x Description This command enables an Admin user to activate the Management Server Platform service on all switches in the fabric. HP recommends that you run the msCapabilityShow command before issuing this command.
msPlMgmtActivate Example To activate Platform service on all switches in the fabric (V4.1.x example): switch:admin> msplmgmtactivate Request to activate MS Platform Service in progress...... *Completed activating MS Platform Service in the fabric! switch:admin> See Also msPlMgmtDeactivate msPlatShow msCapabilityShow msPlClearDB Fabric OS Version 3.1.x/4.1.
Fabric OS Commands msPlMgmtDeactivate Deactivate the Management Server Platform service on all switches in the fabric. Synopsis msPlMgmtDeactivate Availability Admin Release V3.1.x and V4.1.x Description Use this command to deactivate the Platform service on all switches in the fabric. This command deactivates the Platform service of each switch in the fabric and commits the changes to the non-volatile storage of each switch.
msPlMgmtDeactivate Example To deactivate the Platform service on all switches in the fabric: switch:admin> msplmgmtdeactivate MS Platform Service is currently enabled. This will erase MS Platform Service configuration information as well as database in the entire fabric. Would you like to continue this operation? (yes, y, no, n): [no] y Request to deactivate MS Platform Service in progress......
Fabric OS Commands msTdDisable Disable the Management Server Topology Discovery service. Synopsis msTdDisable [“ALL”] Availability Admin Release V3.1.x and V4.1.x Description Use this command to disable the Management Server Topology Discovery service locally or fabric-wide. This command will disable the topology service of the local switch and commit the changes to non-volatile memory of the local switch. If the optional parameter “ALL” is given, then the command is executed on the entire fabric.
msTdDisable Example To disable the Management Server Topology Discovery service locally or fabric-wide: switch:admin> mstddisable This may erase all NID entries. Are you sure? (yes, y, no, n): [no] y Request to disable MS Topology Discovery Service in progress.... *MS Topology Discovery disabled locally. switch:admin> switch:admin> mstddisable ALL This may erase all NID entries. Are you sure? (yes, y, no, n): [no] y Request to disable MS Topology Discovery Service in progress....
Fabric OS Commands msTdEnable Enable the Management Server Topology Discovery service. Synopsis msTdEnable [“ALL”] Availability Admin Release V3.1.x and V4.1.x Description Use this command to enable the Management Server Topology Discovery service locally or fabric-wide. This command enables the Topology Discovery service on the local switch and commits the change to the non-volatile memory of the local switch. If the optional operand “ALL” is given, then the command is executed on the entire fabric.
msTdEnable Example To enable the Management Server Topology Discovery service locally or fabric-wide: switch:admin> mstdenable Request to enable MS Topology Discovery Service in progress.... *MS Topology Discovery enabled locally. switch:admin> switch:admin> mstdenable ALL Request to enable MS Topology Discovery Service in progress.... *MS Topology Discovery enabled locally. *MS Topology Discovery Enable Operation Complete!! switch:admin> See Also msTdDisable msTdReadConfig Fabric OS Version 3.1.x/4.1.
Fabric OS Commands msTDReadConfig Displays the status of Management Server Topology Discovery service. Synopsis msTdReadConfig Availability All users. Release V3.1.x and V4.1.x Description Use this command to check whether or not the Management Server Topology Discovery service is enabled. Operands None. Example To display the status of the Topology Discovery service: switch:admin> msTdReadConfig *MS Topology Discovery is Enabled. switch:admin> See Also msTdEnable msTdDisable 444 Fabric OS Version 3.1.
myid myid Displays the current login session details. Synopsis myid Availability Admin Release V4.1.x Description Use this command to display the status of the system and the login session details. The Status displays if the system is Redundant or Non-Redundant or Unknown.
Fabric OS Commands See Also version 446 Fabric OS Version 3.1.x/4.1.
nbrStatsClear nbrStatsClear Reset FSPF interface counters. Synopsis: V3.1.x nbrStatsClear [portnumber] Synopsis: V4.1.x nbrStatsClear [slotnumber/][portnumber] Availability Admin Release V3.1.x and V4.1.x 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: slotnumber (V4.1.
Fabric OS Commands When this command is specified with no operand, the statistics are cleared for all interfaces. Examples To display how to reset the counters on slot 1 port 4: switch:admin> nbrstatsclear 1/4 See Also interfaceShow portShow switchShow 448 Fabric OS Version 3.1.x/4.1.
nbrStateShow nbrStateShow Displays FSPF neighbor's state. Synopsis: V3.1.x nbrStateShow [portnumber] Synopsis: V4.1.x nbrStateShow [slotnumber/][portnumber] Availability All users. Release V3.1.x and V4.1.x 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.
Fabric OS Commands Operands This command has the following operand: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
nodefind nodefind Displays all the device PIDs matching a given WWN. Synopsis nodefind “WWN” Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the 24-bit Fibre Channel addresses of all the devices in the fabric that have either port world wide name or node world wide name matching with the given world wide name. The message No device is found with wwn xxxxxxxx is displayed if there is no device matching the given WWN.
Fabric OS Commands See Also nsshow nsallshow nscamshow 452 Fabric OS Version 3.1.x/4.1.
nsaliasshow nsaliasshow Displays local name server information with aliases. Synopsis: V3.1.x nsaliasshow Synopsis: V4.1.x nsaliasshow [-r] Availability All users. Release V3.1.x and V4.1.x Description This command is a duplicate of the command nsshow with the added feature of displaying the defined configuration aliases that the device belongs to.
Fabric OS Commands Operands For V3.1.x, none. For V4.1.x, this command has the following operand: -r Specify this option to replace the TTL attribute output with SCR (state change registration) information in the display. SCR is the state change registration of a device. This value indicates what type of RSCN a device registers to receive.
nsaliasshow See Also nsshow nsallshow switchshow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands nsAllShow Displays global Name Server information. Synopsis nsAllShow [type] Availability All users. Release V3.1.x and V4.1.x 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. Note: Specifying the type operand causes the switch to send out a query to every switch in the fabric.
nsAllShow Example To display all devices in the Fabric, followed by all type 8 (SCSI-FCP) devices and all type 5 (SCSI-FCIP) devices: switch:admin> nsAllShow 12 Nx_Ports in the Fabric { 011200 0118e2 0118e4 0118e8 0118ef 021200 0214e2 0214e4 0214e8 0214ef } switch:admin> nsAllShow 8 8 FCP Ports { 0118e2 0118e4 0118e8 0118ef 0214e2 0214e4 0214e8 0214ef } switch:admin> nsAllShow 5 2 FC-IP Ports in the Fabric { 011200 021200} See Also nsShow switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands nscamshow Displays information about remote devices in the Name Server Cache. Synopsis nscamshow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the local Name Server Cache information about the devices discovered in the fabric by the Name Server Cache manager. The message No Entry found! is displayed if the Name Server Cache Manager hasn't discovered new switches and any new devices in the fabric.
nscamshow Example To displays all Switch and device entries discovered by the Name Server in the fabric: switch:admin> nscamshow nscam show for remote switches: Switch entry for 2 state rev owner cold v250+ 0xfffc01 Hot device list: No Entry found! Cold device list: Type Pid COS PortName NodeName N 021200; 2,3;10:00:00:60:69:00:ab:ba;10:00:00:60:69:00:ab:ba; FC4s: FCIP Fabric Port Name: 20:02:00:60:69:00:68:19 See Also nsshow nsallshow switchshow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands nsShow Displays local Name Server information. Synopsis: V3.1.x nsShow Synopsis: V4.1.x nsShow [-r] Availability All users. Release V3.1.x and V4.1.x 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.
nsShow TTL Time-to-live (in seconds) for cached entries, or NA (not applicable) if the entry is local. SCR (V4.1.x only) State change registration of the device. This is displayed if "-r" option is given.
Fabric OS Commands See Also nsAllShow switchShow 462 Fabric OS Version 3.1.x/4.1.
nsstatshow nsstatshow Displays local Name Server statistical information. Synopsis nsstatshow Availability All users. Release V3.1.x and V4.1.x Description This command displays local Name Server statistical information. Operands None. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Example To display local Name Server statistical information: switch:admin> nsstatshow Name Server Statistics { 69 invoked 2 Input 0 discards 0 0 rejected Output 0 request 0 0 cached 0 Req.
nszonemember nszonemember Displays the information of all the online devices which are zoned with the given device. Synopsis nszonemember “PID” Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the information of all the online devices which are zoned with the given device. Each line of output shows: Type U for unknown, N for N_Port, NL for NL_Port. Pid 24-bit Fibre Channel address. COS List of classes of service supported by device.
Fabric OS Commands Operands None.
parityCheck parityCheck Enable or disable DRAM parity checking. Synopsis parityCheck [mode] Availability Admin Release V3.1.x Description Use this command to enable DRAM parity checking. The mode is saved in non-volatile memory and stays in that mode until the next execution of parityCheck. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. The DRAM parity checking, when enabled, causes ramTest to perform several additional tests of the parity memory.
Fabric OS Commands Example To enable and disable DRAM parity checking: switch:admin> parityCheck 1 Committing configuration...done. Parity check is now ON. switch:admin> parityCheck 0 Committing configuration...done. Parity check is now OFF. switch:admin> parityCheck 0 Parity not supported on system model: 4 Parity check already OFF. See Also ramTest 468 Fabric OS Version 3.1.x/4.1.
passwd passwd Change system login name and password. Synopsis: V3.1.x passwd [“username”] Synopsis: V4.1.x passwd [“user”] Availability All users. Release V3.1.x and V4.1.x Description Use this command to change the password for the user currently logged in, or, for another user. To change the password for a specific user, enter the command with the optional operand. The hierarchy of user levels are (from greatest access to least) is Root, Factory, Admin, and User.
Fabric OS Commands If the fabric is in secure mode, the behavior of the command is as follows: ■ If you change your current login level password, you are also prompted to change the passwords of all the user levels below your current level in the user level hierarchy. For example, if you execute this command as the Admin user, you are prompted to change the password of the User account, as User is below Admin in the hierarchy.
passwd 3. Admin 4. User Input Control Use the following to control input: Enter When entered at a prompt with no preceding input, accepts the default value (if applicable) and moves to the next prompt. Ctrl-D (end of file) When entered at a prompt with no preceding input, it terminates the command without changing password. This is valid on most computers, however, your settings could be different. Operands This command has the following operands: username (V3.1.
Fabric OS Commands To change the password for the Admin user using V4.1.x: switch:admin> passwd “admin” Changing password for admin Enter new password: Re-type new password: Password changed. Saving password to stable storage. Password saved to stable storage successfully. switch:admin> Errors When failures are detected, the subtest may report one or more of the following error messages: “user” is not a valid user name.
pdshow pdshow Displays data from a panic dump file. Synopsis pdshow [panic-dump-file] Availability Admin Release V4.1.x Description Use this command to display data from a panic dump file. The panic dump file contains information that may be useful to determine the cause of the system panic. When executed without any arguments, this command displays output from the latest panic dump file available on the switch.
Fabric OS Commands Example The following example shows how pdshow can be used to examine a panic dump file by the name panic_dump located under the directory /tmp: switch:admin> pdshow /tmp/panic_dump * * * * *** CAUTION *** Host PLATFORM (current) is: 'Unknown' PLATFORM got from pd file is: 'Ulysses' Some restuls shown may be incorrect and/or missing It is best if this command is run on same PLATFORM as that of pdfile ************** _______________________********________________________ * File :/core_f
perfAddEEMonitor perfAddEEMonitor Add end-to-end monitor to a port. Synopsis: V3.1.x perfAddEEMonitor portnumber, “SourceID”, “DestID” Synopsis: V4.1.x perfAddEEMonitor [slotnumber/]portnumber, “SourceID”, “DestID” Availability Admin Release V3.1.x and V4.1.x Description Use this command to add an end-to-end performance monitor to a port.
Fabric OS Commands “DestID.” Then RX_COUNT counts the traffic flow from A to B, CRC_COUNT counts the frames with CRC error from A to B. TX_COUNT counts the traffic from B to A. Similarly, you can install a monitor on port D, specify point B as “SourceID” and point A as “DestID.” Then RX_COUNT counts the traffic from B to A, CRC_COUNT counts the frames with CRC errors from B to A and TX_COUNT counts the traffic from A to B.
perfAddEEMonitor DestID Specify the 3-byte DID (Destination ID) of the destination device. It should be in “0xDDAAPP” format, where DD is Domain ID, AA is Area ID and PP is AL_PA ID. For example, 0x058e0f, has a Domain ID of “5,” an Area ID of “8e,” and an AL_PA ID of “f.” Example To add an end-to-end monitor to blade 7 port 2: switch:admin> perfAddEEMonitor 7/2, "0x058e0f", "0x1182ef" End-to-End monitor number 0 added.
Fabric OS Commands perfAddIPMonitor Add a filter-based monitor for IP frame count. Synopsis: V3.1.x perfAddIPMonitor portnumber[, “alias”] Synopsis: V4.1.x perfAddIPMonitor [slotnumber/]portnumber[, “alias”] Availability Admin Release V3.1.x and V4.1.x 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.
perfAddIPMonitor Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands perfAddReadMonitor Add a filter-based monitor for the SCSI Read command. Synopsis: V3.1.x perfAddReadMonitor portnumber[, “alias”] Synopsis: V4.1.x perfAddReadMonitor [slotnumber/]portnumber[, “alias”] Availability Admin Release V3.1.x and V4.1.x 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.
perfAddReadMonitor Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands perfAddRWMonitor Add a monitor for the SCSI Read and Write commands. Synopsis: V3.1.x perfAddRWMonitor portnumber[, “alias”] Synopsis: V4.1.x perfAddRWMonitor [slotnumber/]portnumber[, “alias”] Availability Admin Release V3.1.x and V4.1.x 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.
perfAddRWMonitor Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands perfAddSCSIMonitor Add a monitor for SCSI frame count. Synopsis: V3.1.x perfAddSCSIMonitor portnumber[, “alias”] Synopsis: V4.1.x perfAddSCSIMonitor [slotnumber/]portnumber[, “alias”] Availability Admin Release V3.1.x and V4.1.x 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.
perfAddSCSIMonitor Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands perfAddUserMonitor Add a user-defined filter-based monitor. Synopsis: V3.1.x perfAddUserMonitor portnumber, “grouplist”[,”alias”] Synopsis: V4.1.x perfAddUserMonitor [slotnumber/]portnumber, “grouplist”[,”alias”] Availability Admin Release V3.1.x and V4.1.x Description Use this command to define a special mechanism to qualify frames for statistics gathering to fit your own special need.
perfAddUserMonitor Note: This command requires an Advanced Performance Monitoring license. Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15).
Fabric OS Commands 488 grouplist Specify up to 6 sets of Offset, Mask, and ValueList separated by a semicolon (;). The entire grouplist operand must be enclosed in quotation marks. This operand is required. The grouplist operand must be specified in the following format: “offset, Mask, ValueList; offset, Mask, ValueList” For example: “4, 0xff, 0x22; 12, 0xff, 0x01” The grouplist component values are as follows: ■ Offset - Specify the offset within the frame.
perfAddUserMonitor Example To add a filter based monitor for all Extended Link Service request (R_CTL=0x22 and TYPE=0x01) to blade 2 port 4: switch:admin> perfAddUserMonitor 2/4, “4, 0xff, 0x22; 12, 0xff, 0x01” User monitor #0 added switch:admin> As a special case, to add a filter based monitor for SOFi3 on blade 2 port 4: switch:admin> perfAddUserMonitor 2/4, “0, 0xff, 6” User monitor #1 added switch:admin> See Also perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddRWMonitor perfAddSCSIMonitor
Fabric OS Commands perfAddWriteMonitor Add a filter-based monitor for the SCSI Write command. Synopsis: V3.1.x perfAddWriteMonitor portnumber[, “alias”] Synopsis: V4.1.x perfAddWriteMonitor [slotnumber/]portnumber[, “alias”] Availability Admin Release V3.1.x and V4.1.x 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.
perfAddWriteMonitor Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands perfCfgClear Clear the previously saved performance monitoring configuration settings from non-volatile memory. Synopsis perfCfgClear Availability Admin Release V3.1.x and V4.1.x Description Use this command to clear the previously saved end-to-end and filter configuration settings of performance monitoring from non-volatile memory. Note: This command requires an Advanced Performance Monitoring license. Operands None.
perfCfgClear See Also perfCfgRestore perfCfgSave Fabric OS Version 3.1.x/4.1.
Fabric OS Commands perfCfgRestore Restore performance monitoring configuration settings from non-volatile memory. Synopsis perfCfgRestore Availability Admin Release V3.1.x and V4.1.x Description Use this command to restore the performance monitoring configuration information from non-volatile memory. Note: This command requires an Advanced Performance Monitoring license. Operands None.
perfCfgRestore See Also perfCfgClear perfCfgSave Fabric OS Version 3.1.x/4.1.
Fabric OS Commands perfCfgSave Save performance monitoring configuration settings to non-volatile memory. Synopsis perfCfgSave Availability Admin Release V3.1.x and V4.1.x Description Use this command to save the current end-to-end and filter configuration settings of performance monitoring into non-volatile memory. This enables the performance monitoring configuration to be saved over power off cycles. Note: This command requires an Advanced Performance Monitoring license. Operands None.
perfCfgSave See Also perfCfgClear perfCfgRestore Fabric OS Version 3.1.x/4.1.
Fabric OS Commands perfcleareemonitor Clears statistics counters of an end-to-end monitor on a port. Synopsis: V3.1.x perfcleareemonitor portnumber[, monitorId] Synopsis: V4.1.x perfcleareemonitor [slotnumber/]portnumber[, monitorId] Availability Admin Release V3.1.x and V4.1.x Description Use this command to clear statistics counters for all or a specified End-to-End monitor on a port.
perfcleareemonitor Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands perfclearfiltermonitor Clears statistics counters of a filter-based monitor. Synopsis: V3.1.x perfclearfiltermonitor portnumber [, monitorId] Synopsis: V4.1.x perfclearfiltermonitor [slotnumber/]portnumber [, monitorId] Availability Admin Release V3.1.x and V4.1.x Description Use this command to clear statistics counters for all or a specified filter-based monitor.
perfclearfiltermonitor Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands perfClrAlpaCrc Clear an AL_PA device’s CRC count by the port and AL_PA. Synopsis: V3.1.x perfClrAlpaCrc portnumber[, ALPA] Synopsis: V4.1.x perfClrAlpaCrc [slotnumber/]portnumber[, ALPA] Availability Admin Release V3.1.x and V4.1.x Description Use this command to clear a specific AL_PA device's CRC error counter.
perfClrAlpaCrc Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands perfDelEEMonitor Delete an end-to-end monitor on port. Synopsis: V3.1.x perfDelEEMonitor portnumber[, monitorId] Synopsis: V4.1.x perfDelEEMonitor [slotnumber/]portnumber[, monitorId] Availability Admin Release V3.1.x and V4.1.x Description Use this command to delete an End-to-End monitor on a port. After a successful execution of this command, a message displays confirming that this monitor has successfully been deleted.
perfDelEEMonitor Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands perfDelFilterMonitor Delete a filter-based monitor. Synopsis: V3.1.x perfDelFilterMonitor portnumber[, monitorId] Synopsis: V4.1.x perfDelFilterMonitor [slotnumber/]portnumber[, monitorId] Availability Admin Release V3.1.x and V4.1.x 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.
perfDelFilterMonitor Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands perfHelp Displays performance monitoring help information. Synopsis perfHelp Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the available performance monitoring help commands. Note: This command requires an Advanced Performance Monitoring license. Operands None. 508 Fabric OS Version 3.1.x/4.1.
perfHelp Example To display commands related to performance monitoring: switch:admin> perfHelp perfCfgSave perfCfgRestore perfCfgClear perfClrAlpaCrc perfShowAlpaCrc perfAddEEMonitor perfDelEEMonitor perfClearEEMonitor perfShowEEMonitor perfSetPortEEMask perfShowPortEEMask perfAddUserMonitor perfAddReadMonitor perfAddWriteMonitor perfAddRWMonitor perfAddSCSIMonitor perfAddIPMonitor perfDelFilterMonitor perfClearFilterMonitor perfShowFilterMonitor Save Performance configuration Restore Performance configur
Fabric OS Commands perfSetPortEEMask Set overall mask for end-to-end (EE) monitors. Synopsis: V3.1.x perfSetPortEEMask portnumber, “TxSIDMsk”,”TxDIDMsk”, ”RxSIDMsk”,”RxDIDMsk” Synopsis: V4.1.x perfSetPortEEMask [slotnumber/]portnumber, “TxSIDMsk”, ”TxDIDMsk”,”RxSIDMsk”,”RxDIDMsk” Availability Admin Release V3.1.x and V4.1.x Description Use this command to set the mask for the EE monitors of a port.
perfSetPortEEMask Note: This command requires an Advanced Performance Monitoring license. Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15).
Fabric OS Commands Example To set the overall mask for end-to-end monitors on blade 2 port 4: switch:admin> perfsetporteemask 2/4, "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 512 Fabric OS Version 3.1.x/4.1.
perfShowAlpaCrc perfShowAlpaCrc Displays the AL_PA CRC count by port or by AL_PA. Synopsis: V3.1.x perfShowAlpaCrc portnumber[, ALPA] Synopsis: V4.1.x perfShowAlpaCrc [slotnumber/]portnumber[, ALPA] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display a specific AL_PA device CRC error count by the port or AL_PA. If the AL_PA operand is specified, only the CRC count for that AL_PA device is displayed.
Fabric OS Commands Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
perfShowEEMonitor perfShowEEMonitor Displays end-to-end monitor information and frame traffic on a port. Synopsis: V3.1.x perfShowEEMonitor portnumber[, interval] Synopsis: V4.1.x perfShowEEMonitor [slotnumber/]portnumber[, interval] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display end-to-end monitor information and frame traffic on a port.
Fabric OS Commands Note: This command requires an Advanced Performance Monitoring license. Operands This command has the following operands: 516 slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15).
perfShowEEMonitor Example To display end-to-end monitor frame traffic on blade 4 port 5 at an interval of every 6 seconds: switch:admin> perfShowEEMonitor 4/5, 6 perfShowEEMonitor 4 1: Tx/Rx are # of bytes and crc is # of 0 1 2 3 ------------- ------------- ------------- ------------crc Tx Rx crc Tx Rx crc Tx Rx crc Tx Rx ============= ============= ============= ============= 0 0 0 0 0 0 0 0 0 0 0 0 0 53m 4.9m 0 53m 4.9m 0 53m 4.9m 0 53m 4.9m 0 53m 4.4m 0 53m 4.4m 0 53m 4.4m 0 53m 4.4m 0 53m 4.8m 0 53m 4.
Fabric OS Commands See Also perfAddEEMonitor 518 Fabric OS Version 3.1.x/4.1.
perfShowFilterMonitor perfShowFilterMonitor Displays filter-based monitor information and frame traffic for a port. Synopsis: V3.1.x perfShowFilterMonitor portnumber[, interval] Synopsis: V4.1.x perfShowFilterMonitor [slotnumber/]portnumber[, interval] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display all the filter-based monitors defined on the specified port and the traffic count values.
Fabric OS Commands Operands This command has the following operand: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
perfShowFilterMonitor To display filter monitor information on blade 2 port 5: switch:admin> perfshowfiltermonitor 2/5 There are 7 filter-based monitors defined on port 5. KEY ALIAS OWNER_APP OWNER_IP_ADDR FRAME_COUNT ----------------------------------------------------------------0 SCSI_Frame TELNET N/A 0x00000000002c2229 1 SCSI_WR TELNET N/A 0x000000000000464a 2 SCSI_RW TELNET N/A 0x000000000000fd8c 3 SCSI_RW WEB_TOOLS 192.168.169.40 0x0000000000007ba3 4 SCSI_RW WEB_TOOLS 192.168.169.
Fabric OS Commands perfShowPortEEMask Displays the current end-to-end mask of a port. Synopsis: V3.1.x perfShowPortEEMask portnumber Synopsis: V4.1.x perfShowPortEEMask [slotnumber/]portnumber Availability All users. Release V3.1.x and V4.1.x 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.
perfShowPortEEMask Note: This command requires an Advanced Performance Monitoring license. Operands This command has the following operand: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15).
Fabric OS Commands See Also perfAddEEMonitor perfDelEEMonitor perfShowEEMonitor perfSetPortEEMask perfShowPortEEMask 524 Fabric OS Version 3.1.x/4.1.
pkicreate pkicreate Create pki objects. Synopsis pkicreate Availability Admin Release V4.1.x Description Use this command in non-secure mode to create pki objects: ■ Switch private key and CSR ■ Private key passphrase ■ Install root certificate This command does not create the switch certificate. The switch certificate should be obtained offline from Certificate Authority. In secure mode this command will exit with a warning and will not create pki objects. Operands None.
Fabric OS Commands If run in secure mode the following error message is displayed: switch:admin> pkicreate Warning !! Switch is in secure mode. Can not create new Pki Objects. Exiting... See Also None. 526 Fabric OS Version 3.1.x/4.1.
pkiremove pkiremove Remove existing pki objects. Synopsis pkiremove Availability Admin Release V4.1.x Description Use this command to remove of pki objects in non secure mode. It removes switch private key, private key passphrase, CSR, root certificate and switch certificate. In secure mode, it displays a message and does not remove pki objects. Operands None.
Fabric OS Commands If run in secure mode the following error message is displayed: switch:admin> pkiremove This Switch is in secure mode. Removing Pki objects is not allowed. Exiting... See Also None. 528 Fabric OS Version 3.1.x/4.1.
pkishow pkishow Displays existing pki objects. Synopsis pkishow Availability Admin Release V4.1.x Description Use this command to display existence of pki objects i.e. switch private key, private key passphrase, CSR, root certificate and switch certificate. Operands None. Example To view pki objects: switch:admin> pkishow Passphrase : Exist Private Key : Exist CSR : Exist Certificate : Empty Root Certificate: Exist switch:admin> See Also None. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands portcamshow Displays port based filter CAM utilization. Synopsis: V3.1.x portcamshow [portnumber] Synopsis: V4.1.x portcamshow [slotnumber/][portnumber] Availability Admin Release V3.1.x and V4.1.x Description Use this command to display the current filter CAM utilization of all ports or one port specified at input. The following information is displayed: 530 SID used Displays the total number of CAM entries used by this port.
portcamshow Operands This command has the following operand: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands To display the filter CAM utilization for a single port on a switch: switch:admin> portcamshow 3 -------------------------------------------------Area SID used DID used SID entries DID entries 3 3 4 220100 2b23e8 220800 2b23e2 220c00 2b23e0 2b23e4 -------------------------------------------------Quad ports (SID Free, DID Free) 0-3 (61, 508) switch:admin> See Also portzoneshow switchshow 532 Fabric OS Version 3.1.x/4.1.
portcfgdefault portcfgdefault Restore the port configuration to default values. Synopsis: V3.1.x portcfgdefault portnumber Synopsis: V4.1.x portcfgdefault [slotnumber/]portnumber Availability Admin Release V3.1.x and V4.1.x Description Use this command to reset any special configuration values on a port to their factory defaults. You can view the current port configuration using the portcfgshow command. Operands This command has the following operand: slotnumber (V4.1.
Fabric OS Commands Example The following example configures switch port 3 on blade 1 to factory defaults: switch:admin> portcfgdefault 1/3 Committing configuration...done. See Also portcfgeport portcfggport portcfglongdistance portcfgpersistentdisable portcfgpersistentenable portcfglport portcfgspeed portcfgshow portcfgtrunkport 534 Fabric OS Version 3.1.x/4.1.
portCfgEport portCfgEport Enable or disable a port from becoming an E_Port. Synopsis: V3.1.x portCfgEport portnumber, mode Synopsis: V4.1.x portCfgEport [slotnumber/]portnumber, mode Availability Admin Release V3.1.x and V4.1.x Description This command allows a user to enable or disable a port from becoming an E_Port. The E_Port capability is enabled by default unless this command is used to disable it.
Fabric OS Commands Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
portCfgGport portCfgGport Designate a port as a locked G_Port. Synopsis: V3.1.x portCfgGport portnumber, mode Synopsis: V4.1.x portCfgGport [slotnumber/]portnumber, mode Availability Admin Release V3.1.x and V4.1.x 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.
Fabric OS Commands Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
portcfgislmode portcfgislmode Enable or disable ISL R_RDY Mode on a port. Synopsis: V3.1.x portcfgislmode portnumber, [1 | 0] Synopsis: V4.1.x portcfgislmode [slotnumber/]portnumber, [1 | 0] Availability Admin Release V3.1.x and V4.1.x Description Use this command to enable or disable ISL R_RDY Mode on a port. If enabling ISL R_RDY Mode on a port make sure the PID format is consistent across the entire fabric. Refer to the configure command for more information on the Core PID format.
Fabric OS Commands portnumber Specify a port number. Valid values for port number vary depending on the switch type. This operand is required. [1 | 2] Specify 1 to enable ISL R_RDY mode. Specify 0 to disable ISL R_RDY mode. This operand is required. Example To enable ISL R_RDY mode on switch port 3: switch:admin> portcfgislmode 3, 1 Committing configuration...done. ISL R_RDY Mode is enabled for port 3. Please make sure the PID formats are consistent across the entire fabric.
portCfgLongDistance portCfgLongDistance Configure a port to support long distance links. Synopsis: V3.1.x portCfgLongDistance portnumber[, "distance"] Synopsis: V4.1.x portcfglongdistance [slotnumber/]portnumber [distance_level][vc_translation_link_init] Availability Admin Release V3.1.x and V4.1.x Description V3.1.x 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 is used as an E_Port.
Fabric OS Commands “long” for level 2 long distance. In the switchShow output, the format is Lx, where x is the long distance level number, except for level 0, which is not displayed in switchShow. The vc_translation_link_init operand only applies to long distance setup, it does not affect normal link. It is added to ensure the long distance link initialization sequence. It is not required for long distance, but may be useful when initiating L1 and L2 links.
portCfgLongDistance ■ LD: Dynamic long distance configuration. The buffer credits for the given E-port are automatically configured based on the actual link distance. Up to a total of 63 full size frame buffers will be reserved depending upon the distance measured during E-port initialization. The option “VC Translation Link Init” is used to enable the long distance link initialization sequence. By default this option is set to 0 (disabled). An input of Ctrl-D cancels the configuration update.
Fabric OS Commands Operands This command has the following operands: 544 slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
portCfgLongDistance distance_level (V4.1.x only) This operand indicates the distance to the connected port. This operand is required. The valid values for this operand are: L0: Re-configure the port to be a regular switch port. The number of buffers reserved for the port supports up to 10km links. LE: Level E mode is for E ports for distances beyond 5km and up to 10km especially for 2G link speeds. L0.5 (LM): Level 0.5 long distance, up to 25km. L1: Level one long distance, up to 50km.
Fabric OS Commands The following example configures the switch port 4/15 to support a 100km link and be initialized using long distance link initialization protocol. with V4.1.x: switch:admin> portcfglongdistance portCfgLongDistance 4/15 2/3, L2 1 done. switch:admin> portshow 4/15 portCFlags: 0x1 portFlags: 0x20001 PRESENT LED portType: 1.
portCfgLport portCfgLport Lock a port as an L_PORT. Synopsis: V3.1.x portCfgLport portnumber, lockmode[, privatemode] Synopsis: V4.1.x portCfgLport [slotnumber/]portnumber, lockmode[, privatemode] Availability Admin Release V3.1.x and V4.1.x 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.
Fabric OS Commands Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
portcfgpersistentdisable portcfgpersistentdisable Disable a port persistently. Synopsis portcfgpersistentdisable portnumber Availability Admin Release V3.1.x and V4.1.x Description Use this command to persistently disable a port. Persistently disabled ports remain disabled across power cycles, switch reboots, and switch enables. By default a port is enabled persistently. The change in configuration is effective immediately.
Fabric OS Commands Operands This command has the following operands: portnumber Specify a port number. Valid values for port number vary depending on the switch type. This operand is required. When no operand is specified, the command reports the current port persistent disable status for all ports in the switch. The value of YES is displayed for ports that are persistently disabled. Example To configure port 3 as persistently disabled: switch:admin> portcfgpersistentdisable 3 Committing configuration...
portcfgpersistentenable portcfgpersistentenable Enable a port persistently. Synopsis portcfgpersistentenable portnumber Availability Admin Release V3.1.x and V4.1.x Description Use this command to persistently enable a port. Persistently enabled ports remain enabled across power cycles, switch reboots, and switch enables. By default a port is enabled persistently. The change in configuration is effective immediately.
Fabric OS Commands When no operand is specified, the command reports the current port persistent enabled status for all ports in the switch. The value of YES is displayed for ports that are persistently enabled. Example To configure port 3 as persistently enabled: switch:admin> portcfgpersistentenable 3 Committing configuration...done.
portCfgShow portCfgShow Displays port configuration settings. Synopsis: V3.1.x portCfgShow [portnumber] Synopsis: V4.1.x portCfgShow [slotnumber/][portnumber] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the current configuration of all ports. If no operand is specified, all the port configuration settings are displayed for that switch, or for the StorageWorks Core logical switch.
Fabric OS Commands ■ Locked L_Port is displayed as ON when port is locked to L_Port only or blank (--) when L_Port lock mode is disabled (and it behaves as a U_Port). This value is set by the portCfgLport command. ■ Locked G_Port is displayed as ON when port is locked to G_Port only or blank (--) when G_Port lock mode is disabled (and it behaves as a U_Port). This command is set by the portCfgGport command.
portCfgShow Example To display the configuration settings of ports on a switch in V3.1.x: switch:admin> portcfgshow Ports 0 1 2 3 4 5 6 7 -------------------+--+--+--+--+----+--+--+-Speed 2G 2G 2G 2G 2G 2G 2G 2G Trunk Port .. .. ON ON ON ON ON ON Long Distance .. .. .. .. .. .. .. .. VC link init .. .. .. .. .. .. .. .. Locked L_Port .. .. .. .. .. .. .. .. Locked G_Port .. .. .. .. .. .. .. .. Disabled E_Port .. .. .. .. .. .. .. .. Persistent Disable .. .. .. .. .. .. .. .. ISL R_RDY Mode .. .. .. ..
Fabric OS Commands portCfgSpeed Configure the port speed level. Synopsis: V3.1.x portCfgSpeed portnumber, speed_level Synopsis: V4.1.x portCfgSpeed [slotnumber/]portnumber, speed_level Availability Admin Release V3.1.x and V4.1.x 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.
portCfgSpeed Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands portCfgTrunkport Configure a port to be enabled or disabled for trunking. Synopsis: V3.1.x portCfgTrunkport portnumber, mode Synopsis: V4.1.x portCfgTrunkport [slotnumber/]portnumber, mode Availability Admin Release V3.1.x and V4.1.x Description Use this command to enable or disanble a port for trunking. Note: This command requires a Trunking license. 558 Fabric OS Version 3.1.x/4.1.
portCfgTrunkport Operands This command has the following operand: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands portdebug Set debug level and verbose level of port modules. Synopsis portdebug dbg_lvl, vbs_lvl Availability Admin Release V3.1.x and V4.1.x Description Use this command to set the debug level and verbose level of port modules. Operands This command has the following operands: dbg_lvl Specify the debug level to be set for port modules. Valid values are 1–5. vbs_lvl Specify the verbose level to be set for port modules. Valid values are 1–5.
portDisable portDisable Disable a switch port. Synopsis: V3.1.x portDisable portnumber Synopsis: V4.1.x portDisable [slotnumber/]portnumber Availability Admin Release V3.1.x and V4.1.x 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.
Fabric OS Commands Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
portEnable portEnable Enable a switch port. Synopsis: V3.1.x portEnable portnumber Synopsis: V4.1.x portEnable [slotnumber/]portnumber Availability Admin Release V3.1.x and V4.1.x 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.
Fabric OS Commands Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
portErrShow portErrShow Displays port error summary. Synopsis portErrShow Availability All users. Release V3.1.x and V4.1.x 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. frames rx Frames received. enc in Encoding errors inside frames. crc err Frames with CRC errors.
Fabric OS Commands frjt Frames rejected with F_RJT. fbsy Frames busied with F_BSY. Operands None.
portflagsshow portflagsshow Displays the port status bitmaps for all ports in a switch Synopsis portflagsshow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the following status for a port: SNMP Displays whether the port is online or offline. Physical Displays the port physical status. Valid values are In_Sync and No_Light. Flags Displays whether there is a SFP inserted in the port, whether the port is active, and the port type. Options None.
Fabric OS Commands Example To display the port status for all ports in the switch: switch:admin> portflagsshow Port SNMP Physical Flags ------------------------------0: Offline No_Module PRESENT 1: Offline No_Module PRESENT 2: Offline No_Light PRESENT 3: Offline No_Light PRESENT 4: Offline No_Light PRESENT 5: Offline No_Module PRESENT 6: Offline No_Module PRESENT 7: Offline No_Module PRESENT 8: Offline No_Module PRESENT 9: Offline No_Module PRESENT 10: Offline No_Module PRESENT 11: Offline No_Module PRESEN
portLEDTest portLEDTest Exercise the user port LEDs. Synopsis portLEDTest [-npass count][-ports itemlist] Availability Admin Release V4.1.x Description Use this command to exercise the user port LEDs in the current switch ON/OFF by setting the ATTN LEDs to green for the ON condition and black for the OFF condition. The SPEED LEDs are initially set to black before the command execution. The SPEED LEDs are set to green once the command is executing.
Fabric OS Commands Example To test port LEDs: switch:admin> portledtest -ports 1/1-1/5 passed. switch:admin> See Also itemlist ledtest switchdisable switchenable 570 Fabric OS Version 3.1.x/4.1.
portLogClear portLogClear Clear the port log. Synopsis portLogClear Availability Admin Release V3.1.x and V4.1.x 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, the following message appears as the first line.
Fabric OS Commands Example To clear the port log: switch:admin> portLogClear switch:admin> portLogShow port log is empty switch:admin> Errors The following errors disable the port log: FCIU, IUBAD FCIU, IUCOUNT FCPH, EXCHBAD FCPH, EXCHFREE NBFSM, DUPEPORTSCN UCAST, RELICPDB See Also portLogDump portLogShow 572 Fabric OS Version 3.1.x/4.1.
portLogDump portLogDump Displays the port log without page breaks. Synopsis portLogDump [count[, saved[, portid]]] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the port log, listing all entries in the log without page breaks. This command displays the same information as portLogShow, but portLogShow prompts the user to enter “returns” between each page.
Fabric OS Commands Cmd Defined by the event. Refer to the HP StorageWorks Fabric Operating System Procedures Version 3.1.x/4.1.x User Guide for more information. Args Displays more information about the event. For ioctl events, these are the I/O control arguments For Tx and Rx, these are the first two header words and word four of the FC-PH frame along with the first word of the payload and internal decoding field.
portLogDump See Also portLogClear portLogShow uptime Fabric OS Version 3.1.x/4.1.
Fabric OS Commands portLogDumpPort Displays the port log of specified port, without page breaks. Synopsis: V3.1.x portLogDumpPort port Synopsis: V4.1.x portLogDumpPort portid Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the port log of specified port. The command displays all entries in the log without any page breaks. It is identical to portLogShowPort, except that portLogShow prompts the user to type return between each page of output.
portLogDumpPort Event Displays the task event that generated log entry. Port # Displays the Port number that logged the event. Cmd Defined by the event. Refer to the HP StorageWorks Fabric Operating System Procedures Version 3.1.x/4.1.x User Guide for more information. Args Displays more information about the event.
Fabric OS Commands See Also portLogClear portLogShow uptime 578 Fabric OS Version 3.1.x/4.1.
portloginshow portloginshow Displays port logins. Synopsis: V3.1.x portloginshow portnumber Synopsis: V4.1.x portloginshow [slotnumber/]portnumber Availability All users. Release V3.1.x and V4.1.x Description Use this command to display port login information. Some information varies with the switch model and port type. The lines of the display show: Type Type of login: fe - FLOGI, Fabric Login to Fabric F_Port. ff - PLOGI, Process Login to specific N- Ports or well-known address like Name Server.
Fabric OS Commands There is further information about the login after the above columns. This can include the DID (Destination Identifier) that the port is logged on to. Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required.
portlogpdisc portlogpdisc Set or clear the debug_pdisc_flag. Synopsis portlogpdisc lvl Availability Admin Release V3.1.x and V4.1.x Description Use this command to set or clear the debug_pdisc_flag. Operands This command has the following operand: lvl Specify either 0 to clear the flag or 1 to set the pdisc_flag. Example The following example shows how to set the pdisc_flag: switch:admin> portlogpdisc 1 PDISC log setting = 1 See Also None. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands portLogShow Displays the port log. Synopsis portLogShow [count, saved, portid] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the port log. This command displays 22 entries at a time. The portLogShow command displays the same information as portLogDump, but it allows you to enter a “return” after each page of output. Port logs are circular log files in the switch firmware, which can save up to 1024 entries per logical switch in V3.1.
portLogShow Cmd Defined by the event. Refer to the HP StorageWorks Fabric Operating System Procedures Version 3.1.x/4.1.x User Guide for more information. Args Displays more information about the event. For ioctl events, these are the I/O control arguments For Tx and Rx, these are the first two header words and word four of the FC-PH frame along with the first word of the payload and internal decoding field.
Fabric OS Commands Example To display the port log: switch:admin> portlogshow 10 Oct 16 task event port cmd args ---------------------------------------------WED OCT 16 12:35:24 2002 12:35:24.199 tReceive debug 5 efd00020,00000102,00000000,00000000 12:35:24.199 tReceive debug 5 dede0001,00000f37,00000000,00000000 12:35:24.199 tReceive pstate 5 LR3 12:35:24.199 tReceive debug 5 00acedd6,00000000,00000006,00009601 12:35:24.199 tReceive debug 5 00acedd5,00000000,00000000,00009601 12:35:24.
portlogshowport portlogshowport Displays the port log of specified port, with page breaks. Synopsis: V3.1.x portlogshowport [portid [, count [, saved]]] Synopsis: V4.1.x portlogshowport [portid] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the port log, showing 22 entries at a time. It is identical to portlogdump, except that portlogdump does not prompts the user to type return between each page of output.
Fabric OS Commands portid Specify a non-zero value that specifies which port will be displayed. Example The following example shows a section of the port log with an E_Port coming online. The ELP and EFP exchanges are shown; a name service request was processed. switch:admin> portlogshowport 24 Feb 6 task event port cmd args -----------------------------------------------------08:35:27.899 tShell pstate 14 OL1 08:35:27.899 tReceive pstate 14 LR2 08:35:27.916 tReceive pstate 14 AC 08:35:28.
portLoopbackTest portLoopbackTest Functional test of port N->N path. Synopsis: V3.1.x portLoopbackTest [passCount] Synopsis: V4.1.x portLoopbackTest [--slot number][-nframes count] [-lb_mode mode][-spd_mode mode][-ports itemlist] Availability Admin Release V3.1.x and V4.1.x 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.
Fabric OS Commands 6. Check if the transmit, receive or class 3 receiver counters are stuck at some value. 7. Check if the number of frames transmitted is not equal to the number of frames received. 8. Repeat steps 2 through 7 for all ports present until: — The number of frames (or passCount) requested is reached. — All ports are marked bad. At each pass, the frame is created from a different data type. If seven passes are requested, seven different data types are used in the test.
portLoopbackTest -lb_mode mode (V4.1.x only) Specify the loopback mode for the test. By default, this test uses internal loopback. Valid values are as follows: 1 Port Loopback (loopback plugs) 2 External (SERDES) loopback 5 Internal (parallel) loopback -spd_mode mode (V4.1.x only) Specify the speed mode for the test. For 1 Gbit/sec only products it is ignored. The exact operation of modes 3 through 6 depends upon the loopback mode selected.
Fabric OS Commands Example To run the portLoopbackTest 100 times (V3.1.x example): switch:admin> portLoopbackTest 100 Running Port Loopback Test .... passed. To run the portLoopbackTest (V4.1.x example): switch:admin> portloopbacktest -ports 1/38-1/45 -nframes 1 -lb_mode 1 Running Port Loopback Test .... passed. Errors Below are possible error messages if failures are detected: ■ For V3.1.x: DIAG-INIT DIAG-PORTDIED DIAG-XMIT DIAG-TIMEOUT DIAG-ERRSTAT DIAG-STATS DIAG-DATA ■ For V4.1.
portLoopbackTest See Also camtest centralmemorytest cmemretentiontest cmitest crossporttest filtertest portloopbacktest portregtest ramtest spinsilk sramretentiontest Fabric OS Version 3.1.x/4.1.
Fabric OS Commands portname Assign or display a port name. Synopsis: V3.1.x portname port_number, “port_name” Synopsis: V4.1.x portname [slotnumber/]portnumber, “portname” Availability Admin Release V3.1.x and V4.1.x Description Use this command to assign or display a port name. Both operands are optional for this command. With both the operands present, the port name string will be assigned to the port. With only the port name operand, the previously assigned port name will be displayed.
portname Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands portPerfShow Displays port throughput performance in bytes, kilobytes, or megabytes. Synopsis portPerfShow [interval] Availability All users. Release V3.1.x and V4.1.x 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 Enter, Ctrl-C, or Ctrl-D is entered.
portPerfShow Example To display port throughput for a 16 port switch: switch:admin> portperfshow 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 -----------------------------------------------------------------------------0 0 0 0 0 0 0 76m 0 0 0 0 0 0 0 76m 96 0 96 0 0 96 0 76m 0 0 0 0 0 0 0 76m 0 0 0 0 0 0 0 76m 0 0 0 0 0 0 0 76m To display port throughput for a StorageWorks Core switch: switch:admin> portPerfShow 0 1 2 3 4 5 6 7 8 9 10 ============================================================== slot 1: 0 0 0 0
Fabric OS Commands portRegTest Bit write/read test of the ASIC SRAMs and registers. Synopsis: V3.1.x portRegTest Synopsis: V4.1.x portRegTest [--slot number][-ports itemlist] [-skiptests mask][-verbose mode] Availability Admin Release V3.1.x and V4.1.x Description Use this command to verify that SRAM and register data bits in each ASIC can be independently written and read. The method used is to write a walking pattern to each location.
portRegTest 6. 0x0020 7. 0x0040 8. 0x0080 9. 0x0100 10. 0x0200 11. 0x0400 12. 0x0800 13. 0x1000 14. 0x2000 15. 0x4000 16. 0x8000 The 6-bit register is tested with the following pattern for V4.1.x: 0x0001 0x0010 0x0100 0x1000 0x0002 0x0020 0x0200 0x2000 0x0004 0x0040 0x0400 0x4000 0x0008 0x0080 0x0800 0x8000 Repeat the above steps until all ASIC SRAMs and registers have been tested. Operands For V3.1.x, none. For V4.1.
Fabric OS Commands -skiptests mask A bit mask that defines which of the register test subtests to skip. By default, all subtests will be performed. Valid mask values include one or more of the following: Value Description 0x2 Skip retry register test. 0x4 Skip statistics register test. 0x8 Skip walk-1 test. 0x10 Skip credit counter test. -verbose mode Specify a non-zero value to enable verbose mode. The default value is to disable this mode.
portRegTest See Also camtest centralmemorytest cmemretentiontest cmitest crossporttest filtertest itemlist portloopbacktest spinsilk sramretentiontest statstest Fabric OS Version 3.1.x/4.1.
Fabric OS Commands portRouteShow Displays routing tables for a port. Synopsis: V3.1.x portRouteShow portnumber Synopsis: V4.1.x portRouteShow [slotnumber/]portnumber Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the port address ID and the contents of the following port routing tables: External unicast routing table Shows unicast frame routing to another switch element in the fabric.
portRouteShow Internal unicast routing table Lists all ports in the local switch that a unicast frame can reach from portnumber. Format is destination_port: output_ports_bitmap Because the destination_port is in the local switch, output_ports_bitmap usually contains one bit with a bit position number representing the destination_port number. Multicast routing table Shows multicast frame routing to the destination multicast group.
Fabric OS Commands Example To display the port routing tables for blade 4 port 15: switch:admin> portRouteShow 4/15 port address ID: 0x02bf00 external unicast routing table: 1: 0x4 (vc=3) 2: 0x10000 (vc=0) internal unicast routing table: 60: 0x8000 (vc=2) 63: 0x1000 (vc=5) multicast routing table: 0-255: (all mcast aliases) 0x40 broadcast routing table: 0x19040 san116:user> See Also bcastShow fabricShow mcastShow switchShow topologyShow uRouteShow 602 Fabric OS Version 3.1.x/4.1.
portShow portShow Displays port status. Synopsis: V3.1.x portShow portnumber Synopsis: V4.1.x portShow [slotnumber/]portnumber Availability All users. Release V3.1.x and V4.1.x Description Use this command to display status information for a port. Information varies with the switch model and port type. The display shows: Table 15: PortShow Display Fields Field Description portCFlags Port control flags. portFlags Bit map of port status flags. portType Port type and revision numbers.
Fabric OS Commands Table 15: PortShow Display Fields (Continued) Field 604 Description portPhys Port physical state: No_Card - No interface card present No_Module - No module (SFP or other) present No_Light - Module not receiving light No_Sync - Receiving light but out of sync In_Sync - Receiving light and in sync Laser_Flt - Module is signaling a laser fault Port_Flt - Port marked faulty Diag_Flt - Port failed diagnostics Lock_Ref - Locking to the reference signal portScn Last state change notificat
portShow Table 15: PortShow Display Fields (Continued) Field Description Parity_err Real Tx data parity error. 2ndary_parity_err Secondary Tx data parity error. These are not real Tx data parity errors but rather forced by the ASIC due to certain central memory errors so that the transmitter will abort the frame. This field will only be displayed when there are errors. CMI_bus_err Control message interface errors. The second column shows Link Error Status Block counters.
Fabric OS Commands Example To display the status for a specified E_Port: switch:admin> portshow 15 portName: switch:admin> portShow 2/15 portFlags: portCFlags: 0x300082d7 portLbMod: 0x0 0x10 PRESENT ACTIVE E_PORT G_PORT U_PORT SEG MENTED CBL_LBportFlags: LOGIN 0x20001 PRESENT DISABLED LED portType: 4.1 portType: 1.
portstatsclear portstatsclear Clear the hardware statistics of a specified switch port. Synopsis: V3.1.x portstatsclear portnumber Synopsis: V4.1.x portstatsclear [slotnumber/]portnumber Availability Admin Release V3.1.x and V4.1.x Description This command clears the hardware statistics for a specified switch port. At the same time, this command also clears the hardware statistics for the associated ports in the target port quad. Operands This command has the following operands: slotnumber (V4.1.
Fabric OS Commands Example To clear the hardware statistics for slot 8 port 5: switch:admin> portstatsclear 8/5 switch:admin> See Also portstatshow 608 Fabric OS Version 3.1.x/4.1.
portStatsShow portStatsShow Displays port hardware statistics. Synopsis: V3.1.x portStatsShow portnumber Synopsis: V4.1.x portStatsShow [slotnumber/]portnumber Availability All users. Release V3.1.x and V4.1.x Description Use this command to display port hardware statistics counters. stat_wtx 4-byte words transmitted. stat_wrx 4-byte words received. stat_ftx Frames transmitted. stat_frx Frames received. stat_c2_frx Class 2 frames received. stat_c3_frx Class 3 frames received.
Fabric OS Commands 610 er_crc Frames with CRC errors. er_trunc Frames shorter than minimum. er_toolong Frames longer than maximum. er_bad_eof Frames with bad end-of-frame. er_enc_out Encoding error outside frames. er_disc_c3 Class 3 frames discarded. fl_open Number of OPNyx sent. fl_opened Number of OPNyx received. fl_openfr Number of OPNfr sent. fl_cls_idle CLS sent due to loop idle. fl_cls_rx CLS received when OPEN. fl_bb_stall OPN/CLS BB_Credit stalls.
portStatsShow Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
Fabric OS Commands Example To display the basic set of statistics for blade 2 port 3: switch:admin> portstatsshow 2/5 stat_wtx 24081 4-byte words transmitted stat_wrx 24081 4-byte words received stat_ftx 141 Frames transmitted stat_frx 141 Frames received stat_c2_frx 0 Class 2 frames received stat_c3_frx 117 Class 3 frames received stat_lc_rx 12 Link control frames received stat_mc_rx 0 Multicast frames received stat_mc_to 0 Multicast timeouts stat_mc_tx 0 Multicast frames transmitted tim_rdy_pri 0 Time R_
portswap portswap Swap area numbers of two switch ports. Synopsis portswap [slotnumber/]port1 [slotnumber/]port2 Availability Admin Release V4.1.x Description Use this command to swap area numbers for a pair of switch ports. Both switch ports must be disabled prior to executing this command. The portswap command cannot be used unless the feature is first enabled with the portswapenable command.
Fabric OS Commands Example The following command swaps area numbers between port 2 on slot1 with port5 on slot2: switch:admin> portswap 1/2 2/5 See Also switchshow portshow portenable portdisable portswapshow 614 Fabric OS Version 3.1.x/4.1.
portswapdisable portswapdisable Disable the portswap feature. Synopsis portswapdisable Availability Admin Release V4.1.x Description Use this command to disable the portswap feature. The portswap command cannot be used once this feature is disabled. Operands None. Example The following command disables the portswap feature: switch:admin> portswapdisable done. See Also portenable portdisable portshow portswapenable portswapshow switchshow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands portswapenable Enable the portswap feature. Synopsis portswapenable Availability Admin Release V4.1.x Description Use this command to enable the portswap feature. The portswap command cannot be used unless the feature is first enabled with this command. Operands None. Example The following command enables the portswap feature: switch:admin> portswapenable done. switch:admin> 616 Fabric OS Version 3.1.x/4.1.
portswapenable See Also portenable portdisable portshow portswapenable portswapshow switchshow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands portswapshow Displays information for any ports where area ID numbers have been swapped. Synopsis portswapshow Availability Admin Release V4.1.x Description Use this command to displays port and area information for those ports whose area number is different from the default area number. The default area number of a port is same as its switch port number. Operands None.
portswapshow See Also errshow portenable portdisable portshow portswap portswapdisable portswapenable switchshow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands porttest Functional test of a switch in a live fabric. Synopsis: V3.1.x porttest [ports, iteration, delay, timeout, pattern, patsize, seed] Synopsis: V4.1.x porttest [-ports itemlist][-iteration count] [-userdelay time][-timeout time][-pattern pattern] [-patsize size][-seed seed][-listtype porttype] Availability Admin Release V3.1.x and V4.1.
porttest Only one frame is transmitted and received at any one time. The port LEDs flicker green while the test is running. The following port types are supported: ■ E_ports ■ F_ports. (Must support ELS ECHO) ■ L_ports ■ N->N Loopback ports This command will not run on any other port type. The command performs the following actions: 1. Initiate tests on certain ports (porttest command) 2. Stop active tests on certain ports (stopporttest command) 3. Get the snapshot of the test result.
Fabric OS Commands iteration (V3.1.x only) Specify the number of times (or number of frames per port) to execute this test. Default value is -1 that is set the test to run until stopped. Valid values are: 0 Run the test on timeout mode. -1 Run the test until stopped. This operand is optional. delay (V3.1.x only) Specify the time delay in minutes between frames being sent. The default value is 20 minutes. This operand is optional. timeout (V3.1.
porttest -patsize size (V4.1.x only) Specify the size of the pattern. Default size of the pattern is 1024 bytes. Valid rang of values are 4 bytes through 2112 bytes. -seed seed Specify the seed pattern to be used with pattern. Default seed value is 0xaa. -listtype porttype Specify the type of ports to run porttest. The default value is -1. Valid values are: -1 All ports. -2 All E_ports. -3 All L_ports. -4 All F_ports. -5 All Loopback ports. (V4.1.x only) (V4.1.
Fabric OS Commands porttestshow Retrieve information from the current execution of the porttest command. Synopsis: V3.1.x porttestshow [ports] Synopsis: V4.1.x porttestshow [-ports itemlist] Availability Admin Release V3.1.x and V4.1.x Description Use this command to retrieve a snapshot of information from porttest command. Following information is displayed: ■ Pass/Fail information on a given port. ■ Port type tested.
porttestshow — ALL_LB_PORTS — SINGLE_PORT ■ pattern used in testing. ■ seed used in testing. ■ User Delay value. ■ Total iteration value. ■ Current test iteration. ■ Total Fails on this test. ■ Consecutive Fails on this test. ■ porttest Start Time. ■ porttest Stop Time. ■ Timeout value. ■ Error code if any. Operands This command has the following operands: ports (V3.1.x only) Specify the port to stop the test on. If omitted, the test will be executed on all possible ports.
Fabric OS Commands Example To view information on the current execution of the porttest command: switch:admin> porttestshow 6 Port 6 : PASS PortType: LOOPBACK PORT PortState: TESTING PortState: TX PortTypeToTest: ALL_PORTS Pattern: 0x1 Seed: 0xaa UserDelay: 10 TotalIteration: 100 TotalFail: 0 StartTime: Jul 1 09:03:49 Timeout: 0 switch:admin> CurrentIteration: 22 ConsecutiveFail: 0 StopTime: NONE ErrorCode: 0 See Also crossporttest fporttest loopporttest portloopbacktest porttest spinfab stopporttest 62
powerofflistset powerofflistset Sets slot power off list order. Synopsis powerofflistset Availability Admin Release V4.1.x Description Use this command to set the physical power off slot order. The system available power is compared to the system demand power to determine if there is enough power to operate. If there is less power available than the demand, then the power off list is processed until there is enough power for the system to operate.
Fabric OS Commands Example To modify the power off list order: switch:admin> powerofflistset Slot Current POL ------------------10 1st 9 2nd 8 3rd 7 4th 4 5th 3 6th 2 7th 1 8th 1st 2nd 3rd 4th 5th 6th 7th 8th slot slot slot slot slot slot slot slot to to to to to to to to be be be be be be be be power power power power power power power power off: off: off: off: off: off: off: off: (1..10) [10] 7 (1..10) [9] 8 (1..10) [9] (1..10) [10] (1..4) [4] 1 (2..4) [3] 2 (3..4) [3] (4..
powerofflistshow powerofflistshow Displays slot power off list order. Synopsis powerofflistshow Availability All users. Release V4.1.x Description Use this command to displays the order in which the physical slots will be powered off. The system available power is compared to the system demand power to determine if there is enough power to operate. If there is less power available than the demand, then the power off list is processed until there is enough power for the system to operate.
Fabric OS Commands See Also chassisshow powerofflistset psshow slotpoweroff slotpoweron slotshow 630 Fabric OS Version 3.1.x/4.1.
psShow psShow Displays power supply status. Synopsis psShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the current status of the switch power supplies. The format of the display varies according to the switch model and number of power supplies present. Optionally, depending upon switch model, the OEM Serial ID Data is displayed after each power supply status line.
Fabric OS Commands Example To view the status of the power supply for the current switch: switch:admin> psShow Power Supply #1 is OK DELTA DPS-1001AB-1E 23000000601 S1 Power Supply #2 is faulty DELTA DPS-1001AB-1E 23000000601 S1 Power Supply #3 is OK DELTA DPS-1001AB-1E 23000000601 S1 Power Supply #4 is absent IXD0111000088 IXD0111000162 IXD0111000120 See Also fanShow tempShow 632 Fabric OS Version 3.1.x/4.1.
ptdatashow ptdatashow Displays port data structures. Synopsis ptdatashow [slotnumber/]portnumber Availability All users. Release V4.1.x Description Use this command to display port data structures. Note: This command is not intended for normal user operation and is available to provide supplemental information during system debug. Operands This command has the following operands: slotnumber Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required.
Fabric OS Commands Example To display the port data structure for slot 1 port 1: switch:admin> ptdatashow 1/1 Port Data Structure for slot: 1, port: 1 Bloom Data Pointers: bloomp = 0xc6eb7200 (fbloomp ------------------blm_regs 0xc9b17000 blm_proc_dir fab_ptr 0xc04f0000 fab_Iop qdblm 0xc5702c00 chblm pt 0xc5701760 blm_miniS_handle = 0x00000000) 0xc50d9f20 0xc04f0050 0xc661b5a0 0xc57012e0 Bloom Local Variables --------------------blm_type = 0x00000012 G_PORT E_PORTto stop blm_state = 0x00000001 ONLINE p_p
ptphantomshow ptphantomshow Displays the quick-loop CAM tables. Synopsis ptphantomshow [slotnumber/]portnumber Availability All users.. Release V4.1.x Description Use this command to display the quick-loop CAM (Content Addressable Memory) tables. Note: This command is not intended for normal user operation and is available to provide supplemental information during system debug. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Operands This command has the following operands: slotnumber Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
ptpropshow ptpropshow Displays port properties. Synopsis ptpropshow [slotnumber/]portnumber | [slot] -all Availability All users.. Release V4.1.x Description Use this command to display the ASIC port properties contents for the specified port. Note: This command is not intended for normal user operation and is available to provide supplemental information during system debug. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Operands This command has the following operands: slotnumber Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required. The slot number must be followed by a slash ( / ) and the port number, so that each port is represented by both slot number (1 through 4, or 7 through 10), and port number (0 through 15). The StorageWorks Core switch has a total of 1–10 slots.
ptregshow ptregshow Displays ASIC port registers. Synopsis ptpropshow [slotnumber/]portnumber Availability All users.. Release V4.1.x Description Use this command to display the contents of port registers. Note: This command is not intended for normal user operation and is available to provide supplemental information during system debug. Operands This command has the following operands: slotnumber Specify the slot number for a StorageWorks Core switch.
Fabric OS Commands Example To display the port registers for slot 1 port 1: switch:admin> ptregshow 1/1 Port Registers for slot: 1, port: 1 0xc9b17000: 0xc9b17004: 0xc9b1700a: 0xc9b1700e: 0xc9b17014: 0xc9b1701a: 0xc9b1701e: 0xc9b17024: 0xc9b1702c: 0xc9b17034: 0xc9b17038: 0xc9b1703c: ---
ptrouteshow ptrouteshow Displays port routing properties. Synopsis ptrouteshow [slotnumber/]portnumber Availability All users.. Release V4.1.x Description Use this command to display the ASIC routing table contents. Note: This command is not intended for normal user operation and is available to provide supplemental information during system debug. Operands This command has the following operands: slotnumber Specify the slot number for a StorageWorks Core switch.
Fabric OS Commands Example To display the port routing properties for slot 1 port 3: switch:admin> ptrouteshow 1/3 Port Routing table for slot: 1, port: 3 port address ID: 0x130000 external unicast routing table: internal unicast routing table: multicast routing table: broadcast routing table: See Also ptrouteshow 642 Fabric OS Version 3.1.x/4.1.
ptstatsshow ptstatsshow Displays port statistics properties. Synopsis ptstatsshow [slotnumber/]portnumber Availability All users.. Release V4.1.x Description Use this command to display the port statistic properties for the specified port. Note: This command is not intended for normal user operation and is available to provide supplemental information during system debug. Operands This command has the following operands: slotnumber Specify the slot number for a StorageWorks Core switch.
Fabric OS Commands Example To view port statistics properties on slot 1 port 3: switch:admin> ptstatsshow 1/3 Port Statistics for slot: 1, port: 3 Connection type: BE Configured Speed: 2 Interrupts: 60 Unknown: 2 Lli: 20 Proc_rqrd: 40 Timed_out: 0 Rx_flushed: 0 Tx_unavail: 0 Free_buffer: 0 Overrun: 0 Suspended: 0 Parity_err: 0 2_parity_err: 0 CMI_bus_err: 0 ---
qlDisable qlDisable Disable QuickLoop mode. Synopsis qlDisable Availability Admin Release V3.1.x 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.
Fabric OS Commands Example The following entry disables QuickLoop mode: switch:admin> qldisable Setting switch to Fabric mode, Committing configuration...done. Re-enable FL_Ports switch:admin> See Also qlEnable qlPortDisable qlShow 646 Fabric OS Version 3.1.x/4.1.
qlEnable qlEnable Enable QuickLoop mode. Synopsis qlEnable Availability Admin Release V3.1.x 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. The devices on the two switches are then combined to form a single loop (using a single AL_PA space).
Fabric OS Commands Note: If the qlPortDisable command has been entered for a specific port, the qlEnable command cannot re-enable that port, because it has been removed from QuickLoop management. The port must be specifically re-enabled using the qlPortEnable command. If Advanced Zoning is in use the qlDisable, qlEnable, and qlPartner commands are not in effect. In this case, the qlPortEnable command can be used to enable individual ports. This command requires an Advanced Zoning license. Operands None.
qloopAdd qloopAdd Add a member to a QuickLoop. Synopsis qloopAdd “qloopname”, “member;member” Availability Admin Release V3.1.x and V4.1.x 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 World Wide Names. Zone alias names entered as members of this QuickLoop must be defined with WWNs.
Fabric OS Commands Operands The following operands are required: qloopname Specify the name of QuickLoop, in quotation marks. member Specify a list of QuickLoop members, in quotation marks, separated by semicolons. Include one or more of the following: ■ World Wide Names ■ Zone alias names Example To add an alias for a second World Wide Name to “qlp1”: switch:admin> qloopAdd “qlp1”, “wwn2” See Also qloopCreate qloopDelete qloopRemove qloopShow 650 Fabric OS Version 3.1.x/4.1.
qloopCreate qloopCreate Create a QuickLoop. Synopsis qloopCreate “qloopname”, “member;member” Availability Admin Release V3.1.x and V4.1.x 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”. Blank spaces are ignored.
Fabric OS Commands Operands The following operands are required: qloopname Specify the name of QuickLoop to be created, in quotation marks. The qloopname cannot be used for another zone object. member Specify a list of members to be added to QuickLoop, in quotation marks, separated by semicolons.
qloopDelete qloopDelete Delete a QuickLoop. Synopsis: V3.1.x qloopDelete “qloopName” Synopsis: V4.1.x qloopDelete “name” Availability Admin Release V3.1.x and V4.1.x Description Use this command to delete a QuickLoop. This command changes the Defined Configuration. For the change to be preserved across switch reboots, it must be saved to non-volatile memory using the cfgSave command. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command.
Fabric OS Commands Example To delete QuickLoop “qloop2”: switch:admin> qloopDelete “qloop2” See Also qloopAdd qloopCreate qloopRemove qloopShow 654 Fabric OS Version 3.1.x/4.1.
qloopRemove qloopRemove Remove a member from a QuickLoop. Synopsis qloopRemove “qloopName”, “member;member” Availability Admin Release V3.1.x and V4.1.x 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. For example, if a QuickLoop contains “wwn3; wwn4”, removing “wwn3; wwn4” succeeds, but removing “wwn4; wwn3” fails.
Fabric OS Commands Operands The following operands are required: qloopName Specify the name of QuickLoop, in quotation marks. member Specify the list of QuickLoop members to be removed, in quotation marks, separated by semicolons. Include one or more of the following: ■ World Wide Names ■ Zone alias names Example To remove member “wwn2” from “qlp1”: switch:admin> qloopRemove “qlp1”, “wwn2” See Also qloopAdd qloopCreate qloopDelete qloopShow 656 Fabric OS Version 3.1.x/4.1.
qloopShow qloopShow Displays QuickLoop information. Synopsis qloopShow [pattern][, mode] Availability All users. Release V3.1.x and V4.1.x 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; those that match in the defined configuration are displayed.
Fabric OS Commands Operands The following operands are optional: pattern Specify a POSIX style expression used to match QuickLoop names. Patterns may contain the following special characters: ■ Question mark “?” that matches any single character ■ Asterisk “*” that matches any string of characters ■ Ranges “[0-9a-f]” that match any character within the range mode Specify 1 to display the contents of RAM, specify 0 to display the contents of the transaction buffer. The default value is 0.
qlPartner qlPartner Set a QuickLoop partner or display information about a partner. Synopsis qlpartner [0|wwn] Availability Admin Release V3.1.x 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. If in dual switch mode, the partner’s WWN also displays.
Fabric OS Commands Operands This command has the following operand: 0|wwn Specify 0 to set the QuickLoop to run on a single switch. Specify a WWN to set the QuickLoop to run on dual switches. This operand is optional. If no operand is specified the current value is displayed. Example To set another switch as a QuickLoop partner switch: switch:admin> qlPartner “10:00:00:60:69:10:10:ec” See Also configShow qlShow 660 Fabric OS Version 3.1.x/4.1.
qlPortDisable qlPortDisable Disable a QuickLoop port. Synopsis qlPortDisable port Availability Admin Release V3.1.x 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.
Fabric OS Commands Example To change port 4 from QuickLoop mode to fabric mode: switch:admin> qlPortDisable 4 See Also qlDisable qlPortEnable qlShow 662 Fabric OS Version 3.1.x/4.1.
qlPortEnable qlPortEnable Enable a QuickLoop port. Synopsis qlPortEnable port Availability Admin Release V3.1.x 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.
Fabric OS Commands Example To change port 4 from fabric mode to QuickLoop mode: switch:admin> qlPortEnable 4 See Also qlEnable qlPortDisable qlShow 664 Fabric OS Version 3.1.x/4.1.
qlPortShowAll qlPortShowAll Displays QuickLoop port information. Synopsis qlPortShowAll Availability All users. Release V3.1.x Description Use this command to display the QuickLoop port information.
Fabric OS Commands Note: This command requires an Advanced Zoning license. Operands None. Example The following entry displays QuickLoop port information: switch:admin> qlPortShowAll PortNum QuickLoop Mode Port State 0 Disabled ---1 Disabled ---2 Disabled ---3 Disabled ---4 Disabled ---5 Disabled ---6 Disabled ---7 Disabled ---switch:admin> E E E E E E E E PORT PORT PORT PORT PORT PORT PORT PORT See Also portStatShow qlShow 666 Fabric OS Version 3.1.x/4.1.
qlShow qlShow Displays QuickLoop information. Synopsis qlShow Availability All users. Release V3.1.x Description Use this command to display the following QuickLoop information: Self: World Wide Name and domain ID of this switch. Peer: World Wide Name and domain ID of partner switch. Peer is displayed only if the switch has a partner configured.
Fabric OS Commands Local looplet state Indicates state of local looplet. Member: Current QuickLoop member ports. Online: Current online ports in the QuickLoop. Looplet: The state of each looplet.
qlShow 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: offline Looplet 1: offline Looplet 2: offline Looplet 3: offline Looplet 4: offline Looplet 5: offline Looplet 6: offline Looplet 7: offline switch:admin> See Also qlStatsShow Fabric OS Version 3.
Fabric OS Commands qlStatsShow Displays QuickLoop statistics. Synopsis qlStatsShow Availability All users. Release V3.1.x 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.
qlStatsShow Operands None. Example The following entry displays QuickLoop switch statistics: switch:admin> qlStatsShow Quick loop statistics for switch 2 Last QL init time : Jan 1 00:00:00.000 QL init attempted : 0 QL init succeeded : 0 Single switch QL : 0 Dual switch QL : 0 QL enabled : 0 QL disabled : 0 Port started last init : 0 on switch 2 switch:admin> See Also portStatShow qlShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands quietMode Toggle the shell quiet mode on and off. Synopsis quietMode [mode] Availability All users (display). Admin (set/clear). Release V3.1.x 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.
quietMode Example To display the current mode, then reset to ON: switch:admin> quietMode Quiet Mode is OFF switch:admin> quietMode 1 Committing configuration...done. Quiet Mode is now ON switch:admin> See Also ramTest Fabric OS Version 3.1.x/4.1.
Fabric OS Commands ramTest Bit write and read test of SDRAMs in the switch. Synopsis ramTest [patternSize] Availability Admin Release V3.1.x 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: 1. The address subtest verifies that SDRAM locations can be uniquely accessed. The method used is to write a unique pattern to each location in the SDRAMs.
ramTest The method used is to write pattern D to location N, write the complementary pattern D to location N+1, and then read and compare location N to location N+1. Bump the location to test: N=N+1.
Fabric OS Commands Errors Listed below are possible error messages if failures are detected: DIAG-MEMORY DIAG-MEMSZ DIAG-MEMNULL See Also camtest centralmemorytest cmemretentiontest crossporttest cmitest filtertest portloopbacktest portregtest spinsilk sramretentiontest statstest 676 Fabric OS Version 3.1.x/4.1.
reboot reboot Reboot the switch. Synopsis reboot Availability Admin Release V3.1.x and V4.1.x 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.
Fabric OS Commands Example This example is for the StorageWorks Core switch: switch:admin> reboot Warning: This command is being run on a control processor (CP) based system and will cause the active CP to reboot. This will cause disruption to devices attached to both switch 0 and switch 1. To just reboot a logical switch on this system, use command switchreboot(1M) on the logical switch you intend to reboot.
routeHelp routeHelp Displays routing help commands. Synopsis routeHelp Availability All users. Release V3.1.x and V4.1.x Description Use this command to display routing help commands. Operands None. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Example To view a list of routing related commands: switch:admin> routeHelp bcastShow dlsReset dlsSet dlsShow fspfShow interfaceShow iodReset iodSet iodShow linkCost LSDbShow mcastShow nbrStateShow nbrStatsClear topologyShow uRouteConfig uRouteRemove uRouteShow Print broadcast tree information Turn off Dynamic Load Sharing Turn on Dynamic Load Sharing Print state of Dynamic Load Sharing Print FSPF global information Print FSPF interface information Turn off In-Order Delivery Turn on In-
savecore savecore Save or remove core files created by daemons. Synopsis savecore [-h host_name][-u user_name][-p password] [-d remote_directory] Availability Admin Release V4.1.x Description Use this command to FTP or delete core files that were created by daemons during signal processing such as SIGSEGV, SIGILL etc.
Fabric OS Commands Example To remove core files from the current switch: switch:admin> savecore following 1 directories contains core files: [ ]0: /mnt/core_files/secd Welcome to core files management utility.
secfabricshow secfabricshow Displays security related fabric information. Synopsis secfabricshow Availability Admin Release V3.1.x and V4.1.x Description This command displays the security related information about the fabric. The information displayed is as follows: Role Displays whether the switch is the Primary FCS, Backup FCS, or Non FCS. WWN Displays the world wide name of the switch. DId Displays the Domain of the switch. Status Displays the security state of the switch.
Fabric OS Commands Example To display security related fabric information on the Primary FCS switch: primaryfcs:admin> secfabricshow Role WWN DId Status Enet IP Addr Name ================================================================ non-FCS 10:00:00:60:69:10:03:23 1 Ready 192.168.100.148 "nonfcs" Backup 10:00:00:60:69:00:12:53 2 Ready 192.168.100.147 "backup" Primary 10:00:00:60:69:22:32:83 3 Ready 192.168.100.
secfcsfailover secfcsfailover Enables a Backup FCS switch to take over as Primary FCS switch. Synopsis secfcsfailover Availability Admin Release V3.1.x and V4.1.x Description Use this command to enable a Backup FCS switch to take over as the Primary FCS switch. This command can only be issued on a Backup FCS switch.
Fabric OS Commands Example To enable a Backup FCS switch to take over as the Primary FCS switch: switch:admin> secfcsfailover This switch is about to become the Primary FCS switch. All transactions of the current Primary FCS switch will be aborted. ARE YOU SURE (yes, y, no, n): [no] y WARNING!!! The FCS policy of Active and Defined Policy sets have been changed. Review them before you issue secPolicyActivate again.
sechelp sechelp Displays information about security telnet commands. Synopsis sechelp Availability Admin Release V3.1.x and V4.1.x Description Use this command to display a list of security telnet commands. See “Security Commands” on page 941. Operands None. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Example To display a list of security telnet commands: switch:admin> sechelp secFabricShow secFCSFailover secModeEnable secModeDisable secModeShow secNonFCSPasswd secPolicyAbort secPolicyActivate secPolicyAdd secPolicyCreate secPolicyDelete secPolicyFCSMove secPolicyRemove secPolicySave secPolicyShow secPolicyDump secStatsReset secStatsShow secTempPasswdSet secTempPasswdReset secTransAbort secVersionReset Display security related fabric information Force primary role to this FCS switch
secmodedisable secmodedisable Disable security mode. Synopsis secmodedisable Availability Admin Release V3.1.x and V4.1.x Description Use this command to disable security mode on all switches in the fabric. This command deletes both the defined and active security database. Note: This command must be issued from the Primary FCS switch. See “Security Commands” on page 941. Operands None. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Example To disable security mode: primaryfcs:admin> secmodedisable Warning!!! About to disable security. ARE YOU SURE (yes, y, no, n): [no] y Committing configuration...done. Removing Active FMPS... done Removing Defined FMPS... done Disconnecting current session. See Also secfabricshow secmodeenable secmodeshow 690 Fabric OS Version 3.1.x/4.1.
secmodeenable secmodeenable Enable security mode. Synopsis secmodeenable [“fcsmember;fcsmember”] Availability Admin Release V3.1.x and V4.1.x Description Use this command to enable security mode on all switches in the fabric. This command fails if any switch in the fabric is not capable of enforcing the security policies defined in the security database. If no operand is specified the command becomes interactive. Note: sectelnet must be used to open a secure telnet session into a switch.
Fabric OS Commands The administrator is prompted to enter passwords for the following accounts: ■ Factory ■ Root ■ Admin ■ User If the fabric is not in secure mode and one or more specified FCS switches are present in the fabric, the command must be issued on the first active FCS in the list. If the fabric is not in secure mode and no specified FCS switches are present in the fabric, the command can be issued on any switch.
secmodeenable Example To enable a security policy that includes three FCS switches specified by Domain, WWN address, and switch name: fcsprimary:admin> secmodeenable This is an interactive session to create a FCS list.
Fabric OS Commands See Also secfabricshow secmodedisable secmodeshow 694 Fabric OS Version 3.1.x/4.1.
secmodeshow secmodeshow Displays if security mode is enabled or disabled. Synopsis secmodeshow Availability Admin Release V3.1.x and V4.1.x Description Use this command to display the current security mode of the fabric. The fabric can be in secure mode or non secure mode. If the fabric is in secure mode, the following information is displayed: ■ Version stamp - Displays the current version and build date and time of the security database. ■ FCS switches - Displays a list of FCS switches.
Fabric OS Commands Example To display the current security mode of a fabric: primaryfcs:admin> secmodeshow Secure Mode: ENABLED. Version Stamp: 9182, Wed Mar 13 16:37:01 2001. POS Primary WWN DId swName. ==================================================== 1 Yes 10:00:00:60:69:00:00:5a 21 SW47. 2 No 12:00:00:60:60:03:23:5b 5 SW12. primaryfcs:admin> See Also secfabricshow secmodedisable secmodeenable 696 Fabric OS Version 3.1.x/4.1.
secnonfcspasswd secnonfcspasswd Set the Admin password for non-FCS switches. Synopsis secnonfcspasswd Availability Admin Release V3.1.x and V4.1.x Description Use this command to change the Admin password on all non-FCS switches in the fabric. This command can only be issued from the Primary FCS switch in secure mode. The changed passwords are persistent across reboots. All non-FCS switches that join the fabric in the future will inherit this new password.
Fabric OS Commands Example To set the Admin password for all non-FCS switches in the fabric: primaryfcs:admin> secnonfcspasswd Non FCS switch password: Re-enter new password: Committing configuration...done. primaryfcs:admin> See Also passwd secmodeenable secmodedisable secmodeshow sectemppasswdset 698 Fabric OS Version 3.1.x/4.1.
secpolicyabort secpolicyabort Aborts all changes to the defined database that have not been saved. Synopsis secpolicyabort Availability Admin Release V3.1.x and V4.1.x Description Use this command to abort all changes to the defined security database that have not been saved to flash memory. Note: When security is enabled, this command can only be issued from the Primary FCS switch. See “Security Commands” on page 941. Operands None.
Fabric OS Commands See Also secpolicyactivate secpolicyadd secpolicycreate secpolicydelete secpolicydump secpolicyremove secpolicysave secpolicyshow 700 Fabric OS Version 3.1.x/4.1.
secpolicyactivate secpolicyactivate Apply defined policy set to all switches in the fabric. Synopsis secpolicyactivate Availability Admin Release V3.1.x and V4.1.x Description Use this command to activate the current defined security policy to all switches in the fabric. After activation the defined policy set becomes the active policy set. Note: When security is enabled, this command can only be issued from the Primary FCS switch. See “Security Commands” on page 941. Operands None.
Fabric OS Commands See Also secpolicyabort secpolicyadd secpolicycreate secpolicydelete secpolicydump secpolicyremove secpolicysave secpolicyshow 702 Fabric OS Version 3.1.x/4.1.
secpolicyadd secpolicyadd Add members to an existing policy. Synopsis secpolicyadd “name”, “member;member” Availability Admin Release V3.1.x and V4.1.x Description Use this command to add members to an existing access policy. The new members must not already be members within the policy or the command fails. Each policy corresponds to a management method. The list of members of a policy acts as an access control list for that management method.
Fabric OS Commands Operands This command has the following operands: name Specify the name of an existing policy you want to add members to. Valid values for this operand are: ■ DCC_POLICY_nnn ■ FCS_POLICY ■ TELNET_POLICY ■ HTTP_POLICY ■ API_POLICY ■ RSNMP_POLICY ■ WSNMP_POLICY ■ MS_POLICY ■ SERIAL_POLICY ■ FRONTPANEL_POLICY ■ SCC_POLICY ■ OPTIONS_POLICY The specified policy name must be capitalized. The DCC_POLICY_nnn name has the common prefix DCC_POLICY_ followed by a string of user defined characters.
secpolicyadd WWN Member Policy Types The following policy types require members be specified by WWN address: ■ FCS_POLICY ■ MS_POLICY ■ SERIAL_POLICY ■ FRONTPANEL_POLICY ■ SCC_POLICY These policy types require members be specified as WWN strings, Domain ID, or switch names. If Domain ID or switch names are used, the switches associated must be present in the fabric or the command fails. DCC_POLICY Members The DCC_POLICY_nnn is a list of devices associated with a specific switch and port combination.
Fabric OS Commands Example Adding a member to the MS_POLICY using the device WWN: primaryfcs:admin> secpolicyadd “MS_POLICY”, “12:24:45:10:0a:67:00:40” Member(s) have been added to MS_POLICY. primaryfcs:admin> Adding an SNMP manager to WSNMP_POLICY: primaryfcs:admin> secpolicyadd “WSNMP_POLICY”, “192.168.5.21” Member(s) have been added to WSNMP_POLICY.
secpolicycreate secpolicycreate Create a new policy. Synopsis secpolicycreate name[, “member;member”] Availability Admin Release V3.1.x and V4.1.x Description Use this command to create a new policy. All policies can be created only once, except for the DCC_POLICY_nnn. Each DCC_POLICY_nnn must each have a unique name. Adding members while creating a policy is optional. You may add members to a policy later, using the secpolicyadd command. Each policy corresponds to a management method.
Fabric OS Commands Operands This command has the following operands: name Specify the name of a policy you want to create. Valid values for this operand are: ■ DCC_POLICY_nnn ■ TELNET_POLICY ■ HTTP_POLICY ■ API_POLICY ■ RSNMP_POLICY ■ WSNMP_POLICY ■ MS_POLICY ■ SERIAL_POLICY ■ FRONTPANEL_POLICY ■ SCC_POLICY ■ OPTIONS_POLICY The specified policy name must be capitalized. The DCC_POLICY_nnn name has the common prefix DCC_POLICY_ followed by a string of user defined characters.
secpolicycreate WWN Member Policy Types The following policy types require members be specified by WWN address: ■ MS_POLICY ■ SERIAL_POLICY ■ FRONTPANEL_POLICY These policy types require member IDs be specified as WWN strings, Domains, or switch names. If Domain or switch names are used, the switches associated must be present in the fabric or the command fails. DCC_POLICY Members The DCC_Policy_nnn is a list of devices associated with a specific switch and port combination.
Fabric OS Commands SCC_POLICY Members This policy type requires member IDs be specified as WWN strings, Domains, or switch names. If Domain or switch names are used, the switches associated must be present in the fabric or the command fails. To add all switches in the current fabric as members of the SCC_POLICY enter an asterisk “*” enclosed in quotation marks as the member value. This feature cannot be used by the other security telnet commands.
secpolicycreate See Also secpolicyabort secpolicyactivate secpolicyadd secpolicydelete secpolicydump secpolicyremove secpolicysave secpolicyshow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands secpolicydelete Delete an existing policy. Synopsis secpolicydelete “name” Availability Admin Release V3.1.x and V4.1.x Description Use this command to delete an existing defined policy. The FCS_POLICY can not be deleted through this command, since this policy must exist to maintain security mode. Each policy corresponds to a management method. The list of members of a policy acts as an access control list for that management method.
secpolicydelete Operands This command has the following operand: name Specify the name of a security policy to delete. The policy name must be enclosed in quotation marks. Valid security policy names are: ■ DCC_POLICY_nnn ■ TELNET_POLICY ■ HTTP_POLICY ■ API_POLICY ■ RSNMP_POLICY ■ WSNMP_POLICY ■ MS_POLICY ■ SERIAL_POLICY ■ FRONTPANEL_POLICY ■ SCC_POLICY ■ OPTIONS_POLICY The specified policy name must be capitalized.
Fabric OS Commands See Also secpolicyabort secpolicyactivate secpolicyadd secpolicycreate secpolicydump secpolicyremove secpolicysave secpolicyshow 714 Fabric OS Version 3.1.x/4.1.
secpolicydump secpolicydump Show all members of existing policies. Synopsis secpolicydump [listtype[, name]] Availability Admin Release V3.1.x and V4.1.x Description Use this command to display the members of an existing policy in the Active and Defined (saved) databases with no page breaks. Note: When security is enabled, this command can only be issued from the Primary FCS switch. See “Security Commands” on page 941. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Operands This command has the following operands: 716 listtype Specify which database to display. The name for active database is “Active”; the name for saved, defined database is “Defined.” If not specified, all databases are displayed. This operand is optional. An asterisk (*) can be used to specify both Active and Defined. name Specify the name of a security policy you would like to view.
secpolicydump Example To view all security policy information from all databases (active, updating, defined) without page breaks: primaryfcs:admin> secpolicydump ____________________________________________________ DEFINED POLICY SET FCS_POLICY Pos Primary WWN DId swName __________________________________________________ 1 Yes 10:00:00:60:69:30:15:5c 1 primaryfcs HTTP_POLICY IpAddr __________________________________________________ 192.155.52.
Fabric OS Commands To view all security policy information for the TELNET_POLICY without page breaks: primaryfcs:admin> secpolicydump “*”, “TELNET_POLICY” ____________________________________________________ DEFINED POLICY SET TELNET_POLICY IpAddr __________________________________________________ 192.155.52.13 192.155.52.
secpolicyfcsmove secpolicyfcsmove Move a member in the FCS policy. Synopsis secpolicyfcsmove [From, To] Availability Admin Release V3.1.x and V4.1.x Description Use this command to move an FCS member from one position to another position in the FCS list. Only one FCS can be moved at a time. The first FCS switch in the list that is also present in the fabric is the Primary FCS. If no parameters are specified, the command becomes interactive and prompts for valid values for the operands.
Fabric OS Commands Example To move Backup FCS switch at position 2 to position 3 in the FCS list: switch5:admin> secpolicyfcsmove Pos Primary WWN DId swName. ================================================= 1 Yes 10:00:00:60:69:10:02:18 1 switch5. 2 No 10:00:00:60:69:00:00:5a 2 switch60. 3 No 10:00:00:60:69:00:00:13 3 switch73. Please enter position you'd like to move from Please enter position you'd like to move to : (1..3) [1] 2 : (1..
secpolicyremove secpolicyremove Remove members from an existing policy. Synopsis secpolicyremove “name”, “member;member” Availability Admin Release V3.1.x and V4.1.x Description Use this command to remove members from an existing security policy. If a policy is empty after removing all members, all accesses to the policy are disallowed (the DCC_POLICY and OPTIONS_POLICY are an exception). You cannot remove all members from the FCS_POLICY, and you cannot remove the FCS members from the SCC_POLICY.
Fabric OS Commands Operands This command has the following operands: name Specify the name of an existing policy you want to remove members from. Valid values for this operand are: ■ DCC_POLICY_nnn ■ FCS_POLICY ■ TELNET_POLICY ■ HTTP_POLICY ■ API_POLICY ■ RSNMP_POLICY ■ WSNMP_POLICY ■ MS_POLICY ■ SERIAL_POLICY ■ FRONTPANEL_POLICY ■ SCC_POLICY ■ OPTIONS_POLICY The specified policy name must be capitalized.
secpolicyremove WWN Member Policy Types The following policy types require members be specified by WWN address: ■ FCS_POLICY ■ MS_POLICY ■ SERIAL_POLICY ■ FRONTPANEL_POLICY ■ SCC_POLICY These policy types require member IDs be specified as WWN strings, Domains, or switch names. If Domain or switch names are used, the switches associated must be present in the fabric or the command fails. DCC_POLICY Members The DCC_Policy_nnn is a list of devices associated with a specific switch and port combination.
Fabric OS Commands Example Remove a member that has a WWN of 12:24:45:10:0a:67:00:40 from MS policy: primaryfcs:admin> secpolicyremove “MS_POLICY”, “12:24:45:10:0a:67:00:40” Member(s) have been removed from MS_POLICY. . primaryfcs:admin> See Also secpolicyabort secpolicyactivate secpolicyadd secpolicycreate secpolicydelete secpolicydump secpolicysave secpolicyshow 724 Fabric OS Version 3.1.x/4.1.
secpolicysave secpolicysave Save a defined security policy to flash memory on all switches in the fabric. Synopsis secpolicysave Availability Admin Release V3.1.x and V4.1.x Description Use this command to save a defined security policy to flash memory of all switches in the fabric. Note: When security is enabled, this command can only be issued from the Primary FCS switch. See “Security Commands” on page 941. Operands None.
Fabric OS Commands See Also secpolicyabort secpolicyactivate secpolicyadd secpolicycreate secpolicydelete secpolicydump secpolicyremove secpolicyshow 726 Fabric OS Version 3.1.x/4.1.
secpolicyshow secpolicyshow Show an existing security policy. Synopsis secpolicyshow [listtype[, name]] Availability Admin Release V3.1.x and V4.1.x Description Use this command to display the members of an existing policy in the Active, or Defined security policy database. Users can specify which database to display. If not specified, all database are displayed. Users can specify to view a security policy by name. If no name is specified, all policies are displayed.
Fabric OS Commands Operands This command has the following operands: 728 listtype Specify which database to display. The name for active database is “Active”; the name for saved, defined database is “Defined.” This operand must be enclosed in quotation marks. If not specified, all databases are displayed. This operand is optional. Use an asterisk (*) to specify both Active and Defined. name Specify the name of a security policy you would like to view.
secpolicyshow Example Show all security policies from all databases: primaryfcs:admin> secpolicyshow “active” ____________________________________________________ ACTIVE POLICY SET FCS_POLICY Pos Primary WWN DId swName __________________________________________________ 1 Yes 10:00:00:60:69:30:15:5c 1 primaryfcs HTTP_POLICY IpAddr __________________________________________________ 192.155.52.
Fabric OS Commands See Also secpolicyabort secpolicyactivate secpolicyadd secpolicycreate secpolicydelete secpolicydump secpolicyremove secpolicysave 730 Fabric OS Version 3.1.x/4.1.
secstatsreset secstatsreset Reset security statistic for a policy or all policies to zero. Synopsis secstatsreset [name][,list] Availability Admin Release V3.1.x and V4.1.x Description Use this command to reset statistic data for a particular policy or all policies to zero. This command can be issued to any switch. If issued on the Primary FCS switch, this command can reset security statistics for any or all switches in the fabric. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Operands This command has the following operands: 732 name Specify the name of a security statistic you would like to reset. If executed on the Primary FCS, specify an asterisk (*) to represent all security policies.
secstatsreset Example Reset all statistics on the local switch: primaryfcs:admin> secstatsreset About to reset all security counters. Are you sure (yes, y, no, n):[no] y Security statistics reset to zero. primaryfcs:admin> Reset DCC_POLICY statistics on domains 1 and 69: primaryfcs:admin> secstatsreset “DCC_POLICY”, “1;69” Reset DCC_POLICY statistic. primaryfcs:admin> See Also secfabricshow secstatsshow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands secstatsshow Displays security statistic for a policy or for all policies. Synopsis secstatsshow [name][, list] Availability Admin Release V3.1.x and V4.1.x Description Use this command to display security statistics for one or all security policies. This command can be issued to any switch. If issued on the Primary FCS switch, this command can retrieve and display the security statistics for any or all switches in the fabric. This command can be issued to any switch.
secstatsshow Operands This command has the following operands: name Specify the name of a security statistic you would like to view. If executed on the Primary FCS, specify an asterisk (*) to represent all security policies.
Fabric OS Commands Example Show MS_POLICY statistics on the local switch: primaryfcs:admin> secstatsshow “MS_POLICY” Name Value ==================== MS 20 primaryfcs:admin> Displays statistic information for the “TELNET_POLICY” for all switches in the fabric: primaryfcs:admin> secstatsshow “TELNET_POLICY”, “*” Fabric Statistics: Domain 1: Name Value ========================================= TELNET_POLICY 0 Domain 69: Name Value ========================================= TELNET_POLICY 0 Domain 70: Name
sectemppasswdreset sectemppasswdreset Reset a password on a remote switch. Synopsis sectemppasswdreset [domain[, login_name]] Availability Admin Release V3.1.x and V4.1.x Description This command allows the user to remove temporary passwords that had been set up using sectemppasswdset command. The password is restored to the default password set up on non-FCS switches. If a login name is not supplied, all passwords on the switch identified by the specified Domain are refreshed.
Fabric OS Commands Operands This command has the following operands: domain Specify the Domain of the switch from which the temporary passwords are to be removed. This operand is optional. login_name Specify the name of the login account from which the temporary password are removed. This operand is optional.
sectemppasswdset sectemppasswdset Set a temporary password on a remote switch. Synopsis sectemppasswdset domain, login_name Availability Admin Release V3.1.x and V4.1.x Description Use this command to set a unique temporary password for a given account on a specific switch in the fabric. Use the sectemppasswdreset command to remove the temporary password or reboot the switch. You can change any password on any switch.
Fabric OS Commands Operands This command has the following operands: domain Specify the Domain of a switch where you want to change the password. This operand is required. login_name Specify the login name where you want to change the password. This operand is required.
sectransabort sectransabort Abort current security transaction. Synopsis sectransabort Availability Admin Release V3.1.x and V4.1.x Description Use this command to abort the current transaction. This command is used to recover from management application problems. This command will abort all current changes that have not been committed or activated. Note: This command can be issued from any switch in the fabric. When security is enabled, this command can only be issued from the Primary FCS switch.
Fabric OS Commands See Also secpolicyabort secpolicyactivate secpolicyadd secpolicycreate secpolicydelete secpolicydump secpolicyremove secpolicysave secpolicyshow 742 Fabric OS Version 3.1.x/4.1.
secversionreset secversionreset Reset the version stamp to zero. Synopsis secversionreset Availability Admin Release V3.1.x and V4.1.x Description Use this command to reset the version stamp of all switches in a fabric to zero, so that it can be joined to the another secure fabric. When merging two or more secure fabrics, the following steps should be taken: 1.
Fabric OS Commands Note: When security is enabled, this command can only be issued from the Primary FCS switch. See “Security Commands” on page 941. Operands None. Example To reset the version stamp to zero: primaryfcs:admin> secversionreset About to reset version stamp to 0. Are you sure (yes, y, no, n):[no] y Committing configuration... done. Security Policy Version Stamp has been set to 0.
sensorShow sensorShow Displays sensor readings. Synopsis sensorShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the current temperature, fan and power supply status, and readings from sensors located on the switch. The actual location of the sensors varies depending on the switch type. Using V4.1.
Fabric OS Commands Example Below is an example of the output of this command (V3.1.
setdbg setdbg Set debug level of the specified module. Synopsis setdbg module_name level Availability Admin Release V3.1.x and V4.1.x Description Use this command to set the debug level of a specified module. Operands This command has the following operands: module_name Specify the name of the module where you want to view the debug and verbosity levels. Module names are case sensitive. This operand is optional. level Specify the debug level for the specified module. This operand is required.
Fabric OS Commands setesdmode Enable or disable ESD mode. Synopsis setesdmode [mode | -show] Availability Admin Release V4.1.x Description Use this command to enable or disable ESD mode. The mode is saved in non-volatile memory and stays in that mode until the next execution of setesdmode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. ESD mode, when enabled, modifies the behavior of the diagnostic test methods and post scripts.
setesdmode Example To set ESD mode: switch:admin> setesdmode Esd Mode is 0 (Disabled). switch:admin> setesdmode 1 Config update Succeeded Esd Mode is now 1 (Enabled). switch:admin> See Also spinsilk Fabric OS Version 3.1.x/4.1.
Fabric OS Commands setgbicmode Enable or disable GBIC mode. Synopsis: V3.1.x setgbicmode [mode] Synopsis: V4.1.x setgbicmode [mode | -show] Availability Admin Release V3.1.x and V4.1.x 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 non-volatile memory and the GBIC remains in that mode until the next execution of setgbicmode.
setgbicmode Operands This command has the following operands: mode Specify 1 to enable GBIC mode or 0 to disable GBIC mode. For V4.1.x, if no mode is specified the current value is displayed. The mode is saved in non-volatile memory and remains unchanged until the next execution of the setgbicmode command. This operand is optional. -show (V4.1.x only) Specify the -show operand to display the current setting. This operand is optional. Example To enable or disable GBIC mode (V3.1.
Fabric OS Commands setsfpmode Enable or disable SFP mode. Synopsis setsfpmode [mode | -show] Availability Admin Release V4.1.x Description Use this command to enable or disable the SFP mode. If the mode operand is 1, SFP mode is enabled; if the mode operand is 0, SFP mode is disabled. The mode is saved in non-volatile memory and the SFP remains in that mode until the next execution of setsfpmode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
setsfpmode Example To enable or disable SFP mode: switch:admin> setSFPMode 1 SFP mode is now 1 (Enabled). switch:admin> setSFPMode 0 SFP mode is now 0 (disabled). switch:admin> setSFPMode -show SFP mode is now 0 (disabled). See Also crossPortTest spinSilk Fabric OS Version 3.1.x/4.1.
Fabric OS Commands setSplbMode Enable or disable two port loopback. Synopsis: V3.1.x setSplbMode [mode] Synopsis: V4.1.x setSplbMode [mode | -show] Availability Admin Release V3.1.x and V4.1.x Description Use this command to enable or disable SPLB mode. The mode is saved in non-volatile memory and stays in that mode until the next execution of setSplbMode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
setSplbMode The connections between pairs of M->M ports will be chosen to exercise the connections between as many chips (or bloom quadrants) as possible subject to the setting of allow_intra_chip and the availability of pairs of M->M ports.
Fabric OS Commands setverbose Set verbose level of the module to specified level. Synopsis setverbose module_name, level Availability Admin Release V3.1.x and V4.1.x Description Use this command to set the verbose level of the specified module. Operands This command has the following operands: module_name Specify the name of the module for which verbose level is to be set. -level Specify the verbose level to be set for the specified module.
sfpShow sfpShow Displays serial ID SFP information. Synopsis: V3.1.x sfpShow [portnumber] Synopsis: V4.1.x sfpShow [slotnumber/][portnumber] Availability All users. Release V3.1.x and V4.1.x Description Use this command to display information about Serial Identification SFPs (also known as module definition “4” SFPs). These SFPs provide extended information that describes the SFPs capabilities, interfaces, manufacturer, and other information. Note: SFPs are polled by a background process.
Fabric OS Commands For Finisar “smart” SFPs, five additional fields are displayed: ■ Module temperature ■ Voltage ■ Received optical power ■ Transmitted optical power (longwave only) ■ Laser diode drive current Operands This command has the following operands: slotnumber (V4.1.x only) Specify the slot number for a StorageWorks Core switch. For all other switches this operand is not required.
sfpShow This example shows detailed SFP information for a StorageWorks Core switch: switch:admin> sfpshow 1/3 Identifier: 3 SFP Connector: 7 LC Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 1 8B10B Baud Rate: 21 (units 100 megabaud) Length 9u: 0 (units 100 meters) Length 50u: 30 (units 10 meters) Length 625u: 13 (units 10 meters) Length Cu: 0 (units 1 meter) Vendor Name: FINISAR CORP. Vendor OUI: 00:90:65 Vendor PN: FTRJ-8519-3-2.
Fabric OS Commands slotOff Disable a blade slot. Synopsis slotOff slot Availability Admin Release V4.1.x Description Use this command to disable a non-faulty blade unit while leaving the blade unit powered on. Operands This command has the following operand: slot Specify the physical slot number of the blade to be disabled. This operand is required. Example To power off blade unit 3: switch:admin> slotOff 3 Slot 3 is being disabled. See Also slotOn slotShow 760 Fabric OS Version 3.1.x/4.1.
slotOn slotOn Enable a blade slot. Synopsis slotOn slot Availability Admin Release V4.1.x Description Use this command to re-enable a blade unit that was previously disabled. Operands This command has the following operand: slot Specify the physical slot number of the blade to be enabled. This operand is required. Example To power off blade unit 3: switch:admin> sloton 3 Slot 3 is being enabled. See Also slotOff slotShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands slotpoweroff Power off a blade unit. Synopsis slotPowerOff slot Availability Admin Release V4.1.x Description Use this command to turn off the power to a blade unit. The slot must have a valid blade unit present and the blade unit must be of a type that can be powered off. Operands This command has the following operand: slot Specify the physical slot number of the blade to be powered down. This operand is required.
slotpoweron slotpoweron Power on a blade unit. Synopsis slotPowerOn slot Availability Admin Release V4.1.x Description Use this command to turn on the power to a blade unit. The slot must have a valid blade unit present and the blade unit must be currently powered off. Operands This command has the following operand: slot Specify the physical slot number of the blade to be powered on. This operand is required. Example To power on blade unit 3: switch:admin> slotPowerOn 3 Powering on slot 3.
Fabric OS Commands slotShow Displays slot status. Synopsis slotShow Availability All users. Release V4.1.x Description Use this command to inventory and display the current status of each slot in the system. The format of the display includes a header and four fields for each slot. This command is only supported on the StorageWorks Core switch. The fields and their possible values are as follows: 764 Slot Displays the physical slot number.
slotShow ENABLED The blade is on and enabled. DISABLED The blade is powered on but disabled. FAULTY The blade is faulty because an error was detected. UNKNOWN The blade is inserted but its state cannot be determined. Operands None.
Fabric OS Commands snmpMibCapSet View and modify options for configuring SNMP MIB trap capability. Synopsis snmpMibCapSet Availability Admin Release V3.1.x and V4.1.x 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.
snmpMibCapSet Example To view or modify the options for configuring SNMP MIB traps (V3.1.x example): switch:admin> snmpmibcapset The SNMP Mib/Trap Capability has been set to support FE-MIB SW-MIB FA-MIB SW-TRAP FA-TRAP FA-MIB (yes, y, no, n): [yes] SW-TRAP (yes, y, no, n): [yes] FA-TRAP (yes, y, no, n): [yes] no change See Also agtcfgDefault agtcfgSet agtcfgShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands spinFab Test for Cascaded switch ISL links. Synopsis: V3.1.x spinFab [nMillionFrames [, ePortBeg[, ePortEnd[, failmode]]]] Synopsis: V4.1.x spinfab [-nmegs count][-ports list][-setfail mode] [-domain value] Availability Admin Release V3.1.x and V4.1.
spinFab The frames are continuously transmitted and received to all ports in parallel. The port LEDs flicker green rapidly while the test is running. While the frames are circulating, the RX frame count and port CRC and encoder error statistics are monitored and errors will be generated if a port stops or a low level error occurs. Every one million frames the circulating frames will be captured to verify that they are still circulating and that they are still in-order.
Fabric OS Commands Operands This command has the following operands: 770 nMillionFrames (V3.1.x only) Number of million frames to send. The test will progress until the specified number of frames has been transmitted on each port. The default value for nmill is 10, so the number of frames sent will be at least 10 million. The counting is not exact so the actual number of frames sent will tend to be slightly larger, particularly at 2-Gbps link speeds. ePortBeg (V3.1.
spinFab -setfail mode (V4.1.x only) This parameter may be used to cause spinfab to mark failing ports as bad. Specify a value 1 to mark failing ports as BAD, specify a value of 0 to not mark failed ports as bad. To minimize the impact on live fabrics this test normally logs errors but does not set the port status to FAILED. This parameter is provided to force the failing ports to be marked as BAD in the same manner as other diagnostics.
Fabric OS Commands Example In the following examples ports 0-3 are active ISL links. Port 4 is an F-Port so the test skips it (V3.1.x example): switch:admin> setdbg “DIAG”, 0 switch:admin> spinfab 3,0,4 spinFab running... spinFab: Completed 3 megs, status: passed. port 0 test status: 0x00000000 -- passed. port 1 test status: 0x00000000 -- passed. port 2 test status: 0x00000000 -- passed. port 3 test status: 0x00000000 -- passed.
spinFab To test cascading ISL links (V4.1.x example): switch:admin> > spinfab -ports 1/0 - 1/2 spinfab running... spinfab: Completed 11 megs, status: passed. port 0 test status: 0x00000000 -- passed. port 1 test status: 0x00000000 -- passed. port 2 test status: 0x00000000 -- passed. Test Complete: "spinfab" Pass 10 of 10 Duration 0 hr, 0 min & 41 sec (0:0:41:877). passed. switch:admin> Errors When it detects failures, the test may report one or more of the following error messages: ■ For V3.1.
Fabric OS Commands PORT_DIED PORT_ENABLE PORT_M2M PORT_STOPPED PORT_WRONG RXQ_RAM_PERR STATS STATS_C3FRX STATS_FRX STATS_FTX TIMEOUT XMIT See Also camtest centralmemorytest cmemretentiontest cmitest crossporttest itemlist portloopbacktest setDbg spinsilk sramretentiontest 774 Fabric OS Version 3.1.x/4.1.
spinSilk spinSilk Functional test of port connection at maximum switch speed. Synopsis: V3.1.x spinSilk [nmillionframes[, sfpmode[, lbmode[, spdmode]]]] Synopsis: V4.1.x spinSilk [-nmegs count][-gbic_mode mode][-lb_mode mode] [-spd_mode mode][-verbose mode][-ports itemlist] Availability Admin Release V3.1.x and V4.1.x Description This command verifies the functional operation of the switch by setting up the routing hardware such that frames received by port M are retransmitted through port N.
Fabric OS Commands Optimum test coverage occurs with lbmode 1, M->M loopback plugs and splbMode disabled. In this case every port will exchange frames with every other port and all of the ASIC to ASIC connections are tested. The frames are continuously transmitted and received in all ports in parallel. The port LEDs flicker green rapidly while the test is running. The test method is as follows: 1. Determine which ports are connected to each other. 2. Enable ports for cabled loopback mode. 3.
spinSilk An example of the data used are as follows: CSPAT: BYTE_LFSR: RANDOM: RDRAM_PAT: 0x7e, 0x69, 0x25, 0xff, 0x7e, 0x01, 0x7f, 0x00, 0x7e, 0x02, 0x6e, 0xff, 0x7e, 0x05, 0x9a, 0x00, ... ... ... ... At each pass, the frame is created from a different data type.
Fabric OS Commands where: >>> is a cable or internal loopback -> is a routing table entry The connections between pairs of M->M ports are chosen to exercise the connections between as many ASICs as possible subject to the availability of pairs of M->M ports. In mode 1 with SPLB mode disabled the spinsilk command only circulates frames within each single port and none of the ASIC to ASIC connections are tested. This mode should only be used for fault isolation. ■ 2 for external loopback mode.
spinSilk GBIC/SFP Mode (sfpmode): V4.1.x If the spinSilk command is executed with GBIC mode activated, only ports containing GBICs are tested.
Fabric OS Commands 780 -nmegs count (V4.1.x only) Specify the number of million frames to send. The test will progress until the specified number of frames has been transmitted on each port. The default value for nmill is 10, so the number of frames sent will be at least 10 million. -gbic_mode mode (V4.1.x only) Specify the GBIC mode for the test. The -gbic_mode parameter may be used to override the global GBIC mode described above for the duration of this test.
spinSilk For lb_Mode == 2,3 the following speed modes are available to test fifo underrun. 3,5: set all even ports' speed for 2 Gbit/sec, set all odd ports' speed for 1 Gbit/sec. 4,6: set all even ports' speed for 1 Gbit/sec, set all odd ports' speed for 2 Gbit/sec. -verbose mode (V4.1.x only) Specify a non-zero value, to display more detailed information during the test. This mode should be used for debugging purpose. This operand is optional. -ports itemlist (V4.1.
Fabric OS Commands Errors Below are the possible error messages if failures are detected: ■ For V3.1.x: DIAG-INIT DIAG-PORTDIED DIAG-XMIT DIAG-PORTSTOPPED DIAG-ERRSTAT DIAG-ERRSTATS ■ For V4.1.
spinSilk TIMEOUT XMIT See Also backport camtest centralmemorytest cmemretentiontest cmitest crossporttest itemlist portloopbacktest portregtest ramtest sramretentiontest statstest Fabric OS Version 3.1.x/4.1.
Fabric OS Commands sramRetentionTest Data retention test of the miscellaneous SRAMs in ASIC. Synopsis: V3.1.x sramRetentionTest [passCount] Synopsis: V4.1.x sramRetentionTest [--slot number][-passcnt count] [-ports itemlist][-skip bitmask][-delay value] Availability Admin Release V3.1.x and V4.1.x Description Use this command to verify that data written into the miscellaneous SRAMs in the ASIC are retained after a 10 second wait.
sramRetentionTest For details about the patterns used in diagnostic tests, see the datatypeshow command. Operands This command has the following operand: passCount (V3.1.x only) Specify the number of times to execute the test. The default value is 1. This operand is optional. --slot number (V4.1.x only) Specify the slot number that the diagnostic will operate on. The ports specified will be relative to this slot number. The default is set to 0 and designed to operate on fixed port count products.
Fabric OS Commands ■ For V4.1.x: BUS_TIMEOUT REGERR REGERR_UNRST See Also camtest centralmemorytest cmemretentiontest cmitest crossporttest filterTest portloopbacktest portRegTest ramtest spinsilk 786 Fabric OS Version 3.1.x/4.1.
snn snn Displays and sets the soft serial number. Synopsis ssn [“soft-serial-number”] Availability Admin Release V3.1.x Description Use this command to display or set the soft serial number. When ssn is entered without any operand, this command displays the current soft serial number. When ssn is entered with the operand specified, it sets the soft serial number to a user specified value, which can be a numeric value from 1 to 122 bytes.
Fabric OS Commands The following example sets the soft serial number: switch:admin> ssn “BRCD_101” Committing configuration...done. switch:admin> ssn BRCD_101 See Also None. 788 Fabric OS Version 3.1.x/4.1.
statsTest statsTest Run a statistics counter diagnostic test. Synopsis V3.1.x statsTest [passcount] Synopsis V4.1.x statsTest [-passcnt count][-ports itemlist] Availability Admin Release V3.1.x and V4.1.x Description Use this command to verify the ASIC statistics counter logic. It can run on every base port of quadrant, and send the frame through internal loopback with no CRC data to induce the CRC error. This command is also called from camtest.
Fabric OS Commands Note: There is a LINK table that stores 16 pairs of SID-DID address. Each of the SID-DID pairs is named a LINK. This table is used for gathering statistics that match the LINK. Operands This command has the following operands: passcount (V3.1.x only) -passcnt count (V4.1.x only) Specify the number of times to perform this test. The default value is 1. This operand is optional. -ports itemlist (V4.1.x only) Specify a list of user ports to run the test.
statsTest DIAG-STSWRDCNT DIAG-STSALPACNT See Also camtest centralmemorytest cmemretentiontest cmitest crossporttest filtertest portloopbacktest portregtest ramtest spinsilk sramretentiontest turboramtest Fabric OS Version 3.1.x/4.1.
Fabric OS Commands stopporttest Terminate the running porttest. Synopsis: V3.1.x stopporttest [ports] Synopsis: V4.1.x stopporttest [-ports itemlist] Availability Admin Release V3.1.x and V4.1.x Description Use this command to stop the currently running porttest command. See porttest command for more information. If porttest is running on a non-singlemode, use stopporttest to stop the test. Operands This command has the following operands: 792 ports (V3.1.x only) Specify the port to stop the test on.
stopporttest Example To stop the porttest on an active switch: switch:admin> stopporttest switch:admin> See Also crossporttest fporttest loopporttest portloopbacktest porttest porttestshow spinfab Fabric OS Version 3.1.x/4.1.
Fabric OS Commands supportShow Print switch information for debugging purposes. Synopsis: V3.1.x supportShow [firstPort, lastPort, nLog] Synopsis: V4.1.x supportShow slotnumber[/port1-port2] [lines] Availability All users. Release V3.1.x and V4.1.x Description Use this command to print the switch information for debugging purposes. Note: The output of this command can be very long. This command executes the listed commands in the following order: 1. fabstateshow (V4.1.x only) 2. fabswitchshow (V4.1.
supportShow 9. errdump Runs errdump -a, followed by errdump -p. 10.switchshow 11.fspfshow (V4.1.x only) 12.portflagsshow 13.porterrshow 14.mqshow (V3.1.x only) 15.portsemshow (V3.1.x only) 16.portshow (V3.1.x only) 17.portregshow (V3.1.x only) 18.portrouteshow (V3.1.x only) 19.portstructshow (V3.1.x only) 20.bloomdatashow (V3.1.x only) 21.fabricshow 22.trunkshow 23.topologyshow 24.qlshow (V3.1.x only) 25.fashow (V3.1.x only) 26.portcfglport (V3.1.
Fabric OS Commands 36. /sbin/sin (V4.1.x only) Displays hardware listing of CP components. 37. /bin/df (V4.1.x only) Displays file systems available. 38. /sbin/ifconfig (V4.1.x only) Displays all IP addresses. Eth0 is the IP address of the active CP. 39./sbin/route (V4.1.x only) 40. mii-tool -vv (V4.1.x only) Displays output from 10baseT Full duplex information 41. /usr/bin/du -xh / | /bin/sort (V4.1.x only) Calculates directory sizes, can use diff to see if something is missing or different. 42.
supportShow 55. diagshow (V4.1.x only) Displays diagnostic information for the slot specified, if no slot is specified then all slots on logical switch are displayed. 56. portshow (V4.1.x only) Displays port information for all ports specified. The default value is to display information for all ports. 57. portregshow (V4.1.x only) 58. portrouteshow (V4.1.x only) Operands This command has the following operands: firstPort (V3.1.x only) Specify the first port of a range of ports to dump information.
Fabric OS Commands port1 (V4.1.x only) Specify the first port of a range of ports to display information. Enter the port area number. The default (if no operand specified) is to print state of port 0. If only startPort is specified, only information for startPort is printed. This operand is required. port2 (V4.1.x only) Specify the last port of range of ports to display information. Enter the port area number.
supportShow To display switch information for debugging: switch:admin> supportshow 4/0, 15 version: Kernel: 2.4.2 Fabric OS: 4.0.0 Made on: Thu Oct 25 00:58:55 2001 Flash: Thu Oct 25 00:58:55 2001 BootProm: Unknown uptime: 11:46pm up 4:39, 3 users, load average: 1.85, 1.45, 1.15 tempshow: Index Slot State Centigrade Fahrenheit ========================================================= 1 1 Absent 2 2 Absent 3 3 Absent 4 4 Ok 40 104 5 5 Ok 27 80 6 6 Absent < ... sample output truncated ...
Fabric OS Commands switchBeacon Set switch beaconing mode on or off. Synopsis switchBeacon [mode] Availability Admin Release V3.1.x and V4.1.x Description Use this command to set the switch beaconing mode on (if the operand is 1) or off (if the operand is 0). When beaconing mode is turned on, the port LEDs flash amber in a running pattern from port 0 to port 15, and then back again. The user sees a running pattern in amber LEDs, from left to right and right to left.
switchBeacon Example To turn beaconing mode ON: switch:admin> switchBeacon 1 To turn beaconing mode OFF: switch:admin> switchBeacon 0 See Also switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands switchcfgpersistentdisable Disable switch persistently. Synopsis switchcfgpersistentdisable Availability Admin Release V3.1.x and V4.1.x Description Use this command to persistently disable the switch. The persistently disabled switch remains disabled across power cycles and switch reboots. It will not participate in fabric reconfiguration and will remain isolated from the rest of the topology. By default a switch is enabled persistently.
switchcfgpersistentdisable Example To disable a switch persistently: switch:admin> switchcfgpersistentdisable Committing configuration...done. Command in progress . . . . . . . . done See Also configure configshow portcfgpersistentdisable portcfgpersistentenable portcfgshow portshow switchcfgpersistentenable switchshow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands switchcfgpersistentenable Enable a switch persistently. Synopsis switchcfgpersistentenable Availability Admin Release V3.1.x and V4.1.x Description Use this command to persistently enable the switch. The persistently enabled switch remains enabled across power cycles and switch reboots. By default a switch is enabled persistently. When this command is executed, it will be effective immediately by enabling the switch, if it is not already enabled.
switchcfgpersistentenable Example The following example configures the switch as persistently enabled: switch:admin> switchcfgpersistentenable Committing configuration...done. Command in progress . . . . . . . . done See Also configure configshow portcfgpersistentdisable portcfgpersistentenable portcfgshow portshow switchcfgpersistentdisable switchshow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands switchCfgSpeed Configure all ports of the switch to a particular speed level. Synopsis switchCfgSpeed speed_level Availability Admin Release V3.1.x and V4.1.x 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. The output of portShow displays achieved speed level and portCfgShow displays the user's desired speed setting.
switchCfgSpeed Example To set the speed level for all ports on a switch: switch:admin> switchCfgSpeed 2 done. switch:admin> See Also portCfgSpeed switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands switchCfgTrunk Enable or disable trunking on all the ports of a switch. Synopsis switchCfgTrunk mode Availability Admin Release V3.1.x and V4.1.x 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: mode Specify 1 to enable trunking on all the ports on this switch. Specify 0 to disable trunking on all the ports on this switch. This operand is required.
switchCfgTrunk See Also portCfgShow portCfgTrunkPort portShow switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands switchDisable Disable the switch. Synopsis switchDisable Availability Admin Release V3.1.x and V4.1.x 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.
switchDisable See Also switchEnable switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands switchEnable Enable the switch. Synopsis switchEnable Availability Admin Release V3.1.x and V4.1.x Description Use this command to enable the switch. All Fibre Channel ports that passed POST are enabled. They can come online if connected to a device, or remain offline if disconnected. A switch may need to be enabled if it was previously disabled to make configuration changes or to run diagnostics. If the switch is connected to a fabric, it rejoins the fabric.
switchEnable Example To enable a switch: switch:admin> switchEnable 10 9 8 7 6 5 4 3 2 fabric: Principal switch fabric: Domain 1 1 See Also switchDisable switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands switchName Displays or sets the switch name. Synopsis switchName [“newName”] Availability All users (display). Admin (set). Release V3.1.x and V4.1.x Description Use this command without an operand to display the current switch name. All switches have a symbolic name that is primarily used for switch management. 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, such as fabricshow.
switchName Example To change a switch name to sw10: switch:admin> switchName “sw10” Committing configuration... Done. sw10:admin> See Also fabricShow switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands switchReboot Halt and bring down the operational switch. Synopsis switchReboot Availability Admin Release V4.1.x Description This command reboots the operational switch without disrupting the other switch in the StorageWorks Core switch chassis. The administrator uses this command when the problem with the switch cannot be determined. Using this command brings the switch back to an operational state without disturbing the software state of the system in general.
switchReboot Example To bring down an operational switch: switch:admin> switchreboot Selecting i2c bus...Done. Stopping all switch daemons...Done. Releasing i2c bus...Done. Powering off slot 7...Done. Checking all slots are powered off....Done. Cleaning up kernel modules...Done. Initializing kernel modules...Done. setup FCIP IP: ifconfig fc1 ip=192.168.69.190, netmask=255.255.255.0 Starting all switch daemons...Done. Powering on slot 7...Done. Checking diagnostics............... Start Apache -- /etc/rc.
Fabric OS Commands switchShow Displays switch and port status. Synopsis switchShow Availability All users. Release V3.1.x and V4.1.x 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. Switch summary information: 818 switchName Displays the switch symbolic name.
switchShow Zoning (V3.1.x only) Displays the switch zoning mode: On or Off. The switch summary is followed by one line per port: Area (V4.1.x only) Each slot and port combination in the StorageWorks Core switch is assigned an area number. For example, the area number of slot 3/port 15 is 63 (in switch 0), the area number for slot 10/port 15 is also 63 (in switch 1). This parameter is for V4.1.x only. Slot (V4.1.x only) Slot number.
Fabric OS Commands Port State (V3.1.x only) State (V4.1.
switchShow more comments The comment field may have additional comments depending on the comment field entry. ■ Disabled: A disabled port may have additional comments that explain the reason for disabling it. — (Persistent) — (Security violation) ■ L-Port: An L-port may indicate the number for public, private and phantom devices in the loop. ■ E-Port: An E-port may display one or more of the following. — WWN of the switch connected. — Switch name of the switch connected.
Fabric OS Commands The following example shows a StorageWorks 2 Gb SAN switch: switch:admin> switchshow switchName: switch switchType: 10.
switchShow See Also switchDisable switchEnable switchName Fabric OS Version 3.1.x/4.1.
Fabric OS Commands switchShutdown Halt the operational switch. Synopsis switchShutdown Availability Admin Release V4.1.x Description This command halts the switch operation without disrupting the other switch in the StorageWorks Core switch chassis. This command disables a logical switch in a StorageWorks Core switch without disturbing the software state of the system in general. This command has to be used in combination with switchStart.
switchShutdown Example To bring down the current logical switch without disrupting the other switch in the chassis: switch:admin> switchshutdown Stopping all switch daemons...Done. Powering off slot 1...Done. Powering off slot 4...Done. Checking all slots are powered off...Done. Cleaning up kernel modules...Done. See Also switchReboot switchStart Fabric OS Version 3.1.x/4.1.
Fabric OS Commands switchStart Initialize the switch to operational. Synopsis switchStart Availability Admin Release V4.1.x Description This command initializes a logical switch without disrupting the other switch in the StorageWorks Core switch chassis. This command enables a logical switch in a StorageWorks Core switch without disturbing the software state of the system in general. This command has to be used in combination with switchShutdown.
switchStart Example To initialize the logical switch to operational: switch:admin> switchstart Initializing kernel modules...Done. Starting all switch daemons...Done. Powering on slot 1...Done.q> to stop Powering on slot 4...Done.q> to stop Checking diagnostics...Done. setup FCIP IP: ifconfig fc0 ip=0.0.0.0, netmask=255.255.255.0 See Also switchReboot switchShutdown Fabric OS Version 3.1.x/4.1.
Fabric OS Commands switchStatusPolicySet Set the policy parameters that determine the overall switch status. Synopsis switchStatusPolicySet Availability Admin Release V3.1.x and V4.1.x 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.
switchStatusPolicySet Table 16: Contributor Value and Status (Continued) Default Value for DOWN Default Value for MARGINAL Temperatures 2 1 Fans 2 1 PortStatus 0 0 ISLStatus 2 1 Contributor Any single contributor can force the overall status of the switch to MARGINAL or DOWN. For example, assuming that the switch contributor values are set to the default values, if there is one faulty port in a switch, then this contributor would set the overall switch status to MARGINAL.
Fabric OS Commands Example Notice that in the following example, the only parameter modified is the number of MissingSFPS allowed before a MARGINAL status is triggered: switch:admin> switchStatusPolicySet To change the overall switch status policy parameters The current overall switch status policy parameters: Down Marginal ---------------------------------FaultyPorts 1 0 MissingSFPs 0 1 PowerSupplies 2 1 Temperatures 2 1 Fans 2 1 PortStatus 0 0 ISLStatus 2 1 Note that the value, 0, for a parameter, means
switchStatusPolicyShow switchStatusPolicyShow Displays the policy parameters that determine the overall switch status. Synopsis switchStatusPolicyShow Availability All users. Release V3.1.x and V4.1.x 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.
Fabric OS Commands Table 17: Contributor Value and Status (Continued) Default Value for DOWN Default Value for MARGINAL Fans 2 1 PortStatus 0 0 ISLStatus 2 1 Contributor The policy parameters determine the number of failed or non-operational units for each contributor that trigger a status change in the switch. For example, if the FaultyPorts DOWN parameter is set to 3, and 3 ports fail in the switch, then the status of the switch changes to DOWN. Operands None.
switchStatusShow switchStatusShow Displays the overall status of the switch. Synopsis switchStatusShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the overall status of the switch.
Fabric OS Commands Example There are two examples below. The first shows a switch with a status of MARGINAL, the second shows the same switch after all the errors have been fixed.
switchuptime switchuptime Displays the amount of time the switch has been operating. Synopsis switchuptime Availability All users. Release V4.1.x Description Use this command to display the current time and the amount of time the switch has been operational. Operands None. Example To view the uptime for the switch: switch:admin> switchuptime 2:00pm up for 17 hrs 44 mins sqab14:admin> See Also switchReboot switchShutdown switchStart Fabric OS Version 3.1.x/4.1.
Fabric OS Commands syslogdIpAdd Add the IP address of a syslog daemon. Synopsis: V3.1.x syslogdIpAdd “IPaddr” Synopsis: V4.1.x syslogdIpAdd “ip_address” Availability Admin Release V3.1.x and V4.1.x 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.
syslogdIpAdd Example To add the address 11.22.33.44 to the list of machines to which system messages are sent (V3.1.x example): switch:admin> syslogdIpAdd “11.22.33.44” See Also errShow syslogdIpRemove syslogdIpShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands syslogdIpRemove Remove the IP address of a syslog daemon. Synopsis: V3.1.x syslogdIpRemove “IPaddress” Synopsis: V4.1.x syslogdIpRemove “ip_address” Availability Admin Release V3.1.x and V4.1.x 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: IPaddress (V3.1.
syslogdIpRemove See Also errShow syslogdIpAdd syslogdIpShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands syslogdIpShow Displays all syslog daemon IP addresses. Synopsis syslogdIpShow Availability All users. Release V3.1.x and V4.1.x 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: 11.22.33.44 syslog.IP.address.2: 11.22.33.45 syslog.IP.address.3: 11.22.33.
systemtest systemtest Run a series of diagnostic tests on a switch blade. Synopsis systemtest [[--slot] slotno][-log logfile] Availability Admin Release V4.1.x Description This command will run a suite of diagnostic tests on the specified switch blade. It is not required to install loop-back plugs on every port as in the case of bladediag and bladediagshort. Note: This command is provided just for compatibility and may be removed in the future releases.
Fabric OS Commands Example To run a suite of diagnostics on blade 7: switch:admin> systemtest -slot 7 Testing slot: 7, user ports: 3 2 1 0 7 6 5 4 11 10 9 8 15 14 13 12 PortRegTest Running Port Register Test .... passed. Test Complete: "portregtest" Pass 1 of 1 Duration 0 hr, 2 min & 23 sec (0:2:23:443). passed. Test return status: 0 CentralMemoryTest Running centralmemorytest ............ passed. Test Complete: "centralmemorytest" Pass 1 of 1 Duration 0 hr, 0 min & 19 sec (0:0:19:611). passed.
systemverification systemverification Run a suit of diagnostic tests on all switches in a fabric. Synopsis systemverification [-parameters | -short] Availability Admin Release V4.1.x Description Use this command to run a comprehensive system wide test of all switches in a fabric. It will initiate a burnin run on all switches within the current system. The run can be terminated by issuing a control “c” character from the initiating terminal.
Fabric OS Commands Operands This command has the following operands: 844 -parameters Invokes the diagsetcycle command before starting the burnin run. This will allow users to modify the burnin parameters prior to the run. These diagsetcycle parameters are copied to all switches in the system and override the original settings in the database. If the diagsetcycle parameter is not specified, then the run will use the previously stored values.
systemverification Example To initiate a system verification test on all switches in the fabric: switch:admin> systemverification -short systemverification: Setting parameters for short run. systemverification: burnin parameters.
Fabric OS Commands tempShow Displays temperature readings. Synopsis tempShow Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the current temperature readings of all temperature sensors in a switch. Each temperature sensor has an index. The indices start from 1. There can be more than one sensor per slot. The slot number to which a sensor belongs is displayed in the column next to the index. The temperature readings are given in both Centigrade and Fahrenheit.
tempShow This example shows a StorageWorks Core switch (V4.1.x example): switch:admin> tempshow Index Slot State Centigrade Fahrenheit ========================================================= 1 1 Ok 47 116 2 2 Absent 3 3 Absent 4 4 Ok 46 114 5 5 Ok 33 91 6 6 Ok 33 91 switch:admin> Note: For the StorageWorks Core switch, this command only returns the temperature sensor values for the logical switch you are logged into, not for the entire chassis.
Fabric OS Commands timeout Set or show the IDLE timeout value for a login session. Synopsis timeout [timeval] Availability All users (for viewing only). Admin (show/set). Release V3.1.x and V4.1.x Description Use this command with no operands to display the current telnet timeout value. Use this command with an operand to sets the idle timeout value to the specified minutes. Using a timeout value of zero will disable the timeout functionality so that login sessions would never be disconnected.
timeout See Also None. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands topologyShow Displays the unicast fabric topology. Synopsis topologyShow [domainnumber] Availability All users. Release V3.1.x and V4.1.x 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.
topologyShow Hops The maximum number of hops to reach destination domain. Out Port Port that incoming frame will be forwarded to, in order to reach the destination domain. In Ports Input ports that use the corresponding Out Port to reach the destination domain. This is the same information provided by portRouteShow and uRouteShow. Total Bandwidth The maximum bandwidth of the out port. Bandwidth Demand The maximum bandwidth demand by the in ports. Flags Always “D,” indicating a dynamic path.
Fabric OS Commands The following is a V4.1.
trackChangesHelp trackChangesHelp Displays information on track-changes feature commands. Synopsis trackchangeshelp Availability All users. Release V3.1.x and V4.1.x Description Use this command to display information about the track-changes commands. Operands None.
Fabric OS Commands trackChangesSet Enable configuring of track-changes feature. Synopsis: V3.1.x trackChangesSet [mode], [snmptrapmode] Synopsis: V4.1.x trackChangesSet [mode][,snmptrapmode] Availability Admin Release V3.1.x and V4.1.x Description This command enables or disables the track-changes feature. An SNMP-TRAP mode can also be enabled.
trackChangesSet Operands This command has the following operands: mode Specify 1 to enable the track-changes feature or specify 0 to disable the feature. The default (if no operand is specified) is to disable the track-changes feature. This operand is optional. snmptrapmode Specify 1 to enable errors to be sent to the SNMP-TRAP in addition to the errlog or specify 0 to disable the SNMP-TRAP messages. The default (if no operand is specified) is to disable SNMP-TRAP messages. This operand is optional.
Fabric OS Commands trackChangesShow Displays status of track-changes feature. Synopsis trackChangesShow Availability All users. Release V3.1.x and V4.1.x 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 traps are generated. The output from the track-changes feature is dumped to the error log for the switch. Use the errDump command or errShow command to view the error log. Operands None.
trunkDebug trunkDebug Debug a trunk link failure. Synopsis trunkDebug port1, port2 Availability Admin Release V3.1.x and V4.1.x Description Use this command to debug a trunk link failure.
Fabric OS Commands Operands This command has the following operands: port1 For V3.1.x, specify the first port number of a trunk connection where you want to debug a trunking link error. For V4.1.x, use the area number to specify port1. Use the switchshow command to view the area numbers for a port. This operand is required. port2 For V3.1.x, specify the second port number of a trunk connection where you want to debug a trunking link error. For V4.1.x, use the area number to specify port2.
trunkShow trunkShow Displays trunking information. Synopsis trunkShow Availability All users. Release V3.1.x and V4.1.x 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. Port to port connections Displays the port-to-port trunking connections. WWN Displays the WWN of the connected port.
Fabric OS Commands Example To display trunking information for a switch: switch:admin> trunkShow 1: 1 -> 1 10:00:00:60:69:04:10:83 0 -> 0 10:00:00:60:69:04:10:83 2: 4 -> 4 10:00:00:60:69:04:01:94 5 -> 5 10:00:00:60:69:04:01:94 7 -> 7 10:00:00:60:69:04:01:94 6 -> 6 10:00:00:60:69:04:01:94 3:14 -> 14 10:00:00:60:69:04:10:83 15 -> 15 10:00:00:60:69:04:10:83 deskew deskew deskew deskew deskew deskew deskew deskew 16 55 45 34 22 65 46 33 MASTER MASTER MASTER See Also portCfgTrunkport switchCfgTrunk 860 F
tsclockserver tsclockserver Displays or sets the NTP Server address. Synopsis tsclockserver [ipaddr] Availability All users (display). Admin (set). Release V3.1.x and V4.1.x Description Use this command to synchronize the local time of the Principal or Primary FCS switch to an external NTP server. The Time Server daemon synchronizes fabric time by sending updates of the Principal or Primary FCS local switch time periodically to every switch in the fabric.
Fabric OS Commands The NTP server used MUST support a full NTP client. Fabric OS V3.1.x and v2.6.1 have an SNTP client and hence will accept an SNTP or NTP server, but V4.1.x has an NTP client. So for the proper functioning of a mixed fabric with external time synchronization it is necessary that an NTP server that supports a full NTP client be used. The ipaddr specified should be the IP address of an NTP server and should be accessible from the switch.
tshelp tshelp Displays the time service commands. Synopsis tshelp Availability All users. Release V3.1.x and V4.1.x Description Use this command to display a list of time service commands. Operands None. Example To display a list of time service commands: switch:admin> tshelp tsTimeZone tsClockServer Set time zone Set/Get External NTP Server address NOTE: don't run help command after firmwaredownload without reboot. It will give you wrong information. switch:admin> See Also None. Fabric OS Version 3.1.
Fabric OS Commands tstimezone Displays or sets the system time zone. Synopsis tstimezone [hourOffset [, minuteOffset]] Availability All users (display). Admin (set). Release V3.1.x and V4.1.x Description Use this command to display or set the system time zone. All switches maintain the current time zone setup in non-volatile memory. Changing the Time Zone on a switch updates the local time zone setup and is reflected in local time calculations. All switches are by default in the 0,0 time zone, that is GMT.
tstimezone Operands This command has the following operands: hourOffset Specify the number of hours relative to GMT. This operand must be specified as an integer. Valid values are -12 through 12. This operand is optional. minuteOffset Specify the number of minutes relative to the hourOffset. This operand must be specified as an integer. Valid values are -30, 0, or 30. This operand is optional.
Fabric OS Commands turboRamTest Turbo SRAM logic test for 2-Gbps ASICs. Synopsis: V3.1.x turboramtest [passcount] Synopsis: V4.1.x turboramtest [--slot number][-passcnt count][-ports itemlist] Availability Admin Release V3.1.x and V4.1.x Description This command verifies the on-chip SRAM located in the 2-Gb ASIC using the Turbo-Ram BIST circuitry.
turboRamTest ■ RX Buffer Frame Tail RAM ■ RX Buffer Frame Link RAM ■ TX Buffer Descriptor RAM (Output/Input Frame Tracking, Buffer State) ■ Private RAM ■ Phantom CAM ■ Phantom DID RAM ■ Phantom ALPA RAM ■ Frame Filtering Destination Group Table RAM ■ Frame Filtering Source Group Table RAM ■ Field Definition Block RAM ■ Frame Filtering Destination CAM ■ Frame Filtering Source CAM ■ Special Memory RAM The test flow for each SRAM is as follows: 1.
Fabric OS Commands --slot number (V4.1.x only) Specify the slot number in a StorageWorks Core switch. The slot number must be followed by a slash ( / ) and the port number. The StorageWorks Core switch has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4, and 7 through 10, are switch cards. On each switch card, there are 16 ports counted from the bottom, 0 to 15.
turboRamTest See Also camtest centralmemorytest cmemretentiontest cmitest portregtest ramtest sramretentiontest Fabric OS Version 3.1.x/4.1.
Fabric OS Commands txdpathtest Functional test of TXA and TXD connections. Synopsis txdpathtest [passcount, speedmode] Availability Admin Release V3.1.x Description Use this command to verify the TXA, TXD, and CMI data paths between the ASICs. This is done by configuring all of the ports for internal loopback and sending a frame from each quadrant to all other port on the switch.
txdpathtest 6. Repeat steps 2 through 5 for all ports present until: a. The number of frames (or passcount) requested is reached, b. All ports are marked bad. At each pass, a different data type is used to create the frame from a palette of 7; meaning if a pass of 7 is requested, 7 different frames are used in the test. If 8 passes, the first 7 frames are unique, and the 8th is the same as the first.
Fabric OS Commands Errors When it detects failures, the test may report one or more of the following error messages: DIAG-INIT DIAG-PORTDIED DIAG-XMIT DIAG-TIMEOUT DIAG-ERRSTAT DIAG-STATS DIAG-DATA See Also camtest centralmemorytest cmemretentiontest cmitest crossporttest portloopbacktest portregtest ramtest spinsilk sramretentiontest 872 Fabric OS Version 3.1.x/4.1.
uptime uptime Displays length of time the system has been operational. Synopsis uptime Availability All users. Release V3.1.x and V4.1.x Description Use this command to display the length of time the system has been in operation (also known as “up time”), the total cumulative amount of “up time” since the system was first powered-on, the date and time of the last reboot, and the reason for the last reboot. For up and powered-on times less than 60 seconds, the time is displayed in seconds.
Fabric OS Commands Reboot Last reboot was caused by a user (from any management interface). Powerfail NMI* Power supply caused a nonmaskable interrupt. Watchdog NMI* Watchdog timer caused a nonmaskable interrupt. PushButton NMI* Push buttons 2 and 4 were depressed for two seconds, causing a nonmaskable interrupt. Software NMI* Firmware caused a nonmaskable interrupt. Note: The items marked with an asterisk (*) are usually caused by hardware or firmware failures.
uRouteConfig uRouteConfig Configure a static route. Synopsis uRouteConfig InArea Domain OutArea Availability Admin Release V3.1.x and V4.1.x Description Use this command to configure static routes. A static route is a route that is assigned to a specific path, and will not change when a topology change occurs, unless the path used by the route becomes unavailable.
Fabric OS Commands Operands This command has the following operands: InArea Specify the port to be statically routed. This operand is required. Domain Specify the destination domain. This operand is required. OutArea Specify the output port where traffic is forwarded. This operand is required. Examples To configures a static route for all traffic coming in from port 1 and addressed to domain 2 to go through port 5: switch:admin> uRouteConfig 1 2 5 done. switch:admin> configShow route.ucastRoute.1.
uRouteRemove uRouteRemove Remove a static route. Synopsis uRouteRemove InArea Domain Availability Admin Release V3.1.x and V4.1.x Description Use this command to remove a previously configured static route. After this command is issued, the route to Domain for InArea may or may not change. It changes if the previous static route was not along a minimum cost path. Also, after this command is issued, the load sharing to Domain is re-evaluated. InArea can be either an F_Port or an E_Port.
Fabric OS Commands See Also configShow uRouteConfig uRouteShow 878 Fabric OS Version 3.1.x/4.1.
uRouteShow uRouteShow Displays unicast routing information. Synopsis: V3.1.x uRouteShow [portnumber][, domainnumber] Synopsis: V4.1.x uRouteShow [slotnumber/][portnumber][, domainnumber] Availability All users. Release V3.1.x and V4.1.x 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.
Fabric OS Commands Metric: Cost of reaching the destination domain. Hops: Maximum number of hops required to reach the destination domain. Flags: Indicates if route is dynamic (D) or static (S). A dynamic route is discovered automatically by the FSPF path selection protocol. A static route is assigned using the command uRouteConfig. Next (Dom, Port): Domain and port number of the next hop. These are the domain number and the port number of the switch to which Out Port is connected.
uRouteShow Examples The first example displays the routing information of all the active ports, The second command displays the routing information of port 11 on slot 1, and the third command displays the routing information of port 11 to domain 4 only: switch:admin> urouteshow Local Domain ID: 3 In Port Domain Out Port Metric Hops Flags Next (Dom, Port) --------------------------------------------------------------------------0 1 11 1000 1 D 1,0 11 2 0 1500 2 D 4,0 4 0 500 1 D 4,0 16 1 27 1000 1 D 1,1 27
Fabric OS Commands version Displays firmware version information. Synopsis version Availability All users. Release V3.1.x and V4.1.x Description Use this command to display firmware version information and build dates. The following fields are displayed: Kernel: Displays the version of switch kernel operating system. Fabric OS: Displays the version of switch Fabric OS. Made on: Displays the build date of firmware running in switch. Flash: Displays the build date of firmware stored in flash PROMs.
version Example The following example shows the firmware version information on a StorageWorks Core switch: switch:admin> version Kernel: 2.4.2 Fabric OS: V4.1.x Made on: Fri Feb 1 23:02:08 2002 Flash: Fri Feb 1 18:03:35 2002 BootProm: 3.1.13b switch:admin> See Also firmwareDownload reboot Fabric OS Version 3.1.x/4.1.
Fabric OS Commands wwn View a switch WWN. Synopsis wwn Availability For V3.1.x: All users. For V4.1.x: ■ Factory or Root only (set). ■ All users (display). Release V3.1.x and V4.1.x Description Use this command to modify or display the WWN of a switch. All switches have a numeric address that is the unique Fibre Channel address used for communicating with the switch. The WWN is shown in the output of the switchShow command. This command with no parameters displays the current WWN value.
wwn Operands None. Example To display the switch WWN: switch:admin> wwn 10:00:00:60:69:00:54:e9 switch:admin> See Also switchShow Fabric OS Version 3.1.x/4.1.
Fabric OS Commands zoneAdd 1 Add a member to the zone. Synopsis zoneAdd “zoneName”, “member;member” Availability Admin Release V3.1.x and V4.1.x Description Use this command to add one or more members to an existing zone. This command changes the Defined Configuration. For the change to be preserved across switch reboots, it must be saved to non-volatile memory using the cfgsave command. For the change to become effective, an appropriate zone configuration must be enabled using the cfgenable command.
zoneAdd Operands The following operands are required: zoneName Specify the name of an existing zone, in quotation marks. This operand is required. member Specify a member or list of members to be added, in quotation marks, separated by semicolons. Valid values can be one or more of the following: ■ For V3.1.x, a switch domain and physical port number pair. For example, “2, 12.” ■ For V4.1.x, a switch domain and port area number pair. For example, “2, 20.
Fabric OS Commands zoneCreate Create a zone. Synopsis zoneCreate “zoneName”, “member;member” Availability Admin Release V3.1.x and V4.1.x Description Use this command to create a new zone. Note: This command requires an Advanced Zoning license. 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”. Blank spaces are ignored.
zoneCreate Node and Port Names presented by a device in a login frame (FLOGI or PLOGI). When a zone member is specified by Node Name, then all ports on that device are in the zone. When a zone member is specified by Port Name, then only that single device port is in the zone. Specify a QuickLoop AL_PA as a QuickLoop name followed by a list of AL_PAs, for example, “qloop1[01,02].
Fabric OS Commands Operands The following operands are required: zoneName Name for a zone to be created, in quotation marks. This name cannot be used for any other zone object. member List of members to be included in zone, in quotation marks, separated by semicolons. Can be one or more of the following: ■ For V3.1.x, a switch domain and physical port number pair. For example, “2, 12.” ■ For V4.1.x, a switch domain and port area number pair.
zoneDelete zoneDelete Delete a zone. Synopsis zoneDelete “zoneName” Availability Admin Release V3.1.x and V4.1.x Description Use this command to delete a zone. This command changes the Defined Configuration. For the change to be preserved across switch reboots, it must be saved to non-volatile memory using the cfgsave command. For the change to become effective, an appropriate zone configuration must be enabled using the cfgenable command. Note: This command requires an Advanced Zoning license.
Fabric OS Commands Example To delete the zone “Blue_zone”: switch:admin> zoneDelete “Blue_zone” See Also zoneAdd zoneCreate zoneRemove zoneShow 892 Fabric OS Version 3.1.x/4.1.
zoneHelp zoneHelp Displays help information on zone commands. Synopsis zoneHelp Availability All users. Release V3.1.x and V4.1.x Description Use this command to display help information on zone commands. Operands None. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands Example To display zone command help information: switch:admin> zonehelp aliAdd aliCreate aliDelete aliRemove aliShow Add a member to a zone alias Create a zone alias Delete a zone alias Remove a member from a zone alias Print zone alias information cfgAdd cfgCreate cfgDelete cfgRemove cfgShow Add a member to a configuration Create a zone configuration Delete a zone configuration Remove a member from a configuration Print zone configuration information qloopAdd qloopCreate qloopDelet
zoneRemove zoneRemove Remove a member from a zone. Synopsis zoneRemove “zoneName”, “member;member” Availability Admin Release V3.1.x and V4.1.x 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. For example, if a zone contains “array2; array3; array4,” removing “array3; array4” succeeds. but removing “array4; array3” fails.
Fabric OS Commands Operands The following operands are required: zoneName Name of the zone, in quotation marks. member List of members to be removed from zone, in quotation marks, separated by semicolons. Can be one or more of the following: ■ For V3.1.x, a switch domain and physical port number pair. For example, “2, 12.” ■ For V4.1.x, a switch domain and port area number pair. For example, “2, 20” View the area numbers for ports using the switchShow command.
zoneShow zoneShow Displays zone information. Synopsis zoneShow [“pattern”][, mode] Availability All users. Release V3.1.x and V4.1.x 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.
Fabric OS Commands Operands The following operands are optional: pattern A POSIX style regular expression used to match zone configuration names. The pattern must be enclosed in quotation marks. Patterns may contain: ■ Question mark “?” that matches any single character ■ Asterisk “*” that matches any string of characters ■ Ranges “[0-9a-f]” that match any character within the range mode For V3.1.
Fabric OS Commands for Licensed Products 2 This chapter summarizes the commands that are only available with a license key.
Fabric OS Commands for Licensed Products Advanced Zoning Commands The following commands are available with the purchase of an Advanced Zoning license key. For detailed information about zoning refer to the HP StorageWorks Zoning Version 3.1.x/4.1.x User Guide. Table 18: Zoning Commands Command Description Zone Alias aliAdd Add a member to a zone alias. aliCreate Create a zone alias. aliDelete Delete a zone alias. aliRemove Remove a member from a zone alias.
Fabric OS Commands for Licensed Products Table 18: Zoning Commands (Continued) Command Description Zone Management cfgClear Clear all zone configurations. cfgDisable Disable a zone configuration. cfgEnable Enable a zone configuration. cfgSave Save zone configurations in flash memory. cfgTransAbort Aborts the current zoning transaction. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands for Licensed Products QuickLoop Fabric Assist Mode Commands The following commands are for QuickLoop Fabric Assist Mode. For detailed information about Extended Fabrics refer to the HP StorageWorks QuickLoop Fabric Assist Version 3.1.x User Guide. Table 19: QuickLoop Fabric Assist Mode Commands Command Description fazoneAdd Add members to an existing QuickLoop Fabric Assist zone. fazoneCreate Create a QLFA zone. fazoneDelete Delete an existing QuickLoop Fabric Assist zone.
Fabric OS Commands for Licensed Products Extended Fabric Command The following command is available with the purchase of an Extended Fabrics license key. For detailed information about Extended Fabrics refer to the HP StorageWorks QuickLoop Fabric Assist Version 3.1.x User Guide. Table 20: Extended Fabric Command Command portCfgLongDistance Fabric OS Version 3.1.x/4.1.x Reference Guide Description Configure a port to support long distance links.
Fabric OS Commands for Licensed Products Fabric Watch Commands The following commands are available with the purchase of a Fabric Watch license key. For detailed information about Fabric Watch refer to the HP StorageWorks Fabric Watch Version 3.1.x/4.1.x User Guide. Table 21: Fabric Watch Commands Command 904 Description fwClassInit Initialize all classes under Fabric Watch. fwConfigReload Reload the Fabric Watch configuration.
Fabric OS Commands for Licensed Products Trunking Commands The following commands are available with the purchase of a Trunking license key. For detailed information about trunking refer to the HP StorageWorks ISL Trunking Version 3.1.x/4.1.x User Guide. Table 22: Trunking Commands Command Description portCfgTrunkport Configure a port for trunking. switchCfgTrunk Configure a switch for trunking. trunkDebug Debug a trunk link failure. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands for Licensed Products Advanced Performance Monitoring Commands The following commands are available with the purchase of an Advanced Performance Monitoring license key. For more detailed information about Performance Monitoring refer to the HP StorageWorks Advanced Performance Monitoring Version 3.1.x/4.1.x User Guide. Table 23: Performance Monitoring Commands Command 906 Description perfAddEEMonitor Add an end-to-end monitor to a port. perfAddIPMonitor Add an IP monitor to a port.
Fabric OS Commands for Licensed Products Table 23: Performance Monitoring Commands (Continued) Command Description perfShowEEMonitor Display user-defined end-to-end monitors on a port. perfShowFilterMonitor Display filter-based monitors for a port. perfShowPortEEMask Display the current end-to-end mask of a port. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands for Licensed Products Secure Fabric OS Commands The following commands are available with the purchase of a Security license key. For more detailed information about trunking refer to the HP StorageWorks Secure Fabrics OS Version 1.0 User Guide. Table 24: Secure Fabric OS Commands Command 908 Description secfabricshow Displays security related fabric information. secfcsfailover Enables a Backup FCS switch to take over as Primary FCS switch.
Fabric OS Commands for Licensed Products Table 24: Secure Fabric OS Commands (Continued) Command Description sectemppasswdset Set a temporary password on a remote switch. sectransabort Abort current security transaction. secversionreset Reset the version stamp to zero. Fabric OS Version 3.1.x/4.1.
Fabric OS Commands for Licensed Products 910 Fabric OS Version 3.1.x/4.1.
Fabric OS Version Comparison 3 This chapter summarizes the commands available in V3.1.x and V4.1.x. Fabric OS Version 3.1.x/4.1.
Fabric OS Version Comparison Command Differences Between Versions This table provides a list of which commands are available in V3.1.x and in V4.1.x. It also provides notes on differences that may exist for a particular command between versions. Table 25: Fabric OS Command Version Support (Sheet 1 of 15) Supported in V3.1.x Supported in V4.1.x agtcfgDefault Yes Yes agtcfgSet Yes Yes agtcfgShow Yes Yes aliasDelete No Yes New command for V4.1.x aliasJoin No Yes New command for V4.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 2 of 15) Supported in V3.1.x Supported in V4.1.x bladeDiagShort No Yes Specific to the StorageWorks Core switch bladeDisable No Yes New command for V4.1.x bladeEnable No Yes New command for V4.1.x bladePropShow No Yes Specific to the StorageWorks Core switch bsn Yes No Functionality was replaced by the chassisshow command in V4.1.x.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 3 of 15) Supported in V3.1.x Supported in V4.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 4 of 15) Supported in V3.1.x Supported in V4.1.x dlsReset Yes Yes dlsSet Yes Yes dlsShow Yes Yes dnsconfig Yes Yes errclear Yes Yes errDump Yes Yes errnvlogsizeset No Yes New command for V4.1.x errnvlogsizeshow No Yes New command for V4.1.x errsavelvlset No Yes New command for V4.1.x errsavelvlshow No Yes New command for V4.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 5 of 15) Supported in V3.1.x Supported in V4.1.x fazoneCreate Yes Yes fazoneDelete Yes Yes fazoneRemove Yes Yes fazoneShow Yes Yes fcpprobeshow Yes Yes New command for V3.1.x fcprlsshow Yes Yes New command for V3.1.x fdmicacheshow Yes Yes New command for V3.1.x fdmishow Yes Yes New command for V3.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 6 of 15) Supported in V3.1.x Supported in V4.1.x fwShow Yes Yes gbicshow Yes Yes h Yes Yes haDisable No Yes Specific to the StorageWorks Core switch hadump No Yes New command for V4.1.x haEnable No Yes Specific to the StorageWorks Core switch haFailover No Yes Specific to the StorageWorks Core switch haShow No Yes Specific to the StorageWorks Core switch hasyncstart No Yes New command for V4.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 7 of 15) Supported in V3.1.x Supported in V4.1.x itemlist No Yes New command for V4.1.x killtelnet No Yes New command for V4.1.x ledtest No Yes New command for V4.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 8 of 15) Supported in V3.1.x Supported in V4.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 9 of 15) Supported in V3.1.x Supported in V4.1.x perfShowFilterMonitor Yes Yes perfShowPortEEMask Yes Yes pkicreate No Yes New command for V4.1.x pkiremove No Yes New command for V4.1.x pkishow No Yes New command for V4.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 10 of 15) Supported in V3.1.x Supported in V4.1.x portLogShow Yes Yes portlogshowport Yes Yes portLoopbackTest Yes Yes portname Yes Yes portPerfShow Yes Yes portRegTest Yes Yes portRouteShow Yes Yes portShow Yes Yes portstatsclear Yes Yes portStatsShow Yes Yes portswap No Yes New command for V4.1.x portswapdisable No Yes New command for V4.1.x portswapenable No Yes New command for V4.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 11 of 15) Supported in V3.1.x Supported in V4.1.x qloopCreate Yes Yes qloopDelete Yes Yes qloopRemove Yes Yes qloopShow Yes Yes qlPartner Yes No qlPortDisable Yes No qlPortEnable Yes No qlPortShowAll Yes No qlShow Yes No qlStatsShow Yes No quietMode Yes No ramTest Yes No reboot Yes Yes routeHelp Yes Yes savecore No Yes New command for V4.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 12 of 15) Supported in V3.1.x Supported in V4.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 13 of 15) Supported in V3.1.x Supported in V4.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 14 of 15) Supported in V3.1.x Supported in V4.1.
Fabric OS Version Comparison Table 25: Fabric OS Command Version Support (Sheet 15 of 15) Supported in V3.1.x Supported in V4.1.x zoneHelp Yes Yes zoneRemove Yes Yes zoneShow Yes Yes Command 926 Comment Specify members using area number in V4.1.x Fabric OS Version 3.1.x/4.1.
Fabric and Switch Management 4 This chapter explains the different methods used to manage an HP StorageWorks SAN switch. In order to manage a switch, you must have access to one of the available management methods. ■ Overview, page 928 ■ User Access Level, page 929 ■ Fabric OS Command Line Interface, page 930 ■ Web Tools, page 931 ■ Fabric Manager, page 932 ■ Fabric Watch, page 934 ■ Fabric OS Access Layer (API), page 935 ■ Management Server, page 936 Fabric OS Version 3.1.x/4.1.
Fabric and Switch Management Overview The HP switch can be managed using several local and remote access methods. In order to manage a switch, you must have access to one of the following management methods: ■ Fabric OS command line interface ■ WebTools ■ Fabric Manager ■ Fabric Watch ■ Fabric OS Access Layer (API) ■ Management Server Telnet, SNMP and Web Tools require that the switch be accessible using a network connection.
Fabric and Switch Management User Access Level There are four levels of user access for the HP switch: ■ Root ■ Factory ■ Admin ■ User In Fabric OS V4.1.x, each user access level can have the following number of simultaneous sessions: Table 26: StorageWorks Core switch User Access Maximum Sessions User Name Maximum Number of Simultaneous Sessions Root 4 Factory 4 Admin 2 User 4 Web Tools 4 Note: In Fabric OS V3.1.x and earlier, multiple user access to a switch is limited.
Fabric and Switch Management Fabric OS Command Line Interface The Fabric OS command line interface (CLI) accessed through telnet or serial console provides the user with the full range of management capability on an HP switch. The Fabric OS CLI enables an administrator to monitor and manage entire fabrics, individual switches, and ports from a standard workstation. The entire suite of Fabric OS features and capabilities is available across an entire fabric, from a single access point.
Fabric and Switch Management Web Tools Web Tools provides a graphical interface that allows the administrator to monitor and manage entire fabrics and individual switches and ports from a standard workstation. It is an optionally licensed product that runs on Fabric OS. All switches in the fabric are displayed in the main window of Web Tools, including switches that do not have a Web Tools license.
Fabric and Switch Management Fabric Manager Fabric Manager provides a graphical interface that allows the administrator to monitor and manage an entire fabric from a standard workstation. Fabric Manager can be used to manage fabrics containing integrated Fabrics, in addition to individual HP switches. Fabric Manager provides high-level information about all switches in the fabric, launching the Web Tools application when more detailed information is required.
Fabric and Switch Management ■ Provides the ability to execute multi-fabric administration of Secure Fabric OS SANs through a single encrypted console. ■ Provides the ability to implement scalable SAN management tasks through functionality and tools that intelligently span 8 fabrics and 200 switches. ■ Provides the ability to monitor Inter Switch Links (ISLs) ■ Provides the ability to manage switch licenses ■ Provides the ability to perform Fabric Stamping Fabric OS Version 3.1.x/4.1.
Fabric and Switch Management Fabric Watch Fabric Watch software monitors the performance and status of Fibre Channel networks and HP switches, and can alert SAN managers when problems arise. The real-time alerts from Fabric Watch software help SAN managers solve problems before they become costly failures.
Fabric and Switch Management Fabric OS Access Layer (API) The Fabric OS Access Layer is an application programming interface (API) that enables any application to access critical information about an HP SAN. With Fabric Access, an application can query or control individual switches or the entire fabric.
Fabric and Switch Management Management Server The Management Server is a Fibre Channel native in-band management interface. This interface allows a SAN management application to retrieve and administer the fabric and interconnect elements such as switches, servers, and storage devices. This interface runs directly over Fibre Channel through the HBA. An ACL of WWN addresses determines which systems have access to the Management Server database.
Control Processor Commands 5 This chapter lists the commands that may be available, depending upon the Fabric OS version (V3.1.x or V4.1.x), when logged into the Active CP and Standby CP in a StorageWorks Core switch. Fabric OS Version 3.1.x/4.1.
Control Processor Commands Active CP Commands When you are logged into the Active CP, the full suite of commands are supported (subject to which license keys are installed). HP recommends that you log into a specific logical switch, when performing management functions, rather than the Active CP. This method guarantees that any commands you execute are run on the desired logical switch. When you open a telnet session to the Active CP IP Address, commands execute by default on logical switch 0.
Control Processor Commands Standby CP Commands The commands in Table 27 are supported when logged into the Standby CP. Table 27: StorageWorks Core switch Standby CP Commands Command Notes date Print/set the system date and time. errclear Clear error log. errDump Print error log with no page breaks. errnvlogsizeset Resize non-volatile (persistent) error log. errnvlogsizeshow Show persistent error log configuration. errsavelvlset Set error save level. errsavelvlshow Get error save level.
Control Processor Commands Table 27: StorageWorks Core switch Standby CP Commands (Continued) Command 940 Notes myrid Display current login ID details. reboot Reboot this processor. When executed from the Standby CP, only the Standby CP is rebooted. savecore FTP or Remove core files generated by daemons. timeout Set or display the idle timeout value for a login session. uptime Display how long switch has been up. version Display firmware version information. Fabric OS Version 3.1.x/4.1.
Security Commands 6 This chapter summarizes the commands that are only available on the Primary FCS when the security feature is installed and enabled. Fabric OS Version 3.1.x/4.1.
Security Commands Commands Exclusive to the Primary FCS The following commands are available only on the Primary FCS when security is installed and enabled. Table 28: Commands Exclusive to the Primary FCS Command 942 Notes agtcfgset Can be run on all switches, but it needs to be run on the Primary FCS to modify community strings agtcfgdefault Must be run from the Primary FCS switch. aliadd Must be run from the Primary FCS switch. alicreate Must be run from the Primary FCS switch.
Security Commands Table 28: Commands Exclusive to the Primary FCS (Continued) Command Notes msconfigure Must be run from the Primary FCS switch. msplmgmtdeactivate Must be run from the Primary FCS switch. msplmgmtactivate Must be run from the Primary FCS switch. msplcleardb Must be run from the Primary FCS switch. mstddisable mstddisable "ALL" must be run from the Primary FCS switch. mstdenable mstdenable "ALL" must be run from the Primary FCS switch.
Security Commands Table 28: Commands Exclusive to the Primary FCS (Continued) Command 944 Notes secversionreset Must be run from the Primary FCS switch. Can also be run on a single non-FCS switch which is segmented from a fabric. tsclockserver Must be run from the Primary FCS switch. wwn This command can be run on all switches to view the WWN. With security enabled the WWN of a switch cannot be modified. zoneadd Must be run from the Primary FCS switch.
glossary Glossary This glossary defines terms used in this guide or related to this product and is not a comprehensive glossary of computer terms. Glossary 16-port card The Fibre Channel port card provided with the StorageWorks Core switch. Contains 16 Fibre Channel ports and the corresponding LEDs indicating port status and speed. See also port card. 8b/10b Encoding An encoding scheme that converts each 8-bit byte into 10 bits. Used to balance ones and zeros in high-speed transports.
Glossary Alias An alternate name for an element or group of elements in the fabric. Aliases can be used to simplify the entry of port numbers and WWNs when creating zones. Alias Address Identifier An address identifier recognized by a port in addition to its standard identifier. An alias address identifier may be shared by multiple ports. See also alias. Alias AL_PA An AL_PA value recognized by an L_Port in addition to the AL_PA assigned to the port. See also AL_PA.
Glossary ATM Asynchronous Transfer Mode. A transport used for transmitting data over LANs or WANs that transmit fixed-length units of data. Provides any-to-any connectivity, and allows nodes to transmit simultaneously. Auto-negotiate Speed Process that allows two devices at either end of a link segment to negotiate common features, speed (e.g., 1 or 2 Gbps) and functions. Autosense Process during which a network device automatically senses the speed of another device.
Glossary Beginning Running Disparity The disparity at the transmitter or receiver when the special character associated with an ordered set is encoded or decoded. See also disparity. BER 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. BISR Built-In Self Repair. Refers to the range of algorithms and circuit techniques to replace fault elements in a VLSI circuit with redundant fault-free ones.
Glossary Boot Monitor Code used to initialize the CP (control processor) environment after powering on. Identifies the amount of memory available and how to access it, and retrieves information about system buses. Broadcast The transmission of data from a single source to all devices in the fabric, regardless of zoning. See also multicast, unicast. Buffer-to-buffer Flow Control Management of the frame transmission rate in either a point-to-point topology or in an arbitrated loop. See also BB_Credit.
Glossary Class F Connectionless service for control traffic between switches, with notification of delivery or non-delivery of data between the E_Ports. Class of Service A specified set of delivery characteristics and attributes for frame delivery. CLI Command line interface. Interface that depends entirely on the use of commands, such as through telnet or SNMP, and does not involve a Graphic User Interface (GUI). CLS Close Primitive Signal.
Glossary Configuration How a system is set up. May refer to hardware or software. ■ Hardware: The number, type, and arrangement of components that make up a system or network. ■ Software: The set of parameters that guide switch operation. May include general system parameters, IP address information, Domain ID, and other information. Modifiable by any login with administrative privileges. May also refer to a set of zones. See also zone configuration.
Glossary CT_HDR Common Transport Header. A header that conforms to the Fibre Channel Common Transport (FC_CT) protocol. CT_IU Common Transport Information Unit. An information unit that conforms to the Fibre Channel Common Transport (FC_CT) protocol. Current Fill Word The fill word currently selected by the LPSM. See also fill word, LPSM. Cut-through A switching technique that allows the route for a frame to be selected as soon as the destination address is received. See also route.
Glossary Device Connection Controls Enables organizations to bind an individual device port to a set of one or more switch ports. Device ports are specified by a WWN and typically represent HBAs (servers). See also access control lists. Device A disk, a RAID, or an HBA. 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.
Glossary E_Port Expansion Port. A type of switch port that can be connected to an E_Port on another switch to create an ISL. See also ISL. EE_Credit End-to-end Credit. The number of receive buffers allocated by a recipient port to an originating port. Used by Class 1 and 2 services to manage the exchange of frames across the fabric between source and destination. See also End-to-end Flow Control, BB_Credit. EIA Rack A storage rack that meets the standards set by the Electronics Industry Association.
Glossary Exchange The highest level Fibre Channel mechanism used for communication between N_Ports. Composed of one or more related sequences, and can work in either one or both directions. Extended Fabric An HP product that runs on Fabric OS and allows creation of a Fibre Channel fabric interconnected over distances of up to 100 kilometers. Extended Fabric is a means of allowing the implementation and management of SANs over extended distances.
Glossary Fabric Configuration Server One or more designated HP switches that store and manage the configuration and security parameters for all other switches in the fabric. These switches are designated by WWN, and the list of designated switches is known fabric-wide. Fabric Manager An HP product that works in conjunction with Web Tools to provide a graphical user interface for managing switch groups (such as the SAN Switch Integrated/32) as a single unit, instead of as separate switches.
Glossary FC-FLA The Fibre Channel Fabric Loop Attach standard defined by ANSI. FCIA Fibre Channel Industry Association. An international organization of Fibre Channel industry professionals. Among other things, provides oversight of ANSI and industry developed standards. FCP Fibre Channel Protocol. Mapping of protocols onto the Fibre Channel standard protocols. For example, SCSI FCP maps SCSI-3 onto Fibre Channel. FC-PH-1, 2, 3 The Fibre Channel Physical and Signaling Interface standards defined by ANSI.
Glossary Firmware Download Loading firmware down from a server into a switch. Firmware The basic operating system provided with the hardware. FL_Port Fabric Loop Port. A port that is able to transmit under fabric protocol and also has arbitrated loop capabilities. Can be used to connect an NL_Port to a switch. See also F_Port, Fx_Port. Flash Partition Two redundant usable areas, called “partitions,” into which firmware can be downloaded in the StorageWorks Core switch.
Glossary FS_REQ Fibre Channel Services Request. A request for a Fibre Channel services function, or notification of a fabric condition or event. FS_RJT Fibre Channel Services Reject. An indication that a request for Fibre Channel services could not be processed. FS Fibre Channel Service. A service that is defined by Fibre Channel standards and exists at a well-known address. For example, the Simple Name Server is a Fibre Channel service. See also FSP. FSPF Fabric Shortest Path First.
Glossary GBIC Gigabit interface converter. A removable serial transceiver module that allows gigabaud physical-level transport for Fibre Channel and gigabit Ethernet. Typically refers only to the SC-form factor transceivers. See also SFP. Gbps Gigabits per second (1,062,500,000 bits/second). GBps Gigabytes per second (1,062,500,000 bytes/second).
Glossary Host A computer that accesses storage devices over the fabric. May also be referred to as a server. See also workstation. Hot Pluggable A FRU capability that indicates it may be extracted or installed while customer data is otherwise flowing in the chassis. Hub A Fibre Channel wiring concentrator that collapses a loop topology into a physical star topology. Nodes are automatically added to the loop when active and removed when inactive. IBTA The InfiniBand Trade Association (IBTA).
Glossary Isolated E_Port An E_Port that is online but not operational due to overlapping Domain IDs or nonidentical parameters (such as E_D_TOVs). See also E_Port. ISL Interswitch Link. a Fibre Channel link from the E_Port of one switch to the E_Port of another. See also E_Port, cascade, ISL Trunking. ISL Trunking An HP feature that enables distribution of traffic over the combined bandwidth of up to four ISLs (between adjacent switches), while preserving in-order delivery.
Glossary L_Port Loop Port. A node port (NL_Port) or fabric port (FL_Port) that has arbitrated loop capabilities. An L_Port can be in one of two modes: ■ Fabric mode: Connected to a port that is not loop capable, and using fabric protocol. ■ Loop mode: In an arbitrated loop and using loop protocol. An L_Port in loop mode can also be in participating mode or non-participating mode. See also Non-participating Mode, Participating Mode.
Glossary Loop Failure Loss of signal within a loop for any period of time, or loss of synchronization for longer than the time-out value. See also error. Loop Initialization The logical procedure used by an L_Port to discover its environment. Can be used to assign AL_PA addresses, detect loop failure, or reset a node. Loop_ID A hex value representing one of the 127 possible AL_PA values in an arbitrated loop. Looplet A set of devices connected in a loop to a port that is a member of another loop.
Glossary Modem Serial Port The upper serial port on the CP Card of the StorageWorks Core switch. Can be used to connect the CP Card to a modem with a standard 9-pin modem cable. Consists of a DB-9 connector wired as a RS-232 device, and can be connected by serial cable to a DCE device. A Hayes-compatible modem or Hayes-emulation is required. The device name is ttyS1. See also DB-9 connector, DCE port, terminal serial port.
Glossary NL_Port Node Loop Port. A node port that has arbitrated loop capabilities. Used to connect an equipment port to the fabric in a loop configuration through an FL_Port. See also N_Port, Nx_Port. Node Name The unique identifier for a node, communicated during login and port discovery. Node A Fibre Channel device that contains an N_Port or NL_Port. Non-participating Mode A mode in which an L_Port in a loop is inactive and cannot arbitrate or send frames, but can retransmit any received transmissions.
Glossary Ordered Set A transmission word that uses 8B/10B mapping and begins with the K28.5 character. Ordered sets occur outside of frames, and include the following items: ■ Frame delimiters: Mark frame boundaries and describe frame contents. ■ Primitive signals: Indicate events. ■ Primitive sequences: Indicate or initiate port states. Ordered sets are used to differentiate Fibre Channel control information from data frames and to manage the transport of frames.
Glossary Point-to-point A Fibre Channel topology that employs direct links between each pair of communicating entities. See also topology. Port Cage The metal casing extending out of the optical port on the switch, and in which the SFP can be inserted. Port Card A Fibre Channel card that contains optical or copper port interfaces, and acts like a switch module. See also 16-port card. Port Module A collection of ports in a switch. Port_Name The unique identifier assigned to a Fibre Channel port.
Glossary Public Device A device that supports arbitrated loop protocol, can interpret 8-bit addresses, and can log into the fabric. Public Loop An arbitrated loop that includes a participating FL_Port, and may contain both public and private NL_Ports. Public NL_Port An NL_Port that logs into the fabric, can function within either a public or a private loop, and can communicate with either private or public NL_Ports. Quad A group of four adjacent ports that share a common pool of frame buffers.
Glossary RAID Redundant Array of Independent Disks. A collection of disk drives that appear as a single volume to the server and are fault tolerant through mirroring or parity checking. See also JBOD. Remote Fabric A fabric that spans across WANs by using protocol translation (a process also known as tunneling) such as Fibre Channel over ATM or Fibre Channel over IP.
Glossary RSCN Registered State Change Notification. A switch function that allows notification of fabric changes to be sent from the switch to specified nodes. RX_ID Responder Exchange Identifier. A 2-byte field in the frame header used by the responder of the Exchange to identify frames as being part of a particular exchange. SAN Storage Area Network. A network of systems and storage devices that communicate using Fibre Channel protocols. See also fabric.
Glossary SFP Small form factor pluggable. A transceiver used on 2 Gbps switches that replaces the GBIC. Refers to the LC-form factor transceiver. See also GBIC. SID/DID Source identifier/Destination identifier. S_ID is a 3-byte field in the frame header that is used to indicate the address identifier of the N_Port from which the frame was sent. Single Mode The fiber optic cabling standard that, when used in conjunction with a 1300 nm laser light, can transfer data up to 10 km between devices.
Glossary Switch Hardware that routes frames according to Fibre Channel protocol and is controlled by software. SWL Short Wavelength. A type of fiber optic cabling that is based on 850-mm lasers and supports 1.0625-Gbps link speeds. May also refer to the type of GBIC or SFP. See also LWL. Tachyon A chip developed by Hewlett-Packard, and used in various devices. This chip has FC-0 through FC-2 on one chip. Target A storage device on a Fibre Channel network. See also Initiator.
Glossary Transceiver Device that converts one form of signaling to another for transmission and reception; in fiber optics, it refers to optical and electrical. Transfer State The state in which a port can establish circuits with multiple ports without reentering the arbitration cycle for each circuit. This state can only be accessed by an L_Port in the Open state. Translative Mode A mode in which private devices can communicate with public devices across the fabric.
Glossary ULP Upper-level Protocol. The protocol that runs on top of Fibre Channel. Typical upper-level protocols are SCSI, IP, HIPPI, and IPI. Unicast The transmission of data from a single source to a single destination. See also broadcast, multicast. user account A login intended for use by the customer to monitor, but not control, switch operation. See also account level switches. VC Virtual circuit. A one-way path between N_Ports that allows fractional bandwidth.
Glossary Zone A set of devices and hosts attached to the same fabric and configured as being in the same zone. Devices and hosts within the same zone have access permission to others in the zone, but are not visible to any outside the zone. See also Zoning. Zone Alias A name assigned to a device or group of devices in a zone. Aliases can greatly simplify the zone administrative process. See also alias. Zone Configuration A specified set of zones.
index agtcfgDefault 22 agtcfgSet 26 agtcfgShow 32 aliAdd 44 aliasDelete 36 aliasJoin 38 aliasPurge 40 aliasShow 42 aliCreate 46 aliDelete 49 aliRemove 51 aliShow 53 audience 16 authorized reseller, HP 20 camTest 84 centralMemoryTest 87 cfgactvshow 95 cfgAdd 97 cfgClear 99 cfgCreate 101 cfgDelete 103 cfgDisable 105 cfgEnable 107 cfgRemove 109 cfgSave 111 cfgShow 113 cfgsize 117 cfgTransAbort 119 cfgtransshow 121 chassisName 123 chassisShow 125 chippropshow 128 chipregshow 130 cmemRetentionTest 132 cmiTest
Index D F dataTypeShow 172 date 174 dbgshow 177 diagClearError 179 diagCommandShow 181 diagDisablePost 183 diagEnablePost 185 diagesdports 187 diagfaillimit 189 diagHelp 191 diagloopid 193 diagmodepr 195 diagpost 197 diagretry 199 diagsetburnin 201 diagsetcycle 203 diagshow 205 diagshowtime 208 diagsilkworm 210 diagskiptests 212 diagstopburnin 214 dlsReset 216 dlsSet 218 dlsShow 220 dnsconfig 221 document conventions 17 prerequisites 16 related documentation 16 fabportshow 240 fabretryshow 243 fabricpri
Index G L gbicshow 338 getting help 19 ledtest 395 licenseAdd 396 licenseHelp 398 licenseIdShow 400 licenseRemove 402 licenseShow 404 linkCost 406 login 409 logout 410 loopPortTest 412 LSDbShow 418 H h command 341 haDisable 343 hadump 344 haEnable 346 haFailover 347 haShow 349 hasyncstart 351 hasyncstop 352 help 353 help, obtaining 19 historyLastShow 355 historymode 357 historyShow 359 HP authorized reseller 20 storage website 19 technical support 19 I i command 361 ifModeSet 364 ifModeShow 367 ifShow
Index perfAddEEMonitor 475 perfAddIPMonitor 478 perfAddReadMonitor 480 perfAddRWMonitor 482 perfAddSCSIMonitor 484 perfAddUserMonitor 486 perfAddWriteMonitor 490 perfCfgClear 492 perfCfgRestore 494 perfCfgSave 496 perfcleareemonitor 498 perfclearfiltermonitor 500 perfClrAlpaCrc 502 perfDelEEMonitor 504 perfDelFilterMonitor 506 perfHelp 508 perfSetPortEEMask 510 perfShowAlpaCrc 513 perfShowEEMonitor 515 perfShowFilterMonitor 519 perfShowPortEEMask 522 pkicreate 525 pkiremove 527 pkishow 529 portcamshow 530
Index qlShow 667 qlStatsShow 670 quietMode 672 R ramTest 674 reboot 677 related documentation 16 routeHelp 679 S savecore 681 secfabricshow 683 secfcsfailover 685 sechelp 687 secmodedisable 689 secmodeenable 691 secmodeshow 695 secnonfcspasswd 697 secpolicyabort 699 secpolicyactivate 701 secpolicyadd 703 secpolicycreate 707 secpolicydelete 712 secpolicydump 715 secpolicyfcsmove 719 secpolicyremove 721 secpolicysave 725 secpolicyshow 727 secstatsreset 731 secstatsshow 734 sectemppasswdreset 737 sectemppas
Index text symbols 17 timeout 848 topologyShow 850 trackchangeshelp 853 trackChangesSet 854 trackChangesShow 856 trunkDebug 857 trunkShow 859 tsclockserver 861 tshelp 863 tstimezone 864 turboRamTest 866 txdpathtest 870 U uptime 873 uRouteConfig 875 uRouteRemove 877 uRouteShow 879 982 V version 882 W websites Fibre Channel Association 16 HP storage 19 StorageWorks 16 wwn 884 Z zoneAdd 886 zoneCreate 888 zoneDelete 891 zoneHelp 893 zoneRemove 895 zoneShow 897 Fabric OS Version 3.1.x/4.1.