HP StorageWorks 2/140 CLI reference guide for directors and edge switches
HP StorageWorks 2/140 - Director Switch Manual
View all HP StorageWorks 2/140 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP StorageWorks 2/140 manual content summary:
- HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 1
hp StorageWorks CLI reference guide for directors and edge switches Part Number: AA-RQ7AC-TE Third Edition (January 2003) This guide covers the essentials of using a command line interface (CLI) to manage the Hewlett-Packard (HP) StorageWorks Director and Edge Switches. Also included are CLI - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 2
companies. Hewlett-Packard Company shall not be liable for technical or editorial errors or omissions contained herein. The information is provided "as is" without . Printed in the U.S.A. CLI reference guide for directors and edge switches Third Edition (January 2003) Part Number: AA-RQ7AC- - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 3
on Movements 1-9 Parameters 1-9 Output 1-10 Logging In and Logging Out 1-10 User Access Rights 1-10 login 1-11 logout 1-12 commaDelim 1-13 Handling Command Line Interface Errors 1-14 Using the Command Line Interface Help 1-14 CLI reference guide for directors and edge switches iii - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 4
config.port.fan 2-15 config.port.name 2-16 config.port.speed 2-17 config.port.type 2-18 config.port.show 2-20 config.security.fabricBinding 2-22 config.security.fabricBinding. fabricBinding.wwn 2-29 config.security.portBinding.show 2-30 iv CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 5
2-63 config.zoning Commands 2-64 config.zoning.setDefZoneState 2-65 config.zoning.activateZoneSet 2-66 config.zoning.deactivateZoneSet 2-67 config.zoning.replaceZoneSet 2-68 config.zoning.clearZoneSet 2-69 config.zoning.addZone 2-70 CLI reference guide for directors and edge switches v - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 6
2-88 perf Commands 2-89 perf.class2 2-90 perf.class3 2-92 perf.clearStats 2-94 perf.errors 2-95 perf.link 2-97 perf.traffic 2-99 show Commands 2-101 show.eventLog 2-102 show. .port.status 2-120 show.port.technology 2-124 vi CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 7
show.security.fabricBinding 2-126 show.security.portBinding 2-127 show.security.switchBinding 2-129 show.switch 2-130 show.system 2-132 show.zoning 2-134 A Error Messages Glossary Index 1 Document Conventions xxv 1-1 CLI Command Tree Navigation Conventions 1-2 1-2 CLI Command Tree - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 8
- HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 9
reference guide provides information to use the command line interface (CLI) for the following Hewlett-Packard (HP) products: • HP StorageWorks Director 2/64. • HP StorageWorks Director 2/140 • HP StorageWorks Edge Switch 2/16. • HP StorageWorks Edge Switch 2/24. • HP StorageWorks Edge Switch 2/32 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 10
and messages) Variables Website addresses Convention Blue text: Figure 1 Bold Italics Monospace font COMMAND NAMES are uppercase unless they are case sensitive Monospace, italic font Sans serif font (http://thenew.hp.com) x CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 11
off in this manner presents clarifying information or specific instructions. NOTE: Text set off in this manner presents presence of electrical shock hazards. Enclosed area contains no operator serviceable parts. WARNING: To reduce the risk of injury from guide for directors and edge switches xi - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 12
or damage to the equipment, observe local occupational health and safety requirements and guidelines for manually handling material. Rack Stability WARNING: To reduce the risk of personal injury or damage to is extended for any reason. xii CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 13
Getting Help If you still have a question after reading this guide, contact an HP authorized service provider or access our website: http://thenew.hp.com. HP Technical Support In North America, call technical support at 1-800-652-6672, available 24 hours a day, 7 days a week. NOTE: For continuous - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 14
- HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 15
1-2 1-10 1-13 1-14 1-14 1-16 Command Line Interface Overview The Command Line Interface (CLI) is a feature that provides an alternative to the HP High Availability Fabric Manger (HAFM) and Embedded Web Server (EWS) interface products for Director and Switch management capabilities. The CLI can only - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 16
below: Config.Port> Navigation Conventions Basic command line navigation conventions are supported. The following table includes asynchronous commands recognized by the CLI. Table a completed line to the parser. Used to separate keywords. 1-2 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 17
Command Tree Navigation Conventions (Continued) Character Sequence Common Name Action or Description # Pound Sign Used to designate comments in a script. ? Question Mark Provide help character. Position the cursor left one character. CLI reference guide for directors and edge switches 1-3 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 18
port blocked extDist fan name speed type show security fabricBinding ------ activatePending addMember clearMemList deleteMember replacePending setFabBindState showActive showPending security portBinding ------- bound wwn 1-4 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 19
Tree (Continued) switchBinding ----- userRights -------- snmp switch system -----------zoning addCommunity authTraps deleteCommunity show bbCredit domainRSCN addMember deleteMember setSwitchBindState show administrator operator show CLI reference guide for directors and edge switches 1-5 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 20
addPortMem clearZone deleteWwnMem deletePortMem renameZone showPending showActive maint port beacon reset system beacon clearSysError ipl resetConfig setOnlineState perf class2 class3 clearStats errors link traffic show eventLog frus 1-6 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 21
nodes status technology security fabricBinding portBinding switchBinding switch system zoning Commands are shown, with the port 4 on the Switch, this series of commands is entered: Root> config Config> port Config.Port> name 4 "HP Tape Drive" CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 22
port.beacon command, the commands are entered as follows: Root> config port name 4 "HP Tape Drive" Root> maint port beacon 4 true As shown in this example, use Root> config port name 4 "HP Tape Drive" Root> maint port beacon 4 true 1-8 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 23
> config zoning addWwnMem TheUltimateZone 10:00:00:00:C9:22:9B:64 Root> • Whenever the position in the CLI command tree moves Building_24_Room_16 Config.System> location "Building 24 Room 16" If spaces are not included in a parameter HP Lab\"" CLI reference guide for directors and edge switches 1-9 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 24
standard 80 columns supported by most Telnet interfaces. The output is left-justified. Logging In and Logging Out The CLI allows a single Telnet client to be connected to a Director or Edge Switch. If a described in the following section. 1-10 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 25
other product interfaces, for example, SNMP or Hewlett-Packard (HP) product interfaces. Parameters This command has no parameters. Command Examples login Username: Administrator Password: password login Username: Operator Password: password CLI reference guide for directors and edge switches 1-11 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 26
logs out the single Telnet client connected to a Director or Edge Switch. This command can be entered at any point in the command tree. Parameters This command has no parameters. Command Examples Root> logout Config> logout Config.Port> logout 1-12 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 27
0C0D0E0F, 04/12/01 9:58A,385,Severe,CTP-0,00010203 04050607 08090A0B 0C0D0E0F, 04/11/01 7:18P,395,Severe,CTP-0,00010203 04050607 08090A0B 0C0D0E0F, CLI reference guide for directors and edge switches 1-13 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 28
Error 234: Invalid Command • An error associated with a fabric, Director, or Edge Switch. For example, a parameter error is detected by a Switch, where port 24 is entered for a Switch that supports only 16 - Display the system configuration 1-14 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 29
Root> config port config.port CR> config.port> ## Begin Script ## config.port CR> The pound sign cannot be used after any other characters (a command, for example) to start a comment. The following is to 200 characters per line. CLI reference guide for directors and edge switches 1-15 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 30
Switch. Although the primary use of the CLI is in host-based scripting environments, the CLI commands can also be entered directly at a command line. Any hardware platform that supports verify your configuration's completeness and accuracy. 1-16 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 31
they generate. Section Command Overview config Commands config.switch Commands config.zoning Commands maint Commands perf Commands show Commands Page 2 -1 2 -1 2 -44 2 -64 2 -81 2 -89 2 -101 Command can by used only by the administrator. CLI reference guide for directors and edge switches 2-1 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 32
is possible, however unlikely, that the copy of the zone set encounters no errors until the zone set is activated to the fabric. In general, the config commands) use the USASCII character set. All of the characters in this 128-character set (the first 7-bit subset of the ISO-8859-1 Latin-1 character - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 33
whether enterpriseFabMode is active. Valid values are activate and deactivate. Boolean 1 and 0 may be substituted as values. Command Example Root> config features enterpriseFabMode 1 CLI reference guide for directors and edge switches 2-3 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 34
be installed in order to enable the FICON Management Server State. (The Edge Switch 2/24 does not accept this command.) Parameters This command has one parameter: substituted as values. Command Example Root> config features ficonms 1 2-4 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 35
a feature set that is enabled by the provided feature key. The Switch can be either offline or online when the command is executed. Parameters This command has one parameter: featureKey Root> config features installKey AaBb-CCdD-eeFF-gH CLI reference guide for directors and edge switches 2-5 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 36
Management Server is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values. Command Example Root> onfig features OpenSysMS 1 2-6 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 37
This command shows the product feature information configured for this Switch. Parameters This command has no parameters. Command Example Root individual feature. Fabric-wide features are displayed as Active/Inactive. Switch-centric features are displayed as Enabled/Disabled. Output Example The - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 38
CLI Commands Installed Feature Set Feature Open Systems Management Server OSMS Flex Ports 8 Flex Ports SANtegrity Fabric Binding SANtegrity Switch Binding SANtegrity Enterprise Fabrics State ----Enabled Enabled Active Enabled Active 2-8 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 39
parameters: ipAddress gatewayAddress subnetMask Specifies the new IP address for the Director or Edge Switch. The address must be entered in dotted decimal format (for example Example Root> config ip ethernet 10.0.0.0 0.0.0.0 255.0.0.0 CLI reference guide for directors and edge switches 2-9 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 40
no parameters. Command Example Root> config ip show Output The LAN configuration data is displayed as a table that includes the following properties. 2-10 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 41
CLI Commands IP Address Gateway Address Subnet Mask The IP address. The gateway address. The subnet mask. Output Example The output from the config.ip.show command displays as follows: CLI reference guide for directors and edge switches 2-11 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 42
CLI Commands IP Address: Gateway Address: Subnet Mask: 10.0.0.0 0.0.0.0 255.0.0.0 2-12 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 43
Specifies the port number. Valid values are: 0-15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 blockedState 0-127 and 132-144 for the Director 2/140 Specifies the blocked state for the port. Valid values are true and - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 44
required parameters: portNumber Specifies the port number. Valid values are: 0-5 for the Edge Switch 2/16 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 extDistOn 0-127 and 132-144 for the Director 2/140 Specifies the extended distance state for the port. Valid values are true and - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 45
sets the fabric address notification (FAN) state for a port (Edge Switch 2/24 only). This configuration can be applied to any port regardless of Specifies the port number. Valid values are: fanOn 0-23 for the Edge Switch 2/24 Specifies the FAN state for the port. Valid values are true and - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 46
Switch 2/32 0-63 for the Director 2/64 portName 0-127 and 132-144 for the Director 2/140 Specifies the name for the port. The port name must not exceed 24 characters in length. Command Example Root> config port name 4 "HP Tape Drive" 2-16 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 47
speed to 2.125 Gbps or to negotiate in a Switch with a 1 Gbps Switch speed results in an error message. If the port speed is set to negotiate Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 portSpeed 0-127 and 132-144 for the Director 2/140 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 48
command has two required parameters: portNumber Specifies the port number. Valid values are: 0-15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 2-18 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 49
CLI Commands portType Specifies the type of the port. Valid values are eport, fport, and gport, fxport (Edge Switch 2/24 only) gxport (Edge Switch 2/24 only). Command Example Root> config port type 4 fport CLI reference guide for directors and edge switches 2-19 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 50
Specifies the port number. Valid values are: 0-15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 Command Example Root> config port show 4 Output The port configuration is displayed - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 51
config.port.show command displays as follows. Port Number: Name: Blocked: Extended distance: Type: Speed: 4 HP4 tape drive false false F Port 2 Gb/sec CLI reference guide for directors and edge switches 2-21 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 52
possible, however unlikely, that the copy of the list encounters no errors until the list is activated to the fabric. config.security.fabricBinding. verifies the list before activating it to the fabric and adds the managed Switch to the list if it is not already present. Parameters This command has - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 53
: This information is not saved to the fabric until the activatePending command is issued. When the list is cleared, the CLI automatically adds the managed Switch to the fabric membership list. Parameters This command has no parameters: CLI reference guide for directors and edge switches 2-23 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 54
Syntax replacePending Purpose This command replaces the pending working area with the fabric binding configuration that is currently loaded on the fabric. 2-24 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 55
work area. Valid values are: inactive - Deactivates fabric binding. Switches and Directors are allowed to join the fabric without restriction. The fabric membership , but all new members must be manually added before connecting. The Switch must be online to complete this request. Command Examples - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 56
been activated to the fabric. If no changes have been made to the pending environment, the CLI displays the Active membership list. 2-26 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 57
Active Restricting Fabric Membership ListThe active fabric membership list. Output Example The output from the config.security.fabricBinding.showActive command displays as follows: CLI reference guide for directors and edge switches 2-27 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 58
0-15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 portBindingState 0-127 and 132-144 for the Director 2/140 Specifies the port binding and 0 may be substituted as values. 2-28 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 59
the port number for which the bound WWN is being set. Valid port number values are: 0-15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 CLI reference guide for directors and edge switches 2-29 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 60
security portBinding wwn 4 remove config.security.portBinding.show Syntax show portNumber Purpose This command shows the port binding configuration for a single port. 2-30 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 61
0-15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 Command Example Root> config security WWN: 4 Active AA:99:23:23:08:14:88:C1 CLI reference guide for directors and edge switches 2-31 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 62
switchBinding addMember AA:99:23:23:08:14:88:C1 config.security.deleteMember Syntax deleteMember wwn Purpose This command removes a member from the Switch Member List. The user cannot remove a member that is currently logged into the Switch. 2-32 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 63
AA:99:23:23:08:14:88:C1 config.security.switchBinding.setState Syntax setState switchBindingState Purpose This command removes a member from the Switch Member List. The user cannot remove a member that is currently logged into the Switch. CLI reference guide for directors and edge switches 2-33 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 64
membership list. Command Examples Root> config security switchBinding setState allRestrict config.security.switchBinding.show Syntax show Purpose This command displays the Switch binding configuration. Parameters This command has no parameters. 2-34 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 65
the Switch. Output Example The output from the config.security.portBinding.show command displays as follows: Switch Binding State: Enabled and Restricting E Ports 00:11:22:33:44:55:66:77 88:99:AA:BB:CC:DD:EE:FF 11:55:35:45:24:78:98:FA CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 66
characters and spaces. Spaces are not valid even though quotation marks are used. Command Example Root> config security userRights administrator "Administrator" "newpassword" 2-36 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 67
control characters and spaces. Spaces are not valid even though quotation marks are used. Command Example Root> config security userRights operator "Operator" "newpassword" CLI reference guide for directors and edge switches 2-37 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 68
The output from the config.security.userRights.show command displays as follows. Operator Username: Operator Operator Password Administrator Username: Administrator Administrator Password 2-38 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 69
community specified by commIndex. The community name must not exceed 32 characters in length. Valid characters include all those in the ISO format. Specifies the user datagram protocol (UDP) port number to which the Director sends traps for each recipient. The value can be a decimal number or - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 70
CLI Commands Command Example Root> config snmp addCommunity 1 "CommunityName1" enabled 123.123.123.123 162 2-40 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 71
stations when unauthorized stations try to access SNMP information from the Director or Edge Switch. Parameters This command has one parameter: enabledState Specifies whether the config snmp authTraps true Root> config snmp authTraps 1 CLI reference guide for directors and edge switches 2-41 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 72
the commIndex parameter of the config.snmp.addCommunity command. Valid values are integers in the range 1-6. Command Example Root> config snmp deleteCommunity 5 2-42 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 73
parameters. Command Example Root> config snmp show Output The Switch configuration data is displayed as a table that includes the SNMP management stations when unauthorized stations attempt to access SNMP information from the Switch. The community index number. The name of the community. The write - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 74
config.switch commands, except for the config.switch.show command, require that the Switch be set offline. (Use the maint.system.setOnlineState to set the Switch offline.) If these commands are entered while the Switch is online, an error message results. 2-44 CLI reference guide for directors and - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 75
one parameter: bbCreditValue Specifies the new buffer-to-buffer credit value. This parameter must be an integer in the range 1-60. Command Example Root> config switch bbCredit 2 CLI reference guide for directors and edge switches 2-45 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 76
Purpose This command sets the domain RSCN state for the Switch. The Switch can be either offline or online when this command is executed. Parameters This command has and 0 may be substituted as values. Command Example Root> config switch domainRSCN 1 2-46 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 77
This command sets the insistent domain ID state for the Switch. Parameters This command has one parameter: insistentDomainIdState Specifies whether 0 may be substituted as values. Command Example Root> config switch insistDomainId 1 CLI reference guide for directors and edge switches 2-47 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 78
Syntax edTOV timeoutValue Purpose This command sets the E_D_TOV for the Switch. Description The Switch must be set offline before this command is entered. Special care it must be smaller than the R_A_TOV. Command Example Root> config switch edTOV 4 2-48 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 79
has one parameter: interopMode Specifies the interoperability mode. Valid values are: • mcdata (for Homogenous Fabric mode) • open (for Open Fabric 1.0 mode) Command Example Root> config switch interopMode open CLI reference guide for directors and edge switches 2-49 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 80
has one parameter: domainId Specifies the new preferred domain ID value. This parameter must be an integer in the range 1-31. Command Example Root> config switch prefDomainId 1 2-50 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 81
sets the numerical Switch priority to 255. This Switch is not able to become the principal Switch. NOTE: At least one Switch in a multiswitch fabric must have a Switch priority value of principal or default. NOTE: The number codes 2-253 are not now in use. CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 82
CLI Commands Command Example Root> config switch priority principal 2-52 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 83
Syntax raTOV timeoutValue Purpose This command sets the R_A_TOV for the Switch. Description The Switch must be set offline before this command is entered. Special must be larger than the E_D_TOV. Command Example Root> config switch raTOV 20 CLI reference guide for directors and edge switches 2-53 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 84
enabled, traffic ceases in the fabric for the time specified in the config.switch.edTOV command. This delay allows frames sent on the old path to exit values. Command Examples Root> config switch rerouteDelay true Root> config switch rerouteDelay 1 2-54 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 85
Purpose This command sets the speed for the Switch. NOTE: This command is only applicable for the Director 2/64. Edge Switches and the Director 2/140 cannot change speed. Description The Switch must be set offline before this command is entered. A Switch can be configured to operate at 1.0625 Gbps - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 86
is set in tenths of a second. Error Detect Time Out Value. Preferred Domain Id Switch Priority This value is set in tenths of a second. The preferred domain ID of the Switch. The Switch priority. Values are Principal, Default, or Never Principal. 2-56 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 87
as follows. BB Credit: 2 R_A_TOV: 20 E_D_TOV: 4 Preferred Domain Id: 1 Switch Priority: Principal Speed: 2 Gb/sec Rerouting Delay: Enabled Interop Mode: Open Fabric 1.0 Insistent Domain Id: Disabled Domain RSCN: Enabled CLI reference guide for directors and edge switches 2-57 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 88
" Purpose This command sets the system contact attribute. Parameters This command has one parameter: systemContact Specifies the new system contact string for the Director or Edge Switch. The contact can contain 0-255 characters. Command Example Root> config system contact "Joe" 2-58 CLI reference - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 89
the time parameter must be hh:mm:ss. Valid time values include: • hh: 0-23 • mm: 0-59 • ss: 0-59 Command Examples Root> config system date 04:16:2001 10:34:01 Root> config system date 10/09/2001 14:07:55 CLI reference guide for directors and edge switches 2-59 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 90
This command has one parameter: systemDescription Specifies the new system description string for the Director or Edge Switch. The name can contain 0-255 characters. Command Example Root> config system description "hp StorageWorks director 2/64" 2-60 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 91
" Purpose This command sets the system location attribute. Parameters This command has one parameter: systemLocation Specifies the new system location for the Director or Edge Switch. The location can contain 0-255 characters. Command Example Root> config system location "Everywhere" CLI reference - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 92
system name attribute. Parameters This command has one required parameter: systemName Specifies the new system name for the Director or Edge Switch. The name can contain 0-24 characters. Command Example Root> config system name "hp edge switch 2/16" 2-62 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 93
. The system date and time. Output Examples The output from the config.system.show command displays as follows. Name: Description: Contact: Location: Date/Time: hp director hp StorageWorks director 2/64 Joe Everywhere 04/16/2001 10:34:01 CLI reference guide for directors and edge switches 2-63 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 94
no errors until the zone set is activated to the fabric. NOTE: Port numbers cannot be used for zone members if the interoperability mode for the Switch or Director is set to Open Fabric 1.0 mode. In this case, you must use node WWNs as zone members. 2-64 CLI reference guide for directors and - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 95
values are true and false. Boolean 1 and 0 may be substituted as values. Command Examples Root> config zoning setDefZoneState false Root> config zoning setDefZoneState 0 CLI reference guide for directors and edge switches 2-65 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 96
in the fabric. Parameters This command has no parameters. Command Example Root> config zoning activateZoneSet NOTE: If the interoperability mode for the Switch or Director is set to Open Fabric 1.0 mode when the zone is activated, any zone members specified by port number are ignored. 2-66 CLI - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 97
this command. NOTE: This command takes effect immediately in the fabric. Parameters This command has no parameters. Command Example Root> config zoning deactiveZoneSet CLI reference guide for directors and edge switches 2-67 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 98
active zone set that is currently loaded on the fabric. Parameters This command has no parameters. Command Example Root> config zoning replaceZoneSet 2-68 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 99
immediately. Description This command does not change the zone set name. Parameters This command has no parameters. Command Example Root> config zoning clearZoneSet CLI reference guide for directors and edge switches 2-69 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 100
1-64 characters. Valid characters are: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrs tuvwxyz0123456789$-^_ Spaces are not permitted, and the first character must be alphabetical. Command Example Root> config zoning addZone TheUltimateZone 2-70 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 101
Syntax deleteZone "zoneName" Purpose This command deletes a zone from the zone set in the work area. Description Changes are not activated on the Switch until the config.zoning.activeZoneSet command is issued. Parameters This command has one parameter: zoneName Specifies the name of the zone to be - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 102
new name for the zone set. The zoneSetName must contain 1-64 characters. Valid characters are: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrs tuvwxyz0123456789$-^_ Spaces are not Example Root> config zoning renameZoneSet TheUltimateZoneSet 2-72 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 103
Wide Name zone member to the specified zone in the work area. Description The CLI supports the number of zones members per zone specified for a given product. Parameters This command addWwnMem TheUltimateZone 10:00:00:00:C9:22:9B:64 CLI reference guide for directors and edge switches 2-73 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 104
if the interoperability mode for the Switch or Director is set to Open Fabric 1.0 mode. Description The CLI supports the number of zones members per Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 105
. Parameters This command has one parameter: zoneName Specifies the name of the zone to be cleared. Command Example Root> config zoning clearZone TheNotUltimateAtAllZone CLI reference guide for directors and edge switches 2-75 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 106
:00:AA:00:AA:00:AA:00. Command Example Root> config zoning deleteWwnMem TheNotSoUltimateZone 10:00:00:00:C9:22:9B:AB 2-76 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 107
are: 0-15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 Command Example Root> config zoning deletePortMem TheUltimateZone 10 5 CLI reference guide for directors and edge switches 2-77 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 108
renamed. Specifies the new zone name. The newZoneName must contain 1-64 characters. Valid characters are: ABCDEFGHIJKLMNOPQRSTUVWXYZabcde fghijklmnopqrstuvwxyz$-^_ Spaces are not config zoning renameZone TheOldUltimateZone TheUltimateZone 2-78 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 109
: 10:00:00:00:C9:22:9B:C6 ZoneMember: 10:00:00:00:C9:22:9B:AB Zone: TheNewNotUltimateAtAllZone ZoneMember: Domain 2, Port 63 CLI reference guide for directors and edge switches 2-79 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 110
ZoneSet: TheUltimateZoneSet Zone: TheUltimateZone ZoneMember: Domain 10, Port 6 ZoneMember: Domain 15, Port 2 ZoneMember: Domain 2, Port 63 ZoneMember: 10:00:00:00:C9:22:9B:64 ZoneMember: 10:00:00:00:C9:22:9B:BD Zone: TheNotSoUltimateZone ZoneMember: 10:00:00:00:C9:22:9B:AB ZoneMember: 10:00:00:00 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 111
non-volatile settings, including network information, to their default values (factory settings). Management access may be lost until the network information is restored. CLI reference guide for directors and edge switches 2-81 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 112
: portNumber Specifies the port number. Valid values are: 0-15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 beaconState Specifies whether unit beaconing is enabled. Valid values are true and - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 113
to the port and the device is online, the reset causes a link reset Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 Command Example Root> maint port reset 4 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 114
are true and false. Boolean 1 and 0 may be substituted as values. Command Examples Root> maint system beacon false Root> maint system beacon 0 2-84 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 115
maint.system.clearSysError Syntax clearSysError Purpose This command clears the system error light. Parameters This command has no parameters. Command Example Root> maint system clearSysError CLI Commands CLI reference guide for directors and edge switches 2-85 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 116
CLI Commands maint.system.ipi Syntax ipl Purpose This command IPLs the Switch. Description Connection to the command line interface is lost when this command runs. Parameters This command has no parameters. Command Example Root> maint system ipl 2-86 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 117
in the firmware of the Director or Edge Switch. For information about the default values, refer to the service manual for your Director or Edge Switch. Parameters This command has no parameters. Command Example Root> maint system resetConfig CLI reference guide for directors and edge switches 2-87 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 118
command has one parameter: onlineState Specifies whether the Switch is online. Valid values are true and false. Boolean 1 and 0 may be substituted as values. Command Examples Root> maint system setOnlineState true Root> maint system setOnlineState 1 2-88 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 119
that relate to performance services. The commands in the perf branch can by used by either the administrator or the operator. Note that the counters in perf command output are 32-bit values that wrap 967,296 x 12) + 1842953 = 51,541,450,505. CLI reference guide for directors and edge switches 2-89 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 120
are: 0-15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 Command Example Root> perf class2 within frames that the port has received. 2-90 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 121
The output from the perf.class2 command displays as follows. Port 2 Statistic Count Wrap RxFrames 2953184 23 TxFrames 1842953 12 RxWords 2943184 65 TxWords 1842953 32 Busied Frms 2953184 0 Rjct Frames 1842953 0 CLI reference guide for directors and edge switches 2-91 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 122
are: 0-15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 Command Example Root> perf class3 within frames that the port has received. 2-92 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 123
The output from the perf.class3 command displays as follows. Port 2 Statistic Count Wrap RxFrames 2953184 23 TxFrames 1842953 12 RxWords 2953184 65 TxWords 1842953 32 Disc Frames 2953184 26 CLI reference guide for directors and edge switches 2-93 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 124
Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 all for every port on the Director or Edge Switch Command Example Root> perf clearStats 4 Root> perf clearStats all 2-94 CLI reference guide for directors - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 125
Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 Command Example Root> perf errors 2 Output The port error to both Class 2 and Class 3 traffic. CLI reference guide for directors and edge switches 2-95 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 126
because of disparity errors or misaligned K characters while in the OL2 or OL3 state. CRC Errs The number of frame CRC errors detected by the received with unknown addressing. Output Example The output from the perf.errors command displays as follows. Port 2 Statistic Count Prim Seq Err - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 127
Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 Command Example . The number of offline sequences initiated by this Director or Edge Switch port. The number of link resets initiated by the attached N_Port - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 128
transition or timeout. Link Flrs The number of times the port has detected a link error resulting from an invalid link state transition or timeout. Sync Losses The number of times the 753452 351269 2953184 1842953 2953184 1842953 35246 2-98 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 129
0-15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0-31 for the Edge Switch 2/32 0-63 for the Director 2/64 0-127 and 132-144 for the Director 2/140 Command Example Root> perf 2 and Class 3 frames that the port has transmitted. CLI reference guide for directors and edge switches 2-99 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 130
perf.traffic command displays as follows. Port 2 Statistic ----------Rx% Tx% RxFrames TxFrames TxWords TxWords Count ---------75 30 2953184 1842953 2953184 1842953 Wrap ---------N/A N/A 23 12 65 32 2-100 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 131
tree branches, for example, config.port.show. The commands in the show branch can by used by either the Administrator or the Operator. CLI reference guide for directors and edge switches 2-101 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 132
SBAR cards or the system shutdowns due to CTP thermal threshold violations. Info-Unit operational (information only). The FRU and FRU position, where applicable. The 32-byte hexidecimal description of the event in words. 2-102 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 133
375 Major CTP-0 385 Severe CTP-0 395 Severe CTP-0 Event Data 00010203 04050607 08090A0B 0C0D0E0F 00010203 04050607 08090A0B 0C0D0E0F 00010203 04050607 08090A0B 0C0D0E0F CLI reference guide for directors and edge switches 2-103 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 134
displays as follows: Installed Feature Set Open Systems Management Server Flex Ports SANtegrity SANtegrity SANtegrity Feature OSMS 8 Flex Ports Fabric Binding Switch Binding Enterprise Fabrics State ---Enabled Enabled Active Enabled Active 2-104 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 135
an Edge Switch 2/16, 2/32, or an Director 2/64, the output in this column is NotInstalled. Position State • If a FRU is not installed on a Edge Switch 2/24 or an Director 2/140, the the Edge Switch 2/24.) The part number of the FRU. CLI reference guide for directors and edge switches 2-105 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 136
Active 82051743 292006-001 off 1471 UPM 14 Active 82063560 292006-001 off 1456 UPM 15 Active 82051815 292006-001 off 1471 2-106 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 137
.ethernet command displays as follows. LAN Information IP Address: Gateway Address: Subnet Mask: 144.49.10.15 144.49.10.1 255.255.255.0 CLI reference guide for directors and edge switches 2-107 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 138
receive data field size from the FLOGI received from the attached N_Port. The class of service (for example, 1; 2; 3; 4; 5; 6; F; 1,2; 2,3). The port World Wide Name of the attached device. The node World Wide Name of the attached device. 2-108 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 139
:11:22:33:44:55:00:77 20:11:22:33:44:55:66:77 1 10 2 00:11:22:33:44:55:00:78 20:11:22:33:44:55:66:78 20:11:22:33:44:55:66:84 13 10 2,3 00:11:22:33:44:55:00:85 20:11:22:33:44:55:66:85 15 10 2,3 00:11:22:33:44:55:00:86 20:11:22:33:44:55:66:86 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 140
device. The class of service (for example, 1; 2; 3; 4; 5; 6; F; 1,2; 2,3). The FC4 types registered for this device. One or more numbers display in this field. The numbers in this field correspond to the list at the bottom of the table. 2-110 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 141
-3 Peer 10: SBCCS-Channel 11: SBCCS-Control Unit 12: FC-SB-2 Channel to Control Unit 13: FC-SB-2 Control Unit to Channel 14: Fibre Channel Service 15: FC-FG 16: FC-SW 17: FC-AL 18: SNMP 19: HIPPI-FP 20: Vendor Unique CLI reference guide for directors and edge switches 2-111 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 142
per node. For this reason, this command is supported only in comma-delimited mode. Parameters This command attached device. The node World Wide Name of the attached device. The class of service (for example, 1; 2; 3; 4; 5; 6; F; 1,2; 2,3). The FC4 types guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 143
, N, 010400, 00:11:22:33:44:55:00:77, 20:11:22:33:44:55:66:77, 2-3, 2, Node Name A, Port Name A, N, 20:11:22:33:44:55:66:77, 2, 0, Loop Node 1, Loop Port 7 FL, 000002, 00:11:22:33:44:55:66:04 20:11:22:33:44:55:66:77, 3, 2, Loop Node 2, Loop Port 7, CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 144
.blocked command. The extended distance state as set in the config.port.extDist command. (This does not apply to the Edge Switch 2/24.) The configured fabric address notification (FAN) state. (Edge Switch 2/24 only.) The port type as set in the config.port.type command. The port speed as set in the - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 145
2 Gb/sec 2 Gb/sec 1 Gb/sec Negotiate 1 Gb/sec 1 Gb/sec 2 Gb/sec 2 Gb/sec 1 Gb/sec 1 Gb/sec 1 Gb/sec 1 Gb/sec CLI reference guide for directors and edge switches 2-115 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 146
the port. The current operating speed (1.0625 Gbps, 2.125 Gbps, or Not Established). The current transceiver capability speed (1.0625 or 2.125 Gbps). 2-116 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 147
:80:14:11:22:33:44 1 Gb/sec 2 Gb/sec 15 10:00:80:15:11:22:33:44 1 Gb/sec 2 Gb/sec CLI reference guide for directors and edge switches 2-117 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 148
has one parameter. portNumber Specifies the port number. Valid values are: 0-23 for the Edge Switch 2/24 Command Example Root> show port nodes portNumber Output The port data is displayed as a is left Size blank for private devices. 2-118 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 149
2112 2112 2112 2112 2112 If no nodes are on the loop, a message displays saying that no loop nodes are on the port. CLI reference guide for directors and edge switches 2-119 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 150
properties: Port State The port number. The port state. For example: • Segmented E_Port • Invalid Attachment • Not Installed • Online • Offline • Not Operational • No Light • Testing • Port Failure • Link Reset • Inactive 2-120 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 151
, depending on what is connected to the port. On the Edge Switch 2/24, if the configured port type is Fx_Port, the operational port Error • 05 No Principal Switch • 06 No Response from Attached Switch • 07 ELP Retransmission Failure Timeout CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 152
• 21 Fabric Binding violation • 22 Authorization failure • 23 Switch Binding violation If the operational state is Inactive only the following messages can be generated: • 24 Inactive - RC 0 • 25 No Serial Number • 26 Feature Not Enabled 2-122 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 153
Segmented E_Port ePort 8 Online ePort 9 Offline fPort 10 Inactive ePort 11 Online fPort 12 No Light fPort 13 Online fPort 14 Invalid Attachment fPort 15 Online fPort Attached WWN 10 :80:00:11:22:33:59 10:00:80:00:11:22:33:64 10:00:80:00:11:22:33:66 Beaconing Reason Off On On - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 154
type (LC, MT_RJ, MU, Internal). The transceiver type (Long LC, Short, Short OFC, Long LL, Long Dist). The distances supported (Short, Intermediate, Long, Very Long). The media type (M-M 62.5um, M-M 50um, M-M 50,62.5um, S-M 9um, Copper). 2-124 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 155
LC Long LC Long M-M 50um 13 LC Long LC Long M-M 50um 14 LC Long LC Long M-M 50um 15 LC Long LC Long M-M 50um CLI reference guide for directors and edge switches 2-125 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 156
:55:66:77) Domain 2 (88:99:AA:BB:CC:DD:EE:FF) Domain 14 (11:55:35:45:24:78:98:FA) 2-126 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 157
of the device that is bound to the specified port. If this field is blank, no device is bound to the specified port. CLI reference guide for directors and edge switches 2-127 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 158
:00 00:00:00:00:00:00:00:00 00:00:00:00:00:00:00:00 00:00:00:00:00:00:00:00 2-128 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 159
Restricting F_Ports, Enabled and Restricting E_Ports, or Enabled and Restricting All Ports Switch Membership List The active Switch membership list. Output Example The output from the show.security.switchBinding command displays as follows: CLI reference guide for directors and edge switches 2-129 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 160
.switch.edTov command. The domain ID as set in the config.switch.domainId command. The Switch priority as set in the config.switch.priority command. The Switch speed as set in the config.switch.speed command. (This does not apply to the Edge Switch 2/24.) 2-130 CLI reference guide for directors - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 161
Id: 1 Switch Priority: Default Speed: 2 Gb/sec Rerouting Delay: Enabled Operating Mode: Open Systems Interop Mode: Open Fabric 1.0 Active Domain Id: 1 World Wide Name: 10:00:08:00:88:00:21:07 Insistent Domain Id: Enabled Domain RSCN: Enabled CLI reference guide for directors and - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 162
. Serial NumberThe serial number for the system. Type Number The type number for the system. Model Number The model number for the system (for example, Director 2/64). EC Level The engineering change level installed. 2-132 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 163
Contact: Location: Date/Time: Serial Number: Type Number: Model Number; EC Level: Firmware Version: Beaconing: hp3 director hp StorageWorks director 2/64 Joe Everywhere 04/16/2001 10:34:01AM 123456789 1 director 2/64 1 01.03.00 34 Disabled CLI reference guide for directors and edge switches 2-133 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 164
ZoneSet: TheUltimateZoneSet Zone: TheUltimateZone ZoneMember: Domain 10, Port 6 ZoneMember: Domain 15, Port 2 ZoneMember: Domain 2, Port 63 ZoneMember: 10:00:00:00:C9:22:9B:64 ZoneMember: 10:00:00:00:C9:22:9B:BD Zone: TheNotSoUltimateZone ZoneMember: 10:00:00:00:C9:22:9B:AB ZoneMember: 10:00:00:00 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 165
Error 08: Invalid Switch Name Error 09: Invalid Switch Description The Switch is busy or processing another request. The value entered for the Switch name is invalid. The value entered for the Switch description is invalid. Action After a few second, reissue the request. The name for a Director - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 166
number within the range supported by the Director or Edge Switch. Valid values are: • 0-15 for the Edge Switch 2/16 • 0-23 for the Edge Switch 2/24 • 0-31 for the Edge Switch 2/32 • 0-63 for the Director 2/64 • 0-127 and 132-144 for the Director 2/140 A-2 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 167
14: Invalid Port Name Error 15: Invalid BB Credit Error 16: Invalid R_A_TOV Error 17: Invalid E_D_TOV Description The value entered for the port name is invalid. The value . Check to be sure that all these conditions are met and re-submit. CLI reference guide for directors and edge switches A-3 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 168
Error 18: Invalid TOV Error 20: Invalid Preferred Domain ID Error 21: Invalid Switch Priority Error 29: Invalid Gateway Address Error 30: Invalid IP Address Description The E_D_TOV and R_A_TOV values are not compatible. The value entered for the preferred domain ID for the Director or Edge Switch - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 169
31: Invalid Subnet Mask Error 32: Invalid SNMP Community Name Error 33: Invalid SNMP Trap Address Description The value entered for the new subnet mask for (for example, 10.0.0.0). Enter an SNMP trap address that meets the requirements. CLI reference guide for directors and edge switches A-5 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 170
34: Duplicate Community Names Require Identical Write Authorization Error 37: Invalid Month Error 38: Invalid Day Error 39: Invalid Year Error 40: Invalid Hour Description The two or more . Enter a time, including an hour in the range 0-23. A-6 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 171
Messages Message Error 41: Invalid Minute Error 42: Invalid Second Error 44: Max SNMP Communities Defined Error 45: Not Allowed While Switch Online Error 55: Invalid Zone name in the range of 1-64 characters, using the valid characters. CLI reference guide for directors and edge switches A-7 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 172
Messages Message Error 57: Duplicate Zone Error 59: Zone Name in Use Error 60: Invalid Number of Zone Members Error 61: Invalid Zone Member Type Description Two or more zone either a WWN or domain-port pair that meets the requirements. A-8 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 173
must contain 1-64 characters. Valid service manual for product-specific FRU information and procedures. Refer to the product service manual for product-specific FRU information and procedures. Insert a backup FRU, and reenter the command. CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 174
product service manual for the appropriate action. Refer to the product service manual for the appropriate procedure. Clear the system error light before enabling beaconing. Refer to the product service manual for the appropriate procedure. A-10 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 175
1.0 mode. For example, if the following series of commands is entered, Error 83 results: Root> config zoning setDefZoneState true The value of the specified feature the feature key. If problems persist, contact your sales representative. CLI reference guide for directors and edge switches A-11 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 176
or a G_Port, and then resubmit the command. Block the port, and then resubmit the command. This action is not supported. No action necessary. Contact your sales representative. Enter an integer in the range 1-31 for the preferred domain ID. A-12 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 177
is not supported. Refer to the product service manual, and consult your service representative. Refer to the product service manual to determine the speed capabilities of the product. Refer to the product service manual to determine the speed capabilities of the product. The Switch speed should - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 178
Membership List Entries Error 136: Invalid Number of Switch Membership List Entries Error 137: Invalid Fabric Binding State Description This request cannot be completed because the Switch speed has no been set to 2 Gbps. Generic message to indicate a problem in either the Switch binding or fabric - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 179
Error 140: Invalid Insistent Domain ID State Error 141: Invalid Enterprise Fabric Mode Error 142: Invalid Domain RSCN State Description The Switch .switchBi nding on page 2-32. Insistent domain ID's must switch.domain RSCN on page 2-46. CLI reference guide for directors and edge switches A-15 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 180
. Change the state of the Switch to ONLINE and re-submit the request. This operation will be valid if the Switch state is set to offline and Enterprise Fabric mode to inactive. It should be noted, however, that this can be disruptive to the fabric. A-16 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 181
has not been installed to the firmware. The request cannot be completed because the WWN does not exist in the Switch binding membership list. Action The WWN in the Switch membership list. Make appropriate changes and re-submit the request. CLI reference guide for directors and edge switches A-17 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 182
all the parameters are correct, and reenter the command. If problems persist, contact your service representative. Check that all the parameters are correct, and reenter the command. If problems persist, contact your service representative. A-18 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 183
command. If problems persist, contact your service representative. All zone names must be unique. Delete or rename the zone with the duplicate name before reentering the command; or change the name of the new zone, and reenter the command. CLI reference guide for directors and edge switches A-19 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 184
of Zones Is Zero Error 214: A Zone Contains Zero Members Error 215: Zone Set Size Exceeded empty. The size of the local work-area zone set has outgrown the size supported by the CLI. Action No action required A zone set must have at least : A-20 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 185
Enter a port number within the range supported by the Director or Edge Switch. Valid values are: • 0-15 for the Edge Switch 2/16 • 0-23 for the Edge Switch 2/24 • 0-31 for the Edge Switch 2/32 • 0-63 for the Director 2/64 • 0-127 and 132-144 for the Director 2/140 A port may be configured as an - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 186
USASCII Characters Error 226: Argument Is Too Long Error 227: 32 characters in length. Duplicate community names are allowed if the corresponding write authorizations match. Specify a valid SNMP community name, and resubmit the command. A-22 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 187
The udpPortNum parameter does not contain a valid value. Error 230: Invalid WWN The WWN parameter does not contain a valid value. Error 231: Invalid Port Number The value specified for a valid port number value, and resubmit the command. CLI reference guide for directors and edge switches A-23 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 188
Error 232: Invalid Domain ID Error 233: Invalid Member Error 234: Invalid Command Description The value specified for the domainId parameter is invalid. For example, the domainId parameter of the config.switch and then resubmit the command. A-24 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 189
manual that corresponds to the attempted command. Enter the complete command and resubmit. Check that all the parameters of the command are valid, and resubmit the command. If the problem persists, clear and then reconstruct the zone set. CLI reference guide for directors and edge switches A-25 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 190
, and resubmit the command. If the problem persists, contact your service representative. The message that is returned is a string that includes both the error number and the text of the message. delimited mode and re-issue the command. A-26 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 191
242: Open trunking threshold % value must be 0-99 Error 243: Not allowed while S/390 Mode is Enabled Description An invalid threshold percentage has been valid and resubmit the request. This command is not valid for the S/390 environment. CLI reference guide for directors and edge switches A-27 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 192
- HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 193
an operator of a network or device problem. ALPA Arbitrated Loop Physical Address. alias server Fabric software facility that supports multicast group management. arbitration Process of selecting one device from a collection of devices that request service simultaneously. audit log Log summarizing - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 194
center. The HP support center server accepts calls from the HAFM server, logs reported events, and can notify one or more support center representatives. channel A point-to-point link that transports data from one point to the other. Glossary-2 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 195
of frames is not guaranteed. Class 3 Fibre Channel service Provides a connectionless (not dedicated) service without notification of delivery or nondelivery between two N_Ports. displaying of data at one or more input/output units. CLI reference guide for directors and edge switches Glossary-3 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 196
confirmed. DASD Acronym for direct access storage device. datagram See Class 3 Fibre Channel service. default Pertaining to an attribute, value, or option that is assumed when none is protocol (IP) address through a domain name server. Glossary-4 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 197
a GUI similar to Product Manager applications, and supports Director and Switch configuration, statistics monitoring, and basic operation. error message Indication that an error has been detected. See also information message; warning message. error detect time-out value (E_D_TOV) User-specified - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 198
used to run SCSI over Fibre Channel. fiber Physical media types supported by the Fibre Channel specification, such as optical fiber, copper components fails. firmware Embedded program code that resides and executes on a Director or Edge Switch. Glossary-6 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 199
Availability Fabric Manager (HAFM) server Notebook computer shipped with a Director or Edge Switch that runs the HAFM and Product Manager applications. hardware log Record of FRU insertions and removals for a Director or Edge Switch. CLI reference guide for directors and edge switches Glossary-7 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 200
adapter. heterogeneous fabric A fabric with both HP and non-HP products. high availability A performance feature characterized error message; warning message. initial machine load (IML) Hardware reset for a Director or Edge Switch, initiated by pushing the button on a Director CTP card or Edge Switch - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 201
over a network. interswitch link (ISL) Physical E_Port connection between two Directors or Edge Switches in a fabric. IP address See internet protocol address. IPL See initial identifier for a logical device on a storage area network. CLI reference guide for directors and edge switches Glossary-9 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 202
Connector on the Director or Edge Switch where a PC running an ASCII terminal emulator can be attached or dial-up connection made for specialized maintenance support. managed product Hardware product that can be managed with the HAFM application. For example, the Director 2/64 is a managed product - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 203
names from one form into another. For example, the domain name service (DNS) translates domain names into IP addresses. name server zoning N_Port to initialize a link and has detected a problem in doing so. OLS See offline sequence. CLI reference guide for directors and edge switches Glossary-11 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 204
OLS) to attached devices, and the devices cannot log in to the Director. operating state (port) Valid states are: • Online, offline, or testing. • Beaconing. • Invalid attachment. • Link incident to another device can be attached. Glossary-12 CLI reference guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 205
occur on the system. E-mail notification and the configuration of SNMP trap recipients are two examples of remote notification programs that can be implemented on director-class Switches. CLI reference guide for directors and edge switches Glossary-13 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 206
be delivered. RFI Acronym for radio frequency interface. SAN See storage area network. SBAR See serial crossbar assembly error light. serial crossbar (SBAR) assembly Responsible for Fibre Channel frame transmission from any Director port to any other Director guide for directors and edge switches - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 207
those queries are addressed with the correct SNMP community name. storage area network (SAN) A high-performance data communications environment that interconnects computing and storage resources so that is configured to receive traps. CLI reference guide for directors and edge switches Glossary-15 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 208
module (UPM) card Each Director 2/64 UPM card provides four 2. error has been detected. See also error message; information message. World Wide Name (WWN) Eight-byte address that uniquely identifies a Switch identified by the port number of the Director or Edge Switch to which it is attached or by - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 209
Glossary zone set See zone. zoning Grouping of several devices by function or by location. All devices connected to a connectivity product, such as the Director or Edge Switch, may be configured into one or more zones. See also zone. CLI reference guide for directors and edge switches Glossary-17 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 210
- HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 211
2-13 config.port.extDist 2-14 config.port.fan 2-15 config.port.name 2-16 config.port.show 2-20 config.port.speed 2-17 config.port.type 2-18 config.security.fabricBinding 2-22 config .renameZoneSet 2-72 config.zoning.replaceZoneSet 2-68 CLI reference guide for directors and edge switches Index-1 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 212
commands 2-81 config.perf commands 2-89 config.show commands 2-101 config.switch commands 2-44 config.zoning commands 2-64 conventions documentation 1-2 navigation 1-2 D documentation conventions 1-2 E entering CLI commands 1-2 error messages A-1 Index-2 CLI reference guide for directors and edge - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 213
Fabric mode 2-3 Switch Binding add new member 2-32 delete member 2-32, 2-33 show configuration 2-34 Switch Member List add member 2-32 delete member 2-32, 2-33 show 2-35 T Telnet client session 1-16 U user access rights 1-10 Index CLI reference guide for directors and edge switches Index-3 - HP StorageWorks 2/140 | CLI reference guide for directors and edge switches - Page 214
hp StorageWorks
CLI reference guide for directors and
edge switches
Part Number: AA-RQ7AC-TE
Third Edition (January 2003)
This guide covers the essentials of using a command line interface
(CLI) to manage the Hewlett-Packard (HP) StorageWorks Director
and Edge Switches. Also included are CLI commands, syntax,
purpose, and parameters.