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.
Entering Command Line Interface Commands 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.
Table 1 CLI Command Tree Navigation Conventions (cont’d) Character Sequence Common Name Action or Description Control-A Position the cursor to the start of the line. Control-B Position the cursor left one character. Control-D Delete the current character. Control-E Position the cursor to the end of the line. Control-F Position the cursor right one character.
Page 17
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 show userRights -------------- administrator operator show snmp --------------------- addCommunity...
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 showActive maint --------------------- port ----------------------- beacon reset system ------------------ beacon clearSysError Entering Command Line Interface Commands...
Page 19
Table 2 Command Line Interface Command Tree 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 are shown, with the exception of the zoning commands, in alphabetical order to make them easier to locate.
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 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.beacon command, the commands are entered as follows: Root>...
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 <ESC>[A) or the up-arrow keyboard symbol) cannot move the position back towards the root, as shown in this example: Root>...
Logging In and Logging Out 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.
Page 24
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.
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.
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.
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.
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>...
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.
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.
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.
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 commands function in a different way from the other CLI commands, which are single action commands that take effect immediately.
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 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).
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. IP Address: 10.0.0.0 Gateway Address:...
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.
config.port.name Syntax name portNumber “portName” Purpose This command sets the name for a port. Parameters This command has two required parameters. portNumber 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.
Parameters This command has two required parameters. portNumber Specifies the port number. Valid values are: 0–63 for the FC-64 portType eport fport gport Specifies the type of the port. Valid values are , and Command Example Root> config port type 4 fport config.port.show Syntax show portNumber...
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. true false Blocked The blocked state. Valid values are true false Extended Distance The extended distance configuration state.
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 true Specifies the port binding state as active or inactive. Valid values are false true sets the port binding to active.
Page 41
Parameters This command has two parameters. portNumber 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).
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>...
Output Example The output from the config.security.portBinding.show command displays as follows. Port Number: WWN Binding: Active Bound WWN: AA:99:23:23:08:14:88:C1 config.security.userRights config.security.userRights.administrator Syntax administrator “username” “password” Purpose This command sets the name and password for administrator-level access. Description Immediately after the name and password for the administrator is set, you will be prompted to log in with the new access rights.
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 .
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 that includes the following properties.
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.
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.
Page 49
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.
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.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 command has one parameter.
Description The switch must be set offline before this command is entered. Parameters This command has one parameter. interopMode mcdata open Specifies the interoperability mode. Valid values are mcdata — McDATA Fabric 1.0 open — Open Fabric 1.0 Command Example Root>...
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. switchPriority principal default Specifies the switch priority. Valid values are: , or neverprincipal principal...
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 .
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 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. BB Credit: R_A_TOV: E_D_TOV:...
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...
config.system.description Syntax description “systemDescription” Purpose This command sets the system description string. Parameters This command has one parameter. systemDescription 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” Note The value “HP Surestore Director FC-64”...
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.
Page 61
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. Name The system name. Description The system description. Contact The system contact.
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.
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 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. Note This command takes effect immediately in the fabric. Parameters This command has no parameters.
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 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.
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 config.zoning.renameZoneSet Syntax renameZoneSet “zoneSetName” Purpose This command changes the name of the zone set in the work area.
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.
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. Parameters This command has one parameter.
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>...
Parameters This command has two parameters. zoneName Specifies the name of the zone that contains the member to be deleted. 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 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.
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 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 The enabled status, name, and member zones of the zone set.
Page 75
Output Example The output from the config.zoning.showActive command displays as follows. Active Zone Set Default Zone Enabled: False 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...
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 non- volatile settings, including network information, to their default values (factory settings).
maint.port.reset Syntax reset portNumber Purpose This command resets an individual port. Description 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 true false Specifies whether unit beaconing is enabled. Valid values are 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...
maint.system.ipl Syntax 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 Purpose This command resets all NV-RAM configuration parameters to their default values. Description This command IPLs the switch.
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 system resetConfig maint.system.setOnlineState Syntax setOnlineState onlineState...
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 Class 2 counters for all ports. Parameters This command has no parameters.
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.
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 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.
Command Example Root> perf clearStats 4 Root> perf clearStats all perf.errors Syntax errors Purpose 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.
Page 86
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 Root> perf link Output The port link counter data is displayed as a table that includes the following properties. Port The port number.
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 ---- ------ ------- -------- --------- --------- ----------- ---------- perf.traffic Syntax traffic Purpose This command displays port traffic counters for all ports. Parameters This command has no parameters.
Page 89
Output The port traffic counter data is displayed as a table that includes the following properties. Port The port number. The received link utilization percentage. The transmitted link utilization percentage. Rx Frames The number of Fibre Channel 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.
Page 91
Output The event log data are displayed as a table that includes the following properties. Date/Time 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).
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. The FRU name. NotInstalled means the FRU is not installed. Position The relative position of the FRU, that is, its slot.
Output Example The output from the show.frus command displays as follows. Position State Serial Num Part Num Beaconing Pwr On Hrs -------- -------- ------ ---------- -------------- --------- ---------- Active 21234560 A6534-67005 false Backup 21234561 A6534-67005 false SBAR Active 31234560 A6534-67007 false SBAR Backup 31234561...
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.
Page 95
Command Example Root> show loginServer Output The device information is displayed as a table that includes the following properties. Port 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.
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).
Page 97
Output Example The output from the show.nameServer command displays as follows. Type Port Id Port Name Node Name FC4 Types ---- ------- ----------------------- ----------------------- --------- 010400 00:11:22:33:44:55:00:77 20:11:22:33:44:55:66:77 010500 00:11:22:33:44:55:01:77 20:11:22:33:44:55:66:77 010600 00:11:22:33:44:55:66:02 20:11:22:33:44:55:66:77 010700 00:11:22:33:44:55:66:03 20:11:22:33:44:55:66:77 010800 00:11:22:33:44:55:66:04 20:11:22:33:44:55:66:77 010900 00:11:22:33:44:55:66:77 20:11:22:33:44:55:66:77...
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.
Output Example The output from the show.port.config command displays as follows. Port Name Blocked Ext Dist Type ---- ------------------------ ------- -------- ----- Port 1 false false fPort Port 2 true true fPort Port 3 false false gPort Port 4 false false fPort Port 5...
Page 100
Output The port information data is displayed as a table that includes the following properties. Port The port number. 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).
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 The port number.
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 Duplicate Domain ID(s)
Output Example The output from the show.port.status command displays as follows. Port State Type Attached WWN Beaconing Reason ---- ---------------- ----- ----------------------- --------- ------ Online fPort 10:00:80:00:11:22:33:44 false Online gPort 00:00:00:00:00:00:00:00 true No Light fPort 10:00:80:00:11:22:33:55 true Offline ePort 10:00:80:00:11:22:33:00 false Online gPort...
Page 104
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).
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 following properties.
Output Example The output from the show.security.portBinding command displays as follows. Port WWN Binding Bound WWN ---- ----------- ----------------------- Active AA:00:AA:00:AA:00:AA:00 Inactive 00:00:00:00:00:00:00:00 Inactive CC:33:44:55:CC:33:44:55 Active 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00...
Page 107
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.
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.
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: Location: Everywhere Date/Time: 04/16/2001 10:34:01AM Serial Number: 123456789 Type Number: Model Number; FC-64 EC Level: Firmware Version: 01.03.00 34 Beaconing: Disabled show.zoning...
Page 110
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. Active Zone Set Default Zone Enabled: False ZoneSet:...
Page 112
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.
Page 113
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 value.
Page 114
Message Cause/Solution Error 32: Invalid SNMP The value entered for the SNMP community name is invalid. The Community Name 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.
Page 115
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.
Page 116
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 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...
Page 117
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>...
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 The director or switch is already in the state requested. For Authorization ID false example, if the defaultZoneState has been set to...
Page 119
Message Cause/Solution Error 213: Number of Zones Is The config.zoning.activateZoneSet command tried to activate Zero 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.
Page 120
Message Cause/Solution Error 228: Invalid Write The writeAuthorization parameter of the Authorization Argument config.snmp.addCommunity command does not contain a valid true false value. For example, the value is . Valid values for enabled disabled the writeAuthorization parameter are Boolean 1 and 0 may be substituted as values. Error 229: Invalid UDP Port The udpPortNum parameter of the config.snmp.addCommunity Number...
Page 121
Message Cause/Solution Error 236: Ambiguous The CLI command interface cannot interpret the command. For Command example, an incomplete command is entered: Root> The commaDelim command or the config command may have been intended. Enter the complete name of the command. 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.
Page 124
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.
Page 125
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.
Page 126
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. datagram See Class 3 Fibre Channel service.
Page 127
E_Port See expansion port. E_D_TOV See error-detect time-out value. 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.
Page 128
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.
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 its components fails. firmware The embedded program code that resides and executes on, for example, directors, switches, and hubs.
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 EFC Server and cannot be downloaded to remote workstations.
Page 131
In Fibre Channel, a device that connects nodes into a logical loop by using a physical star topology. 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.
Page 132
See initial program load. See interswitch link. 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.
Page 133
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.
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.
Page 135
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 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.
Page 136
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.
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 is done.
Page 138
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. warning message Indication that a possible error has been detected. See also error message; information message.
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.
Page 141
INDEX navigation conventions 3 Symbols .. 8 output 10 ? 17 parameters 10 purpose 2 Numerics root> prompt 8 60 characters in history log 9 using 2 80-column output 10 CLI commands, case sensitivity 3 commaDelim command 14 globally available 4 access rights command line interface 2 administrator, setting 31...
Page 142
periods in 3 gateway address 22 show 78 globally available commands 4 commands that take effect immediately 50 config command 21 help command 17 configuration data, resetting 64 history log 9 configuration, resetting 67 clearing 10 connection loss, ethernet 18 HP EFC Manager 2 conventions HP Embedded Web Server 2...
Page 143
operator access, setting 32 principal switch 41 output 10 priority, of switches 41 commaDelim command 14 order of displayed values 8, 20 quotation marks, for spaces 10 parameters 10 r_a_tov 42 perf command 69 rerouting delay 43 performance services 69 root, transitioning through 8 periods in command names 3 root>...
Page 144
strings, null 10 user access rights 11 subnet mask 22 administrator, setting 31 switch attributes, displaying 94 operator, setting 32 switches 68 relationship to other products 12 configuring IP address 21 configuring, set offline 38 work area 21, 50 e_d_tov 39 world-wide name members event log 78 adding 56...
Page 147
Address: ZIP: City & State: Country: ___ Check here if you would like a reply. Hewlett-Packard has the right to use submitted suggestions without obligation, with all such ideas becoming the property of Hewlett-Packard. ESSD Roseville Information Engineering A6534-90909 E0102...
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 Tape Please Do Not Staple...