HP StorageWorks 8B - FC Entry Switch User manual

reference manual
version 3.0
fabric os
www.hp.com

Notice
© Hewlett-Packard Company, 2001. All rights reserved.
Edition: E1201
Hewlett-Packard Company makes no warranty of any kind with
regard to this material, including, but not limited to, the implied
warranties of merchantability and fitness for a particular purpose.
Hewlett-Packard shall not be liable for errors contained herein or for
incidental or consequential damages in connection with the
furnishing, performance, or use of this material.
This document contains proprietary information, which is protected
by copyright. No part of this document may be photocopied,
reproduced, or translated into another language without the prior
written consent of Hewlett-Packard. The information contained in
this document is subject to change without notice.
Use, duplication, or disclosure by government is subject to
restrictions as set forth in subdivision (c) (1) (ii) of the Rights in
Technical Data and Computer Software Clause at DFARS
252.227.7013.
Warranty
If you have any questions about the warranty for this product,
contact your dealer or local Hewlett-Packard sales representative.
Trademarks
BROCADE, the Brocade B weave logo, Brocade: the Intelligent
Platform for Networking Storage, SilkWorm, and SilkWorm
Express, are trademarks or registered trademarks of Brocade
Communications Systems, Inc. or its subsidiaries in the United
States and/or in other countries.
All other brands, product or service names are or may be trademarks
or service marks of, and are used to identify products of services of
their respective owners.
Safety notices
Any servicing, adjustment, maintenance, or repair must be
performed only by authorized service-trained personnel.

Fabric OS Reference iii
Contents
Preface
About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Related Publications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
System Requirements and Compatibility. . . . . . . . . . . . . . . . . . . . . . . . xiii
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Getting Software Updates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Chapter 1 Telnet Commands
agtcfgDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
agtcfgSet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
agtcfgShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
aliasShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
aliAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
aliCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
aliDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
aliRemove. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11
aliShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
backSpace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13
bcastShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-14
camTest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-15
centralMemoryTest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-16
cfgAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18
cfgClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-19
cfgCreate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-20
cfgDelete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21
cfgDisable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-22

iv Fabric OS Reference
cfgEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-23
cfgRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-24
cfgSave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-25
cfgShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-26
cfgTransAbort. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-28
cmemRetentionTest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-29
cmiTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-30
configDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-32
configDownload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-33
configShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-35
configUpload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-37
configure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-39
crossPortTest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-47
date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-51
diagClearError . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-52
diagDisablePost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-53
diagEnablePost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-54
diagHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-55
diagShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-56
dlsReset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-58
dlsSet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59
dlsShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-60
errDisplayFilter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-61
errDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-62
errShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-63
fabricShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-68
fanShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-69
fastboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-70
filterTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-71
firmwareDownload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-73

Fabric OS Reference v
fspfShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-75
fwAlarmsFilterSet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-77
fwAlarmsFilterShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-78
fwClassInit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-79
fwConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-80
fwConfigReload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-83
fwHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-84
fwMailCfg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-85
fwSetToCustom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-87
fwSetToDefault. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-88
fwShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-89
gbicShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-91
h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-93
help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-94
i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-95
ifModeSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-97
ifModeShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-98
ifShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-99
interfaceShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-100
InteropMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-103
iodReset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-105
iodSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-106
iodShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-107
ipAddrSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-108
ipAddrShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-109
islShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-110
islTopoCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-111
islTopoShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-112
licenseAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-114
licenseHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-115

vi Fabric OS Reference
licenseRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-116
licenseShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-117
linkCost. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-118
login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-119
logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-120
LSDbShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-121
mcastShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-124
msConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-125
msPlatShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-127
msPlClearDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-128
msPlCapabilityShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-129
msPlMgmtActivate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-130
msPlMgmtDeactivate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-131
msTDEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-132
msTDDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-133
nbrStatsClear. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-134
nbrStateShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-135
nsAllShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-136
nsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-137
parityCheck. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-139
passwd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-140
perfAddEEMonitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-142
perfAddIPMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-144
perfAddReadMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-145
perfAddRWMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-146
perfAddSCSIMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-147
perfAddUserMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-148
perfAddWriteMonitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-150
perfCfgClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-151
perfCfgRestore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-152

