McDATA 316095-B21 - StorageWorks Edge Switch 2/24 User Manual

Fw 08.01.00 mcdata e/os command line interface user manual (620-000134-740, november 2005)
Hide thumbs Also See for 316095-B21 - StorageWorks Edge Switch 2/24:
Table of Contents

Advertisement

E/OS

Command Line Interface

User Manual

P/N 620-000134-740
REV A

Advertisement

Table of Contents
loading

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

  • Page 1: Command Line Interface

    E/OS Command Line Interface User Manual P/N 620-000134-740 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...
  • Page 3 Data, nScale, nView, OPENready, SANavigator, SANtegrity, SANvergence, SecureConnect and Sphereon are trademarks or registered trademarks of McDATA Corporation. OEM and Reseller logos are the property of such parties and are reprinted with limited use permission. All other trademarks are the property of their respective companies.
  • Page 4 E/OS Command Line Interface User Manual...
  • Page 5: Table Of Contents

    Contents Preface ..........................xv Chapter 1 Introduction Command Line Interface Overview..........1-2 Entering Command Line Interface Commands ......1-2 Documentation Conventions ...........1-2 Navigation Conventions............1-2 Command Tree ................1-4 Navigation of the CLI Command Tree.........1-12 Parameters ................1-14 Output ..................1-15 Logging In and Logging Out ............1-15 User Access Rights ..............1-15 Passwords and Secrets ............1-15 login ...................1-16...
  • Page 6 Contents config ....................2-5 config.enterpriseFabMode.setState.........2-5 config.features.enterpriseFabMode ........2-6 config.features.ficonMS ............2-7 config.features.installKey ............2-7 config.features.NPIV..............2-8 config.features.openSysMS ............2-8 config.features.openTrunking ..........2-9 config.features.show ..............2-9 config.fencing.addPolicy ............2-10 config.fencing.addPort............2-11 config.fencing.deletePolicy ............2-12 config.fencing.removePort .............2-12 config.fencing.setParams............2-13 config.fencing.setState ............2-15 config.fencing.show ..............2-15 config.fencing.showTypeTable..........2-17 config.ficonCUPZoning.addControlHost ......2-17 config.ficonCUPZoning.deleteControlHost ......2-18 config.ficonCUPZoning.setState ...........2-18 config.ficonCUPZoning.show ..........2-19 config.ficonMS.setMIHPTO...........2-19 config.ficonMS.setState............2-20 config.ficonMS.show...............2-20 config.ip.ethernet..............2-21 config.ip.lineSpeed ..............2-22...
  • Page 7 Contents config.port.type ............... 2-33 config.security ................. 2-34 config.security.authentication.interface.api.outgoing ..2-35 config.security.authentication.interface.api.sequence..2-35 config.security.authentication.interface.cli.sequence ..2-36 config.security.authentication.interface.eport.outgoing ... 2-37 config.security.authentication.interface.eport.sequence ... 2-37 config.security.authentication.interface.nport.outgoing... 2-38 config.security.authentication.interface.nport.sequence... 2-39 config.security.authentication.interface.osms.outgoing ... 2-39 config.security.authentication.interface.osms.setKey ..2-40 config.security.authentication.interface.serial.enhancedAuth. 2-41 config.security.authentication.interface.show ....2-41 config.security.authentication.interface.web.sequence..2-42 config.security.authentication.port.override ...... 2-42 config.security.authentication.port.show......
  • Page 8 Contents config.security.portBinding.wwn .........2-61 config.security.ssh.resetKeys ..........2-63 config.security.ssh.setState.............2-63 config.security.ssh.show............2-63 config.security.switchAcl ............2-64 config.security.switchAcl.addRange ........2-64 config.security.switchAcl.deleteRange ........2-65 config.security.switchAcl.setState.........2-65 config.security.switchAcl.show..........2-65 config.security.switchBinding ..........2-66 config.security.switchBinding.addMember ......2-67 config.security.switchBinding.deleteMember.....2-67 config.security.switchBinding.setState.........2-68 config.security.switchBinding.show........2-69 config.security.ssl ..............2-70 config.security.ssl.generateKeys ...........2-70 config.security.ssl.resetKeys ..........2-71 config.security.ssl.setRenegotiationMB .......2-72 config.security.ssl.setWebState..........2-72 config.security.ssl.setAPIState ..........2-73 config.security.ssl.show............2-73 config.snmp ................2-75 config.snmp.addAccessEntry ..........2-76 config.snmp.addAccessViews ..........2-77 config.snmp.addCommunity..........2-77 config.snmp.addTargetParams ..........2-78 config.snmp.addUserEntry ............2-80...
  • Page 9 Contents config.snmp.showUserTable..........2-91 config.snmp.showV3GroupTable......... 2-92 config.snmp.showViewTable ..........2-93 config.snmp.validateUser ............2-94 config.switch................2-95 config.switch.apiState............. 2-95 config.switch.domainRSCN ..........2-96 config.switch.edTOV .............. 2-96 config.switch.haMode ............2-97 config.switch.insistDomainId ..........2-97 config.switch.interopMode............ 2-98 config.switch.islFSPFCost............2-98 config.switch.ltdFabRSCN............. 2-99 config.switch.prefDomainId..........2-99 config.switch.priority ............2-100 config.switch.raTOV............. 2-101 config.switch.rerouteDelay..........
  • Page 10 Contents config.zoning.clearZoneSet..........2-117 config.zoning.deactivateZoneSet ........2-117 config.zoning.deletePortMem ..........2-118 config.zoning.deleteWwnMem ...........2-118 config.zoning.deleteZone .............2-119 config.zoning.renameZone ..........2-120 config.zoning.renameZoneSet ..........2-120 config.zoning.replaceZoneSet..........2-121 config.zoning.setDefZoneState..........2-121 config.zoning.showActive............2-121 config.zoning.showPending ..........2-122 maint....................2-124 maint.port.beacon..............2-124 maint.port.reset..............2-125 maint.system.beacon.............2-125 maint.system.clearSysError ..........2-126 maint.system.ipl..............2-126 maint.system.resetConfig.............2-126 maint.system.setOnlineState..........2-127 perf ....................2-128 perf.class2 ................2-128 perf.class3 ................2-129 perf.clearStats .................2-131 perf.errors ................2-131 perf.link...................2-133 perf.openTrunking.backPressure........2-134 perf.openTrunking.congestionThresh........2-135 perf.openTrunking.lowBBCreditThresh ......2-136 perf.openTrunking.setState..........2-136...
  • Page 11 Contents perf.thresholdAlerts.counter.show ........2-154 perf.thresholdAlerts.counter.showStatisticTable ..... 2-154 perf.thresholdAlerts.deleteAlert......... 2-155 perf.thresholdAlerts.setState ..........2-156 perf.thresholdAlerts.show ........... 2-156 perf.thresholdAlerts.throughput.addAlert ....... 2-158 perf.thresholdAlerts.throughput.addPort......2-159 perf.thresholdAlerts.throughput.removePort ....2-160 perf.thresholdAlerts.throughput.setUtilType ....2-161 perf.thresholdAlerts.throughput.setUtilPercentage ..2-162 perf.thresholdAlerts.throughput.setParams ..... 2-163 perf.thresholdAlerts.throughput.show ......2-164 perf.thresholdAlerts.throughput.showUtilTypeTable ..2-164 perf.traffic................2-165 show ....................
  • Page 12 Contents show.openTrunking.config..........2-195 show.openTrunking.rerouteLog .........2-196 show.port.config ..............2-197 show.port.exit ................2-198 show.port.info ................2-200 show.port.nodes ..............2-201 show.port.opticData..............2-203 show.port.opticEDD .............2-204 show.port.opticHealth ............2-205 show.port.opticInfo ...............2-206 show.port.profile ..............2-208 show.port.showPortAddr ...........2-210 show.port.status..............2-212 show.port.technology ............2-215 show.preferredPath.showPath ..........2-216 show.preferredPath.showState..........2-218 show.security.fabricBinding ..........2-218 show.security.log..............2-219 show.security.portBinding...........2-220 show.security.switchAcl............2-221 show.security.switchBinding..........2-222 show.snmp.accessTable............2-223 show.snmp.targetTable ............2-224 show.snmp.userTable ............2-225 show.snmp.V3GroupTable ..........2-226 show.snmp.viewTable ............2-227 show.snmp.config ..............2-228...
  • Page 13 Tables CLI Command Tree Navigation Conventions ......... 1-3 CLI Command Tree ..................1-4 CLI Command Tree for the ED-5000 Director ........1-22 Supported Zoning Configurations ............2-114 Throughput Threshold Alerts ..............2-147 Alert Counters ................... 2-147 Commands and Releases ................B-1 Tables xiii...
  • Page 14 Tables E/OS Command Line Interface User Manual...
  • Page 15: Preface

    Preface This publication is part of the documentation suite that supports the ® McDATA Sphereon™ 3016, Sphereon 3032, Sphereon 3216, Sphereon 3232, Sphereon 4300, Sphereon 4500, Sphereon 4400, and ® Sphereon 4700 Fabric Switches, Intrepid 6064 Director, and Intrepid 6140 Director. This publication describes the commands that can be entered through Who Should Use This Manual...
  • Page 16 Preface This publication is organized as follows: Organization of This Manual • Chapter 1, Introduction, provides an introduction and overview of the Command Line Interface. • Chapter 2, CLI Commands, describes the CLI commands, including their syntax, purpose, and parameters, as well as examples of their usage and any output that they generate.
  • Page 17 Preface • 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 NOTE: To expedite warranty entitlement, please have your product serial number available. McDATA Corporation 380 Interlocken Crescent Broomfield, CO 80021 Phone: (800) 752-4572 or (720) 558-3910 Fax: (720) 558-3581 E-mail: support@mcdata.com NOTE: Customers who purchased the hardware product from a company other than McDATA should contact that company’s service representative for technical support.
  • Page 19 Preface The following terms, indicated by a registered trademark symbol (®) Trademarks or trademark symbol (™) on first use in this publication, are trademarks of McDATA Corporation in the United States, other countries, or both: Registered Trademarks Trademarks ® Fabricenter E/OS™...
  • Page 20 Preface E/OS Command Line Interface User Manual...
  • Page 21: Introduction

    Introduction This chapter introduces the Command Line Interface (CLI) and describes the essentials for using the CLI commands. • Command Line Interface Overview............1-2 • Entering Command Line Interface Commands........1-2 • Logging In and Logging Out.............. 1-15 • Using the commaDelim Command ............ 1-18 •...
  • Page 22: Command Line Interface Overview

    Command Line Interface Overview Command Line Interface Overview The Command Line Interface (CLI) is a feature that provides an alternative to Graphical User Interface (GUI) and web-based (HTTP) interface products for director and switch management capabilities. The CLI can only be used through a Telnet client session in an out-of-band management environment, using the Ethernet port in the director or switch.
  • Page 23: Cli Command Tree Navigation Conventions

    Entering Command Line Interface Commands CLI Command Tree Navigation Conventions Table 1-1 Character Sequence Common Name Action or Description <CR> Carriage Return Pass a completed line to the parser. <DEL> Delete Backspace one character and delete the character. <NL> New Line Pass a completed line to the parser.
  • Page 24: Command Tree

    Entering Command Line Interface Commands Table 1-1 CLI Command Tree Navigation Conventions (Continued) Character Sequence Common Name Action or Description Control-R Redraw the line. Control-U Clear the input and reset the line buffer. Control-X Clear the input and reset the line buffer.
  • Page 25 Entering Command Line Interface Commands Table 1-2 CLI Command Tree (Continued) openSysMS openTrunking show fencing------------------- addPolicy addPort deletePolicy removePort setParams setState show showTypeTable ficonCUPZoning------- addControlHost deleteControlHost setState show ficonMS------------------ setMIHPTO setState show ip-------------------------- ethernet lineSpeed show setHostCtrlState NPIV--------------------- maxPortIDs setState show openSysMS------------ setHostCtrlState setState...
  • Page 26 Entering Command Line Interface Commands Table 1-2 CLI Command Tree (Continued) swapPortByNum type security------------------ authentication---------- interface----------------- api------------------------- outgoing sequence cli-------------------------- sequence eport---------------------- outgoing sequence nport---------------------- outging sequence osms--------------------- outgoing setKey serial--------------------- enhancedAuth show web----------------------- sequence port----------------------- override show radius-------------------- attempts deadtime deleteServer server...
  • Page 27 Entering Command Line Interface Commands Table 1-2 CLI Command Tree (Continued) showPending portBinding ------------- bound show ssh------------------------ resetKeys setState show switchAcl---------------- addRange deleteRange setState show switchBinding ---------- addMember deleteMember setState show ssl ------------------------ generateKeys resetKeys setAPIState setRengotiationMB setWebState show snmp --------------------- addAccessEntry addAccessViews addCommunity addTargetParams...
  • Page 28 Entering Command Line Interface Commands Table 1-2 CLI Command Tree (Continued) setFaMibVersion setSNMPv3State setState show showAccessTable showTargetTable showUserTable showV3GroupTable showViewTable validateUser switch -------------------- apiState bbCredit domainRSCN edTOV haMode islFSPFCost insistDomainId interopMode ltdFabRSCN prefDomainId priority raTOV rerouteDelay RSCNZoneIsolation safeZoning speed show webState zoneFlexPars zoningRSCN...
  • Page 29 Entering Command Line Interface Commands Table 1-2 CLI Command Tree (Continued) date description location name show zoning ------------------ activateZoneSet addPortMem addWwnMem addZone clearZone clearZoneSet deactivateZoneSet deletePortMem deleteWwnMem deleteZone renameZone renameZoneSet replaceZoneSet setDefZoneState showPending showActive maint ---------- port ----------------------- beacon reset system ------------------ beacon clearSysError resetConfig...
  • Page 30 Entering Command Line Interface Commands Table 1-2 CLI Command Tree (Continued) setState show unresCongestion preferredPath ---------- clearPath setPath setState showPath showState thresholdAlerts -------- counter ------------------ addAlert addPort removePort setCounter setParams show showStatisticTable deleteAlert setState show throughput -------------- addAlert addPort removePort setUtilType setUtilPercentage setParams...
  • Page 31 Entering Command Line Interface Commands Table 1-2 CLI Command Tree (Continued) eventLog fabric--------------------- nodes principal topology traceroute fabricLog---------------- noWrap wrap features fencing------------------- policies ficonCUPZoning ficonMS frus ip -------------------------- ethernet linkIncidentLog loginServer nameServer nameServerExt NPIV--------------------- config openSysMS------------ config openTrunking ---------- config rerouteLog port ----------------------- config exit...
  • Page 32: Navigation Of The Cli Command Tree

    Entering Command Line Interface Commands Table 1-2 CLI Command Tree (Continued) portBinding switchAcl switchBinding snmp -------------------- accessTable config targetTable userTable V3GroupTable viewTable switch syslog system thresholdAlerts-------- alerts zoning Note that the commands are shown, with the exception of the zoning commands, in alphabetical order to make them easier to locate.
  • Page 33 Entering Command Line Interface Commands Config.Port> name 4 "Sam’s Tape Drive" At this point, to enter the maint.port.beacon command to set the beaconing state of port 4, the following series of commands is entered: Config.Port> .. Config> .. Root> maint Maint>...
  • Page 34: Parameters

    Entering Command Line Interface Commands Limitation on Movements As the commands are entered, they are recorded in a history log. Note these limitations on movement that result from use of the history log: • If a command has more than 60 characters, the command runs, but the command is not recorded in the history log, and the position in the tree does not change, as shown in the following example.
  • Page 35: Output

    Logging In and Logging Out All output from the CLI commands is limited to the standard 80 Output columns supported by most Telnet interfaces. The output is left-justified. Logging In and Logging Out The command line interface (CLI) allows a single Telnet client to be connected to the switch.
  • Page 36: Login

    Logging In and Logging Out simplesecret**** This is an example of a secret that does not use any special characters. \40\72\A3\F9\12\13\14\15\16\17\18\19\55\33\87\42 This is an example of a secret of length 4 that is configured using the hexadecimal representation. a9p\40\40xx\44\88kutfe\89h This is an example of a secret that has a length of 7 characters that are composed of a mix using hexadecimal and the printable ASCII characters.
  • Page 37: Logout

    Logging In and Logging Out The access rights chosen for the CLI are completely independent of the other product interfaces, for example, SNMP or McDATA product interfaces. Parameters This command has no parameters. Command Examples login Username: Administrator Password: password login Username: Operator Password: password...
  • Page 38: Using The Commadelim Command

    Using the commaDelim Command Using the commaDelim Command Note that the output examples shown in the other sections of this publication presume that commaDelim is off. commaDelim Syntax commaDelim enable Purpose This command enables the user to obtain displayed information in comma-delimited, rather than tabular, format.
  • Page 39: Handling Command Line Interface Errors

    Handling Command Line Interface Errors Handling Command Line Interface Errors Two types of errors detected by the CLI are: • An error associated with the interface. For example, a keyword is misspelled or does not exist. Root> confg Error 234: Invalid Command •...
  • Page 40: Using The Command Line Interface Help

    Using the Command Line Interface Help Using the Command Line Interface Help The question mark (?) can be used within a command to obtain certain information: • If the question mark is used in place of a command keyword, all the keywords at that level of the CLI command tree display: Root>...
  • Page 41: Commenting Scripts

    Commenting Scripts Commenting Scripts The pound sign (#) can be used to add comments in a script file. The pound sign must be the first character in the line; the CLI ignores everything after the pound sign in that line. The following lines are valid: Root>...
  • Page 42: Ed-5000 Director

    ED-5000 Director ED-5000 Director A subset of the CLI commands described in this publication are available on the ED-5000 Director™. The globally available commands (login, logout, and commaDelim) are described previously in this chapter. The following config, maint, and show commands are described in Chapter 2, New and Changed Commands:...
  • Page 43: Telnet Session

    Telnet Session Telnet Session The CLI can be accessed through a Telnet client session in an out-of-band management environment, using the Ethernet port in the director or switch. It can also be accessed using Secure Shell (SSH). Although the primary use of the CLI is in host-based scripting environments, the CLI commands can also be entered directly at a command line.
  • Page 44 Telnet Session E/OS Command Line Interface User Manual 1-24...
  • Page 45: Cli Commands

    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 •...
  • Page 46: Command Overview

    Command Overview Command Overview Most of the commands in this chapter are listed in alphabetical order to make them easy to locate. Although the commands can be entered in any order, depending on the results desired (so long as the tree structure is followed), the order used herein for the zoning commands follows a typical order of entry.
  • Page 47 New and Changed Commands • on page 2-73 config.security.ssl.show • on page 2-76 config.snmp.addAccessEntry • on page 2-85 config.snmp.deleteAccessEntry • on page 2-78 config.snmp.addTargetParams • on page 2-80 config.snmp.addUserEntry • on page 2-82 config.snmp.addV1Target • on page 2-83 config.snmp.addV2Target • on page 2-83 config.snmp.addV3Target •...
  • Page 48 New and Changed Commands • on page 2-108 config.syslog.setLogConfig • on page 2-108 config.syslog.setState • on page 2-109 config.syslog.show • on page 2-110 config.system • on page 2-110 config.system.contact • on page 2-124 maint.port.beacon • on page 2-125 maint.port.reset • on page 2-128 perf.class2 •...
  • Page 49: Config

    config • on page 2-208 show.port.profile • on page 2-216 show.preferredPath.showPath • on page 2-223 show.snmp.accessTable • on page 2-224 show.snmp.targetTable • on page 2-225 show.snmp.userTable • on page 2-226 show.snmp.V3GroupTable • on page 2-227 show.snmp.viewTable • on page 2-234 show.syslog config The config branch of the CLI command tree contains commands that...
  • Page 50: Config.features.enterprisefabmode

    config This command has one parameter: Parameters enterpriseFabModeState Specifies whether enterpriseFabMode is active. Valid values are activate and deactivate. Boolean 1 and 0 may be substituted as values. Command Example Root> config enterpriseFabMode setState 1 NOTE: You cannot activate Enterprise Fabric Mode while Open Trunking is enabled.
  • Page 51: Config.features.ficonms

    config config.features.ficonMS Syntax ficonMS ficonMSState This command enables or disables FICON Management Server. The Purpose 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.) Sphereon 3016 and 3216 NOTE: This command is displayed on a only if...
  • Page 52: Config.features.npiv

    config This command has one parameter: Parameters featureKey Specifies the key you have received to enable optional software feature on a specific product. A feature key is a string of case-sensitive, alphanumeric ASCII characters. The number of characters may vary in the format;...
  • Page 53: Config.features.opentrunking

    config This command has one parameter: Parameters osmsState Specifies whether the Open Systems Management Server is enabled. Valid values are enable and disable. Boolean 1 and 0 may be substituted as values. Command Example Root> config features openSysMS 1 NOTE: The command on page 2-25 has config.openSysMS.setState functionality that is identical to this command.
  • Page 54: Config.fencing.addpolicy

    config Command Example Root> config features show The product feature data is displayed as a table that includes the Output following properties. Installed Feature 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.
  • Page 55: Config.fencing.addport

    config Command Example Root> config fencing addPolicy Policy2 NOTE: The maximum number of policies supported is 14. config.fencing.addPort Syntax addPort name portNumber This command adds a port to the specified fencing policy. Purpose This command has two parameters: Parameters name The name of the fencing policy.
  • Page 56: Config.fencing.deletepolicy

    config • flport – This adds all active F_Ports and FL_ports (This applies to Sphereon 4400, Sphereon 4300, Sphereon 4500 and Sphereon 4700 switches). NOTE: A fencing policy can contain either port types or individual port numbers only. Command Example Root>...
  • Page 57: Config.fencing.setparams

    config This command has two parameters: Parameters name The name of the fencing policy. portNumber The port number to remove from the fencing policy, or all, which will remove all of the individual ports from the fencing policy. 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 0-15 for the Sphereon 4400 0–23 for the Sphereon 4500...
  • Page 58 config This command has four parameters: Parameters name The name of the fencing policy. typeNumber This must be entered as a number that corresponds to an entry in the table shown below. limit The count of fencing violations that must occur within the specified period in order for a port to be automatically disabled.
  • Page 59: Config.fencing.setstate

    config Where: Port list = 0, 1, 2 Fencing Type = Protocol Errors Limit Period = 1800 seconds Command Example Root> Config fencing setParams abc 1 5 300 config.fencing.setState Syntax setState name enabledState This command enables or disables specified fencing policy. A policy Purpose cannot be activated if it contains ports that are already controlled by a different fencing policy of the same type.
  • Page 60 config 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.
  • Page 61: Config.fencing.showtypetable

    config Period: 300 seconds State: Disabled config.fencing.showTypeTable Syntax showTypeTable This command displays the table of different fencing types that can Purpose be assigned to a policy. This table is used for reference only. This command has no parameters. Parameters Command Example Root>...
  • Page 62: Config.ficoncupzoning.deletecontrolhost

    config config.ficonCUPZoning.deleteControlHost Syntax deleteControlHost hostNodeWwn This command removes one or all control hosts from the Control Purpose 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: Parameters hostNodeWwn The node WWN of the desired control host,...
  • Page 63: Config.ficoncupzoning.show

    config config.ficonCUPZoning.show Syntax show This command displays the contents of the host control list and the Purpose enabled state of FICON CUP Zoning. This command has no parameters. Parameters Command Example Root> config ficonCUPZoning show The data is displayed as a table that includes the following Output information: FICON CUP...
  • Page 64: Config.ficonms.setstate

    config Command Example Root> config ficonms setMIHPTO 180 config.ficonMS.setState Syntax setState ficonMSState This command enables or disables FICON Management Server. The Purpose 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.) Sphereon 3016 NOTE: This command is displayed on a...
  • Page 65: Config.ip.ethernet

    config The data is displayed as a table that includes the following Output 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 Output Example follows: Ficon MS State: Disabled...
  • Page 66: Config.ip.linespeed

    config config.ip.lineSpeed Synopsis lineSpeed speed duplex This command sets the Ethernet line speed. Purpose This command has two parameters. One of the parameters is optional Parameters 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.
  • Page 67: Config.npiv

    config config.NPIV N_Port ID Virtualization (NPIV) provides a FC facility for sharing a single physical N_Port among multiple N_Port IDs, thereby allowing multiple initiators, each with its own N_Port ID, to share the N_Port. You can configure the number of allowed NPIV logins for a given port and enable or disable the feature.
  • Page 68: Config.npiv.setstate

    config config.NPIV.setState Syntax setState NPIVEnabledState This command sets enabled state of the NPIV feature. The NPIV Purpose feature key must be installed in order to enable this feature. This command has one parameter: Parameters NPIVEnabledState This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted.
  • Page 69: Config.opensysms.sethostctrlstate

    config NOTE: The command on page 2-193 has functionality that show.NPIV.config is the same as this command. config.openSysMS.setHostCtrlState Syntax setHostCtrlState HostContrlState This command enables or disables Open Systems Management Purpose Server (OSMS) Host Control. This command has one parameter: Parameters HostContrlState This parameter can be set to enable or disable.
  • Page 70: Config.port.blocked

    config NOTE: The command on page 2-8 has functionality config.features.openSysMS that is identical to this command. config.port.blocked Syntax blocked portNumber blockedState This command sets the blocked state for a port. Purpose This command has two required parameters: 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...
  • Page 71: Config.port.name

    config This command has two required parameters: Parameters portNumber Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 0-15 for the Sphereon 4400 0–23 for the Sphereon 4500 0–31 for the Sphereon 3232 0-31 for the Sphereon 4700 fanState Specifies the FAN state for the port.
  • Page 72: Config.port.rxcredits

    config config.port.rxCredits Syntax rxCredits PortNumber RxCredits This command is used to set the number of initial BB_Credits for a Purpose given port. The number of credits assigned must fall between the minimum and maximum allowed values for the port. This command has two required parameters: Parameters portNumber Specifies the port number.
  • Page 73 config This command has one parameter: 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...
  • Page 74: Config.port.showportaddr

    config Port Number: Name: Sam’s tape drive Blocked: false Type: F Port Speed: 2 Gb/sec Rx BB_Credits: config.port.showPortAddr Syntax showPortAddr This command displays the port address configuration for all ports. Purpose NOTE: The command on page 2-210 has functionality show.port.showPortAddr that is the same as this command.
  • Page 75: Config.port.showcredits

    config config.port.showCredits Syntax showCredits This command shows the BB_Credit Pool information. Purpose This command has no parameters. Parameters Command Example Root> config port showCredits This command displays the BB_Credit data: Output 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...
  • Page 76: Config.port.speed

    config config.port.speed Syntax speed portNumber portSpeed This command sets the speed for a port. A port can be configured to Purpose operate at 1 Gb/sec, 2 Gb/sec, 4Gb/sec, or a negotiated speed. The port speed can be set only to 1 Gb/sec, if the switch speed is 1 Gb/sec.
  • Page 77: Config.port.swapportbynum

    config This command has two required parameters: 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. Command Example Root> config port swapPortByAddr 1e 1f config.port.swapPortByNum Syntax swapPortByNum...
  • Page 78: Config.security

    config The port configurations function as follows: • F_Port—cannot be used as an interswitch link, but may attach to a device with an N_Port. • E_Port—only other switches may attach to this type of port. • G_Port—either a device or another switch may attach to this type of port.
  • Page 79: Config.security.authentication.interface.api.outgoing

    config Some security configuration commands (namely those under the fabricBinding branch) are different from other CLI commands in that they are not single action commands that take effect immediately. These commands implement a rudimentary membership list editor. A user works on a temporary copy of a membership list in the editor and can perform actions such as adding or deleting fabric members.
  • Page 80: Config.security.authentication.interface.cli.sequence

    config This command has one required parameter, and one optional Parameters parameter: method1 This sets the preferred method of authentication. Accepted values are local or RADIUS. This optional parameter sets the backup method2 method of authentication. This backup method is used when the preferred method cannot be contacted.
  • Page 81: Config.security.authentication.interface.eport.outgoing

    config Command Example Root> config security authentication interface cli sequence RADIUS local config.security.authentication.interface.eport.outgoing Syntax outgoing enabledState This command determines if outgoing CHAP authentication is used Purpose on E_Port connections. If this is enabled, the switch will issue a CHAP challenge to authenticate the remote end of the ISL. NOTE: This command requires that the SANtegrity Authentication feature key be installed.
  • Page 82: Config.security.authentication.interface.nport.outgoing

    config This command has one required parameter, and one optional Parameters parameter: method1 This sets the preferred method of authentication. Accepted values are local or RADIUS. This optional parameter sets the backup method2 method of authentication. This backup method is used when the preferred method cannot be contacted.
  • Page 83: Config.security.authentication.interface.nport.sequence

    config config.security.authentication.interface.nport.sequence Syntax sequence method1 [method2] This command sets the sequence that the N_Port interface will use to Purpose authenticate. When the preferred method cannot be contacted, the backup method will be used to authenticate the remote end of the ISL.
  • Page 84: Config.security.authentication.interface.osms.setkey

    config NOTE: The SANtegrity Authentication feature key must be installed to configure the OSMS outgoing state. This command has one parameter: Parameters enabledState This parameter enables and disables FCCT authentication. Accepted values for this parameter are enable or disable. Boolean 1 and 0 values may also be substituted.
  • Page 85: Config.security.authentication.interface.serial.enhancedauth

    config config.security.authentication.interface.serial.enhancedAuth Syntax enhancedAuth enhancedAuthState This command sets the enhanced serial authentication state. Purpose Enhanced Serial Authentication will require a user to enter a password when gaining access to the serial port interface. This command has one parameter: Parameters enhancedAuthState This parameter enables and disables enhanced authentication on the serial port interface.
  • Page 86: Config.security.authentication.interface.web.sequence

    config Command Example Root> config security authentication interface show Web The output for the config.security.authentication.interface.show Output Example command appears as follows: Interface: Web Outgoing: Incoming: Sequence: Local, RADIUS config.security.authentication.interface.web.sequence Syntax sequence method1 [method2] This command sets the sequence that the web interface will use to Purpose authenticate.
  • Page 87: Config.security.authentication.port.show

    config state for either the E_Port or N_Port interface. The default setting will cause the port to use the outgoing state configure for the corresponding interface (either E_Port or N_Port). NOTE: This command requires that the SANtegrity Authentication feature key be installed. This command has one required parameter, and one optional Parameters parameter:...
  • Page 88: Config.security.authentication.radius.attempts

    config This command displays all valid user names in the local database for Output the specified interface. Port The port number. Override State The outgoing authentication override state. The output for the config.security.authentication.port.show command Output Example appears as follows: Port Override State ---- --------------...
  • Page 89: Config.security.authentication.radius.deleteserver

    config This command configures the number of minutes a RADIUS server is Purpose marked as “dead”. If a RADIUS server does not respond to an authentication request, it can be marked as “dead” for a specified time interval. This may speed up authentication by eliminating timeouts and retransmissions.
  • Page 90: Config.security.authentication.radius.show

    config There are three slots available for RADIUS servers. Servers will be added into the list by the index value. The range is 1 to 3. If a server is added and there is an empty slot before that server, it will be shifted up to the empty slot.
  • Page 91: Config.security.authentication.radius.timeout

    config The output for the config.security.authentication.RADIUS.show Output Example command appears as follows: Deadtime: Index IP Address Port Attempts Timeout ----- ------------- ---- ---------- ------- 1.1.1.1 1111 2.2.2.2 2222 config.security.authentication.RADIUS.timeout Syntax timeout index seconds This command configures the number of seconds to wait for a Purpose response from the RADIUS server before retransmitting a packet.
  • Page 92: Config.security.authentication.user

    config command was executed from. No characters will be echoed back to the screen when entering a password, or when confirming a password. See on page 1-15 for valid characters. Passwords and Secrets NOTE: The SANtegrity Authentication feature key must be installed to configure switch secret.
  • Page 93 config NOTE: The SANtegrity Authentication feature key must be installed to configure E_port and N_port usernames. This command has two required parameters and an additional Parameters 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.
  • Page 94: Config.security.authentication.user.delete

    config Command Example Root> config security authentication user add 01:2A:3f:4:5:0:0 eport config.security.authentication.user.delete Syntax delete username This command deletes an entry from the local authentication Purpose database. Both the Web and CLI interfaces must have at least one valid username with an “Administrator” role. This command has one parameter: Parameters username...
  • Page 95: Config.security.authentication.user.role

    config This command has two required parameters and an additional Parameters 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.
  • Page 96: Config.security.authentication.user.show

    config This command sets the role value associated to an existing user name. Purpose The role value can either be set to an administrator or an operator. This value defaults to “none” when the user is first added to the database.
  • Page 97: Config.security.fabricbinding

    config ----------- ----------- ------------- johndoe_1223 Web,CLI Administrator ewsOperator Operator Operator Web,CLI Operator config.security.fabricBinding Fabric Binding functionality provided by the SANtegrity Binding feature allows you to bind the switch or director to specified fabrics so that it can communicate only with those fabrics included in the Fabric Binding Membership List (FBML).
  • Page 98: Config.security.fabricbinding.activatepending

    config The following terms apply to the switches and directors that are part of the FBMLs: • Local: The switch or director that you are configuring. This is a required FBML member. • Attached: A switch or director that is currently in a fabric with the local switch or director.
  • Page 99: Config.security.fabricbinding.addattachedmembers

    config NOTE: This command takes effect immediately. The CLI verifies the list before activating it to the fabric. This command has no parameters. Parameters Command Example Root> config security fabricBinding activatePending config.security.fabricbinding.addAttachedMembers Syntax addAttachedMembers This command adds all the current members of the fabric to the Purpose Pending FBML.
  • Page 100: Config.security.fabricbinding.clearmemlist

    config Command Example Root> config security fabricBinding addMember AA:99:23:23:08:14:88:C1 2 config.security.fabricBinding.clearMemList Syntax clearMemList This command clears the Pending FBML in the working area. Purpose 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.
  • Page 101: Config.security.fabricbinding.deletemember

    config config.security.fabricBinding.deleteMember Syntax deleteMember wwn domainId This command removes a member from the Pending FBML in the Purpose fabric binding work area. The local member and attached members cannot be deleted from the list. NOTE: Changes are not activated to the fabric until the activatePending command is issued.
  • Page 102: Config.security.fabricbinding.showpending

    config This command displays the fabric binding configuration (active Purpose FBML) saved on the fabric. It performs the same function as on page 2-218. show.preferredPath.showState This command has no parameters. Parameters Command Example Root> config security fabricBinding showActive This command displays the following fabric binding configuration Output data: Domain ID...
  • Page 103: Config.security.portbinding

    config The fabric binding configuration data is displayed as a table that Output includes the following properties of the Pending FBML. Domain ID The domain ID of the FBML member. Valid domain IDs range from 1 to 239. The world wide name (WWN) of the FBML member in colon-delimited hexadecimal notation.
  • Page 104: Config.security.portbinding.show

    config This command has two parameters: Parameters portNumber Specifies the port number for which the port binding state is being set. Valid port number values are: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 and 3216 0-15 for the Sphereon 4400 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 and 3232 0-31 for the Sphereon 4700...
  • Page 105: Config.security.portbinding.wwn

    config This command has one parameter: Parameters portNumber Specifies the port number for which the port binding configuration will be shown. 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...
  • Page 106 config This command has two parameters: Parameters portNumber Port number for which the bound WWN is being set. Valid port number values are: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 and 3216 0-15 for the Sphereon 4400 0–23 for the Sphereon 4500 0–31 for the Sphereon 3032 and 3232 0-31 for the Sphereon 4700...
  • Page 107: Config.security.ssh.resetkeys

    config Root> config security portBinding wwn 4 attached Root> config security portBinding wwn 4 remove config.security.ssh.resetKeys Syntax resetKeys This command resets the SSH (secure shell) encryption keys to their Purpose factory default (unconfigured). The next time a client connects using SSH the server will generate new keys.
  • Page 108: Config.security.switchacl

    config The output of the config.security.ssh.show command displays the Output following data: Indicates whether the SSH interface to CLI is enabled or disabled. Telnet Indicates whether the Telnet interface to CLI is enabled or disabled. Output Example SSH: enabled Telnet: disabled config.security.switchAcl The access control list (ACL) feature allows the administrator to...
  • Page 109: Config.security.switchacl.deleterange

    config config.security.switchAcl.deleteRange Syntax deleteRange startIPAddress endIPAddress This command deletes a range of IP addresses from the access control Purpose list. This range must exactly match one of the existing ranges in the access control list. This command has the following parameters: Parameters startIPAddress The starting IP Address of the range to be...
  • Page 110: Config.security.switchbinding

    config This command displays the contents of the access control list. Purpose This command has no parameters. Parameters Command Example Root> config security switchACL show This command displays the following access control list information: Output Starting IP The starting IP Address of the range in the Address access control list.
  • Page 111: Config.security.switchbinding.addmember

    config • Enabling Enterprise Fabric Mode automatically enables Switch Binding. • If Enterprise Fabric Mode is enabled and the switch or director is online, you cannot disable Switch Binding. • If Enterprise Fabric Mode is enabled and the switch or director is offline, you can disable Switch Binding, but this also disables Enterprise Fabric Mode.
  • Page 112: Config.security.switchbinding.setstate

    config This command has one parameter: Parameters Specifies the switch or N_Port device WWN of the member to be removed from the SBML. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00). You may also enter all for this argument to clear the SBML completely.
  • Page 113: Config.security.switchbinding.show

    config This command has one parameter: Parameters switchBindingState Sets the switch binding state for the switch. Valid values are: disable - Disable switch binding. Devices (servers, storage, and other switches) are allowed to connect to the switch without restrictions. eRestrict - Enable switch binding and restrict E_Port connections.
  • Page 114: Config.security.ssl

    config This command displays the following switch binding configuration Output 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 The WWNs of members of the SBML saved Membership List on the switch.
  • Page 115: Config.security.ssl.resetkeys

    config The purpose for generating new keys is to improve the security of the SSL connections in case the private key has been compromised. This is considered to be unlikely, but the generation of new keys is usually performed periodically as a matter of security policy. Once a new certificate and private key are generated, you will likely see a message upon SSL connection that indicates that the new certificate is unrecognized.
  • Page 116: Config.security.ssl.setrenegotiationmb

    config when the certificate expires. At this point, you can either choose to continue, or cancel, despite the expiry date. This command has no parameters. Parameters Command Example Root> config security ssl resetKeys config.security.ssl.setRenegotiationMB Syntax setRenegotiationMB megabytes This command sets the number of megabytes that can be transferred Purpose using SSL before the SSL session is automatically renegotiated.
  • Page 117: Config.security.ssl.setapistate

    config This command has one parameter: Parameters sslEnabledState This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Command Example Root> config security ssl setWebState 0 config.security.ssl.setAPIState Syntax setAPIState sslEnabledState This command sets the enabled state for the SSL API interface. The Purpose default API access is non-secure.
  • Page 118 config Output Web Enable State The SSL enabled state for the web interface. API Enable State The SSL enabled state for the API interface. Renegotiation The SSL MB limit before renegotiation will take place. Certificate The SSL certificate. The SSL certificate in Privacy Enhanced Mail (PEM) format.
  • Page 119: Config.snmp

    config 5a:6b:7d:b9:35:3e:13:53:61:38:be:bb:54:39:18:39:23:ac: 52:a1:bf:d4:87:79:22:2c:ee:fb:3e:40:89:3d:97:9e:c7:b3: 7f:f2:4f:2e:af:67:3c:08:63:71:1b:b3:85:7b:dc:81:a8:3c: 85:da:84:07:62:2b:a5:83:92:aa PEM: -----BEGIN CERTIFICATE----- MIIBoDCCAUqgAwIBAgIEQnYh8jANBgkqhkiG9w0BAQUFADBQMSYwJAYDVQQDEx1T d2l0Y2ggU2VyaWFsIE51bWJlciBURVNUNDUwMDEmMCQGA1UEChMdU3dpdGNoIFNl cmlhbCBOdW1iZXIgVEVTVDQ1MDAwHhcNMDUwNTAyMTI0OTU0WhcNMDUwNjIxMTI0 OTU0WjBAMRYwFAYDVQQDEw0xNzIuMjYuMjIuMjEyMSYwJAYDVQQKEx1Td2l0Y2gg U2VyaWFsIE51bWJlciBURVNUNDUwMDBcMA0GCSqGSIb3DQEBAQUAA0sAMEgCQQC6 et6ISmqRSRCODtWgk0M/9Hl6iKLBF1Eoyb0t0ujq1IawEll7BvQZSyWhBqEx4had 48HXRw6r71O3gYIWSSFfAgMBAAGjHDAaMBgGA1UdEQQRMA+CDTE3Mi4yNi4yMi4y MTIwDQYJKoZIhvcNAQEFBQADQQBaa325NT4TU2E4vrtUORg5I6xSob/Uh3kiLO77 PkCJPZeex7N/8k8ur2c8CGNxG7OFe9yBqDyF2oQHYiulg5Kq -----END CERTIFICATE----- MD5: 1F:AC:B8:FF:BD:92:F0:13:E7:43:5E:AB:7F:C4:2D:E6 SHA-1: 5E:4A:0E:91:33:4B:10:75:00:EE:33:A8:AD:55:14:46:F4:E3:6B:43 config.snmp The E/OS provides additional level of security to the existing SNMP framework by supporting SNMPV3 in addition to SNMP versions 1 and 2, which authenticate the SNMP requests based on the “community”...
  • Page 120: Config.snmp.addaccessentry

    config ATTENTION! Before enabling SNMPv3, ensure all desired communities are configured for SNMPv3 access. If existing community strings are not configured for SNMPv3, then existing SNMP access will be lost. NOTE: The authentication/privacy key (password) configured for an SNMPv3 User on a switch is not localized. Therefore, the authentication/privacy key configured in the SNMP management application must be configured as a non-localized authentication/privacy key in ASCII format.
  • Page 121: Config.snmp.addaccessviews

    config NOTE: Using Authentication (Auth) means that the Authentication protocols such as HMAC-MD5 or HMAC-SHA will be used to calculate the hash value for the packet and this calculated Hash value will be sent along with the packets as part of the SNMPv3 Header. Using privacy (priv) means that the data part of the packet will be encrypted using a privacy protocol such as DES.
  • Page 122: Config.snmp.addtargetparams

    config This command has five parameters. Up to six community names and Parameters trap recipients may be defined as follows: commIndex Specifies the community to be created or edited. Valid values are integers in the range 1–6. commName Specifies the community name of the community specified by commIndex.
  • Page 123 config This command has five parameters: Parameters index Index of the Target entry. Valid values are indices already created using one of the addv1Target, addv2Target or addv3Target commands. Username The Security Name to be used for the corresponding trap entry. The maximum length for the security name is 32 characters and all characters in the ISO Latin-1 character set are valid.
  • Page 124: Config.snmp.adduserentry

    config config.snmp.addUserEntry Syntax addUserEntry index username authPtcl privPtcl This command adds a User-based Security Model (USM) user entry Purpose to the User Table (RFC 2574). It also specifies the authentication protocol and privacy protocol for this user. This command has four parameters: Parameters index Index of the target entry.
  • Page 125: Config.snmp.addv3Group

    config Confirm: Retype the privacy password config.snmp.addV3Group Syntax addV3Group index username secModel groupName This command configures an entry in the Security-to-Group table. Purpose This table is used to map a user to a group and a security model. This command has four parameters: Parameters index Index of the user entry.
  • Page 126: Config.snmp.addv1Target

    config Index Username Model Group Name ----- -------------------------------- ----- ---------- smith smithGroup smith smithGroup smith smithOtherGroup config.snmp.addV1Target Syntax addV1Target index community [IP] [udpNum] This command configures a v1 community string. The IP address and Purpose port number of a v1 trap recipient can be optionally specified. The community string can be used for v1 access only if mapped to a security and group name.
  • Page 127: Config.snmp.addv2Target

    config config.snmp.addV2Target Syntax addV2Target index community [IP] [udpNum] This command configures a v2 community string. The IP address and Purpose port number of a v2 trap recipient can be optionally specified. The community string can be used for v2 access only if mapped to a security and group name.
  • Page 128: Config.snmp.authtraps

    config This command configures the IP address and optionally the port Purpose number of a v3 trap recipient. The community name is not used for v3 Traps. This command has three parameters. The last one is optional. Parameters index Index of the Target entry. Valid values are 1 to 6.
  • Page 129: Config.snmp.deleteaccessentry

    config config.snmp.deleteAccessEntry Syntax deleteAccessEntry index This command deletes the specified entry from the Access Table. Purpose This command has 1 parameter: Parameters commIndex Index of the access entry. Valid values are 1 to Command Example Root> config snmp deleteAccessEntry 1 config.snmp.deleteCommunity Syntax deleteCommunity commIndex...
  • Page 130: Config.snmp.deletetargetentry

    config config.snmp.deleteTargetEntry Syntax deleteTargetEntry index This command deletes the specified entry from the Target Table. Purpose This command has one parameter: Parameters Index Index of the target entry. Valid values are 1 to Command Example Root> config snmp deletetargetentry 1 config.snmp.deleteV3Group Syntax deleteV3Group index...
  • Page 131: Config.snmp.setfamibversion

    config This command has one parameter: Parameters enabledState Enabled state of SNMPv3. This can be set to enable or disable. Boolean 1 and 0 values may also be substituted. Command Example Root> config snmp setSNMPv3State enable config.snmp.setFaMibVersion Syntax setFaMibVersion versionNumber This command sets the version of the Fibre Alliance MIB with which Purpose the SNMP agent interacts.
  • Page 132: Config.snmp.show

    config config.snmp.show Syntax show This command shows the SNMP configuration of the switch. Purpose This command has no parameters. Parameters Command Example Root> config snmp show The switch configuration data is displayed as a table that includes the Output following properties: SNMP Agent The state of the SNMP agent.
  • Page 133: Config.snmp.showaccesstable

    config CommunityName1 Enabled 123.123.123.123 CommunityName2 Enabled 10.25.25.10 CommunityName3 Disabled 132.44.85.224 public Enabled config.snmp.showAccessTable Syntax showAccessTable [index] This command displays the configured values for the Access Table. Purpose This command has one optional parameter: Parameters Index of the access entry. Valid values are 1 to index Command Example Config.SNMP>...
  • Page 134: Config.snmp.showtargettable

    config 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: Security Model: Security Level: None Group Name: group1 Read View: fcmgmt_3_1 Write View: fceos Notify View: internet...
  • Page 135: Config.snmp.showusertable

    config Index: Target IP: 172.19.16.169 UDP Port: Community Name: public MP Model: SNMPv1 Security Name: user1 Security Model: Security Level: No Authentication and No Privacy These are explained in the table below. SNMPv3 State Indicates whether SNMPv3 is enabled or disabled.
  • Page 136: Config.snmp.showv3Grouptable

    config This command displays the following switch configuration data: Output SNMPv3 State Indicates whether SNMPv3 is enabled or disabled. Index The index number. Username The username. Auth Protocol The Authentication Protocol. Privacy Protocol The Privacy Protocol. Command Example Config.SNMP> showUserTable SNMPv3 State: Enabled Index...
  • Page 137: Config.snmp.showviewtable

    config Username The username. Model The Security model. Group Name The group name. Example config.SNMP> showV3GroupTable SNMPv3 State: Enabled Index Username Model Group Name ----- -------------------------------- ----- ---------- User1 Group1 NOTE: This command and the command show.snmp.V3GroupTable page 22-226 has the same functionality. config.snmp.showViewTable Syntax showViewTable...
  • Page 138: Config.snmp.validateuser

    config experimental View Included .1.3.6.1.3 private View Included .1.3.6.1.4 snmpv3 View Included .1.3.6.1.6 fceos View Included .1.3.6.1.4.1.289 fcmgmt_3_1 View Included .1.3.6.1.2.1.8888 fcmgmt_3_0 View Included .1.3.6.1.3.94 fcfe View Included .1.3.6.1.3.42 system View Included .1.3.6.1.2.1.1 View Included .1.3.6.1.2.1.4 config.snmp.validateUser Syntax validateUser username secModel secLevel This command searches the User, Group, and Access tables for the Purpose given username, security model, and security level.
  • Page 139: Config.switch

    config Read View The Read View access for this user. Write View The Write View access for this user. Notify View The Notify View access for this user. Command Example Root> Config SNMP validateUser Jerry v1 noauthnopriv Username: Jerry Auth Protocol: No Authentication Priv Protocol: No Privacy...
  • Page 140: Config.switch.domainrscn

    config Command Example Root> config switch apiState enable config.switch.domainRSCN Syntax domainRSCN domainRSCNState Sets the domain RSCN state for the switch or director. You can run Purpose this command when the switch or director is either offline or online. When this parameter is enabled, domain registered state change notifications (domain RSCNs) are sent between end devices in a fabric to provide additional connection information to host bus adapters (HBA) and storage devices.
  • Page 141: Config.switch.hamode

    config This command has one parameter: Parameters timeoutValue Specifies the new E_D_TOV value. The units for this value are tenths of a second. This parameter must be an integer in the range 2–600 (0.2 second to 60 seconds), and it must be smaller than the R_A_TOV.
  • Page 142: Config.switch.interopmode

    config NOTE: The Insistent Domain ID must be enabled if the Enterprise Fabric Mode (an optional SANtegrity feature) or Preferred Path is enabled. config.switch.interopMode Syntax interopMode interopMode This command sets the interoperability mode for the switch. The Purpose switch must be offline to complete this command. NOTE: The switch must be set offline before this command is entered.
  • Page 143: Config.switch.ltdfabrscn

    config This command has one parameter: Parameters islFSPFCostState This parameter can be set to equal or default. If set to default, the value of the FSPF cost for each port depends on the speed of the port. In this case, the cost is inversely proportional to the bit rate of the ISL.
  • Page 144: Config.switch.priority

    config This command sets the preferred domain ID for the switch or Purpose director. The switch or director must be offline to complete this command. This command has one parameter: Parameters domainId Specifies the new preferred domain ID value. This parameter must be an integer in the range 1–31.
  • Page 145: Config.switch.ratov

    config Command Example Root> config switch priority principal config.switch.raTOV Syntax raTOV timeoutValue This command sets the resource allocation timeout value (R_A_TOV) Purpose 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.
  • Page 146: Config.switch.rscnzoneisolation

    config path may arrive ahead of older frames still in route over the older path. If rerouting delay is enabled, traffic ceases in the fabric for the time specified in the config.switch.edTOV command. This delay allows frames sent on the old path to exit to their destination before new frames begin traversing the new path.
  • Page 147: Config.switch.safezoning

    config config.switch.safeZoning Syntax safeZoning safeZoningState This command sets the state for safe zoning. When enabled, zone Purpose merges will not happen unless zone sets are equivalent; in addition, the option to set the default zone will be disabled. This command has one parameter: Parameters safeZoningState This parameter can be set to enable or disable.
  • Page 148: Config.switch.show

    config config.switch.show Syntax show This command displays the switch configuration. Purpose NOTE: The switch can be either offline or online when this command is executed. This command has no parameters. Parameters Command Example Root> config switch show The switch configuration data is displayed as a table that includes the Output following properties: BB Credit...
  • Page 149 config Domain RSCN When enabled, this allows domain RSCNs to be sent to registered members of the fabric. Zoning RSCN When enabled, allows zoning RSCNs to be sent to registered members of the fabric. Limited Fabric When enabled, fabric RSCNs are suppressed RSCN after an IPL.
  • Page 150: Config.switch.webstate

    config config.switch.webState Syntax webState webEnabledState This command sets the state of the web interface. When disabled, Purpose access through the web interface will be turned off. This command has one parameter: Parameters webEnabledState This parameter can be set to enable or disable. Boolean 1 and 0 values may also be substituted.
  • Page 151: Config.syslog

    config This command has one parameter: Parameters zoningRSCNStat This parameter can be set to enable, disable, true, or false. Boolean 1 and 0 values may also be substituted. config.syslog The syslog feature records events such as logins, configuration changes, and error messages that occur on the switch. If an error condition occurs, the switch attempts to write an entry to the system log.
  • Page 152: Config.syslog.setlogconfig

    config This command has one parameter: Parameters index The index number of the server to be deleted. Possible values are 1 to 3. Command Example Root> config syslog deleteserver 2 config.syslog.setLogConfig Syntax setLogConfig logName state This command enables syslog support for the given log. Purpose This command has two parameters: Parameters...
  • Page 153: Config.syslog.show

    config config.syslog.show Syntax show This command displays the syslog configuration. Purpose NOTE: The command on page 2-234 has functionality that is the show.syslog same as this command. This command has no parameters. Parameters The syslog configuration is shown as a table of properties. The Output following properties are displayed: The index number of the server.
  • Page 154: Config.system

    config config.system With the system command, the configuration branch enters the system configuration branch. All commands under this branch operate on a particular system attribute. System attributes are generic attributes that are not specific to Fibre Channel, and thus would be present on any product.
  • Page 155: Config.system.description

    config This command has two required parameters: Parameters systemDate Specifies the new system date. The format of the date parameter must be mm:dd:yyyy or mm/dd/yyyy. Valid date values include: mm: 1–12 dd: 1–31 yyyy: >1980 systemTime Specifies the new system time. The format of the time parameter must be hh:mm:ss.
  • Page 156: Config.system.name

    config This command has one parameter: Parameters systemLocation Specifies the new system location for the director or switch. The location can contain 0–255 characters. Command Example Root> config system location Everywhere config.system.name Syntax name systemName This command sets the system name attribute. Purpose This command has one required parameter: Parameters...
  • Page 157: Config.zoning

    config Contact The system contact. Location The system location. Date/Time The system date and time. The output from the config.system.show command appears as follows: Output Examples Name: Joe’s Switch Description: McDATA Intrepid 6140 Fibre Channel Director Contact: Location: Everywhere Date/Time: 04/16/2001 10:34:01 config.zoning...
  • Page 158: Config.zoning.activatezoneset

    config Fabrics Configuration Document located on www.mcdata.com in the Resource Library or contact your customer support representative. Supported Zoning Configurations Table 2-1 Sphereon 3x32 Intrepid 6064 Sphereon Sphereon Sphereon Sphereon Sphereon Product Intrepid 6140 4700 4400 4500 4300 3x16 ED-5000 Number of End 1024 1024...
  • Page 159: Config.zoning.addwwnmem

    config This command adds the domain ID and port number of a zone Purpose member to the specified zone in the work area. NOTE: Port numbers cannot be used for zone members if the interoperability mode for the switch or director is set to Open Fabric 1.0 mode. NOTE: A product can have a maximum of 4096 zone members in its zones.
  • Page 160: Config.zoning.addzone

    config NOTE: The ED-5000 supports a maximum of 512 zones. This command has two parameters: Parameters zoneName Specifies the name of the zone. The WWN of the member to be added to the zone. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00).
  • Page 161: Config.zoning.clearzone

    config Command Example Root> config zoning addZone TheUltimateZone config.zoning.clearZone Syntax clearZone zoneName This command clears all zone members for the specified zone in the Purpose work area. This command does not change the zone name. This command has one parameter: Parameters zoneName Specifies the name of the zone to be cleared.
  • Page 162: Config.zoning.deleteportmem

    config config.zoning.deletePortMem Syntax deletePortMem zoneName domainId portNumber This command deletes a domain ID and port number for a zone Purpose member in the specified zone in the work area. This command has three parameters: Parameters zoneName Specifies the name of the zone that contains the member to be deleted.
  • Page 163: Config.zoning.deletezone

    config This command has two parameters: Parameters zoneName Specifies the name of the zone that contains the member to be deleted. Specifies the WWN of the member to be deleted from the zone. The value of the WWN must be in colon-delimited hexadecimal notation (for example, AA:00:AA:00:AA:00:AA:00).
  • Page 164: Config.zoning.renamezone

    config config.zoning.renameZone Syntax renameZone oldZoneName newZoneName This command renames a zone in the work area. Purpose This command has two parameters: Parameters oldZoneName Specifies the current zone name of the zone to be renamed. newZoneName Specifies the new zone name. The newZoneName must contain 1–64 characters.
  • Page 165: Config.zoning.replacezoneset

    config Command Example Root> config zoning renameZoneSet TheUltimateZoneSet config.zoning.replaceZoneSet Syntax replaceZoneSet This command replaces the work area with the active zone set that is Purpose currently loaded on the fabric. This command has no parameters. Parameters Command Example Root> config zoning replaceZoneSet config.zoning.setDefZoneState Syntax setDefZoneState defaultZoneState...
  • Page 166: Config.zoning.showpending

    config The zoning configuration data is displayed as a table that includes Output the following properties. Active ZoneSet The enabled status, name, and member zones of the zone set. The output from the config.zoning.showActive command appears as Output Example follows: Active Zone Set Default Zone Enabled: False...
  • Page 167 config The output from the config.zoning.showPending command appears as Output Example follows: Pending Zone Set Default Zone Enabled: False ZoneSet: TheNewUltimateZoneSet Zone: TheNewUltimateZone ZoneMember: Domain 10, Port 6 ZoneMember: Domain 15, Port 2 Zone: TheNewNotSoUltimateZone ZoneMember: 10:00:00:00:C9:22:9B:AB ZoneMember: 10:00:00:00:C9:22:9B:C6 ZoneMember: 10:00:00:00:C9:22:9B:AB Zone: TheNewNotUltimateAtAllZone ZoneMember: Domain 2, Port 63...
  • Page 168: Maint

    maint 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).
  • Page 169: Maint.port.reset

    maint maint.port.reset Syntax reset portNumber This command resets an individual port without affecting any other Purpose 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.
  • Page 170: Maint.system.clearsyserror

    maint maint.system.clearSysError Syntax clearSysError This command clears the system error light. Purpose This command has no parameters. Parameters Command Example Root> maint system clearSysError maint.system.ipl Syntax This command IPLs the switch. Purpose ATTENTION! Connection to the CLI is lost when this command runs. This command has no parameters.
  • Page 171: Maint.system.setonlinestate

    maint Command Example Root> maint system resetConfig maint.system.setOnlineState Syntax setOnlineState onlineState This command sets the switch online or offline. Purpose This command has one parameter: Parameters onlineState Specifies whether the switch is online. Valid values are true and false. Boolean 1 and 0 may be substituted as values.
  • Page 172: Perf

    perf 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.
  • Page 173: Perf.class3

    perf The port Class 2 counter data is displayed as a table that includes the Output following statistics, along with a wrap count for each corresponding counter. Port The port number. RxFrames The number of Fibre Channel Class 2 frames that the port has received.
  • Page 174 perf This command has one parameter: Parameters 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 45000 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...
  • Page 175: Perf.clearstats

    perf TxFrames 1842953 RxWords 2953184 TxWords 1842953 Disc Frames 2953184 perf.clearStats Syntax clearStats portNumber This command resets all port statistics for an individual port or for all Purpose ports. This command has one parameter: Parameters 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...
  • Page 176 perf This command has one parameter: Parameters 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...
  • Page 177: Perf.link

    perf The output from the perf.errors command appears as follows: Output Example Port 2 StatisticCount --------------------- Prim Seq Err753452 Disc Frms351269 Inv Tx Wrds2953184 CRC Errs1842953 Delim Errs2953184 Addr Id Errs1842953 FrmsTooShrt40059 perf.link Syntax link portNumber This command displays port link counters for a single port. Purpose This command has one parameter: Parameters...
  • Page 178: Perf.opentrunking.backpressure

    perf Reset In The number of link resets initiated by the attached N_Port. Reset Out The number of link resets initiated by this switch or director. LIPS In The number of Loop Initialization Primitives (LIPs) detected on this switch loop port. LIPS Out The number of LIPs generated on this switch loop port.
  • Page 179: Perf.opentrunking.congestionthresh

    perf This command has one parameter: Parameters backPressureState This parameter can be set to enable or disable OpenTrunking back pressure. Boolean 1 and 0 values may also be substituted. If the state is configured to be enabled, a back pressure entry is made to the Event Log and an SNMP trap is generated if SNMP is configured.
  • Page 180: Perf.opentrunking.lowbbcreditthresh

    perf perf.openTrunking.lowBBCreditThresh Syntax lowBBCreditThresh lowBBcreditThreshold This command configures the low BB_credit threshold of the Purpose OpenTrunking configuration. The low BB_credit threshold is defined as the percentage of time that no transmit BB_Credits are passed on the link. When the threshold value is exceeded, the system tries to reroute the flows that are going to the ISL with the problem.
  • Page 181: Perf.opentrunking.show

    perf Command Example Root> perf opentrunking setState 1 NOTE: The command on page 2-9 has config.features.openTrunking functionality that is identical to this command. perf.openTrunking.show Syntax show portNumber This command displays the current OpenTrunking configuration per Purpose port. This command has one parameter: Parameters portNumber Specifies the port number.
  • Page 182: Perf.opentrunking.unrescongestion

    perf Unresolved The current enabled/disabled state of the Congestion 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 The current threshold setting of the Low Threshold...
  • Page 183: Perf.preferredpath

    perf 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.
  • Page 184: Perf.preferredpath.clearpath

    perf perf.preferredPath.clearPath Syntax clearPath destDomainID sourcePort This command deletes a preferred path. The command causes the Purpose 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.
  • Page 185: Perf.preferredpath.setpath

    perf perf.preferredPath.setPath Syntax setPath destDomainID sourcePort exitPort This command sets a preferred exit port, given the destination Purpose 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.
  • Page 186: Perf.preferredpath.setstate

    perf perf.preferredPath.setState Syntax setState enabledState This command enables or disables the preferred path feature. Purpose NOTE: Insistent domain IDs must be used in order to enable the preferred path state. This command has one parameter: Parameters enabledState Sets the state of the preferred path feature.
  • Page 187 perf This command has the following parameters: 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 188: Perf.preferredpath.showstate

    perf The following examples show the output returned by the three Command and Output Examples methods of specifying the perf.preferredPath.showPath command. Single values for both parameters Root> perf preferredPath showPath 21 10 Preferred Path State: Enabled Preferred Exit Port: Not Configured destDomainId set to all Root>...
  • Page 189 perf You can configure a maximum of 16 threshold alerts, including both counter threshold alerts (CTAs) and throughput threshold alerts (TTAs). Each of these types of alerts have commands that are specific to the alert type. • Counter threshold alerts: These are alerts that are triggered by counts of events.
  • Page 190 perf • on page 2-153 perf.thresholdAlerts.counter.setParams • on page 2-154 perf.thresholdAlerts.counter.show • on page 2-154 perf.thresholdAlerts.counter.showStatisticTable 4. Once the alert is fully configured, activate the alert using the command described on 2-156. To perf.thresholdAlerts.setState modify an alert you will need to disable it first. Activating a Throughput Threshold Alert In order to activate a throughput threshold alert using the CLI, you must enter certain commands in the specified sequence:...
  • Page 191: Throughput Threshold Alerts

    perf Alert Types and Counters Table 2-2 provides a list of throughput threshold alerts. Throughput Threshold Alerts Table 2-2 Utilization Code Threshold Alert Type Tx Util TTA - Transmit Utilization Rx Util TTA - Receive Utilization Tx/Rx Util TTA - Transmit or Receive Utilization Table 2-3 provides a list of threshold alert counters and counter sets.
  • Page 192 perf Table 2-3 Alert Counters (Continued) Number Threshold Alert Counter or Counter Set Class2RejectedFrames Class3DiscardedFrames Physical Link Errors Set Link Sequence Counts Set Logical Link Errors Set (see below) LIPs Detected (Sphereon 4300 and Sphereon 4500 switches only) LIPs Generated (Sphereon 4300 and Sphereon 4500 switches only) Some of the threshold alerts consist of groups of related items called Description of...
  • Page 193: Perf.thresholdalerts.counter.addalert

    perf • Class 2 Busied Frames • Class 2 Rejected Frames • Class 3 Discarded Frames perf.thresholdAlerts.counter.addAlert Syntax addAlert name This command configures a new counter threshold alert and assigns Purpose it a name. The new alert is assigned default settings which can then be changed using the other counter threshold alert commands.
  • Page 194: Perf.thresholdalerts.counter.addport

    perf perf.thresholdAlerts.counter.addPort Syntax addPort name portNumber This command adds a port to the specified counter threshold alert. Purpose NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. This command has the following parameters: Parameters name...
  • Page 195: Perf.thresholdalerts.counter.removeport

    perf Command Example Root> perf thresholdAlerts counter addPort checklinks 12 perf.thresholdAlerts.counter.removePort Syntax removePort name portNumber This command removes a port from the specified counter threshold Purpose alert. NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command.
  • Page 196 perf with the threshold alert name created using the command. perf.thresholdAlerts.counter.addAlert NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. This command has the following parameters: Parameters name The name of a counter threshold alert as...
  • Page 197: Perf.thresholdalerts.counter.setparams

    perf perf.thresholdAlerts.counter.setParams Syntax setParams name increment interval This command sets the increment and interval times for a specified Purpose counter threshold alert. NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. This command has the following parameters: Parameters name...
  • Page 198: Perf.thresholdalerts.counter.show

    perf perf.thresholdAlerts.counter.show Syntax show name This command displays the settings for an individual counter Purpose threshold alert. This command has one parameter: Parameters name The name of a threshold alert as defined by the command perf.thresholdAlerts.counter.addAlert, described on 2-149. You can specify all instead of a name, which means that all threshold alerts are displayed.
  • Page 199: Perf.thresholdalerts.deletealert

    perf Command Example Root> perf threshAlerts counter showStatisticTable The output from the perf.thresholdAlerts.counter.showStatisticTable Output Example command appears as follows: NumberCounter or Counter Set ---------------------------- 1 Link Resets Sent 2 Link Resets Received 3 OLS Sent 4 OLS Received 5 Link Failures 6 Sync Losses 7 Signal Losses 8 Protocol Errors...
  • Page 200: Perf.thresholdalerts.setstate

    perf Command Example Root> perf thresholdAlerts deleteAlert checklinks perf.thresholdAlerts.setState Syntax setState name enabledState This command enables or disables specified threshold alert. Purpose This command has the following parameters: Parameters name The name of a threshold alert as defined by the commands perf.thresholdAlerts.counter.addAlert perf.thresholdAlerts.throughput.addAlert.
  • Page 201 perf Tx/Rx Util TTA - Transmit or Receive Utilization Link Resets Sent CTA - Link Resets Sent Link Resets CTA - Link Resets Received Received OLS Sent CTA - OLS Sent OLS Received CTA - OLS Received Link Failures CTA - Link Failures Sync Losses CTA - Sync Losses Signal Losses...
  • Page 202: Perf.thresholdalerts.throughput.addalert

    perf LIPs Detected CTA - Loop Initialization Primitive Detected LIPs Generated CTA - Loop Initialization Primitive Generated State The enabled state of the CTA. Either enabled or disabled. Output Example Name Type State ---------------------------------------------------- ----------------- -------- Throughput Threshold #1 Rx Util Enable Threshold for CRC CRC Errors...
  • Page 203: Perf.thresholdalerts.throughput.addport

    perf This command has one parameter: Parameters 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.
  • Page 204: Perf.thresholdalerts.throughput.removeport

    perf This command has the following parameters: Parameters name The name of a throughput threshold alert as defined by the command perf.thresholdAlerts.throughput.addAlert, described on 2-158. portNumber Specifies the port number or port type. Valid values are either a single port number, all ports, or port type.
  • Page 205: Perf.thresholdalerts.throughput.setutiltype

    perf NOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this command. This command has the following parameters: Parameters name The name of a throughput threshold alert as defined by the command perf.thresholdAlerts.throughput.addAlert, described on 2-158.
  • Page 206: Perf.thresholdalerts.throughput.setutilpercentage

    perf This command has the following parameters: Parameters name The name of a throughput threshold alert as defined by the command perf.thresholdAlerts.throughput.addAlert, described on 2-158. utilizationType The type of traffic that triggers the alert. Enter the number that corresponds to the desired utilization type: 1 - Transmit Traffic (Tx) 2 - Receive Traffic (Rx)
  • Page 207: Perf.thresholdalerts.throughput.setparams

    perf perf.thresholdAlerts.throughput.setParams Syntax setParams name duration interval This command sets the name, duration, and interval for a specified Purpose throughput threshold alert. It also enables you to configure an alert to be sent when the following two events occur at the same time. •...
  • Page 208: Perf.thresholdalerts.throughput.show

    perf perf.thresholdAlerts.throughput.show Syntax show name This command displays the settings for an individual throughput Purpose threshold alert. This command has one parameter: Parameters name The name of a throughput threshold alert as defined by the command perf.thresholdAlerts.throughput.addAlert, described on 2-158. You can also specify all instead of a name, to display all threshold alerts.
  • Page 209: Perf.traffic

    perf This command has no parameters. Parameters Command Example Root> perf thresholdAlerts throughput showUtilTypeTable The output from the perf.thresholdAlerts.throughput.showUtilTypeTable Output Example command appears as follows: NumberUtilization Type ---------------------------- 1 Transmit Traffic (Tx) 2 Receive Traffic (Rx) 3 Both (Tx/Rx) perf.traffic Syntax traffic portNumber This command displays port traffic counters for a specified port.
  • Page 210 perf RxFrames The number of Fibre Channel Class 2 and Class 3 frames that the port has received. TxFrames The number of Fibre Channel Class 2 and Class 3 frames that the port has transmitted. RxWords The number of 4-byte words in Class 2 and Class 3 frames that the port has received.
  • Page 211: Show

    show 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.
  • Page 212: Show.auditlog

    show • show.features • show.security.portbinding • show.security.switchbinding • show.security.fabricbinding • show.openTrunking.config • show.thresholdAlerts.alerts • show.fabric.topology • show.fabric.nodes • show.security.switchACL • show.ficonCUPZoning • show.FencingPolicies show.auditLog Syntax auditLog [clear] This command displays the entries of the audit log after the last time Purpose the log was cleared.
  • Page 213: Show.epframelog.config

    show Output Example Date/Time Action Source User Id ---------- ----------- ------- ------------- 11/24/03 04:18P Switch set online 172.16.22.23 11/24/03 03:38P Switch name modifiedCLI 172.16.22.23 11/24/03 03:38P Switch set offline 172.16.22.23 11/24/03 11:27A Firmware downloaded Web 172.60.5.40 show.epFrameLog.config Syntax config This command shows the current embedded port frame log settings. Purpose This command has no parameters.
  • Page 214: Show.epframelog.disabletrigger

    show End Bit Pattern The bit pattern that triggers the logging to end. Start Condition True if the start condition was met. End Condition Met False if the end condition was not met. Command Example Root> show EPFrameLog config Filter Class F Frames: Disabled Filter Port: Start Offset:...
  • Page 215: Show.epframelog.setfilterport

    show This command has one optional parameter. If no parameters are Parameters entered, it will show the current state. Specifies the on/off state. Valid values are filterstate enable and disable. Boolean 1 and 0 values may also be substituted. Command Example Root>...
  • Page 216: Show.epframelog.nowrap

    show show.epFrameLog.noWrap Syntax noWrap [clear] This command displays the contents of the non-wrapping region of Purpose the FC2 frame log. Specifying the optional keyword clear removes all entries from the non-wrapping region of the log. The log entries will not persist over IMLs or power cycles; it will not be stored in NV RAM.
  • Page 217: Show.epframelog.settrigger

    show The output of the show.epFrameLog.nowrap command appears as Output Example follows: Count Date/Time Port # Direction SOF Payload Size ------ --------------- ------ --------- --- --- ------------ 11/24/03 11:30A 39 2112 Header: 22000026 000000EF E1000000 00000000 FFFF0000 00000000 00010203 04050607 08090A0B 0C0D0E0F 10111213 14151617 18191A1B 1C1D1E1F 11/24/03 11:30A 38 2112 Header: 22000026 000000EF E1000000 00000000 FFFF0000 00000000...
  • Page 218: Show.epframelog.wrap

    show show.epFrameLog.wrap Syntax wrap [clear] This command displays the contents of the wrapping region of the Purpose FC2 frame log. Specifying the optional keyword clear clears all entries from both the wrapping and the non-wrapping regions of the log. The log entries will not persist over IMLs or power cycles, and will not be stored in NV RAM.
  • Page 219: Show.eventlog

    show The output of the show.epFrameLog.wrap command appears as Output Example follows: Count Date/Time Port # Direction SOF Payload Size ------ --------------- ------ --------- --- --- ------------ 11/24/03 11:30A 39 2112 Header: 22000026 000000EF E1000000 00000000 FFFF0000 00000000 00010203 04050607 08090A0B 0C0D0E0F 10111213 14151617 18191A1B 1C1D1E1F 11/24/03 11:30A 38 2112 Header: 22000026 000000EF E1000000 00000000 FFFF0000 00000000...
  • Page 220: Show.fabriclog.nowrap

    show Severity The severity of the event. The values are: Major—Unit operational (major failure). Minor—Unit operational (minor failure). Severe—Unit not operational. The causes are either that the switch contains no operational SBAR cards or that the system shuts down due to CTP thermal threshold violations.
  • Page 221: Show.fabriclog.wrap

    show This command displays the following data: Output Count A constantly incrementing counter. Date/Time The date and time of the log entry. Description A description of the log entry. Data Extended data that is associated to the log entry. The output of the show.fabricLog.noWrap command appears as Output Example follows: Count...
  • Page 222: Show.fabric.nodes

    show This command has one optional parameter. If no parameter is Parameters specified, then the 1000 entries of the log will be displayed. Removes all entries from the log. clear Command Example show fabricLog Wrap This command displays the following data: Output Count A constantly incrementing counter.
  • Page 223: Show.fabric.principal

    show This command has no parameters. Parameters Command Example Root> show fabric nodes The data is displayed as a table that includes the following Output properties: Domain ID Domain ID of the switch to which the device is attached. Node WWN The WWN of the fabric attached node.
  • Page 224: Show.fabric.topology

    show show.fabric.topology Syntax topology This command displays a text description of the fabric. The principal Purpose switch in the fabric will have a "*" next to it. This command has no parameters. Parameters Command Example Root> show fabric topology The features data is displayed as a table that includes the following Output properties.
  • Page 225: Show.fabric.traceroute

    show show.fabric.traceRoute Syntax traceRoute source destination This command retrieves the route between two nodes in the fabric. Description This command has two parameters: Parameters source The source port for the trace route. This can be either a Port ID or a WWN. destination The destination port for the trace route.
  • Page 226 show Ingress Port Num The Ingress Port Num taken by the trace route. Egress Port WWN The Egress Port WWN taken by the trace route. Egress Port Num The Egress Port Num taken by the trace route. Direction The direction the trace route was going for the specified entry.
  • Page 227: Show.features

    show Domain ID: Ingress Port WWN: 20:0F:08:00:88:A0:B0:9C Ingress Port Num: Egress Port WWN: 20:12:08:00:88:A0:B0:9C Egress Port Num: Direction: Destination to source Entry 4 Switch WWN: 10:00:08:00:88:22:33:44 Domain ID: Ingress Port WWN: 20:1B:08:00:88:22:33:44 Ingress Port Num: Egress Port WWN: 20:17:08:00:88:22:33:44 Egress Port Num: Direction: Destination to source Entry 5...
  • Page 228: Show.fencing.policies

    show The features data is displayed as a table that includes the following Output properties: Installed Feature 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.
  • Page 229: Show.ficoncupzoning

    show The data is displayed as a table that includes the following Output properties: Name The name of the policy. This will be concatenated to 50 characters in the summary display. The policy full name will be shown in comma-delim mode. Ports The ports to which the fencing policy will be applied.
  • Page 230: Show.ficonms

    show This command has no parameters. Parameters Command Example show ficonCUPzoning The data is presented as a table with the following properties: Output FICON CUP The enabled state of the FICON CUP Zoning Zoning State feature Host Control List List of 0-8 control hosts, displays “empty” for control host list with no members.
  • Page 231: Show.frus

    show show.frus Syntax frus This command displays information about all field-replaceable units Purpose (FRUs). This command has no parameters. Parameters Command Example Root> show frus The FRU information is displayed as a table that includes the Output following properties: The FRU name. (This may show Unknown or Not Installed if the FRU is not installed.) Position The relative position of the FRU, that is, its slot.
  • Page 232: Show.ip.ethernet

    show Power Active 470-000399-700 223456789 Active 470-000399-700 223456789 show.ip.ethernet Syntax ethernet This command displays Ethernet attributes. Purpose This command has no parameters. Parameters Command Example Root> show ip ethernet The Ethernet attributes data is displayed as a table that includes the Output following properties: IP Address...
  • Page 233: Show.loginserver

    show This command has one optional parameter: Parameters This optional parameter causes all link incident clear log entries to be cleared. Command Example Root> show linkIncidentLog The event log data are displayed as a table that includes the following Output properties: Date/Time The date and time when the event occurred.
  • Page 234: Show.nameserver

    show The device information is displayed as a table that includes the Output following properties: Port The port number where the device is attached. BB Crdt The Buffer to buffer credit (BB_Credit). The maximum number of remaining frames that can be transmitted without causing a buffer overrun condition at the receiver.
  • Page 235 show more than one device per port for any public loop devices attached to an FL_Port. This command has no parameters. Parameters Command Example Root> show nameServer The device information data is displayed as a table that includes the Output following properties: Type The type of the port (N, NL, F/NL, F, FL, E, B).
  • Page 236: Show.nameserverext

    show Type Port Id Port Name Node Name FC4 Types ---- ------- ----------------------- ----------------------- --------- 010400 00:11:22:33:44:55:66:77 20:11:22:33:44:55:66:77 010500 00:11:22:33:44:55:66:78 20:11:22:33:44:55:66:78 010600 00:11:22:33:44:55:66:79 20:11:22:33:44:55:66:79 010700 00:11:22:33:44:55:66:80 20:11:22:33:44:55:66:80 010800 00:11:22:33:44:55:66:81 20:11:22:33:44:55:66:81 010900 00:11:22:33:44:55:66:82 20:11:22:33:44:55:66:82 010C00 00:11:22:33:44:55:66:83 20:11:22:33:44:55:66:83 010D00 00:11:22:33:44:55:66:84 20:11:22:33:44:55:66:84 010E00 00:11:22:33:44:55:66:85 20:11:22:33:44:55:66:85 010F00...
  • Page 237: Show.npiv.config

    show This command has no parameters. Parameters Command Example Root> show nameServerExt The device information data is displayed as a table that includes the Output following properties: Type The type (N, NL, F/NL, F, FL, E, B). Port Id The 24-bit Fibre Channel address. Port Name The port WWN of the attached device.
  • Page 238: Show.opensysms.config

    show NOTE: The command on page 2-24 has functionality that is config.NPIV.show identical to this command. This command has no parameters. Parameters Command Example Root> show NPIV config This command displays the following NPIV configuration data: Output NPIV state The current enabled/disabled state of the NPIV feature.
  • Page 239: Show.opentrunking.config

    show The configuration data is displayed as a table that includes the Output following properties: openSysMS State The Open System Management Server state. Host Control State The Open System Management Server Host Control state. Output Example openSysMS State: disable Host Control State: enable show.openTrunking.config Syntax config...
  • Page 240: Show.opentrunking.reroutelog

    show The output from the show.openTrunking.config command appears as Output Example follows: Unresolved Congestion: Enabled Backpressure: Disabled Low BB_Credit Threshold (%): 75 (default) Port Threshold % ---- ------------ 60 (default) 60 (default) 60 (default) show.openTrunking.rerouteLog Syntax reroutelog [clear] This command displays the Open Trunking Re-route Log Purpose information.
  • Page 241: Show.port.config

    show The device information data is displayed as a table that includes the Output following properties: Date/Time The date/time when the rerouting event occurred. The port associated with the flow that was rerouted. The target domain associated with the flow that was rerouted.
  • Page 242: Show.port.exit

    show The configured fabric address notification (FAN) state. (Sphereon 4300, Sphereon 4500, Sphereon 4400, and Sphereon 4700 switches only.) Type The port type as set in the config.port.type command. Speed The port speed as set in the config.port.speed command. Rx Crdts The number of Rx BB_Credits as set in the config.port.rxCredits command.
  • Page 243 show This command has the following parameters: Parameters destDomainId Specifies the destination domain ID. Valid domain IDs are in the range 1–31, or, use all to show all exit ports to and from the source port specified in the sourcePort parameter. sourcePort Specifies the number of the source port.
  • Page 244: Show.port.info

    show The following examples show the output returned by the three Command and Output Examples methods of specifying the show.port.exit command. Output with single values for both parameters Root> show port exit 21 10 Exit Port: Output with destDomainId set to all Root>...
  • Page 245: Show.port.nodes

    show The port information data is displayed as a table that includes the Output following properties: Port The port number. The WWN of the port. OpSpeed The current operating speed (1 Gb/s, 2 Gb/s, 4 Gb/s, or Not Established). SpeedCap The current transceiver capability speed (1 Gb/s, 2 Gb/s, or 4 Gb/s).
  • Page 246 show This command has one parameter: Parameters portNumber Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 0–23 for the Sphereon 4500 0-15 for the Sphereon 4400 0-31 for the Sphereon 4700 Command Example Root> show port nodes portNumber The port nodes data is displayed as a table that includes the following Output properties:...
  • Page 247: Show.port.opticdata

    show The show.port.nodes command output for a mix of public and private Output Example nodes on a loop appears as follows: FCAddr BB Crdt RxFldSz Port Name Node Name ------ ------- ------- ----------------------- ----------------------- 612902 00:11:22:33:44:55:00:77 20:11:22:33:44:55:66:77 612903 2112 00:11:22:33:44:55:00:77 20:11:22:33:44:55:66:77 612904 00:11:22:33:44:55:00:77...
  • Page 248: Show.port.opticedd

    show This command displays the following optic data: Output 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.
  • Page 249: Show.port.optichealth

    show This command has no parameters. Parameters Command Example Show port opticEDD The port optic diagnostic data is displayed as a table that includes the Output 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.
  • Page 250: Show.port.opticinfo

    show This command has no parameters. Parameters This command displays the following optic data: Output 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.
  • Page 251 show This command displays information about the optic. Purpose This command has no parameters. Parameters Command Example Root> show port opticInfo The port optic data is displayed as a table that includes the following Output properties: Port Number The port number. Tranceiver The transceiver type.
  • Page 252: Show.port.profile

    show 8,SFP,E2O COMMS INC ,36U1350 ,EM212-LP3TA-MT 15,4,07/03/03 Lot# 9,SFP,E2O COMMS INC ,35D2220 ,EM212-LP3TA-MT 15,4,05/16/03 Lot# 10,SFP,E2O COMMS INC ,36U1345 ,EM212-LP3TA-MT 15,4,07/03/03 Lot# 11,SFP,E2O COMMS INC ,36U3681 ,EM212-LP3TA-MT 15,4,07/04/03 Lot# 12,SFP,E2O COMMS INC ,3770978 ,EM212-LP3TA-MT 15,4,07/09/03 Lot# 13,SFP,E2O COMMS INC ,36U1338 ,EM212-LP3TA-MT 15,4,07/03/03 Lot# 14,SFP,E2O COMMS INC...
  • Page 253 show This command has one parameter: Parameters portNumber Specifies the port number. Valid values are: 0–11 for the Sphereon 4300 0–15 for the Sphereon 3016 0–23 for the Sphereon 4500 0-15 for the Sphereon 4400 0-31 for the Sphereon 4700 0–31 for the Sphereon 3032 0–31 for the ED-5000 0–63 for the Intrepid 6064...
  • Page 254: Show.port.showportaddr

    show Reason The reason that the port operational state is not “online”. Rx BB_Credits Then number of configured Rx BB_Credits. Connector Type Optic connector type. Transceiver Optic transceiver type. Distance Capability Optic distance capability. Media Type Optic media type. Speed Capability Optic speed capability.
  • Page 255 show NOTE: The on page 2-30 has functionality that is config.port.showPortAddr identical to this command. This command has no parameters. Parameters Command Example Root> show port showPortAddr The port configuration is shown as a table of properties. The Output following properties are displayed: Port The port number.
  • Page 256: Show.port.status

    show show.port.status Syntax status This command displays port status for all ports. Purpose This command has no parameters. Parameters Command Example Root> show port status The port status data is displayed as a table that includes the following Output properties: Port The port number.
  • Page 257 show Beaconing The beaconing state for the port (Off or On). Reason An optional message number that indicates whether the port has a segmented ISL, if a port binding violation has occurred, or if the port is inactive. The message description for this message number is provided at the bottom of the table.
  • Page 258 show Reason (cont.) If the operational state is Inactive only the following messages can be generated: • 24: Inactive - RC 0 • 25: No Serial Number • 26: Feature Not Enabled • 27: Switch Speed Conflict The output from the show.port.status command appears as follows: Output Example Port State Type...
  • Page 259: Show.port.technology

    show show.port.technology Syntax technology This command displays port technology information for all ports. Purpose This command has no parameters. Parameters Command Example Root> show port technology The port technology data is displayed as a table that includes the Output following properties: Port The port number.
  • Page 260: Show.preferredpath.showpath

    show show.preferredPath.showPath Syntax showPath destDomainID sourcePort This command displays the specified preferred path configuration Purpose and the actual path used by the system. The output shows both the exit port as configured for the preferredPath feature and the actual exit port currently being used for traffic. Use all for one of the command’s parameters to display all configured and actual exit ports for either the destination domain ID or the specified source port.
  • Page 261 show The output from the show.preferredPath.showPath command includes Output the following parameters: Destination The destination domain ID to which a preferred Domain 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.
  • Page 262: Show.preferredpath.showstate

    show sourcePort set to all Root> show preferredPath showPath 1 all Preferred Path State: Enabled Source Port Preferred Exit Port Actual Exit Port ------------------ ------------------- ---------------- No Source No Path show.preferredPath.showState Syntax showState This command displays the state of the preferred path. Purpose This command has one parameter: Parameters...
  • Page 263: Show.security.log

    show The fabric binding configuration data is displayed as a table that Output includes the following properties: Domain ID The domain ID of the Fabric Binding Membership List (FBML) member. Valid domain IDs range from 1 to 239. The world wide name (WWN) of the FBML member in colon-delimited hexadecimal notation.
  • Page 264: Show.security.portbinding

    show The security log data are displayed as a table that includes the Output 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.
  • Page 265: Show.security.switchacl

    show This command has no parameters. Parameters Command Example Root> show security portBinding The port binding configuration data is displayed as a table that Output includes the following properties: Port The port number. WWN Binding The state of port binding for the specified port (active or inactive).
  • Page 266: Show.security.switchbinding

    show The data is displayed as a table that includes the following Output 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.
  • Page 267: Show.snmp.accesstable

    show The output from the show.security.switchBinding command appears as Output Example 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 accessTable [index] This command displays the configured values for the Access Table. Purpose This command has one optional parameter. Parameters Command Example Root>...
  • Page 268: Show.snmp.targettable

    show 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: Security Model: Security Level: None Group Name: group1 Read View: fcmgmt_3_1...
  • Page 269: Show.snmp.usertable

    show If the optional parameter, index, is specified, the output from this command contains the following information: SNMPv3 State Indicates the status of SNMPv3 (Enabled or Disabled). Index The index number. Target IP The trap recipient IP. UDP Port The UDP port for the trap recipient Community The community name.
  • Page 270: Show.snmp.v3Grouptable

    show This command displays the following switch configuration data: Output 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.userTable command appears as Output Example follows: SNMPv3 State:...
  • Page 271: Show.snmp.viewtable

    show This command displays the following switch configuration data: Output 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 Output Example follows: SNMPv3 State:...
  • Page 272: Show.snmp.config

    show The output from the show.snmp.viewTable command appears as Output Example follows: View Name Type Object ID -------------------------------- ------------------ --------- no_access View Excluded .1.3.6.1 internet View Included .1.3.6.1 management View Included .1.3.6.1.2 experimental View Included .1.3.6.1.3 private View Included .1.3.6.1.4 snmpv3 View Included .1.3.6.1.6...
  • Page 273 show The switch configuration data is displayed as a table that includes the Output following properties: SNMP Agent State Displays the state of the SNMP agent. If it is disabled, then the SNMP state will not respond to any requests, nor will it produce any traps.
  • Page 274: Show.switch

    show show.switch Syntax switch This command displays the switch attributes. Purpose This command has no parameters. Parameters Command Example Root> show switch The switch attributes data is displayed as a table that includes the Output following properties: State The state of the switch (for example, online or offline).
  • Page 275 show Interop Mode The interoperability mode as set in the config.switch.interopMode command. For more information, see config.switch.interopMode page 2-98. Active Domain The active domain ID of the switch or director. This ID may or may not be the same as the preferred domain ID.
  • Page 276: Show.system

    show API Enable The enabled state of API. API Management IP address for of where the application that is managing the switch or director resides. If there is no application managing the switch, this will be the IP address of the switch. HA Mode The enabled state of HA mode.
  • Page 277 show The system attributes are displayed as a table that includes the Output following properties. Name The system name. For more information, see on page 2-112. config.system.name Contact The system contact as set in the config.system.contact command. For more information, see on page 2-107.
  • Page 278: Show.syslog

    show Serial Number: 82420481 Type Number: 006064 Model Name: ED-6064 Model Number: EC Level: 1011231 Firmware Version: 04.01.00 Build 23 Beaconing: Disabled show.syslog syslog Syntax This command displays the syslog configuration Purpose This command has no parameters. Parameters The syslog configuration is shown as a table of properties. The Output following properties are displayed: The index number of the server.
  • Page 279: Show.thresholdalerts.alerts

    show show.thresholdAlerts.alerts Syntax alerts This command provides the name, type, and enabled state of each Purpose configured threshold alert, including both counter threshold alerts (CTAs) and throughput threshold alerts (TTAs). This command has no parameters. Parameters Command Example Root> show thresholdAlerts alerts The threshold alert data appears as a table that includes the following Output properties:...
  • Page 280 show CRC Errors CTA - CRC Errors. Discarded Frames CTA - Discarded Frames. Frames Too Short CTA - Frames Too Short. Delimiter Errors CTA - Delimiter Errors. Address ID Errors CTA - Address ID Errors. Cls2 BusiedFrms CTA - Class 2 Busied Frames.
  • Page 281: Show.thresholdalerts.log

    show Safety #2 Logic Lnk Err Set Enabled Safety #1 Cls2 BusiedFrms Disabled show.thresholdAlerts.log Syntax log [clear] This command shows the contents of the threshold alert log. This log Purpose shows all the threshold alerts that have been triggered, including both counter threshold alerts (CTAs) and throughput threshold alerts (TTAs).
  • Page 282 show 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.
  • Page 283: Show.zoning

    show LIPS Generated 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.log command appears as Output Example follows: Date/Time Name...
  • Page 284 show 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 E/OS Command Line Interface User Manual...
  • Page 285: Error Messages

    Error Messages This appendix lists and explains error messages for the Command Line Interface (CLI). Any error numbers that are not listed are reserved for future use. The message that is returned is a string that includes the error number and the text of the message. Message Error 005: Busy The switch cannot process any requests at this time.
  • Page 286 Message Error 009: Invalid Switch Description The value entered for the switch Description is invalid. Description The description for the director or switch may contain 0–255 Action characters. Enter a description with 0–255 characters and re-submit. If spaces are used, enclose the description in quotation marks. Message Error 010: Invalid Switch Location The value entered for the switch location is invalid.
  • Page 287 The value entered for the port name is invalid. Description The port name for the individual port may contain 0–24 characters. Action Enter a name with 0–24 characters and re-submit. If spaces are used, enclose the name in quotation marks. Message Error 015: Invalid BB Credit The value entered for the buffer-to-buffer credit is invalid.
  • Page 288 Message Error 020: Invalid Preferred Domain ID The value entered for the preferred domain ID for the director or Description switch is invalid. The preferred domain ID must be an integer in the range 1–31. Enter Action an appropriate value and re-submit. Message Error 021: Invalid Switch Priority The value entered for the switch priority is invalid.
  • Page 289 Message Error 032: Invalid SNMP Community Name The value entered for the SNMP community name is invalid. Description The community name must not exceed 32 characters in length. Action Duplicate community names are allowed, but corresponding write authorizations must match. Enter an appropriate SNMP community name and re-submit.
  • Page 290 The format of the date parameter must be mm:dd:yyyy or Action mm/dd/yyyy. The month must contain an integer in the range 1–12. Enter an appropriate date and re-submit. Message Error 038: Invalid Day The value of the day entered for the new system date is invalid. Description The format of the date parameter must be mm:dd:yyyy or Action...
  • Page 291 The format of the time parameter must be hh:mm:ss. The second can Action contain an integer in the range 0–59. Enter an appropriate time and re-submit. Message Error 044: Max SNMP Communities Defined A new SNMP community may not be defined without removing an Description existing community from the list.
  • Page 292 Message Error 051: Invalid RADIUS Server Transmit Attempts Value The RADIUS server Retransmit value entered is invalid. Description Enter a valid Retransmit value. Valid values are 1 to 100. Action Message Error 052: Invalid RADIUS Server Deadtime Value The RADIUS server Deadtime entered is invalid. Description Enter a valid Deadtime value.
  • Page 293 Message Error 057: Duplicate Zone Two or more zone names in the zone set are identical. Description All zone names must be unique. Make the appropriate changes and Action re-submit. Message Error 059: Zone Name in Use Two or more zone names in the zone set are identical. Description All zone names must be unique.
  • Page 294 Message Error 064: Configuration changes have been limited to the API interface The API interface has restricted this interface from making Description configuration changes. To make configuration changes from this interface, the API interface Action will need to update to allow this interface to make changes. Message Error 065: Cannot remove the last CLI user with Administrator rights...
  • Page 295 The requested FRU is not installed. Description Consult the installation/service manual for this product for Action appropriate action. Message Error 072: No Backup FRU The FRU swap cannot be performed because a backup FRU is not Description installed. Insert a backup FRU and re-submit the request or consult the Action installation/service manual for this product for appropriate action.
  • Page 296 Reduce the number of members in one or more zones and re-submit Action the command. Message Error 077: Not Allowed While Port Is Failed The port selected is in a failed or inactive state, or is in need of Description service.
  • Page 297 Message Error 083: Not Allowed in Open Fabric Mode This request cannot be completed while this switch is operating in Description Open Fabric 1.0 mode. Configure the interop mode to McDATA Fabric 1.0 mode. Action Message Error 088: Invalid Feature Key Length The feature key installed is longer than the maximum length allowed.
  • Page 298 Message Error 094: Invalid Feature Combination The features requested cannot be installed at the same time on one Description switch or director. Contact your sales representative. Action Message Error 099: Preferred Domain ID Cannot Be Zero This product cannot be configured to have a preferred domain ID Description equal to zero (0).
  • Page 299 The request cannot be completed because a system diagnostic is Description running. Wait for the diagnostic to complete. Action Message Error 105: Max Threshold Definitions Reached The maximum number of total threshold alerts has already been Description reached. Remove a threshold alert before adding the new threshold alert. A Action total of 16 counter and throughput threshold alerts is allowed.
  • Page 300 Message Error 110: Invalid Percent Utilization The type of the throughput threshold alert has not been set. Description Set the type of the TTA, then try to activate the alert. Action Message Error 111: Invalid Threshold Type The type of the threshold alert is not valid. Description Configure the type of the throughput threshold alert to one of the Action...
  • Page 301 This request cannot be completed because the requested port speed is Description faster than the currently-configured switch speed. The switch speed should first be configured to accommodate changes Action in the configured port speed. The ports cannot operate at a faster rate than the switch, itself.
  • Page 302 Message Error 134: Invalid Membership List Generic message to indicate a problem in either the switch binding or Description fabric binding membership list. Be sure that the membership list submitted does not isolate a switch Action 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 303 The switch binding state submitted is not recognized by the CLI. Description The switch binding state must be set to one of the following: disable, Action erestrict, frestrict, or allrestrict. See config.security.switchBinding page 2-66 for clarification on these states. Message Error 139: Insistent Domain ID's Must Be Enabled When Fabric Binding Active The user attempted to disable insistent domain IDs while fabric...
  • Page 304 The domain RSCN state must be set to either enable or disable. For Action more information, see on page 2-96. config.switch.domainRSCN Message Error 143: Domain RSCNs Must Be Enabled When Enterprise Fabric Mode Active The user attempted to disable domain RSCN's while enterprise fabric Description mode was active.
  • Page 305 Message Error 149: Not Allowed While Enterprise Fabric Mode Enabled and Switch Active The request cannot be completed while the switch is online and Description enterprise fabric mode is Active. This operation will be valid if the switch state is set to offline and Action enterprise fabric mode to inactive.
  • Page 306 Make sure that the WWN deleted matches the WWN in the Switch Action Binding Membership List. Make appropriate changes and re-submit the request. Message Error 155: Cannot Remove Active Member From List This member cannot be removed from the fabric security list because Description it is currently logged in.
  • Page 307 Make sure the IP addresses are valid and the first IP is lower than the Action second. Message Error 159: Invalid IP Access Control List Pairs Count Value The list being activated has an invalid number of IP pairs. Description Make sure there is at least one IP address in the Access Control List.
  • Page 308 Install the FICON CUP zoning feature key. Action Message Error 166: CUP Zoning feature must be enabled The command cannot be completed with the CUP Zoning feature Description enabled. Enable FICON CUP Zoning. Action Message Error 167: Diagnostics can not be run on inactive port The port is in the inactive state and diagnostics cannot be run.
  • Page 309 Enter a unique username using only the allowed characters and Action proper length. Message Error 172: Invalid list size The number of entries in the list is invalid. Description Make sure the list has at least one entry. Action Message Error 173: Invalid value The value being entered is invalid.
  • Page 310 Add a new Administrator and then try again. Action Message Error 178: Invalid password The entered password is invalid. Description Enter a password using valid characters and a proper length. Action Message Error 179: Insistent Domain IDs must be enabled To complete this command, Insistent Domain IDs must be enabled.
  • Page 311 Message Error 184: Invalid Fencing Policy Time Period The entered period is invalid. Description Enter a valid period. Action Message Error 185: Invalid Limit Value for this Fencing Policy Type The entered limit is invalid. Description Enter a valid limit. Action Message Error 186: Cannot Block this Port...
  • Page 312 Message Error 190: Invalid Fencing Policy Port Type Invalid fencing policy port type. Description Enter a valid port or port type. Action Message Error 191: Max Fencing Policy Definitions Reached A new port fencing policy may not be defined without removing an Description existing port fencing policy from the list.
  • Page 313 Two policies of the same type cannot be enabled if they have the Description same port type. Make sure the policy that is being enabled doesn't have the same port Action type as a policy that is enabled. Message Error 196: Cannot enable two policies of the same type that contain default scope Two policies of the same type cannot be enabled if they are both Description...
  • Page 314 Be sure all parameters have been entered correctly and re-submit. Action Contact your service representative with further problems. Message Error 203: Another Client Has Change Authorization Another user is currently making changes to this switch. Description Be sure all parameters have been entered correctly and re-submit. Action Message Error 207: Change Request Failed...
  • Page 315 Message Error 211: Duplicate Zone Two or more zone names in the local zone set are identical. Description All zone names must be unique. Make the appropriate changes and Action re-submit. Message Error 212: Duplicate Zone Member A member was added that already exists in the zone. Description No action necessary.
  • Page 316 There are no attached nodes. Description To add more members, attach more devices to the switch or add the Action members by WWN or Domain ID and port. Message Error 217: All Attached Nodes are in the Zone All the attached nodes are already in the zone. Description To add more members, attach more devices to the switch or add the Action...
  • Page 317 Diagnostics cannot be run on an active E Port. Description Block the port to run diagnostics. Action Message Error 222: Invalid SNMP Community Index The value entered for the SNMP community index is invalid. Description The SNMP community index must be an integer in the range 1–6. Action Make the appropriate changes and re-submit the command.
  • Page 318 The community name must not exceed 32 characters in length. Action Duplicate community names are allowed, but corresponding write authorizations must match. Enter an appropriate SNMP community name and re-submit. Message Error 228: Invalid Write Authorization Argument The writeAuthorization parameter does not contain a valid value. Description Parameters must be typed exactly to specification to be recognized Action...
  • Page 319 For the appropriate parameters, see the section of the manual that Action corresponds to the attempted command. Parameters must be typed exactly to specification to be recognized correctly by the CLI. Message Error 233: Invalid Member The zone member added is not valid. Description For the appropriate parameters, see the section of the manual that Action...
  • Page 320 manual that corresponds to the attempted command. Enter the complete command and re-submit. Message Error 237: Invalid Zoning Database There was an unidentifiable problem in the local zone set work area. Description Verify all parameters are entered correctly and re-submit. Otherwise, Action the pending zone set should be cleared and reconstructed.
  • Page 321 Some commands require that comma-delimited mode be active (e.g. Action 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 This operation is not allowed while the switch is in Enterprise Fabric Description Mode and the switch is Online.
  • Page 322 Message Error 249: At least one port or port type must be added to this threshold alert A port or port type must be assigned to an alert before it is enabled. Description Use the command on page 2-150 to Action perf.thresholdAlerts.counter.addPort add a port before the alert is enabled.
  • Page 323 Message Error 255: Invalid throughput threshold alert name The name of the threshold alert is incorrect. Description Either the name does not exist, or the new name cannot be used Action because it is illegal or a duplicate. Message Error 256: Invalid utilization type number The utilization type number does not exist.
  • Page 324 Message Error 261: No Attached Members Exist There are no members attached to the switch. Description Check all connections and make sure attached devices are present. Action Message Error 262: All Attached Members are in the Membership List All attached fabric members are already in the membership list. Description This action is redundant, all members are already in the list.
  • Page 325 The fabric is still building, wait a couple of seconds until it is Action complete. Message Error 268: RADIUS key too long The desired RADIUS key is too long. Description Use a shorter RADIUS key. Action Message Error 269: Invalid retransmit attempts. Must be between 1 and 100 The desired retransmit attempt value is invalid.
  • Page 326 Re-enter the command and enter matching passwords. Action Message Error 274: Invalid interface combination The desired interface is not a valid interface. Description Select a valid interface value. Action Message Error 275: Invalid authentication role The desired role is not a valid role. Description Select a valid role.
  • Page 327 Select a valid zone member. Action Message Error 281: Zone doesn't exist The desired zone doesn't exist. Description Select a valid zone name. Action Message Error 282: Conflicting Domain ID for the specified WWN The desired Domain ID is already in use. Description Select a different Domain ID.
  • Page 328 The desired value for NPIV allowed logins is invalid. Description Select a value between 1 and 256. Action Message Error 287: Port is unaddressable The desired port cannot be configured because it is unadressable. Description This operation is not supported. No action necessary. Action Message Error 288: The NPIV feature key must be installed...
  • Page 329 Select a different port number. Action Message Error 294: Invalid RADIUS Index The specified RADIUS index is invalid. Description Enter a valid RADIUS index. Valid indexes are 1 to 3. Action Message Error 295: Invalid MIHPTO value The MIHPTO value is invalid. Description Enter a valid MIHPTO value.
  • Page 330 Message Error 299: Chap secret not defined The Chap secret must be defined (for Open Systems Management Description Server before enabling Outgoing Authentication.) Define a Chap Secret (for Open Systems Management Server). Action Message Error 300: No user defined for this Interface You cannot perform the specified action unless a user is defined for Description the interface.
  • Page 331 Message Error 304: Radius Authentication Present. Cannot remove all Radius Servers You cannot remove all the RADIUS Server configurations if RADIUS Description Authentication is enabled on any interface. Disabled RADIUS Authentication on all interfaces and then remove Action the last RADIUS server configuration. Message Error 305: Operating mode is not OSMS You cannot enable CT Outgoing Authentication when Open Systems...
  • Page 332 You cannot perform this operation until the FICON Management Description Server is enabled. Enable the FICON Management Server. Action Message Error 311: FICON CUP Zoning must be disabled You cannot perform this operation until the FICON Management Description Server is disabled. Disable the FICON Management Server.
  • Page 333 The trigger end bit pattern is invalid. Description Select a valid trigger end bit pattern. Action Message Error 327: Invalid trigger The trigger is invalid. Description Enter a valid trigger value. Action Message Error 328: Invalid syslog index The syslog index is invalid. Description Select a valid syslog index.
  • Page 334 Enter a valid Port ID. Action Message Error 336: Invalid SSL renegotiation megabyte value The SSL renegotiation megabyte value is invalid Description Enter a valid SSL renegotiation megabyte value Action Message Error 337: Invalid SNMP table index The SNMP table index is invalid Description Select a valid index.
  • Page 335 Message Error 343: Invalid SNMPv3 privacy protocol The privacy protocol is invalid. Description Select a valid privacy protocol. Action Message Error 344: Invalid SNMPv3 privacy key The privacy key is invalid. Description Select a valid privacy key. Action Message Error 345: Invalid SNMPv3 target table index The target table index is invalid.
  • Page 336 Message Error 349: Invalid SNMPv3 MP model The MP model is invalid. Description Enter a valid MP model. Action Message Error 350: Invalid SNMPv3 security name The security name is invalid. Description Enter a valid security name. Action Message Error 351: Invalid SNMPv3 group name The group name is invalid.
  • Page 337 The number of days for the key generation is invalid. Description Enter a valid number of days for key generation. Action Message Error 361: An internal error occurred when generating the key. An error occurred while generating the SSL key. Description None Action...
  • Page 338 The HA mode cannot be set. Description Contact your service representative. Action Message 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. Description None Action Message Error 373: Configuration not allowed while SNMPv3 is enabled...
  • Page 339 Message Error 378: Duplicate IP address The IP address already exists. Description Choose a different IP Address or remove the existing entry. Action Error Messages A-55...
  • Page 340 E/OS Command Line Interface User Manual A-56...
  • Page 341: Commands And Releases

    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.
  • Page 342 Table B-1 Commands and Releases First E/OS Release Command config.snmp.addV3Group config.snmp.addV3Target config.snmp.deleteAccessEntry config.snmp.setSNMPv3State config.snmp.deleteUserEntry config.snmp.deleteV3Group config.snmp.setSNMPv3State config.snmp.showAccessTable config.snmp.showTargetTable config.snmp.showUserTable config.snmp.showV3GroupTable config.snmp.showViewTable config.snmp.validateUser config.switch.apiState config.switch.haMode config.syslog config.syslog config.switch.webState config.switch.apiState con.sw.safe zoning config.switch.islFSPFCost config.syslog config.syslog.addServer config.syslog.deleteServer config.syslog.setLogConfig E/OS Command Line Interface User Manual...
  • Page 343 Table B-1 Commands and Releases First E/OS Release Command config.syslog.setState config.syslog.show config.system.contact show.epFrameLog.disableTrigger show.epFrameLog.setTrigger show.fabric.traceRoute show.port.opticData show.port.opticHealth show.snmp.accessTable show.snmp.targetTable show.snmp.userTable show.snmp.V3GroupTable show.snmp.viewTable show.syslog config.features.NPIV config.fencing.addPolicy config.fencing.addPort config.fencing.deletePolicy config.fencing.removePort config.fencing.setParams config.fencing.setState config.fencing.show config.fencing.showTypeTable config.ficonCUPZoning.addControlHost config.ficonCUPZoning.deleteControlHost Commands and Corresponding Releases...
  • Page 344 Table B-1 Commands and Releases First E/OS Release Command config.ficonCUPZoning.setState config.ficonCUPZoning.show config.ficonMS.setMIHPTO config.ficonMS.show config.ip.lineSpeed config.NPIV.maxPortIDs config.NPIV.setState config.NPIV.show config.openSysMS.setHostCtrlState config.port.rxCredits config.port.show config.port.showPortAddr config.port.swapPortByAddr config.port.swapPortByNum config.security.authentication.interface.api.outgoing config.security.authentication.interface.api.sequence config.security.authentication.interface.cli.sequence config.security.authentication.interface.eport.outgoing config.security.authentication.interface.eport.sequence config.security.authentication.interface.nport.outgoing config.security.authentication.interface.nport.sequence config.security.authentication.interface.osms.outgoing config.security.authentication.interface.osms.setKey config.security.authentication.interface.serial.enhancedAuth config.security.authentication.interface.show E/OS Command Line Interface User Manual...
  • Page 345 Table B-1 Commands and Releases First E/OS Release Command config.security.authentication.interface.web.sequence config.security.authentication.port.override config.security.authentication.port.show config.security.authentication.RADIUS.attempts config.security.authentication.RADIUS.deadtime config.security.authentication.RADIUS.deleteServer config.security.authentication.RADIUS.server config.security.authentication.RADIUS.show config.security.authentication.RADIUS.timeout config.security.authentication.switch.setSecret config.security.authentication.user config.security.authentication.user.add config.security.authentication.user.delete config.security.authentication.user.modify config.security.authentication.user.role config.security.authentication.user.show config.security.ssh.resetKeys config.security.ssh.setState config.security.ssh.show config.security.switchAcl.addRange config.security.switchAcl.deleteRange config.security.switchAcl.setState config.security.switchAcl.show config.switch.apiState perf.preferredPath.showPath Commands and Corresponding Releases...
  • Page 346 Table B-1 Commands and Releases First E/OS Release Command perf.thresholdAlerts.show show.auditLog show.epFrameLog.config show.epFrameLog.filterClassFFrames show.epFrameLog.noWrap show.epFrameLog.setFilterPort show.epFrameLog.wrap show.fabricLog.noWrap show.fabricLog.wrap show.fabric.principal show.fencing.policies show.ficonCUPZoning show.ficonMS show.NPIV.config show.openSysMS.config show.port.config show.port.opticEDD show.port.opticInfo show.port.profile show.port.showPortAddr show.security.switchAcl show.security.log config.snmp.setFaMibVersion config.snmp.setState perf.preferredPath.clearPath E/OS Command Line Interface User Manual...
  • Page 347 Table B-1 Commands and Releases First E/OS Release Command perf.preferredPath.setPath perf.preferredPath.setState perf.preferredPath.showPath show.all show.fabric.nodes show.fabric.topology show.linkIncidentLog show.port.exit show.preferredPath.showPath show.syslog show.thresholdAlerts.log config.enterpriseFabMode.setState config.features.openTrunking config.ficonMS.setMIHPTO config.NPIV.maxPortIDs config.switch.ltdFabRSCN config.switch.webState perf.openTrunking.backPressure perf.openTrunking.congestionThresh perf.openTrunking.lowBBCreditThresh perf.openTrunking.setState perf.openTrunking.show perf.openTrunking.unresCongestion perf.thresholdAlerts show.openTrunking.config Commands and Corresponding Releases...
  • Page 348 Table B-1 Commands and Releases First E/OS Release Command show.openTrunking.rerouteLog config.features.enterpriseFabMode config.features.ficonMS config.features.installKey config.features.openSysMS config.features.show config.ip.ethernet config.ip.show config.port.blocked config.port.fan config.port.name config.port.show config.port.speed config.port.type config.security.fabricBinding config.security.portBinding config.security.switchBinding config.security.ssl.setAPIState config.snmp.authTraps config.snmp.deleteCommunity config.snmp.show config.switch config.switch.domainRSCN config.switch.edTOV config.switch.insistDomainId E/OS Command Line Interface User Manual...
  • Page 349 Table B-1 Commands and Releases First E/OS Release Command config.switch.interopMode config.switch.prefDomainId config.switch.priority config.switch.raTOV config.switch.rerouteDelay config.switch.show config.switch.speed config.system.date config.system.description config.system.location config.system.name config.system.show config.zoning.activateZoneSet config.zoning.addPortMem config.zoning.clearZone config.zoning.renameZoneSet config.zoning.clearZone config.zoning.renameZoneSet config.zoning.deactivateZoneSet config.zoning.deletePortMem config.zoning.renameZone config.zoning.renameZoneSet config.zoning.renameZone config.zoning.renameZoneSet config.zoning.replaceZoneSet Commands and Corresponding Releases...
  • Page 350 Table B-1 Commands and Releases First E/OS Release Command config.zoning.setDefZoneState config.zoning.showActive config.zoning.showPending maint.port.beacon maint.port.reset maint.system.beacon maint.system.clearSysError maint.system.ipl maint.system.resetConfig maint.system.setOnlineState perf.class2 perf.class3 perf.clearStats perf.errors perf.link perf.traffic show.eventLog show.features show.frus show.ip.ethernet show.loginServer show.nameServer show.nameServerExt show.port.config show.port.info E/OS Command Line Interface User Manual B-10...
  • Page 351 Table B-1 Commands and Releases First E/OS Release Command show.port.nodes show.port.status show.port.technology show.preferredPath.showState show.security.portBinding show.security.switchBinding show.switch show.system show.zoning Commands and Corresponding Releases B-11...
  • Page 352 E/OS Command Line Interface User Manual B-12...
  • Page 353 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.
  • Page 354 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 list of all devices that can access other devices across the network access control and the permissions associated with that access.
  • Page 355 Glossary buffer-to-buffer credit. BB_Credit In a director or switch, the attribute that when set, removes the blocked port communication capability of a specific port. A blocked port continuously transmits the offline sequence. Storage area for data in transit. Buffers compensate for differences in buffer processing speeds between devices.
  • Page 356 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. Nondedicated link. Typically used to describe a link between nodes connectionless which allows the switch to forward Class 2 or Class 3 frames as resources (ports) allow.
  • Page 357 Glossary A zone that contains all of the devices attached to a fabric that are not default zone members of at least one of the zones of the activated zone set. (1) Mechanical, electrical, or electronic hardware with a specific device purpose (D).
  • Page 358 Glossary With director or switch firmware version 1.2 (or later) installed, embedded web administrators or operators with a browser-capable PC and an server Internet connection can monitor and manage the director or switch through an embedded web server interface, called the EFCM Basic interface.
  • Page 359 Glossary FL_Port. A fabric port (F_Port) that contains arbitrated loop (AL) fabric loop port 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.
  • Page 360 Glossary field-replaceable unit. generic port. G_Port A multi-homed host used to route network traffic from one network gateway to another, and to pass network traffic from one protocol to another. (1) In transmission control protocol/Internet protocol (TCP/IP), a gateway address device that connects two systems that use the same or different protocols.
  • Page 361 Glossary (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. Message notifying a user that a function is performing normally or information message has completed normally.
  • Page 362 Glossary local area network. link incident. Physical connection between two devices on a switched fabric. A link link consists of two conductors, one used for sending and the other for receiving, thereby providing a duplex communication path. LIN. Interruption to link due to loss of light or other causes. See also link incident link incident alerts.
  • Page 363 Glossary A Fibre Channel fabric created by linking more than one director or multiswitch fabric fabric switching device within a fabric. node port. N_Port (1) In TCP/IP, see domain name server. (2) In Fibre Channel protocol, name server a server that allows node ports (N_Ports) to register information about themselves.
  • Page 364 Glossary When the switch or director is in the online state, all of the unblocked online state 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.
  • Page 365 Glossary In a network, any route between any two ports. path A form of server-level access control that uses configuration informa- persistent binding tion to bind a server to a specific Fibre Channel storage volume (or logical device), using a unit number. See also access control.
  • Page 366 Glossary R_A_TOV. R_A_TOV is a value used to time-out operations that resource allocation depend on the maximum possible time that a frame could be delayed time-out value in a fabric and still be delivered. storage area network; system area network. (1) Software application that is the system management framework SAN management providing the user interface for managing Fibre Channel switch...
  • Page 367 Glossary A computer that provides shared resources, such as files and printers, server 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 simple network (TCP/IP)-derived protocol governing network management and management monitoring of network devices.
  • Page 368 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. A device that connects, filters and forwards packets between local switch area network (LAN) segments or storage area network (SAN) nodes or devices.
  • Page 369 Glossary URL. A URL is the address of a document or other resource on the uniform resource Internet. locator A flexible 1 gigabit-per-second or 2 gigabit-per-second module that universal port module contains four generic ports (G_Ports). uniform resource locator. UDP. A connectionless protocol that runs on top of Internet protocol user datagram (IP) networks.
  • Page 370 Glossary g-18 E/OS Command Line Interface User Manual...
  • Page 371 Index configuring interface 2-36 Symbols configuring N port 2-38, 2-39 " 1-14 configuring Open Systems 2-39, 2-40 1-21 configuring outgoing 2-35 1-20 configuring port 2-42 configuring sequence 2-35 Numerics configuring serial 2-41 60 characters in history log 1-14 configuring Web 2-42 80-column output 1-15...
  • Page 372 Index help 1-20 unresolved 2-138 logging in or out 1-15 congestion threshold lost 2-126 OpenTrunking 2-135 navigation conventions connection loss, ethernet 1-23 output 1-15 conventions parameters 1-14 documentation purpose navigation root> prompt 1-12 used in manual xvii using counter data 2-128, 2-129 CLI commands, case sensitivity counter threshold alert...
  • Page 373 Index element managers delete member 2-57 enabling Telnet 1-23 online state functions 2-54 Embedded Frame Log pending configuration show configuration 2-169 activate 2-54 view 2-172, 2-174 add attached members 2-55 enable pending FBML access control list 2-65 show 2-58 OpenTrunking 2-136 replace pending 2-57...
  • Page 374 Index resetting 2-126 features keys preferred path 2-139 for feature sets fencing policies resetting 2-126 show 2-184 Fibre Alliance MIB SNMP 2-87 Latin-1 character set FICON limitations, history log 1-14 enabling management server limited fabric RSCN 2-99 FICON CUP link counters 2-133 show zoning 2-185...
  • Page 375 Index add member 2-55 passwords clear 2-56 format 1-15 switch binding 2-66 perf command 2-128 performance alerts 2-144 performance services 2-128 periods in command names name server 2-190, 2-192 physical link errors 2-148 names, for ports 2-27 port navigating the command tree 1-12 address, show 2-210...
  • Page 376 Index preferred domain ID 2-99 preferred path SANtegrity clear 2-140 Enterprise Fabric Mode 2-5, delete 2-140 scripting environments destination 2-142, 2-216 scripts, commenting 1-21 disable 2-142 secret enable 2-142 setting 2-47 feature overview 2-139 secrets set exit port 2-141 format 1-15 show 2-216...
  • Page 377 Index show SSH state 2-63 port optic 2-206 showing port 2-43 port optical diagnostics 2-204 showing RADIUS server 2-46 port status 2-212 showing state 2-41 port technology information 2-215 showing user 2-52 preferred path 2-216 switch binding 2-66 preferred path exit port 2-198 adding member 2-67...
  • Page 378 Index setting NPIV 2-24 showing LAN configuration 2-22 SNMP 2-87 speed 2-103 Zone Flex Pars 2-95 system contact 2-110 statistic table, threshold alert 2-154 system description 2-111 statistics, port, clearing 2-131 system location 2-111 strings, null 1-14 system name 2-112 strings, quotation marks in 1-14 system attributes, displaying...
  • Page 379 Index add alert 2-158 user access rights 1-15 trigger relationship to other products 1-17 percentage 2-162 user datagram protocol 2-78, 2-88 trigger type 2-161 using this manual utilization percentage 2-162 utilization type utilization type 2-161 threshold alert 2-161 utilization types 2-164 threshold alerts overview...
  • Page 380 Index zone set activating to fabric 2-113, 2-114 clearing 2-117 deactivating 2-117 renaming 2-120 replacing 2-121 temporary copy 2-113 zone sets and zones displaying 2-114 zoning configuring 2-113 FICON CUP 2-18, 2-19 show FICON CUP 2-185 Zone Flex Pars state 2-95 zoning configuration active, display...

Table of Contents