Dell M5424 Command Reference Guide

53-1002746-01	®
14 December 2012

Fabric OS

Command Reference

Supporting Fabric OS v7.1.0

Copyright © 19992012 Brocade Communications Systems, Inc. All Rights Reserved.

Brocade, the B-wing symbol, BigIron, DCX, Fabric OS, FastIron, NetIron, SAN Health, ServerIron, and TurboIron are registered trademarks, and AnyIO, Brocade Assurance, Brocade NET Health, Brocade One, CloudPlex, MLX, VCS, VDX, and When the Mission Is Critical, the Network Is Brocade are trademarks of Brocade Communications Systems, Inc., in the United States and/or in other countries. Other brands, products, or service names mentioned are or may be trademarks or service marks of their respective owners.

Notice: This document is for informational purposes only and does not set forth any warranty, expressed or implied, concerning any equipment, equipment feature, or service offered or to be offered by Brocade. Brocade reserves the right to make changes to this document at any time, without notice, and assumes no responsibility for its use. This informational document describes features that may not be currently available. Contact a Brocade sales office for information on feature and product availability. Export of technical data contained in this document may require an export license from the United States government.

The authors and Brocade Communications Systems, Inc. shall have no liability or responsibility to any person or entity with respect to any loss, cost, liability, or damages arising from the information contained in this book or the computer programs that accompany it.

The product described by this document may contain “open source” software covered by the GNU General Public License or other open source license agreements. To find out which open source software is included in Brocade products, view the licensing terms applicable to the open source software, and obtain a copy of the programming source code, please visit http://www.brocade.com/support/oscd.

Brocade Communications Systems, Incorporated

Corporate and Latin American Headquarters	Asia-Pacific Headquarters
Brocade Communications Systems, Inc.	Brocade Communications Systems China HK, Ltd.
130 Holger Way	No. 1 Guanghua Road
San Jose, CA 95134	Chao Yang District
Tel: [phone]	Units 2718 and 2818
Fax: [phone]	Beijing 100020, China
E-mail: [e-mail]	Tel: [phone]
	Fax: [phone]
	E-mail: [e-mail]
European Headquarters	Asia-Pacific Headquarters
Brocade Communications Switzerland Sàrl	Brocade Communications Systems Co., Ltd. (Shenzhen
Centre Swissair	WFOE)
Tour B - 4ème étage	Citic Plaza
29, Route de l'Aéroport	No. 233 Tian He Road North
Case Postale 105	Unit 1308 – 13th Floor
CH-1215 Genève 15	Guangzhou, China
Switzerland	Tel: [phone]
Tel: [phone]	Faz: [phone]
Fax: [phone]	E-mail: [e-mail]
Email: [e-mail]

Document History

Document title	Publication number	Summary of changes	Publication date
Fabric OS Reference v2.0	53-0001487-03		September 1999
Fabric OS Reference v2.2	53-0001558-02		May 2000
Fabric OS Reference v2.3	53-0000067-02		December 2000
Fabric OS Reference v3.0	53-0000127-03		July 2001
Fabric OS Reference v2.6	53-0000194-02		December 2001
Fabric OS Reference v3.0 / v4.0	53-0000182-02		March 2002
Fabric OS Reference v4.0.2	53-0000182-03		September 2002
Fabric OS Reference v3.1.0	53-0000500-02		April 2003
Fabric OS Reference v4.1.0	53-0000519-02		April 2003
Fabric OS Reference v4.1.2	53-0000519-03		May 2003
Fabric OS Reference v4.1.2	53-0000519-04		July 2003
Fabric OS Reference v4.1.2	53-0000519-05		August 2003
Fabric OS Reference v4.1.2	53-0000519-06		October 2003
Fabric OS Reference v4.2.0	53-0000519-07		December 2003
Fabric OS Command Reference	53-0000519-08		March 2004
Fabric OS Command Reference	53-0000519-08 Rev. A		April 2004
Fabric OS Command Reference	53-0000519-09		September 2004
Fabric OS Command Reference	53-0000519-10		April 2005
Fabric OS Command Reference	53-0000519-12		July 2005
Fabric OS Command Reference	53-1000240-01		September 2006
Fabric OS Command Reference	53-1000436-01		June 2007
Fabric OS Command Reference	53-1000599-01	Added 13 new commands.	October 2007
		Updated 23 commands with
		new options in support of v6.0.
		Removed 46 obsolete
		commands. Edited and revised
		~ 150 commands. Added
		command syntax conventions
		to Preface. Updated FCS,
		standby CP, and RBAC tables.
		Added AD Type to RBAC table
		(Appendix A). Removed
		licensed command tables and
		SupportShow reference.
		Cosmetic edits throughout.
Fabric OS Command Reference	53-1000599-02	Added 9 new commands.	March 2008
		Updated 28 commands to
		support new v6.1 functionality.
		Removed 6 operands from 6
		commands. Corrected errors in
		~150 commands. Updated
		Preface and RBAC/AD table
		(Appendix A). Cosmetic edits
		throughout.

