Reference Guide hp StorageWorks CLI Reference Guide for Directors and Edge Switches Product Version: FW v06.xx/HAFM SW v08.02.00 Fifth Edition (July 2004) Part Number: AA–RQ7AE–TE/623–000004–001 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.
© Copyright 2001-2004 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.
Contents Contents About this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Adding Comments to Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Telnet Session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Ethernet Connection Loss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 2 CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents config.security.switchBinding Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 config.security.switchBinding.addMember. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 config.security.switchBinding.deleteMember. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 config.security.switchBinding.setState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 config.security.switchBinding.show . . . . . . . . . . . . . . . .
Contents config.zoning.setDefZoneState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . config.zoning.activateZoneSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . config.zoning.deactivateZoneSet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . config.zoning.replaceZoneSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . config.zoning.clearZoneSet . . . . . . . . . . . . . . . . . .
Contents perf.preferredPath.setPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . perf.preferredPath.setState. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . perf.preferredPath.showPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . perf.thresholdAlerts Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . perf.thresholdAlerts.counter.addAlert . . . .
Contents show.port.info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . show.port.nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . show.port.status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . show.port.technology. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . show.preferredPath.
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.
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.
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.
About this Guide Caution: Text set off in this manner indicates that failure to follow directions could result in damage to equipment or data. Tip: Text in a tip provides additional help to readers by providing nonessential or optional techniques, procedures, or shortcuts. 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.
About this Guide Any surface or area of the equipment marked with these symbols indicates the presence of a hot surface or hot component. Contact with this surface could result in injury. WARNING: To reduce the risk of personal injury from a hot component, allow the surface to cool before touching. Power supplies or systems marked with these symbols indicate the presence of multiple sources of power.
About this Guide Rack Stability Rack stability protects personnel and equipment. WARNING: To reduce the risk of personal injury or damage to the equipment, be sure that: ■ The leveling jacks are extended to the floor. ■ The full weight of the rack rests on the leveling jacks. ■ In single rack installations, the stabilizing feet are attached to the rack. ■ In multiple rack installations, the racks are coupled. ■ Only one rack component is extended at any time.
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.
About this Guide ■ 16 Elsewhere, see the HP website for locations and telephone numbers: http://www.hp.com.
Introduction 1 This chapter introduces the command line interface (CLI) and describes the essentials for using CLI commands.
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.
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 26.
Introduction Table 2: CLI Command Tree Navigation Conventions (Continued) Character Sequence Common Name Action or Description ^F Control-F Position the cursor right one character. ^H Control-H Backspace one character and delete the character. ^I Tab Complete the current keyword. ^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.
Table 3: CLI Command Tree (Continued) openTrunking show ficonMS setState ip ----------------- ethernet show port --------------- blocked extDist fan name show speed type openSysMS setState security ------------- fabricBinding ------ activatePending addAttachedMem bers addMember clearMemList deactivateFabBind deleteMember replacePending showActive showPending portBinding ------- bound wwn show switchBinding ----- addMember deleteMember setState show CLI Reference Guide for Directors and Edge S
Introduction Table 3: CLI Command Tree (Continued) userRights -------- administrator operator show snmp ------------- addCommunity authTraps deleteCommunity SetFaMibVersion setState show switch ------------ bbCredit domainRSCN edTOV insistDomainld interopMode ltdFabRSCN prefDomainId priority raTOV rerouteDelay speed show zoningRSCN system ------------ contact date description location name show zoning ------------ setDefZoneState activateZoneSet 22 CLI Reference Guide for Directors and Edge Swit
Table 3: CLI Command Tree (Continued) deactivateZoneSet replaceZoneSet clearZoneSet addZone deleteZone renameZoneSet 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 LowBBCreditThresh setState CLI Reference Guide for Directors and Edge S
Introduction Table 3: CLI Command Tree (Continued) show unresCongestion preferredPath clearPath setPath setState showPath thresholdAlerts counter addAlert addPort removePort setCounter setParams show showStatisticTable deleteAlert setState throughput addAlert addPort removePort setUtilType setUtilPercentage setParams show showUtilTypeTable traffic show ------------- all eventLog fabric nodes topology 24 CLI Reference Guide for Directors and Edge Switches
Table 3: CLI Command Tree (Continued) features frus ip ----------------- ethernet linkIncidentLog loginServer nameServer nameServerExt openTrunking config reroutelog port --------------- config exit info nodes status technology preferredPath showPath security ----------- fabricBinding portBinding switchBinding switch system thresholdAlerts alerts log zoning Commands are shown, with the exception of the zoning commands, in alphabetical order to make them easier to locate.
Introduction Note that the order in which commands are entered determines the order in which the show commands display the values. Refer to “CLI Commands” on page 39 for examples of show commands output. Navigation of the CLI Command Tree Once the administrator or operator logs in and receives the Root> prompt, the CLI commands are accessed by navigating up and down the CLI command tree.
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.name command and then the maint.
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.
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.
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.
logout 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.
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.
commaDelim 04/12/01 10:58A,375,Major,CTP-0,00010203 04050607 08090A0B 0C0D0E0F, 04/12/01 9:58A,385,Severe,CTP-0,00010203 04050607 08090A0B 0C0D0E0F, 04/11/01 7:18P,395,Severe,CTP-0,00010203 04050607 08090A0B 0C0D0E0F, CLI Reference Guide for Directors and Edge Switches 33
Introduction Handling Command Line Interface Errors Two types of errors detected by the CLI are: ■ An error associated with the interface. For example, a keyword is misspelled or does not exist. Root> confg Error 234: Invalid Command ■ An error associated with a fabric, director, or edge switch. For example, a parameter error is detected by a switch, where port 24 is entered for a switch that supports only 16 ports.
commaDelim 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.
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.
commaDelim 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.
Introduction 38 CLI Reference Guide for Directors and Edge Switches
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.
CLI Commands Command Overview Most of the commands in this chapter are listed in alphabetical order to make them easy to locate. Although the commands can be entered in any order, depending on the results desired (so long as the tree structure is followed), the order used herein for the zoning commands follows a typical order of entry. The various show commands are usually entered at the end of a group of other commands.
config 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.
CLI Commands 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.
config.features.enterpriseFabMode 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.
CLI Commands 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.
config.features.installKey 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.
CLI Commands 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.
config.features.opentrunking 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. Command Example Root> config features opentrunking 1 Note: The command “perf.
CLI Commands 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 215. 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.
config.features.
CLI Commands 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.
config.ip.ethernet 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.
CLI Commands 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: 52 10.0.0.0 0.0.0.
config.openSysMS.setState 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.
CLI Commands 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–11 for the Edge Switch 2/12 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.
config.port.extDist 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 gigabit per second (Gbps) port. Parameters This command has two required parameters: portNumber Specifies the port number.
CLI Commands 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.
config.port.name 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–11 for the Edge Switch 2/12 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.
CLI Commands 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.
config.port.show 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.
CLI Commands 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.
config.port.
CLI Commands 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/12 or 2/24, a port can also be an Fx_Port or Gx_Port. On the Edge Switch 2/12, the E_Port, G_Port, and Gx_Port options are not valid, unless the Fabric Capable feature is enabled. For more information, see the Edge Switch 2/12 Installation Guide.
config.port.type portNumber Specifies the port number. Valid values are: 0–11 for the Edge Switch 2/12 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 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).
CLI Commands config.security.fabricBinding Commands Fabric Binding functionality, provided by the SANtegrity Binding feature, allows you to bind the switch or director to specified fabrics so that it can communicate only with those fabrics. With Fabric Binding enabled, the product can communicate only with fabrics that are included in the Fabric Binding Membership List (FBML). Using Fabric Binding, you can allow specific switches to attach to specific fabrics in the SAN.
config.port.type Note: An Edge Switch 2/12 cannot participate in a fabric, unless the Fabric Capable feature is enabled. For more information, see the Edge Switch 2/12 Installation Guide. Fabric Binding Membership Terminology Two types of FBMLs are configured using the CLI: ■ Active FBML: When fabric binding is active, the active FBML is the list of fabric members with which the product is allowed to communicate. If fabric binding is disabled, this list is empty.
CLI Commands ■ If Fabric Binding is enabled and the director is offline, you can disable Insistent Domain ID, but this will disable Fabric Binding. ■ You cannot disable Fabric Binding if Enterprise Fabric Mode is enabled. However, if Enterprise Fabric Mode is disabled, you can disable Fabric Binding. Fabric Binding can be disabled when the switch is offline.
config.security.fabricBinding.activatePending config.security.fabricBinding.activatePending Syntax activatePending Purpose This command activates the fabric binding configuration contained in the pending work area to the fabric. Members that are attached remain in the list, because the Pending FBML must contain all attached members to become active. Note: This command takes effect immediately.
CLI Commands config.security.fabricBinding.addAttachedMembers Syntax addAttachedMembers Purpose This command adds all the current members of the fabric to the Pending FBML. If a fabric member's domain ID or WWN already exists in the list, it is not added. Parameters This command has no parameters.
config.security.fabricBinding.addMember config.security.fabricBinding.addMember Syntax addMember 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.
CLI Commands config.security.fabricBinding.clearMemList Syntax clearMemList Purpose This command clears the Fabric Membership List for the pending fabric binding working area. Members that are attached remain in the list, because the Pending FBML must contain all attached members to become active. 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.
config.security.fabricBinding.deactivateFabBind config.security.fabricBinding.deactivateFabBind Syntax deactivateFabBind Purpose This command deactivates the active FBML on the fabric. The Active FBML is erased when this command is executed. Note: This command takes effect immediately in the fabric. Parameters This command has no parameters.
CLI Commands 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. The local member and attached members cannot be deleted from the list. 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.
config.security.fabricBinding.replacePending 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. Parameters This command has no parameters.
CLI Commands config.security.fabricBinding.showActive Syntax showActive Purpose This command displays the fabric binding configuration (active FBML) saved on the fabric. It performs the same function as “show.security.fabricBinding” on page 250. Parameters This command has no parameters. Output This command displays the following fabric binding configuration data: Domain ID The domain ID of the FBML member. Valid domain ID's range from 1 to 239.
config.security.fabricBinding.showPending 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.
CLI Commands config.security.portBinding Commands The Port Binding CLI commands enable you to “bind” a specific switch or director port to the WWN of an attached node, switch, or director for exclusive communication. The config.security.portBinding commands include the following: 76 ■ config.security.portBinding.bound, page 77 ■ config.security.portBinding.show, page 79 ■ config.security.portBinding.
config.security.portBinding.bound 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.
CLI Commands Command Examples Root> config security portBinding bound 4 true Root> config security portBinding bound 4 1 78 CLI Reference Guide for Directors and Edge Switches
config.security.portBinding.show 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.
CLI Commands Output Example The output from the config.security.portBinding.show command displays as follows.
config.security.portBinding.wwn 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.
CLI Commands 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.
config.security.portBinding.wwn config.security.switchBinding Commands Switch Binding CLI commands allow you to enable the product to communicate only with nodes, switches, and directors that are listed on the Switch Binding Membership List (SBML). Switch Binding restricts connections to only the devices listed on the SBML and allows no other devices to communicate with the switch. When an unauthorized WWN attempts to log in, it is denied a connection and an event is posted to the Event Log.
CLI Commands config.security.switchBinding.addMember Syntax addMember wwn Purpose This command adds a new member to the Switch Binding Membership List. A maximum number of 256 members may be added to the Switch Binding 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 Binding Membership List. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00).
config.security.switchBinding.deleteMember config.security.switchBinding.deleteMember Syntax deleteMember wwn Purpose This command removes a member from the Switch Binding 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 Binding Membership List.
CLI Commands 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. eRestrict — Enable switch binding and restrict E_Port connections.
config.security.switchBinding.
CLI Commands 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.
config.security.switchBinding.show config.security.userRights Commands The config.security.userRights commands include the following: ■ config.security.userRights.administrator, page 90 ■ config.security.userRights.operator, page 91 ■ config.security.userRights.
CLI Commands 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. This parameter is 1–15 characters.
config.security.userRights.operator 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.
CLI Commands 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.
config.security.userRights.show config.snmp.add Commands The config.snmp.add commands include the following: ■ config.snmp.addCommunity, page 94 ■ config.snmp.authTraps, page 95 ■ config.snmp.deleteCommunity, page 96 ■ config.snmp.setFaMibVersion, page 97 ■ config.snmp.setState, page 98 ■ config.snmp.
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.
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.
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.
config.snmp.setFaMibVersion config.snmp.setFaMibVersion Syntax setFaMibVersion versionNumber Purpose This command sets the version of the Fibre Alliance MIB with which the SNMP agent interacts. The version number can be set to 3.0 or 3.1. Parameters This command has one parameter. versionNumber Sets the version of the Fibre Alliance MIB version number. Accepted values for this command are 3.0 or 3.1. Command Example Root> config snmp setFaMibVersion 3.
CLI Commands config.snmp.setState Syntax setState enabledState Purpose This command enables or disables the SNMP agent. When disabled, the SNMP agent does not respond to any requests or send any traps. Parameters This command has one parameter. enabledState Sets the state of the SNMP agent. This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted.
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: SNMP Agent State The state of the SNMP agent. If it is disabled, the SNMP state does not respond to any requests and does not produce any traps.
CLI Commands UDP Port The user datagram protocol (UDP) port number to which the director will send traps for each recipient. Output Example The output from the config.snmp.show command displays as follows. SNMP Agent State: Enabled FA MIB Version Number: 3.0 Authentication Traps: Enabled Index Community Name WriteAuth ----- -------------------- --------1 CommunityName1 Enabled 2 CommunityName2 Enabled 3 CommunityName3 Disabled 4 public Enabled 100 Trap Recipient UDP Port --------------- -------123.123.
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, page 102 ■ config.switch.domainRSCN, page 103 ■ config.switch.insistDomainId, page 104 ■ config.switch.
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.
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. When this parameter is enabled, domain register for state change notifications (domain RSCNs) are sent between end devices in a fabric to provide additional connection information to host bus adapters (HBA) and storage devices.
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 or disabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values.
config.switch.ltdFabRSCN config.switch.ltdFabRSCN Syntax ltdFabRSCN ltdFabRSCNState Purpose This command sets the status of limited fabric RSCNs. When enabled, fabric register for state change notifications (RSCNs) are suppressed during an IPL. Description The switch must be set offline before this command is entered. Parameters This command has one parameter. ltdFabRSCNState Specifies whether the limited fabric RSCN state is enabled. Valid values are enable and disable.
CLI Commands config.switch.edTOV Syntax edTOV timeoutValue Purpose This command sets the E_D_TOV for the switch. Description The switch must be set offline before this command is entered. Special care should be used when scripting this command due to its relationship with R_A_TOV. Parameters This 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.
config.switch.interopMode 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.
CLI Commands 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.
config.switch.priority 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.
CLI Commands switchPriority Specifies the switch priority. Valid values are: principal, default, or neverprincipal. ■ principal — sets the numerical switch priority to 1. The switch with a priority of 1 becomes the principal switch; however, if two or more switches have a priority of 1, the switch with the lowest WWN becomes the principal switch. ■ default — sets the numerical switch priority to 254.
config.switch.raTOV 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.
CLI Commands config.switch.rerouteDelay Syntax rerouteDelay rerouteDelayState Purpose This command enables or disables rerouting delay for the switch. Description The switch can be either offline or online when this command is executed. 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.
config.switch.
CLI Commands 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.
config.switch.show 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.
CLI Commands 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.
config.switch.zoningRSCN config.switch.zoningRSCN Syntax zoningRSCN zoningRSCNState Purpose This command sets the zoning RSCN state for the switch. When enabled, this parameter allows zoning register for state change notifications (RSCNs) to be sent to registered members of the fabric. Zoning RSCNs are sent to ports on the switch following any change to the fabric’s active zone set. The switch can be either offline or online when this command is executed.
CLI Commands config.system Commands The config.system commands include the following: 118 ■ config.system.contact, page 119 ■ config.system.date, page 120 ■ config.system.description, page 121 ■ config.system.location, page 122 ■ config.system.name, page 123 ■ config.system.
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.
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.
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.
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.
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.
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.
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.
CLI Commands 126 ■ config.zoning.deletePortMem, page 140 ■ config.zoning.renameZone, page 141 ■ config.zoning.showPending, page 142 ■ config.zoning.
config.zoning.setDefZoneState 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.
CLI Commands 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.
config.zoning.deactivateZoneSet 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.
CLI Commands 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.
config.zoning.clearZoneSet 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.
CLI Commands 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.
config.zoning.deleteZone 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.
CLI Commands config.zoning.renameZoneSet Syntax renameZoneSet “zoneSetName” Purpose This command changes the name of the zone set in the work area. Description Changes are not activated on the switch until the config.zoning.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.
config.zoning.addWwnMem 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.
CLI Commands 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. Parameters This command has three parameters: zoneName Specifies the name of the zone.
config.zoning.
CLI Commands 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.
config.zoning.deleteWwnMem 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.
CLI Commands 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.
config.zoning.renameZone 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.
CLI Commands 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.
config.zoning.showActive 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.
CLI Commands 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. The maint commands include the following: 144 ■ maint.
maint.port.beacon 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–11 for the Edge Switch 2/12 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.
CLI Commands 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.
maint.system.beacon 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.
CLI Commands maint.system.clearSysError Syntax clearSysError Purpose This command clears the system error light. Parameters This command has no parameters.
maint.system.ipl 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.
CLI Commands 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).
maint.system.setOnlineState 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.
CLI Commands 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.
perf.class2 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.
CLI Commands RxWords The number of Class 2 4-byte words within frames that the port has received. 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.
perf.class3 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.
CLI Commands RxWords The number of Class 3 4-byte words within frames that the port has received. 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.
perf.clearStats 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.
CLI Commands 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.
perf.errors 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.
CLI Commands 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.
perf.link Reset In The number of link resets initiated by the attached N_Port. 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.
CLI Commands 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. If the state is configured to be enabled, a back pressure entry is made to the Event Log and an SNMP trap is generated if SNMP is configured.
perf.openTrunking.congestionThresh 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.
CLI Commands perf.openTrunking.lowBBCreditThresh Syntax LowBBCreditThresh lowBBcreditThreshold Purpose This command configures the low BB_credit threshold of the OpenTrunking configuration. The low BB_credit 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 with the problem.
perf.opentrunking.setState 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. Command Example Root> perf opentrunking setState 1 Note: The command “config.
CLI Commands 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.
perf.openTrunking.show 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.
CLI Commands 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.
perf.openTrunking.unresCongestion perf.preferredPath The perf.preferredPath commands enable you to use the Preferred Path feature to influence the route of data traffic that traverses multiple switches or directors in a fabric. If more than one ISL connects switches in your SAN, this feature is useful for specifying an ISL preference for a particular flow.
CLI Commands The perf.preferredPath commands include the following: 170 ■ perf.preferredPath.clearPath, page 171 ■ perf.preferredPath.setPath, page 172 ■ perf.preferredPath.setState, page 174 ■ perf.preferredPath.
perf.preferredPath.clearPath perf.preferredPath.clearPath Syntax clearPath destDomainID sourcePort Purpose This command deletes a preferred path. The command causes the specified path to use a path selection algorithm that is different from the preferred path. All configured paths can be removed by specifying the all parameter for both the destination domain ID and source port. Parameters This command has the following parameters: destDomainId Specifies the destination domain ID.
CLI Commands perf.preferredPath.setPath Syntax setPath destDomainID sourcePort exitPort Purpose This command sets a preferred exit port given the destination domain ID and source port. An exit port can be set for each combination of destination domain ID and source port. Parameters This command has the following parameters: destDomainId Specifies the destination domain ID. Valid domain IDs are in the range 1–31. sourcePort Specifies the number of the source port.
perf.preferredPath.
CLI Commands perf.preferredPath.setState Syntax setState enabledState Purpose This command enables or disables the Preferred Path feature. Note: Insistent domain IDs must be used in order to enable the preferred path state. Parameters This command has one parameter. enabledState Sets the state of the preferred path feature. When disabled, the preferred path settings are ignored for all path selection decisions. Accepted values for this command are enable and disable.
perf.preferredPath.showPath perf.preferredPath.showPath Syntax showPath destDomainID sourcePort Purpose This command displays the requested Preferred Path configuration. The output shows the configured preferred exit port. Using all for either the destination domain ID or the specified sourcePort parameter results in output that shows all configured and actual exit ports for the other parameter. If the destination domain is set to all, then all paths from the specified source port are displayed.
CLI Commands Output The output from perf.preferredPath.showPath includes the following parameters: Destination Domain The destination domain ID for which a preferred path has been configured. This is displayed only if the destination domain parameter is set to all. Source Port This is the source port for which a preferred path to the specified destination domain ID is specified. This is displayed only if the source port parameter is set to all.
perf.preferredPath.
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 maximum of 16 threshold alerts, including both counter threshold alerts (CTAs) and throughput threshold alerts (TTAs). Each of these types of alerts have commands that are specific to the alert type. ■ Counter threshold alerts: These are alerts that are triggered by counts of events.
perf.preferredPath.showPath Note: The perf.thresholdAlerts commands are standard command line interface features. They do not require a feature key. Creating Threshhold Alerts The tasks you need to complete to create and activate a threshold alert differ depending on the type of alert you are creating. To implement a counter threshold alert, see “Activating a Counter Threshold Alert” on page 179. To implement a throughput alert, see “Activating a Throughput Threshold Alert” on page 180.
CLI Commands Activating a Throughput Threshold Alert In order to activate a throughput threshold alert using the CLI, you must enter certain commands in order. Enable the threshold alert using the following order: 1. Create a throughput threshold alert using the command perf.thresholdAlerts.throughput.addAlert. Use this command to create a name for the threshold alert that you can use in subsequent commands. The threshold alert must then be configured using the other throughput threshold alert commands.
perf.preferredPath.showPath Table 5 provides a list of threshold alert counters and counter sets.
CLI Commands Description of Summed Sets Some of the threshold alerts consist of groups of related items called Summed Sets. When any of the items in the summed set are encountered, the total value of the summed set counter is incremented.
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.
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 184 The name of a counter threshold alert as defined by the command “perf.thresholdAlerts.counter.addAlert” on page 183.
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–11 for the Edge Switch 2/12 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.
CLI Commands 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” on page 183. portNumber Specifies the port number.
perf.thresholdAlerts.counter.setCounter 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 command “perf.thresholdAlerts.counter.addAlert” on page 183. Note: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command.
CLI Commands 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” on page 183.
perf.thresholdAlerts.counter.setParams Interval Time = 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.
CLI Commands 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” on page 183. Note: The output of this command truncates threshold alert names that are longer than 51 characters.
perf.threshAlerts.counter.showStatisticTable 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.
CLI Commands perf.thresholdAlerts.deleteAlert Syntax deleteAlert name Purpose This command deletes a specified threshold alert. Note: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. Parameters This command has one parameter. name 192 The name of a threshold alert as defined by the commands perf.thresholdAlerts.counter.addPort and perf.thresholdAlerts.throughput.
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” on page 183. enabledState Sets the counter threshold alert enabled state. Valid values are enabled and disabled. Boolean 1 and 0 values may also be substituted.
CLI Commands perf.thresholdAlerts.throughput.addAlert Syntax addAlert name Purpose This command configures a new throughput threshold alert and assigns it a name. The new alert is assigned default settings that can then be changed using the other throughput threshold alert commands.
perf.thresholdAlerts.throughput.
CLI Commands perf.thresholdAlerts.throughput.addPort Syntax addPort name portNumber Purpose This command adds a port to the specified throughput threshold alert. Note: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command.
perf.thresholdAlerts.throughput.addPort Parameters This command has the following parameters: name The name of a throughput threshold alert as defined by the command “perf.thresholdAlerts.throughput.addAlert” on page 194. portNumber Specifies the port number or port type. Valid values are either a single port number, all ports, or port type.
CLI Commands perf.thresholdAlerts.throughput.removePort Syntax removePort name portNumber Purpose This command removes a port from the specified throughput threshold alert. Note: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. Parameters This command has the following parameters: name The name of a throughput threshold alert as defined by the command “perf.thresholdAlerts.throughput.addAlert” on page 194.
perf.thresholdAlerts.throughput.setUtilType perf.thresholdAlerts.throughput.setUtilType Syntax setUtilType name utilizationType Purpose This command sets the throughput statistic that is used to trigger the throughput threshold alert. Note: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. Parameters This command has the following parameters: name The name of a throughput threshold alert as defined by the command “perf.
CLI Commands perf.thresholdAlerts.throughput.SetUtilPercentage Syntax SetUtilPercentage name utilizationPercentage Purpose This command sets the throughput utilization percentage that is used to trigger the throughput threshold alert. Note: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. Parameters This command has the following parameters: name The name of a throughput threshold alert as defined by the command “perf.
perf.thresholdAlerts.throughput.setParams perf.thresholdAlerts.throughput.setParams Syntax setParams name duration interval Purpose This command sets the duration and interval times for a specified throughput threshold alert. This command enables you to configure the alert to be sent if both of the following events occur: ■ The throughput threshold alert value is surpassed for more than the timespan specified for the duration parameter.
CLI Commands Command Example Root> perf thresholdAlerts throughput SetParams eportRx 1 10 202 CLI Reference Guide for Directors and Edge Switches
perf.thresholdAlerts.throughput.show perf.thresholdAlerts.throughput.show Syntax show name Purpose This command displays the settings for an individual throughput threshold alert. Parameters This command has the following parameter. name The name of a throughput threshold alert as defined by the command “perf.thresholdAlerts.throughput.addAlert” on page 194. You can specify all instead of a name, which means that all threshold alerts are displayed.
CLI Commands perf.thresholdAlerts.throughput.showUtilTypeTable Syntax showUtilTypeTable Purpose This command displays a table of the utilization types that can be used for a throughput threshold alert. This table is used for reference only. Parameters This command has no parameters. Command Example Root> perf thresholdAlerts throughput showUtilTypeTable Output Example The output from the perf.thresholdAlerts.throughput.showUtilTypeTable command displays as follows.
perf.traffic 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.
CLI Commands 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.
perf.traffic 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.
CLI Commands show.all Syntax all Purpose This command displays all configuration and status information available. The command results in a sequential display of the output of other CLI show commands. This set of show commands returns the full configuration and status of the switch and fabric. Parameters This command has no parameters. Command Example Root> show all Output The output of this command is a sequential display of the output of other CLI show commands.
show.all ■ show.features ■ show.security.portbinding ■ show.security.switchbinding ■ show.security.fabricbinding ■ show.openTrunking.config ■ show.thresholdAlerts.alerts ■ show.fabric.topology ■ show.fabric.
CLI Commands 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.
show.eventLog 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.
CLI Commands show.fabric.nodes Syntax nodes Purpose This command displays a list of all fabric-attached nodes. Parameters This command has no parameters. Command Example Root> show fabric nodes Output The data is displayed as a table that includes the following properties: Domain ID Domain ID of the switch to which the device is attached. Node WWN The WWN of the fabric attached node. Output Example The output from the show.fabric.nodes command displays as follows.
show.fabric.topology show.fabric.topology Syntax topology Purpose This command displays a text description of the fabric. Parameters This command has no parameters. Command Example Root> show fabric topology Output The features data is displayed as a table that includes the following properties: Switch WWN The WWN of the switch at the local end of the ISL. DID Domain ID of the switch at the local end of the ISL. OutPrt The port number at the local end of the ISL.
CLI Commands Output Example The output from the show.fabric.topology command displays as follows.
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 command “config.features.show” on page 48. 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.
CLI Commands Output Example The output from the show.
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.
CLI Commands Output Example The output from the show.
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.
CLI Commands show.linkIncidentLog Syntax linkIncidentLog [clear] Purpose This command shows the contents of the link incident log on the director or switch. Note: If the switch is restarted (as occurs during IPL, IML, configuration reset, feature key installation, or firmware load) or is power cycled, the information in the link incident log is lost. Parameters This command has one parameter. clear This optional parameter causes all link incident log entries to be cleared.
show.linkIncidentLog Output Example The output from the show.linkIncidentLog command displays as follows: Date / Time Port Link Incident Event ----------------- ---- --------------------------------------- 02/27/03 02/27/03 02/27/03 02/27/03 Not Operational primitive sequence. Primitive sequence timeout. Not Operational primitive sequence. Invalid primitive seq received.
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: 222 Port The port number where the device is attached.
show.loginServer Output Example The output from the show.loginServer command displays as follows.
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).
show.nameServer Output Example The output from the show.nameServer command displays as follows.
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.
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 224. 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.
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: 228 Unresolved Congestion The current enabled/disabled state of the unresolved congestion trunking feature. Backpressure The current enabled/disabled state of the backpressure trunking feature.
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 ...
CLI Commands show.openTrunking.reroutelog Syntax reroutelog [clear] Purpose This command displays the trunking reroute log information. Note: If the switch is restarted (as occurs during IPL, IML, configuration reset, feature key installation, or firmware load) or is power cycled, the information in the Open Trunking Re-route Log is lost. Parameters This command has one parameter: clear This optional parameter causes all reroute log entries to be cleared.
show.openTrunking.reroutelog Output The device information data is displayed as a table that includes the following properties: Date/Time The date/time when the rerouting event occurred. Rcv The port associated with the flow that was rerouted. Dom The target domain associated with the flow that was rerouted. Old The exit port number on this switch that the flow used to get to the target domain. New The exit port number on this switch that the flow now uses to get to the target domain.
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: 232 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.
show.port.config Output Example The output from the show.port.
CLI Commands show.port.exit Syntax exit destDomainID sourcePort Purpose This command displays the exit port from a source port to a given destination domain. This command shows the Preferred Path configuration. Use all for one of the command’s parameters to display all configured and actual exit ports for either the destination domain ID or the specified source Port. You cannot specify all for both parameters.
show.port.exit Output The output from show.port.exit includes the following parameters: Destination Domain The destination domain ID to which a preferred path has been configured. This is displayed only if the destination domain parameter is set to all. Source Port The source port for which a preferred path to the specified destination domain ID is specified. This is displayed only if the source port parameter is set to all. Exit Port This is the actual exit port being used for the given path.
CLI Commands Output with sourcePort set to all Root> show port exit 1 all Source Port Exit Port ------------------ ---------------0 No Source 1 5 2 No Source 3 6 … 236 CLI Reference Guide for Directors and Edge Switches
show.port.info 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).
CLI Commands 8 9 10 11 12 13 14 15 238 10:00:80:08:11:22:33:44 10:00:80:09:11:22:33:44 10:00:80:10:11:22:33:44 10:00:80:11:11:22:33:44 10:00:80:12:11:22:33:44 10:00:80:13:11:22:33:44 10:00:80:14:11:22:33:44 10:00:80:15:11:22:33:44 2 2 1 1 1 1 1 1 Gb/sec Gb/sec Gb/sec Gb/sec Gb/sec Gb/sec Gb/sec Gb/sec 2 2 2 2 2 2 2 2 Gb/sec Gb/sec Gb/sec Gb/sec Gb/sec Gb/sec Gb/sec Gb/sec CLI Reference Guide for Directors and Edge Switches
show.port.nodes show.port.nodes Syntax nodes portNumber Purpose This command displays the loop node list for a specified port. Parameters This command has one parameter: portNumber Specifies the port number. Valid values are: 0–11 for the Edge Switch 2/12 0–23 for the Edge Switch 2/24 Command Example Root> show port nodes portNumber Output The port data is displayed as a table that includes the following properties: FC Addr The Fibre Channel address of nodes attached to this port.
CLI Commands Output Example The Data Field Size value for public devices. This field is left blank for private devices.
show.port.status show.port.status Syntax status Purpose This command displays port status for all ports. Parameters This command has no parameters. Command Example Root> show port status Output The port status data is displayed as a table that includes the following properties: Port The port number. State The port state.
CLI Commands 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.
show.port.
CLI Commands Output Example The output from the show.port.status command displays as follows.
show.port.technology 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: 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).
CLI Commands Output Example The output from the show.port.
show.preferredPath.showPath show.preferredPath.showPath Syntax showPath destDomainID sourcePort Purpose This command displays the specified Preferred Path configuration and the actual path used by the system. The output shows both the exit port, as configured for the Preferred Path feature, and the actual exit port currently being used for traffic. Use all for one of the command’s parameters to display all configured and actual exit ports for either the destination domain ID or the specified source Port.
CLI Commands Output The output from show.preferredPath.showPath includes the following parameters: Destination Domain The destination domain ID to which a preferred path has been configured. This is displayed only if the destination domain parameter is set to all. Source Port The source port for which a preferred path to the specified destination domain ID is specified. This is displayed only if the source port parameter is set to all. Preferred Exit Port The configured Preferred Path exit port.
show.preferredPath.
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.
show.security.fabricBinding Output Example The output from the show.security.fabricBinding command displays as follows.
CLI Commands 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: 252 Port The port number. WWN Binding The state of port binding for the specified port (active or inactive).
show.security.portBinding Output Example The output from the show.security.
CLI Commands show.security.switchBinding Syntax switchBinding Purpose This command displays the switch binding configuration. Parameters This command has no parameters.
show.security.switchBinding Output Example The output from the show.security.
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 256 The state of the switch. For example: ■ online ■ offline BB Credit The BB_Credit as set in the config.switch.bbCredit command. (This does not apply to the Edge Switch 2/24. R_A_TOV The R_A_TOV as set in the config.switch.
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.
CLI Commands Limited Fabric RSCN When enabled, fabric RSCNs are suppressed after an IPL. 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: FC Address Domain Id Limited Fabric RSCN 258 Online 2 20 4 1 Default 2 Gb/sec Enabled Open Systems Open Fabric 1.
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.
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.
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.
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
show.thresholdAlerts.
CLI Commands 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.
show.thresholdAlerts.
CLI Commands Output Example The output from the show.thresholdAlerts.log command displays as follows.
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.
CLI Commands 268 CLI Reference Guide for Directors and Edge Switches
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 6: CLI Error Messages Message Description Action Error 05: Busy The switch is busy or processing another request. After a few seconds, reissue the request.
Error Messages Table 6: CLI Error Messages (Continued) Message 270 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.
Error Messages Table 6: 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.
Error Messages Table 6: CLI Error Messages (Continued) Message 272 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.
Error Messages Table 6: 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.
Error Messages Table 6: CLI Error Messages (Continued) Message 274 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.
Error Messages Table 6: 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.
Error Messages Table 6: CLI Error Messages (Continued) 276 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.
Error Messages Table 6: 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.
Error Messages Table 6: CLI Error Messages (Continued) Message 278 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.
Error Messages Table 6: 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.
Error Messages Table 6: CLI Error Messages (Continued) Message Error 106: Invalid Threshold Scope Error 107: Invalid Threshold State 280 Description Action The scope of a threshold alert is not set to a valid state before the user activates an alert. Set the scope of the threshold alert, then try to activate the alert. The scope of a threshold alert must be set before the user activates an alert. Set the scope of the threshold alert, then try to activate the alert.
Error Messages Table 6: CLI Error Messages (Continued) Message 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.
Error Messages Table 6: CLI Error Messages (Continued) Message 282 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.
Error Messages Table 6: CLI Error Messages (Continued) Message Description Action Error 139: Insistent Domain ID's Must Be Enabled When Fabric Binding Active The user attempted to disable insistent domain IDs while fabric binding was active. Insistent domain IDs must remain enabled while fabric binding is active. If fabric binding is set to inactive, the insistent domain ID state may be changed. It should be noted, however, that this can be disruptive to the fabric.
Error Messages Table 6: CLI Error Messages (Continued) Message 284 Description Action Error 144: The SANtegrity Feature Has Not Been Installed The user attempted to activate a change to the fabric security configuration without first installing the SANtegrity feature key. If this key has not been installed, contact your sales representative.
Error Messages Table 6: CLI Error Messages (Continued) Message Description Action Error 153: Feature Key Not Installed The request cannot be completed because the required feature key has not been installed to the firmware. Contact your sales representative. 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 Binding Membership List.
Error Messages Table 6: CLI Error Messages (Continued) Message 286 Description Action Error 157: Access Control List is Disabled The switch must be offline and Fabric Binding must be inactive before this feature can be disabled. Deactivating this feature can be disruptive to Fabric operations. Take the switch offline and deactivate fabric binding before disabling this feature. Error 158: Invalid IP Access Control List Pair The pair of IP addresses are invalid and cannot be added to the list.
Error Messages Table 6: CLI Error Messages (Continued) Message Description Action Error 167: Diagnostics can not be run on inactive port The port is in the inactive state and diagnostics can't be run. The port state must change out of the inactive state. Error 168: Duplicate member in the list The port is in the inactive state and diagnostics can't be run. The port state must change out of the inactive state.
Error Messages Table 6: CLI Error Messages (Continued) Message 288 Description Action Error 180: Too many authentication management users Only 25 management users can be added to the user database. Remove other management users in order to make room for a new one. Error 181: Preferred path must be disabled The Preferred Path feature must be disabled. Disable the Preferred Path feature. Error 182: Source port must be different than the exit port The source and exit ports cannot be the same.
Error Messages Table 6: CLI Error Messages (Continued) Message Description Action Error 209: Change Request Aborted The switch did not accept the request. Check that all the parameters are correct, and reenter the command. If problems persist, contact your service representative. Error 210: Busy Processing Another Request A different switch in the fabric was busy processing another request and could not complete the command. Check that all the parameters are correct, and reenter the command.
Error Messages Table 6: CLI Error Messages (Continued) Message 290 Description Action Error 214: A Zone Contains Zero Members The config.zoning.activateZo neSet command tried to activate the zone set contained in the work area to the fabric; however, the zone set contains at least one zone that is empty. Each zone in the zone set must contain at least one zone member. Add zone members so that each zone has at least one zone member; then reenter the config.zoning.
Error Messages Table 6: CLI Error Messages (Continued) Message Description Action Error 219: Invalid Port Type The value specified for the port type is invalid. A port may be configured as an E_Port, a G_Port, or an F_Port. Make sure the port is configured appropriately and resubmit the command. The Fx_port and Gx_port types are also supported on the Edge Switch 2/24. Error 222: Invalid SNMP Community Index The value specified for the SNMP community index is invalid.
Error Messages Table 6: CLI Error Messages (Continued) Message 292 Description Action Error 227: Invalid SNMP Community Name The value specified for the SNMP community name is invalid. The community name must not exceed 32 characters in length. Duplicate community names are allowed if the corresponding write authorizations match. Specify a valid SNMP community name, and resubmit the command.
Error Messages Table 6: CLI Error Messages (Continued) Message Error 232: Invalid Domain ID Description The value specified for the domainId parameter is invalid. For example, the domainId parameter of the config.switch.pr efDomainId Action Refer to “CLI Commands” on page 39 for information about the commands with the domainId parameter. Specify a valid domain ID value, and resubmit the command. command requires an integer in the range 1–31.
Error Messages Table 6: CLI Error Messages (Continued) Message 294 Description Action Error 235: Unrecognized Command The CLI does not recognize the submitted command and cannot perform the help(?) command as requested. Refer to “Using the Command Line Interface Help” on page 35for information about the help command. Refer to “CLI Commands” on page 39 for the correct spelling of the submitted command. Ensure that the command is spelled correctly.
Error Messages Table 6: CLI Error Messages (Continued) Message Description Action Error 238: Invalid Feature Key The specified feature key is invalid. Check that the feature key is entered correctly, and resubmit the command. If the problem persists, contact your service representative. The message that is returned is a string that includes both the error number and the text of the message.
Error Messages Table 6: CLI Error Messages (Continued) Message 296 Description Action 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. Make sure Enterprise Fabric mode is not enabled and the switch is offline. Error 245: Invalid increment value The increment value specified is not between 1 and 70560. Make sure the increment value given is between 1 and 70560.
Error Messages Table 6: CLI Error Messages (Continued) Message Description Action Error 253: Cannot Remove a Member Currently Interacting with the Fabric Current members of the fabric must be included in the Fabric Binding List. Do not remove active fabric members from the pending Fabric Binding List. Error 254: A utilization type must be assigned to this threshold alert A utilization type must be set before activating this threshold alert.
Error Messages Table 6: CLI Error Messages (Continued) Message 298 Description Action Error 264: The Preferred Path feature key is not installed The preferred path feature key must be installed. Install the preferred path feature key. Error 265: Duplicate threshold alert name The desired name for the threshold alert is already in use. Use a different name for the threshold alert.
Index A alert types and counters 180 audience 10 authorized reseller, HP 15 B back pressure state, OpenTrunking 162 CLI Reference Guide for Directors and Edge Switches Index case sensitivity, CLI commands 19 CLI commands case sensitivity 19 commaDelim 32 command tree 20 config.features.enterpriseFabMode 43 config.features.enterpriseFabMode.setState 42 config.features.ficonms 44 config.features.installKey 45 config.features.OpenSysMS 46, 47 config.features.show 48 config.ficonms.setState 50 config.ip.
Index config.zoning.addPortMem 136 config.zoning.addWwnMem 135 config.zoning.addZone 132 config.zoning.clearZone 138 config.zoning.clearZoneSet 131 config.zoning.deactivateZoneSet 129 config.zoning.deletePortMem 140 config.zoning.deleteWwnMem 139 config.zoning.deleteZone 133 config.zoning.renameZone 141 config.zoning.renameZoneSet 134 config.zoning.replaceZoneSet 130 config.zoning.setDefZoneState 127 config.zoning.showActive 143 config.zoning.
Index logging in or out 29 output 28 overview 18 parameters 28 purpose 18 Telnet session 37 user access rights 29 command tree 20 movement limitations 27 navigation 26 commands config 41 config.maint 144 config.perf 152 config.show 207 config.switch 101 config.system 118 config.zoning 125 comments adding 36 config commands 41 config.maint commands 144 config.perf commands 152 config.show commands 207 config.switch commands 101 config.system commands 118 config.
Index G P getting help 15 performance alerts 178 physical link errors 182 port threshold alert 184 preferred path feature overview 169 H help 35 help, obtaining 15 HP authorized reseller 15 storage website 15 technical support 15 L link sequence counts 182 log threshold alert 264 logging in 29 logging out 29 logical link errors 182 M Management Style 44 membership list fabric binding add attached 68 N navigation conventions 19 null strings 28 O Open Systems Management Server 53 OpenTrunking back pr
Index symbols in text 11 symbols on equipment 12 T technical support, HP 15 Telnet client session 37 text symbols 11 threshold alert add alert 183 alert list 261 counter setting 187 list 261 log 264 name 190 parameters 188 port add 184 statistic table, show 191 threshold alerts creating 179 overview 178 CLI Reference Guide for Directors and Edge Switches summed sets 182 throughput threshold alerts 178 trunking congestion 163, 168 TTAs 178 U unresolved congestion OpenTrunking 168 user access rights 29