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

E/OS
Command Line Interface
User Manual
P/N 620-000134-740
REV A

E/OS Command Line Interface User Manual
ii
Record of Revisions and Updates
Copyright © 2001 - 2005 McDATA Corporation. All rights reserved.
Printed June 2005
Thirteenth Edition
No part of this publication may be reproduced or distributed in any form or by any means, or stored in a
database or retrieval system, without the prior written consent of McDATA Corporation. The information
contained in this document is subject to change without notice. McDATA Corporation assumes no
responsibility for any errors that may appear.
All computer software programs, including but not limited to microcode, described in this document are
furnished under a license, and may be used or copied only in accordance with the terms of such license.
McDATA either owns or has the right to license the computer software programs described in this document.
McDATA Corporation retains all rights, title and interest in the computer software programs.
McDATA Corporation makes no warranties, expressed or implied, by operation of law or otherwise, relating
to this document, the products or the computer software programs described herein. McDATA
CORPORATION DISCLAIMS ALL IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
A PARTICULAR PURPOSE. In no event shall McDATA Corporation be liable for (a) incidental, indirect,
special, or consequential damages or (b) any damages whatsoever resulting from the loss of use, data or
profits, arising out of this document, even if advised of the possibility of such damages.
©2005 McDATA Corporation. All rights reserved. McDATA, the McDATA logo, McDATA Eclipse,
Fabricenter, HotCAT, Intrepid, Multi-Capable Storage Network Solutions, Networking the World's Business
Revision Date Description
620-000134-000 11/2001 Initial release of Manual
620-000134-100 05/2002 Updates for E/OS 2.0
620-000134-200 08/2002 Updates for E/OS 3.0
620-000134-300 09/2002 Updates for E/OS 4.0
620-000134-400 10/2002 Updates for E/OS 4.1
620-000134-500 10/2002 Updates for E/OS 4.1 CD-ROM final
620-000134-600 2/2003 Updates for E/OS 5.1 and EFCM 7.1
620-000134-601 7/2003 Updates for E/OS 5.5
620-000134-700 10/2003 Updates for E/OS 6.0
620-000134-710 12/2003 Updates for E/OS 6.1
620-000134-720 6/2004 Updates for E/OS 6.2
620-000134-730 12/2004 Updates for E/OS 7.0
620-000134-740 6/2005 Updates for E/OS 8.0

E/OS Command Line Interface User Manual iii
Data, nScale, nView, OPENready, SANavigator, SANtegrity, SANvergence, SecureConnect and Sphereon are
trademarks or registered trademarks of McDATA Corporation. OEM and Reseller logos are the property of
such parties and are reprinted with limited use permission. All other trademarks are the property of their
respective companies. All specifications subject to change.

E/OS Command Line Interface User Manual
iv

Contents v
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
logout.........................................................................................1-17
Using the commaDelim Command..............................................1-18
commaDelim ............................................................................1-18
Handling Command Line Interface Errors .................................1-19
Using the Command Line Interface Help ...................................1-20
Commenting Scripts.......................................................................1-21
ED-5000 Director.............................................................................1-22
Telnet Session ..................................................................................1-23
Ethernet Connection Loss.......................................................1-23
Chapter 2 CLI Commands
Command Overview........................................................................2-2
New and Changed Commands ......................................................2-2
Contents

E/OS Command Line Interface User Manual
vi
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
config.ip.show..........................................................................2-22
config.NPIV..............................................................................2-23
config.NPIV.maxPortIDs........................................................2-23
config.NPIV.setState ..............................................................2-24
config.NPIV.show ..................................................................2-24
config.openSysMS.setHostCtrlState .....................................2-25
config.openSysMS.setState.....................................................2-25
config.port.blocked..................................................................2-26
config.port.fan..........................................................................2-26
config.port.name......................................................................2-27
config.port.rxCredits...............................................................2-28
config.port.show......................................................................2-28
config.port.showPortAddr.....................................................2-30
config.port.showCredits.........................................................2-31
config.port.speed .....................................................................2-32
config.port.swapPortByAddr ................................................2-32
config.port.swapPortByNum.................................................2-33