Fabric OS Command Reference	iii
53-1002746-01

Document title	Publication number	Summary of changes	Publication date
Fabric OS Command Reference	53-1000599-03	Corrections and updates to 31	July 2008
		commands. Removed “Brocade
		Optional Features” from
		Preface. Added trademark note
		to Preface. Cosmetic edits
		throughout.
Fabric OS Command Reference	53-1001115-01	Added 3 new commands to	August 2008
		support Encryption. Modified 1
		command. Updated Preface
		and RBAC/AD table.
Fabric OS Command Reference	53-1001186-01	Added 14 new commands to	November 2008
		support Logical Fabrics.
		Modified 63 commands with
		new command operands to
		support new Fabric OS v6.2.0
		features. Removed 8
		deprecated commands.
		Miscellaneous edits to ~40
		commands to correct edits,
		update examples. Removed
		standby CP command table.
		Updated Preface, surrounding
		chapters, and command
		availability tables.
Fabric OS Command Reference	53-1001337-01	Added 18 new commands.	July 2009
		Modified 27 commands with
		new command operands to
		support new Fabric OS v6.3.0
		features. Removed 6
		deprecated command options.
		Removed 6 diagnostic
		commands that now require
		root access. Miscellaneous
		edits to ~100 commands to
		correct edits, update examples.
		Updated Preface, surrounding
		chapters, and permission
		tables.
Fabric OS Command Reference	53-1001754-01	Updated 4 help pages with new	January 2010
		command options. Modified 16
		help pages for minor updates
		and corrections.
Fabric OS Command Reference	53-1001764-01	Added 8 new commands.	March 2010
		Modified 41 commands with
		new operands to support Fabric
		OS v6.4.0 features. Removed 5
		commands and 3 deprecated
		command options.
		Miscellaneous edits to ~100
		commands to correct edits,
		update examples, etc. Updated
		Preface, surrounding chapters,
		and permission tables.

iv	Fabric OS Command Reference
	53-1002746-01

Document title	Publication number	Summary of changes	Publication date
Fabric OS Command Reference	53-1002147-01	Added 20 new commands.	April 2011
		Modified 102 commands to
		support Fabric OS v7.0.0
		features. Removed 40
		commands. 16 commands have
		deprecated command options.
		Miscellaneous edits to ~250
		additional commands. Updated
		Preface, surrounding chapters,
		and permission tables.
Fabric OS Command Reference	53-1002447-01	Added 2 new commands.	December 2011
		Modified 19 commands to
		support Fabric OS v7.0.1
		features. Removed 1
		command. Updated Preface,
		surrounding chapters, and
		permission tables.
Fabric OS Command Reference	53-1002746-01	Added 7 new commands.	December 2012
		Modified 100 commands to
		support Fabric OS v7.1.0
		features. Removed 6
		commands. Updated Preface,
		surrounding chapters, and
		permission tables.

Fabric OS Command Reference	v
53-1002746-01

vi	Fabric OS Command Reference
	53-1002746-01

Contents

About This Document

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix How this document is organized. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix Supported hardware and software . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix

What is new in this document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi New commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi Modified commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi Deprecated commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii

CLI usage conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii

Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv Text formatting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv Command syntax conventions . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv Notes, cautions, and warnings . . . . . . . . . . . . . . . . . . . . . . . . . . xxv Key terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxv

Notice to the reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xxv

Additional information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvi Brocade resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvi Other industry resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvi

Getting technical help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvi Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xxvii

Chapter 1	Using Fabric OS Commands
	In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. 1
	Using the command line interface . . . . . . . . . . . . . . . . . . . . . . . . . .	1
	Understanding Role-Based Access Control . . . . . . . . . . . . . . . . . . .	2
	Encryption commands and permissions . . . . . . . . . . . . . . . . . . .	2
	Understanding Virtual Fabric restrictions . . . . . . . . . . . . . . . . . . . . .	3
	Understanding Admin Domain restrictions . . . . . . . . . . . . . . . . . . . .	4
	Determining RBAC permissions for a specific command . . . . . . . . . .	4
Chapter 2	Fabric OS Commands
	aaaConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
	ad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	13
	ag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	23
	agAutoMapBalance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	44
	agShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	47
	aliAdd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	49

Fabric OS Command Reference	vii
53-1002746-01

aliCreate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 aliDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 aliRemove. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 aliShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 appLoginHistory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 aptPolicy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 auditCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 auditDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 authUtil. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 bannerSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 bannerShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 bcastShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 bladeCfgGeMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 bladeDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 bladeEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 bladeSwap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 bootLunCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 bottleneckMon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 bpPortLoopbackTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 bpTurboRamTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 bufOpMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 ceePortLedTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 ceePortLoopbackTest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 ceeTurboRamTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 cfgActvShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 cfgAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 cfgClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 cfgCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 cfgDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 cfgDisable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 cfgEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 cfgRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 cfgSave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 cfgShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 cfgSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 cfgTransAbort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 cfgTransShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 chassisBeacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 chassisDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 chassisDistribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 chassisEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 chassisName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

