User manual

ManualsBrandsMcDATA ManualsNetwork CardOPENconnectors Command Line Interace

E/OS

Command Line Interface

User Manual

P/N 620-000134-780

REV A

Summary of content (406 pages)

PAGE 1
E/OS Command Line Interface User Manual P/N 620-000134-780 REV A
PAGE 2
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.
PAGE 3
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-3 Command Tree ..........
PAGE 4
Contents New and Changed Commands ......................................................2-2 New Commands........................................................................2-2 config ..................................................................................................2-3 config.alias ..................................................................................2-3 config.alias.activatePending ....................................................2-4 config.alias.add .....................
PAGE 5
Contents config.NPIV.setState .............................................................. 2-27 config.NPIV.show .................................................................. 2-27 config.NSTools ........................................................................ 2-28 config.NSTools.clearSnapshot............................................... 2-28 config.NSTools.saveSnapshot ............................................... 2-28 config.NSTools.showSnapDiff .........................................
PAGE 6
Contents config.security.authentication.RADIUS.timeout ................2-54 config.security.authentication.switch.setSecret ..................2-55 config.security.authentication.user.......................................2-56 config.security.authentication.user.add...............................2-56 config.security.authentication.user.delete ...........................2-57 config.security.authentication.user.modify .........................2-58 config.security.authentication.user.passExpTime ..............
PAGE 7
Contents config.security.ssl.setAPIState .............................................. 2-82 config.security.ssl.show ......................................................... 2-82 config.snmp ............................................................................. 2-84 config.snmp.addAccessEntry................................................ 2-85 config.snmp.addAccessViews............................................... 2-86 config.snmp.addCommunity ................................................
PAGE 8
Contents config.switch.ltdFabRSCN ...................................................2-110 config.switch.prefDomainId ................................................2-110 config.switch.priority............................................................2-111 config.switch.raTOV .............................................................2-112 config.switch.rerouteDelay ..................................................2-112 config.switch.RSCNZoneIsolation ......................................
PAGE 9
Contents maint.port.beacon ................................................................. 2-134 maint.port.reset ..................................................................... 2-135 maint.system.beacon ............................................................ 2-135 maint.system.clearSysError ................................................. 2-136 maint.system.ipl .................................................................... 2-136 maint.system.resetConfig ................................
PAGE 10
Contents perf.thresholdAlerts.throughput.setUtilType...................2-173 perf.thresholdAlerts.throughput.setUtilPercentage ........2-174 perf.thresholdAlerts.throughput.setParams .....................2-175 perf.thresholdAlerts.throughput.show ..............................2-175 perf.thresholdAlerts.throughput.showUtilTypeTable.....2-176 perf.traffic ...............................................................................2-177 show..................................................................
PAGE 11
Contents show.port.config ................................................................... 2-214 show.port.exit ........................................................................ 2-216 show.port.info ....................................................................... 2-218 show.port.nodes.................................................................... 2-219 show.port.opticData ............................................................. 2-221 show.port.opticEDD ...........................
PAGE 12
Contents xii E/OS Command Line Interface User Manual
PAGE 13
Tables 1-1 1-2 1-3 CLI Command Tree Navigation Conventions ......................................... 1-3 CLI Command Tree ...................................................................................... 1-5 CLI Command Tree for the ED-5000 Director ........................................ 1-22 2-1 2-2 2-3 Supported Zoning Configurations ......................................................... 2-124 Throughput Threshold Alerts ................................................................
PAGE 14
Tables xiv E/OS Command Line Interface User Manual
PAGE 15
Preface This publication is part of the documentation suite that supports the following McDATA® products: • Sphereon™ 3016, 3032, 3216, 3232, 4300, 4400, 4500, and 4700 Fabric Switches • Intrepid® 6064 and 6140 Directors Who Should Use This Manual This publication is for data center administrators or customer support personnel, who use the Command Line Interface (CLI) equipped with a Telnet Client to manage the following: • Sphereon 3016, 3032, 3216, 3232, 4300, 4400, 4500 and 4700 Fabric Switches • In
PAGE 16
Preface The publications listed in Related Publications provide considerable information about both concepts and McDATA products. Organization of This Manual Manual Updates Related Publications xvi This publication is organized as follows: • Chapter 1, Introduction, provides an introduction and overview of the Command Line Interface.
PAGE 17
Preface Manual Conventions • Sphereon 3016 and 3216 Fabric Switches Installation and Service Manual (620-000154) • Sphereon 3032 and 3232 Fabric Switch Element Manager User Manual (620-000173) • Sphereon 3032 and 3232 Fabric Switches Installation and Service Manual (620-000155) • Sphereon 4300 Fabric Switch Installation and Service Manual (620-000171) • Sphereon 4500 Fabric Switch Installation and Service Manual (620-000159) • Sphereon 4500 Fabric Switch Element Manager User Manual (620-000175)
PAGE 18
Preface Where to Get Help For technical support, McDATA end-user customers should call the phone number located on the service label attached to the front or rear of the hardware product. McDATA’s “Best in Class” Technical Support Center (TSC) and Network Operations Center (NOC) provide single points of contact for customers seeking help. These centers will research, explore, and resolve inquiries or service requests regarding McDATA products and services.
PAGE 19
Preface Please send your comments via e-mail, our home page, or FAX. Identify the manual, and provide page numbers and specific detail. Thank you. E-mail: pubsmgr@mcdata.com Home Page: http://www.mcdata.com Fax: Ordering Publications Technical Communications Manager (720) 558-8999 To order a paper copy of this manual, submit a purchase order as described in Ordering McDATA Documentation Instructions, which is found on McDATA’s web site at the following location: www.mcdata.
PAGE 20
Preface xx E/OS Command Line Interface User Manual
PAGE 21
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-16 Using the commaDelim Command ....................................................
PAGE 22
Command Line Interface Overview 1 Command Line Interface Overview The Command Line Interface (CLI) is a feature that can be used to manage switches and directors. It provides an alternative to the Graphical User Interface (GUI) and web-based (HTTP) interface products. 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, switch, or SSH. Any hardware platform that supports the Telnet client software can be used.
PAGE 23
Entering Command Line Interface Commands 1 Navigation Conventions Basic command line navigation conventions are supported. Table 1-1 includes the asynchronous commands that are recognized by the CLI. 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.~~
PAGE 24
Entering Command Line Interface Commands 1 Table 1-1 Command Tree CLI Command Tree Navigation Conventions (Continued) Character Sequence Common Name Action or Description ^N Control-N Move down one line in the command history. ^P Control-P Move up one line in the command history. ^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.
PAGE 25
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree config---------- alias ------------------------ activatePending add clearPending delete replacePending setCLIState setWebState showActive showPending enterpriseFabMode------ setState features --------------------- enterpriseFabMode ficonMS installKey NPIV openSysMS openTrunking show fencing---------------------- addPolicy addPort deletePolicy removePort setParams setState show showTypeTable ficonCUPZoning---------- addControlHost del
PAGE 26
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) ip----------------------------- setHostCtrlState NPIV------------------------- maxPortIDs setState show NSTools--------------------- clearSnapshot saveSnapshot showSnapDiff showSnapshot openSysMS---------------- setHostCtrlState setState port -------------------------- blocked fan mode name rxCredits show showCredits showPortAddr speed swapPortByAddr swapPortByNum type security---------------------- authentication----------
PAGE 27
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) security---------------------- authentication---------- radius-------------------- attempts deadtime deleteServer server show timeout switch-------------------- setSecret user----------------------- add delete modify passExpTime role show security --------------------- fabricBinding ----------- activatePending addAttachedMembers addMember clearMemList deactivateFabBind deleteMember replacePending showActive showPending port
PAGE 28
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) show ssl ------------------------ generateKeys resetKeys setAPIState setRengotiationMB setWebState show snmp --------------------- addAccessEntry addAccessViews addCommunity addTargetParams addUserEntry addV1Target addV2Target addV3Group addV3Target authTraps deleteAccessEntry deleteCommunity deleteTargetEntry deleteUserEntry deleteV3Group sendTestTrap setFaMibVersion setSNMPv3State setState show showAccessTable showTargetT
PAGE 29
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) setWebState show domainIDOffset domainRSCN edTOV haMode islFSPFCost insistDomainId interopMode ltdFabRSCN prefDomainId priority raTOV rerouteDelay RSCNZoneIsolation safeZoning speed show webState zoneFlexPars zoningRSCN syslog ------------------- addServer deleteServer setLogConfig setState show system ------------------ contact date description location name show zoning ------------------ activateZoneSet addPortMem add
PAGE 30
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) clearZone clearZoneSet deactivateZoneSet deletePortMem deleteWwnMem deleteZone renameZone renameZoneSet replaceZoneSet setDefZoneState showPending showActive maint ---------- port ----------------------- beacon system ------------------ beacon reset clearSysError ipl resetConfig setOnlineState perf------------- AFD -------------------- HDDReport POMReport Show class2 class3 clearStats errors link openTrunking --------
PAGE 31
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) 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 ---------- activeAlias all auditLog epFrameLog----------- config disabl
PAGE 32
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) fabric--------------------- nodes ping principal showRouteTable topology traceroute fabricLog---------------- noWrap wrap features fencing------------------- policies ficonCUPZoning ficonMS frus ip -------------------------- ethernet linkIncidentLog loginServer nameServer nameServerExt nameServerFC4Types NPIV--------------------- config openSysMS------------ config platformInfo openTrunking ---------- config rer
PAGE 33
Entering Command Line Interface Commands 1 Table 1-2 CLI Command Tree (Continued) preferredPath ---------- showPath security------------------ fabricBinding showState log portBinding switchAcl switchBinding snmp -------------------- accessTable config targetTable userTable V3GroupTable viewTable switch syslog system thresholdAlerts-------- alerts log zoning With the exception of the zoning commands, all the others are listed in alphabetical order.
PAGE 34
Entering Command Line Interface Commands 1 Navigation of the CLI Command Tree To move from the root through any of the four extended branches, enter the name of the next branch as shown in Table 1-2, CLI Command Tree, page 1-5. For example, to use the config.port.name command to configure the name for port 4 on the switch, enter the series of commands as follows: Root> config Config> port Config.Port> name 4 "Sam’s Tape Drive" If you want to set the beaconing state of port 4 using the enter the maint.
PAGE 35
Entering Command Line Interface Commands 1 When coding a script, remember to code the appropriate character sequences, which are described in Navigation Conventions on page 1-3. Root> config port name 4 "Sam’s Tape Drive" Root> maint port beacon 4 true Limitation on Movements The commands that are entered are recorded in a history log.
PAGE 36
Logging In and Logging Out 1 Config.System> location "Building 24 \"Joe’s PlayLab\"" A null string can be created by using the quotation marks without any space between them. Config.System> location "" Output Output from the CLI commands is limited to the standard 80 columns supported by most Telnet interfaces. The output is left-aligned. Logging In and Logging Out The CLI allows a single Telnet client to be connected to the switch.
PAGE 37
Logging In and Logging Out 1 • Non-printable and extended ASCII characters can be entered by using a backslash. • Two hexadecimal characters must follow the backslash. • All printable ASCII characters can be entered using the keyboard or using its hexadecimal value except for the backslash character. If a backslash is desired as part of the password its hexadecimal representation must be used.
PAGE 38
Logging In and Logging Out 1 The login command is called automatically by the CLI whenever a new Telnet session is activated or new administrator access rights are configured. Users are prompted to change the password after logging in with the default password (password). However, at the next login, they will be required to change the password if the default password is still being used. A user name and password can be set by the administrator through the config.security.authentication.user.
PAGE 39
Logging In and Logging Out 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 displays 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.
PAGE 40
Logging In and Logging Out 1 Root> confg Error 234: Invalid Command • An error associated with fabric or switch issues: For example, a parameter error is detected by the switch where port 24 is entered for a switch that supports only 16 ports: Root> config port name 24 "Port 24" Error 218: Invalid Port Number In either case, the command is ignored. The CLI remains at the same point before the command was entered.
PAGE 41
Commenting Scripts 1 Commenting Scripts Use the pound sign (#) 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.
PAGE 42
ED-5000 Director 1 ED-5000 Director A subset of CLI commands described in this publication is available on the ED-5000 Director™. The Globally available commands are described previously in this chapter. The list of commands for ED-5000 Director are listed in Table 1-3. For a description of these commands, refer to Chapter 2, New and Changed Commands.
PAGE 43
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/switch or Secure Shell (SSH). Any hardware platform that supports the Telnet client software can be used to enter the CLI commands. Use the Configure option in the GUI-based or web-based interfaces to enable/disable Telnet access. Telnet access is enabled by default.
PAGE 44
Telnet Session 1 1-24 E/OS Command Line Interface User Manual
PAGE 45
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.....................................................................................................
PAGE 46
Command Overview 2 Command Overview The listed commands are arranged in alphabetical order. The commands can be entered in any order, depending on the results desired as per the command line tree. The various show commands are usually entered at the end of a group of other commands to verify configuration changes. New and Changed Commands New Commands The following CLI commands are new for this edition of the E/OS Command Line Interface User Manual: 2-2 • config.alias on page 2-3 • config.alias.
PAGE 47
config 2 config The config branch of the CLI command tree contains commands that set parameter values on the switch or director. These values are not temporary (session) values but are retained across power cycles. The commands in the config branch can only be accessed by a user logging in as administrator. CLI commands are activated on the switch immediately except under certain conditions, which are noted in the command description. In general, the config naming commands (except for the config.
PAGE 48
config 2 • fabricbinding.deletemember • portbinding.addmember • portbinding.deletemember • switchbinding.addmember • switchbinding.deletemember • zoning.addwwnmember • zoning.deletewwnmember • security.authentication.user.add • ficoncupzoning.addControlhost • ficoncupzoning.deletecontrolhost • show.security.portbinding • show.port.profile • show.port.info • show.fabric.
PAGE 49
config 2 config.alias.add Syntax add wwn alias Description This command adds the association that exists between a WWN and its alias from the pending alias database. This command can be run only after copying the active association list into the pending list using the replacePending command. The parameter should be any one member of the association – either the WWN or the alias. Parameters This command has two parameters: Command Example wwn The WWN to associate with the alias.
PAGE 50
config 2 Parameters This command has one parameter. parameter Command Example This can either be WWN or alias. Root> config alias delete 11:22:33:44:55:66:77:88 or Root> config alias delete AliasName config.alias.replacePending Syntax replacePending Description This command copies the list of the active alias associations to the pending alias association list. Parameters This command has no parameters. Command Example Root> config alias replacePending config.alias.
PAGE 51
config 2 Parameters This command has one parameter: state Command Example The enabled/disabled state for displaying Aliases in the Web interface. This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Root> config alias setWebState 1 or Root> config alias setWebState disable config.alias.showActive Syntax showActive Description This command displays all the alias entries that are available in the active alias database.
PAGE 52
config 2 config.alias.showPending Syntax showPending Description This command displays the alias entries that are available in the pending alias database. Parameters This command has no parameters. Output Output Example This command displays the currently associated WWNs and their aliases that are in the active association list. Also, it displays the current associations count and possible total associations count. Config.
PAGE 53
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: Open Trunking should be disabled before activating Enterprise Fabric Mode. config.features.
PAGE 54
config 2 config.features.ficonMS Syntax Purpose ficonMS ficonMSState This command enables or disables the FICON Management Server. The FICON Management Server feature key must be installed in order to enable the FICON Management Server State. Sphereon 4300 and Sphereon 4500 switches do not accept this command. This command is displayed on Sphereon 3016 and 3216 switches only if the feature key is installed.
PAGE 55
config 2 Parameters This command has one parameter: featureKey Specifies the key you have received to enable an 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. Command Example Root> config features installKey AaBb-CCdD-eeFF-gH config.features.
PAGE 56
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-30 has functionality that is identical to this command. config.features.
PAGE 57
config 2 Output Output Example 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. Features related to the switch are displayed as Enabled/Disabled.
PAGE 58
config 2 config.fencing.addPolicy Syntax Purpose addPolicy name This command configures a new fencing policy and assigns it a name. The new policy is assigned default settings, which must be changed before the policy is activated. Refer to the command config.fencing.setParams on page 2-17 for default settings. Parameters This command has one parameter. name Command Example Specifies the name of the new fencing policy.
PAGE 59
config 2 Parameters 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.
PAGE 60
config 2 config.fencing.deletePolicy Syntax Purpose Parameters deletePolicy name This command deletes the specified fencing policy. Only disabled fencing policies can be deleted. This command has one parameter: name Command Example The name of the fencing policy. You can also enter all for this argument. This will delete all of the configured fencing policies. Root> config fencing deletePolicy Policy1 config.fencing.
PAGE 61
config 2 Command Example Root> config fencing removePort 24 config.fencing.setParams Syntax Purpose Parameters setParams name typeNumber limit period This command sets the type, limit, and period values for the specified fencing policy. 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.
PAGE 62
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 the 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.
PAGE 63
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.
PAGE 64
config 2 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.
PAGE 65
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).
PAGE 66
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.
PAGE 67
config 2 Command Example Root> config ficonms setMIHPTO 180 config.ficonMS.setState Syntax Purpose setState ficonMSState This command enables or disables the 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. This command is displayed on a Sphereon 3016 only if the feature key is installed.
PAGE 68
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.
PAGE 69
config 2 Purpose Parameters Command Example This command sets the Ethernet line speed. 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.
PAGE 70
config 2 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. The Product Feature Enablement key that enables NPIV has to be purchased from McDATA. config.NPIV.
PAGE 71
config 2 config.NPIV.setState Syntax Purpose Parameters setState NPIVEnabledState This command sets the enabled state of the NPIV feature. The NPIV feature key must be installed in order to enable this feature. This command has one parameter: 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.
PAGE 72
config 2 NOTE: The command show.NPIV.config on page 2-210 has functionality that is the same as this command. config.NSTools The NSTools command on the configuration branch enters the NSTools configuration branch. All commands under this branch operate on the Nameserver snapshot database. config.NSTools.clearSnapshot Syntax Description clearSnapshot This command clears the Nameserver database entries from the snapshot database that was saved. Refer to config.NSTools.
PAGE 73
config 2 config.NSTools.showSnapDiff Syntax showSnapDiff Description This command displays a list of FC IDs of nodes that have logged in or logged out from the nameserver since the last snapshot was taken. Parameters This command has no parameters. Command Example Output Output Example Root> config NSTools showSnapDiff The following properties are displayed: Snapshot Time The time at which the Nameserver snapshot was taken. Current Time The current date and time.
PAGE 74
config 2 Parameters Command Example Output Example This command has no parameters. Root> config NSTools showSnapshot The output from the config.NSTools.showSnapshot command appears as follows: Config.NSTools> showsnapshot Snapshot Time: 02/27/2006 22:35:41 Saved NS Entries ---------------690BDC 690BE0 690BE1 690BE2 690BE4 690BE8 config.openSysMS.
PAGE 75
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 openSysMS setState 1 NOTE: The command config.features.openSysMS on page 2-11 has functionality that is identical to this command. config.port.blocked Syntax Purpose Parameters blocked portNumber blockedState This command sets the blocked state for a port.
PAGE 76
config 2 config.port.fan Syntax Purpose Parameters fan portNumber fanState This command sets the Fabric Address Notification (FAN) state for a port (Sphereon 4300 and Sphereon 4500 switches only). This configuration can be applied to any port regardless of its current configuration. The FAN value is applied at the time the port is configured and operated in a loop. This command has two required parameters: portNumber Specifies the port number.
PAGE 77
config 2 Parameters This command has two required parameters: portNumber Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 0–15 for the Sphereon 4400 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 0–31 for the Sphereon 3232 0–31 for the Sphereon 4700 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 portName Command Example Specifies the name for the port. The port name must not exceed 24 characters in length.
PAGE 78
config 2 Parameters This command has two required parameters: portNumber Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 0–15 for the Sphereon 4400 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 0–31 for the Sphereon 3232 0–31 for the Sphereon 4700 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 numBBCredits Specifies the number of Rx BB_Credits to assign the specified port.
PAGE 79
config 2 Parameters This command has one parameter: portNumber Specifies the port number. Valid values are: 0–12 for the Sphereon 4300 0–15 for the Sphereon 3016 0–16 for the Sphereon 4400 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 0–32 for the Sphereon 4700 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 Command Example Output Root> config port show 4 This command output appears as a table that includes the following properties: Port Number The port number.
PAGE 80
config 2 Speed The configured port speed. Valid values are: 1G – 1 Gb/sec 2G – 2 Gb/sec 4G – 4 Gb/sec (Sphereon 4400 and Sphereon 4700 only) 10G – 10 Gb/sec (XPM only) Neg - Negotiate 4G Burst – 4 Gb/sec Burst (QPM only) 4G Sust – 4 Gb/sec Sustained (QPM only) Neg Sust – Negotiate Sustained (QPM only) Neg 2G Max – Negotiate 2 Gb/sec Maximum (QPM only) Neg B 4G Max – Negotiate Burst 4 Gb/sec Maximum (QPM only) Rx BB_Credits Output Example The number of configured Rx BB_Credits.
PAGE 81
config 2 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. Swapped Port Num If the port is swapped with another port, it will show the port number of the port it is swapped with. Port ---0 1 2 3 4 5 6 7 8 ...
PAGE 82
config 2 Output 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 Output Example Total The total number of BB_Credits that this pool contains. Allocated The number of BB_Credits that are currently allocated to ports. Available The number of BB_Credits that are currently available to allocate to ports. Ports A list of port numbers that belong to the pool.
PAGE 83
config 2 NOTE: Port speed changes temporarily disrupt port data transfers. Parameters This command has two required parameters: portNumber Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 0–16 for the Sphereon 4400 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 0–32 for the Sphereon 4700 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 portSpeed Specifies the speed of the port.
PAGE 84
config 2 config.port.swapPortByAddr Syntax Purpose Parameters Command Example swapPortByAddr portAddr1 portAddr2 This command will swap two ports given the port addresses. The ports must be offline to perform this operation. 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.
PAGE 85
config 2 NOTE: On the Sphereon 4300 Switch, the E_Port, G_Port, and GX_Port options are not valid unless the Fabric Capable feature is enabled. For more information, see the McDATA Sphereon 4300 Switch Installation and Service Manual (620-000171). The port configurations function as follows: Parameters • 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.
PAGE 86
config 2 portType Specifies the type of the port. Valid values for the port type are: eport fport gport fxport (Sphereon 4300 and Sphereon 4500 only) gxport (Sphereon 4300 and Sphereon 4500 only) Command Example Root> config port type 4 fport config.security Using the security command on the configuration branch, users can enter the security configuration branch. All commands under this branch operate on a particular security attribute.
PAGE 87
config 2 config.security.authentication.interface.api.outgoing Syntax Purpose Parameters outgoing enabledState This command determines if outgoing CHAP authentication is used on all API sessions. If this is enabled, the switch will issue a CHAP challenge to authenticate all new API connections. This command has one parameter: enabledState Command Example This parameter enables and disables outgoing CHAP authentication for API sessions. Valid values for this parameter are enable or disable.
PAGE 88
config 2 config.security.authentication.interface.cli.sequence Syntax Purpose Parameters sequence method1 [method2] This command sets the sequence that the CLI interface will use to authenticate. When the preferred method cannot be contacted, the backup method will be used to authenticate the CLI login. This command has one required parameter, and one optional parameter: method1 This sets the preferred method of authentication for the CLI interface. Accepted values are local or RADIUS.
PAGE 89
config 2 Command Example Root> config security authentication interface eport outgoing disable config.security.authentication.interface.eport.sequence Syntax Purpose sequence method1 [method2] This command sets the sequence that the E_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.
PAGE 90
config 2 NOTE: This command requires that the SANtegrity Authentication feature key be installed. Parameters This command has one parameter: enabledState Command Example This parameter enables and disables outgoing CHAP authentication on all ISLs. Accepted values for this parameter are enable or disable. Boolean 1 and 0 values may also be substituted. Root> config security authentication interface eport outgoing disable config.security.authentication.interface.nport.
PAGE 91
config 2 config.security.authentication.interface.osms.outgoing Syntax Purpose outgoing enabledState This command determines if outgoing authentication is used on all OSMS requests. The OSMS key must be configured prior to setting the outgoing state to enabled. 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.
PAGE 92
config 2 NOTE: The SANtegrity Authentication feature key must be installed to configure the FCCT key. Parameters Command Example This command has no required parameters. Root> config security authentication interface osms setKey config.security.authentication.interface.serial.enhancedAuth Syntax Purpose Parameters enhancedAuth enhancedAuthState This command sets the enhanced serial authentication state.
PAGE 93
config 2 Parameters This command has one parameter: interface The interface that will be displayed. Valid values for this parameter are: cli web osms api serial eport nport 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.
PAGE 94
config 2 NOTE: A preferred method of local and a backup method of RADIUS is not an accepted combination because the local method can always be contacted. Command Example Root> config security authentication interface cli sequence RADIUS local config.security.authentication.port.override Syntax Purpose override portNumber [overrideState] This command sets the outgoing override state for a single port.
PAGE 95
config 2 Command Example Root> config security authentication port override 138 enable config.security.authentication.port.show Syntax Purpose Parameters Command Example Output Output Example show This command displays a table displaying the outgoing override state for each port. This command has no parameters. Root> config security authentication port show This command displays all valid user names in the local database for the specified interface. Port The port number.
PAGE 96
config 2 received before the timeout. After the transmit attempt limit is reached, the switch will, if applicable, move to the next defined RADIUS server. The default number of attempts is three. Parameters Command Example This command has two required parameters: index Index of the RADIUS sever (1-3) to change the transmit attempts value. attempts The number of transmit attempts. Valid values are between 1 and 100. Root> config security authentication RADIUS attempts 3 20 config.security.
PAGE 97
config 2 numbered slots, these servers will be automatically moved up to the first available slots. Parameters This command has one required parameter: index Command Example Index of the server to be removed. Root> config security authentication RADIUS deleteServer 3 config.security.authentication.RADIUS.server Syntax Purpose server index [IP:port] This command adds or modifies one RADIUS server at a given index that will be used for authentication.
PAGE 98
config 2 config.security.authentication.RADIUS.show Syntax Purpose Parameters Command Example Output Output Example show This command displays the current RADIUS server configuration. This command has no parameters. Root> config security authentication RADIUS show This command displays all three configured RADIUS servers. Deadtime The amount of time a server is marked as “dead”. Server The IP address and UDP port of the configured RADIUS server. Attempts The number of transmit attempts.
PAGE 99
config 2 For example, if all of the ports on an Intrepid 6140 Director are coming online at the same time and requiring authentication, some of the ports may not get an access_accept before they timeout. Parameters Command Example This command has two required parameters: index Index of the RADIUS sever (1-3) to change the timeout value. seconds The number of seconds before the RADIUS server retransmits. Valid values are between 1 and 1000.
PAGE 100
config 2 config.security.authentication.user One of the fundamental concepts of the authentication portion of the CLI is that all secured interfaces have interchangeable users that are stored in a single local authentication user database. In the past, CLI supported authorization for only two username/password pairs (Administrator and Operator). These two username/password pairs were also unique to the CLI interface.
PAGE 101
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 new user name that will be added to the local authentication database. If the entered user name already exists in the user database, an error will be shown. This parameter can be from 1-23 characters in length for an API, Web, or CLI username. E_Port and N_Port usernames must be entered as a standard colon-delimited WWN.
PAGE 102
config 2 Purpose Parameters This command deletes an entry from the local authentication database. Both the Web and CLI interfaces must have at least one valid username with an Administrator role. This command has one parameter: username Command Example A valid user name in the local authentication database. Root> config security authentication user delete 01:2A:3f:4:5:0:0 config.security.authentication.user.
PAGE 103
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.
PAGE 104
config 2 Description This command configures the password expiry time for the management users of the switch/director. The value “0” specifies that the user password will never expire. Parameters This command has one parameter: days Command Example A number from 0 - 3650 specifying the number of days after which the user password will expire. Root> config security authentication user passExpTime 90 config.security.authentication.user.
PAGE 105
config 2 Parameters This command has one optional parameter: interface The interface that will be displayed. Accepted values for this parameter are: • • • • • Command Example Output cli web api eport nport Root> config security authentication user show web The output is displayed as a table with the following properties: Username The username specified by the user. Interfaces The management interfaces that a user belong to. Role The management role of the user.
PAGE 106
config 2 accidental fabric merges and potential fabric disruption when fabrics become segmented because they cannot merge. Fabric Binding Commands The config.security.fabricBinding commands function in a different way from most CLI commands, which are single action commands that take effect immediately. Most of the Fabric Binding commands affect a temporary copy of an FBML in the work area called the Pending FBML. When this temporary copy is activated to the fabric, it is called the Active FBML.
PAGE 107
config 2 unattached if they have been added manually to the pending FBML, or if they are segmented from the local fabric. Enable/Disable and Online State Functions For Fabric Binding to function, specific operating parameters and optional features must be enabled. Also, there are specific requirements for disabling these parameters and features when the switch or director is offline or online.
PAGE 108
config 2 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. This command has no parameters. Root> config security fabricbinding addAttachedMembers config.security.fabricBinding.
PAGE 109
config 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. When the list is cleared, the CLI automatically adds the managed switch to the Pending FBML. Parameters Command Example This command has no parameters.
PAGE 110
config 2 Parameters Command Examples This command has two parameters: wwn WWN of the member to be removed from the Pending FBML. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00). domainId The domain ID of the member to be removed from the Pending FBML. Valid domain IDs range from 1 to 239. Root> config security fabricBinding deleteMember AA:99:23:23:08:14:88:C1 2 config.security.fabricBinding.
PAGE 111
config 2 Output Output Example 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. 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-62. The output from the config.security.fabricBinding.
PAGE 112
config 2 Output Example The output from the config.security.fabricBinding.showPending command appears as follows. Domain Domain Domain Domain 1 3 2 14 (20:30:40:50:60:70:8F:1A) (00:11:22:33:44:55:66:77) (88:99:AA:BB:CC:DD:EE:FF) (11:55:35:45:24:78:98:FA) (Local) (Unattached) (Attached) (Attached) config.security.portBinding The Port Binding CLI commands enables users to bind a specific switch or director port to the WWN of an attached node, switch, or director for exclusive communication. config.
PAGE 113
config 2 portBindingState Specifies the port binding state as active or inactive. Valid values are true and false. true sets the port binding to active. The specified port is bound to the WWN configured with the config.security.portBinding.wwn command. If no WWN has been configured, no devices can log in to that port. false sets the port binding to inactive. Any device is free to connect to the specified port in this state, regardless of the WWN setting. Boolean 1 and 0 may be substituted as values.
PAGE 114
config 2 Output Output Example The port binding configuration date is displayed as a table that includes the following properties: Port Number The port number. WWN Binding The state of port binding for the specified port: active or inactive. Bound WWN The WWN of the device bound to the specified port. If this field is blank, no device has been bound to the specified port. The output from the config.security.portBinding.show command appears as follows.
PAGE 115
config 2 boundWwn WWN of the device that is being bound to the specified port. The value must be entered in colon-delimited hexadecimal notation (for example, 11:22:33:44:55:66:AA:BB). If the boundWwn is configured and the portBindState is: Active—only the device described by boundWwn can connect to the specified port. Inactive—the WWN is retained, but any device can connect to the specified port.
PAGE 116
config 2 config.security.ssh.resetKeys Syntax Purpose Parameters Command Example resetKeys This command resets the SSH Public/Private keys. After resetting the keys, the new keys are generated immediately and do not wait until the next user session. This command has no parameters Root> config security ssh resetKeys config.security.ssh.
PAGE 117
config 2 enable; otherwise, only Telnet can be accepted. Both SSH and Telnet cannot be enabled at the same time. Parameters This command has one parameter: sshEnableState Command Example This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Root> config security ssh setState enable config.security.ssh.
PAGE 118
config 2 MIHxMIGoBgcqhkjOOAQBMIGcAkEAt+W14KwlGwHMzV15vSBxNXpMckhr 3gpVOAkq/6ACLZDDGD8Izlq+mxK0afu7Ir5hexE9v5potwk0fk38kwPh MQIVAN/hih31RuuaQTNgQNVAtrTDkFBVAkBaYRsm4Fj7/4i8Lt7OydKJ cYTMAJhJ71UboAVFpmfyVpCQOh3RFK9HfNYJYjkTaSTB3QQt9Hz1HilU /oKSx8aBA0QAAkEAh0B1piZzDUfXmLuKsIf2sst7lSXfgtkxg85dfpPy JMSqM6M93D5wM3Nh/O54tSefEDi559HftVsX4YFKmYXV+w== -----END PUBLIC KEY----MD5 Fingerprint: d1:f2:aa:9d:ec:92:de:38:75:d0:47:2f:9c:cb:b2:02 SHA-1 Fingerprint: dc:f5:33:c8:e0:8b:01:4b:ce:b5:68:a1:55:2b:dd:8f:a5:5c:8c :26
PAGE 119
config 2 config.security.switchAcl.deleteRange Syntax Purpose Parameters 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).
PAGE 120
config 2 Parameters Command Example Output 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 Output Example The ending IP Address of the range in the access control list. The output from the config.security.switchAcl.show command appears as follows. ACL State: Disabled Starting IP Address ------------------110.
PAGE 121
config 2 • If Enterprise Fabric Mode is enabled and the switch or director is online, Switch Binding cannot be disabled. • If Enterprise Fabric Mode is enabled and the switch or director is offline, users 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.addMember Syntax Purpose Parameters addMember wwn This command adds a new member to the SBML.
PAGE 122
config 2 Command Example Root> config security switchBinding deleteMember AA:99:23:23:08:14:88:C1 config.security.switchBinding.setState Syntax Purpose Parameters setState switchBindingState This command sets the switch binding state on the switch. This command has one parameter: switchBindingState Sets the switch binding state for the switch. Valid values are: disable - Disables switch binding. Devices (servers, storage, and other switches) are allowed to connect to the switch without restrictions.
PAGE 123
config 2 Output This command displays the following switch binding configuration data: switchBindingState The state of switch binding, which can have the following values: Disabled Enabled and Restricting F_Ports Enabled and Restricting E_Ports Enabled and Restricting All Ports Switch Binding Membership List Output Example The WWNs of members of the SBML saved on the switch. The output from the config.security.switchBinding.
PAGE 124
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, users will see a message upon SSL connection that indicates that the new certificate is unrecognized. You can then choose to accept or reject the connection.
PAGE 125
config 2 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 megabytes that can be transferred using SSL before the SSL session is automatically re-negotiated. This re-negotiation increases security by limiting the amount of data encrypted with the same negotiated SSL parameters. This command does not affect the SSL certificate or private key.
PAGE 126
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.
PAGE 127
config 2 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.
PAGE 128
config 2 cmlhbCBOdW1iZXIgVEVTVDQ1MDAwHhcNMDUwNTAyMTI0OTU0WhcNMDUwNjIxMTI0 OTU0WjBAMRYwFAYDVQQDEw0xNzIuMjYuMjIuMjEyMSYwJAYDVQQKEx1Td2l0Y2gg U2VyaWFsIE51bWJlciBURVNUNDUwMDBcMA0GCSqGSIb3DQEBAQUAA0sAMEgCQQC6 et6ISmqRSRCODtWgk0M/9Hl6iKLBF1Eoyb0t0ujq1IawEll7BvQZSyWhBqEx4had 48HXRw6r71O3gYIWSSFfAgMBAAGjHDAaMBgGA1UdEQQRMA+CDTE3Mi4yNi4yMi4y MTIwDQYJKoZIhvcNAQEFBQADQQBaa325NT4TU2E4vrtUORg5I6xSob/Uh3kiLO77 PkCJPZeex7N/8k8ur2c8CGNxG7OFe9yBqDyF2oQHYiulg5Kq -----END CERTIFICATE----MD5: 1F:AC:B8:FF:BD:92:F0:13:E7:43:5E:A
PAGE 129
config 2 on localization, refer to http://www.ietf.org/rfc/rfc3414.txt?number=3414. config.snmp.addAccessEntry Syntax Purpose Parameters addAccessEntry index secModel secLevel groupName This command adds an entry to the access table. This command has four parameters: index Index of the access entry. Valid values are 1 to 12. secModel Specifies the Security Model to be used for this entry. Possible values for this parameter are v1, v2 and usm. secLevel Specifies the security level for this entry.
PAGE 130
config 2 config.snmp.addAccessViews Syntax Purpose Parameters Command Example addAccessViews index secModel secLevel groupName This command sets the views for a particular entry in the access table. This command has a one-to-one mapping with the config.snmp.addAccessEntry command. This command has four parameters: index Index of the access entry. Valid values are 1 to 12. readView The name of the Read View. See the View table for possible values. writeView The name of the Write View.
PAGE 131
config 2 Command Example writeAuthorization Specifies the write authorization state of the community. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values. trapRecipient Specifies the IP address of the trap recipient. Values must be 4 bytes in dotted-decimal format. udpPortNum Specifies the User Datagram Protocol (UDP) port number to which the director sends traps for each recipient. The value can be a decimal number or default. The default value is 162.
PAGE 132
config 2 secLevel Specifies the security level for this entry. It specifies whether the entry requires authentication and/or privacy.
PAGE 133
config 2 authPtcl Specifies the authentication protocol being used by this user. The possible values for this parameter are noauth, md5 and sha. The value noauth specifies that this user does not use any authentication protocol. The values MD5 and SHA specify that the respective protocols that are used for authentication. If this parameter is set to MD5 or SHA, then after the command has been executed, the user will be prompted twice for a 16 byte MD5 key, or a 20 byte SHA key.
PAGE 134
config 2 username Specifies the User Name (also referred as Security Name) for this entry. The maximum length for this User Name is 32 characters. All characters in the ISO-Latin 1 character set are valid for this user name. The same user can be mapped to the same group if the security model is different or, mapped to the same security model with a different group name. Command Example Output Example secModel Specifies the Security Model to be used for this entry.
PAGE 135
config 2 Parameters This command has four parameters. The last two are optional. index Index of the target entry. Valid values are 1 to 6. community Community string of the target entry. The maximum length of the community string is 32 characters. All characters in the ISO Latin-1 character set are valid for community names. Duplicate community names are allowed, but the corresponding security names (refer to the command config.snmp.addTargetParams on page 22-87) must also match.
PAGE 136
config 2 community Community string of the target entry described by the index. The maximum length of the community string is 32 characters. All characters in the ISO Latin-1 character set are valid for community names. Duplicate community strings are allowed. IP The IP 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. This value is expressed in decimal and the default value is 162.
PAGE 137
config 2 Command Example Root> config snmp addv3target 6 124.56.67.98 165 Root> config snmp addv3target 6 124.56.67.98 config.snmp.authTraps Syntax Purpose Parameters authTraps enabledState This command enables or disables the authentication traps to be sent to the SNMP management stations when unauthorized stations try to access SNMP information from the director or switch. This command has one parameter: enabledState Command Examples Specifies whether the authentication traps are enabled.
PAGE 138
config 2 Parameters This command has one parameter: commIndex Command Example Specifies the community to be deleted. Valid values are integers in the range 1–6. This value was set in the commIndex parameter of the config.snmp.addCommunity command. Root> config snmp deleteCommunity 5 config.snmp.deleteUserEntry Syntax Purpose Parameters deleteUserEntry index This command deletes the specified user entry from the user table.
PAGE 139
config 2 Parameters This command has one parameter: index Command Example Index of the user entry. Valid values are 1 to 6. Root> config snmp deleteV3Group 1 config.snmp.sendTestTrap Synopsis sendTestTrap Purpose This command instantly generates the fcConnUnitEvent trap with event type as “status” and event description as “Reason code 0”. Parameters Command Example This command has no parameters. Root> config snmp sendTestTrap config.snmp.
PAGE 140
config 2 Purpose Parameters 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. This command has one parameter: versionNumber Command Example Sets the version of the Fibre Alliance MIB version number. Accepted values for this command are 3.0 or 3.1. Root> config snmp setFaMibVersion 3.1 config.snmp.setState Syntax Purpose Parameters setState enabledState This command enables or disables the SNMP agent.
PAGE 141
config 2 Output Example FA MIB Version Number Version of the Fibre Alliance MIB (FA MIB) that the SNMP agent is configured to use. Authentication Traps The state of the authentication traps (for example, enabled) that are sent to SNMP management stations when unauthorized stations attempt to access SNMP information from the switch. Index The community index number. Community Name The name of the community. WriteAuth The write authorization state.
PAGE 142
config 2 ----1 2 3 4 5 6 7 8 9 10 11 12 ---------group1 v1Group v2Group usmGroup usmGroup or If you specify the index, the output of this command will contain the following data: Index Index of the access entry. Valid values are 1 to 6. Group Name The group name. 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.
PAGE 143
config 2 Parameters This command has one optional parameter: Index of the access entry. Valid values are 1 to 6. index Command Example SNMPv3 Index ----1 2 3 4 5 6 Config.SNMP> showTargetTable State: Enabled Target IP UDP Port ------------- -------172.19.16.169 162 Community -------------------------------public MP Model -------SNMPv1 or Specifying the index will give the following output: Config.
PAGE 144
config 2 Security Name The security name (user name). Security Model The security model. Security Level The security level. NOTE: The command show.snmp.targetTable on page 22-242 has functionality that is same as that of this command. config.snmp.showUserTable Syntax Purpose Parameters Output Command Example SNMPv3 Index ----1 2 3 4 5 6 showUserTable [index] This command displays the users configured presently in the USM table. This command has no parameters.
PAGE 145
config 2 config.snmp.showV3GroupTable Syntax Purpose Parameters Output showV3GroupTable This command displays the Security-to-Group table. This command has no parameters. This command displays the following switch configuration data: SNMPv3 State Indicates whether SNMPv3 is enabled or disabled. Index The index number. Username The username. Model The security model. Group Name The group name. Example Index ----1 2 3 4 5 6 config.
PAGE 146
config 2 Output Command Example This command displays the following switch configuration data: View Name The name of the view. Type The type of the view. Object ID The Object ID. config.
PAGE 147
config 2 Output Command Example This command displays the following switch configuration data: Username The user name. Auth Protocol The authentication protocol used for this user. Priv Protocol The privacy protocol used for this user. Security Model The security model for this user. Security Level The security level for this user. Context Match The context match method. Group Name The group that this user belongs to. Read View The read view access for this user.
PAGE 148
config 2 config.switch.apiState Syntax Purpose Parameters apiState apiEnabledState This command sets the state of the API interface. When disabled, access through the API interface will be turned off. This command has one parameter: apiEnabledState Command Example This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Root> config switch apiState enable config.switch.banner The banner command on the configuration branch enters the banner configuration branch.
PAGE 149
config 2 Parameters This command has two parameters: lineNumber Specifies the line number in the banner text. This can take a value from 0 to 24. lineContent The text for a particular line. If an empty line is to be displayed, an empty string in double quotes is to be configured. For a string that is separated by spaces, the entire string should be enclosed within quotes. This has an 80 character limitation and accepts alphanumeric characters. Command Example config.switch.
PAGE 150
config 2 Parameters This command has one parameter. state Command Example The enabled/disabled state for CLI banner. This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Root> config switch banner setWebState 0 config.switch.banner.show Syntax show Description This command displays the configured banner. Parameters This command has no parameters.
PAGE 151
config 2 Parameters This command has one parameter: offset The Domain ID offset. Values are in hexadecimal. Valid values are: 00 32 64 96 128 160 192 Command Example Root> config switch domainIDOffset 160 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.
PAGE 152
config 2 config.switch.edTOV Syntax Purpose edTOV timeoutValue Sets the error detect timeout value (E_D_TOV) for the switch. NOTE: The switch must be set offline before this command is entered. Special care should be used when scripting this command due to its relationship with R_A_TOV. Parameters This command has one parameter: timeoutValue 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.
PAGE 153
config 2 Parameters This command has one parameter: insistentDomainIdState Command Example Specifies whether the insistent domain ID state is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values. Root> config switch insistDomainId 1 NOTE: The Insistent Domain ID must be enabled if the Enterprise Fabric Mode (an optional SANtegrity feature) or Preferred Path is enabled. config.switch.
PAGE 154
config 2 shortest path (or the path which would take the least amount of time for traffic to travel) to a destination. Parameters This command has two parameters: ignore Every ISL has the same FSPF cost. In essence, the actual FSPF cost is ignored. port Each ISL has a McDATA default cost, which depends on the speed of the port. TIP: It is recommended that all the switches in the fabric to be configured have the same value for the ISL FSPF Cost Configuration parameter.
PAGE 155
config 2 Parameters 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. NOTE: The switch must be set offline before this command is entered. Parameters This command has one parameter: Priority Specifies the switch priority.
PAGE 156
config 2 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. The units for this value are tenths of a second.
PAGE 157
config 2 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. Note that during this delay period, frames addressed to the destinations that are being rerouted are discarded if they are Class 3 frames and rejected if they are Class 2 or Class F frames.
PAGE 158
config 2 Parameters 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.speed Syntax Purpose speed switchSpeed This command sets the speed for the switch. NOTE: This command is only applicable for the Intrepid 6064. NOTE: The switch must be set offline before this command is entered.
PAGE 159
config 2 Parameters Command Example Output This command has no parameters. Root> config switch show The switch configuration data is displayed as a table that includes the following properties: R_A_TOV Resource Allocation Time Out Value. This time outs the operations that depend on the maximum possible time that a frame can be delayed in a fabric and still be delivered. E_D_TOV Error Detect Time Out Value. This indicates the maximum turnaround time that an operation could require.
PAGE 160
config 2 Output Example RSCN Zone Isolation When set to fabric, RSCNs will only be sent to affected fabric members when zoning information changes. When set to none, filtering of RSCNs will not take place, and RSCNs will be sent to all zoneset members when zoning information changes. Safe Zoning Safe Zoning State. ISL FSPF Cost The method for computing the FSPF cost for ISLs. Web Enable The enabled state of web. API Enable API enable state. HA Mode The enabled state of high availability mode.
PAGE 161
config 2 Parameters 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.zoneFlexPars Syntax Purpose Parameters zoneFlexPars zoneFlexParstate This command configures the state of Zone FlexPars. This command has one parameter: zoneFlexParsState Command Example This parameter can be set to fabric and none.
PAGE 162
config 2 log. The syslog feature will send the user requested logs (supported logs) to the syslog service on a remote host. You may configure up to three remote syslog recipients. A single facility may be configured for each remote syslog recipient and the default is Local 0. All syslog facilities are limited to the local use facility (Local 0 - Local 7). config.syslog.
PAGE 163
config 2 Purpose Parameters Command Example 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. state This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted. If the state is enabled, messages for that log will be sent to the configured syslog servers. Root> config syslog setLogConfig event enable config.syslog.
PAGE 164
config 2 Output Command Example 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. IP Address The IP address of the server. Facility The facility level for the server. Values are Local 0 Local 7. Root>Config SysLog show Syslog State: Disabled Index IP Address Facility ----- --------------- -------1 172.16.22.23 Local 0 2 3 180.77.
PAGE 165
config 2 Parameters This command has one parameter: systemContact Command Example Specifies the new system contact string for the director or switch. The contact can contain 0–255 characters. Root> config system contact Joe config.system.date Syntax date systemDate systemTime Purpose This command sets the system date and time. Parameters This command has two required parameters: systemDate Specifies the new system date. The format of the date parameter must be mm:dd:yyyy or mm/dd/yyyy.
PAGE 166
config 2 Parameters This command has one parameter: systemDescription Command Example Specifies the new system description string for the director or switch. The name can contain 0–255 characters. Root> config system description McDATAIntrepid6140FibreChannelDirector config.system.location Syntax Purpose Parameters location systemLocation This command sets the system location attribute.
PAGE 167
config 2 Parameters Command Example Output Output Examples This command has no parameters. Root> config system show The system configuration is displayed as a table that includes the following properties: Name The system name. Description The system description. Contact The system contact. Location The system location. Date/Time The system date and time. The output from the config.system.
PAGE 168
config 2 NOTE: A Sphereon 4300 Switch cannot participate in a fabric unless the Fabric Capable feature is enabled. For more information, see the McDATA Sphereon 4300 Switch Installation and Service Manual (620-000171). Table 2-1 shows the limits for configuring zoning in McDATA fabrics that are supported by switch and director firmware as of 11/14/03. Although EFCM 8.0 or EFCM 8.0b may allow you to configure greater values in the Zoning Library, values in this table have been tested and are supported.
PAGE 169
config 2 NOTE: If the interoperability mode for the switch or director is set to Open Fabric 1.0 mode when the zone is activated, any zone members specified by the port number are ignored. config.zoning.addPortMem Syntax Purpose addPortMem “zoneName” domainId portNumber This command adds the domain ID and port number of a zone member to the specified zone in the work area. NOTE: Port numbers cannot be used for zone members if the interoperability mode for the switch or director is set to Open Fabric 1.
PAGE 170
config 2 Command Example Root> config zoning addPortMem TheUltimateZone 10 6 config.zoning.addWwnMem Syntax Purpose addWwnMem zoneName wwn This command adds a WWN zone member to the specified zone in the work area. NOTE: A product can have at most 4096 zone members in its zones. NOTE: The ED-5000 supports a maximum of 512 zones. Parameters Command Example This command has two parameters: zoneName Specifies the name of the zone. wwn The WWN of the member to be added to the zone.
PAGE 171
config 2 Parameters This command has one parameter: zoneName Specifies the name of the new zone. The zoneName must contain 1–64 characters. Valid characters are: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijkl mnopqrstuvwxyz0123456789$-^_ Spaces are not permitted, and the first character must be alphabetical. Command Example Root> config zoning addZone TheUltimateZone config.zoning.
PAGE 172
config 2 config.zoning.deactivateZoneSet Syntax Purpose deactivateZoneSet This command places all attached devices in the default zone and takes effect immediately for the entire fabric. This command clears both the active zone set and the working area. This command takes effect immediately in the fabric. NOTE: The default zone must be activated independently of this command. Parameters Command Example This command has no parameters. Root> config zoning deactiveZoneSet config.zoning.
PAGE 173
config 2 portNumber Specifies the port number of the member to be deleted from the zone. Valid port numbers 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–31 for the ED-5000 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 Command Example Root> config zoning deletePortMem TheUltimateZone 10 5 config.zoning.
PAGE 174
config 2 config.zoning.deleteZone Syntax Purpose deleteZone zoneName This command deletes a zone from the zone set in the work area. NOTE: Changes are not activated on the switch until the config.zoning.activateZoneSet command is issued. Parameters This command has one parameter: zoneName Command Example Specifies the name of the zone to be deleted. Root> config zoning deleteZone TheLeastUltimateZone config.zoning.
PAGE 175
config 2 Purpose This command changes the name of the zone set in the work area. NOTE: Changes are not activated on the switch until the config.zoning.activateZoneSet command is issued. Parameters This command has one parameter: zoneSetName Specifies the new name for the zone set. The zoneSetName must contain 1–64 characters. Valid characters are: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijkl mnopqrstuvwxyz0123456789$-^_ Spaces are not permitted, and the first character must be alphabetical.
PAGE 176
config 2 Parameters This command has one parameter: defaultZoneState Command Examples Specifies whether the default zone is enabled. Valid values are true and false. Boolean 1 and 0 may be substituted as values. Root> config zoning setDefZoneState false Root> config zoning setDefZoneState 0 config.zoning.showActive Syntax Purpose Parameters Command Example Output showActive This command shows the zoning configuration saved on the fabric. This command has no parameters.
PAGE 177
config 2 config.zoning.showPending Syntax Purpose Parameters Command Example Output showPending This command shows the zoning configuration in the work area of the zone set that has not yet been activated. This command has no parameters. Root> config zoning showPending The zoning configuration data is displayed as a table that includes the following properties: Local ZoneSet Output Example The enabled status, name, and member zones of the zone set. The output from the config.zoning.
PAGE 178
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.
PAGE 179
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.
PAGE 180
maint 2 Command Examples Root> maint system beacon false Root> maint system beacon 0 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.
PAGE 181
maint 2 The default values are set in the firmware of the director or switch. For information about the default values, refer to the service manual of your director or switch. Parameters Command Example This command has no parameters. 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.
PAGE 182
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.
PAGE 183
perf 2 Command Example Root> perf AFD HDDReport evtlog perf.AFD.POMReport Syntax POMReport logSetting Description This command configures the Predictive Optics Monitoring (POM) event reporting configuration. Parameters This command has one parameter: logSetting Command Example This parameter has the following values: • nolog - disables logging. • evtlogemail - logs all POM events to the event log and enables email notification for these events, if email notification is enabled.
PAGE 184
perf 2 HDD Report: POM Report: No logging No logging perf.class2 Syntax Purpose Parameters class2 portNumber This command displays port Class 2 counters for a single port. This command has one parameter: portNumber Specifies the port number.
PAGE 185
perf 2 Output Example TxWords The number of Class 2 4-byte words within frames that the port has transmitted. Busied Frms The number of times the FBSY (Fabric Busy link response) was returned to this port as a result of a Class 2 frame that could not be delivered to the other end of the link. This occurs if either the fabric or the destination port is temporarily busy.
PAGE 186
perf 2 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. RxWords The number of Class 3 4-byte words within frames that the port has received.
PAGE 187
perf 2 Parameters This command has one parameter: portNumber Specifies the port number. Valid 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 all for every port on the director or switch Command Example Root> perf clearStats 4 Root> perf clearStats all perf.
PAGE 188
perf 2 Command Example Output Output Example Root> perf errors 2 The port error counter data is displayed as a table that includes the following statistics: Port The port number. Prim Seq Err The number of state machine protocol errors detected by the port hardware. Disc Frms The number of received frames discarded due to a frame size of less than size words or to frames dropped because the BB_Credit was zero.
PAGE 189
perf 2 Purpose Parameters This command displays port link counters for a single port. This command has one parameter: portNumber Specifies the port number.
PAGE 190
perf 2 Output Example Sync Losses The number of times the port has detected a loss of synchronization timeout while not in an offline or LF2 state. Sig Losses The number of times the port has detected a loss of signal while not in an offline or LF2 state. Time at 0 Tx Credit The number of 100 millisecond intervals where the switch port has zero Tx BB_Credit. The output from the perf.
PAGE 191
perf 2 perf.openTrunking.congestionThresh Syntax Purpose Parameters congestionThresh portNumber congestionThreshold This command configures the congestion threshold for an individual port or for all ports. This command has the following parameters: portNumber Specifies the port number.
PAGE 192
perf 2 Effectively, the threshold is the percent of the time that the port does not receive BB_Credits before traffic is rerouted away from the port. This threshold is also used for prevention of improperly rerouting to an ISL that lacks BB_Credits. In other words, the system does not reroute a flow to a link that lacks BB_Credits even if that link is significantly under its loading threshold.
PAGE 193
perf 2 perf.openTrunking.show Syntax Purpose Parameters show portNumber This command displays the current OpenTrunking configuration per port. This command has one parameter: portNumber Specifies the port number.
PAGE 194
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.
PAGE 195
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.
PAGE 196
perf 2 perf.preferredPath.clearPath Syntax Purpose Parameters 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.
PAGE 197
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 This command has the following parameters: destDomainId Specifies the destination domain ID.
PAGE 198
perf 2 exitPort Specifies the number of the desired exit port. Valid port numbers 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 ED-5000 0–31 for the Sphereon 4700 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 Command Example Root> perf preferredPath setPath 17 5 11 perf.preferredPath.
PAGE 199
perf 2 perf.preferredPath.showPath Syntax Purpose Parameters showPath destDomainID sourcePort This command displays the requested preferred path configuration. The output shows the configured preferred exit port. Using all for either the destination domain ID or the specified source port parameter results in an output that shows all configured and actual exit ports for the other parameter. If the destination domain is set to all, then all paths from the specified source port are displayed.
PAGE 200
perf 2 Output Command and Output Examples The output from the perf.preferredPath.showPath command includes the following parameters: Destination Domain The destination domain ID for which a preferred path has been configured. This is displayed only if the destination domain parameter is set to all. Source Port This is the source port for which a preferred path to the specified destination domain ID is specified. This is displayed only if the source port parameter is set to all.
PAGE 201
perf 2 perf.preferredPath.showState Syntax Purpose Parameters Command Example showState This command shows the enabled state for preferred path This command has no parameters. Root> Perf PreferredPath showState perf.thresholdAlerts The perf.thresholdAlerts commands enable you to configure alerts that notify you of specific conditions on your system. You can configure a maximum of 16 threshold alerts, including both counter threshold alerts (CTAs) and throughput threshold alerts (TTAs).
PAGE 202
perf 2 1. Create a counter threshold alert using the command perf.thresholdAlerts.counter.addAlert on page 2-161. Use this command to create a name for the threshold alert that you can use in subsequent commands. The threshold alert must then be configured using the other counter threshold alert commands. 2. Assign the threshold alert to a port using the command perf.thresholdAlerts.counter.addPort on page 2-162. 3. Configure the threshold alert using other perf.thresholdalert commands.
PAGE 203
perf 2 4. Identify the percentage of throughput that triggers the throughput threshold alert using the command perf.thresholdAlerts.throughput.setUtilPercentage on page 2-174. 5. Configure the threshold alert using other perf.thresholdalert commands. For example, you may want to set the duration and interval times for the alert, as described in perf.thresholdAlerts.throughput.setParams on page 2-175. Use the following commands to view alert settings and configure an alert: • perf.thresholdAlerts.
PAGE 204
perf 2 Table 2-3 Description of Summed Sets Alert Counters (Continued) Number Threshold Alert Counter or Counter Set 5 Link Failures 6 Sync Losses 7 Signal Losses 8 Protocol Errors 9 Invalid Tx Words 10 CRC Errors 11 Discarded Frames 12 Frames Too Short 13 Delimiter Errors 14 Address ID Errors 15 Class2BusiedFrames 16 Class2RejectedFrames 17 Class3DiscardedFrames 18 Physical Link Errors Set 19 Link Sequence Counts Set 20 Logical Link Errors Set (see below) 21 LIPs Dete
PAGE 205
perf 2 • • • • • • • Link Sequence Counts Summed Set • • • • • Signal Losses Protocol Errors Invalid Tx Words CRC Errors Frames Too Short Delimiter Errors Link Resets Received Link Reset Sent OLS Received OLS Sent Logical Link Errors Summed Set • • • • • Discarded Frames Address ID Errors Class 2 Busied Frames Class 2 Rejected Frames Class 3 Discarded Frames perf.thresholdAlerts.counter.
PAGE 206
perf 2 Parameters This command has one parameter: name Specifies the name of the new counter threshold alert. This name can consist of any ASCII characters up to a maximum length of 64 characters. To use spaces or special characters in this name, put quotation marks around the name. This parameter is case-sensitive. TIP: Although the system supports a name length of 64 characters, you may want to use a much shorter name. Some commands that display the threshold name show a maximum of 51 characters.
PAGE 207
perf 2 portNumber Specifies the port number or port type. Valid port number values: 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 all applies the counter threshold alert to every port on the product.
PAGE 208
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 This command has the following parameters: name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert, described on 2-161. portNumber Specifies the port number.
PAGE 209
perf 2 Parameters Command Example This command has the following parameters: name The name of a counter threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert, described in 2-161. counterNumber Specifies the counter number. Valid values are shown in Table 2-3, Alert Counters, page 2-159. Root> perf thresholdAlerts counter setCounter checklinks 1 perf.thresholdAlerts.counter.
PAGE 210
perf 2 The increment value takes place in an interval that is a fixed length amount of time. This interval is not a rolling window interval. Command Example Root> perf thresholdAlerts counter setParams checklinks 5 30 perf.thresholdAlerts.counter.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.
PAGE 211
perf 2 Purpose Parameters Command Example Output Example This command displays the table of different statistic counters that can be added to a counter threshold alert. This table is used for reference only. This command has no parameters. Root> perf threshAlerts counter showStatisticTable The output from the perf.thresholdAlerts.counter.
PAGE 212
perf 2 perf.thresholdAlerts.deleteAlert Syntax Purpose deleteAlert name This command deletes a specified threshold alert. NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. Parameters This command has one parameter: name Command Example The name of a threshold alert as defined by the commands perf.thresholdAlerts.counter.addAlert and perf.thresholdAlerts.throughput.
PAGE 213
perf 2 Parameters Command Example Output This command has no parameters. Root> perf thresholdAlerts show The data is displayed as a table that includes the following properties: Name The name of the threshold alert (truncated to 51 characters). Type The trigger statistic or threshold type of the alert (abbreviated to 17 chars).
PAGE 214
perf 2 State Cls3 DiscardFrms CTA - Class 3 Discarded Frames Phys Lnk Err Set CTA - Physical Link Errors Summed Set Lnk Seq Cnt Set CTA - Link Sequence Counts Summed Set Logic Lnk Err Set CTA - Logical Link Errors Summed Set LIPs Detected CTA - Loop Initialization Primitive Detected LIPs Generated CTA - Loop Initialization Primitive Generated The enabled state of the CTA. Either enabled or disabled.
PAGE 215
perf 2 • Parameters Alert State: Disabled 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.
PAGE 216
perf 2 portNumber Specifies the port number or port type. Valid values are either a single port number, all ports, or port type. The following port numbers are valid: 0–11 for the 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 4700 0–31 for the Sphereon 3032 and 3232 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 all applies the throughput threshold alert to every port on the product.
PAGE 217
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 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-170. portNumber Specifies the port number.
PAGE 218
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-170. 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) Command Example Root> perf thresholdAlerts throughput setUtilType eportRx 1 perf.thresholdAlerts.throughput.
PAGE 219
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.
PAGE 220
perf 2 Parameters 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-170. You can also specify all instead of a name, to display all threshold alerts. NOTE: The output of this command truncates all the threshold alert names that are longer than 51 characters. In case you specify lengthy names, you can display the complete name by entering the comma-delimited mode using the commaDelim command.
PAGE 221
perf 2 1 2 3 Transmit Traffic (Tx) Receive Traffic (Rx) Both (Tx/Rx) perf.traffic Syntax Purpose Parameters traffic portNumber This command displays port traffic counters for a specified port. This command has one parameter: portNumber Specifies the port number.
PAGE 222
perf 2 Output Example TxFrames The number of Fibre Channel Class 2 and Class 3 frames that the port has transmitted. RxWords The number of 4-byte words in Class 2 and Class 3 frames that the port has received. TxWords The number of 4-byte words in Class 2 and Class 3 frames that the port has transmitted. The output from the perf.
PAGE 223
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.
PAGE 224
show 2 11:22:33:44:55:66:77:01 11:22:33:44:55:66:77:02 11:22:33:44:55:66:77:03 11:22:33:44:55:66:77:04 NAME1 NAME2 NAME3 NAME4 show.all Syntax Purpose Parameters Command Example Output 2-180 all This command displays all configuration and status information that are available. The command results in a sequential display of the output of other CLI show commands. This set of show commands returns the full configuration and status of the switch and fabric. This command has no parameters.
PAGE 225
show 2 • show.security.fabricbinding • show.openTrunking.config • show.thresholdAlerts.alerts • show.fabric.topology • show.fabric.nodes • show.security.switchACL • show.ficonCUPZoning • show.fencing.Policies • show.activeAlias show.auditLog Syntax Purpose Parameters auditLog [clear] This command displays the entries of the audit log after the last time the log was cleared.
PAGE 226
show 2 ---------11/24/03 04:18P 11/24/03 03:38P 11/24/03 03:38P 11/24/03 11:27A ----------------Switch set online CLI Switch name modifiedCLI Switch set offline CLI Firmware downloaded Web ------------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.
PAGE 227
show 2 End Offset: End Bit Pattern: Trigger State: Num of Entries: Start Condition Met: End Condition Met: 0 FBXXXXX3321 Active 6 True False show.epFrameLog.disableTrigger Syntax Purpose Parameters Command Example disableTrigger This command clears the embedded port frame log trigger, which was configured with the command show.epFrameLog.setTrigger. This command has no parameters. Root> show epFrameLog disableTrigger show.epFrameLog.
PAGE 228
show 2 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. NOTE: This log will not wrap. The log will stop collecting entries after is it filled. Parameters This command has one optional parameter. If no parameter is specified, then the 500 entries of the log will be displayed.
PAGE 229
show 2 Header: 22000025 000000EF E1000000 00000000 FFFF0000 00000000 PL: 00010203 04050607 08090A0B 0C0D0E0F 10111213 14151617 18191A1B 1C1D1E1F show.epFrameLog.removeFilterPort Synopsis removeFilterPort portNumber Description This command removes a port from FC2 frame logging filter. Parameters This command has one parameter which can be either “all” or a port number.
PAGE 230
show 2 Parameters This command has one parameter. Port Num The port number to specify “all” for disabling FC2 frame log for all the ports or the port number for which frame log entries will be recorded. Valid Port Numbers range from: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 0–63 for the Intrepid 6064 0–127 and 132–143 for the Intrepid 6140 [all] The “all” parameter will make the FC2 log collect entries from all of the ports on the switch.
PAGE 231
show 2 Parameters This command has five parameters: portNumber The port to monitor this trigger on. Valid 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 Command Example offStart The offset for the start bit pattern. bitStart The bit pattern that will trigger the logging.
PAGE 232
show 2 discarded by hardware, such as un-routable class-3 frames unless class-3 discard is disabled in the hardware. NOTE: This log will begin to wrap after the log is filled. Parameters This command has one optional parameter. If no parameter is specified, then the 1000 entries of the log will be displayed. Adding the optional clear parameter removes all entries from both the wrapping and the non-wrapping regions of the log.
PAGE 233
show 2 show.eventLog Syntax Purpose Parameters eventLog [clear] This command displays the contents of the event log as maintained in NV-RAM on the director or switch. This command has one parameter: This optional parameter causes all event log entries to be cleared. clear Command Example Output Root> show eventLog The event log data are displayed as a table that includes the following properties. Date/Time The date and time when the event occurred. Code The event reason code.
PAGE 234
show 2 show.fabricLog.noWrap Syntax Purpose noWrap [clear] This command displays the contents of the non-wrapping region of the fabric log. The log entries will not persist over IMLs or power cycles; it will not be stored in NV RAM. NOTE: This log will not wrap. The log will stop collecting entries after is it filled. Parameters This command has one optional parameter. If no parameter is specified, then the 200 entries of the log will be displayed.
PAGE 235
show 2 Data: 9 Data: 8 12/04/03 08:15A Paths Operational 12/04/03 08:15A Zone Merge Completed show.fabricLog.wrap Syntax Purpose wrap [clear] This command displays the contents of the wrapping region of the fabric log. The log entries will not persist over IMLs or power cycles; it will not be stored in NV RAM. NOTE: This log will begin to wrap after the log is filled. Parameters This command has one optional parameter.
PAGE 236
show 2 126, 127, 132, 133, 134, 135, 144 10 12/04/03 08:15A Data: 9 12/04/03 08:15A Data: 8 12/04/03 08:15A Data: 136, 137, 138, 139, 140, 141, 142, 143, Fabric Operational Paths Operational Zone Merge Completed show.fabric.nodes Syntax Purpose Parameters Command Example Output Output Example Domain ID --------3 nodes This command displays a list of all fabric-attached nodes. This command has no parameters.
PAGE 237
show 2 Parameters Command Example This command has three parameters. The last 2 parameters are optional. destination The destination to be pinged. This parameter can be an FC ID or the WWN of the destination in the fabric. count The number of times the destination is to be pinged. Default is 4. Maximum count possible is 10. timeout The time the command waits before timing out. Default is 5s. Maximum possible timeout is 10s.
PAGE 238
show 2 Output Example Principal Switch WWN: 00:00:00:00:00:00:00:00 show.fabric.showRouteTable Syntax showRouteTable [source] [destination] Description This command displays routes for specified online ingress port to specified domains in the fabric. Parameters This command has two parameters, which are optional. source The source port/Ingress port for which the route table is displayed. destination The destination Domain ID for which the route is displayed.
PAGE 239
show 2 * The actual cost and effective cost can be different based on whether ISL cost configuration is configured or not. If ISL cost configuration is configured, then links with different speeds will have different costs (1G = 1000, 2G = 1000, 4G = 250, 10G = 100). Actual cost lists the actual cost that based on the cost configuration and effective cost is the cost assuming that the ISL cost configuration is not configured. Output Example Show.
PAGE 240
show 2 Output Output Example 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. OutPrt The port number at the local end of the ISL. Remote WWN The WWN of the switch at the remote end of the ISL. RemDID The domain ID of the switch at the remote end of the ISL. RemPrt The port number at the remote end of the ISL. The output from the show.
PAGE 241
show 2 Output Return code The return value. Possible values are: • Command Completed Successfully • Command Not Supported in Next Switch • No Response from Next Switch • Maximum Hop Count Reached • Source Port not in Fabric • Destination Port not in Fabric • Devices not in Common Zone • No Route Between Designated Ports • No Additional Explanation • Fabric Busy • Fabric Build in Progress • Unable to run a trace route at this time Number of Entries The number of entries returned from the trace route.
PAGE 242
show 2 2-198 Domain ID: Ingress Port WWN: Ingress Port Num: Egress Port WWN: Egress Port Num: Direction: 26 20:15:08:00:88:60:F0:A2 17 20:0D:08:00:88:60:F0:A2 9 Source to destination Entry 1 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:17:08:00:88:22:33:44 19 20:1B:08:00:88:22:33:44 23 Source to destination Entry 2 Switch WWN: Domain ID: Ingress Port WWN: Ingress Port Num: Egress Port WWN: Egress Port Num: Directi
PAGE 243
show 2 show.features Syntax Purpose Parameters Command Example Output Output Example features This command displays a table of all installed feature sets and their states. This command provides the same output as the command config.features.show on page 2-12. This command has no parameters. Root> show features The features data is displayed as a table that includes the following properties: Installed Feature Set The feature set installed using a feature key. Only installed keys are displayed.
PAGE 244
show 2 NOTE: The “*” in the output example indicates that the feature is a trial version. When the trial period expires, the State property will show the feature as Disabled and Exp property will show no value for the number of days. NOTE: If a feature is present in two bundles, it will be shown in only one bundle under Installed Feature Set property. show.fencing.policies Syntax Purpose This command displays a table of the configured fencing policies.
PAGE 245
show 2 Output Example Root> show fencing Name -----------------------Default_Protocol_Errors Protocol Errors #2 Safety #2 Type --------------Protocol Errors Protocol Errors Protocol Errors State -------Enabled Disabled Enabled Root> show fencing Protocol Errors #2 Name: Protocol Errors #2 Ports: 2,4-7,20-24 Type: Protocol Errors Limit: 5 Period: 1800 seconds State: Disabled show.
PAGE 246
show 2 show.ficonMS Syntax Purpose ficonMs This command displays the FICON MS settings. NOTE: This command is displayed on a Sphereon 3016 only if the feature key is installed. Parameters Command Example Output Output Example This command has no parameters. Root> show ficonms The data is displayed as a table that includes the following properties: Ficon MS State The state of the FICON MS feature. Ficon MIHPTO The Ficon MIHPTO value in seconds.
PAGE 247
show 2 State The state of the FRU. Values are: Active—the current module is active. Backup—this module is not currently being used, but it is available for immediate failover. Degraded—the back end path is failed. (QPM and XPM only). Powered Off—the module is installed, but powered off. (Intrepid 6064 and QPM only). NotInst—the module is not currently installed. Failed—the current module is failed. Serial Num The serial number of the FRU.
PAGE 248
show 2 Purpose Parameters Command Example Output Output Example 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. Gateway Address The gateway address for the Ethernet adapter as set in the config.ip.ethernet command.
PAGE 249
show 2 Output The event log data are displayed as a table that includes the following properties: Date/Time The date and time when the event occurred. Port The number of the port where the link incident occurred. Link Incident Event An ASCII string describing the link incident event. 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 The output from the show.
PAGE 250
show 2 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 ------- COS The class of service (for example, 1; 2; 3; 4; 5; 6; F; 1,2; 2,3). Port Name The port WWN of the attached device. Node Name The node WWN of the attached device. The output from the show.
PAGE 251
show 2 Output The device information data is displayed as a table that includes the following properties: DID The DID of the switch whose nameserver entries are being displayed. 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. COS The class of service (for example, 1; 2; 3; 4; 5; 6; F; 1,2; 2,3). FC4 Types The FC4 types registered for this device.
PAGE 252
show 2 Show> nameServer DID --28 Type ---F PortId -----7C3913 Port Name ----------------------10:00:00:00:C9:20:DA:D1 Node Name ----------------------20:00:00:00:C9:20:DA:D1 COS --- FC4 --- FC4 types decode information can be viewed via the show nameserverFC4Types CLI command Show> nameServer 15 (15 is not in the fabric) No entries in the database for Domain 15. show.
PAGE 253
show 2 Output Example FC4 The FC4 types registered for this device. One or more numbers display in this field. The numbers in this field correspond to the list in the output example for show.nameServer on page 2-206. SymNodeName 255-character representation of the Symbolic Node Name. SymPortName 255-character representation of the Symbolic Port Name. The output from the show.
PAGE 254
show 2 11. 12. 13. 14. 15. 16. 17. 18. SBCCS-Cntrl Unit FC Srvcs FC-FG FC-XS FC-AL SNMP HIPPI-FP Vendor Unique show.NPIV.config Syntax Purpose config This command displays the current NPIV configuration for all ports. NOTE: The command config.NPIV.show on page 2-27 has functionality that is identical to this command. Parameters Command Example Output Output Example This command has no parameters.
PAGE 255
show 2 Purpose Parameters Command Example Output Output Example This command displays the Open System Management Server (OSMS) state and the Open System Management Server Host Control State. This command has no parameters. Root> show openSysMS config 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.
PAGE 256
show 2 Command Example Output Root> show openSysMS platformInfo GPNL The configuration data is displayed as a table that includes the following properties: Platform Name The list of Platform Name List for GPNL query. Node Name The list of Platform Node Name List for GPLNL queries. Platform The Platform Management Address (URL) List for Management Address GPLML queries. Platform Type Output Example The Platform Type for GPLT queries. show.
PAGE 257
show 2 Output Output Example The device information is displayed as a table that includes the following: Unresolved Congestion The current enabled/disabled state of the unresolved congestion trunking feature. Backpressure The current enabled/disabled state of the backpressure trunking feature. Low BB_Credit Threshold The current threshold setting of the low BB_Credit threshold trunking feature listed as a percentage.
PAGE 258
show 2 Parameters This command has one optional parameter: clear Command Example This optional parameter causes all re-route log entries to be cleared. show opentrunking reroutelog NOTE: The clear parameter also clears the log entries for your SAN management application. 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.
PAGE 259
show 2 Output The port configuration attributes are displayed as a table that includes the following properties: Port The port number. Name The name of the port as set in the config.port.name command. Blocked The blocked state of the port as set in the config.port.blocked command. 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.
PAGE 260
show 2 show.port.exit Syntax Purpose exit destDomainID sourcePort This command displays the exit port from a source port to a given destination domain. This command shows the preferred path configuration. Use all for one of the command’s parameters to display all configured and actual exit ports for either the destination domain ID or the specified source port. You cannot specify all for both parameters. If the destination domain is set to all, then all paths from the specified source port are displayed.
PAGE 261
show 2 Output Command and Output Examples The output from show.port.exit includes the following parameters: Destination Domain The destination domain ID to which a preferred path has been configured. This is displayed only if the destination domain parameter is set to all. Source Port The source port for which a preferred path to the specified destination domain ID is specified. This is displayed only if the source port parameter is set to all.
PAGE 262
show 2 show.port.info Syntax Purpose Parameters Command Example Output info This command displays port information for all ports. This command has no parameters. Root> show port info The port information data is displayed as a table that includes the following properties: Port The port number. WWN The WWN of the port. OpSpeed The current operating speed.
PAGE 263
show 2 SpeedCap The current transceiver capability speed. Valid values are: 1 – 1g 2 – 2g 4 – 4g capable (Sphereon 4400 and Sphereon 4700 only) Neg – Negotiable speed Neg_2 – Negotiable speed up to 2g maximum 4_B – 4g Burst 4_S – 4g Sustained Neg_S – Negotiable speed in sustained mode Neg_B_4 – Negotiable speed in burst mode up to 4g maximum Output Example Port ---0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 The output from the show.port.
PAGE 264
show 2 Parameters This command has one parameter: 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 4700 Command Example Output 2-220 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.
PAGE 265
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.
PAGE 266
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.
PAGE 267
show 2 Command Example Output Output Example Port ---0 1 2 3 4 Xvr --UNK UNK UNK UNK XFP 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.8 voltage in volts. 5.0 Voltage The 5.
PAGE 268
show 2 Output 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.
PAGE 269
show 2 Output Output Example The port optic data is displayed as a table that includes the following properties: Port Number The port number. Transceiver 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. Extended Identifier The extended identifier. Date and Lot The data and lot. The show.port.
PAGE 270
show 2 12,SFP,E2O COMMS 15,4,07/09/03 13,SFP,E2O COMMS 15,4,07/03/03 14,SFP,E2O COMMS 15,4,07/03/03 15,SFP,E2O COMMS 15,4,07/03/03 16,SFP,E2O COMMS 15,4,07/04/03 17,SFP,E2O COMMS 15,4,07/07/04 18,SFP,E2O COMMS 15,4,01/16/03 19,SFP,E2O COMMS 15,4,07/08/04 20,SFP,E2O COMMS 15,4,07/03/03 21,SFP,E2O COMMS 15,4,07/03/03 22,SFP,E2O COMMS 15,4,07/03/03 23,SFP,E2O COMMS 15,4,07/03/03 INC Lot# INC Lot# INC Lot# INC Lot# INC Lot# INC Lot# INC Lot# INC Lot# INC Lot# INC Lot# INC Lot# INC Lot# ,3770978 , ,36U1338 ,
PAGE 271
show 2 Command Example Output Root> show port profile portNumber 138 The port profile information is displayed as a single output for an individual port. Port Number Port number. Name Configured port name. Blocked Blocked state. Valid values are true and false. Blocked Reason Blocked reason. Valid values are "Blocked temporarily, Internal","Blocked by user","Blocked by hardware type change","Blocked by port fencing". Operating Type Operating port type. Operating Speed Operating port speed.
PAGE 272
show 2 Configured Speed Configured port speed. 1G - 1 Gb/sec 2G - 2 Gb/sec 4G - 4 Gb/sec (Sphereon 4400 and Sphereon 4700 only) 10G - 10 Gb/sec (XPM only) Neg - Negotiate 4G Sust - 4 Gb/sec Sustained (QPM only) 4G Burst - 4 Gb/sec Burst (QPM only) Neg Sust - Negotiate Sustained (QPM only) Neg 2G Max - Negotiate 2 Gb/sec Maximum (QPM only) Neg B 4G Max - Negotiate Burst 4 Gb/sec Maximum (QPM only) 2-228 Beaconing Beaconing state. FAN FAN state. FC Address The Port Fibre Channel address.
PAGE 273
show 2 Output Example The output from the show.port.
PAGE 274
show 2 Output Example Original Addr The original port address of the port. Current Addr The current port address of the port. Swapped Port Num If the port is swapped with another port, it will show the port number of the port it is swapped with. Port ---0 1 2 3 4 5 6 7 8 ... Original Addr ------------4 5 6 7 8 9 a b c Current Addr -----------4 5 7 6 8 9 a b c SwappedPort Num ---------------- 3 2 show.port.
PAGE 275
show 2 Type The operational port type. If the configured port type is F_Port or E_Port, this value will match the configured type. If the configured type is G_Port, this value can be E_Port, F_Port, or G_Port, depending on what is connected to the port. On the Sphereon 4300 and Sphereon 4500, if the configured port type is Fx_Port, the operational port type can include FL_Port in addition to the values noted above for F_Port.
PAGE 276
show 2 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.
PAGE 277
show 2 Output Example The output from the show.port.
PAGE 278
show 2 Media Output Example The media type (M-M 62.5um, M-M 50um, M-M 50,62.5um, S-M 9um, Copper). The output from the show.port.
PAGE 279
show 2 Parameters 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.
PAGE 280
show 2 Command and Output Examples The following examples show the output returned by the three methods of specifying the show.preferredPath.showPath command.
PAGE 281
show 2 show.security.fabricBinding Syntax Purpose Parameters Command Example Output Output Example fabricBinding This command displays the fabric binding configuration saved on the fabric. The command performs the same function as the command See config.security.fabricBinding.showActive on page 2-66.. This command has no parameters.
PAGE 282
show 2 Command Example Output Output Example Reason -----10000 Desc: Data: 10305 Desc: Data: 10300 Desc: Data: 10411 Desc: Data: Root> show security log The security log data are displayed as a table that includes the following properties: Reason The reason code for the security event. 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.
PAGE 283
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.
PAGE 284
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.
PAGE 285
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.
PAGE 286
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-97 has the functionality that is the same as this command. show.snmp.
PAGE 287
show 2 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. Security Name The security name (username). Security Model The security model. Security Level The security level. Config.SNMP> showTargetTable 1 Index: Target IP: UDP Port: Community Name: MP Model: Security Name: Security Model: Security Level: 1 172.19.
PAGE 288
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.
PAGE 289
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.
PAGE 290
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.
PAGE 291
show 2 Authentication Traps Displays the state of authentication traps to be sent to SNMP management stations when unauthorized stations try to access SNMP information from the switch or director. Output Example Index Index in the community table. Community. Name Displays the community name. WriteAuth The write authorization state of the community. Trap Recipient Protocol description of the trap recipient.
PAGE 292
show 2 2-248 State The state of the switch (for example, online or offline). R_A_TOV The resource allocation timeout value (R_A_TOV) as set in the config.switch.raTOV command. E_D_TOV The error detect timeout value (E_D_TOV) as set in the config.switch.edTOV command. Preferred Domain Id The domain ID as set in the config.switch.prefDomainId command. Switch Priority The switch priority as set in the config.switch.priority command. For more information, see config.switch.priority on page 2-111.
PAGE 293
show 2 Output Example FC Address Domain Id The domain ID of the switch derived from the Fibre Channel Address. Limited Fabric RSCN When enabled, fabric RSCNs are suppressed after an IPL. Isolate Zone RSCN When set to fabric filtering, fabric RSCNs will only be sent to those members that need notification. When set to No Filtering, RSCNs will be set to everyone when zoning information changes. Safe Zoning Safe zoning state. ISL FSPF Cost The method for computing the FSPF cost for ISLs.
PAGE 294
show 2 Web Enabled: API Enabled: HA Mode: API Management IP: Domain ID offset: Password Exp. Time: Enabled Enabled Disalbed 100.0.0.1 96 365 show.system Syntax Purpose Parameters Command Example Output 2-250 system This command displays a set of system attributes. This command has no parameters. Root> show system The system attributes are displayed as a table that includes the following properties. Name The system name. For more information, see config.system.name on page 2-122.
PAGE 295
show 2 Output Example Firmware Version The current firmware version installed. Beaconing The enabled state of unit beaconing (enabled or disabled) as set in the maint.system.beacon command. Date/Time The system date and time as set in the config.system.date command. For more information, see config.system.date on page 2-121. The output from the show.
PAGE 296
show 2 Command Example Root> Config Syslog show Syslog State: Disabled Index IP Address Facility ----- --------------- -------1 172.16.22.23 Local 0 2 3 180.77.66.55 Local 5 Log -------------------------Event Log Open Trunking Re-Route Log Link Incident Log Security Log Audit Log Fabric Log Embedded Port Frame Log State -------Enabled Disabled Disabled Enabled Enabled Enabled Disabled show.thresholdAlerts.
PAGE 297
show 2 State 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. Delimiter Errors CTA - Delimiter Errors. Address ID Errors CTA - Address ID Errors.
PAGE 298
show 2 Output Example The output from the show.thresholdAlerts.alerts command appears as follows: Name -----------------------------------Throughput Threshold #1 Threshold for CRC Safety #2 Safety #1 Type ----------------Rx Util CRC Errors Logic Lnk Err Set Cls2 BusiedFrms State -------Enable Disabled Enabled Disabled show.thresholdAlerts.log Syntax Purpose log [clear] This command shows the contents of the threshold alert log.
PAGE 299
show 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.
PAGE 300
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.
PAGE 301
show 2 Active Zone Set Default Zone Enabled: False ZoneSet: TheUltimateZoneSet Zone: TheUltimateZone ZoneMember: Domain 10, Port 6 ZoneMember: Domain 15, Port 2 ZoneMember: Domain 2, Port 63 ZoneMember: 10:00:00:00:C9:22:9B:64 ZoneMember: 10:00:00:00:C9:22:9B:BD Zone: TheNotSoUltimateZone ZoneMember: 10:00:00:00:C9:22:9B:AB ZoneMember: 10:00:00:00:C9:22:9B:C6 ZoneMember: 10:00:00:00:C9:22:9B:AB Zone: TheNotUltimateAtAllZone ZoneMember: Domain 2, Port 63 CLI Commands 2-257
PAGE 302
show 2 2-258 E/OS Command Line Interface User Manual
PAGE 303
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.
PAGE 304
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.
PAGE 305
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.
PAGE 306
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.
PAGE 307
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.
PAGE 308
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.
PAGE 309
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.
PAGE 310
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.
PAGE 311
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.
PAGE 312
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.
PAGE 313
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.
PAGE 314
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.
PAGE 315
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.
PAGE 316
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.
PAGE 317
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.
PAGE 318
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.
PAGE 319
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-114 and config.port.show on page 2-34.
PAGE 320
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.
PAGE 321
A 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-76 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.
PAGE 322
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.
PAGE 323
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.
PAGE 324
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.
PAGE 325
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.
PAGE 326
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.
PAGE 327
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.
PAGE 328
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.
PAGE 329
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.
PAGE 330
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.
PAGE 331
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.
PAGE 332
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.
PAGE 333
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.
PAGE 334
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.
PAGE 335
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.
PAGE 336
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.
PAGE 337
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.
PAGE 338
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.
PAGE 339
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.
PAGE 340
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-162 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.
PAGE 341
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.
PAGE 342
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.
PAGE 343
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.
PAGE 344
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.
PAGE 345
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.
PAGE 346
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.
PAGE 347
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.
PAGE 348
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.
PAGE 349
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.
PAGE 350
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.
PAGE 351
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.
PAGE 352
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.
PAGE 353
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.
PAGE 354
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.
PAGE 355
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.
PAGE 356
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.
PAGE 357
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Error 378: Duplicate IP address setting The IP address already exists. Choose a different IP Address or remove the existing entry. Error 379: Changing of QPM port mode can only start with an even numbered port Only even numbered ports can be configured.
PAGE 358
A The password expiration time should be in the range 0-3650. Message Description Action Message Description Action Message Description Action Error 384: Count specified to ping a destination is invalid The ping count specified is invalid. The count can have a value from 1 to 10 Error 385: Timeout value specified for ping is invalid The ping response timeout specified is invalid.
PAGE 359
A Use the saveSnapshot command and then re-issue this command Message Description Error 390: Invalid Login Banner Line Index The line number specified for the banner text is invalid Action The line number can have a value between 0-24. Message Error 391: Invalid destination domain specified Description The destination domain ID specified is invalid Action The domain Id can have a value between 1-31.
PAGE 360
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description A-58 Specify a valid port address when issuing the command. Error 396: logical error An internal logical error has occurred. None. Error 397: Unable to respond to the request The destination was not able to respond to the ping request. None.
PAGE 361
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description None. Error 402: Proxy transaction aborted The operation was aborted None. Error 402: Proxy received, but invalid response A response was received, but an invalid response None. Error 402: Proxy transaction aborted The operation was aborted None.
PAGE 362
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description A-60 Make the destination switch online and then re-issue the ping request. Error 407: No path to the destination from the source There is no path from the specified source to the destination None Error 408: Invalid CIDR log event specified The log setting specified is invalid Specify a valid log setting.
PAGE 363
A Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Assign a valid alias for the WWN. Error 414: No aliases associations available The association list is empty. None. Error 415: The active associations could not be loaded The active association list could not be copied to the pending association list None.
PAGE 364
A Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action Message Description Action A-62 Error 419: The Associations have been modified externally The associations have been modified in a different switch in the fabric and have been synchronized fabric wide and hence the checksum has changed. Update the pending list and re-issue the commands Error 420: Unable to handle request at this time An internal error occurred.
PAGE 365
A Message Error 425: Invalid login banner length. Description The login banner line length is too long. Action Message Description Action Enter a login banner line of 80 characters or less. Error 426: Invalid ping destination. An invalid FCID was entered. Specify a valid FCID. Message Error 427: Invalid snmp udp port number. Description The SNMP udp port number is not correct. Action Specify the valid SNMP udp port. Message Error 428: Invalid Login Banner text.
PAGE 366
A Message Description Action Message Description Action A-64 Error 431: Ping to well-known address is disallowed A well-known FCID is entered. Specify a valid FCID other than the well-known address. Error 432: Not allowed while fabric not operational The operation is not allowed while fabric is not operational. Try again after fabric becomes operational.
PAGE 367
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 9.1 config.alias 9.1 config.alias.activatePending 9.1 config.alias.add 9.1 config.alias.clearPending 9.1 config.
PAGE 368
B Table B-1 Commands and Releases (Continued) First E/OS Release B-2 Command 9.0 config.NSTools 9.0 config.NSTools.clearSnapshot 9.0 config.NSTools.saveSnapshot 9.0 config.NSTools.showSnapDiff 9.0 config.NSTools.showSnapshot 9.0 config.security.authentication.user.passExpTime 9.0 config.security.ssh.setRenegotiationMB 9.0 config.snmp.sendTestTrap 9.0 config.switch.banner 9.0 config.switch.banner.bannerText 9.0 config.switch.banner.setCLIState 9.0 config.switch.banner.
PAGE 369
B Table B-1 Commands and Releases (Continued) First E/OS Release Command 8.0 config.security.ssl.setRenegotiationMB 8.0 config.security.ssl.setWebState 8.0 config.security.ssl.show 8.0 config.snmp.addAccessEntry 8.0 config.snmp.deleteAccessEntry 8.0 config.snmp.addTargetParams 8.0 config.snmp.addUserEntry 8.0 config.snmp.addV1Target 8.0 config.snmp.addV2Target 8.0 config.snmp.addV3Group 8.0 config.snmp.addV3Target 8.0 config.snmp.deleteAccessEntry 8.0 config.snmp.
PAGE 370
B Table B-1 Commands and Releases (Continued) First E/OS Release B-4 Command 8.0 config.switch.apiState 8.0 config.switch.safeZoning 8.0 config.switch.islFSPFCost 8.0 config.syslog 8.0 config.syslog.addServer 8.0 config.syslog.deleteServer 8.0 config.syslog.setLogConfig 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.
PAGE 371
B Table B-1 Commands and Releases (Continued) First E/OS Release Command 7.0 config.fencing.removePort 7.0 config.fencing.setParams 7.0 config.fencing.setState 7.0 config.fencing.show 7.0 config.fencing.showTypeTable 7.0 config.ficonCUPZoning.addControlHost 7.0 config.ficonCUPZoning.deleteControlHost 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.
PAGE 372
B Table B-1 Commands and Releases (Continued) First E/OS Release B-6 Command 7.0 config.security.authentication.interface.eport.sequence 7.0 config.security.authentication.interface.nport.outgoing 7.0 config.security.authentication.interface.nport.sequence 7.0 config.security.authentication.interface.osms.outgoing 7.0 config.security.authentication.interface.osms.setKey 7.0 config.security.authentication.interface.serial.enhancedAuth 7.0 config.security.authentication.interface.show 7.
PAGE 373
B Table B-1 Commands and Releases (Continued) First E/OS Release Command 7.0 config.security.ssh.show 7.0 config.security.switchAcl.addRange 7.0 config.security.switchAcl.deleteRange 7.0 config.security.switchAcl.setState 7.0 config.security.switchAcl.show 7.0 config.switch.apiState 7.0 perf.preferredPath.showPath 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.
PAGE 374
B Table B-1 Commands and Releases (Continued) First E/OS Release B-8 Command 7.0 show.port.profile 7.0 show.port.showPortAddr 7.0 show.security.switchAcl 7.0 show.security.log 6.1 config.snmp.setFaMibVersion 6.1 config.snmp.setState 6.1 perf.preferredPath.clearPath 6.1 perf.preferredPath.setPath 6.1 perf.preferredPath.setState 6.1 perf.preferredPath.showPath 6.1 show.all 6.1 show.fabric.nodes 6.1 show.fabric.topology 6.1 show.linkIncidentLog 6.1 show.port.exit 6.1 show.
PAGE 375
B Table B-1 Commands and Releases (Continued) First E/OS Release Command 5.3 perf.openTrunking.congestionThresh 5.3 perf.openTrunking.lowBBCreditThresh 5.3 perf.openTrunking.setState 5.3 perf.openTrunking.show 5.3 perf.openTrunking.unresCongestion 5.3 perf.thresholdAlerts 5.3 show.openTrunking.config 5.3 show.openTrunking.rerouteLog 4.0 config.features.enterpriseFabMode 4.0 config.features.ficonMS 4.0 config.features.installKey 4.0 config.features.openSysMS 4.0 config.features.
PAGE 376
B Table B-1 Commands and Releases (Continued) First E/OS Release B-10 Command 4.0 config.snmp.deleteCommunity 4.0 config.snmp.show 4.0 config.switch 4.0 config.switch.domainRSCN 4.0 config.switch.edTOV 4.0 config.switch.insistDomainId 4.0 config.switch.interopMode 4.0 config.switch.prefDomainId 4.0 config.switch.priority 4.0 config.switch.raTOV 4.0 config.switch.rerouteDelay 4.0 config.switch.show 4.0 config.switch.speed 4.0 config.system.date 4.0 config.system.
PAGE 377
B Table B-1 Commands and Releases (Continued) First E/OS Release Command 4.0 config.zoning.deletePortMem 4.0 config.zoning.renameZone 4.0 config.zoning.renameZoneSet 4.0 config.zoning.renameZone 4.0 config.zoning.renameZoneSet 4.0 config.zoning.replaceZoneSet 4.0 config.zoning.setDefZoneState 4.0 config.zoning.showActive 4.0 config.zoning.showPending 4.0 maint.port.beacon 4.0 maint.port.reset 4.0 maint.system.beacon 4.0 maint.system.clearSysError 4.0 maint.system.ipl 4.
PAGE 378
B Table B-1 Commands and Releases (Continued) First E/OS Release B-12 Command 4.0 show.ip.ethernet 4.0 show.loginServer 4.0 show.nameServer 4.0 show.nameServerExt 4.0 show.port.config 4.0 show.port.info 4.0 show.port.nodes 4.0 show.port.status 4.0 show.port.technology 4.0 show.preferredPath.showState 4.0 show.security.portBinding 4.0 show.security.switchBinding 4.0 show.switch 4.0 show.system 4.0 show.
PAGE 379
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).
PAGE 380
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.
PAGE 381
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.
PAGE 382
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.
PAGE 383
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.
PAGE 384
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.
PAGE 385
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.
PAGE 386
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.
PAGE 387
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.
PAGE 388
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.
PAGE 389
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.
PAGE 390
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.
PAGE 391
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).
PAGE 392
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.
PAGE 393
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.
PAGE 394
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.
PAGE 395
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.
PAGE 396
Glossary g-18 E/OS Command Line Interface User Manual
PAGE 397
Index Symbols " 1-15 ? 1-20 Numerics 60 characters in history log 1-15 80-column output 1-16 A access control list 2-74 adding a range 2-74 delete a range 2-75 disable 2-75 enable 2-75 show 2-75 access rights relationship to other products 1-18 active zoning configuration 2-132 add access control list 2-74 alias to WWN 2-5 address port 2-36 AFD 2-138 HDD report 2-138 POM report 2-139 show 2-139 alerts, threshold 2-157 alias 2-3 activate pending 2-4 add 2-5 clear pending 2-5 delete 2-5 enabling CLI 2-6 r
PAGE 398
Index block port 2-31 C cable, replacing 1-23 character set 2-3 class 2 counters 2-140 class 3 counters 2-141 CLI 1-2 command tree 1-4 ED-5000 Director 1-22 errors, handling 1-19 globally available commands 1-4 help 1-20 logging in or out 1-16 lost 2-136 navigation conventions 1-3 output 1-16 parameters 1-15 purpose 1-2 root> prompt 1-14 using 1-2 commaDelim command 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-
PAGE 399
Index state 2-108 domain ID, port member adding 2-125 deleting 2-128 domain RSCN state 2-87, 2-90, 2-91, 2-92, 2-94, 2-107 E e_d_tov 2-88, 2-108 E_port, setting 2-40 ED-5000 Director 1-22 Embedded Frame Log show configuration 2-182 view 2-183, 2-187 enable access control list 2-75 OpenTrunking 2-148 SNMP agent 2-96 enabling 2-9 enterprise fabric mode 2-8, 2-9 feature set 2-10 NPIV 2-11 enbling FICON Management Server 2-10 Enterprise Fabric Mode activating 2-8, 2-9 deactivating 2-8, 2-9 enterprise fabric m
PAGE 400
Index list 2-199 NPIV 2-11 Open Systems Management Server 2-11, 2-30 OpenTrunking 2-12, 2-148 SANtegrity 2-8, 2-9 show 2-199 feature key NPIV 2-11 feature keys 2-10 resetting 2-136 features preferred path 2-151 fencing policies show 2-200 Fibre Alliance MIB SNMP 2-95 FICON enabling management server 2-10 FICON CUP show zoning 2-201 zoning 2-21, 2-22 FICON Management Server 2-10, 2-23 FICON MS show 2-202 ficonms 2-10, 2-23 FRU information 2-202 G G_port, setting 2-40 gateway address 2-24 globally available
PAGE 401
Index conventions xvii using this xvi McDATA product publications, ordering xix technical support xviii web site xvi membership list fabric binding 2-65 add attached 2-64 add member 2-64 clear 2-65 switch binding 2-76 N name server 2-206, 2-208 names, for ports 2-32 navigating the command tree 1-14 limitations 1-15 navigation conventions 1-3 NPIV configuring port IDs 2-25, 2-26 disable 2-11 enable 2-11 enabling 2-11 set state 2-11 setting state 2-27 showing configuration 2-27 NSTools 2-28 clear snapshot 2
PAGE 402
Index speed 2-38 statistics, clearing 2-142 status 2-230 swapping 2-40 threshold alert 2-162, 2-163 traffic counters 2-177 type 2-40 port binding state 2-68 port number, zone member adding 2-125 deleting 2-128 port statistics, resetting 2-142 preferred domain ID 2-110 preferred path clear 2-152 delete 2-152 destination 2-155, 2-234 disable 2-154 enable 2-154 feature overview 2-151 set exit port 2-153 show 2-234 show exit port 2-216 show path 2-155 show state 2-157 source port 2-155, 2-234 state 2-154 princ
PAGE 403
Index active configuration 2-66 add members 2-64 deactivate 2-65 delete members 2-65 replace pending 2-66 show pending 2-67 modifying users 2-58 port binding 2-68 reset SSH keys 2-72 set SSH renegotiation MB 2-72 set SSH state 2-72 setting secret 2-55 setting user role 2-60 show SSH state 2-73 showing port 2-51 showing RADIUS server 2-54 showing state 2-48 showing user 2-60 switch binding 2-76 adding member 2-77 deleting member 2-77 setting state 2-78 showing configuration 2-78 timeout RADIUS server 2-54 s
PAGE 404
Index system configuration 2-122 SNMP authorization traps 2-93 community adding 2-86 deleting 2-93 disable agent 2-96 enable agent 2-96 Fibre Alliance MIB version 2-95 send test trap 2-95 set state 2-96 spaces, quotation marks required 1-15 speeds port 2-38 switches 2-114 state back pressure 2-146 OpenTrunking 2-12, 2-148 setting NPIV 2-27 SNMP 2-96 Zone Flex Pars 2-104 statistic table, threshold alert 2-166 statistics, port, clearing 2-142 strings, null 1-16 strings, quotation marks in 1-15 subnet mask 2-
PAGE 405
Index add throughput alert 2-170 alert list 2-252 counter setting 2-164 deactivate 2-168 delete alert 2-168 disable 2-168 enable 2-168 list 2-252 log 2-254 name 2-166 parameters 2-165, 2-175 port add 2-162, 2-171 remove 2-163, 2-172 remove port 2-172 set parameters 2-175 settings show 2-175 show 2-168, 2-175 show utilization types 2-176 statistic table, show 2-166 throughput add alert 2-170 trigger percentage 2-174 trigger type 2-173 utilization percentage 2-174 utilization type 2-173 utilization types 2-1
PAGE 406
Index WWN members adding 2-126 deleting 2-129 Z zone adding 2-126 default state 2-131 deleting 2-130 members adding by port 2-125 adding by WWN 2-126 deleting by port 2-128 deleting by WWN 2-129 renaming 2-130 Zone Flex Pars zoning state 2-104 zone members clearing 2-127 domain ID adding 2-125 deleting 2-128 zone set activating to fabric 2-123, 2-124 clearing 2-127 deactivating 2-128 renaming 2-130 replacing 2-131 temporary copy 2-123 zone sets and zones displaying 2-124 zoning configuring 2-123 FICON CUP