vii
Contents
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............................ 2-43
config.security.authentication.RADIUS.attempts.............. 2-44
config.security.authentication.RADIUS.deadtime............. 2-44
config.security.authentication.RADIUS.deleteServer ....... 2-45
config.security.authentication.RADIUS.server .................. 2-45
config.security.authentication.RADIUS.show.................... 2-46
config.security.authentication.RADIUS.timeout................ 2-47
config.security.authentication.switch.setSecret.................. 2-47
config.security.authentication.user ...................................... 2-48
config.security.authentication.user.add .............................. 2-48
config.security.authentication.user.delete........................... 2-50
config.security.authentication.user.modify ........................ 2-50
config.security.authentication.user.role .............................. 2-51
config.security.authentication.user.show............................ 2-52
config.security.fabricBinding ................................................ 2-53
config.security.fabricBinding.activatePending................... 2-54
config.security.fabricbinding.addAttachedMembers........ 2-55
config.security.fabricBinding.addMember ......................... 2-55
config.security.fabricBinding.clearMemList....................... 2-56
config.security.fabricbinding.deactivateFabBind............... 2-56
config.security.fabricBinding.deleteMember...................... 2-57
config.security.fabricBinding.replacePending.................... 2-57
config.security.fabricBinding.showActive .......................... 2-57
config.security.fabricBinding.showPending....................... 2-58
config.security.portBinding................................................... 2-59
config.security.portBinding.bound ...................................... 2-59
config.security.portBinding.show ........................................ 2-60

E/OS Command Line Interface User Manual
viii
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
config.snmp.addV3Group......................................................2-81
config.snmp.addV1Target......................................................2-82
config.snmp.addV2Target......................................................2-83
config.snmp.addV3Target......................................................2-83
config.snmp.authTraps...........................................................2-84
config.snmp.deleteAccessEntry ............................................2-85
config.snmp.deleteCommunity.............................................2-85
config.snmp.deleteUserEntry ................................................2-85
config.snmp.deleteTargetEntry.............................................2-86
config.snmp.deleteV3Group..................................................2-86
config.snmp.setSNMPv3State................................................2-86
config.snmp.setFaMibVersion...............................................2-87
config.snmp.setState ...............................................................2-87
config.snmp.show ...................................................................2-88
config.snmp.showAccessTable..............................................2-89
config.snmp.showTargetTable ..............................................2-90

ix
Contents
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.................................................. 2-101
config.switch.RSCNZoneIsolation ..................................... 2-102
config.switch.safeZoning..................................................... 2-103
config.switch.speed .............................................................. 2-103
config.switch.show ............................................................... 2-104
config.switch.webState......................................................... 2-106
config.switch.zoneFlexPars ................................................. 2-106
config.switch.zoningRSCN.................................................. 2-106
config.syslog .......................................................................... 2-107
config.syslog.addServer ....................................................... 2-107
config.syslog.deleteServer ................................................... 2-107
config.syslog.setLogConfig ................................................. 2-108
config.syslog.setState............................................................ 2-108
config.syslog.show................................................................ 2-109
config.system ......................................................................... 2-110
config.system.contact ........................................................... 2-110
config.system.date ................................................................ 2-110
config.system.description .................................................... 2-111
config.system.location.......................................................... 2-111
config.system.name .............................................................. 2-112
config.system.show............................................................... 2-112
config.zoning ......................................................................... 2-113
config.zoning.activateZoneSet ............................................ 2-114
config.zoning.addPortMem................................................. 2-114
config.zoning.addWwnMem .............................................. 2-115
config.zoning.addZone ........................................................ 2-116
config.zoning.clearZone....................................................... 2-117

E/OS Command Line Interface User Manual
x
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
perf.openTrunking.show......................................................2-137
perf.openTrunking.unresCongestion .................................2-138
perf.preferredPath.................................................................2-139
perf.preferredPath.clearPath................................................2-140
perf.preferredPath.setPath ...................................................2-141
perf.preferredPath.setState ..................................................2-142
perf.preferredPath.showPath ..............................................2-142
perf.preferredPath.showState..............................................2-144
perf.thresholdAlerts..............................................................2-144
perf.thresholdAlerts.counter.addAlert...............................2-149
perf.thresholdAlerts.counter.addPort ................................2-150
perf.thresholdAlerts.counter.removePort..........................2-151
perf.thresholdAlerts.counter.setCounter ...........................2-151
perf.thresholdAlerts.counter.setParams ............................2-153

