HP Surestore 64 HP Surestore Director FC-64 Command Line Interface User's Guid
HP Surestore 64 - Director Switch Manual
View all HP Surestore 64 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP Surestore 64 manual content summary:
- HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 1
Command Line Interface User's Guide hp surestore director fc-64 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 2
- HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 3
hp surestore director fc-64 Command Line Interface User's Guide Edition E0102 Order No. A6534-90909 Printed in U.S.A. - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 4
key Warranty If you have any questions about the warranty for this product, contact your dealer or local HewlettPackard sales representative. Safety Instructions Service Any servicing, adjustment, maintenance, or repair must be performed only by authorized servicetrained personnel. ii - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 5
Contents CONTENTS 1 Introduction Command Line Interface Overview 2 Entering Command Line Interface Commands 3 Documentation Conventions 3 Navigation Conventions 3 Command Tree 4 Navigation of the CLI Command Tree 8 Limitation on Movements 9 Parameters 10 Output 10 Logging In and Logging - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 6
config.ip.ethernet 21 config.ip.show 22 config.port.blocked 23 config.port.extDist 24 config.port.name 25 config.port.type 25 config.port.show 26 config.security.portBinding 27 config.security.portBinding.bound 27 config.security.portBinding.wwn 28 config.security.portBinding.show 30 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 7
.zoning.deleteWwnMem 58 config.zoning.deletePortMem 59 config.zoning.renameZone 60 config.zoning.showPending 60 config.zoning.showActive 62 maint 64 maint.port.beacon 64 maint.port.reset 65 maint.system.beacon 65 maint.system.clearSysError 66 maint.system.ipl 67 maint.system.resetConfig - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 8
maint.system.setOnlineState 68 perf 69 perf.class2 69 perf.class3 70 perf.clearStats 72 perf.errors 73 perf.link 75 perf.traffic 76 show 78 show.eventLog 78 show.frus 80 show.ip.ethernet 81 show.loginServer 82 show.nameServer 84 show.port.config 86 show.port.info 87 show.port.status - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 9
Contents C 112 D 114 E 115 F 116 G 117 H 118 I 119 L 120 M 120 N 121 O 121 P 123 R 124 S 124 T 126 W 126 Z 126 Index vii - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 10
viii - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 11
Tables TABLES 1 CLI Command Tree Navigation Conventions 3 2 Command Line Interface Command Tree 5 ix - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 12
x - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 13
Introduction 1 INTRODUCTION Command Line Interface Overview Entering Command Line Interface Commands Logging In and Logging Out Using the commaDelim Command Handling Command Line Interface Errors Using the Command Line Interface Help Telnet Session This chapter introduces the Command Line - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 14
be entered directly at a command line. Any hardware platform that supports the Telnet client software can be used. The primary purpose of the CLI is to no prompts are displayed to guide the user through a task. If an interactive interface is needed, the HP EFC Manager or HP EWS products should be - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 15
the periods, the command line prompts do include the periods. Config.Port> Navigation Conventions Basic command line navigation conventions are supported. The following table includes the asynchronous commands that are recognized by the Command Line Interface. Table 1 CLI Command Tree Navigation - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 16
Table 1 CLI Command Tree Navigation Conventions (cont'd) Character Sequence Common Name Action or Description ^A Control-A Position the cursor to the start of the line. ^B Control-B Position the cursor left one character. ^D Control-D Delete the current character. ^E Control-E Position - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 17
Introduction The hierarchy from the root, reading from left to right, is as follows. Table 2 Command Line Interface Command Tree config ip ethernet show port blocked extDist name type show security portBinding bound wwn show userRights administrator operator show snmp addCommunity authTraps - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 18
Table 2 Command Line Interface Command Tree system contact date description location name show zoning setDefZoneState activateZoneSet deactivateZoneSet replaceZoneSet clearZoneSet addZone deleteZone renameZoneSet addWwnMem addPortMem clearZone deleteWwnMem deletePortMem renameZone showPending - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 19
Introduction Table 2 Command Line Interface Command Tree ipl resetConfig setOnlineState perf class2 class3 clearStats errors link traffic show eventLog frus ip ethernet loginServer nameServer port config info status technology security portBinding switch system zoning Note that the commands - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 20
Note that the order in which commands are entered determines the order in which the show commands display the values. Refer to Chapter 2, CLI Commands for examples of show commands output. Navigation of the CLI Command Tree Once the Administrator or Operator logs in and receives the Root> prompt, - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 21
recorded in the history, a subsequent asynchronous command (navigation command) cannot depend on it. Root> config zoning addWwnMem TheUltimateZone 10:00:00:00:C9:22:9B: 64 Entering Command Line Interface Commands 9 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 22
the quotation marks without any space between them. Config.System> location "" Output All output from the CLI commands is limited to the standard 80 columns supported by most Telnet interfaces. The output is left-justified. 10 Entering Command Line Interface Commands - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 23
the current user's access is lost. Examples of a restart include an IPL and any power-off situation. User Access Rights The Command Line Interface supports two user access rights: Administrator and Operator. A user who logs in with Administrator access rights can use all of the commands described in - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 24
command. The access rights chosen for the CLI are completely independent of the other product interfaces, for example, SNMP or HP product interfaces. Parameters This command has no parameters. Command Examples login Username: Administrator Password: password login Username: Operator Password - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 25
Introduction logout Syntax logout Purpose This command allows a Telnet client to disconnect from the switch. Description This command logs out the single Telnet client connected to the switch. This command can be entered at any point in the command tree. Parameters This command has no parameters. - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 26
Using the commaDelim Command Note that the output examples shown in the other sections of this publication presume that commaDelim is off. commaDelim Syntax commaDelim enable Purpose This command enables the user to obtain displayed information (from a show command) in comma-delimited, rather than - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 27
Introduction Output Example Output displayed in commaDelim mode is as follows: Root> show eventLog Date/Time,Code,Severity,FRU,Event Data, 04/12/01 10:58A,375,Major,CTP-0,00010203 04050607 08090A0B 0C0D0E0F, 04/12/01 10:58A,375,Major,CTP-0,00010203 04050607 08090A0B 0C0D0E0F, 04/12/01 09:58A,385, - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 28
• An error associated with fabric or switch issues. For example, a parameter error is detected by the switch, where port 24 is entered for a switch that supports only 16 ports. Root> config port name 24 "Port 24" Error 13: Invalid Port Number In either case, the command is ignored. The Command Line - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 29
Introduction Using the Command Line Interface Help The question mark (?) can be used within a command to obtain certain information: • If the question mark is used in place of a command keyword, all the keywords at that level of the CLI command tree display. Root> config system ? Command - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 30
directly at a command line. Any hardware platform that supports the Telnet client software can be used. Ethernet Connection Loss If the Ethernet connection has already timed out, open an HP Embedded Web Server (HP EWS) or HP Surestore Director FC-64 Product Manager window. Toggle the enabled - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 31
2 CLI COMMANDS Command Overview config maint perf show This chapter describes the Command Line Interface commands, including their syntax, purpose, and parameters, as well as examples of their usage and any output that they generate. CLI Commands 19 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 32
Command Overview Note that most of the commands in this chapter are listed in alphabetical order to make them easier to locate. Although the commands can be entered in any order, depending on the results desired (so long as the tree structure is followed), the order used herein for the zoning - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 33
CLI Commands config The config branch of the CLI command tree contains commands that set parameter values. These values are not temporary (session) values, but are retained across power cycles. The commands in the config branch can by used only by the Administrator. Note that the config.zoning - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 34
Note If the IP address is reconfigured, your Telnet client must be reconnected to the new IP address. A new login will be requested. Parameters This command has three parameters. ipAddress gatewayAddress subnetMask Specifies the new IP address for the director or switch. The address must be - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 35
blocked state for a port. Parameters This command has two required parameters. portNumber blockedState Specifies the port number. Valid values are: 0-63 for the FC-64 Specifies the blocked state for the port. Valid values are true and false. Boolean 1 and 0 may be substituted as values. config 23 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 36
distance field is true, the port is configured for 60 buffer credits, which supports a distance of up to 100 km for a 1 GB port. Parameters extDistOn Specifies the port number. Valid values are: 0-63 for the FC-64 Specifies the extended distance state for the port. Valid values are true and - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 37
name for a port. Parameters This command has two required parameters. portNumber portName Specifies the port number. Valid values are: 0-63 for the FC-64 Specifies the name for the port. The port name must not exceed 24 characters in length. Command Example Root> config port name 4 "Sam's tape - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 38
Parameters This command has two required parameters. portNumber portType Specifies the port number. Valid values are: 0-63 for the FC-64 Specifies the type of the port. Valid values are eport, fport, and gport. Command Example Root> config port type 4 fport config.port.show Syntax show - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 39
CLI Commands Command Example Root> config port show 4 Output The port configuration is displayed as a table that includes the following properties. Port Number The port number. Name The port name. Blocked The blocked state. Valid values are true and false. Extended Distance The extended - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 40
. portNumber portBindingState Specifies the port number for which the port binding state is being set. Valid port number values are: 0-63 for the FC-64 Specifies the port binding state as active or inactive. Valid values are true and false. true sets the port binding to active. The specified port - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 41
two parameters. portNumber boundWwn Specified the port number for which the bound WWN is being set. Valid port number values are: 0-63 for the FC-64 Specifies the WWN of the device that is being bound to the specified port. The value must be entered in colon-delimited hexidecimal notation (for - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 42
one parameter. portNumber Specifies the port number for which the port binding configuration will be shown. Valid values are: 0-63 for the FC-64 Command Example Root> config security portBinding show 4 Output The port binding configuration date is displayed as a table that includes the following - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 43
CLI Commands Output Example The output from the config.security.portBinding.show command displays as follows. Port Number: WWN Binding: Bound WWN: 4 Active AA:99:23:23:08:14:88:C1 config.security.userRights config.security.userRights.administrator Syntax administrator "username" "password" - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 44
Command Example Root> config security userRights administrator "Administrator" "new password" config.security.userRights.operator Syntax operator "username" "password" Purpose This command sets the name and password for operator-level access. Parameters This command has two parameters. username - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 45
config.security.userRights.show Syntax show Purpose This command shows the user rights for the command line interface access levels. Parameters This command has no parameters. Command Example Root> config security userRights show Output The user rights configuration data is displayed as a table - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 46
Output Example The output from the config.security.userRights.show command displays as follows. Operator Username: Operator Operator Password Administrator Username: Administrator Administrator Password config.snmp.addCommunity Syntax addCommunity commIndex "commName" writeAuthorization - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 47
CLI Commands trapRecipient udpPortNum Specifies the trap recipient. Values must be 4 bytes in dotted-decimal format. Specifies the UDP port number to which the director will send traps for each recipient. The values must be a decimal number; the default value is 162. Valid values include all legal - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 48
config.snmp.deleteCommunity Syntax deleteCommunity commIndex Purpose This command entirely deletes a community from the SNMP Parameters This command has one parameter. commIndex Specifies the community to be deleted. Valid values are integers in the range 1-6. This value was set in the commIndex - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 49
Command Example Root> config snmp show Output The switch configuration data is displayed as a table that includes the following properties commIndex commName writeAuthorization trapRecipient udpPortNum The community index number. The name of the community. The write authorization state. The - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 50
config.switch All of the config.switch commands, except for the config.switch.show command, require that the switch first 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. config. - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 51
CLI Commands config.switch.edTOV 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 should be used when scripting this command due to its relationship with R_A_TOV. Parameters This - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 52
Description The switch must be set offline before this command is entered. Parameters This command has one parameter. interopMode Specifies the interoperability mode. Valid values are mcdata and open: mcdata - McDATA Fabric 1.0 open - Open Fabric 1.0 Command Example Root> config switch - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 53
CLI Commands Command Example Root> config switch prefDomainId 1 config.switch.priority Syntax priority switchPriority Purpose This command sets the switch priority. Description The switch must be set offline before this command is entered. Parameters This command has one parameter. - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 54
Command Example Root> config switch priority principal config.switch.raTOV 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 care should be used when scripting this command due to its - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 55
CLI Commands config.switch.rerouteDelay Syntax rerouteDelay rerouteDelayState Purpose This command enables or disables rerouting delay for the switch. Description The switch must be set offline before this command is entered. This command is only applicable if the configured switch is in a - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 56
Command Examples Root> config switch rerouteDelay true Root> config switch rerouteDelay 1 config.switch.show Syntax show Purpose This command shows the switch configuration. Parameters This command has no parameters. Command Example Root> config switch show Output The switch configuration data is - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 57
CLI Commands Rerouting Delay Interop Mode The rerouting delay that ensures that frames are delivered in order through the fabric to their destination. Values are Enabled or Disabled. Interoperability mode for the switch. Output Example The output from the config.switch.show command displays as - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 58
config.system.date Syntax date sysDate sysTime Purpose This command sets the system date and time. Parameters This command has two required parameters. sysDate sysTime Specifies the new system date. The format of the date parameter must be mm:dd:yyyy or mm/dd/yyyy. Valid date values include: mm: - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 59
the director or switch. The name can contain 0-255 characters. Command Example Root> config system description "HP Surestore Director FC-64" Note The value "HP Surestore Director FC-64" in the command example can be any user specified value. config.system.location Syntax location "systemLocation - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 60
Parameters This command has one parameter. systemLocation Specifies the new system location for the director or switch. The location can contain 0-255 characters. Command Example Root> config system location "Everywhere" config.system.name Syntax name "systemName" Purpose This command sets the - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 61
system date and time. Output Examples The output from the config.system.show command displays as follows. Name: Description: Contact: Location: Date/Time: Joe's Switch HP Surestore Director FC-64 Joe Everywhere 04/16/2001 10:34:01 config 49 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 62
config.zoning Note that the config.zoning commands function in a different way from the other CLI commands, which are single action commands that take effect immediately. A zoning configuration is typically too complicated to be described by a single command, so the first zoning command entered - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 63
Command Examples Root> config zoning setDefZoneState false Root> config zoning setDefZoneState 0 config.zoning.activateZoneSet Syntax activateZoneSet Purpose This command activates the zone set contained in the work area to the fabric and takes effect immediately. Description Note This command - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 64
config.zoning.deactivateZoneSet Syntax deactivateZoneSet Purpose This command places all attached devices in the default zone and takes effect immediately fabric wide. Description The default zone must be activated independently of this command. Note This command takes effect immediately in the - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 65
CLI Commands Parameters This command has no parameters. Command Example Root> config zoning replaceZoneSet config.zoning.clearZoneSet Syntax clearZoneSet Purpose This command clears the zone set contained in the work area, removing all zones, and takes effect immediately. Description This command - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 66
on the switch until the config.zoning.activateZoneSet command is issued. The CLI supports the number of zones per zone set specified for a given product. the new zone. The zoneName must contain 1-64 characters. Valid characters are: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz012345 6789$-^_ - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 67
This command has one parameter. zoneSetName Specifies the new name for the zone set. The zoneSetName must contain 1-64 characters. Valid characters are: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz012345 6789$-^_ Spaces are not permitted, and the first character must be alphabetical - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 68
adds a world-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 has two parameters Root> config zoning addWwnMem TheUltimateZone 10:00:00:00:C9:22:9B: 64 56 config - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 69
a 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 number values are: 0-63 for the FC-64 Command Example Root> config zoning addPortMem TheUltimateZone 10 6 CLI Commands config 57 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 70
config.zoning.clearZone Syntax clearZone "zoneName" Purpose This command clears all zone members for the specified zone in the work area. Description This command does not change the zone name. Parameters This command has one parameter. zoneName Specifies the name of the zone to be cleared. - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 71
domain IDs are in the range 1-31. Specifies the port number of the member to be deleted from the zone. Valid port numbers values are: 0-64 for the FC-64 config 59 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 72
Command Example Root> config zoning deletePortMem TheUltimateZone 10 5 config.zoning.renameZone Syntax renameZone "oldZoneName" "newZoneName" Purpose This command renames a zone in the work area. Parameters This command has two parameters. oldZoneName newZoneName Specifies the current zone name - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 73
Parameters This command has no parameters. Command Example Root> config zoning showPending Output The zoning configuration data is displayed as a table that includes the following properties. Local ZoneSet The enabled status, name, and member zones of the zone set. Output Example The output from - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 74
config.zoning.showActive Syntax showActive Purpose This command shows the zoning configuration saved on the fabric. Parameters This command has no parameters. Command Example Root> config zoning showActive Output The zoning configuration data is displayed as a table that includes the following - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 75
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 Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 76
particular port. Parameters This command has two required parameters. portNumber beaconState Specifies the port number. Valid values are: 0-63 for the FC-64 Specifies whether unit beaconing is enabled. Valid values are true and false. Boolean 1 and 0 may be substituted as values. Command Examples - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 77
port. Parameters This command has one parameter. portNumber Specifies the port number to be reset. Valid values are: 0-63 for the FC-64 Command Example Root> maint port reset 4 maint.system.beacon Syntax beacon beaconState Purpose This command enables or disables unit beaconing. maint 65 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 78
Parameters This command has one parameter. beaconState Specifies whether unit beaconing is enabled. Valid values 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 maint.system.clearSysError Syntax - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 79
CLI Commands maint.system.ipl Syntax ipl Purpose This command IPLs the switch. Description Note Connection to the command line interface is lost when this command runs. Parameters This command has no parameters. Command Example Root> maint system ipl maint.system.resetConfig Syntax resetConfig - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 80
Note This command resets all configuration data and non-volatile settings, including network information, to their default values (factory settings). Management access may be lost until the network information is restored. Parameters This command has no parameters. Command Example Root> maint - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 81
CLI Commands perf The perf branch of the CLI command tree contains commands that relate to performance services. The commands in the perf branch can by used by either the Administrator or the Operator. perf.class2 Syntax class2 Purpose This command displays port - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 82
Busied Frms Rjct Frames The number of times that FBSY was returned to this port as a result of a Class 2 frame that could not be delivered to the other end of the link. This occurs if either the fabric or the destination port is temporarily busy. The number of times that FRJT was returned to this - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 83
Parameters This command has no parameters. Command Example Root> perf class3 Output The port Class 3 counter data is displayed as a table that includes the following properties. Port Rx Frames Tx Frames Rx Words TX Words Disc Frames The port number. The number of Fibre Channel Class 3 frames that - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 84
an individual port or for all ports. Parameters This command has tone parameter. portNumber Specifies the port number. Valid values are: 0-63 for the FC-64 all for every port on the director or switch 72 perf - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 85
was zero. This number is counted during the first round of frame verification and applies to both Class 2 and Class 3 traffic. The number of 10-bit transmission words that the port is unable to map to 8bit bytes because of disparity errors or misaligned K characters while in the OL2 or OL3 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 86
CRC Errs Dlim Errs Addr Id Errs The number of frame CRC errors detected by the port. The number of invalid frame delimiters (SOF or EOF) received by the port. The number of frames received with unknown addressing. Output Example The output from the perf.errors command displays as follows. Port - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 87
CLI Commands perf.link Syntax link Purpose This command displays port link counters for all ports. Parameters This command has no parameters. Command Example Root> perf link Output The port link counter data is displayed as a table that includes the following properties. Port OLS In OLS Out Reset - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 88
Output Example The output from the perf.link command displays as follows. Port OLS In OLS Out Reset In Reset Out Link Flrs Sync Losses Sig Losses 0 0 0 13 21 0 0 0 1 2 0 16 30 6 0 9 2 0 0 0 0 0 0 0 3 0 0 0 0 0 0 0 4 0 0 0 0 0 0 1 5 0 0 0 0 0 0 0 6 0 0 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 89
CLI Commands Output The port traffic counter data is displayed as a table that includes the following properties. Port Rx% Tx% Rx Frames Tx Frames Rx Words Tx Words The port number. The received link utilization percentage. The transmitted link utilization percentage. The number of Fibre Channel - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 90
show The show branch of the CLI command tree contains commands that display, but do not change, stored data values. Note that the displayed output that results from these commands is not identical with the output from the show commands that are within the other CLI command tree branches, for example - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 91
Output The event log data are displayed as a table that includes the following properties. Date/Time Code Severity FRU Event Data The date and time when the event occurred. The event reason code. The severity of the event. The values are: Major-Unit operational (major failure). Minor-Unit - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 92
not installed. The relative position of the FRU, that is, its slot. The state of the FRU. Values are: Active-the current module is active. Backup-this module is not currently being used, but it is available for immediate failover. Failed-the current module is failed. The serial number of the - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 93
Part Num Beaconing Pwr On Hrs CTP 1 Active 21234560 A6534-67005 false 892 CTP 0 Backup 21234561 A6534-67005 false 766 SBAR 1 Active 31234560 A6534-67007 false 890 SBAR 0 Backup 31234561 A6534-67007 false 891 NotInst 13 NotInst 14 NotInst 15 Power 0 Active 61234560 A6534 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 94
Output The Ethernet attributes data is displayed as a table that includes the following properties. IP Address Gateway Address Subnet Mask The IP address for the Ethernet adapter as set in the config.ip.ethernet command. The gateway address for the Ethernet adapter as set in the config.ip.ethernet - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 95
at the receiver. The buffer-to-buffer 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. Output Example - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 96
FC4 Types The type (N, NL, F/NL, F, FL, E, B). The 24-bit Fibre Channel address. The port world-wide name of the 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 registered - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 97
-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 show 85 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 98
show.port.config Syntax config Purpose This command shows the port configuration for all ports. Parameters This command has no parameters. Command Example Root> show port config Output The port configuration attributes are displayed as a table that includes the following properties. Port Name - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 99
CLI Commands Output Example The output from the show.port.config command displays as follows. Port ---0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Name Port 1 Port 2 Port 3 Port 4 Port 5 Port 6 Port 7 Port 8 Port 9 Port A Port B Port C Port D Port E Port F Port X Blocked ------false true false false - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 100
Output The port information data is displayed as a table that includes the following properties. Port WWN OpSpeed SpeedCap The port number. The world-wide name of the port. The current operating speed (1G, where G represents gigabits). The current transceiver capability speed (1G or 2G, where G - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 101
CLI Commands show.port.status Syntax status Purpose This command displays port status for all ports. Parameters This command has no parameters. Command Example Root> show port status Output The port status data is displayed as a table that includes the following properties. Port State Type - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 102
Reason An optional message number that indicates if the port has a segmented ISL or if a port binding violation has occurred. The message description for this message number is provided at the bottom of the table. State is Segmented E_Port 0 Segment Not Defined 1 Incompatible Operating Parameters 2 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 103
CLI Commands Output Example The output from the show.port.status command displays as follows. Port State 0 Online 1 Online 2 No Light 3 Offline 4 Online 5 Port Failure 6 Link Reset 7 Segmented E_Port 8 Online 9 Offline 10 Online 11 Online 12 No Light 13 Online 14 Online 15 Online Type ----fPort - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 104
number. The port connector 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). Output Example The output from the - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 105
show.security.portBinding Syntax portBinding Purpose This command shows the port binding configuration for all ports. Parameters This command has no parameters. Command Example Root> show security portBinding Output The port binding configuration data is displayed as a table that includes the - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 106
Output Example The output from the show.security.portBinding command displays as follows. Port ---0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 WWN Binding ----------Active Inactive Inactive Active Inactive Inactive Inactive Inactive Inactive Inactive Inactive Inactive Inactive Inactive Inactive Inactive - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 107
CLI Commands Output The switch attributes data is displayed as a table that includes the following properties. State The state of the switch (for example, online or offline). BB Credit The BB credit as set in the config.switch.bbCredit command. R_A_TOV The R_A_TOV as set in the config.switch. - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 108
config.system.date command. The serial number for the system. The type number for the system. The model number for the system (for example, FC-64). The engineering change level installed. The current firmware version installed. The enabled state of unit beaconing (true or false). 96 show - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 109
Commands Output Example The output from the show.system command displays as follows. System Information Name: Joe's Switch Description: HP Surestore Director FC-64 Contact: Joe Location: Everywhere Date/Time: 04/16/2001 10:34:01AM Serial Number: 123456789 Type Number: 1 Model Number - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - 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 Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 111
Appendix ERROR MESSAGES 99 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 112
. Enter a valid port address. The value entered for the port number is invalid. Enter a port number within the range supported by your director or switch. Valid values are: 0-63 for the FC-64 The value entered for the port name is invalid. The port name for the individual port can contain 0-24 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 113
Appendix Message Cause/Solution Error 16: Invalid R_A_TOV The value entered for the resource allocation time-out value is invalid. The R_A_TOV is entered in tenths of a second and must be an integer in the range 10-1200 (1 second to 120 seconds). The R_A_TOV value must be larger than the E_D_TOV - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 114
Message Cause/Solution Error 32: Invalid SNMP Community Name The value entered for the SNMP community name is invalid. The SNMP community name is the name of the community specified by commIndex. The community name must not exceed 32 characters in length. Valid characters include all those in the - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 115
: Invalid Zone Set Name The value entered for the zone set name is invalid. The zone set name must contain 1-64 characters. Valid characters are ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuv wxyz0123456789$-^_ (spaces are not permitted, and the first character must be alphabetical). Enter a zone - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 116
Error 64: Duplicate Zone Set Error 65: Max Zone Sets Defined Error 66: Zone Set Name in Use Error 67: Invalid Number of Zone Set Members Error 68: Zone Set Not Enabled Error 69: Duplicate Port Name Error 70: Invalid Device Type Error 71: Device Not Installed Error 72: No Backup FRU - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 117
Appendix Message Cause/Solution Error 83: Not Legacy Mode Zone member cannot be put into the default zone in open mode. For example, if the following series of commands is entered, Error 83 results: Root> maint system setOnlineState false Root> config switch interopMode open Root> config zoning - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 118
Message Cause/Solution Error 99: Preferred Domain ID Is Zero Error 100: Port Binding Feature Not Enabled Error 101: Invalid Product Family Model Error 102: Switch Not Operational Error 201: Changed Authorization Request Failed Error 202: Invalid Change Authorization ID The director or switch - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 119
Appendix Message Cause/Solution Error 213: Number of Zones Is Zero The config.zoning.activateZoneSet command tried to activate the work area; however, the work area is empty. Enter the changes in the work area, and then reenter the config.zoning.activateZoneSet command to activate the work area - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 120
Message Cause/Solution Error 228: Invalid Write Authorization Argument Error 229: Invalid UDP Port Number The writeAuthorization parameter of the config.snmp.addCommunity command does not contain a valid value. For example, the value is true or false. Valid values for the writeAuthorization - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 121
Message Error 236: Ambiguous Command Cause/Solution The CLI command interface cannot interpret the command. For example, an incomplete command is entered: Root> co The commaDelim command or the config command may have been intended. Enter the complete name of the command. Appendix Appendix 109 - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 122
110 Appendix - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 123
zones or aliases. B backplane The backplane provides 48 VDC power distribution and connections for all logic cards. backup FRU When an active FRU fails, an identical backup FRU takes over operation automatically (failover) to maintain director and Fibre Channel link operation. beaconing The use of - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 124
processing speeds between devices. See also BB_Credit. C channel A point-to-point link that transports data from one point to the other. class of Fibre Channel service Defines the level of connection dedication, acknowledgment, and other characteristics of a connection. Class F Fibre Channel - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 125
A configuration backup file is required to restore configuration data if the CTP card in a nonredundant FC-64 is removed is located on the CTP card to connect to the Ethernet LAN and communicate with the HP EFC Server or a specific management station. control unit A hardware unit that controls the - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 126
data integrity is confirmed. D datagram See Class 3 Fibre Channel service. default Pertaining to an attribute, value, or option that is connected to a managed director, that is not controlled directly by the HP Product Manager. See also node. dialog box A window containing informational messages - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 127
The interface provides a GUI similar to the HP Product Manager application, and supports director configuration, statistics monitoring, and basic operation for the IEEE 802.3 standard, which specifies the physical and software layers. Baseband LAN allows multiple station access to the transmission - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 128
on the director, such as FRU failures, degraded operation, and port problems. expansion port The physical interface on a Fibre Channel switch within a failed to a backup FRU. FCP A standard Fibre Channel protocol used to run SCSI over Fibre Channel. fiber Physical media types supported by the - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 129
Fibre Channel Integrated set of standards recognized by ANSI which defines specific protocols for flexible information transfer. Logically, a point-to-point serial data channel, structured for high performance. field-replaceable unit An assembly removed and replaced in its entirety when any one of - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 130
The number of hops a unit of information traverses in a fabric. HP EFC Hewlett-Packard enterprise fabric connectivity. HP EFC Management Services application Software application that provides back-end product-independent services to the HP EFC Manager application. The application runs only on the - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 131
the device and causing the operating system to start. Initiated through a menu in the HP Product Manager, this option performs a hardware reset on the active CTP only. interface Hardware, software, or both, linking systems, programs, or devices. Internet protocol address A unique string of numbers - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 132
itself, by returning the output of the mechanism as input. M managed product A hardware product that can be managed with the HP EFC Product Manager. For example, the FC-64 is a managed product. See also device. multiswitch fabric A Fibre Channel fabric created by linking more than one director or - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 133
N name server (1) In TCP/IP, a program that translates names from one form into another. Domain name servers (DNS) translate domain names into IP addresses. (2) In Fibre Channel, a server that allows N_Ports to register information about themselves. This information allows N_Ports to discover and - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 134
operating state ( director) The operating states are described as follows: Online - when the director is set online, an attached device can log in to the director if the port is not blocked. Attached devices can communicate with each other if they are configured in the same zone. Offline - when the - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 135
connections for fiber cables and performs specific device-dependent logic functions. port name Name that the user assigns to a particular port through the HP Product Manager. preferred domain ID Domain ID that a switch is assigned by the principal switch in a switched fabric. The preferred domain ID - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 136
The serial crossbar assembly (SBAR) is responsible for Fibre Channel frame transmission from any director port to any other director port. Connections are established without software intervention. 124 Glossary - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 137
Simple Network Management Protocol A protocol that specifies a mechanism for network management that is complete, yet simple. Information is exchanged between agents, which are the devices on the network being managed, and managers, which are the devices on the network through which the management - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 138
T topology The logical, physical, or both arrangement of stations on a network. trap The unsolicited notification of an event originating from a SNMP managed device and directed to an SNMP network management station. W warning message Indication that a possible error has been detected. See also - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 139
zone set A collection of zones that may be activated as a unit. zoning Grouping of several devices by function or by location. All devices connected to a connectivity product, such as the director, may be configured into one or more zones. See also zone. Glossary 127 Glossary - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 140
128 Glossary - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 141
parameters 10 purpose 2 root> prompt 8 using 2 command tree 4 limitations on movements within 9 navigation of 8 commands asynchronous 3 commaDelim 14 config 21 login 11 logout 13 maint 64 order affects output 20 perf 69 129 Index - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 142
Web Server 2 HP EWS 2 I interactive interfaces 2 interoperability mode 39 IP address, ethernet 21 IPL 67 L limitations, history log 9 link counters 75 logging in 11 logging out 11 login command 11 globally available 4 login server 82 logout command 13 globally available 4 M maint command 64 N name - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 143
20 P parameters 10 perf command 69 performance services 69 periods in command names 3 port beaconing, port 64 port binding 93 port binding state 27 port 73 extended distance state 24 link counters 75 name 25 port beaconing 64 port binding state 27 port configuration 86 port information 87 port - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 144
strings, null 10 subnet mask 22 switch attributes, displaying 94 switches 68 configuring IP address 21 configuring, set offline 38 e_d_tov 39 event log 78 FRU information 80 interoperability mode 39 IPL 67 login server database 82 name server database 84 preferred domain ID 40 principal 41 priority - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 145
zoning, configuring 50 Index 133 Index - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 146
134 Index - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 147
Sheet hp surestore director fc-64 Command Line Interface User's Guide We welcome your evaluation of this manual. Your comments and suggestions will help us improve our publications. Remove this page and mail or FAX it to 916-785-2875. Use and attach additional pages if necessary. The manual is - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 148
BUSINESS REPLY MAIL FIRST CLASS MAIL PERMIT NO. 256 ROSEVILLE, CA POSTAGE WILL BE PAID BY ADDRESSEE Attention: Information Engineering (MS 5668) Hewlett-Packard Company Enterprise Storage Solutions Division 8000 Foothills Blvd. Roseville, CA 95747-9987 Fold Here NO POSTAGE NECESSARY IF MAILED IN - HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 149
- HP Surestore 64 | HP Surestore Director FC-64 Command Line Interface User's Guid - Page 150
Manual Part Number A6534-90909 E0102 Copyright © 2002 Hewlett-Packard Company Printed in U.S. A. A6534-96017
hp surestore director fc-64
Command Line
Interface
User’s Guide