HP StorageWorks MSA 2/8 - SAN Switch User manual

hp StorageWorks
fabric OS commands
version 3.1.x/4.1.x
Product Version: 3.1.x/4.1.x
Fabric OS Commands Version 3.1.x/4.1.x
Quick Reference Guide
Second Edition (June 2003)
Part Number: AA–RTE6B–TE
© Copyright 1999-2003 Hewlett-Packard Development Company, L.P.
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.
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.
Hewlett-Packard Company shall not be liable for technical or editorial
errors or omissions contained herein. The information is provided “as is”
without warranty of any kind and is subject to change without notice. The
warranties for Hewlett-Packard Company products are set forth in the
express limited warranty statements for such products. Nothing herein
should be construed as constituting an additional warranty.
Printed in the U.S.A.
quick
reference
guide
This document provides a quick reference to definitions of
specified commands.
Command Definition
agtcfgDefault Reset the SNMP agent
configuration to default
values.
agtcfgSet Modify the SNMP agent
configuration.
agtcfgShow Display the SNMP agent
configuration.
aliasDelete Delete a port from all local
groups.
aliasJoin Create or add a member to a
group of N_Ports.
aliasPurge Remove an alias group.
aliasShow Display local alias server
information.
aliAdd Add a member to a zone
alias.
aliCreate Create a zone alias.
aliDelete Delete a zone alias.
aliRemove Remove a member from a
zone alias.
aliShow Display zone alias
information.
backplanetest Run backplane connection
test for multiple blade
configured system.
backPort Run test for back-end
miniswitch to miniswitch links.
backSpace Set an alternate backspace
character.
bannerset Set the banner on the local
switch.
bannershow Display the banner text.
bcastShow Display broadcast routing
information.
bladeBeacon Set blade beaconing mode
on or off.
bladeDiag Run diagnostics on a switch
blade.
bladeDiagShort Run diagnostics on a switch
blade.
bladedisable Disable a blade.
bladeenable Enable a blade.
bladePropShow Display blade property.
bsn Display the serial number.
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands

Page 2
camTest Run functional test of the
CAM memory. Verify
QuickLoop's Content
Addressable Memory (CAM)
SID translation.
centralMemoryTest Test ASIC central memory
operation.
cfgactvshow Display effective zone
configuration information.
cfgAdd Add a member to a zone
configuration.
cfgClear Clear all zone configurations.
cfgCreate Create a zone configuration.
cfgDelete Delete a zone configuration.
cfgDisable Disable a zone configuration.
cfgEnable Enable a zone configuration.
cfgRemove Remove a member from a
zone configuration.
cfgSave Save zone configuration to
non-volatile memory.
cfgShow Display zone configuration
information.
cfgsize Display size details of the
zone database.
cfgTransAbort Abort the current zoning
transaction.
cfgtransshow Display information about
current zoning transaction.
chassisName Display or set the chassis
name for a StorageWorks
Core switch.
chassisShow Display all Field Replaceable
Units (FRUs).
chippropshow Display ASIC chip property
contents.
chipregshow Display port registers of a
given chip number.
cmemRetentionTest Test the data retention of the
central memory SRAMs.
cmiTest Verify the Control Message
Interface (CMI) bus between
ASICs.
configDefault Reset a subset of
configuration settings to the
default values.
configDownload Download the switch
configuration file from a host
system.
configShow Display system configuration
settings.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands
configUpload Create a backup file of switch
configuration information on
a host workstation.
configure Modify system configuration
settings.
crossPortTest Run functional test of port
external transmit and receive
path.
dataTypeShow Display sample data stream
types used in some
diagnostic commands.
date Display or set the switch date
and time.
dbgshow Display current values of
debug and verbosity levels of
the specified module.
diagClearError Clear the diag software flag
to allow for retest.
diagCommandShow Display a list of diagnostic
commands.
diagDisablePost Disable POST execution at
reboot.
diagEnablePost Enable POST execution at
next reboot.
diagesdports Set ESD skip ports list.
diagfaillimit Set diagnostics fail limit to a
specified value.
diagHelp Display diagnostic command
information.
diagloopid Set the diagnostics loop ID.
diagmodepr Enable or disable mode
messages.
diagpost Enable or disable POST
testing.
diagretry Enable or disable retry mode.
diagsetburnin Initialize the blade for a
burn-in run.
diagsetcycle Set diagnostic script
parameters.
diagshow Display diagnostics status.
diagshowtime Enable or disable elapsed
time messages.
diagsilkworm Enable or disable silkworm
mode.
diagskiptests Enable or disable diagnostics
skip test flags.
diagstopburnin Terminate a blade burn-in
run.
dlsReset Disable Dynamic Load
Sharing (DLS) option.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands

