Dell M5424 Command Reference Guide

53-1002746-01

®

14 December 2012

Fabric OS

Command Reference

Supporting Fabric OS v7.1.0

Copyright © 1999- 2012 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
Brocade Communications Systems, Inc.
130 Holger Way
San Jose, CA 95134
Tel: [phone]
Fax: [phone]
E-mail: [e-mail]

European Headquarters
Brocade Communications Switzerland Sàrl
Centre Swissair
Tour B - 4ème étage
29, Route de l'Aéroport
Case Postale 105
CH-1215 Genève 15
Switzerland
Tel: [phone]
Fax: [phone]
Email: [e-mail]

Asia-Pacific Headquarters
Brocade Communications Systems China HK, Ltd.
No. 1 Guanghua Road
Chao Yang District
Units 2718 and 2818
Beijing 100020, China
Tel: [phone]
Fax: [phone]
E-mail: [e-mail]

Asia-Pacific Headquarters
Brocade Communications Systems Co., Ltd. (Shenzhen
WFOE)
Citic Plaza
No. 233 Tian He Road North
Unit 1308 – 13th Floor
Guangzhou, China
Tel: [phone]
Faz: [phone]
E-mail: [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.

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.

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.

October 2007

March 2008

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

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

support Encryption. Modified 1
command. Updated Preface
and RBAC/AD table.

Fabric OS Command Reference 53-1001186-01 Added 14 new commands to

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.

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

command options. Modified 16
help pages for minor updates
and corrections.

Fabric OS Command Reference 53-1001764-01 Added 8 new commands.

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.

July 2008

August 2008

November 2008

July 2009

January 2010

March 2010

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.

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.

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.

Modified 100 commands to
support Fabric OS v7.1.0
features. Removed 6
commands. Updated Preface,
surrounding chapters, and
permission tables.

April 2011

December 2011

December 2012

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

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi

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
DCX-4S Backbone

• FC8-16 port blade

• FC8-32 port blade

• FC8-48 port blade

• FC8-64 port blade

• FCOE10-24 DCX blade

• FS8-18 Encryption blade

• FX8-24 Extension blade

Brocade DCX 8510-8 backbone
Brocade DCX 8510-4 backbone

• FC8-32E port blade

• FC8-48E port blade

• FC8-64 port blade

• FC16-32 port blade

• FC16-48 port blade

• FS8-18 Encryption blade

• FX8-24 Extension blade

8 Gbit 512-port core fabric backbone
8 Gbit 192-port core fabric backbone

• 8 Gbit 16-port blade

• 8 Gbit 32-port blade

• 8 Gbit 84-port blade

• 8 Gbit 84-port blade

• 10 Gbit 6-port ISL blade

• 8 Gbit 24-port blade

*

• 4 Gbit 16-FC port, 2 GbE port router blade

• 8 Gbit 16-port encryption blade

• 8 Gbit 12-FC ports, 10 GbE ports, 2 10GbE ports

16 Gbit 192-port core fabric backbone
16 Gbit 384-port core fabric backbone

• 8 Gbit 32-port blade

• 8 Gbit 48-port blade

• 8 Gbit 84-port blade

• 16 Gbit 32-port blade

• 16 Gbit 48-port blade

• 8 Gbit 24-port blade

• 8 Gbit 16-port encryption blade

• 8 Gbit 12-FC ports, 10 GbE ports, 2 10GbE ports

Condor 2
Condor 2

• Condor 2

• Condor 2

• Condor 2

• Condor 2

• Condor

• Anvil/Condor 2

• Condor

• Condor 2

• Condor 2

Condor 3
Condor 3

• Condor 3

• Condor 3

• Condor 2

• Condor 3

• Condor 3

• Anvil/Condor 2

• Condor 2

• 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

italic text Provides emphasis

code text Identifies CLI output

Identifies GUI elements
Identifies keywords and operands
Identifies text to enter at the GUI or CLI

Identifies variables
Identifies paths and Internet addresses
Identifies document titles

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

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.

or

xxiv Fabric OS Command Reference

53-1002746-01

Notes, cautions, and warnings

NOTE

ATTENTION

CAUTION

DANGER

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

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

An Attention statement indicates potential damage to hardware or data.

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

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

IBM Tivoli Key Lifecycle Manager

Legato Legato Networker

(ESKM)

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

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

1

Fabric OS Command Reference 1
53-1002746-01

Understanding Role-Based Access Control

NOTE

1

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 Ta b le 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

Operator A subset of administrative tasks typically required for routine

SwitchAdmin Administrative use excluding security, user management, and zoning.

ZoneAdmin Zone management only.

FabricAdmin Administrative use excluding user management and Admin Domain

BasicSwitchAdmin A subset of administrative tasks, typically of a more limited scope and

Admin All administrative tasks, including encryption and chassis commands.

SecurityAdmin Administrative use including admin, encryption, security, user

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”,

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.

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.

maintenance operations.

management.

effect.

management, and zoning.

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