viii	Fabric OS Command Reference
	53-1002746-01

chassisShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 classConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 cliHistory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 cmsh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 configDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 configDownload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 configList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 configRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 configShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 configUpload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 configureChassis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 cryptoCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 dataTypeShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 dbgShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 defZone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 diagClearError. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 diagDisablePost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 diagEnablePost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 diagHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 diagPost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 diagRetry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 diagShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 distribute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 dlsReset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 dlsSet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 dlsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 dnsConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 enclosureShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 errClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 errDelimiterSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 errDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 errFilterSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 errModuleShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 errShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 fabRetryShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 fabRetryStats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266 fabricLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268 fabricName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 fabricPrincipal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

Fabric OS Command Reference	ix
53-1002746-01

fabricShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 fabStatsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 fanDisable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282 fanEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 fanShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 faPwwn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 fastBoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 fcipHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 fcipLedTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294 fcipPathTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 fcoe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 fcoeLoginCfg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 fcoeLoginGroup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304 fcPing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306 fcpLogClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 fcpLogDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 fcpLogEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316 fcpLogShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 fcpProbeShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 fcpRlsProbe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 fcpRlsShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 fcrBcastConfig. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 fcrConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 fcrEdgeShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 fcrFabricShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 fcrLsan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 fcrLsanCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 fcrLsanMatrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 fcrPhyDevShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 fcrProxyConfig. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 fcrProxyDevShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 fcrResourceShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344 fcrRouterPortCost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 fcrRouteShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 fcrXlateConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 fddCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 fdmiCacheShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 fdmiShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 ficonCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 ficonClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 ficonCupSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 ficonCupShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362

x	Fabric OS Command Reference
	53-1002746-01

ficonHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 ficonShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 fipsCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375 firmwareCommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 firmwareDownload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 firmwareDownloadStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385 firmwareKeyShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 firmwareRestore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388 firmwareShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 fmMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391 fosConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398 fosExec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 frameLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 fspfShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408 fwAlarmsFilterSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411 fwAlarmsFilterShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 fwClassInit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 fwConfigReload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 fwFruCfg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415 fwHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 fwMailCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418 fwPortDetailShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 fwSamShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424 fwSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 fwSetToCustom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426 fwSetToDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428 gePortErrShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430 h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 haDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 haDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 haEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 haFailover. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 haShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437 haSyncStart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439 haSyncStop. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440 help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441 historyLastShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 historyMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444 historyShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445 i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447 iclCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 ifModeSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451

Fabric OS Command Reference	xi
53-1002746-01

ifModeShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453 iflShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455 interfaceShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457 iodReset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 iodSet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463 iodShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464 ipAddrSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465 ipAddrShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470 ipFilter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473 ipSecConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480 islShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496 itemList. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498 killTelnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500 ldapCfg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 lfCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 licenseAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507 licenseIdShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508 licensePort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509 licenseRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512 licenseShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514 licenseSlotCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 linkCost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521 login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523 logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524 lsanZoneShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525 lsCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527 lsDbShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533 memShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536 motd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537 msCapabilityShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538 msConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539 msPlatShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541 msPlatShowDBCB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542 msPlClearDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543 msPlMgmtActivate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544 msPlMgmtDeactivate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545 msTdDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546 msTdEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547 msTdReadConfig. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548 myId. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549 nbrStateShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550 nbrStatsClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552

xii	Fabric OS Command Reference
	53-1002746-01

nodeFind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554 nsAliasShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556 nsAllShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560 nsCamShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561 nsDevLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564 nsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566 nsZoneMember . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 nsZoneShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574 passwd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576 passwdCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579 pathInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585 pdShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592 perfAddEEMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593 perfCfgClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597 perfCfgRestore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598 perfCfgSave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599 perfClearAlpaCrc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600 perfDelEEMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601 perfHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602 perfMonitorClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603 perfMonitorShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605 perfResourceShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607 perfSetPortEEMask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610 perfShowAlpaCrc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612 perfShowPortEEMask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613 perfTTmon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615 portAddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619 portAlpaShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622 portBeacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623 portBufferCalc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625 portBufferShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626 portCamShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629 portCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631 portCfgAlpa. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654 portCfgAutoDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655 portCfgCompress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659 portCfgCreditRecovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661 portCfgDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662 portCfgDPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664 portCfgEncrypt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666 portCfgEport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668 portCfgEXPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670

Fabric OS Command Reference	xiii
53-1002746-01