Fabric OS Reference vii
perfCfgSave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-153
perfClrAlpaCrc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-154
perfDelEEMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-155
perfHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-156
perfDelFilterMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-157
perfSetPortEEMask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-158
perfShowAlpaCrc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-160
perfShowEEMonitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-161
perfShowFilterMonitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-163
perfShowPortEEMask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-165
portCfgEport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-167
portCfgGport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-168
portCfgLport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-169
portCfgLongDistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-170
portcfgMcastLoopback. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-172
portCfgShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-174
portCfgSpeed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-176
portCfgTrunkport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-177
portDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-178
portEnable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-179
portErrShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-180
portLogClear. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-182
portLogDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-183
portLogShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-184
portLoopbackTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-190
portPerfShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-192
portRegTest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-193
portRouteShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-195
portShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-197
portStatsShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-200

viii Fabric OS Reference
psShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-202
qloopAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-203
qloopCreate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-204
qloopDelete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-205
qloopRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-206
qloopShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-207
qlDisable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-209
qlEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-210
qlPartner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-211
qlPortDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-212
qlPortEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-213
qlPortShowAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-214
qlShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-215
qlStatsShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-217
quietMode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-218
ramTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-219
reboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-221
routeHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-222
setGbicMode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-223
setSplbMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-224
sgroupDelete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-225
sgroupRename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-226
sgroupSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-227
sgroupShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-229
sgroupSupportShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-231
sgroupSwReplace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-233
snmpMibCapSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-235
spinFab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-236
spinSilk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-239
sramRetentionTest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-244

Fabric OS Reference ix
statsTest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-245
supportShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-246
switchBeacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-248
switchCfgSpeed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-249
switchCfgTrunk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-250
switchDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-251
switchEnable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-252
switchName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-253
switchShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-254
switchStatusPolicySet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-257
switchStatusPolicyShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-259
switchStatusShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-261
syslogdIpAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-262
syslogdIpRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-263
syslogdIpShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-264
tempShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-265
timeOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-266
topologyShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-267
trackChangesSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-269
trackChangesShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-270
trunkDebug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-271
trunkShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-272
turboRamTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-273
uptime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-275
uRouteConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-277
uRouteRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-278
uRouteShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-279
version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-281
zoneAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-282
zoneCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-283

xFabric OS Reference
zoneDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-285
zoneRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-286
zoneShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-287
Chapter 2 Error Messages
System Error Message Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Displaying Error Messages Using Telnet . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Resetting Bad Ports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Post Test Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Diagnostic Test Failure and Recovery Actions. . . . . . . . . . . . . . . . . . . . 3-4
Error Message Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Diagnostic Error Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
System Error Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Fabric Watch Error Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
Chapter 3 Licensed Telnet Commands
Zoning Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
QuickLoop Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
QuickLoop Fabric Assist Mode Commands. . . . . . . . . . . . . 4-3
Extended Fabric Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Fabric Watch Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
FC 6164 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Trunking Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Performance Monitoring Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Glossary
Index

Fabric OS Reference xi
Preface
Fabric OS Reference contains descriptions for the telnet commands used to administer and
configure HP Brocade switches (HP Surestore FC 1Gb/2Gb Entry Switch 8B, HP Surestore FC
1Gb/2Gb Switch 8B, HP Surestore FC 1Gb/2Gb Switch 16B, HP Brocade 2400 and 2800 switches,
and HP Surestore FC Switch 6164).
About This Guide
This guide provides the following information about Fabric OS:
Related Publications
Related product information can be found in the following publications.
Provided with the FC Entry Switch 8B and FC Switch 8B:
•HP Surestore FC 1Gb/2Gb Entry Switch 8B and FC 1Gb/2Gb Switch 8B Getting Started
Guide (A7346-90902)
•HP Surestore FC 1Gb/2Gb Entry Switch 8B and FC 1Gb/2Gb Switch 8B Documentation
CD (A7346-11001)
Chapter 1
Telnet Commands Provides a detailed description of the telnet commands in the Fabric OS.
Chapter 2
Error Messages Provides error message formats as well as a list of error messages with descriptions.
Chapter 3
Licensed Telnet Commands Provides a summary of telnet commands that are available with licensed products such as Zoning, Quickloop, or Fabric Watch.