Page 3
dlsSet Enable DLS option.
dlsShow Display the setting of the DLS
option.
dnsconfig Set or display Domain Name
Service parameters.
errClear Clear the switch error log.
errDump Display the error log without
page breaks
errNvLogSizeSet Resize the persistent error
log.
errNvLogSizeShow Display the current persistent
(non-volatile) error log
configuration of a switch.
errSaveLvlSet Set error saving level of a
switch.
errSaveLvlShow Show current error save level
setting of a switch.
errShow Display the error log.
exit Log out from a shell session.
fabportshow Display fabric port
information.
fabretryshow Display the retry count of the
fabric commands.
fabricprincipal Set the Principal Switch
Selection mode.
fabricShow Display fabric membership
information.
fabstateclear Clear the fabric state
information.
fabstateshow Display the fabric state
information.
fabStatsShow Display the fabric statistics
information.
fabswitchshow Display the fabric switch state
structure information.
fanDisable Disable a fan unit.
fanEnable Enable a fan unit.
fanShow Display fan status.
fashow Display Fabric Assist
information.
faStatsShow Display statistics about Fabric
Assist.
fastboot Reboot the switch, bypassing
POST.
fazoneAdd Add a member to a Fabric
Assist zone.
fazoneCreate Create a Fabric Assist zone.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands
fazoneDelete Delete a Fabric Assist mode
zone.
fazoneRemove Remove members from a
Fabric Assist mode zone.
fazoneShow Display fazone information.
fcpprobeshow Display the FCP probe
information.
fcprlsshow Display the FCP RLS
information.
fdmicacheshow Display abbreviated remote
FDMI device information
according to remote domain
ID.
fdmishow Display detailed FDMI device
information.
filterTest Run frame filter test.
firmwareCommit Commit switch firmware
update.
firmwareDownload Download switch firmware
from a remote host or from a
local directory.
firmwaredownloadstatus Display the status of a
firmware download.
firmwarerestore Restore old active firmware
image.
firmwareshow Display the Fabric OS
versions on both partitions of
the local and remote CPs.
fporttest Run functional test of F->N,
N->F point to point path.
fspfShow Display FSPF protocol
information.
fwAlarmsFilterSet Enable or disable alarms for
Fabric Watch.
fwAlarmsFilterShow Display alarm filtering for
Fabric Watch.
fwClassInit Initialize all classes under
Fabric Watch.
fwConfigReload Reload the Fabric Watch
configuration.
fwConfigure Display and modify the
Fabric Watch configuration
and status.
fwFruCfg Display or modify FRU state
alert configuration.
fwHelp Display Fabric Watch
command information.
fwMailCfg Configure e-mail alerts in
Fabric Watch.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands

Page 4
fwsamshow Display the switch availability
monitor information.
fwSetToCustom Set boundary and alarm
levels to custom values.
fwSetToDefault Set boundary and alarm
levels to the default values.
fwShow Display the thresholds
monitored by Fabric Watch.
gbicShow Display serial ID GBIC
information.
h Display shell history.
haDisable Disable the High Availability
feature in the switch.
hadump Disable the High Availability
feature in the switch.
haEnable Enable the High Availability
feature in the switch.
haFailover Force the failover mechanism
so that the Standby CP
becomes the Active CP.
haShow Display Control Processor
(CP) status.
hasyncstart Enable the HA state
synchronizing process.
hasyncstop Disable the HA state
synchronizing process.
help Display help information for
commands.
historyLastShow Display last history log
record.
historymode Display or set the mode of the
history log.
historyShow Display the history log.
i Display task summary.
ifModeSet Set the link operating mode
for a network interface.
ifModeShow Display the link operating
mode for a network interface.
ifShow Display network interface
information.
interfaceShow Display FSPF interface
information.
iodReset Turn off the In-order Delivery
(IOD) option.
iodSet Enable the In-Order Delivery
(IOD) option.
iodShow Display the In-Order Delivery
(IOD) option setting.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands
ipAddrSet Set the IP Address details for
a switch or Control Processor.
ipAddrShow Display the IP address for a
switch or Control Processor.
islshow Display ISL information.
itemlist List parameter syntax and
grammar information.
killtelnet Terminate an open telnet
session.
ledtest Run LED diagnostics on a
switch blade and WWN.
licenseAdd Add license key to switch.
licenseHelp Show commands used to
administer license keys.
licenseIdShow Display system license ID.
licenseRemove Remove the license key from
a switch.
licenseShow Display current license keys.
linkCost Set or print the FSPF cost of a
link.
login Log in as a new user.
logout Log out from a shell session.
loopPortTest Test the L_port M->M path on
a loop..
LSDbShow Display the FSPF Link State
Database.
mcastShow Display multicast routing
information.
memshow Display the amount of free
and used memory in a
switch.
msCapabilityShow Display the Management
Server Capability.
msConfigure Configure the Management
Server.
msPlatShow Display the Management
Server Platform database.
msPlClearDB Clear the Management
Server Platform database on
all switches in the fabric.
msPlMgmtActivate Activate the Management
Server Platform service on all
switches in the fabric.
msPlMgmtDeactivate Deactivate the Management
Server Platform service on all
switches in the fabric.
msTdDisable Disable the Management
Server Topology Discovery
service.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands

Page 5
msTdEnable Enable the Management
Server Topology Discovery
service.
msTDReadConfig Display the status of the
Management Server
Topology Discovery service.
myid Display the current login
session details.
nbrStatsClear Reset FSPF interface counters.
nbrStateShow Display FSPF neighbor's
state.
nodefind Display all the device PIDs
matching a given WWN.
nsaliasshow Display local Name Server
information with aliases.
nsAllShow Display global Name Server
information.
nscamshow Display information about
remote devices in the Name
Server Cache.
nsShow Display local Name Server
information.
nsstatshow Display local Name Server
statistical information.
nszonemember Display the information of all
the online devices which are
zoned with the given device.
parityCheck Enable or disable DRAM
parity checking.
passwd Change system login name
and password.
pdshow Display data from a panic
dump file.
perfAddEEMonitor Add end-to-end monitor to a
port.
perfAddIPMonitor Add a filter-based monitor
for IP frame count.
perfAddReadMonitor Add a filter-based monitor
for the SCSI Read command.
perfAddRWMonitor Add a monitor for the SCSI
Read and Write commands.
perfAddSCSIMonitor Add a monitor for SCSI
frame count.
perfAddUserMonitor Add a user-defined
filter-based monitor.
perfAddWriteMonitor Add a filter-based monitor
for the SCSI Write command.
perfCfgClear Clear the previously saved
performance monitoring
configuration settings from
non-volatile memory.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands
perfCfgRestore Restore performance
monitoring configuration
settings from non-volatile
memory.
perfCfgSave Save performance monitoring
configuration settings to
non-volatile memory.
perfcleareemonitor Clear statistics counters of an
end-to-end monitor on a
port.
perfclearfiltermonitor Clear statistics counters of a
filter-based monitor.
perfClrAlpaCrc Clear an AL_PA device’s CRC
count by the port and AL_PA.
perfDelEEMonitor Delete an end-to-end monitor
on port.
perfDelFilterMonitor Delete a filter-based monitor.
perfHelp Display performance
monitoring help information.
perfSetPortEEMask Set overall mask for
end-to-end (EE) monitors.
perfShowAlpaCrc Display the AL_PA CRC count
by port or by AL_PA.
perfShowEEMonitor Display end-to-end monitor
information and frame traffic
on a port.
perfShowFilterMonitor Display filter-based monitor
information and frame traffic
for a port.
perfShowPortEEMask Display the current
end-to-end mask of a port.
pkicreate Create pki objects.
pkiremove Remove existing pki objects.
pkishow Display existing pki objects.
portcamshow Display port-based filter
CAM use.
portcfgdefault Restore the port configuration
to default values.
portCfgEport Enable or disable a port from
becoming an E_Port.
portCfgGport Designate a port as a locked
G_Port.
portcfgislmode Enable or disable ISL R_RDY
Mode on a port.
portCfgLongDistance Configure a port to support
long distance links.
portCfgLport Lock a port as an L_PORT.
portcfgpersistentdisable Disable a port persistently.
portcfgpersistentenable Enable a port persistently.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands

Page 6
portCfgShow Display port configuration
settings.
portCfgSpeed Configure the port speed.
portCfgTrunkport Configure a port to be
enabled or disabled for
trunking.
portdebug Set debug level and verbose
level of port modules.
portDisable Disable a switch port.
portEnable Enable a switch port.
portErrShow Display port error summary.
portflagshow Display the port status
bitmaps for all ports in a
switch
portLEDTest Exercise the user port LEDs.
portLogClear Clear the port log.
portLogDump Display the port log without
page breaks.
portLogDumpPort Display the port log of
specified port, without page
breaks.
portloginshow Display port logins.
portlogpdisc Set or clear the
debug_pdisc_flag.
portLogShow Display the port log.
portlogshowport Display the port log of
specified port, with page
breaks.
portLoopbackTest Run functional test of port
N->N path.
portname Assign or display a port
name.
portPerfShow Display port throughput
performance in bytes,
kilobytes, or megabytes.
portRegTest Run bit write/read test of the
ASIC SRAMs and registers.
portRouteShow Display routing tables for a
port.
portShow Display port status.
portstatsclear Clear the hardware statistics
of a specified switch port.
portStatsShow Display port hardware
statistics.
portswap Swap area numbers of two
switch ports.
portswapdisable Disable the portswap feature.
portswapenable Enable the portswap feature.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands
portswapshow Display information for any
ports where area ID numbers
have been swapped.
porttest Run functional test of a switch
in a live fabric.
porttestshow Retrieve information from the
current execution of the
porttest command.
powerOffListSet Display information from
porttest.
powerOffListShow Set slot power off list order.
psShow Display power supply status.
ptdatashow Display port data structures.
ptphantomshow Display the quick-loop CAM
tables.
ptpropshow Display port properties.
ptregshow Display ASIC port registers.
ptrouteshow Display port routing
properties.
ptstatsshow Display port statistics
properties.
qlDisable Disable QuickLoop mode.
qlEnable Enable QuickLoop mode.
qloopAdd Add a member to a
QuickLoop.
qloopCreate Create a QuickLoop.
qloopDelete Delete a QuickLoop.
qloopRemove Remove a member from a
QuickLoop.
qloopShow Display QuickLoop
information.
qlPartner Set a QuickLoop partner or
display information about a
partner.
qlPortDisable Disable a QuickLoop port.
qlPortEnable Enable a QuickLoop port.
qlPortShowAll Display QuickLoop port
information.
qlShow Display QuickLoop
information.
qlStatsShow Display QuickLoop statistics.
quietMode Toggle the shell quiet mode
on and off.
ramTest Run bit write and read test of
SDRAMs in the switch.
reboot Reboot the switch.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands

Page 7
routeHelp Display routing help
commands.
savecore Save or remove core files
created by daemons.
secfabricshow Display security-related fabric
information.
secfcsfailover Enable a Backup FCS switch
to take over as Primary FCS
switch.
sechelp Display information about
security telnet commands.
secmodedisable Disable security mode.
secmodeenable Enable security mode.
secmodeshow Display if security mode is
enabled or disabled.
secnonfcspasswd Set the admin password for
non-FCS switches.
secpolicyabort Abort all changes to the
defined database that have
not been saved.
secpolicyactivate Apply defined policy set to all
switches in the fabric.
secpolicyadd Add members to an existing
policy.
secpolicycreate Create a new policy.
secpolicydelete Delete an existing policy.
secpolicydump Show all members of existing
policies.
secpolicyfcsmove Move a member in the FCS
policy.
secpolicyremove Remove members from an
existing policy.
secpolicysave Save a defined security policy
to flash memory on all
switches in the fabric.
secpolicyshow Show an existing security
policy.
secstatsreset Reset security statistic for a
policy for all policies to zero.
secstatsshow Display security statistic for a
policy or for all policies.
sectemppasswdreset Reset a password on a
remote switch.
sectemppasswdset Set a temporary password on
a remote switch.
sectransabort Abort current security
transaction.
secversionreset Reset the version stamp to
zero.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands
sensorShow Display sensor readings.
setdbg Set debug level of the
specified module.
setesdmode Enable or disable ESD mode.
setgbicmode Enable or disable GBIC
mode.
setsfpmode Enable or disable SFP mode.
setSplbMode Enable or disable two-port
loopback.
setverbose Set verbose level of the
module to specified level.
sfpShow Display serial ID SFP
information.
slotOff Disable a blade slot.
slotOn Enable a blade slot.
slotpoweroff Power off a blade unit.
slotpoweron Power on a blade unit.
slotShow Display slot status.
snmpMibCapSet View and modify options for
configuring SNMP MIB trap
capability.
spinFab Test for Cascaded switch ISL
links.
spinSilk Run functional test of port
connection at maximum
switch speed.
sramRetentionTest Run data retention test of the
miscellaneous SRAMs in
ASIC.
snn Display and set the soft serial
number.
statsTest Run a statistics counter
diagnostic test.
stopporttest Terminate the running
porttest.
supportShow Print switch information for
debugging purposes.
switchBeacon Set switch beaconing mode
on or off.
switchcfgpersistentdisable Disable switch persistently.
switchcfgpersistentenable Enable switch persistently.
switchCfgSpeed Configure all ports of the
switch to a particular speed.
switchCfgTrunk Enable or disable trunking on
all the ports of a switch.
switchDisable Disable the switch.
switchEnable Enable the switch.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands

Page 8
switchName Display or set the switch
name.
switchReboot Halt and bring down the
operational switch.
switchShow Display switch and port
status.
switchShutdown Halt the operational switch.
switchStart Initialize the switch to
operational.
switchStatusPolicySet Set the policy parameters that
determine the overall switch
status.
switchStatusPolicyShow Display the policy parameters
that determine the overall
switch status.
switchStatusShow Display the overall status of
the switch.
switchuptime Display the amount of time
the switch has been
operating.
syslogdIpAdd Add the IP address of a
syslog daemon.
syslogdIpRemove Remove the IP address of a
syslog daemon.
syslogdIpShow Display all syslog daemon IP
addresses.
systemtest Run a series of diagnostic
tests on a switch blade.
systemverification Run a series of diagnostic
tests on all switches in a
fabric.
tempShow Display temperature
readings.
timeout Set or show the IDLE timeout
value for a login session.
topologyShow Display the unicast fabric
topology.
trackChangesHelp Display information on
track-changes feature
commands.
trackChangesSet Enable configuring of
track-changes feature.
trackChangesShow Display status of
track-changes feature.
trunkDebug Debug a trunk link failure.
trunkShow Display trunking information.
tsclockserver Display or set the NTP Server
address.
tshelp Display the time service
commands.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands
tstimezone Display or set the system time
zone.
turboRamTest Run turbo SRAM logic test for
2 Gb ASICs.
txdpathtest Run functional test of TXA
and TXD connections.
uptime Display length of time the
system has been operational.
uRouteConfig Configure a static route.
uRouteRemove Remove a static route.
uRouteShow Display unicast routing
information.
version Display firmware version
information.
wwn View WWN of a switch.
zoneAdd Add a member to the zone.
zoneCreate Create a zone.
zoneDelete Delete a zone.
zoneHelp Display help information on
zone commands.
zoneRemove Remove a member from a
zone.
zoneShow Display zone information.
Command Definition
Legend: v3.1 unique commands
v4.1 unique commands
v3.1 and v4.1 commands