portCfgFaultDelay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673 portCfgFec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676 portCfgFillword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679 portCfgFportBuffers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681 portCfgGeMediaType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682 portCfgGport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684 portCfgISLMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685 portCfgLongDistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687 portCfgLossTov . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690 portCfgLport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691 portCfgNPIVPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693 portCfgNPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697 portCfgOctetSpeedCombo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698 portCfgPersistentDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700 portCfgPersistentEnable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703 portCfgQoS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 705 portCfgShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708 portCfgSpeed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719 portCfgTrunkPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722 portCfgVEXPort. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723 portCmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726 portDebug. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733 portDecom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734 portDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735 portDPortTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737 portEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741 portEncCompShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743 portErrShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745 portFencing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747 portFlagsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750 portLedTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752 portLogClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754 portLogConfigShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755 portLogDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756 portLogDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757 portLogDumpPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758 portLogEnable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759 portLogEventShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760 portLoginShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761 portLogPdisc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763 portLogReset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764 portLogResize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765

xiv	Fabric OS Command Reference
	53-1002746-01

portLogShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766 portLogShowPort. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773 portLogTypeDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774 portLogTypeEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775 portLoopbackTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776 portMirror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780 portName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784 portPerfShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786 portRouteShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789 portShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791 portStats64Show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 839 portStatsClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844 portStatsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 846 portSwap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 853 portSwapDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 855 portSwapEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 856 portSwapShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 857 portTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 858 portTestShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 861 portThConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 863 portTrunkArea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 872 portZoneShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 877 powerOffListSet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 878 powerOffListShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 880 psShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 882 rasAdmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 883 rasMan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 886 reBoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 888 roleConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 890 routeHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 893 rtLogTrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 894 secActiveSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 895 secAuthSecret. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 896 secCertUtil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 898 secDefineSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 908 secGlobalShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 909 secHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 911 secPolicyAbort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912 secPolicyActivate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 913 secPolicyAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 914 secPolicyCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 917 secPolicyDelete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 921

Fabric OS Command Reference	xv
53-1002746-01

secPolicyDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 923 secPolicyFCSMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 926 secPolicyRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 928 secPolicySave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 930 secPolicyShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 931 secStatsReset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 933 secStatsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 935 sensorShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 937 serDesTuneMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 938 setContext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 941 setDbg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942 setVerbose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943 sfpShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944 shellFlowControlDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 950 shellFlowControlEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 951 slotPowerOff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 952 slotPowerOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953 slotShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 954 snmpConfig. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 959 snmpTraps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 972 spinFab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 975 sshUtil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979 statsClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 984 stopPortTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 985 supportFfdc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 986 supportFtp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 987 supportSave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 989 supportShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 993 supportShowCfgDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 996 supportShowCfgEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 998 supportShowCfgShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1000 switchBeacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1002 switchCfgPersistentDisable. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1004 switchCfgPersistentEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1005 switchCfgSpeed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1006 switchCfgTrunk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1007 switchDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1008 switchEnable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1009 switchName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1010 switchShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1011 switchStatusPolicySet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1026 switchStatusPolicyShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1029

xvi	Fabric OS Command Reference
	53-1002746-01

switchStatusShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1030 switchUptime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1032 switchViolation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1033 syslogdFacility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1034 syslogdIpAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1035 syslogdIpRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1036 syslogdIpShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1037 sysMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1038 sysShutDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1045 tempShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1047 thConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1048 thMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1057 timeOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1058 topologyShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1059 traceDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1062 trackChangesHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1064 trackChangesSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1065 trackChangesShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1066 trunkDebug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1067 trunkShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1068 tsClockServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1071 tsTimeZone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1073 turboRamTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1077 upTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1079 uRouteShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1080 usbStorage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1082 userConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1084 version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1092 wwn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1093 wwnAddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1095 zone. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1097 zoneAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1108 zoneCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1110 zoneDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1112 zoneHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1113 zoneObjectCopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1114 zoneObjectExpunge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1115 zoneObjectRename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1117 zoneObjectReplace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1118 zoneRemove. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1119 zoneShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1121

Fabric OS Command Reference	xvii
53-1002746-01

Chapter 3	Primary FCS Commands
	In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	1125
	Primary FCS commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	1125
Appendix A	Command Availability
	In this appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	1127
	Command validation checks . . . . . . . . . . . . . . . . . . . . . . . . . . .	1127
	Command Admin Domain and Virtual Fabrics restrictions . . . . . .	1128

xviii	Fabric OS Command Reference
	53-1002746-01

About This Document

In this chapter

• How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix

• Supported hardware and software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix

• What is new in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi

• CLI usage conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii

• Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv

• Notice to the reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxv

• Additional information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvi

• Getting technical help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvi

• Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvii

How this document is organized

This document is organized to help you find the information that you want as quickly and easily as possible.

The document contains the following components:

•Chapter 1, “Using Fabric OS Commands,” explains how to use the command line interface to manage a Brocade SAN and Brocade switches.

•Chapter 2, “Fabric OS Commands,” provides command information.

•Chapter 3, “Primary FCS Commands,” summarizes the subset of commands available when an FCS policy is enabled.

•Appendix A, “Command Availability,” explains the Role-Based Access Control, as well as Virtual Fabric and Admin Domain restriction checks used to validate commands.