xii Fabric OS Reference
Provided on the FC Entry Switch 8B and FC Switch 8B Documentation CD, and at the HP Web site
at http://www.hp.com/support/fc8B:
•HP Surestore FC 1Gb/2Gb Entry Switch 8B and FC 1Gb/2Gb Switch 8B Getting Started
Guide (A7346-90902)
•HP Surestore FC 1Gb/2Gb Entry Switch 8B and FC 1Gb/2Gb Switch 8B Installation and
Reference Guide
•Fabric OS Reference Manual, version 3.0
•Fabric OS Procedures Guide, version 3.0
•Fabric OS Version 3.0.1b Release Notes
•Fabric Watch User’s Guide, version 3.0
•QuickLoop User’s Guide, version 3.0
•Web Tools User’s Guide, version 3.0
•Distributed Fabrics User’s Guide, version 3.0
•Zoning User’s Guide, version 3.0
•MIB Reference Manual, version 3.0
•ISL Trunking User’s Guide, version 3.0
•Advanced Performance Monitoring User’s Guide, version 3.0
•Merging Heterogeneous Fabrics Instructions
Provided with the FC 16B:
•HP Surestore FC 1Gb/2Gb Switch 16B Quick Start Guide (A7340-96002)
•HP Surestore FC 1Gb/2Gb Switch 16B Documentation CD (A7340-11001)
Provided on the FC 1Gb/2Gb Switch 16B Documentation CD and at the HP Web site at
http://www.hp.com/support/fc16B:
•HP Surestore FC 1Gb/2Gb Switch 16B Quick Start Guide (A7340-96002)
•HP Surestore FC 1Gb/2Gb Switch 16B Installation and Reference Guide
•Fabric OS Reference Manual, version 3.0
•Fabric OS Procedures Guide, version 3.0
•Fabric OS Version 3.0.1 Release Notes
•Fabric Watch User’s Guide, version 3.0
•QuickLoop User’s Guide, version 3.0
•Web Tools User’s Guide, version 3.0
•Distributed Fabrics User’s Guide, version 3.0
•Zoning User’s Guide, version 3.0
•MIB Reference Manual, version 3.0
•ISL Trunking User’s Guide, version 3.0
•Advanced Performance Monitoring User’s Guide, version 3.0
•Merging Heterogeneous Fabrics Instructions
Information about Fibre Channel standards and Fibre Channel in general can be found on the Fibre
Channel Industry Association Web site, located at http://www.fibrechannel.com.

Fabric OS Reference xiii
System Requirements and Compatibility
Compatibility with other Products
Fabric OS version 3.0.1b or later can be installed and run on the FC Entry Switch 8B, FC Switch
8B, and FC 16B products.
The FC Entry Switch 8B, FC Switch 8B, and the FC 16B switch running Fabric OS version 3.0.1b
or later can operate in the same fabric with the HP Brocade 2400/2800 and FC 6164 switches
running the a2.4.1 or later versions of Fabric OS.
For more information about configuring FC Entry Switch 8B, FC Switch 8B, FC 16B, HP Brocade
2400/2800, and FC 6164 products to operate in the same fabric, contact your switch supplier.
Getting Help
For information for the FC Entry Switch 8B and FC Switch 8B, visit the HP Web site at
http://www.hp.com/support/fc8B. For the most current technical support information for the FC 16B,
visit the HP Web site at http://www.hp.com/support/fc16B. This includes hardware and software
support, all repairs, and spare components.
Be prepared to provide the following information to the support personnel:
•Switch serial number
•Switch world wide name
•Output from the supportShow telnet command
•Detailed description of the problem
•Topology configuration
•Troubleshooting steps already performed
Getting Software Updates
For information on obtaining software updates contact your HP account representative or technical
support.