xi
Contents
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 ............................................................................................... 2-167
show.all................................................................................... 2-167
show.auditLog....................................................................... 2-168
show.epFrameLog.config .................................................... 2-169
show.epFrameLog.disableTrigger...................................... 2-170
show.epFrameLog.filterClassFFrames .............................. 2-170
show.epFrameLog.setFilterPort.......................................... 2-171
show.epFrameLog.noWrap ................................................. 2-172
show.epFrameLog.setTrigger ............................................. 2-173
show.epFrameLog.wrap ...................................................... 2-174
show.eventLog ...................................................................... 2-175
show.fabricLog.noWrap ...................................................... 2-176
show.fabricLog.wrap............................................................ 2-177
show.fabric.nodes ................................................................. 2-178
show.fabric.principal............................................................ 2-179
show.fabric.topology............................................................ 2-180
show.fabric.traceRoute......................................................... 2-181
show.features......................................................................... 2-183
show.fencing.policies ........................................................... 2-184
show.ficonCUPZoning......................................................... 2-185
show.ficonMS ....................................................................... 2-186
show.frus................................................................................ 2-187
show.ip.ethernet.................................................................... 2-188
show.linkIncidentLog........................................................... 2-188
show.loginServer .................................................................. 2-189
show.nameServer.................................................................. 2-190
show.nameServerExt............................................................ 2-192
show.NPIV.config................................................................. 2-193
show.openSysMS.config ...................................................... 2-194

E/OS Command Line Interface User Manual
xii
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
show.switch............................................................................2-230
show.system ...........................................................................2-232
show.syslog ............................................................................2-234
show.thresholdAlerts.alerts .................................................2-235
show.thresholdAlerts.log .....................................................2-237
show.zoning ...........................................................................2-239
Appendix A Error Messages
Appendix B Commands and Corresponding Releases
Glossary ........................................................................................................................a-1
Index ...............................................................................................................................b-1

Tables xiii
1-1 CLI Command Tree Navigation Conventions ......................................... 1-3
1-2 CLI Command Tree ...................................................................................... 1-4
1-3 CLI Command Tree for the ED-5000 Director ........................................ 1-22
2-1 Supported Zoning Configurations ......................................................... 2-114
2-2 Throughput Threshold Alerts ................................................................ 2-147
2-3 Alert Counters ........................................................................................... 2-147
B-1 Commands and Releases ............................................................................. B-1
Tables

xiv E/OS Command Line Interface User Manual
Tables

Preface xv
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.
Who Should Use This
Manual
This publication describes the commands that can be entered through
the Command Line Interface (CLI) for the Intrepid 6064 Director, and
Intrepid 6140 Director, Sphereon 3016, Sphereon 3032, Sphereon
3216, Sphereon 3232, Sphereon 4300, Sphereon 4400, Sphereon 4500,
and Sphereon 4700 Fabric Switches. (A limited number of these
commands are available on the ED-5000 Director.) Access through a
Telnet client is presumed.
This publication is intended for data center administrators and
customer support personnel, who can either enter the commands
manually or write a script containing them. However, the primary
purpose of the CLI is for scripts written by these administrators and
personnel for use in a host-based scripting environments. Therefore,
this publication presumes that the user is familiar with:
• Establishing and using a Telnet session
• Using the command line of a terminal
• Writing scripts
• Networking, SAN, and zoning concepts
• McDATA products in the user’s network
The publications listed in Related Publications provide considerable
information about both concepts and McDATA products.