Supported hardware and software

This document includes updated information specific to new functionality introduced in Fabric OS v7.1.0. Table lists the hardware platforms supported in Fabric OS v7.1 release. ASIC names may be used in this document to distinguish between types of switches that share certain characteristics.

TABLE 1	Supported hardware for Fabric OS v7.1
Hardware Platform		Description	ASIC
Brocade 300		8 Gbit 16-port switch	Goldeneye 2
Brocade 5100		8 Gbit 32-port switch	Condor 2
Brocade 5300		8 Gbit 64-port switch	Goldeneye 2

Fabric OS Command Reference	xix
53-1002746-01

TABLE 1		Supported hardware for Fabric OS v7.1 (Continued)
Hardware Platform			Description			ASIC
Brocade 5410			8 Gbit 12-port embedded switch			Goldeneye 2
Brocade 5424			8 Gbit 24-port embedded switch			Goldeneye 2
Brocade 5450			8 Gbit 24-port embedded switch			Goldeneye 2
Brocade 5460			8 Gbit 24-port embedded switch			Goldeneye 2
Brocade 5470			8 Gbit 16-port embedded switch			Goldeneye 2
Brocade 5480			8 Gbit 24-port embedded switch			Goldeneye 2
Brocade 6505			16 Gbit 24-port switch			Condor 3
Brocade 6510			16 Gbit 48-port switch			Condor 3
Brocade 6520			16 Gbit 96-port switch			Condor 3
Brocade VA-40FC			8 Gbit 40-port switch			Condor 2
Brocade 7800 Extension switch			8 Gbit 16-FC ports, 6 GbE ports			Goldeneye 2
Brocade 8000 FCoE switch			8 Gbit 16-FC port, 10 GbE 8-Ethernet port switch			Anvil/Condor 2
Brocade Encryption Switch			8 Gbit 16-port encryption switch			Condor 2
DCX Backbone			8 Gbit 512-port core fabric backbone			Condor 2
DCX-4S Backbone			8 Gbit 192-port core fabric backbone			Condor 2
•	FC8-16 port blade		•	8	Gbit 16-port blade	•	Condor 2
•	FC8-32 port blade		•	8	Gbit 32-port blade	•	Condor 2
•	FC8-48 port blade		•	8	Gbit 84-port blade	•	Condor 2
•	FC8-64 port blade		•	8	Gbit 84-port blade	•	Condor 2
•	FCOE10-24 DCX blade		•	10 Gbit 6-port ISL blade		•	Condor
•	FS8-18 Encryption blade		•	8	Gbit 24-port blade	•	Anvil/Condor 2
•	FX8-24 Extension blade*		•	4	Gbit 16-FC port, 2 GbE port router blade	•	Condor
			•	8	Gbit 16-port encryption blade	•	Condor 2
			•	8	Gbit 12-FC ports, 10 GbE ports, 2 10GbE ports	•	Condor 2
Brocade DCX 8510-8 backbone			16 Gbit 192-port core fabric backbone			Condor 3
Brocade DCX 8510-4 backbone			16 Gbit 384-port core fabric backbone			Condor 3
•	FC8-32E port blade		•	8	Gbit 32-port blade	•	Condor 3
•	FC8-48E port blade		•	8	Gbit 48-port blade	•	Condor 3
•	FC8-64 port blade		•	8	Gbit 84-port blade	•	Condor 2
•	FC16-32 port blade		•	16 Gbit 32-port blade		•	Condor 3
•	FC16-48 port blade		•	16 Gbit 48-port blade		•	Condor 3
•	FS8-18 Encryption blade		•	8	Gbit 24-port blade	•	Anvil/Condor 2
•	FX8-24 Extension blade		•	8	Gbit 16-port encryption blade	•	Condor 2
			•	8	Gbit 12-FC ports, 10 GbE ports, 2 10GbE ports	•	Condor 2

Although Brocade supports and tests many different software and hardware configurations for Fabric OS v7.1.0, documenting all possible configurations and scenarios is beyond the scope of this document.

This document is specific to Fabric OS v7.1.0. To obtain information about an OS version other than v7.1.0, refer to the documentation for that OS version.

xx	Fabric OS Command Reference
	53-1002746-01

What is new in this document

The Fabric OS Command Reference v7.1.0Command supports the current Fabric OS release and the new hardware platforms.

The Fabric OS command RBAC availability and Admin Domain type table in the appendix chapter is updated. The table lists the Admin domain, Context and Switch type for the commands.

New commands

The following commands and associated man pages have been added since the publication of the Fabric OS v7.1.0 release of this manual:

•fabRetryStats - Displays or manages the retry count of fabric commands.

•fcpRlsProbe - Initiates the Fibre Channel Protocol (FCP) Read Link Status (RLS) probing for F_Port and displays the RLS information.

•gePortErrShow - Displays error statistics of Gigabit Ethernet (GbE) port and XGE ports.

•iflShow - Displays the interfabric link (IFL) information.

•nsDevLog - Manages device history logging.

•nsZoneShow - Displays the zone names.

