Command Line Interface User’s Guide hp surestore director fc-64
hp surestore director fc-64 Command Line Interface User’s Guide KS+ Edition E0102 Order No. A6534-90909 Printed in U.S.A.
Notice Format Conventions © Hewlett-Packard Company, 2002. All rights reserved. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. HewlettPackard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Contents CONTENTS 1 Introduction Command Line Interface Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Entering Command Line Interface Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Navigation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Command Tree . . . . . . .
config.ip.ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 config.ip.show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 config.port.blocked. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 config.port.extDist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 config.port.
Contents config.system.date. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 config.system.description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 config.system.location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 config.system.name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 config.system.show. .
maint.system.setOnlineState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 perf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 perf.class2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 perf.class3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents C. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114 E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 F. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
viii
Tables TABLES 1 CLI Command Tree Navigation Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2 Command Line Interface Command Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
x
1 INTRODUCTION 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 Interface and describes the essentials for using the Command Line Interface commands.
Command Line Interface Overview The Command Line Interface (CLI) is a feature that provides an alternative to HP EFC Manager and HP Embedded Web Server (HP EWS) products for director and switch management capabilities. The CLI can only be used through a Telnet client session in an out-of-band management environment, using the Ethernet port in the director or 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.
Entering Command Line Interface Commands Introduction The Command Line Interface (CLI) commands can be entered directly at the command line of a terminal or coded in a script. Note that the CLI commands are not case sensitive. Documentation Conventions Throughout this publication, periods are used to separate the components of a command name. However, the periods cannot be included when the command is actually entered at the terminal or coded in a script.
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 the cursor to the end of the line. ^F Control-F Position the cursor right one character. ^H Control-H Backspace one character and delete the character. ^I Tab Complete the current keyword.
The hierarchy from the root, reading from left to right, is as follows.
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 showActive maint --------------------- port ----------------------- beacon reset system ------------------ beacon clearSysError 6 Entering Command Line Interface Commands
Table 2 Command Line Interface Command Tree ipl resetConfig setOnlineState Introduction 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 are shown, with the exception of the zoning commands, in alphabetical order to make them easier to loc
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, the CLI commands are accessed by navigating up and down the CLI command tree.
Config.Port> root Root> maint Maint> port Maint.Port> beacon 4 true Introduction Another approach to making the navigation more concise is to use the complete command syntax from the Root> prompt each time. For example, to issue the config.port.name command and then the maint.port.
Root> • Whenever the position in the CLI command tree moves to a new branch (for example, config to maint, config to config.port, or config.port to config), the history log is cleared. In this case, any asynchronous commands (for example, the up-arrow command [A) or the up-arrow keyboard symbol) cannot move the position back towards the root, as shown in this example: Root> config Root.Config> port Root.Config.Port> [A Root.Config.
Logging In and Logging Out Introduction The Command Line Interface allows a single Telnet client to be connected to the switch. If a Telnet client logs out, or if after 15 minutes of inactivity the client’s access times out, another Telnet client may log in. Also note that the Telnet client (user) must log in any time the director or switch is restarted because the current user’s access is lost. Examples of a restart include an IPL and any power-off situation.
user enters any of the commands included in Table 2, Command Line Interface Command Tree. A user name and password can be set by the Administrator through the config.security.userRights.administrator command or through the config.security.userRights.operator 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.
logout Syntax logout Introduction 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. Command Examples Root> logout Config> logout Config.
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 tabular, format. Tabular format is the default. Description This command can be entered at any point in the command tree. Parameter This command has one parameter.
Output Example Output displayed in commaDelim mode is as follows: Root> show eventLog Using the commaDelim Command Introduction 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,Severe,CTP-0,00010203 04050607 08090A0B 0C0D0E0F, 04/11/01 07:18P,395,Severe,CTP-0,00010203 04050607 08090A0B 0C0D0E0F, 15
Handling Command Line Interface Errors Two types of errors detected by the Command Line Interface are: • An error associated with the interface. For example, a keyword is misspelled or does not exist. Root> confg Error 234: Invalid Command • 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.
Using the Command Line Interface Help The question mark (?) can be used within a command to obtain certain information: Introduction • If the question mark is used in place of a command keyword, all the keywords at that level of the CLI command tree display.
Telnet Session The CLI can only be used through a Telnet client session in an out-of-band management environment, using the Ethernet port in the director or 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 the Telnet client software can be used.
2 CLI COMMANDS Command Overview config maint CLI Commands 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.
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 commands follows a typical order of entry. The various show commands are usually entered at the end of a group of other 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. CLI Commands 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.
If the IP address is reconfigured, your Telnet client must be reconnected to the new IP address. A new login will be requested. Note Parameters This command has three parameters. ipAddress Specifies the new IP address for the director or switch. The address must be entered in dotted decimal format (for example, 10.0.0.0). gatewayAddress Specifies the new gateway address for the Ethernet interface. The address must be entered in dotted decimal format (for example, 0.0.0.0).
Output The LAN configuration data is displayed as a table that includes the following properties. IP Address The IP address. Gateway Address The gateway address. Subnet Mask The subnet mask. Output Example The output from the config.ip.show command displays as follows. 10.0.0.0 0.0.0.0 255.0.0.0 CLI Commands IP Address: Gateway Address: Subnet Mask: config.port.blocked Syntax blocked portNumber blockedState Purpose This command sets the blocked state for a port.
Command Examples Root> config port blocked 4 false Root> config port blocked 4 0 config.port.extDist Syntax extDist portNumber extDistOn Purpose This command sets the extended distance state for a port. Description When the extended 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 This command has two required parameters. portNumber Specifies the port number.
config.port.name Syntax name portNumber “portName” Purpose This command sets the name for a port. Parameters This command has two required parameters. Specifies the port number. Valid values are: 0–63 for the FC-64 portName Specifies the name for the port. The port name must not exceed 24 characters in length. CLI Commands portNumber Command Example Root> config port name 4 “Sam’s tape drive” config.port.type Syntax type portNumber portType Purpose This command sets the allowed type for a port.
Parameters This command has two required parameters. portNumber Specifies the port number. Valid values are: 0–63 for the FC-64 portType 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 portNumber Purpose This command displays the port configuration for a single port. Description This show command, on the config.port branch, displays the current configuration for the specified port.
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 distance configuration state. Valid values are true and false. Type The port type. Valid values are F Port, E Port, and G Port. CLI Commands Output Example The output from the config.port.show command displays as follows.
Parameters This command has two parameters. portNumber Specifies the port number for which the port binding state is being set. Valid port number values are: 0–63 for the FC-64 portBindingState 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 will be bound to the WWN configured with the config.security.portBinding.wwn command. If no WWN has been configured, no devices can log in to that port.
Parameters This command has two parameters. Specified the port number for which the bound WWN is being set. Valid port number values are: 0–63 for the FC-64 boundWwn 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 example, 11:22:33:44:55:66:AA:BB). If the boundWwn is configured and the portBindState is: Active—only the device described by boundWwn will be able to connect to the specified port.
config.security.portBinding.show Syntax show portNumber Purpose This command shows the port binding configuration for a single port. Parameters This command has 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 properties. Port Number The port number.
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 CLI Commands administrator “username” “password” Purpose This command sets the name and password for administrator-level access.
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 Specifies the new user name for operator-level login. Default is set to Operator. This parameter is 1–15 characters.
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 CLI Commands Root> config security userRights show Output The user rights configuration data is displayed as a table that includes the following properties. Operator Username The username for operator privileges. Operator Password The password for operator privileges.
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 trapRecipient udpPortNum Purpose This command adds an SNMP community to the SNMP configuration. Parameters This command has five parameters.
trapRecipient Specifies the trap recipient. Values must be 4 bytes in dotted-decimal format. udpPortNum 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 UDP port numbers. Command Example Root> config snmp addCommunity 1 "CommunityName1" enabled 123.123.1 23.123 162 config.snmp.
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 parameter of the config.snmp.addCommunity command. Valid values are integers in the range 1–6. Command Example Root> config snmp deleteCommunity 5 config.snmp.
Command Example Root> config snmp show Output The switch configuration data is displayed as a table that includes the following properties commIndex The community index number. commName The name of the community. writeAuthorization The write authorization state. trapRecipient The address of the trap recipient. udpPortNum The UDP port number to which the director will send traps for each recipient. CLI Commands Output Example The output from the config.snmp.show command displays as follows.
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.switch.bbCredit Syntax bbCredit bbCreditValue Purpose This command sets the buffer-to-buffer credit value for all ports, except those ports configured for extended distance.
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. CLI Commands Parameters This command has one parameter. timeoutValue Specifies the new E_D_TOV value. The units for this value are tenths of a second. This parameter must be an integer in the range 2–600 (0.
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 interopMode open config.switch.prefDomainId Syntax prefDomainId domainId Purpose This command sets the preferred domain ID for the switch. Description The switch must be set offline before this command is entered.
Command Example Root> config switch prefDomainId 1 config.switch.priority Syntax priority switchPriority Purpose This command sets the switch priority. CLI Commands Description The switch must be set offline before this command is entered. Parameters This command has one parameter. switchPriority Specifies the switch priority. Valid values are: principal, default, or neverprincipal. principal — sets the numerical switch priority to 1.
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 relationship with E_D_TOV. Parameters This command has one parameter. timeoutValue Specifies the new R_A_TOV value. The units for this value are tenths of a second.
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. CLI Commands This command is only applicable if the configured switch is in a multiswitch fabric. Enabling the rerouting delay ensures that frames are delivered in order through the fabric to their destination.
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 displayed as a table that includes the following properties. BB Credit The maximum number of outstanding frames that can be transmitted without causing a buffer overrun condition at the receiver.
Rerouting Delay The rerouting delay that ensures that frames are delivered in order through the fabric to their destination. Values are Enabled or Disabled. Interop Mode Interoperability mode for the switch. Output Example The output from the config.switch.show command displays as follows. CLI Commands BB Credit: 2 R_A_TOV: 20 E_D_TOV: 4 Preferred Domain Id: 1 Switch Priority: Principal Rerouting Delay: Enabled Interop Mode: Open Fabric 1.0 config.system.
config.system.date Syntax date sysDate sysTime Purpose This command sets the system date and time. Parameters This command has two required parameters. sysDate 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: 1–12 dd: 1–31 yyyy: >1980 sysTime Specifies the new system time. The format of the time parameter must be hh:mm:ss.
config.system.description Syntax description “systemDescription” Purpose This command sets the system description string. Parameters This command has one parameter. systemDescription CLI Commands Specifies the new system description string for the director or switch. The name can contain 0–255 characters. Command Example Root> config system description “HP Surestore Director FC-64” The value “HP Surestore Director FC-64” in the command example can be any user specified value. Note config.system.
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 system name attribute. Parameters This command has one required parameter. systemName Specifies the new system name for the director or switch. The name can contain 0–24 characters.
Purpose This command shows the system configuration. Parameters This command has no parameters. Command Example Root> config system show Output The system configuration is displayed as a table that includes the following properties. The system name. Description The system description. Contact The system contact. Location The system location. Date/Time The system date and time. CLI Commands Name Output Examples The output from the config.system.show command displays as follows.
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 invokes a work area editor. The commands take effect on a temporary copy of a zone set in the work area until the temporary copy in the work area is activated to the fabric--or is discarded.
Command Examples Root> config zoning setDefZoneState false Root> config zoning setDefZoneState 0 config.zoning.activateZoneSet Syntax activateZoneSet Purpose CLI Commands This command activates the zone set contained in the work area to the fabric and takes effect immediately. Description Note This command takes effect immediately in the fabric. Parameters This command has no parameters.
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. This command takes effect immediately in the fabric. Note Parameters This command has no parameters. Command Example Root> config zoning deactiveZoneSet config.zoning.
Parameters This command has no parameters. Command Example Root> config zoning replaceZoneSet config.zoning.clearZoneSet Syntax clearZoneSet CLI Commands Purpose This command clears the zone set contained in the work area, removing all zones, and takes effect immediately. Description This command does not change the zone set name. Parameters This command has no parameters.
config.zoning.addZone Syntax addZone “zoneName” Purpose This command adds a new (empty) zone to the zone set in the work area. Description Changes are not activated 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. Parameters This command has one parameter. zoneName Specifies the name of the new zone. The zoneName must contain 1–64 characters.
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 deleted. Command Example Root> config zoning deleteZone TheLeastUltimateZone CLI Commands config.zoning.renameZoneSet Syntax renameZoneSet “zoneSetName” Purpose This command changes the name of the zone set in the work area. Description Changes are not activated on the switch until the config.zoning.
Command Example Root> config zoning renameZoneSet TheUltimateZoneSet config.zoning.addWwnMem Syntax addWwnMem “zoneName” wwn Purpose This command 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. zoneName Specifies the name of the zone. wwn The world-wide name of the member to be added to the zone.
config.zoning.addPortMem Syntax addPortMem “zoneName” domainId portNumber Purpose This command adds the domain ID and port number of 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. CLI Commands Parameters This command has one parameter. zoneName Specifies the name of the zone. domainId Specifies the domain ID of the member to be added to the zone. Valid values are in the range 1–31.
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. Command Example Root> config zoning clearZone TheNotUltimateAtAllZone config.zoning.deleteWwnMem Syntax deleteWwnMem “zoneName” wwn Purpose This command removes a WWN member from a zone that is in the work area.
Parameters This command has two parameters. zoneName Specifies the name of the zone that contains the member to be deleted. wwn Specifies the world-wide name of the member to be deleted from the zone. The value of the WWN must be in colon-delimited hexidecimal notation (for example, AA:00:AA:00:AA:00:AA:00). Command Example Root> config zoning deleteWwnMem TheNotSoUltimateZone 10:00:00:00:C 9:22:9B:AB CLI Commands config.zoning.
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 Specifies the current zone name of the zone to be renamed. newZoneName Specifies the new zone name. Command Example Root> config zoning renameZone TheOldUltimateZone TheUltimateZone config.zoning.
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. CLI Commands Output Example The output from the config.zoning.showPending command displays as follows.
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 properties. Active ZoneSet 62 config The enabled status, name, and member zones of the zone set.
Output Example The output from the config.zoning.showActive command displays as follows.
maint The maint branch of the CLI command tree contains commands that relate to maintenance activities. The commands in the maint branch can be used only by the Administrator. Note that the maint.system.resetConfig command resets all configuration data and nonvolatile settings, including network information, to their default values (factory settings). Management access may be lost until the network information is restored. maint.port.
maint.port.reset Syntax reset portNumber Purpose This command resets an individual port. Description CLI Commands This command resets an individual port without affecting any other ports. However, if a device is attached to the port and the device is online, the reset causes a link reset to occur. If the port is in a failed state (that is, after failing a loopback test), the reset restores the port to an operational state.
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 clearSysError Purpose This command clears the system error light. Parameters This command has no parameters.
maint.system.ipl Syntax ipl Purpose This command IPLs the switch. Description Connection to the command line interface is lost when this command runs. Note CLI Commands Parameters This command has no parameters. Command Example Root> maint system ipl maint.system.resetConfig Syntax resetConfig Purpose This command resets all NV-RAM configuration parameters to their default values. Description This command IPLs the switch.
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. Note Parameters This command has no parameters. Command Example Root> maint system resetConfig maint.system.setOnlineState Syntax setOnlineState onlineState Purpose This command sets the switch online or offline. Parameters This command has one parameter.
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 CLI Commands Purpose This command displays port Class 2 counters for all ports. Parameters This command has no parameters. Command Example Root> perf class2 Output The port Class 2 counter data is displayed as a table that includes the following properties. Port The port number.
Busied Frms 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. Rjct Frames The number of times that FRJT was returned to this port as the result of a Class 2 frame that was rejected by the fabric. Output Example The output from the perf.class2 command displays as follows.
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. The port number. Rx Frames The number of Fibre Channel Class 3 frames that the port has received. Tx Frames The number of Fibre Channel Class 3 frames that the port has transmitted. Rx Words The number of Class 3 4-byte words within frames that the port has received.
Output Example The output from the perf.class3 command displays as follows.
Command Example Root> perf clearStats 4 Root> perf clearStats all perf.errors Syntax errors Purpose CLI Commands This command displays port error counters for all ports. Parameters This command has no parameters. Command Example Root> perf errors Output The port error counter data is displayed as a table that includes the following properties. Port The port number. Prim Seq Err The number of state machine protocol errors detected by the port hardware.
CRC Errs The number of frame CRC errors detected by the port. Dlim Errs The number of invalid frame delimiters (SOF or EOF) received by the port. Addr Id Errs The number of frames received with unknown addressing. Output Example The output from the perf.errors command displays as follows.
perf.link Syntax link Purpose This command displays port link counters for all ports. Parameters This command has no parameters. Command Example CLI Commands Root> perf link Output The port link counter data is displayed as a table that includes the following properties. Port The port number. OLS In The number of offline sequences initiated by the attached N_Port. OLS Out The number of offline sequences initiated by this director or switch port.
Output Example The output from the perf.link command displays as follows. Port ---0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 OLS In -----0 2 0 0 0 0 0 0 0 0 0 0 0 0 0 0 OLS Out ------0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Reset In -------13 16 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Reset Out --------21 30 0 0 0 0 0 0 0 0 4 0 1 0 0 0 Link Flrs --------0 6 0 0 0 0 0 0 0 0 4 0 1 0 0 0 Sync Losses ----------0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 perf.
Output The port traffic counter data is displayed as a table that includes the following properties. The port number. Rx% The received link utilization percentage. Tx% The transmitted link utilization percentage. Rx Frames The number of Fibre Channel Class 2 and Class 3 frames that the port has received. Tx Frames The number of Fibre Channel Class 2 and Class 3 frames that the port has transmitted. Rx Words The number of 4-byte words in Class 2 and Class 3 frames that the port has received.
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, config.port.show. The commands in the show branch can by used by either the Administrator or the Operator. show.
Output The event log data are displayed as a table that includes the following properties. The date and time when the event occurred. Code The event reason code. Severity The severity of the event. The values are: Major—Unit operational (major failure). Minor—Unit operational (minor failure). Severe—Unit not operational. The causes are either the switch contains no operational SBAR cards or the system shutdowns due to CTP thermal threshold violations. Info—Unit operational (information only).
show.frus Syntax frus Purpose This command displays information about all FRUs. Parameters This command has no parameters. Command Example Root> show frus Output The FRU information is displayed as a table that includes the following properties. FRU The FRU name. NotInstalled means the FRU is not installed. Position The relative position of the FRU, that is, its slot. State The state of the FRU. Values are: Active—the current module is active.
Output Example The output from the show.frus command displays as follows.
Output The Ethernet attributes data is displayed as a table that includes the following properties. IP Address The IP address for the Ethernet adapter as set in the config.ip.ethernet command. Gateway Address The gateway address for the Ethernet adapter as set in the config.ip.ethernet command. Subnet Mask The subnet mask for the Ethernet adapter as set in the config.ip.ethernet command. Output Example The output from the show.ip.ethernet command displays as follows.
Command Example Root> show loginServer Output The device information is displayed as a table that includes the following properties. The port number where the device is attached. BB Crdt The maximum number of remaining frames that can be transmitted without causing a buffer overrun condition at the receiver. RxFldSz The buffer-to-buffer receive data field size from the FLOGI received from the attached N_Port. COS The class of service (for example, 1; 2; 3; 4; 5; 6; F; 1,2; 2,3).
show.nameServer Syntax nameServer Purpose This command displays information from the name server database for devices attached to this switch. Parameters This command has no parameters. Command Example Root> show nameServer Output The device information data is displayed as a table that includes the following properties. Type The type (N, NL, F/NL, F, FL, E, B). Port Id The 24-bit Fibre Channel address. Port Name The port world-wide name of the attached device.
Output Example The output from the show.nameServer command displays as follows.
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 The port number. Name The name of the port as set in the config.port.name command. Blocked The blocked state of the port as set in the config.port.blocked command.
Output Example The output from the show.port.config command displays as follows.
Output The port information data is displayed as a table that includes the following properties. Port The port number. WWN The world-wide name of the port. OpSpeed The current operating speed (1G, where G represents gigabits). SpeedCap The current transceiver capability speed (1G or 2G, where G represents gigabits). Output Example The output from the show.port.info command displays as follows.
show.port.status Syntax status Purpose This command displays port status for all ports. Parameters This command has no parameters. Command Example CLI Commands Root> show port status Output The port status data is displayed as a table that includes the following properties. Port The port number. State The port state (for example, Segmented E_Port, Invalid Attachment, Not Installed, Online, Offline, Not Operational, No Light, Testing, Port Failure, and Link Reset). Type The operational port type.
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.
Output Example The output from the show.port.status command displays as follows.
Command Example Root> show port technology Output The port technology data is displayed as a table that includes the following properties. Port The port number. Connectr The port connector type (LC, MT_RJ, MU, Internal). Transcvr The transceiver type (Long LC, Short, Short OFC, Long LL, Long Dist). Distance The distances supported (Short, Intermediate, Long, Very Long). Media 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 show.port.
show.security.portBinding Syntax portBinding Purpose This command shows the port binding configuration for all ports. Parameters This command has no parameters. Command Example CLI Commands Root> show security portBinding Output The port binding configuration data is displayed as a table that includes the following properties. Port The port number. WWN Binding The state of port binding for the specified port (active or inactive). Bound WWN The WWN of the device that is bound to the specified port.
Output Example The output from the show.security.portBinding command displays as follows.
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.raTov command. E_D_TOV The E_D_TOV as set in the config.switch.edTov command. Preferred Domain Id The domain ID as set in the config.switch.domainId command. The switch priority as set in the config.switch.priority command.
show.system Syntax system Purpose This command displays a set of system attributes. Parameters This command has no parameters. Command Example Root> show system Output The system attributes are displayed as a table that includes the following properties. Name The system name as set in the config.system.name command. Description The system description as set in the config.system.description command. Contact The system contact as set in the config.system.contact command.
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; FC-64 EC Level: 1 Firmware Version: 01.03.00 34 Beaconing: Disabled CLI Commands show.zoning Syntax zoning Purpose This command shows the zoning configuration saved on the fabric. Parameters This command has no parameters.
Output The zoning configuration data is displayed as a table that includes the following properties. Active ZoneSet The enabled status, name, and member zones of the zone set. Output Example The output from the show.zoning command displays as follows.
ERROR MESSAGES Appendix 99
This appendix lists and explains error messages for the Command Line Interface. Any error numbers that are not listed are reserved for future use. Note that the message that is returned is a string that includes both the error number and the text of the message. Message Cause/Solution Error 08: Invalid Switch Name The value entered for the switch name is invalid. The name for the director or switch can contain 0–24 characters. Enter a name with 0–24 characters.
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 value. Enter a value in the range 10–1200. Error 17: Invalid E_D_TOV The value entered for the error detect time-out value is invalid. The E_D_TOV is entered in tenths of a second and must be an integer in the range 2–600 (0.
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 ISO Latin-1 character set. Duplicate community names are allowed, but the corresponding writeAuthorization values must match. Enter the specified name of the SNMP community.
Message Cause/Solution Error 42: Invalid Second The value of the second entered for the new system time is invalid. The format of the time parameter must be hh:mm:ss. The second can contain an integer in the range 0–59. Enter an integer in the range 0–59. Error 43: Invalid Statistics Group ID Error 44: Max SNMP Communities Defined The entered command requires that the director or switch be set offline. Set the director or switch offline before reentering the command.
Message Cause/Solution Error 63: Undefined Zone Set 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 Error 73: Port Not Installed Error 74: Invalid Number of Zones Error 75: Invalid Zone Set Size Error 76: Invalid Number of Unique Zone Members Error 77: Port Failed Error 78:
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 setDefZoneState true Configure the interoperability mode as mcdata in the previous series of commands.
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 is already in the state requested. For example, if the defaultZoneState has been set to false with the config.zoning.
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 to the fabric. Error 214: A Zone Contains Zero Members The config.zoning.activateZoneSet command tried to activate the work area; however, the zone in the work area is empty.
Message Cause/Solution Error 228: Invalid Write Authorization Argument 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 parameter are enabled and disabled. Boolean 1 and 0 may be substituted as values. Error 229: Invalid UDP Port Number The udpPortNum parameter of the config.snmp.addCommunity command does not contain a valid value.
Message Cause/Solution Error 236: Ambiguous Command 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.
110 Appendix
GLOSSARY The following cross-references are used in this glossary: Contrast with. This refers to a term that has an opposite or substantively different meaning. See. This refers the reader to another keyword or phrase for the same term. See also. This refers the reader to definite additional information contained in another entry. A active zone set The single zone set that is active in a multiswitch fabric. It is created when you enable a specified zone set.
BB_Credit Also known as Buffer-to-Buffer Credit. The maximum number of frames a port can transmit without receiving a receive ready signal from the receiving device. blocked port Devices communicating with the port are prevented from logging into the director or communicating with other devices attached to the director. A blocked port continuously transmits the offline sequence. buffer A storage area for data in transit. Buffers compensate for differences in processing speeds between devices.
community profile Information that specifies which management objects are available to what management domain or SNMP community name. configuration data Configuration data includes: identification data, port configuration data, operating parameters, SNMP configuration, and zoning configuration. A configuration backup file is required to restore configuration data if the CTP card in a nonredundant FC-64 is removed and replaced. connectionless Nondedicated link.
cyclic redundancy check System of error checking performed at both the sending and receiving station using the value of a particular character generated by a cyclic algorithm. When the values generated at each station are identical, data integrity is confirmed. D datagram See Class 3 Fibre Channel service. default Pertaining to an attribute, value, or option that is assumed when none is explicitly specified. default zone Contains all attached devices that are not members of a separate zone.
E E_Port See expansion port. E_D_TOV See error-detect time-out value. EFC Enterprise fabric connectivity. embedded web server With director firmware Version 1.2 (or later) installed, administrators or operators with a browser-capable PC and an Internet connection can monitor and manage the director through an embedded web server interface. The interface provides a GUI similar to the HP Product Manager application, and supports director configuration, statistics monitoring, and basic operation.
event log Record of significant events that have occurred on the director, such as FRU failures, degraded operation, and port problems. expansion port The physical interface on a Fibre Channel switch within a fabric, that attaches to an expansion port (E_Port) on another Fibre Channel switch to form a multiswitch fabric. See also segmented E_Port.
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 its components fails. firmware The embedded program code that resides and executes on, for example, directors, switches, and hubs. F_Port See fabric port. FRU See field-replaceable unit.
G_Port See generic port. H hop Data transfer from one node to another node. hop count 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 EFC Server and cannot be downloaded to remote workstations.
hub In Fibre Channel, a device that connects nodes into a logical loop by using a physical star topology. I information message A message telling a user that a function is performing normally or has completed normally. See also error message; warning message. initial program load Process of initializing 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.
IPL See initial program load. ISL See interswitch link. L LIN See link incident. link Physical connection between two devices on a switched fabric. link incident Interruption to link due to loss of light or other causes. loopback test Test that checks attachment or control unit circuitry, without checking the mechanism 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.
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 learn about one another by sending queries to the Name Server. network address Name or address that identifies a managed product on a TCP/IP network.
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 director is set offline, all ports are set offline. The director transmits the offline sequence (OLS) to attached devices, and the devices cannot log in to the director.
P password Unique string of characters known to the computer system and to a user who must specify it to gain full or limited access to a system and to the information stored within it. path In a network, any route between any two ports. port Receptacle on a device to which a cable leading to another device can be attached. port card Field-replaceable hardware component that provides the port connections for fiber cables and performs specific device-dependent logic functions.
R R_A_TOV See resource allocation time out value. redundancy Performance characteristic of a system or product whose integral components are backed up by identical components to which operations will automatically failover in the event of a component failure. Redundancy is a vital characteristic of virtually all high-availability (24 hr./7 days per week) computer systems and networks.
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 is done. SNMP See Simple Network Management Protocol. SNMP community Also known as SNMP community string.
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 error message; information message. world-wide name Eight byte identifier uniquely assigned to a switch or to a node (end device), even on global networks. WWN See world-wide name.
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.
128 Glossary
INDEX Symbols ..
periods in 3 show 78 commands that take effect immediately 50 config command 21 configuration data, resetting 64 configuration, resetting 67 connection loss, ethernet 18 conventions documentation 3 navigation 3 gateway address 22 globally available commands 4 D date and time, system 46 default values, resetting 67 default zone 50 default zone state 50 directors See switches documentation conventions 3 domain ID, port member adding 57 deleting 59 I interactive interfaces 2 interoperability mode 39 IP addr
operator access, setting 32 output 10 commaDelim command 14 order of displayed values 8, 20 Q quotation marks, for spaces 10 R r_a_tov 42 rerouting delay 43 root, transitioning through 8 root> prompt 8 S scripting environments 2 setting online or offline 68 show commands active zoning configuration 62 configuration for port 26 ethernet attributes 81 event log 78 FRU information 80 order of output 8 pending zoning configuration 60 port binding for all ports 93 port binding for port 30 port configuration 86
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 41 r_a_tov 42 rerouting delay 43 system contact 45 system description 47 system location 47 system name 48 system attributes, displaying 96 system contact attribute 45 system date and time 46 system description 4
zoning, configuring 50 Index Index 133
134 Index
Reader Comment 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. Agree Disagree N/A The manual is well organized. The information is technically accurate. Information is easy to find. Step-by-step procedures are easy to perform. There are enough examples and pictures.
NO POSTAGE NECESSARY IF MAILED IN THE UNITED STATES 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.
Manual Part Number A6534-90909 E0102 Copyright © 2002 Hewlett-Packard Company Printed in U.S. A.
