McDATA OPENconnectors Command Line Interface USER MANUAL P/N 620-000134-500 REV B McDATA Corporation 380 Interlocken Crescent Broomfield, CO 80021-3464 Corporate Headquarters: 800.545.5773 Web: www.mcdata.com Sales E-mail: sales@mcdata.
Record of Revisions and Updates Revision Date Description 620-000134-000 11/2001 Initial release of Manual 620-000134-100 05/2002 Updates for E/OS 2.0 620-000134-200 08/2002 Updates for E/OS 3.0 620-000134-300 09/2002 Updates for E/OS 4.0 620-000134-400 10/2002 Updates for E/OS 4.1 620-000134-500 10/2002 Updates for E/OS 4.1 CD-ROM final Copyright © 2002 McDATA Corporation. All rights reserved.
Contents Preface ............................................................................................................................ix Chapter 1 Introduction Command Line Interface Overview...............................................1-2 Entering Command Line Interface Commands ...........................1-3 Documentation Conventions ...................................................1-3 Navigation Conventions...........................................................1-3 Command Tree...........
Contents Chapter 2 CLI Commands Command Overview........................................................................2-2 config ..................................................................................................2-2 config.features.enterpriseFabMode ........................................2-3 config.features.ficonms.............................................................2-3 config.features.installKey.........................................................2-4 config.features.
Contents config.zoning ........................................................................... 2-44 config.zoning.setDefZoneState ............................................. 2-44 config.zoning.activateZoneSet .............................................. 2-45 config.zoning.deactivateZoneSet.......................................... 2-45 config.zoning.replaceZoneSet ............................................... 2-46 config.zoning.clearZoneSet ...................................................
Contents show.port.status.......................................................................2-79 show.port.technology .............................................................2-82 show.security.fabricBinding ..................................................2-83 show.security.portBinding.....................................................2-84 show.security.switchBinding.................................................2-85 show.switch ................................................................
Tables 1-1 1-2 1-3 P/N 620-000134-500 CLI Command Tree Navigation Conventions .......................................... 1-3 CLI Command Tree ...................................................................................... 1-5 CLI Command Tree for the ED-5000 Director ........................................
Tables viii McDATA OPENconnectors Command Line Interface USER MANUAL P/N 620-000134-500
3UHIDFH This publication is part of the documentation suite that supports the McDATA® Sphereon™ 3016 Fabric Switch, Sphereon 3032 Fabric Switch, Sphereon 3216 Fabric Switch, Sphereon 3232 Fabric Switch, Sphereon 4500 Fabric Switch, Intrepid™ 6064 Director, and Intrepid 6140 Director.
Preface • McDATA products in the user’s network The publications listed in Related Publications provide considerable information about both concepts and McDATA products. Organization of This Manual This publication is organized as follows: Chapter 1, Introduction, provides an introduction and overview of the Command Line Interface.
Preface P/N 620-000134-500 • McDATA Intrepid 6140 Director Installation and Service Manual (620-000157) • McDATA OPENconnectors SNMP Support Manual (620-000131) • McDATA SANpilot User Manual (620-000160) • McDATA Sphereon 3016 and 3216 Fabric Switch Product Manager User Manual (620-000151) • McDATA Sphereon 3016 Switch Installation and Service Manual (620-000112) • McDATA Sphereon 3016 Switch Product Manager User Manual (620-000121) • McDATA Sphereon 3032 and 3232 Fabric Switch Product Manage
Preface Manual Conventions The following notational conventions are used in this document: Convention Meaning Bold Keyboard keys, buttons and switches on hardware products, and screen prompts for the Command Line Interface. Italic Outside book references, names of user interface windows, buttons, and dialog boxes. Monospaced Command syntax, examples of commands, output. A note presents important information that is not hazard-related.
Preface Forwarding Publication Comments We sincerely appreciate any comments about this publication. Did you find this manual easy or difficult to use? Did it lack necessary information? Were there any errors? Could its organization be improved? Please send your comments via e-mail, our home page, or FAX. Identify the manual, and provide page numbers and specific detail. Thank you. Ordering Publications ❏ E-mail: ❏ Home Page: http://www.mcdata.com ❏ Fax: pubsmgr@mcdata.
Preface xiv McDATA OPENconnectors Command Line Interface USER MANUAL P/N 620-000134-500
,QWURGXFWLRQ This chapter introduces the Command Line Interface (CLI) and describes the essentials for using the CLI commands.
Introduction 1 &RPPDQG /LQH ,QWHUIDFH 2YHUYLHZ The Command Line Interface (CLI) is a feature that provides an alternative to McDATA’s Enterprise Fabric Connectivity Manager (EFCM) and SANpilot 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 switch.
Introduction 1 (QWHULQJ &RPPDQG /LQH ,QWHUIDFH &RPPDQGV The CLI commands can be entered directly at the command line of a terminal or coded in a script. Note that the CLI commands are not case sensitive. 'RFXPHQWDWLRQ &RQYHQWLRQV Throughout this publication, periods are used to separate the components of a command name. However, the periods cannot be included when the command is actually entered at the terminal or coded in a script.
Introduction 1 Table 1-1 1-4 CLI Command Tree Navigation Conventions (continued) Character Sequence Common Name Action or Description ^B Control-B Position the cursor left one character. ^D Control-D Delete the current character. ^E Control-E Position the cursor to the end of the line. ^F Control-F Position the cursor right one character. ^H Control-H Backspace one character and delete the character. ^I Tab Complete the current keyword. ^K Control-K Delete to the end of the line.
Introduction 1 &RPPDQG 7UHH 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, CLI Commands. There are three additional commands (login, logout, and commaDelim) that are globally available commands. These commands are described in this chapter. The hierarchy from the root, reading from left to right, is as follows.
Introduction 1 Table 1-2 CLI Command Tree (continued) show userRights -------------- administrator operator show snmp --------------------- addCommunity authTraps deleteCommunity show switch -------------------- bbCredit domainRSCN edTOV insistDomainId interopMode prefDomainId priority raTOV rerouteDelay speed show system ------------------ contact date description location name show zoning ------------------- setDefZoneState activateZoneSet deactivateZoneSet replaceZoneSet clearZoneSet addZone deleteZone
Introduction 1 Table 1-2 CLI Command Tree (continued) deleteWwnMem deletePortMem renameZone showPending showActive maint --------------------- port ----------------------- beacon reset system ------------------ beacon clearSysError ipl resetConfig setOnlineState perf ----------------------- class2 class3 clearStats errors link traffic show --------------------- eventLog features frus ip -------------------------- ethernet loginServer nameServer nameServerExt port ----------------------- config info nodes
Introduction 1 Note that the 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, CLI Command Tree, on page 1-5 for the zoning commands is a typical order in which the zoning commands are entered. Note that the order in which commands are entered determines the order in which the show commands display the values.
Introduction 1 Maint> port Maint.Port> beacon 4 true Another approach to making the navigation more concise is to use the complete command syntax from the Root> prompt each time. For example, to issue the config.port.name command and then the maint.port.
Introduction 1 3DUDPHWHUV Some command parameters accept character strings that include spaces. Quotation marks are required when a string includes spaces. Config.System> location Building_24_Room_16 Config.System> location "Building 24 Room 16" If spaces are not included in a parameter that accepts a string, the quotation marks are not required around that string. To include quotation marks in a string, use the escape character (\) before the quotation marks. Config.
Introduction 1 /RJJLQJ ,Q DQG /RJJLQJ 2XW The CLI allows a single Telnet client to be connected to the switch. If a Telnet client logs out, or if after 15 minutes of inactivity the client’s access times out, another Telnet client may log in. Also note that the Telnet client (user) must log in any time the director or switch is restarted because the current user’s access is lost. Examples of a restart include an IPL and any power-off situation.
Introduction 1 The access rights chosen for the CLI are completely independent of the other product interfaces, for example, SNMP or McDATA product interfaces. 3DUDPHWHUV &RPPDQG ([DPSOHV This command has no parameters. login Username: Administrator Password: password login Username: Operator Password: password ORJRXW 6\QWD[ logout 3XUSRVH This command allows a Telnet client to disconnect from the switch. 'HVFULSWLRQ This command logs out the single Telnet client connected to the switch.
Introduction 1 8VLQJ WKH FRPPD'HOLP &RPPDQG Note that the output examples shown in the other sections of this publication presume that commaDelim is off. FRPPD'HOLP 6\QWD[ 3XUSRVH 'HVFULSWLRQ 3DUDPHWHU commaDelim enable This command enables the user to obtain displayed information in comma-delimited, rather than tabular, format. Tabular format is the default. This command can be entered at any point in the command tree.
Introduction 1 +DQGOLQJ &RPPDQG /LQH ,QWHUIDFH (UURUV 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 fabric or switch issues. For example, a parameter error is detected by the switch, where port 24 is entered for a switch that supports only 16 ports.
Introduction 1 8VLQJ WKH &RPPDQG /LQH ,QWHUIDFH +HOS 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 1 &RPPHQWLQJ 6FULSWV 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.
Introduction 1 (' 'LUHFWRU A subset of the CLI commands described in this publication are available on the ED-5000 Director™. The globally available commands (login, logout, and commaDelim) are described previously in this chapter. The following config, maint, and show commands are described in Chapter 2, CLI Commands.
Introduction 1 7HOQHW 6HVVLRQ The CLI can only be used through a Telnet client session in an out-of-band management environment, using the Ethernet port in the director or switch. Although the primary use of the CLI is in host-based scripting environments, the CLI commands can also be entered directly at a command line. Any hardware platform that supports the Telnet client software can be used.
&/, &RPPDQGV This chapter describes the 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 2 &RPPDQG 2YHUYLHZ 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 to verify configuration changes.
CLI Commands 2 FRQILJ IHDWXUHV HQWHUSULVH)DE0RGH 6\QWD[ 3XUSRVH 3DUDPHWHUV enterpriseFabMode enterpriseFabModeState This command sets the Enterprise Fabric Mode state for the fabric. The McDATA SANtegrity™ feature key must be installed to activate the Enterprise Fabric Mode state. This command has one parameter. enterpriseFabModeState &RPPDQG ([DPSOH Specifies whether enterpriseFabMode is active. Valid values are activate and deactivate. Boolean 1 and 0 may be substituted as values.
CLI Commands 2 FRQILJ IHDWXUHV LQVWDOO.H\ 6\QWD[ 3XUSRVH 3DUDPHWHUV installKey featureKey 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 this command is executed. This command has one parameter. featureKey &RPPDQG ([DPSOH Specifies the key you have received to enable optional software feature on a specific product. A feature key is a string of case-sensitive, alphanumeric ASCII characters.
CLI Commands 2 FRQILJ IHDWXUHV VKRZ 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOH show This command shows the product feature information configured for this switch. This command has no parameters. Root> config features show The product feature data is displayed as a table that includes the following property. Installed Feature Set The feature set installed using a feature key. Only installed keys are displayed. Feature Individual features within each set.
CLI Commands 2 FRQILJ LS HWKHUQHW 6\QWD[ 3XUSRVH 'HVFULSWLRQ ethernet ipAddress gatewayAddress subnetMask This command sets the Ethernet network settings. 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. 3DUDPHWHUV &RPPDQG ([DPSOH This command has three parameters. ipAddress Specifies the new IP address for the director or switch.
CLI Commands 2 2XWSXW 2XWSXW ([DPSOH 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. The output from the config.ip.show command displays as follows. IP Address: Gateway Address: Subnet Mask: 10.0.0.0 0.0.0.0 255.0.0.0 FRQILJ SRUW EORFNHG 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOHV blocked portNumber blockedState This command sets the blocked state for a port.
CLI Commands 2 FRQILJ SRUW H[W'LVW 6\QWD[ 3XUSRVH extDist portNumber extDistOn This command sets the extended distance state for a port. (The Sphereon 4500 does not accept this command.) 'HVFULSWLRQ 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. 3DUDPHWHUV This command has two required parameters. &RPPDQG ([DPSOHV portNumber Specifies the port number.
CLI Commands 2 FRQILJ SRUW IDQ 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH fan portNumber fanOn This command sets the fabric address notification (FAN) state for a port (Sphereon 4500 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. This command has two required parameters. portNumber Specifies the port number.
CLI Commands 2 FRQILJ SRUW QDPH 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2-10 name portNumber “portName” This command sets the name for a port. This command has two required parameters. portNumber Specifies the port number. Valid values are: 0–15 for the Sphereon 3016 and 3216 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 and 3232 0–63 for the Intrepid 6064 0–127 and 132–144 for the Intrepid 6140 portName Specifies the name for the port.
CLI Commands 2 FRQILJ SRUW VSHHG 6\QWD[ 3XUSRVH 'HVFULSWLRQ speed portNumber portSpeed This command sets the speed for a port. A port can be configured to operate at 1 Gbps, 2 Gbps, or a negotiated speed. The port speed can be set only to 1 Gbps if the switch speed is 1 Gbps. An attempt to set the port speed to 2 Gbps or to negotiate in a switch with a 1 Gbps switch speed results in an error message.
CLI Commands 2 FRQILJ SRUW W\SH 6\QWD[ 3XUSRVH 'HVFULSWLRQ 3DUDPHWHUV type portNumber portType This command sets the allowed type for a port. A port can be configured as an F_Port, an E_Port, or a G_Port. On a Sphereon 4500, a port can also be an Fx_port or Gx_port. The port configurations function as follows: • F_Port—cannot be used as an interswitch link, but may attach to a device with an N_Port. • E_Port—only other switches may attach to this type of port.
CLI Commands 2 FRQILJ SRUW VKRZ 6\QWD[ 3XUSRVH show portNumber This command displays the port configuration for a single port. 'HVFULSWLRQ This show command, on the config.port branch, displays the current configuration for the specified port. 3DUDPHWHUV This command has one parameter. portNumber &RPPDQG ([DPSOH 2XWSXW Specifies the port number.
CLI Commands 2 Type The port type. Valid values are: • • • • • Speed 2XWSXW ([DPSOH F Port E Port G Port Fx Port (Sphereon 4500 only) Gx Port (Sphereon 4500 only) The port speed. Valid values are 1 Gb/sec, 2 Gb/sec, and Negotiate. The output from the config.port.show command displays as follows. Port Number: Name: Blocked: Extended distance: Type: Speed: 4 Sam’s tape drive false false F Port 2 Gb/sec FRQILJ VHFXULW\ IDEULF%LQGLQJ Note that the config.security.
CLI Commands 2 This command takes effect immediately. The CLI verifies the list before activating it to the fabric and adds the managed switch to the list if it is not already present. 3DUDPHWHUV This command has no parameters. Root> config security fabricBinding activatePending config.security.fabricBinding.addMember 6\QWD[ 3XUSRVH addMember wwn domainId This command adds a new member to the Fabric Member List in the pending fabric binding work area.
CLI Commands 2 config.security.fabricBinding.clearMemList 6\QWD[ 3XUSRVH clearMemList This command clears the fabric membership list for the pending fabric binding working area. 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. 3DUDPHWHUV This command has no parameters. config.security.fabricBinding.
CLI Commands 2 config.security.fabricBinding.replacePending 6\QWD[ 3XUSRVH 3DUDPHWHUV replacePending This command replaces the pending working area with the fabric binding configuration that is currently loaded on the fabric. This command has no parameters. Root> config security fabricBinding replacePending config.security.fabricbinding.setState 6\QWD[ 3XUSRVH setState fabricBindingState This command sets the fabric binding state for the pending fabric binding configuration work area.
CLI Commands 2 config.security.fabricBinding.showActive 6\QWD[ 3XUSRVH 3DUDPHWHUV 2XWSXW 2XWSXW ([DPSOH showActive This command displays the fabric binding configuration saved on the fabric. It performs the same function as show.security.fabricBinding. This command has no parameters. This command displays the following fabric binding configuration data: Fabric Binding State The active fabric binding state: Inactive or Active Restricting Fabric Membership List The active fabric membership list.
CLI Commands 2 config.security.fabricBinding.showPending 6\QWD[ 3XUSRVH 3DUDPHWHUV 2XWSXW 2XWSXW ([DPSOH showPending 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. This command has no parameters. The fabric binding configuration data is displayed as a table that includes the following properties.
CLI Commands 2 FRQILJ VHFXULW\ SRUW%LQGLQJ config.security.portBinding.bound 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOHV bound portNumber portBindingState This command sets the port binding state for a given port. This command has two parameters. portNumber Specifies the port number for which the port binding state is being set.
CLI Commands 2 config.security.portBinding.wwn 6\QWD[ 3XUSRVH 3DUDPHWHUV wwn portNumber boundWwn This command configures the single device WWN to which a port is bound. This command has two parameters. portNumber Specified the port number for which the bound WWN is being set.
CLI Commands 2 &RPPDQG ([DPSOHV Root> config security portBinding wwn 4 AA:99:23:23:08:14:88:C1 Root> config security portBinding wwn 4 attached Root> config security portBinding wwn 4 remove config.security.portBinding.show 6\QWD[ 3XUSRVH 3DUDPHWHUV show portNumber This command shows the port binding configuration for a single port. This command has one parameter.
CLI Commands 2 FRQILJ VHFXULW\ VZLWFK%LQGLQJ config.security.switchBinding.addMember 6\QWD[ 3XUSRVH 3DUDPHWHUV addMember wwn 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. This command has one parameter: wwn Specifies the switch or N-Port device WWN of the member to be added to the switch membership list. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00).
CLI Commands 2 config.security.switchBinding.setState 6\QWD[ 3XUSRVH 3DUDPHWHUV setState switchBindingState This command sets the switch binding state on the switch. 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.
CLI Commands 2 config.security.switchBinding.show 6\QWD[ 3XUSRVH 3DUDPHWHUV 2XWSXW 2XWSXW ([DPSOH show This command displays the switch binding configuration. This command has no parameters. This command displays the following switch binding configuration data: switchBindingState Disabled, Enabled and Restricting F_Ports, Enabled and Restricting E_Ports, or Enabled and Restricting All Ports. Switch Membership List The switch membership list saved on the switch. The output from the config.security.
CLI Commands 2 FRQILJ VHFXULW\ XVHU5LJKWV config.security.userRights.administrator 6\QWD[ 3XUSRVH This command sets the name and password for administrator-level access. 'HVFULSWLRQ Immediately after the name and password for the administrator is set, you are prompted to log in with the new access rights. 3DUDPHWHUV This command has two parameters. &RPPDQG ([DPSOH 2-26 administrator “username” “password” username Specifies the new user name for administrator-level login.
CLI Commands 2 config.security.userRights.operator 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH operator “username” “password” This command sets the name and password for operator-level access. 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 2 config.security.userRights.show 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOH show This command shows the user rights for the CLI access levels. This command has no parameters. Root> config security userRights show 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.
CLI Commands 2 FRQILJ VQPS DGG&RPPXQLW\ 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH addCommunity commIndex "commName" writeAuthorization trapRecipient udpPortNum This command adds an SNMP community to the SNMP configuration. 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.
CLI Commands 2 FRQILJ VQPS DXWK7UDSV 6\QWD[ 3XUSRVH 3DUDPHWHUV authTraps enabledState 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 switch. This command has one parameter. enabledState &RPPDQG ([DPSOHV Specifies whether the authorization traps are enabled. Valid values are true and false. Boolean 1 and 0 may be substituted as values.
CLI Commands 2 FRQILJ VQPS VKRZ 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOH show This command shows the switch SNMP configuration. This command has no parameters. Root> config snmp show The switch configuration data is displayed as a table that includes the following properties. Authorization Traps The state of the authorization traps (for example, enabled) that are sent to SNMP management stations when unauthorized stations attempt to access SNMP information from the switch.
CLI Commands 2 FRQILJ VZLWFK Some of the config.switch commands 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. FRQILJ VZLWFK EE&UHGLW 6\QWD[ 3XUSRVH bbCredit bbCreditValue This command sets the buffer-to-buffer credit value for all ports, except those ports configured for extended distance. (The Sphereon 4500 does not accept this command.
CLI Commands 2 FRQILJ VZLWFK LQVLVW'RPDLQ,G 6\QWD[ 3XUSRVH 3DUDPHWHUV insistDomainId insistentDomainIdState This command sets the insistent domain ID state for the switch. This command has one parameter. insistentDomainIdState &RPPDQG ([DPSOH Specifies whether the insistent domain ID state is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values.
CLI Commands 2 FRQILJ VZLWFK LQWHURS0RGH 6\QWD[ 3XUSRVH interopMode interopMode This command sets the interoperability mode for the switch. The switch must be offline to complete this command. 'HVFULSWLRQ The switch must be set offline before this command is entered. 3DUDPHWHUV This command has one parameter. interopMode &RPPDQG ([DPSOH Specifies the interoperability mode. Valid values are mcdata and open: mcdata — McDATA Fabric 1.0 open — Open Fabric 1.
CLI Commands 2 FRQILJ VZLWFK SULRULW\ 6\QWD[ 3XUSRVH priority switchPriority This command sets the switch priority. 'HVFULSWLRQ The switch must be set offline before this command is entered. 3DUDPHWHUV This command has one parameter. switchPriority Specifies the switch priority. Valid values are: principal, default, or neverprincipal. principal — sets the numerical switch priority to 1.
CLI Commands 2 FRQILJ VZLWFK UD729 6\QWD[ 3XUSRVH 'HVFULSWLRQ raTOV timeoutValue This command sets the R_A_TOV for the switch. 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. 3DUDPHWHUV This command has one parameter. timeoutValue &RPPDQG ([DPSOH 2-36 Specifies the new R_A_TOV value. The units for this value are tenths of a second.
CLI Commands 2 FRQILJ VZLWFK UHURXWH'HOD\ 6\QWD[ 3XUSRVH 'HVFULSWLRQ rerouteDelay rerouteDelayState This command enables or disables rerouting delay for the switch. 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.
CLI Commands 2 FRQILJ VZLWFK VSHHG 6\QWD[ 3XUSRVH speed switchSpeed This command sets the speed for the switch. This command is only applicable for the Intrepid 6064. Sphereon products cannot change switch speed. 'HVFULSWLRQ The switch must be set offline before this command is entered. A switch can be configured to operate at 1 Gbps or 2 Gbps.
CLI Commands 2 FRQILJ VZLWFK VKRZ 6\QWD[ 3XUSRVH show This command shows the switch configuration. 3DUDPHWHUV This command has no parameters. 'HVFULSWLRQ The switch can be either offline or online when this command is executed. &RPPDQG ([DPSOH 2XWSXW Root> config switch show The switch configuration data is displayed as a table that includes the following properties.
CLI Commands 2 2XWSXW ([DPSOH Insistent Domain Id When enabled, ensures that the embedded firmware cannot change a switch’s preferred domain ID. Domain RSCN When enabled, allows domain RSCNs to be sent to registered members of the fabric. The output from the config.switch.show command displays as follows. BB Credit: 2 R_A_TOV: 20 E_D_TOV: 4 Preferred Domain Id: 1 Switch Priority: Principal Speed: 2 Gb/sec Rerouting Delay: Enabled Interop Mode: Open Fabric 1.
CLI Commands 2 FRQILJ V\VWHP GDWH 6\QWD[ date sysDate sysTime 3XUSRVH This command sets the system date and time. 3DUDPHWHUV This command has two required parameters. &RPPDQG ([DPSOHV sysDate Specifies the new system date. The format of the date parameter must be mm:dd:yyyy or mm/dd/yyyy. Valid date values include: mm: 1–12 dd: 1–31 yyyy: >1980 sysTime Specifies the new system time. The format of the time parameter must be hh:mm:ss.
CLI Commands 2 FRQILJ V\VWHP ORFDWLRQ 6\QWD[ 3XUSRVH 3DUDPHWHUV location “systemLocation” This command sets the system location attribute. This command has one parameter. systemLocation &RPPDQG ([DPSOH Specifies the new system location for the director or switch. The location can contain 0–255 characters. Root> config system location “Everywhere” FRQILJ V\VWHP QDPH 6\QWD[ 3XUSRVH 3DUDPHWHUV name “systemName” This command sets the system name attribute. This command has one required parameter.
CLI Commands 2 FRQILJ V\VWHP VKRZ 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOHV show This command shows the system configuration. This command has no parameters. Root> config system show 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. The output from the config.system.
CLI Commands 2 FRQILJ ]RQLQJ Note that the config.zoning commands function in a different way from most 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 2 FRQILJ ]RQLQJ DFWLYDWH=RQH6HW 6\QWD[ 3XUSRVH activateZoneSet This command activates the zone set contained in the work area to the fabric and takes effect immediately. 'HVFULSWLRQ This command takes effect immediately in the fabric. 3DUDPHWHUV This command has no parameters. &RPPDQG ([DPSOH Root> config zoning activateZoneSet If the interoperability mode for the switch or director is set to Open Fabric 1.
CLI Commands 2 FRQILJ ]RQLQJ UHSODFH=RQH6HW 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH replaceZoneSet This command replaces the work area with the active zone set that is currently loaded on the fabric. This command has no parameters. Root> config zoning replaceZoneSet FRQILJ ]RQLQJ FOHDU=RQH6HW 6\QWD[ 3XUSRVH This command clears the zone set contained in the work area, removing all zones, and takes effect immediately. 'HVFULSWLRQ This command does not change the zone set name.
CLI Commands 2 FRQILJ ]RQLQJ DGG=RQH 6\QWD[ 3XUSRVH addZone “zoneName” This command adds a new (empty) zone to the zone set in the work area. 'HVFULSWLRQ 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. 3DUDPHWHUV This command has one parameter. zoneName &RPPDQG ([DPSOH Specifies the name of the new zone. The zoneName must contain 1–64 characters.
CLI Commands 2 FRQILJ ]RQLQJ UHQDPH=RQH6HW 6\QWD[ 3XUSRVH renameZoneSet “zoneSetName” This command changes the name of the zone set in the work area. 'HVFULSWLRQ Changes are not activated on the switch until the config.zoning.activateZoneSet command is issued. 3DUDPHWHUV This command has one parameter. zoneSetName &RPPDQG ([DPSOH Specifies the new name for the zone set. The zoneSetName must contain 1–64 characters.
CLI Commands 2 FRQILJ ]RQLQJ DGG3RUW0HP 6\QWD[ 3XUSRVH addPortMem “zoneName” domainId portNumber This command adds the domain ID and port number of a zone member to the specified zone in the work area. 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. 'HVFULSWLRQ The CLI supports the number of zones members per zone specified for a given product. 3DUDPHWHUV This command has one parameter.
CLI Commands 2 FRQILJ ]RQLQJ FOHDU=RQH 6\QWD[ 3XUSRVH clearZone “zoneName” This command clears all zone members for the specified zone in the work area. 'HVFULSWLRQ This command does not change the zone name. 3DUDPHWHUV This command has one parameter. zoneName &RPPDQG ([DPSOH Specifies the name of the zone to be cleared.
CLI Commands 2 FRQILJ ]RQLQJ GHOHWH3RUW0HP 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH deletePortMem “zoneName” domainId portNumber This command deletes a domain ID and port number for a zone member in the specified zone in the work area. 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 that to be deleted from the zone. Valid domain IDs are in the range 1–31.
CLI Commands 2 FRQILJ ]RQLQJ UHQDPH=RQH 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2-52 renameZone “oldZoneName” “newZoneName” This command renames a zone in the work area. 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.
CLI Commands 2 FRQILJ ]RQLQJ VKRZ3HQGLQJ 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW showPending This command shows the zoning configuration in the work area of the zone set that has not yet been activated. This command has no parameters. Root> config zoning showPending The zoning configuration data is displayed as a table that includes the following properties. Local ZoneSet 2XWSXW ([DPSOH The enabled status, name, and member zones of the zone set. The output from the config.zoning.
CLI Commands 2 FRQILJ ]RQLQJ VKRZ$FWLYH 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW showActive This command shows the zoning configuration saved on the fabric. This command has no parameters. Root> config zoning showActive The zoning configuration data is displayed as a table that includes the following properties. Active ZoneSet 2XWSXW ([DPSOH The enabled status, name, and member zones of the zone set. The output from the config.zoning.showActive command displays as follows.
CLI Commands 2 PDLQW 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.
CLI Commands 2 PDLQW SRUW UHVHW 6\QWD[ 3XUSRVH reset portNumber This command resets a port. 'HVFULSWLRQ 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.
CLI Commands 2 PDLQW V\VWHP FOHDU6\V(UURU 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH clearSysError This command clears the system error light. This command has no parameters. Root> maint system clearSysError PDLQW V\VWHP LSO 6\QWD[ 3XUSRVH ipl This command IPLs the switch. 'HVFULSWLRQ Connection to the CLI is lost when this command runs. 3DUDPHWHUV This command has no parameters.
CLI Commands 2 PDLQW V\VWHP UHVHW&RQILJ 6\QWD[ 3XUSRVH 'HVFULSWLRQ resetConfig This command resets all NV-RAM configuration parameters to their default values, including feature keys and IP addresses. This command IPLs the switch. Connection from the CLI to the switch is lost when this command runs. This command resets all configuration data and non-volatile settings, including network information, to their default values (factory settings).
CLI Commands 2 SHUI 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.
CLI Commands 2 2XWSXW ([DPSOH TxFrames The number of Fibre Channel Class 2 frames that the port has transmitted. 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.
CLI Commands 2 3DUDPHWHUV This command has one parameter. portNumber &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOH Specifies the port number. Valid values are: 0–15 for the Sphereon 3016 and 3216 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 and 3232 0–63 for the Intrepid 6064 0–127 and 132–144 for the Intrepid 6140 Root> perf class3 2 The port Class 3 counter data is displayed as a table that includes the following statistics, along with a wrap count for each corresponding counter.
CLI Commands 2 SHUI FOHDU6WDWV 6\QWD[ 3XUSRVH 3DUDPHWHUV clearStats portNumber This command resets all port statistics for an individual port or for all ports. This command has one parameter. portNumber &RPPDQG ([DPSOH Specifies the port number.
CLI Commands 2 2XWSXW 2XWSXW ([DPSOH The port error counter data is displayed as a table that includes the following statistics. Port The port number. Prim Seq Err The number of state machine protocol errors detected by the port hardware. 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.
CLI Commands 2 SHUI OLQN 6\QWD[ 3XUSRVH 3DUDPHWHUV link portNumber This command displays port link counters for a single port. This command has one parameter. portNumber &RPPDQG ([DPSOH 2XWSXW 2-64 Specifies the port number.
CLI Commands 2 2XWSXW ([DPSOH Sync Losses The number of times the port has detected a loss of synchronization timeout while not in an offline or LF2 state. Sig Losses The number of times the port has detected a loss of signal while not in an offline or LF2 state. The output from the perf.link command displays as follows.
CLI Commands 2 2XWSXW 2XWSXW ([DPSOH The port traffic counter data is displayed as a table that includes the following statistics, along with a wrap count for each corresponding counter. Port The port number. Rx% The received link utilization percentage. Tx% The transmitted link utilization percentage. RxFrames The number of Fibre Channel Class 2 and Class 3 frames that the port has received. TxFrames The number of Fibre Channel Class 2 and Class 3 frames that the port has transmitted.
CLI Commands 2 VKRZ 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 by either the administrator or the operator.
CLI Commands 2 2XWSXW ([DPSOH The output from the show.eventLog command displays as follows.
CLI Commands 2 VKRZ IUXV 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW frus This command displays information about all FRUs. This command has no parameters. Root> show frus The FRU information is displayed as a table that includes the following properties. FRU The FRU name. • If a FRU is not installed on a Sphereon 3016, 3216, 3032, 3232, or an Intrepid 6064, the output in this column is NotInstalled.
CLI Commands 2 2XWSXW ([DPSOH The output from the show.frus command displays as follows.
CLI Commands 2 VKRZ ORJLQ6HUYHU 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOH loginServer This command displays information from the login server database for devices attached to this switch. Note that it is possible to have more than one device per port for any public loop devices attached to an FL Port. This command has no parameters. Root> show loginServer The device information is displayed as a table that includes the following properties.
CLI Commands 2 VKRZ QDPH6HUYHU 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2-72 nameServer This command displays information from the name server database for devices attached to this switch. Note that it is possible to have more than one device per port for any public loop devices attached to an FL Port. This command has no parameters. Root> show nameServer 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).
CLI Commands 2 2XWSXW ([DPSOH Type ---N N N N N N N N N N N N Port Id ------010400 010500 010600 010700 010800 010900 010C00 010D00 010E00 010F00 011200 011300 The output from the show.nameServer command displays as follows.
CLI Commands 2 2XWSXW 2XWSXW ([DPSOH The device information data is displayed as a table that includes the following properties. Type The type (N, NL, F/NL, F, FL, E, B). Port Id The 24-bit Fibre Channel address. Port Name The port WWN of the attached device. Node Name The node WWN of the attached device. COS The class of service (for example, 1; 2; 3; 4; 5; 6; F; 1,2; 2,3). FC4 Types The FC4 types registered for this device. One or more numbers display in this field.
CLI Commands 2 VKRZ SRUW FRQILJ 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOH config This command shows the port configuration for all ports. This command has no parameters. Root> show port config The port configuration attributes are displayed as a table that includes the following properties. Port The port number. Name The name of the port as set in the config.port.name command. Blocked The blocked state of the port as set in the config.port.blocked command.
CLI Commands 2 VKRZ SRUW LQIR 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOH info This command displays port information for all ports. This command has no parameters. Root> show port info The port information data is displayed as a table that includes the following properties. Port The port number. WWN The WWN of the port. OpSpeed The current operating speed (1 Gb/sec, 2 Gb/sec, or Not Established). SpeedCap The current transceiver capability speed (1 Gb/sec or 2 Gb/sec).
CLI Commands 2 VKRZ SRUW QRGHV 6\QWD[ 3XUSRVH 3DUDPHWHUV nodes portNumber This command displays the loop node list for a specified port. This command is valid only on the Sphereon 4500. This command has one parameter. portNumber &RPPDQG ([DPSOH 2XWSXW Specifies the port number. Valid values are: 0–23 for the Sphereon 4500 Root> show port nodes portNumber The port nodes data is displayed as a table that includes the following properties.
CLI Commands 2 2XWSXW ([DPSOH The show.port.
CLI Commands 2 VKRZ SRUW VWDWXV 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW status This command displays port status for all ports. This command has no parameters. Root> show port status The port status data is displayed as a table that includes the following properties. Port The port number. State The port state (for example, Segmented E_Port, Invalid Attachment, Not Installed, Online, Offline, Not Operational, No Light, Testing, Port Failure, Link Reset, or Inactive).
CLI Commands 2 Reason An optional message number that indicates if the port has a segmented ISL, if a port binding violation has occurred, or if the port is inactive. The message description for this message number is provided at the bottom of the table.
CLI Commands 2 2XWSXW ([DPSOH The output from the show.port.status command displays as follows.
CLI Commands 2 VKRZ SRUW WHFKQRORJ\ 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOH technology This command displays port technology information for all ports. This command has no parameters. Root> show port technology 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 2 VKRZ VHFXULW\ IDEULF%LQGLQJ 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOH fabricBinding This command displays the fabric binding configuration saved on the fabric. The command performs the same function as config.security.fabricBinding.showActive. This command has no parameters. Root> show security fabricBinding The fabric binding configuration data is displayed as a table that includes the following properties.
CLI Commands 2 VKRZ VHFXULW\ SRUW%LQGLQJ 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOH portBinding This command shows the port binding configuration for all ports. This command has no parameters. Root> show security portBinding The port binding configuration data is displayed as a table that includes the following properties. Port The port number. WWN Binding The state of port binding for the specified port (active or inactive).
CLI Commands 2 VKRZ VHFXULW\ VZLWFK%LQGLQJ 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2XWSXW ([DPSOH switchBinding This command displays the switch binding configuration. This command has no parameters. Root> show security switchBinding The switch binding configuration data is displayed as a table that includes the following properties.
CLI Commands 2 VKRZ VZLWFK 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2-86 switch This command displays switch attributes. This command has no parameters. Root> show switch The switch attributes data is displayed as a table that includes the following properties. State The state of the switch (for example, online or offline). BB Credit The BB credit as set in the config.switch.bbCredit command. (This does not apply to the Sphereon 4500.) R_A_TOV The R_A_TOV as set in the config.switch.
CLI Commands 2 2XWSXW ([DPSOH Active Domain Id The active domain ID of the switch. This ID may or may not be the same as the preferred domain ID. World Wide Name The WWN for the switch. Insistent Domain Id Configured Insistent domain ID state as set in the config.switch.insistDomainId command. Domain RSCN Configured Domain RSCN state as set in the config.switch.domainRSCN command. The output from the show.switch command displays as follows.
CLI Commands 2 VKRZ V\VWHP 6\QWD[ 3XUSRVH 3DUDPHWHUV &RPPDQG ([DPSOH 2XWSXW 2-88 system This command displays a set of system attributes. This command has no parameters. Root> show system 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 2 2XWSXW ([DPSOH The output from the show.system command displays as follows. System Information Name: Description: Director Contact: Location: Date/Time: Serial Number: Type Number: Model Number; EC Level: Firmware Version: Beaconing: Joe’s Switch McDATA Intrepid 6064 Fibre Channel Joe Everywhere 04/16/2001 10:34:01AM 123456789 1 Intrepid 6064 1 01.03.
CLI Commands 2 2-90 McDATA OPENconnectors Command Line Interface USER MANUAL P/N 620-000134-300
$ (UURU 0HVVDJHV 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. Message Description Action Message Description Action Error 05: Busy The switch is busy processing another request. After a few seconds, re-issue the request.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Error 09: Invalid Switch Description The value entered for the switch description is invalid. The description for the director or switch may contain 0–255 characters. Enter a description with 0–255 characters and re-submit. If spaces are used, enclose the description in quotation marks. Error 10: Invalid Switch Location The value entered for the switch location is invalid.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 14: Invalid Port Name The value entered for the port name is invalid. The port name for the individual port may contain 0–24 characters. Enter a name with 0–24 characters and re-submit. If spaces are used, enclose the name in quotation marks. Error 15: Invalid BB Credit The value entered for the buffer-to-buffer credit is invalid.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action A-4 Error 20: Invalid Preferred Domain ID The value entered for the preferred domain ID for the director or switch is invalid. The preferred domain ID must be an integer in the range 1–31. Enter an appropriate value and re-submit. Error 21: Invalid Switch Priority The value entered for the switch priority is invalid.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Error 31: Invalid Subnet Mask The value entered for the subnet mask is invalid. The new subnet mask for the Ethernet interface must be entered in dotted decimal format (e.g. 255.0.0.0). Enter an appropriate subnet mask and re-submit. Error 32: Invalid SNMP Community Name The value entered for the SNMP community name is invalid.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-6 Error 37: Invalid Month The value of the month entered for the new system date is invalid. The format of the date parameter must be mm:dd:yyyy or mm/dd/yyyy. The month must contain an integer in the range 1–12. Enter an appropriate date and re-submit. Error 38: Invalid Day The value of the day entered for the new system date is invalid.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Error 42: Invalid Second The value of the second entered for the new system time is invalid. The format of the time parameter must be hh:mm:ss. The second can contain an integer in the range 0–59. Enter an appropriate time and re-submit. Error 44: Max SNMP Communities Defined A new SNMP community may not be defined without removing an existing community from the list.
Error Messages A Message Description Action Message Description Action Message Description Action Message Two or more zone names in the zone set are identical. All zone names must be unique. Make the appropriate changes and re-submit. Error 59: Zone Name in Use Two or more zone names in the zone set are identical. All zone names must be unique. Make the appropriate changes and re-submit.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 69: Duplicate Port Name Two or more port names are identical. Port names must be unique. Make appropriate changes and re-submit. For more information, see config.port.name on page 2-10.
Error Messages A Message Description Action Message Description Action Message The specified zone set contains less than one zone or more than the maximum number of zones allowed for this product. A zone set must contain at least one zone to be considered valid. Add or remove zones accordingly to meet specified requirements. Error 75: Invalid Zone Set Size The zone set entered exceeds switch NVRAM limitations. Reduce the size of the zone set to meet specified requirements.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Message Error 79: FRU Failed The specified FRU has failed. Consult the installation/service manual for appropriate action. Error 81: Default Zone Enabled The request cannot be completed because the default zone is enabled Disable the default zone and re-submit the command. Error 82: Invalid Interop Mode The value entered for the interoperability mode is not valid.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-12 Error 89: Not Allowed in S/390 Mode Without the SANtegrity (TM) Feature Cannot configure port types in S/390 mode without installing SANtegrity. This command is only supported when the switch is in Open Systems mode or in S/390 with SANtegrity.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 94: Invalid Feature Combination The features requested cannot be installed at the same time on one director or switch. Contact your sales representative. Error 99: Preferred Domain ID Cannot Be Zero This product cannot be configured to have a preferred domain ID equal to zero (0).
Error Messages A Message Description The request cannot be completed because the switch is not capable of operating at 2 Gbps. Action Consult the installation/service manual to determine the speed capabilities of your product. Message Error 117: Port Speeds Cannot be Set at Higher Data Rate than Switch Speed Description This request cannot be completed because the requested port speed is faster than the currently-configured switch speed.
Error Messages A Message Error 134: Invalid Membership List Description Generic message to indicate a problem in either the switch binding or fabric binding membership list. Action Be sure that the membership list submitted does not isolate a switch already in the fabric. If this is not the case, the user needs to be aware of all fabric security rules and make sure that the list submitted adheres appropriately.
Error Messages A Message Description Action Message Description Action Message Description Action Message A-16 Error 138: Invalid Switch Binding State The switch binding state submitted is not recognized by the CLI. The switch binding state must be set to one of the following: disable, erestrict, frestrict, or allrestrict. For more information, see config.security.switchBinding on page 2-23.
Error Messages A Message Description Action Message Error 142: Invalid Domain RSCN State The request cannot be completed because an invalid domain RSCN state has been submitted. The domain RSCN state must be set to either enable or disable. For more information, see config.switch.domainRSCN on page 2-32. Error 143: Domain RSCNs Must Be Enabled When Enterprise Fabric Mode Active Description The user attempted to disable domain RSCN’s while enterprise fabric mode was active.
Error Messages A Message Description The switch must be online to complete this request. Action Change the state of the switch to ONLINE and re-submit the request. Message Error 149: Not Allowed While Enterprise Fabric Mode Enabled and Switch Active Description Action Message Description Action Message Description Action Message Description Action A-18 Error 148: Not Allowed While Switch Offline The request cannot be completed while the switch is online and enterprise fabric mode is Active.
Error Messages A Message Description Action Message Error 154: Invalid Membership List WWN The request cannot be completed because the WWN does not exist in the switch binding membership list. Make sure that the WWN deleted matches the WWN in the switch membership list. Make appropriate changes and re-submit the request. Error 155: Cannot Remove Active Member From List Description This member cannot be removed from the fabric security list because it is currently logged in.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-20 Error 202: Invalid Change Authorization ID The switch will not accept a change request from this particular client. Be sure all parameters have been entered correctly and re-submit. Contact your service representative with further problems.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 210: Busy Processing Another Request A different switch in the Fabric was busy processing another request and could not complete the command. Be sure all parameters have been entered correctly and re-submit. Contact your service representative with continued problems.
Error Messages A Message Description Action Message Description Action Error 215: Zone Set Size Exceeded The local work area zone set has outgrown the size limitations imposed by the Command Line Interface. Reduce the size of the zone set to meet CLI requirements. This can be a reduction in the number of zones in the zone set, a reduction of members in a zone, or a reduction of zone name lengths.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 223: Unknown Error The switch did not accept the request Contact your service representative. Error 224: Invalid Argument One or more parameters are invalid for this command. For the appropriate parameters, see the section of the manual that corresponds to the attempted command.
Error Messages A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-24 Error 228: Invalid Write Authorization Argument The writeAuthorization parameter does not contain a valid value. Parameters must be typed exactly to specification to be recognized correctly by the CLI. For more information, see config.snmp.addCommunity on page 2-29.
Error Messages A Message Description Action Message Error 233: Invalid Member The zone member added is not valid. For the appropriate parameters, see the section of the manual that corresponds to the attempted command. Parameters must be typed exactly to specification to be recognized correctly by the CLI. Error 234: Invalid Command Description The CLI cannot associate an action with the submitted command.
Error Messages A Message Description There was an unidentifiable problem in the local zone set work area. Action Verify all parameters are entered correctly and re-submit. Otherwise, the pending zone set should be cleared and reconstructed. Message Description Action Message Description Action Message Error 238: Invalid Feature Key The feature key entered is invalid. Verify that the feature key was entered correctly and re-submit. Contact your service representative with further difficulties.
Error Messages A Message Description Action Message Description Action Error 242: Open trunking threshold % value must be 0–99 An invalid threshold percentage has been entered. The Open trunking threshold must be in the range 0–99. Make sure all values are valid and re-submit the request. Error 243: Not allowed while S/390 Mode is Enabled This operation is not allowed while S/390 mode is enabled. This command is not valid for the S/390 environment.
Error Messages A A-28 McDATA OPENconnectors Command Line Interface USER MANUAL P/N 620-000134-500
*ORVVDU\ The following cross-references are used in this glossary: Contrast with. This refers to a term that has an opposite or substantively different meaning. See. This refers the reader to another keyword or phrase for the same term. See also. This refers the reader to definite additional information contained in another entry. A active zone set ALPA The single zone set that is active in a multiswitch fabric. It is created when you enable a specified zone set.
Glossary backup FRU beaconing BB_Credit blocked port buffer When an active FRU fails, an identical backup FRU takes over operation automatically (failover) to maintain director and Fibre Channel link operation. The use of light-emitting diodes on ports, port cards, hardware components, and directors to aid in the fault-isolation process; when enabled, active beaconing will cause LEDs to flash for selected components. Also known as Buffer-to-Buffer Credit.
Glossary configuration. A configuration backup file is required to restore configuration data if the CTP card in a nonredundant Intrepid 6064 is removed and replaced. connectionless connector control processor card control unit CRC CTP cyclic redundancy check Nondedicated link. Typically used to describe a link between nodes which allows the switch to forward Class 2 or Class 3 frames as resources (ports) allow.
Glossary dialog box A window containing informational messages or data fields to be modified or filled in with desired options. director An intelligent, high-availability Fibre Channel switching device providing any-to-any port connectivity between nodes (end devices) on a switched fabric. The director sends data transmissions (data frames) between nodes in accordance with the address information present in the frame headers of those transmissions.
Glossary Ethernet event log expansion port A widely implemented local area network (LAN) protocol that uses a bus or star topology and served as the basis for the IEEE 802.3 standard, which specifies the physical and software layers. Baseband LAN allows multiple station access to the transmission medium at will without prior coordination and which avoids or resolves contention. Record of significant events that have occurred on the director, such as FRU failures, degraded operation, and port problems.
Glossary Fibre Channel Address There are two types of Fibre Channel addresses: • An address for a public device, comprised of the domain ID, port address, and its AL_PA • An address for a private device, comprised of 0000 followed by its AL_PA. In both cases, the Fibre Channel address is represented as a six-digit hexadecimal string. field-replaceable unit firmware An assembly removed and replaced in its entirety when any one of its components fails.
Glossary Gx_Port A port configuration allowing a port to transition operationally to FL_Port as well as to the port operational states described for a G_Port. Only the Sphereon 4500 Switch supports the configuration of this port type. H hop hop count hub Data transfer from one node to another node. The number of hops a unit of information traverses in a fabric. In Fibre Channel, a device that connects nodes into a logical loop by using a physical star topology.
Glossary L LIN See link incident. link Physical connection between two devices on a switched fabric. link incident LIPS loopback test Interruption to link due to loss of light or other causes. Loop Initialization Primitives. Test that checks attachment or control unit circuitry, without checking the mechanism itself, by returning the output of the mechanism as input. M managed product multiswitch fabric A hardware product that can be managed by the CLI.
Glossary format xxx.xxx.xxx.xxx), or a domain name (as administered on a customer network). node node port In Fibre Channel terminology, node refers to an end device (server or storage device) that is or can be connected to a switched fabric. Physical interface within an end device which can connect to an F_Port on a switched fabric or directly to another N_Port (in point-to-point communications).
Glossary out-of-band management Transmission of management information using frequencies or channels other than those routinely used for information transfer. P password path port Unique string of characters known to the computer system and to a user who must specify it to gain full or limited access to a system and to the information stored within it. In a network, any route between any two ports. Receptacle on a device to which a cable leading to another device can be attached.
Glossary operations will automatically failover in the event of a component failure. Redundancy is a vital characteristic of virtually all high-availability (24 hr./7 days per week) computer systems and networks. resource allocation time out value R_A_TOV is a 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. S SAN SANpilot interface SBAR segmented E_Port SEL See storage area network.
Glossary SNMP community Also known as SNMP community string. SNMP community is a cluster of managed products (in SNMP terminology, hosts) to which the server or managed product running the SNMP agent belongs. 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.
Glossary W warning message Indication that a possible error has been detected. See also error message; information message. world wide name Eight byte identifier uniquely assigned to a switch or to a node (end device), even on global networks. WWN See world wide name. Z zone A set of devices that can access one another. All connected devices may be configured into one or more zones. Devices in the same zone can see each other. Those devices that occupy different zones cannot.
Glossary g-14 McDATA OPENconnectors Command Line Interface USER MANUAL P/N 620-000134-500
Index Symbols " # ..
Index using 1-2 command tree 1-5 limitations on movements within 1-9 navigation of 1-8 commands asynchronous 1-3 commaDelim 1-13 config 2-2 ED-5000 1-17 login 1-11 logout 1-12 maint 2-55 perf 2-59 periods in 1-3 show 2-67 commands that take effect immediately 2-14, 2-44 commenting scripts 1-16 config command 2-2 configuration data, resetting 2-55 configuration, resetting 2-58 connection loss, ethernet 1-18 conventions documentation 1-3 navigation 1-3 used in manual xii counter data 2-59, 2-60 D data trans
Index G G_port, setting 2-12 gateway address 2-6 globally available commands 1-5 H help command 1-15 help, technical support xii history log 1-9 clearing 1-9 I inactive state reasons 2-80 insistent Domain ID state Domain ID state 2-33 interactive interfaces 1-2 interoperability mode 2-34 invalid attachment state reasons 2-80 IP address, ethernet 2-6 IPL 2-57 K keys for feature sets 2-4 resetting 2-58 L Latin-1 character set 2-2 limitations, history log 1-9 link counters 2-64 logging in 1-11 logging out
Index deleting 2-51 port statistics, resetting 2-62 port status 2-79 port technology information 2-82 port traffic counters 2-65 ports bbCredit 2-32 error counters 2-62 extended distance state 2-8 link counters 2-64 name 2-10 port beaconing 2-55 port binding state 2-20 port configuration 2-75 port information 2-76 port nodes 2-77 port statistics 2-62 port technology information 2-82 resetting 2-56 speed 2-11 statistics, clearing 2-62 status 2-79 traffic counters 2-65 type 2-12 WWN, binding 2-21 pound sign
Index strings, null 1-10 strings, quotation marks in 1-10 subnet mask 2-6 switch attributes, displaying 2-86 Switch Binding add new member 2-23 configuration 2-23 delete member 2-23 show configuration 2-25 switch binding 2-85 set state 2-24 Switch Member List add member 2-23 delete member 2-23 show 2-25 switches 2-58 configuring IP address 2-6 configuring, set offline 2-32 e_d_tov 2-33 event log 2-67 FRU information 2-69 interoperability mode 2-34 IPL 2-57 login server database 2-71 name server database 2-
Index members adding by port 2-49 adding by WWN 2-48 deleting by port 2-51 deleting by WWN 2-50 renaming 2-52 zoning configuration active, display 2-54 displaying 2-89 pending, display 2-53 zoning, configuring 2-44 i-6 McDATA OPENconnectors Command Line Interface USER MANUAL P/N 620-000134-500