•portBufferCalc - Calculates the number of buffers required per port.

•rasAdmin - Configures RASlog message generation.

•rasMan - Displays RASlog message text and documentation.

•zoneObjectReplace - Replaces zone members.

Modified commands

The following commands and associated man pages have been modified to remove support for the platforms Brocade 7500 and FR4-18i in Fabric OS v7.1.0:

•configDefault

•fcipPathTest

•lsCfg

•portCfg

•portCfgShow

•portCmd

•portShow

•portStatsShow

•sfpShow

•slotShow

•statsClear

•supportShow

•supportShowCfgDisable

•supportShowCfgEnable

•supportShowCfgShow

Fabric OS Command Reference	xxi
53-1002746-01

The following commands and associated man pages have been corrected or updated with additional information:

•aaaConfig - Added support for TACACS+.

•ag - Added options to save the configured F_Ports, delete the backup mappings for the given N_Port, and display the saved mappings for the given N_Port.

•aptPolicy - Added support for Device-based routing in FICON environments.

•auditDump - The CLI audit is captured.

•bottleneckMon - Added option to configure the BE credit Loss Link Reset Threshold.

•cfgShow - Added new option to display the changes in the transactions.

•cfgTransShow- Added new option to display local open transaction token details and the list of domains with open transactions.

•classConfig - Added the command restriction details dispalyed with the -showcli option.

•cliHistory - Added new new options to display the CLI history of the specified users.

•configureChassis - Added the CS_CTL to virtual channel mapping options.

•dlsSet - The Losseless (or fmsmode) can be enabled when XISL is enabled and vice versa.

•dnsConfig - Added options to set the DNS configuration parameters through the CLI. Also added options to delete and display the DNS configuration.

•errDump - Added options to display messages for the entire chassis, to display messages based on count value, to display messages in reversed order, to display messages based on severity, and to display messages based on slot.

•fcrFabricShow - Added option to display the FC Routers on a backbone fabric with edge fabric names.

•fcrPhyDevShow - Added the help option.

•ficonCupShow - Added options to display the FICON-CUP missing interrupt handler primary timeout (MIHPTO) value in seconds, to display the Director Diagnostics Log, to display dignostic information, and to display HealthCheck Logs for the logical switch.

•ficonShow - Added options to display RNID data in table format, and to display RNID data for only the specified port.

•ifModeSet - Added options to configure autonegotiation, speed, and capability. Also added the help option.

•islShow - The output is modified to display the neighbor WWN information even when the ISL is segmented during exchange link parameter (ELP) or post ELP segmentation phase.

•licensePort - The restriction that the command is supported only on embedded platforms is no longer applicable.

•nsAliasShow - Added option to display the remote device details for a specific domain. Also added the help option.

•nsZoneMember - Added help option.

•pathInfo - Added options to specify the source ID of the originator and the destination ID of the proxy device.

•portCfg - Added option to configure auto-negotiation settings for 1 GbE ports.

•portCfgAutoDisable - Added options to suspend and resume the port autodisable configuration.

•portCfgCreditRecovery - Command is supported in Access Gateway mode.

xxii	Fabric OS Command Reference
	53-1002746-01

•portCfgFec - Command is supported in Access Gateway mode. Rewrote the description for this command to better capture the feature and what it does. Updated examples to reflect latest output and documented the FEC states.

•portCfgLongDistance - Added options -distance, -buffers, -framesize, -fecenable, and -fecdisable.

•portEncCompShow - The output displays port speed.

•portShow - Added options fciptunnel --reset,--lifetime and fcipcircuit --reset,--lifetime.

•portSwap - Added option to remove swapping of all ports.

•secCertUtil - Added new options -commonswcert and -commonswcsr.

•setContext - Accepts switch name.

•sshUtil - Added option to delete the known host name or IP address from the file

.ssh/known_hosts.

•switchCfgPersistentDisable - Added options to set the switch in disable state, to disable the switch persistently, and help option.

•switchName - The switch name must be unique.

•switchShow - The output is modified to display the neighbor WWN information even when the ISL is segmented during exchange link parameter (ELP) or post ELP segmentation phase.

•zone - Added option to generate a report of potential routing problems in the local Domain.

•zoneAdd - Added wildcard character (asterisk) option to specify members.

•zoneCreate - Added wildcard character (asterisk) option to specify members.

•zoneRemove - Added wildcard character (asterisk) option to specify members.

•zoneShow - Added new option to display the changes in the transactions.

Deprecated commands

The following commands and associated man pages have been removed since this document was last released.

•fcIpChipTest

•fcrChipTest

•fcrPathTest

•licenseHelp

•policy

•uRouteConfig

•uRouteRemove

CLI usage conventions

•Some Fabric OS show commands display certain switch or fabric components in three-digit decimal numbers, for example, 003. When you use these numeric identifiers as inputs to other commands, you must remove the leading zeros; otherwise the commands will either fail or generate incorrect results. Adding zeros to any decimal number in a command input will cause that number to be treated as an Octal number.

