FW 05.01.00 and SW 07.01.00 HP StorageWorks CLI Reference Guide for Directors and Edge Switches (AA-RQ7AD-TE, June 2003)

ManualsBrandsHP ManualsSoftwareHP StorageWorks HA-Fabric Manager Upgrade

reference

guide

hp StorageWorks

CLI reference guide for directors

and edge switches

Product Version: FW V05.01.00-24/HAFM SW V07.01.00-09

Fourth Edition (June 2003)

Part Number: AA-RQ7AD-TE

This guide covers the essentials of using a command line interface (CLI) to manage HP

StorageWorks directors and edge switches. It also includes all current CLI commands and

specifies their syntax, purpose, and parameters.

Summary of content (250 pages)

PAGE 1
reference guide hp StorageWorks CLI reference guide for directors and edge switches Product Version: FW V05.01.00-24/HAFM SW V07.01.00-09 Fourth Edition (June 2003) Part Number: AA-RQ7AD-TE This guide covers the essentials of using a command line interface (CLI) to manage HP StorageWorks directors and edge switches. It also includes all current CLI commands and specifies their syntax, purpose, and parameters.
PAGE 2
© Copyright 2001-2003 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
PAGE 3
contents Contents About this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 4
Contents Adding Comments to Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Telnet Session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Ethernet Connection Loss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 2 CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 5
Contents config.security.switchBinding Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 config.security.switchBinding.addMember. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 config.security.switchBinding.deleteMember. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 config.security.switchBinding.setState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 config.security.switchBinding.show . . . . . . . . . . . . . . . .
PAGE 6
Contents config.zoning.addZone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . config.zoning.deleteZone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . config.zoning.renameZoneSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . config.zoning.addWwnMem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . config.zoning.addPortMem . . . . . . . . . . . . . . . .
PAGE 7
Contents perf.thresholdAlerts.counter.show. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . perf.ThreshAlerts.counter.showStatisticTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . perf.thresholdAlerts.setState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . perf.traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . show Commands. . . . . . . . . . . . . . . . . . . .
PAGE 8
Contents 8 CLI Reference Guide for Directors and Edge Switches
PAGE 9
about this guide About this Guide This reference guide provides information to help you: ■ Use the command lineAbout interface. this Guide ■ Obtain information about specific commands when needed.
PAGE 10
About this Guide Overview This section covers the following topics: ■ Intended Audience ■ Related Documentation Intended Audience This book is intended for use by data center administrators, system administrators, and customer support personnel who are experienced with the following: ■ Concepts of networking, storage area network, and zoning. ■ HP products included in the user’s network. ■ Establishing and using a Telnet session. ■ Using a terminal command line.
PAGE 11
About this Guide Conventions Conventions consist of the following: ■ Document Conventions ■ Text Symbols ■ Equipment Symbols Document Conventions The document conventions included in Table 1 apply in most cases.
PAGE 12
About this Guide Caution: Text set off in this manner indicates that failure to follow directions could result in damage to equipment or data. Note: Text set off in this manner presents commentary, sidelights, or interesting points of information. Equipment Symbols The following equipment symbols may be found on hardware for which this guide pertains. They have the following meanings.
PAGE 13
About this Guide Power supplies or systems marked with these symbols indicate the presence of multiple sources of power. WARNING: To reduce the risk of personal injury from electrical shock, remove all power cords to completely disconnect power from the power supplies and systems. Any product or assembly marked with these symbols indicates that the component exceeds the recommended weight for one individual to handle safely.
PAGE 14
About this Guide Getting Help If you still have a question after reading this guide, contact an HP authorized service provider or access our website: http://www.hp.com. HP Technical Support In North America, call technical support at 1-800-652-6672, available 24 hours a day, 7 days a week. Note: For continuous quality improvement, calls may be recorded or monitored. Outside North America, call technical support at the nearest location.
PAGE 15
About this Guide HP Authorized Reseller For the name of your nearest HP authorized reseller: ■ In the United States, call 1-800-345-1518. ■ In Canada, call 1-800-263-5868. ■ Elsewhere, see the HP website for locations and telephone numbers: http://www.hp.com.
PAGE 16
About this Guide 16 CLI Reference Guide for Directors and Edge Switches
PAGE 17
Introduction 1 This chapter introduces the command line interface (CLI) and describes the essentials for using CLI commands.
PAGE 18
Introduction Command Line Interface Overview The Command Line Interface (CLI) is a feature that provides an alternative to the HP High Availability Fabric Manger (HAFM) and Embedded Web Server (EWS) interface products for director and switch management capabilities. The CLI can only be used through a Telnet client session in an out-of-band management environment, using the Ethernet port in the director or edge switch.
PAGE 19
Introduction Entering Command Line Interface Commands CLI commands can be entered directly at the command line of a workstation or coded in a script. CLI commands are not case sensitive. Documentation Conventions Throughout this publication, periods are used to separate components of a command name. However, periods cannot be included when the command is actually entered at a workstation or coded in a script. How to enter commands is explained in “Navigation of the CLI Command Tree” on page 25.
PAGE 20
Introduction Table 2: CLI Command Tree Navigation Conventions (Continued) Character Sequence Common Name Action or Description ^H Control-H Backspace one character and delete the character. ^I Tab Complete the current keyword. ^K Control-K Delete to the end of the line. ^L Control-L Redraw the line. ^N Control-N Move down one line in the command history. ^P Control-P Move up one line in the command history. ^R Control-R Redraw the line.
PAGE 21
Introduction Table 3: CLI Command Tree (Continued) show ficonms setState ip ----------------- ethernet show port --------------- blocked extDist fan name speed show type openSysMS setState security ------------- fabricBinding ------ activatePending addMember clearMemList deleteMember replacePending setState showActive showPending security ----------- portBinding ------- bound wwn show switchBinding ----- addMember deleteMember setState show userRights -------- administrator operator show
PAGE 22
Introduction Table 3: CLI Command Tree (Continued) snmp ------------- addCommunity authTraps deleteCommunity show switch ------------ bbCredit domainRSCN edTOV insistDomainld interopMode prefDomainId priority raTOV rerouteDelay speed show zoningRSCN system ------------ contact date description location name show zoning ------------ setDefZoneState activateZoneSet deactivateZoneSet replaceZoneSet clearZoneSet addZone deleteZone renameZoneSet 22 CLI Reference Guide for Directors and Edge Switches
PAGE 23
Introduction Table 3: CLI Command Tree (Continued) addWwnMem addPortMem clearZone deleteWwnMem deletePortMem renameZone showPending showActive maint ------------- port --------------- beacon reset system ------------ beacon clearSysError ipl resetConfig setOnlineState perf ------------- class2 class3 clearStats errors link openTrunking backPressure congestionThresh creditStarvThresh setState show unresCongestion thresholdAlerts setState deleteAlert counter addAlert addPort CLI Reference Guide fo
PAGE 24
Introduction Table 3: CLI Command Tree (Continued) deleteAlert removePort setCounter setParams show traffic show -------------- eventLog features frus ip ----------------- ethernet loginServer nameServer nameServerExt openTrunking config reroutelog port --------------- config info nodes status technology security ----------- fabricBinding portBinding switchBinding switch system thresholdAlerts alerts log zoning 24 CLI Reference Guide for Directors and Edge Switches
PAGE 25
Introduction Commands are shown, with the exception of the zoning commands, in alphabetical order to make them easier to locate. Although the commands can be entered in any order, depending on the results desired, the order shown in Table 3 on page 20 for the zoning commands is a typical order in which the zoning commands are entered. Note that the order in which commands are entered determines the order in which the show commands display the values. Refer to Chapter 2 for examples of show commands output.
PAGE 26
Introduction One approach to making the navigation more concise is to use the root command to jump directly to the root of the CLI command tree. The previous example, which shows stepping back to the root with the double-dot command, is simplified as follows: 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.
PAGE 27
Introduction ■ 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.
PAGE 28
Introduction Logging In and Logging Out The CLI allows a single Telnet client to be connected to a director or edge 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 a director or edge switch is restarted because the current user’s access is lost. Examples of a restart include an IPL and any power-off situation.
PAGE 29
Introduction login login Syntax login Purpose This command allows a Telnet client to connect to a director or edge switch. Description This command allows the user to log in with either administrator or operator access rights. The default password is password. The login command is called automatically by the CLI each time a new Telnet session is activated, as well as each time new administrator access rights are configured. After the login command is issued, the Username: prompt automatically displays.
PAGE 30
Introduction logout Syntax logout Purpose This command allows a Telnet client to disconnect from a director or edge switch. Description This command logs out the single Telnet client connected to a director or edge switch. This command can be entered at any point in the command tree. Parameters This command has no parameters. Command Examples Root> logout Config> logout Config.
PAGE 31
Introduction commaDelim Note: The output examples shown in the other sections of this publication presume that commaDelim is off. Syntax commaDelim enable Purpose This command enables the user to obtain displayed information (from a show command) in comma-delimited, rather than tabular, format. The default format is tabular. Description This command can be entered at any point in the command tree. Parameter This command has one parameter: enable Specifies the comma-delineated state for output.
PAGE 32
Introduction Output Example Output displayed in commaDelim mode follows.
PAGE 33
Introduction Using the Command Line Interface Help The question mark (?) can be used within a command to obtain certain information: ■ If the question mark is used in place of a command keyword, all the keywords at that level of the CLI command tree display.
PAGE 34
Introduction Adding Comments to Scripts The pound sign (#) can be used to add comments in a script file. The pound sign must be the first character in the line; the CLI ignores everything after the pound sign in that line. The following lines are valid: Root> #Change port 3 to an E_Port Root> config port config.port> ################## config.port> ## Begin Script ## config.
PAGE 35
Introduction 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 a director or edge 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.
PAGE 36
Introduction 36 CLI Reference Guide for Directors and Edge Switches
PAGE 37
CLI Commands 2 This chapter describes command line interface (CLI) commands, including their syntax, purpose, and parameters, as well as examples of their usage and any output that they generate. It includes the following topics: ■ Command Overview, page 37 ■ config Commands, page 38 ■ maint Commands, page 133 ■ perf Commands, page 141 ■ show Commands, page 174 Command Overview Most of the commands in this chapter are listed in alphabetical order to make them easy to locate.
PAGE 38
CLI Commands config Commands 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.
PAGE 39
config.enterpriseFabMode.setState config.enterpriseFabMode.setState Syntax setState enterpriseFabModeState Purpose This command sets the Enterprise Fabric Mode state for the fabric. The SANtegrity feature key must be installed to activate the Enterprise Fabric Mode state. Parameters This command has one parameter: enterpriseFabModeState Specifies whether enterpriseFabMode is active. Valid values are activate and deactivate. Boolean 1 and 0 may be substituted as values.
PAGE 40
CLI Commands config.features.enterpriseFabMode Syntax enterpriseFabMode enterpriseFabModeState Purpose This command sets the Enterprise Fabric mode state for the fabric. The SANtegrity feature key must be installed to activate the Enterprise Fabric mode state. Parameters This command has one parameter: enterpriseFabModeState Specifies whether enterpriseFabMode is active. Valid values are activate and deactivate. Boolean 1 and 0 may be substituted as values.
PAGE 41
config.features.ficonms config.features.ficonms Syntax ficonms ficonmsState Purpose This command sets the enabled state of the FICON Management Server. The FICON Management Server feature key must be installed in order to enable the FICON Management Server State. (The Edge Switch 2/24 does not accept this command.) Note: If the FICON Management Server is enabled, the default management style is the FICON management style. The Open Systems management style cannot be used.
PAGE 42
CLI Commands config.features.installKey Syntax installKey featureKey Purpose This command allows the user to install a feature set that is enabled by the provided feature key. The switch can be either offline or online when the command is executed. Note: If any currently installed features are being removed by the new feature key, the switch must be offline when the command is given.
PAGE 43
config.features.OpenSysMS config.features.OpenSysMS Syntax OpenSysMS osmsState Purpose This command sets the enabled state of the Open Systems Management Server. The Open Systems Management Server feature key must be installed in order to enable the OSMS State. Parameters This command has one parameter: osmsState Specifies whether the Open Systems Management Server is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values.
PAGE 44
CLI Commands config.features.opentrunking Syntax opentrunking openTrunkingState Purpose This command sets the enabled state of the OpenTrunking feature. The OpenTrunking feature key must be installed in order to enable open trunking. Parameters This command has one parameter: openTrunkingState This parameter can be set to enable or disable the OpenTrunking feature. Boolean 1 and 0 may be substituted as values.
PAGE 45
config.features.show config.features.show Syntax show Purpose This command shows the product feature information configured for this switch. This command provides the same output as the command show.features on page 177. Parameters This command has no parameters. Command Example Root> config features show Output The product feature data is displayed as a table that includes the following properties: Installed Feature Set The feature set installed using a feature key. Only installed keys are displayed.
PAGE 46
CLI Commands Output Example The output from the config.features.
PAGE 47
config.ficonms.setState config.ficonms.setState Syntax setState ficonmsState Purpose This command sets the enabled state of the FICON Management Server. The FICON Management Server feature key must be installed in order to enable the FICON Management Server State. (The Edge Switch 2/24 does not accept this command.) Note: If the FICON Management Server is enabled, the default management style is the FICON management style. The Open Systems management style cannot be used.
PAGE 48
CLI Commands config.ip.ethernet Syntax ethernet ipAddress gatewayAddress subnetMask Purpose This command sets the Ethernet network settings. Description The Telnet connection can be lost when these Ethernet network settings are changed. 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 edge switch.
PAGE 49
config.ip.show config.ip.show Syntax show Purpose This command shows the LAN configuration. Parameters This command has no parameters. Command Example Root> config ip show 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: Gateway Address: Subnet Mask: 10.0.0.0 0.0.0.
PAGE 50
CLI Commands config.openSysMS.setState Syntax setState osmsState Purpose This command sets the enabled state of the Open Systems Management Server. The Open Systems Management Server feature key must be installed in order to enable the OSMS State. Parameters This command has one parameter: osmsState Specifies whether the Open Systems Management Server is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values.
PAGE 51
config.port.blocked config.port.blocked Syntax blocked portNumber blockedState Purpose This command sets the blocked state for a port. Parameters This command has two required parameters: portNumber Specifies the port number. Valid values are: 0–15 for the Edge Switch 2/16 0–23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64 0–127 and 132–143 for the Director 2/140 blockedState Specifies the blocked state for the port. Valid values are true and false.
PAGE 52
CLI Commands config.port.extDist Syntax extDist portNumber extDistOn Purpose This command sets the extended distance state for a port. (The Edge Switch 2/24 does not accept this command.) 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 gigabits per second (Gbps) port. Parameters This command has two required parameters: portNumber Specifies the port number.
PAGE 53
config.port.fan config.port.fan Syntax fan portNumber fanOn Purpose This command sets the fabric address notification (FAN) state for a port (Edge Switch 2/24 only). This configuration can be applied to any port regardless of its current configuration. The FAN value is applied at the time the port is configured and operated in a loop. Parameters This command has two required parameters: portNumber Specifies the port number.
PAGE 54
CLI Commands 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–15 for the Edge Switch 2/16 0–23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64 0–127 and 132–143 for the Director 2/140 portName Specifies the name for the port. The port name must not exceed 24 characters in length.
PAGE 55
config.port.show 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. Parameters This command has one parameter: portNumber Specifies the port number.
PAGE 56
CLI Commands Extended Distance The extended distance configuration state. Valid values are true and false. This field is not valid for the Edge Switch 2/24. FAN The fabric address notification (FAN) state. Valid values are true and false. (Edge Switch 2/24 only.) Type The port type. Valid values are F Port, E Port, G Port, Fx Port (Edge Switch 2/24 only), and Gx Port (Edge Switch 2/24 only). Speed The port speed. Valid values are 1 Gb/sec, 2 Gb/sec, and Negotiate.
PAGE 57
config.port.speed config.port.speed Syntax speed portNumber portSpeed Purpose This command sets the speed for a port. Description A port can be configured to operate at 1.0625 Gbps or 2.125 Gbps, or a negotiated speed. The port speed can be set only to 1.0625 Gbps if the switch speed is 1.0625 Gbps. An attempt to set the port speed to 2.125 Gbps or to negotiate in a switch with a 1 Gbps switch speed results in an error message.
PAGE 58
CLI Commands Command Examples Root> config port speed 4 2g Root> config port speed 6 negotiate 58 CLI Reference Guide for Directors and Edge Switches
PAGE 59
config.port.type config.port.type Syntax type portNumber portType Purpose This command sets the allowed type for a port. Description A port can be configured as an F_Port, an E_Port, or a G_Port. On an Edge Switch 2/24, a port can also be an Fx_Port or Gx_Port. The port configurations function as follows: ■ F_Port—cannot be used as an interswitch link, but may attach to a device with an N_Port. ■ E_Port—only other switch may attach to this type of port.
PAGE 60
CLI Commands portType Specifies the type of the port. Valid values are eport, fport, and gport, fxport (Edge Switch 2/24 only) gxport (Edge Switch 2/24 only).
PAGE 61
config.port.type config.security.fabricBinding Commands The config.security.fabricBinding commands function in a different way from most CLI commands, which are single action commands that take effect immediately. The first Fabric Binding command entered invokes a work-area editor. The commands take effect on a temporary copy of a Fabric Membership List in the work area until the temporary copy in the work area is activated to the fabric — or is discarded.
PAGE 62
CLI Commands config.security.fabricBinding.activatePending Syntax activatePending Purpose This command activates the fabric binding configuration contained in the pending work area to the fabric. Note: This command takes effect immediately. The CLI verifies the list before activating it to the fabric and adds the managed switch to the list if it is not already present.
PAGE 63
config.security.fabricBinding.addMember config.security.fabricBinding.addMember Syntax ddMember wwn domainId Purpose This command adds a new member to the Fabric Membership List in the pending fabric binding work area. The number of entries is limited to the maximum available domain IDs for the fabric (31). Note: Changes from this command are not activated to the fabric until the activatePending command is issued.
PAGE 64
CLI Commands config.security.fabricBinding.clearMemList Syntax clearMemList Purpose This command clears the Fabric Membership List for the pending fabric binding working area. Note: This information is not saved to the fabric until the activatePending command is issued. When the list is cleared, the CLI automatically adds the managed switch to the Fabric Membership List. Parameters This command has no parameters.
PAGE 65
config.security.fabricBinding.deleteMember config.security.fabricBinding.deleteMember Syntax deleteMember wwn domainId Purpose This command removes a member from the Fabric Membership List in the pending fabric binding work area. Note: Changes are not activated to the fabric until the activatePending command is issued. Parameters This command has two parameters: wwn Specifies the WWN of the member to be removed from the Fabric Membership List.
PAGE 66
CLI Commands config.security.fabricBinding.replacePending Syntax replacePending Purpose This command replaces the pending working area with the fabric binding configuration that is currently loaded on the fabric.
PAGE 67
config.security.fabricBinding.setState config.security.fabricBinding.setState Syntax setState fabricBindingState Purpose This command sets the fabric binding state for the pending fabric binding configuration work area. Note: This state is not saved to the fabric until the activatePending command is issued. Parameters This command has one parameter: fabricBindingState Specifies the fabric binding state for the pending fabric binding configuration work area.
PAGE 68
CLI Commands Command Examples Root> config security fabricBinding setstate restrict 68 CLI Reference Guide for Directors and Edge Switches
PAGE 69
config.security.fabricBinding.showActive config.security.fabricBinding.showActive Syntax showActive Purpose This command displays the fabric binding configuration saved on the fabric. It performs the same function as show.security.fabricBinding. Parameters This command has no parameters.
PAGE 70
CLI Commands config.security.fabricBinding.showPending Syntax showPending Purpose This command displays the fabric binding configuration in the pending working area and has not yet been activated to the fabric. If no changes have been made to the pending environment, the CLI displays the active membership list. Parameters This command has no parameters.
PAGE 71
config.security.fabricBinding.showPending config.security.portBinding Commands The config.security.portBinding commands include the following: ■ config.security.portBinding.bound ■ config.security.portBinding.wwn ■ config.security.portBinding.
PAGE 72
CLI Commands config.security.portBinding.bound Syntax bound portNumber portBindingState Purpose This command sets the port binding state for a given port. Parameters This command has two parameters: portNumber Specifies the port number for which the port binding state is being set.
PAGE 73
config.security.portBinding.
PAGE 74
CLI Commands config.security.portBinding.wwn Syntax wwn portNumber boundWwn Purpose This command configures the single device WWN to which a port is bound. Parameters This command has two parameters: portNumber Specifies the port number for which the bound WWN is being set.
PAGE 75
config.security.portBinding.wwn 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. Inactive — the WWN is retained, but any device can connect to the specified port.
PAGE 76
CLI Commands 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.
PAGE 77
config.security.portBinding.show Output Example The output from the config.security.portBinding.show command displays as follows.
PAGE 78
CLI Commands config.security.switchBinding Commands The config.security.switchBinding commands include the following: 78 ■ config.security.switchBinding.addMember ■ config.security.switchBinding.deleteMember ■ config.security.switchBinding.setState ■ config.security.switchBinding.
PAGE 79
config.security.switchBinding.addMember config.security.switchBinding.addMember Syntax addMember wwn Purpose This command adds a new member to the Switch Membership List. A maximum number of 256 members may be added to the Switch Membership List. Parameters This command has one parameter: wwn Specifies the switch or N-Port device WWN of the member to be added to the Switch Membership List. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00).
PAGE 80
CLI Commands config.security.switchBinding.deleteMember Syntax deleteMember wwn Purpose This command removes a member from the Switch Membership List. The user cannot remove a member that is currently logged into the switch. Parameters This command has one parameter: wwn Specifies the switch or N-Port device WWN of the member to be removed from the Switch Membership List. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00).
PAGE 81
config.security.switchBinding.setState config.security.switchBinding.setState Syntax setState switchBindingState Purpose This command sets the switch binding state on the switch.Parameters This command has one parameter: switchBindingState Sets the switch binding state for the switch. Valid values are: disable — Disable switch binding. Devices (servers, storage, and other switches) are allowed to connect to the switch without restrictions.
PAGE 82
CLI Commands Command Examples Root> config security switchBinding setState allRestrict 82 CLI Reference Guide for Directors and Edge Switches
PAGE 83
config.security.switchBinding.show config.security.switchBinding.show Syntax show Purpose This command displays the switch binding configuration. Parameters This command has no parameters. Output This command displays the following switch binding configuration data: switchBindingState The state of switch binding, which can have the following values: Disabled, Enabled and Restricting F_Ports, Enabled and Restricting E_Ports, or Enabled and Restricting All Ports.
PAGE 84
CLI Commands config.security.userRights Commands The config.security.userRights commands include the following: 84 ■ config.security.userRights.administrator ■ config.security.userRights.operator ■ config.security.userRights.
PAGE 85
config.security.userRights.administrator 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. Parameters This command has two parameters: username Specifies the new user name for administrator-level login. Default is set to Administrator.
PAGE 86
CLI Commands 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 Operator. This parameter is 1–15 characters. Valid characters include all characters in the USASCII character set, excluding control characters and spaces. Spaces are not valid even though quotation marks are used.
PAGE 87
config.security.userRights.show config.security.userRights.show Syntax show Purpose This command shows the user rights for the CLI 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. Operator Username The username for operator privileges. Operator Password The password for operator privileges.
PAGE 88
CLI Commands 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. Up to six community names and trap recipients may be defined. commIndex Specifies the community to be created or edited. Valid values are integers in the range 1–6. commName Specifies the community name of the community specified by commIndex.
PAGE 89
config.snmp.authTraps config.snmp.authTraps Syntax authTraps enabledState Purpose This command enables or disables the authorization traps to be sent to SNMP management stations when unauthorized stations try to access SNMP information from the director or edge switch. Parameters This command has one parameter: enabledState Specifies whether the authorization traps are enabled. Valid values are true and false. Boolean 1 and 0 may be substituted as values.
PAGE 90
CLI Commands 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.
PAGE 91
config.snmp.show config.snmp.show Syntax show Purpose This command shows the switch SNMP configuration. Parameters This command has no parameters. Command Example Root> config snmp show Output The switch configuration data is displayed as a table that includes the following properties. Authorization Traps The state of the authorization traps (for example, enabled) that will be sent to SNMP management stations when unauthorized stations attempt to access SNMP information from the switch.
PAGE 92
CLI Commands Output Example The output from the config.snmp.show command displays as follows. Authorization Traps: Enabled Index ----1 2 3 4 5 6 92 Community Name WriteAuth Trap Recipient UDP Port --------------------- --------- ---------------- ----CommunityName1 Enabled 123.123.123.123 162 CommunityName2 Enabled 10.25.25.10 144 CommunityName3 Disabled 132.44.85.
PAGE 93
config.snmp.show config.switch Commands All of the config.switch commands, except for the config.switch.show command, require that the switch be set offline. (Use the maint.system.setOnlineState to set the switch offline.) If these commands are entered while the switch is online, an error message results. The config.switch commands include the following: ■ config.switch.bbCredit ■ config.switch.domainRSCN ■ config.switch.insistDomainId ■ config.switch.edTOV ■ config.switch.interopMode ■ config.
PAGE 94
CLI Commands 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. (The Edge Switch 2/24 does not accept this command.) Description The switch must be set offline before this command is entered. Parameters This command has one parameter: bbCreditValue Specifies the new buffer-to-buffer credit value. This parameter must be an integer in the range 1–60.
PAGE 95
config.switch.domainRSCN config.switch.domainRSCN Syntax domainRSCN domainRSCNState Purpose This command sets the domain RSCN state for the switch. The switch can be either offline or online when this command is executed. Parameters This command has one parameter: domainRSCNState Specifies whether the domain RSCN state is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values.
PAGE 96
CLI Commands config.switch.insistDomainId Syntax insistDomainId insistentDomainIdState Purpose This command sets the insistent domain ID state for the switch. Parameters This command has one parameter: insistentDomainIdState Specifies whether the insistent domain ID state is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values.
PAGE 97
config.switch.edTOV 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: 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.
PAGE 98
CLI Commands config.switch.interopMode Syntax interopMode interopMode Purpose This command sets the interoperability mode for the switch. The switch must be offline to complete this command. 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 (for Homogenous Fabric mode) ■ open (for Open Fabric 1.
PAGE 99
config.switch.prefDomainId 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. Parameters This command has one parameter: domainId Specifies the new preferred domain ID value. This parameter must be an integer in the range 1–31.
PAGE 100
CLI Commands 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 Specifies the switch priority. Valid values are: principal, default, or neverprincipal. ■ principal — sets the numerical switch priority to 1.
PAGE 101
config.switch.
PAGE 102
CLI Commands 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.
PAGE 103
config.switch.rerouteDelay 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.
PAGE 104
CLI Commands Command Examples Root> config switch rerouteDelay true Root> config switch rerouteDelay 1 104 CLI Reference Guide for Directors and Edge Switches
PAGE 105
config.switch.speed config.switch.speed Syntax speed switchSpeed Purpose This command sets the speed for the switch. Note: This command is only applicable for the Director 2/64. Edge switches and the Director 2/140 cannot change speed. Description The switch must be set offline before this command is entered. A switch can be configured to operate at 1.0625 Gbps or 2.125 Gbps. If the switch has fibre port module (FPM) cards, configuring the switch speed to 2.
PAGE 106
CLI Commands config.switch.show Syntax show Purpose This command shows the switch configuration. Parameters This command has no parameters. Description This switch can be either offline or online when this command is executed. 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.
PAGE 107
config.switch.show Speed The switch speed. (This parliamentary is not valid for the Edge Switch 2/24.) 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. Insistent Domain Id When enabled, ensures that the embedded firmware cannot change a switch's preferred domain ID.
PAGE 108
CLI Commands config.switch.zoningRSCN Syntax zoningRSCN zoningRSCNState Purpose This command sets the zoning RSCN state for the switch. The switch can be either offline or online when this command is executed. Parameters This command has one parameter: zoningRSCNState Specifies whether the zoning RSCN state is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values.
PAGE 109
config.system.contact config.system.contact Syntax contact “systemContact” Purpose This command sets the system contact attribute. Parameters This command has one parameter: systemContact Specifies the new system contact string for the director or edge switch. The contact can contain 0–255 characters.
PAGE 110
CLI Commands 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: sysTime ■ mm: 1–12 ■ dd: 1–31 ■ yyyy: >1980 Specifies the new system time. The format of the time parameter must be hh:mm:ss.
PAGE 111
config.system.description 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 edge switch. The name can contain 0–255 characters.
PAGE 112
CLI Commands config.system.location Syntax location “systemLocation” Purpose This command sets the system location attribute. Parameters This command has one parameter: systemLocation Specifies the new system location for the director or edge switch. The location can contain 0–255 characters.
PAGE 113
config.system.name 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 edge switch. The name can contain 0–24 characters.
PAGE 114
CLI Commands config.system.show Syntax show 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. Location The system location. Date/Time The system date and time. Output Examples The output from the config.system.
PAGE 115
config.system.show config.zoning Commands 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.
PAGE 116
CLI Commands config.zoning.setDefZoneState Syntax setDefZoneState defaultZoneState Purpose This command enables or disables the default zone and takes effect immediately fabric wide. Description This command takes effect immediately in the fabric. Parameters This command has one parameter: defaultZoneState Specifies whether the default zone is enabled. Valid values are true and false. Boolean 1 and 0 may be substituted as values.
PAGE 117
config.zoning.activateZoneSet 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 This command takes effect immediately in the fabric. Parameters This command has no parameters. Command Example Root> config zoning activateZoneSet Note: If the interoperability mode for the switch or director is set to Open Fabric 1.
PAGE 118
CLI Commands config.zoning.deactivateZoneSet Syntax deactivateZoneSet Purpose This command places all attached devices in the default zone if the default zone is enabled and takes effect immediately for the entire fabric. If the default zone is not enabled, there will be no zoning in effect and all attached devices will be unable to communicate with any other attached device. This command clears both the active zone set and the working area.
PAGE 119
config.zoning.replaceZoneSet config.zoning.replaceZoneSet Syntax replaceZoneSet Purpose This command replaces the work area with the active zone set that is currently loaded on the fabric. Parameters This command has no parameters.
PAGE 120
CLI Commands 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.
PAGE 121
config.zoning.addZone config.zoning.addZone Syntax addZone “zoneName” Purpose This command adds a new (empty) zone to the zone set in the work area. (A switch or director can have a maximum of 1024 zones.) Description Changes are not activated on the switch until the config.zoning.activateZoneSet command is issued. Parameters This command has one parameter: zoneName Specifies the name of the new zone. The zoneName must contain 1–64 characters.
PAGE 122
CLI Commands config.zoning.deleteZone Syntax deleteZone “zoneName” Purpose This command deletes a zone from the zone set in the work area. Description Changes are not activated on the switch until the config.zoning.activeZoneSet command is issued. Parameters This command has one parameter: zoneName Specifies the name of the zone to be deleted.
PAGE 123
config.zoning.renameZoneSet 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.activateZoneSet command is issued. Parameters This command has one parameter: zoneSetName Specifies the new name for the zone set. The zoneSetName must contain 1–64 characters.
PAGE 124
CLI Commands 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 A product can have a maximum of 1024 zone members in its zones. 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. The value of the WWN must be in colon-delimited hexadecimal notation. For example: AA:00:AA:00:AA:00:AA:00.
PAGE 125
config.zoning.addPortMem 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. Note: Port numbers cannot be used for zone members if the interoperability mode for the switch or director is set to Open Fabric 1.0 mode. Description A product can have a maximum of 1024 zone members in its zones.
PAGE 126
CLI Commands Command Example Root> config zoning addPortMem TheUltimateZone 10 6 126 CLI Reference Guide for Directors and Edge Switches
PAGE 127
config.zoning.clearZone 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.
PAGE 128
CLI Commands 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.
PAGE 129
config.zoning.deletePortMem config.zoning.deletePortMem Syntax deletePortMem “zoneName” domainId portNumber Purpose This command deletes a domain ID and port number for a zone member in the specified zone in the work area. Parameters This command has three parameters: zoneName Specifies the name of the zone that contains the member to be deleted. domainId Specifies the domain ID of the member to be deleted from the zone. Valid domain IDs are in the range 1–31.
PAGE 130
CLI Commands 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. The newZoneName must contain 1–64 characters. Valid characters are: ABCDEFGHIJKLMNOPQRSTUVWXYZabcde fghijklmnopqrstuvwxyz$-^_ Spaces are not permitted, and the first character must be alphabetical.
PAGE 131
config.zoning.showPending config.zoning.showPending Syntax showPending Purpose This command shows the zoning configuration in the work area of the zone set that has not yet been activated. 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.
PAGE 132
CLI Commands 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. Output Example The output from the config.zoning.showActive command displays as follows.
PAGE 133
config.zoning.showActive maint Commands 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). Management access may be lost until the network information is restored.
PAGE 134
CLI Commands maint.port.beacon Syntax beacon portNumber beaconState Purpose This command enables or disables port beaconing for a port. Parameters This command has two required parameters: portNumber Specifies the port number. Valid values are: 0–15 for the Edge Switch 2/16 0–23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64 0–127 and 132–143 for the Director 2/140 beaconState Specifies whether unit beaconing is enabled. Valid values are true and false.
PAGE 135
maint.port.reset maint.port.reset Syntax reset portNumber Purpose This command resets a 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.
PAGE 136
CLI Commands maint.system.beacon Syntax beacon beaconState Purpose This command enables or disables unit beaconing. 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.
PAGE 137
maint.system.clearSysError maint.system.clearSysError Syntax clearSysError Purpose This command clears the system error light. Parameters This command has no parameters.
PAGE 138
CLI Commands maint.system.ipl Syntax ipl Purpose This command IPLs the switch. Description Connection to the command line interface is lost when this command runs. Parameters This command has no parameters.
PAGE 139
maint.system.resetConfig maint.system.resetConfig Syntax resetConfig Purpose This command resets all NVRAM configuration parameters to their default values, including feature keys and IP addresses. Description This command IPLs the switch. Connection from the CLI to the switch is lost when this command runs. Note: This command resets all configuration data and non-volatile settings, including network information, to their default values (factory settings).
PAGE 140
CLI Commands maint.system.setOnlineState Syntax setOnlineState onlineState Purpose This command sets the switch online or offline. Parameters This command has one parameter: onlineState Specifies whether the switch is online. Valid values are true and false. Boolean 1 and 0 may be substituted as values.
PAGE 141
maint.system.setOnlineState perf Commands 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. Note that the counters in perf command output are 32-bit values that wrap at 4,294,967,296. To calculate the full value of a counter, multiply 4,294,967,296 by the value in the wrap field, and add the resulting product to the value in the count field.
PAGE 142
CLI Commands perf.class2 Syntax class2 portNumber Purpose This command displays port Class 2 counters for a single port. Parameters This command has one parameter: portNumber Specifies the port number.
PAGE 143
perf.class2 TxWords The number of Class 2 4-byte words within frames that the port has transmitted. Busied Frms The number of times that FBSY (Fabric Busy link response) 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.
PAGE 144
CLI Commands perf.class3 Syntax class3 portNumber Purpose This command displays port Class 3 counters for a single ports. Parameters This command has one parameter: portNumber Specifies the port number.
PAGE 145
perf.class3 TxWords The number of Class 3 4-byte words within frames that the port has transmitted. Disc Frames The number of Class 3 frames that have been discarded upon receipt by this port. There are no FBSYs (Fabric Busy link response) or FRJTs (Frame Reject link response) generated for Class 3 frames. Output Example The output from the perf.class3 command displays as follows.
PAGE 146
CLI Commands perf.clearStats Syntax clearStats portNumber Purpose This command resets all port statistics for an individual port or for all ports. Parameters This command has one parameter: portNumber Specifies the port number.
PAGE 147
perf.errors perf.errors Syntax errors portNumber Purpose This command displays port error counters for a single port. Parameters This command has one parameter: portNumber Specifies the port number.
PAGE 148
CLI Commands Disc Frms The number of received frames discarded due to a frame size of less than size words or to frames dropped because the BB credit was zero. This number is counted during the first round of frame verification and applies to both Class 2 and Class 3 traffic. Inv Tx Wrds The number of 10-bit transmission words that the port is unable to map to 8-bit bytes because of disparity errors or misaligned K characters while in the OL2 or OL3 state.
PAGE 149
perf.link perf.link Syntax link portNumber Purpose This command displays port link counters for a single ports. Parameters This command has one parameter: portNumber Specifies the port number.
PAGE 150
CLI Commands Reset Out The number of link resets initiated by this director or edge switch. LIPS In The number of LIPS generated on this switch loop port. LIPS Out The number of times the port has detected a link error resulting from an invalid link state transition or timeout. Link Flrs The number of times the port has detected a link error resulting from an invalid link state transition or timeout.
PAGE 151
perf.openTrunking.backPressure perf.openTrunking.backPressure Syntax backPressure backPressureState Purpose This command configures the Back Pressure state of the OpenTrunking configuration. Parameters This command has one parameter: backPressureState This parameter can be set to enable or disable OpenTrunking back pressure. Boolean 1 and 0 values may also be substituted.
PAGE 152
CLI Commands perf.openTrunking.congestionThresh Syntax congestionThresh portNumber congestionThreshold Purpose This command configures the congestion threshold for an individual port or for all ports. Parameters This command has the following parameters: portNumber Specifies the port number.
PAGE 153
perf.openTrunking.creditStarvThresh perf.openTrunking.creditStarvThresh Syntax creditStarvThresh creditStarvationThreshold Purpose This command configures the Credit Starvation Threshold of the OpenTrunking configuration. Credit Starvation Threshold is defined as the percentage of time that no transmit BB_Credits are passed on the link. When the threshold value is exceeded, the system tries to reroute the flows that are going to the ISL that has the problem.
PAGE 154
CLI Commands perf.opentrunking.setState Syntax setState openTrunkingState Purpose This command sets the enabled state of the OpenTrunking feature. The OpenTrunking feature key must be installed in order to enable open trunking. Parameters This command has one parameter. openTrunkingState This parameter can be set to enable or disable the OpenTrunking feature. Boolean 1 and 0 may be substituted as values.
PAGE 155
perf.openTrunking.show perf.openTrunking.show perf.openTrunking.show Syntax show portNumber Purpose This command displays the current OpenTrunking configuration per port. Parameters This command has one parameter: portNumber Specifies the port number.
PAGE 156
CLI Commands Flows Rerouted From Trunking statistic displaying flows rerouted from the specified port. (These statistics are cleared by the perf.clearStats command.) Unresolved Congestion The current enabled/disabled state of the unresolved congestion trunking feature. (The indicated state applies to every port on the product.) Backpressure The current enabled/disabled state of the backpressure trunking feature. (The indicated state applies to every port on the product.
PAGE 157
perf.openTrunking.unresCongestion perf.openTrunking.unresCongestion Syntax unresCongestion unresolvedCongestionState Purpose This command configures the Unresolved Congestion state of the OpenTrunking configuration. If the state is configured to be enabled, an unresolved congestion entry is made to the Event Log and an SNMP trap is generated if SNMP is configured.
PAGE 158
CLI Commands perf.thresholdAlerts Commands The perf.thresholdAlerts commands enable you to configure alerts that notify you of specific conditions on your system. You can configure a total of 16 threshold alerts, including both counter threshold alerts (CTAs) and throughput threshold alerts (TTAs). For a list of the available threshold alerts counters, see Table 4. The perf.thresholdAlerts commands are standard CLI features. They do not require a feature key.
PAGE 159
perf.openTrunking.
PAGE 160
CLI Commands ■ Link Sequence Counts Summed Set — Link Resets Received — Link Reset Sent — OLS Received — OLS Sent ■ Logical Link Errors Summed Set — Discarded Frames — Address ID Errors — Class 2 Busied Frames — Class 2 Rejected Frames — Class 3 Discarded Frames 160 CLI Reference Guide for Directors and Edge Switches
PAGE 161
perf.thresholdAlerts.counter.addAlert perf.thresholdAlerts.counter.addAlert Syntax addAlert name Purpose This command configures a new counter threshold alert and assigns it a name. The new alert is assigned default settings which can then be changed using the other counter threshold alert commands.
PAGE 162
CLI Commands perf.thresholdAlerts.counter.addPort Syntax addPort name portNumber Purpose This command adds a port to the specified counter threshold alert. Note: An alert cannot be modified unless it is in the disabled state. Parameters This command has the following parameters. name 162 The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert on page 161.
PAGE 163
perf.thresholdAlerts.counter.addPort portNumber Specifies the port number or port type. Valid values are either a single port number, all ports, or port type. The following port numbers are valid: 0–15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64 0–127 and 132–143 for the Director 2/140 all applies the congestionThreshold value to every port on the product.
PAGE 164
CLI Commands perf.thresholdAlerts.counter.deleteAlert Syntax deleteAlert name Purpose This command deletes a specified counter threshold alert. Parameters This command has one parameter: name The name of a counter threshold alert, as defined by the command perf.thresholdAlerts.counter.
PAGE 165
perf.thresholdAlerts.counter.removePort perf.thresholdAlerts.counter.removePort Syntax removePort name portNumber Purpose This command removes a port from the specified counter threshold alert. Note: An alert cannot be modified unless it is in the disabled state. Parameters This command has the following parameters. name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert, described on page 161. portNumber Specifies the port number.
PAGE 166
CLI Commands perf.thresholdAlerts.counter.setCounter Syntax setCounter name counterNumber Purpose This command sets the counter statistic that will be used to trigger the counter threshold alert. Use this command to associate a counter with the threshold alert name created using the perf.thresholdAlerts.setState command, described on page 171. Parameters This command has the following parameters: name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.
PAGE 167
perf.thresholdAlerts.counter.setParams perf.thresholdAlerts.counter.setParams Syntax setParams name increment interval Purpose This command sets the increment and interval times for a specified counter threshold alert. Note: An alert cannot be modified unless it is in the disabled state. Parameters This command has the following parameters: name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert, described on page 161.
PAGE 168
CLI Commands Example The meaning for each of these inputs can best be described using the following example sentence: If ports 0, 1, or 2 CRC Error counter increments more then 5 times within a period of 30 minutes, send an alert. Where: Port list CTA Counter Increment value Interval Time = = = = 0, 1, 2 CRCErrors 5 30 minutes The increment value takes place in an interval that is a fixed length amount of time. This interval is not a rolling window interval.
PAGE 169
perf.thresholdAlerts.counter.show perf.thresholdAlerts.counter.show Syntax show name Purpose This command displays the settings for an individual counter threshold alert. Parameters This command has one parameter: name The name of a threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert, described on page 161. Command Example Root> perf thresholdAlerts counter show checklinks Output Example The output from the perf.thresholdAlerts.counter.show command displays as follows.
PAGE 170
CLI Commands perf.ThreshAlerts.counter.showStatisticTable Syntax showStatisticTable Purpose This command displays the table of different statistic counters that can be added to a counter threshold alert. This table is used for reference only. Parameters This command has no parameters. Command Example Root> perf ThreshAlerts counter showStatisticTable Output Example The output from the showStatisticTable command displays as follows.
PAGE 171
perf.thresholdAlerts.setState perf.thresholdAlerts.setState Syntax setState name enabledState Purpose This command sets the enabled state of the specified counter threshold alert. Parameters This command has the following parameters: name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert, described on page 161. enabledState Sets the counter threshold alert enabled state. Valid values are enabled and disabled.
PAGE 172
CLI Commands perf.traffic Syntax traffic portNumber Purpose This command displays port traffic counters for a single port. Parameters This command has one parameter: portNumber Specifies the port number.
PAGE 173
perf.traffic TxFrames The number of Fibre Channel Class 2 and Class 3 frames that the port has transmitted. RxWords The number of 4-byte words in Class 2 and Class 3 frames that the port has received. TxWords The number of 4-byte words in Class 2 and Class 3 frames that the port has transmitted. Output Example The output from the perf.traffic command displays as follows.
PAGE 174
CLI Commands show Commands The show branch of the CLI command tree contains commands that display, but do not change, stored data values. The displayed output that results from these commands is not necessarily 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 either by the Administrator or the Operator.
PAGE 175
show.eventLog show.eventLog Syntax eventLog [clear] Purpose This command shows the contents of the event log as maintained in NVRAM on the director or edge switch. Parameters This command has one parameter: clear This optional parameter causes all reroute log entries to be cleared. Command Example Root> show eventLog 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.
PAGE 176
CLI Commands FRU The FRU and FRU position, where applicable. Event Data The 32-byte hexidecimal description of the event in words. Output Example The output from the show.
PAGE 177
show.features show.features Syntax features Purpose This command displays a table of all installed feature sets and their states. This command provides the same output as the config.features.show command, described on page 45. Parameters This command has no parameters. Command Example Root> show features Output The features data is displayed as a table that includes the following properties: Installed Feature Set The feature set installed using a feature key. Only installed keys are displayed.
PAGE 178
CLI Commands Output Example The output from the show.
PAGE 179
show.frus 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. This property may show Unknown or Not Installed if 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.
PAGE 180
CLI Commands Output Example The output from the show.
PAGE 181
show.ip.ethernet show.ip.ethernet Syntax ethernet Purpose This command displays ethernet attributes. Parameters This command has no parameters. Command Example Root> show ip ethernet Output The Ethernet attributes data are 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 182
CLI Commands show.loginServer Syntax loginServer Purpose This command displays information from the login server database for devices attached to this switch. Note: It is possible to have more than one device per port for any public loop devices attached to an FL Port. Parameters This command has no parameters. Command Example Root> show loginServer Output The device information is displayed as a table that includes the following properties: 182 Port The port number where the device is attached.
PAGE 183
show.loginServer Output Example The output from the show.loginServer command displays as follows.
PAGE 184
CLI Commands show.nameServer Syntax nameServer Purpose This command displays information from the name server database for devices attached to this switch. Note: It is possible to have more than one device per port for any public loop devices attached to an FL Port. 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 185
show.nameServer Output Example The output from the show.nameServer command displays as follows.
PAGE 186
CLI Commands show.nameServerExt Syntax nameServerExt Purpose This command displays extended information from the name server database for devices attached to this switch. The command provides symbolic nameserver information, as well as the same information as the show.nameServer command. Multiple devices per port are possible for any public loop device attached to an FL Port. Note: Because it contains symbolic nameserver information that can be lengthy, the CLI output wraps several times per node.
PAGE 187
show.nameServerExt FC4 Types The FC4 types registered for this device. One or more numbers display in this field. The numbers in this field correspond to the list in the output example for show.nameServer on page 184. SymNodeName 255-character representation of the Symbolic Node Name. SymPortName 255-character representation of the Symbolic Port Name. Output Example The output from the show.nameServerExt command displays as follows.
PAGE 188
CLI Commands show.openTrunking.config Syntax config Purpose This command displays the trunking configuration for all ports. Parameters This command has no parameters. Command Example show openTrunking config Output The device information data is displayed as a table that includes the following properties. 188 Unresolved Congestion The current enabled/disabled state of the unresolved congestion trunking feature. Backpressure The current enabled/disabled state of the backpressure trunking feature.
PAGE 189
show.openTrunking.config Output Example The output from the show.openTrunking.config command displays as follows. Unresolved Congestion: Backpressure: Low BB Credit Threshold (%): Port Threshold % ---- -----------1 60 (default) 2 69 3 60 (default) 4 60 (default) 5 90 ...
PAGE 190
CLI Commands show.openTrunking.reroutelog Syntax reroutelog [clear] Purpose This command displays the trunking reroute log information. Parameters This command has one parameter: clear This optional parameter causes all reroute log entries to be cleared. The clear parameter also clears the log entries for the HAFM.
PAGE 191
show.openTrunking.reroutelog Output Example The output from the show.opentrunking.reroutelog command displays as follows.
PAGE 192
CLI Commands 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: 192 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.
PAGE 193
show.port.config Output Example The output from the show.port.
PAGE 194
CLI Commands show.port.info Syntax info Purpose This command displays port information for all ports. Parameters This command has no parameters. Command Example Root> show port info 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 (1.0625 Gbps, 2.125 Gbps, or Not Established). SpeedCap The current transceiver capability speed (1.0625 or 2.125 Gbps).
PAGE 195
show.port.
PAGE 196
CLI Commands show.port.nodes Syntax nodes portNumber Purpose This command displays the loop node list for a specified port. This command is valid only on the Edge Switch 2/24. Parameters This command has one parameter: portNumber Specifies the port number.
PAGE 197
show.port.nodes Output Example The Data Field Size value for public devices. This field is left blank for private devices.
PAGE 198
CLI Commands show.port.status Syntax status Purpose This command displays port status for all ports. Parameters This command has no parameters. Command Example Root> show port status Output The port status data is displayed as a table that includes the following properties: 198 Port The port number. State The port state.
PAGE 199
show.port.status Type The operational port type. If the configured port type is F_Port or E_Port, this value will match the configured type. If the configured type is G_Port, this value can be E_Port, F_Port, or G_Port, depending on what is connected to the port. On the Edge Switch 2/24, if the configured port type is Fx_Port, the operational port type can include FL_Port in addition to the values noted above for F_Port.
PAGE 200
CLI Commands If the operational state is Invalid Attachment, only the following messages can be generated: ■ 09 Unknown ■ 10 ISL connection not allowed on this port ■ 11 ELP rejected by the attached switch ■ 12 Incompatible switch at other end of the ISL ■ 13 External loopback adapter connected to the port ■ 14 N_Port connection not allowed on this port ■ 15 Non-HP switch at other end of the ISL ■ 16 ISL connection not allowed on this port ■ 17 ISL connection not allowed to external Fabric
PAGE 201
show.port.status Output Example The output from the show.port.status command displays as follows.
PAGE 202
CLI Commands show.port.technology Syntax technology Purpose This command shows the port technology information for all ports. Parameters This command has no parameters. Command Example Root> show port technology Output The port technology data is displayed as a table that includes the following properties: 202 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).
PAGE 203
show.port.technology Output Example The output from the show.port.
PAGE 204
CLI Commands show.security.fabricBinding Syntax fabricBinding Purpose This command displays the fabric binding configuration saved on the fabric. The command performs the same function as config.security.fabricBinding.showActive command. Parameters This command has no parameters.
PAGE 205
show.security.portBinding 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: Port The port number. WWN Binding The state of port binding for the specified port (active or inactive).
PAGE 206
CLI Commands Output Example The output from the show.security.
PAGE 207
show.security.switchBinding show.security.switchBinding Syntax switchBinding Purpose This command displays the switch binding configuration. Parameters This command has no parameters.
PAGE 208
CLI Commands show.switch Syntax switch Purpose This command displays switch attributes. Parameters This command has no parameters. Command Example Root> show switch Output The switch attributes data is displayed as a table that includes the following properties: State 208 The state of the switch. For example: ■ online ■ 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.
PAGE 209
show.switch Speed The switch speed as set in the config.switch.speed command. (This does not apply to the Edge Switch 2/24.) Rerouting Delay The rerouting delay as set in the config.switch.rerouteDelay command. Operating Mode The operating mode (Open Systems or S/390). This attribute cannot be configured through the CLI. Note: The Operating Mode parameter is equivalent to the Management Style parameter of the HAFM interface. The S/390 Mode is equivalent to the FICON management style on the HAFM.
PAGE 210
CLI Commands Output Example The output from the show.switch command displays as follows. Switch Information State: BB Credit: R_A_TOV: E_D_TOV: Preferred Domain Id: Switch Priority: Speed: Rerouting Delay: Operating Mode: Interop Mode: Active Domain Id: World Wide Name: Insistent Domain Id: Domain RSCN: Zoning RSCN: 210 Online 2 20 4 1 Default 2 Gb/sec Enabled Open Systems Open Fabric 1.
PAGE 211
show.system 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.
PAGE 212
CLI Commands EC Level The engineering change level installed. Firmware Version The current firmware version installed. Beaconing The enabled state of unit beaconing (enabled or disabled) as set in the maint.system.beacon command. Output Example The output from the show.system command displays as follows.
PAGE 213
show.thresholdAlerts.alert show.thresholdAlerts.alert Syntax alert Purpose This command provides the name, type, and enabled state of each threshold alert. This command displays information about all threshold alerts, including both counter threshold alerts (CTAs) and throughput threshold alerts (TTAs). Parameters This command has no parameters.
PAGE 214
CLI Commands State Signal Losses CTA - Signal Losses Protocol Errors CTA - Primitive Sequence Errors/Protocol Errors Invalid Tx Words CTA - Invalid Tx Words CRC Errors CTA - CRC Errors Discarded Frames CTA - Discarded Frames Frames Too Short CTA - Frames Too Short Delimiter Errors CTA - Delimiter Errors Address ID Errors CTA - Address ID Errors Cls2 BusiedFrms CTA - Class 2 Busied Frames Cls2 RejectedFrms CTA - Class 2 Rejected Frames Cls3 DiscardFrms CTA - Class 3 Discarded Frames P
PAGE 215
show.thresholdAlerts.log show.thresholdAlerts.log Syntax log [clear] Purpose This command shows the contents of the threshold alert log. This log shows all the threshold alerts that have been triggered, including both counter threshold alerts (CTAs) and throughput threshold alerts (TTAs). Parameters This command has one parameter. clear This optional parameter causes all reroute log entries to be cleared.
PAGE 216
CLI Commands Link Resets Received CTA - Link Resets Received OLS Sent CTA - OLS Sent OLS Received CTA - OLS Received Link Failures CTA - Link Failures Sync Losses CTA - Sync Losses Signal Losses CTA - Signal Losses Protocol Errors CTA - Primitive Sequence Errors/Protocol Errors Invalid Tx Words CTA - Invalid Tx Words CRC Errors CTA - CRC Errors Discarded Frames CTA - Discarded Frames Frames Too Short CTA - Frames Too Short Delimiter Errors CTA - Delimiter Errors Address ID Errors C
PAGE 217
show.zoning show.zoning Syntax zoning Purpose This command shows the zoning configuration saved on the fabric. Parameters This command has no parameters. Command Example Root> show zoning 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.
PAGE 218
CLI Commands 218 CLI Reference Guide for Directors and Edge Switches
PAGE 219
A Error Messages This appendix lists and explains error messages for the command line interface (CLI). Any error numbers that are not listed are reserved for future use. The message that is returned is a string that includes the error number and the text of the message. Table 5: CLI Error Messages Message Description Action Error 05: Busy The switch is busy or processing another request. After a few seconds, reissue the request.
PAGE 220
Error Messages Table 5: CLI Error Messages (Continued) Message 220 Description Action Error 11: Invalid Switch Contact The value entered for the switch contact is invalid. The contact for the director or edge switch can contain 0–255 characters. Enter a contact with 0–255 characters. If spaces are used, enclose the contact in quotation marks. Error 13: Invalid Port Number The value entered for the port number is invalid.
PAGE 221
Error Messages Table 5: CLI Error Messages (Continued) Message Description Action 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. Check to be sure that all these conditions are met and re-submit.
PAGE 222
Error Messages Table 5: CLI Error Messages (Continued) 222 Message Description Action Error 29: Invalid Gateway Address The value entered for the gateway address is invalid. The new gateway address for the Ethernet interface must be entered in dotted decimal format (for example, 0.0.0.0). Enter the gateway address for the Ethernet interface in the dotted decimal format. Error 30: Invalid IP Address The value entered for the IP address of the director or edge switch is invalid.
PAGE 223
Error Messages Table 5: CLI Error Messages (Continued) Message Description Action Error 33: Invalid SNMP Trap Address The value entered for the SNMP trap address is invalid. The new SNMP trap address for the SNMP interface must be entered in dotted decimal format (for example, 10.0.0.0). Enter an SNMP trap address that meets the requirements.
PAGE 224
Error Messages Table 5: CLI Error Messages (Continued) Message 224 Description Action Error 40: Invalid Hour The value of the hour entered for the new system time is invalid. The format of the time parameter must be hh:mm:ss. The hour must contain an integer in the range 00–23. Enter a time, including an hour in the range 00–23. Error 41: Invalid Minute The value of the minute entered for the new system time is invalid. The format of the time parameter must be hh:mm:ss.
PAGE 225
Error Messages Table 5: CLI Error Messages (Continued) Message Description Action Error 55: Invalid Zone Name The value entered for the zone name is invalid. The zone name must contain 1–64 characters. Valid characters are ABCDEFGHIJKLMNOPQ RSTUVWXYZabcdefghijkl mnopqrstuvwxyz012345 6789$-^_ (spaces are not permitted, and the first character must be alphabetical). Enter a zone name in the range of 1–64 characters, using the valid characters.
PAGE 226
Error Messages Table 5: CLI Error Messages (Continued) 226 Message Description Action Error 62: Invalid Zone Set Name The value entered for the zone set name is invalid. The zone set name must contain 1–64 characters. Valid characters are ABCDEFGHIJKLMNOPQ RSTUVWXYZabcdefghijkl mnopqrstuvwxyz012345 6789$-^_ (spaces are not permitted, and the first character must be alphabetical). Enter a zone set name in the range of 1–64 characters, using the valid characters.
PAGE 227
Error Messages Table 5: CLI Error Messages (Continued) Message Description Action Error 74: Invalid Number of Zones The specified zone set contains less than one zone or more than the maximum number of zones allowed for this product. The zone set must contain at least one zone. Add or remove zones to stay within the required number of zones for this product. Error 75: Invalid Zone Set Size The specified zone set exceeds the NVRAM limitations of the director or edge switch.
PAGE 228
Error Messages Table 5: CLI Error Messages (Continued) Message 228 Description Action Error 82: Invalid Interop Mode The value entered for the interoperability mode is not valid. The interoperability mode for the director or edge switch must be Homogenous Fabric or Open Fabric 1.0. Enter mcdata (Homogenous Fabric) or open (Open Fabric 1.0) to set the interoperability mode. Error 83: Not Allowed in Open Fabric Mode This request cannot be completed while this switch is operating in Open Fabric 1.
PAGE 229
Error Messages Table 5: CLI Error Messages (Continued) Message Description Action Error 91: E_Port Type Configured Ports cannot be configured as E_Ports in S/390 mode (FICON management style in HAFM). Reconfigure the port as either an F_Port or a G_Port, and then resubmit the command. Error 92: Not Allowed While Port Is Unblocked The port must be blocked to complete this request. Block the port, and then resubmit the command.
PAGE 230
Error Messages Table 5: CLI Error Messages (Continued) Message 230 Description Action Error 117: Ports Cannot be Set at Higher Data Rate than Switch Speed The request cannot be completed because the requested port speed is faster than the configured switch speed. The switch speed should first be configured to accommodate changes in the configured port speed. The ports cannot operate at a faster rate than the switch itself. Update the switch speed and resubmit the request.
PAGE 231
Error Messages Table 5: CLI Error Messages (Continued) Message Description Action Error 135: Invalid Number of Fabric Membership List Entries The number of fabric members submitted exceeds the maximum allowable entries of 31. The number of entries in the Fabric Membership List is limited to the total number of domain IDs available to the fabric. Make sure that the list (including the managed switch) contains no more than 31 entries.
PAGE 232
Error Messages Table 5: CLI Error Messages (Continued) Message 232 Description Action Error 140: Invalid Insistent Domain ID State The request cannot be completed because an invalid insistent domain ID state has been submitted. The insistent domain ID state must be set to either enable or disable. For more information, see config.switch.insistDomai nId on page 96.
PAGE 233
Error Messages Table 5: CLI Error Messages (Continued) Message Description Action Error 146: Fabric Binding May Not Be Deactivated While Enterprise Fabric Mode Active The user attempted to deactivate fabric binding while Enterprise Fabric mode was active. Fabric binding must be active while operating in Enterprise Fabric mode. The fabric binding state may be changed if Enterprise Fabric mode is deactivated. It should be noted, however, that this can be disruptive to the fabric.
PAGE 234
Error Messages Table 5: CLI Error Messages (Continued) Message 234 Description Action Error 154: Invalid Membership List WWN The request cannot be completed because the WWN does not exist in the switch binding membership list. Make sure that the WWN deleted matches the WWN in the Switch Membership List. Make appropriate changes and re-submit the request. Error 155: Cannot Remove Active Member From List This member cannot be removed from the fabric security list because it is currently logged in.
PAGE 235
Error Messages Table 5: CLI Error Messages (Continued) Message Description Error 202: Invalid Change Authorization ID The switch will not accept a change request from this particular client. Check that all the parameters are correct, and reenter the command. If problems persist, contact your service representative. Error 203: Another Client Has Change Authorization Another user is currently making changes to this switch. Check that all the parameters are correct, and reenter the command.
PAGE 236
Error Messages Table 5: CLI Error Messages (Continued) Message 236 Description Action Error 212: Duplicate Zone Member The entered command tried to add a member that already exists in the zone. No action required Error 213: Number of Zones Is Zero The config.zoning.activateZon eSet command tried to activate a zone set contained in the work area to the fabric; however, the zone set is empty. A zone set must have at least one zone to be a valid zone set.
PAGE 237
Error Messages Table 5: CLI Error Messages (Continued) Message Error 218: Invalid Port Number Description Action The value specified for the port number is invalid. Enter a port number within the range supported by the director or edge switch.
PAGE 238
Error Messages Table 5: CLI Error Messages (Continued) Message 238 Description Action Error 225: Argument Does Not Contain All USASCII Characters The CLI received one or more non-USASCII characters. Refer to Chapter 2 for information about the command parameters. Check that all parameters are typed correctly, and then resubmit the command. Error 226: Argument Is Too Long One or more parameters of the specified command are invalid. Refer to Chapter 2 for information about the command parameters.
PAGE 239
Error Messages Table 5: CLI Error Messages (Continued) Message Description Action Error 230: Invalid WWN The WWN parameter does not contain a valid value. For the appropriate parameters, see the section of the manual that corresponds to the attempted command. Parameters must be typed exactly to specification to be recognized correctly by the CLI. Error 231: Invalid Port Number The value specified for the portNumber parameter is invalid.
PAGE 240
Error Messages Table 5: CLI Error Messages (Continued) Message 240 Description Action Error 234: Invalid Command The CLI cannot associate an action with the submitted command. The command may be misspelled, required parameters may be missing, or the request may not be applicable to the branch of the CLI tree from which it was submitted. Refer to Chapter 2 for the correct command syntax and spelling.
PAGE 241
Error Messages Table 5: CLI Error Messages (Continued) Message Description Action Error 237: Invalid Zoning Database An unidentifiable problem with the zone set in the local work area occurred. Check that all the parameters of the command are valid, and resubmit the command. If the problem persists, clear and then reconstruct the zone set. Error 238: Invalid Feature Key The specified feature key is invalid. Check that the feature key is entered correctly, and resubmit the command.
PAGE 242
Error Messages Table 5: CLI Error Messages (Continued) Message 242 Description Action Error 243: Not allowed while S/390 Mode is Enabled This operation is not allowed while S/390 mode (FICON management style in HAFM) is enabled. This command is not valid for the S/390 environment (FICON management style in HAFM). Error 244: Not allowed while Enterprise Fabric Mode is Active and Switch is Online This operation is not allowed while the switch is in Enterprise Fabric mode and the switch is online.
PAGE 243
Error Messages Table 5: CLI Error Messages (Continued) Message Description Action Error 251: The threshold alert must be disabled The counter threshold alert to be modified/deleted is already enabled. Disable the threshold alert and then try the command again. Error 252: Not Allowed While the Pending Fabric Binding State is Set to Inactive The pending fabric binding set must be set to Restrict in order to edit the pending Fabric Binding List. Set the pending fabric binding state to Restrict.
PAGE 244
Error Messages 244 CLI Reference Guide for Directors and Edge Switches
PAGE 245
index A audience 10 authorized reseller, HP 15 B back pressure state, Open Trunking 151 CLI Reference Guide for Directors and Edge Switches Index case sensitivity, CLI commands 19 CLI commands case sensitivity 19 commaDelim 31 command tree 20 config.features.enterpriseFabMode 40 config.features.enterpriseFabMode.setState 39 config.features.ficonms 41 config.features.installKey 42 config.features.OpenSysMS 43, 44 config.features.show 45 config.ficonms.setState 47 config.ip.ethernet 48 config.ip.
PAGE 246
Index config.zoning.clearZone 127 config.zoning.clearZoneSet 120 config.zoning.deactivateZoneSet 118 config.zoning.deletePortMem 129 config.zoning.deleteWwnMem 128 config.zoning.deleteZone 122 config.zoning.renameZone 130 config.zoning.renameZoneSet 123 config.zoning.replaceZoneSet 119 config.zoning.setDefZoneState 116 config.zoning.showActive 132 config.zoning.showPending 131 handling errors 32 logging in or out 28 login 29 logout 30 maint.port.beacon 134 maint.port.reset 135 maint.system.
PAGE 247
Index config.switch 93 config.zoning 115 config commands 38 config.maint commands 133 config.perf commands 141 config.show commands 174 config.switch commands 93 config.
PAGE 248
Index L link sequence counts 160 log threshold alert 215 logging in 28 logging out 28 logical link errors 160 M Management Style 41 membership list fabric 63, 64, 65 port threshold alert 162 R rack stability, warning 13 related documentation 10 reroutelog, OpenTrunking 190 RSCN zoning state 108 S performance alerts 158 physical link errors 159 SANtegrity Enterprise Fabric Mode 39 Enterprise Fabric mode 40 show OpenTrunking configuration 188 reroutelog 190 OpenTrunking information 155 state back press
PAGE 249
Index T technical support, HP 14 Telnet client session 35 text symbols 11 threshold alert activate 171 add alert 161 alert list 213 counter setting 166 deactivate 171 delete alert 164 disable 171 enable 171 list 213 log 215 name 169 parameters 167 port add 162 statistic table, show 170 threshold alerts overview 158 summed sets 159 throughput threshold alerts 158 trunking congestion 152, 157 TTAs 158 U unresolved congestion OpenTrunking 157 user access rights 28 W warning rack stability 13 symbols on equ
PAGE 250
Index 250 CLI Reference Guide for Directors and Edge Switches