Enterprise Operating System Command Line Interface User Manual P/N 620-000134-720 REV A
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 620-000134-600 2/2003 Updates for E/OS 5.1 and EFCM 7.1 620-000134-601 7/2003 Updates for E/OS 5.5 620-000134-700 10/2003 Updates for E/OS 6.
property of such parties and are reprinted with limited use permission. All other trademarks are the property of their respective companies. All specifications subject to change.
iv Enterprise Operating System Command Line Interface User Manual
Contents Preface.............................................................................................................................xv 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 New and Changed Commands ......................................................2-2 config ..................................................................................................2-5 config.enterpriseFabMode.setState.........................................2-5 config.features.enterpriseFabMode ........................................2-6 config.features.ficonMS ............................................................2-6 config.features.installKey .......................................
Contents config.security ......................................................................... 2-32 config.security.authentication.interface api.outgoing ....... 2-33 config.security.authentication.interface.api.sequence....... 2-33 config.security.authentication.interface.cli.sequence ........ 2-34 config.security.authentication.interface.eport.outgoing ... 2-34 config.security.authentication.interface.eport.sequence ... 2-35 config.security.authentication.interface.nport.outgoing... 2-36 config.
Contents config.security.ssh.resetKeys .................................................2-61 config.security.ssh.setState.....................................................2-61 config.security.ssh.show.........................................................2-61 config.security.switchAcl .......................................................2-62 config.security.switchAcl.addRange ....................................2-62 config.security.switchAcl.deleteRange ................................2-63 config.
Contents config.zoning.addZone .......................................................... 2-87 config.zoning.clearZone......................................................... 2-88 config.zoning.clearZoneSet ................................................... 2-88 config.zoning.deactivateZoneSet.......................................... 2-89 config.zoning.deletePortMem............................................... 2-89 config.zoning.deleteWwnMem............................................. 2-90 config.
Contents perf.thresholdAlerts.counter.setCounter ...........................2-123 perf.thresholdAlerts.counter.setParams ............................2-124 perf.thresholdAlerts.counter.show .....................................2-125 perf.threshholdAlerts.counter.showStatisticTable ...........2-126 perf.thresholdAlerts.deleteAlert .........................................2-127 perf.thresholdAlerts.setState ...............................................2-127 perf.thresholdAlerts.show ........................
Contents show.openTrunking.rerouteLog......................................... 2-162 show.port.config ................................................................... 2-163 show.port.exit ........................................................................ 2-164 show.port.info ....................................................................... 2-166 show.port.nodes.................................................................... 2-167 show.port.opticEDD .......................................
Contents xii Enterprise Operating System Command Line Interface User Manual
Tables 1-1 1-2 1-3 CLI Command Tree Navigation Conventions ......................................... 1-3 CLI Command Tree ...................................................................................... 1-5 CLI Command Tree for the ED-5000 Director ........................................ 1-21 2-1 2-2 2-3 Supported Zoning Configurations ........................................................... 2-85 Throughput Threshold Alerts ................................................................
Tables xiv Enterprise Operating System Command Line Interface User Manual
Preface 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 4300 Fabric Switch, Sphereon 4500 Fabric Switch, Intrepid® 6064 Director, and Intrepid 6140 Director.
Preface The publications listed in Related Publications provide considerable information about both concepts and McDATA products. Organization of This Manual Manual Updates Related Publications xvi This publication is organized as follows: • Chapter 1, Introduction, provides an introduction and overview of the Command Line Interface.
Preface Manual Conventions • Sphereon 3016 and 3216 Fabric Switch Element Manager User Manual (620-000174) • Sphereon 3016 and 3216 Fabric Switches Installation and Service Manual (620-000154) • Sphereon 3032 and 3232 Fabric Switch Element Manager User Manual (620-000173) • Sphereon 3032 and 3232 Fabric Switches Installation and Service Manual (620-000155) • Sphereon 4300 Fabric Switch Installation and Service Manual (620-000171) • Sphereon 4500 Fabric Switch Installation and Service Manual (62
Preface McDATA’s “Best in Class” Solution Center provides a single point of contact for customers seeking help with McDATA software products. The Solution Center will research, explore, and resolve inquiries or service requests regarding McDATA products and services. The Solution Center is staffed 24 hours a day, 7 days a week, including holidays. NOTE: To expedite warranty entitlement, please have your product serial number available.
Preface Fax: (720) 558-4193 Trademarks The following terms, indicated by a registered trademark symbol (®) or trademark symbol (™) on first use in this publication, are trademarks of McDATA Corporation in the United States, other countries, or both: Registered Trademarks Trademarks Fabricenter® E/OS™ HotCAT® Eclipse™ Intrepid® Fibre Channel Director™ McDATA® OPENconnectors™ OPENready® SANvergence™ SANavigator® Sphereon™ SANpilot® SANtegrity® All other trademarked terms, indicated by a regist
Preface xx Enterprise Operating System Command Line Interface User Manual
1 Introduction This chapter introduces the Command Line Interface (CLI) and describes the essentials for using the CLI commands. • • • • • • • • • • Command Line Interface Overview...................................................... 1-2 Entering Command Line Interface Commands.................................... 1-3 Logging In and Logging Out.............................................................. 1-14 Using the commaDelim Command ....................................................
Command Line Interface Overview 1 Command Line Interface Overview The Command Line Interface (CLI) is a feature that provides an alternative to Graphical User Interface (GUI) and web-based (HTTP) 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.
Entering Command Line Interface Commands 1 Entering Command Line Interface Commands 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. Documentation Conventions 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.
Entering Command Line Interface Commands 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.
Entering Command Line Interface Commands 1 Command Tree The command tree of the CLI begins from the root. Table 1-2 shows the CLI command tree. The commands in the four extended branches (config, maint, perf, and show) are described in Chapter 2, CLI Commands.
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) ip-------------------------- ethernet lineSpeed show setHostCtrlState NPIV--------------------- maxPortIDs setState show openSysMS------------ setState port ----------------------- blocked fan name rxCredits show showPortAddr speed swapPortByAddr swapPortByNum type security------------------ authentication---------- interface----------------- api------------------------- outgoing sequence cli-------------------------- sequen
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) show timeout switch-------------------- setSecret user----------------------- add delete modify role show security ----------------- fabricBinding ----------- activatePending addAttachedMembers addMember clearMemList deactivateFabBind deleteMember replacePending showActive showPending portBinding ------------- bound show wwn ssh------------------------ resetKeys setState show switchAcl---------------- addRange deleteRange s
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) authTraps deleteCommunity setFaMibVersion setState show switch -------------------- domainRSCN edTOV insistDomainId interopMode ltdFabRSCN prefDomainId priority raTOV rerouteDelay speed show zoneFlexPars zoningRSCN system ------------------ contact date description location name show zoning ------------------- setDefZoneState activateZoneSet deactivateZoneSet replaceZoneSet clearZoneSet addZone deleteZone renameZoneSet addWw
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) deletePortMem renameZone showPending showActive maint ---------- port ----------------------- beacon reset system ------------------ beacon clearSysError ipl resetConfig setOnlineState perf ------------ class2 class3 clearStats errors link openTrunking ---------- backPressure congestionThresh lowBBCreditThresh setState show unresCongestion preferredPath ---------- clearPath setPath setState showPath showState thresholdAlert
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) show throughput -------------- addAlert addPort removePort setUtilType setUtilPercentage setParams show showUtilTypeTable traffic show ---------- all auditLog epFrameLog----------- config filterClassFFrames noWrap setFilterPort wrap eventLog fabric--------------------- nodes principal topology fabricLog---------------- noWrap wrap features fencing------------------- policies ficonCUPZoning ficonMS frus ip ------------------
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) openTrunking ---------- config rerouteLog port ----------------------- config exit info nodes opticEDD opticInfo profile showPortAddr status technology preferredPath ---------- showPath security------------------ fabricBinding log log portBinding switchAcl switchBinding snmp switch system thresholdAlerts-------- alerts log zoning Note that the commands are shown, with the exception of the zoning commands, in alphabetical or
Entering Command Line Interface Commands 1 Navigation of the CLI Command Tree Once the administrator or operator logs in and receives the Root> prompt, the CLI commands are accessed by navigating up and down the CLI command tree. To move from the root through the any of the four extended branches, enter the name of the next branch as shown in Table 1-2, CLI Command Tree, page 1-5. For example, to use the config.port.
Entering Command Line Interface Commands 1 As shown in this example, use of the complete command syntax avoids navigating up and down the branches of the CLI command tree, and the prompt stays at the root. The use of complete command syntax is particularly useful when writing scripts. When coding a script, remember to code the appropriate character sequences, which are described in Navigation Conventions on page 1-3.
Logging In and Logging Out 1 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.System> location "Building 24 \"Joe’s PlayLab\"" A null string can be created by using the quotation marks without any space between them. Config.
Logging In and Logging Out 1 hexadecimal characters must follow the backslash. All printable ASCII characters can be entered using the keyboard or using its hexadecimal value except for the backslash character. If a backslash is desired as part of the password its hexadecimal representation must be used. Spaces are valid, but if they appear at the begging of the password then they will be ignored. The following are examples of valid secrets.
Logging In and Logging Out 1 enters the default password when prompted to change the password, the data portion of the security log entry for CLI login includes “password not changed.” A user name and password can be set by the administrator through the config.security.authentication.user.add command or through the config.security.authentication.user.modify command.
Using the commaDelim Command 1 Using the commaDelim Command Note that the output examples shown in the other sections of this publication presume that commaDelim is off. commaDelim Syntax Purpose Description Parameter 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.
Handling Command Line Interface Errors 1 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 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.
Using the Command Line Interface Help 1 Using the Command Line Interface Help The question mark (?) can be used within a command to obtain certain information: • If the question mark is used in place of a command keyword, all the keywords at that level of the CLI command tree display.
Commenting Scripts 1 Commenting Scripts The pound sign (#) can be used to add comments in a script file. The pound sign must be the first character in the line; the CLI ignores everything after the pound sign in that line. The following lines are valid: Root> #Change port 3 to an E_Port Root> config port config.port> ################## config.port> ## Begin Script ## config.
ED-5000 Director 1 ED-5000 Director 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.
Telnet Session 1 Telnet Session The CLI can be accessed through a Telnet client session in an out-of-band management environment, using the Ethernet port in the director or switch. It can also be accessed using Secure Shell (SSH). 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.
Backup and Restoration 1 Backup and Restoration A standalone Configuration Backup and Restore (CBR) utility is available for customers that do not use EFCM for backing up and restoring user configuration data. You can use this utility to backup and restore configuration data from all switch and director products running E/OS versions 4.0 and higher. The CBR utility is available for no charge in the Technical Documents section of the McDATA website at www.mcdata.
Backup and Restoration 1 1-24 Enterprise Operating System Command Line Interface User Manual
2 CLI Commands 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. • • • • • • Command Overview ............................................................................. 2-2 New and Changed Commands ............................................................. 2-2 config.....................................................................................................
Command Overview 2 Command Overview Most of the commands in this chapter are listed in alphabetical order to make them easy to locate. Although the commands can be entered in any order, depending on the results desired (so long as the tree structure is followed), the order used herein for the zoning commands follows a typical order of entry. The various show commands are usually entered at the end of a group of other commands to verify configuration changes.
New and Changed Commands 2 • config.NPIV.show on page 2-23 • config.port.rxCredits on page 2-26 • config.port.show on page 2-27 • config.port.showPortAddr on page 2-28 • config.port.swapPortByAddr on page 2-30 • config.port.swapPortByNum on page 2-30 • config.security.authentication.interface api.outgoing on page 2-33 • config.security.authentication.interface.api.sequence on page 2-33 • config.security.authentication.interface.cli.sequence on page 2-34 • config.security.authentication.
New and Changed Commands 2 2-4 • config.security.authentication.user.add on page 2-46 • config.security.authentication.user.delete on page 2-47 • config.security.authentication.user.modify on page 2-48 • config.security.authentication.user.role on page 2-49 • config.security.authentication.user.show on page 2-50 • config.security.switchAcl.addRange on page 2-62 • config.security.switchAcl.deleteRange on page 2-63 • config.security.switchAcl.setState on page 2-63 • config.security.
config 2 • show.port.opticInfo on page 2-170 • show.port.profile on page 2-171 • show.port.showPortAddr on page 2-173 • show.security.log on page 2-181 • show.security.switchAcl on page 2-183 config The config branch of the CLI command tree contains commands that set parameter values on the switch or director. These values are not temporary (session) values, but are retained across power cycles. The commands in the config branch can only be accessed by a user with administrator level user rights.
config 2 Command Example Root> config enterpriseFabMode setState 1 NOTE: You cannot activate Enterprise Fabric Mode while Open Trunking is enabled. config.features.enterpriseFabMode Syntax Purpose Parameters enterpriseFabMode enterpriseFabModeState 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. This command has one parameter.
config 2 NOTE: If the FICON Management Server is enabled, the default management style is the FICON Management Style. The Open Systems Management Style cannot be used. Parameters This command has one parameter. ficonMSState Command Example Specifies whether the FICON Management Server is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values. Root> config features ficonMS 1 NOTE: The command config.ficonMS.
config 2 config.features.NPIV Syntax Purpose Parameters setState NPIVState This command sets the enabled state of the NPIV feature. The NPIV feature key must be installed in order to enable this feature. This command has one parameter. NPIVState Command Example Valid values are enable and disable. Boolean 1 and 0 may be substituted as values. Root> config features NPIV enable NOTE: The command config.NPIV.setState on page 2-23 has functionality that is identical to this command. config.features.
config 2 Purpose Parameters This command sets the enabled state of the OpenTrunking feature. The OpenTrunking feature key must be installed in order to enable open trunking. This command has one parameter. openTrunkingState Command Example This parameter can be set to enable or disable the OpenTrunking feature. Boolean 1 and 0 may be substituted as values. Root> config features openTrunking 1 NOTE: The command perf.openTrunking.
config 2 Output Example The output from the config.features.show command displays as follows. Installed Feature Set -----------------------------Flex Ports SANtegrity SANtegrity SANtegrity Open Trunking Feature -----------------8 Flex Ports Fabric Binding Switch Binding Enterprise Fabrics Open Trunking State ----Enabled Active Enabled Active Enabled NOTE: The command show.features on page 2-150.has functionality that is identical to this command. config.fencing.
config 2 Parameters This command has two parameters. name The name of the fencing policy. portNumber The new port number to add to the fencing policy, or all, which will add all of the individual ports to the fencing policy.
config 2 Parameters This command has one parameter. name Command Example The name of the fencing policy. You can also enter all for this argument. This will delete all of the configured fencing policies. Root> config fencing deletePolicy Policy1 config.fencing.removePort Syntax Purpose Parameters removePort name portNumber This command removes a port from the specified fencing policy. This command has two parameters. name The name of the fencing policy.
config 2 Parameters This command has four parameters. name The name of the fencing policy. typeNumber This must be entered as a number that corresponds to an entry in the table shown below. limit The count of fencing violations that must occur within the specified period in order for a port to be automatically disabled. Acceptable values are in the range of 1-255. You may also enter default for this argument, which will set the default limit value for this fencing policy type.
config 2 Command Example The meaning for each of these inputs can best be described using the following example sentence: If ports 0,1, or 2 have more than 5 protocol errors on a single port within a period of 30 minutes, disable the offending port. Where: Port list = 0, 1, 2 Fencing Type = Protocol Errors Limit =5 Period = 1800 seconds config.fencing.
config 2 Parameters This command has one optional parameter. name The name of the fencing policy. When no parameters are specified, the command will display the name, type, and state of all policies. If you use the optional parameter, it will display all the information about the policy. NOTE: When the name parameter isn't supplied, then only 50 characters of the names of the policies will be displayed. You will have to enable Comma Delimited Mode to view the full name.
config 2 The output from the config.fencing.show Policy_1 command displays as follows: Name: Ports: Type: Limit: Period: State: Policy_1 E ports Protocol Error 5 300 seconds Disabled config.fencing.showTypeTable Syntax Purpose Parameters Command Example Output Example showTypeTable This command displays the table of different fencing types that can be assigned to a policy. This table is used for reference only. This command has no parameters.
config 2 Command Example Root> config ficonCUPZoning addControlHost 01:02:03:04: 05:06:07:08 config.ficonCUPZoning.deleteControlHost Syntax Purpose Parameters deleteControlHost This command removes one or all control hosts from the Control Host List used to determine the FICON host(s) capable of viewing all ports. This list overrides the FCZ port visibility mask.
config 2 Command Example Root> config ficonCUPZoning setState 1 config.ficonCUPZoning.show Syntax Purpose Parameters Command Example Output Output Example show This command displays the contents of the host control list and the enabled state of FICON CUP Zoning. This command has no parameters.
config 2 Parameters This command has one parameter. timeout Command Example Valid values are 15, 30, 45, 60, 120, 180, 240, 300, 360, 420, 480, 540, and 600. Root> config ficonms setMIHPTO 180 config.ficonMS.setState Syntax Purpose setState ficonMSState 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.
config 2 config.ficonMS.show Syntax Purpose Parameters Command Example Output Output Example show This command shows the Ficon MS settings This command has no parameters. Root> config ficonMS show The data is displayed as a table that includes the following information: Ficon MS State The state of the FICON MS feature. Ficon MIHPTO The FICON MIHPTO value in seconds. The output from the config ficonMS show command displays as follows: Ficon MS State: Disabled Ficon MIHPTO (seconds): 180 config.ip.
config 2 Parameters Command Example This command has three parameters. ipAddress Specifies the new IP address for the director or switch. The address must be entered in dotted decimal format (for example, 10.0.0.0). gatewayAddress Specifies the new gateway address for the Ethernet interface. The address must be entered in dotted decimal format (for example, 0.0.0.0). subnetMask Specifies the new subnet mask for the Ethernet interface.
config 2 Output Output Example 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 config.NPIV.
config 2 config.NPIV.setState Syntax Purpose Parameters setState NPIVEnabledState This command sets enabled state of the NPIV feature. The NPIV feature key must be installed in order to enable this feature. This command has one parameter. NPIVEnabledState Command Example This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Root> config NPIV setState enable config.NPIV.
config 2 6 ... 130 NOTE: The command show.NPIV.config on page 2-159 has functionality that is the same as this command. config.openSysMS.setHostCtrlState Syntax Purpose Parameters setHostCtrlState HostContrlState This command sets the enabled state of the Open Systems Management Server Host Control. This command has one parameter: HostContrlState Command Example This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted.
config 2 NOTE: The command config.features.openSysMS on page 2-8 has functionality that is identical to this command. config.port.blocked Syntax Purpose Parameters Command Examples blocked portNumber blockedState This command sets the blocked state for a port. This command has two required parameters. portNumber Specifies the port number.
config 2 Parameters Command Example This command has two required parameters. portNumber Specifies the port number. Valid values are: 0–23 for the Sphereon 4500 fanOn Specifies the FAN state for the port. Valid values are true and false. Boolean 1 and 0 may be substituted as values. Root> config port fan 4 1 config.port.name Syntax Purpose Parameters Command Example name portNumber portName This command sets the name for a port. This command has two required parameters.
config 2 Parameters Command Example This command has two required parameters: portNumber Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 numBBCredits Specifies the number of Rx BB Credits to assign the specified port. For the Sphereon 4300 and Sphereon 4500 the RxCredits per port must be between 2 and 12.
config 2 Command Example Output Output Example Root> config port show 4 This command displays as a table that includes the following properties. Port Number The port number. Name The configured port name. Blocked The blocked state. Valid values are true and false. FAN The fabric address notification (FAN) state. Valid values are true and false. (Sphereon 4300 and Sphereon 4500 switches only.) Type The port type.
config 2 Parameters Command Example Output Output Example This command has no parameters. Root> config port showPortAddr The port configuration is shown as a table of properties. The following properties are displayed: Port The port number Original Addr The original port address of the port Current Addr The current port address of the port Swapped Port Num If the port is swapped with another port, it will show the port number of the port it is swapped with. Port ---0 1 2 3 4 5 6 7 8 ...
config 2 ATTENTION! Port speed changes temporarily disrupt port data transfers. Parameters Command Examples This command has two required parameters. portNumber Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 portSpeed Specifies the speed of the port. Valid values are 1g, 2g, and negotiate.
config 2 Purpose Parameters Command Example This command will swap two ports given the port numbers. The ports must be offline to perform this operation. This command has two required parameters: portNum1 Port number, in hexidecimal format, of the desired port to be swapped portNum2 Port number, in hexidecimal format, of the desired port to be swapped Root> config port swapPortByAddr 1e 1f config.port.type Syntax Purpose type portNumber portType This command sets the allowed type for a port.
config 2 Parameters This command has two required parameters. portNumber Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 portType Specifies the type of the port. Valid values for the port type are: eport fport gport fxport (Sphereon 4300 and Sphereon 4500 only) gxport (Sphereon 4300 and Sphereon 4500 only) Command Example config.
config 2 config.security.authentication.interface api.outgoing Syntax Purpose Parameters outgoing enabledState This command determines if outgoing CHAP authentication is used on all API sessions. If this is enabled, the switch will issue a CHAP challenge to authenticate all new API connections. This command has one parameter: enabledState Command Example This parameter enables and disables outgoing CHAP authentication for API sessions. Valid values for this parameter are enable or disable.
config 2 NOTE: A preferred method of local and a backup method of RADIUS is not an accepted combination because the local method can always be contacted. Command Example Root> config security authentication interface api sequence RADIUS local config.security.authentication.interface.cli.sequence Syntax Purpose Parameters sequence method1 [method2] This command sets the sequence that the CLI interface will use to authenticate.
config 2 NOTE: This command requires that the SANtegrity Authentication feature key be installed. Parameters This command has one parameter: enabledState Command Example This parameter enables and disables outgoing CHAP authentication on all ISLs. Accepted values for this parameter are enable or disable. Boolean 1 and 0 values may also be substituted. Root> config security authentication interface eport outgoing disable config.security.authentication.interface.eport.
config 2 NOTE: A preferred method of local and a backup method of RADIUS is not an accepted combination because the local method can always be contacted. Command Example Root> config security authentication interface eport sequence RADIUS local config.security.authentication.interface.nport.outgoing Syntax Purpose outgoing enabledState This command determines if outgoing CHAP authentication is used on N port connections.
config 2 Parameters This command has one required parameter, and one optional parameter: method1 This sets the preferred method of authentication. Accepted values are local or RADIUS. method2 This optional parameter sets the backup method of authentication. This backup method is used when the preferred method cannot be contacted. Accepted value is local. NOTE: A preferred method of local and a backup method of RADIUS is not an accepted combination because the local method can always be contacted.
config 2 config.security.authentication.interface.osms.setKey Syntax Purpose setKey This command sets the FCCT key that is associated to the single OSMS username. This username is a static entry in the local authentication database. This user is not viewable. This command effectively sets the key that will be used in all OSMS authenticated requests. This entry in the user database is only used for the OSMS interface, and cannot be changed.
config 2 Command Example Root> config security authentication serial enhancedAuth enable config.security.authentication.interface.show Syntax Purpose show interface This command displays the settings in the local authentication database for a single interface. NOTE: The SANtegrity Authentication feature key must be installed to view the eport and nport information, and the OSMS information. Parameters This command has one parameter.
config 2 Parameters This command has one required parameter, and one optional parameter: method1 This sets the preferred method of authentication for the CLI interface. Accepted values are local or RADIUS. method2 This optional parameter sets the backup method of authentication for the CLI interface. This backup method is used when the preferred method cannot be contacted. Accepted value is local.
config 2 Parameters Command Example This command has one required parameter, and one optional parameter: portNumber Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 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–143 for the Intrepid 6140 overrideState This parameter sets the outgoing authentication state for the specified port. Valid values are enable, disable, or default.
config 2 Port ---0 1 2 3 4 Override State -------------Default Default Enable Default Disable config.security.authentication.RADIUS.attempts syntax Purpose Parameters Command Example attempts index attempts This command configures the number of attempts a packet will be sent to a RADIUS server if a response is not received before the timeout. After the transmit attempt limit is reached, the switch will, if applicable, move on to the next defined RADIUS server. The default is 3 attempts.
config 2 Parameters This command has one required parameter: minutes Command Example The number of minutes a RADIUS server is marked “dead” before it is contacted again. Valid values are between 0 and 1440. Root> config security authentication RADIUS deadtime 120 config.security.authentication.RADIUS.deleteServer Syntax Purpose Parameters deleteServer index This command removes a RADIUS server from the RADIUS server list.
config 2 Parameters Command Example This command has one required parameter, and two optional parameters: index Index of the RADIUS server (1-3) to add/modify. IP IP address of the server. port The UDP port number. Root> config security authentication RADIUS server 3 14.2.114.183:6 config.security.authentication.RADIUS.show Syntax Purpose Parameters Command Example Output Output Example show This command displays the current RADIUS server configuration. This command has no parameters.
config 2 config.security.authentication.RADIUS.timeout Syntax Purpose Parameters Command Example timeout index seconds This command configures the number of seconds to wait for a response from the RADIUS server before retransmitting a packet. The default is 2 seconds. This command has two required parameters: index Index of the RADIUS sever (1-3) to change the timeout value. seconds The number of seconds before the RADIUS server retransmits. Valid values are between 1 and 1000.
config 2 Command Example Root> config security authentication switch setSecret config.security.authentication.user One of the fundamental concepts of the authentication portion of the Command Line Interface is that all secured interfaces have interchangeable users that are stored in a single local authentication user database. In the past, CLI has supported authorization for only two username/password pairs (one Administrator-level and another Operator-level).
config 2 username The new user name that will be added to the local authentication database. If the entered user name already exists in the user database, an error will be shown. This parameter can be from 1-23 characters in length for an API, Web or CLI username. E Port and N Port usernames must be entered as a standard colon delimited WWN. All characters in the printable USASCII character set are valid with the exception of spaces, single quotes, and double quotes.
config 2 Purpose Parameters This command deletes an entry from the local authentication database. Both the Web and CLI interfaces must have at least one valid username with an “Administrator” role. This command has one parameter: username Command Example A valid username in the local authentication database. Root> config security authentication user delete 01:2A:3f:4:5:0:0 config.security.authentication.user.
config 2 Parameters This command has two required parameters, and an additional password parameter at the prompt after the command: username The existing user name whose fields will be modified in the local authentication database. If the entered user name does not exist in the user database, an error will be shown. This parameter can be from 1-23 characters in length for an API, Web or CLI username. E Port and N Port usernames must be entered as a standard colon delimited WWN.
config 2 Purpose Parameters Command Example This command sets the role value that is associated to an existing username. The role value can either be set to an administrator or an operator. This value defaults to “none” when the user is first added to the database. This value must be changed for all new CLI and Web users before they will be allowed access to their respective interfaces. This command has two required parameters: username A valid Web or CLI username in the local authentication database.
config 2 Username ----------johndoe_1223 ewsOperator Operator Interfaces ----------Web,CLI Web Web,CLI Role ------------Administrator Operator Operator config.security.fabricBinding Fabric Binding functionality, provided by the SANtegrity Binding feature, allows you to bind the switch or director to specified fabrics so that it can communicate only with those fabrics.
config 2 • Active FBML: When fabric binding is active, the active FBML is the list of fabric members with which the product is allowed to communicate. If fabric binding is disabled, this list is empty. • Pending FBML: A list used to configure an FBML before it is made active on the product. Changes to the pending FBML are not implemented in the fabric until they are saved and activated using the config.security.fabricBinding.activatePending command as documented on page 2-53.
config 2 config.security.fabricBinding.activatePending Syntax Purpose activatePending This command activates the fabric binding configuration contained in the pending work area to the fabric. The Pending FBML becomes the Active FBML, and fabric binding is made functional. NOTE: This command takes effect immediately. The CLI verifies the list before activating it to the fabric. Parameters Command Example This command has no parameters. Root> config security fabricBinding activatePending config.
config 2 config.security.fabricBinding.addMember Syntax Purpose addMember wwn domainId This command adds a new member to the Pending FBML in the fabric binding work area. The number of entries is limited to the maximum available domain IDs for the fabric, which is 239. NOTE: Changes from this command are not activated to the fabric until the activatePending command is issued.
config 2 config.security.fabricbinding.deactivateFabBind Syntax Purpose deactivateFabBind This command deactivates the active FBML on the fabric. The Active FBML is erased when this command is executed. NOTE: This command takes effect immediately in the fabric. Parameters Command Example This command has no parameters. Root> config security fabricbinding deactivateFabBind config.security.fabricBinding.
config 2 config.security.fabricBinding.replacePending Syntax Purpose Parameters Command Example replacePending This command replaces the Pending FBML 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.showActive Syntax Purpose Parameters Output Output Example showActive This command displays the fabric binding configuration (active FBML) saved on the fabric.
config 2 config.security.fabricBinding.showPending Syntax Purpose Parameters Output Output Example showPending This command displays the pending FBML, which may not reflect what is active on the fabric. This command has no parameters. The fabric binding configuration data is displayed as a table that includes the following properties of the Pending FBML. Domain ID The domain ID of the FBML member. Valid domain ID's range from 1 to 239.
config 2 Purpose Parameters Command Examples 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.
config 2 Parameters This command has one parameter. portNumber Command Example Output Output Example Specifies the port number for which the port binding configuration will be shown.
config 2 Parameters 2-60 This command has two parameters. portNumber Specified the port number for which the bound WWN is being set. Valid port number values are: 0–11 for the Sphereon 4300 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–143 for the Intrepid 6140 boundWwn Specifies the WWN of the device that is being bound to the specified port.
config 2 Command Examples 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.ssh.resetKeys Syntax Purpose Parameters Command Example resetKeys This command resets the SSH (secure shell) encryption keys to their factory default (unconfigured). The next time a client connects using SSH the server will generate new keys.
config 2 Parameters Command Example Output Output Example This command has no parameters. config security ssh show The output of the config.security.ssh.show command displays the following data: SSH Indicates if the SSH interface to CLI is enabled or disabled. Telnet Indicates if the Telnet interface to CLI is enabled or disabled. SSH: Telnet: enabled disabled config.security.
config 2 NOTE: The starting IP address must be lesser than the ending IP address. Command Example Root> config security switchAcl addRange 10.0.0.0 10.0.0.2 config.security.switchAcl.deleteRange Syntax Purpose Parameters Command Example deleteRange startIPAddress endIPAddress This command deletes a range of IP addresses from the access control list. This range must exactly match one of the existing ranges in the access control list.
config 2 Command Example Root> config security switchAcl setState 1 config.security.switchAcl.show Syntax Purpose Parameters Command Example Output Output Example show This command displays the contents of the access control list. This command has no parameters. Root> config security switchACL show This command displays the following access control list information: Starting IP Address The starting IP Address of the range in the access control list.
config 2 You can use the Switch Binding commands to enable Switch Binding and to create and change the SBML. Switch Binding is available only if the SANtegrity Binding feature is installed. Enable, Disable and Online State Functions For Switch Binding to function, specific operating parameters and optional features must be enabled. Also, there are specific requirements for disabling these parameters and features: • Switch Binding can be enabled or disabled whether the product is offline or online.
config 2 config.security.switchBinding.deleteMember Syntax Purpose Parameters deleteMember wwn This command removes a member from the SBML. The user cannot remove any member currently logged into the switch. This command has one parameter: wwn Command Example Specifies the switch or N_Port device WWN of the member to be removed from the SBML. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00).
config 2 Parameters This command has one parameter: switchBindingState Command Example 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. E_Ports are prevented from forming ISL connections unless explicitly identified in the SBML. F_Port connections are allowed without restriction.
config 2 Output Output Example This command displays the following switch binding configuration data: switchBindingState The state of switch binding, which can have the following values: Disabled, Enabled and Restricting F_Ports, Enabled and Restricting E_Ports, or Enabled and Restricting All Ports. Switch Binding Membership List The WWNs of members of the SBML saved on the switch. The output from the config.security.switchBinding.show command displays as follows.
config 2 Parameters Command Example 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. The community name must not exceed 32 characters in length. Valid characters include all those in the ISO Latin-1 character set.
config 2 Parameters This command has one parameter. enabledState Command Examples Specifies whether the authentication traps are enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values. Root> config snmp authTraps enable Root> config snmp authTraps 1 config.snmp.deleteCommunity Syntax Purpose Parameters deleteCommunity commIndex This command entirely deletes a community from the SNMP. This command has one parameter.
config 2 config.snmp.setState Syntax Purpose Parameters setState enabledState This command enables or disables the SNMP agent. When disabled, the SNMP agent does not respond to any requests or send any traps. This command has one parameter. enabledState Command Example Sets the state of the SNMP agent. This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Root> config snmp setState 1 config.snmp.
config 2 Output Example Community Name The name of the community. WriteAuth The write authorization state. Trap Recipient The address of the trap recipient shown in 4-byte dotted-decimal format. UDP Port The user datagram protocol (UDP) port number to which the director will send traps for each recipient. The output from the config.snmp.show command displays as follows. SNMP Agent State: Enabled FA MIB Version Number: 3.
config 2 fabric to provide additional connection information to host bus adapters (HBA) and storage devices. As an example, this information might be that a logical path has been broken because of a physical event, such as a fiber optic cable being disconnected from a port. Parameters This command has one parameter. domainRSCNState Command Example Specifies whether the domain RSCN state is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values.
config 2 Parameters This command has one parameter. insistentDomainIdState Command Example Specifies whether the insistent domain ID state is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values. Root> config switch insistDomainId 1 NOTE: The Insistent Domain ID must be enabled, if the Enterprise Fabric Mode (an optional SANtegrity feature) or Preferred Path is enabled. config.switch.
config 2 Purpose Parameters This command sets the status of limited fabric RSCNs. When enabled, fabric register for state change notifications (RSCNs) are suppressed during an IPL. This command has one parameter. ltdFabRSCNState Specifies whether the limited fabric RSCN state is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values. Command Example Root> config switch ltdFabRSCN 1 config.switch.
config 2 Parameters This command has one parameter. Priority Specifies the switch priority. Valid values are: principal, default, or neverprincipal. principal — sets the numerical switch priority to 1. The switch with a priority of 1 becomes the principal switch; however, if two or more switches have a priority of 1, the switch with the lowest WWN becomes the principal switch. default — sets the numerical switch priority to 254.
config 2 Parameters This command has one parameter. timeoutValue Command Example Specifies the new R_A_TOV value. The units for this value are tenths of a second. This parameter must be an integer in the range 10–1200 (1 second to 120 seconds), and it must be larger than the E_D_TOV. Root> config switch raTOV 20 config.switch.rerouteDelay Syntax Purpose rerouteDelay rerouteDelayState This command enables or disables rerouting delay for the switch.
config 2 Parameter This command has one parameter. rerouteDelayState Command Examples Specifies whether rerouting delay is enabled. Valid values are true and false. Boolean 1 and 0 may be substituted as values. Root> config switch rerouteDelay true Root> config switch rerouteDelay 1 config.switch.speed Syntax Purpose speed switchSpeed This command sets the speed for the switch. NOTE: This command is only applicable for the Intrepid 6064.
config 2 Purpose This command shows the switch configuration. NOTE: The switch can be either offline or online when this command is executed. Parameters Command Example Output This command has no parameters. Root> config switch show The switch configuration data is displayed as a table that includes the following properties. BB Credit The maximum number of outstanding frames that can be transmitted without causing a buffer overrun condition at the receiver.
config 2 Output Example Zoning RSCN When enabled, allows zoning RSCNs to be sent to registered members of the fabric. Limited Fabric RSCN When enabled, fabric RSCNs are suppressed after an IPL. Zone Flex Pars When set to fabric, RSCNs will only be sent to affected fabric members when zoning information changes. When set to none, filtering of RSCNs will not take place, and RSCNs will be sent to all zoneset members when zoning information changes. The output from the config.switch.
config 2 Parameters This command has one parameter: zoneFlexParsState This parameter can be set to fabric and none. When set to fabric, RSCNs will only be sent to affected fabric members when zoning information changes. When set to none, filtering of RSCNs will not take place, and RSCNs will be sent to all zoneset members when zoning information changes Command Example Root> config switch zoneFlexPars fabric config.switch.
config 2 Parameters This command has one parameter. systemContact Command Example Specifies the new system contact string for the director or switch. The contact can contain 0–255 characters. Root> config system contact Joe config.system.date Syntax date systemDate systemTime Purpose This command sets the system date and time. Parameters This command has two required parameters. Command Examples systemDate Specifies the new system date.
config 2 Parameters This command has one parameter. systemDescription Specifies the new system description string for the director or switch. The name can contain 0–255 characters. Command Example Root> config system description McDATA Intrepid 6064 Fibre Channel Director config.system.location Syntax Purpose Parameters location systemLocation This command sets the system location attribute. This command has one parameter.
config 2 Purpose Parameters Command Example Output Output Examples 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.show command displays as follows.
config 2 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. In this case, you must use node WWNs as zone members. NOTE: A Sphereon 4300 Switch cannot participate in a fabric, unless the Fabric Capable feature is enabled. For more information, see the McDATA Sphereon 4300 Switch Installation and Service Manual (620-000171).
config 2 NOTE: If the interoperability mode for the switch or director is set to Open Fabric 1.0 mode when the zone is activated, any zone members specified by port number are ignored. config.zoning.addPortMem Syntax Purpose 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. NOTE: Port numbers cannot be used for zone members if the interoperability mode for the switch or director is set to Open Fabric 1.
config 2 config.zoning.addWwnMem Syntax Purpose addWwnMem zoneName wwn This command adds a WWN zone member to the specified zone in the work area. NOTE: A product can have at most 1024 zone members in its zones. NOTE: The ED-5000 supports a maximum of 512 zones. Parameters Command Example This command has two parameters. zoneName Specifies the name of the zone. wwn The WWN of the member to be added to the zone.
config 2 Parameters This command has one parameter. zoneName Command Example Specifies the name of the new zone. The zoneName must contain 1–64 characters. Valid characters are: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef ghijklmnopqrstuvwxyz0123456789$-^_ Spaces are not permitted, and the first character must be alphabetical. Root> config zoning addZone TheUltimateZone config.zoning.
config 2 config.zoning.deactivateZoneSet Syntax Purpose deactivateZoneSet This command places all attached devices in the default zone and takes effect immediately for the entire fabric. This command clears both the active zone set and the working area. This command takes effect immediately in the fabric. NOTE: The default zone must be activated independently of this command. Parameters Command Example This command has no parameters. Root> config zoning deactiveZoneSet config.zoning.
config 2 config.zoning.deleteWwnMem Syntax Purpose Parameters Command Example deleteWwnMem zoneName wwn This command removes a WWN member from a zone that is in the work area. This command has two parameters. zoneName Specifies the name of the zone that contains the member to be deleted. wwn Specifies the WWN of the member to be deleted from the zone. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00).
config 2 config.zoning.renameZone Syntax Purpose Parameters Command Example 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.
config 2 Command Example Root> config zoning renameZoneSet TheUltimateZoneSet config.zoning.replaceZoneSet Syntax Purpose Parameters Command Example 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 config.zoning.setDefZoneState Syntax Purpose setDefZoneState defaultZoneState This command enables or disables the default zone and takes effect immediately fabric wide.
config 2 Output The zoning configuration data is displayed as a table that includes the following properties. Active ZoneSet Output Example The enabled status, name, and member zones of the zone set. The output from the config.zoning.showActive command displays as follows.
config 2 Pending Zone Set Default Zone Enabled: False ZoneSet: TheNewUltimateZoneSet Zone: TheNewUltimateZone ZoneMember: Domain 10, Port 6 ZoneMember: Domain 15, Port 2 Zone: TheNewNotSoUltimateZone ZoneMember: 10:00:00:00:C9:22:9B:AB ZoneMember: 10:00:00:00:C9:22:9B:C6 ZoneMember: 10:00:00:00:C9:22:9B:AB Zone: TheNewNotUltimateAtAllZone ZoneMember: Domain 2, Port 63 2-94 Enterprise Operating System Command Line Interface User Manual
maint 2 maint The maint branch of the CLI command tree contains commands that relate to maintenance activities. The commands in the maint branch can be used only by the administrator. Note that the maint.system.resetConfig command resets all configuration data and non-volatile settings, including network information, to their default values (factory settings). Management access may be lost until the network information is restored. maint.port.
maint 2 maint.port.reset Syntax Purpose reset portNumber This command resets a port. 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. The reset also clears all statistics counters and disables port beaconing for the specified port.
maint 2 maint.system.clearSysError Syntax Purpose Parameters Command Example clearSysError This command clears the system error light. This command has no parameters. Root> maint system clearSysError maint.system.ipl Syntax Purpose ipl This command IPLs the switch. ATTENTION! Connection to the CLI is lost when this command runs. Parameters Command Example This command has no parameters. Root> maint system ipl maint.system.
maint 2 Command Example Root> maint system resetConfig maint.system.setOnlineState Syntax Purpose Parameters setOnlineState onlineState This command sets the switch online or offline. This command has one parameter. onlineState Command Examples Specifies whether the switch is online. Valid values are true and false. Boolean 1 and 0 may be substituted as values.
perf 2 perf The perf branch of the CLI command tree contains commands that relate to performance services. The commands in the perf branch can by used by either the administrator or the operator. The counters in perf command output are 32-bit values that wrap at 4,294,967,296. To calculate the full value of a counter, multiply 4,294,967,296 by the value in the wrap field, and add the resulting product to the value in the count field.
perf 2 Output Example 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.
perf 2 Parameters This command has one parameter. portNumber Command Example Output Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 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–143 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.
perf 2 Output Example The output from the perf.class3 command displays as follows. Port 2 Statistic ---------------RxFrames TxFrames RxWords TxWords Disc Frames Wrap -------3 2 65 32 26 Count -------2953184 1842953 2953184 1842953 2953184 perf.clearStats Syntax Purpose Parameters clearStats portNumber This command resets all port statistics for an individual port or for all ports. This command has one parameter. portNumber Command Example Specifies the port number.
perf 2 Parameters This command has one parameter. portNumber Command Example Output Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 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–143 for the Intrepid 6140 Root> perf errors 2 The port error counter data is displayed as a table that includes the following statistics. Port The port number.
perf 2 Output Example The output from the perf.errors command displays as follows. Port 2 Statistic ----------Prim Seq Err Disc Frms Inv Tx Wrds CRC Errs Delim Errs Addr Id Errs FrmsTooShrt Count ---------753452 351269 2953184 1842953 2953184 1842953 40059 perf.link Syntax Purpose Parameters link portNumber This command displays port link counters for a single port. This command has one parameter. portNumber Command Example Output 2-104 Specifies the port number.
perf 2 Output Example Reset Out The number of link resets initiated by this director or switch. LIPS In The number of Loop Initialization Primitives (LIPS) detected on this switch loop port. LIPS Out The number of LIPS generated on this switch loop port. Link Flrs The number of times the port has detected a link error resulting from an invalid link state transition or timeout.
perf 2 Parameters This command has one parameter. backPressureState Command Example This parameter can be set to enable or disable OpenTrunking back pressure. Boolean 1 and 0 values may also be substituted. If the state is configured to be enabled, a back pressure entry is made to the Event Log and an SNMP trap is generated if SNMP is configured. Root> perf openTrunking backPressure 1 perf.openTrunking.
perf 2 as the percentage of time that no transmit BB_Credits are passed on the link. When the threshold value is exceeded, the system tries to reroute the flows that are going to the ISL with the problem. Effectively, the threshold is the percent of the time that the port does not receive BB_Credits before traffic is rerouted away from the port. This threshold is also used for prevention of improperly rerouting to an ISL that lacks BB_Credits.
perf 2 NOTE: The command config.features.openTrunking on page 2-8 has functionality that is identical to this command. perf.openTrunking.show Syntax Purpose Parameters show portNumber This command displays the current OpenTrunking configuration per port. This command has one parameter. portNumber Command Example Output 2-108 Specifies the port number.
perf 2 Output Example Backpressure The current enabled/disabled state of the backpressure trunking feature. (The indicated state applies to every port on the product.) Low BB Credit Threshold The current threshold setting of the Low BB Credit Threshold trunking feature. If the value is a default value, (default) is displayed next to the percentage. (The indicated value applies to every port on the product.) The output from the perf.openTrunking.show command displays as follows.
perf 2 perf.preferredPath The perf.preferredPath commands enable you to use the Preferred Path feature to influence the route of data traffic that traverses multiple switches or directors in a fabric. If more than one ISL connects switches in your SAN, this feature is useful for specifying an ISL preference for a particular flow. The Preferred Path feature allows the user to enhance the system’s path selection algorithm by providing the ability to prioritize ISLs for a selected port on the switch.
perf 2 the preferred path. All configured paths can be removed by specifying the all parameter for both the destination domain ID and source port. Parameters Command Example This command has the following parameters. destDomainId Specifies the destination domain ID. Valid domain IDs are in the range 1–31 or all, which deletes all preferred paths to and from the source port specified in the sourcePort parameter. sourcePort Specifies the number of the source port.
perf 2 Parameters Command Example This command has the following parameters. destDomainId Specifies the destination domain ID. Valid domain IDs are in the range 1–31. sourcePort Specifies the number of the source port.
perf 2 Parameters This command has one parameter. enabledState Command Example Sets the state of the preferred path feature. When disabled, the preferred path settings are ignored for all path selection decisions. Accepted values for this command are enable and disable. Boolean 1 and 0 may be substituted as values. Root> perf preferredPath setState enable perf.preferredPath.showPath Syntax Purpose showPath destDomainID sourcePort This command displays the requested Preferred Path configuration.
perf 2 Parameters Output 2-114 This command has the following parameters. destDomainId Specifies the destination domain ID. Valid domain IDs are in the range 1–31 or all, which shows all paths to and from the source port specified in the sourcePort parameter. sourcePort Specifies the number of the source port.
perf 2 Command and Output Examples The following examples show the output returned by the three methods of specifying the perf.preferredPath.showPath command.
perf 2 perf.thresholdAlerts The perf.thresholdAlerts commands enable you to configure alerts that notify you of specific conditions on your system. You can configure a maximum of 16 threshold alerts, including both counter threshold alerts (CTAs) and throughput threshold alerts (TTAs). Each of these types of alerts have commands that are specific to the alert type. • Counter threshold alerts: These are alerts that are triggered by counts of events.
perf 2 3. Configure the threshold alert using other perf.thresholdalert commands. For example, you may want to associate the threshold alert counter with the threshold alert name using the perf.thresholdAlerts.counter.setCounter command, described on 2-123. Use the following commands to view alert settings and configure an alert: • perf.thresholdAlerts.counter.removePort on page 2-122 • perf.thresholdAlerts.counter.setCounter on page 2-123 • perf.thresholdAlerts.counter.setParams on page 2-124 • perf.
perf 2 5. Configure the threshold alert using other perf.thresholdalert commands. For example, you may want to set the duration and interval times for the alert, as described in perf.thresholdAlerts.throughput.setParams on page 2-134. Use the following commands to view alert settings and configure an alert: • perf.thresholdAlerts.throughput.removePort on page 2-131 • perf.thresholdAlerts.throughput.setParams on page 2-134 • perf.thresholdAlerts.throughput.show on page 2-135 • perf.thresholdAlerts.
perf 2 Table 2-3 Alert Counters (Continued) Number Threshold Alert Counter or Counter Set 6 Sync Losses 7 Signal Losses 8 Protocol Errors 9 Invalid Tx Words 10 CRC Errors 11 Discarded Frames 12 Frames Too Short 13 Delimiter Errors 14 Address ID Errors 15 Class2BusiedFrames 16 Class2RejectedFrames 17 Class3DiscardedFrames 18 Physical Link Errors Set (see below) 19 Link Sequence Counts Set (see below) 20 Logical Link Errors Set (see below) 21 LIPS Detected (Sphereon 4300 an
perf 2 Description of Summed Sets Some of the threshold alerts consist of groups of related items called Summed Sets. When any of the items in the summed set are encountered, the total value of the summed set counter is incremented.
perf 2 Parameters • Interval: 60 minutes • State: Disabled This command has one parameter. name Specifies the name of the new counter threshold alert. This name can consist of any ASCII characters up to a maximum length of 64 characters. To use spaces or special characters in this name, put quotation marks around the name. This parameter is case-sensitive. TIP: Although the system supports a name length of 64 characters, you may want to use a much shorter name.
perf 2 Parameters This command has the following parameters. name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert on page 2-120. portNumber Specifies the port number or port type.
perf 2 NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. Parameters Command Example This command has the following parameters. name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert, described on 2-120. portNumber Specifies the port number.
perf 2 Parameters Command Example This command has the following parameters. name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert, described on 2-120. counterNumber Specifies the counter number. Valid values are shown in Table 2-3, Alert Counters, page 2-118. Root> perf thresholdAlerts counter setCounter checklinks 1 perf.thresholdAlerts.counter.
perf 2 If ports 0,1, or 2 CRC Error counter increments more then 5 times within a period of 30 minutes, send an alert. Where: Port list CTA Counter Increment value Interval Time = = = = 0, 1, 2 CRCErrors 5 30 The increment value takes place in an interval that is a fixed length amount of time. This interval is not a rolling window interval. Command Example Root> perf thresholdAlerts counter setParams checklinks 5 30 perf.thresholdAlerts.counter.
perf 2 Interval: Alert State: 30 Disabled perf.threshholdAlerts.counter.showStatisticTable Syntax Purpose showStatisticTable This command displays the table of different statistic counters that can be added to a counter threshold alert. This table is used for reference only. This command has no parameters. Command Example Output Example Root> perf threshAlerts counter showStatisticTable The output from the perf.thresholdAlerts.counter.showStatisticTable command displays as follows.
perf 2 perf.thresholdAlerts.deleteAlert Syntax Purpose deleteAlert name This command deletes a specified threshold alert. NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. Parameters This command has one parameter. name Command Example The name of a threshold alert as defined by the commands perf.thresholdAlerts.counter.addAlert and perf.thresholdAlerts.throughput.
perf 2 Purpose Parameters Command Example Output This command displays information about all threshold alerts. This command has no parameters. Root> perf thresholdAlerts show The data is displayed as a table that includes the following properties: Name The name of the threshold alert (truncated to 51 characters). Type The trigger statistic or threshold type of the alert (abbreviated to 17 chars).
perf 2 Address ID Errors CTA - Address ID Errors State Cls2 BusiedFrms CTA - Class 2 Busied Frames Cls2 RejectedFrms CTA - Class 2 Rejected Frames Cls3 DiscardFrms CTA - Class 3 Discarded Frames Phys Lnk Err Set CTA - Physical Link Errors Summed Set Lnk Seq Cnt Set CTA - Link Sequence Counts Summed Set Logic Lnk Err Set CTA - Logical Link Errors Summed Set LIPs Detected CTA - Loop Initialization Primitive Detected LIPs Generated CTA - Loop Initialization Primitive Generated The enabled st
perf 2 Parameters • Ports: None • Utilization Type: None • Utilization Percentage: 50% • Duration: 30 minutes • Interval: 60 minutes • Alert State: Disabled This command has the following parameter. name Specifies the name of the new throughput threshold alert. This name can consist of any ASCII characters up to a maximum length of 64 characters. To use spaces or special characters in this name, put quotation marks around the name. This parameter is case-sensitive.
perf 2 Parameters This command has the following parameters. name The name of a throughput threshold alert as defined by the command perf.thresholdAlerts.throughput.addAlert, described on 2-129. portNumber Specifies the port number or port type. Valid values are either a single port number, all ports, or port type.
perf 2 NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. Parameters Command Example This command has the following parameters. name The name of a throughput threshold alert as defined by the command perf.thresholdAlerts.throughput.addAlert, described on 2-129. portNumber Specifies the port number.
perf 2 Parameters Command Example This command has the following parameters. name The name of a throughput threshold alert as defined by the command perf.thresholdAlerts.throughput.addAlert, described on 2-129. utilizationType The type of traffic that triggers the alert. Enter the number that corresponds to the desired utilization type: 1 - Transmit Traffic (Tx) 2 - Receive Traffic (Rx) 3 - Both (Rx and Tx) Root> perf thresholdAlerts throughput setUtilType eportRx 1 perf.thresholdAlerts.throughput.
perf 2 perf.thresholdAlerts.throughput.setParams Syntax Purpose Parameters Command Example 2-134 setParams name duration interval This command sets the duration and interval times for a specified throughput threshold alert. This command enables you to configure the alert to be sent if both of the following events occur: • The throughput threshold alert value is surpassed for more than the timespan specified for the duration parameter.
perf 2 perf.thresholdAlerts.throughput.show Syntax Purpose Parameters show name This command displays the settings for an individual throughput threshold alert. This command has the following parameter. name The name of a throughput threshold alert as defined by the command perf.thresholdAlerts.throughput.addAlert, described on 2-129. You can specify all instead of a name, which means that all threshold alerts are displayed.
perf 2 Parameters Command Example Output Example This command has no parameters. Root> perf thresholdAlerts throughput showUtilTypeTable The output from the perf.thresholdAlerts.throughput.showUtilTypeTable command displays as follows. Number -----1 2 3 Utilization Type ---------------------Transmit Traffic (Tx) Receive Traffic (Rx) Both (Tx/Rx) perf.traffic Syntax Purpose Parameters traffic portNumber This command displays port traffic counters for a specified port. This command has one parameter.
perf 2 Output Example TxFrames The number of Fibre Channel Class 2 and Class 3 frames that the port has transmitted. RxWords The number of 4-byte words in Class 2 and Class 3 frames that the port has received. TxWords The number of 4-byte words in Class 2 and Class 3 frames that the port has transmitted. The output from the perf.traffic command displays as follows.
show 2 show 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. show.
show 2 • show.features • show.security.portbinding • show.security.switchbinding • show.security.fabricbinding • show.openTrunking.config • show.thresholdAlerts.alerts • show.fabric.topology • show.fabric.nodes • show.security.switchACL • show.ficonCUPZoning • show.FencingPolicies show.auditLog Syntax Purpose Parameters auditLog [clear] This command displays the entries of the audit log after the last time the log was cleared. This command has one optional parameter.
show 2 Output Example Date/Time ---------11/24/03 04:18P 11/24/03 03:38P 11/24/03 03:38P 11/24/03 11:27A Action Source ----------------Switch set online CLI Switch name modifiedCLI Switch set offline CLI Firmware downloaded Web User Id ------------172.16.22.23 172.16.22.23 172.16.22.23 172.60.5.40 show.epFrameLog.config Syntax Purpose config This command shows the current Embedded Frame Log settings Parameters This command has no parameters.
show 2 Parameters This command has one optional parameter. If no parameters are entered, it will show the current state. enable Command Example Specifies the on/off state. Valid values are enable and disable. Boolean 1 and 0 values may also be substituted. Root> show epFrameLog filterClassFFrames enable show.epFrameLog.setFilterPort Syntax Purpose Parameters setFilterPort This command sets the port number that the Embedded Port Frame Log will use for logging.
show 2 show.epFrameLog.noWrap Syntax Purpose noWrap [clear] This command allows the user to view the contents of the non-wrapping region of the FC2 frame log. The log entries will not persist IMLs or power cycles; it will not be stored in NV RAM. This log will not include entries for frames discarded by hardware, such as un-routable class-3 frames unless class-3 discard is disabled in the hardware. NOTE: This log will not wrap. The log will stop collecting entries after is it filled.
show 2 Output Example Count -----39 Header: PL: 38 Header: PL: 37 Header: PL: The output of the show.epFrameLog.
show 2 Output Example Count -----39 Header: PL: 38 Header: PL: 37 Header: PL: Direction Direction of the frame through the port (I = In, O = Out). SOF Start of frame. EOF End of frame. Header The 24 byte FC frame header. PL (size in bytes) The first 32 bytes of the FC frame payload. The output of the show.epFrameLog.
show 2 Output Output Example Date/Time ---------------04/12/01 10:58A 04/12/01 9:58A 04/11/01 7:18P Code ---375 385 395 The event log data are displayed as a table that includes the following properties. Date/Time The date and time when the event occurred. Code The event reason code. Severity The severity of the event. The values are: • Major—Unit operational (major failure). • Minor—Unit operational (minor failure). • Severe—Unit not operational.
show 2 Parameters This command has one optional parameter. If no parameter is specified, then the 200 entries of the log will be displayed. clear Command Example Output Output Example Removes all entries from the log. show fabricLog noWrap This command displays the following data. Count A constantly incrementing counter. Date/Time The date and time of the log entry. Description A description of the log entry. Data Extended data that is associated to the log entry. The output of the show.
show 2 Purpose This command allows the user to view the contents of the wrapping region of the fabric log. The log entries will not persist IMLs or power cycles; it will not be stored in NV RAM. NOTE: This log will begin to wrap after the log is filled. Parameters This command has one optional parameter. If no parameter is specified, then the 1000 entries of the log will be displayed. clear Command Example Output Output Example Removes all entries from the log.
show 2 show.fabric.nodes Syntax Purpose Parameters Command Example Output Output Example nodes This command displays a list of all fabric-attached nodes. This command has no parameters. Root> show fabric nodes The data is displayed as a table that includes the following properties. Domain ID Domain ID of the switch to which the device is attached. Node WWN The WWN of the fabric attached node. The output from the show.fabric.nodes command displays as follows.
show 2 Output Example Principal Switch WWN: 00:00:00:00:00:00:00:00 show.fabric.topology Syntax Purpose Parameters Command Example Output Output Example topology This command displays a text description of the fabric. The principal switch in the fabric will have a "*" next to it. This command has no parameters. Root> show fabric topology The features data is displayed as a table that includes the following properties. Switch WWN The WWN of the switch at the local end of the ISL.
show 2 show.features Syntax Purpose Parameters Command Example Output Output Example features This command displays a table of all installed feature sets and their states. This command provides the same output as the command config.features.show on page 2-9. This command has no parameters. Root> show features The features data is displayed as a table that includes the following properties. Installed Feature Set The feature set installed using a feature key. Only installed keys are displayed.
show 2 Parameters Command Example Output Output Example This command has one optional parameter, an individual policy name. If an individual policy name is given, then a detailed description will be shown for the specified policy. If no parameter is given, then a summary of all policies will be shown. Root> show fencing Root> show fencing Protocol Errors #2 The data is displayed as a table that includes the following properties: Name The name of the policy.
show 2 show.ficonCUPZoning Syntax Purpose ficonCUPZoning This command displays the contents of the host control list and the enabled state of FICON CUP Zoning. NOTE: The command config.ficonCUPZoning.show on page 2-18 has functionality that is the same as this command. Parameters Command Example Output Output Example This command has no parameters.
show 2 Output Output Example The data is displayed as a table that includes the following properties: Ficon MS State The state of the Ficon MS feature. Ficon MIHPTO The Ficon MIHPTO value in seconds. Ficon MS State: Ficon MIHPTO (seconds): Disabled 180 show.frus Syntax Purpose Parameters Command Example Output 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.
show 2 Output Example FRU ----CTP CTP SBAR SBAR FPM FPM UPM Power Fan Position -------0 1 0 1 1 3 4 0 0 State -----Active Backup Active Failed Active Active Active Active Active The output from the show.frus command displays as follows.
show 2 Purpose This command shows the contents of the link incident log on the director or switch. ATTENTION! If the switch is restarted (as occurs during IPL, IML, configuration reset, feature key installation, or firmware load) or is power cycled, the information in the link incident log is lost. Parameters This command has one parameter.
show 2 more than one device per port for any public loop devices attached to an FL Port. Parameters Command Example Output Output Example Port ---0 1 4 7 8 10 11 12 13 15 BB Crdt ------10 10 10 10 10 10 10 10 10 10 RxFldSz ------- This command has no parameters. Root> show loginServer The device information is displayed as a table that includes the following properties. Port The port number where the device is attached.
show 2 Purpose Parameters Command Example Output 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). Port Id The 24-bit Fibre Channel address.
show 2 Output Example 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.
show 2 Parameters Command Example Output Output Example This command has no parameters. Root> show nameServerExt 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).
show 2 NOTE: The command config.NPIV.show on page 2-23 has functionality that is identical to this command. Parameters Command Example Output This command has no parameters. Root> show NPIV config This command displays the following NPIV configuration data: NPIV state The current enabled/disabled state of the NPIV feature. Max Allowed A table mapping each port number on the NPIV Login Table switch to a corresponding max number of NPIV logins setting.
show 2 Output Output Example The configuration data is displayed as a table that includes the following properties: openSysMS State The Open System Management Server state. Host Control State The Open System Management Server Host Control state. openSysMS State: disable Host Control State: enable show.openTrunking.config Syntax Purpose Parameters Command Example Output config This command displays the trunking configuration for all ports. This command has no parameters.
show 2 Output Example The output from the show.openTrunking.config command displays as follows. Unresolved Congestion: Backpressure: Low BB Credit Threshold (%): Port Threshold % ---- -----------1 60 (default) 2 69 3 60 (default) 4 60 (default) 5 90 ... Enabled Disabled 75 (default) show.openTrunking.rerouteLog Syntax Purpose reroutelog [clear] This command displays Open Trunking Re-route Log information.
show 2 Output Output Example The device information data is displayed as a table that includes the following properties. Date/Time The date/time when the rerouting event occurred. Rcv The port associated with the flow that was rerouted. Dom The target domain associated with the flow that was rerouted. Old The exit port number on this switch that the flow used to get to the target domain. New The exit port number on this switch that the flow now uses to get to the target domain.
show 2 Output Example Port ---0 1 2 ... Name -------------Port_0_name FAN The configured fabric address notification (FAN) state. (Sphereon 4300 and Sphereon 4500 switches only.) Type The port type as set in the config.port.type command. Speed The port speed as set in the config.port.speed command. Rx Crdts The number of Rx BB Credits as set in the config.port.rxCredits command. The output from the show.port.config command displays as follows.
show 2 Parameters Output This command has the following parameters. destDomainId Specifies the destination domain ID. Valid domain IDs are in the range 1–31, or, use all to show all exit ports to and from the source port specified in the sourcePort parameter. sourcePort Specifies the number of the source port.
show 2 Command and Output Examples The following examples show the output returned by the three methods of specifying the show.port.exit command.
show 2 Output Output Example 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). The output from the show.port.info command displays as follows.
show 2 Parameters This command has one parameter. portNumber Command Example Output 2-168 Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 0–31 for the ED-5000 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 Root> show port nodes portNumber The port nodes data is displayed as a table that includes the following properties.
show 2 Output Example FCAddr -----612902 612903 612904 612905 6129AB 6129AC 6129AD 6129AE 6129FD 6129FE BB Crdt ------10 10 10 10 8 10 8 10 10 10 The show.port.
show 2 Output Example Port ---0 1 2 3 4 Xvr --UNK UNK UNK UNK XFP RX Pwr The Receiver power in uW. 1.8 Voltage The 1.8 Voltage in Volts. 5.0 Voltage The 5.0 Voltage in Volts. The show.port.opticEDD command output displays as follows: Temp 3.3 Volt ----- -------Unknown Unknown Unknown Unknown Unknown Unknown Unknown Unknown 36.105 3.256 Current ------Unknown Unknown Unknown Unknown 5.324 TX Power --------Unknown Unknown Unknown Unknown 602.100 RX Power 1.
show 2 Output Example Port ---0 1 2 3 4 Xvr --UNK UNK UNK UNK XFP The show.port.opticInfo command output displays as follows: Temp 3.3 Volt ----- -------Unknown Unknown Unknown Unknown Unknown Unknown Unknown Unknown 36.105 3.256 Current ------Unknown Unknown Unknown Unknown 5.324 TX Power --------Unknown Unknown Unknown Unknown 602.100 RX Power 1.8 Volt --------- -------Unknown Unknown Unknown Unknown Unknown Unknown Unknown Unknown 289.300 1.779 5.0 Volt ------Unknown Unknown Unknown Unknown 4.
show 2 Port WWN Port WWN. Configured Type Configured port type. Configured Speed Configured port speed. Output Example Beaconing Beaconing state. FAN FAN state. FC Address The Port Fibre Channel address. Attached WWN The node WWN of the device at the remote end of the link. A loop port will display the first attached loop device. Operational State The operational state of the port. Reason The reason that the port operational state is not “online”.
show 2 FAN: FC Address: Attached WWN: Operational State: Reason: Rx BB Credits: Connector Type: Transceiver: Distance Capability: Media Type: Speed Capability: 10G FC Compliance: Disabled 034FA2 F0:01:02:A1:B0:22:00:12 Online None 12 LC Long LC Long M-M 50um 2 Gb/sec None show.port.showPortAddr Syntax Purpose showPortAddr This command displays the port address configuration for all ports. NOTE: The config.port.showPortAddr on page 2-28 has functionality that is identical to this command.
show 2 Output Example Port ---0 1 2 3 4 5 6 7 8 ... Original Addr ------------4 5 6 7 8 9 a b c Current Addr -----------4 5 7 6 8 9 a b c SwappedPort Num ---------------- 3 2 show.port.status Syntax Purpose Parameters Command Example Output 2-174 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.
show 2 Attached WWN The WWN of the device or switch attached to the port, if one is attached. Beaconing The beaconing state for the port (Off or On). 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.
show 2 Reason (cont.) If the operational state is Inactive only the following messages can be generated: • • • • Output Example Port ---0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 State ---------------Online Online No Light Offline Online Port Failure Link Reset Segmented E_Port Online Offline Inactive Online No Light Online Invalid Attachment Online 24: Inactive - RC 0 25: No Serial Number 26: Feature Not Enabled 27: Switch Speed Conflict The output from the show.port.status command displays as follows.
show 2 show.port.technology Syntax Purpose Parameters Command Example Output Output Example 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).
show 2 show.preferredPath.showPath Syntax Purpose showPath destDomainID sourcePort This command displays the specified Preferred Path configuration and the actual path used by the system. The output shows both the exit port as configured for the Preferred Path feature and the actual exit port currently being used for traffic. Use all for one of the command’s parameters to display all configured and actual exit ports for either the destination domain ID or the specified source Port.
show 2 Output Command and Output Examples The output from show.preferredPath.showPath includes the following parameters. Destination Domain The destination domain ID to which a preferred path has been configured. This is displayed only if the destination domain parameter is set to all. Source Port The source port for which a preferred path to the specified destination domain ID is specified. This is displayed only if the source port parameter is set to all.
show 2 sourcePort set to all Root> show preferredPath showPath 1 all Preferred Path State: Enabled Source Port Preferred Exit Port ------------------ ------------------0 2 2 5 3 17 22 5 Actual Exit Port ---------------No Source 5 No Path 6 show.security.fabricBinding Syntax Purpose Parameters Command Example Output Output Example fabricBinding This command displays the fabric binding configuration saved on the fabric. The command performs the same function as config.security.fabricBinding.showActive.
show 2 show.security.log Syntax Purpose Parameters log [clear] This command shows the contents of the security log as maintained in NV-RAM on the director or switch. This command has one parameter. clear Command Example Output Output Example Reason -----10000 Desc: This optional parameter causes all security log entries to be cleared. Root> show security log The security log data are displayed as a table that includes the following properties. Reason The reason code for the security event.
show 2 Data: 10305 Desc: Data: 10300 Desc: Data: 10411 Desc: Data: Usr=Administrator IPaddr=001.002.003.004 Role=admin 04/11/01 01:03A Error Authorization Failure 1 IP Access Control List Violation IPaddr=172.072.016.
show 2 Port ---0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 WWN Binding ----------Active Inactive Inactive Active Inactive Inactive Inactive Inactive Inactive Inactive Inactive Inactive Inactive Inactive Inactive Inactive Bound WWN ----------------------AA:00:AA:00:AA:00:AA:00 00:00:00:00:00:00:00:00 CC:33:44:55:CC:33:44:55 00:00:00:00:00:00:00:00 00:00:00:00:00:00:00:00 00:00:00:00:00:00:00:00 00:00:00:00:00:00:00:00 00:00:00:00:00:00:00:00 00:00:00:00:00:00:00:00 00:00:00:00:00:00:00:00 00:00:00:00:00:00:00:0
show 2 show.security.switchBinding Syntax Purpose Parameters Command Example Output Output Example 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.
show 2 show.snmp Syntax Purpose Parameters snmp This command shows the switch SNMP configuration. This command has no parameters. NOTE: The command config.snmp.show on page 2-71 has functionality that is identical to this command. Command Example Output Root> show snmp The switch configuration data is displayed as a table that includes the following properties. SNMP Agent State The state of the SNMP agent.
show 2 Output Example The output from the show.snmp command displays as follows. SNMP Agent State: Enabled FA MIB Version Number: 3.0 Authentication Traps: Enabled Index Community Name ----- ----------------------------1 CommunityName1 2 CommunityName2 3 CommunityName3 4 public 5 WriteAuth --------Enabled Enabled Disabled Enabled Trap Recipient --------------123.123.123.123 10.25.25.10 132.44.85.224 UDP Port -----162 144 162 162 show.
show 2 Switch Priority The switch priority as set in the config.switch.priority command. For more information, see config.switch.priority on page 2-75. Speed The switch speed as set in the config.switch.speed command. (This does not apply to the Sphereon 4300 and Sphereon 4500 switches.) For more information, see config.switch.speed on page 2-78. Rerouting Delay The rerouting delay as set in the config.switch.rerouteDelay command. For more information, see config.switch.rerouteDelay on page 2-77.
show 2 Output Example The output from the show.switch command displays as follows. State: BB Credit: R_A_TOV: E_D_TOV: Preferred Domain Id: Switch Priority: Speed: Rerouting Delay: Interop Mode: Active Domain Id: World Wide Name: Insistent Domain Id: Domain RSCN: Zoning RSCN: FC Address Domain Id: Limited Fabric RSCN: Online 2 20 4 1 Default 2 Gb/sec Enabled Open Fabric 1.0 1 10:00:08:00:88:00:21:07 Enabled Enabled Disabled 67 (hexadecimal) Disabled show.
show 2 Output Example Location The system description as set in the config.system.description command. For more information, see config.system.location on page 2-83. Serial Number The serial number for the system. Type Number The type number for the system. Model Name The model name for the system (for example, Sphereon 4500). Model Number The model number for the system. All products have the model number 001, except 1 Gb sheet metal units, which are 002.
show 2 Syntax Purpose Parameters Command Example Output alerts This command provides the name, type, and enabled state of each configured threshold alert, including both counter threshold alerts (CTAs) and throughput threshold alerts (TTAs). This command has no parameters. Root> show thresholdAlerts alerts The threshold alert data displays as a table that includes the following properties. Name The name of the threshold alert, truncated to 45 characters.
show 2 State Output Example Delimiter Errors CTA - Delimiter Errors Address ID Errors CTA - Address ID Errors Cls2 BusiedFrms CTA - Class 2 Busied Frames Cls2 RejectedFrms CTA - Class 2 Rejected Frames Cls3 DiscardFrms CTA - Class 3 Discarded Frames Phys Lnk Err Set CTA - Physical Link Errors Summed Set Lnk Seq Cnt Set CTA - Link Sequence Counts Summed Set Logic Lnk Err Set CTA - Logical Link Errors Summed Set LIPS Detected CTA - Loop Initialization Primitives Detected (Sphereon 4300 an
show 2 show.thresholdAlerts.log Syntax Purpose log [clear] This command shows the contents of the threshold alert log. This log shows all the threshold alerts that have been triggered, including both counter threshold alerts (CTAs) and throughput threshold alerts (TTAs). ATTENTION! If the switch is restarted (as occurs during IPL, IML, configuration reset, feature key installation, or firmware load) or is power cycled, the information in the threshold alert log is lost.
show 2 OLS Received CTA - OLS Received Link Failures CTA - Link Failures Sync Losses CTA - Sync Losses Signal Losses CTA - Signal Losses Protocol Errors CTA - Primitive Sequence Errors/Protocol Errors Invalid Tx Words CTA - Invalid Tx Words CRC Errors CTA - CRC Errors Discarded Frames CTA - Discarded Frames Frames Too Short CTA - Frames Too Short Delimiter Errors CTA - Delimiter Errors Address ID Errors CTA - Address ID Errors Cls2 BusiedFrms CTA - Class 2 Busied Frames Cls2 Rejecte
show 2 Output Example Value The increment or utilization value of the alert. Interval The time interval of the alert. The output from the show.thresholdAlerts.
show 2 Active Zone Set Default Zone Enabled: False ZoneSet: TheUltimateZoneSet Zone: TheUltimateZone ZoneMember: Domain 10, Port 6 ZoneMember: Domain 15, Port 2 ZoneMember: Domain 2, Port 63 ZoneMember: 10:00:00:00:C9:22:9B:64 ZoneMember: 10:00:00:00:C9:22:9B:BD Zone: TheNotSoUltimateZone ZoneMember: 10:00:00:00:C9:22:9B:AB ZoneMember: 10:00:00:00:C9:22:9B:C6 ZoneMember: 10:00:00:00:C9:22:9B:AB Zone: TheNotUltimateAtAllZone ZoneMember: Domain 2, Port 63 CLI Commands 2-195
show 2 2-196 Enterprise Operating System Command Line Interface User Manual
A Error Messages This appendix lists and explains error messages for the Command Line Interface (CLI). Any error numbers that are not listed are reserved for future use. The message that is returned is a string that includes the error number and the text of the message. Message Description Action Message Description Action Message Description Action Error 005: Busy The switch cannot process any requests at this time. Re-submit the request.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-2 Error 009: 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.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 014: 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 015: Invalid BB Credit The value entered for the buffer-to-buffer credit is invalid.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-4 Error 020: 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 021: Invalid Switch Priority The value entered for the switch priority is invalid.
A Message Description Action Message Description Action Message Description Action Message Description Action Error 032: Invalid SNMP Community Name The value entered for the SNMP community name is invalid The community name must not exceed 32 characters in length. Duplicate community names are allowed, but corresponding write authorizations must match. Enter an appropriate SNMP community name and re-submit. Error 033: Invalid SNMP Trap Address The value entered for the SNMP trap address is invalid.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-6 Error 037: 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 038: Invalid Day The value of the day entered for the new system date is invalid.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 042: 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.
A Message Description Action Message The RADIUS server Timeout value entered is invalid. Enter a valid Timeout value. Valid values are 1 to 1000. Error 051: Invalid RADIUS Server Transmit Attempts Value Description The RADIUS server Retransmit value entered is invalid. Action Enter a valid Retransmit value. Valid values are 1 to 100.
A config.zoning.renameZoneSet on page 2-91. Make the appropriate changes to the zone name and re-submit. Message Description Action Message Description Action Message Description Action Message Error 057: Duplicate Zone 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 059: 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.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-10 Error 062: Invalid Zone Set Name The value entered for the zone set name is invalid. The zone set name must be contain 1–64 characters. The valid character set for the zone name can be found in config.zoning.renameZoneSet on page 2-91. Make the appropriate changes to the zone set name and re-submit.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 070: Invalid FRU Type The requested FRU does not exist on this product. Consult the installation/service manual for this product to find appropriate FRU names. Error 071: FRU Not Installed The requested FRU is not installed. Consult the installation/service manual for this product for appropriate action.
A Message Description Action Message The zone set entered exceeds switch NVRAM limitations. Reduce the size of the zone set to meet specified 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 076: Invalid Number of Unique Zone Members Description The zone entered contains more than the maximum number of zone members allowed per zone set for this product.
A Message Description Action Message Description Action Message Description Action Message Error 081: Default Zone Enabled The request cannot be completed because the default zone is enabled Disable the default zone and re-submit the command. Error 082: Invalid Interop Mode The value entered for the interoperability mode is not valid. The interoperability mode for the director or switch must be mcdata (McDATA Fabric 1.0) or open (Open Fabric 1.0). Make the appropriate changes and re-submit the command.
A Message Description Action Ports are not allowed to be configured as E_Ports in S/390 mode. Configure the port as either a fport or gport and resubmit the command. Message Error 092: Not Allowed While Port Is Unblocked Description The port must be blocked to complete this request. Action Message Description Action Message Description Action Message Description Action A-14 Error 091: E_Port Type Configured Block the port and re-submit the command.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 101: Command Not Supported on This Product This product does not support the requested command. Command not supported. No action necessary. Error 102: Switch Not Operational The request cannot be completed because the switch is not operational. Consult the installation/service manual and contact your service representative.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-16 Error 106: Invalid Threshold Scope The scope of a threshold alert is not set to a valid state before the user activates an alert. Set the scope of the threshold alert, then try to activate the alert. Error 107: Invalid Threshold State The scope of a threshold alert must be set before the user activates an alert.
A Message Description Action Message Description Action Message Description Error 112: No Threshold Definition Given The threshold value for the alert was not configured before the user attempted to activate the alert. Set the threshold value, then try to activate the alert. Error 115: Invalid Switch Speed The request cannot be completed because the switch is not capable of operating at the configured speed. Consult the installation/service manual to determine the speed capabilities of your product.
A Message Description Action Message This request cannot be completed because the requested port speed is not recognized for this product. Port speeds may be set to 1 Gb/s or 2 Gb/s. Update the port speed and re-submit the request. Error 119: Switch Speed Not 2 Gb/sec Description This request cannot be completed because the switch speed has not been set to 2 Gb/s. Action The switch speed must be set to 2 Gb/s in order to accommodate a port speed of 2 Gb/s.
A Message Description Action Error 135: Invalid Number of Fabric Membership List Entries The number of fabric members submitted exceeds the maximum allowable entries of 31. The number of entries in the fabric membership list is limited to the total number of domain IDs available to the fabric. Make sure that the list (including the managed switch) contains no more than 31 entries.
A Message Description Action Message Description Action Message The user attempted to disable insistent domain IDs while fabric binding was active. Insistent domain IDs must remain enabled while fabric binding is active. If fabric binding is set to inactive, the insistent domain ID state may be changed. It should be noted, however, that this can be disruptive to the fabric.
A Message 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. Action Domain RSCN's must remain enabled while the enterprise fabric mode is active. If enterprise fabric mode is set to inactive, the domain RSCN state may be changed. It should be noted, however, that this can be disruptive to the fabric.
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-22 Error 148: Not Allowed While Switch Offline The request cannot be completed while the switch is online and enterprise fabric mode is Active.
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 Binding 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.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-24 Error 158: Invalid Switch IP Access Control List IP Address Range The pair of IP addresses are invalid and cannot be added to the list. Make sure the IP addresses are valid and the first IP is lower than the second. Error 159: Invalid IP Access Control List Pairs Count Value The list being activated has an invalid number of IP pairs.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 165: CUP Zoning feature key must be installed The command is not available without the FICON CUP Zoning feature key. Install the FICON CUP zoning feature key. Error 166: CUP Zoning feature must be enabled The command cannot be completed with the CUP Zoning feature enabled. Enable FICON CUP Zoning.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-26 Error 171: Invalid username The username is invalid. Enter a unique username using only the allowed characters and proper length. Error 172: Invalid list size The number of entries in the list is invalid. Make sure the list has at least one entry. Error 173: Invalid value The value being entered is invalid. Enter a valid value.
A Message Error 177: Cannot remove the last Web user with Administrator rights Description At least one Administrator user must exist for each management interface. Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Add a new Administrator and then try again. Error 178: Invalid password The entered password is invalid. Enter a password using valid characters and a proper length.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-28 Error 183: Invalid Enable Status The enable status is invalid. Enter a valid enable status. Error 184: Invalid Fencing Policy Time Period The entered period is invalid. Enter a valid period. Error 185: Invalid Limit Value for this Fencing Policy Type The entered limit is invalid. Enter a valid limit.
A Message Description Action Message Description Action Message Error 189: Invalid Fencing Policy Type Invalid fencing policy type. Enter a valid fencing policy type. Error 190: Invalid Fencing Policy Port Type Invalid fencing policy port type. Enter a valid port or port type. Error 191: Max Fencing Policy Definitions Reached Description A new port fencing policy may not be defined without removing an existing port fencing policy from the list.
A Message Description Two policies of the same type cannot be enabled if they have ports that are in both lists. Action Make sure the policy that is being enabled doesn't have the same port number as a policy that is enabled Message Error 195: Cannot enable two policies of the same type that contain same port scope Description Two policies of the same type cannot be enabled if they have the same port type.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 201: Change Authorization Request Failed The switch did not accept the request to make a change to NVRAM. Be sure all parameters have been entered correctly and re-submit. Contact your service representative with further problems. Error 202: Invalid Change Authorization ID The switch will not accept a change request from this particular client.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-32 Error 209: Change Request Aborted The switch did not accept the request. Be sure all parameters have been entered correctly and re-submit. Contact your service representative with further problems. Error 210: Busy Processing Another Request A different switch in the Fabric was busy processing another request and could not complete the command.
A Message Description Action Message Description Action Message Description Action Error 214: A Zone Contains Zero Members You are attempting to activate a zone set that contains at least one zone with zero members. Each zone in the zone set must contain at least one member. Add a valid member to the empty zone and re-submit. Error 215: Zone Set Size Exceeded The local work area zone set has outgrown the size limitations imposed by the Command Line Interface.
A Message Description The port type configured is invalid. Action A port may be configured to be an eport, gport, or fport. Be sure the port is configured appropriately and re-submit the command. On the Sphereon 4300 and Sphereon 4500 only, fxport and gxport types are also supported. On the Sphereon 4300, the Fabric Capable feature must be installed to configure a E_Port, G_Port, or Gx_Port.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 224: Invalid Argument One or more parameters are invalid for this command. Consult this manual (Chapter 2, CLI Commands) for appropriate parameter names. Parameters must be typed exactly to specification to be recognized correctly by the CLI. Error 226: Argument Is Too Long One or more parameters are invalid for this command.
A Message Description Action Message Description Action Message Description Action Message Description Action A-36 Error 230: Invalid WWN The wwn parameter does not contain a valid value. For the appropriate parameters, see the section of the manual that corresponds to the attempted command. Parameters must be typed exactly to specification to be recognized correctly by the CLI. Error 231: Invalid Port number The portNum parameter does not contain a valid value.
A Message Error 234: Invalid Command Description The CLI cannot associate an action with the submitted command. The command may be misspelled, required parameters may be missing, or the request may not be applicable to the branch of the CLI tree from which it was submitted. Action Consult the documentation for the command to be sure this command was entered correctly, all parameters are valid and present, and that the syntax is correct.
A Message Description Action Message Description Action Message 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 239: Fabric binding entry not found The user requested to remove a fabric binding entry that is not in the pending fabric membership list. Verify that the correct entry (both WWN and Domain ID) is being requested for removal from the list and re-submit the request.
A Message Description Action Message Description Action Message Description Action Message Description Error 245: Invalid increment value The increment value specified is not between 1 and 70560. Make sure the increment value given is between 1 and 70560. Error 246: Invalid interval value The interval value specified is not between 5 and 70560 minutes. Make sure the increment value given is between 5 and 70560 minutes. Error 247: Invalid counter number The counter specified is not a valid number.
A Message Description Action Message Description Action The name specified for the alert is not valid. Specify a counter threshold alert name that has already been created. Error 251: The threshold alert must be disabled The counter threshold alert to be modified/deleted is already enabled. Disable the threshold alert and then try the command again.
A Message Error 256: Invalid utilization type number Description The utilization type number does not exist. Action Select a valid utilization type number. Message Error 257: Invalid utilization percentage value Description The utilization percentage value is out of range. Action Message Description Action Message Description Action Message Description Action Message Description Action Select a valid utilization percentage value.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-42 Error 262: All Attached Members are in the Membership List All attached fabric members are already in the membership list. This action is redundant, all members are already in the list. Error 263: The SANtegrity Authentication feature key is not installed The SANtegrity Authentication feature key is not installed.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 269: Invalid retransmit attempts. Must be between 1 and 100 The desired retransmit attempt value is invalid. Select a retransmit value between 1 and 100. Error 270: Invalid timeout value. Must be between 1 and 1000 The desired retransmit value is invalid. Select a timeout value between 1 and 10000. Error 271: Invalid deadtime value.
A Message Description Action Message Description Action Message The desired role is not a valid role. Select a valid role. Valid roles are administrator and operator. Error 276: Invalid sequence authentication combination The desired sequence is not a valid sequence. Select a valid sequence. Valid sequences are RADIUS, local, and RADIUS local. Error 277: Roles cannot be assigned to a username with this interface Description The role of the selected username is not configurable.
A Message Description Action Message Description Action Message Error 282: Conflicting Domain ID for the specified WWN The desired Domain ID is already in use. Select a different Domain ID. Error 283: Conflicting WWN for the specified Domain ID The WWN is already in use. Select a different WWN. Error 284: FICON CUP Zoning host control list is full Description A new host may not be entered without removing an existing host from the list.
A Message Description Action Message Description The NPIV feature key must be installed to complete this operation. Install the NPIV feature key. Error 289: Duplicate policy name A policy cannot be added if it has the same name as an existing policy. Action Select a different policy name.
A Message Description Action Error 295: Invalid MIHPTO value The MIHPTO value is invalid. Enter a valid MIHPTO value. Message Error 296: Cannot delete last EPort user with current authentication setting Description You cannot remove the last EPort user with the current authentication settings. Action Message Description Action Message Description Action Modify the EPort authentication settings.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-48 Error 299: Chap secret not defined The Chap secret must be defined (for Open Systems Management Server before enabling Outgoing Authentication.) Define a Chap Secret (for Open Systems Management Server). Error 300: No user defined for this Interface You cannot perform the specified action unless a user is defined for the interface.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Error 304: Radius Authentication Present. Cannot remove all Radius Servers You cannot remove all the RADIUS Server configurations if RADIUS Authentication is enabled on any interface. Disabled RADIUS Authentication on all interfaces and then remove the last RADIUS server configuration.
A A-50 Enterprise Operating System Command Line Interface User Manual
B Commands and Corresponding Releases Table B-1, Commands and Releases, shows the commands that are valid in the Enterprise Operating System (E/OS) Command Line Interface (CLI) and the release in which the command was added to the CLI. The commands are organized by release, and are in alphabetical order within the release. Table B-1 Commands and Releases First E/OS Release Command 7.0 config.features.NPIV 7.0 config.fencing.addPolicy 7.0 config.fencing.addPort 7.0 config.fencing.deletePolicy 7.
B Table B-1 First E/OS Release B-2 Commands and Releases Command 7.0 config.ficonCUPZoning.show 7.0 config.ficonMS.setMIHPTO 7.0 config.ficonMS.show 7.0 config.ip.lineSpeed 7.0 config.NPIV.maxPortIDs 7.0 config.NPIV.setState 7.0 config.NPIV.show 7.0 config.openSysMS.setHostCtrlState 7.0 config.port.rxCredits 7.0 config.port.show 7.0 config.port.showPortAddr 7.0 config.port.swapPortByAddr 7.0 config.port.swapPortByNum 7.0 config.security.authentication.interface api.
B Table B-1 First E/OS Release Commands and Releases Command 7.0 config.security.authentication.port.override 7.0 config.security.authentication.port.show 7.0 config.security.authentication.RADIUS.attempts 7.0 config.security.authentication.RADIUS.deadtime 7.0 config.security.authentication.RADIUS.deleteServer 7.0 config.security.authentication.RADIUS.server 7.0 config.security.authentication.RADIUS.show 7.0 config.security.authentication.RADIUS.timeout 7.0 config.security.
B Table B-1 First E/OS Release B-4 Commands and Releases Command 7.0 perf.thresholdAlerts.show 7.0 show.auditLog 7.0 show.epFrameLog.config 7.0 show.epFrameLog.filterClassFFrames 7.0 show.epFrameLog.noWrap 7.0 show.epFrameLog.setFilterPort 7.0 show.epFrameLog.wrap 7.0 show.fabricLog.noWrap 7.0 show.fabricLog.wrap 7.0 show.fabric.principal 7.0 show.fencing.policies 7.0 show.ficonCUPZoning 7.0 show.ficonMS 7.0 show.NPIV.config 7.0 show.openSysMS.config 7.0 show.port.
B Table B-1 First E/OS Release Commands and Releases Command 6.1 perf.preferredPath.clearPath 6.1 perf.preferredPath.setPath 6.1 perf.preferredPath.setState 6.1 perf.preferredPath.showPath 6.1 show.all 6.1 show.fabric.nodes 6.1 show.fabric.topology 6.1 show.linkIncidentLog 6.1 show.port.exit 6.1 show.preferredPath.showPath 6.1 show.thresholdAlerts.alerts 6.1 show.thresholdAlerts.log 5.3 config.enterpriseFabMode.setState 5.3 config.features.openTrunking 5.3 config.ficonMS.
B Table B-1 First E/OS Release B-6 Commands and Releases Command 5.3 show.openTrunking.config 5.3 show.openTrunking.rerouteLog 4.0 config.features.enterpriseFabMode 4.0 config.features.ficonMS 4.0 config.features.installKey 4.0 config.features.openSysMS 4.0 config.features.show 4.0 config.ip.ethernet 4.0 config.ip.show 4.0 config.port.blocked 4.0 config.port.fan 4.0 config.port.name 4.0 config.port.show 4.0 config.port.speed 4.0 config.port.type 4.0 config.security.
B Table B-1 First E/OS Release Commands and Releases Command 4.0 config.switch.edTOV 4.0 config.switch.insistDomainId 4.0 config.switch.interopMode 4.0 config.switch.prefDomainId 4.0 config.switch.priority 4.0 config.switch.raTOV 4.0 config.switch.rerouteDelay 4.0 config.switch.show 4.0 config.switch.speed 4.0 config.system.contact 4.0 config.system.date 4.0 config.system.description 4.0 config.system.location 4.0 config.system.name 4.0 config.system.show 4.0 config.
B Table B-1 First E/OS Release B-8 Commands and Releases Command 4.0 config.zoning.renameZone 4.0 config.zoning.renameZoneSet 4.0 config.zoning.replaceZoneSet 4.0 config.zoning.setDefZoneState 4.0 config.zoning.showActive 4.0 config.zoning.showPending 4.0 maint.port.beacon 4.0 maint.port.reset 4.0 maint.system.beacon 4.0 maint.system.clearSysError 4.0 maint.system.ipl 4.0 maint.system.resetConfig 4.0 maint.system.setOnlineState 4.0 perf.class2 4.0 perf.class3 4.0 perf.
B Table B-1 First E/OS Release Commands and Releases Command 4.0 show.nameServerExt 4.0 show.port.config 4.0 show.port.info 4.0 show.port.nodes 4.0 show.port.status 4.0 show.port.technology 4.0 show.security.fabricBinding 4.0 show.security.portBinding 4.0 show.security.switchBinding 4.0 show.switch 4.0 show.system 4.0 show.
B B-10 Enterprise Operating System Command Line Interface User Manual
Glossary This glossary includes terms and definitions from: • American National Standard Dictionary for Information Systems (ANSI X3.172-1990), copyright 1990 by the American National Standards Institute (ANSI). Copies can be purchased from the American National Standards Institute, 25 West 42nd Street, New York, NY 10036. Definitions from this text are identified by (A). • ANSI/EIA Standard - 440A: Fiber Optic Terminology, copyright 1989 by the Electronic Industries Association (EIA).
Glossary 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 access control A list of all devices that can access other devices across the network and the permissions associated with that access. See also persistent binding; zoning. active field-replaceable unit Active FRU. A FRU that is currently operating as the active, and not the backup FRU.
Glossary BB_Credit blocked port See buffer-to-buffer credit. In a director or switch, the attribute that when set, removes the communication capability of a specific port. A blocked port continuously transmits the offline sequence. buffer Storage area for data in transit. Buffers compensate for differences in processing speeds between devices. See buffer-to-buffer credit. buffer-to-buffer credit BB_Credit.
Glossary zoning configurations, and port configurations through the Element Manager application, results in a collection of configuration data. Configuration data includes: identification data, port configuration data, operating parameters, simple network management protocol (SNMP) configuration, and zoning configuration. connectionless connector control processor card Nondedicated link.
Glossary default zone device A zone that contains all of the devices attached to a fabric that are not members of a at lest one of the zones of the activated zone set. (1) Mechanical, electrical, or electronic hardware with a specific purpose (D). See also managed product. (2) See node. dialog box A pop-up window in the user interface with informational messages or fields to be modified or completed with desired options.
Glossary embedded web server With director firmware Version 1.2 (or later) installed, administrators or operators with a browser-capable PC and an Internet connection can monitor and manage the director or switch through an embedded web server interface, called the SANpilot interface. The interface provides a GUI similar to the Element Manager application, and supports director configuration, statistics monitoring, and basic operation. error-detect time-out value E_D_TOV.
Glossary fabric loop port fabric port FL_Port. A fabric port (F_Port) that contains arbitrated loop (AL) functions associated with the Fibre Channel arbitrated loop (FC-AL) topology. The access point of the fabric for physically connecting an arbitrated loop of node loop ports (NL_Ports). F_Port. Physical interface within the fabric that connects to a node port (N_Port) through a point-to-point full duplex connection.
Glossary FRU See field-replaceable unit. G G_Port See generic port. gateway A multi-homed host used to route network traffic from one network to another, and to pass network traffic from one protocol to another. gateway address (1) In transmission control protocol/Internet protocol (TCP/IP), a device that connects two systems that use the same or different protocols.
Glossary hub (1) In Fibre Channel protocol, a device that connects nodes into a logical loop by using a physical star topology. (2) In Ethernet, a device used to connect the server platform and the directors or switches it manages. I information message initial program load interface Message notifying a user that a function is performing normally or has completed normally. See also error message; warning message. IPL. The process of initializing the device and causing the operating system to start.
Glossary L LAN See local area network. LIN See link incident. link Physical connection between two devices on a switched fabric. A link consists of two conductors, one used for sending and the other for receiving, thereby providing a duplex communication path. link incident link incident alerts LIPS LIN. Interruption to link due to loss of light or other causes. See also link incident alerts.
Glossary multiswitch fabric A Fibre Channel fabric created by linking more than one director or fabric switching device within a fabric. N N_Port See node port. name server (1) In TCP/IP, see domain name server. (2) In Fibre Channel protocol, a server that allows node ports (N_Ports) to register information about themselves. This information allows N_Ports to discover and learn about each other by sending queries to the name server.
Glossary online state operating state (director or switch) When the switch or director is in the online state, all of the unblocked ports are allowed to log in to the fabric and begin communicating. Devices can connect to the switch or director if the port is not blocked and can communicate with another attached device if both devices are in the same zone, or if the default zone is enabled. Contrast with offline state.
Glossary path In a network, any route between any two ports. persistent binding A form of server-level access control that uses configuration information to bind a server to a specific Fibre Channel storage volume (or logical device), using a unit number. See also access control. port Receptacle on a device to which a cable leading to another device can be attached. Ports provide Fibre Channel connections (D).
Glossary resource allocation time-out value R_A_TOV. 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 SAN management application (1) Software application that is the system management framework providing the user interface for managing Fibre Channel switch products. (2) The software application that implements the management user interface for all managed hardware products.
Glossary server simple network management protocol A computer that provides shared resources, such as files and printers, to the network. Used primarily to store data, providing access to shared resources. Usually contains a network operating system. SNMP. A transmission control protocol/Internet protocol (TCP/IP)-derived protocol governing network management and monitoring of network devices. simple network management protocol community SNMP community. Also known as SNMP community string.
Glossary the packets more quickly. Typically, a subnet may represent all the machines at one geographic location, in one building, or on the same local area network. switch A device that connects, filters and forwards packets between local area network (LAN) segments or storage area network (SAN) nodes or devices. switch binding A security method that limits the devices that can log in to a switch, by specifying the node WWN of the allowed devices in the Switch Membership List.
Glossary uniform resource locator universal port module URL user datagram protocol URL. A URL is the address of a document or other resource on the Internet. A flexible 1 gigabit-per-second or 2 gigabit-per-second module that contains four generic ports (G_Ports). See uniform resource locator. UDP. A connectionless protocol that runs on top of Internet protocol (IP) networks.
Glossary zoning g-18 Grouping of several devices by function or by location. All devices connected to a connectivity product, such as the director or switch, may be configured into one or more zones. See also access control; zone.
Index Symbols " 1-14 # 1-20 ? 1-19 Numerics 60 characters in history log 1-13 80-column output 1-14 configuring interface 2-34 configuring N port 2-36 configuring Open Systems 2-37, 2-38 configuring outgoing 2-33 configuring port 2-40 configuring sequence 2-33 configuring serial 2-38 configuring Web 2-39 showing settings 2-39 authorization traps, SNMP 2-69 A access control list 2-62 adding a range 2-62 delete a range 2-63 disable 2-63 enable 2-63 show 2-64 access rights relationship to other products 1-
Index help 1-19 logging in or out 1-14 lost 2-97 navigation conventions 1-3 output 1-14 parameters 1-13 purpose 1-2 root> prompt 1-12 using 1-2 CLI commands, case sensitivity 1-3 commaDelim command 1-17 globally available 1-5 command line interface 1-2 command tree 1-5 ED-5000 1-21 errors, handling 1-18 globally available commands 1-5 help 1-19 logging in or out 1-14 lost 2-97 navigation conventions 1-3 output 1-14 parameters 1-13 purpose 1-2 root> prompt 1-12 using 1-2 command tree 1-5 limitations on move
Index view 2-142, 2-143 enable access control list 2-63 OpenTrunking 2-107 SNMP agent 2-71 Enterprise Fabric Mode activating 2-5, 2-6 deactivating 2-5, 2-6 error counters, port 2-102 error light, system, clearing 2-97 escape character 1-14 ethernet attributes 2-154 ethernet cable, replacing 1-22 ethernet connection, loss of 1-22 event log 2-144 exit port set 2-111 F F frames configuring logging 2-140 F_port, setting 2-31 fabric address notification (FAN) setting state 2-25 fabric binding activate 2-53 act
Index G G_port, setting 2-31 gateway address 2-21 globally available commands 1-5 graphical user interface 1-2 GUI 1-2 enabling Telnet 1-22 H help command 1-19 help, technical support xvii history log 1-13 clearing 1-13 HTTP 1-2 I inactive operational state 2-176 inactive state reasons 2-175 insistent Domain ID state 2-73 interactive interfaces 1-2 interoperability mode 2-74 invalid attachment state reasons 2-175 IP address, ethernet 2-20 IP configuration, showing 2-21 IP line speed, ethernet 2-21 IPL 2-
Index NV-RAM configuration parameters, reset 2-97 O offline, setting switches for configuration 2-72 Open Systems setting state 2-24 Open Systems Management Server 2-8, 2-24 OpenTrunking back pressure state 2-105 congestion threshold 2-106 low BB credit threshold 2-106 show 2-108 configuration 2-161 reroute log 2-162 state 2-8, 2-107 unresolved congestion 2-109 operational state 2-175 ordering product publications xviii OSMS state 2-8, 2-24 output 1-14 commaDelim command 1-17 order of displayed values 1-1
Index Q quotation marks for spaces 1-14 in strings 1-14 R r_a_tov 2-76 RADIUS server adding 2-43 configuring deadtime 2-42 configuring timeout 2-45 deleting 2-43 showing configuration 2-44 range access control list 2-62, 2-63 registered trademarks xix related documentation xvi reroute log, OpenTrunking 2-162 rerouting delay 2-77 root, transitioning through 1-12 root> prompt 1-12 RSCN fabric 2-74 zoning state 2-81 S SANtegrity Enterprise Fabric Mode 2-5, 2-6 scripting environments 1-2 scripts, commenting
Index access control list 2-64 all 2-138 ethernet attributes 2-154 event log 2-144 fabric binding 2-180 fabric nodes 2-148 fabric topology 2-149 features list 2-150 fencing policies 2-150 FICON CUP zoning 2-152 FICON MS 2-152 FRU information 2-153 link incident log 2-154 login server 2-155 name server 2-156 open trunking configuration 2-161 OpenTrunking configuration 2-161 rerouteLog 2-162 OpenTrunking information 2-108 port address 2-173 port binding for all ports 2-182 port configuration 2-163, 2-171 por
Index delete member 2-66 online state functions 2-65 set state 2-66 show configuration 2-67 show SBML 2-68 Switch Binding Membership List 2-68 add member 2-65 delete member 2-66 overview 2-64 show 2-68 switches 2-98 configuring IP address 2-20 configuring IP line speed 2-21 configuring, set offline 2-72 e_d_tov 2-73 event log 2-144 FRU information 2-153 interoperability mode 2-74 IPL 2-97 login server database 2-155 name server database 2-156, 2-158 preferred domain ID 2-75 principal 2-76 priority 2-75 r_a
Index throughput threshold alert 2-116 types 2-118 time, system 2-82 trademarks xix traffic counters 2-136 traversing the command tree 1-12 trunking congestion 2-106, 2-109 TTAs 2-116 types, port 2-31 U UDP 2-69, 2-72, 2-185 unattached fabric binding terminology 2-52 unit beaconing 2-96 unresolved congestion OpenTrunking 2-109 up-arrow command 1-13 user adding to database 2-46 configuring 2-46 deleting from database 2-47 modifying 2-48 setting role 2-49 showing 2-50 user access rights 1-14 relationship to
Index i-10 Enterprise Operating System Command Line Interface User Manual