Fabric OS Command Reference	xxiii
53-1002746-01

•Automatic page breaks in CLI command output displays are being phased out. Use the more option to display command output with page breaks: command | more. Do not use the more option in conjunction with help pages. Executing help command | more will display a command “no manual entry for command” message.

Document conventions

This section describes text formatting conventions and important notices formats.

Text formatting

The narrative-text formatting conventions that are used in this document are as follows:

bold text	Identifies command names
	Identifies GUI elements
	Identifies keywords and operands
	Identifies text to enter at the GUI or CLI
italic text	Provides emphasis
	Identifies variables
	Identifies paths and Internet addresses
	Identifies document titles
code text	Identifies CLI output
	Identifies syntax examples

For readability, command names in the command titles and in the narrative portions of this guide are presented in mixed letter case, for example, switchShow. In examples, command letter case is all lowercase.

Command syntax conventions

Command syntax in this document follows these conventions:

command	Commands are printed in bold.
--option, option	Command options are printed in bold.
-argument, arg	Arguments are printed in bold.
[ ]	Optional element.
variable	Variables are printed in italics. In the help pages, values are underlined or
	enclosed in angle brackets < >.
...	Repeat the previous element, for example “member[;member...]”
value	Fixed (literal) values following arguments are printed in plain font. For example,
	--show WWN
|	Boolean. Elements are exclusive. Example: --show -mode egress | ingress
\	Backslash indicates a “soft” line break. If a backslash separates two lines of a
	command input, enter the entire command at the prompt without the backslash.

xxiv	Fabric OS Command Reference
	53-1002746-01

Notes, cautions, and warnings

The following notices and statements are used in this manual. They are listed below in order of increasing severity of potential hazards.

NOTE

A note provides a tip, guidance, or advice, emphasizes important information, or provides a reference to related information.

ATTENTION

An Attention statement indicates potential damage to hardware or data.

CAUTION

A Caution statement alerts you to situations that can be potentially hazardous to you or cause damage to hardware, firmware, software, or data.

DANGER

A Danger statement indicates conditions or situations that can be potentially lethal or extremely hazardous to you. Safety labels are also attached directly to products to warn of these conditions or situations.

Key terms

For definitions specific to Brocade and Fibre Channel, see the technical glossaries on the Brocade website. See “Brocade resources” on page xxvi for instructions on accessing the information.

For definitions of SAN-specific terms, visit the Storage Networking Industry Association online dictionary at:

http://www.snia.org/education/dictionary

Notice to the reader

This document may contain references to the trademarks of the following corporations. These trademarks are the properties of their respective companies and corporations.

These references are made for informational purposes only.

Corporation	Referenced Trademarks and Products
Commvault	Commvault Galaxy Data Protection
EMC	RSA Data Protection Manager (DPM)
HP	Secure Key Manager (SKM) and Enterprise Secure Key Manager
	(ESKM)
IBM	Tivoli Key Lifecycle Manager
Legato	Legato Networker

Fabric OS Command Reference	xxv
53-1002746-01

Corporation	Referenced Trademarks and Products
Microsoft Corporation	Windows, Windows NT, Internet Explorer
NetApp	NetApp Lifetime Key Manager (LKM)
Oracle Corporation	Oracle, Java
Symantec	Veritas NetBackup 6.5 Enterprise Server
Red Hat, Inc.	Linux
Thales	Thales e-Security keyAuthority (TEKA)

Additional information

This section lists additional Brocade and industry-specific documentation that you may find helpful.

Brocade resources

To get up-to-the-minute information, join MyBrocade at no cost to obtain a user ID and password: http://my.brocade.com

White papers, online demonstrations, and data sheets are available through the Brocade website at: http://www.brocade.com/products-solutions/products/index.page

For additional Brocade documentation, visit the Brocade SAN Info Center and click the Resource Library location:

http://www.brocade.com

Release notes are available on the Brocade website.

Other industry resources

For additional resource information, visit the Technical Committee T11 website. This website provides interface standards for high-performance and mass storage applications for Fibre Channel, storage management, and other applications:

http://www.t11.org

For information about the Fibre Channel industry, visit the Fibre Channel Industry Association website: http://www.fibrechannel.org

Getting technical help

Contact your switch support supplier for hardware, firmware, and software support, including product repairs and part ordering. To expedite your call, have the following information available:

•General Information

-Switch model

-Switch operating system version

-Error numbers and messages received

xxvi	Fabric OS Command Reference
	53-1002746-01

-supportSave command output

-Detailed description of the problem, including the switch or fabric behavior immediately following the problem, and specific questions

-Description of any troubleshooting steps already performed and the results

-Serial console and Telnet session logs

-syslog message logs

•Switch Serial Number

The switch serial number and corresponding bar code are provided on the serial number label, as shown here:

:

*FT00X0054E9

FT00X0054E9

The serial number label is located as follows:

-Brocade 300, 5100, 5300, 6505, 6510, 6520, 6547, 7800, 8000, VA-40FC, and Brocade Encryption Switch—On the switch ID pull-out tab located inside the chassis on the port side on the left.

