McDATA OPENconnectors Command Line Interace Manuale Utente

Enterprise Operating System Command Line Interface User ManualP/N 620-000134-720REV A

Enterprise Operating System Command Line Interface User Manual xContentsperf.thresholdAlerts.counter.setCounter ...2-123perf.t

22-56Enterprise Operating System Command Line Interface User Manual configconfig.security.fabricBinding.replacePendingSyntax replacePendingPurpose Thi

2CLI Commands2-57configconfig.security.fabricBinding.showPendingSyntax showPendingPurpose This command displays the pending FBML, which may not reflec

22-58Enterprise Operating System Command Line Interface User Manual configPurpose This command sets the port binding state for a given port. Parameter

2CLI Commands2-59configParameters This command has one parameter. Command ExampleRoot> config security portBinding show 4Output The port binding co

22-60Enterprise Operating System Command Line Interface User Manual configParameters This command has two parameters. portNumber Specified the port nu

2CLI Commands2-61configCommand Examples Root> config security portBinding wwn 4 AA:99:23:23:08:14:88:C1Root> config security portBinding wwn 4

22-62Enterprise Operating System Command Line Interface User Manual configParameters This command has no parameters.Command Exampleconfig security ssh

2CLI Commands2-63configNOTE: The starting IP address must be lesser than the ending IP address.Command Example Root> config security switchAcl addR

22-64Enterprise Operating System Command Line Interface User Manual configCommand Example Root> config security switchAcl setState 1config.security

2CLI Commands2-65configYou can use the Switch Binding commands to enable Switch Binding and to create and change the SBML. Switch Binding is available

xiContentsContentsshow.openTrunking.rerouteLog... 2-162show.port.config ...

22-66Enterprise Operating System Command Line Interface User Manual configconfig.security.switchBinding.deleteMemberSyntax deleteMember wwnPurpose Thi

2CLI Commands2-67configParameters This command has one parameter:Command ExampleRoot> config security switchBinding setState allRestrictconfig.secu

22-68Enterprise Operating System Command Line Interface User Manual configOutput This command displays the following switch binding configuration data

2CLI Commands2-69configParameters This command has five parameters. Up to six community names and trap recipients may be defined. Command ExampleRoot&

22-70Enterprise Operating System Command Line Interface User Manual configParameters This command has one parameter. Command ExamplesRoot> config s

2CLI Commands2-71configconfig.snmp.setStateSyntax setState enabledStatePurpose This command enables or disables the SNMP agent. When disabled, the SNM

22-72Enterprise Operating System Command Line Interface User Manual configOutput Example The output from the config.snmp.show command displays as foll

2CLI Commands2-73configfabric to provide additional connection information to host bus adapters (HBA) and storage devices. As an example, this informa

22-74Enterprise Operating System Command Line Interface User Manual configParameters This command has one parameter. Command ExampleRoot> config sw