xvi E/OS Command Line Interface User Manual
Preface
Organization of This
Manual
This publication is organized as follows:
•Chapter 1, Introduction,provides an introduction and overview of
the Command Line Interface.
•Chapter 2, CLI Commands,describes the CLI commands,
including their syntax, purpose, and parameters, as well as
examples of their usage and any output that they generate.
•Appendix A, Error Messages lists and explains error messages that
may appear while using the CLI.
•Appendix B, Commands and Corresponding Releases lists each
command in the CLI and the release in which the command was
added to the CLI.
•TheGlossary defines terms, abbreviations, and acronyms used in
this manual.
•AnIndex is also provided.
Manual Updates Check the McDATA web site at www.mcdata.com for possible
updates or supplements to this manual.
Related Publications Other publications that provide additional information about the
products mentioned in this manual are:
• Configuration Backup and Restore Utility Installation and User Guide
(958-000370)
• McDATA Products in a SAN Environment - Planning Manual
(620-000124)
• Intrepid 6064 Director Installation and Service Manual (620-000108)
• Intrepid 6140 and 6064 Directors Element Manager User Manual
(620-000172)
• Intrepid 6140 Director Installation and Service Manual (620-000157)
• EFCM Basic User Manual (620-000240)
• McDATA E/OS SNMP Support Manual (620-000131)
• Sphereon 3016 and 3216 Fabric Switch Element Manager User Manual
(620-000174)
• Sphereon 3016 and 3216 Fabric Switches Installation and Service
Manual (620-000154)
• Sphereon 3032 and 3232 Fabric Switch Element Manager User Manual
(620-000173)

Preface xvii
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)
• McDATA Sphereon 4400 Switch Element Manager User Manual
(620-000241)
• McDATA Sphereon 4700 Fabric Switch Element Manager User
Manual (620-000242)
• McDATA Sphereon 4400 Fabric Switch Installation and Service
Manual (620-000238)
• McDATA Sphereon 4700 Fabric Switch Installation and Service
Manual (620-000239)
Manual Conventions The following notational conventions are used in this document:
NOTE: A note presents important information that is not hazard-related.
ATTENTION! An attention notice presents important information about
activities that could result in loss of equipment function or loss of data.
Where to Get Help For technical support, McDATA end-user customers should call the
phone number located on the service label attached to the front or
rear of the hardware product.
Convention Meaning
Bold Keyboard keys, buttons and switches on hardware products,
and screen prompts for the Command Line Interface.
Italic Outside book references, names of user interface windows,
buttons, and dialog boxes.
Monospaced Command syntax, examples of commands, output.

xviii E/OS Command Line Interface User Manual
Preface
NOTE: To expedite warranty entitlement, please have your product serial
number available.
McDATA Corporation
380 Interlocken Crescent
Broomfield, CO 80021
Phone: [phone] or [phone]
Fax: [phone]
E-mail: [email protected]
NOTE: Customers who purchased the hardware product from a company
other than McDATA should contact that company’s service representative
for technical support.
Forwarding
Publication
Comments
We sincerely appreciate any comments about this publication. Did
you find this manual easy or difficult to use? Did it lack necessary
information? Were there any errors? Could its organization be
improved?
Please send your comments via e-mail, our home page, or FAX.
Identify the manual, and provide page numbers and specific detail.
Thank you.
Ordering Publications To order a paper copy of this manual, submit a purchase order as
described in Ordering McDATA Documentation Instructions, which is
found on McDATA’s web site, www.mcdata.com. To obtain
documentation CD-ROMs, contact your sales representative.
E-mail: [e-mail]
Home Page: http://www.mcdata.com
Fax: Technical Communications Manager
[phone]

Preface xix
Preface
Trademarks The following terms, indicated by a registered trademark symbol (®)
or trademark symbol (™) on first use in this publication, are
trademarks of McDATA Corporation in the United States, other
countries, or both:
Registered Trademarks Trademarks
Fabricenter®E/OS™
HotCAT®Eclipse™
Intrepid®Fibre Channel Director™
McDATA®OPENconnectors™
OPENready®SANvergence™
SANavigator®Sphereon™
SANtegrity®
All other trademarked terms, indicated by a registered trademark
symbol (®) or trademark symbol (™) on first use in this publication,
are trademarks of their respective owners in the United States, other
countries, or both.

xx E/OS Command Line Interface User Manual
Preface