xiv Fabric OS Reference

Fabric OS Reference 1-1
Chapter
1
Telnet Commands
agtcfgDefault
Reset the SNMP agent configuration to default values.
Synopsis agtcfgDefault
Availability admin
Description Use this command to reset the configuration of the SNMP agent to default values:
•sysDescr - The default value is Fibre Channel Switch.
•sysLocation - The default value is End User Premise.
•sysContact - The default value is Field Support.
•swEventTrapLevel - The default value is 0 (off).
•authTraps - The default value is 0 (off).
•The IP addresses of the trap recipient for each community defaults to 0.0.0.0 or no trap
recipient. The 6 communities are:
Community 1: Secret C0de
Community 2: OrigEquipMfr
Community 3: private
Community 4: public
Community 5: common
Community 6: FibreChannel
Note: For more information about SNMP configuration parameters refer to the agtcfgSet
command.
Operands None.

1-2 Fabric OS Reference
Telnet Commands
1
Example To set the SNMP agent configuration parameters to default values, and verify they were set:
See Also agtcfgSet
agtcfgShow
switch:admin> agtcfgDefault
Committing configuration...done.
agent configuration reset to factory default
switch:admin>
switch:admin> agtcfgShow
Current SNMP Agent Configuration
Customizable MIB-II system variables:
sysDescr = Fibre Channel Switch.
sysLocation = End User Premise
sysContact = Field Support.
swEventTrapLevel = 0
authTraps = 0 (OFF)
SNMPv1 community and trap recipient configuration:
Community 1: Secret C0de (rw)
No trap recipient configured yet
Community 2: OrigEquipMfr (rw)
No trap recipient configured yet
Community 3: private (rw)
No trap recipient configured yet
Community 4: public (ro)
No trap recipient configured yet
Community 5: common (ro)
No trap recipient configured yet
Community 6: FibreChannel (ro)
No trap recipient configured yet
switch:admin>

Fabric OS Reference 1-3
Telnet Commands 1
agtcfgSet
Modify the SNMP agent configuration.
Synopsis agtcfgSet
Availability admin
Description Use this command to modify the configuration of the SNMP agent in the switch. Set the values for
the following items:
•sysDescr - Specify the switch description (in MIB-II definition). The default value is
Fibre Channel Switch.
•sysLocation - Specify the location of the switch (in MIB-II). The default value is End
User Premise.
•sysContact - Specify the contact information for this switch. The default value is Field
Support.
•swEventTrapLevel - Specify the event trap level in conjunction with an event's severity
level. When an event occurs, and if its severity level is at or below the set value (that is, more
critical), the SNMP trap, swEventTrap, is sent to configured trap recipients. The default
value is 0 which means that no swEventTrap is sent. Possible values are:
0 - None
1 - critical
2 - error
3 - warning
4 - informational
5 - debug
See errShow for more information.
•authTrapsEnabled - Specify whether authorization traps are passed to the trap recipient.
The default value is False (off), meaning no messages are sent. A value of True (on) means that
authorization trap messages are sent to the community IP addresses configured below. For
SNMPv1 and SNMPv2c, this indicates that a request containing a community string is not
known to the agent.
•There are six communities, each with a respective trap recipient, supported by the agent. The
first three communities are for read-write access (rw) and the last three are for read-only access
(ro).
Specify the IP address for each management station:
Community 1: Secret C0de - The default value for this trap recipient is '0.0.0.0'.
Community 2: OrigEquipMfr - The default value for this trap recipient is '0.0.0.0'.
Community 3: private - The default value for this trap recipient is '0.0.0.0'.
Community 4: public - The default value for this trap recipient is '0.0.0.0'.
Community 5: common - The default value for this trap recipient is '0.0.0.0'.
Community 6: FibreChannel - The default value for this trap recipient is '0.0.0.0'.