2CLI Commands2-75configPurpose This command sets the status of limited fabric RSCNs. When enabled, fabric register for state change notifications (RSC

Enterprise Operating System Command Line Interface User Manual xiiContents

22-76Enterprise Operating System Command Line Interface User Manual configParameters This command has one parameter. Command ExampleRoot> config sw

2CLI Commands2-77configParameters This command has one parameter. Command ExampleRoot> config switch raTOV 20config.switch.rerouteDelaySyntax rerou

22-78Enterprise Operating System Command Line Interface User Manual configParameter This command has one parameter. Command ExamplesRoot> config sw

2CLI Commands2-79configPurpose This command shows the switch configuration. NOTE: The switch can be either offline or online when this command is exec

22-80Enterprise Operating System Command Line Interface User Manual configOutput Example The output from the config.switch.show command displays as fo

2CLI Commands2-81configParameters This command has one parameter:Command ExampleRoot> config switch zoneFlexPars fabricconfig.switch.zoningRSCNSynt

22-82Enterprise Operating System Command Line Interface User Manual configParameters This command has one parameter. Command ExampleRoot> config sy

2CLI Commands2-83configParameters This command has one parameter. Command ExampleRoot> config system description McDATA Intrepid 6064 Fibre Channel

22-84Enterprise Operating System Command Line Interface User Manual configPurpose This command shows the system configuration. Parameters This command

2CLI Commands2-85configNOTE: Port numbers cannot be used for zone members if the interoperability mode for the switch or director is set to Open Fabri

Tablesxiii1-1 CLI Command Tree Navigation Conventions ... 1-31-2 CLI Command Tree ...

22-86Enterprise Operating System Command Line Interface User Manual configNOTE: If the interoperability mode for the switch or director is set to Open

2CLI Commands2-87configconfig.zoning.addWwnMemSyntax addWwnMem zoneName wwnPurpose This command adds a WWN zone member to the specified zone in the wo

22-88Enterprise Operating System Command Line Interface User Manual configParameters This command has one parameter. Command ExampleRoot> config zo

2CLI Commands2-89configconfig.zoning.deactivateZoneSetSyntax deactivateZoneSet Purpose This command places all attached devices in the default zone an

22-90Enterprise Operating System Command Line Interface User Manual configconfig.zoning.deleteWwnMemSyntax deleteWwnMem zoneName wwnPurpose This comma

2CLI Commands2-91configconfig.zoning.renameZoneSyntax renameZone oldZoneName newZoneNamePurpose This command renames a zone in the work area.Parameter

22-92Enterprise Operating System Command Line Interface User Manual configCommand Example Root> config zoning renameZoneSet TheUltimateZoneSetconfi

2CLI Commands2-93configOutput The zoning configuration data is displayed as a table that includes the following properties.Output Example The output f

22-94Enterprise Operating System Command Line Interface User Manual configPending Zone Set Default Zone Enabled: False ZoneSet: TheNewUltimateZoneSe

2CLI Commands2-95maintmaintThe maint branch of the CLI command tree contains commands that relate to maintenance activities.The commands in the maint

xivEnterprise Operating System Command Line Interface User Manual Tables

22-96Enterprise Operating System Command Line Interface User Manual maintmaint.port.resetSyntax reset portNumberPurpose This command resets a port.Thi

2CLI Commands2-97maintmaint.system.clearSysErrorSyntax clearSysErrorPurpose This command clears the system error light.Parameters This command has no

22-98Enterprise Operating System Command Line Interface User Manual maintCommand Example Root> maint system resetConfigmaint.system.setOnlineStateS

2CLI Commands2-99perfperfThe perf branch of the CLI command tree contains commands that relate to performance services.The commands in the perf branch

22-100Enterprise Operating System Command Line Interface User Manual perfOutput Example The output from the perf.class2 command displays as follows.Po

2CLI Commands2-101perfParameters This command has one parameter. Command ExampleRoot> perf class3 2Output The port Class 3 counter data is displaye

22-102Enterprise Operating System Command Line Interface User Manual perfOutput Example The output from the perf.class3 command displays as follows.Po

2CLI Commands2-103perfParameters This command has one parameter. Command ExampleRoot> perf errors 2Output The port error counter data is displayed

22-104Enterprise Operating System Command Line Interface User Manual perfOutput Example The output from the perf.errors command displays as follows.Po

2CLI Commands2-105perfOutput Example The output from the perf.link command displays as follows.Port 2 Statistic Count ----------- ---------- OLS In

PrefacexvPrefaceThis publication is part of the documentation suite that supports the McDATA® Sphereon™ 3016 Fabric Switch, Sphereon 3032 Fabric Switc

22-106Enterprise Operating System Command Line Interface User Manual perfParameters This command has one parameter. Command ExampleRoot> perf openT

2CLI Commands2-107perfas the percentage of time that no transmit BB_Credits are passed on the link. When the threshold value is exceeded, the system t

22-108Enterprise Operating System Command Line Interface User Manual perfNOTE: The command config.features.openTrunking on page 2-8 has functionality

2CLI Commands2-109perfOutput Example The output from the perf.openTrunking.show command displays as follows.Port Number: 1Congest

22-110Enterprise Operating System Command Line Interface User Manual perfperf.preferredPathThe perf.preferredPath commands enable you to use the Prefe

2CLI Commands2-111perfthe preferred path. All configured paths can be removed by specifying the all parameter for both the destination domain ID and s

22-112Enterprise Operating System Command Line Interface User Manual perfParameters This command has the following parameters. Command ExampleRoot>

2CLI Commands2-113perfParameters This command has one parameter.Command ExampleRoot> perf preferredPath setState enableperf.preferredPath.showPathS

22-114Enterprise Operating System Command Line Interface User Manual perfParameters This command has the following parameters.Output The output from p

2CLI Commands2-115perfCommand and Output ExamplesThe following examples show the output returned by the three methods of specifying the perf.preferred

xviEnterprise Operating System Command Line Interface User Manual PrefaceThe publications listed in Related Publications provide considerable informat

22-116Enterprise Operating System Command Line Interface User Manual perfperf.thresholdAlertsThe perf.thresholdAlerts commands enable you to configure

2CLI Commands2-117perf3. Configure the threshold alert using other perf.thresholdalert commands. For example, you may want to associate the threshold

22-118Enterprise Operating System Command Line Interface User Manual perf5. Configure the threshold alert using other perf.thresholdalert commands. Fo

2CLI Commands2-119perf6Sync Losses7Signal Losses8 Protocol Errors9 Invalid Tx Words10 CRC Errors11 Discarded Frames12 Frames Too Short13 Delimiter Err

22-120Enterprise Operating System Command Line Interface User Manual perfDescription of Summed SetsSome of the threshold alerts consist of groups of r

2CLI Commands2-121perf• Interval: 60 minutes• State: DisabledParameters This command has one parameter. TIP: Although the system supports a name lengt

22-122Enterprise Operating System Command Line Interface User Manual perfParameters This command has the following parameters. Specifying a port type

2CLI Commands2-123perfNOTE: An alert cannot be modified unless it is in the disabled state. Verify that the alert is disabled before executing this co

22-124Enterprise Operating System Command Line Interface User Manual perfParameters This command has the following parameters.Command ExampleRoot>

2CLI Commands2-125perfIf ports 0,1, or 2 CRC Error counter increments more then 5 times within a period of 30 minutes, send an alert. Where:Port list

PrefacexviiPreface• Sphereon 3016 and 3216 Fabric Switch Element Manager User Manual (620-000174)• Sphereon 3016 and 3216 Fabric Switches Installation

22-126Enterprise Operating System Command Line Interface User Manual perfInterval: 30Alert State: Disabledperf.threshholdAlerts.count

2CLI Commands2-127perfperf.thresholdAlerts.deleteAlertSyntax deleteAlert namePurpose This command deletes a specified threshold alert.NOTE: An alert c

22-128Enterprise Operating System Command Line Interface User Manual perfPurpose This command displays information about all threshold alerts.Paramete

2CLI Commands2-129perfOutput ExampleName Type State------------------ --------- ---------Throughput Threshold #1 Rx Util EnableThreshold for CRC CRC E

22-130Enterprise Operating System Command Line Interface User Manual perf•Ports: None• Utilization Type: None• Utilization Percentage: 50%• Duration:

2CLI Commands2-131perfParameters This command has the following parameters. Specifying a port type removes the alert from all ports and applies the al

22-132Enterprise Operating System Command Line Interface User Manual perfNOTE: An alert cannot be modified unless it is in the disabled state. Verify

2CLI Commands2-133perfParameters This command has the following parameters. Command ExampleRoot> perf thresholdAlerts throughput setUtilType eportR

22-134Enterprise Operating System Command Line Interface User Manual perfperf.thresholdAlerts.throughput.setParamsSyntax setParams name duration inter

2CLI Commands2-135perfperf.thresholdAlerts.throughput.showSyntax show namePurpose This command displays the settings for an individual throughput thre

xviiiEnterprise Operating System Command Line Interface User Manual PrefaceMcDATA’s “Best in Class” Solution Center provides a single point of contact

22-136Enterprise Operating System Command Line Interface User Manual perfParameters This command has no parameters. Command ExampleRoot> perf thres

2CLI Commands2-137perfOutput Example The output from the perf.traffic command displays as follows.Port 2 Statistic Wrap Count----------- ---------- --

22-138Enterprise Operating System Command Line Interface User Manual showshowThe show branch of the CLI command tree contains commands that display, b

2CLI Commands2-139show•show.features• show.security.portbinding• show.security.switchbinding• show.security.fabricbinding•show.openTrunking.config• sh

22-140Enterprise Operating System Command Line Interface User Manual showOutput Example Date/Time Action Source User Id---------- ----------- -------

2CLI Commands2-141showParameters This command has one optional parameter. If no parameters are entered, it will show the current state.Command Example

22-142Enterprise Operating System Command Line Interface User Manual showshow.epFrameLog.noWrapSyntax noWrap [clear]Purpose This command allows the us

2CLI Commands2-143showOutput Example The output of the show.epFrameLog.nowrap command displays as follows:Count Date/Time Port # Direction SOF EOF Pa

22-144Enterprise Operating System Command Line Interface User Manual showOutput Example The output of the show.epFrameLog.wrap command displays as fol

2CLI Commands2-145showOutput The event log data are displayed as a table that includes the following properties.Output Example The output from the sho

PrefacexixPrefaceFax: (720) 558-4193Trademarks The following terms, indicated by a registered trademark symbol (®) or trademark symbol (™) on first us

22-146Enterprise Operating System Command Line Interface User Manual showParameters This command has one optional parameter. If no parameter is specif

2CLI Commands2-147showPurpose This command allows the user to view the contents of the wrapping region of the fabric log. The log entries will not per

22-148Enterprise Operating System Command Line Interface User Manual showshow.fabric.nodesSyntax nodesPurpose This command displays a list of all fabr

2CLI Commands2-149showOutput Example Principal Switch WWN: 00:00:00:00:00:00:00:00show.fabric.topologySyntax topologyPurpose This command displays a

22-150Enterprise Operating System Command Line Interface User Manual showshow.featuresSyntax featuresPurpose This command displays a table of all inst

2CLI Commands2-151showParameters This command has one optional parameter, an individual policy name. If an individual policy name is given, then a det

22-152Enterprise Operating System Command Line Interface User Manual showshow.ficonCUPZoningSyntax ficonCUPZoningPurpose This command displays the con

2CLI Commands2-153showOutput The data is displayed as a table that includes the following properties:Output ExampleFicon MS State: DisabledFicon MIHPT

22-154Enterprise Operating System Command Line Interface User Manual showOutput Example The output from the show.frus command displays as follows.FRU

2CLI Commands2-155showPurpose This command shows the contents of the link incident log on the director or switch.ATTENTION! If the switch is restarted

Enterprise Operating System Command Line Interface User Manual iiRecord of Revisions and UpdatesCopyright © 2001 - 2004 McDATA Corporation. All rights

xxEnterprise Operating System Command Line Interface User Manual Preface

22-156Enterprise Operating System Command Line Interface User Manual showmore than one device per port for any public loop devices attached to an FL P

2CLI Commands2-157showPurpose This command displays information from the name server database for devices attached to this switch. Note that it is pos

22-158Enterprise Operating System Command Line Interface User Manual showOutput Example The output from the show.nameServer command displays as follow

2CLI Commands2-159showParameters This command has no parameters. Command ExampleRoot> show nameServerExtOutput The device information data is displ

22-160Enterprise Operating System Command Line Interface User Manual showNOTE: The command config.NPIV.show on page 2-23 has functionality that is ide

2CLI Commands2-161showOutput The configuration data is displayed as a table that includes the following properties:Output Example openSysMS State:

22-162Enterprise Operating System Command Line Interface User Manual showOutput Example The output from the show.openTrunking.config command displays

2CLI Commands2-163showOutput The device information data is displayed as a table that includes the following properties.Output Example The output from

22-164Enterprise Operating System Command Line Interface User Manual showOutput Example The output from the show.port.config command displays as follo

2CLI Commands2-165showParameters This command has the following parameters.Output The output from show.port.exit includes the following parameters. de

Introduction1-11 IntroductionThis chapter introduces the Command Line Interface (CLI) and describes the essentials for using the CLI commands. • Comma

22-166Enterprise Operating System Command Line Interface User Manual showCommand and Output ExamplesThe following examples show the output returned by

2CLI Commands2-167showOutput The port information data is displayed as a table that includes the following properties.Output Example The output from t

22-168Enterprise Operating System Command Line Interface User Manual showParameters This command has one parameter. Command ExampleRoot> show port

2CLI Commands2-169showOutput Example The show.port.nodes command output for a mix of public and private nodes on a loop appears as follows:FCAddr BB

22-170Enterprise Operating System Command Line Interface User Manual showOutput Example The show.port.opticEDD command output displays as follows:Port

2CLI Commands2-171showOutput Example The show.port.opticInfo command output displays as follows:Port Xvr Temp 3.3 Volt Current TX Power RX Power 1.8 V

22-172Enterprise Operating System Command Line Interface User Manual showOutput Example The output from the show.port.profile command displays as foll

2CLI Commands2-173showFAN: DisabledFC Address: 034FA2Attached WWN: F0:01:02:A1:B0:22:00:12Operational State:

22-174Enterprise Operating System Command Line Interface User Manual showOutput Example Port Original Addr Current Addr SwappedPort Num ---- ---------

2CLI Commands2-175showAttached WWN The WWN of the device or switch attached to the port, if one is attached.Beaconing The beaconing state for the port

11-2Enterprise Operating System Command Line Interface User Manual Command Line Interface OverviewCommand Line Interface OverviewThe Command Line Inte

22-176Enterprise Operating System Command Line Interface User Manual showOutput Example The output from the show.port.status command displays as follo

2CLI Commands2-177showshow.port.technologySyntax technologyPurpose This command displays port technology information for all ports.Parameters This com

22-178Enterprise Operating System Command Line Interface User Manual showshow.preferredPath.showPathSyntax showPath destDomainID sourcePort Purpose Th

2CLI Commands2-179showOutput The output from show.preferredPath.showPath includes the following parameters. Command and Output ExamplesThe following e

22-180Enterprise Operating System Command Line Interface User Manual showsourcePort set to allRoot> show preferredPath showPath 1 allPreferred Path

2CLI Commands2-181showshow.security.logSyntax log [clear]Purpose This command shows the contents of the security log as maintained in NV-RAM on the di

22-182Enterprise Operating System Command Line Interface User Manual show Data: Usr=Administrator IPaddr=001.002.003.004 Role=admin10305 04/11/01 0

2CLI Commands2-183showPort WWN Binding Bound WWN ---- ----------- ----------------------- 0 Active AA:00:AA:00:AA:00

22-184Enterprise Operating System Command Line Interface User Manual showshow.security.switchBindingSyntax switchBindingPurpose This command displays

2CLI Commands2-185showshow.snmpSyntax snmp Purpose This command shows the switch SNMP configuration.Parameters This command has no parameters.NOTE: Th

1Introduction1-3Entering Command Line Interface CommandsEntering Command Line Interface CommandsThe CLI commands can be entered directly at the comman

22-186Enterprise Operating System Command Line Interface User Manual showOutput Example The output from the show.snmp command displays as follows.SNMP

2CLI Commands2-187showSwitch Priority The switch priority as set in the config.switch.priority command. For more information, see config.switch.priori

22-188Enterprise Operating System Command Line Interface User Manual showOutput Example The output from the show.switch command displays as follows.St

2CLI Commands2-189showOutput Example The output from the show.system command displays as follows.System InformationName: Joe's Switch

22-190Enterprise Operating System Command Line Interface User Manual showSyntax alertsPurpose This command provides the name, type, and enabled state

2CLI Commands2-191showOutput Example The output from the show.thresholdAlerts.alerts command displays as follows.Name

22-192Enterprise Operating System Command Line Interface User Manual showshow.thresholdAlerts.logSyntax log [clear]Purpose This command shows the cont

2CLI Commands2-193showOLS Received CTA - OLS ReceivedLink Failures CTA - Link FailuresSync Losses CTA - Sync LossesSignal Losses CTA - Signal LossesPr

22-194Enterprise Operating System Command Line Interface User Manual showOutput Example The output from the show.thresholdAlerts.log command displays

2CLI Commands2-195showActive Zone Set Default Zone Enabled: False ZoneSet: TheUltimateZoneSet Zone: TheUltimateZone ZoneMember: Domai

11-4Enterprise Operating System Command Line Interface User Manual Entering Command Line Interface Commands^B Control-B Position the cursor left one c

22-196Enterprise Operating System Command Line Interface User Manual show

Error MessagesA-1A Error MessagesThis appendix lists and explains error messages for the Command Line Interface (CLI). Any error numbers that are not

AA-2Enterprise Operating System Command Line Interface User Manual Message Error 009: Invalid Switch Description Description The value entered for the

AError MessagesA-3Message Error 014: Invalid Port Name Description The value entered for the port name is invalid. Action The port name for the indiv

AA-4Enterprise Operating System Command Line Interface User Manual Message Error 020: Invalid Preferred Domain ID Description The value entered for th

AError MessagesA-5Message Error 032: Invalid SNMP Community Name Description The value entered for the SNMP community name is invalid Action The comm

AA-6Enterprise Operating System Command Line Interface User Manual Message Error 037: Invalid Month Description The value of the month entered for the

AError MessagesA-7Message Error 042: Invalid Second Description The value of the second entered for the new system time is invalid. Action The format

AA-8Enterprise Operating System Command Line Interface User Manual Message Error 050: Invalid RADIUS Server Timeout ValueDescription The RADIUS server

AError MessagesA-9config.zoning.renameZoneSet on page 2-91. Make the appropriate changes to the zone name and re-submit.Message Error 057: Duplicate Z

1Introduction1-5Entering Command Line Interface CommandsCommand TreeThe command tree of the CLI begins from the root. Table 1-2 shows the CLI command

AA-10Enterprise Operating System Command Line Interface User Manual Message Error 062: Invalid Zone Set Name Description The value entered for the zon

AError MessagesA-11Message Error 070: Invalid FRU Type Description The requested FRU does not exist on this product. Action Consult the installation/

AA-12Enterprise Operating System Command Line Interface User Manual Message Error 075: Invalid Zone Set Size Description The zone set entered exceeds

AError MessagesA-13Message Error 081: Default Zone Enabled Description The request cannot be completed because the default zone is enabled Action Dis

AA-14Enterprise Operating System Command Line Interface User Manual Message Error 091: E_Port Type Configured Description Ports are not allowed to be

AError MessagesA-15Message Error 101: Command Not Supported on This Product Description This product does not support the requested command. Action C

AA-16Enterprise Operating System Command Line Interface User Manual Message Error 106: Invalid Threshold Scope Description The scope of a threshold al

AError MessagesA-17Message Error 112: No Threshold Definition Given Description The threshold value for the alert was not configured before the user a

AA-18Enterprise Operating System Command Line Interface User Manual Message Error 118: Invalid Port Speed Description This request cannot be completed

AError MessagesA-19Message Error 135: Invalid Number of Fabric Membership List Entries Description The number of fabric members submitted exceeds the

11-6Enterprise Operating System Command Line Interface User Manual Entering Command Line Interface Commandsip-------------------------- ethernetlineSp

AA-20Enterprise Operating System Command Line Interface User Manual Message Error 139: Insistent Domain ID's Must Be Enabled When Fabric Binding

AError MessagesA-21Message Error 143: Domain RSCNs Must Be Enabled When Enterprise Fabric Mode Active Description The user attempted to disable domain

AA-22Enterprise Operating System Command Line Interface User Manual Message Error 148: Not Allowed While Switch Offline Description The switch must be

AError MessagesA-23Message Error 154: Invalid Membership List WWN Description The request cannot be completed because the WWN does not exist in the sw

AA-24Enterprise Operating System Command Line Interface User Manual Message Error 158: Invalid Switch IP Access Control List IP Address Range Descript

AError MessagesA-25Message Error 165: CUP Zoning feature key must be installed Description The command is not available without the FICON CUP Zoning

AA-26Enterprise Operating System Command Line Interface User Manual Message Error 171: Invalid username Description The username is invalid. Action

AError MessagesA-27Message Error 177: Cannot remove the last Web user with Administrator rights Description At least one Administrator user must exis

AA-28Enterprise Operating System Command Line Interface User Manual Message Error 183: Invalid Enable StatusDescription The enable status is invalid.A

AError MessagesA-29Message Error 189: Invalid Fencing Policy TypeDescription Invalid fencing policy type.Action Enter a valid fencing policy type.Mess

1Introduction1-7Entering Command Line Interface Commandsshowtimeoutswitch-------------------- setSecretuser----------------------- adddeletemodifyrole

AA-30Enterprise Operating System Command Line Interface User Manual Message Error 194: Cannot enable two policies of the same type that contain the sa

AError MessagesA-31Message Error 201: Change Authorization Request Failed Description The switch did not accept the request to make a change to NVRAM.

AA-32Enterprise Operating System Command Line Interface User Manual Message Error 209: Change Request Aborted Description The switch did not accept th

AError MessagesA-33Message Error 214: A Zone Contains Zero Members Description You are attempting to activate a zone set that contains at least one zo

AA-34Enterprise Operating System Command Line Interface User Manual Message Error 219: Invalid Port Type Description The port type configured is inval

AError MessagesA-35Message Error 224: Invalid Argument Description One or more parameters are invalid for this command. Action Consult this manual (C

AA-36Enterprise Operating System Command Line Interface User Manual Message Error 230: Invalid WWN Description The wwn parameter does not contain a va

AError MessagesA-37Message Error 234: Invalid Command Description The CLI cannot associate an action with the submitted command. The command may be mi

AA-38Enterprise Operating System Command Line Interface User Manual Message Error 238: Invalid Feature Key Description The feature key entered is inva

AError MessagesA-39Message Error 245: Invalid increment value Description The increment value specified is not between 1 and 70560. Action Make sure

11-8Enterprise Operating System Command Line Interface User Manual Entering Command Line Interface CommandsauthTrapsdeleteCommunitysetFaMibVersionsetS

AA-40Enterprise Operating System Command Line Interface User Manual Message Error 250: Invalid counter threshold alert name Description The name speci

AError MessagesA-41Message Error 256: Invalid utilization type number Description The utilization type number does not exist. Action Select a valid u

AA-42Enterprise Operating System Command Line Interface User Manual Message Error 262: All Attached Members are in the Membership List Description Al

AError MessagesA-43Message Error 269: Invalid retransmit attempts. Must be between 1 and 100 Description The desired retransmit attempt value is inval

AA-44Enterprise Operating System Command Line Interface User Manual Message Error 275: Invalid authentication role Description The desired role is not

AError MessagesA-45Message Error 282: Conflicting Domain ID for the specified WWN Description The desired Domain ID is already in use.Action Select a

AA-46Enterprise Operating System Command Line Interface User Manual Message Error 288: The NPIV feature key must be installed Description The NPIV fea

AError MessagesA-47Message Error 295: Invalid MIHPTO valueDescription The MIHPTO value is invalid.Action Enter a valid MIHPTO value.Message Error 296:

AA-48Enterprise Operating System Command Line Interface User Manual Message Error 299: Chap secret not definedDescription The Chap secret must be defi

AError MessagesA-49Message Error 304: Radius Authentication Present. Cannot remove all Radius ServersDescription You cannot remove all the RADIUS Serv

1Introduction1-9Entering Command Line Interface CommandsdeletePortMemrenameZoneshowPendingshowActivemaint ---------- port ----------------------- beac

AA-50Enterprise Operating System Command Line Interface User Manual

Commands and Corresponding ReleasesB-1B Commands and Corresponding ReleasesTable B-1, Commands and Releases, shows the commands that are valid in the

BB-2Enterprise Operating System Command Line Interface User Manual 7.0 config.ficonCUPZoning.show7.0 config.ficonMS.setMIHPTO7.0 config.ficonMS.show7.

BCommands and Corresponding ReleasesB-37.0 config.security.authentication.port.override7.0 config.security.authentication.port.show7.0 config.security

BB-4Enterprise Operating System Command Line Interface User Manual 7.0 perf.thresholdAlerts.show7.0 show.auditLog7.0 show.epFrameLog.config7.0 show.ep

BCommands and Corresponding ReleasesB-56.1 perf.preferredPath.clearPath6.1 perf.preferredPath.setPath6.1 perf.preferredPath.setState6.1 perf.preferred

BB-6Enterprise Operating System Command Line Interface User Manual 5.3 show.openTrunking.config5.3 show.openTrunking.rerouteLog4.0 config.features.ent

BCommands and Corresponding ReleasesB-74.0 config.switch.edTOV4.0 config.switch.insistDomainId4.0 config.switch.interopMode4.0 config.switch.prefDomai

BB-8Enterprise Operating System Command Line Interface User Manual 4.0 config.zoning.renameZone4.0 config.zoning.renameZoneSet4.0 config.zoning.replac

BCommands and Corresponding ReleasesB-94.0 show.nameServerExt4.0 show.port.config4.0 show.port.info4.0 show.port.nodes4.0 show.port.status4.0 show.por

Enterprise Operating System Command Line Interface User Manualiiiproperty of such parties and are reprinted with limited use permission. All other tra

11-10Enterprise Operating System Command Line Interface User Manual Entering Command Line Interface Commandsshowthroughput -------------- addAlertaddP

BB-10Enterprise Operating System Command Line Interface User Manual

Glossaryg-1Glossary This glossary includes terms and definitions from: • American National Standard Dictionary for Information Systems (ANSI X3.172-19

g-2 Enterprise Operating System Command Line Interface User Manual GlossarySee. This refers the reader to another keyword or phrase for the same term.

Glossaryg-3GlossaryBB_Credit See buffer-to-buffer credit.blocked port In a director or switch, the attribute that when set, removes the communication

g-4 Enterprise Operating System Command Line Interface User Manual Glossaryzoning configurations, and port configurations through the Element Manager

Glossaryg-5Glossarydefault zone A zone that contains all of the devices attached to a fabric that are not members of a at lest one of the zones of the

g-6 Enterprise Operating System Command Line Interface User Manual Glossaryembedded web serverWith director firmware Version 1.2 (or later) installed,

Glossaryg-7Glossaryfabric loop port FL_Port. A fabric port (F_Port) that contains arbitrated loop (AL) functions associated with the Fibre Channel arb

g-8 Enterprise Operating System Command Line Interface User Manual GlossaryFRU See field-replaceable unit. GG_Port See generic port.gateway A multi-ho

Glossaryg-9Glossaryhub (1) In Fibre Channel protocol, a device that connects nodes into a logical loop by using a physical star topology. (2) In Ether

1Introduction1-11Entering Command Line Interface CommandsNote that the commands are shown, with the exception of the zoning commands, in alphabetical

g-10 Enterprise Operating System Command Line Interface User Manual GlossaryLLAN See local area network.LIN See link incident.link Physical connection

Glossaryg-11Glossarymultiswitch fabric A Fibre Channel fabric created by linking more than one director or fabric switching device within a fabric.NN_

g-12 Enterprise Operating System Command Line Interface User Manual Glossaryonline state When the switch or director is in the online state, all of th

Glossaryg-13Glossarypath In a network, any route between any two ports.persistent binding A form of server-level access control that uses configuratio

g-14 Enterprise Operating System Command Line Interface User Manual Glossaryresource allocation time-out value R_A_TOV. R_A_TOV is a value used to tim

Glossaryg-15Glossaryserver A computer that provides shared resources, such as files and printers, to the network. Used primarily to store data, provid

g-16 Enterprise Operating System Command Line Interface User Manual Glossarythe packets more quickly. Typically, a subnet may represent all the machin

Glossaryg-17Glossaryuniform resource locatorURL. A URL is the address of a document or other resource on the Internet.universal port module A flexible

g-18 Enterprise Operating System Command Line Interface User Manual Glossaryzoning Grouping of several devices by function or by location. All devices

Indexi-1Symbols" 1-14# 1-20? 1-19Numerics60 characters in history log 1-1380-column output 1-14Aaccess control list 2-62adding a range 2-6

11-12Enterprise Operating System Command Line Interface User Manual Entering Command Line Interface CommandsNavigation of the CLI Command TreeOnce the

Enterprise Operating System Command Line Interface User Manual i-2Indexhelp 1-19logging in or out 1-14lost 2-97navigation conventions 1-3output 1

i-3IndexIndexview 2-142, 2-143enableaccess control list 2-63OpenTrunking 2-107SNMP agent 2-71Enterprise Fabric Modeactivating 2-5, 2-6deactivatin

Enterprise Operating System Command Line Interface User Manual i-4IndexGG_port, setting 2-31gateway address 2-21globally available commands 1-5grap

i-5IndexIndexNV-RAM configuration parameters, reset 2-97Ooffline, setting switches for configuration 2-72Open Systemssetting state 2-24Open Systems

Enterprise Operating System Command Line Interface User Manual i-6IndexQquotation marksfor spaces 1-14in strings 1-14Rr_a_tov 2-76RADIUS serveraddi

i-7IndexIndexaccess control list 2-64all 2-138ethernet attributes 2-154event log 2-144fabric binding 2-180fabric nodes 2-148fabric topology 2-1

Enterprise Operating System Command Line Interface User Manual i-8Indexdelete member 2-66online state functions 2-65set state 2-66show configuratio

i-9IndexIndexthroughput threshold alert 2-116types 2-118time, system 2-82trademarks xixtraffic counters 2-136traversing the command tree 1-12tru

Enterprise Operating System Command Line Interface User Manual i-10Index

1Introduction1-13Entering Command Line Interface CommandsAs shown in this example, use of the complete command syntax avoids navigating up and down th

11-14Enterprise Operating System Command Line Interface User Manual Logging In and Logging OutIf spaces are not included in a parameter that accepts a

1Introduction1-15Logging In and Logging Outhexadecimal characters must follow the backslash. All printable ASCII characters can be entered using the k

11-16Enterprise Operating System Command Line Interface User Manual Logging In and Logging Outenters the default password when prompted to change the

1Introduction1-17Using the commaDelim CommandUsing the commaDelim CommandNote that the output examples shown in the other sections of this publication

11-18Enterprise Operating System Command Line Interface User Manual Handling Command Line Interface ErrorsHandling Command Line Interface ErrorsTwo ty

1Introduction1-19Using the Command Line Interface HelpUsing the Command Line Interface HelpThe question mark (?) can be used within a command to obtai

Enterprise Operating System Command Line Interface User Manual iv

11-20Enterprise Operating System Command Line Interface User Manual Commenting ScriptsCommenting ScriptsThe pound sign (#) can be used to add comments

1Introduction1-21ED-5000 DirectorED-5000 DirectorA subset of the CLI commands described in this publication are available on the ED-5000 Director™. Th

11-22Enterprise Operating System Command Line Interface User Manual Telnet SessionTelnet SessionThe CLI can be accessed through a Telnet client sessio

1Introduction1-23Backup and RestorationBackup and RestorationA standalone Configuration Backup and Restore (CBR) utility is available for customers th

11-24Enterprise Operating System Command Line Interface User Manual Backup and Restoration

CLI Commands2-12 CLI CommandsThis chapter describes the Command Line Interface (CLI) commands, including their syntax, purpose, and parameters, as wel

22-2Enterprise Operating System Command Line Interface User Manual Command OverviewCommand OverviewMost of the commands in this chapter are listed in

2CLI Commands2-3New and Changed Commands• config.NPIV.show on page 2-23• config.port.rxCredits on page 2-26• config.port.show on page 2-27• config.por

22-4Enterprise Operating System Command Line Interface User Manual New and Changed Commands• config.security.authentication.user.add on page 2-46• con

2CLI Commands2-5config• show.port.opticInfo on page 2-170• show.port.profile on page 2-171• show.port.showPortAddr on page 2-173• show.security.log on

ContentsvPreface...xvChapter

22-6Enterprise Operating System Command Line Interface User Manual configCommand Example Root> config enterpriseFabMode setState 1 NOTE: You canno

2CLI Commands2-7configNOTE: If the FICON Management Server is enabled, the default management style is the FICON Management Style. The Open Systems Ma

22-8Enterprise Operating System Command Line Interface User Manual configconfig.features.NPIVSyntax setState NPIVStatePurpose This command sets the en

2CLI Commands2-9configPurpose This command sets the enabled state of the OpenTrunking feature. The OpenTrunking feature key must be installed in order

22-10Enterprise Operating System Command Line Interface User Manual configOutput Example The output from the config.features.show command displays as

2CLI Commands2-11configParameters This command has two parameters.NOTE: A range of ports is not accepted as a valid input to this command (e.g., “0-29

22-12Enterprise Operating System Command Line Interface User Manual configParameters This command has one parameter.Command ExampleRoot> config fen

2CLI Commands2-13configParameters This command has four parameters.NOTE: The interval value is a fixed length amount of time. This interval is not a r

22-14Enterprise Operating System Command Line Interface User Manual configCommand Example The meaning for each of these inputs can best be described u

2CLI Commands2-15configParameters This command has one optional parameter. When no parameters are specified, the command will display the name, type,

Enterprise Operating System Command Line Interface User Manual viContentsNew and Changed Commands ...

22-16Enterprise Operating System Command Line Interface User Manual configThe output from the config.fencing.show Policy_1 command displays as follows

2CLI Commands2-17configCommand Example Root> config ficonCUPZoning addControlHost 01:02:03:04: 05:06:07:08config.ficonCUPZoning.deleteControlHostSy

22-18Enterprise Operating System Command Line Interface User Manual configCommand Example Root> config ficonCUPZoning setState 1 config.ficonCUPZon

2CLI Commands2-19configParameters This command has one parameter.Command ExampleRoot> config ficonms setMIHPTO 180config.ficonMS.setStateSyntax set

22-20Enterprise Operating System Command Line Interface User Manual configconfig.ficonMS.showSyntax showPurpose This command shows the Ficon MS settin

2CLI Commands2-21configParameters This command has three parameters. Command ExampleRoot> config ip ethernet 10.0.0.0 0.0.0.0 255.0.0.0config.ip.li

22-22Enterprise Operating System Command Line Interface User Manual configOutput The LAN configuration data is displayed as a table that includes the

2CLI Commands2-23configconfig.NPIV.setState Syntax setState NPIVEnabledStatePurpose This command sets enabled state of the NPIV feature. The NPIV fea

22-24Enterprise Operating System Command Line Interface User Manual config6 130...NOTE: The command show.NPIV.config on page 2-159 has functionality t

2CLI Commands2-25configNOTE: The command config.features.openSysMS on page 2-8 has functionality that is identical to this command.config.port.blocked

viiContentsContentsconfig.security ... 2-32config.security.authentication.interf

22-26Enterprise Operating System Command Line Interface User Manual configParameters This command has two required parameters.Command ExampleRoot>

2CLI Commands2-27configParameters This command has two required parameters:Command ExampleRoot> config port rxCredits 8 40config.port.showSyntax sh

22-28Enterprise Operating System Command Line Interface User Manual configCommand Example Root> config port show 4Output This command displays as a

2CLI Commands2-29configParameters This command has no parameters.Command ExampleRoot> config port showPortAddrOutput The port configuration is show

22-30Enterprise Operating System Command Line Interface User Manual configATTENTION! Port speed changes temporarily disrupt port data transfers.Parame

2CLI Commands2-31configPurpose This command will swap two ports given the port numbers. The ports must be offline to perform this operation.Parameters

22-32Enterprise Operating System Command Line Interface User Manual configParameters This command has two required parameters. Command Example Root>

2CLI Commands2-33configconfig.security.authentication.interface api.outgoingSyntax outgoing enabledStatePurpose This command determines if outgoing C

22-34Enterprise Operating System Command Line Interface User Manual configNOTE: A preferred method of local and a backup method of RADIUS is not an ac

2CLI Commands2-35configNOTE: This command requires that the SANtegrity Authentication feature key be installed.Parameters This command has one paramet

Enterprise Operating System Command Line Interface User Manual viiiContentsconfig.security.ssh.resetKeys...

22-36Enterprise Operating System Command Line Interface User Manual configNOTE: A preferred method of local and a backup method of RADIUS is not an ac

2CLI Commands2-37configParameters This command has one required parameter, and one optional parameter:NOTE: A preferred method of local and a backup m

22-38Enterprise Operating System Command Line Interface User Manual configconfig.security.authentication.interface.osms.setKeySyntax setKeyPurpose Thi

2CLI Commands2-39configCommand Example Root> config security authentication serial enhancedAuth enableconfig.security.authentication.interface.show

22-40Enterprise Operating System Command Line Interface User Manual configParameters This command has one required parameter, and one optional paramet

2CLI Commands2-41configParameters This command has one required parameter, and one optional parameter:Command ExampleRoot> config security authenti

22-42Enterprise Operating System Command Line Interface User Manual configPort Override State---- --------------0 Default1 Default2 Enable3 Default4 D

2CLI Commands2-43configParameters This command has one required parameter:Command ExampleRoot> config security authentication RADIUS deadtime 120co

22-44Enterprise Operating System Command Line Interface User Manual configParameters This command has one required parameter, and two optional paramet

2CLI Commands2-45configconfig.security.authentication.RADIUS.timeoutSyntax timeout index seconds Purpose This command configures the number of secon

ixContentsContentsconfig.zoning.addZone ... 2-87config.zoning.clearZone...

22-46Enterprise Operating System Command Line Interface User Manual configCommand Example Root> config security authentication switch setSecret con

2CLI Commands2-47configNOTE: Currently the only possible combination of multiple interfaces is (Web and CLI). Command Example Root> config security

22-48Enterprise Operating System Command Line Interface User Manual configPurpose This command deletes an entry from the local authentication database

2CLI Commands2-49configParameters This command has two required parameters, and an additional password parameter at the prompt after the command:NOTE:

22-50Enterprise Operating System Command Line Interface User Manual configPurpose This command sets the role value that is associated to an existing u

2CLI Commands2-51configUsername Interfaces Role----------- ----------- -------------johndoe_1223 Web,CLI Administrator ewsOperator Web Operator Op

22-52Enterprise Operating System Command Line Interface User Manual config• Active FBML: When fabric binding is active, the active FBML is the list of

2CLI Commands2-53configconfig.security.fabricBinding.activatePendingSyntax activatePendingPurpose This command activates the fabric binding configurat

22-54Enterprise Operating System Command Line Interface User Manual configconfig.security.fabricBinding.addMemberSyntax addMember wwn domainIdPurpose

2CLI Commands2-55configconfig.security.fabricbinding.deactivateFabBindSyntax deactivateFabBind Purpose This command deactivates the active FBML on the