HP StorageWorks MSA 2/8, StorageWorks Fabric OS 3.1, StorageWorks Fabric OS 4.1 Quick Reference Manual

quick

reference

guide

hp StorageWorks

fabric OS commands

version 3.1.x/4.1.x

Product Version: 3.1.x/4.1.x

© 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.

Fabric OS Commands Version 3.1.x/4.1.x
Quick Reference Guide
Second Edition (June 2003)
Part Number: AA–RTE6B–TE

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

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Page 2

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Page 3

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Page 4

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Page 5

Command Definition

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.

Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Page 6

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Page 7

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Command Definition

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.
Legend: v3.1 unique commands

v4.1 unique commands

v3.1 and v4.1 commands

Page 8