Page 1: Edge Switches
Part Number: AA-RQ7AC-TE Third Edition (January 2003) This guide covers the essentials of using a command line interface (CLI) to manage the Hewlett-Packard (HP) StorageWorks Director and Edge Switches. Also included are CLI commands, syntax, purpose, and parameters.
Page 2 © Hewlett-Packard Company, 2003. All rights reserved. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Page 3: Table Of Contents
Contents About This Guide Intended Audience ............ix Related Documentation .
Page 4 Contents Commenting Scripts ........... 1–15 Telnet Session.
Page 5 Contents config.security.switchBinding ........2–32 config.security.switchBinding.addMember .
Page 6 Contents config.zoning.deleteZone ......... . 2–71 config.zoning.renameZoneSet .
Page 7 show.security.fabricBinding ........2–126 show.security.portBinding.
Page 9: About This Guide
About This Guide This reference guide provides information to use the command line interface (CLI) for the following Hewlett-Packard (HP) products: • HP StorageWorks Director 2/64. • HP StorageWorks Director 2/140 • HP StorageWorks Edge Switch 2/16. • HP StorageWorks Edge Switch 2/24.
Page 10: Related Documentation
About This Guide Related Documentation For a list of corresponding documentation, see the Related Documents section of the Release Notes that came with this product. For the latest information, documentation, and firmware releases, please visit the following StorageWorks website: http://h18006.www1.hp.com/storage/saninfrastructure.html For information about Fibre Channel Standards, visit the Fibre Channel Industry Association website, located at http://www.fibrechannel.org...
Page 11: Symbols In Text
About This Guide Symbols in Text These symbols may be found in the text of this guide. They have the following meanings. WARNING: Text set off in this manner indicates that failure to follow directions in the warning could result in bodily harm or loss of life. CAUTION: Text set off in this manner indicates that failure to follow directions could result in damage to equipment or data.
Page 12: Rack Stability
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 injury from a hot component, allow the surface to cool before touching.
Page 13: Getting Help
About This Guide Getting Help If you still have a question after reading this guide, contact an HP authorized service http://thenew.hp.com. provider or access our website: HP Technical Support In North America, call technical support at 1-800-652-6672, available 24 hours a day, 7 days a week.
Page 15: Introduction
Introduction This chapter introduces the command line interface (CLI) and describes the essentials for using CLI commands. Section Page Command Line Interface Overview Entering Command Line Interface Commands 1-10 Logging In and Logging Out 1-13 The commaDelim Command 1-14 Handling Command Line Interface Errors 1-14 Using the Command Line Interface Help 1-16...
Page 16: Entering Command Line Interface Commands
Introduction The purpose of the CLI is to automate management of a large number of Directors and Edge Switches through scripts. Although the primary use of the CLI is in host-based scripting environments, CLI commands can also be entered directly at a command line.
Page 17: Cli Command Tree
Introduction Table 1–1: CLI Command Tree Navigation Conventions (Continued) Character Common Sequence Name Action or Description Pound Sign Used to designate comments in a script. Question Mark Provide help information. “ Quotation Mark Used to surround a single token. Control-A Position the cursor to the start of the line.
Page 18: Command Tree
Introduction Command Tree The command tree of the CLI begins from the root. The commands in the four extended branches (config, maint, perf, and show) are described in Chapter 2, Commands. There are three additional commands (login, logout, and commaDelim) that are globally available.
Page 19 Introduction Table 1–2: CLI Command Tree (Continued) show switchBinding ----- addMember deleteMember setSwitchBindState show userRights -------- administrator operator show snmp ------------- addCommunity authTraps deleteCommunity show switch ------------ bbCredit domainRSCN edTOV insistDomainld interopMode prefDomainId priority raTOV rerouteDelay speed show system ------------ contact date description...
Page 20 Introduction Table 1–2: CLI Command Tree (Continued) activateZoneSet deactivateZoneSet replaceZoneSet clearZoneSet addZone deleteZone renameZoneSet addWwnMem addPortMem clearZone deleteWwnMem deletePortMem renameZone showPending showActive maint ------------- port --------------- beacon reset system ------------ beacon clearSysError resetConfig setOnlineState perf --------------- class2 class3 clearStats errors link traffic show --------------...
Page 21: Navigation Of The Cli Command Tree
Introduction Table 1–2: CLI Command Tree (Continued) ip ----------------- ethernet loginServer nameServer port --------------- config info nodes status technology security ----------- fabricBinding portBinding switchBinding switch system zoning Commands are shown, with the exception of the zoning commands, in alphabetical order to make them easier to locate. Although the commands can be entered in any order, depending on the results desired, the order shown in Table 1–2 on page 1-4 the zoning commands is a typical order in which the zoning commands are entered.
Page 22 Introduction At this point, to enter the maint.port.beacon command to set the beaconing state of port 4, the following series of commands is entered: Config.Port> .. Config> .. Root> maint Maint> port Maint.Port> beacon 4 true NOTE: You must return all the way to the root of the tree to transition to another extended branch.
Page 23: Limitation On Movements
Introduction Limitation on Movements As the commands are entered, they are recorded in a history log. The limitations on movement that result from use of the history log are: • If a command has more than 60 characters, the command runs, but the command is not recorded in the history log, and the position in the tree does not change, as shown in the following example.
Page 24: Output
Introduction A null string can be created by using the quotation marks without any space between them. Config.System> location “” Output All output from the CLI commands is limited to the standard 80 columns supported by most Telnet interfaces. The output is left-justified. Logging In and Logging Out The CLI allows a single Telnet client to be connected to a Director or Edge Switch.
Page 25: Login
A user name and password can be set by the administrator through the config.security.userRights.administrator command or through the config.security.userRights.operator command. The access rights chosen for the CLI are completely independent of the other product interfaces, for example, SNMP or Hewlett-Packard (HP) product interfaces. Parameters This command has no parameters. Command Examples...
Page 26: Logout
Introduction logout Syntax logout Purpose This command allows a Telnet client to disconnect from a Director or Edge Switch. Description This command logs out the single Telnet client connected to a Director or Edge Switch. This command can be entered at any point in the command tree. Parameters This command has no parameters.
Page 27: Commadelim
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.
Page 28: Handling Command Line Interface Errors
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.
Page 29: Commenting Scripts
Introduction • If the question mark is used at the end of a recognized command, any parameters for that command display. Root> config port name ? - name <portNumber> <portName> • If the question mark is used after one or more characters of a keyword, any keywords at that level of the CLI command tree display.
Page 30: Telnet Session
Introduction Telnet Session The CLI can only be used through a Telnet client session in an out-of-band management environment, using the Ethernet port in a Director or Edge Switch. Although the primary use of the CLI is in host-based scripting environments, the CLI commands can also be entered directly at a command line.
Page 31: Cli Commands
CLI Commands 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. Section Page 2 -1 Command Overview 2 -1 config Commands 2 -44 config.switch Commands 2 -64 config.zoning Commands...
Page 32 CLI Commands Note that the config.zoning commands function in a different way from the other CLI commands, which are single action commands that take effect immediately. A zoning configuration is typically too complicated to be described by a single command, so the first zoning command entered invokes a work-area editor. The commands take effect on a temporary copy of a zone set in the work area until the temporary copy in the work area is activated to the fabric or is discarded.
Page 33: Config.features.enterprisefabmode
CLI Commands config.features.enterpriseFabMode Syntax enterpriseFabMode enterpriseFabModeState Purpose This command sets the Enterprise Fabric mode state for the fabric. The SANtegrity feature key must be installed to activate the Enterprise Fabric mode state. Parameters This command has one parameter: Specifies whether enterpriseFabMode is enterpriseFabModeState active.
Page 34: Config.features.ficonms
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.) Parameters This command has one parameter: Specifies whether the FICON Management...
Page 35: Config.features.installkey
CLI Commands config.features.installKey Syntax installKey featureKey Purpose This command allows the user to install a feature set that is enabled by the provided feature key. The Switch can be either offline or online when the command is executed. Parameters This command has one parameter: Specifies the key you have received to enable an featureKey optional software feature on a specific product.
Page 36: Config.features.opensysms
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: Specifies whether the Open Systems Management osmsState Server is enabled.
Page 37: Config.features.show
CLI Commands config.features.show Syntax show Purpose This command shows the product feature information configured for this Switch. 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. The feature set installed using a feature key.
Page 38 CLI Commands Installed Feature Set Feature State ------------------------------ ------------------ ----- Open Systems Management Server OSMS Enabled Flex Ports 8 Flex Ports Enabled SANtegrity Fabric Binding Active SANtegrity Switch Binding Enabled SANtegrity Enterprise Fabrics Active 2–8 CLI reference guide for directors and edge switches...
Page 39: Config.ip.ethernet
CLI Commands config.ip.ethernet Syntax ethernet ipAddress gatewayAddress subnetMask Purpose This command sets the Ethernet network settings. Description The Telnet connection can be lost when these Ethernet network settings are changed. If the IP address is reconfigured, your Telnet client must be reconnected to the new IP address.
Page 40: Config.ip.show
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. 2–10 CLI reference guide for directors and edge switches...
Page 41 CLI Commands The IP address. IP Address The gateway address. Gateway Address The subnet mask. Subnet Mask Output Example The output from the config.ip.show command displays as follows: CLI reference guide for directors and edge switches 2–11...
Page 42 CLI Commands IP Address: 10.0.0.0 Gateway Address: 0.0.0.0 Subnet Mask: 255.0.0.0 2–12 CLI reference guide for directors and edge switches...
Page 43: Config.port.blocked
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: Specifies the port number. Valid values are: portNumber 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–144 for the Director 2/140...
Page 44: Config.port.extdist
CLI Commands config.port.extDist Syntax extDist portNumber extDistOn Purpose This command sets the extended distance state for a port. (The Edge Switch 2/24 does not accept this command. Description When the extended distance field is true, the port is configured for 60 buffer credits, which supports a distance of up to 100 km for a 1 gigabits per second (Gbps) port.
Page 45: Config.port.fan
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.
Page 46: Config.port.name
CLI Commands config.port.name Syntax name portNumber “portName” Purpose This command sets the name for a port. Parameters This command has two required parameters: Specifies the port number. Valid values are: portNumber 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–144 for the Director 2/140...
Page 47: Config.port.speed
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.
Page 48: Config.port.type
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/24, a port can also be an Fx_Port or Gx_Port. The port configurations function as follows: •...
Page 49: Command Example
CLI Commands Specifies the type of the port. Valid values are portType eport, fport, and gport, fxport (Edge Switch 2/24 only) gxport (Edge Switch 2/24 only). Command Example Root> config port type 4 fport CLI reference guide for directors and edge switches 2–19...
Page 50: Config.port.show
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: Specifies the port number. Valid values are: portNumber 0–15 for the Edge Switch 2/16 0–23 for the Edge Switch 2/24...
Page 51 CLI Commands The extended distance configuration state. Extended Valid values are true and false. This field is not valid for Distance the Edge Switch 2/24. The fabric address notification (FAN) state. Valid values are true and false. (Edge Switch 2/24 only.) The port type.
Page 52: Config.security.fabricbinding
CLI Commands config.security.fabricBinding Note that the config.security.fabricBinding commands function in a different way from most CLI commands, which are single action commands that take effect immediately. The first Fabric Binding command entered invokes a work-area editor. The commands take effect on a temporary copy of a Fabric Member List in the work area until the temporary copy in the work area is activated to the fabric--or is discarded.
Page 53: Config.security.fabricbinding.clearmemlist
CLI Commands Purpose This command adds a new member to the Fabric Member List in the pending fabric binding work area. The number of entries is limited to the maximum available domain ID's for the fabric (31). NOTE: Changes from this command are not activated to the fabric until the activatePending command is issued.
Page 54: Config.security.fabricbinding.deletemember
CLI Commands config.security.fabricBinding.deleteMember Syntax deleteMember wwn domainId Purpose This command removes a member from the Fabric Member List in the pending fabric binding work area. NOTE: Changes are not activated to the fabric until the activatePending command is issued. Parameters This command has two parameters: Specifies the WWN of the member to be removed from the fabric membership list.
Page 55: Config.security.fabricbinding.setstate
CLI Commands Parameters This command has no parameters: Command Examples Root> config security fabricBinding replacePending config.security.fabricBinding.setState Syntax setState fabricBindingState Purpose This command sets the fabric binding state for the pending fabric binding configuration work area. NOTE: This state is not saved to the fabric until the activatePending command is issued. Parameters This command has one parameter: Specifies the fabric binding state for the pending fabric...
Page 56: Config.security.fabricbinding.showactive
CLI Commands config.security.fabricBinding.showActive Syntax showActive Purpose This command displays the fabric binding configuration saved on the fabric. It performs the same function as show.security.fabricBinding. Parameters This command has no parameters: Output This command displays the following fabric binding configuration data: Fabric Binding State The active fabric binding state: Inactive or Active Restricting...
Page 57 CLI Commands Parameters This command has no parameters. Output The fabric binding configuration data is displayed as a table that includes the following properties: The active fabric binding state: Inactive or Fabric Binding State Active Restricting Fabric Membership ListThe active fabric membership list. Output Example The output from the config.security.fabricBinding.showActive command displays as follows:...
Page 58: Config.security.portbinding
CLI Commands config.security.portBinding 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: Specifies the port number for which the port binding state portNumber is being set. Valid port number values are: 0–15 for the Edge Switch 2/16 0–23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32...
Page 59: Config.security.fabricbinding.wwn
CLI Commands Command Examples Root> config security portBinding bound 4 true Root> config security portBinding bound 4 1 config.security.fabricBinding.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 Specified the port number for which the bound WWN is being set.
Page 60: Config.security.portbinding.show
CLI Commands Specifies the WWN of the device that is being bound to the boundWwn 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.
Page 61 CLI Commands Parameters This command has one parameter: Specifies the port number for which the port binding portNumber configuration will be shown. Valid values are: 0–15 for the Edge Switch 2/16 0–23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64 0–127 and 132–144 for the Director 2/140 Command Example...
Page 62: Config.security.switchbinding
CLI Commands config.security.switchBinding config.security.switchBinding.addMember Syntax addMember wwn Purpose This command adds a new member to the Switch Membership List. A maximum number of 256 members may be added to the Switch membership list. Parameters This command has one parameter: Specifies the Switch or N-Port device WWN of the member to be added to the Switch membership list.
Page 63: Config.security.switchbinding.setstate
CLI Commands Parameters This command has one parameter: Specifies the Switch or N-Port device WWN of the member to be removed from the Switch membership list. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00). The user may also enter all for this argument to clear the Switch membership list completely.
Page 64: Config.security.switchbinding.show
CLI Commands 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 —...
Page 65 CLI Commands Output This command displays the following Switch binding configuration data: Disabled, Enabled and Restricting F_Ports, switchBindingState Enabled and Restricting E_Ports, or Enabled and Restricting All Ports. The Switch membership list saved on the Switch Membership List Switch. Output Example The output from the config.security.portBinding.show command displays as follows: Switch Binding State:...
Page 66: Config.security.userrights
CLI Commands config.security.userRights config.security.userRights.administrator Syntax administrator “username” “password” Purpose This command sets the name and password for administrator-level access. Description Immediately after the name and password for the administrator is set, you will be prompted to log in with the new access rights. Parameters This command has two parameters: Specifies the new user name for administrator-level login.
Page 67: Config.security.userrights.operator
CLI Commands config.security.userRights.operator Syntax operator “username” “password” Purpose This command sets the name and password for operator-level access. Parameters This command has two parameters: Specifies the new user name for operator-level login. username Default is Operator. This parameter is 1–15 characters. Valid characters include all characters in the USASCII character set, excluding control characters and spaces.
Page 68: Config.security.userrights.show
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.
Page 69: Config.snmp.addcommunity
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. Specifies the community to be created or edited. commIndex Valid values are integers in the range 1–6.
Page 70 CLI Commands Command Example Root> config snmp addCommunity 1 “CommunityName1” enabled 123.123.123.123 162 2–40 CLI reference guide for directors and edge switches...
Page 71: Config.snmp.authtraps
CLI Commands 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: Specifies whether the authorization traps are enabled.
Page 72: Config.snmp.deletecommunity
CLI Commands config.snmp.deleteCommunity Syntax deleteCommunity commIndex Purpose This command entirely deletes a community from the SNMP. Parameters This command has one parameter: Specifies the community to be deleted. commIndex Valid values are integers in the range 1–6. This value was set in the commIndex parameter of the config.snmp.addCommunity command.
Page 73: Config.snmp.show
CLI Commands 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. The state of the authorization traps (for example, Authorization enabled) that will be sent to SNMP management...
Page 74: Config.switch Commands
CLI Commands Output Example The output from the config.snmp.show command displays as follows. Authorization Traps: Enabled Index Community Name WriteAuth Trap Recipient UDP Port ----- --------------------- --------- ---------------- ----- CommunityName1 Enabled 123.123.123.123 CommunityName2 Enabled 10.25.25.10 CommunityName3 Disabled 132.44.85.224 public Enabled config.switch Commands All of the config.switch commands, except for the config.switch.show command, require that the Switch be set offline.
Page 75: Config.switch.bbcredit
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: Specifies the new buffer-to-buffer credit value.
Page 76: Config.switch.domainrscn
CLI Commands config.switch.domainRSCN Syntax domainRSCN domainRSCNState Purpose This command sets the domain RSCN state for the Switch. The Switch can be either offline or online when this command is executed. Parameters This command has one parameter: Specifies whether the domain RSCN state is enabled. domainRSCNState Valid values are enable and disable.
Page 77: Config.switch.insistdomainid
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: Specifies whether the insistent domain ID state is insistentDomainIdState enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values.
Page 78: Config.switch.edtov
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.
Page 79: Config.switch.interopmode
CLI Commands config.switch.interopMode Syntax interopMode interopMode Purpose This command sets the interoperability mode for the Switch. The Switch must be offline to complete this command. Description The Switch must be set offline before this command is entered. Parameters This command has one parameter: Specifies the interoperability mode.
Page 80: Config.switch.prefdomainid
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: Specifies the new preferred domain ID value. domainId This parameter must be an integer in the range 1–31.
Page 81: Config.switch.priority
CLI Commands config.switch.priority Syntax priority switchPriority Purpose This command sets the Switch priority. Description The Switch must be set offline before this command is entered. Parameters This command has one parameter: switchPriority Specifies the Switch priority. Valid values are: principal, default, or neverprincipal.
Page 82 CLI Commands Command Example Root> config switch priority principal 2–52 CLI reference guide for directors and edge switches...
Page 83: Config.switch.ratov
CLI Commands config.switch.raTOV Syntax raTOV timeoutValue Purpose This command sets the R_A_TOV for the Switch. Description The Switch must be set offline before this command is entered. Special care should be used when scripting this command due to its relationship with E_D_TOV.
Page 84: Config.switch.reroutedelay
CLI Commands config.switch.rerouteDelay Syntax rerouteDelay rerouteDelayState Purpose This command enables or disables rerouting delay for the Switch. Description The Switch must be set offline before this command is entered. This command is only applicable if the configured Switch is in a multiswitch fabric. Enabling the rerouting delay ensures that frames are delivered in order through the fabric to their destination.
Page 85: Config.switch.speed
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.
Page 86: Config.switch.show
CLI Commands config.switch.show Syntax show Purpose This command shows the Switch configuration. Parameters This command has no parameters. Description This Switch can be either offline or online when this command is executed. Command Example Root> config switch show Output The Switch configuration data is displayed as a table that includes the following properties.
Page 87 CLI Commands The Switch speed. (This parliamentary is not valid for the Speed Edge Switch 2/24.) The rerouting delay that ensures that frames are delivered in Rerouting order through the fabric to their destination. Delay Values are Enabled or Disabled. Interop Mode Interoperability mode for the Switch.
Page 88: Config.system.contact
CLI Commands config.system.contact Syntax contact “systemContact” Purpose This command sets the system contact attribute. Parameters This command has one parameter: Specifies the new system contact string for the systemContact Director or Edge Switch. The contact can contain 0–255 characters. Command Example Root>...
Page 89: Config.system.date
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: Specifies the new system date. sysDate The format of the date parameter must be mm:dd:yyyy or mm/dd/yyyy. Valid date values include: •...
Page 90: Config.system.description
CLI Commands 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. Command Example Root>...
Page 91: Config.system.location
CLI Commands config.system.location Syntax location “systemLocation” Purpose This command sets the system location attribute. Parameters This command has one parameter: Specifies the new system location for the Director or Edge systemLocation Switch. The location can contain 0–255 characters. Command Example Root>...
Page 92: Config.system.name
CLI Commands config.system.name Syntax name “systemName” Purpose This command sets the system name attribute. Parameters This command has one required parameter: Specifies the new system name for the Director or systemName Edge Switch. The name can contain 0–24 characters. Command Example Root>...
Page 93: Config.system.show
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. The system name. Name The system description.
Page 94: Config.zoning Commands
CLI Commands config.zoning Commands Note that the config.zoning commands function in a different way from the other CLI commands, which are single action commands that take effect immediately. 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.
Page 95: Config.zoning.setdefzonestate
CLI Commands config.zoning.setDefZoneState Syntax setDefZoneState defaultZoneState Purpose This command enables or disables the default zone and takes effect immediately fabric wide. Description This command takes effect immediately in the fabric. Parameters This command has one parameter: Specifies whether the default zone is enabled. defaultZoneState Valid values are true and false.
Page 96: Config.zoning.activatezoneset
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>...
Page 97: Config.zoning.deactivatezoneset
CLI Commands config.zoning.deactivateZoneSet Syntax deactivateZoneSet Purpose This command places all attached devices in the default zone and takes effect immediately fabric wide. Description The default zone must be activated independently of this command. NOTE: This command takes effect immediately in the fabric. Parameters This command has no parameters.
Page 98: Config.zoning.replacezoneset
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. Command Example Root> config zoning replaceZoneSet 2–68 CLI reference guide for directors and edge switches...
Page 99: Config.zoning.clearzoneset
CLI Commands config.zoning.clearZoneSet Syntax clearZoneSet Purpose This command clears the zone set contained in the work area, removing all zones, and takes effect immediately. Description This command does not change the zone set name. Parameters This command has no parameters. Command Example Root>...
Page 100: Config.zoning.addzone
CLI Commands config.zoning.addZone Syntax addZone “zoneName” Purpose This command adds a new (empty) zone to the zone set in the work area. Description Changes are not activated on the Switch until the config.zoning.activateZoneSet command is issued. The CLI supports the number of zones per zone set specified for a given product.
Page 101: Config.zoning.deletezone
CLI Commands config.zoning.deleteZone Syntax deleteZone “zoneName” Purpose This command deletes a zone from the zone set in the work area. Description Changes are not activated on the Switch until the config.zoning.activeZoneSet command is issued. Parameters This command has one parameter: zoneName Specifies the name of the zone to be deleted.
Page 102: Config.zoning.renamezoneset
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.
Page 103: Config.zoning.addwwnmem
CLI Commands config.zoning.addWwnMem Syntax addWwnMem “zoneName” wwn Purpose This command adds a World Wide Name zone member to the specified zone in the work area. Description The CLI supports the number of zones members per zone specified for a given product.
Page 104: Config.zoning.addportmem
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.
Page 105: Config.zoning.clearzone
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: Specifies the name of the zone to be cleared. zoneName Command Example Root>...
Page 106: Config.zoning.deletewwnmem
CLI Commands config.zoning.deleteWwnmem Syntax deleteWwnMem “zoneName” wwn Purpose This command removes a WWN member from a zone that is in the work area. Parameters This command has two parameters: Specifies the name of the zone that contains the member to be zoneName deleted.
Page 107: Config.zoning.deleteportmem
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: Specifies the name of the zone that contains the member to be zoneName deleted.
Page 108: Config.zoning.renamezone
CLI Commands config.zoning.renameZone Syntax renameZone “oldZoneName” “newZoneName” Purpose This command renames a zone in the work area. Parameters This command has two parameters: Specifies the current zone name of the zone to be oldZoneName renamed. Specifies the new zone name. The newZoneName newZoneName must contain 1–64 characters.
Page 109: Config.zoning.showpending
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.
Page 110: Config.zoning.showactive
CLI Commands config.zoning.showActive Syntax showActive Purpose This command shows the zoning configuration saved on the fabric. Parameters This command has no parameters. Command Example Root> config zoning showActive Output The zoning configuration data is displayed as a table that includes the following properties.
Page 111: Maint Commands
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).
Page 112: Maint.port.beacon
CLI Commands maint.port.beacon Syntax beacon portNumber beaconState Purpose This command enables or disables port beaconing for a port. Parameters This command has two required parameters: Specifies the port number. portNumber Valid values are: 0–15 for the Edge Switch 2/16 0–23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64 0–127 and 132–144 for the Director 2/140...
Page 113: Maint.port.reset
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.
Page 114: Maint.system.beacon
CLI Commands maint.system.beacon Syntax beacon beaconState Purpose This command enables or disables unit beaconing. Parameters This command has one parameter: Specifies whether unit beaconing is enabled. beaconState Valid values are true and false. Boolean 1 and 0 may be substituted as values. Command Examples Root>...
Page 115: Maint.system.clearsyserror
CLI Commands maint.system.clearSysError Syntax clearSysError Purpose This command clears the system error light. Parameters This command has no parameters. Command Example Root> maint system clearSysError CLI reference guide for directors and edge switches 2–85...
Page 116: Maint.system.ipi
CLI Commands maint.system.ipi Syntax 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. Command Example Root> maint system ipl 2–86 CLI reference guide for directors and edge switches...
Page 117: Maint.system.resetconfig
CLI Commands maint.system.resetConfig Syntax resetConfig Purpose This command resets all NV-RAM configuration parameters to their default values, including feature keys and IP addresses. Description This command IPLs the Switch. Connection from the CLI to the Switch is lost when this command runs. NOTE: This command resets all configuration data and non-volatile settings, including network information, to their default values (factory settings).
Page 118: Maint.system.setonlinestate
CLI Commands maint.system.setOnlineState Syntax setOnlineState onlineState Purpose This command sets the Switch online or offline. Parameters This command has one parameter: Specifies whether the Switch is online. onlineState Valid values are true and false. Boolean 1 and 0 may be substituted as values. Command Examples Root>...
Page 119: Perf Commands
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.
Page 120: Perf.class2
CLI Commands perf.class2 Syntax class2 portNumber Purpose This command displays port Class 2 counters for a single port. Parameters This command has one parameter: Specifies the port number. portNumber Valid values are: 0–15 for the Edge Switch 2/16 0–23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64 0–127 and 132–144 for the Director 2/140...
Page 121 CLI Commands The number of Class 2 4-byte words within frames that the port has TxWords 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.
Page 122: Perf.class3
CLI Commands perf.class3 Syntax class3 portNumber Purpose This command displays port Class 3 counters for a single ports. Parameters This command has one parameter: Specifies the port number. portNumber Valid values are: 0–15 for the Edge Switch 2/16 0–23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64 0–127 and 132–144 for the Director 2/140...
Page 123 CLI Commands TxWords The number of Class 3 4-byte words within frames that the port has transmitted. The number of Class 3 frames that have been discarded upon receipt by Disc this port. Frames There are no FBSYs (Fabric Busy link response) or FRJTs (Frame Reject link response) generated for Class 3 frames.
Page 124: Perf.clearstats
CLI Commands perf.clearStats Syntax clearStats portNumber Purpose This command resets all port statistics for an individual port or for all ports. Parameters This command has one parameter: Specifies the port number. portNumber Valid values are: 0–15 for the Edge Switch 2/16 0–23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64...
Page 125: Perf.errors
CLI Commands perf.errors Syntax errors portNumber Purpose This command displays port error counters for a single port. Parameters This command has one parameter: Specifies the port number. portNumber Valid values are: 0–15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64 0–127 and 132–144 for the Director 2/140...
Page 126 CLI Commands The number of 10-bit transmission words that the port is Inv Tx Wrds unable to map to 8-bit bytes because of disparity errors or misaligned K characters while in the OL2 or OL3 state. The number of frame CRC errors detected by the port. CRC Errs The number of invalid frame delimiters (SOF or EOF) Dlim Errs...
Page 127: Perf.link
CLI Commands perf.link Syntax link portNumber Purpose This command displays port link counters for a single ports. Parameters This command has one parameter: Specifies the port number. portNumber Valid values are: 0–15 for the Edge Switch 2/16 0-23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64 0–127 and 132–144 for the Director 2/140...
Page 128 CLI Commands The number of times the port has detected a link error resulting LIPS Out from an invalid link state transition or timeout. The number of times the port has detected a link error resulting Link Flrs from an invalid link state transition or timeout. Sync Losses The number of times the port has detected a loss of synchronization timeout while not in an offline or LF2 state.
Page 129: Perf.traffic
CLI Commands perf.traffic Syntax traffic portNumber Purpose This command displays port traffic counters for a single port. Parameters This command has one parameter: Specifies the port number. portNumber Valid values are: 0–15 for the Edge Switch 2/16 0–23 for the Edge Switch 2/24 0–31 for the Edge Switch 2/32 0–63 for the Director 2/64 0–127 and 132–144 for the Director 2/140...
Page 130 CLI Commands The number of 4-byte words in Class 2 and Class 3 frames that the RxWords port has received. The number of 4-byte words in Class 2 and Class 3 frames that the TxWords port has transmitted. Output Example The output from the perf.traffic command displays as follows.
Page 131: Show Commands
CLI Commands show Commands The show branch of the CLI command tree contains commands that display, but do not change, stored data values. The displayed output that results from these commands is not necessarily identical with the output from the show commands that are within the other CLI command tree branches, for example, config.port.show.
Page 132: Show.eventlog
CLI Commands show.eventLog Syntax eventLog Purpose This command shows the contents of the event log as maintained in NV-RAM on the Director or Edge Switch. Parameters This command has no parameters. Command Example Root> show eventLog Output The event log data are displayed as a table that includes the following properties: The date and time when the event occurred.
Page 133 CLI Commands Output Example The output from the show.eventLog command displays as follows. Date/Time Code Severity Event Data -------------- ---- ------- ----- --------------------------------- 04/12/01 10:58A Major CTP-0 00010203 04050607 08090A0B 0C0D0E0F 04/12/01 9:58A Severe CTP-0 00010203 04050607 08090A0B 0C0D0E0F 04/11/01 7:18P Severe CTP-0...
Page 134: Show.features
CLI Commands show.features Syntax features Purpose This command displays a table of all installed feature sets and their states. The output is exactly the same as the output to the config.features.show command. Parameters This command has no parameters. Command Example Root>...
Page 135: Show.frus
CLI Commands show.frus Syntax frus Purpose This command displays information about all FRUs. Parameters This command has no parameters. Command Example Root> show frus Output The FRU information is displayed as a table that includes the following properties: The FRU name. •...
Page 136 CLI Commands The beaconing state of the FRU (on or off). Beaconing The power-on hours value for the FRU. Pwr On Hrs Output Example The output from the show.frus command displays as follows. Position State Serial Num Part Num Beacon Pwr On Hrs -------- -------- ------...
Page 137: Show.ip.ethernet
CLI Commands 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 is displayed as a table that includes the following properties: The IP address for the Ethernet adapter as set in the IP Address config.ip.ethernet command.
Page 138: Show.login.server
CLI Commands show.login.server 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.
Page 139 CLI Commands Output Example The output from the show.loginServer command displays as follows. Port BB Crdt RxFldSz Port Name Node Name ---- ------- ------- ----------------------- ---------------------- 2,3 00:11:22:33:44:55:00:77 20:11:22:33:44:55:66:77 00:11:22:33:44:55:00:78 20:11:22:33:44:55:66:78 2,3 00:11:22:33:44:55:00:79 20:11:22:33:44:55:66:79 2,3 00:11:22:33:44:55:00:80 20:11:22:33:44:55:66:80 00:11:22:33:44:55:00:81 20:11:22:33:44:55:66:81 2,3 00:11:22:33:44:55:00:82 20:11:22:33:44:55:66:82 2,3 00:11:22:33:44:55:00:83 20:11:22:33:44:55:66:83 00:11:22:33:44:55:00:84 20:11:22:33:44:55:66:84 2,3 00:11:22:33:44:55:00:85 20:11:22:33:44:55:66:85...
Page 140: Show.nameserver
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.
Page 141 CLI Commands Output Example The output from the show.nameServer command displays as follows. Type Port Id Port Name Node Name FC4 Types ---- ------- ----------------------- ----------------------- --------- 010400 00:11:22:33:44:55:66:77 20:11:22:33:44:55:66:77 010500 00:11:22:33:44:55:66:78 20:11:22:33:44:55:66:78 010600 00:11:22:33:44:55:66:79 20:11:22:33:44:55:66:79 010700 00:11:22:33:44:55:66:80 20:11:22:33:44:55:66:80 010800 00:11:22:33:44:55:66:81 20:11:22:33:44:55:66:81 010900...
Page 142: Show.nameserverext
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.
Page 143 CLI Commands 255-character representation of the Symbolic Node Name. SymNodeName 255-character representation of the Symbolic Port Name. SymPortName Output Example The output from the show.nameServerExt command displays as follows. Type, Port Id, Port Name, Node Name, COS, FC4 Types, SymNodeName, SymPortName, 010400, 00:11:22:33:44:55:00:77, 20:11:22:33:44:55:66:77, 2-3, 2, Node Name A, Port Name A,...
Page 144: Show.port.config
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: The port number.
Page 145 CLI Commands Output Example The output from the show.port.config command displays as follows. Port Name Blocked Ext Dist Type Speed ---- ------------------------ ------- -------- ----- --------- Port 1 false false fPort 1 Gb/sec Port 2 true true fPort 1 Gb/sec Port 3 false false...
Page 146: Show.port.info
CLI Commands show.port.info Syntax info Purpose This command displays port information for all ports. Parameters This command has no parameters. Command Example Root> show port info Output The port information data is displayed as a table that includes the following properties: The port number.
Page 147 CLI Commands Output Example The output from the show.port.info command displays as follows. Port OpSpeed SpeedCap ---- ----------------------- -------- -------- 10:00:80:00:11:22:33:44 1 Gb/sec 2 Gb/sec 10:00:80:01:11:22:33:44 1 Gb/sec 2 Gb/sec 10:00:80:02:11:22:33:44 1 Gb/sec 2 Gb/sec 10:00:80:03:11:22:33:44 1 Gb/sec 2 Gb/sec 10:00:80:04:11:22:33:44 2 Gb/sec 2 Gb/sec...
Page 148: Show.port.nodes
CLI Commands show.port.nodes Syntax nodes portNumber Purpose This command displays the loop node list for a specified port. This command is valid only on the Edge Switch 2/24. Parameters This command has one parameter. Specifies the port number. portNumber Valid values are: 0–23 for the Edge Switch 2/24 Command Example Root>...
Page 149 CLI Commands Output Example The Data Field Size value for public devices. This field is left blank for private devices. FC Addr Attached WWN Class Data Field Size ------- ----------------------- ----- --------------- 610A01 33:00:00:00:00:00:00:03 2112 610A02 33:00:00:00:00:00:00:04 2112 610A04 33:00:00:00:00:00:00:05 2112 610A08 33:00:00:00:00:00:00:02...
Page 150: Show.port.status
CLI Commands show.port.status Syntax status Purpose This command displays port status for all ports. Parameters This command has no parameters. Command Example Root> show port status Output The port status data is displayed as a table that includes the following properties: The port number.
Page 151 CLI Commands The operational port type. 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.
Page 152 CLI Commands If the operational state is Invalid Attachment only the following messages can be generated: • 08 None • 09 Unknown • 10 ISL connection not allowed on this port • 11 ELP rejected by the attached Switch • 12 Incompatible Switch at other end of the ISL •...
Page 153 CLI Commands Output Example The output from the show.port.status command displays as follows. Port State Type Attached WWN Beaconing Reason ---- ---------------- ----- ----------------------- --------- ------ Online fPort 10:00:80:00:11:22:33:44 Online gPort 10:00:80:00:11:22:33:45 No Light fPort 10:00:80:00:11:22:33:55 Offline ePort 10:00:80:00:11:22:33:00 Online gPort 10:00:80:00:11:22:33:57 Port Failure...
Page 154: Show.port.technology
CLI Commands show.port.technology Syntax technology Purpose This command shows the port technology information for all ports. Parameters This command has no parameters. Command Example Root> show port technology Output The port technology data is displayed as a table that includes the following properties: The port number.
Page 155 CLI Commands Output Example The output from the show.port.technology command displays as follows: Port Connectr Transcvr Distance Media ---- -------- --------- ------------ ----------- Long LC Long M-M 50um Long LC Long M-M 50um Long LC Long M-M 50um MT_RJ Long LC Long M-M 50um MT_RJ...
Page 156: Show.security.fabricbinding
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. Command Example Root> show security fabricBinding Output The fabric binding configuration data is displayed as a table that includes the following properties: The active fabric binding state: Inactive or Fabric Binding State...
Page 157: Show.security.portbinding
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: The port number.
Page 158 CLI Commands Output Example The output from the show.security.portBinding command displays as follows: Port WWN Binding Bound WWN ---- ----------- ----------------------- Active AA:00:AA:00:AA:00:AA:00 Inactive 00:00:00:00:00:00:00:00 Inactive CC:33:44:55:CC:33:44:55 Active 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00 Inactive 00:00:00:00:00:00:00:00...
Page 159: Show.security.switchbinding
CLI Commands show.security.switchBinding Syntax switchBinding Purpose This command displays the Switch binding configuration. Parameters This command has no parameters. Command Example Root> show security switchBinding Output The Switch binding configuration data is displayed as a table that includes the following properties: Switch Binding State Disabled, Enabled and Restricting F_Ports,...
Page 160: Show.switch
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: The state of the Switch. For example: State •...
Page 161 CLI Commands The rerouting delay as set in the Rerouting config.switch.rerouteDelay command. Delay The operating mode (Open Systems or S/390). Operating Mode This attribute cannot be configured through the command line interface. Interop Mode The interoperability mode as set in the config.switch.interopMode command.
Page 162: Show.system
CLI Commands 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: The system name as set in the config.system.name Name command.
Page 163 CLI Commands The current firmware version installed. Firmware Version The enabled state of unit beaconing (enabled or disabled) as Beaconing set in the maint.system.beacon command. Output Example The output from the show.system command displays as follows. System Information Name: hp3 director Description: hp StorageWorks director 2/64 Contact:...
Page 164: Show.zoning
CLI Commands 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: The enabled status, name, and member zones of Active...
Page 165: Error Messages
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.
Page 166 Error Messages Message Description Action Error 10: Invalid Switch The value entered for the The location for the Location Switch location is invalid. Director or Edge Switch can contain 0–255 characters. Enter a location with 0–255 characters. If spaces are used, enclose the location in quotation marks.
Page 167 Error Messages Message Description Action Error 14: Invalid Port The value entered for the The port name for the Name port name is invalid. individual port can contain 0–24 characters. Enter a name with 0–24 characters. If spaces are used, enclose the name in quotation marks.
Page 168 Error Messages Message Description Action Error 18: Invalid TOV The E_D_TOV and Enter a valid R_A_TOV values are not E_D_TOV/R_A_TOV compatible. combination. The E_D_TOV must be smaller than the R_A_TOV. Error 20: Invalid The value entered for the The preferred domain ID Preferred Domain ID preferred domain ID for the must be an integer in the...
Page 169 Error Messages Message Description Action Error 31: Invalid Subnet The value entered for the The subnet mask must Mask new subnet mask for the be entered in dotted Ethernet interface is invalid. decimal format (for example, 255.0.0.0). Enter the subnet mask for the Ethernet interface in dotted decimal format.
Page 170 Error Messages Message Description Action Error 34: Duplicate The two or more entered Enter different values for Community Names community names are the community names, or Require Identical Write identical, but their enter identical write Authorization corresponding write authorizations for the authorizations are not duplicate community identical.
Page 171 Error Messages Message Description Action Error 41: Invalid Minute The value of the minute The format of the time entered for the new system parameter must be time is invalid. hh:mm:ss. The minute must contain an integer in the range 0–59. Enter a time, including minutes in the range 0–59.
Page 172 Error Messages Message Description Action Error 57: Duplicate Two or more zone names in All zone names within a Zone the zone set are identical. zone set must be unique. Enter a zone name that does not duplicate the name of another zone within the zone set.
Page 173 Error Messages Message Description Action Error 62: Invalid Zone The value entered for the The zone set name must Set Name zone set name is invalid. contain 1–64 characters. Valid characters are ABCDEFGHIJKLMNOP QRSTUVWXYZabcdefgh ijklmnopqrstuvwxyz0123 456789$-^_ (spaces are not permitted, and the first character must be alphabetical).
Page 174 Error Messages Message Description Action Error 73: Port Not The specified port is not Refer to the product Installed installed on the product. service manual for information about installing a port optic. Error 74: Invalid The specified zone set The zone set must Number of Zones contains less than one zone contain at least one...
Page 175 Error Messages Message Description Action Error 81: Default Zone The request cannot be Disable the default zone Enabled completed because the before reentering the default zone is enabled. command. Error 82: Invalid Interop The value entered for the The interoperability Mode interoperability mode is not mode for the Director or...
Page 176 Error Messages Message Description Action Error 89: Not Allowed in This procedure is not The entered command is S/390 Mode Without allowed in S/390 mode. only supported when the the SANtegrity™ product is in Open Feature Systems mode. The product cannot be taken out of S/390 mode through the CLI.
Page 177 Error Messages Message Description Action Error 101: Command This product does not Information only Not Supported on This support the specified message: this operation Product command. is not supported. Error 102: Switch Not The request cannot be Refer to the product Operational completed because the service manual, and...
Page 178 Error Messages Message Description Action Error 119: Switch This request cannot be The Switch speed must Speed Not 2 Gb/sec completed because the be set to 2 Gbps in order Switch speed has no been to accommodate a port set to 2 Gbps. speed of 2 Gbps.
Page 179 Error Messages Message Description Action Error 138: Invalid The Switch binding state The Switch binding state Switch Binding State submitted is not recognized must be set to one of the by the CLI. following: disable, erestrict, frestrict, or allrestrict. For more information, see config.security.switchBi nding on page 2-32...
Page 180 Error Messages Message Description Action Error 143: Domain The user attempted to Domain RSCN's must RSCNs Must Be disable domain RSCN's remain enabled while the Enabled When while Enterprise Fabric Enterprise Fabric mode Enterprise Fabric Mode mode was active. is active. If Enterprise Active Fabric mode is set to inactive, the domain...
Page 181 Error Messages Message Description Action Error 151: Invalid Open The request cannot be The OSMS state may be Systems Management completed because the set to either enable or Server State OSMS state submitted is disable. For more invalid. information, see config.features.OpenSys MS on page 2-6 Error 152: Invalid...
Page 182 Error Messages Message Description Action Error 155: Cannot This member cannot be Fabric security rules Remove Active removed from the fabric prohibit any device or Member From List security list because it is Switch from being currently logged in. isolated from the fabric via a membership list change.
Page 183 Error Messages Message Description Action Error 203: Another Another user is currently Check that all the Client Has Change making changes to this parameters are correct, Authorization Switch. and reenter the command. Error 207: Change The Switch did not accept Check that all the Request Failed the request.
Page 184 Error Messages Message Description Action Error 212: Duplicate The entered command tried No action required Zone Member to add a member that already exists in the zone. Error 213: Number of A zone set must have at Zones Is Zero least one zone to be a config.zoning.activa teZoneSet command tried...
Page 185 Error Messages Message Description Action Error 218: Invalid Port The value specified for the Enter a port number Number port number is invalid. within the range supported by the Director or Edge Switch. Valid values are: • 0–15 for the Edge Switch 2/16 •...
Page 186 Error Messages Message Description Action Chapter 2 Error 224: Invalid The values entered for one Refer to Argument or more parameters of the information about the command are invalid. For commands and their example, a letter may have parameters. Check that been entered where an all values for the integer is required.
Page 187 Error Messages Message Description Action Error 228: Invalid Write Parameters must be Authorization Argument typed exactly to writeAuthorization parameter does not contain specification to be a valid value. recognized correctly by the CLI. For more information, see config.snmp.addCommu nity on page 2-39 Error 229: Invalid UDP The udpPortNum Parameters must be...
Page 188 Error Messages Message Description Action Chapter 2 Error 232: Invalid The value specified for the Refer to Domain ID domainId parameter is information about the invalid. For example, the commands with the domainId parameter of the domainId parameter. Specify a valid domain ID config.switch.prefDo mainId command requires value, and resubmit the...
Page 189 Error Messages Message Description Action Using the Error 235: The CLI does not recognize Refer to Command Line Interface Unrecognized the submitted command Help on page 1-14 Command and cannot perform the help (?) command as information about the requested. help command.
Page 190 Error Messages Message Description Action Error 238: Invalid The specified feature key is Check that the feature Feature Key invalid. 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...
Page 191 Error Messages Message Description Action Error 242: Open An invalid threshold The Open trunking trunking threshold % percentage has been threshold must be in the value must be 0–99 entered. range 0–99. Make sure all values are valid and resubmit the request. Error 243: Not allowed This operation is not This command is not...
Page 193: Glossary
Glossary This glossary defines terms used in this guide or related to this product and is not a comprehensive glossary of computer terms. access control Method of control (with associated permissions) by which a set of devices can access other devices across a network.
Page 194 Glossary beaconing Use of light-emitting diodes on ports, port cards, field-replaceable units, Directors, and Edge Switches to aid in the fault-isolation process; when enabled, active beaconing causes LEDs to flash for selected components. BB_Credit See buffer-to-buffer credit. See bit error rate. bidirectional In Fibre Channel, the capability to simultaneously communicate at maximum speeds (100 Mbps) in both directions over a link.
Page 195 Glossary class of Fibre Channel service Defines the level of connection dedication, acknowledgment, and other characteristics of a connection. Class F Fibre Channel service Used by Switches to communicate across interswitch links (ISLs) to configure, control, and coordinate a multiswitch fabric. Class 2 Fibre Channel service Provides a connectionless (not dedicated) service with notification of delivery or nondelivery between two N_Ports.
Page 196 Glossary See cyclic redundancy check. CTP card See control processor card. cyclic redundancy check (CRC) System of error checking performed at both the sending and receiving station using the value of a particular character generated by a cyclic algorithm. When the values generated at each station are identical, data integrity is confirmed.
Page 197 Glossary domain ID Number (1 through 31) that uniquely identifies a Switch in a multiswitch fabric. A distinct domain ID is automatically allocated to each Switch in the fabric by the principal Switch. domain name service (DNS) See DNS name. E_D_TOV See error detect time-out value.
Page 198 Glossary fabric Fibre Channel entity that interconnects node ports (N_Ports_ and is capable of routing (switching) Fibre Channel frames using the destination ID information in the Fibre Channel frame header accompanying the frames. fabric element An active Director, Switch, or node in a Fibre Channel switched fabric. fabric port (F_Port) Physical interface on a Director or Edge Switch that connects to an N_Port through a point-to-point full duplex connection.
Page 199 Glossary F_Port See fabric port. FL_Port Edge Switch 2/24 supports the operation of Arbitrated Loop. FX_Port A port configuration allowing a port to transition operationally to either an F_Port or an FL_Port. Only the Edge Switch 2/24 supports the configuration of this port type. See field-replaceable unit.
Page 200 Glossary See host bus adapter. heterogeneous fabric A fabric with both HP and non-HP products. high availability A performance feature characterized by hardware component redundancy and hot-swapability (enabling non-disruptive maintenance). High-availability systems maximize system uptime while providing superior reliability, availability, and serviceability. Data transfer from one fabric node to another node.
Page 201 Glossary interface Hardware, software, or both, linking systems, programs, or devices. internet protocol address Unique string of numbers (in the format xxx.xxx.xxx.xxx) that identifies a device on a network. interoperability Ability to communicate, execute programs, or transfer data between various functional units over a network.
Page 202 Glossary loopback plug In a fiber optic environment, a type of duplex connector used to wrap the optical output signal of a device directly to the optical input. loopback test Test that checks attachment or control unit circuitry, without checking the mechanism itself, by returning the output of the mechanism as input.
Page 203 Glossary name server Program that translates names from one form into another. For example, the domain name service (DNS) translates domain names into IP addresses. name server zoning N_Port access management that allows N_Ports to communicate if and only if they belong to a common name server zone.
Page 204 Glossary operating state (Director) The operating states are as follows: Online - when the Director is set online, an attached device can log in to the Director if the port is not blocked. Attached devices can communicate with each other if they are configured in the same zone.
Page 205 Glossary port card Field-replaceable hardware component that provides the port connections for fiber cables and performs specific device-dependent logic functions. port card map Map showing numbers assigned to each port card by card slot. port name Name that the user assigns to a particular port through the Product Manager. POST See power-on self test.
Page 206 Glossary remote user workstation Workstation, such as a PC, using the HAFM and Product Manager applications that can access the HAFM server over a LAN connection. resource allocation time-out value (R_A_TOV) User-specified value used to time out operations that depend on the maximum possible time that a frame could be delayed in a fabric and still be delivered.
Page 207 Glossary SNMP community name The name assigned to a given SNMP community. Queries from an SNMP management station to a device running an SNMP agent will only elicit a response if those queries are addressed with the correct SNMP community name. storage area network (SAN) A high-performance data communications environment that interconnects computing and storage resources so that the resources can be effectively shared and consolidated.
Page 208 trunk cable Cable consisting of multiple fiber pairs that do not directly attach to an active device. This cable usually exists between distribution panels. See also optical cable, contrast with jumper cable. unblocked port Devices attached to an unblocked port can login to the Director or Edge Switch and communicate with devices attached to any other unblocked port.
Page 209 Glossary zone set See zone. zoning Grouping of several devices by function or by location. All devices connected to a connectivity product, such as the Director or Edge Switch, may be configured into one or more zones. See also zone. CLI reference guide for directors and edge switches Glossary–17...
Page 211: Index
Index config.security.userRights.show 2–38 config.snmp.addCommunity 2–39 case sensitivity config.snmp.authTraps 2–41 CLI commands 1–2 config.snmp.show 2–43 CLI commands config.switch.bbCredit 2–45 case sensitivity 1–2 config.switch.domainRSCN 2–46 commaDelim 1–13 config.switch.edTOV 2–48 command tree 1–4 config.switch.insistDomainId 2–47 config.features.enterpriseFabMode 2–3 config.switch.interopMode 2–49 config.features.ficonms 2–4 config.switch.prefDomainId 2–50 config.features.installKey 2–5 config.switch.priority 2–51 config.features.OpenSysMS 2–6...
Page 212 Index config.zoning.setDefZoneState 2–65 show.system 2–132 config.zoning.showActive 2–80 show.zoning 2–134 config.zoning.showPending 2–79 command line interface handling errors 1–14 command overview 2–1 logging in or out 1–10 command tree 1–4 login 1–11 handling errors 1–14 logout 1–12 help 1–14 maint.port.beacon 2–82 logging in or out 1–10 maint.port.reset 2–83 output 1–10 maint.system.beacon 2–84...
Page 213 Index Fabric Binding membership list active configuration fabric 2–23 2–24 show 2–26 pending configuration navigation conventions 1–2 activate 2–22 null strings 1–10 replace 2–24 show 2–26 fabric binding SANtegrity membership list 2–23 2–24 Enterprise Fabric mode 2–3 state 2–25 Switch Binding fabric membership list add new member 2–32 add 2–23...

This manual is also suitable for:

Storageworks 2/24 - edge switch

HP 316095-B21 - StorageWorks Edge Switch 2/24 Reference Manual

About this Guide

1 Introduction

151 CLI Commands

Error Messages

Glossary

Index

Quick Links

edge switches

Related Manuals for HP 316095-B21 - StorageWorks Edge Switch 2/24

Summary of Contents for HP 316095-B21 - StorageWorks Edge Switch 2/24

This manual is also suitable for:

Table of Contents