-Brocade 5410, 5424, 5430, 5450, 5460, 5470, 5480—Serial number label attached to the module.

-DCX, and DCX 8510-8—On the port side of the chassis, on the lower right side and directly above the cable management comb

-DCX-4S and DCX 8510-4—On the non-port side of the chassis on the lower left side.

•Use the licenseIdShow command to display the switch WWN.

If you cannot use the licenseIdShow command because the switch is inoperable, you can get the WWN from the same place as the serial number, except for the Brocade DCX, DCX-4S, DCX 8510-8, and DCX 8510-4. On these models, access the numbers on the WWN cards by removing the Brocade logo plate at the top of the non-port side of the chassis.

Document feedback

Quality is our first concern at Brocade, and we have made every effort to ensure the accuracy and completeness of this document. However, if you find an error or an omission, or you think that a topic needs further development, we want to hear from you. Forward your feedback to:

[e-mail]

Provide the title and version number and as much detail as possible about your issue, including the topic heading and page number and your suggestions for improvement.

Fabric OS Command Reference	xxvii
53-1002746-01

xxviii	Fabric OS Command Reference
	53-1002746-01

	Chapter
Using Fabric OS Commands	1

In this chapter

•	Using the command line interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	1
•	Understanding Role-Based Access Control . . . . . . . . . . . . . . . . . . . . . . . . . . . .	2
•	Understanding Virtual Fabric restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	3
•	Understanding Admin Domain restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	4
•	Determining RBAC permissions for a specific command . . . . . . . . . . . . . . . . . .	4

Using the command line interface

The Fabric OS command line interface (CLI), accessed via Telnet, SSH, or serial console, provides full management capability on a Brocade switch. The Fabric OS CLI enables an administrator to monitor and manage individual switches, ports, and entire fabrics from a standard workstation. Selected commands must be issued from a secure Telnet or SSH session.

Access is controlled by a switch-level password for each access level. The commands available through the CLI are based on the user’s login role and the license keys used to unlock certain features.

The Fabric OS CLI provides the following capabilities:

•Access to the full range of Fabric OS features, given the license keys installed.

•Assistance with configuration, monitoring, dynamic provisioning, and daily management of every aspect of storage area networks (SANs).

•A deeper view of the tasks involved in managing a Brocade SAN.

•Identification, isolation, and management of SAN events across every switch in the fabric.

•Management of Brocade licenses.

The documentation for each command includes a synopsis of its syntax, a description of command use, and a set of examples. The same information can be accessed by issuing the help command, followed by the command name on a Brocade switch or director. This command displays the help page for the specified command. For example, to display the help page for portCfg, enter:

switch:admin> help portCfg

Fabric OS Command Reference	1
53-1002746-01

1 Understanding Role-Based Access Control

Understanding Role-Based Access Control

Fabric OS implements Role-Based Access Control (RBAC) to control access to all Fabric OS operations.

Seven predefined roles are supported, as described in Table 2. These predefined role definitions are guided by perceived common operational situations and the operations and effects a role is permitted to have on a fabric and individual fabric elements.

TABLE 2 Role definitions

Role name	Definition
User	Non-administrative use, such as monitoring system activity. In Fabric
	OS v6.2.0 and later, the user account gains access to Fabric ID 128.
	This is the default logical fabric after a firmware upgrade.
Operator	A subset of administrative tasks typically required for routine
	maintenance operations.
SwitchAdmin	Administrative use excluding security, user management, and zoning.
ZoneAdmin	Zone management only.
FabricAdmin	Administrative use excluding user management and Admin Domain
	management.
BasicSwitchAdmin	A subset of administrative tasks, typically of a more limited scope and
	effect.
Admin	All administrative tasks, including encryption and chassis commands.
SecurityAdmin	Administrative use including admin, encryption, security, user
	management, and zoning.

In addition to these predefined roles, Fabric OS v7.0.0 and later provides support for creating user-defined roles. Refer to the roleConfig command for more information.

Additional command restrictions apply depending on whether Virtual Fabrics or Admin Domains are enabled in a fabric. Refer to Appendix A, “Command Availability”,

NOTE

Virtual Fabrics and Admin Domains are mutually exclusive and are not supported at the same time on a switch. To use Admin Domains, you must first disable Virtual Fabrics; to use Virtual Fabrics, you must first delete all Admin Domains. Use ad --clear -f to remove all Admin Domains. Refer to the Fabric OS Administrator’s Guide for more information.

Encryption commands and permissions

There are two system RBAC roles that are permitted to perform encryption operations.

•Admin and SecurityAdmin

Users authenticated with the Admin and SecurityAdmin RBAC roles may perform cryptographic functions assigned to the FIPS Crypto Officer, including the following:

-Perform encryption node initialization.

-Enable cryptographic operations.

-Manage critical security parameters (CSPs) input and output functions.

-Zeroize encryption CSPs.

-Register and configure a key vault.

-Configure a recovery share policy.

2	Fabric OS Command Reference
	53-1002746-01