1-4 Fabric OS Reference
Telnet Commands
1
Operands None.
Example To modify the SNMP configuration values:
Note: The current value for each item is displayed in brackets.
See Also agtcfgDefault
agtcfgShow
switch:admin> agtcfgSet
Customizing MIB-II system variables ...
At each prompt, do one of the following:
o <Return> to accept current value,
o enter the appropriate new value,
o <Control-D> to skip the rest of configuration, or
o <Control-C> to cancel any change.
To correct any input mistake:
<Backspace> erases the previous character,
<Control-U> erases the whole line,
sysDescr: [FC Switch]
sysLocation: [End User Premise]
sysContact: [Field Support]
swEventTrapLevel: (0..5) [3] 4
authTrapsEnabled (true, t, false, f): [true]
SNMP community and trap recipient configuration:
Community (rw): [Secret C0de]
Trap Recipient's IP address in dot notation: [192.168.1.51]
Community (rw): [OrigEquipMfr]
Trap Recipient's IP address in dot notation: [192.168.1.26]
Community (rw): [private]
Trap Recipient's IP address in dot notation: [0.0.0.0]
192.168.64.88
Community (ro): [public]
Trap Recipient's IP address in dot notation: [0.0.0.0]
Community (ro): [common]
Trap Recipient's IP address in dot notation: [0.0.0.0]
Community (ro): [FibreChannel]
Trap Recipient's IP address in dot notation: [0.0.0.0]
switch:admin>

Fabric OS Reference 1-5
Telnet Commands 1
agtcfgShow
Display the SNMP agent configuration.
Synopsis agtcfgShow
Availability All users
Description Use this command to display the configuration of the SNMP agent in the switch. The following
information is displayed:
•sysDescr - Displays the switch description.
•sysLocation - Displays the location of the switch.
•sysContact - Displays the contact information for this switch.
•swEventTrapLevel - Displays the event trap level. Possible values are:
0 - None
1 - critical
2 - error
3 - warning
4 - informational
5 - debug
Note: See errshow for more information on the event trap level.
•authTraps - Displays whether authorization traps are passed to the trap recipient. The
default value is 0 (off), meaning no messages are sent. A value of 1 (on) means that
authorization trap messages are sent to the community IP addresses configured below. For
SNMPv1 and SNMPv2c, this indicates that a request containing a community string is not
known to the agent.
•There are six communities, each with a respective trap recipient, supported by the agent. The
first three communities are for read-write access (rw) and the last three are for read-only access
(ro).
For an SNMP Management Station to receive a trap generated by the agent, the admin user
must configure a trap recipient IP address of the Management Station.
Community 1: Secret C0de - Displays the IP address for this trap recipient.
Community 2: OrigEquipMfr - Displays the IP address for this trap recipient.
Community 3: private - Displays the IP address for this trap recipient.
Community 4: public - Displays the IP address for this trap recipient.
Community 5: common - Displays the IP address for this trap recipient.
Community 6: FibreChannel - Displays the IP address for this trap recipient.
Note: For more information about these SNMP configuration parameters refer to the agtcfgset
command.
Operands None.

1-6 Fabric OS Reference
Telnet Commands
1
Example To display SNMP agent configuration information:
See Also agtcfgDefault
agtcfgSet
switch:admin> agtcfgShow
Current SNMP Agent Configuration
Customizable MIB-II system variables:
sysDescr = FC Switch
sysLocation = End User Premise
sysContact = Field Support.
swEventTrapLevel = 3
authTraps = 1 (ON)
SNMPv1 community and trap recipient configuration:
Community 1: Secret C0de (rw)
Trap recipient: 192.168.1.51
Community 2: OrigEquipMfr (rw)
Trap recipient: 192.168.1.26
Community 3: private (rw)
No trap recipient configured yet
Community 4: public (ro)
No trap recipient configured yet
Community 5: common (ro)
No trap recipient configured yet
Community 6: FibreChannel (ro)
No trap recipient configured yet