E/OS Command Line Interface User Manual P/N 620-000134-740 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.
Data, nScale, nView, OPENready, SANavigator, SANtegrity, SANvergence, SecureConnect and Sphereon are trademarks or registered trademarks of McDATA Corporation. OEM and Reseller logos are the 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 E/OS Command Line Interface User Manual
Contents Preface.............................................................................................................................xv Chapter 1 Introduction Command Line Interface Overview...............................................1-2 Entering Command Line Interface Commands ...........................1-2 Documentation Conventions ...................................................1-2 Navigation Conventions...........................................................1-2 Command Tree ..........
Contents config ..................................................................................................2-5 config.enterpriseFabMode.setState.........................................2-5 config.features.enterpriseFabMode ........................................2-6 config.features.ficonMS ............................................................2-7 config.features.installKey .........................................................2-7 config.features.NPIV.........................................
Contents config.port.type ....................................................................... 2-33 config.security ......................................................................... 2-34 config.security.authentication.interface.api.outgoing ....... 2-35 config.security.authentication.interface.api.sequence....... 2-35 config.security.authentication.interface.cli.sequence ........ 2-36 config.security.authentication.interface.eport.outgoing ... 2-37 config.security.authentication.interface.eport.
Contents config.security.portBinding.wwn .........................................2-61 config.security.ssh.resetKeys .................................................2-63 config.security.ssh.setState.....................................................2-63 config.security.ssh.show.........................................................2-63 config.security.switchAcl .......................................................2-64 config.security.switchAcl.addRange ....................................
Contents config.snmp.showUserTable................................................. 2-91 config.snmp.showV3GroupTable......................................... 2-92 config.snmp.showViewTable ................................................ 2-93 config.snmp.validateUser ...................................................... 2-94 config.switch............................................................................ 2-95 config.switch.apiState.............................................................
Contents config.zoning.clearZoneSet..................................................2-117 config.zoning.deactivateZoneSet ........................................2-117 config.zoning.deletePortMem .............................................2-118 config.zoning.deleteWwnMem ...........................................2-118 config.zoning.deleteZone .....................................................2-119 config.zoning.renameZone ..................................................2-120 config.zoning.
Contents perf.thresholdAlerts.counter.show .................................... 2-154 perf.thresholdAlerts.counter.showStatisticTable ............. 2-154 perf.thresholdAlerts.deleteAlert......................................... 2-155 perf.thresholdAlerts.setState ............................................... 2-156 perf.thresholdAlerts.show ................................................... 2-156 perf.thresholdAlerts.throughput.addAlert ....................... 2-158 perf.thresholdAlerts.throughput.
Contents show.openTrunking.config..................................................2-195 show.openTrunking.rerouteLog .........................................2-196 show.port.config ....................................................................2-197 show.port.exit ........................................................................2-198 show.port.info ........................................................................2-200 show.port.nodes .....................................................
Tables 1-1 1-2 1-3 CLI Command Tree Navigation Conventions ......................................... 1-3 CLI Command Tree ...................................................................................... 1-4 CLI Command Tree for the ED-5000 Director ........................................ 1-22 2-1 2-2 2-3 Supported Zoning Configurations ......................................................... 2-114 Throughput Threshold Alerts ................................................................
Tables xiv E/OS Command Line Interface User Manual
Preface This publication is part of the documentation suite that supports the McDATA® Sphereon™ 3016, Sphereon 3032, Sphereon 3216, Sphereon 3232, Sphereon 4300, Sphereon 4500, Sphereon 4400, and Sphereon 4700 Fabric Switches, Intrepid® 6064 Director, and Intrepid 6140 Director.
Preface 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. • Chapter 2, CLI Commands, describes the CLI commands, including their syntax, purpose, and parameters, as well as examples of their usage and any output that they generate. • Appendix A, Error Messages lists and explains error messages that may appear while using the CLI.
Preface Manual Conventions • 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 (620-000159) • Sphereon 4500 Fabric Switch Element Manager User Manual (620-000175) • McDATA Sphereon 4400 Switch Element Manager User Manual (620-000241) • McDATA Sphereon 4700 Fabric Switch Element Manager User Manual (620-000242) • McDATA Spher
Preface NOTE: To expedite warranty entitlement, please have your product serial number available. McDATA Corporation 380 Interlocken Crescent Broomfield, CO 80021 Phone: (800) 752-4572 or (720) 558-3910 Fax: (720) 558-3581 E-mail: support@mcdata.com NOTE: Customers who purchased the hardware product from a company other than McDATA should contact that company’s service representative for technical support. Forwarding Publication Comments We sincerely appreciate any comments about this publication.
Preface 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™ SANtegrity® All other trademarked terms, indicated by a registered trademark symbol (®) or t
Preface xx E/OS 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-2 Logging In and Logging Out.............................................................. 1-15 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. It can also be used through SSH.
Entering Command Line Interface Commands 1 Table 1-1 CLI Command Tree Navigation Conventions Character Sequence Common Name Action or Description Carriage Return Pass a completed line to the parser. Delete Backspace one character and delete the character. New Line Pass a completed line to the parser. Space Used to separate keywords. # Pound Sign Used to designate comments in a script. ? Question Mark Provide help information.
Entering Command Line Interface Commands 1 Table 1-1 Command Tree CLI Command Tree Navigation Conventions (Continued) Character Sequence Common Name Action or Description ^R Control-R Redraw the line. ^U Control-U Clear the input and reset the line buffer. ^X Control-X Clear the input and reset the line buffer. [A Up Arrow Move up one line in the command history. [B Down Arrow Move down one line in the command history.
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) openSysMS openTrunking show fencing------------------- addPolicy addPort deletePolicy removePort setParams setState show showTypeTable ficonCUPZoning------- addControlHost deleteControlHost setState show ficonMS------------------ setMIHPTO setState show ip-------------------------- ethernet lineSpeed show setHostCtrlState NPIV--------------------- maxPortIDs setState show openSysMS------------ setHostCtrlState setState port
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) swapPortByNum type security------------------ authentication---------- interface----------------- api------------------------- outgoing sequence cli-------------------------- sequence eport---------------------- outgoing sequence nport---------------------- outging sequence osms--------------------- outgoing setKey serial--------------------- enhancedAuth show web----------------------- sequence port----------------------- o
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) showPending portBinding ------------- bound show wwn ssh------------------------ resetKeys setState show switchAcl---------------- addRange deleteRange setState show switchBinding ---------- addMember deleteMember setState show ssl ------------------------ generateKeys resetKeys setAPIState setRengotiationMB setWebState show snmp --------------------- addAccessEntry addAccessViews addCommunity addTargetParams addUserEntry ad
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) setFaMibVersion setSNMPv3State setState show showAccessTable showTargetTable showUserTable showV3GroupTable showViewTable validateUser switch -------------------- apiState bbCredit domainRSCN edTOV haMode islFSPFCost insistDomainId interopMode ltdFabRSCN prefDomainId priority raTOV rerouteDelay RSCNZoneIsolation safeZoning speed show webState zoneFlexPars zoningRSCN syslog ------------------- addServer deleteServer setLogCon
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) date description location name show zoning ------------------ activateZoneSet addPortMem addWwnMem addZone clearZone clearZoneSet deactivateZoneSet deletePortMem deleteWwnMem deleteZone renameZone renameZoneSet replaceZoneSet setDefZoneState showPending showActive maint ---------- port ----------------------- beacon reset system ------------------ beacon clearSysError ipl resetConfig setOnlineState perf ------------ class2
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) setState show unresCongestion preferredPath ---------- clearPath setPath setState showPath showState thresholdAlerts -------- counter ------------------ addAlert addPort removePort setCounter setParams show showStatisticTable deleteAlert setState show throughput -------------- addAlert addPort removePort setUtilType setUtilPercentage setParams show showUtilTypeTable traffic show ---------- all auditLog epFrameLog-----------
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) eventLog fabric--------------------- nodes principal topology traceroute fabricLog---------------- noWrap wrap features fencing------------------- policies ficonCUPZoning ficonMS frus ip -------------------------- ethernet linkIncidentLog loginServer nameServer nameServerExt NPIV--------------------- config openSysMS------------ config openTrunking ---------- config rerouteLog port ----------------------- config exit info no
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) portBinding switchAcl switchBinding snmp -------------------- accessTable config targetTable userTable V3GroupTable viewTable switch syslog system thresholdAlerts-------- alerts log zoning Note that the commands are shown, with the exception of the zoning commands, in alphabetical order to make them easier to locate.
Entering Command Line Interface Commands 1 Config.Port> name 4 "Sam’s Tape Drive" At this point, to enter the maint.port.beacon command to set the beaconing state of port 4, the following series of commands is entered: Config.Port> .. Config> .. Root> maint Maint> port Maint.Port> beacon 4 true Note that you must return all the way to the root of the tree to transition to another extended branch. When traversing back to the root, the name of each branch cannot be used.
Entering Command Line Interface Commands 1 Limitation on Movements As the commands are entered, they are recorded in a history log. Note these limitations on movement that result from use of the history log: • If a command has more than 60 characters, the command runs, but the command is not recorded in the history log, and the position in the tree does not change, as shown in the following example.
Logging In and Logging Out 1 Output All output from the CLI commands is limited to the standard 80 columns supported by most Telnet interfaces. The output is left-justified. Logging In and Logging Out The command line interface (CLI) allows a single Telnet client to be connected to the switch. If a Telnet client logs out, or if after 15 minutes of inactivity the client’s access times out, another Telnet client may log in.
Logging In and Logging Out 1 simplesecret**** This is an example of a secret that does not use any special characters. \40\72\A3\F9\12\13\14\15\16\17\18\19\55\33\87\42 This is an example of a secret of length 4 that is configured using the hexadecimal representation. a9p\40\40xx\44\88kutfe\89h This is an example of a secret that has a length of 7 characters that are composed of a mix using hexadecimal and the printable ASCII characters.
Logging In and Logging Out 1 The access rights chosen for the CLI are completely independent of the other product interfaces, for example, SNMP or McDATA product interfaces. Parameters Command Examples This command has no parameters. login Username: Administrator Password: password login Username: Operator Password: password logout Syntax logout Purpose This command allows a Telnet client to disconnect from the switch.
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 commaDelim enable This command enables the user to obtain displayed information in comma-delimited, rather than tabular, format. Tabular format is the default. Description 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.
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: Root> config system Command identified contact date description location name show - • ? Set the Set the Set the Set the Set the Display system contact attribute system date and time system description attribute system
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.
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.
Telnet Session 1 1-24 E/OS 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.security.ssl.show on page 2-73 • config.snmp.addAccessEntry on page 2-76 • config.snmp.deleteAccessEntry on page 2-85 • config.snmp.addTargetParams on page 2-78 • config.snmp.addUserEntry on page 2-80 • config.snmp.addV1Target on page 2-82 • config.snmp.addV2Target on page 2-83 • config.snmp.addV3Target on page 2-83 • config.snmp.deleteAccessEntry on page 2-85 • config.snmp.setSNMPv3State on page 2-86 • config.snmp.
New and Changed Commands 2 2-4 • config.syslog.setLogConfig on page 2-108 • config.syslog.setState on page 2-108 • config.syslog.show on page 2-109 • config.system on page 2-110 • config.system.contact on page 2-110 • maint.port.beacon on page 2-124 • maint.port.reset on page 2-125 • perf.class2 on page 2-128 • perf.class3 on page 2-129 • perf.clearStats on page 2-131 • perf.errors on page 2-131 • perf.link on page 2-133 • perf.openTrunking.
config 2 • show.port.profile on page 2-208 • show.preferredPath.showPath on page 2-216 • show.snmp.accessTable on page 2-223 • show.snmp.targetTable on page 2-224 • show.snmp.userTable on page 2-225 • show.snmp.V3GroupTable on page 2-226 • show.snmp.viewTable on page 2-227 • show.syslog on page 2-234 config The config branch of the CLI command tree contains commands that set parameter values on the switch or director.
config 2 Parameters This command has one parameter: enterpriseFabModeState Command Example Specifies whether enterpriseFabMode is active. Valid values are activate and deactivate. Boolean 1 and 0 may be substituted as values. Root> config enterpriseFabMode setState 1 NOTE: You cannot activate Enterprise Fabric Mode while Open Trunking is enabled. config.features.
config 2 config.features.ficonMS Syntax Purpose ficonMS ficonMSState This command enables or disables FICON Management Server. The FICON Management Server feature key must be installed in order to enable the FICON Management Server State. (The Sphereon 4300 and Sphereon 4500 switches do not accept this command.) NOTE: This command is displayed on a Sphereon 3016 and 3216 only if the feature key is installed.
config 2 Parameters This command has one parameter: featureKey Command Example Specifies the key you have received to enable optional software feature on a specific product. A feature key is a string of case-sensitive, alphanumeric ASCII characters. The number of characters may vary in the format; however, the key must be entered exactly, including the hyphens. An example of a feature key format is XxXx-XXxX-xxXX-xX. Root> config features installKey AaBb-CCdD-eeFF-gH config.features.
config 2 Parameters This command has one parameter: osmsState Command Example Specifies whether the Open Systems Management Server is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values. Root> config features openSysMS 1 NOTE: The command config.openSysMS.setState on page 2-25 has functionality that is identical to this command. config.features.
config 2 Command Example Output Output Example Root> config features show The product feature data is displayed as a table that includes the following properties. Installed Feature Set The feature set installed using a feature key. Only installed keys are displayed. Feature Individual features within each set. In many cases, there is only one feature within each feature set. State The state of the individual feature. Fabric-wide features are displayed as Active/Inactive.
config 2 Command Example Root> config fencing addPolicy Policy2 NOTE: The maximum number of policies supported is 14. config.fencing.addPort Syntax Purpose Parameters addPort name portNumber This command adds a port to the specified fencing policy. This command has two parameters: name The name of the fencing policy. portNumber The port number to add to the fencing policy, or all, which will add all of the individual ports to the fencing policy.
config 2 • flport – This adds all active F_Ports and FL_ports (This applies to Sphereon 4400, Sphereon 4300, Sphereon 4500 and Sphereon 4700 switches). NOTE: A fencing policy can contain either port types or individual port numbers only. Command Example Root> config fencing addPort 24 Root> config fencing addPort eport config.fencing.deletePolicy Syntax Purpose Parameters deletePolicy name This command deletes the specified fencing policy. Only disabled fencing policies can be deleted.
config 2 Parameters Command Example This command has two parameters: name The name of the fencing policy. portNumber The port number to remove from the fencing policy, or all, which will remove all of the individual ports from 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 Where: Command Example Port list = 0, 1, 2 Fencing Type = Protocol Errors Limit =5 Period = 1800 seconds Root> Config fencing setParams abc 1 5 300 config.fencing.setState Syntax Purpose Parameters Command Example setState name enabledState This command enables or disables specified fencing policy. A policy cannot be activated if it contains ports that are already controlled by a different fencing policy of the same type.
config 2 When no parameters are specified, the command will display the name, type, and state of all policies. If the optional parameter is specified, it will display all the information about the policy. NOTE: If the name parameter is not supplied, then only 50 characters of the policy name will be displayed. In such cases enable the Comma Delimited Mode to view the full name.
config 2 Period: State: 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. Root> config fencing showTypeTable The output from the config.fencing.
config 2 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. This command has one parameter: hostNodeWwn Command Example hostNodeWwn The node WWN of the desired control host, entered in colon-delimited notation (e.g., 01:02:03:04:05:06:07:08).
config 2 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. Root> config ficonCUPZoning show The data is displayed as a table that includes the following information: FICON CUP Zoning State The enabled state of the FICON CUP Zoning feature.
config 2 Command Example Root> config ficonms setMIHPTO 180 config.ficonMS.setState Syntax Purpose setState ficonMSState This command enables or disables FICON Management Server. The FICON Management Server feature key must be installed in order to enable the FICON Management Server State. (The Sphereon 4300 and Sphereon 4500 switches do not accept this command.) NOTE: This command is displayed on a Sphereon 3016 only if the feature key is installed.
config 2 Output Output Example 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 appears as follows: Ficon MS State: Disabled Ficon MIHPTO (seconds): 180 config.ip.ethernet Syntax Purpose ethernet ipAddress gatewayAddress subnetMask This command sets the Ethernet network settings.
config 2 config.ip.lineSpeed Synopsis lineSpeed speed duplex Purpose This command sets the Ethernet line speed. Parameters Command Example This command has two parameters. One of the parameters is optional depending on the combination. speed The line speed. Options are auto, 10, or 100. If auto is entered then the optional duplex should not be entered. duplex The duplex mode for the connection. Options are full or half. Root> config ip lineSpeed 10 half config.ip.
config 2 config.NPIV N_Port ID Virtualization (NPIV) provides a FC facility for sharing a single physical N_Port among multiple N_Port IDs, thereby allowing multiple initiators, each with its own N_Port ID, to share the N_Port. You can configure the number of allowed NPIV logins for a given port and enable or disable the feature. Valid values for the Login Limit are 1 to 256. When the feature is enabled, NPIV number cannot be lowered if the NPIV devices have been logged in already.
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-193 has functionality that is the same as this command. config.openSysMS.setHostCtrlState Syntax Purpose Parameters setHostCtrlState HostContrlState This command enables or disables Open Systems Management Server (OSMS) 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–11 for the Sphereon 4300 0-15 for the Sphereon 4400 0–23 for the Sphereon 4500 0–31 for the Sphereon 3232 0-31 for the Sphereon 4700 fanState 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.
config 2 config.port.rxCredits Syntax Purpose Parameters Command Example rxCredits PortNumber RxCredits This command is used to set the number of initial BB_Credits for a given port. The number of credits assigned must fall between the minimum and maximum allowed values for the port. This command has two required parameters: portNumber Specifies the port number.
config 2 Parameters This command has one parameter: portNumber Command Example Output Output Example Specifies the port number.
config 2 Port Number: Name: Blocked: Type: Speed: Rx BB_Credits: 4 Sam’s tape drive false F Port 2 Gb/sec 12 config.port.showPortAddr Syntax Purpose showPortAddr This command displays the port address configuration for all ports. NOTE: The command show.port.showPortAddr on page 2-210 has functionality that is the same as this command. Parameters Command Example Output Output Example 2-30 This command has no parameters.
config 2 config.port.showCredits Syntax Purpose Parameters Command Example Output Output Example showCredits This command shows the BB_Credit Pool information. This command has no parameters. Root> config port showCredits This command displays the BB_Credit data: Pool The BB_Credit pool. Possible values: Sphereon 4300 - Pool 0 Sphereon 4400 - Pool 0 Sphereon 4500 - Pool 0 Sphereon 4700 - Pool 0 and Pool 1 Total The total number of BB_Credits that this pool contains.
config 2 config.port.speed Syntax Purpose speed portNumber portSpeed This command sets the speed for a port. A port can be configured to operate at 1 Gb/sec, 2 Gb/sec, 4Gb/sec, or a negotiated speed. The port speed can be set only to 1 Gb/sec, if the switch speed is 1 Gb/sec. An attempt to set the port speed to 2 Gb/sec or to negotiate in a switch with a 1 Gb/sec switch speed results in an error message.
config 2 Parameters Command Example This command has two required parameters: portAddr1 Port address, in hexidecimal format, of the desired port to be swapped. portAddr2 Port address, in hexidecimal format, of the desired port to be swapped. Root> config port swapPortByAddr 1e 1f config.port.swapPortByNum Syntax Purpose Parameters Command Example swapPortByNum portNum1 portNum2 This command will swap two ports given the port numbers. The ports must be offline to perform this operation.
config 2 The port configurations function as follows: Parameters Command Example config.security 2-34 • F_Port—cannot be used as an interswitch link, but may attach to a device with an N_Port. • E_Port—only other switches may attach to this type of port. • G_Port—either a device or another switch may attach to this type of port. • Fx_Port — allows Arbitrated Loop operation in addition to the functionality of an F_Port. (Sphereon 4300 and Sphereon 4500 only.
config 2 Some security configuration commands (namely those under the fabricBinding branch) are different from other CLI commands in that they are not single action commands that take effect immediately. These commands implement a rudimentary membership list editor. A user works on a temporary copy of a membership list in the editor and can perform actions such as adding or deleting fabric members. The edited copy can then be activated to the fabric.
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 Command Example Root> config security authentication interface cli sequence RADIUS local config.security.authentication.interface.eport.outgoing Syntax Purpose outgoing enabledState This command determines if outgoing CHAP authentication is used on E_Port connections. If this is enabled, the switch will issue a CHAP challenge to authenticate the remote end of the ISL. NOTE: This command requires that the SANtegrity Authentication feature key be installed.
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.nport.sequence Syntax Purpose sequence method1 [method2] This command sets the sequence that the N_Port interface will use to authenticate. When the preferred method cannot be contacted, the backup method will be used to authenticate the remote end of the ISL. NOTE: This command requires that the SANtegrity Authentication feature key be installed.
config 2 NOTE: The SANtegrity Authentication feature key must be installed to configure the OSMS outgoing state. Parameters This command has one parameter: enabledState Command Example This parameter enables and disables FCCT authentication. Accepted values for this parameter are enable or disable. Boolean 1 and 0 values may also be substituted. Root> config security authentication interface osms outgoing 1 config.security.authentication.interface.osms.
config 2 config.security.authentication.interface.serial.enhancedAuth Syntax Purpose Parameters enhancedAuth enhancedAuthState This command sets the enhanced serial authentication state. Enhanced Serial Authentication will require a user to enter a password when gaining access to the serial port interface. This command has one parameter: enhancedAuthState Command Example This parameter enables and disables enhanced authentication on the serial port interface.
config 2 Command Example Output Example Root> config security authentication interface show Web The output for the config.security.authentication.interface.show command appears as follows: Interface: Outgoing: Incoming: Sequence: Web N/A N/A Local, RADIUS config.security.authentication.interface.web.sequence Syntax Purpose Parameters sequence method1 [method2] This command sets the sequence that the web interface will use to authenticate.
config 2 state for either the E_Port or N_Port interface. The default setting will cause the port to use the outgoing state configure for the corresponding interface (either E_Port or N_Port). NOTE: This command requires that the SANtegrity Authentication feature key be installed. Parameters Command Example This command has one required parameter, and one optional parameter: portNumber Specifies the port number.
config 2 Output Output Example This command displays all valid user names in the local database for the specified interface. Port The port number. Override State The outgoing authentication override state. The output for the config.security.authentication.port.show command appears as follows: Port ---0 1 2 3 4 Override State -------------Default Default Enable Default Disable config.security.authentication.RADIUS.
config 2 Purpose Parameters This command configures the number of minutes a RADIUS server is marked as “dead”. If a RADIUS server does not respond to an authentication request, it can be marked as “dead” for a specified time interval. This may speed up authentication by eliminating timeouts and retransmissions. If no alternate RADIUS servers are available (when only one server is configured or when all are marked dead), then the deadtime is ignored. Deadtime may be 0 to 1440 minutes. The default is 0.
config 2 There are three slots available for RADIUS servers. Servers will be added into the list by the index value. The range is 1 to 3. If a server is added and there is an empty slot before that server, it will be shifted up to the empty slot. The IP:port is the IP address and the UDP port on the RADIUS server. NOTE: If you want to configure a RADIUS server without a key, you must specify the key as "". The set of double quotes is an empty string in the CLI.
config 2 Output Example The output for the config.security.authentication.RADIUS.show command appears as follows: Deadtime: Index ----1 2 3 0 IP Address Port ------------- ---1.1.1.1 1111 2.2.2.2 2222 Attempts ---------3 3 Timeout ------2 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 4 seconds.
config 2 command was executed from. No characters will be echoed back to the screen when entering a password, or when confirming a password. See Passwords and Secrets on page 1-15 for valid characters. NOTE: The SANtegrity Authentication feature key must be installed to configure switch secret. Parameters Command Example This command has no required parameters. Root> config security authentication switch setSecret config.security.authentication.
config 2 NOTE: The SANtegrity Authentication feature key must be installed to configure E_port and N_port usernames. Parameters This command has two required parameters and an additional interface parameter before the password parameter at the prompt after the command. 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.
config 2 Command Example Root> config security authentication user add 01:2A:3f:4:5:0:0 eport config.security.authentication.user.delete Syntax Purpose Parameters delete username 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 user name in the local authentication database.
config 2 Parameters This command has two required parameters and an additional interface parameter before the 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 user name.
config 2 Purpose Parameters Command Example This command sets the role value associated to an existing user name. 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 ----------johndoe_1223 ewsOperator Operator ----------Web,CLI Web Web,CLI ------------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 included in the Fabric Binding Membership List (FBML).
config 2 The following terms apply to the switches and directors that are part of the FBMLs: Enable/Disable and Online State Functions • Local: The switch or director that you are configuring. This is a required FBML member. • Attached: A switch or director that is currently in a fabric with the local switch or director. Any switch and director that is attached to the local switch or director is a required FBML member.
config 2 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.security.fabricbinding.addAttachedMembers Syntax Purpose Parameters Command Example addAttachedMembers This command adds all the current members of the fabric to the Pending FBML. If the domain ID or WWN of a fabric member already exists in the list, it is not added.
config 2 Command Example Root> config security fabricBinding addMember AA:99:23:23:08:14:88:C1 2 config.security.fabricBinding.clearMemList Syntax Purpose clearMemList This command clears the Pending FBML in the working area. Members that are attached remain in the list because the Pending FBML must contain all attached members to become active. NOTE: This information is not saved to the fabric until the activatePending command is issued.
config 2 config.security.fabricBinding.deleteMember Syntax Purpose deleteMember wwn domainId This command removes a member from the Pending FBML in the fabric binding work area. The local member and attached members cannot be deleted from the list. NOTE: Changes are not activated to the fabric until the activatePending command is issued. Parameters Command Examples This command has two parameters: wwn WWN of the member to be removed from the Pending FBML.
config 2 Purpose Parameters Command Example Output Output Example This command displays the fabric binding configuration (active FBML) saved on the fabric. It performs the same function as show.preferredPath.showState on page 2-218. This command has no parameters. Root> config security fabricBinding showActive This command displays the following fabric binding configuration data: Domain ID The domain ID of the FBML member. Valid domain IDs range from 1 to 239.
config 2 Output Output Example 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 IDs range from 1 to 239. WWN The world wide name (WWN) of the FBML member in colon-delimited hexadecimal notation. Attachment Status Indicates whether the FBML member is Local, Attached, or Unattached. For more information, see Fabric Binding Membership Terminology on page 2-53.
config 2 Parameters Command Examples This command has two parameters: portNumber Specifies the port number for which the port binding state is being set. Valid port number values are: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 and 3216 0-15 for the Sphereon 4400 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 and 3232 0-31 for the Sphereon 4700 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 portBindingState Specifies the port binding state as active or inactive.
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 This command has two parameters: portNumber 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-15 for the Sphereon 4400 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 and 3232 0-31 for the Sphereon 4700 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 boundWwn Command Examples 2-62 WWN of the device that is being bound to the specified port.
config 2 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. This command has no parameters Root> config security ssh resetKeys config.security.ssh.
config 2 Output Output Example The output of the config.security.ssh.show command displays the following data: SSH Indicates whether the SSH interface to CLI is enabled or disabled. Telnet Indicates whether the Telnet interface to CLI is enabled or disabled. SSH: Telnet: enabled disabled config.security.switchAcl The access control list (ACL) feature allows the administrator to configure a set of IP addresses that are allowed to make an IP management connection to the switch or director. config.
config 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. This command has the following parameters: startIPAddress The starting IP Address of the range to be deleted. The address must be entered in dotted decimal form (such as, 10.0.0.0).
config 2 Purpose Parameters Command Example Output Output Example 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. Ending IP Address The ending IP Address of the range in the access control list. The output from the config.security.switchAcl.
config 2 • Enabling Enterprise Fabric Mode automatically enables Switch Binding. • If Enterprise Fabric Mode is enabled and the switch or director is online, you cannot disable Switch Binding. • If Enterprise Fabric Mode is enabled and the switch or director is offline, you can disable Switch Binding, but this also disables Enterprise Fabric Mode. • WWNs can be added to the SBML regardless of whether Switch Binding is enabled or disabled. config.security.switchBinding.
config 2 Parameters 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). You may also enter all for this argument to clear the SBML completely. Note that you cannot clear a WWN that is currently logged into the switch. Root> config security switchBinding deleteMember AA:99:23:23:08:14:88:C1 config.security.
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 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.
config 2 The purpose for generating new keys is to improve the security of the SSL connections in case the private key has been compromised. This is considered to be unlikely, but the generation of new keys is usually performed periodically as a matter of security policy. Once a new certificate and private key are generated, you will likely see a message upon SSL connection that indicates that the new certificate is unrecognized. You can then choose to accept or reject the connection.
config 2 when the certificate expires. At this point, you can either choose to continue, or cancel, despite the expiry date. Parameters Command Example This command has no parameters. Root> config security ssl resetKeys config.security.ssl.setRenegotiationMB Syntax Purpose setRenegotiationMB megabytes This command sets the number of megabytes that can be transferred using SSL before the SSL session is automatically renegotiated.
config 2 Parameters This command has one parameter: sslEnabledState Command Example This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Root> config security ssl setWebState 0 config.security.ssl.setAPIState Syntax Purpose Parameters setAPIState sslEnabledState This command sets the enabled state for the SSL API interface. The default API access is non-secure. If SSL is enabled, there is no visual indication provided to the end user.
config 2 Output Web Enable State The SSL enabled state for the web interface. API Enable State The SSL enabled state for the API interface. Renegotiation MB The SSL MB limit before renegotiation will take place. Certificate The SSL certificate. PEM The SSL certificate in Privacy Enhanced Mail (PEM) format. MD5 Fingerprint MD5 fingerprint of the SSL certificate. SHA-1 Fingerprint SHA-1 Fingerprint of the SSL certificate.
config 2 5a:6b:7d:b9:35:3e:13:53:61:38:be:bb:54:39:18:39:23:ac: 52:a1:bf:d4:87:79:22:2c:ee:fb:3e:40:89:3d:97:9e:c7:b3: 7f:f2:4f:2e:af:67:3c:08:63:71:1b:b3:85:7b:dc:81:a8:3c: 85:da:84:07:62:2b:a5:83:92:aa PEM: -----BEGIN CERTIFICATE----MIIBoDCCAUqgAwIBAgIEQnYh8jANBgkqhkiG9w0BAQUFADBQMSYwJAYDVQQDEx1T d2l0Y2ggU2VyaWFsIE51bWJlciBURVNUNDUwMDEmMCQGA1UEChMdU3dpdGNoIFNl cmlhbCBOdW1iZXIgVEVTVDQ1MDAwHhcNMDUwNTAyMTI0OTU0WhcNMDUwNjIxMTI0 OTU0WjBAMRYwFAYDVQQDEw0xNzIuMjYuMjIuMjEyMSYwJAYDVQQKEx1Td2l0Y2gg U2VyaWFsIE51bWJ
config 2 ATTENTION! Before enabling SNMPv3, ensure all desired communities are configured for SNMPv3 access. If existing community strings are not configured for SNMPv3, then existing SNMP access will be lost. NOTE: The authentication/privacy key (password) configured for an SNMPv3 User on a switch is not localized. Therefore, the authentication/privacy key configured in the SNMP management application must be configured as a non-localized authentication/privacy key in ASCII format.
config 2 NOTE: Using Authentication (Auth) means that the Authentication protocols such as HMAC-MD5 or HMAC-SHA will be used to calculate the hash value for the packet and this calculated Hash value will be sent along with the packets as part of the SNMPv3 Header. Using privacy (priv) means that the data part of the packet will be encrypted using a privacy protocol such as DES. Privacy without Authentication is not allowed by the SNMPv3.
config 2 Parameters Command Example This command has five parameters. Up to six community names and trap recipients may be defined as follows: 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 five parameters: index Index of the Target entry. Valid values are indices already created using one of the addv1Target, addv2Target or addv3Target commands. Username The Security Name to be used for the corresponding trap entry. The maximum length for the security name is 32 characters and all characters in the ISO Latin-1 character set are valid. This name is the same as the User name in the USM user table. Refer to the command config.snmp.
config 2 config.snmp.addUserEntry Syntax Purpose Parameters addUserEntry index username authPtcl privPtcl This command adds a User-based Security Model (USM) user entry to the User Table (RFC 2574). It also specifies the authentication protocol and privacy protocol for this user. This command has four parameters: index Index of the target entry. Valid values are 1 to 6. username Specifies the User Name (also referred to as Security Name). The maximum length for the User Name is 32 characters.
config 2 Confirm: Retype the privacy password config.snmp.addV3Group Syntax Purpose Parameters Command Example Output Example addV3Group index username secModel groupName This command configures an entry in the Security-to-Group table. This table is used to map a user to a group and a security model. This command has four parameters: index Index of the user entry. Valid values are 1 to 6. username Specifies the User Name (also referred as Security Name) for this entry.
config 2 Index ----1 2 3 Username -------------------------------smith smith smith Model ----V1 USM USM Group Name ---------smithGroup smithGroup smithOtherGroup config.snmp.addV1Target Syntax Purpose Parameters Command Example 2-82 addV1Target index community [IP] [udpNum] This command configures a v1 community string. The IP address and port number of a v1 trap recipient can be optionally specified. The community string can be used for v1 access only if mapped to a security and group name.
config 2 config.snmp.addV2Target Syntax Purpose Parameters Command Example addV2Target index community [IP] [udpNum] This command configures a v2 community string. The IP address and port number of a v2 trap recipient can be optionally specified. The community string can be used for v2 access only if mapped to a security and group name. This command has four parameters. The last two are optional. index Index of the Target entry. Valid values are 1 to 6.
config 2 Purpose Parameters Command Example This command configures the IP address and optionally the port number of a v3 trap recipient. The community name is not used for v3 Traps. This command has three parameters. The last one is optional. index Index of the Target entry. Valid values are 1 to 6. IP The address of the trap recipient shown in 4-byte dotted-decimal format. udpNum UDP Port Number of the Trap recipient, to which the SNMP agent will send the traps.
config 2 config.snmp.deleteAccessEntry Syntax Purpose Parameters deleteAccessEntry index This command deletes the specified entry from the Access Table. This command has 1 parameter: commIndex Command Example Index of the access entry. Valid values are 1 to 6. Root> config snmp deleteAccessEntry 1 config.snmp.deleteCommunity Syntax Purpose Parameters deleteCommunity commIndex This command deletes an SNMP community and trap recipient, if configured.
config 2 config.snmp.deleteTargetEntry Syntax Purpose Parameters deleteTargetEntry index This command deletes the specified entry from the Target Table. This command has one parameter: Index Command Example Index of the target entry. Valid values are 1 to 6. Root> config snmp deletetargetentry 1 config.snmp.deleteV3Group Syntax Purpose Parameters deleteV3Group index This command deletes the specified entries from the Security-to-Group table.
config 2 Parameters This command has one parameter: enabledState Command Example Enabled state of SNMPv3. This can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Root> config snmp setSNMPv3State enable config.snmp.setFaMibVersion Syntax Purpose Parameters setFaMibVersion versionNumber This command sets the version of the Fibre Alliance MIB with which the SNMP agent interacts. The version number can be set to 3.0 or 3.1.
config 2 config.snmp.show Syntax Purpose Parameters Command Example Output Output Example show This command shows the SNMP configuration of the switch. This command has no parameters. Root> config snmp show The switch configuration data is displayed as a table that includes the following properties: SNMP Agent State The state of the SNMP agent. If it is disabled, the SNMP agent does not respond to any requests and does not produce any traps.
config 2 1 2 3 4 5 6 CommunityName1 CommunityName2 CommunityName3 public Enabled Enabled Disabled Enabled 123.123.123.123 10.25.25.10 132.44.85.224 162 144 162 162 config.snmp.showAccessTable Syntax Purpose Parameters showAccessTable [index] This command displays the configured values for the Access Table. This command has one optional parameter: index Command Example Index of the access entry. Valid values are 1 to 6. Config.
config 2 Security Level The security level. Read View The read view name. Write View The write view name. Notify View The notify view name. Config.SNMP> showAccessTable 1 Index: 1 Security Model: Any Security Level: None Group Name: group1 Read View: fcmgmt_3_1 Write View: fceos Notify View: internet config.snmp.showTargetTable Syntax Purpose Parameters showTargetTable [index] This command displays the configured values for the Target Table.
config 2 Index: Target IP: UDP Port: Community Name: MP Model: Security Name: Security Model: Security Level: 1 172.19.16.169 162 public SNMPv1 user1 V1 No Authentication and No Privacy These are explained in the table below. SNMPv3 State Indicates whether SNMPv3 is enabled or disabled. Index The index number. Target IP The IP address of the trap recipient. UDP Port The UDP port of the trap recipient. Community The community name. MP Model The Messaging Model.
config 2 Output Command Example SNMPv3 Index ----1 2 3 4 5 6 This command displays the following switch configuration data: SNMPv3 State Indicates whether SNMPv3 is enabled or disabled. Index The index number. Username The username. Auth Protocol The Authentication Protocol. Privacy Protocol The Privacy Protocol. Config.
config 2 Username The username. Model The Security model. Group Name The group name. Example Index ----1 2 3 4 5 6 config.SNMP> showV3GroupTable SNMPv3 State: Enabled Username Model Group Name -------------------------------- ----- ---------User1 V1 Group1 NOTE: This command and the command show.snmp.V3GroupTable on page 22-226 has the same functionality. config.snmp.
config 2 experimental private snmpv3 fceos fcmgmt_3_1 fcmgmt_3_0 fcfe system ip View View View View View View View View View Included Included Included Included Included Included Included Included Included .1.3.6.1.3 .1.3.6.1.4 .1.3.6.1.6 .1.3.6.1.4.1.289 .1.3.6.1.2.1.8888 .1.3.6.1.3.94 .1.3.6.1.3.42 .1.3.6.1.2.1.1 .1.3.6.1.2.1.4 config.snmp.
config 2 Command Example Read View The Read View access for this user. Write View The Write View access for this user. Notify View The Notify View access for this user. Root> Config SNMP validateUser Jerry v1 noauthnopriv Username: Auth Protocol: Priv Protocol: Security Model: Security Level: Context Match: Group Name: Read View: Write View: Notify View: Jerry No Authentication No Privacy V1 No Authentication and No Privacy Prefix Group1 internet management private config.
config 2 Command Example Root> config switch apiState enable config.switch.domainRSCN Syntax Purpose domainRSCN domainRSCNState Sets the domain RSCN state for the switch or director. You can run this command when the switch or director is either offline or online. When this parameter is enabled, domain registered state change notifications (domain RSCNs) are sent between end devices in a fabric to provide additional connection information to host bus adapters (HBA) and storage devices.
config 2 Parameters This command has one parameter: timeoutValue Command Example Specifies the new E_D_TOV value. The units for this value are tenths of a second. This parameter must be an integer in the range 2–600 (0.2 second to 60 seconds), and it must be smaller than the R_A_TOV. Root> config switch edTOV 4 config.switch.haMode Syntax Purpose Parameters haMode haEnabledState This command sets the state of high availability.
config 2 NOTE: The Insistent Domain ID must be enabled if the Enterprise Fabric Mode (an optional SANtegrity feature) or Preferred Path is enabled. config.switch.interopMode Syntax Purpose interopMode interopMode This command sets the interoperability mode for the switch. The switch must be offline to complete this command. NOTE: The switch must be set offline before this command is entered. Parameters This command has one parameter: interopMode Command Example Specifies the interoperability mode.
config 2 Parameters This command has one parameter: islFSPFCostState This parameter can be set to equal or default. If set to default, the value of the FSPF cost for each port depends on the speed of the port. In this case, the cost is inversely proportional to the bit rate of the ISL. The higher the bit rate, the lower the cost. If set to enabled, every ISL on the switch has the same FSPF cost, and considers only the number of hops to determine the shortest path, ignoring the speed of the port.
config 2 Purpose Parameters This command sets the preferred domain ID for the switch or director. The switch or director must be offline to complete this command. This command has one parameter: domainId Command Example Specifies the new preferred domain ID value. This parameter must be an integer in the range 1–31. Root> config switch prefDomainId 1 config.switch.priority Syntax Purpose priority Priority This command sets the switch priority.
config 2 Command Example Root> config switch priority principal config.switch.raTOV Syntax Purpose raTOV timeoutValue This command sets the resource allocation timeout value (R_A_TOV) for the switch. NOTE: The switch must be set offline before this command is entered. Special care should be taken when scripting this command due to its relationship with E_D_TOV. Parameters This command has one parameter: timeoutValue Command Example Specifies the new R_A_TOV value.
config 2 path may arrive ahead of older frames still in route over the older path. If rerouting delay is enabled, traffic ceases in the fabric for the time specified in the config.switch.edTOV command. This delay allows frames sent on the old path to exit to their destination before new frames begin traversing the new path.
config 2 config.switch.safeZoning Syntax Purpose Parameters safeZoning safeZoningState This command sets the state for safe zoning. When enabled, zone merges will not happen unless zone sets are equivalent; in addition, the option to set the default zone will be disabled. This command has one parameter: safeZoningState Command Example This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Root> config switch safeZoning enable config.switch.
config 2 config.switch.show Syntax Purpose show This command displays the switch configuration. NOTE: The switch can be either offline or online when this command is executed. Parameters Command Example Output 2-104 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 Domain RSCN When enabled, this allows domain RSCNs to be sent to registered members of the fabric. 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.
config 2 config.switch.webState Syntax Purpose Parameters webState webEnabledState This command sets the state of the web interface. When disabled, access through the web interface will be turned off. This command has one parameter: webEnabledState Command Example This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Root> config switch webState enable config.switch.
config 2 Parameters This command has one parameter: zoningRSCNStat e This parameter can be set to enable, disable, true, or false. Boolean 1 and 0 values may also be substituted. config.syslog The syslog feature records events such as logins, configuration changes, and error messages that occur on the switch. If an error condition occurs, the switch attempts to write an entry to the system log. The syslog feature will send the user requested logs (supported logs) to the syslog service on a remote host.
config 2 Parameters This command has one parameter: index Command Example The index number of the server to be deleted. Possible values are 1 to 3. Root> config syslog deleteserver 2 config.syslog.setLogConfig Syntax Purpose Parameters Command Example setLogConfig logName state This command enables syslog support for the given log. This command has two parameters: logName The log type. Possible values are Event, Trunking, Link, Security, Audit, Fabric, and Frame.
config 2 config.syslog.show Syntax Purpose show This command displays the syslog configuration. NOTE: The command show.syslog on page 2-234 has functionality that is the same as this command. Parameters Output Command Example This command has no parameters. The syslog configuration is shown as a table of properties. The following properties are displayed: Log The index number of the server. State Reports if syslog support is enabled. Index The index number of the server.
config 2 config.system With the system command, the configuration branch enters the system configuration branch. All commands under this branch operate on a particular system attribute. System attributes are generic attributes that are not specific to Fibre Channel, and thus would be present on any product. config.system.contact Syntax Purpose Parameters contact systemContact This command sets the system contact attribute.
config 2 Parameters Command Examples This command has two required parameters: systemDate Specifies the new system date. The format of the date parameter must be mm:dd:yyyy or mm/dd/yyyy. Valid date values include: mm: 1–12 dd: 1–31 yyyy: >1980 systemTime Specifies the new system time. The format of the time parameter must be hh:mm:ss. Valid time values include: hh: 0–23 mm: 0–59 ss: 0–59 Root> config system date 04:16:2001 10:34:01 Root> config system date 10/09/2001 14:07:55 config.system.
config 2 Parameters This command has one parameter: systemLocation Command Example Specifies the new system location for the director or switch. The location can contain 0–255 characters. Root> config system location Everywhere config.system.name Syntax Purpose Parameters name systemName This command sets the system name attribute. This command has one required parameter: systemName Command Example Specifies the new system name for the switch or switch. The name can contain 0–24 characters.
config 2 Output Examples Contact The system contact. Location The system location. Date/Time The system date and time. The output from the config.system.show command appears as follows: Name: Description: Contact: Location: Date/Time: Joe’s Switch McDATA Intrepid 6140 Fibre Channel Director Joe Everywhere 04/16/2001 10:34:01 config.zoning Note that the config.zoning commands function in a different way from most CLI commands, which are single action commands that take effect immediately.
config 2 Fabrics Configuration Document located on www.mcdata.com in the Resource Library or contact your customer support representative.
config 2 Purpose This command adds the domain ID and port number of a zone member to the specified zone in the work area. NOTE: Port numbers cannot be used for zone members if the interoperability mode for the switch or director is set to Open Fabric 1.0 mode. NOTE: A product can have a maximum of 4096 zone members in its zones. NOTE: The ED-5000 supports a maximum of 512 zones. Parameters Command Example This command has the following parameters: zoneName Specifies the name of the zone.
config 2 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. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00). Root> config zoning addWwnMem TheUltimateZone 10:00:00:00:C9:22:9B:64 config.zoning.
config 2 Command Example Root> config zoning addZone TheUltimateZone config.zoning.clearZone Syntax Purpose Parameters clearZone zoneName This command clears all zone members for the specified zone in the work area. This command does not change the zone name. This command has one parameter: zoneName Command Example Specifies the name of the zone to be cleared. Root> config zoning clearZone TheNotUltimateAtAllZone config.zoning.
config 2 config.zoning.deletePortMem Syntax Purpose Parameters Command Example deletePortMem zoneName domainId portNumber This command deletes a domain ID and port number for a zone member in the specified zone in the work area. This command has three parameters: zoneName Specifies the name of the zone that contains the member to be deleted. domainId Specifies the domain ID of the member that has to be deleted from the zone. Valid domain IDs are in the range 1–31.
config 2 Parameters Command Example 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). Root> config zoning deleteWwnMem TheNotSoUltimateZone 10:00:00:00:C9:22:9B:AB config.zoning.
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.
config 2 Output Example The output from the config.zoning.
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 Parameters reset portNumber 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 be 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 Output Example The port Class 2 counter data is displayed as a table that includes the following statistics, along with a wrap count for each corresponding counter. Port The port number. RxFrames The number of Fibre Channel Class 2 frames that the port has received. 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.
perf 2 Parameters This command has one parameter: portNumber Command Example Output Output Example 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. Port The port number. RxFrames The number of Fibre Channel Class 3 frames that the port has received. TxFrames The number of Fibre Channel Class 3 frames that the port has transmitted.
perf 2 TxFrames RxWords TxWords Disc Frames 2 65 32 26 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 2-132 Specifies the port number.
perf 2 Output Example The output from the perf.errors command appears as follows: Port 2 StatisticCount --------------------Prim Seq Err753452 Disc Frms351269 Inv Tx Wrds2953184 CRC Errs1842953 Delim Errs2953184 Addr Id Errs1842953 FrmsTooShrt40059 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 Specifies the port number.
perf 2 Output Example Reset In The number of link resets initiated by the attached N_Port. Reset Out The number of link resets initiated by this switch or director. 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 perf.openTrunking.lowBBCreditThresh Syntax Purpose lowBBCreditThresh lowBBcreditThreshold This command configures the low BB_credit threshold of the OpenTrunking configuration. The low BB_credit threshold is defined as the percentage of time that no transmit BB_Credits are passed on the link. When the threshold value is exceeded, the system tries to reroute the flows that are going to the ISL with the problem.
perf 2 Command Example Root> perf opentrunking setState 1 NOTE: The command config.features.openTrunking on page 2-9 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 Specifies the port number.
perf 2 Output Example Unresolved Congestion The current enabled/disabled state of the unresolved congestion trunking feature. (The indicated state applies to every port on the product.) Backpressure The current enabled/disabled state of the backpressure trunking feature. (The indicated state applies to every port on the product.) Low BB_Credit Threshold The current threshold setting of the Low BB_Credit Threshold trunking feature.
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 path selection algorithm of the switch by providing the ability to prioritize ISLs for a selected port on the switch.
perf 2 perf.preferredPath.clearPath Syntax Purpose Parameters Command Example 2-140 clearPath destDomainID sourcePort This command deletes a preferred path. The command causes the specified path to use a path selection algorithm that is different from the preferred path. All configured paths can be removed by specifying the all parameter for both the destination domain ID and source port. This command has the following parameters: destDomainId Specifies the destination domain ID.
perf 2 perf.preferredPath.setPath Syntax Purpose setPath destDomainID sourcePort exitPort This command sets a preferred exit port, given the destination domain ID and source port. An exit port can be set for each combination of destination domain ID and source port. NOTE: You cannot set a path where the Destination Domain ID is the same as the domain ID of the switch. Parameters Command Example This command has the following parameters: destDomainId Specifies the destination domain ID.
perf 2 perf.preferredPath.setState Syntax Purpose setState enabledState This command enables or disables the preferred path feature. NOTE: Insistent domain IDs must be used in order to enable the preferred path state. Parameters This command has one parameter: enabledState 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.
perf 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 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 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. The commands used to configure these alerts start with perf.thresholdAlerts.counter. • Throughput threshold alerts: These alerts are triggered by port throughput.
perf 2 • perf.thresholdAlerts.counter.setParams on page 2-153 • perf.thresholdAlerts.counter.show on page 2-154 • perf.thresholdAlerts.counter.showStatisticTable on page 2-154 4. Once the alert is fully configured, activate the alert using the perf.thresholdAlerts.setState command described on 2-156. To modify an alert you will need to disable it first.
perf 2 Alert Types and Counters Table 2-2 provides a list of throughput threshold alerts. Throughput Threshold Alerts Table 2-2 Utilization Code Threshold Alert Type Tx Util TTA - Transmit Utilization Rx Util TTA - Receive Utilization Tx/Rx Util TTA - Transmit or Receive Utilization Table 2-3 provides a list of threshold alert counters and counter sets.
perf 2 Table 2-3 Description of Summed Sets Alert Counters (Continued) Number Threshold Alert Counter or Counter Set 16 Class2RejectedFrames 17 Class3DiscardedFrames 18 Physical Link Errors Set 19 Link Sequence Counts Set 20 Logical Link Errors Set (see below) 21 LIPs Detected (Sphereon 4300 and Sphereon 4500 switches only) 22 LIPs Generated (Sphereon 4300 and Sphereon 4500 switches only) Some of the threshold alerts consist of groups of related items called Summed Sets.
perf 2 • Class 2 Busied Frames • Class 2 Rejected Frames • Class 3 Discarded Frames perf.thresholdAlerts.counter.addAlert Syntax Purpose addAlert name This command configures a new counter threshold alert and assigns it a name. The new alert is assigned default settings which can then be changed using the other counter threshold alert commands.
perf 2 perf.thresholdAlerts.counter.addPort Syntax Purpose addPort name portNumber This command adds a port to the specified counter threshold alert. NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. Parameters This command has the following parameters: name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert on page 2-149.
perf 2 Command Example Root> perf thresholdAlerts counter addPort checklinks 12 perf.thresholdAlerts.counter.removePort Syntax Purpose removePort name portNumber This command removes a port from the specified counter threshold alert. NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command.
perf 2 with the threshold alert name created using the perf.thresholdAlerts.counter.addAlert command. 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 2-152 This command has the following parameters: name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert, described in 2-149. counterNumber Specifies the counter number.
perf 2 perf.thresholdAlerts.counter.setParams Syntax Purpose setParams name increment interval This command sets the increment and interval times for a specified counter threshold alert. NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. Parameters Example This command has the following parameters: name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.
perf 2 perf.thresholdAlerts.counter.show Syntax Purpose Parameters show name This command displays the settings for an individual counter threshold alert. This command has one parameter: name The name of a threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert, described on 2-149. You can specify all instead of a name, which means that all threshold alerts are displayed. NOTE: The output of this command truncates threshold alert names that are longer than 51 characters.
perf 2 Command Example Output Example Root> perf threshAlerts counter showStatisticTable The output from the perf.thresholdAlerts.counter.
perf 2 Command Example Root> perf thresholdAlerts deleteAlert checklinks perf.thresholdAlerts.setState Syntax Purpose Parameters Command Example setState name enabledState This command enables or disables specified threshold alert. This command has the following parameters: name The name of a threshold alert as defined by the commands perf.thresholdAlerts.counter.addAlert and perf.thresholdAlerts.throughput.addAlert. enabledState Sets the counter threshold alert enabled state.
perf 2 Tx/Rx Util TTA - Transmit or Receive Utilization Link Resets Sent CTA - Link Resets Sent Link Resets Received CTA - Link Resets Received OLS Sent CTA - OLS Sent OLS Received CTA - OLS Received Link Failures CTA - Link Failures Sync Losses CTA - Sync Losses Signal Losses CTA - Signal Losses Protocol Errors CTA - Primitive Sequence Errors/Protocol Errors Invalid Tx Words CTA - Invalid Tx Words CRC Errors CTA - CRC Errors Discarded Frames CTA - Discarded Frames Frames Too Short C
perf 2 State LIPs Detected CTA - Loop Initialization Primitive Detected LIPs Generated CTA - Loop Initialization Primitive Generated The enabled state of the CTA. Either enabled or disabled. Output Example Name Type State ---------------------------------------------------- ----------------- -------Throughput Threshold #1 Rx Util Enable Threshold for CRC CRC Errors Disabled Safety #2 Logic Lnk Err Set Enabled Safety #1 Cls2 BusiedFrms Disabled perf.thresholdAlerts.throughput.
perf 2 Parameters This command has one 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. TIP: Although the system supports a name length of 64 characters, you may want to use a much shorter name. Some commands that display the threshold name show a maximum of 51 characters.
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-158. 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-158. 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-158. 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 setParams name duration interval This command sets the name, duration, and interval for a specified throughput threshold alert. It also enables you to configure an alert to be sent when the following two events occur at the same time. • The throughput threshold alert value is surpassed to more than the timespan specified in 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 one parameter: name The name of a throughput threshold alert as defined by the command perf.thresholdAlerts.throughput.addAlert, described on 2-158. You can also specify all instead of a name, to display all threshold alerts.
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 appears as follows: NumberUtilization Type ---------------------------1 Transmit Traffic (Tx) 2 Receive Traffic (Rx) 3 Both (Tx/Rx) perf.traffic Syntax Purpose Parameters traffic portNumber This command displays port traffic counters for a specified port.
perf 2 Output Example RxFrames The number of Fibre Channel Class 2 and Class 3 frames that the port has received. TxFrames The number of Fibre Channel Class 2 and Class 3 frames that the port has transmitted. 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.
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.
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 port frame log settings. Parameters This command has no parameters.
show 2 End Bit Pattern The bit pattern that triggers the logging to end. Start Condition Met True if the start condition was met. End Condition Met False if the end condition was not met. Command Example Root> show EPFrameLog config Filter Class F Frames: Filter Port: Start Offset: Start Bit Pattern: End Offset: End Bit Pattern: Trigger State: Num of Entries: Start Condition Met: End Condition Met: Disabled 15 0 FFXXXXX3452 0 FBXXXXX3321 Active 6 True False show.epFrameLog.
show 2 Parameters This command has one optional parameter. If no parameters are entered, it will show the current state. filterstate 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 displays the contents of the non-wrapping region of the FC2 frame log. Specifying the optional keyword clear removes all entries from the non-wrapping region of the log. The log entries will not persist over 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.
show 2 Output Example Count -----39 Header: PL: 38 Header: PL: 37 Header: PL: The output of the show.epFrameLog.
show 2 show.epFrameLog.wrap Syntax Purpose wrap [clear] This command displays the contents of the wrapping region of the FC2 frame log. Specifying the optional keyword clear clears all entries from both the wrapping and the non-wrapping regions of the log. The log entries will not persist over IMLs or power cycles, and 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.
show 2 Output Example Count -----39 Header: PL: 38 Header: PL: 37 Header: PL: The output of the show.epFrameLog.
show 2 Output Example Date/Time ---------------04/12/01 10:58A 04/12/01 9:58A 04/11/01 7:18P Code ---375 385 395 Severity The severity of the event. The values are: Major—Unit operational (major failure). Minor—Unit operational (minor failure). Severe—Unit not operational. The causes are either that the switch contains no operational SBAR cards or that the system shuts down due to CTP thermal threshold violations. Info—Unit operational (information only).
show 2 Output Output Example 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.fabricLog.
show 2 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 fabricLog Wrap 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 Parameters Command Example Output Output Example 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. Port WWN The WWN of the fabric attached port The output from the show.fabric.
show 2 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. DID The Domain ID of the switch at the local end of the ISL.
show 2 show.fabric.traceRoute Syntax traceRoute source destination Description This command retrieves the route between two nodes in the fabric. Parameters This command has two parameters: Command Example source The source port for the trace route. This can be either a Port ID or a WWN. destination The destination port for the trace route. This can be either a Port ID or a WWN. Root> show fabric traceRoute Output Return code The return value.
show 2 Output Example 2-182 Ingress Port Num The Ingress Port Num taken by the trace route. Egress Port WWN The Egress Port WWN taken by the trace route. Egress Port Num The Egress Port Num taken by the trace route. Direction The direction the trace route was going for the specified entry. Possible values are: "Source to destination "At Destination "Destination to source Show.
show 2 Domain ID: Ingress Port WWN: Ingress Port Num: Egress Port WWN: Egress Port Num: Direction: 31 20:0F:08:00:88:A0:B0:9C 11 20:12:08:00:88:A0:B0:9C 14 Destination to source Entry 4 Switch WWN: Domain ID: Ingress Port WWN: Ingress Port Num: Egress Port WWN: Egress Port Num: Direction: 10:00:08:00:88:22:33:44 2 20:1B:08:00:88:22:33:44 23 20:17:08:00:88:22:33:44 19 Destination to source Entry 5 Switch WWN: Domain ID: Ingress Port WWN: Ingress Port Num: Egress Port WWN: Egress Port Num: Direction: 10
show 2 Output Output Example 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. Feature Individual features within each set. In many cases, there is only one feature within each feature set. State The state of the individual feature. Fabric-wide features are displayed as Active/Inactive. Switch-centric features are displayed as Enabled/Disabled.
show 2 Output Output Example The data is displayed as a table that includes the following properties: Name The name of the policy. This will be concatenated to 50 characters in the summary display. The policy full name will be shown in comma-delim mode. Ports The ports to which the fencing policy will be applied. Type The type of the fencing policy. Limit The number of offenses that are allowed before a port is disabled.
show 2 Parameters Command Example Output Output Example This command has no parameters. show ficonCUPzoning The data is presented as a table with the following properties: FICON CUP Zoning State The enabled state of the FICON CUP Zoning feature Host Control List List of 0-8 control hosts, displays “empty” for control host list with no members. FICON CUP Zoning State: Host Control List ----------------------01:02:03:04:05:06:07:08 09:0A:0B:0C:0D:0E:0F:00 Enabled show.
show 2 show.frus Syntax Purpose Parameters Command Example Output Output Example FRU ----CTP CTP SBAR SBAR FPM FPM UPM Position -------0 1 0 1 1 3 4 State -----Active Backup Active Failed Active Active Active frus This command displays information about all field-replaceable units (FRUs). This command has no parameters. Root> show frus The FRU information is displayed as a table that includes the following properties: FRU The FRU name.
show 2 Power Fan 0 0 Active Active 470-000399-700 470-000399-700 223456789 223456789 Off Off 831 831 show.ip.ethernet Syntax Purpose Parameters Command Example Output Output Example ethernet This command displays Ethernet attributes. This command has no parameters. Root> show ip ethernet The Ethernet attributes data is displayed as a table that includes the following properties: IP Address The IP address for the Ethernet adapter as set in the config.ip.ethernet command.
show 2 Parameters This command has one optional parameter: clear Command Example Output Output Example Date / Time ---------------02/27/03 01:28P 02/27/03 01:28P 02/27/03 01:27P 02/27/03 01:27P Port ---20 4 62 62 This optional parameter causes all link incident log entries to be cleared. Root> show linkIncidentLog The event log data are displayed as a table that includes the following properties: Date/Time The date and time when the event occurred.
show 2 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 ------- The device information is displayed as a table that includes the following properties: Port The port number where the device is attached. BB Crdt The Buffer to buffer credit (BB_Credit). The maximum number of remaining frames that can be transmitted without causing a buffer overrun condition at the receiver.
show 2 more than one device per port for any public loop devices attached to an FL_Port. Parameters Command Example Output Output Example 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 of the port (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.
show 2 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 Port Name ----------------------00:11:22:33:44:55:66:77 00:11:22:33:44:55:66:78 00:11:22:33:44:55:66:79 00:11:22:33:44:55:66:80 00:11:22:33:44:55:66:81 00:11:22:33:44:55:66:82 00:11:22:33:44:55:66:83 00:11:22:33:44:55:66:84 00:11:22:33:44:55:66:85 00:11:22:33:44:55:66:86 00:11:22:33:44:55:66:87 00:11:22:33:44:55:66:88 Node Name ----------------------20:11:22:33:44:55:6
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-24 has functionality that is identical to this command. Parameters Command Example Output Output Example 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 NPIV Login Table A table mapping each port number on the 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 appears 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 the 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, Sphereon 4500, Sphereon 4400, and Sphereon 4700 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.
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/s, 2 Gb/s, 4 Gb/s, or Not Established). SpeedCap The current transceiver capability speed (1 Gb/s, 2 Gb/s, or 4 Gb/s). The output from the show.port.
show 2 Parameters This command has one parameter: portNumber Command Example Output 2-202 Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 0–23 for the Sphereon 4500 0-15 for the Sphereon 4400 0-31 for the Sphereon 4700 Root> show port nodes portNumber The port nodes data is displayed as a table that includes the following properties: FC Addr The Fibre Channel address of nodes attached to this port.
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 Output Example This command displays the following optic data: Type The measurement type. Temperature is in celsius, voltage is in volts, power is in mW, and current is in mA. Value The value of the measurement. Low Warning The lower limit for the warning threshold. High Warning The higher limit for the warning threshold. Low Alarm The lower limit for the alarm threshold. High Alarm The higher limit for the alarm threshold. The output from the show.port.
show 2 Parameters Command Example Output Output Example Port ---0 1 2 3 4 Xvr --UNK UNK UNK UNK XFP This command has no parameters. Show port opticEDD The port optic diagnostic data is displayed as a table that includes the following properties. Port The port number. Xcvr The transceiver type. Temp The optic temperature in celsius. 3.3 Voltage The 3.3 voltage in volts. Current The current in mA. TX Pwr The transceiver power in uW. RX Pwr The receiver power in uW. 1.8 Voltage The 1.
show 2 Parameters Output This command has no parameters. This command displays the following optic data: Port The port number. Overall Health The overall health of the optic. Possible values are list below according to priority. Alarm One or more alarm threshold has been exceeded. Warning One or more warning threshold has been exceeded. Normal All measurements are within thresholds. No Info The optic does not support enhanced digital diagnostics or the state has not been updated yet.
show 2 Purpose Parameters Command Example Output Output Example This command displays information about the optic. This command has no parameters. Root> show port opticInfo The port optic data is displayed as a table that includes the following properties: Port Number The port number. Tranceiver The transceiver type. Vendor Name The vender name. Serial Number The serial number. Part Number, The part number. Revision Level The revision level. Supported Link Length The Supported link length.
show 2 8,SFP,E2O COMMS INC ,36U1350 15,4,07/03/03 Lot# , 9,SFP,E2O COMMS INC ,35D2220 15,4,05/16/03 Lot# , 10,SFP,E2O COMMS INC ,36U1345 15,4,07/03/03 Lot# , 11,SFP,E2O COMMS INC ,36U3681 15,4,07/04/03 Lot# , 12,SFP,E2O COMMS INC ,3770978 15,4,07/09/03 Lot# , 13,SFP,E2O COMMS INC ,36U1338 15,4,07/03/03 Lot# , 14,SFP,E2O COMMS INC ,36U1347 15,4,07/03/03 Lot# , 15,SFP,E2O COMMS INC ,36U1332 15,4,07/03/03 Lot# , 16,SFP,E2O COMMS INC ,36U3676 15,4,07/04/03 Lot# , 17,SFP,E2O COMMS INC ,476PM46 15,4,07/07/04 Lot
show 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 0–23 for the Sphereon 4500 0-15 for the Sphereon 4400 0-31 for the Sphereon 4700 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 profile portNumber 138 The port profile information is displayed as a single output for an individual port.
show 2 Reason The reason that the port operational state is not “online”. Rx BB_Credits Then number of configured Rx BB_Credits. Connector Type Optic connector type. Transceiver Optic transceiver type. Distance Capability Optic distance capability. Media Type Optic media type. Speed Capability Optic speed capability. 10G FC Compliance Optic 10G FC Compliance code. Output Example The output from the show.port.
show 2 NOTE: The config.port.showPortAddr on page 2-30 has functionality that is identical to this command. Parameters This command has no parameters. Command Example Root> show port showPortAddr Output Output Example 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.
show 2 show.port.status Syntax Purpose Parameters Command Example Output 2-212 status This command displays port status for all ports. This command has no parameters. Root> show port status The port status data is displayed as a table that includes the following properties: Port The port number. State The port state (for example, Segmented E_Port, Invalid Attachment, Not Installed, Online, Offline, Not Operational, No Light, Testing, Port Failure, Link Reset, or Inactive).
show 2 Beaconing The beaconing state for the port (Off or On). Reason An optional message number that indicates whether 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 24: Inactive - RC 0 25: No Serial Number 26: Feature Not Enabled 27: Switch Speed Conflict The output from the show.port.
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 preferredPath 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 the show.preferredPath.showPath command 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.preferredPath.showState Syntax Purpose Parameters showState This command displays the state of the preferred path. This command has one parameter: Preferred Path State Command Example Indicates the state of the preferred path (Enabled or Disabled).
show 2 Output Output Example The fabric binding configuration data is displayed as a table that includes the following properties: Domain ID The domain ID of the Fabric Binding Membership List (FBML) member. Valid domain IDs range from 1 to 239. WWN The world wide name (WWN) of the FBML member in colon-delimited hexadecimal notation. Attachment Status Indicates whether the FBML member is Local, Attached, or Unattached. For more information, see Fabric Binding Membership Terminology on page 2-53.
show 2 Output Output Example Reason -----10000 Desc: Data: 10305 Desc: Data: 10300 Desc: Data: 10411 Desc: Data: The security log data are displayed as a table that includes the following properties: Reason The reason code for the security event. Date/Time The date and time when the event occurred. Trigger Level The trigger level of the event. Possible values are Informational, Security Change, or Error. Category The event category message.
show 2 Parameters Command Example Output Output Example This command has no parameters. Root> show security portBinding The port binding configuration data is displayed as a table that includes the following properties: Port The port number. WWN Binding The state of port binding for the specified port (active or inactive). Bound WWN The WWN of the device that is bound to the specified port. If this field is blank, no device is bound to the specified port. The output from the show.security.
show 2 Output Output Example The data is displayed as a table that includes the following properties: Switch ACL State The enabled state of the switch access control list. Starting IP Address The starting IP address of a range in the access control list. Ending IP Address The ending IP address of a range in the access control list. ACL State: Disabled Starting IP Address ------------------110.80.1.1 110.81.1.10 200.11.15.1 Ending IP Address ----------------110.80.255.255 110.81.1.255 200.11.255.
show 2 Output Example The output from the show.security.switchBinding command appears as follows: Switch Binding State: Enabled and Restricting E Ports 00:11:22:33:44:55:66:77 88:99:AA:BB:CC:DD:EE:FF 11:55:35:45:24:78:98:FA show.snmp.accessTable Syntax Purpose Parameters Command Example Output Example accessTable [index] This command displays the configured values for the Access Table. This command has one optional parameter. Root> show snmp accessTable The output from the show.snmp.
show 2 Security Model The security model. Security Level The security level. Read View The read view name. Write View The write view name. Notify View The notify view name. Config.SNMP> showAccessTable 1 Index: 1 Security Model: Any Security Level: None Group Name: group1 Read View: fcmgmt_3_1 Write View: fceos Notify View: internet NOTE: The command config.snmp.showAccessTable on page 22-89 has the functionality that is the same as this command. show.snmp.
show 2 If the optional parameter, index, is specified, the output from this command contains the following information: SNMPv3 State Indicates the status of SNMPv3 (Enabled or Disabled). Index The index number. Target IP The trap recipient IP. UDP Port The UDP port for the trap recipient Community The community name. MP Model The messaging model. Secuirty Name The security name (username). Security Model The security model. Security Level The security level. Config.
show 2 Output Output Example SNMPv3 Index ----1 2 3 4 5 6 This command displays the following switch configuration data: SNMPv3 State Indicates the status of SNMPv3 (Enabled or Disabled). Index The index number. Username The username. Auth Protocol The Authentication Protocol. Privacy Protocol The Privacy Protocol. The output from the show.snmp.
show 2 Output Output Example SNMPv3 Index ----1 2 3 4 5 6 This command displays the following switch configuration data: SNMPv3 State Indicates the status of SNMPv3 (Enabled or Disabled). Index The index number. Username The username. Model The security model. Group Name The group name. The output from the show.snmp.V3GroupTable command appears as follows: State: Enabled Username -------------------------------User1 Model ----V1 Group Name ---------Group1 show.snmp.
show 2 Output Example The output from the show.snmp.viewTable command appears as follows: View Name -------------------------------no_access internet management experimental private snmpv3 fceos fcmgmt_3_1 fcmgmt_3_0 fcfe system ip Type -----------------View Excluded View Included View Included View Included View Included View Included View Included View Included View Included View Included View Included View Included Object ID --------.1.3.6.1 .1.3.6.1 .1.3.6.1.2 .1.3.6.1.3 .1.3.6.1.4 .1.3.6.1.6 .1.3.
show 2 Output Output Example The switch configuration data is displayed as a table that includes the following properties: SNMP Agent State Displays the state of the SNMP agent. If it is disabled, then the SNMP state will not respond to any requests, nor will it produce any traps. SNMPv3 State The SNMPv3 state. FA MIB Version Number Version of the Fibre Alliance MIB (FA MIB) that the SNMP agent is configured to use.
show 2 show.switch Syntax Purpose Parameters Command Example Output 2-230 switch This command displays the switch attributes. This command has no parameters. Root> show switch The switch attributes data is displayed as a table that includes the following properties: State The state of the switch (for example, online or offline). BB Credit The BB_Credit. (This does not apply to the Sphereon 4300 and Sphereon 4500 switches.
show 2 Interop Mode The interoperability mode as set in the config.switch.interopMode command. For more information, see config.switch.interopMode on page 2-98. Active Domain Id The active domain ID of the switch or director. This ID may or may not be the same as the preferred domain ID. World Wide Name The WWN for the switch or director. Insistent Domain Id Configured insistent domain ID state as set in the config.switch.insistDomainId command. For more information, see config.switch.
show 2 API Enable The enabled state of API. API Management IP address for of where the application that is IP managing the switch or director resides. If there is no application managing the switch, this will be the IP address of the switch. HA Mode Output Example The enabled state of HA mode. The output from the show.
show 2 Output Output Example The system attributes are displayed as a table that includes the following properties. Name The system name. For more information, see config.system.name on page 2-112. Contact The system contact as set in the config.system.contact command. For more information, see config.syslog on page 2-107. Description The system description. For more information, see config.system.description on page 2-111. Location The system description. For more information, see config.system.
show 2 Serial Number: Type Number: Model Name: Model Number: EC Level: Firmware Version: Beaconing: 82420481 006064 ED-6064 001 1011231 04.01.00 Build 23 Disabled show.syslog Syntax Purpose Parameters Output Command Example syslog This command displays the syslog configuration This command has no parameters. The syslog configuration is shown as a table of properties. The following properties are displayed: Log The index number of the server. State Reports if syslog support is enabled.
show 2 show.thresholdAlerts.alerts 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 appears as a table that includes the following properties: Name The name of the threshold alert, truncated to 45 characters.
show 2 State Output Example CTA - CRC Errors. Discarded Frames CTA - Discarded Frames. Frames Too Short CTA - Frames Too Short. Delimiter Errors CTA - Delimiter Errors. Address ID Errors CTA - Address ID Errors. Cls2 BusiedFrms CTA - Class 2 Busied Frames. Cls2 RejectedFrms CTA - Class 2 Rejected Frames. Cls3 DiscardFrms CTA - Class 3 Discarded Frames. Phys Lnk Err Set CTA - Physical Link Errors Summed Set. Lnk Seq Cnt Set CTA - Link Sequence Counts Summed Set.
show 2 Safety #2 Safety #1 Logic Lnk Err Set Cls2 BusiedFrms Enabled Disabled 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).
show 2 Link Resets Received CTA - Link Resets Received. 2-238 E/OS Command Line Interface User Manual OLS Sent CTA - OLS Sent. OLS Received CTA - OLS Received. Link Failures CTA - Link Failures. Sync Losses CTA - Sync Losses. Signal Losses CTA - Signal Losses. Protocol Errors CTA - Primitive Sequence Errors/Protocol Errors. Invalid Tx Words CTA - Invalid Tx Words. CRC Errors CTA - CRC Errors. Discarded Frames CTA - Discarded Frames. Frames Too Short CTA - Frames Too Short.
show 2 LIPS Generated Output Example CTA - Loop Initialization Primitives Generated (Sphereon 4300 and 4500 only). 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 2-240 E/OS 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 Message 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 Description Action Message Description Action Message Description Action Message Description Action Message Description Action 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 Message Description 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.
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description A-6 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. The format of the date parameter must be mm:dd:yyyy or mm/dd/yyyy.
A Action Message Description Action Message Description Action Message Description Action Message Description The format of the time parameter must be hh:mm:ss. The second can contain an integer in the range 0–59. Enter an appropriate time and re-submit. Error 044: Max SNMP Communities Defined A new SNMP community may not be defined without removing an existing community from the list. A total of 6 communities may be defined for SNMP.
A Message Description The RADIUS server Retransmit value entered is invalid. Action Enter a valid Retransmit value. Valid values are 1 to 100. Message Description Action Message Description Action Message Description Action Message Description Action A-8 Error 051: Invalid RADIUS Server Transmit Attempts Value Error 052: Invalid RADIUS Server Deadtime Value The RADIUS server Deadtime entered is invalid. Enter a valid Deadtime value. Valid values are 0 to 1440.
A 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 Message A-10 Error 064: Configuration changes have been limited to the API interface The API interface has restricted this interface from making configuration changes. To make configuration changes from this interface, the API interface will need to update to allow this interface to make changes.
A Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description The requested FRU is not installed. Consult the installation/service manual for this product for appropriate action. Error 072: No Backup FRU The FRU swap cannot be performed because a backup FRU is not installed. Insert a backup FRU and re-submit the request or consult the installation/service manual for this product for appropriate action.
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-12 Reduce the number of members in one or more zones and re-submit the command. Error 077: Not Allowed While Port Is Failed The port selected is in a failed or inactive state, or is in need of service. Consult the installation/service manual for appropriate action.
A Message Description Action Message Description Action Message Description Action Message Description Action Error 083: Not Allowed in Open Fabric Mode This request cannot be completed while this switch is operating in Open Fabric 1.0 mode. Configure the interop mode to McDATA Fabric 1.0 mode. Error 088: Invalid Feature Key Length The feature key installed is longer than the maximum length allowed. Be sure that the key has been entered correctly and re-submit.
A Message Description Action Message The features requested cannot be installed at the same time on one switch or director. Contact your sales representative. Error 099: Preferred Domain ID Cannot Be Zero Description This product cannot be configured to have a preferred domain ID equal to zero (0). Action Ensure that the ID is expressed as an integer in the range 1–31 and re-submit.
A Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action The request cannot be completed because a system diagnostic is running. Wait for the diagnostic to complete. Error 105: Max Threshold Definitions Reached The maximum number of total threshold alerts has already been reached. Remove a threshold alert before adding the new threshold alert.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description A-16 Error 110: Invalid Percent Utilization The type of the throughput threshold alert has not been set. Set the type of the TTA, then try to activate the alert. Error 111: Invalid Threshold Type The type of the threshold alert is not valid. Configure the type of the throughput threshold alert to one of the types found in the enumerated table for TTAs.
A Description This request cannot be completed because the requested port speed is faster than the currently-configured switch speed. Action The switch speed should first be configured to accommodate changes in the configured port speed. The ports cannot operate at a faster rate than the switch, itself. Update the switch speed and re-submit the request. For more information, see config.switch.speed on page 2-103 and config.port.show on page 2-28.
A Message Description Generic message to indicate a problem in either the switch binding or fabric binding membership list. Action Be sure that the membership list submitted does not isolate a switch already in the fabric. If this is not the case, the user needs to be aware of all fabric security rules and make sure that the list submitted adheres appropriately.
A Description Action Message Description Action Message Description Action Message The switch binding state submitted is not recognized by the CLI. The switch binding state must be set to one of the following: disable, erestrict, frestrict, or allrestrict. See config.security.switchBinding on page 2-66 for clarification on these states. Error 139: Insistent Domain ID's Must Be Enabled When Fabric Binding Active The user attempted to disable insistent domain IDs while fabric binding was active.
A Action 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 RSCNs 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 Action Message Description Action Message Description Action Message Description Action Message Description Error 149: Not Allowed While Enterprise Fabric Mode Enabled and Switch Active The request cannot be completed while the switch is online and enterprise fabric mode is Active. This operation will be valid if the switch state is set to offline and enterprise fabric mode to inactive. It should be noted, however, that this can be disruptive to the fabric.
A Action Message 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. Action Fabric security rules prohibit any device or switch from being isolated from the fabric via a membership list change. If it is truly the intention of the user to remove the device in question from the membership list, then there are several approaches to take.
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description 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. Make sure there is at least one IP address in the Access Control List.
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description A-24 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. Error 167: Diagnostics can not be run on inactive port The port is in the inactive state and diagnostics cannot be run.
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action 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. Error 174: Invalid list data The list data is invalid.
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-26 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. Error 179: Insistent Domain IDs must be enabled To complete this command, Insistent Domain IDs must be enabled. Enabled Insistent Domain IDs.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action 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. Error 186: Cannot Block this Port Port is not blockable. Enter a valid port number.
A Message Description Action Message 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. Action A total of 14 policies may be defined for port fencing. A new policy can be added only after a current policy is removed. Make the appropriate changes and re-submit.
A Description Two policies of the same type cannot be enabled if they have the same port type. Action Make sure the policy that is being enabled doesn't have the same port type as a policy that is enabled.
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-30 Be sure all parameters have been entered correctly and re-submit. Contact your service representative with further problems. Error 203: Another Client Has Change Authorization Another user is currently making changes to this switch. Be sure all parameters have been entered correctly and re-submit.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Error 211: Duplicate Zone Two or more zone names in the local zone set are identical. All zone names must be unique. Make the appropriate changes and re-submit. Error 212: Duplicate Zone Member A member was added that already exists in the zone. No action necessary. Error 213: Number of Zones Is Zero You are attempting to activate and empty zone set.
A Description Action To add more members, attach more devices to the switch or add the members by WWN or Domain ID and port. Message Error 217: All Attached Nodes are in the Zone Description All the attached nodes are already in the zone. Action Message Description Action Message Description To add more members, attach more devices to the switch or add the members by WWN or Domain ID and port.
A Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Diagnostics cannot be run on an active E Port. Block the port to run diagnostics. Error 222: Invalid SNMP Community Index The value entered for the SNMP community index is invalid. The SNMP community index must be an integer in the range 1–6. Make the appropriate changes and re-submit the command.
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description A-34 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 228: Invalid Write Authorization Argument The writeAuthorization parameter does not contain a valid value.
A Action Message Description Action Message Description Action Message Description Action Message Description Action 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 233: Invalid Member The zone member added is not valid. For the appropriate parameters, see the section of the manual that corresponds to the attempted command.
A manual that corresponds to the attempted command. Enter the complete command and re-submit. Message Description There was an unidentifiable problem in the local zone set work area. Action Verify all parameters are entered correctly and re-submit. Otherwise, the pending zone set should be cleared and reconstructed. Message Description Action Message Description Action Message Error 238: Invalid Feature Key The feature key entered is invalid.
A Action Some commands require that comma-delimited mode be active (e.g. show.nameserverExt). Enable comma-delimited mode and re-issue the command. Message Error 244: Not allowed when Enterprise Fabric Mode is Active and Switch is Online Description This operation is not allowed while the switch is in Enterprise Fabric Mode and the switch is Online.
A Message Description Action Message Description Action Message Description Action A port or port type must be assigned to an alert before it is enabled. Use the command perf.thresholdAlerts.counter.addPort on page 2-150 to add a port before the alert is enabled. Error 250: Invalid counter threshold alert name The name specified for the alert is not valid. Specify a counter threshold alert name that has already been created.
A Message Description Action Error 255: Invalid throughput threshold alert name The name of the threshold alert is incorrect. Either the name does not exist, or the new name cannot be used because it is illegal or a duplicate. 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.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description A-40 Error 261: No Attached Members Exist There are no members attached to the switch. Check all connections and make sure attached devices are present. 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.
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description The fabric is still building, wait a couple of seconds until it is complete. Error 268: RADIUS key too long The desired RADIUS key is too long. Use a shorter RADIUS key. 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.
A Action Message Description Action Message Description Action Message Description Action Message Error 274: Invalid interface combination The desired interface is not a valid interface. Select a valid interface value. Error 275: Invalid authentication role 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.
A Action Message Description Action Message Description Action Message Description Action Message Select a valid zone member. Error 281: Zone doesn't exist The desired zone doesn't exist. Select a valid zone name. 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.
A Description Action Select a value between 1 and 256. Message Error 287: Port is unaddressable Description Action Message Description Action Message Description The desired port cannot be configured because it is unadressable. This operation is not supported. No action necessary. Error 288: The NPIV feature key must be installed The NPIV feature key must be installed to complete this operation. Install the NPIV feature key.
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Select a different port number. Error 294: Invalid RADIUS Index The specified RADIUS index is invalid. Enter a valid RADIUS index. Valid indexes are 1 to 3. Error 295: Invalid MIHPTO value The MIHPTO value is invalid. Enter a valid MIHPTO value.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-46 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 Message 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 Description Action Message Description Action Message Enable the FICON Management Server. Error 311: FICON CUP Zoning must be disabled You cannot perform this operation until the FICON Management Server is disabled. Disable the FICON Management Server. Error 321: Invalid syslog facility number Description The syslog facility number is invalid Action Select a valid syslog facility number. Message Error 323: Invalid trigger start offset Description The trigger start offset value is invalid.
A Description The trigger end bit pattern is invalid. Action Select a valid trigger end bit pattern. Message Description Action Message Error 327: Invalid trigger The trigger is invalid. Enter a valid trigger value. Error 328: Invalid syslog index Description The syslog index is invalid. Action Select a valid syslog index.
A Action Message Description Action Message Description Action Message Description Action Message Error 336: Invalid SSL renegotiation megabyte value The SSL renegotiation megabyte value is invalid Enter a valid SSL renegotiation megabyte value Error 337: Invalid SNMP table index The SNMP table index is invalid Select a valid index. Error 339: Invalid SNMPv3 user table index The user table index is invalid. Enter a valid index.
A Message Error 343: Invalid SNMPv3 privacy protocol Description The privacy protocol is invalid. Action Select a valid privacy protocol. Message Error 344: Invalid SNMPv3 privacy key Description The privacy key is invalid. Action Select a valid privacy key. Message Description Action Message Description Action Message Error 345: Invalid SNMPv3 target table index The target table index is invalid. Select a valid index. Error 346: Invalid SNMPv3 target IP The Target IP Address is invalid.
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message A-52 Error 349: Invalid SNMPv3 MP model The MP model is invalid. Enter a valid MP model. Error 350: Invalid SNMPv3 security name The security name is invalid. Enter a valid security name. Error 351: Invalid SNMPv3 group name The group name is invalid. Enter a valid group name.
A Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message The number of days for the key generation is invalid. Enter a valid number of days for key generation. Error 361: An internal error occurred when generating the key. An error occurred while generating the SSL key. None Error 362: Duplicate SNMPv3 user name You can't have two SNMPv3 usernames that are the same.
A Description Action Message Description Action Message Description Action Message Description Action Contact your service representative. Error 372: The IP ACL pair does not exist in the Switch Access Control List The IP ACL pair is already not in the list. None Error 373: Configuration not allowed while SNMPv3 is enabled You can't perform the desired operation while SNMPv3 is enabled. Disable SNMPv3 before continuing.
A Message Description Action Error 378: Duplicate IP address The IP address already exists. Choose a different IP Address or remove the existing entry.
A A-56 E/OS 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 8.0 config.security.ssl.generateKeys 8.0 config.security.ssl.resetKeys 8.0 config.security.ssl.setAPIState 8.
B Table B-1 Commands and Releases First E/OS Release B-2 Command 8.0 config.snmp.addV3Group 8.0 config.snmp.addV3Target 8.0 config.snmp.deleteAccessEntry 8.0 config.snmp.setSNMPv3State 8.0 config.snmp.deleteUserEntry 8.0 config.snmp.deleteV3Group 8.0 config.snmp.setSNMPv3State 8.0 config.snmp.showAccessTable 8.0 config.snmp.showTargetTable 8.0 config.snmp.showUserTable 8.0 config.snmp.showV3GroupTable 8.0 config.snmp.showViewTable 8.0 config.snmp.validateUser 8.0 config.
B Table B-1 First E/OS Release Commands and Releases Command 8.0 config.syslog.setState 8.0 config.syslog.show 8.0 config.system.contact 8.0 show.epFrameLog.disableTrigger 8.0 show.epFrameLog.setTrigger 8.0 show.fabric.traceRoute 8.0 show.port.opticData 8.0 show.port.opticHealth 8.0 show.snmp.accessTable 8.0 show.snmp.targetTable 8.0 show.snmp.userTable 8.0 show.snmp.V3GroupTable 8.0 show.snmp.viewTable 8.0 show.syslog 7.0 config.features.NPIV 7.0 config.fencing.
B Table B-1 Commands and Releases First E/OS Release B-4 Command 7.0 config.ficonCUPZoning.setState 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.
B Table B-1 First E/OS Release Commands and Releases Command 7.0 config.security.authentication.interface.web.sequence 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.
B Table B-1 Commands and Releases First E/OS Release B-6 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.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.syslog 6.1 show.thresholdAlerts.log 5.3 config.enterpriseFabMode.setState 5.3 config.features.openTrunking 5.3 config.ficonMS.setMIHPTO 5.3 config.NPIV.maxPortIDs 5.3 config.
B Table B-1 Commands and Releases First E/OS Release B-8 Command 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.fabricBinding 4.0 config.security.
B Table B-1 First E/OS Release Commands and Releases Command 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.date 4.0 config.system.description 4.0 config.system.location 4.0 config.system.name 4.0 config.system.show 4.0 config.zoning.activateZoneSet 4.0 config.zoning.addPortMem 4.0 config.zoning.clearZone 4.
B Table B-1 Commands and Releases First E/OS Release B-10 Command 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.clearStats 4.0 perf.errors 4.0 perf.link 4.0 perf.traffic 4.0 show.eventLog 4.0 show.
B Table B-1 First E/OS Release Commands and Releases Command 4.0 show.port.nodes 4.0 show.port.status 4.0 show.port.technology 4.0 show.preferredPath.showState 4.0 show.security.portBinding 4.0 show.security.switchBinding 4.0 show.switch 4.0 show.system 4.0 show.
B B-12 E/OS 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. active field-replaceable unit Active FRU. A FRU that is currently operating as the active, and not the backup FRU. See also backup field-replaceable unit.
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 at least 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 error-detect time-out value error message Ethernet With director or switch 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 EFCM Basic interface. The interface provides a GUI similar to the Element Manager application, and supports director configuration, statistics monitoring, and basic operation.
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 local area network loopback test loop initialization primitive 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 g-18 E/OS Command Line Interface User Manual
Index Symbols " 1-14 # 1-21 ? 1-20 Numerics 60 characters in history log 1-14 80-column output 1-15 configuring interface 2-36 configuring N port 2-38, 2-39 configuring Open Systems 2-39, 2-40 configuring outgoing 2-35 configuring port 2-42 configuring sequence 2-35 configuring serial 2-41 configuring Web 2-42 showing settings 2-41 authorization traps, SNMP 2-84 A access control list 2-64 adding a range 2-64 delete a range 2-65 disable 2-65 enable 2-65 show 2-65 access rights relationship to other produ
Index help 1-20 logging in or out 1-15 lost 2-126 navigation conventions 1-2 output 1-15 parameters 1-14 purpose 1-2 root> prompt 1-12 using 1-2 CLI commands, case sensitivity 1-2 commaDelim command 1-18 globally available 1-4 command line interface 1-2 command tree 1-4 ED-5000 1-22 errors, handling 1-19 globally available commands 1-4 help 1-20 logging in or out 1-15 lost 2-126 navigation conventions 1-2 output 1-15 parameters 1-14 purpose 1-2 root> prompt 1-12 using 1-2 command tree 1-4 limitations on mo
Index element managers enabling Telnet 1-23 Embedded Frame Log show configuration 2-169 view 2-172, 2-174 enable access control list 2-65 OpenTrunking 2-136 SNMP agent 2-87 enabling 2-6 enterprise fabric mode 2-5, 2-6 feature set 2-7 NPIV 2-8 enbling FICON Management Server 2-7 Enterprise Fabric Mode activating 2-5, 2-6 deactivating 2-5, 2-6 enterprise fabric mode 2-6 disabling 2-5 enabling 2-5 error counters, port 2-131 error light, system, clearing 2-126 escape character 1-14 ethernet attributes 2-188 et
Index resetting 2-126 features preferred path 2-139 fencing policies show 2-184 Fibre Alliance MIB SNMP 2-87 FICON enabling management server 2-7 FICON CUP show zoning 2-185 zoning 2-18, 2-19 FICON Management Server 2-7, 2-20 FICON MS show 2-186 ficonms 2-7, 2-20 FRU information 2-187 G G_port, setting 2-33 gateway address 2-21 globally available commands 1-4 graphical user interface 1-2 GUI 1-2 enabling Telnet 1-23 H help command 1-20 help, technical support xvii history log 1-14 clearing 1-14 HTTP 1-2
Index add member 2-55 clear 2-56 switch binding 2-66 N name server 2-190, 2-192 names, for ports 2-27 navigating the command tree 1-12 faster methods 1-13 limitations 1-14 navigation conventions 1-2 NPIV configuring port IDs 2-23 disable 2-8 enable 2-8 enabling 2-8 set state 2-8 setting state 2-24 showing configuration 2-24 null strings 1-14 NV-RAM configuration parameters, reset 2-126 O offline, setting switches for configuration 2-80 Open Systems setting state 2-25 Open Systems Management Server 2-8, 2
Index preferred domain ID 2-99 preferred path clear 2-140 delete 2-140 destination 2-142, 2-216 disable 2-142 enable 2-142 feature overview 2-139 set exit port 2-141 show 2-216 show exit port 2-198 show path 2-142 show state 2-144 source port 2-142, 2-216 state 2-142 principal switch 2-100 priority, of switches 2-100 publications McDATA products, ordering xviii related xvi updates xvi Q quotation marks for spaces 1-14 in strings 1-14 R r_a_tov 2-101 RADIUS server adding 2-45 configuring deadtime 2-44 con
Index show SSH state 2-63 showing port 2-43 showing RADIUS server 2-46 showing state 2-41 showing user 2-52 switch binding 2-66 adding member 2-67 deleting member 2-67 setting state 2-68 showing configuration 2-69 timeout RADIUS server 2-47 security log 2-219 segmented E_Port 2-213 segmented E_port state reasons 2-213 service, technical support xvii setting online or offline 2-127 settings threshold alert settings 2-164 show access control list 2-65 all 2-167 ethernet attributes 2-188 event log 2-175 fabri
Index setting NPIV 2-24 SNMP 2-87 Zone Flex Pars 2-95 statistic table, threshold alert 2-154 statistics, port, clearing 2-131 strings, null 1-14 strings, quotation marks in 1-14 subnet mask 2-21 summed sets 2-148 swap ports by address 2-32 by number 2-33 switch attributes, displaying 2-230 Switch Binding add SBML member 2-67 configuration 2-66 delete SBML member 2-67 show configuration 2-69 switch binding 2-222 adding member 2-67 delete member 2-67 online state functions 2-66 set state 2-68 show configurat
Index add alert 2-158 trigger percentage 2-162 trigger type 2-161 utilization percentage 2-162 utilization type 2-161 utilization types 2-164 threshold alerts overview 2-144 summed sets 2-148 throughput alert add 2-158 port 2-159, 2-160 set parameters 2-163 show settings 2-164 show utilization types 2-164 utilization percentage 2-162 utilization type 2-161 Throughput Threshold Alert activating 2-146 throughput threshold alert 2-145 types 2-147 time, system 2-110 trademarks xix traffic counters 2-165 traver
Index zone set activating to fabric 2-113, 2-114 clearing 2-117 deactivating 2-117 renaming 2-120 replacing 2-121 temporary copy 2-113 zone sets and zones displaying 2-114 zoning configuring 2-113 FICON CUP 2-18, 2-19 show FICON CUP 2-185 Zone Flex Pars state 2-95 zoning configuration active, display 2-121 pending, display 2-122 i-10 E/OS Command Line Interface User Manual
