Command Book

S e n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o m .
Cisco MDS 9000 Family Command Reference, Release 2.x

Cisco MDS SAN-OS Release 2.0(1b) through Release 2.1(1a) April 2005
Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 526-4100
Text Part Number: OL-6970-03
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS. THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY. The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCBs public domain version of the UNIX operating system. All rights reserved. Copyright 1981, Regents of the University of California. NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED AS IS WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. CCSP, CCVP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Empowering the Internet Generation, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, StrataView Plus, TeleRouter, The Fastest Way to Increase Your Internet Quotient, and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries. All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0502R) Cisco MDS 9000 Family Command Reference Copyright 20022005 Cisco Systems, Inc. All rights reserved.
CONTENTS
Preface
xxvii xxvii xxvii xxviii xxix
Audience
Organization
Document Conventions Related Documentation
Obtaining Documentation xxx Cisco.com xxx Documentation DVD xxx Ordering Documentation xxx Documentation Feedback
xxxi
Cisco Product Security Overview xxxi Reporting Security Problems in Cisco Products Obtaining Technical Assistance xxxii Cisco Technical Support Website xxxii Submitting a Service Request xxxii Definitions of Service Request Severity xxxiii Obtaining Additional Publications and Information
1
xxxi
xxxiii
CHAPTER
CLI Overview
1-1 1-2 1-3
About the Switch Prompt
About the CLI Command Modes
Understanding CLI Command Hierarchy 1-4 EXEC Mode Options 1-5 Configuration Mode 1-6 Configuration Mode Commands and Submodes Navigating Through CLI Commands 1-9 Getting Help 1-9 Command Completion 1-9 Using the no and Default Forms of Commands Entering CLI Commands 1-10 Viewing Switch Configurations 1-10 Saving a Configuration 1-13 Clearing a Configuration 1-13
1-6
1-10
Cisco MDS 9000 Family Command Reference OL-6970-03, Cisco MDS SAN-OS Release 2.x
iii
Contents
Searching and Filtering CLI Output 1-13 Multiple Filter Commands 1-14 Searching and Filtering CLI Output Examples 1-15 Displaying Users 1-18 Sending Messages to Users 1-18 Using the ping Command 1-18 Using traceroute 1-19 Setting the Switchs Shell Timeout 1-19 Displaying VTY Sessions 1-19 Clearing VTY Sessions 1-20 Setting the Switchs Terminal Timeout 1-20 Setting the Switchs Terminal Type 1-20 Setting the Switchs Terminal Length 1-21 Setting the Switchs Terminal Width 1-21 Displaying Terminal Settings 1-21 About Flash Devices 1-22 Internal bootflash: 1-22 External CompactFlash (Slot0)
1-22 1-23
Formatting Flash Disks and File Systems Initializing bootflash: 1-23 Formatting Slot0: 1-23
Using the File System 1-24 Setting the Current Directory 1-24 Displaying the Current Directory 1-24 Listing the Files in a Directory 1-25 Creating a New Directory 1-25 Deleting an Existing Directory 1-25 Moving Files 1-25 Copying Files 1-26 Deleting Files 1-26 Displaying File Contents 1-26 Saving Command Output to a File 1-27 Compressing and Uncompressing Files 1-27 Displaying the Last Line in a File 1-28 Executing Commands Specified in a Script 1-28 Setting the Delay Time 1-29 Role-Based CLI
1-29 1-30
Using Valid Formats and Ranges
Cisco MDS 9000 Family Command Reference
iv
OL-6970-03, Cisco MDS SAN-OS Release 2.x
Contents
Using Debug Commands 1-31 Generating debug Command Output 1-32 Redirecting debug and Error Message Output 1-32 Enabling Message Logging 1-33 Setting the Message Logging Levels 1-33 Limiting the Types of Logging Messages Sent to the Console 1-34 Logging Messages to an Internal Buffer 1-34 Limiting the Types of Logging Messages Sent to Another Monitor 1-34 Logging Messages to a UNIX Syslog Server 1-35 Limiting Messages to a Syslog Server 1-35
2
CHAPTER
A Commands
2-1 2-2 2-3 2-4 2-6 2-7
aaa accounting logsize aaa accounting default aaa authentication login
aaa authentication dhchap default aaa authentication iscsi default aaa group server abort arp
2-10 2-11 2-8
active equals saved

2-12 2-13 2-14
attach module attribute qos
autonomous-fabric-id (IVR topology database configuration) autonomous-fabric-id (IVR service group configuration) autonomous-fabric-id database
3
2-19 2-17
2-15
CHAPTER
B Commands banner motd boot bport

3-4 3-6
3-1 3-2
bport-keepalive broadcast
4
3-8
3-7
CHAPTER
C Commands callhome
4-1 4-2 4-4
callhome test
Contents
cd cdp
4-5 4-6 4-8 4-10
cfs distribute cimserver class

4-13
channel mode active

4-11
clear accounting log clear arp-cache clear cdp clear cores

4-18 4-19 4-16
4-15
clear callhome session
4-17
clear counters (EXEC mode)
4-20 4-21
clear counters (SAN extension N port configuration mode) clear crypto ike domain ipsec sa clear crypto sa domain ipsec clear debug-logfile clear device-alias clear dpvm
4-26 4-27 4-24 4-25 4-22 4-23
clear fabric-binding statistics clear fcanalyzer clear fcflow stats clear fcns statistics clear fcs statistics clear fctimer session clear ficon
4-33 4-34 4-28 4-29 4-30 4-31 4-32
clear fspf counters clear ips arp clear license clear line clear ntp clear logging
4-41 4-36
clear ip access-list counters clear ivr zone database

4-38 4-39 4-40 4-37
4-35
clear port-security clear processes log
4-42 4-44
vi
Contents
clear qos statistics clear radius session clear rlir
4-47 4-48 4-49 4-50 4-45 4-46
clear role session clear rscn statistics
clear scheduler logfile clear screen clear ssh hosts

4-51
clear scsi-flow statistics

4-53
4-52
clear system reset-reason clear tacacs+ session clear tlport alpa-cache clear user clear vrrp clear zone clock
4-60 4-62 4-63 4-64 4-65 4-66 4-67 4-57 4-58 4-59 4-55
4-54
4-56
code-page clock set code-page commit contract-id copy

4-68
configure terminal copy licenses

4-71
crypto global domain ipsec security-association lifetime crypto ike domain ipsec crypto ike enable crypto ipsec enable
4-75 4-76 4-77 4-73 4-74
4-72
crypto ike domain ipsec rekey sa
crypto map domain ipsec (configuration mode) crypto transform-set domain ipsec customer-id
4-82 4-80
crypto map domain ipsec (interface configuration submode)
4-79
vii
Contents
CHAPTER
D Commands delete
5-3
5-1 5-2
data-pattern-file
destination interface destination-profile device-alias abort device-alias commit device-alias database device-alias distribute device-alias name dir
5-16 5-18
5-6 5-8 5-10 5-11 5-12 5-13 5-14
device-alias import fcalias

5-15
disable
discover custom-list discover scsi-target distribute do

5-23 5-25 5-26 5-22
5-19 5-20
dpvm abort dpvm activate
dpvm auto-learn dpvm commit dpvm database
5-27 5-29 5-30 5-31
dpvm database copy active dpvm database diff dpvm distribute dpvm enable dscp
5-36 5-35 5-32 5-34
duplicate-message throttle
6
5-37
CHAPTER
Debug Commands debug aaa debug all debug biosd debug bootvar debug callhome
6-2 6-4 6-5
6-1
6-6 6-7
viii
Contents
debug cdp debug cfs debug core debug dpvm debug dstats debug ethport
6-9 6-11 6-13
debug cimserver
6-14
debug device-alias
6-17 6-19 6-20
6-15
debug exceptionlog debug fabric-binding debug fc-tunnel debug fc2 debug fc2d debug fcc debug fcfwd debug fcns debug fcs debug fdmi debug ficon debug flogi debug fm debug fspf debug idehsd debug ike debug ipacl debug ipconf debug ipfc debug ips debug ipsec debug isns debug ivr
6-27 6-30 6-32 6-25
6-22 6-23
debug fcdomain
6-38 6-40
6-34
6-36
debug fcsp-mgr
6-44 6-46 6-48 6-50 6-52
6-42
debug hardware arbiter

6-56 6-57 6-58
6-55
debug ilc_helper
6-59 6-60 6-61 6-62 6-64 6-66 6-68
ix
Contents
debug klm debug logfile debug mcast debug mip debug ntp debug port debug qos debug radius debug rd-reg debug rib debug rlir debug rscn debug rdl errors
6-90 6-91 6-92 6-93 6-70 6-72 6-73 6-75 6-77 6-78
debug license
debug module
6-79
debug platform
6-82
6-80
debug port-channel
6-85 6-86 6-88
6-84
6-89
debug san-ext-tuner debug scsi-flow debug scsi-target debug security debug sensor debug snmp debug span debug tacacs+ debug tcap debug tlport debug ttyd debug vni debug vrrp debug vsan debug wr-reg debug wwn debug xbar
6-99 6-100 6-102 6-95
6-97 6-98
debug system health

6-106 6-108 6-109 6-110 6-111 6-112 6-114 6-116 6-117 6-119
6-104
Contents
debug xbc debug zone
7
6-120 6-121
CHAPTER
E Commands enable end exit

7-5 7-6 7-3
7-1 7-2
email-contact encryption
7-4
CHAPTER
F Commands
8-1 8-2 8-3 8-4 8-5
fabric-binding activate
fabric-binding database copy fabric-binding database diff fabric-binding database vsan fabric-binding enable fcalias clone fcalias name fcalias rename fcanalyzer fcc enable fcc priority fcdomain
8-11 8-13 8-14 8-15 8-17 8-8 8-9 8-10 8-7
fcdomain rcf-reject fcdroplatency fcflow stats fcid-allocation fcid-last-byte

8-18 8-20 8-22 8-24
fcinterop fcid-allocation fcinterop loop-monitor fcip enable fcip profile

8-27 8-28 8-29
8-25 8-26
fcns proxy-port fcping fcroute

8-31 8-33
fcns reject-duplicate-pwwn vsan
8-30
xi
Contents
fcrxbbcredit extended enable fcs plat-check-global vsan fcs register fcsp
8-37 8-39 8-42 8-43 8-36 8-34 8-35
fcsp dhchap fcsp enable fcsp timeout fctimer

8-44
fctimer abort fctimer commit
8-45 8-46 8-47
fctimer distribute fctrace fc-tunnel ficon swap

8-48 8-49 8-51
ficon vsan (EXEC mode) file find format fspf cost

8-54 8-55 8-56 8-57
8-52 8-53
ficon vsan (configuration mode)
fspf config vsan

8-59
fspf dead-interval fspf enable vsan fspf hello-interval fspf passive

8-63
8-60 8-61 8-62
fspf retransmit-interval
9
8-64
CHAPTER
G Commands group gzip gunzip

9-2 9-3 9-4
9-1
CHAPTER
10
H Commands hash host

10-2 10-3
10-1
xii
Contents
CHAPTER
11
I Commands initiator install all
11-1 11-2
in-order-guarantee
11-3 11-4 11-10
install license
install module bios install module epld install module loader interface interface fc interface fcip interface iscsi interface mgmt interface vsan ip access-group ip access-list
11-15 11-17
11-11 11-12 11-14
interface fc-tunnel
11-21
11-19
interface gigabitethernet
11-26 11-28
11-24
interface port-channel
11-32 11-33 11-35
11-30
ip address (FCIP profile configuration submode) ip address (interface configuration submode) ip-compression
11-40 11-42 11-43
11-38 11-39
ip default-gateway ip default-network ip domain-list ip domain-name ip name-server ip route ip routing iscsi enable

11-48 11-49 11-44
ip domain-lookup
11-45 11-46 11-47
iscsi authentication
11-52
11-50
iscsi import target fc
11-53 11-54 11-55
iscsi initiator idle-timeout iscsi initiator ip-address
xiii
Contents
iscsi initiator name iscsi save-initiator isns
11-63 11-65 11-66 11-67 11-68 11-69 11-57 11-58
iscsi interface vsan-membership

11-59 11-60
iscsi virtual-target name isns distribute isns esi retries isns profile name isns reregister ivr abort ivr commit ivr distribute ivr enable ivr nat ivr refresh
11-75 11-76 11-70 11-71
isns-server enable
ivr copy auto-topology user-configured-topology

11-73 11-74
11-72
ivr service-group name ivr virtual-fcdomain-add ivr vsan-topology

11-80
11-77 11-79
ivr vsan-topology database ivr withdraw domain ivr zone name ivr zoneset
12
11-85 11-86 11-84
11-82
CHAPTER
J Commands job name
12-1 12-2
CHAPTER
13
K Commands keepalive kernel core key

13-5
13-1 13-2 13-3
CHAPTER
14
L Commands line com1
14-1 14-2
lifetime seconds
14-3
xiv
Contents
line console line vty
14-9 14-10 14-11 14-12 14-13 14-6
logging abort logging commit logging console
logging distribute logging level logging logfile logging module logging monitor logging server
15
14-14 14-15 14-16 14-17 14-18
CHAPTER
M Commands match
15-2
15-1
match address mcast root

15-5
15-4
member (ivr zone configuration submode) member (zoneset configuration submode) mkdir move
15-11 15-12
15-6 15-8
member (zone configuration and zoneset-zone configuration submode)

15-10
modem connect line

15-13
mutual-chap username (iSCSI initiator mode)

16
15-14
CHAPTER
N Commands nasb module nport pwwn ntp

16-4
16-1 16-2 16-3
ntp abort ntp commit
16-5 16-6 16-7 16-8
ntp distribute
nwwn (DPVM database configuration submode) nwwn (SAN extension configuration mode)
16-9
xv
Contents
CHAPTER
17
P Commands
17-1 17-2 17-3 17-5
passive-mode peer-info ipaddr phone-contact ping policy port

17-7 17-8 17-9
periodic-inventory notification
17-6
port-channel persistent port-security

17-11
17-10
port-security abort port-security commit
17-14 17-15 17-16 17-18 17-19 17-20 17-21 17-22
port-security database port-security distribute port-security enable port-track enable port-track interface portaddress
17-24
port-track force-shut
power redundancy-mode poweroff module priority

17-29 17-31 17-28
17-26
purge fcdomain fcid purge module pwd

17-33 17-32
pwwn (DPVM database configuration submode)

18
17-34
CHAPTER
Q Commands
18-1 18-2 18-3
qos class-map qos enable qos dwrr-q qos priority
qos control priority

18-4 18-5
qos policy-map
18-7
18-6
xvi
Contents
qos service quiesce
19
18-8
18-9
CHAPTER
R Commands radius abort
19-1 19-2 19-3 19-4 19-5 19-7 19-8 19-9
radius commit radius distribute
radius-server host radius-server key
radius-server retransmit radius-server timeout reload read-only rmdir rmon alarm rmon event role abort role commit role distribute role name rscn
19-23 19-24 19-26 19-10 19-12
read command-id
19-13 19-14 19-15 19-17 19-18 19-19
19-20
19-21
run-script rspan-tunnel
20
CHAPTER
S Commands
20-1 20-2 20-3 20-4
santap module scsi-flow flow-id send server setup

20-6 20-7
scsi-flow distribute
set (IPsec crypto map configuration submode)

20-10 20-11 20-12
20-8
setup ficon shutdown site-id
20-14
xvii
Contents
sleep
20-15 20-16 20-17 20-19
snmp port snmp-server
snmp-server enable traps snmp-server host snmp-server user source

20-24 20-27 20-28 20-21 20-22
span session special-frame ssh

20-29 20-30
ssh key
ssh server enable ssm enable feature stop

20-37
20-32 20-33 20-36
static (iSCSI initiator submode) streetaddress suspend

20-39 20-41 20-42 20-44 20-45 20-48 20-49 20-50 20-38
switch-priority switch-wwn switchname switchport
switchport auto-negotiate switchport ingress-rate switchport initiator id
switchport promiscuous-mode switchport proxy-initiator system cores

20-54 20-52
20-51
system default switchport system hap-reset system health

20-56 20-57
20-55
system health clear-errors
20-59 20-61 20-62
system health external-loopback system health internal-loopback system health module system heartbeat
20-63 20-65
xviii
Contents
system memlog
20-66 20-67 20-68 20-69 20-70
system startup-config system statistics reset
system switchover (EXEC mode) system trace

20-71 20-72
system switchover (configuration mode) system watchdog

21
CHAPTER
Show Commands
21-1 21-2 21-3
show aaa accounting show aaa groups show arp

21-7 21-4
show aaa authentication show accounting log

21-5
show autonomous-fabric-id database show banner motd show boot

21-11 21-12 21-10
21-8
show boot auto-copy show callhome show cdp show cfs show clock show cores
21-15 21-19 21-21 21-13
show cimserver
21-22 21-23 21-24
show crypto global domain ipsec show crypto ike domain ipsec show crypto map domain ipsec show crypto sad domain ipsec show crypto spd domain ipsec show debug show dpvm
21-33 21-36
21-26 21-27 21-29 21-31 21-32
show crypto transform-set domain ipsec show device-alias

21-38 21-39 21-41
show environment show fabric-binding show fc-tunnel
21-45
xix
Contents
show fc2
21-46 21-49 21-50
show fcalias show fcc
show fcanalyzer
21-51
show fcdomain show fcflow stats show fcfwd show fcip
21-52 21-55 21-56
show fcdroplatency
21-57
show fcid-allocation
21-59
21-58
show fcns database show fcns statistics show fcroute show fcs show fcsp show fctimer show fdmi show ficon show file show fspf show hosts
21-66 21-69 21-73 21-75 21-77 21-80 21-86
21-61 21-65
show flogi database

21-89
21-87
show hardware
21-92
21-94 21-95
show incompatibility system show install all impact show install all status show in-order-guarantee show interface show inventory show ip route show ip routing show ips arp show ips stats show ips ip route
21-101 21-109 21-110 21-96 21-98
21-100
show ip access-list
21-111 21-112 21-113 21-114 21-115
xx
Contents
show ips status show iscsi global show iscsi initiator show iscsi session show iscsi stats show isns show ivr
21-129 21-132 21-137 21-118 21-119 21-120 21-122 21-124 21-128
show iscsi virtual-target
show kernel core show license show line show mcast show module show nasb show ntp show logging
21-140
21-138
21-142 21-148 21-150 21-152
21-155 21-157 21-159 21-162
show port-channel show port-security show processes show qos show radius show rlir show rmon show role show rscn
21-165 21-167
show radius-server
21-169 21-173 21-174 21-176
21-168
show running-config show san-ext-tuner show santap module show scheduler show scsi-flow show scsi-target show snmp show sprom show span session
21-200
21-178 21-181 21-182
21-186 21-188 21-192
21-195 21-198
xxi
Contents
show ssh
21-203 21-205 21-206 21-210
show ssm provisioning show startup-config show switchname show system show tacacs+ show system health
21-217 21-211
21-214
show tacacs-server show tech-support show telnet server show terminal show tlport show topology
21-225
21-218 21-219 21-223
21-224
21-227 21-229 21-230
show trunk protocol show user-account show users show version show vrrp show vsan show wwn show zone show zoneset
22
21-231 21-232
21-236 21-238 21-241 21-242 21-247
show zone-attribute-group
21-248
CHAPTER
T Commands
22-1 22-2 22-3 22-4 22-5 22-6 22-8 22-10
tacacs+ abort tacacs+ commit
tacacs+ distribute tacacs+ enable tacacs-server key tail

22-11 22-12
tacacs-server host
tacacs-server timeout tcp cwm
tcp keepalive-timeout
22-13 22-14
tcp maximum-bandwidth-kbps
xxii
Contents
tcp maximum-bandwidth-mbps tcp max-jitter
22-18 22-20 22-21 22-16
tcp max-retransmissions tcp min-retransmit-time tcp pmtu-enable tcp qos

22-24 22-25 22-26 22-22
tcp qos control tcp sack-enable tcp-connection telnet terminal time

22-29
tcp send-buffer-size
22-28
22-27
telnet server enable

22-31 22-33 22-35
22-30
time-stamp traceroute
tlport alpa-cache
22-37
22-36
transfer-ready-size transport email trunk protocol enable

23
22-38
22-39 22-41
CHAPTER
U Commands undebug all
23-1 23-2 23-3
update license use-profile username

23-4 23-5
username (iSCSI initiator mode)

24
23-8
CHAPTER
V Commands
24-1 24-2
vsan (iSCSI initiator mode) vsan database vsan policy deny vrrp
24-7 24-3 24-5
xxiii
Contents
CHAPTER
25
W Commands
25-1 25-2 25-3
write command-id write-accelerator write erase

25-5
wwn secondary-mac
26
25-6
CHAPTER
Z Commands zone clone zone copy
26-1 26-2
zone broadcast enable vsan

26-3 26-4 26-5
zone default-zone
zone merge-control restrict vsan zone mode enhanced vsan

26-7
26-6
zone name (configuration mode) zone rename

26-12 26-13 26-14
26-8 26-11
zone name (zone set configuration submode) zone-attribute-group clone zone-attribute-group name zone-attribute-group rename zoneset (configuration mode) zoneset (EXEC mode)
27
26-18
26-15 26-16
CHAPTER
Advanced Services Module Commands attach moduleshow fcdd attach moduleshow npc attach moduleshow vec attach moduleshow ves
27-2 27-4 27-6 27-8 27-10 27-11
27-1
attach moduleshow version attach moduleshow vsha attach moduleterminal attachpriv module asm mgmt-vsan interface cpp show asm
27-19 27-20 27-18 27-16 27-17
attach moduleshow virt-lookup

27-13 27-15
show flogi database

xxiv
Contents
show interface show fvport
28
27-21 27-29
CHAPTER
Caching Services Module Commands cluster add cluster config cluster name dir modflash: feature enable flash-copy host
28-12 28-14 28-2 28-4 28-5 28-7 28-8
28-1
28-10
install module node interface svc iogroup ip

28-19 28-20 28-22 28-18 28-16
mdisk-grp node
28-23
migrate vdisk node svc delete
28-25 28-26 28-27
node svc recover node svc upgrade quorum

28-29
node svc servicemode
28-28
remote-copy
28-30 28-32
show cluster flash-copy show cluster host show cluster ip

28-33
show cluster iogroup

28-35
28-34
show cluster mdisk show cluster nodes
28-36 28-38
show cluster mdsik-grp show cluster remote-copy show cluster status show cluster vdisk
28-39 28-40 28-41
show cluster remote-copy-cluster

28-42 28-43 28-44
show environment battery
xxv
Contents
show interface svc show nodes show svc svc-config svc-ibmcli vdisk
28-57 28-49 28-51 28-54 28-55 28-56 28-46
svc-purge-wwn module
xxvi
Preface
This preface describes the audience, organization, and conventions of the Cisco MDS 9000 Family Command Reference. It also provides information on how to obtain related documentation.
Audience
This guide is for experienced network operators and administrators who are responsible for configuring and maintaining the Cisco MDS 9000 family of multilayer directors and fabric switches.
Organization
This guide is organized as follows: Chapter Chapter 1 Chapter 2 Chapter 3 Chapter 4 Chapter 5 Chapter 6 Chapter 7 Chapter 8 Chapter 9 Chapter 10 Chapter 11 Chapter 12 Chapter 13 Chapter 14 Chapter 15 Chapter 16 Title CLI Overview A Commands B Commands C Commands D Commands Debug Commands E Commands F Commands G Commands H Commands I Commands K Commands L Commands M Commands N Commands P Commands Description Describes the CLI (command-line interface). Describes all commands beginning with the letter a. Describes all commands beginning with the letter b. Describes all commands beginning with the letter c. Describes all commands beginning with the letter d. Describes all the debug commands. Describes all commands beginning with the letter e. Describes all commands beginning with the letter f. Describes all commands beginning with the letter g. Describes all commands beginning with the letter h. Describes all commands beginning with the letter i. Describes all commands beginning with the letter k. Describes all commands beginning with the letter l. Describes all commands beginning with the letter m. Describes all commands beginning with the letter n. Describes all commands beginning with the letter p.
xxvii
Preface Document Conventions
Chapter Chapter 17 Chapter 18 Chapter 19 Chapter 20 Chapter 21 Chapter 22 Chapter 23 Chapter 24 Chapter 25 Chapter 26 Chapter 27 Title Q Commands R Commands S Commands Show Commands T Commands U Commands V Commands W Commands Z Commands Advanced Services Module Commands Caching Services Module Commands Description Describes all commands beginning with the letter q. Describes all commands beginning with the letter r. Describes all commands beginning with the letter s except for the show commands. Describes all the show commands. Describes all commands beginning with the letter t. Describes all commands beginning with the letter u. Describes all commands beginning with the letter v. Describes all commands beginning with the letter w. Describes all commands beginning with the letter z. Describes all commands pertaining to the Advanced Services Module (ASM) Describes all commands pertaining to the Caching Services Module (CSM).
Document Conventions
Command descriptions use these conventions: Convention boldface font italic font [ ] {x | y | z } [x|y|z] string Indication Commands and keywords are in boldface. Arguments for which you supply values are in italics. Elements in square brackets are optional. Required alternative keywords are grouped in braces and separated by vertical bars. Optional alternative keywords are grouped in brackets and separated by vertical bars. A nonquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.
Screen examples use these conventions: Convention

screen
Indication Terminal sessions and information the switch displays are in screen font. Information you must enter is in boldface screen font. Arguments for which you supply values are in italic screen font. Nonprinting characters, such as passwords are in angle brackets. Default responses to system prompts are in square brackets. An exclamation point (!) or a pound sign (#) at the beginning of a line of code indicates a comment line.
font
boldface screen
font
italic screen
font
< > [ ] !, #
xxviii
Preface Related Documentation
This document uses the following conventions:
Note
Means reader take note. Notes contain helpful suggestions or references to material not covered in the manual.
Caution
Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data.
Related Documentation
The documentation set for the Cisco MDS 9000 Family includes the following documents:

Cisco MDS 9000 Family Release Notes for Cisco MDS SAN-OS Releases Cisco MDS 9000 Family Interoperability Support Matrix Cisco MDS SAN-OS Release Compatibility Matrix for IBM SAN Volume Controller Software for Cisco MDS 9000 Cisco MDS SAN-OS Release Compatibility Matrix for VERITAS Storage Foundation for Networks Software Cisco MDS SAN-OS Release Compatibility Matrix for SSI Images Regulatory Compliance and Safety Information for the Cisco MDS 9000 Family Cisco MDS 9500 Series Hardware Installation Guide Cisco MDS 9200 Series Hardware Installation Guide Cisco MDS 9216 Switch Hardware Installation Guide Cisco MDS 9100 Series Hardware Installation Guide Cisco MDS 9000 Family Software Upgrade and DowngradeGuide Cisco MDS 9000 Family Configuration Guide Cisco MDS 9000 Family Command Reference Cisco MDS 9000 Family Fabric Manager Configuration Guide Cisco MDS 9000 Family Fabric and Device Manager Online Help Cisco MDS 9000 Family SAN Volume Controller Configuration Guide Cisco MDS 9000 Family MIB Quick Reference Cisco MDS 9000 Family CIM Programming Reference Cisco MDS 9000 Family System Messages Reference Cisco MDS 9000 Family Troubleshooting Guide Cisco MDS 9000 Family Port Analyzer Adapter 2 Installation and Configuration Note Cisco MDS 9000 Family Port Analyzer Adapter Installation and Configuration Note
For information on VERITAS Storage Foundation for Networks for the Cisco MDS 9000 Family, refer to the VERITAS website: http://support.veritas.com/
xxix
Preface Obtaining Documentation
For information on IBM TotalStorage SAN Volume Controller Storage Software for the Cisco MDS 9000 Family, refer to the IBM TotalStorage Support website: http://www.ibm.com/storage/support/2062-2300/
Obtaining Documentation
Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several ways to obtain technical assistance and other technical resources. These sections explain how to obtain technical information from Cisco Systems.
Cisco.com
You can access the most current Cisco documentation at this URL: http://www.cisco.com/univercd/home/home.htm You can access the Cisco website at this URL: http://www.cisco.com You can access international Cisco websites at this URL: http://www.cisco.com/public/countries_languages.shtml
Documentation DVD
Cisco documentation and additional literature are available in a Documentation DVD package, which may have shipped with your product. The Documentation DVD is updated regularly and may be more current than printed documentation. The Documentation DVD package is available as a single unit. Registered Cisco.com users (Cisco direct customers) can order a Cisco Documentation DVD (product number DOC-DOCDVD=) from the Ordering tool or Cisco Marketplace. Cisco Ordering tool: http://www.cisco.com/en/US/partner/ordering/ Cisco Marketplace: http://www.cisco.com/go/marketplace/
Ordering Documentation
You can find instructions for ordering documentation at this URL: http://www.cisco.com/univercd/cc/td/doc/es_inpck/pdi.htm You can order Cisco documentation in these ways:
Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from the Ordering tool: http://www.cisco.com/en/US/partner/ordering/
xxx
Preface Documentation Feedback
Nonregistered Cisco.com users can order documentation through a local account representative by calling Cisco Systems Corporate Headquarters (California, USA) at 408 526-7208 or, elsewhere in North America, by calling 1 800 553-NETS (6387).
Documentation Feedback
You can send comments about technical documentation to [email protected]. You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address: Cisco Systems Attn: Customer Document Ordering 170 West Tasman Drive San Jose, CA 95134-9883 We appreciate your comments.
Cisco Product Security Overview

Cisco provides a free online Security Vulnerability Policy portal at this URL: http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html From this site, you can perform these tasks:

Report security vulnerabilities in Cisco products. Obtain assistance with security incidents that involve Cisco products. Register to receive security information from Cisco.
A current list of security advisories and notices for Cisco products is available at this URL: http://www.cisco.com/go/psirt If you prefer to see advisories and notices as they are updated in real time, you can access a Product Security Incident Response Team Really Simple Syndication (PSIRT RSS) feed from this URL: http://www.cisco.com/en/US/products/products_psirt_rss_feed.html
Reporting Security Problems in Cisco Products

Cisco is committed to delivering secure products. We test our products internally before we release them, and we strive to correct all vulnerabilities quickly. If you think that you might have identified a vulnerability in a Cisco product, contact PSIRT:

Emergencies [email protected] Nonemergencies [email protected]
Tip
We encourage you to use Pretty Good Privacy (PGP) or a compatible product to encrypt any sensitive information that you send to Cisco. PSIRT can work from encrypted information that is compatible with PGP versions 2.x through 8.x.
xxxi
Preface Obtaining Technical Assistance
Never use a revoked or an expired encryption key. The correct public key to use in your correspondence with PSIRT is the one that has the most recent creation date in this public key server list: http://pgp.mit.edu:11371/pks/lookup?search=psirt%40cisco.com&op=index&exact=on
In an emergency, you can also reach PSIRT by telephone:

1 877 228-7302 1 408 525-6532
Obtaining Technical Assistance

For all customers, partners, resellers, and distributors who hold valid Cisco service contracts, Cisco Technical Support provides 24-hour-a-day, award-winning technical assistance. The Cisco Technical Support Website on Cisco.com features extensive online support resources. In addition, Cisco Technical Assistance Center (TAC) engineers provide telephone support. If you do not hold a valid Cisco service contract, contact your reseller.
Cisco Technical Support Website

The Cisco Technical Support Website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The website is available 24 hours a day, 365 days a year, at this URL: http://www.cisco.com/techsupport Access to all tools on the Cisco Technical Support Website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a user ID or password, you can register at this URL: http://tools.cisco.com/RPF/register/register.do
Note
Use the Cisco Product Identification (CPI) tool to locate your product serial number before submitting a web or phone request for service. You can access the CPI tool from the Cisco Technical Support Website by clicking the Tools & Resources link under Documentation & Tools. Choose Cisco Product Identification Tool from the Alphabetical Index drop-down list, or click the Cisco Product Identification Tool link under Alerts & RMAs. The CPI tool offers three search options: by product ID or model name; by tree view; or for certain products, by copying and pasting show command output. Search results show an illustration of your product with the serial number label location highlighted. Locate the serial number label on your product and record the information before placing a service call.
Submitting a Service Request

Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3 and S4 service requests are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Service Request Tool provides recommended solutions. If your issue is not resolved using the recommended resources, your service request is assigned to a Cisco TAC engineer. The TAC Service Request Tool is located at this URL: http://www.cisco.com/techsupport/servicerequest
xxxii
Preface Obtaining Additional Publications and Information
For S1 or S2 service requests or if you do not have Internet access, contact the Cisco TAC by telephone. (S1 or S2 service requests are those in which your production network is down or severely degraded.) Cisco TAC engineers are assigned immediately to S1 and S2 service requests to help keep your business operations running smoothly. To open a service request by telephone, use one of the following numbers: Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227) EMEA: +32 2 704 55 55 USA: 1 800 553-2447 For a complete list of Cisco TAC contacts, go to this URL: http://www.cisco.com/techsupport/contacts
Definitions of Service Request Severity

To ensure that all service requests are reported in a standard format, Cisco has established severity definitions. Severity 1 (S1)Your network is down, or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation. Severity 2 (S2)Operation of an existing network is severely degraded, or significant aspects of your business operation are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation. Severity 3 (S3)Operational performance of your network is impaired, but most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels. Severity 4 (S4)You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.
Obtaining Additional Publications and Information

Information about Cisco products, technologies, and network solutions is available from various online and printed sources.
Cisco Marketplace provides a variety of Cisco books, reference guides, and logo merchandise. Visit Cisco Marketplace, the company store, at this URL: http://www.cisco.com/go/marketplace/ Cisco Press publishes a wide range of general networking, training and certification titles. Both new and experienced users will benefit from these publications. For current Cisco Press titles and other information, go to Cisco Press at this URL: http://www.ciscopress.com Packet magazine is the Cisco Systems technical user magazine for maximizing Internet and networking investments. Each quarter, Packet delivers coverage of the latest industry trends, technology breakthroughs, and Cisco products and solutions, as well as network deployment and troubleshooting tips, configuration examples, customer case studies, certification and training information, and links to scores of in-depth online resources. You can access Packet magazine at this URL: http://www.cisco.com/packet
xxxiii
Preface Obtaining Additional Publications and Information
iQ Magazine is the quarterly publication from Cisco Systems designed to help growing companies learn how they can use technology to increase revenue, streamline their business, and expand services. The publication identifies the challenges facing these companies and the technologies to help solve them, using real-world case studies and business strategies to help readers make sound technology investment decisions. You can access iQ Magazine at this URL: http://www.cisco.com/go/iqmagazine Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at this URL: http://www.cisco.com/ipj World-class networking training is available from Cisco. You can view current offerings at this URL: http://www.cisco.com/en/US/learning/index.html
xxxiv
C H A P T E R
CLI Overview
This chapter prepares you to configure switches from the CLI (command-line interface). It also lists the information you need to have before you begin, and it describes the CLI command modes. This chapter includes the following sections:

About the Switch Prompt, page 1-2 About the CLI Command Modes, page 1-3 Understanding CLI Command Hierarchy, page 1-4 Navigating Through CLI Commands, page 1-9 Searching and Filtering CLI Output, page 1-13 About Flash Devices, page 1-22 Formatting Flash Disks and File Systems, page 1-23 Using the File System, page 1-24 Role-Based CLI, page 1-29 Using Valid Formats and Ranges, page 1-30 Using Debug Commands, page 1-31
1-1
Chapter 1 About the Switch Prompt
CLI Overview
About the Switch Prompt

If you are connected to the console port when the switch boots up, you see the output show in :
Note
Refer to the Cisco MDS 9200 Series Hardware Installation Guide or the Cisco MDS 9500 Series Hardware Installation Guide for installation and connection instructions. Once the switch is powered on successfully, you see the default switch prompt (switch#). You can perform embedded CLI operations, access command history, and use command parsing functions at this prompt. The switch gathers the command string upon detecting an Enter (CR) and accepts commands from a terminal.
Example 1-1 Output When a Switch Boots Up
Auto booting bootflash:/boot-279 bootflash:/system_image;... Booting kickstart image:bootflash:/boot-279.... ............................................Image verification OK Starting kernel... INIT: version 2.78 booting Checking all filesystems..... done. Loading system software Uncompressing system image: bootflash:/system_image CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC INIT: Entering runlevel: 3 <<<<<<SAN OS bootup log messages>>>>>> ---- Basic System Configuration Dialog ---This setup utility will guide you through the basic configuration of the system. Use ctrl-c to abort configuration dialog at any prompt. Basic management setup configures only enough connectivity for management of the system. Would you like to enter the basic configuration dialog (yes/no): yes <<<<<<after configuration>>>>>> switch login:
1-2
Chapter 1
CLI Overview About the CLI Command Modes
About the CLI Command Modes

Switches in the Cisco MDS 9000 Family have two main command modesuser EXEC mode and configuration mode. The commands available to you depend on the mode you are in. To obtain a list of available commands in either mode, type a question mark (?) at the system prompt. Table 1-1 lists and describes the two commonly used modes, how to enter the modes, and the resulting system prompts. The system prompt helps you identify which mode you are in and hence, which commands are available to you.
Table 1-1 Frequently Used Switch Command Modes
Mode EXEC
Description of Use
How to Access
Prompt
switch#
Enables you to temporarily change At the switch prompt, enter the required terminal settings, perform basic tests, and EXEC mode command. display system information.
Note
Changes made in this mode are generally not saved across system resets. From EXEC mode, enter the config terminal command.
switch(config)#
Configuration mode
Enables you to configure features that affect the system as a whole.

Note
Changes made in this mode are saved across system resets if you save your configuration. Refer to the Cisco MDS 9000 Family Configuration Guide for further information.
You can abbreviate commands and keywords by entering just enough characters to make the command unique from other commands. For example, you can abbreviate the config terminal command to conf t.
1-3
Chapter 1 Understanding CLI Command Hierarchy
CLI Overview
Understanding CLI Command Hierarchy

The CLI commands are organized hierarchically, with commands that perform similar functions grouped under the same level. For example, all commands that display information about the system, configuration, or hardware are grouped under the show command, and all commands that allow you to configure the switch are grouped under the config terminal command. Figure 1-1 illustrates a portion of the config terminal command hierarchy.
Figure 1-1 CLI Command Hierarchy Example
switch prompt (switch#) EXEC m ode copy config terminal show Configuration mode aaa .... port-channel fc ethernet mgmt vsan clock .... fspf interface zoneset exit .... cpp
79525
exit
end
Configuratio n submode
To execute a command, you enter the command by starting at the top level of the hierarchy. For example, to configure a Fibre Channel interface, use the config terminal command. Once you are in configuration mode, issue the interface command. When you are in the interface submode, you can query the available commands there. The following example shows how to query the available commands in the interface submode:
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# interface fc1/1 switch(config-if)# ? Interface configuration commands: channel-group Add to/remove from a port-channel exit Exit from this submode fcdomain Enter the interface submode fspf To configure FSPF related parameters no Negate a command or set its defaults shutdown Enable/disable an interface switchport Configure switchport parameters
1-4
Chapter 1
CLI Overview Understanding CLI Command Hierarchy
EXEC Mode Options

When you start a session on the switch, you begin in EXEC mode. Based on the role or group to which you belong, you have access to limited commands or to all commands (see the Role-Based CLI section on page 1-29). From the EXEC mode, you can enter configuration mode. Most of the EXEC commands are one-time commands, such as show commands, which display the current configuration status. Here is a list of EXEC mode commands:
switch# ? Exec Commands: attach Connect to a specific linecard callhome Callhome commands cd Change current directory clear Reset functions clock Manage the system clock config Enter configuration mode copy Copy from one file to another debug Debugging functions delete Remove files dir Directory listing for files discover Discover information exit Exit from the EXEC fcping Ping an N-Port fctrace Trace the route for an N-Port. find Find a file below the current directory format Format disks install Upgrade software load Load system image mkdir Create new directory move Move files no Disable debugging functions ping Send echo messages purge Deletes unused data pwd View current directory reload Reboot the entire box rmdir Remove existing directory run-script Run shell scripts send Send message to all the open sessions setup Run the basic SETUP command facility show Show running system information sleep Sleep for the specified number of seconds system System management commands tail Display the last part of a file telnet Telnet to another system terminal Set terminal line parameters test Test command traceroute Trace route to destination undebug Disable Debugging functions (See also debug) write Write current configuration zone Execute Zone Server commands
1-5
CLI Overview
Configuration Mode
Configuration mode allows you to make changes to the existing configuration. When you save the configuration, these commands are preserved across switch reboots. Once you are in configuration mode, you can enter interface configuration mode, zone configuration mode, and a variety of protocol-specific modes. Configuration mode is the starting point for all configuration commands. When you are in configuration mode, the switch expects configuration commands from the user. The following example shows output from the config terminal command:
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)#
Configuration Mode Commands and Submodes

The following is a list of configuration mode commands:
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ? Configure commands: aaa Configure AAA arp [no] remove an entry from the ARP cache boot Configure boot variables callhome Enter the callhome configuration mode clock Configure time-of-day clock end Exit from configure mode exit Exit from configure mode fcalias Fcalias configuration commands fcanalyzer Configure cisco fabric analyzer fcc Configure FC Congestion Control fcdomain Enter the fcdomain configuration mode fcdroplatency Configure switch or network latency fcflow Configure fcflow fcinterop Interop commands. fcns Name server configuration fcroute Configure FC routes fcs Configure Fabric Config Server fctimer Configure fibre channel timers fspf Configure fspf in-order-guarantee Set in-order delivery guarantee interface Select an interface to configure ip Configure IP features line Configure a terminal line logging Modify message logging facilities no Negate a command or set its defaults ntp NTP Configuration power Configure power supply poweroff Poweroff a module in the switch qos Configure priority of FC control frames radius-server Configure RADIUS related parameters role Configure roles rscn Config commands for RSCN snmp-server Configure snmp server span Enter SPAN configuration mode ssh Configure SSH parameters switchname Configure system's network name system System config command telnet Enable telnet trunk Configure Switch wide trunk protocol username Configure user information.
1-6
Chapter 1
CLI Overview Understanding CLI Command Hierarchy
vsan wwn zone zoneset Enter the vsan configuration mode Set secondary base MAC addr and range for additional WWNs Zone configuration commands Zoneset configuration commands
Configuration mode, also known as terminal configuration mode, has several submodes. Each of these submodes places you deeper in the prompt hierarchy. When you type exit, the switch backs out one level and returns you to the previous level. When you type end, the switch backs out to the user EXEC level. You can also type Ctrl-Z in configuration mode as an alternative to typing end.
Note
When in configuration mode, you can alternatively enter:

Ctrl-Z instead of the end command Ctrl-G instead of the exit command
You can execute an EXEC mode command from a configuration mode or submode prompt. You can issue this command from any submode within the configuration mode. When in configuration mode (or in any submode), enter the do command along with the required EXEC mode command. The entered command is executed at the EXEC level and the prompt resumes its current mode level.
switch(config)# do terminal session-timeout 0 switch(config)#
In this example, terminal session-timeout is an EXEC mode commandyou are issuing an EXEC mode command using the configuration mode do command. The do command applies to all EXEC mode commands other than the end and exit commands. You can also use the help (?) and command completion (tab) features for EXEC commands when issuing a do command along with the EXEC command. Table 1-2 lists some useful command keys that can be used in both EXEC and configuration modes:
Table 1-2 Useful Command Key Description
Command Ctrl-P Ctrl-N Ctrl-X-H Alt-P
Description Up history Down history List history History search backwards

Note
The difference between Tab completion and Alt- P or Alt-N is that TAB completes the current word while Alt- P and Alt-N completes a previously-entered command.
Alt-N Ctrl-G Ctrl-Z Ctrl-L
History search forwards Exit End Clear screen
1-7
CLI Overview
Table 1-3 displays the commonly used configuration submodes.
Table 1-3 Submodes Within the Configuration Mode
Submode Name Call Home FCS Registration
From Configuration Mode Enter callhome fcs register
Submode Prompt
switch(config-callhome)# switch(config-fcs-register)#
Configured Information Contact, destination, and e-mail FCS attribute registration
From FCS registration submode: switch(config-fcs-register-att Platform name and VSAN ID rib)# association platform name name vsan vsan-id Fibre Channel alias fcalias name name vsan vsan-id switch(config-fcalias)# FSPF Interface configuration fspf config vsan vsan-id interface type slot/port
switch(config-(fspf-config))#
Alias member Static SPF computation, hold time, and autonomous region Channel groups, Fibre Channel domains, FSPF parameters, switch port trunk and beacon information, and IP address Virtual router (Refer to the Cisco MDS 9000 Family Configuration Guide for further information.) Primary terminal console Virtual terminal line Rule SPAN source, destination, and suspend session information VSAN database Zone member Zone set member
switch(config-if)#
From the VSAN or mgmt0 (management) interface configuration submode: vrrp number Line console VTY Role SPAN VSAN database Zone Zone set line console line vty role name span session number vsan database zone name string vsan vsan-id zoneset name name vsan vsan-id
switch(config-if-vrrp)#
switch(config-console)# switch(config-line)# switch(config-role)# switch(config-span)#
switch(config-vsan-db)# switch(config-zone)# switch(config-zoneset)#
1-8
Chapter 1
CLI Overview Navigating Through CLI Commands
Navigating Through CLI Commands

To redisplay a command you previously entered, press the Up Arrow key. You can continue to press the Up Arrow key to see more previously issued commands. Similarly, you can press the Down Arrow, Right Arrow, Left Arrow, and Delete keys to navigate through the command history and to modify an existing command string.
Getting Help
In any command mode, you can get a list of available commands by entering a question mark (?).
switch# ?
To obtain a list of commands that begin with a particular character sequence, type in those characters followed immediately by the question mark (?). Do not include a space.
switch# co? configure copy
To list keywords or arguments, enter a question mark in place of a keyword or argument. Include a space before the question mark. This form of help is called command syntax help, because it reminds you which keywords or arguments are applicable based on the commands, keywords, and arguments you have already entered.
switch# config ? terminal Configure the system from the terminal
Tip
If you are having trouble entering a command, check the system prompt and enter the question mark (?) for a list of available commands. You might be in the wrong command mode or using incorrect syntax.
Command Completion
In any command mode, you can begin a particular command sequence and immediately press the Tab key to complete the rest of the command.
switch (config)# ro<Tab> switch (config)# role <Tab> switch (config)# role name
This form of help is called command completion, because it completes a word for you. If several options are available for the typed letters, all options that match those letters are presented:
switch(config)# fc<Tab> fcalias fcdomain fcanalyzer fcdroplatency fcc fcinterop switch(config)# fcd<Tab> fcdomain fcdroplatency switch(config)# fcdo<Tab> switch(config)# fcdomain fcs fcns fcroute
fctimer
1-9
Chapter 1 Navigating Through CLI Commands
CLI Overview
Using the no and Default Forms of Commands

You can issue the no form of any command to perform the following actions:
Undo a wrongly issued command. If you issue the zone member command, you can undo the results:
switch(config)# zone name test vsan 1 switch(config-zone)# member pwwn 12:12:12:12:12:12:12:12 switch(config-zone)# no member pwwn 12:12:12:12:12:12:12:12 WARNING: Zone is empty. Deleting zone test. Exit the submode. switch(config-zone)#
Delete a created facility If you want to delete a zone that you created:
switch(config)# zone name test vsan 1 switch(config-zone)# exit switch(config)# no zone name test vsan 1 switch(config)#
You cannot delete a zone facility called test while residing in it. You must first exit the zone submode and return to configuration mode.
Entering CLI Commands

You can configure the software in one of two ways:

You can create the configuration for the switch interactively by issuing commands at the CLI prompt. You can create an ASCII file containing a switch configuration and then load this file on the required system. You can then use the CLI to edit and activate the file. (Refer to the Cisco MDS 9000 Family Configuration Guide for further information.)
Viewing Switch Configurations

You can view the ASCII form of the configuration file when required. To view the current configuration tree from the EXEC prompt, issue the show running-config command. If the running configuration is different from the startup configuration, issue the show startup-config command to view the ASCII version of the current startup configuration that was used to boot the switch. You can also gather specific information on the entire switch configuration by issuing the relevant show commands. Configurations are displayed based a specified feature, interface, module, or VSAN. Available show commands for each feature are briefly described in this section and listed at the end of each chapter. Examples 1-2 to 1-8 display a few show command examples.
Example 1-2 Displays Details on the Specified Interface
switch# show interface fc1/1 fc1/1 is up Hardware is Fibre Channel, 20:01:ac:16:5e:4a:00:00 vsan is 1 Port mode is E
1-10
Chapter 1
CLI Overview Navigating Through CLI Commands
Speed is 1 Gbps Beacon is turned off FCID is 0x0b0100 0 frames input, 0 bytes, 0 discards 0 runts, 0 jabber, 0 too long, 0 too short 0 input errors, 0 CRC, 0 invalid transmission words 0 address id, 0 delimiter 0 EOF abort, 0 fragmented, 0 unknown class 0 frames output, 0 bytes, 0 discards Received 0 OLS, 0 LRR, 0 NOS, 0 loop inits Transmitted 0 OLS, 0 LRR, 0 NOS, 0 loop inits
Example 1-3
Displays the Software and Hardware Version
switch# show version Cisco Storage Area Networking Operating System (SAN-OS) Software TAC support: http://www.cisco.com/tac Copyright (c) 2002-2003, Cisco Systems, Inc. All rights reserved. The copyrights to certain works contained herein are owned by Andiamo Systems, Inc. and/or other third parties and are used and distributed under license. Some parts of this software are covered under the GNU Public License. A copy of the license is available at http://www.gnu.org/licenses/gpl.html. Software BIOS: loader: kickstart: system:
version version version version
1.0.8 1.1(2) 2.0(1) [build 2.0(0.6)] [gdb] 2.0(1) [build 2.0(0.6)] [gdb] 08/07/03 bootflash:///m9500-sf1ek9-kickstart-mzg.2.0.0.6.bin 10/25/2010 12:00:00 bootflash:///m9500-sf1ek9-mzg.2.0.0.6.bin 10/25/2020 12:00:00
BIOS compile time: kickstart image file is: kickstart compile time: system image file is: system compile time: Hardware RAM 1024584 kB
bootflash: 1000944 blocks (block size 512b) slot0: 0 blocks (block size 512b) 172.22.92.181 uptime is 0 days 2 hours 18 minute(s) 1 second(s) Last reset at 970069 usecs after Tue Sep 16 22:31:25 1980 Reason: Reset Requested by CLI command reload System version: 2.0(0.6) Service:
Example 1-4
Displays the Running Configuration
switch# show running Building Configuration ... interface fc1/1 interface fc1/2 interface fc1/3 interface fc1/4 interface mgmt0 ip address 172.22.95.112 255.255.255.0 no shutdown vsan database boot system bootflash:system-237; sup-1
1-11
Chapter 1 Navigating Through CLI Commands
CLI Overview
boot kickstart bootflash:boot-237 sup-1 callhome ip default-gateway 172.22.95.1 switchname switch trunk protocol enable username admin password 5 /AFDAMD4B2xK2
role network-admin
Example 1-5
Displays the Difference between the Running and Startup Configuration
switch# show running diff Building Configuration ... *** Startup-config --- Running-config ****************** 1,16 **** fcip enable ip default-gateway 172.22.91.1 iscsi authentication none iscsi enable ! iscsi import target fc iscsi virtual-target name vt pWWN 21:00:00:04:cf:4c:52:c1 all-initiator-permit --- 1,20 ---fcip enable + aaa accounting logsize 500 + + + ip default-gateway 172.22.91.1 iscsi authentication none iscsi enable ! iscsi initiator name junk iscsi virtual-target name vt pWWN 21:00:00:04:cf:4c:52:c1 all-initiator-permit
Example 1-6
Displays the Configuration for a Specified Interface
switch# show running interface fc2/9 interface fc2/9 switchport mode E no shutdown
Note
The show running interface command is different from the show interface command.
Example 1-7 Displays the Configuration for all Interfaces in a 16-Port Module
switch# show running interface fc2/10 - 12 interface fc2/10 switchport mode E no shutdown interface fc2/11 switchport mode E no shutdown interface fc2/12 switchport mode FL no shutdown
1-12
Chapter 1
CLI Overview Searching and Filtering CLI Output
Example 1-8 Displays the Configuration Per VSAN
switch# show runnning vsan 1 Building Configuration ... zone name m vsan 1 member pwwn 21:00:00:20:37:60:42:5c member pwwn 21:00:00:20:37:4b:00:a2 zoneset name m vsan 1 member m zoneset activate name m vsan 1
Saving a Configuration
To save the configuration, enter the copy running-config startup-config command from the EXEC mode prompt to save the new configuration into nonvolatile storage. Once this command is issued, the running and the startup copies of the configuration are identical. Refer to the Cisco MDS 9000 Family Configuration Guide for further information.
Clearing a Configuration
To clear a startup configuration, enter the write erase command from the EXEC mode prompt. Once this command is issued, the switchs startup configuration reverts to factory defaults. The running configuration is not affected. The write erase command erases the entire startup configuration with the exception of any configuration that affects the loader functionality. The write erase boot command only erases the configuration that affects the loader functionality. The loader functionality configuration includes the boot variables and the mgmt0 IP configuration information (IP address, netmask and default gateway).
switch# write erase boot This command will erase the boot variables and the ip configuration of interface mgmt 0
Searching and Filtering CLI Output

The Cisco MDS SAN-OS CLI provides ways of searching through large amounts of command output and filtering output to exclude information you do not need. These features are enabled for the show command, which generally displays large amounts of data.
Note
The show command is always entered in EXEC mode. When output continues beyond what is displayed on your screen, the Cisco MDS SAN-OS CLI displays a --More-- prompt. Pressing Return displays the next line; pressing the Spacebar displays the next screen of output. To search the show command output, use the following command in EXEC mode:
Command
switch# show any-command | begin pattern
Purpose Begins unfiltered output of the show command with the first line that contains the pattern.
1-13
Chapter 1 Searching and Filtering CLI Output
CLI Overview
Note
Cisco MDS SAN-OS documentation generally uses the vertical bar to indicate a choice of syntax. However, to search the output of the show command, you need to enter the pipe character (the vertical bar). In this section the pipe appears in bold (|) to indicate that you should enter this character. To filter show command output, use one of the following commands in EXEC mode:
Command
switch# show any-command | exclude pattern switch# show any-command | include pattern switch# show any-command | include pattern1|pattern2
Purpose Displays output lines that do not contain the pattern. Displays output lines that contain the pattern. Displays output lines that contain either pattern1 or pattern2.
Note
The alternation patterns, pattern1|pattern2, must appear within double quotes.
switch# show any-command | include pattern [next number] [prev number]
Displays output lines that contain the pattern. Optionally, using the next or prev parameter followed by a number also displays the designated number of lines. Displays the number lines of output in the display.
switch# show any-command | count number
You can enter the Ctrl-Z key combination at any time to interrupt the output and return to EXEC mode. For example, you can enter the show running-config | begin hostname command to start the display of the running configuration file at the line containing the hostname setting, then use Ctrl-Z when you get to the end of the information you are interested in capturing. See the Searching and Filtering CLI Output Examples section on page 1-15.
Multiple Filter Commands

Cisco MDS SAN-OS Release 2.1(1a) supports using multiple filters in the same show command output. This means you can use a combination of the available filters to format the output of any show command.
Note
The maximum number of commands allowed is four. For example, you can enter a maximum of three filter commands or two filter commands and a redirection. Cisco MDS SAN-OS Release 2.1(1a) also supports both filters and redirection in the same command. Now you can apply the required filters to the output of any command, and save the output using the file redirection. See the next section, Searching and Filtering CLI Output Examples section on page 1-15.
1-14
Chapter 1
Searching and Filtering CLI Output Examples

The following is partial sample output of the show running-config | begin EXEC command. It begins displaying unfiltered output with the first line that contain the pattern vsan.
switch# show running-config | begin vsan fcdomain fcid persistent vsan 1 fcdomain fcid persistent vsan 2 fcdomain fcid persistent vsan 3 fcdomain fcid persistent vsan 101 fcdomain fcid persistent vsan 102 fcdomain fcid database vsan 1 wwn 29:00:00:05:30:00:06:ea fcid vsan 1 wwn 28:0f:00:05:30:00:06:ea fcid vsan 1 wwn 28:10:00:05:30:00:06:ea fcid vsan 1 wwn 28:11:00:05:30:00:06:ea fcid vsan 1 wwn 28:12:00:05:30:00:06:ea fcid vsan 1 wwn 28:13:00:05:30:00:06:ea fcid vsan 1 wwn 28:14:00:05:30:00:06:ea fcid vsan 1 wwn 28:1f:00:05:30:00:06:ea fcid vsan 1 wwn 28:20:00:05:30:00:06:ea fcid vsan 1 wwn 21:00:00:e0:8b:05:76:28 fcid vsan 1 wwn 20:c5:00:05:30:00:06:de fcid vsan 1 wwn 28:2b:00:05:30:00:06:ea fcid vsan 1 wwn 28:2d:00:05:30:00:06:ea fcid vsan 1 wwn 28:2e:00:05:30:00:06:ea fcid vsan 1 wwn 28:2f:00:05:30:00:06:ea fcid vsan 1 wwn 28:30:00:05:30:00:06:ea fcid --More--
0x680000 0x680001 0x680002 0x680003 0x680004 0x680005 0x680006 0x680007 0x680008 0x680100 0x680200 0x680012 0x680013 0x680014 0x680015 0x680016
dynamic dynamic dynamic dynamic dynamic dynamic dynamic dynamic dynamic area dynamic area dynamic dynamic dynamic dynamic dynamic dynamic
The following is partial sample output of the show tech-support EXEC command. It begins displaying unfiltered output with the first line that contain the string show interface brief.
switch# show tech-support | begin "show interface brief" -------------------- show interface brief -----------------------------------------------------------------------------------------------Interface Vsan Admin Admin Status FCOT Oper Oper Port Mode Trunk Mode Speed Channel Mode (Gbps) ------------------------------------------------------------------------------fc4/1 1 FX -sfpAbsent ---fc4/2 1 FX -sfpAbsent ---fc4/3 1 FX -sfpAbsent ---fc4/4 1 FX -sfpAbsent ---fc4/5 1 FX -up swl F 1 -fc4/6 1 FX -sfpAbsent ---fc4/7 1 FX -sfpAbsent ---fc4/8 1 FX -sfpAbsent ---fc4/9 1 E on notConnected swl --fc4/10 1 FX -sfpAbsent ---fc4/11 1 FX -sfpAbsent ---fc4/12 1 FX -sfpAbsent ---fc4/13 1 FX -sfpAbsent ---fc4/14 1 FX -sfpAbsent ---fc4/15 1 FX -sfpAbsent -----More--
1-15
CLI Overview
The following is partial sample output of the show running-config | exclude EXEC command. It excludes any output line that contain the pattern vsan.
switch# show running-config | exclude vsan version 2.1(1a) poweroff module 9 fcdomain fcid database ssm enable feature nasb interface fc4/1-4 ssm enable feature santap module 4 ssm enable feature nasb interface fc9/1-4 ssm enable feature santap interface fc9/5-8 ssm enable feature santap interface fc9/21-28 switchname switch boot kickstart bootflash:/b2193 sup-1 boot system bootflash:/r2193 sup-1 boot kickstart bootflash:/b2193 sup-2 boot system bootflash:/r2193 sup-2 boot ssi bootflash:/laslc1.bin module 1 boot ssi bootflash:/laslc1.bin module 2 boot ssi bootflash:/laslc1.bin module 3 boot ssi bootflash:/laslc1.bin module 4 boot ssi bootflash:/laslc1.bin module 7 boot ssi bootflash:/laslc1.bin module 8 boot ssi bootflash:/laslc1.bin module 9 line console speed 38400 --More--
The following is partial sample output of the show interface EXEC command. It includes all output with the pattern vsan.
switch# show interface | include vsan Port vsan is 1 Port vsan is 1 Port vsan is 1 Port vsan is 1 Port vsan is 1 Port vsan is 1 [information deleted]
The following is partial sample output of the show interface EXEC command. It includes all output with the pattern FX plus the next and previous five lines of output.
switch# show interface | include FX next 5 prev 5 fc4/1 is down (SFP not present) Hardware is Fibre Channel Port WWN is 20:c1:00:05:30:00:06:de Admin port mode is FX Port vsan is 1 Receive data field Size is 2112 Beacon is turned off 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec -0 transmit B2B credit remaining
1-16
Chapter 1
fc4/2 is down (SFP not present) Hardware is Fibre Channel Port WWN is 20:c2:00:05:30:00:06:de Admin port mode is FX Port vsan is 1 Receive data field Size is 2112 Beacon is turned off 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec ---More--
The following output of the show running-config EXEC command. It displays the number lines, or count, of the output.
switch# show running-config | count 214 switch#
The following output of the show interface brief EXEC command. It displays the interfaces where the administration mode is FX.
switch# show interface brief | include FX fc4/1 1 FX -sfpAbsent fc4/2 1 FX -sfpAbsent fc4/3 1 FX -sfpAbsent fc4/4 1 FX -sfpAbsent fc4/5 1 FX -up fc4/6 1 FX -sfpAbsent fc4/7 1 FX -sfpAbsent fc4/8 1 FX -sfpAbsent fc4/10 1 FX -sfpAbsent fc4/11 1 FX -sfpAbsent fc4/12 1 FX -sfpAbsent fc4/13 1 FX -sfpAbsent fc4/14 1 FX -sfpAbsent fc4/15 1 FX -sfpAbsent fc4/16 1 FX -sfpAbsent fc4/17 1 FX -sfpAbsent fc4/18 1 FX -sfpAbsent fc4/19 1 FX -sfpAbsent fc4/20 1 FX -sfpAbsent fc4/21 1 FX -sfpAbsent fc4/22 1 FX -sfpAbsent fc4/23 1 FX -sfpAbsent fc4/24 1 FX -sfpAbsent fc4/25 1 FX -sfpAbsent fc4/26 1 FX -sfpAbsent fc4/27 1 FX -sfpAbsent fc4/28 1 FX -down fc4/29 1 FX -sfpAbsent fc4/30 1 FX -sfpAbsent fc4/31 1 FX -sfpAbsent fc4/32 1 FX -sfpAbsent switch# ----swl ---------------------swl --------F ----------------------------------------------------------
The following output of the show interface brief EXEC command uses multiple filter commands. It display the number of interfaces, or count, where the administration mode is FX.
switch# show interface brief | include FX | count 31 switch#
1-17
CLI Overview
The following show interface brief EXEC command uses multiple filter commands to redirect the output where the administration mode is FX to the file named test.txt in the directory SavedData.
switch# show interface brief | include FX > SavedData\test.txt switch# cd SavedData switch# dir 2263 Jan 12 18:53:41 2005 SavedData\test.txt Usage for volatile:// 8192 bytes used 20963328 bytes free 20971520 bytes total switch#
Displaying Users
The show users command displays all users currently accessing the switch.
switch# show users admin pts/7 admin pts/9 admin pts/11 Jan 12 20:56 (10.77.202.149) Jan 12 23:29 (modena.cisco.com) Jan 13 01:53 (dhcp-171-71-49-49.cisco.com)
Sending Messages to Users

The send command sends a message to all active CLI users currently using the switch. This message is restricted to 80 alphanumeric characters with spaces. This example sends a warning message to all active users about the switch being shut down.
switch# send Shutting down the system in 2 minutes. Please log off. Broadcast Message from admin@excal-112 (/dev/pts/3) at 16:50 ... Shutting down the system in 2 minutes. Please log off.
Using the ping Command

The ping command verifies the connectivity of a remote host or server by sending echo messages. The syntax for this command is ping <host or ip address>
switch# ping 171.71.181.19 PING 171.71.181.19 (171.71.181.19): 56 data bytes 64 bytes from 171.71.181.19: icmp_seq=0 ttl=121 time=0.8 ms 64 bytes from 171.71.181.19: icmp_seq=1 ttl=121 time=0.8 ms --- 171.71.181.19 ping statistics --2 packets transmitted, 2 packets received, 0% packet loss round-trip min/avg/max = 0.8/0.8/0.8 ms
To abnormally terminate a ping session, type the Ctrl-C escape sequence.
1-18
Chapter 1
Using traceroute
The traceroute command prints the routes taken by a specified host or IP address. The syntax for this command is traceroute <host or ip address>
switch# traceroute www.cisco.com traceroute to www.cisco.com (171.71.181.19), 30 hops max, 38 byte packets 1 kingfisher1-92.cisco.com (172.22.92.2) 0.598 ms 0.470 ms 0.484 ms 2 nubulab-gw1-bldg6.cisco.com (171.71.20.130) 0.698 ms 0.452 ms 0.481 ms 3 172.24.109.185 (172.24.109.185) 0.478 ms 0.459 ms 0.484 ms 4 sjc12-lab4-gw2.cisco.com (172.24.111.213) 0.529 ms 0.577 ms 0.480 ms 5 sjc5-sbb4-gw1.cisco.com (171.71.241.174) 0.521 ms 0.495 ms 0.604 ms 6 sjc12-dc2-gw2.cisco.com (171.71.241.230) 0.521 ms 0.614 ms 0.479 ms 7 sjc12-dc2-cec-css1.cisco.com (171.71.181.5) 2.612 ms 2.093 ms 2.118 ms 8 www.cisco.com (171.71.181.19) 2.496 ms * 2.135 ms
To abnormally terminate a traceroute session, enter Ctrl-C.
Setting the Switchs Shell Timeout

Use the exec-timeout command in configuration mode to configure the lifetime of all terminal sessions on that switch. When the time limit configured by this command is exceeded, the shell exits and closes that session. The syntax for this command from is exec-timeout minutes The default is 30 minutes. You can configure different timeout values for a console or a virtual terminal line (VTY) session. You can set the exec-timeout value to 0 to disable this feature so the session remains active until you exit the switch. This change is saved in the configuration file.
From the console:

switch(config)# line console switch(config-console)# exec-timeout 60
Specifies the current console shell timeout to be 60 minutes.
From a VTY session (Telnet or SSH):

switch(config)# line vty switch(config-line)# exec-timeout 60
Specifies the current console shell timeout to be 60 minutes.
Displaying VTY Sessions

Use the show line command to display all configured VTY sessions:
switch# show line line Console: Speed: 9600 bauds Databits: 8 bits per byte Stopbits: 1 bit(s) Parity: none Modem In: Disable Modem Init-String default : ATE0Q1&D2&C1S0=1\015 Statistics: tx:5558511 rx:5033958
Register Bits:RTS|CTS|DTR|DSR|CD|RI
1-19
CLI Overview
line Aux: Speed: 9600 bauds Databits: 8 bits per byte Stopbits: 1 bit(s) Parity: none Modem In: Disable Modem Init-String default : ATE0Q1&D2&C1S0=1\015 Hardware Flowcontrol: ON Statistics: tx:35 rx:0 Register Bits:RTS|DTR
Clearing VTY Sessions

Use the clear line command to close a specified VTY session:
switch# clear line Aux
Setting the Switchs Terminal Timeout

Use the terminal session-timeout command in EXEC mode to configure the automatic logout time for the current terminal session on that switch. When the time limit configured by this command is exceeded, the switch closes that session and exits. The syntax for this command from is terminal session-timeout minutes The default is 30 minutes. You can set the terminal session-timeout value to 0 to disable this feature so the terminal remains active until you choose to exit the switch. This change is not saved in the configuration file.
switch# terminal session-timeout 600
Specifies the terminal timeout to be 600 minutes for the current session.
Setting the Switchs Terminal Type

Use the terminal terminal-type command in EXEC mode to specify the terminal type for a switch: The syntax for this command is terminal terminal-type terminal-type
switch# terminal terminal-type vt100
Specifies the terminal type. The terminal-type string is restricted to 80 characters and must be a valid type (for example vt100 or xterm). If a Telnet or SSH session specifies an unknown terminal type, the switch uses the vt100 terminal by default.
1-20
Chapter 1
Setting the Switchs Terminal Length

To set the terminal screen length for the current session, use the terminal length command in EXEC mode. This command is specific to only the console port. Telnet and SSH sessions set the length automatically. The syntax for this command is terminal length lines
switch# terminal length 20
Sets the screen length for the current session to 20 lines for the current terminal session. The default is 24 lines.
Setting the Switchs Terminal Width

To set the terminal screen width for the current session, use the terminal width command in EXEC mode. This command is specific to only the console port. Telnet and SSH sessions set the width automatically. The syntax for this command is terminal width columns
switch# terminal width 86
Sets the screen length for the current session to 86 columns for the current terminal session. The default is 80 columns.
Displaying Terminal Settings

The show terminal command displays the terminal settings for the current session:
switch# show terminal TTY: Type: vt100 Length: 24 lines, Width: 80 columns Session Timeout: 525600 minutes
1-21
Chapter 1 About Flash Devices
CLI Overview
About Flash Devices

Every switch in the Cisco MDS 9000 Family contains one internal bootflash (see Figure 1-2). The Cisco MDS 9500 Series additionally contains one external CompactFlash called slot0 (see Figure 1-2 and Figure 1-3).
Figure 1-2 Flash Devices in the Cisco MDS 9000 Supervisor Module
Internal bootflash Internal bootflash External CompactFlash Slot 0 Cisco MDS 9500 Series Director
Cisco MDS 9216 Switch
Figure 1-3
External CompactFlash in the Cisco MDS 9000 Supervisor Module
CompactFlash 1 eject button
CompactFlash 1 slot 0
79527 85603
CompactFlash 1 LED
Internal bootflash:
All switches in the Cisco MDS 9000 Family have one internal bootflash: that resides in the supervisor or switching module.You have access to two directories within the internal bootflash: file system.

The volatile: directory which provides temporary storage, and is also the default. Files in temporary storage (volatile:) are erased when the switch reboots. The bootflash (nonvolatile storage): directory which provides permanent storage. The files in bootflash are preserved through reboots and power outages.
External CompactFlash (Slot0)

Cisco MDS 9500 Series directors contain an additional external CompactFlash called slot0: The external CompactFlash, an optional device for MDS 9500 Series directors, can be used for storing software images, logs, and core dumps.
1-22
Chapter 1
CLI Overview Formatting Flash Disks and File Systems
Formatting Flash Disks and File Systems

By formatting a flash disk or a file system, you are essentially clearing out the contents of the disk or the file system and restoring it to its factory-shipped state (see the About Flash Devices section on page 1-22 and Using the File System section on page 1-24 for additional information).
Initializing bootflash:
When a switch is shipped, the init system command is already performed and you do not need to issue it again. Initializing the switch resets the entire internal disk and erases all data in the bootflash: partition. The internal disk is composed of several file systems with bootflash: being one of them. All files in bootflash: are erased and you must download the system and kickstart images again. After issuing an init system command, you don't have to format the bootflash: again since bootflash: is automatically formatted.
Note
The init system command also installs a new loader from the existing (running) kickstart image. You can access this command from the switch(boot)# prompt. If bootflash: is found corrupted during a boot sequence, you will see the following message:
ERROR:bootflash: has unrecoverable error; please do format bootflash:
Use the format bootflash: command to only format the bootflash: file system. You can issue the format bootflash: command from either the switch# or the switch(boot)# prompts. If you issue the format bootflash: command, you must download the kickstart and system images again.
Formatting Slot0:
Be sure to format an external CompactFlash device before using it to save files or images. You can verify if the external CompactFlash device is formatted by inserting it into slot0: and issuing the dir slot0: command.

If the external CompactFlash device is already formatted, you can see file system usage information (along with any existing files). If the external CompactFlash device is unformatted (corrupted), you will see the following message:
Device unavailable
In this case, you need to format the CompactFlash device using the format slot0: command.
Note
The slot0: file system cannot be accessed from the standby the loader> prompt or the switch(boot)# prompt, if the disk is inserted after booting the switch.
Caution
The Cisco MDS SAN-OS software only supports Cisco-certified CompactFlash devices that are formatted using Cisco MDS switches. Using uncertified CompactFlash devices may result in unpredictable consequences; formatting CompactFlash devices using other platforms may result in errors.
1-23
Chapter 1 Using the File System
CLI Overview
Using the File System

The switch provides the following useful functions to help you manage software image files and configuration files:

Setting the Current Directory, page 1-24 Displaying the Current Directory, page 1-24 Listing the Files in a Directory, page 1-25 Creating a New Directory, page 1-25 Deleting an Existing Directory, page 1-25 Moving Files, page 1-25 Copying Files, page 1-26 Deleting Files, page 1-26 Displaying File Contents, page 1-26 Saving Command Output to a File, page 1-27 Compressing and Uncompressing Files, page 1-27 Displaying the Last Line in a File, page 1-28 Executing Commands Specified in a Script, page 1-28 Setting the Delay Time, page 1-29
Setting the Current Directory

The cd command changes the current directory level to a specified directory level. CLI defaults to the volatile: files system. This command expects a directory name input.
Tip
Any file saved in the volatile: file system will be erased when the switch reboots. The syntax for this command is cd directory name This example changes the current directory to the mystorage directory that resides in the slot0 directory:
switch# cd slot0:mystorage
This example changes the current directory to the mystorage directory that resides in the current directory.
switch# cd mystorage If the current directory is slot0:mydir, this command changes the current directory to slot0:mydir/mystorage.
Displaying the Current Directory

The pwd command displays the current directory location. This example changes the directory and displays the current directory.
switch# cd bootflash: switch# pwd
1-24
Chapter 1
CLI Overview Using the File System
bootflash:
Listing the Files in a Directory

The dir command displays the contents of the current directory or the specified directory. The syntax for this command is dir directory or file name This example shows how to list the files on the default volatile: file system:
switch# dir Usage for volatile: filesystem 0 bytes total used 20971520 bytes free 20971520 bytes available
Creating a New Directory

The mkdir command creates a directory at the current directory level or at a specified directory level. The syntax for this command is mkdir directory name This example creates a directory called test in the slot0 directory.
switch# mkdir slot0:test
This example creates a directory called test at the current directory level.
switch# mkdir test If the current directory is slot0:mydir, this command creates a directory called slot0:mydir/test.
Deleting an Existing Directory

The rmdir command deletes an existing directory at the current directory level or at a specified directory level. The directory must be empty to be deleted. The syntax for this command is rmdir directory name This example deletes the directory called test in the slot0 directory.
switch# rmdir slot0:test
This example deletes the directory called test at the current directory level.
switch# rmdir test If the current directory is slot0:mydir, this command deletes the slot0:mydir/test directory.
Moving Files
The move command removes a file from the source directory and places it in the destination directory. If a file with the same name already exists in the destination directory, that file is overwritten by the moved file. This example moves the file called samplefile from the slot0 directory to the mystorage directory.
1-25
CLI Overview
switch# move slot0:samplefile slot0:mystorage/samplefile This example moves a file from the current directory level. switch# move samplefile mystorage/samplefile If the current directory is slot0:mydir, this command moves slot0:mydir/samplefile to slot0:mydir/mystorage/samplefile.
Copying Files
The copy command copies a file. This example copies the file called samplefile from the external CompactFlash (slot0) directory to the mystorage directory.
switch# copy slot0:samplefile slot0:mystorage/samplefile This example copies a file from the current directory level. switch# copy samplefile mystorage/samplefile If the current directory is slot0:mydir, this command copies slot0:mydir/samplefile to slot0:mydir/mystorage/samplefile. You can also use the copy command to upload and download files from the slot0: or bootflash: file system to or from a FTP, TFTP, SFTP, or SCP server.
Refer to the Cisco MDS 9000 Family Configuration Guide for further information.
Deleting Files
The delete command deletes a specified file or the specified directory and all its contents. Refer to the Cisco MDS 9000 Family Configuration Guide for further information. This example shows how to delete a file from the bootflash: directory (assuming you are already in the bootflash: directory):
switch# delete dns_config.cfg
This example shows how to delete a file from an external CompactFlash (slot0):
switch# delete slot0:dns_config.cfg
This example deletes the entire my-dir directory and all its contents:
switch# delete bootflash:my-dir
Caution
If you specify a directory, the delete command deletes the entire directory and all its contents.
Displaying File Contents

The show file command displays the contents of a specified file in the file system. The syntax for this command is show file file_name This example displays the contents of the test file that resides in the slot0 directory.
switch# show file slot0:test
1-26
Chapter 1
CLI Overview Using the File System
config t Int fc1/1 no shut end show int
This example displays the contents of a file residing in the current directory.
switch# show file myfile
Saving Command Output to a File

You can force all screen output to go to a file by appending > filename to any command. For example, enter show interface > samplefile at the EXEC mode switch prompt to save the interface configuration to samplefilea file created at the same directory level. At the EXEC mode switch prompt, issue a dir command to view all files in this directory, including the recently saved samplefile. Refer to the Cisco MDS 9000 Family Configuration Guide for further information.
Note
Redirection is allowed only if the current directory is on the volatile: (default) or slot0: file systems. Redirection is not allowed if the current directory is on the bootflash: file system. The current directory can be viewed using the pwd command and changed using the cd command.
Compressing and Uncompressing Files

The gzip command compresses (zips) the specified file using LZ77 coding. This example directs the output of the show tech-support command to a file (Samplefile) and then zips the file and displays the difference in the space used up in the volatile: directory:
switch# show tech-support > Samplefile Building Configuration ... switch# dir 1525859 Jul 04 00:51:03 2003 Samplefile Usage for volatile:// 1527808 bytes used 19443712 bytes free 20971520 bytes total switch# gzip volatile:Samplefile switch# dir 266069 Jul 04 00:51:03 2003 Samplefile.gz Usage for volatile:// 266240 bytes used 20705280 bytes free 20971520 bytes total
The gunzip command uncompresses (unzips) LZ77 coded files. This example unzips the file that was compressed in the previous example:
switch# gunzip samplefile /volatile/samplefile.gz: No such file or directory switch# gunzip Samplefile switch# dir 1525859 Jul 04 00:51:03 2003 Samplefile Usage for volatile:// 1527808 bytes used 19443712 bytes free
1-27
CLI Overview
20971520 bytes total
Displaying the Last Line in a File

The tail command displays the last lines (tail end) of a specified file. The syntax for this command is tail <file name> [<number of lines>]
switch# tail mylog 10
You see the last 10 lines of the mylog file.
Executing Commands Specified in a Script

The run-script command executes the commands specified in a file. To use this command, be sure to create the file and specify commands in the required order.
Note
You cannot create the script files at the switch prompt. You can create the script file on an external machine and copy it the bootflash: directory. This section assumes that the script file resides in the bootflash: directory. The syntax for this command is run-script file_name This example displays the CLI commands specified in the testfile that resides in the slot0 directory.
switch# show file slot0:testfile conf t interface fc 1/1 no shutdown end sh interface fc1/1
This file output is in response to the run-script command executing the contents in the testfile file:
switch# run-script slot0:testfile 'conf t' Enter configuration commands, one per line. End with CNTL/Z. 'interface fc1/1' 'no shutdown' 'end' 'sh interface fc1/1' fc1/1 is down (Fcot not present) Hardware is Fibre Channel Port WWN is 20:01:00:05:30:00:48:9e Admin port mode is auto, trunk mode is on vsan is 1 Beacon is turned off Counter Values (current): 0 frames input, 0 bytes, 0 discards 0 runts, 0 jabber, 0 too long, 0 too short 0 input errors, 0 CRC, 0 invalid transmission words 0 address id, 0 delimiter 0 EOF abort, 0 fragmented, 0 unknown class 0 frames output, 0 bytes, 0 discards
1-28
Chapter 1
CLI Overview Role-Based CLI
Received 0 OLS, 0 LRR, 0 NOS, 0 loop inits Transmitted 0 OLS, 0 LRR, 0 NOS, 0 loop inits Counter Values (5 minute averages): 0 frames input, 0 bytes, 0 discards 0 runts, 0 jabber, 0 too long, 0 too short 0 input errors, 0 CRC, 0 invalid transmission words 0 address id, 0 delimiter 0 EOF abort, 0 fragmented, 0 unknown class 0 frames output, 0 bytes, 0 discards Received 0 OLS, 0 LRR, 0 NOS, 0 loop inits Transmitted 0 OLS, 0 LRR, 0 NOS, 0 loop inits
Setting the Delay Time

The sleep command delays an action by a specified number of seconds. The syntax for this command is sleep <seconds>
switch# sleep 30
You will see the switch prompt return after 30 seconds. This command is useful within scripts. For example, if you create a script called test-script:
switch# show file slot0:test-script discover scsi-target remote sleep 10 show scsi-target disk switch# run-script slot0:test-script
When you execute the slot0:test-script, the switch software executes the discover scsi-target remote command, and then waits for 10 seconds before executing the show scsi-target disk command.
Role-Based CLI
By default, two roles exist in all switches:

Network operatorHas permission to view the configuration. Network administratorHas permission to execute all commands and to set up to 64 permission levels based on user roles and groups.
When you execute a command, perform command completion, or obtain context sensitive help, the switch software allows the operation to progress if you have the correct permission as specified in the description of the command.
1-29
Chapter 1 Using Valid Formats and Ranges
CLI Overview
Using Valid Formats and Ranges

Note
Do not enter ellipsis ( ... ), vertical bar ( | ), less or great ( < > ), bracket ( [ ] ), or braces ( { } ) in command lines. These characters have special meaning in Cisco MDS SAN-OS text strings. Some commands require a MAC address, IP address, or IDs that must be designated in a standard format or given a range. See Table 1-4.
Table 1-4
Valid Formats and Ranges
Address MAC address IP address
Description 6 bytes in hexadecimal format separated by colons (not case-sensitive)
Valid Format Example 00:00:0c:24:d2:Fe
Range
126.2.54.1 32 bytes, written as 4 octets separated by periods (dotted decimal format) that are made up of a network section, an optional netmask section, and a host section. Integer that specifies the VSAN. Integer that specifies the VLAN 7 11
VSAN VLAN Port WWN (pWWN) Node WWN (nWWN) LUN
1 to 4093 1 to 4093
Eight hexadecimal numbers separated by colons (not 12:34:56:78:9A:BC:dE:F1 case-sensitive). Eight hexadecimal numbers separated by colons (not 12:34:56:78:9A:BC:dE:F1 case-sensitive). 8 bytes in hexadecimal format separated by colons. A 64 minimum of two hex characters are acceptable. The (100d = 64h) valid format is hhhh[:hhhh[:hhhh[:hhhh]]] Six character hexadecimal value prepended by 0x. Integer that specifies the domain. Integer that specifies timers in milliseconds for latency, FC time out values (TOV). Slot in which the applicable switching module resides. Integer specifying switch priority. Integer that specifies a PortChannel group addition. 0xabc123 7 100 1 5 1 1000 64
FCID Domain ID Timers Switching module Switch priority Channel group
1 to 239 0 to 2147483647 1 to 15 1 to 254 1 to 100 0 to 65535 64 to 65536 0 to 2147483647 1 to 255 250 to 5000
Fabric Shortest Path Integer that specifies the hold time (in milliseconds) First (FSPF) before making FSPF computations. Fabric Analyzer Fabric Analyzer captures FCIP profile The allowed range for the frame size limit in bytes.
An example of 10 frames, limits the number of frames 10 captured to 10. Integer that specifies the FCIP profile 101
TCP retransmit time Integer that specifies the minimum retransmit time for 300 the TCP connection in milliseconds
1-30
Chapter 1
CLI Overview Using Debug Commands
Table 1-4 Valid Formats and Ranges (continued)
Address Keepalive timeout
Description
Valid Format Example
Range 1 to 7200 1 to 8 60 to 3600 0 to 8192 10 to 100 0 to 65535 1 to 60,000 1 to 64 5 to 255
Integer that specifies the TCP connections keepalive 60 timeout in seconds. 6 90
TCP retransmissions Integer that specifies the maximum number of TCP transmissions. PMTU TCP buffer size Traffic burst size Peer TCP port Acceptable time difference iSCSI pWWN allocation CDP refresh and hold time Integer that specifies the path MTU reset time in seconds
Integer that specifies the advertised TCP buffer size in 5000 KB. Integer that specifies the maximum burst size in KB. 30 Integer that specifies the TCP port number 3000 Integer that specifies the acceptable time difference in 4000 milliseconds for a packet being accepted. Integer that specifies the number of pWWNs that must be allocated to an iSCSI initiator. 2
Integer that specifies the refresh time interval and the 60 hold time in seconds for the CDP protocol.
Using Debug Commands

Caution
Because debugging output is assigned high priority in the CPU process, it can render the system unusable. For this reason, use debug commands only to troubleshoot specific problems or during troubleshooting sessions with Cisco technical support staff. Moreover, it is best to use debug commands during periods of lower network traffic and fewer users. Debugging during these periods decreases the likelihood that increased debug command processing overhead will affect system use. All debug commands are entered in privileged EXEC mode, and most debug commands take no arguments. Use the show debugging command to display the state of each debugging option. To list and see a brief description of all the debugging command options, enter the command debug ? at the command line in privileged EXEC mode. For example:
switch# debug ?
Not all debugging commands listed in the debug ? output are described in this document. Commands are included here based on their usefulness in assisting you to diagnose network problems. Commands not included are typically used internally by Cisco engineers during the development process and are not intended for use outside the Cisco environment. To enable all system diagnostics, enter the debug all command at the command line in privileged EXEC mode. For example:
switch# debug all
1-31
Chapter 1 Using Debug Commands
CLI Overview
To turn off all diagnostic output, enter the no debug all command at the command line in privileged EXEC mode. For example:
switch# no debug all
Using the no debug all command is a convenient way to ensure that you have not accidentally left any debug commands turned on.
Caution
Because debugging output takes priority over other network traffic, and because the debug all command generates more output than any other debug command, it can severely diminish the performance of the router or even render it unusable. In virtually all cases, it is best to use more specific debug commands.
Generating debug Command Output

Enabling a debug command can result in output similar to the following example for the debug modem command:
Router# debug modem 15:25:51: 15:25:51: 15:25:51: 15:27:51: 15:27:51: 15:27:51: 15:27:52: 15:27:52: 15:27:57: 15:27:58: TTY4: tty4: TTY4: TTY4: TTY4: TTY4: TTY4: tty4: TTY4: TTY4: DSR came up Modem: IDLE->READY Autoselect started Autoselect failed Line reset Modem: READY->HANGUP dropping DTR, hanging up Modem: HANGUP->IDLE restoring DTR DSR came up
The router continues to generate such output until you enter the corresponding no debug command (in this case, the no debug modem command). If you enable a debug command and no output is displayed, consider the following possibilities:

The router may not be properly configured to generate the type of traffic you want to monitor. Use the more system:running-config EXEC command to check its configuration. Even if the router is properly configured, it may not generate the type of traffic you want to monitor during the particular period that debugging is turned on. Depending on the protocol you are debugging, you can use commands such as the TCP/IP ping EXEC command to generate network traffic.
Redirecting debug and Error Message Output

By default, the network server sends the output from debug commands and system error messages to the console. If you use this default, monitor debug output using a virtual terminal connection, rather than the console port. To redirect debug output, use the logging command options within configuration mode as described in the following sections. Possible destinations include the console, virtual terminals, internal buffer, and UNIX hosts running a syslog server. The syslog format is compatible with 4.3 Berkeley Standard Distribution (BSD) UNIX and its derivatives.
1-32
Chapter 1
Note
Be aware that the debugging destination you use affects system overhead. Logging to the console produces very high overhead, whereas logging to a virtual terminal produces less overhead. Logging to a syslog server produces even less, and logging to an internal buffer produces the least overhead of any method. To configure message logging, you need to be in configuration command mode. To enter this mode, use the configure terminal command at the EXEC prompt.
Enabling Message Logging

To enable message logging to all supported destinations other than the console, enter the following command: logging on The default condition is logging on. To direct logging to the console only and disable logging output to other destinations, enter the following command: no logging on
Setting the Message Logging Levels

You can set the logging levels when logging messages to the following devices:

Console Monitor Syslog server
Table 5 lists and briefly describes the logging levels and corresponding keywords you can use to set the logging levels for these types of messages. The highest level of message is level 0, emergencies. The lowest level is level 7, debugging, which also displays the greatest amount of messages. For information about limiting these messages, see sections later in this chapter.
Table 5 Message Logging Keywords and Levels
Level 0 1 2 3 4 5 6 7
Keyword emergencies alerts critical errors warnings notification informational debugging
Description System is unusable. Immediate action is needed. Critical conditions exist. Error conditions exist. Warning conditions exist. Normal, but significant, conditions exist. Informational messages. Debugging messages.
Syslog Definition LOG_EMERG LOG_ALERT LOG_CRIT LOG_ERR LOG_WARNING LOG_NOTICE LOG_INFO LOG_DEBUG
1-33
CLI Overview
Limiting the Types of Logging Messages Sent to the Console

To limit the types of messages that are logged to the console, use the logging console router configuration command. The full syntax of this command follows: logging console level no logging console The logging console command limits the logging messages displayed on the console to messages up to and including the specified severity level, which is specified by the level argument. Keywords are listed in order from the most severe level to the least severe. The no logging console command disables logging to the console. The following example sets console logging of messages at the debugging level, which is the least severe level and which displays all logging messages:
logging console debugging
Logging Messages to an Internal Buffer

The default logging device is the console; all messages are displayed on the console unless otherwise specified. To log messages to an internal buffer, use the logging buffered router configuration command. The full syntax of this command follows: logging buffered no logging buffered The logging buffered command copies logging messages to an internal buffer instead of writing them to the console. The buffer is circular in nature, so newer messages overwrite older messages. To display the messages that are logged in the buffer, use the show logging privileged EXEC command. The first message displayed is the oldest message in the buffer. The no logging buffered command cancels the use of the buffer and writes messages to the console (the default).
Limiting the Types of Logging Messages Sent to Another Monitor

To limit the level of messages logged to the terminal lines (monitors), use the logging monitor router configuration command. The full syntax of this command follows: logging monitor level no logging monitor The logging monitor command limits the logging messages displayed on terminal lines other than the console line to messages with a level up to and including the specified level argument. To display logging messages on a terminal (virtual console), use the terminal monitor privileged EXEC command. The no logging monitor command disables logging to terminal lines other than the console line.
1-34
Chapter 1
The following example sets the level of messages displayed on monitors other than the console to notification:
logging monitor notification
Logging Messages to a UNIX Syslog Server

To log messages to a syslog server host, use the logging host global configuration command. The full syntax of this command follows: logging host {ip-address | host-name} [xml] no logging host {ip-address | host-name} [xml] The logging host command identifies a syslog server host that is to receive logging messages. The ip-address argument is the IP address of the host. By issuing this command more than once, you build a list of syslog servers that receive logging messages. The no logging host command deletes the syslog server with the specified address from the list of syslogs.
Limiting Messages to a Syslog Server

To limit the number of messages sent to syslog servers, use the logging trap router configuration command. The full syntax of this command follows: logging trap level no logging trap The logging trap command limits the logging messages sent to syslog servers to logging messages with a level up to and including the specified level argument. To send logging messages to a syslog server, specify its host address with the logging host command. The default trap level is informational. The no logging trap command returns the trap level to the default. The current software generates the following categories of syslog messages:

Error messages at the emergencies level. Error messages at the alerts level. Error messages at the critical level. Error messages about software or hardware malfunctions, displayed at the errors level. Interface up/down transitions and system restart messages, displayed at the notification level. Reload requests and low-process stack messages, displayed at the informational level. Output from the debug commands, displayed at the debugging level.
The show logging privileged EXEC command displays the addresses and levels associated with the current logging setup. The command output also includes ancillary statistics.
1-35
CLI Overview
Example of Setting Up a UNIX Syslog Daemon
To set up the syslog daemon on a 4.3 BSD UNIX system, include a line such as the following in the file /etc/syslog.conf:
local7.debugging /usr/adm/logs/tiplog
The local7 keyword specifies the logging facility to be used. The debugging keyword specifies the syslog level. See Table 5 for other keywords that can be listed. The UNIX system sends messages at or above this level to the specified file, in this case /usr/adm/logs/tiplog. The file must already exist, and the syslog daemon must have permission to write to it. For the System V UNIX systems, the line should read as follows:
local7.debug /usr/admin/logs/cisco.log
1-36
C H A P T E R
A Commands
The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. See the Command Modes section to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.
2-1
Chapter 2 aaa accounting logsize
A Commands
aaa accounting logsize

To set the size of the local accounting log file, use the aaa accounting logsize command to set the size of the local accounting log file. To revert to the default logsize 35000 bytes, use the no form of the command. aaa accounting logsize integer no aaa accounting logsize
Syntax Description
aaa accounting logsize integer
Configures accounting methods Configures local accounting log file size (in bytes). Sets the size limit of the local accounting log file in bytes from 0 to 35000.
Defaults
35,000
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example shows the log file size configured at 29000 bytes.
switch# config terminal switch(config)# aaa accounting logsize 29000
Related Commands
Command show accounting logsize show accounting log
Description Displays the configured log size. Displays the entire log file.
2-2
Chapter 2
A Commands aaa accounting default
aaa accounting default

To configure the default accounting method, use the aaa accounting default command. To revert to the default local accounting, use the no form of the command. aaa accounting default {group group-name [none] | none} | local [none] | none} no aaa accounting default {group group-name [none] | none} | local [none] | none}
Syntax Description
group group-name local none
Specifies the group authentication method. The group name is a maximum of 127 characters. Specifies the local authentication method. No authentication, everyone permitted.
Defaults
Local accounting.
Command Modes
Configuration mode.
Command History
This command was modified in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
Specify the currently configured command preceded by a no in order to revert to the factory default.
Examples
The following example enables accounting to be performed using remote TACACS+ servers which are member of the group called TacServer, followed by the local accounting method.
switch# config t switch(config)# aaa accounting default group TacServer
The following example turns off accounting.

switch(config)# aaa accounting default none
The following example reverts to the local accounting (default).

switch(config)# no aaa accounting default group TacServer
Related Commands
Command show aaa accounting
Description Displays the configured accounting methods.
2-3
Chapter 2 aaa authentication login
A Commands
aaa authentication login

To configure the authentication method for a login, use the aaa authentication login command in configuration mode. To revert to local authentication, use the no form of the command. aaa authentication login {default {group group-name [none] | none} | local [none] | none} | console {group-name [none] | none} | local [none] | none}| error-enable} no aaa authentication login {default {group group-name [none] | none} | local [none] | none} | console {group-name [none] | none} | local [none] | none}| error-enable}
Syntax Description
default console group group-name local none error-enable
Configures the default method. Configures the console authentication login method. Specifies the group name. The group name is a maximum of 127 characters. Specifies the local authentication method. No authentication, everyone permitted. Configures login error message display enable.
Defaults
local user name authentication.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Use the console option to override the console login method. Specify the currently configured command preceded by a no in order to revert to the factory default.
Examples
The following example enables all login authentication to be performed using remote TACACS+ servers which are member of the group called TacServers, followed by the local login method.
switch# config t switch(config)# aaa authentication login default group TacServer
The following example enables console authentication to use the group called TacServers, followed by the local login method.
switch(config)# aaa authentication login console group TacServer
The following example turns off password validation.

switch(config)# aaa authentication login default none
The following example reverts to the local authentication method (default).

switch(config)# no aaa authentication login default group TacServer
2-4
Chapter 2
A Commands aaa authentication login
Related Commands Command show aaa authentication Description Displays the configured authentication methods.
2-5
Chapter 2 aaa authentication dhchap default
A Commands
aaa authentication dhchap default

To configure DHCHAP authentication method, use the aaa authentication dhchap default command in configuration mode. To revert to factory defaults, use the no form of the command. aaa authentication dhchap default {group group-name [none] | none} | local [none] | none}} no aaa authentication dhchap default {group group-name [none] | none} | local [none] | none}
Syntax Description
Specifies the group name authentication method. The group name is a maximum of 127 characters. Specifies local user name authentication (default). Specifies no authentication.
Defaults
local user name authentication.
Command Modes
Configuration mode.
Command History
Usage Guidelines
The local option disables other authentication methods and configures local authentication to be used exclusively. Specify the currently configured command preceded by a no in order to revert to the factory default.
Examples
The following example enables all DHCHAP authentication to be performed using remote TACACS+ servers which are member of the group called TacServers, followed by the local authentication.
switch# config terminal switch(config)# aaa authentication dhchap default group TacServer

switch(config)# no aaa authentication dhcahp default group TacServer
Related Commands
Command show aaa authentication
Description Displays the configured authentication methods.
2-6
Chapter 2
A Commands aaa authentication iscsi default
aaa authentication iscsi default

To configure the iSCSI authentication method, use the aaa authentication iscsi default command in configuration mode. To negate the command or revert to factory defaults, use the no form of this command. aaa authentication iscsi default {group group-name [none] | none} | local [none] | none}} no aaa authentication iscsi default {group group-name [none] | none} | local [none] | none}}
Syntax Description
Specifies the group name. The group name is a maximum of 127 characters. Specifies local user name authentication (default). Specifies no authentication.
Defaults
Local user name authentication.
Command Modes
Configuration mode.
Command History
Usage Guidelines
The local option disables other authentication methods and configures local authentication to be used exclusively. Specify the currently configured command preceded by a no in order to revert to the factory default.
Examples
The following example enables all iSCSI authentication to be performed using remote TACACS+ servers which are member of the group called TacServers, followed by the local authentication.
switch# config terminal switch(config)# aaa authentication iscsi default group TacServer

switch(config)# no aaa authentication iscsi default group TacServer
Related Commands
Command show aaa authentication
Description Displays the configured authentication methods.
2-7
Chapter 2 aaa group server
A Commands
aaa group server

To configure one or more independent server groups, use the aaa group server command in configuration mode. To remove the server group, use the no form of this command to remove the server group. aaa group server {radius | tacacs+} group-name server server-name no server server-name no aaa group server {radius | tacacs+} group-name
Syntax Description
radius tacacs+ group-name server server-name
Specifies the RADIUS server group. Specifies the TACACS+ server group. Identifies the specified group of servers with a user-defined name. The name is limited to 64 alphanumeric characters. Specifies the server name to add or remove from the server group.
Defaults
None.
Command Modes
Configuration.
Command History
Usage Guidelines
You can configure these server groups at any time but they only take effect when you apply them to a AAA service using the aaa authentication login or the aaa accounting commands.
Examples
You can configure these server groups at any time but they only take effect when you apply them to a AAA service using the aaa authentication or the aaa accounting commands.
switch# config terminal switch(config)# aaa group server tacacs+ TacacsServer1 switch(config-tacacs+)# server ServerA switch(config-tacacs+)# exit switch(config)# aaa group server radius RadiusServer19 switch(config-radius)# server ServerB switch(config-radius)# no server ServerZ
Related Commands
Command show aaa groups
Description Displays all configured server groups.
2-8
Chapter 2
A Commands aaa group server
Command show radius-server groups show tacacs-server groups Description Displays configured RADIUS server groups Displays configured TACACS server groups
2-9
Chapter 2 abort
A Commands
abort
To discard a Call Home configuration session in progress, use the abort command in Call Home configuration submode. abort
Syntax Description
This command has no other arguments or keywords.
Defaults
None.
Command Modes
Call Home configuration submode
Command History
Release 2.0(1b)
Modification This command was introduced.
Usage Guidelines
None.
Examples
The following example shows how to discard a Call Home configuration session in progress.
switch# config terminal Enter configuration commands, one per line. switch(config)# callhome switch(config-callhome)# abort End with CNTL/Z.
Related Commands
Command callhome callhome test show callhome
Description Configures the Call Home function. Sends a dummy test message to the configured destination(s). Displays configured Call Home information.
2-10
Chapter 2
A Commands active equals saved
active equals saved

Enable the active equals saved command to automatically write any changes to the block, prohibit or port address name to the IPL file. To disable the configuration or to revert to factory defaults, use the no form of the command. active equals saved no active equals saved
Syntax Description
Defaults
Disabled.
Command Modes
FICON configuration submode.
Command History
Usage Guidelines
Enabling active equals saved ensures that you do not have to perform the copy running-config startup-config command to save the FICON configuration as well as the running configuration. If your switch or fabric consists of multiple FICON-enabled VSANs, and one of these VSANs has active equals saved enabled, changes made to the non-FICON configuration causes all FICON-enabled configurations to be saved to the IPL file. Refer to the Cisco MDS 9000 Family Configuration Guide for further information.
Examples
The following example enables the automatic save feature for a VSAN.
switch(config)# ficon vsan 2 switch(config-ficon)# active equals saved
The following example disables the automatic save feature for this VSAN.
switch(config-ficon)# no active equals saved
Related Commands
Command ficon vsan vsan-id show ficon
Description Enables FICON on the specified VSAN. Displays configured FICON details.
copy running-config startup-config Saves the running configuration to the startup configuration.
2-11
Chapter 2 arp
A Commands
arp
To enable the Address Resolution Protocol (ARP) for the switch, use the arp command.To disable ARP for the switch, use the no form of the command. arp hostname no arp hostname
Syntax Description
hostname
Name of the host. Maximum length is 20 characters.
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example disables the Address Resolution Protocol configured for the host with the IP address 10.1.1.1.
switch(config)# no arp 10.1.1.1 switch(config)#
Related Commands
Command show arp clear arp
Description Displays the ARP table. Deletes a specific entry or all entries from the ARP table.
2-12
Chapter 2
A Commands attach module
attach module
To connect to a specific module, use the attach module command in EXEC mode. attach module slot-number
Syntax Description
slot-number
Specifies slot number of the module to which to connect.
Command Modes
EXEC.
Command History
Usage Guidelines
You can use the attach module command to view the standby supervisor module information, but you cannot configure the standby supervisor module using this command. You can also use the attach module command on the switching module portion of the Cisco MDS 9216 supervisor module, which resides in slot 1 of this two-slot switch. To disconnect, use the exit command at the module-number# prompt, or type $. to forcibly abort the attach session.
Examples
The following example connects to the module in slot 2. Note that after you connect to the image on the module using the attach module command, the prompt changes to module-number#.
switch# attach module 1 Attaching to module 1 ... To exit type 'exit', to abort type '$.' module-1# exit switch#
Related Commands
Command exit show module
Description Disconnects from the module. Displays the status of a module.
2-13
Chapter 2 attribute qos
A Commands
attribute qos
To configure a QOS attribute, use the attribute qos command in Inter-VSAN Routing (IVR) zone configuration submode. To disable this feature, use the no form of this command. attribute qos {high | low | medium} no attribute qos {high | low | medium}
Syntax Description
high low medium
Configures frames matching zone to get high priority. Configures frames matching zone to get low priority (Default). Configures frames matching zone to get medium priority.
Defaults
Disabled
Command Modes
IVR zone configuration submode
Command History
Release 2.1(1a)
Usage Guidelines
None.
Examples
The following example shows how to configure an IVR zone QOS attribute to low priority.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ivr zone name IvrZone switch(config-ivr-zone)# attribute qos priority low
Related Commands
Command show ivr zone
Description Displays IVR zone configuration.
2-14
Chapter 2
A Commands autonomous-fabric-id (IVR topology database configuration)
autonomous-fabric-id (IVR topology database configuration)

To configure an autonomous fabric ID (AFID) into the Inter-VSAN Routing (IVR) topology database, use the autonomous-fabric-id command. To remove the fabric ID, use the no form of the command. autonomous-fabric-id fabric-id switch-wwn swwn vsan-ranges vsan-id no autonomous-fabric-id fabric-id switch-wwn swwn vsan-ranges vsan-id
Syntax Description
fabric-id
Specifies the fabric ID for the IVR topology.

Note
For Cisco MDS SAN-OS images prior to release 2.1(1a), the fabric-id value is limited to 1. For Releases 2.1(1a) and later images, the fabric-id range is 1 to 64.
switch-wwn swwn vsan-ranges vsan-id
Configures the switch WWN in dotted hex format. Configures up to five ranges of VSANs to be added to the database. The range is 1 to 4093.
Defaults
None.
Command Modes
IVR topology database configuration submode.
Command History
Release 1.3(1) 2.1(1a)
Modification This command was introduced. Modified range for fabric-id.
Usage Guidelines
The following rules apply to configuring AFIDs to VSANs:

The default AFID of a VSAN is 1. Each VSAN belongs to one and only one AFID. A switch can be a member of multiple AFIDs. AFIDs at a switch must not share any VSAN identifier (for example, a VSAN at a switch can belong to only one AFID). A VSAN identifier can be reused in different AFIDs, without merging the VSANs, as long as those AFIDs do not share a switch.
You can have up to 64 VSANs (or 128 VSANs for Cisco MDS SAN-OS Release 2.1(1a) or later) in an IVR topology. Specify the IVR topology using the following information:

The switch WWNs of the IVR-enabled switches. A minimum of two VSANs to which the IVR-enabled switch belongs.
2-15
Chapter 2 autonomous-fabric-id (IVR topology database configuration)
A Commands
The autonomous fabric ID (AFID), which distinguishes two VSANs that are logically and physically separate, but have the same VSAN number. Cisco MDS SAN-OS Release 1.3(1) and later supports only one default AFID (AFID 1) and thus does not support non-unique VSAN IDs in the network. As of Cisco MDS SAN-OS Release 2.1(1a), you can specify up to 64 AFIDs.
Note
Two VSANs with the same VSAN number but different fabric IDs are counted as two VSANs out o f the 128 total VSANs allowed in the fabric. The following command enters the configuration mode, enables the IVR feature, enters the VSAN topology database, and configures the pWWN-VSAN association for VSANs 2 and 2000:
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ivr enable switch(config)# ivr vsan-topology database switch(config-ivr-topology-db)# autonomous-fabric-id 1 switch 20:00:00:00:30:00:3c:5e vsan-ranges 2,2000
Related Commands
Command ivr enable ivr vsan-topology database show autonomous-fabric-id database show ivr
Description Enables the Inter-VSAN Routing (IVR) feature. Configures a VSAN topology database. Displays the contents of the AFID database. Displays IVR feature information.
2-16
Chapter 2
A Commands autonomous-fabric-id (IVR service group configuration)
autonomous-fabric-id (IVR service group configuration)

To configure an autonomous fabric ID (AFID) into an IVR service group, use the autonomous-fabric-id command in IVR service group configuration submode. To remove the autonomous fabric ID, use the no form of the command. autonomous-fabric-id afid vsan-ranges vsan-id no autonomous-fabric-id afid vsan-ranges vsan-id
Syntax Description
afid vsan-ranges vsan-id
Specifies the AFID to the local VSAN. Configures up to five ranges of VSANs to be added to the service group. The range is 1 to 4093.
Defaults
None.
Command Modes
IVR service group configuration submode.
Command History
Release 2.1
Usage Guidelines
Before configuring an IVR service group, you must enable the following:

IVR using the ivr enable command IVR distribution using the ivr distribute command Automatic IVR topology discovery using the ivr vsan-topology auto command
To change to IVR service group configuration submode, use the ivr service-group name command.
Examples
The following command enters the IVR service group configuration submode and configures AFID 10 to be in IVR service group serviceGroup1:
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ivr enable switch(config)# ivr distribute switch(config)# ivr vsan-topology auto switch(config)# ivr service-group name serviceGroup1 switch(config-ivr-sg)# autonomous-fabric-id 10 vsan 1-4
2-17
Chapter 2 autonomous-fabric-id (IVR service group configuration)
A Commands
Related Commands Command ivr enable ivr service-group name show autonomous-fabric-id database show ivr Description Enables the Inter-VSAN Routing (IVR) feature. Configures an IVR service group and changes to IVR service group configuration submode. Displays the contents of the AFID database. Displays IVR feature information.
2-18
Chapter 2
A Commands autonomous-fabric-id database
autonomous-fabric-id database
To configure an autonomous fabric ID (AFID) database, use the autonomous-fabric-id database command. To remove the fabric AFID database, use the no form of the command. autonomous-fabric-id database no autonomous-fabric-id database
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.1(1a)
Usage Guidelines
You must configure the IVR VSAN topology to auto mode, using the ivr vsan-topology auto command, before you can use the autonomous-fabric-id database command to modify the database. The autonomous-fabric-id database command also enters AFID database configuration submode.
Note
In user-configured VSAN topology mode, the AFIDs are specified in the IVR VSAN topology configuration itself and a separate AFID configuration is not needed.
Examples
The following example shows how to create an AFID database and enters AFID database configuration submode:
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# autonomous-fabric-id database switch(config-afid-db)#
Related Commands
Command ivr vsan-topology auto switch-wwn show autonomous-fabric-id database show ivr
Description Configures a VSAN topology for Inter-VSAN Routing (IVR) to auto configuration mode. Configures a switch WWN in the autonomous fabric ID (AFID) database Displays the contents of the AFID database. Displays IVR feature information.
2-19
Chapter 2 autonomous-fabric-id database
A Commands
2-20
C H A P T E R
B Commands
3-1
Chapter 3 banner motd
B Commands
banner motd
To configure a message of the day (MOTD) banner, use the banner motd command in configuration mode. banner motd [delimiting-character message delimiting-character] no banner motd [delimiting-character message delimiting-character]
Syntax Description
delimiting-character message
Identifies the delimiting character. Specifies the banner message that is restricted to 40 lines with a maximum of 80 characters in each line.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
The configured MOTD banner is displayed before the login prompt on the terminal whenever a user logs in to a Cisco MDS 9000 Family switch. Follow these guidelines when choosing your delimiting character:

Do not use the delimiting-character in the message string. Do not use " and % as delimiters.
You can include tokens in the form $(token) in the message text. Tokens will be replaced with the corresponding configuration variable. For example:

$(hostname) $(line)
displays the host name for the switch
displays the vty or tty line no or name
The $(line-desc) and $(domain) tokens are not supported.
Examples
The following example configures a banner message with the following text Testing the MOTD Feature.
switch# config terminal switch(config)# banner motd # Testing the MOTD Feature. #
3-2
Chapter 3
B Commands banner motd
The following example spans multiple lines and uses tokens to configure the banner message:
switch# config terminal switch(config)# banner motd # Enter TEXT message. End with the character '#'. Welcome to switch $(hostname). You tty line is $(line). #
Related Commands
Command show banner motd
Description Displays the configured banner message.
3-3
Chapter 3 boot
B Commands
boot
To perform operations on the system, use the boot command in configuration mode. To negate this feature or return to factory defaults, use the no form of the command. boot {asm-sfn {bootflash: | slot0: | tftp:}[image] [module [slot-number]] | auto-copy | kickstart {bootflash: | slot0: | tftp:}[image] [sup-1 [sup-2] | sup-2] | lasilc {bootflash: | slot0: | tftp:}[image] [module [slot-number]] | ssi {bootflash: | slot0:} | system {bootflash: | slot0: | tftp:}[image] [sup-1 [sup-2] | sup-2]} no boot {asm-sfn | auto-copy | kickstart | lasilc | system}
Syntax Description
asm-sfn module slot-number auto-copy kickstart lasilc ssi system bootflash: slot0: tftp: image sup-1 sup-2
Configures the virtualization image. Specifies the slot number of the SSM. Configures auto-copying of boot variable images. Configures the kickstart image. Configures the boot image. Configures the SSI image. Configures the system image. Specifies system image URI for bootflash. Specifies system image URI for slot 0. Specifies system image URI for TFTP. Specifies the image file name. The upper supervisor. The lower supervisor.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
The boot kickstart slot0:image command is currently not allowed. For kickstart, only bootflash: is allowed. When the boot auto-copy command is issued, the system copies the boot variable images which are local (present) in the active supervisor module (but not in the standby supervisor module) to the standby supervisor module. For kickstart and system boot variables, only those images that are set for the standby supervisor module are copied. For modules (line card) images, all modules present in standby's corresponding locations (bootflash: or slot0:) will be copied.
3-4
Chapter 3
B Commands boot
Examples The following example adds the new system image file to the SYSTEM environment variable.
switch(config)# boot system bootflash:system.img
The following example boots from the CompactFlash device (slot0:). The switch updates the SYSTEM environment variable to reflect the new image file in the specified Flash device.
switch(config)# boot system slot0:system.img
The following example overwrites the old Kickstart environment variable in the configuration file:
switch(config)# boot kickstart bootflash:kickstart.img
The following example specifies the SSM image to be used:

switch(config)# boot asm-sfn bootflash:m9000-ek9-asm-sfn-mz.1.2.2.bin
The following example enables automatic copying of boot variables from the active supervisor module to the standby supervisor module.
switch(config)# boot auto-copy
The following example disables the automatic copy feature (default).

switch(config)# no boot auto-copy
Related Commands
Command show boot
Description Displays the configured boot variable information.
3-5
Chapter 3 bport
B Commands
bport
To configure a B port mode on a FCIP interface, use the bport option. To disable a B port mode on a FCIP interface, use the no form of the command. bport no bport
Syntax Description
Defaults
Disabled.
Command Modes
Interface configuration submode.
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode.
Examples
The following example shows how to configure a B port mode on an FCIP interface.
switch# config terminal switch(config)# interface fcip 1 switch(config-if)# bport
Related Commands
Command show interface fcip bport-keepalive
Description Displays an interface configuration for a specified FCIP interface. Configures B port keepalive responses.
3-6
Chapter 3
B Commands bport-keepalive
bport-keepalive
To configure keepalive responses for B port FCIP interfaces, use the bport-keepalive option. To disable keepalive responses for B port FCIP interfaces, use the no form of the command. bport-keepalive no bport-keepalive
Syntax Description
Defaults
Disabled
Command Modes
Interface configuration submode
Command History
Usage Guidelines
Examples
The following example shows how to configure keepalive responses for B port FCIP interfaces.
switch# config terminal switch(config)# interface fcip 1 switch(config-if)# bport-keepalives
Related Commands
Command show interface fcip bport
Description Displays an interface configuration for a specified FCIP interface. Configures a B port FCIP interface.
3-7
Chapter 3 broadcast
B Commands
broadcast
To enable the broadcast frames attribute in a zone attribute group, use the broadcast command. To revert to the default, use the no form of the command. broadcast no broadcast
Syntax Description
Defaults
Disabled.
Command Modes
Zone attribute configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
Broadcast frames are sent to all Nx ports. If any NL port attached to an FL port shares a broadcast zone with the source of the broadcast frame, then the frames are broadcast to all devices in the loop. This command only configures the broadcast attribute for enhanced zoning. To enable broadcast zoning for basic mode, use the attribute broadcast subcommand after entering zone configuration mode using the zone name command.
Examples
The following example shows how to set the broadcast attribute for a zone attribute group.
switch# config terminal switch(config)# zone-attribute-group name admin-attributes vsan 10 switch(config-attribute-group)# broadcast
Related Commands
Command show zone-attribute-group zone mode enhanced vsan zone name zone-attribute-group name
Description Displays zone attribute group information. Enables enhanced zoning for a VSAN. Configures zone attributes. Configures zone attribute groups.
3-8
C H A P T E R
C Commands
The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. See the About the CLI Command Modes section on page 1-3 to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.
4-1
Chapter 4 callhome
C Commands
callhome
To configure the Call Home function, use the callhome command. callhome
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
The Call Home configuration commands are available in the (config-callhome) submode. A Call Home message is used to contact a support person or organization in case an urgent alarm is raised. Once you have configured the contact information, you must enable the Call Home function. The enable command is required for the Call Home function to start operating. When you disable the Call Home function, all input events are ignored.
Note
Even if Call Home is disabled, basic information for each Call Home event is sent to syslog.
Examples
The following example assigns contact information.

switch# config terminal config terminal switch# snmp-server contact [email protected] switch(config)# callhome switch(config-callhome)# email-contact [email protected] switch(config-callhome)# phone-contact +1-800-123-4567 switch(config-callhome)# streetaddress 1234 Picaboo Street, Any city, Any state, 12345 switch(config-callhome)# switch-priority 0 switch(config-callhome)# customer-id Customer1234 switch(config-callhome)# site-id Site1ManhattanNY switch(config-callhome)# contract-id Company1234
4-2
Chapter 4
C Commands callhome
Related Commands Command callhome test show callhome Description Sends a dummy test message to the configured destination(s). Displays configured Call Home information.
4-3
Chapter 4 callhome test
C Commands
callhome test
To simulate a CallHome message generation, use the callhome test command. callhome test [inventory]
Syntax Description
inventory
Sends a dummy CallHome inventory.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
You can simulate a message generation by issuing a callhome test command.
Examples
The following example sends a test message to the configured destination(s):

switch# callhome test trying to send test callhome message successfully sent test callhome message
The following example sends a test inventory message to the configured destination(s)
switch# callhome test inventory trying to send test callhome message successfully sent test callhome message
Related Commands
Command callhome show callhome
Description Configures Call Home functions. Displays configured Call Home information.
4-4
Chapter 4
C Commands cd
cd
To change the default directory or file system, use the cd command. cd {directory | bootflash:[directory] | slot0:[directory] | volatile:[directory]}
Syntax Description
directory bootflash: slot0: volatile:
Name of the directory on the file system. URI or alias of the bootflash or file system. URI or alias of the slot0 file system. URI or alias of the volatile file system.
Defaults
The initial default file system is flash:. For platforms that do not have a physical device named flash:, the keyword flash: is aliased to the default Flash device. If you do not specify a directory on a file system, the default is the root directory on that file system.
Command Modes
EXEC mode
Command History
Usage Guidelines
For all EXEC commands that have an optional file system argument, the system uses the file system specified by the cd command when you omit the optional file system argument. For example, the dir command, which displays a list of files on a file system, contains an optional file system argument. When you omit this argument, the system lists the files on the file system specified by the cd command.
Examples
The following example sets the default file system to the Flash memory card inserted in slot 0:
switch# pwd bootflash:/ switch# cd slot0: switch# pwd slot0:/
Related Commands
Command copy delete dir pwd show file systems undelete
Description Copies any file from a source to a destination. Deletes a file on a Flash memory device. Displays a list of files on a file system. Displays the current setting of the cd command. Lists available file systems and their alias prefix names. Recovers a file marked deleted on a Class A or Class B Flash file system.
4-5
Chapter 4 cdp
C Commands
cdp
Use the cdp command to globally configure the Cisco Discovery Protocol parameters. Use the no form of this command to revert to factory defaults. cdp {enable | advertise {v1 | v2} | holdtime holdtime-seconds | timer timer-seconds} no cdp {enable | advertise | holdtime holdtime-seconds | timer timer-seconds}
Syntax Description
enable advertise v1 v2 holdtime holdtime-seconds timer timer-seconds
Enables CDP globally on all interfaces on the switch. Specifies the EXEC command to be executed. Specifies CDP version 1. Specifies CDP version 2. Sets the hold time advertised in CDP packets. Specifies the holdtime in seconds. The default is 180 seconds and the valid range is from 10 to 255 seconds. Sets the refresh time interval. Specifies the time interval in seconds. The default is 60 seconds and the valid range is from 5 to 255 seconds.
Defaults
CDP is enabled. The hold time default interval is 180 seconds. The refresh time interval is 60 seconds.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Use the cdp enable command to enable the Cisco Discovery Protocol (CDP) feature at the switch level or at the interface level. Use the no form of this command to disable this feature. When the interface link is established, CDP is enabled by default CDP version 1 (v1) and version 2 (v2) are supported in Cisco MDS 9000 Family switches. CDP packets with any other version number are silently discarded when received.
Examples
The following example disables the CDP protocol on the switch. When CDP is disabled on an interface, one packet is sent to clear out the switch state with each of the receiving devices.
switch(config)# no cdp enable Operation in progress. Please check global parameters switch(config-console)#
4-6
Chapter 4
C Commands cdp
The following example enables (default) the CDP protocol on the switch. When CDP is enabled on an interface, one packet is sent immediately. Subsequent packets are sent at the configured refresh time
switch(config)# cdp enable Operation in progress. Please check global parameters switch(config)#
The following example configures the Gigabit Ethernet interface 8/8 and disables the CDP protocol on this interface. When CDP is disabled on an interface, one packet is sent to clear out the switch state with each of the receiving devices.
switch(config)# interface gigbitethernet 8/8 switch(config-if)# no cdp enable Operation in progress. Please check interface parameters switch(config-console)#
The following example enables (default) the CDP protocol on the selected interface. When CDP is enabled on this interface, one packet is sent immediately. Subsequent packets are sent at the configured refresh time.
switch(config-if)# cdp enable Operation in progress. Please check interface parameters switch(config)#
The following example globally configures the refresh time interval for the CDP protocol in seconds. The default is 60 seconds and the valid range is from 5 to 255 seconds.
switch# config terminal switch(config)# cdp timer 100 switch(config)#
The following example globally configures the hold time advertised in CDP packet in seconds. The default is 180 seconds and the valid range is from 10 to 255 seconds.
switch# config terminal switch(config)# cdp holdtime 200 switch(config)#
The following example globally configures the CDP version. The default is version 2 (v2). The valid options are v1 and v2
switch# config terminal switch(config)# cdp advertise v1 switch(config)#
Related Commands
Command clear cdp show cdp
Description Clears global or interface-specific CDP configurations. Displays configured CDP settings and parameters.
4-7
Chapter 4 cfs distribute
C Commands
cfs distribute
To enable or disable Cisco Fabric Services (CFS) distribution on the switch, use the cfs distribute command in configuration mode. To disable this feature, use the no form of the command. cfs distribute no cfs distribute
Syntax Description
Defaults
CFS distribution is enabled.
Command Modes
Configuration mode.
Command History
Release 2.1(1a)
Usage Guidelines
By default CFS is in the distribute mode. In the distribute mode, fabric wide distribution is enabled. Applications can distribute data/configuration to all CFS-capable switches in the fabric where the application exists. This is the normal mode of operation. If CFS distribution is disabled, using the no cfs distribute command causes the following to occurs:

CFS and the applications using CFS on the switch are isolated from the rest of the fabric even though there is physical connectivity. All CFS operations are restricted to the isolated switch. All the CFS commands continue to work similar to the case of a physically isolated switch. Other CFS operations (for example, lock, commit, and abort) initiated at other switches do not have any effect at the isolated switch.
Examples
The following example shows how to disable CFS distribution.

switch# config terminal Enter configuration commands, one per line. switch(config)# no cfs distribute End with CNTL/Z.
The following example shows how to reenable CFS distribution.

switch# config terminal Enter configuration commands, one per line. switch(config)# cfs distribute End with CNTL/Z.
4-8
Chapter 4
C Commands cfs distribute
Related Commands Command show cfs status Description Displays whether CFS distribution is enabled or disabled.
4-9
Chapter 4 channel mode active
C Commands
channel mode active

To enable channel mode on a PortChannel interface, use the channel mode active command. To disable this feature, use the no form of the command. channel mode active no channel mode
Syntax Description
Defaults
Enabled.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
This command determines the protocol behavior for all the member ports in the channel group associated with the port channel interface.
Examples
The following example shows how to disable channel mode on a PortChannel interface.
switch# config terminal switch(config)# interface port-channel 10 switch(config-if)# no channel mode active
Related Commands
Command show interface port-channel
Description Displays PortChannel interface information.
4-10
Chapter 4
C Commands cimserver
cimserver
Use the cimserver command to configure the Common Information Models (CIM) parameters. Use the no form of this command to revert to factory defaults. cimserver {certificate {bootflash:filename | slot0:filename | volatile:filename} | clearcertificate filename | enable | enablehttp | enablehttps} no cimserver {certificate {bootflash:filename | slot0:filename | volatile:filename} | clearcertificate filename enable enablehttp enablehttps}
Syntax Description
certificate bootflash: slot0: volatile: filename clearcertificate enable enablehttp enablehttps
Installs the Secure Socket Layer (SSL) certificate Specifies the location for internal bootflash memory. Specifies the location for the CompactFlash memory or PCMCIA card. Specifies the location for the volatile file system. The name of the license file with a .pem extension. Clears a previously-installed SSL certificate. Enables and starts the CIM server. Enables the HTTP (non-secure) protocol for the CIM server(default). Enables the HTTPS (secure) protocol for the CIM server.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
A CIM client is required to access the CIM server. The client can be any client that supports CIM.
4-11
Chapter 4 cimserver
C Commands
Examples The following example installs a Secure Socket Layer (SSL) certificate specified in the file named with a .pem extension.
switch# config terminal switch(config)# cimserver certificateName bootflash:simserver.pem
The following example clears the specified SSL certificate.

switch(config)# cimserver clearCertificateName bootflash:simserver.pem
The following example enables HTTPS (secure protocol).

switch(config)# cimserver enablehttps
The following example disables HTTPS (default).

switch(config)# no cimserver enablehttps
The following example

switch(config)# cimserver enable
The following example disables the CIM server (default).

switch(config)# no cimserver enable
The following example enables HTTP and reverts to the switch default.
switch(config)# cimserver enablehttp
The following example disables HTTP and reverts to the switch default.
switch(config)# no cimserver enablehttp
Related Commands
Command show csimserver
Description Displays configured CIM settings and parameters.
4-12
Chapter 4
C Commands class
class
To select a QoS policy map class for configuration, use the class command in QoS policy map configuration submode. To disable this feature, use the no form of the command. class class-map-name no class class-map-name
Syntax Description
class-map-name
Selects the QoS policy class map to configure.
Defaults
Disabled
Command Modes
QoS policy map configuration submode
Command History
Release 1.3(1)
Usage Guidelines
Before you can configure a QoS policy map class you must complete the following:

Enable the QoS data traffic feature using the qos enable command. Configure a QoS class map using the qos class-map command. Configure a QoS policy map using the qos policy-map command.
After you configure the QoS policy map class, you can configure the Differentiated Services Code Point (DSCP) and priority for frames matching this class map.
Examples
The following example shows how to select a QoS policy map class to configure.
switch# config terminal Enter configuration commands, one per line. switch(config)# qos enable switch(config)# qos class-map class-map1 switch(config)# qos policy-map policyMap1 switch(config-pmap)# class class-map1 switch(config-pmap-c)# End with CNTL/Z.
Related Commands
Command qos enable qos class-map qos policy-map dscp
Description Enables the QoS data traffic feature on the switch. Configures a QoS class map. Configures a QoS policy map. Configures the DSCP in the QoS policy map class.
4-13
Chapter 4 class
C Commands
Command priority show qos Description Configures the priority in the QoS policy map class. Displays the current QoS settings.
4-14
Chapter 4
C Commands clear accounting log
clear accounting log

To clear the accounting log, use the clear accounting log command. clear accounting log
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example clears the accounting log.

switch# clear accouting session
Related Commands
Command show accounting log
Description Displays the accounting log contents.
4-15
Chapter 4 clear arp-cache
C Commands
clear arp-cache
To clear the ARP cache table entries, use the clear arp-cache command in EXEC mode. clear arp-cache
Syntax Description
Defaults
The ARP table is empty by default.
Command Modes
EXEC mode.
Command History
Examples
The following example shows how to clear the arp-cache table entries.
switch# clear arp-cache
Related Commands
Command show arp
Description Displays Address Resolution Protocol (ARP) entries.
4-16
Chapter 4
C Commands clear callhome session
clear callhome session

To clear Call Home Cisco Fabric Services (CFS) session configuration and locks, use the clear callhome session command. clear callhome session
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to clear the Call Home session configuration and locks.
switch# clear callhome session
Related Commands
Command show callhome
Description Displays Call Home information.
4-17
Chapter 4 clear cdp
C Commands
clear cdp
Use the clear cdp command to delete global or interface-specific CDP configurations. clear cdp {counters | table} [interface {gigabitethernet slot/port | mgmt 0}]
Syntax Description
counters table interface gigabitethernet slot/port mgmt 0
Enables CDP on globally or on a per-interfaces basis. Specifies the EXEC command to be executed. Displays CDP parameters for an interface. Specifies the Gigabit Ethernet interface. Specifies the slot number and port number separated by a slash (/). Specifies the Ethernet management interface.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
You can issue this command for a specified interface or for all interfaces (management and Gigabit Ethernet interfaces)
Examples
The following example clears CDP traffic counters for all interfaces.
switch# clear cdp counters switch#
The following example clears CDP entries for the specified Gigabit Ethernet interface.
switch# clear cdp table interface gigabitethernet 4/1 switch#
Related Commands
Command cdp show cdp
Description Configures global or interface-specific CDP settings and parameters. Displays configured CDP settings and parameters.
4-18
Chapter 4
C Commands clear cores
clear cores
To clear all core dumps for the switch, use the clear cores command in EXEC mode. clear cores
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The system software keeps the last few cores per service and per slot and clears all other cores present on the active supervisor module.
Examples
The following example shows how to clear all core dumps for the switch.
switch# clear cores
Related Commands
Command show cores
Description Displays core dumps that have been made.
4-19
Chapter 4 clear counters (EXEC mode)
C Commands
clear counters (EXEC mode)

To clear the interface counters, use the clear counters command in EXEC mode. clear counters {all | interface {fc | mgmt | port-channel | sup-fc | vsan} number}
Syntax Description
all interface type number
Clears all interface counters. Clears interface counters for the specified interface. Specifies the interface type. See the Keywords table in the Usage Guidelines section. Specifies the number of the slot or interface being cleared.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The following table lists the keywords and number ranges for the clear counters interface types: Keyword fc gigabitethernet mgmt port-channel sup-fc vsan Interface Type Fibre Channel Gigabit Ethernet Management PortChannel Inband VSAN Number 1- 2 or 1 - 9 (slot) 1- 2 or 1 - 9 (slot) 0-0 (management interface) 1-128 (PortChannel) 0-0 (Inband interface) 1- 4093 (VSAN ID)
This command clears counter displayed in the show interface command output.
Examples
The following example shows how to clear counters for a VSAN interface.
switch# clear counters interface vsan 13
Related Commands
Command
show interface
Description Displays interface information.
4-20
Chapter 4
C Commands clear counters (SAN extension N port configuration mode)
clear counters (SAN extension N port configuration mode)

To clear SAN extension tuner N port counters, use the clear counters command. clear counters
Syntax Description
Defaults
None.
Command Modes
SAN extension N port configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to clear SAN extension tuner N port counters.
switch# san-ext-tuner switch(san-ext)# nWWN 10:00:00:00:00:00:00:00 switch(san-ext)# nport pwwn 12:00:00:00:00:00:00:56 vsan 13 interface gigabitethernet 1/2 switch(san-ext-nport)# clear counters
Related Commands
Command show san-ext-tuner
Description Displays SAN extension tuner information.
4-21
Chapter 4 clear crypto ike domain ipsec sa
C Commands
clear crypto ike domain ipsec sa

To clear the IKE tunnels for IPsec, use the clear crypto ike domain ipsec sa command. clear crypto ike domain ipsec sa [tunnel-id]
Syntax Description
tunnel-id
Specifies a tunnel ID. The range is 1 to 2147483647.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, the IKE protocol must be enabled using the crypto ike enable command. If the tunnel ID is not specified, all IKE tunnels are cleared.
Examples
The following example shows how to clear all IKE tunnels.

switch# clear crypto ike domain ipsec sa
Related Commands
Command crypto ike domain ipsec crypto ike enable show crypto ike domain ipsec
Description Configures IKE information. Enables the IKE protocol. Displays IKE information for the IPsec domain.
4-22
Chapter 4
C Commands clear crypto sa domain ipsec
clear crypto sa domain ipsec

To clear the security associations for IPsec, use the clear crypto sa domain ipsec command. clear crypto sa domain ipsec interface gigabitethernet slot/port {inbound | outbound} sa sa-index
Syntax Description
interface gigabitethernet slot/port inbound outbound sa sa-index
Specifies the Gigabit Ethernet interface. Specifies clearing inbound associations. Specifies clearing output associations. Specifies the security association index. The range is 1 to 2147483647.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
To clear security associations, IPsec must be enabled using the crypto ipsec enable command.
Examples
The following example shows how to clear a security association for an interface.
switch# clear crypto sa domain ipsec interface gigabitethernet 1/2 inbound sa 1
Related Commands
Command show crypto sad domain ipsec
Description Displays IPsec security association database information.
4-23
Chapter 4 clear debug-logfile
C Commands
clear debug-logfile
To delete the debug logfile, use the clear debug-logfile command in EXEC mode. clear debug-logfile filename
Syntax Description
filename
The name (restricted to 80 characters) of the log file to be cleared. The maximum size of the log file is 1024 bytes.
Defaults
None.
Command Modes
EXEC.
Command History
Examples
The following example shows how to clear the debug logfile.

switch# clear debug-logfile debuglog
Related Commands
Command
show debug logfilw
Description Displays the logfile contents.
4-24
Chapter 4
C Commands clear device-alias
clear device-alias
To clear device alias information, use the clear device-alias command. clear device-alias {session | statistics}
Syntax Description
session statistics
Clears session information. Clears device alias statistics.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to clear the device alias session.
switch# clear device-alias session
Related Commands
Command show device-alias
Description Displays device alias database information.
4-25
Chapter 4 clear dpvm
C Commands
clear dpvm
To clear Dynamic Port VSAN Membership (DPVM) information, use the clear dpvm command. clear dpvm {auto-learn [pwwn pwwn-id] | session}
Syntax Description
auto-learn pwwn pwwn-id session
Clears automatically learned (autolearn) DPVM entries. Specifies the pWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number. Clears the DPVM session and locks.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, DVPM must be enabled using the dpvm enable command.
Examples
The following example shows how to clear a single autolearned entry.

switch# clear dpvm auto-learn pwwn 21:00:00:20:37:9c:48:e5
The following example shows how to clear all autolearn entries.

switch# clear dpvm auto-learn
The following example shows how to clear a session.

switch# clear dpvm session
Related Commands
Command dpvm enable show dpvm
Description Enables DPVM. Displays DPVM database information.
4-26
Chapter 4
C Commands clear fabric-binding statistics
clear fabric-binding statistics

To clear fabric binding statistics in a FICON enabled VSAN, use the clear fabric-binding statistics command in EXEC mode. clear fabric-binding statistics vsan vsan-id
Syntax Description
vsan vsan-id
Specifies the FICON-enabled VSAN. The ID of the VSAN is from 1 to 4093.
Defaults
None
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
The following example clears existing fabric binding statistics in VSAN 1.

switch# clear fabric-binding statistics vsan 1
Related Commands
Command
show fabric-binding efmd statistics
Description Displays existing fabric binding statistics information.
4-27
Chapter 4 clear fcanalyzer
C Commands
clear fcanalyzer
To clear the entire list of configured hosts for remote capture, use the clear fcanalyzer command in EXEC mode. clear fcanalyzer
Syntax Description
Defaults
None.
Command Modes
EXEC.
Command History
Usage Guidelines
This command clears only the list of configured hosts. Existing connections are not terminated.
Examples
The following example shows how to clear the entire list of configured hosts for remote capture.
switch# clear fcanalyzer
Related Commands
Command show fcanalyzer
Description Displays the list of hosts configured for a remote capture.
4-28
Chapter 4
C Commands clear fcflow stats
clear fcflow stats

To clear Fibre Channel flow statistics, use the clear fcflow stats command in EXEC mode. clear fcflow stats [aggregated] module module-number index flow-number
Syntax Description
aggregated module module-number index flow-number
Clears the Fibre Channel flow aggregated statistics. Clears the statistics for a specified module. Specifies the module number. Clears the Fibre Channel flow counters for a specified flow index. Specifies the flow index number.
Defaults
None.
Command Modes
EXEC.
Command History
Examples
The following example shows how to clear aggregated Fibre Channel flow statistics for flow index 1 of module 2.
switch(config)# # clear fcflow stats aggregated module 2 index 1
Related Commands
Command show fcflow
Description Displays the fcflow statistics.
4-29
Chapter 4 clear fcns statistics
C Commands
clear fcns statistics

To clear the name server statistics, use the clear fcns statistics command in EXEC mode. clear fcns statistics vsan vsan-id
Syntax Description
vsan vsan-id
FCS statistics are to be cleared for a specified VSAN ranging from 1 to 4093.
Defaults
None.
Command Modes
EXEC.
Command History
Examples
The following example shows how to clear the name server statistics.
switch# show fcns statistics Name server statistics for vsan 1 =================================== registration requests received = 0 deregistration requests received = 0 queries received = 23 queries sent = 27 reject responses sent = 23 RSCNs received = 0 RSCNs sent = 0 switch# clear fcns statistics vsan 1 switch# show fcns statistics Name server statistics for vsan 1 =================================== registration requests received = 0 deregistration requests received = 0 queries received = 0 queries sent = 0 reject responses sent = 0 RSCNs received = 0 RSCNs sent = 0 switch#
Related Commands
Command show fcns statistics
Description Displays the name server statistics.
4-30
Chapter 4
C Commands clear fcs statistics
clear fcs statistics

To clear the fabric configuration server statistics, use the clear fcs statistics command in EXEC mode. clear fcs statistics vsan vsan-id
Syntax Description
vsan vsan-id
FCS statistics are to be cleared for a specified VSAN ranging from 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Examples
The following example shows how to clear the fabric configuration server statistics for VSAN 10.
switch# clear fcs statistics vsan 10
Related Commands
Command show fcs statistics
Description Displays the fabric configuration server statistics information.
4-31
Chapter 4 clear fctimer session
C Commands
clear fctimer session

To clear fctimer Cisco Fabric Services (CFS) session configuration and locks, use the clear fctimer session command. clear fctimer session
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to clear fctimer session.

switch# clear fctimer session
Related Commands
Command show fctimer
Description Displays fctimer information.
4-32
Chapter 4
C Commands clear ficon
clear ficon
Use the clear ficon command in EXEC mode to clear the FICON information for the specified VSAN. clear ficon vsan vsan-id [allegiance | timestamp]
Syntax Description
vsan vsan-id allegiance timestamp
Specifies the FICON-enabled VSAN. The ID of the VSAN is from 1 to 4093. Clears FICON device allegiance. Clears FICON VSAN specific timestamp.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The clear ficon vsan vsan-id allegiance command aborts the currently-executing session.
Examples
The following example clears the current device allegiance for VSAN 1.
switch# clear ficon vsan 1 allegiance
The following example clears the VSAN clock for VSAN 20.
switch# clear ficon vsan 20 timestamp
Related Commands
Command show ficon
Description Displays configured FICON details.
4-33
Chapter 4 clear fspf counters
C Commands
clear fspf counters

To clear the Fabric Shortest Path First statistics, use the clear fspf counters command in EXEC mode. clear fspf counters vsan vsan-id [interface type]
Syntax Description
vsan vsan-id interface type
Indicates that the counters are to be cleared for a VSAN. The ID of the VSAN is from 1 to 4093. (Optional). The counters are to be cleared for an interface. The interface types are fc for Fibre Channel, and port-channel for PortChannel.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
If the interface is not specified, then all of the counters of a VSAN are cleared. If the interface is specified, then the counters of the specific interface are cleared.
Examples
The following example clears the FSPF t statistics on VSAN 1.

switch# clear fspf counters vsan 1
The following example clears FSPF statistics specific to the Fibre Channel interface in VSAN 1, Slot 9 Port 32.
switch# clear fspf counters vsan 1 interface fc 9/32
Related Commands
Command show fspf
Description Displays global FSPF information for a specific VSAN.
4-34
Chapter 4
C Commands clear ip access-list counters
clear ip access-list counters

To clear IP access list counters, use the clear ip access-list counters command in EXEC mode. clear ip access-list counters list-name
Syntax Description
list-name
Specifies the IP access list name (maximum 64 characters).
Defaults
None.
Command Modes
EXEC.
Command History
Examples
The following example clears the counters for an IP access list.

switch# clear ip access-list counters adminlist
Related Commands
Command show ip access-list
Description Displays IP access list information.
4-35
Chapter 4 clear ips arp
C Commands
clear ips arp

To clear ARP caches, use the clear ips arp command in EXEC mode. clear ips arp {address ip-address| interface gigabitethernet module-number}
Syntax Description
address ip-address interface gigabitethernet module-number
Clears fcflow aggregated statistics. Enters the peer IP address. Specifies the Gigabit Ethernet interface. Specifies slot and port of the Gigabit Ethernet interface.
Defaults
None.
Command Modes
EXEC.
Command History
Examples
The ARP cache can be cleared in two ways: clearing just one entry or clearing all entries in the ARP cache. The following example clears one ARP cache entry:
switch# clear ips arp address 10.2.2.2 interface gigabitethernet 8/7 arp clear successful
The following example clears all ARP cache entries

switch# clear ips arp interface gigabitethernet 8/7 arp clear successful
4-36
Chapter 4
C Commands clear ivr zone database
clear ivr zone database

To clear the Inter-VSAN Routing (IVR) zone database, use the clear ivr zone database command in EXEC mode. clear ivr zone database
Syntax Description
Defaults
None.
Command Modes
EXEC.
Command History
Examples
The following example clears all configured IVZ information.

switch# clear ivr zone database
4-37
Chapter 4 clear license
C Commands
clear license
To uninstall a license, use the clear license command in EXEC mode. clear license filename
Syntax Description
filename
Specifies the license file to be uninstalled.
Defaults
None.
Command Modes
EXEC.
Command History
Examples
The following example clears a specific license.

switch# clear license Ficon.lic Clearing license Ficon.lic: SERVER this_host ANY VENDOR cisco # An example fcports license INCREMENT SAN_EXTN_OVER_IP cisco 1.000 permanent 1 HOSTID=VDH=ABCD \ NOTICE=<LicFileID>san_extn2.lic</LicFileID><LicLineID>1</LicLineID> \ SIGN=67CB2A8CCAC2 Do you want to continue? (y/n) y Clearing license ..done switch#
Related Commands
Command show license
Description Displays license information.
4-38
Chapter 4
C Commands clear line
clear line
To clear VTY sessions, use the clear line command in EXEC mode. clear line vty-name
Syntax Description
vty-name
Specifies the VTY name (maximum 64 characters).
Defaults
None.
Command Modes
EXEC.
Command History
Examples
The following example clears one ARP cache entry:

switch# clear line Aux arp clear successful
Related Commands
Command show line
Description Displays line information.
4-39
Chapter 4 clear logging
C Commands
clear logging
To delete the SYSLOG information, use the clear logging command in EXEC mode. clear logging {logfile | nvram}
Syntax Description
logfile nvram
Clears log file messages. Clears NVRAM logs.
Defaults
None.
Command Modes
EXEC.
Command History
Examples
The following example shows how to clear the debug logfile.

switch# clear logging logfile
Related Commands
Command show logging
Description Displays logging information.
4-40
Chapter 4
C Commands clear ntp
clear ntp
To clear Network Time Protocol (NTP) information, use the clear ntp command in EXEC mode. clear ntp {session | statistics {all-peers | io | local | memory}}
Syntax Description
session statistics all-peers io local memory
Clears NTP CFS session configuration and locks. Clears NTP statistics. Clears I/O statistics for all peers. Clears I/O statistics for I/O devices. Clears I/O statistics for local devices. Clears I/O statistics for memory.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None mode.
Examples
The following example shows how to clear NTP statistics for all peers.
switch# clear ntp statistics all-peers
The following example shows how to clear NTP statistics for I/O devices.
switch# clear ntp statistics io
The following example shows how to clear NTP statistics for local devices.
switch# clear ntp statistics local
The following example shows how to clear NTP statistics for memory.
switch# clear ntp statistics memory
Related Commands
Command show ntp
Description Displays the configured server and peer associations.
4-41
Chapter 4 clear port-security
C Commands
clear port-security
To clear the port security information on the switch, use the clear port-security command in EXEC mode. clear port-security {database auto-learn {interface fc slot/port | port-channel port} | session | statistics} vsan vsan-id
Syntax Description
database session statistics auto-learn interface fc slot/port port-channel port vsan vsan-id
Clears the port security active configuration database. Clears the port security CFS configuration session and locks. Clears the port security counters. Clears the auto-learnt entries for a specified interface or VSAN. Clears entries for a specified interface. Clears entries for a specified PortChannel. The range is 1 to 128. Clears entries for a specified VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.2(1) 2.0(1b)
Modification This command was introduced. Added the session option.
Usage Guidelines
The active database is read-only and clear port-security database command can be used when resolving conflicts.
Examples
The following example clears all existing statistics from the port security database for a specified VSAN.
switch# clear port-security statistics vsan 1
The following example clears learnt entries in the active database for a specified interface within a VSAN.
switch# clear port-security database auto-learn interface fc1/1 vsan 1
The following example clears learnt entries in the active database up to for the entire VSAN.
switch# clear port-security database auto-learn vsan 1
4-42
Chapter 4
C Commands clear port-security
Related Commands Command show port-security Description Displays the configured port security information.
4-43
Chapter 4 clear processes log
C Commands
clear processes log

To clear the log files on the switch, use the clear processes log command in EXEC mode. clear processes log {all | pid pid-number}
Syntax Description
all pid pid-number
Deletes all of the log files. Deletes the log files of a specific process. Specifies the process ID, which must be from 0 to 2147483647.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following examples show how to clear all of the log files on the switch.
switch# clear processes log all
Related Commands
Command show processes
Description Displays the detailed running or log information of processes or high availability applications.
4-44
Chapter 4
C Commands clear qos statistics
clear qos statistics

To clear the quality of services statistics counters, use the clear qos statistics command in EXEC mode. clear qos statistics
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following examples shows how to clear the quality of service counters.
switch# clear qos statistics
Related Commands
Command show qos statistics
Description Displays the current QoS settings, along with a number of frames marked high priority.
4-45
Chapter 4 clear radius session
C Commands
clear radius session

To clear RADIUS Cisco Fabric Services (CFS) session configuration and locks, use the clear radius session command. clear radius session
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to clear RADIUS session.

switch# clear radius session
Related Commands
Command show radius
Description Displays RADIUS CFS distribution status and other details.
4-46
Chapter 4
C Commands clear rlir
clear rlir
To clear the Registered Link Incident Report (RLIR), use the clear rlir command in EXEC mode. clear rlir {history | recent {interface fc slot/port | portnumber port-number} | statistics vsan vsan-id}
Syntax Description
history recent interface fc slot/port portnumber port-number statistics vsan vsan-id
Clears RLIR link incident history. Clears recent link incidents. Clears entries for a specified interface. Displays the port number for the link incidents. Clears RLIR statistics. Specifies the VSNA ID for which the RLIR statistics are to be cleared.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example clears all existing statistics for a specified VSAN.
switch# clear rlir statistics vsan 1
The following example clears the link incident history.

switch# clear rlir history
The following example clears recent RLIR information for a specified interface.
switch# clear rlir recent interface fc 1/2
The following example clears recent RLIR information for a specified port number.
switch# clear rlir recent portnumber 16
Related Commands
Command show rscn
Description Displays RSCN information.
4-47
Chapter 4 clear role session
C Commands
clear role session

To clear authentication role Cisco Fabric Services (CFS) session configuration and locks, use the clear role session command. clear role session
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to clear authentication role CFS session.
switch# clear role session
Related Commands
Command show role
Description Displays role configuration information.
4-48
Chapter 4
C Commands clear rscn statistics
clear rscn statistics

To clear the registered state change notification statistics for a specified VSAN, use the clear rscn statistics command in EXEC mode. clear rscn statistics vsan vsan-id
Syntax Description
vsan vsan-id
The RSCN statistics are to be cleared for a VSAN. The ID for the VSAN for which you want to clear RSCN statistics.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to clear rcsn statistics for VSAN 1.
switch# clear rscn statistics 1
Related Commands
Command show rscn
Description Displays RSCN information.
4-49
Chapter 4 clear scheduler logfile
C Commands
clear scheduler logfile

To clear the command scheduler logfile, use the clear scheduler logfile command. clear scheduler logfile
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to clear the command scheduler logfile.
switch# clear scheduler logfile
Related Commands
Command show scheduler
Description Displays command scheduler information.
4-50
Chapter 4
C Commands clear screen
clear screen
To clear the terminal screen, use the clear screen command in EXEC mode. clear screen
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to clear the terminal screen.

switch# clear screen
4-51
Chapter 4 clear scsi-flow statistics
C Commands
clear scsi-flow statistics

To clear the SCSI flow statistics counters, use the clear scsi-flow statistics command. clear scsi-flow statistics flow-id flow-id
Syntax Description
flow-id flow-id
Configures the SCSI flow identification number.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(2)
Usage Guidelines
None.
Examples
The following example shows how to clear the SCSI flow statistics counters for SCSI flow ID 3.
switch# clear scsi-flow statistics flow-id 3
Related Commands
Command scsi-flow flow-id show scsi-flow
Description Configures the SCSI flow services. Displays SCSI flow configuration and status.
4-52
Chapter 4
C Commands clear ssh hosts
clear ssh hosts

To clear trusted SSH hosts, use the clear ssh hosts command in EXEC mode. clear ssh hosts
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to clear reset-reason information from NVRAM and volatile storage.
switch# clear ssh hosts
Related Commands
Command show ssh hosts
Description Displays SSH host information.
4-53
Chapter 4 clear system reset-reason
C Commands
clear system reset-reason

To clear the reset-reason information stored in NVRAM and volatile persistent storage, use the clear system reset-reason command in EXEC mode. clear system reset-reason
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(2a).
Usage Guidelines
Use this command as listed below:

In a Cisco MDS 9500 Series switch, this command clears the reset-reason information stored in NVRAM and volatile persistent storage in the active and standby supervisor modules. In a Cisco MDS 9200 Series switch, this command clears the reset-reason information stored in NVRAM and volatile persistent storage in the active supervisor module.
Examples
The following example shows how to clear trusted SSH hosts.

switch# clear system reset-reason
Related Commands
Command show system reset-reason
Description Displays system reset-reason information.
4-54
Chapter 4
C Commands clear tacacs+ session
clear tacacs+ session

To clear TACACS+ Cisco Fabric Services (CFS) session configuration and locks, use the clear tacacs+ session command. clear tacacs+ session
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, TACACS+ must be enabled using the tacacs+ enable command.
Examples
The following example shows how to clear the TACACS+ session.

switch# clear tacacs+ session
Related Commands
Command show tacacs+ tacacs+ enable
Description Displays TACACS+ CFS distribution status and other details. Enables TACACS+.
4-55
Chapter 4 clear tlport alpa-cache
C Commands
clear tlport alpa-cache

To clear the entire contents of the alpa-cache, use the clear tlport alpa-cache command in EXEC mode. clear tlport alpa-cache
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to clear a TL port ALPA cache.

switch# clear tlport alpa-cache
Related Commands
Command show tlport alpa-cache
Description Displays TL port alpa-cache information.
4-56
Chapter 4
C Commands clear user
clear user
To clear trusted SSH hosts, use the clear user command in EXEC mode. clear user username
Syntax Description
username
Specifies the user name to clear.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to log out a specified user.

switch# clear user vsam
Related Commands
Command show users
Description Displays user information.
4-57
Chapter 4 clear vrrp
C Commands
clear vrrp
To clear all the software counters for the specified virtual router, use the clear vrrp command in EXEC mode. clear vrrp {statistics | vr number interface {gigabitethernet port/slot | mgmt 0 | port-channel portchannel-id | vsan vsan-id}}
Syntax Description
statistics vr number interface gigabitethernet port/slot mgmt 0 port-channel portchannel-id vsan vsan-id
Clears global VRRP statistics. Clears specific VR statistics. Specifies a VR number from 1 to 255. Specifies an interface. Specifies a gigabitethernet interface. Specifies the management interface. Specifies a port-channel interface.The ID of the port-channel interface is from 1 to 128. Specifies a VSAN. The ID of the VSAN is from 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following examples shows how to clear all the software counters for virtual router 7 on VSAN 2.
switch# clear vrrp 7 interface vsan2
Related Commands
Command show vrrp
Description Displays VRRP configuration information.
4-58
Chapter 4
C Commands clear zone
clear zone
To clear all configured information in the zone server for a specified VSAN, use the clear zone command in EXEC mode. clear zone {database | statistics {lun-zoning | read-only-zoning}} vsan vsan-id
Syntax Description
database statistics lun-zoning read-only-zoning vsan vsan-id
Clears zone server database information. Clears zone server statistics. Clears LUN-zoning related statistics. Clears read-only zoning related statistics. Clears zone information for a VSAN. The ID of the VSAN is from 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
After issuing a clear zone database command, you need to explicitly issue the copy running-config startup-config to ensure that the running configuration is used when you next start the switch.
Examples
The following examples shows how to clear all configured information in the zone server for VSAN 1.
switch# clear zone database vsan 1
Related Commands
Command show zone
Description Displays zone information for any configured interface.
4-59
Chapter 4 clock
C Commands
clock
To configure the time zone and the summer time of day, use the clock command in configuration mode. To disable the daylight saving time adjustment, use the no form of the command. clock {summer-time | time-zone daylight-timezone-name start-week start-day start-month start-time end-week end-day end-month end-time daylight-offset-to-be-added-in-minutes} no clock {summer-time | time-zone daylight-timezone-name start-week start-day start-month start-time end-week end-day end-month end-time daylight-offset-to-be-added-in-minutes}
Syntax Description
summer-time
Adjusts the daylight savings time for the Pacific time zone by 60 minutes starting the first sunday in April at 2 a.m. and ending the last Sunday in October at 2 a.m. Sets the time zone for a specified time zone name. The 8-character name of the time zone The week ranging from 1 through 5 The day ranging from Sunday through Saturday The month ranging from January through December The time ranging from The daylight offset ranges from1 through 1440 minutes that will be added to the start time and deleted from the end time
time-zone daylight-timezone-na me start-week end-week start-day end-day start-month end-month start-time end-time daylight-offset-to-beadded-in-minutes
Defaults
Coordinated Universal Time (UTC), which is the same as Greenwich Mean Time (GMT).
Command Modes
Configuration mode.
Command History
Usage Guidelines
Use this command if you need to change the UTC or GMT time or time zone.
4-60
Chapter 4
C Commands clock
Examples The following example shows how to configure the time zone and summer time of day.
switch# config terminal switch(config)# clock timezone <daylight timezone name> <start week> <start day> <start month> <start time> <end week> <end day> <end month> <end time> <daylight offset to be added in minutes> switch(config)# clock summer-time Pacific 1 Sun Apr 02:00 5 Sun Oct 02:00 60 switch(config)# no clock summer-time switch(config)# exit switch#
Related Commands
Command clock set show clock show run
Description Changes the default time on the switch. Displays the current date and time. Displays changes made to the time zone configuration along with other configuration information.
4-61
Chapter 4 code-page
C Commands
code-page
Use the code-page command to configure the EBCDIC format. To disable the configuration or to revert to factory defaults, use the no form of the command. code-page brazil |france | france | international-5 | italy | japan | spain-latinamerica | uk | us-canada
Syntax Description
code-page brazil france international-5 italy japan spain-latinamerica uk us-canada
Configures code page on a FICON-enabled VSAN Configures the brazil EBCDIC format. Configures the france EBCDIC format. Configures the international-5 EBCDIC format. Configures the italy EBCDIC format. Configures the japan EBCDIC format. Configures the spain-latinamerica EBCDIC format. Configures the uk EBCDIC format. Configures the us-canada EBCDIC format.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
This is an optional configuration. If you are not sure of the EBCDIC format to be used, we recommend retaining the us-canada (default) option.
Examples
The following example configures the italy EBCDIC format.

switch(config)# ficon vsan 2 switch(config-ficon)# code-page italy
The following example reverts to the factory default of using the us-canada EBCDIC format.
switch(config-ficon)# no code-page
Related Commands
Command show ficon ficon vsan vsan-id
Description Displays configured FICON details. Enables FICON on the specified VSAN.
4-62
Chapter 4
C Commands clock set
clock set
To change the system time on a Cisco MDS 9000 Family switch, use the clock set command in EXEC mode. clock set HH:MM:SS DD Month YYYY
Syntax Description
HH MM SS DD Month YYYY
The two-digit time in hours in military format (15 for 3 p.m.). The two-digit time in minutes (58). The two-digit time in seconds(15). The two-digit date (12). The month in words (August). The four-digit year (2002).
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Generally, if the system is synchronized by a valid outside timing mechanism, such as an NTP clock source, or if you have a switch with calendar capability, you do not need to set the system clock. Use this command if no other time sources are available. The time specified in this command is relative to the configured time zone. The clock set command changes are saved across system resets.
Examples
The following example displays the clock set command:

switch# clock set 15:58:15 12 August 2002 Mon Aug 12 15:58:00 PDT 2002
4-63
Chapter 4 code-page
C Commands
code-page
Use the code-page command to configure the EBCDIC format. To disable the configuration or to revert to factory defaults, use the no form of the command. code-page {brazil | france | france | international-5 | italy | japan | spain-latinamerica | uk | us-canada}
Syntax Description
brazil france international-5 italy japan spain-latinamerica uk us-canada
Specifies brazil EBCDIC format. Specifies france EBCDIC format. Specifies international-5 EBCDIC format. Specifies italy EBCDIC format. Specifies japan EBCDIC format. Specifies spain-latinamerica EBCDIC format. Specifies uk EBCDIC format. Specifies us-canada EBCDIC format.
Defaults
us-canada
Command Modes
Configuration mode.
Command History
Usage Guidelines
Examples
The following example configures the italy EBCDIC format.

switch(config)# ficon vsan 2 switch(config-ficon)# code-page italy
The following example reverts to the factory default of using the us-canada EBCDIC format.
switch(config-ficon)# no code-page
Related Commands
4-64
Chapter 4
C Commands commit
commit
To apply the pending configuration pertaining to the Call Home configuration session in progress, use the commit command in Call Home configuration submode. commit
Syntax Description
Defaults
None.
Command Modes
Call Home configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
CFS distribution must be enabled before you can commit the Call Home configuration.
Examples
The following example shows how to commit the Call Home configuration commands.
switch# config terminal Enter configuration commands, one per line. switch(config)# callhome switch(config-callhome)# commit End with CNTL/Z.
Related Commands
4-65
Chapter 4 contract-id
C Commands
contract-id
To configure the service contract ID of the customer with the Call Home function, use the contract-id command in Call Home configuration submode. To disable this feature, use the no form of the command. contract-id customer-id no contract-id customer-id
Syntax Description
contract-id
(Optional) Configures the service contract ID of the customer. Allows up to 64 characters for the contract number.
Defaults
None.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to configure the contract ID in the Call Home configuration.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# callhome switch(config-callhome)# contract-id Customer1234
Related Commands
4-66
Chapter 4
C Commands configure terminal
configure terminal
To enter the configuration mode, use the configure terminal command in EXEC mode. configure terminal
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example enters the configuration mode:

switch# configure terminal switch(config)#
The following example enters the configuration mode using an abbreviated format of the command:
switch# config terminal switch(config)#
4-67
Chapter 4 copy
C Commands
copy
To save a backup of the system software, use the copy command in EXEC mode. copy source-URL destination-URL
Syntax Description
source-URL destination-URL
The location URL or alias of the source file or directory to be copied. The destination URL or alias of the copied file or directory.
The following table lists the aliases for source and destination URLs. running-config Specifies the configuration currently running on the switch. The system:running-config keyword represents the current running configuration file. Specifies the configuration used during initialization (startup). You can copy the startup configuration from NVRAM. The nvram:startup-config keyword represents the configuration file used during initialization. Specifies the location for internal bootflash memory. Specifies the location for the log file system. Specifies the location for the CompactFlash memory or PCMCIA card. Specifies the location for the volatile file system. Specifies the location for system memory, which includes the running configuration. Specifies a fabric wide startup configuration update using Cisco Fabric Services (CFS) where all the remote switches in the fabric copy their running configuration (source) file into their startup configuration (destination) file. The syntax for this command is copy running-config startup-config fabric. Specifies the location for a Trivial File Transfer Protocol (TFTP) network server. The syntax for this alias is tftp:[[//location]/directory]/filename. Specifies the location for a File Transfer Protocol (FTP) network server. The syntax for this alias is ftp:[[//location]/directory]/filename. Specifies the location for a secure copy (scp) network server. The syntax for this alias is scp:[[//location]/directory]/filename. Specifies the location for a Secure Trivial File Transfer Protocol (SFTP) network server. The syntax for this alias is sftp:[[//location]/directory]/filename. Specifies the location for log files stored in the same directory. Specifies the location for the debug files stored in the debug partition Specifies the switch NVRAM. Specifies the location of the cores from any switching or supervisor module to an external flash (slot 0) or a TFTP server. The name of the Flash file. The number of the supervisor module, where sup-1 is the slot 5 supervisor (active) and sup-2 is the slot 6 supervisor (standby).
startup-config
bootflash: log: slot0: volatile: system: fabric
tftp: ftp: scp: sftp:
log: debug: nvram: core: filename sup-1 sup-2
4-68
Chapter 4
C Commands copy
Defaults None.
Command Modes
EXEC mode.
Command History
Release 1.3(4) 2.1(1a)
Modification Command modified. Added the fabric keyword and functionality.
Usage Guidelines
This command makes the running and the backup copy of the software identical. A file can only be copied from an active supervisor to a standby supervisor, not from standby to active. This command does not allow 127.x.x.x IP addresses. The copy function will not be completed if the required space is not available in the directory. First change to the required directory (for example, cd bootflash:) and verify the available space (for example, dir bootflash:). The entire copying process may take several minutes. Do not copy a file from an external source directly to the standby supervisor. You must copy from the external source to the active supervisor, and then copy the saved file to the standby supervisor. You can save cores (from the active supervisor module, the standby supervisor module, or any switching module) to an external flash (slot 0) or to a TFTP server in one of two ways:

On demandto copy a single file based on the provided process ID. Periodicallyto copy core files periodically as configured by the user.
You copy the logfile to a different location using the copy log:messages command. The debug partition contains debugging files created by the software for troubleshooting purposes. The running-config startup-config fabric parameters allow you to use CFS to force every switch in the Fibre Channel fabric to copy their running configuration (source) to their startup configuration (destination).
Note
If any remote switch fails to complete the copy running-config startup-config fabric process, the initiator switch also does not complete saving its startup-configuration. This means, both the remote switch and the initiator switch have failed to save their startup-configuration (the old startup-configuration reverts back). All the other switches in the network would have succeeded.
Examples
The following example saves your configuration to the startup configuration.

switch# copy system:running-config nvram:startup-config
The following example copies the file called samplefile from the slot0 directory to the mystorage directory.
switch# copy slot0:samplefile slot0:mystorage/samplefile
4-69
Chapter 4 copy
C Commands
The following example copies a file from the current directory level.
switch# copy samplefile mystorage/samplefile
If the current directory is slot0:mydir, this command copies slot0:mydir/samplefile to slot0:mydir/mystorage/samplefile. The following example downloads a configuration file from an external CompactFlash to the running configuration.
switch copy slot0:dns-config.cfg system:running-config
The following example saves a running configuration file to an external CompactFlash.

switch# copy system:running-config slot0:dns-config.cfg
The following example saves a startup configuration file to an external CompactFlash.

switch# copy system:startup-config slot0:dns-config.cfg
The following example uses CFS to cause all switches in the fabric to copy their running configuration (source) file to their startup configuration (destination) file.
switch# copy running-config startup-config fabric [########################################] 100% switch#
Note
If any remote switch fails to complete the copy running-config startup-config fabric process, the initiator switch also does not complete saving its startup-configuration. This means, both the remote switch and the initiator switch have failed to save their startup-configuration (the old startup-configuration reverts back). All the other switches in the network would have succeeded. The following example creates a backup copy of the binary configuration.
switch# copy nvram:startup-config nvram:snapshot-config
The following example copies an image in bootflash on the active supervisor to the bootflash on the standby supervisor.
switch# copy bootflash:myimage bootflash://sup-2/myimage
The following example creates a running configuration copy in bootflash.

switch# copy system:running-config bootflash:my-config
The following examples creates a startup configuration copy in bootflash.

switch# copy nvram:startup-config bootflash:my-config
Related Commands
Command cd dir reload show version
Description Changes the default directory or file system. Displays a list of files on a file system. Reloads the operating system. Displays the version of the running configuration file.
4-70
Chapter 4
C Commands copy licenses
copy licenses
To save a backup of the installed license files, use the copy licenses command in EXEC mode. copy licenses source-URL destination-URL
Syntax Description
source-URL destination-URL
The location URL or alias of the source file or directory to be copied. The destination URL or alias of the copied file or directory.
The following table lists the aliases for source and destination URLs. bootflash: slot0: volatile: filename Specifies the location for internal bootflash memory. Specifies the location for the CompactFlash memory or PCMCIA card. Specifies the location for the volatile file system. Specifies the name of the license file with a.tar extension.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The copy function will not be completed if the required space is not available in the directory. First change to the required directory (for example, cd bootflash:) and verify the available space (for example, dir bootflash:). We recommend backing-up your license files immediately after installing them and just before issuing a write erase command.
Examples
The following example saves a file called Enterprise.tar to the bootflash: directory.
switch# copy licenses bootflash:/Enterprise.tar Backing up license done
Related Commands
Command cd dir install license
Description Changes the default directory or file system. Displays a list of files on a file system. Installs a license file.
4-71
Chapter 4 crypto global domain ipsec security-association lifetime
C Commands
crypto global domain ipsec security-association lifetime

To configure global parameters for IPsec, use the crypto global domain ipsec security-association lifetime command. To revert to the default, use the no form of the command. crypto global domain ipsec security-association lifetime {gigabytes number | kilobytes number | megabytes number | seconds number} no crypto global domain ipsec security-association lifetime {gigabytes | kilobytes | megabytes | seconds}
Syntax Description
gigabytes number kilobytes number megabytes number seconds number
Specifies a volume-based key duration in gigabytes. The range is 1 to 4095. Specifies a volume-based key duration in kilobytes. The range is 2560 to 2147483647. Specifies a volume-based key duration in megabytes. The range is 3 to 4193280. Specifies a time-based key duration in seconds. The range is 120 to 86400.
Defaults
450 gigabytes and 3600 seconds
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, IPsec must be enabled using the crypto ipsec enable command. The global security association lifetime value can be overridden for individual IPsec crypto maps using the set command in IPsec crypto map configuration submode.
Examples
The following example shows how to configure the system default before the IPsec.
switch# config terminal switch(config)# crypto global domain ipsec security-association lifetime gigabytes 500
Related Commands
Command crypto ipsec enable set (IPsec crypto map configuration submode)
Description Enables IPsec. Configures IPsec crypto map entry parameters.
show crypto global domain ipsec Displays the global attributes for IPsec.
4-72
Chapter 4
C Commands crypto ike domain ipsec
crypto ike domain ipsec

To enter IKE configuration submode, use the crypto ike domain ipsec command. crypto ike domain ipsec
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To configure IKE protocol attributes, IKE must be enabled using the crypto ike enable command.
Examples
The following example shows how enter IKE configuration mode.

switch# config terminal switch(config)# crypto ike domain ipsec switch(config-ike-ipsec)#
Related Commands
Command crypto ike enable
Description Enables the IKE protocol.
show crypto ike domain ipsec Displays IKE information for the IPsec domain.
4-73
Chapter 4 crypto ike domain ipsec rekey sa
C Commands
crypto ike domain ipsec rekey sa

To rekey an IKE crypto security association (SA) in the IPsec domain, use the crypto ike domain ipsec rekey sa command. crypto ike domain ipsec rekey sa sa-index
Syntax Description
sa-index
Specifies the SA index. The range is 1 to 2147483647.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, IKE must be enabled using the crypto ike enable command.
Examples
The following example rekeys an IKE crypto SA.

switch# crypto ike domain ipsec rekey sa 100
Related Commands
Command crypto ike enable
Description Enables the IKE protocol.
4-74
Chapter 4
C Commands crypto ike enable
crypto ike enable

To enable IKE, use the crypto ike enable command. To disable IKE, use the no form of the command. crypto ike enable no crypto ike enable
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
The IKE protocol cannot be disabled unless IPsec is disabled. The configuration and verification commands for the IKE protocol are only available when the IKE protocol is enabled on the switch. When you disable this feature, all related configurations are automatically discarded.
Examples
The following example shows how to enable the IKE protocol.

switch# config terminal switch(config)# crypto ike enable
Related Commands
Command
Description
clear crypto ike domain ipsec Clears IKE protocol information clear IKE SAs. sa crypto ipsec enable Enables IPsec. show crypto ike domain ipsec Displays IKE information for the IPsec domain.
4-75
Chapter 4 crypto ipsec enable
C Commands
crypto ipsec enable

To enable IPsec, use the crypto ipsec enable command. To disable IPsec, use the no form of the command. crypto ipsec enable no crypto ipsec enable
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To enable the IPsec, the IKE protocol must be enabled using the crypto ike enable command. The configuration and verification commands for IPsec are only available when IPsec is enabled on the switch. When you disable this feature, all related configurations are automatically discarded.
Examples
The following example shows how to enable IPsec.

switch# config terminal switch(config)# crypto ipsec enable
Related Commands
Command show crypto map domain ipsec show crypto transform-set domain ipsec
Description Displays IPsec crypto map information. Displays IPsec crypto transform set information.
show crypto global domain ipsec Displays IPsec crypto global information.
4-76
Chapter 4
C Commands crypto map domain ipsec (configuration mode)
crypto map domain ipsec (configuration mode)

To specify an IPsec crypto map and enter IPsec crypto map configuration mode, use the crypto map domain ipsec command. To delete an IPsec crypto map or a specific entry in an IPsec crypto map, use the no form of the command. crypto map domain ipsec map-name seq-number no crypto map domain ipsec map-name [seq-number]
Syntax Description
map-name seq-number
Specifies the map name. Maximum length is 63 characters. Specifies the sequence number for the map entry. The range is 1 to 65535.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, IPsec must be enabled using the crypto ipsec enable command. The sequence number determines the order in which IPsec crypto map entries are applied.
Examples
The following example specifies entry 1 for IPsec crypto map IPsecMap and enters IPsec crypto map configuration mode.
switch# config terminal switch(config)# crypto map domain ipsec IPsecMap 1 switch(config-crypto-map-ip)#
The following example deletes an IPsec crypto map entry.

switch# config terminal switch(config)# no crypto map domain ipsec IPsecMap 1
The following example deletes the entire IPsec crypto map.

switch# config terminal switch(config)# no crypto map domain ipsec IPsecMap
4-77
Chapter 4 crypto map domain ipsec (configuration mode)
C Commands
Related Commands Command crypto ipsec enable crypto transform-set domain ipsec set (IPsec crypto map configuration submode) show crypto map domain ipsec Description Enables IPsec. Configures the transform set for an IPsec crypto map. Configures IPsec crypto map entry parameters. Displays IPsec crypto map information.
4-78
Chapter 4
C Commands crypto map domain ipsec (interface configuration submode)
crypto map domain ipsec (interface configuration submode)

To configure an IPsec crypto map on a Gigabit Ethernet interface, use the crypto map domain ipsec command in interface configuration submode. To remove the IPsec crypto map, use the no form of the command. crypto map domain ipsec map-name no crypto map domain ipsec
Syntax Description
map-name
Specifies the map name. Maximum length is 63 characters.
Defaults
None.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, IPsec must be enabled using the crypto ipsec enable command. The sequence number determines the order in which crypto maps are applied.
Examples
The following example shows how to specify an IPsec crypto map for a Gigabit Ethernet interface.
switch# config terminal switch(config)# interface gigabitethernet 1/2 switch(config-if)# crypto map domain ipsec IPsecMap
Related Commands
Command crypto ipsec enable show interface
Description Enables IPsec. Displays interface information.
show crypto map domain ipsec Displays IPsec crypto map information.
4-79
Chapter 4 crypto transform-set domain ipsec
C Commands
crypto transform-set domain ipsec

To create and configure IPsec transform sets, use the crypto transform-set domain ipsec command. To delete an IPsec transform set, use the no form of the command. crypto transform-set domain ipsec set-name {esp-3des | esp-des} [esp-aes-xcbc-mac | esp-md5-hmac | esp-sha1-hmac] crypto transform-set domain ipsec set-name esp-aes {128 | 256} [ctr {esp-aes-xcbc-mac | esp-md5-hmac | esp-sha1-hmac} | esp-aes-xcbc-mac | esp-md5-hmac | esp-sha1-hmac] crypto transform-set domain ipsec set-name [{esp-3des | esp-des} [esp-aes-xcbc-mac | esp-md5-hmac | esp-sha1-hmac]] crypto transform-set domain ipsec set-name esp-aes [{128 | 256} [ctr {esp-aes-xcbc-mac | esp-md5-hmac | esp-sha1-hmac} | esp-aes-xcbc-mac | esp-md5-hmac | esp-sha1-hmac]]
Syntax Description
set-name esp-3des esp-des esp-aes-xcbc-mac esp-md5-hmac esp-sha1-hmac esp-aes 128 256 ctr
Specifies the transform set name. Maximum length is 63 characters. Specifies ESP transform using the 3DES cipher (128 bits). Specifies ESP transform using the DES cipher (56 bits). Specifies ESP transform using AES-XCBC-MAC authentication. Specifies ESP transform using MD5-HMAC authentication. Specifies ESP transform using SHA1-HMAC authentication Specifies ESP transform using the AES cipher (128 or 256 bits). Specifies ESP transform using AES 128-bit cipher. Specifies ESP transform using AES 256-bit cipher. Specifies AES in counter mode.
Defaults
None. The default mode of AES is CBC (Cyber Block Chaining).
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, IPsec must be enabled using the crypto ipsec enable command. You can use this command to modify existing IPsec transform sets. If you change a transform set definition, the change is only applied to crypto map entries that reference the transform set. The change is not applied to existing security associations, but used in subsequent negotiations to establish new security associations. If you want the new settings to take effect sooner, you can clear all or part of the security association database using the clear crypto sa domain ipsec command.
4-80
Chapter 4
C Commands crypto transform-set domain ipsec
Examples The following example shows how to configure an IPsec transform set.
switch# config terminal switch(config)# crypto transform-set domain ipsec Set1 esp-aes 128
Related Commands
Command clear crypto sa domain ipsec crypto ipsec enable show crypto transform-set domain ipsec
Description Clears security associations. Enables IPsec. Displays IPsec crypto transform set information.
4-81
Chapter 4 customer-id
C Commands
customer-id
To configure the customer ID with the Call Home function, use the customer-id command in Call Home configuration submode. To disable this feature, use the no form of the command. customer-id customer-id no customer customer-id
Syntax Description
customer-id
(Optional) Specifies the customer ID. The maximum length is 64 alphanumeric characters in free format.
Defaults
None.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to configure the customer ID in the Call Home configuration submode.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# callhome switch(config-callhome)# customer-id Customer1234
Related Commands
4-82
C H A P T E R
D Commands
5-1
Chapter 5 data-pattern-file
D Commands
data-pattern-file
To configure data pattern file for a SAN tuner extension N port, use the data-pattern-file command in interface configuration submode. To remove data pattern file, use the no form of the command. data-pattern-file filename no data-pattern-file
Syntax Description
filename
Specifies the data pattern file name.
Defaults
All zero pattern.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
By default, an all-zero pattern is used as the pattern for data generated by the virtual N ports. You can optionally specify a file as the data pattern to be generated by selecting a data pattern file from one of three locations: the bootflash: directory, the volatile: directory, or the slot0: directory. This option is especially useful when testing compression over FCIP links. You can also use Canterbury corpus or artificial corpus files for benchmarking purposes.
Examples
The following example configures the data pattern file for an N port.
switch# san-ext-tuner switch(san-ext)# nWWN 10:00:00:00:00:00:00:00 switch(san-ext)# nport pwwn 12:00:00:00:00:00:00:56 vsan 13 interface gigabitethernet 1/2 switch(san-ext-nport)# data-pattern-file bootflash://DataPatternFile
Related Commands
Command nport pwwn san-ext-tuner show san-ext-tuner
Description Configures SAN extension tuner N port pWWNs. Enters SAN extension tuner configuration mode. Displays SAN extension tuner information.
5-2
Chapter 5
D Commands delete
delete
To delete a specified file or directory on a Flash memory device, use the delete command in EXEC mode. delete {bootflash:filename | debug:filename | log:filename | modflash:filename | slot0:filename | volatile:filename}
Syntax Description
bootflash: debug: log:
Flash image that resides on the supervisor module. Contains the debug files. Contains the two default logfiles. The file dmesg contains the kernel log-messages and the file messages contains the system application log-messages. Flash image that resides on a module. Flash image that resides on another module. Flash image that resides on the volatile file system. The name of the file to be deleted.
modflash: slot0: volatile: filename
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.0(2 2.1(1a)
Modification This command was introduced. Added debug, log, and modflash keywords.
Usage Guidelines
When you delete a file, the software erases the file. If you attempt to delete the configuration file or image specified by the CONFIG_FILE or BOOTLDR environment variable, the system prompts you to confirm the deletion. Also, if you attempt to delete the last valid system image specified in the BOOT environment variable, the system prompts you to confirm the deletion.
Caution
If you specify a directory, the delete command deletes the entire directory and all its contents.
Examples
The following example deletes the file named test from the Flash card inserted in slot 0.
switch# delete slot0:test Delete slot0:test? [confirm]
5-3
Chapter 5 delete
D Commands
The following example deletes a file from a directory.
switch# delete dns_config.cfg
The following example deletes a file from an external CompactFlash (slot0).

switch# delete slot0:dns_config.cfg
The following example deletes the entire my-dir directory and all its contents:
switch# delete bootflash:my-dir
The following example deletes the entire user created dk log file on the active supervisor:
switch# delete log://sup-active/ log://sup-active/dk log://sup-active/dmesg switch# delete log://sup-active/dk switch# dir log: 31 Feb 04 18:22:03 2005 dmesg 14223 Feb 04 18:25:30 2005 messages Usage for log://sup-local 35393536 bytes used 174321664 bytes free 209715200 bytes total switch# log://sup-active/messages
Related Commands
Command dir
Description Displays the contents of the current or a specified directory.
5-4
Chapter 5
D Commands delete
Related Commands Command cd dir show boot Description Changes the default directory or file system. Displays a list of files on a file system. Displays the contents of the BOOT environment variable, the name of the configuration file pointed to by the CONFIG_FILE environment variable, the contents of the BOOTLDR environment variable, and the configuration register setting.
5-5
Chapter 5 destination interface
D Commands
destination interface
To configure a switched port analyzer (SPAN) destination interface, use the destination interface command in SPAN session configuration submode. To disable this feature, use the no form of the command. destination interface {fc slot/port | fc-tunnel tunnel-id} no destination interface {fc slot/port | fc-tunnel tunnel-id}
Syntax Description
fc slot/port fc-tunnel tunnel-id
Specifies the Fibre Channel interface ID at a slot and port. Specifies the Fibre Channel tunnel interface ID.
Defaults
Disabled.
Command Modes
SPAN session configuration submode.
Command History
Release 1.0(2) 1.2(1)
Modification This command was introduced. Added the fc-tunnel parameter.
Usage Guidelines
The SPAN destination interface must be configured as SPAN destination port (SD port) mode using the switchport command before the interface can be associated with SPAN session as a destination interface.
Examples
The following example shows how to configure an interface as a SPAN destination port (SD port), create a SPAN session, and then configure the interface fc3/13 as the SPAN destination interface.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# interface fc3/13 switch(config-if)# switchport mode sd switch(config)# span session 1 switch(config-span)# destination interface fc3/13 switch(config-span)# do show span session 1 switch(config-span)# show span session 1 Session 1 (inactive as destination is down) Destination is fc3/13 No session filters configured No ingress (rx) sources No egress (tx) sources switch(config-span)#
5-6
Chapter 5
D Commands destination interface
Related Commands Command switchport span session source suspend show span session Description Configures the switchport mode on the Fibre Channel interface. Selects or configures the SPAN session and changes to SPAN configuration submode. Configures a SPAN source. Suspends a SPAN session. Displays specific information about a SPAN session
5-7
Chapter 5 destination-profile
D Commands
destination-profile
To configure the customer ID with the Call Home function, use the destination-profile command in Call Home configuration submode. To disable this feature, use the no form of the command. destination-profile {profile-name | full-txt-destination | short-txt-destination | xml-destination} {alert-group {all | avanti | cisco-tac | environmental | inventory | license | linecard-hardware | rmon | supervisor-hardware | syslog-group-port | system | test} no destination-profile {profile-name | full-txt-destination | short-txt-destination | xml-destination} {alert-group {all | avanti | cisco-tac | environmental | inventory | license | linecard-hardware | rmon | supervisor-hardware | syslog-group-port | system | test}
Syntax Description
profile-name full-txt-destination short-txt-destination xml-destination alert-group all avanti cisco-tac environmental inventory license linecard-hardware rmon supervisor-hardware syslog-port-group system test
Specifies a user-defined user profile with a maximum of 32 alphanumeric characters. Configures destination profile for plain text message. (Optional) Configures a destination for a short text message. (Optional) Configures destination profile for XML message. Specifies one or more of the alert groups Specifies an alert group consisting of all Call Home messages. Specifies an alert group consisting of events that are meant only for Avanti. Specifies an alert group consisting of events that are meant only for Cisco TAC. Specifies an alert group consisting of power, fan, temperature-related events. Specifies an alert group consisting of inventory status events. Specifies an alert group consisting of license status events. Specifies an alert group consisting of module-related events. Specifies an alert group consisting of RMON status events. Specifies an alert group consisting of supervisor related events. Specifies an alert group consisting of syslog port group status events. Specifies an alert group consisting of software related events. Specifies an alert group consisting of user-generated test events.
Defaults
None.
Command Modes
Command History
Release 1.0(2)
5-8
Chapter 5
D Commands destination-profile
Usage Guidelines None.
Examples
The following example configures full-text destination profiles.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# callhome switch(config-callhome)# destination-profile full-txt-destination email-addr [email protected] switch(config-callhome)# destination-profile full-txt-destination message-size 1000000
The following example configures short-text destination profiles.

switch(config-callhome)# destination-profile short-txt-destination email-addr [email protected] switch(config-callhome)# destination-profile short-txt-destination message-size 100000
Related Commands
5-9
Chapter 5 device-alias abort
D Commands
device-alias abort
To discard a Distributed Device Alias Services (device alias) Cisco Fabric Services (CFS) distribution session in progress, use the device-alias abort command in configuration mode. device-alias abort
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to discard a device alias CFS distribution session in progress.
switch# config terminal switch(config)# device-alias abort
Related Commands
Command device-alias database device-alias distribute show device-alias
Description Configures and activates the device alias database. Enables CFS distribution for device aliases. Displays device alias information.
5-10
Chapter 5
D Commands device-alias commit
device-alias commit
To apply the pending configuration pertaining to the Distributed Device Alias Services (device alias) Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the device-alias commit command in configuration mode. device-alias commit
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to commit pending changes to the active DPVM database.
switch# config terminal switch(config)# device-alias commit
Related Commands
Description Configures and activates the device alias database. Enables CFS distribution for device aliases. Displays device alias information.
5-11
Chapter 5 device-alias database
D Commands
device-alias database
To initiate a Distributed Device Alias Services (device alias) session and configure device alias database, use the device-alias database command. To deactivate the device alias database, use the no form of the command. device-alias database no device-alias database
Syntax Description
Defaults
Deactivated.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
The device-alias database command starts a device alias session that locks all the databases on all the switches in this fabrics. When you exit device alias database configuration submode, the device alias session ends and the locks are released. You can only perform all modifications in the temporary device alias database. To make the changes permanent, use the device-alias commit command.
Examples
The following example shows how to activate a device alias session and enter device alias database configuration submode;.
switch# config terminal switch(config)# device-alias database switch(config-device-alias-db)#
Related Commands
Command device-alias commit show device-alias
Description Commits changes to the temporary device alias database to the active device alias database. Displays device alias database information.
5-12
Chapter 5
D Commands device-alias distribute
device-alias distribute
To enable Cisco Fabric Services (CFS) distribution for Distributed Device Alias Services (device alias), use the device-alias distribute command. To disable this feature, use the no form of the command. device-alias distribute no device-alias distribute
Syntax Description
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
Use the device-alias commit command to apply pending changes to the CFS distribution session.
Examples
The following example shows how to enable distribution for device alias information.
switch# config terminal switch(config)# device-alias distribute
Related Commands
Command device-alias commit device-alias database show device-alias
Description Commits changes to the active device alias database. Configures and activates the device alias database. Displays device alias information.
5-13
Chapter 5 device-alias import fcalias
D Commands
device-alias import fcalias

To import device alias database information from another VSAN, use the device-alias import fcalias command. To revert to the default configuration or factory defaults, use the no form of the command. device-alias import fcalias vsan vsan-id no device-alias import fcalias vsan vsan-id
Syntax Description
vsan vsan-id
Specifies the VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
You can import legacy device name configurations using this feature without losing data, if they satisfy the following restrictions:

Each fcalias has only one member. The member type is supported by the device name implementation.
If any name conflict exists, the fcaliases are not imported. The device name database is completely independent from the VSAN dependent fcalias database. When the import operation is complete, the modified global fcalias table can distributed to all other switches in the physical fabric using the device-alias distribute command so that new definitions are available everywhere.
Examples
The following example shows how to import device alias information.

switch# config terminal switch#(config)# device-alias import fcalias vsan 10
Related Commands
Description Configures and activates the device alias database. Distributes fcalias database changes to the fabric. Displays device alias database information.
5-14
Chapter 5
D Commands device-alias name
device-alias name
To configure device names in the device alias database, use the device-alias name command. To remove device names from the device alias database, use the no form of the command. device-alias name device-name pwwn pwwn-id no device-alias name device-name
Syntax Description
device-name pwwn pwwn-id
Specifies the device name. Maximum length is 64 characters. Specifies the pWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number.
Defaults
None.
Command Modes
Device alias database configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to configure a device name alias entry in the device name database.
switch# config terminal switch(config)# device-alias database switch(config-device-alias-db)# device-alias name Device1 pwwn 21:00:00:20:37:6f:db:bb
Related Commands
Command device-alias database show device-alias
Description Enters device alias database configuration submode. Displays device alias database information.
5-15
Chapter 5 dir
D Commands
dir
To display the contents of the current directory or the specified directory, use the dir command in EXEC mode. dir [bootflash:module | directory-or-filename | debug:directory-or-filename | log:module | directory-or-filename | modflash:module | directory-or-filename | slot0:directory-or-filename | volatile:module | directory-or-filename]
Syntax Description
bootflash: debug: log:
(Optional) Flash image that resides on the supervisor module. (Optional) Provides information about the debug capture directory. (Optional) Provides information about the two default logfiles. The file dmesg contains the kernel log-messages and the file messages contains the system application log-messages. (Optional) Provides information about the flash image that resides in a module flash file directory. (Optional) Flash image that resides on another module. (Optional) Module name and number. (Optional) Name of the file or directory to display on a specified device. The files can be of any type. You can use wildcards in the filename. A wildcard character (*) matches all patterns. Strings after a wildcard are ignored. Flash image on the volatile file system.
modflash: slot0: module filename-or-directory
volatile:
Defaults
The default file system is specified by the cd command.
Command Modes
EXEC mode.
Command History
Release 1.2(1) 2.1(1a)
Modification This command was introduced. Added debug, log, and modflash keywords.
Usage Guidelines
None.
5-16
Chapter 5
D Commands dir
Examples The following example shows how to list the files on the bootflash directory.
switch# dir bootflash: 40295206 Aug 05 15:23:51 1980 ilc1.bin 12456448 Jul 30 23:05:28 1980 kickstart-image1 12288 Jun 23 14:58:44 1980 lost+found/ 27602159 Jul 30 23:05:16 1980 system-image1 12447232 Aug 05 15:08:30 1980 kickstart-image2 28364853 Aug 05 15:11:57 1980 system-image2 Usage for bootflash://sup-local 135404544 bytes used 49155072 bytes free 184559616 bytes total
The following example shows how to list the files in the debug directory.
switch# dir debug: Usage for debug://sup-local 0 bytes used 2097152 bytes free 2097152 bytes total switch#
The following example shows how to list the files in the log file directory.
switch# dir log: 31 Feb 05 05:00:57 2005 8445 Feb 06 10:34:35 2005 Usage for log://sup-local 35196928 bytes used 174518272 bytes free 209715200 bytes total switch# dmesg messages
Related Commands
Command cd delete
Description Changes the default directory or file system. Deletes a file on a Flash memory device.
5-17
Chapter 5 disable
D Commands
disable
To disable the Call Home function, use the disable command in Call Home configuration submode. disable
Syntax Description
Defaults
None.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
To enable the Call Home function, use the enable command.
Examples
The following example shows how to disable the Call Home function.
switch# config terminal Enter configuration commands, one per line. switch(config)# callhome switch(config-callhome)# disable End with CNTL/Z.
Related Commands
5-18
Chapter 5
D Commands discover custom-list
discover custom-list
To selectively initiate discovery for specified domain IDs in a VSAN, use the discover custom-list command in EXEC mode. discover custom-list {add | delete} vsan vsan-id fcid fc-id
Syntax Description
add delete vsan vsan-id fcip fc-id
Add a targets to the customized list. Deletes a target from the customized list. Discovers SCSI targets for the specified VSAN ID. The range is 1 to 4093. Discovers SCSI targets for the specified FCID. The format is 0xhhhhhhh, where h is a hexadecimal digit.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example selectively initiates discovery for the specified VSAN and FCID.
switch# discover custom-list add vsan 1 fcid 0X123456
The following example deletes the specified VSAN and FCID from the customized list.
switch# discover custom-list delete vsan 1 fcid 0X123456
5-19
Chapter 5 discover scsi-target
D Commands
discover scsi-target
To discover SCSI targets on local storage to the switch or remote storage across the fabric, use the discover scsi-target command in EXEC mode. discover scsi-target {custom-list | local | remote | vsan vsan-id fcid fc-id} os {aix | all | hpux | linux | solaris | windows} [lun | target]
Syntax Description
custom-list local remote vsan vsan-id fcip fc-id os aix all hpux linux solaris windows lun target
Discovers SCSI targets from the customized list. Discovers local SCSI targets. Discovers remote SCSI targets. Discovers SCSI targets for the specified VSAN ID. The range is 1 to 4093. Discovers SCSI targets for the specified FCID. The format is 0xhhhhhhh, where h is a hexadecimal digit. Discovers the specified operating system. Discovers the AIX operating system Discovers all operating systems Discovers the HPUX operating system Discovers the Linux operating system Discovers the Solaris operating system Discovers the Windows operating system Discovers SCSI targets and LUNs. Discovers SCSI targets.
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was modified in Cisco MDS SAN-OS Release 1.3(2a).
Usage Guidelines
On-demand discovery only discovers Nx ports present in the name server database that have registered a FC4 Type = SCSI_FCP.
Examples
The following example shows how to discover local targets assigned to all OSs.
switch# discover scsi-target local os all discovery started
5-20
Chapter 5
D Commands discover scsi-target
The following example shows how to discover remote targets assigned to the Windows OS.
switch# discover scsi-target remote os windows discovery started
The following example shows how to discover SCSI targets for the specified VSAN (1) and FCID (0x9c03d6).
switch# discover scsi-target vsan 1 fcid 0x9c03d6 discover scsi-target vsan 1 fcid 0x9c03d6 VSAN: 1 FCID: 0x9c03d6 PWWN: 00:00:00:00:00:00:00:00 PRLI RSP: 0x01 SPARM: 0x0012...
The following example begins discovering targets from a customized list assigned to the Linux operating system.
switch# discover scsi-target custom-list os linux discovery started
5-21
Chapter 5 distribute
D Commands
distribute
To enable distribution of the Call Home function using CFS, use the distribute command in Call Home configuration submode. To disable this feature, use the no form of the command. distribute no distribute
Syntax Description
Defaults
None.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to enable distribution of the Call Home function using CFS.
switch# config terminal Enter configuration commands, one per line. switch(config)# callhome switch(config-callhome)# distribute End with CNTL/Z.
Related Commands
5-22
Chapter 5
D Commands do
do
Use the do command to execute an EXEC-level command from any configuration mode or submode. do command
Syntax Description
command
Specifies the EXEC command to be executed.
Defaults
None.
Command Modes
All configuration modes.
Command History
Usage Guidelines
Use this command to execute EXEC commands while configuring your switch. After the EXEC command is executed, the system returns to the mode from which you issued the do command.
Examples
The following example disables the terminal session-timeout command using the do command in configuration mode.
switch(config)# do terminal session-timeout 0 switch(config)#
5-23
Chapter 5 do
D Commands
The following example create, enables, and displays the interface from configuration mode.
switch(config)# int fc 3/1 switch(config-if)# no shut switch(config-if)# do show interface fc 3/1 fc3/1 is trunking Hardware is Fibre Channel Port WWN is 20:81:00:05:32:00:4a:9e Peer port WWN is 20:43:00:0c:88:00:4a:e2 Admin port mode is auto, trunk mode is on Port mode is TE Port vsan is 1 Speed is 2 Gbps Transmit B2B Credit is 0 Receive B2B Credit is 255 Receive data field Size is 2112 Beacon is turned off Trunk vsans (admin allowed and active) (1-10) Trunk vsans (up) (1-10) Trunk vsans (isolated) () Trunk vsans (initializing) () 5 minutes input rate 504 bits/sec, 63 bytes/sec, 0 frames/sec 5 minutes output rate 344 bits/sec, 43 bytes/sec, 0 frames/sec 69390 frames input, 4458680 bytes 0 discards, 0 errors 0 CRC, 0 unknown class 0 too long, 0 too short 69458 frames output, 3086812 bytes 0 discards, 0 errors 2 input OLS, 1 LRR, 0 NOS, 2 loop inits 1 output OLS, 1 LRR, 1 NOS, 1 loop inits
5-24
Chapter 5
D Commands dpvm abort
dpvm abort
To discard a dynamic port VSAN membership (DPVM) Cisco Fabric Services (CFS) distribution session in progress, use the dpvm abort command in configuration mode. dpvm abort
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command.
Examples
The following example shows how to discard a DPVM CFS distribution session in progress.
switch# config terminal switch(config)# dpvm abort
Related Commands
Command dpvm database dpvm distribute dpvm enable show dpvm
Description Configures the DPVM database. Enables CFS distribution for DPVM. Enables DPVM. Displays DPVM information.
5-25
Chapter 5 dpvm activate
D Commands
dpvm activate
To activate the dynamic port VSAN membership (DPVM) configuration database, use the dpvm activate command. To deactivate the DPVM configuration database, use the no form of the command. dpvm activate [force] no dpvm activate [force]
Syntax Description
force
Forces the activation or deactivation if conflicts exist between the configured DPVM database and the active DPVM database.
Defaults
Deactivated.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command. Activation might fail if conflicting entries are found between the configured DPVM database and the currently activated DPVM database. You can ignore the conflicts using the force option.
Examples
The following example shows how to activate the DPVM database.

switch# config terminal switch(config)# dpvm activate
The following example shows how to deactivate the DPVM database.

switch# config terminal switch(config)# no dpvm activate
Related Commands
Command dpvm database dpvm enable show dpvm
Description Configures the DPVM database. Enables DPVM. Displays DPVM database information.
5-26
Chapter 5
D Commands dpvm auto-learn
dpvm auto-learn
To enable the automatic learning feature (autolearn) for the active dynamic port VSAN membership (DPVM) database, use the dpvm auto-learn command. To disable this feature, use the no form of the command. dpvm auto-learn no dpvm auto-learn
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command. When autolearn is enabled, the system automatically creates the DPVM database by learning about devices currently logged or newly logged devices with a VSAN. This is a quick way to create the DPVM database, which can later be edited. Autolearn features include the following:

An autolearned entry is created by adding the device PWWN and VSAN to the active DPVM database. The active DPVM database must be present when autolearning is enabled. Autolearned entries can be deleted from the active DPVM database by the user until autolearning is disabled. Autolearned entries are not permanent in the active DPVM database until autolearning is disabled. If a device logs out when autolearning is enabled, the device entry is deleted from the active DPVM database. If a particular device logs into the switch multiple times through different ports, then only the VSAN corresponding to last login is associated with the device. Autolearn entries do not override previously configured activate entries.
Examples
The following example shows how to enable autolearning for the DPVM database.
switch# config terminal switch(config)# dpvm auto-learn
5-27
Chapter 5 dpvm auto-learn
D Commands
The following example shows how to disable autolearning for the DPVM database.
switch# config terminal switch(config)# no dpvm auto-learn
Related Commands
5-28
Chapter 5
D Commands dpvm commit
dpvm commit
To apply the pending configuration pertaining to the dynamic port VSAN membership (DPVM) Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the dpvm commit command. dpvm commit
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to commit changes to the DPVM database.
switch# config terminal switch(config)# dpvm commit
Related Commands
Command dpvm distribute dpvm enable show dpvm
Description Enables CFS distribution for DPVM. Enables DPVM. Displays DPVM information.
5-29
Chapter 5 dpvm database
D Commands
dpvm database
To activate and configure the dynamic port VSAN membership (DPVM) database, use the dpvm database command. To deactivate the database, use the no form of the command. dpvm database no dpvm database
Syntax Description
Defaults
Deactivated.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command. The DPVM database consists of a series of device mapping entries. Each entry consists of device pWWN or nWWN along with the dynamic VSAN to be assigned. Use the nwwn command or pwwn command to add the entries to the DPVM database. This database is global to the whole switch (and fabric) and is not maintained for each VSAN.
Examples
The following example shows how to activate the DPVM database and enter DPVM database configuration submode.
switch# config terminal switch(config)# dpvm database switch(config-dpvm-db)#
Related Commands
Command dpvm enable nwwn (DPVM database configuration submode) pwwn (DPVM database configuration submode) show dpvm
Description Enables DPVM. Adds entries to the DPVM database using the nWWN. Adds entries to the DPVM database using the pWWN. Displays DPVM database information.
5-30
Chapter 5
D Commands dpvm database copy active
dpvm database copy active

To copy the active dynamic port VSAN membership (DPVM) database to the config DPVM database, use the dpvm database copy active command. dpvm database copy active
Syntax Description
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command. The following circumstances may require the active database to be copied to the config database:

When the autolearned entries are only added to the active database. When the config database or entries in the config database are accidently deleted.
Note
If you want to copy the DPVM database and fabric distribution is enabled, you must first commit the changes.
Examples
The following example shows how to copy the active DPVM database to the config DPVM database.
switch# dpvm database copy active
Related Commands
5-31
Chapter 5 dpvm database diff
D Commands
dpvm database diff

To display the active dynamic port VSAN membership (DPVM) database, use the dpvm database diff command. dpvm database diff {active | config}
Syntax Description
active config
Displays differences in the DPVM active database compared to the DPVM config database. Displays differences in the DPVM config database compared to the DPVM active database.
Defaults
Deactivated.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example displays the differences in the DPVM active database when compared with the DPVM config database.
switch# dpvm database diff active Legend: + New Entry, - Missing Entry, * Possible Conflict Entry --------------------------------------------------------------------- pwwn 44:22:33:44:55:66:77:88 vsan 44 * pwwn 11:22:33:44:55:66:77:88 vsan 11
The following example displays the differences in the DPVM config database when compared with the DPVM active database.
switch# dpvm database diff config Legend: + New Entry, - Missing Entry, * Possible Conflict Entry --------------------------------------------------------------------- pwwn 44:22:33:44:55:66:77:88 vsan 44 * pwwn 11:22:33:44:55:66:77:88 vsan 11
5-32
Chapter 5
D Commands dpvm database diff
Related Commands Command dpvm enable show dpvm Description Enables DPVM. Displays DPVM database information.
5-33
Chapter 5 dpvm distribute
D Commands
dpvm distribute
To enable Cisco Fabric Services (CFS) distribution for dynamic port VSAN membership (DPVM), use the dpvm distribute command. To disable this feature, use the no form of the command. dpvm distribute no dpvm distribute
Syntax Description
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command. Temporary changes to the DPVM database must be committed to the active DPVM database using the dpvm commit command before being distributed to the fabric.
Examples
The following example shows how to disable distribution for the DPVM database.
switch# config terminal switch(config)# no dpvm distribute
The following example shows how to enable distribution for the DPVM database.
switch# config terminal switch(config)# dpvm distribute
Related Commands
Description Enables DPVM. Displays DPVM information.
5-34
Chapter 5
D Commands dpvm enable
dpvm enable
To enable dynamic port VSAN membership (DPVM), use to dpvm enable command. To disable DPVM, use the no form of the command. dpvm enable no dpvm enable
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
The configuration and verification commands for DPVM are only available when DPVM is enabled on the switch. When you disable this feature, all related configurations are automatically discarded.
Examples
The following example shows how to enable DPVM.

switch# config terminal switch(config)# dpvm enable
Related Commands
Command dpvm activate dpvm database show dpvm
Description Activates the DPVM database. Configures the DPVM database. Displays DPVM database information.
5-35
Chapter 5 dscp
D Commands
dscp
To configure a differentiated services code point (DSCP) in a QoS policy map class, use the dscp command in EXEC mode. To disable this feature, use the no form of the command. dscp value no dscp value
Syntax Description
value
Configures the DSCP value. The range is 0 to 63. DSCP value 46 is reserved.
Defaults
The default DSCP value is 0.
Command Modes
QoS policy map class configuration submode.
Command History
Release 1.3(1)
Usage Guidelines
Before you can configure a QoS policy map class you must complete the following:

Enable the QoS data traffic feature using the qos enable command. Configure a QoS class map using the qos class-map command. Configure a QoS policy map using the qos policy-map command. Configure a QoS policy map class using the class command.
Examples
The following example configures a DSCP value of 56 in QoS policy classMap1.

switch(config-pmap)# class classMap1 switch(config-pmap-c)# dscp 56 switch(config-pmap-c)#
Related Commands
Command qos enable qos class-map qos policy-map class show qos
Description Enables the QoS data traffic feature on the switch. Configures a QoS class map. Configure a QoS policy map. Configure a QoS policy map class. Displays the current QoS settings.
5-36
Chapter 5
D Commands duplicate-message throttle
duplicate-message throttle
To enable throttling of duplicate Call Home alert messages, use the duplicate-message throttle command in Call Home configuration submode. To disable this feature, use the no form of the command. duplicate-message throttle no duplicate-message throttle
Syntax Description
Defaults
Enabled.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
The rate of throttling is a maximum of thirty messages in 2 hours.
Examples
The following example shows how to enable throttling of duplicate Call Home alert messages.
switch# config terminal switch(config)# callhome switch(config-callhome)# duplicate-message throttle
Related Commands
5-37
Chapter 5 duplicate-message throttle
D Commands
5-38
C H A P T E R
Debug Commands
The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All debug commands are issued in EXEC mode and are shown here in alphabetical order. For more information, refer to the Cisco MDS 9000 Family Troubleshooting Guide and the Cisco MDS 9000 Family System Messages Guide. Using the CLI, you can enable debugging modes for each switch feature and view a real-time updated activity log of the control protocol exchanges. Each log entry is time-stamped and listed in chronological order. Access to the debug feature can be limited through the CLI roles mechanism and can be partitioned on a per-role basis.
6-1
Chapter 6 debug aaa
Debug Commands
debug aaa
To enable debugging for boot variables, use the debug aaa command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug aaa {all | conf-events | errors | events | mts} no debug aaa {all | conf-events | errors | events | mts}
Syntax Description
all conf-events errors events mts
Enables all AAA debug options. Enables AAA configuration events debugging. Enables debugging for AAA errors. Enables debugging for AAA events. Enables AAA transmit and receive MTS packets debugging.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.3(1)
Modifications This command was introduced.
Usage Guidelines
None.
Examples
The following example displays the system output when the debug aaa conf-events command is issued:
switch# debug aaa conf-events Nov 20 06:29:52 aaa: aaa_cleanup_session Nov 20 06:29:52 aaa: mts_drop of request msg Nov 20 06:29:52 aaa: Configured method local Succeeded Nov 20 06:29:58 aaa: Src: 0x00000101/10886 Dst: 0x00000101/0 ID: 0x003 ize: 197 [REQ] Opc: 8402 (MTS_OPC_AAA_REQ) RR: 0x003A48F7 HA_SEQNO: 0x0 TS: 0x9FC1C1234E7C REJ:0 SYNC:0 Nov 20 06:29:58 aaa: 01 01 0C 00 00 00 00 00 00 00 00 00 00 00 02 01 Nov 20 06:29:58 aaa: 00 00 00 00 00 00 00 06 08 00 03 05 00 00 00 00 Nov 20 06:29:58 aaa: 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Nov 20 06:29:58 aaa: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Nov 20 06:29:58 aaa: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Nov 20 06:29:58 aaa: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Nov 20 06:29:58 aaa: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Nov 20 06:29:58 aaa: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Nov 20 06:29:58 aaa: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Nov 20 06:29:58 aaa: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
6-2
Chapter 6
Debug Commands debug aaa
Related Commands Command aaa authentication login no debug all show aaa authentication Description Configures the authentication mode for a login. Disables all debugging. Displays the configured authentication methods.
6-3
Chapter 6 debug all
Debug Commands
debug all
To enable debugging for all features on the switch, use the debug all command in EXEC mode. To disable this command and turn off all debugging, use the no form of the command. debug all no debug all
Syntax Description
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
The no debug all command turns off all diagnostic output. Using the no debug all command is a convenient way to ensure that you have not accidentally left any debug commands turned on.
Caution
Because debugging output takes priority over other network traffic, and because the debug all command generates more output than any other debug command, it can severely diminish the performance of the switch or even render it unusable. In virtually all cases, it is best to use more specific debug commands.
Examples
The following example displays the system output when the debug all command is issued:
switch# debug all
Related Commands
Command show debug
Description Displays the debug commands configured on the switch.
6-4
Chapter 6
Debug Commands debug biosd
debug biosd
To configure bios_daemon debugging, use the debug biosd command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug biosd all no debug biosd all
Syntax Description
all
Enables all bios_daemon debug options.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 2.1(1)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug biosd command is issued:
switch# debug biosd
Related Commands
Command no debug all
Description Disables all debugging.
6-5
Chapter 6 debug bootvar
Debug Commands
debug bootvar
To enable debugging for boot variables, use the debug bootvar command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug bootvar {all | errors | events | info | pss} no debug bootvar {all | errors | events | info | pss}
Syntax Description
all errors events info pss
Enables all boot variable debug options. Enables debugging for boot variable errors. Enables debugging for boot variable events. Enables debugging for boot variable information. Enables debugging for boot variable PSS operations.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug bootvar all command is issued:
switch# debug
bootvar all
Related Commands
Command debug all show boot
Description Enables debugging for all features on the switch. Displays the boot variables or modules.
6-6
Chapter 6
Debug Commands debug callhome
debug callhome
To enable debugging for the Call Home function, use the debug callhome command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug callhome {all | events | mts} no debug callhome {all | events | mts}
Syntax Description
all events mts
Enables debugging for all Call Home features. Enables debugging for all Call Home events. Enables debugging for all Call Home tx/rx packets of MTS
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
The debug callhome command, when used with the all parameter, displays the troubleshooting information for both Call Home event traces and a dump of the messaging and transaction service (MTS) messages that the Call Home function receives.
Note
The debug Call Home function displays event traces for both successful and unsuccessful Call Home e-mail transmissions.
6-7
Chapter 6 debug callhome
Debug Commands
Examples The following example displays the system output when the debug callhome events command is issued:
switch# debug callhome events 2005-03-09T05:37:21 2005 Mar 9 05:37:21 callhome: filling in name field with Test 2005 Mar 9 05:37:21 callhome: filling in the header list 2005 Mar 9 05:37:21 callhome: filling up the chassis list 2005 Mar 9 05:37:21 callhome: filling up the main body list 2005 Mar 9 05:37:21 callhome: filling up the fru list 2005 Mar 9 05:37:21 callhome: Entering function do_event_correlation 2005 Mar 9 05:37:21 callhome: getting dest profiles for alert group test 2005 Mar 9 05:37:21 callhome: getting dest profiles for alert group cisco-tac 2005 Mar 9 05:37:21 callhome: Applying the event rule for destination profile full_txt 2005 Mar 9 05:37:21 callhome: Applying the event rule for destination profile short_txt 2005 Mar 9 05:37:21 callhome: Applying the event rule for destination profile xml 2005 Mar 9 05:37:21 callhome: Applying the event rule for destination profile basu 2005 Mar 9 05:37:21 callhome: Exiting function do_event_correlation 2005 Mar 9 05:37:21 callhome: running cli commands for alert name : Test, message id : 1540383426 2005 Mar 9 05:37:21 callhome: process scheduled for running cli commands for alert Test, message id 1540383426, destination profile basu 2005 Mar 9 05:37:21 callhome: process scheduled for running cli commands for alert Test, message id 1540383426, destination profile xml 2005 Mar 9 05:37:21 callhome: process scheduled for running cli commands for alert Test, message id 1540383426, destination profile short_txt . . .
The following example displays the system output when the debug callhome mts command is issued:
switch# debug callhome mts Apr 8 13:09:42 callhome: Src: 0x00000501/4067 Dst: 0x00000501/66 ID: 0x0004FA 0D Size: 252 [REQ] Opc: 182 (MTS_OPC_DEBUG_WRAP_MSG) RR: 0x0004FA0D HA_SEQNO: 0x00000000 TS: 0x86708AFE37B REJ:0 Apr 8 13:09:42 callhome: 00 00 00 00 06 00 00 00 00 00 00 00 00 00 00 00 Apr 8 13:09:42 callhome: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 8 13:09:42 callhome: 00 00 00 00 00 00 00 00 00 00 00 00 FF FF FF FF ... Apr 8 13:09:42 callhome: Src: 0x00000501/4067 Dst: 0x00000501/66 ID: 0x0004FA 10 Size: 252 [REQ] Opc: 182 (MTS_OPC_DEBUG_WRAP_MSG) RR: 0x0004FA10 HA_SEQNO: 0x00000000 TS: 0x86708D6A974 REJ:0 Apr 8 13:09:42 callhome: 00 00 00 00 05 00 00 00 00 00 00 00 00 00 00 00 Apr 8 13:09:42 callhome: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 8 13:09:42 callhome: 00 00 00 00 00 00 00 00 00 00 00 00 FF FF FF FF ...
Related Commands
Command no debug all show callhome
Description Disables all debugging. Displays Call Home information configured on a switch.
6-8
Chapter 6
Debug Commands debug cdp
debug cdp
To enable debugging for the Cisco Discovery Protocol (CDP) function, use the debug cdp command in EXEC mode. To disable a debug command use the no form of the command or use the no debug all command to turn off all debugging. debug cdp {all | errors | events {mts | packets | pss}} [interface {gigabitethernet slot/port | mgmt 0}] no debug cdp {all | errors | events {mts | packets | pss}} [interface {gigabitethernet slot/port | mgmt 0}]
Syntax Description
all errors events mts packets pss interface gigbitethernet slot/port mgmt 0
Enables debugging for all CDP features. Enables debugging for CDP error conditions. Enables debugging for CDP events. Enables debugging for CDP tx/rx MTS packets. Enables debugging for CDP tx/rx CDP packets. Enables debugging for all PSS related CDP events. Specifies debugging for the specified interface. Specifies the Gigabit Ethernet interface slot and port. Specifies the management interface.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.1(1)
Usage Guidelines
None.
6-9
Chapter 6 debug cdp
Debug Commands
Examples The following example displays the system output when the debug cdp events packets command is issued:
switch# debug cdp events packets Apr 8 21:22:34 cdp: Sent CDP packet, interface 0x2380000 Apr 8 21:22:34 cdp: Sent CDP packet, interface 0x2381000 Apr 8 21:22:35 cdp: Sent CDP packet, interface 0x2382000 Apr 8 21:22:35 cdp: Sent CDP packet, interface 0x2383000 Apr 8 21:22:51 cdp: Received CDP packet, interface 0x5000000 Apr 8 21:23:01 cdp: Sent CDP packet, interface 0x5000000 Apr 8 21:23:34 cdp: Sent CDP packet, interface 0x2380000 Apr 8 21:23:34 cdp: Sent CDP packet, interface 0x2381000 Apr 8 21:23:35 cdp: Sent CDP packet, interface 0x2382000 ...
Related Commands
Command no debug all show cdp
Description Disables all debugging. Displays CDP parameters configured globally or for a specific interface.
6-10
Chapter 6
Debug Commands debug cfs
debug cfs
To enable debugging for Cisco Fabric Services (CFS), use the debug cfs command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug cfs {all | errors | events {db [vsan vsan-id] | fc2 [vsan vsan-id] | fsm-action [vsan vsan-id] | fsm-trans [sap sap-id] | mts [vsan vsan-id] | pss [vsan vsan-id]} | fsm {ha | trans} | merge} no debug cfs {all | errors | events {db [vsan vsan-id] | fc2 [vsan vsan-id] | fsm-action [vsan vsan-id] | fsm-trans [sap sap-id] | mts [vsan vsan-id] | pss [vsan vsan-id]} | fsm {ha | trans} | merge}
Syntax Description
all errors events db vsan vsan-id fc2 fsm-action fsm-trans sap sap-id mts pss fsm ha trans merge
Enables all CFS debugging. Enables debugging for CFS error conditions. Enables debugging for CFS events. Enables debugging for CFS database events. Restricts debugging to the specified VSAN ID. The range is 1 to 4093. Enables debugging for CFS FC2 events. Enables debugging for CFS FSM action events. Enables debugging for CFS FSM transition events. Restricts debugging to the specified SAP ID. The range is 0 to 2147483647 Enables debugging for CFS MTS events. Enables debugging for CFS PSS events. Enables debugging for CFS FSM events. Enables debugging for CFS FSM high availability events. Enables debugging for CFS FSM transition events. Enables debugging for CFS merge events.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
6-11
Chapter 6 debug cfs
Debug Commands
Examples The following example displays the system output when the debug cfs all command is issued.
switch# debug cfs all
Related Commands
Command no debug all show cfs
Description Disables all debugging. Displays CFS information.
6-12
Chapter 6
Debug Commands debug cimserver
debug cimserver
To enable debugging for the Common Information Model (CIM) management applications function, use the debug cimserver command in EXEC mode. To disable a debug command use the no form of the command or use the no debug all command to turn off all debugging.turn off all debugging). debug cimserver {all | errors | events | mts | trace} no debug cimserver {all | errors | events | mts | trace}
Syntax Description
all errors events mts trace
Enables debugging for all CIM features. Enables debugging for CIM error conditions. Enables debugging for CIM events. Enables debugging for CIM tx/rx MTS packets. Enables debugging for CIM traces.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.3(1)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug cimserver all command is issued:
switch# debug cimserver all 2004 Mar 29 20:05:22 cimsrvprov: cim_mts_dispatch(): Opcode is 182
Related Commands
Command no debug all show cimserver
Description Disables all debugging. Displays the CIM configurations and settings.
6-13
Chapter 6 debug core
Debug Commands
debug core
To enable core daemon debugging, use the debug core command in EXEC mode. To disable a debug command use the no form of the command or use the no debug all command to turn off all debugging. debug core {error | flow} no debug core {error | flow}
Syntax Description
error flow
Enables debugging for core demon error conditions. Enables debugging for the core demon flow.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug core flow command is issued:
switch# debug core flow
Related Commands
Command no debug all show cores
Description Disables all debugging. Displays all the cores presently available for upload from active sup.
6-14
Chapter 6
Debug Commands debug device-alias
debug device-alias
To enable debugging for device aliases, use the debug device-alias command in EXEC mode. To disable a debug command use the no form of the command or use the no debug all command to turn off all debugging. debug device-alias {all | database {detail | errors | events} | fsm | ha | import {errors | events} | merge {errors | events | packets} | pss {errors | events} | session {errors | events | packets} | trace} no debug device-alias {all | database {detail | errors | events} | fsm | ha | import {errors | events} | merge {errors | events | packets} | pss {errors | events} | session {errors | events | packets} | trace}
Syntax Description
all database detail errors events fsm ha import merge packets pss session trace
Enables all device alias debugging. Enables debugging for device alias database events. Enables detailed debugging for device alias database events. Enables debugging for device alias error conditions. Enables debugging for device alias events. Enables debugging for device alias FSM events. Enables debugging for device alias HA events. Enables debugging for device alias imports. Enables debugging for device alias merges. Enables debugging for device alias packets. Enables debugging for device alias PSS. Enables debugging for device alias sessions. Enables debugging for device alias traces.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug device-alias all command is issued.
switch# debug device-alias all
6-15
Chapter 6 debug device-alias
Debug Commands
Related Commands Command no debug all show device-alias Description Disables all debugging. Displays device alias information.
6-16
Chapter 6
Debug Commands debug dpvm
debug dpvm
To enable debugging for dynamic port VSAN membership (DPVM), use the debug dpvm command in EXEC mode. To disable a debug command use the no form of the command or use the no debug all command to turn off all debugging. debug dpvm {all | cfs-events | change-events | db-events | errors | ftrace | merge-event | mts-events | pss-events | session-events | snmp-events | sys-events} no debug dpvm {all | cfs-events | change-events | db-events | errors | ftrace | merge-event | mts-events | pss-events | session-events | snmp-events | sys-events}
Syntax Description
all cfs-events change-events db-events errors ftrace merge-event mts-events pss-events session-events snmp-events sys-events
Enables debugging for all DPVM. Enables debugging for Cisco Fabric Services (CFS). Enables debugging for change events. Enables debugging for database events. Enables debugging for error. Enables debugging for function trace. Enables debugging for merge events. Enables debugging for MTS events. Enables debugging for PSS events. Enables debugging for session events. Enables debugging for SNMP events. Enables debugging for system events.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example displays the system output when the debug dpvm all command is issued.
switch# debug dpvm all
6-17
Chapter 6 debug dpvm
Debug Commands
Related Commands Command no debug all show dpvm Description Disables all debugging. Displays DPVM database information.
6-18
Chapter 6
Debug Commands debug dstats
debug dstats
To enable delta statistics debugging, use the debug dstats command in EXEC mode. To disable a debug command use the no form of the command or use the no debug all command to turn off all debugging. debug dstats {error | flow} no debug dstats {error | flow}
Syntax Description
error flow
Enables debugging for delta statistics error conditions. Enables debugging for the delta statistics flow.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug dstats flow command is issued:
switch# debug dstats flow
Related Commands
6-19
Chapter 6 debug ethport
Debug Commands
debug ethport
To enable Ethernet port debugging, use the debug ethport command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug ethport {all | error | event [interface gigabitethernet slot/port | module slot] | ha [interface gigibetethernet slot/port | module slot] | trace [interface gigibetethernet slot/port | module slot]} no debug ethport {all | error | event [interface gigabitethernet slot/port | module slot] | ha [interface gigibetethernet slot/port | module slot] | trace [interface gigibetethernet slot/port | module slot]}
Syntax Description
all error event ha trace interface gigibetethernet slot/port module slot
Enables debugging for all Ethernet port features. Enables debugging for Ethernet port error conditions. Enables debugging for Ethernet port events. Enables debugging for port high availability. Enables debugging for Ethernet port traces. Specifies the slot and port of the Gigabit Ethernet interface. Specifies the slot number of the module being debugged.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug ethport all command is issued:
switch# debug ethport all 1981 May 5 07:28:59 ethport: 1981 May 5 07:28:59 ethport: 1981 May 5 07:28:59 ethport: MTS_OPC_DEBUG_WRAP_MSG(msg_id fu_fsm_execute_all: match_msg_id(0), log_already_open(0) fu_fsm_execute_all: null fsm_event_list fu_fsm_engine_post_event_processing: mts msg 52343) dropped
6-20
Chapter 6
Debug Commands debug ethport
Related Commands Command no debug all Description Disables all debugging.
6-21
Chapter 6 debug exceptionlog
Debug Commands
debug exceptionlog
To enable the exception log debugging feature, use the debug exceptionlog command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug exceptionlog {demux | deque | error | flow | info} no debug exceptionlog {demux | deque | error | flow | info}
Syntax Description
demux deque error flow info
Enables debugging for the exception logger demux functions. Enables debugging for the exception logger deque function. Enables debugging for exception logger errors. Enables debugging for the exception logger flow. Enables debugging for exception logger information.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug exceptionlog command is issued:
switch# debug exceptionlog 7), credit(3), empty
Related Commands
6-22
Chapter 6
Debug Commands debug fabric-binding
debug fabric-binding
To enable debugging for the fabric binding feature, use the debug fabric-binding command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fabric-binding {all | efmd {db-events | errors | merge {errors | events | packets}} | mts-events | pss-events} | errors [vsan vsan-id] | events [vsan vsan-id] | mts-events | pss-events | snmp-events | trace [vsan vsan-id]} no debug fabric-binding {all | efmd {db-events | errors | merge {errors | events | packets}} | mts-events | pss-events} | errors [vsan vsan-id] | events [vsan vsan-id] | mts-events | pss-events | snmp-events | trace [vsan vsan-id]}
Syntax Description
all efmd db-events merge packets errors vsan vsan-id events mts-events pss-events snmp-events trace
Enables debugging for all fabric binding features. Enables debugging for Exchange Fabric Membership Data (EFMD) protocol. Enables debugging for EFMD protocol database events. Enables debugging for EFMD protocol merges. Enables debugging for EFMD protocol packets. Enables debugging for fabric binding errors. Specifies the VSAN ID. The range is 1 to 4093. Enables debugging for fabric binding events. Enables debugging for fabric binding MTS events. Enables debugging for fabric binding PSS events. Enables debugging for fabric binding SNMP events Enables debugging for fabric binding traces.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.3(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug fabric-binding all command is issued:
switch# debug fabric-binding all
6-23
Chapter 6 debug fabric-binding
Debug Commands
Related Commands Command no debug all show fabric-binding Description Disables all debugging. Displays configured fabric binding information.
6-24
Chapter 6
Debug Commands debug fc-tunnel
debug fc-tunnel
To enable debugging for the Fibre Channel tunnel feature, use the debug fc-tunnel command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fc-tunnel {all | errors | external-events | ha | label-update | mts {pkt | pkthdr} {both | rx | tx} | pss | route-update [vsan vsan-id] | rsvp-messages [tunnel tunnel-id | vsan vsan-id] | state-machine} no debug fc-tunnel {all | errors | external-events | ha | label-update | mts {pkt | pkthdr} {both | rx | tx} | pss | route-update [vsan vsan-id] | rsvp-messages [tunnel tunnel-id | vsan vsan-id] | state-machine}
Syntax Description
all errors external-events ha label-update mts pkt pkthdr both tx rx pss route-update vsan vsan-id rsvp-messages tunnel tunnel-id state-machine node opcode sap range
Enables debugging for all FC tunnel features. Enables debugging for FC tunnel errors. Enables debugging for external FC tunnel events. Enables debugging for FC tunnel high availability (HA) events. Enables debugging for FC tunnel label updates. Enables debugging for FC tunnel MTS events. Specifies debugging of packets. Specifies debugging of headers. Specifies debugging in both the transmit and receive directions. Specifies debugging in the transmit direction. Specifies debugging in the receive direction. Enables debugging for FC tunnel PSS events. Enables debugging for FC tunnel route updates. Specifies the VSAN ID. The range is 1 to 4093. Enables debugging for FC tunnel SNMP events Specifies the tunnel ID. The range is 1 to 255. Enables debugging for FC tunnel traces. Specifies the node for the packets in the receive direction. Specifies the opcode for the packets in the receive direction. Specifies the sap for the packets in the receive direction. Specifies the integer range from 1 to 4096.
Defaults
Disabled.
Command Modes
EXEC mode.
6-25
Chapter 6 debug fc-tunnel
Debug Commands
Command History Release 1.3(2) Modification This command was introduced.
Usage Guidelines
None.
Examples
The following example displays the system output when the debug fc-tunnel all command is issued:
switch# debug fc-tunnel all
Related Commands
Command no debug all show fc-tunnel
Description Disables all debugging. Display configured FC tunnel information.
6-26
Chapter 6
Debug Commands debug fc2
debug fc2
To enable debugging for the FC2 feature, use the debug fc2 command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fc2 {credit | error [fcid fcid [interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] | interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] flag | flow [fcid fcid [interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] | interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] | (interface fc type number | vsan vsan-id) | frame | loopback | pkt {both | tx | rx} [bytes bytes | fcid fcid [bytes bytes | interface {fc slot/port | fcip port} [bytes bytes | pkts pkts [bytes bytes]] | pkts pkts [bytes bytes] | vsan vsan-id [bytes bytes | interface {fc slot/port | fcip port} [bytes bytes | pkts pkts [bytes bytes]]] | pkthdr {both | tx | rx} [bytes bytes | fcid fcid [bytes bytes | interface {fc slot/port | fcip port} [bytes bytes | pkts pkts [bytes bytes]] | pkts pkts [bytes bytes] | vsan vsan-id [bytes bytes | interface {fc slot/port | fcip port} [bytes bytes | pkts pkts [bytes bytes]]] | rdl | rxhdrhistory [fcid fcid [interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] | interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] txhdrhistory [fcid fcid [interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] | interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]]} no debug fc2 {credit | error [fcid fcid [interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] | interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] flag | flow [fcid fcid [interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] | interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] | (interface fc type number | vsan vsan-id) | frame | loopback | pkt {both | tx | rx} [bytes bytes | fcid fcid [bytes bytes | interface {fc slot/port | fcip port} [bytes bytes | pkts pkts [bytes bytes]] | pkts pkts [bytes bytes] | vsan vsan-id [bytes bytes | interface {fc slot/port | fcip port} [bytes bytes | pkts pkts [bytes bytes]]] | pkthdr {both | tx | rx} [bytes bytes | fcid fcid [bytes bytes | interface {fc slot/port | fcip port} [bytes bytes | pkts pkts [bytes bytes]] | pkts pkts [bytes bytes] | vsan vsan-id [bytes bytes | interface {fc slot/port | fcip port} [bytes bytes | pkts pkts [bytes bytes]]] | rdl | rxhdrhistory [fcid fcid [interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] | interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] txhdrhistory [fcid fcid [interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]] | interface {fc slot/port | fcip port} | vsan vsan-id [interface {fc slot/port | fcip port}]]}
6-27
Chapter 6 debug fc2
Debug Commands
Syntax Description credit error fcid fcid interface fc slot/port fcip port vsan vsan-id flag flow frame loopback pkt both tx rx bytes bytes pkts pkts pkthdr rdl rxhdrhistory txhdrhistory Enables FC2 credit debugging. Enables FC2 error debugging. Restricts debugging to the specified FCID. Restricts debugging to the specified interface. Restricts debugging to the specified interface. Restricts debugging to the specified interface. Restricts debugging to the specified VSAN. Enables FC2 flags debugging. Enables FC2 flow debugging. Enables FC2 frame debugging. Enables FC2 loopback debugging. Enables FC packet debugging. Enables debugging in both the transmit and receive directions. Enables debugging in the transmit direction, Enables debugging in the receive direction. Specifies the number of bytes to display. Specifies the number of packets to display. Enables FC header debugging. Enables FC2 RDL debugging. Enables FC2 received header history debugging. Enables FC2 transmitted header history debugging.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
If FSPF receives a bad FC2 packet analyze the output of the debug fc2 pkt command.
Examples
The following example displays the system output when the debug fc2 error vsan 1 command is issued:
switch1# debug fc2 error vsan 1
6-28
Chapter 6
Debug Commands debug fc2
Related Commands Command no debug all show fc2 Description Disables all debugging. Displays FC2 information.
6-29
Chapter 6 debug fc2d
Debug Commands
debug fc2d
To enable debugging for the FC2 feature, use the debug fc2 command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fc2 {all | bypass ficon_mgr | demux [vsan vsan-id] | deque | error | event [vsan vsan-id] | ha [vsan vsan-id] | trace [detail] [vsan vsan-id] | warning [vsan vsan-id]} no debug fc2 {all | bypass ficon_mgr | demux [vsan vsan-id] | deque | error | event [vsan vsan-id] | ha [vsan vsan-id] | trace [detail] [vsan vsan-id] | warning [vsan vsan-id]}
Syntax Description
all bypass ficon_mgr demux vsan vsan-id deque error event ha trace detail warning
Enables all FC2D debug flags. Enables bypassing some components in fc2d execution. Enables bypassing FICON Manager in fc2d execution. Enables debugging of FC2D message demux. Restricts debugging to the specified VSAN. Enables debugging of FC2D message dequeue. Enables debugging of FC2D error. Enables debugging of FC2D FSM and Events. Enables debugging of FC2D HA. Enables debugging of FC2D trace. Enables detailed debugging of FC2D trace. Enables debugging of FC2D warning.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.3(4)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug fc2d all command is issued:
switch1# debug fc2d all 2004 Mar 29 22:57:25 fc2d: fu_fsm_execute_all: match_msg_id(0), log_already_open (0) 2004 Mar 29 22:57:25 fc2d: fu_fsm_execute_all: null fsm_event_list 2004 Mar 29 22:57:25 fc2d: fu_fsm_engine_post_event_processing: mts msg MTS_OPC_ DEBUG_WRAP_MSG(msg_id 6894921) dropped
6-30
Chapter 6
Debug Commands debug fc2d
Related Commands Command debug fc2 no debug all show fc2 Description Enables debugging for the FC2 feature. Disables all debugging. Displays FC2 information.
6-31
Chapter 6 debug fcc
Debug Commands
debug fcc
To enable debugging for the Fibre Channel Congestion (FCC) function, use the debug fcc command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fcc {all | error [module slot] | event [module slot] | mts [pkt {both | rx [node range | opcode range | sap range] | tx} | pkthdr {both | tx | rx [numpkt range]}] | trace [module slot]} no debug fcc {all | error [module slot] | event [module slot] | mts {pkt {both | rx [node range | opcode range | sap range] | tx} | pkthdr {both | tx | rx [numpkt range]}} | trace [module slot]}
Syntax Description
all errors events mts trace module slot pkt pkthdr numpkt both tx rx node opcode sap range
Enables debugging for all FCC features. Enables debugging for FCC error conditions. Enables debugging for FCC events. Enables debugging for FCC tx/rx MTS packets. Enables debugging for FCC traces. Specifies the slot number of the module being debugged. Enables debugging for FCC tx/rx FCC packets. Enables debugging for FCC tx/rx FCC headers. Specifies the number of required packets Specifies debugging in both the transmit and receive directions. Specifies debugging in the transmit direction, Specifies debugging in the receive direction. Specifies the node for the packets in the receive direction. Specifies the opcode for the packets in the receive direction. Specifies the sap for the packets in the receive direction. Specifies the integer range from 1 to 4096.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
6-32
Chapter 6
Debug Commands debug fcc
Examples The following example displays the system output when the debug fcc all command is issued:
switch# debug fcc all
Related Commands
Command no debug all show fcc
Description Disables all debugging. Displays FCC settings.
6-33
Chapter 6 debug fcdomain
Debug Commands
debug fcdomain
To enable debugging for the fcdomain feature, use the debug fcdomain command in EXEC mode.To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fcdomain {all | critical | error | fc {pkt | pkthdr} {both | rx | tx} [interface type number [vsan vsan-id] | vsan vsan-id] | ipc {pkt | pkthdr} {both | rx [node range | opcode range | sap range] | tx} | memory | notify | phase} no debug fcdomain {all | critical | error | fc {pkt | pkthdr} {both | rx | tx} [interface type number [vsan vsan-id] | vsan vsan-id] | ipc {pkt | pkthdr} {both | rx [node range | opcode range | sap range] | tx} | memory | notify | phase}
Syntax Description
all critical error fc fcip port-channel pkt pkthdr both rx interface type number vsan vsan-id tx memory notify phase
Enables debugging of all fcdomain parameters. Enables debugging of critical operations. Enables debugging of error operation. Enables debugging of Fibre Channel packets and headers. Enables debugging of Fibre Channel IP packets and headers. Enables debugging of PortChannel packets and headers. Enables debugging of packets. Enables debugging of headers. Enables debugging in both the transmit and receive directions. Enables debugging in the receive direction. Specifies the interface to be debugged. Restricts debugging to the specified VSAN. Enables debugging in the transmit direction, Enables debugging of memory operations. Enables debugging of notifications Enables debugging of global phases
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
6-34
Chapter 6
Debug Commands debug fcdomain
Examples
The following example displays the system output when the debug fcdomain critical command is issued:
switch# debug fcdomain critical Jan 27 07:04:31 fcdomain: Src: 0x00000501/6243 Dst: 0x00000501/14 ID: 0x0005BF 41 Size: 252 [REQ] Opc: 182 (MTS_OPC_DEBUG_WRAP_MSG) RR: 0x0005BF41 HA_SEQNO: 0x00000000 TS: 0x183C4D027F4A3 Jan 27 07:04:31 fcdomain: 00 00 00 00 68 00 00 00 00 00 00 00 00 00 00 00 Jan 27 07:04:31 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Jan 27 07:04:31 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 FF FF FF FF Jan 27 07:04:31 fcdomain: 2F 64 65 76 2F 70 74 73 2F 30 00 00 00 00 00 00 Jan 27 07:04:31 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ...
The following example displays the system output when the debug fcdomain error command is issued:
switch# debug fcdomain error Jan 27 07:05:29 fcdomain: Src: 0x00000501/6245 Dst: 0x00000501/14 ID: 0x0005BF 7E Size: 252 [REQ] Opc: 182 (MTS_OPC_DEBUG_WRAP_MSG) RR: 0x0005BF7E HA_SEQNO: 0x00000000 TS: 0x183D5E63C081A Jan 27 07:05:29 fcdomain: 00 00 00 00 64 00 00 00 00 00 00 00 00 00 00 00 Jan 27 07:05:29 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Jan 27 07:05:29 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 FF FF FF FF Jan 27 07:05:29 fcdomain: 2F 64 65 76 2F 70 74 73 2F 30 00 00 00 00 00 00 ...
The following example displays the system output when the debug fcdomain ipc pkthdr both command is issued:
vegas2# debug fcdomain ipc pkthdr both Apr 8 20:44:38 fcdomain: Src: 0x00000501/3883 Dst: 0x00000501/14 ID: 0x00038E 1D Size: 252 [REQ] Opc: 182 (MTS_OPC_DEBUG_WRAP_MSG) RR: 0x00038E1D HA_SEQNO: 0x00000000 TS: 0x5DD9B14EA3AA REJ:0 Apr 8 20:44:38 fcdomain: 00 00 00 00 08 00 00 00 00 00 00 00 00 00 00 00 Apr 8 20:44:38 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 8 20:44:38 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 FF FF FF FF Apr 8 20:44:38 fcdomain: 2F 64 65 76 2F 70 74 73 2F 30 00 00 00 00 00 00 Apr 8 20:44:38 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 8 20:44:38 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ... Apr 8 20:44:38 fcdomain: Src: 0x00000501/3883 Dst: 0x00000501/14 ID: 0x00038E 20 Size: 252 [REQ] Opc: 182 (MTS_OPC_DEBUG_WRAP_MSG) RR: 0x00038E20 HA_SEQNO: 0x00000000 TS: 0x5DD9B186CCEB REJ:0 Apr 8 20:44:38 fcdomain: 00 00 00 00 07 00 00 00 00 00 00 00 00 00 00 00 Apr 8 20:44:38 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 8 20:44:38 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 FF FF FF FF Apr 8 20:44:38 fcdomain: 2F 64 65 76 2F 70 74 73 2F 30 00 00 00 00 00 00 Apr 8 20:44:38 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 8 20:44:38 fcdomain: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ...
Related Commands
Command show fcdomain domain-list fcdomain
Description Displays current domains in the fabric. Enables fcdomain features.
6-35
Chapter 6 debug fcfwd
Debug Commands
debug fcfwd
To enable debugging for the Fibre Channel forwarding feature, use the debug fcfwd command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fcfwd {flogimap | idxmap | pcmap | sfib | spanmap} {error | event | trace} [module slot | vsan vsan-id [module slot]] no debug fcfwd {flogimap | idxmap | pcmap | sfib | spanmap} {error | event | trace} [module slot | vsan vsan-id [module slot]]
Syntax Description
flogimap idxmap pcmap sfib spanmap error event trace module slot vsan vsan-id
Enables flogimap debugging. Enables idxmap debugging. Enables pcmap debugging. Enables sfib debugging. Enables spanmap debugging. Enables debugging for FCC error conditions. Enables debugging for FCC events. Enables debugging for FCC traces. Specifies the slot number of the module being debugged. Restricts debugging to the specified VSAN.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug fcfwd error command is issued:
switch# debug fcfwd error
6-36
Chapter 6
Debug Commands debug fcfwd
Related Commands Command no debug all show fcfwd Description Disables all debugging. Displays the configured fcfwd tables and statistics.
6-37
Chapter 6 debug fcns
Debug Commands
debug fcns
To enable debugging for name server registration, use the debug fcns command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fcns {all | errors | events {mts | query | register}} [vsan vsan-id] no debug fcns {all | errors | events {mts | query | register}} [vsan vsan-id]
Syntax Description
all errors events mts query register vsan vsan-id
Enables debugging for all name server features. Enables debugging for name server error conditions. Enables debugging for name server events. Enables debugging for name server tx/rx MTS packets. Enables debugging for name server tx/rx CDP packets. Enables debugging for name server PSS related events. Restricts debugging to the specified VSAN.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug fcns events register vsan 99 command is issued:
switch# debug fcns events register vsan 99 Feb 17 04:42:54 fcns: vsan 99: Got Entry for port-id 27800 Feb 17 04:42:54 fcns: vsan 99: Registered port-name 36a4078be0000021 for port-id 780200 Feb 17 04:42:54 fcns: vsan 99: Registered node-name 36a4078be0000020 for port-id 780200 ...
6-38
Chapter 6
Debug Commands debug fcns
Related Commands Command no debug all show fcns database show fcns statistics Description Disables all debugging. Displays the results of the discovery or the name server database for a specified VSAN or for all VSANs. Displays the statistical information for a specified VSAN or for all VSANs.
6-39
Chapter 6 debug fcs
Debug Commands
debug fcs
To enable debugging for the fabric configuration server, use the debug fcs command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fcs {all | discovery events | errors [vsan vsan-id] | ess-events [vsan vsan-id] | mts events {brief | detail} | pss events | queries events [vsan vsan-id] | registrations events [vsan vsan-id] | rscn events [vsan vsan-id] | snmp events} no debug fcs {all | discovery events | errors [vsan vsan-id] | ess-events [vsan vsan-id] | mts events {brief | detail} | pss events | queries events [vsan vsan-id] | registrations events [vsan vsan-id] | rscn events [vsan vsan-id] | snmp events}
Syntax Description
all discovery events errors mts events pss events brief detail queries events registration events rscn events snmp events vsan vsan-id
Enables debugging for all FCS features. Enables debugging for FCS discovery events. Enables debugging for FCS error conditions. Enables debugging for FCS tx/rx MTS events. Enables debugging for FCS Provides brief information for each event. Provides detailed information for each event. Enables debugging for FCS tx/rx events. Enables debugging for FCS PSS related events. Enables debugging for FCS RSCN events. Enables debugging for FCS SNMP events. Restricts debugging to the specified VSAN.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug fcs all command is issued:
switch# debug fcs all
6-40
Chapter 6
Debug Commands debug fcs
Related Commands Command no debug all show fcs Description Disables all debugging. Displays the status of the fabric configuration.
6-41
Chapter 6 debug fcsp-mgr
Debug Commands
debug fcsp-mgr
To enable debugging for the Fibre Channel Security Protocol (FC-SP) manager, use the debug fcsp-mgr command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fcsp-mgr {all | critical | datastructure | dhchap | error | event-gen | fc2 | fsm | general | ha | init | level1 | level2 | level3 | level4 | level5 | message | mts | notify | trace} no debug fcsp-mgr {all | critical | datastructure | dhchap | error | event-gen | fc2 | fsm | general | ha | init | level1 | level2 | level3 | level4 | level5 | message | mts | notify | trace}
Syntax Description
all critical datastructure dhchap error event-gen fc2 fsm general ha init level1 level2 level3 level4 level5 message mts notify trace
Enables debugging for all FC-SP features. Enables debugging of FC-SP critical errors. Enables debugging of FC-SP data structures. Enables debugging of DHCHAP. Enables debugging of FC-SP error. Enables debugging of FC-SP event generation. Enables debugging of FC-SP FC2 messages. Enables debugging of FC-SP events. Enables general debugging of FC-SP. Enables debugging of FC-SP High Availability Enables debugging of FC-SP Initialization. Sets debugging level of FC-SP Mgr to 1. Sets debugging level of FC-SP Mgr to 2. Sets debugging level of FC-SP Mgr to 3. Sets debugging level of FC-SP Mgr to 4. Set debugging level of FC-SP Mgr to 5. Enables debugging of FC-SP messages. Enables debugging of FC-SP MTS messages. Sets debug level to notify. Enables debugging of FC-SP function enter/exit.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.3(2)
6-42
Chapter 6
Debug Commands debug fcsp-mgr
Examples
The following example displays the system output when the debug fcsp-mgr all command is issued:
switch# debug fcsp-mgr all 2004 Mar 29 23:33:56 fcsp-mgr: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) 2004 Mar 29 23:33:56 fcsp-mgr: fu_fsm_execute_all: null fsm_event_list 2004 Mar 29 23:33:56 fcsp-mgr: fu_fsm_engine_post_event_processing: mts msg MTS_ OPC_DEBUG_WRAP_MSG(msg_id 7061762) dropped
Related Commands
Command no debug all show fcsp
Description Disables all debugging. Displays the status of the FC-SP configuration
6-43
Chapter 6 debug fdmi
Debug Commands
debug fdmi
To enable debugging for the Fabric-Device Management Interface (FDMI) feature, use the debug fdmi command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fdmi {all | errors | fdmi-messages [vsan vsan-id] | ha | mts {pkt {both | rx [node range | opcode range | sap range] | tx} | pkthdr {both | tx | rx [numpkt range]}} | pss | trace} no debug fdmi {all | errors | fdmi-messages [vsan vsan-id] | ha | mts {pkt {both | rx [node range | opcode range | sap range] | tx} | pkthdr {both | tx | rx [numpkt range]}} | pss | trace}
Syntax Description
all errors fdmi-messages ha mts pkt both tx rx node range opcode sap pkthdr numpkt pss trace
Enables debugging for all FDMI features. Enables debugging for FDMI error conditions. Enables the dump of FDMI PDUs. Enables the dump of HA synchronization messages. Enables debugging for FDMI tx/rx MTS events. Enables debugging for FCC tx/rx FCC packets. Specifies debugging in both the transmit and receive directions. Specifies debugging in the transmit direction, Specifies debugging in the receive direction. Specifies the node for the packets in the receive direction. Specifies the integer range from 1 to 4096. Specifies the opcode for the packets in the receive direction. Specifies the sap for the packets in the receive direction. Enables debugging for FCC tx/rx FCC headers. Specifies the number of required packets Enables debugging for FDMI PSSs. Restricts debugging for FDMI traces.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.3(2)
Usage Guidelines
None.
6-44
Chapter 6
Debug Commands debug fdmi
Examples The following example displays the system output when the debug fdmi all command is issued:
switch# debug fdmi all 2005 Mar 10 02:37:28 fdmi: 00 00 00 02 00 00 00 1C 04 19 65 08 00 82 39 08 2005 Mar 10 02:37:28 fdmi: C4 16 65 08 44 19 65 08 E4 87 39 08 04 17 65 08 2005 Mar 10 02:37:28 fdmi: 84 19 65 08 4C 8D 39 08 44 17 65 08 C4 19 65 08 2005 Mar 10 02:37:28 fdmi: B4 92 39 08 00 17 65 08 04 1A 65 08 1C 98 39 08 2005 Mar 10 02:37:28 fdmi: C4 17 65 08 44 1A 65 08 84 9D 39 08 04 18 65 08 2005 Mar 10 02:37:28 fdmi: 84 1A 65 08 EC A2 39 08 44 18 65 08 C4 1A 65 08 2005 Mar 10 02:37:28 fdmi: 54 A8 39 08 84 18 65 08 04 1B 65 08 BC AD 39 08 2005 Mar 10 02:37:28 fdmi: 00 00 00 02 00 00 0B B8 00 00 00 00 00 00 00 00 2005 Mar 10 02:37:28 fdmi: 00 00 00 00 00 00 00 00 00 00 00 00 2005 Mar 10 02:37:28 fdmi: Src: 0x00000601/27 Dst: 0x00000601/105 ID: 0x0069E217 140 [REQ] Opc: 7804 (MTS_OPC_FDMI_SNMP) RR: 0x0069E217 HA_SEQNO: 0x00000000 TS: 0x25218CC5A40E3 REJ:0 SYNC:0
Size:
Related Commands
Command no debug all show fdmi
Description Disables all debugging. Displays the FDMI database information.
6-45
Chapter 6 debug ficon
Debug Commands
debug ficon
To enable debugging for the FI-bre CON-nection (FICON) interface capabilities, use the debug ficon command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug ficon {all | bypass {acl | esa | file | pm | postcheck | precheck} | control-device {all | bypass ficon_mgr | demux [vsan vsan-id] | deque | error | event [vsan vsan-id] | ficon_mgr | ha [vsan vsan-id] | demux [vsan vsan-id] | sb3 {error | flow} trace [detail] [vsan vsan-id] | warning [vsan vsan-id]} | error | event | file-trace | ha | max-port-number ports | pss-trace | stat {all | demux [vsan vsan-id] | deque | error | event [vsan vsan-id] | ha [vsan vsan-id] | trace [detail] [vsan vsan-id] | warning [vsan vsan-id]} | timer | trace} no debug ficon {all | bypass {acl | esa | file | pm | postcheck | precheck} | control-device {all | bypass ficon_mgr | demux [vsan vsan-id] | deque | error | event [vsan vsan-id] | ficon_mgr | ha [vsan vsan-id] | demux [vsan vsan-id] | sb3 {error | flow} trace [detail] [vsan vsan-id] | warning [vsan vsan-id]} | error | event | file-trace | ha | max-port-number port | pss-trace | stat {all | demux [vsan vsan-id] | deque | error | event [vsan vsan-id] | ha [vsan vsan-id] | trace [detail] [vsan vsan-id] | warning [vsan vsan-id]} | timer | trace}
Syntax Description
all bypass acl esa file pm postcheck precheck control-device all bypass ficon_mgr demux deque error event ficon_mgr ha sb3 trace warning error
Enables debugging for all FICON features. Enables bypass flags for FICON error conditions. Bypass ACL manager execution. Bypass ESA execution. Bypass file operations execution. Bypass port manager execution. Bypass post check execution for VSAN enable. Bypass precheck execution for VSAN enable. Enables the dump of FICON control devices. Specifies all debug flags of FICON control device. Bypass FICON Manager. Configure debugging of FICON control device message demux. Configure debugging of FICON control device message deque. Configure debugging of FICON control device error. Configure debugging of FICON control device FSM and Events. Configure debugging of FICON manager control device. Configure debugging of FICON control device HA. Configure debugging of SB3 library. Configure debugging of FICON control device trace. Configure debugging of FICON control device warning. Enables debugging for FICON errors.
6-46
Chapter 6
Debug Commands debug ficon
event file-trace ha max-port-number ports pss-trace stat all demux deque error event ha trace warning timer trace Enables debugging for FICON events. Enables debugging of FICON file flow Enables the debugging of HA synchronization messages. Specifies maximum number of ports. Enables debugging of FICON PSS flow. Enables debugging of FICON statistics. Specifies all debug flags of FICON statistics. Specifies FICON statistics message demux. Specifies FICON statistics message deque. Specifies FICON statistics errors. Specifies FICON statistics FSM and events. Specifies FICON statistics HA. Specifies FICON statistics trace. Specifies FICON statistics warnings Enables debugging of FICON timer messages. Enables debugging of FICON flow.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.3(2)
Usage Guidelines
FICON must be enabled on the switch to use this command.
Examples
The following example displays the system output when the debug ficon all command is issued:
switch# debug ficon all 2005 Mar 10 02:38:58 ficon: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) 2005 Mar 10 02:38:58 ficon: fu_fsm_execute_all: null fsm_event_list 2005 Mar 10 02:38:58 ficon: fu_fsm_engine_post_event_processing: mts msg MTS_OPC_DEBUG_WRAP_MSG(msg_id 6943776) dropped switch# undebug all
Related Commands
Command no debug all show ficon
Description Disables all debugging. Displays configured FICON information.
6-47
Chapter 6 debug flogi
Debug Commands
debug flogi
To enable debugging for the fabric login (FLOGI) feature, use the debug flogi command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug flogi {action [interface type number | vsan vsan-id] | all | bypass {acl | dm | dpvm | fcsp | lcp | npiv | ns | pl | pm | pmvc | rib| vsan_mgr | zs} | demux [interface type number | vsan vsan-id] | error | event [interface type number | vsan vsan-id] | ha [interface type number | vsan vsan-id] | init [interface type number | vsan vsan-id] | timers [interface type number | vsan vsan-id] | trace [interface type number | vsan vsan-id] | warning}
Syntax Description
action all bypass acl dm dpvm fcsp lcp npiv ns pl pm pmvc rib vsan_mgr zs demux error event ha init timer trace warning interface type number vsan vsan-id
Enables all FLOGI debug features. Enables all FLOGI debug options. Bypass some components in FLOGI execution. Bypass ACL execution. Bypass domain manager execution. Bypass DPVM execution. Bypass FCSP execution. Bypass LCP execution. Bypass NPIV execution. Bypass name server execution. Bypass port lock execution. Bypass port manager execution. Bypass PM VSAN change execution. Bypass RIB execution. Bypass VSAN manager execution. Bypass zone server execution. Enables FLOGI demux Enables debugging for FLOGI error conditions. Enables debugging for FLOGI FSMs and events. Enables debugging for FLOGI high availability. Enables debugging of FLOGI addition, deletion, and initialization. Enables debugging for FLOGI message timers Enables debugging for FLOGI traces. Enables debugging for FLOGI warnings. Restricts debugging to the specified interface. Restricts debugging to the specified VSAN.
6-48
Chapter 6
Debug Commands debug flogi
Defaults Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug flogi all command is issued:
switch# debug flogi all Apr 9 22:44:08 flogi: fs_demux: msg consumed by sdwrap_process msg Apr 9 22:44:08 flogi: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) Apr 9 22:44:08 flogi: fu_fsm_execute_all: null fsm_event_list Apr 9 22:44:08 flogi: fu_fsm_engine: mts msg MTS_OPC_DEBUG_WRAP_MSG(msg_id 67690) dropped
The following example displays the system output when the debug flogi event command is issued:
switch# debug flogi event Apr 10 00:07:16 flogi: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) Apr 10 00:07:16 flogi: fu_fsm_execute_all: null fsm_event_list Apr 10 00:07:16 flogi: fu_fsm_engine: mts msg MTS_OPC_DEBUG_WRAP_MSG(msg_id 71314) dropped
The following example displays the system output when the debug flogi trace command is issued:
switch# debug flogi trace Apr 10 00:42:36 flogi: fs_genport_vsan_hash_fn: key: 0x1 index: 0x1 Apr 10 00:42:36 flogi: fs_mts_hdlr_fs_flogo: FLOGI HOLD(0x8122144) refcnt:3 Apr 10 00:42:36 flogi: fs_clear_all_outstanding_responses_for_flogi: FLOGI FREE( a07e00300500252b) refcnt:3
Related Commands
Command no debug all show flogi database
Description Disables all debugging. Displays all the FLOGI sessions through all interfaces across all VSANs.
6-49
Chapter 6 debug fm
Debug Commands
debug fm
To enable feature manager debugging, use the debug fm command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fm {error | flow} no debug fm {error | flow}
Syntax Description
error flow
Enables debugging for feature manager error conditions. Enables debugging for the feature manager flow.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug fm flow command is issued:
switch# debug fm flow switch# 2005 Mar 10 02:40:19 feature-mgr: fm_event_loop: ----------- EVENT START 2005 Mar 10 02:40:19 feature-mgr: fm_event_loop: received MTS message: 2005 Mar 10 02:40:19 feature-mgr: fm_event_loop: Src: 0x00000601/27 Dst: 0x00000601/121 ID: 0x006A0FC4 Size: 160 [REQ] Opc: 8922 (MTS_OPC_FM_CMI_GET_FEATURE_OP) RR: 0x006A0FC4 HA_SEQNO: 0x00000000 TS: 0x2524B48D52B53 REJ:0 SYNC:0 2005 Mar 10 02:40:19 feature-mgr: fm_handle_cmi_get_feature_op: Get feature (1) op request 2005 Mar 10 02:40:19 feature-mgr: fm_handle_cmi_get_feature_op: Reply to get feature ivr op request: op 2, op_state 0, result 0x0 (success) 2005 Mar 10 02:40:19 feature-mgr: fm_event_loop: ----------- EVENT START 2005 Mar 10 02:40:19 feature-mgr: fm_event_loop: received MTS message: 2005 Mar 10 02:40:19 feature-mgr: fm_event_loop: Src: 0x00000601/27 Dst: 0x00000601/121 ID: 0x006A0FC6 Size: 160 [REQ] Opc: 8922 (MTS_OPC_FM_CMI_GET_FEATURE_OP) RR: 0x006A0FC6 HA_SEQNO: 0x00000000 TS: 0x2524B48EBF55D REJ:0 SYNC:0 2005 Mar 10 02:40:19 feature-mgr: fm_handle_cmi_get_feature_op: Get feature (1) op request 2005 Mar 10 02:40:19 feature-mgr: fm_handle_cmi_get_feature_op: Reply to get feature ivr op request: op 2, op_state 0, result 0x0 (success)
6-50
Chapter 6
Debug Commands debug fm
Related Commands Command no debug all Description Disables all debugging.
6-51
Chapter 6 debug fspf
Debug Commands
debug fspf
To enable debugging for the FSPF feature, use the debug fspf command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug fspf {all [interface type number] [vsan vsan-id] | database [interface type number] [vsan vsan-id | error | event [interface type number] [vsan vsan-id] | fc {pkt | pkthdr} {both | tx | rx} [interface type number] [vsan vsan-id] | flood [interface type number] [vsan vsan-id] | ha [interface type number] [vsan vsan-id] | mts {pkt {both | rx [node range | opcode range | sap range] | tx} | pkthdr {both | rx [numpkt range] | tx}} | retrans [interface type number] [vsan vsan-id] | route | timer} no debug fspf {all [interface type number] [vsan vsan-id] | database [interface type number] [vsan vsan-id | error | event [interface type number] [vsan vsan-id] | fc {pkt | pkthdr} {both | tx | rx} [interface type number] [vsan vsan-id] | flood [interface type number] [vsan vsan-id] | ha [interface type number] [vsan vsan-id] | mts {pkt {both | rx [node range | opcode range | sap range] | tx} | pkthdr {both | rx [numpkt range] | tx}} | retrans [interface type number] [vsan vsan-id] | route | timer}
Syntax Description
all database error events fc fc-tunnel fcip fv gigbitethernet slot/port ipc mgmt 0 port-channel sup-fc pkt both
Enables debugging for all FSPF features. Enables debugging for the FSPF database. Enables debugging for FSPF error conditions. Enables debugging for FSPF events. Enables debugging of Fibre Channel packets and headers. Enables debugging of Fibre Channel tunnel interface. Enables debugging of Fibre Channel IP packets and headers. Enables debugging of Fibre Channel Virtualization interface. Specifies the Gigabit Ethernet interface slot and port. Enables debugging of IPC packets and headers. Specifies the management interface. Enables debugging of PortChannel packets and headers. Enables debugging of inband Interface. Enables debugging for FCC tx/rx FCC packets. Specifies debugging in both the transmit and receive directions.
6-52
Chapter 6
Debug Commands debug fspf
tx rx node range opcode sap pkthdr numpkt flood ha mts retrans route timer interface type number vsan vsan-id Specifies debugging in the transmit direction, Specifies debugging in the receive direction. Specifies the node for the packets in the receive direction. Specifies the integer range from 1 to 4096. Specifies the opcode for the packets in the receive direction. Specifies the sap for the packets in the receive direction. Enables debugging for FCC tx/rx FCC headers. Specifies the number of required packets Enables debugging for FSPF flooding events. Enables debugging for FSPF high availability. Enables debugging for FSPF tx/rx MTS events. Enables debugging for FSPF retransmits. Enables debugging for FSPF route computation. Enables debugging for FSPF timers. Restricts debugging to the specified interface. Restricts debugging to the specified VSAN.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
If you receive bad packets on an interface, use the debug fc pkt command. If you receive an error in processing a packet on an interface in VSAN, turn on debug fspf error to get more information. Make sure there is no misconfiguration of FSPF parameters on the two ends of the interface. Also issue the debug fspf fc pkt command for the specific interface. If you receive an error in flooding the local LSR in a VSAN issue the debug fspf flood and debug fspf error commands. If error is reported in transmitting packet check if interface is up and turn on debug fc2 error. If you receive an error in processing a timer event for the interface in a VSAN, issue the debug fspf error command. If you receive an error in processing due to a wrong MTS message, use the debug fspf mts pkt and debug fspf error commands. If you receive an error when interacting with RIB, use the debug fspf route command along with the RIB debug traces.
6-53
Chapter 6 debug fspf
Debug Commands
If you receive an error in computing routes for VSANs, issue the debug fspf error and the debug fspf route commands. If you receive an error due to the interface being stuck in a state other than FULL, use the debug fspf event and debug fspf fc pkt commands on the interfaces involved.
Examples
The following example displays the system output when the debug fspf all command is issued:
switch1# debug fspf all Apr 5 11:50:01 fspf: Wrong hello interval for packet on interface 100f000 in VSAN 1 Apr 5 11:50:04 fspf: Error in processing hello packet , error code = 4
Related Commands
Command no debug all show fspf
Description Disables all debugging. Displays global FSPF information.
6-54
Chapter 6
Debug Commands debug hardware arbiter
debug hardware arbiter

To configures debugging for the hardware arbiter driver, use the debug hardware arbiter command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug hardware arbiter {error | flow} [group number]} no debug hardware arbiter {error | flow} [group number]}
Syntax Description
error flow group number
Enables debugging for hardware arbiter kernel errors. Enables debugging for hardware arbiter kernel flow. Restricts debugging to the specified group. The range is 0 to 17.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug hardware arbiter error group command is issued:
switch# debug hardware arbiter error group 1
Related Commands
Command no debug all show hardware
Description Disables all debugging. Displays switch hardware inventory details.
6-55
Chapter 6 debug idehsd
Debug Commands
debug idehsd
To enable IDE hot swap handler debugging, use the debug idehsd command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug idehsd {cmd dbglevel [debug-level] | error | flow} no debug idehsd {cmd dbglevel [debug-level] | error | flow}
Syntax Description
cmd dbglevel debug-level error flow
Enables debugging for the IDE hot swap handler. Specifies the debug level (0 to 8). Enables debugging for IDE hot swap handler error conditions. Enables debugging for IDE hot swap handler flow.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug idehsd cmd dbglevel command is issued:
switch# debug idehsd cmd dbglevel 5 set debug level to 5 succeeded
Related Commands
6-56
Chapter 6
Debug Commands debug ike
debug ike
To enable debugging for the IKE protocol, use the debug ike command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug ike {all | error | event | message | mts | protocol | verbose | warning} no debug ike {all | error | event | message | mts | protocol | verbose | warning}
Syntax Description
all error event message mts protocol verbose warning
Enables all of the debugging flags for IKE. Enables debugging for IKE errors. Enables debugging for IKE event generation. Enables debugging for IKE messages. Enables debugging for MTS-related IKE activity. Enables debugging for IKE protocol-related handling. Enables verbose debugging for IKE protocol-related handling. Enables debugging for IKE warnings.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, IKE must be enabled using the crypto ike enable command.
Examples
The following example displays the system output when the debug ike all command is issued.
switch# debug ike all
Related Commands
Command no debug all show crypto ike domain ipsec
Description Disables all debugging. Displays IKE protocol information.
6-57
Chapter 6 debug ilc_helper
Debug Commands
debug ilc_helper
To enable ILC helper debugging, use the debug ilc_helper command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug ilc_helper {all | errors | events | info} no debug ilc_helper {all | errors | events | info}
Syntax Description
all errors events info
Enables debugging for all ILC helper features. Enables debugging for ILC helper error conditions. Enables debugging for the ILC helper events. Enables debugging for ILC helper information.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug ilc_helper all command is issued:
switch# debug ilc_helper all For Application :125, sdwrap:mts_send : Broken pipe
Related Commands
6-58
Chapter 6
Debug Commands debug ipacl
debug ipacl
To enable IP access control list (ACL) debugging, use the debug ipacl command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug ipacl {all | error | event | trace} no debug ipacl {all | error | event | trace}
Syntax Description
all error event trace
Enables debugging for all IP ACL features. Enables debugging for IP ACL error conditions. Enables debugging for the IP ACL events. Enables debugging for IP ACL trace.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug ipacl all command is issued:
switch# debug ipacl all
Related Commands
Command no debug all show ip access-list
Description Disables all debugging. Displays the IP access control lists that are currently active.
6-59
Chapter 6 debug ipconf
Debug Commands
debug ipconf
To enable IP configuration debugging, use the debug ipconf command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug ipconf {all | errors | events | info | pss} no debug ipconf {all | errors | events | info | pss}
Syntax Description
Enables debugging for all IP configuration features. Enables debugging for IP configuration error conditions. Enables debugging for IP configuration tx/rx MTS events. Enables debugging for IP configuration information. Enables debugging for IP configuration PSS operations.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug ipconf all command is issued:
switch# debug ipconf all switch# 2005 Mar 10 02:45:30 2005 Mar 10 02:45:30 ipconf: 2005 Mar 10 02:45:30 ipconf: 2005 Mar 10 02:45:30 ipconf: 2005 Mar 10 02:45:30 ipconf: 2005 Mar 10 02:45:30 ipconf: 2005 Mar 10 02:45:30 ipconf: 2005 Mar 10 02:45:30 ipconf: 2005 Mar 10 02:45:30 ipconf: ipconf: Received MTS MTS message received Getting ip addresses Received MTS message MTS message received Getting ip addresses Received MTS message MTS message received Getting ip addresses message opcode 862 source 0x00000601/27 on interface 5000000 opcode 862 source 0x00000601/27 on interface 5000000 opcode 862 source 0x00000601/27 on interface 5000000
Related Commands
6-60
Chapter 6
Debug Commands debug ipfc
debug ipfc
To enable IP over Fibre Channel (IPFC) debugging, use the debug ipfc command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug ipfc {all | errors | events | info | kernel {errors | events}}
Syntax Description
all errors events info kernel
Enables debugging for all IPFC features. Enables debugging for IPFC error conditions. Enables debugging for IPFC tx/rx MTS events. Enables debugging for IPFC information. Enables debugging for IPFC kernel operations.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug ipfc kernel errors command is issued:
switch# debug ipfc kernel errors
Related Commands
6-61
Chapter 6 debug ips
Debug Commands
debug ips
To enable debugging for the IP Storage Services (IPS) module, use the debug ips command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug ips {acl {flow | flow-detail} | all | demux | error | flow {ethernet | fcip} | fsm | ha | init | iscsi {config | config-detail | flow | flow-detail | msgs} | isns {config | config-detail | error | flow | flow-detail | msgs | packet} | show_all | upgrade} no debug ips {acl {flow | flow-detail} | all | demux | error | flow {ethernet | fcip} | fsm | ha | init | iscsi {config | config-detail | flow | flow-detail | msgs} | isns {config | config-detail | error | flow | flow-detail | msgs | packet} | show_all | upgrade}
Syntax Description
acl flow flow-detail all demux error ethernet fcip fsm ha init iscsi config config-detail msgs show_all upgrade
Enables debugging for ACLs. Enables debugging for the IPS flow. Enables detailed debugging for the IPS flow. Enables all IPS debug options. Enables debugging for IPS demux Enables debugging for IPS error conditions. Restricts debugging to the Ethernet flow Restricts debugging to the FCIP flow Enables debugging for IPS FSM and events. Enables debugging for IPS high availability. Enables debugging of IPS addition, deletion, and initialization. Enables debugging of iSCSI. Enables debugging of the iSCSI configuration. Enables detailed debugging of the iSCSI configuration. Enables debugging of the iSCSI messages received and responded. Enables all debugging IPS manager flags. Enables debugging for upgrade.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.1(1)
Usage Guidelines
None.
6-62
Chapter 6
Debug Commands debug ips
Examples The following example displays the system output when the debug ips show_all command is issued:
switch# debug ips show_all IPS Manager: iSCSI Trace Detail debugging is on
Related Commands
Command no debug all show ips stats show ips status
Description Disables all debugging. Displays IP storage statistics. Displays the IP storage status.
6-63
Chapter 6 debug ipsec
Debug Commands
debug ipsec
To enable debugging for IPsec, use the debug ipsec command in EXEC mode.To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug ipsec {all | bypass ficon_mgr | config | config-detail | demux | deque | error | event | flow | flow-detail | ha | trace [detail] | warning} no debug ipsec {all | bypass ficon_mgr | config | config-detail | demux | deque | error | event | flow | flow-detail | ha | trace [detail] | warning}
Syntax Description
all bypass ficon_mgr config config-detail demux deque error event flow flow-detail ha trace detail warning
Enables all IPsec debugging. Bypasses the FICON manager. Enables debugging for IPsec configuration. Enables debugging for detailed IPsec configuration. Enables debugging for IPsec message demux. Enables debugging for IPsec message dequeue. Enables debugging for IPsec errors. Enables debugging for IPsec FSM and events. Enables debugging for IPsec flow. Enables debugging for detailed IPsec flow. Enables debugging for IPsec high availability. Enables debugging for IPsec trace. Specifies detailed trace. Enables debugging for IPsec warning.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, IPsec must be enabled using the crypto ipsec enable command.
Examples
The following example displays the system output when the debug ipsec config command is issued.
switch# debug ipsec config
6-64
Chapter 6
Debug Commands debug ipsec
Related Commands Command crypto ipsec enable no debug all Description Enables IPsec. Disables all debugging.
6-65
Chapter 6 debug isns
Debug Commands
debug isns
To enable debugging for Internet storage name services (iSNS), use the debug isns command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug isns {all | bypass ficon_mgr | cloud | db | deque | error | event [vsan vsan-id] | fabric distribute | ha [vsan vsan-id] | prot | trace [detail] | warning [vsan vsan-id]} no debug isns {all | bypass ficon_mgr | cloud | db | deque | error | event [vsan vsan-id] | fabric distribute | ha [vsan vsan-id] | prot | trace [detail] | warning [vsan vsan-id]}
Syntax Description
all bypass ficon_mgr cloud db deque error event vsan vsan-id fabric distribute ha prot trace detail warning
Enables all iSNS debugging. Enables bypassing FICON manager execution. Enables debugging for iSNS cloud discovery. Enables debugging for iSNS database. Enables debugging for iSNS message dequeue. Enables debugging for iSNS error. Enables debugging for iSNS event. Restricts debugging to the specified VSAN ID. The range is 1 to 4093. Enables debugging for iSNS fabric distribution. Enables debugging for iSNS high availability. Enables debugging for iSNS protocol. Enables debugging for iSNS trace. Enables detailed iSNS trace. Enables debugging for iSNS warning.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, iSNS must be enabled using the isns-server enable command.
Examples
The following example displays the system output when the debug isns error command is issued.
switch# debug isns error
6-66
Chapter 6
Debug Commands debug isns
Related Commands Command isns-server enable no debug all show isns Description Enables the iSNS server. Disables all debugging. Displays iSNS information.
6-67
Chapter 6 debug ivr
Debug Commands
debug ivr
To enable debugging for inter-VSAN routing (IVR), use the debug ivr command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug {all | demux | dep | dep-detail | dequeue | drav-fsm | drav-fsm-detail | errors | fcid-rewrite | fcid-rewrite-detail | ha | pnat | pv | pv-detail | state-machine [vsan vsan-id] | test | trace | trace-detail | tu-fsm | tu-fsm-detail | zone-distrib-errors | zone-distrib-events | zone-fsm | zone-fsm-detail} no debug {all | demux | dep | dep-detail | dequeue | drav-fsm | drav-fsm-detail | errors | fcid-rewrite | fcid-rewrite-detail | ha | pnat | pv | pv-detail | state-machine [vsan vsan-id] | test | trace | trace-detail | tu-fsm | tu-fsm-detail | zone-distrib-errors | zone-distrib-events | zone-fsm | zone-fsm-detail}
Syntax Description
all demux dep dep-detail dequeue drav-fsm drav-fsm-detail errors fcid-rewrite fcid-rewrite-detail ha pnat pv pv-detail state-machine vsan vsan-id test trace trace-detail tu-fsm tu-fsm-detail zone-distrib-errors zone-distrib-events zone-fsm zone-fsm-detail
Enables all filters for IVR debugging. Enables debugging of IVR event demultiplexing. Enables debugging of IVR DEP. Enables debugging of IVR DEP detail. Enables debugging of IVR event dequeue. Enables debugging of IVR DRAV finite state machine (FSM). Enables debugging of IVR DRAV FSM detail. Enables debugging for IVR errors. Enables debugging of IVR FC ID rewrite. Enables debugging of IVR FC ID rewrite detail. Enables debugging of IVR high-availability. Enables debugging of IVR payload Network Address Translation (NAT). Enables debugging of IVR PV state machine. Enables debugging of IVR PV state machine detail. Enables debugging of FSM. Restricts debugging to the specified VSAN. Enables debugging of IVR test features. Enables debugging of IVR trace. Enables debugging of IVR detail trace. Enables debugging of IVR TU FSM. Enables debugging of IVR TU FSM detail. Enables debugging of IVR zone distribution errors. Enables debugging of IVR zone distribution events. Enables debugging of IVR zone FSM. Enables debugging of IVR zone FSM detail.
Defaults
Disabled.
6-68
Chapter 6
Debug Commands debug ivr
Command Modes EXEC mode.
Command History
Release 2.1(1)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug ivr all command is issued:
switch# debug ivr all 2005 Mar 10 01:27:27 ivr: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) 2005 Mar 10 01:27:27 ivr: fu_fsm_execute_all: null fsm_event_list 2005 Mar 10 01:27:27 ivr: fu_fsm_engine_post_event_processing: mts msg MTS_OPC_DEBUG_WRAP_MSG(msg_id 6774251) dropped
Related Commands
Command no debug all show ivr
Description Disables all debugging. Displays IVR configurations.
6-69
Chapter 6 debug klm
Debug Commands
debug klm
To enable kernel loadable module parameter debugging, use the debug klm command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug klm {fc2 {cpuhog seconds | flag flags} | scsi-target {driver | error [vsan vsan-id] [fcid fc-id] | flag flags | flow [vsan vsan-id] [fcid fc-id] | snmp | syscall} | sdip {all | error | flow | warning}} no debug klm {fc2 {cpuhog seconds | flag flags} | scsi-target {driver | error [vsan vsan-id] [fcid fc-id] | flag flags | flow [vsan vsan-id] [fcid fc-id] | snmp | syscall} | sdip {all | error | flow | warning}}
Syntax Description
fc2 cpuhog seconds flag flags scsi-target driver error vsan vsan-id fcid fc-id flow snmp syscall sdip all flow warning
Enables debugging for FC2 driver debug parameters. Specify the FC2 CPU hog value. The ranges is 0 to 10000 seconds. Specify the flag values. The ranges is 0x0 to 0xffffffff. Enables debugging for the SCSI target driver. Enables debugging for SCSI target driver flags. Enables debugging for driver error conditions. Restricts debugging to the specified VSAN. Restricts debugging to the specified FCID interface. Enables debugging for SCSI target flow. Enables debugging for SCSI target SNMP requests. Enables debugging for SCSI target system call request. Enables debugging for the SDIP driver. Enables debugging for the SCSI target driver. Enables debugging for driver flow. Enables debugging for driver warnings.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
6-70
Chapter 6
Debug Commands debug klm
Examples The following example displays the system output when the debug klm scsi-target driver command is issued:
switch# debug klm scsi-target driver
Related Commands
6-71
Chapter 6 debug license
Debug Commands
debug license
To enable licensing debugging, use the debug license command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug license {all | errors | event s | mts} no debug license {all | errors | events | mts}
Syntax Description
all errors events mts
Enables debugging for all licensing features. Enables debugging for licensing error conditions. Enables debugging for the licensing events. Enables debugging for Tx/Rx packets of MTS.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug license all command is issued:
switch# debug license all
Related Commands
Command no debug all show license
Description Disables all debugging. Displays license information.
6-72
Chapter 6
Debug Commands debug logfile
debug logfile
To direct the output of the debug commands to a specified file, use the debug logfile command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug logfile filename [size bytes]
Syntax Description
filename size bytes
Assigns the name of the log file. Maximum length is 80 characters. Specifies the logfile size in bytes. The range is 4096 to 4194304.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
Use this command to log debug messages to a special log file. This file is more secure and easier to process than sending the debug output to the console. When you use the debug logfile command to create a log file, the file is automatically created in the log: directory on the supervisor module unless you specify a different path. For example, using the debug logfile command to created a log file named captureDebug, you must enter the dir log://sup-local/? command to find the log file you created. Following example shows you how to find the log file created.
switch# debug logfile captureDebug switch# dir log://sup-local/? log: Enter URL "log:[//<module-number>]/<filename>" log://sup-local/dmesg log://sup-local/messages log://sup-local/captureDebug switch# dir log://sup-local/
Examples
The following example redirects the output of the debug commands to the file named sample.
switch# debug logfile sample
The following example assigns the log file size for the file named sample.
switch# debug logfile sample size 410000
6-73
Chapter 6 debug logfile
Debug Commands
Related Commands Command no debug all show logging Description Disables all debugging. Displays the current message logging configuration.
6-74
Chapter 6
Debug Commands debug mcast
debug mcast
To enable debugging for multicast definitions, use the debug mcast command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug mcast {all | error [vsan vsan-id] [interface fc slot/port] | event [vsan vsan-id] [interface fc slot/port] | mts {pkt {both | rx [node range | opcode range | sap range] | tx} | pkthdr {both | rx [numpkt range] | tx}} | trace [vsan vsan-id] [interface fc slot/port]] no debug mcast {all | error [vsan vsan-id] [interface fc slot/port] | event [vsan vsan-id] [interface fc slot/port] | mts {pkt {both | rx [node range | opcode range | sap range] | tx} | pkthdr {both | rx [numpkt range] | tx}} | trace [vsan vsan-id] [interface fc slot/port]]
Syntax Description
all error event mts trace vsan vsan-id interface fc slot/port pkt pkthdr numpkt both tx rx node opcode sap range
Enables debugging for all multicast definitions. Enables debugging for multicast errors. Enables debugging for multicast events. Enables debugging for multicast tx/rx MTS events. Enables debugging for multicast traces. Restricts debugging to the specified VSAN. Restricts debugging to the specified interface. Specifies debugging of packets. Specifies debugging of headers. Specifies the number of required packets Specifies debugging in both the transmit and receive directions. Specifies debugging in the transmit direction, Specifies debugging in the receive direction. Specifies the node for the packets in the receive direction. Specifies the opcode for the packets in the receive direction. Specifies the sap for the packets in the receive direction. Specifies the integer range from 1 to 4096.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
6-75
Chapter 6 debug mcast
Debug Commands
Examples The following example displays the system output when the debug mcast all command is issued:
switch# debug mcast all
Related Commands
Command no debug all show mcast
Description Disables all debugging. Displays multicast information.
6-76
Chapter 6
Debug Commands debug mip
debug mip
To enable debugging for multiple IP (MIP) kernel drivers, use the debug mip command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug mip {errors | events} no debug mip {errors | events}
Syntax Description
errors events
Enables debugging for MIP error conditions. Enables debugging for MIP events.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug mip errors command is issued:
switch# debug mip errors
Related Commands
6-77
Chapter 6 debug module
Debug Commands
debug module
To enable debugging for switching or service modules, use the debug module command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug module {all | error [module slot] | event | ha | no-powerdown | trace [module slot]} no debug module {all | error [module slot] | event | ha | no-powerdown | trace [module slot]}
Syntax Description
all error event ha no-powerdown trace module slot
Enables debugging for all module features. Enables debugging for module error conditions. Enables debugging for module events. Enables debugging for a modules high availability features. Disables the power cycle feature for the module. Enables debugging for a modules trace flows. Restricts debugging to the specified module.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug module all command is issued:
switch# debug module all 2005 Mar 10 02:51:01 module: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) 2005 Mar 10 02:51:01 module: fu_fsm_execute_all: null fsm_event_list 2005 Mar 10 02:51:01 module: fu_fsm_engine_post_event_processing: mts msg MTS_OPC_DEBUG_WRAP_MSG(msg_id 6986564) dropped
Related Commands
Command no debug all show module
Description Disables all debugging. Displays the status of a module.
6-78
Chapter 6
Debug Commands debug ntp
debug ntp
To enable debugging for the Network Time Protocol (NTP) module, use the debug ntp command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug ntp {errors | info} no debug ntp {errors | info}
Syntax Description
errors info
Enables debugging for NTP error conditions. Enables debugging for NTP information and events.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug ntp info command is issued:
switch# debug ntp info 2005 Mar 10 03:00:42 ntp: Dropping msg_ref with rr_token [7002722]
Related Commands
Command no debug all show ntp
Description Disables all debugging. Displays the configured NTP server and peer associations.
6-79
Chapter 6 debug platform
Debug Commands
debug platform
To enable debugging for the platform manager, use the debug platform command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug platform {all [fc_id fc-id] | error [module slot] | flow [module slot] | fsm | ha | hitless | mts {pkt | pkthdr} {tx | rx} | nopowerdown | supervisor-reset} no debug platform {all [fc_id fc-id] | error [module slot] | flow [module slot] | fsm | ha | hitless | mts {pkt | pkthdr} {tx | rx} | nopowerdown | supervisor-reset}
Syntax Description
all error flow fsm ha hitless mts nopowerdown supervisor-reset fcid f c-id pkt pkthdr tx rx
Enables debugging for all platform features. Enables debugging for platform-related error conditions. Enables debugging for platform-related flows. Enables debugging for platform-related FSMs. Enables debugging for platform-related high availability. Enables the platform loading feature while the switch is in hitless mode. Enables debugging for platform-related tx/rx MTS events. Enables powering down modules Resets the local supervisor. Restricts debugging to the specified FC ID module number. The range is 0 to 2147483647. Enables debugging of packets. Enables debugging of headers. Enables debugging in the transmit direction, Enables debugging in the receive direction.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
6-80
Chapter 6
Debug Commands debug platform
Examples The following example displays the system output when the debug platform all command is issued:
switch# debug platform all 2005 Mar 10 03:01:56 platform: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) 2005 Mar 10 03:01:56 platform: fu_fsm_execute_all: null fsm_event_list 2005 Mar 10 03:01:56 platform: fu_fsm_engine_post_event_processing: mts msg MTS_OPC_DEBUG_WRAP_MSG(msg_id 7004045) dropped v-185# 2005 Mar 10 03:01:56 platform: env_chg_none: ps 0 old 1 new 1 2005 Mar 10 03:01:57 platform: env_chg_none: ps 0 old 1 new 1 2005 Mar 10 03:01:58 platform: env_chg_none: ps 0 old 1 new 1 v-185# debug platform all 2005 Mar 10 03:01:59 platform: fu_priority_select: - setting fd[7] for select call 2005 Mar 10 03:01:59 platform: fu_priority_select_select_queue: round credit(5) 2005 Mar 10 03:01:59 platform: curr_q - FU_PSEL_Q_CAT_CQ, usr_q_info(0), priority(1), credit(0), empty 2005 Mar 10 03:01:59 platform: fu_priority_select: returning FU_PSEL_Q_CAT_FD queue, fd(7), usr_q_info(1) 2005 Mar 10 03:01:59 platform: fu_fsm_engine: line[2139] .
Related Commands
6-81
Chapter 6 debug port
Debug Commands
debug port
To enable debugging for ports, use the debug port command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug port {all | bypass {acl_manager | domain_manager | fcsp | ficon | fport_server | lcp | loopback_diag | port_channel_mgr | port_lock | qos_mgr | span | switch_wwn | vsan_mgr | wwn_mgr |xbar_mgr | zone_server} | error | event [interface type number | module slot] | ha [interface type number | module slot] | trace [interface type number | module slot]} no debug port {all | bypass {acl_manager | domain_manager | fcsp | ficon | fport_server | lcp | loopback_diag | port_channel_mgr | port_lock | qos_mgr | span | switch_wwn | vsan_mgr | wwn_mgr | xbar_mgr | zone_server} | error | event [interface type number | module slot] | ha [interface type number | module slot] | trace [interface type number | module slot]}
Syntax Description
all bypass error event ha trace acl_manager domain_manager fcsp ficon fport_server lcp loopback_diag port_channel_mgr port_lock qos_mgr span switch_wwn vsan_mgr wwn_mgr xbar_mgr zone_mgr interface type number module slot
Enables all port debug options. Bypasses some components in port execution. Enables debugging for port error conditions. Enables debugging for port FSMs and events. Enables debugging for port high availability. Enables debugging for port traces. Bypasses ACL manager execution. Bypasses domain manager execution. Bypasses FCSP execution. Bypasses FICON execution. Bypasses FPort server execution. Bypasses LCP execution. Bypasses loopback diagnostics execution. Bypasses PortChannel manager execution. Bypasses port lock execution. Bypasses QOS manager execution. Bypasses SPAN execution. Bypasses using switch WWN and uses VSAN WWN in ELP. Bypasses VSAN manager execution. Bypasses WWN manager execution. Bypasses XBAR manager execution. Bypasses zone manager execution. Restricts debugging to the specified interface. Restricts debugging to the specified module.
Defaults
Disabled.
6-82
Chapter 6
Debug Commands debug port
Command Modes EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug port all command is issued:
switch# debug port all Apr 10 00:49:38 port: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) Apr 10 00:49:38 port: fu_fsm_execute_all: null fsm_event_list Apr 10 00:49:38 port: fu_fsm_engine: mts msg MTS_OPC_DEBUG_WRAP_MSG(msg_id 40239) dropped
The following example displays the system output when the debug port event command is issued:
switch# debug port event Apr 10 15:30:35 port: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) Apr 10 15:30:35 port: fu_fsm_execute_all: null fsm_event_list Apr 10 15:30:35 port: fu_fsm_engine: mts msg MTS_OPC_DEBUG_WRAP_MSG(msg_id 7002) dropped switch# Apr 10 15:30:35 port: fu_priority_select: - setting fd[3] for select call setting fd[5] for select call - setting fd[6] for select call Apr 10 15:30:35 port: fu_priority_select_select_queue: round credit(16) Apr 10 15:30:35 port: curr_q - FU_PSEL_Q_CAT_FD, usr_q_info(32), fd(5), priority(3), credit(2), empty Apr 10 15:30:35 port: fu_priority_select: returning FU_PSEL_Q_CAT_MTS queue, fd(3), usr_q_info(8)
Related Commands
6-83
Chapter 6 debug port-channel
Debug Commands
debug port-channel
To enable debugging for PortChannels, use the debug port-channel command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug port-channel {all | error | event | ha | trace | warning} no debug port-channel {all | error | event | ha | trace | warning}
Syntax Description
all demux deque error event ha trace warning
Enables all PortChannel debug options. Enables debugging of PortChannel messages. Enables debugging of PortChannel message dequeues. Enables debugging for PortChannel error conditions. Enables debugging for PortChannel FSMs and events. Enables debugging for PortChannel high availability. Enables debugging for PortChannel traces. Enables debugging for PortChannel warning.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug port-channel all command is issued:
switch# debug port-channel all 2005 Mar 10 03:03:26 port_channel: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) 2005 Mar 10 03:03:26 port_channel: fu_fsm_execute_all: null fsm_event_list 2005 Mar 10 03:03:26 port_channel: fu_fsm_engine_post_event_processing: mts msg MTS_OPC_DEBUG_WRAP_MSG(msg_id 7005958) dropped
Related Commands
Command no debug all show port-channel
Description Disables all debugging. Displays information about existing PortChannel configurations.
6-84
Chapter 6
Debug Commands debug qos
debug qos
To enable debugging for quality of service (QoS), use the debug qos command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug qos {all [interface fc slot/port] | detail | errors supervisor | flow | trace} no debug qos {all [interface fc slot/port] | detail | errors supervisor | flow | trace}
Syntax Description
all interface fc slot/port detail errors supervisor flow trace
Enables all QoS debug options. Restricts debugging to the specified interface. Enables all QoS debug output. Enables debugging for supervisor QoS error conditions. Enables flow-level QoS debug options. Enables debugging for QoS traces.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug qos all command is issued:
switch# debug qos all
Related Commands
Command no debug all show qos
Description Disables all debugging. Displays the current QoS settings along with a the number of frames marked high priority.
6-85
Chapter 6 debug radius
Debug Commands
debug radius
To enable debugging for boot variables, use the debug radius command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug radius {aaa-request | aaa-request-lowlevel | all | config | config-lowlevel} no debug radius {aaa-request | aaa-request-lowlevel | all | config | config-lowlevel}
Syntax Description
aaa-request aaa-request-lowlevel all config config-lowlevel
Enables RADIUS AAA request debug. Enables RADIUS AAA request low-level debugging. Enables Enable all the debug flags. Enables RADIUS configuration debugging. Enables RADIUS configuring low-level debugging.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.3(1)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug radius config-lowlevel command is issued:
switch# debug radius config-lowlevel Nov 20 06:36:42 radius: radius_new_debug_conf_open: entering... Nov 20 06:36:42 radius: radius_new_conf_close: entering... Nov 20 06:36:42 radius: radius_new_conf_close: returning 0 Nov 20 06:36:42 radius: radius_new_enable_info_config: entering for Radius Daemon debug Nov 20 06:36:42 radius: radius_new_debug_conf_open: entering... Nov 20 06:36:42 radius: radius_new_debug_conf_open: exiting Nov 20 06:36:42 radius: radius_new_enable_info_config: SET_REQ for Radius Daemon debug with 1 Nov 20 06:36:42 radius: radius_new_enable_info_config: SET_REQ done for Radius Daemon debug with 1 Nov 20 06:36:42 radius: radius_new_enable_info_config: got back the return value of configuration operation:success Nov 20 06:36:42 radius: radius_new_debug_conf_close: entering... Nov 20 06:36:42 radius: radius_new_debug_conf_close: returning 0 Nov 20 06:36:42 radius: radius_new_enable_info_config: exiting for Radius Daemon debug
6-86
Chapter 6
Debug Commands debug radius
Related Commands Command no debug all show radius Description Disables all debugging. Displays the RADIUS Cisco Fabric Services (CFS) distribution status and other details.
6-87
Chapter 6 debug rd-reg
Debug Commands
debug rd-reg
To enable debugging for the list of devices using the read-register feature, use the debug rd-reg command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug rd-reg [device-name | register address]
Syntax Description
device-name register address
Specifies the device name for the required device. Specifies the register address for the required device.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug rd-reg abc command is issued:
switch# debug rd-reg abc
Related Commands
6-88
Chapter 6
Debug Commands debug rdl errors
debug rdl errors

To enable debugging for RDL errors, use the debug rdl errors command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug rdl errors
Syntax Description
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug rdl errors command is issued:
switch# debug rdl errors
Related Commands
6-89
Chapter 6 debug rib
Debug Commands
debug rib
To enable debugging for the routing information base (RIB) feature, use the debug rib command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug rib {all | error | event | trace}
Syntax Description
all detail error event trace
Enables debugging for all RIB features. Enables detailed debugging for all RIB features. Enables debugging for RIB errors. Enables debugging for RIB events. Enables debugging for trace events.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
If a RIB operation is ignored or not supported, then issue the debug rib all command to find out more details.
Examples
The following example displays the system output when the debug rib error command is issued:
switch# debug rib error
Related Commands
6-90
Chapter 6
Debug Commands debug rlir
debug rlir
To enable Registered Link Incident Report (RLIR) debugging, use the debug rlir command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug rlir {all | errors | events | mts-errors | mts-events} no debug rlir {all | errors | events | mts-errors | mts-events}
Syntax Description
all errors events mts-errors mts-events
Enables debugging for all RLIR features. Enables debugging for RLIR error conditions. Enables debugging for the RLIR events. Enables debugging for MTS error conditions. Enables debugging for MTS events.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug rlir all command is issued:
switch# debug rlir all
Related Commands
Command no debug all show rlir
Description Disables all debugging. Displays information about RLIR, Link Incident Record Registration (LIRR), and Distribute Registered Link Incident Record (DRLIR) frames.
6-91
Chapter 6 debug rscn
Debug Commands
debug rscn
To enable debugging for the registered state change notification (RSCN) feature, use the debug rscn command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug rscn {all | errors | events | mts-errors | mts-events} [vsan vsan-id] no debug rscn {all | errors | events | mts-errors | mts-events} [vsan vsan-id]
Syntax Description
all errors events mts-errors mts-events vsan vsan-id
Enables debugging for all RSCN features. Enables debugging for RSCN errors. Enables debugging for RSCN events. Enables debugging for RSCN MTS errors. Enables debugging for RSCN MTS events. Restricts debugging to the specified VSAN.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug rscn errors command is issued:
switch# debug rscn errors
Related Commands
Command no debug all show rscn
Description Disables all debugging. Displays RSCN information.
6-92
Chapter 6
Debug Commands debug san-ext-tuner
debug san-ext-tuner
To enable debugging for SAN extension tuner, use the debug san-ext-tuner command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug isns {all | demux | deque | error | event | ha | trace [detail] | warning} no debug isns {all | bypass ficon_mgr | demux | deque | error | event | ha | trace [detail] | warning}
Syntax Description
all demux deque error event ha trace detail warning
Enables all SAN extension tuner debugging. Enables debugging for SAN extension tuner message demux. Enables debugging for SAN extension tuner message dequeue. Enables debugging for SAN extension tuner error conditions. Enables debugging for SAN extension tuner events. Enables debugging for SAN extension tuner high availability. Enables debugging for SAN extension tuner trace. Enables detailed debugging for SAN extension tuner trace. Enables debugging for SAN extension tuner warnings.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug san-ext-tuner error command is issued.
switch# debug san-ext-tuner error
6-93
Chapter 6 debug san-ext-tuner
Debug Commands
Related Commands Command isns-server enable no debug all show isns show san-ext-tuner Description Enables the iSNS server. Disables all debugging. Displays iSNS information. Displays SAN extension tuner information.
6-94
Chapter 6
Debug Commands debug scsi-flow
debug scsi-flow
To enable debugging of a SCSI flow, use the debug scsi-flow command. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug scsi-flow {all | demux vsan vsan-id | deque | error | event vsan vsan-id | ha | trace {detail vsan vsan-id | vsan vsan-id} | warning vsan vsan-id} no debug scsi-flow {all | demux vsan vsan-id | deque | error | event vsan vsan-id | ha | trace {detail vsan vsan-id | vsan vsan-id} | warning vsan vsan-id}
Syntax Description
all demux deque error event ha trace detail warning vsan vsan-id
Enables all debug flags for all SCSI flows. Enables debugging for SCSI flow demux functions. Enables debugging for SCSI flow deque events. Enables debugging for SCSI flow errors. Enables debugging for SCSI flow events. Enables debugging for SCSI flow high availability events. Enables debugging for SCSI flow traces. Enables debugging of SCSI flow detail trace. Enables debugging for SCSI flow warning messages. Restricts debugging to the specified VSAN. The range is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(2)
Usage Guidelines
None.
Examples
The following example enables all debug flags for all SCSI flows.
switch# debug scsi-flow all 2004 Nov 29 17:24:49 sfm: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) 2004 Nov 29 17:24:49 sfm: fu_fsm_execute_all: null fsm_event_list 2004 Nov 29 17:24:49 sfm: fu_fsm_engine_post_event_processing: mts msg MTS_OPC_DEBUG_WRAP_MSG(msg_id 536440) dropped switch#
6-95
Chapter 6 debug scsi-flow
Debug Commands
Related Commands Command no debug all show scsi-flow Description Disables all debugging. Displays SCSI flow information.
6-96
Chapter 6
Debug Commands debug scsi-target
debug scsi-target
To enable debugging for SCSI targets, use the debug scsi-target command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug scsi-target {error | flow} no debug scsi-target {error | flow}
Syntax Description
error flow
Enables debugging for SCSI target daemon error conditions. Enables debugging for the SCSI target flow.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.1(1)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug scsi-target flow command is issued:
switch# debug scsi-target flow Apr 28 21:11:52 vhbad: vhba_mts_handler: sdwrap_dispatch: retval:0 Apr 28 21:11:54 vhbad: vhbad_handle_timeout: timer:1 context:(nil) Apr 28 21:12:06 vhbad: vhba_mts_handler: sysmgr_dispatch: retval:-1
Related Commands
Command no debug all show scsi-target
Description Disables all debugging. Displays information about existing SCSI target configurations.
6-97
Chapter 6 debug security
Debug Commands
debug security
To enable debugging for the security and accounting features, use the debug security command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug security {all | events | mts | radius} no debug security {all | events | mts | radius}
Syntax Description
all events mts radius
Enables debugging for all security features. Enables debugging for security events. Enables debugging for security MTS packets. Enables debugging for RADIUS events.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug security radius command is issued:
switch# debug security radius Mar 5 00:51:13 securityd: RADIUS is enabled, hence it will be tried first for CHAP authentication Mar 5 00:51:13 securityd: reading RADIUS configuration Mar 5 00:51:13 securityd: opening radius configuration for group:default Mar 5 00:51:13 securityd: opened the configuration successfully Mar 5 00:51:13 securityd: GET request for RADIUS global config Mar 5 00:51:13 securityd: got back the return value of global radius configuration operation:success Mar 5 00:51:13 securityd: closing RADIUS pss configuration Mar 5 00:51:13 securityd: opening radius configuration for group:default
Related Commands
6-98
Chapter 6
Debug Commands debug sensor
debug sensor
To enable debugging for the sensor manager, use the debug sensor command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug sensor {demux | deque | error | info | init} no debug sensor {demux | deque | error | info | init}
Syntax Description
demux deque error info init
Enables debugging for sensor demux functions. Enables debugging for sensor deque events. Enables debugging for sensor errors. Enables debugging for sensor information. Enables debugging for sensor initialization.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
Use this command to debug sensor manager events and information.
Examples
The following example displays the system output when the debug sensor info command is issued:
switch# debug sensor info
Related Commands
Command no debug all show environment temperature
Description Disables all debugging. Displays current temperature threshold settings and state.
6-99
Chapter 6 debug snmp
Debug Commands
debug snmp
To enable debugging for the SNMP manager, use the debug snmp command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug snmp { all | errors | mts {pkt {both | rx [node range | opcode range | sap range] | tx} | pkthdr {both | rx [numpkt range] | tx}} | pkt-dump | trace {trace-entryexit | trace-stub}} no debug snmp { all | errors | mts {pkt {both | rx [node range | opcode range | sap range] | tx} | pkthdr {both | rx [numpkt range] | tx}} | pkt-dump | trace {trace-entryexit | trace-stub}}
Syntax Description
all errors mts pkt-dump trace pkt pkthdr both tx rx node opcode sap numpkt range trace-entryexit trace-stub
Enables debugging for all SNMP output. Enables debugging for SNMP error output. Enables debugging for SNMP packets and headers. Enables a packet dump of debug output. Enables trace level debug output. Specifies debugging of packets. Specifies debugging of headers. Specifies debugging in both the transmit and receive directions. Specifies debugging in the transmit direction. Specifies debugging in the receive direction. Specifies the node for the packets in the receive direction. Specifies the opcode for the packets in the receive direction. Specifies the sap for the packets in the receive direction. Specifies the number of required packets Specifies the integer range from 1 to 4095. Specifies trace-level entry or exit debug output. Specifies trace-level stub debug output.
Defaults
Disabled.
Command Modes
EXEC mode.
6-100
Chapter 6
Debug Commands debug snmp
Usage Guidelines
None.
Examples
The following example displays the system output when the debug snmp trace command is issued:
switch# debug snmp trace Apr 29 16:03:34 snmpd[1177]: SDWRAP message Successfully processed
Related Commands
Command no debug all show snmp snmp-server snmp-server enable traps
Description Disables all debugging. Displays SNMP status and setting information. Configures the SNMP server information, switch location, and switch name. Enables SNMP server notifications (informs and traps).
6-101
Chapter 6 debug span
Debug Commands
debug span
To enable SPAN debugging, use the debug span command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug span {all | buffer-size bytes | error | event | trace | warning} no debug span {all | error | event | trace | warning}
Syntax Description
all buffer-size bytes error event ha lib trace warning
Enables debugging for all SPAN features. Configures event logs buffer size for SPAN. The range is 4096 to 131072. Enables debugging for SPAN errors. Enables debugging for SPAN events. Enables debugging for SPAN HA. Enables debugging for SPAN library. Enables debugging for SPAN traces. Enables debugging for SPAN warning messages.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug span all command is issued:
switch# debug span all Apr 29 16:06:44 span: span_demux: msg consumed by sdwrap_process msg Apr 29 16:06:44 span: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) Apr 29 16:06:44 span: fu_fsm_execute_all: null fsm_event_list Apr 29 16:06:44 span: fu_fsm_engine: mts msg MTS_OPC_DEBUG_WRAP_MSG(msg_id 2548887) dropped Apr 29 16:06:48 span: fu_priority_select: - setting fd[3] for select call Apr 29 16:06:48 span: fu_priority_select_select_queue: round credit(12) Apr 29 16:06:48 span: curr_q - FU_PSEL_Q_CAT_CQ, usr_q_info(4), priority(7), credit(6), empty Apr 29 16:06:48 span: fu_priority_select: returning FU_PSEL_Q_CAT_MTS queue, fd(3), usr_q_info(2) Apr 29 16:06:48 span: span_get_data_from_mts_q dequeued mts msg (26e525), MTS_OPC_DEBUG_WRAP_MSG
6-102
Chapter 6
Debug Commands debug span
Related Commands Command no debug all show span session Description Disables all debugging. Displays specific information about a Switched Port Analyzer (SPAN) session.
6-103
Chapter 6 debug system health
Debug Commands
debug system health

To enable system health monitoring debugging, use the debug system health command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug system health {all | asic-counters | battery-charger | cache-disk | eobc | error | event | external-loopback | failure-analysis | fc2 | ha | inband | loopback | mgmt | misc | mts | pss | serdes | special | trace | xipc} no debug system health {all | asic-counters | battery-charger | cache-disk | eobc | error | event | external-loopback | failure-analysis | fc2 | ha | inband | loopback | mgmt | misc | mts | pss | serdes | special | trace | xipc}
Syntax Description
all asic-counters battery-charger cache-disk eobc error event external-loopback failure-analysis fc2 ha inband loopback mgmt misc mts pss serdes special trace xipc
Enables debugging of all online health flags. Enables debugging of system health ASIC statistics. Enables debugging of system health battery charger tests. Enables debugging of system health cache-disk tests. Enables debugging of system health EOBC tests. Enables debugging of system health error conditions. Enables debugging of system health events. Enables debugging of system health external loopback tests. Enables debugging of system health failure analysis. Enables debugging of system health FC2 frames. Enables debugging of health monitoring HA flags. Enables debugging of system health inband tests. Enables debugging of system health loopback tests. Enables debugging of system health management-port port tests. Enables debugging of system health misc Enables debugging of system health MTS Enables debugging of system health pss Enables debugging of system health SerDes tests. Enables debugging of system health special. Enables debugging of health monitoring trace flags. Enables debugging of system health XIPC.
Defaults
Disabled.
Command Modes
EXEC mode.
6-104
Chapter 6
Debug Commands debug system health
Usage Guidelines
None.
Examples
The following example displays the system output when the debug system health command is issued:
switch# debug system health all 2005 Mar 10 01:49:28 SystemHealth: ohms_snake_fd_activity: Module 1 Snake Frame came. 2005 Mar 10 01:49:28 SystemHealth: ohms_snake_fd_activity: Module 8 waiting for Snake Frame to come. 2005 Mar 10 01:49:28 SystemHealth: ohms_dequeue: select timeout 0 998000 2005 Mar 10 01:49:28 SystemHealth: fu_priority_select: - setting fd[4] for select call setting fd[20] for select call - setting fd[22] for select call - setting fd[28] for select call - setting fd[29] for select call - setting fd[30] for select call 2005 Mar 10 01:49:28 SystemHealth: fu_priority_select_select_queue: round credit(14) 2005 Mar 10 01:49:28 SystemHealth: curr_q - FU_PSEL_Q_CAT_FD, usr_q_info(466240), fd(29), priority(6), credit(3), empty 2005 Mar 10 01:49:28 SystemHealth: fu_priority_select: returning FU_PSEL_Q_CAT_CQ queue, usr_q_info(1) 2005 Mar 10 01:49:28 SystemHealth: ohms_dequeue: Select woken up 2005 Mar 10 01:49:28 SystemHealth: ohms_dequeue: Process event type 0x1 2005 Mar 10 01:49:28 SystemHealth: ohms_dequeue: Processing timer type 2005 Mar 10 01:49:28 SystemHealth: fu_fsm_engine: line[2139] 2005 Mar 10 01:49:28 SystemHealth: fu_fsm_handle_sysmgr_msg: Not mts event 2005 Mar 10 01:49:28 SystemHealth: ohms_timer_event_handler: called. 2005 Mar 10 01:49:28 SystemHealth: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) .
Related Commands
Command no debug all show system health
Description Disables all debugging. Displays configured Online System Health Management (OSHM) information.
6-105
Chapter 6 debug tacacs+
Debug Commands
debug tacacs+
To enable debugging for boot variables, use the debug tacacs+ command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug tacacs+ {aaa-request | aaa-request-lowlevel | all | config | config-lowlevel} no debug tacacs+ {aaa-request | aaa-request-lowlevel | all | config | config-lowlevel}
Syntax Description
aaa-request aaa-request-lowlevel all config config-lowlevel
Enables TACACS+ AAA request debug. Enables TACACS+ AAA request low-level debugging. Enables Enable all the debug flags. Enables TACACS+ configuration debugging. Enables TACACS+ configuring low-level debugging.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.3(1)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug tacacs+ config-lowlevel command is issued:
switch# debug tacacs+ config-lowlevel Nov 20 06:39:44 tacacs: tacacs_debug_conf_open: entering... 172.22.94.252# Nov 20 06:39:44 tacacs: tacacs_debug_conf_open: exiting Nov 20 06:39:44 tacacs: tacacs_conf_close: entering... Nov 20 06:39:44 tacacs: tacacs_conf_close: returning 0 Nov 20 06:39:44 tacacs: tacacs_enable_info_config: entering for TACACS+ Daemon debug Nov 20 06:39:44 tacacs: tacacs_debug_conf_open: entering... Nov 20 06:39:44 tacacs: tacacs_debug_conf_open: exiting Nov 20 06:39:44 tacacs: tacacs_enable_info_config: SET_REQ for TACACS+ Daemon debug with 1 Nov 20 06:39:44 tacacs: tacacs_enable_info_config: SET_REQ done for TACACS+ Daemon debug with 1 Nov 20 06:39:44 tacacs: tacacs_enable_info_config: got back the return value of configuration operation:success Nov 20 06:39:44 tacacs: tacacs_debug_conf_close: entering... Nov 20 06:39:44 tacacs: tacacs_debug_conf_close: returning 0 Nov 20 06:39:44 tacacs: tacacs_enable_info_config: exiting for TACACS+ Daemon debug
6-106
Chapter 6
Debug Commands debug tacacs+
Related Commands Command no debug all show tacacs+ Description Disables all debugging. Displays the TACACS+ Cisco Fabric Services (CFS) distribution status and other details.
6-107
Chapter 6 debug tcap
Debug Commands
debug tcap
To enable debugging the exception logger, use the debug tcap command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug tcap {demux | deque | error | info | init} no debug tcap {demux | deque | error | info | init}
Syntax Description
demux deque error info init
Enables debugging for terminal capture demux functions. Enables debugging for terminal capture deque events. Enables debugging for terminal capture errors. Enables debugging for terminal capture information. Enables debugging for terminal capture initialization.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
Use this command to debug terminal capture utility events and information.
Examples
The following example displays the system output when the debug tcap demux command is issued:
switch# debug tcap demux
Related Commands
6-108
Chapter 6
Debug Commands debug tlport
debug tlport
To enable debugging for TL port interfaces, use the debug tlport command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug tlport {all | errors | events {fc2 {terminal | transit} | mts | pss}} [interface fc slot/port] no debug tlport {all | errors | events {fc2 {terminal | transit} | mts | pss}} [interface fc slot/port]
Syntax Description
all errors events fc2 terminal transit mts pss interface fc slot/port
Enables debugging for all TL port features. Enables debugging for TL port error conditions. Enables debugging for TL port monitoring events. Enables debugging for TL port monitoring FC 2 events. Specifies TL port monitoring FC 2 terminating events. Specifies TL port monitoring FC 2 transit events. Enables debugging for TL port monitoring MTS packets. Enables debugging for TL port monitoring PSS packets. Restricts debugging to the specified interface.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug tlport events pss command is issued:
switch# debug tlport events pss
Related Commands
Command no debug all show tlport
Description Disables all debugging. Displays configured TL port information.
6-109
Chapter 6 debug ttyd
Debug Commands
debug ttyd
To enable TTYD debugging, use the debug ttyd command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug ttyd {all | errors | events} no debug ttyd {all | errors | events}
Syntax Description
all errors events
Enables debugging for all TTYD features. Enables debugging for TTYD error conditions. Enables debugging for TTYD events.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug ttyd events command is issued:
switch# debug ttyd events
Related Commands
6-110
Chapter 6
Debug Commands debug vni
debug vni
To enable debugging for a virtual network interface (VNI), use the debug vni command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug vni {all | errors | events | info | pss} no debug vni {all | errors | events | info | pss}
Syntax Description
Enables debugging for all VNI features. Enables debugging for VNI error conditions. Enables debugging for VNI events. Enables debugging for VNI events. Enables debugging for VNI PSS packets.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug vni all command is issued:
switch# debug vni all Apr 29 17:00:59 vni: Received MTS message Apr 29 17:00:59 vni: message not processed by system mgr library , so process it normal way
Related Commands
6-111
Chapter 6 debug vrrp
Debug Commands
debug vrrp
To enable debugging for a Virtual Router Redundancy Protocol (VRRP), use the debug vrrp command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug vrrp {configuration | engine} {all | error | event | info} no debug vrrp {configuration | engine} {all | error | event | info}
Syntax Description
configuration engine all error event info
Enables VRRP configuration debugging. Enables VRRP engine debugging. Enables debugging for all VRRP features. Enables debugging for VRRP error conditions. Enables debugging for VRRP events. Enables debugging for VRRP events.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug vrrp engine all command is issued:
switch# debug vrrp engine all Apr 29 17:35:58 vrrp_eng: fu_priority_select: - setting fd[7] for select call - setting fd[11] for select call - setting fd[12] for select call - setting fd [13] for select call - setting fd[15] for select call Apr 29 17:35:58 vrrp_eng: fu_priority_select_select_queue: round credit(6) Apr 29 17:35:58 vrrp_eng: curr_q - FU_PSEL_Q_CAT_FD, usr_q_info(6), fd(15), priority(2), credit(1), empty Apr 29 17:35:58 vrrp_eng: fu_priority_select: returning FU_PSEL_Q_CAT_FD queue, fd(7), usr_q_info(3) Apr 29 17:35:58 vrrp_eng: heartbeat sent Apr 29 17:35:58 vrrp_eng: message not processed by system mgr library , so process it normal way
6-112
Chapter 6
Debug Commands debug vrrp
Related Commands Command no debug all show vrrp Description Disables all debugging. Displays VRRP configuration information.
6-113
Chapter 6 debug vsan
Debug Commands
debug vsan
To enable debugging for VSANs, use the debug vsan command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug vsan {all | global | ha | info | membership | mts} no debug vsan {all | global | ha | info | membership | mts}
Syntax Description
all global ha info membership mts
Enables all debugging flags for the VSAN feature. Enables debugging of events for the VSAN global parameter database Enables debugging of VSAN's HA-related events. Enables debugging of events for VSAN information database. Enables debugging of events for VSAN membership database. Enables debugging of Tx/Rx packets of MTS.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug vsan all command is issued:
switch# debug vsan all 2005 Mar 10 01:44:35 vsan: Calling handling function 2005 Mar 10 01:44:35 vsan: querying trunking membership(readonly) for interface:16859136 2005 Mar 10 01:44:35 vsan: Replying to trunking membership query for interface:fc1/21 with VSAN bitmap:1-4093 2005 Mar 10 01:44:35 vsan: got back reply_code:0 2005 Mar 10 01:44:35 vsan: Returned from handling function 2005 Mar 10 01:44:35 vsan: Freeing notifications 2005 Mar 10 01:44:35 vsan: Src: 0x00000601/15 Dst: 0x00000601/27 ID: 0x0067CEA1 Size: 520 [RSP] Opc: 116 (MTS_OPC_VSAN_GET_PORT_TRUNKING_MEMBERSHIP) RR: 0x0067CEA0 HA_SEQNO: 0x00000000 TS: 0x24E717EAC7CE2 REJ:0 SYNC:1 2005 Mar 10 01:44:35 vsan: 00 00 00 00 00 00 02 00 7F FF FF FF FF FF FF FF 2005 Mar 10 01:44:35 vsan: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 2005 Mar 10 01:44:35 vsan: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 2005 Mar 10 01:44:35 vsan: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 2005 Mar 10 01:44:35 vsan: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF .
6-114
Chapter 6
Debug Commands debug vsan
Related Commands Command no debug all show vsan Description Disables all debugging. Displays information about configured VSANs.
6-115
Chapter 6 debug wr-reg
Debug Commands
debug wr-reg
To enable debugging for the list of devices using the write-register feature, use the debug wr-reg command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug wr-reg [device-name | register-address] no debug wr-reg [device-name | register-address]
Syntax Description
device-name register-address
Specifies the device name for the required device. Specifies the register address for the required device.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug wr-reg command is issued:
switch# debug wr-reg
Related Commands
6-116
Chapter 6
Debug Commands debug wwn
debug wwn
To enable debugging for the world wide name (WWN) manager, use the debug wwn command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug wwn {all | detail | errors | flow | trace} no debug wwn {all | detail | errors | flow | trace}
Syntax Description
all detail error flow trace
Enables all WWN debug options. Enables all WWN output Enables debugging for WWN error conditions. Enables flow-level WWN debug options. Enables debugging for WWN traces.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug wwn all command is issued:
switch# debug wwn all Apr 29 19:24:17 wwn: 53601-wwnm_sdwrap_dispatch:77|SDWRAP massage Successfully processed Apr 29 19:24:17 wwn: Src: 0x00000601/5206 Dst: 0x00000601/46 ID: 0x002C7DE4 Size: 252 [REQ] Opc: 182 (MTS_OPC_DEBUG_WRAP_MSG) RR: 0x002C7DE4 HA_SEQNO: 0x00000000 TS: 0x55D49A130243 REJ:0 Apr 29 19:24:17 wwn: 2F 64 65 76 2F 70 74 73 2F 30 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Apr 29 19:24:17 wwn: 00 00 00 00 00 00 00 00 2E 00 00 00
6-117
Chapter 6 debug wwn
Debug Commands
Apr 29 19:24:17 wwn: 53601-wwnm_unmask_sigalrm:1261|TRACE: FILE=_manager/wwnm/wwnm_utilities.c
Related Commands
Command no debug all show wwn
Description Disables all debugging. Displays the status of the WWN configuration.
6-118
Chapter 6
Debug Commands debug xbar
debug xbar
To enable crossbar debugging (XBAR), use the debug xbar command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug xbar {all | demux | deque | error [module slot] | fsm [module slot] | ha [module slot] | init | main}
Syntax Description
all demux deque error fsm ha init main module slot
Enables all XBAR debug options. Enables debugging for XBAR demux functions. Enables debugging for XBAR deque events. Enables debugging for XBAR errors. Enables debugging for XBAR FSMs. Enables debugging for XBAR high availability information. Enables debugging for XBAR initialization. Enables XBAR debugging for main functions. Specifies the slot number of the module being debugged.
Defaults
Enabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug xbar all command is issued:
switch# debug xbar all Apr 29 19:48:34 xbar: its a sdwrap msg, fsm utils dropping the mts msg Apr 29 19:48:34 xbar: fu_fsm_engine: (Error) SYSERR_FU_xx: 0x10, err_num (16) in demux Apr 29 19:48:34 xbar: fu_fsm_execute_all: match_msg_id(0), log_already_open(0) Apr 29 19:48:34 xbar: fu_fsm_execute_all: null fsm_event_list ...
Related Commands
6-119
Chapter 6 debug xbc
Debug Commands
debug xbc
To enable crossbar client debugging (XBC), use the debug xbc command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug xbc {demux | deque | init | main} no debug xbc {demux | deque | init | main}
Syntax Description
demux deque init main
Enables debugging for crossbar demux functions. Enables debugging for crossbar deque events. Enables debugging for crossbar initialization. Enables debugging for crossbar main functions.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
Use this command to debug crossbar client events and information.
Examples
The following example displays the system output when the debug xbc init command is issued:
switch# debug xbc init
Related Commands
6-120
Chapter 6
Debug Commands debug zone
debug zone
To enable debugging for zones, use the debug zone command in EXEC mode. To disable a debug command, use the no form of the command or use the no debug all command to turn off all debugging. debug zone {all | change {errors | events | packets} | database {detail | errors | events} | gs errors {errors | events | packets} | lun-zoning {errors | events | packets} | merge {errors | events | packets} | mts notifications | pss {errors | events} || read-only-zoning {errors | events | packets} | tcam errors {errors | events | packets} | transit {errors | events}} [vsan vsan-id] no debug zone {all | change {errors | events | packets} | database {detail | errors | events} | gs errors {errors | events | packets} | lun-zoning {errors | events | packets} | merge {errors | events | packets} | mts notifications | pss {errors | events} || read-only-zoning {errors | events | packets} | tcam errors {errors | events | packets} | transit {errors | events}} [vsan vsan-id]
Syntax Description
all vsan vsan-id change database errors events packets database gs lun-zoning merge mts notification pss read-only-zoning tcam transit
Enables all zone server debug options. Restricts debugging to the specified VSAN. Enables debugging for change protocol messages. Enables debugging for the zone database messages. Enables debugging for zone errors. Enables debugging for zone events. Enables debugging for zone packets. Enables debugging for database messages. Enables debugging for GS protocol messages. Enables debugging for LUN zoning messages. Enables debugging for merge protocol messages. Enables debugging for MTS notification messages. Enables debugging for PSS debug messages Enables debugging for read-only Zoning messages. Enables debugging for TCAM messages. Enables debugging for transit frame messages.
6-121
Chapter 6 debug zone
Debug Commands
Defaults Disabled.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example displays the system output when the debug zone all command is issued:
switch# debug zone all 2005 Mar 10 01:46:36 zone: Src: 0x00000601/18 Dst: 0x00000601/94 ID: 0x0067D5CD Size: 276 [REQ] Opc: 182 (MTS_OPC_DEBUG_WRAP_MSG) RR: 0x0067D5CD HA_SEQNO: 0x00000000 TS: 0x24E95060E0EF4 REJ:0 SYNC:0 2005 Mar 10 01:46:36 zone: 01 00 00 00 E8 03 00 00 00 00 00 00 00 00 00 00 2005 Mar 10 01:46:36 zone: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 2005 Mar 10 01:46:36 zone: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 2005 Mar 10 01:46:36 zone: FF FF FF FF 2F 64 65 76 2F 70 74 73 2F 30 00 00 2005 Mar 10 01:46:36 zone: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 2005 Mar 10 01:46:36 zone: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 .
Related Commands
Command no debug all show zone
Description Disables all debugging. Displays zone information.
6-122
C H A P T E R
E Commands
7-1
Chapter 7 email-contact
E Commands
email-contact
To configure an e-mail contact with the Call Home function, use the email-addr command in Call Home configuration submode. To disable this feature, use the no form of the command. email-addr email-address no email-addr email-address
Syntax Description
email-address
Configures an e-mail address. Uses a standard e-mail address that does not have any text size restrictions.
Defaults
None.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to configure e-mail contact in the Call Home configuration.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# callhome switch(config-callhome)# email-contact [email protected]
Related Commands
7-2
Chapter 7
E Commands enable
enable
To enable the Call Home function, use the enable command in Call Home configuration submode. To disable this feature, use the disable command. enable
Syntax Description
Defaults
None.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
To disable the Call Home function, use the disable command.
Examples
The following example shows how to enable the Call Home function.
switch# config terminal Enter configuration commands, one per line. switch(config)# callhome switch(config-callhome)# enable End with CNTL/Z.
Related Commands
7-3
Chapter 7 encryption
E Commands
encryption
To configure an encryption algorithm for an IKE protocol policy, use the encryption command. To revert to the default, use the no form of the command. encryption {3des | aes | des} no encryption
Syntax Description
3des aes des
168-bit DES (3DES) 128-bit AES-CBC 56-bit DES-CBS
Defaults
3des
Command Modes
IKE policy configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, the IKE protocol must be enabled using the crypto ike enable command.
Examples
The following example shows how to configure the encryption algorithm for the IKE protocol.
switch# config terminal switch(config)# crypto ike domain ipsec switch(config-ike-ipsec)# policy 1 switch(config-ike-ipsec-policy)# encryption 3des
Related Commands
Command crypto ike domain ipsec crypto ike enable policy show crypto ike domain ipsec
Description Enters IKE configuration mode. Enables the IKE protocol. Configures IKE policy parameters. Displays IKE information for the IPsec domain.
7-4
Chapter 7
E Commands end
end
To exit any of the configuration modes and return to EXEC mode, use the end command in configuration mode. end
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
You can also press Ctrl-Z to exit configuration mode.
Examples
The following example changes the name to george. Entering the end command causes the system to exit configuration mode and return to EXEC mode.
switch(config)# hostname george george(config)# end switch#
Related Commands
Command exit
Description Exits configuration mode, or any of the configuration modes.
7-5
Chapter 7 exit
E Commands
exit
To exit any configuration mode or close an active terminal session and terminate the EXEC, use the exit command at the system prompt. exit
Syntax Description
Defaults
None.
Command Modes
EXEC and Configuration modes.
Command History
Usage Guidelines
Use the exit command at the EXEC levels to exit the EXEC mode. Use the exit command at the configuration level to return to privileged EXEC mode. Use the exit command in interface configuration mode to return to configuration mode. You also can press Ctrl-Z, or use the end command, from any configuration mode to return to EXEC mode.
Note
The exit command is associated with privilege level 0. If you configure AAA authorization for a privilege level greater than 0, this command will not be included in the command set for that privilege level.
Examples
The following example displays an exit from the interface configuration mode for VRRP to return to the interface configuration mode.
switch(config-if-vrrp)# exit switch(config-if)#
The following example displays an exit from the interface configuration mode to return to the configuration mode.
switch(config-if)# exit switch(config)#
The following example shows how to exit an active session (log-out).

switch# exit
Related Commands
Command end
Description Returns you to EXEC mode.
7-6
C H A P T E R
F Commands
8-1
Chapter 8 fabric-binding activate
F Commands
fabric-binding activate
To activate fabric binding in a FICON enabled VSAN, use the fabric-binding activate command in configuration mode. To disable this feature, use the no form of the command. fabric-binding activate vsan vsan-id [force] no fabric-binding activate vsan vsan-id
Syntax Description
vsan vsan-id force
Specifies the FICON-enabled VSAN. The ID of the VSAN is from 1 to 4093. Forces fabric binding activation.
Defaults
Disabled
Command Modes
Configuration mode
Command History
Usage Guidelines Fabric binding is configured on a per-VSAN basis and can only be implemented in FICON VSANs.
Examples
The following example activates the fabric binding database for the specified VSAN.
switch# config terminal switch(config)# fabric-binding activate vsan 1
The following example deactivates the fabric binding database for the specified VSAN.
switch(config)# no fabric-binding activate vsan 10
The following example activates the fabric binding database for the specified VSAN forcefullyeven if the configuration is not acceptable.
switch(config)# fabric-binding activate vsan 3 force
The following example reverts to the previously-configured state or to the factory default (if no state is configured)
switch(config)# no fabric-binding activate vsan 1 force
Related Commands
Command fabric-binding database fabric-binding enable
Description Configures a fabric-binding database. Enables fabric-binding.
8-2
Chapter 8
F Commands fabric-binding database copy
fabric-binding database copy

To copy from the active fabric binding database to the configuration fabric binding database, use the fabric-binding database copy command in EXEC mode. fabric-binding database copy vsan vsan-id
Syntax Description
vsan vsan-id
Specifies the FICON-enabled VSAN. The ID of the VSAN is from 1 to 4093.
Defaults
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can only be implemented in FICON VSANs. If the configured database is empty, this command is not accepted
Examples
The following example copies from the active database to the config database in VSAN 1.
switch# fabric-binding database copy vsan 1
Related Commands
Command fabric-binding diff
Description Provides the differences between the fabric-binding databases.
8-3
Chapter 8 fabric-binding database diff
F Commands
fabric-binding database diff

To view the differences between the active database and the configuration database in a FICON enabled VSAN, use the fabric-binding database diff command in EXEC mode. fabric-binding database diff {active | config} vsan vsan-id
Syntax Description
active config vsan vsan-id
Provides information on the differences in the active database with respect to the configuration database. Provides information on information on the differences in the configuration database with respect to the active database. Specifies the FICON-enabled VSAN. The ID of the VSAN is from 1 to 4093.
Defaults
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can only be implemented in FICON VSANs.
Examples
The following example displays the differences between the active database and the configuration database in VSAN 1.
switch# fabric-binding database diff active vsan 1
The following example displays information on the differences between the configuration database and the active database.
switch# fabric-binding database diff config vsan 1
Related Commands
Command fabric-binding copy
Description Copies from the active to the config fabric binding database.
8-4
Chapter 8
F Commands fabric-binding database vsan
fabric-binding database vsan

To configure a user-specified fabric binding list in a FICON enabled VSAN, use the fabric-binding database vsan command in configuration mode. To disable an FC alias, use the no form of the command. fabric-binding database vsan vsan-id swwn switch-wwn domain domain-id fabric-binding database vsan vsan-id no swwn switch-wwn domain domain-id no fabric-binding database vsan vsan-id
Syntax Description
vsan-id swwn switch-wwn domain domain-id
Specifies the FICON-enabled VSAN. The ID of the VSAN is from 1 to 4093. Configures the switch WWN in dotted hex format. Specifies the specified domain ID. The domain ID is a number from 1 to 239.
Defaults
None
Command Modes
Configuration mode
Command History
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can only be implemented in FICON VSANs. The persistent domain ID must be specified along with the sWWN. Domain ID authorization is required in FICON VSANs where the domains are statically configured and the end devices reject a domain ID change in all switches in the fabric.
Examples
The following example enters the fabric binding database submode and adds the sWWN and domain ID of a switch to the configured database list.
switch# config terminal switch(config)# fabric-binding database vsan 5 switch(config-fabric-binding)# swwn 21:00:05:30:23:11:11:11 domain 102
The following example deletes a fabric binding database for the specified VSAN.
switch# config terminal switch(config)# no fabric-binding database vsan 10
The following example deletes the sWWN and domain ID of a switch from the configured database list.
switch# config terminal switch(config)# fabric-binding database vsan 5 switch(config-fabric-binding)# no swwn 21:00:15:30:23:1a:11:03 domain 101
8-5
Chapter 8 fabric-binding database vsan
F Commands
Related Commands
Command fabric-binding activate fabric-binding enable
Description Activates fabric-binding. Enables fabric-binding.
8-6
Chapter 8
F Commands fabric-binding enable
fabric-binding enable
To enable fabric binding in a FICON-enabled VSAN, use the fabric-binding enable command. To disable fabric binding, use the no form of the command. fabric-binding enable no fabric-binding enable
Syntax Description
Defaults
Disabled
Command Modes
Configuration mode
Command History
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can only be implemented in FICON VSANs. The fabric binding feature must be enabled in each switch in the fabric that participate in the fabric binding.
Examples
The following examples enables fabric binding on that switch.

switch# config t switch(config)# fabric-binding enable
The following example disables fabric binding on that switch.

switch# config t switch(config)# no fabric-binding enable
Related Commands
Command fabric-binding activate fabric-binding database
Description Activates fabric-binding. Configures a fabric-binding database.
8-7
Chapter 8 fcalias clone
F Commands
fcalias clone
To clone a Fibre Channel alias, use the fcalias clone command. fcalias clone origFcalias-Name cloneFcalias-Name vsan vsan-id
Syntax Description
origFcalias-Name cloneFcalias-Name vsan vsan-id
Clones a Fibre Channel alias from the current name to a new name. Maximum length of names is 64 characters. The clone Fibre Channel alias is for a VSAN. The ID of the VSAN is from 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.1(1a)
Usage Guidelines
To disable an FC alias, use the no form of the fcalias name command.
Examples
The following examples show how to clone a fcalias named origAlias to cloneAlias on VSAN 45.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# fcalias clone origAlias cloneAlias vsan 45
Related Commands
Command show fcalias
Description Displays the member name information in a Fibre Channel alias (fcalias).
8-8
Chapter 8
F Commands fcalias name
fcalias name
To configure an FC alias, use the fcalias name command. To disable an FC alias, use the no form of the command. fcalias name alias name vsan vsan-id no fcalias name alias name vsan vsan-id
Syntax Description
alias-name vsan vsan-id
The name of the fcalias. Maximum length is 64 characters. The fcalias is for a VSAN. The ID of the VSAN is from 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
To include multiple members in any alias, use the FCID, fWWN, or pWWN values.
Examples
The following examples show how to configure an fcalias called AliasSample on VSAN 3.
switch# config terminal switch(config)# fcalias name AliasSample vsan 3 switch(config-fcalias)#
Related Commands
Command member (fcalias configuration mode)
Description Configures alias member for a specified zone.
8-9
Chapter 8 fcalias rename
F Commands
fcalias rename
To rename a Fibre Channel alias (fcalias), use the fcalias rename command. fcalias rename current-name new-name vsan vsan-id
Syntax Description
current-name new-name vsan vsan-id
Specifies the current fcalias name. The maximum length is 64. Specifies the new fcalias name. The maximum length is 64. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to rename an fcalias.

switch# config terminal switch(config)# fcalias rename oldalias newalias vsan 10
Related Commands
Command fcalias name show fcalias
Description Configures fcalias names. Displays fcalias information.
8-10
Chapter 8
F Commands fcanalyzer
fcanalyzer
To configure the Cisco Fabric Analyzer use the fcanalyzer command in configuration mode. fcanalyzer {local [brief] [display-filter expression] [limit-captured-frames number] [limit-frame-size bytes] [write {slot: | volatile:}] | remote ip-address [active [port-number]]}
Syntax Description
local brief display-filter expression limit-frame-size bytes
Begins capturing the frames locally (supervisor module). Displays the protocol summary in a brief format. Displays the filtered frames using the provided filter expression. Limits the size of the frame captures. The range is 64 to 65536 bytes.
limit-captured-frames Limits the number of frames captured to 10. The range is 0 to 2147483647 number frames and the default is 100 frames. Use 0 if you do not want to limit the captured frames. write slot: volatile: remote ip-address active port-number Saves the captured frames to a specified file. Specifies the Flash device in slot 0. Specifies volatile memory. Configures the remote IP address to which the captured frames will be sent. Specifies IP address or histamine. Maximum length is 1024 characters. Enables active mode (passive is the default) with the remote host. Specifies port number
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
You can capture Fibre Channel control traffic from a switch and decode it without having to disrupt connectivity and without having to be local to the point of analysis.
8-11
Chapter 8 fcanalyzer
F Commands
Examples The following examples shows how to configure the Cisco Fabric Analyzer.
switch# config terminal switch(config)# fcanalyzer local Capturing on eth2 switch(config)# fcanalyzer local brief Capturing on eth2 switch(config)# fcanalyzer local display-filter SampleF Capturing on eth2 switch(config)# fcanalyzer local limit-frame-size 64 Capturing on eth2 switch(config)# fcanalyzer local limit-captured-frames 10 Capturing on eth2 sswitch(config)# fcanalyzer local write SampleFile Capturing on eth2 switch(config)# fcanalyzer remote 10.21.0.3 Capturing on eth2 switch(config)# fcanalyzer remote 10.21.0.3 active Capturing on eth2
Related Commands
Command clear fcanalyzer show fcanalyzer
Description Clears the entire list of configured hosts. Displays the list of hosts configured for a remote capture.
8-12
Chapter 8
F Commands fcc enable
fcc enable
To enable Fibre Channel Congestion Control (FCC), use the fcc enable command in configuration mode. To disable this feature, use the no form of the command. fcc enable no fcc enable
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
FCC reduces the congestion in the traffic without interfering with standard Fibre Channel protocol.
Examples
The following example shows how to enable FCC.

switch# config terminal switch(config)# fcc enable
Related Commands
Command show fcc
Description Displays FCC settings.
8-13
Chapter 8 fcc priority
F Commands
fcc priority
To assign the FCC priority to the entire switch, use the fcc priority command in configuration mode. To revert to the default, use the no form of the command. fcc priority number no fcc priority number
Syntax Description
number
The FCC priority threshold. The range is 0 to 7, where 0 is the lowest priority and 7 the highest priority.
Defaults
The default priority is 4.
Command Modes
Configuration mode.
Command History
Usage Guidelines
FCC reduces the congestion in the traffic without interfering with standard Fibre Channel protocol.
Examples
The following example shows how to configure the FCC priority threshold as 2.
switch# config terminal switch(config)# fcc priority 2
Related Commands
Command show fcc
Description Displays FCC settings.
8-14
Chapter 8
F Commands fcdomain
fcdomain
To configure the Fibre Channel domain feature, use the fcdomain command. To disable the FC domain, use the no form of the command. fcdomain {allowed domain vsan vsan-id | auto-reconfigure vsan vsan-id | contiguous-allocation vsan vsan-id | domain id {preferred | static} vsan vsan-id | fabric-name name vsan vsan-id | fcid {database | persistent vsan vsan-id} | priority value vsan vsan-id | restart [disruptive] vsan vsan-id | vsan vsan-id} no fcdomain {allowed domain vsan vsan-id | auto-reconfigure vsan vsan-id | contiguous-allocation vsan vsan-id | domain id {preferred | static} vsan vsan-id | fabric-name name vsan vsan-id | fcid {database | persistent vsan vsan-id} | priority value vsan vsan-id | restart [disruptive] vsan vsan-id | vsan vsan-id}
Syntax Description
allowed domain vsan vsan-id auto-reconfigure contiguous-allocation domain id preferred
Configures the allowed domain ID list ranging from 1 to 239. Specifies a VSAN ID. The range is 1 to 4093. Configures autoreconfigure. Configures contiguous allocation. Configures the domain ID and its type. The range is 0 to 239. Configures the domain ID as preferred. By default, the local switch accepts the domain ID assigned by the principal switch and the assigned domain ID becomes the runtime domain ID. Configures the domain ID as static. The assigned domain ID is discarded, all local interfaces are isolated, and the local switch assigns itself the configured domain ID, which becomes the runtime domain ID. Specifies the fabric name. The name format is hh:hh:hh:hh:hh:hh:hh:hh. Configures FC domain persistent FCIDs. Enters persistent FCIDs submode. Enables or disables FC domain persistent FCIDs. Specifies the FC domain priority. The range is 1 to 254. Starts a disruptive or nondisruptive reconfiguration. Forces the disruptive fabric reconfiguration.
static
fabric-name name fcid database persistent priority value restart disruptive
Defaults
Enabled.
8-15
Chapter 8 fcdomain
F Commands
Command Modes Configuration mode.
Command History
Release 1.1(1) 2.0(1)
Modification This command was introduced. The global-enable keyword option was deprecated.
Usage Guidelines
You can use this command to select the principle switch, domain ID distribution, reconfigure fabric, and allocate FCIDs.
Examples
The following examples show how to configure the Fibre Channel domain feature.
switch# config terminal switch(config)# fcdomain domain 3 preferred vsan 87 switch(config)# no fcdomain domain 3 preferred vsan 87 switch(config)# fcdomain domain 2 static vsan 237 switch(config)# no fcdomain domain 2 static vsan 237 switch(config)# fcdomain restart vsan 1 switch(config)# fcdomain restart disruptive vsan 1 switch(config)# fcdomain priority 25 VSAN 99 switch(config)# no fcdomain priority 25 VSAN 99 switch(config)# fcdomain auto-reconfigure vsan 10 switch(config)# fcdomain contiguous-allocation vsan 81-83 switch(config)# no fcdomain contiguous-allocation vsan 1030 switch(config)# fcdomain fabric-name 20:1:ac:16:5e:0:21:01 vsan 3 switch(config)# no fcdomain fabric-name 20:1:ac:16:5e:0:21:01 vsan 3010 switch(config)# fcdomain allowed 50-110 vsan 4 switch(config)# no fcdomain allowed 50-110 vsan 5
Related Commands
Command show fcdomain
Description Displays global information about the FC domain configurations.
8-16
Chapter 8
F Commands fcdomain rcf-reject
fcdomain rcf-reject
To enable the RCF reject flag for a Fibre Channel or FCIP interface, use the fcdomain option. To disable this feature, use the no form of the command. fcdomain rcf-reject vsan number no fcdomain rcf-reject vsan number
Syntax Description
vsan vsan-id
Specifies a VSAN ID. The range is 1 to 4093.
Defaults
Enabled
Command Modes
Usage Guidelines
Access this command from the switch(config-if)# submode. Use this option to configure the RCF reject option for the selected Fibre Channel or FCIP interface.
Examples
The following examples show how to configure the FCIP RCF reject fcdomain feature.
switch# config terminal switch(config)# interface fcip 1 switch(config-if)# fcdomain rcf-reject vsan 1
Related Commands
Command show fcdomain show interface fcip
Description Displays global information about the FC domain configurations. Displays an interface configuration for a specified FCIP interface.
8-17
Chapter 8 fcdroplatency
F Commands
fcdroplatency
To configure the network and switch FC drop latency time, use the fcdroplatency command in configuration mode. To disable the FC latency time, use the no form of the command. fcdroplatency {network milliseconds [vsan vsan-id] | switch milliseconds} no fcdroplatency {network milliseconds [vsan vsan-id] | switch milliseconds
Syntax Description
network milliseconds vsan vsan-id switch milliseconds
Specifies network latency. The range is 500 to 60000. Specifies a VSAN ID. The range is 1 to 4093. Specifies switch latency. The range is 0 to 60000 milliseconds.
Defaults
2000 millisecond network latency 500 millisecond switch latency
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to configure the network latency to 5000 milliseconds.
switch# config terminal switch(config)# switch(config)# fcdroplatency network 5000 switch(config)#
The following example shows how to revert to the default network latency.
switch(config)# no fcdroplatency network 5000 switch(config)#
The following example shows how to configure the switch latency to 4000 milliseconds.
switch(config)# fcdroplatency switch 4000 switch(config)#
The following example shows how to revert to the default switch latency.
switch(config)# no fcdroplatency switch 4000 switch(config)#
8-18
Chapter 8
F Commands fcdroplatency
Related Commands Command show fcdroplatency Description Displays the configured FC drop latency parameters.
8-19
Chapter 8 fcflow stats
F Commands
fcflow stats
To configure fcflow statistics, use the fcflow stats command in configuration mode. To disable the counter, use the no form of the command. fcflow stats {aggregated module module-number index flow-number vsan vsan-id | module module-number index flow-number destination-fcid source-fcid netmask vsan vsan-id} no fcflow stats {aggregated module module-number index flow-number | module module-number index flow-number}
Syntax Description
aggregated index flow-number vsan vsan-id destination-fcid source-fcid netmask
Configures aggregated fcflow statistics. Specifies a flow index. The range is 1 to 2147483647. Specifies a VSAN ID. The range is 1 to 4093. Enters the destination FCID in hexadecimal format. Enters the source FCID in hexadecimal format. Enters the mask for the source and destination FCID (restricted to 6 hexadecimal characters ranging from 0x000000 to 0xffffff).
module module-number Configure fcflow statistics on a module.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
If you enable flow counters, you can enable a maximum of 1K entries for aggregate flow and flow statistics. Be sure to assign an unused flow index to a module for each new flow. Flow indexes can be repeated across modules. The number space for flow index is shared between the aggregate flow statistics and the flow statistics.
Examples
The following example shows how to configure aggregated fcflow statistics for module 1.
switch-config# fcflow stats aggregated module 1 switch-config#
The following example enables the aggregated flow counter.

switch(config)# fcflow stats aggregated module 1 index 1005 vsan 1
The following example disables the aggregated flow counter.

switch(config)# no fcflow stats aggregated module 1 index 1005
8-20
Chapter 8
F Commands fcflow stats
The following example enables the flow counter for module 1.
switch(config)# fcflow stats module 1 index 1 0x145601 0x5601 0xffffff vsan 1
The following example disables the flow counter for module 1.

switch(config)# no fcflow stats module 2 index 1001
Related Commands
Command show fcflow stats
Description Displays the configured FC drop latency parameters.
8-21
Chapter 8 fcid-allocation
F Commands
fcid-allocation
Use the fcid-allocation command to manually add a FCID to the default area company ID list. Use the no form of the command to remove a FCID from the default area company ID list. fcid-allocation area company-id company-id no fcid-allocation area company-id company-id
Syntax Description
area company-id companyid
Modifies the auto area list of company IDs. Configures the company IDs.
Defaults
None
Command Modes
Configuration mode.
Command History
Release 2.0
Modification New command
Usage Guidelines
Fibre Channel standards require a unique FCID to be allocated to an N port attached to a Fx port in any switch. To conserve the number of FCIDs used, Cisco MDS 9000 Family switches use a special allocation scheme. Some HBAs do not discover targets that have FCIDs with the same domain and area. Prior to Cisco MDS SAN-OS Release 2.0, the Cisco MDS SAN-OS software maintained a list of tested company ID (also know as Organizational Unit Identifier, or OUI) which do not exhibit this behavior. These Host Bus Adapters (HBAs) were allocated with single FCIDs, and for others a full area was allocated. The FCID allocation scheme available in Release 1.3 and earlier, allocates a full area to these HBAs. This allocation isolates them to that area and are listed with their pWWN during a fabric login. The allocated FCIDs are cached persistently and are still available in Cisco MDS SAN-OS Release 2.0 (see the FCID Allocation for HBAs section on page 38-22). As of Cisco MDS SAN-OS Release 2.0, to allow further scalability for switches with numerous ports, the Cisco MDS SAN-OS software is maintaining a list of HBAs exhibiting this behavior. Each HBA is identified by its company ID used in the pWWN during a fabric log in. Hence a full area is allocated to the N ports with company IDs that are listed and for the others, a single FCID is allocated. Irrespective of the kind (whole area or single) of FCID allocated, the FCID entries remain persistent.
8-22
Chapter 8
F Commands fcid-allocation
Examples
The following example adds a new company ID to the default area company ID list.
switch# config terminal switch(config)# fcid-allocation area company-id 0x003223
Related Commands
Command show fcid-allocation
Description Displays the configured company IDs.
8-23
Chapter 8 fcid-last-byte
F Commands
fcid-last-byte
Use the fcid-last-byte command to allocate the last byte FCID for the fabric address. To disable the configuration or to revert to factory defaults, use the no form of the command. fcid-last-byte last-byte-id no fcid-last-byte last-byte-id
Syntax Description
last-byte-fcid
Specifies the last-byte FCID range from 0 to 250.
Defaults
Command Modes
Command History
Usage Guidelines
Examples
The following example assigns the last byte FCID for the fabric address.
switch# config terminal switch(config)# ficon vsan 2 switch(config-ficon)# fcid-last-byte 12
The following example removes the configured last byte FCID for the fabric address and reverts to the default.
switch# config terminal switch(config)# ficon vsan 2 switch(config-ficon)# no fcid-last-byte 3
Related Commands
8-24
Chapter 8
F Commands fcinterop fcid-allocation
fcinterop fcid-allocation
To allocate FCIDs on the switch, use the fcinterop fcid-allocation command in configuration mode. To disable FCIDs on the switch, use the no form of the command. fcinterop fcid-allocation {auto | flat | none} no fcinterop fcid-allocation {auto | flat | none}
Syntax Description
auto flat none
Assigns single FCID to compatible HBAs. Assign single FCID. Assigns FCID range.
Defaults
The default is fcinterop fcid-allocation auto.
Command Modes
Configuration mode.
Command History
Usage Guidelines
This command defines how the switch assigns FCIDs.
Examples
switch# config terminal switch(config)# fcinterop fcid-allocation none switch(config)# fcinterop fcid-allocation flat switch(config)# fcinterop fcid-allocation auto
Related Commands
Command show flogi database
Description Displays the fabric login (FLOGI) table.
8-25
Chapter 8 fcinterop loop-monitor
F Commands
fcinterop loop-monitor
To monitor removal of discs from a loop port, use the fcinterop loop-monitor command in configuration mode. To disable loop monitoring, use the no form of the command. fcinterop loop-monitor no fcinterop loop-monitor
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
This command detects devices that are removed from a looped port.
Examples
The following example shows how to enables monitoring of NL ports in a loop.

switch# config terminal switch(config)# fcinterop loop-monitor
The following example shows how to disable monitoring of NL ports in a loop.

switch# config terminal switch(config)# no fcinterop loop-monitor
Related Commands
Command show flogi database
Description Verify if a storage device is displayed in the Fabric login (FLOGI) table.
8-26
Chapter 8
F Commands fcip enable
fcip enable
To enable the FCIP feature in any switch in the Cisco MDS Family, issue the fcip enable command. fcip enable no fcip enable
Syntax Description
Defaults
Disabled
Command Modes
Configuration mode
Command History
Usage Guidelines
The configuration and verification commands for the iSCSI feature are only available when FCIP is enabled on a switch. When you disable this feature, all related configurations are automatically discarded.
Examples
The following command enables the FCIP feature.

switch(config)# fcip enable
The following command disables the FCIP feature (default).

switch(config)# no fcip enable
Related Commands
Command show fcip
Description Displays FCIP information.
8-27
Chapter 8 fcip profile
F Commands
fcip profile
To create and configure an FCIP profile, use the fcip profile command. To remove an FCIP profile, use the no form of the command. fcip profile profile-id no fcip profile profile-id
Syntax Description
profile-id
Specifies a ID range from 1 to 255.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
When you perform this command, the CLI enters FCIP profile configuration mode.
Examples
The following example shows how to configure an FCIP profile.

switch## config terminal switch(config)# fcip profile 5 switch(config-profile)#
Related Commands
Command show fcip profile interface fcip interface_number use-profile profile-id show interface fcip
Description Displays information about the FCIP profile. Configures the interface using an existing profile ID from 1 to 255.
Displays an interface configuration for a specified FCIP interface.
8-28
Chapter 8
F Commands fcns proxy-port
fcns proxy-port
To register a name server proxy, use the fcns proxy-port command in configuration mode. fcns proxy-port wwn-id vsan vsan-id no fcns proxy-port wwn-id vsan vsan-id
Syntax Description
wwn-id vsan vsan-id
Specifies the port WWN, with the format hh:hh:hh:hh:hh:hh:hh:hh. Specifies a VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
One name server can be configured to proxy another name server and name server information can be displayed using the CLI. The name server can be viewed using the CLI or the Cisco Fabric Manager. All name server registration requests come from the same port whose parameter is registered or changed. If it does not, then the request is rejected.
Examples
The following example shows configuring a proxy port for VSAN 2.

switch# config terminal switch(config)# fcns proxy-port 21:00:00:e0:8b:00:26:d vsan 2
Related Commands
Command show fcns
Description Displays the name server database and statistical information for a specified VSAN or for all VSANs.
8-29
Chapter 8 fcns reject-duplicate-pwwn vsan
F Commands
fcns reject-duplicate-pwwn vsan

To reject duplicate Fibre Channel name server (FCNS) proxies on a VSAN, use the fcns reject-duplicate-pwwn vsan command in configuration mode. fcns reject-duplicate-pwwn vsan vsan-id no fcns reject-duplicate-pwwn vsan vsan-id
Syntax Description
vsan-id
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example rejects duplicate FCNS pWWNs for VSAN 2.

switch# config terminal switch(config)# fcns reject-duplicate-pwwn vsan 2
Related Commands
Command show fcns
Description Displays the name server database and statistical information for a specified VSAN or for all VSANs.
8-30
Chapter 8
F Commands fcping
fcping
To ping an N port with a specified FCID, use the fcping fcid command in EXEC mode. fcping {device-alias aliasname | fcid {fc-port | domain-controller-id} | pwwn pwwn-id} vsan vsan-id [count number [timeout value [usr-priority priority]]]
Syntax Description
device-alias aliasname fcid fc-port domain-controller-id pwwn pwwn-id vsan vsan-id count number timeout value usr-priority priority
Specifies the device alias name. Maximum length is 64 characters. The FCID of the destination N port. The port FCID, with the format 0xhhhhhh. Verifies connection to the destination switch. Specifies the port WWN of the destination N port, with the format hh:hh:hh:hh:hh:hh:hh:hh. Specifies the VSAN ID of the destination N port. The range is 1 to 4093. Specifies the number of frames to send. A value of 0 sends forever. The range is 0 to 2147483647. Specifies the timeout value in seconds. The range is 1 to 10. Specifies the priority the frame receives in the switch fabric. The range is 0 to 1.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.0(2) 1.2(1) 2.0(1b)
Modification This command was introduced. Allowed the domain controller ID as an FCID. Added the device-alias aliasname option.
Usage Guidelines
To obtain the domain controller address, concatenate the domain ID with FFFC. For example, if the domain ID is 0xda(218), the concatenated ID is 0xfffcda.
Examples
The following example shows a fcping operation for the specified pWWN or the FCID of the destination. By default, five frames are sent.
switch# fcping 28 bytes from 28 bytes from 28 bytes from 28 bytes from 28 bytes from fcid 0xd70000 vsan 1 0xd70000 time = 730 0xd70000 time = 165 0xd70000 time = 262 0xd70000 time = 219 0xd70000 time = 228 usec usec usec usec usec
8-31
Chapter 8 fcping
F Commands
5 frames sent, 5 frames received, 0 timeouts Round-trip min/avg/max = 165/270/730 usec
The following example shows the setting of the number of frames to be sent using the count option. The range is from 0 through 2147483647. A value of 0 will ping forever.
switch# fcping 28 bytes from 28 bytes from 28 bytes from 28 bytes from 28 bytes from 28 bytes from 28 bytes from 28 bytes from 28 bytes from 28 bytes from fcid 0xd70000 vsan 1 0xd70000 time = 730 0xd70000 time = 165 0xd70000 time = 262 0xd70000 time = 219 0xd70000 time = 228 0xd70000 time = 230 0xd70000 time = 230 0xd70000 time = 225 0xd70000 time = 229 0xd70000 time = 183 count 10 usec usec usec usec usec usec usec usec usec usec
The following example shows the setting of the timeout value. The default period to wait is 5 seconds. The range is from 1 through 10 seconds.
switch# fcping 28 bytes from 28 bytes from 28 bytes from 28 bytes from 28 bytes from fcid 0xd500b4 vsan 1 timeout 10 0xd500b4 time = 1345 usec 0xd500b4 time = 417 usec 0xd500b4 time = 340 usec 0xd500b4 time = 451 usec 0xd500b4 time = 356 usec
This command shows the No response from the N port message even when the N port or NL port is active. This is due to resource exhaustion at the N port or NL port. Retry the command a few seconds later.
switch# fcping fcid 0x010203 vsan 1 No response from the N port. switch# fcping pwwn 21:00:00:20:37:6f:db:dd vsan 1 28 bytes from 21:00:00:20:37:6f:db:dd time = 1454 usec 28 bytes from 21:00:00:20:37:6f:db:dd time = 471 usec 28 bytes from 21:00:00:20:37:6f:db:dd time = 372 usec 28 bytes from 21:00:00:20:37:6f:db:dd time = 364 usec 28 bytes from 21:00:00:20:37:6f:db:dd time = 1261 usec 5 frames sent, 5 frames received, 0 timeouts Round-trip min/avg/max = 364/784/1454 usec
The following example displays fcping operation for the device alias of the specified destination.
switch# fcping device-alias x vsan 1 28 bytes from 21:01:00:e0:8b:2e:80:93 time = 358 usec 28 bytes from 21:01:00:e0:8b:2e:80:93 time = 226 usec 28 bytes from 21:01:00:e0:8b:2e:80:93 time = 372 usec
8-32
Chapter 8
F Commands fcroute
fcroute
To configure Fibre Channel routes, use the fcroute command. fcroute fcid [network_mask] interface {fc slot/port | portchannel port} domain domain-id [[metric number] remote] vsan vsan-id
Syntax Description
fcid network_mask interface fc slot/port portchannel port domain domain-id metric number remote vsan vsan-id
Specifies the FCID. The format is 0xhhhhhh. Specifies the FCID network mask. The format is 0xhhhhhh. Specifies the route for the specified interface. Specifies a Fibre Channel interface. Specifies a PortChannel interface. Specifies the route for the domain of the next hop switch. The range is 1 to 239. Specifies the cost of the route. The range is 1 to 65535. Default cost is 10. Configures the static route for a destination switch remotely connected. Specifies a VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Use this command to assign forwarding information to the switch.
Examples
switch# config terminal switch(config)# switch(config)# fcroute switch(config)# switch(config)# fcroute switch(config)# switch(config)# fcroute switch(config-if)# switch(config)# fcroute
0x111211 interface fc1/1 domain 3 vsan 2 0x111211 interface port-channel 1 domain 3 vsan 4 0x031211 interface fc1/1 domain 3 metric 1 vsan 1 0x111112 interface fc1/1 domain 3 metric 3 remote vsan 3
Related Commands
Command show fcroute
Description Displays Fibre Channel routes.
8-33
Chapter 8 fcrxbbcredit extended enable
F Commands
fcrxbbcredit extended enable

To enable Fibre Channel extended buffer-to-buffer credits (BB_credits), use the fcrxbbcredit extended enable command in configuration mode. To disable the feature, use the no form of the command. fcrxbbcredit extended enable no fcrxbbcredit extended enable
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
Performing the fcrxbbcredit extended enable command enables the switchport fcrxbbcredit extended command.
Examples
The following example shows how to enable Fibre Channel extended BB_credits.
switch# config terminal switch(config)# fcrxbbcredit extended enable
The following example shows how to disable Fibre Channel extended BB_credits.
switch# config terminal switch(config)# no fcrxbbcredit extended enable
Related Commands
Command show interface
Description Displays interface information and status.
switchport fcrxbbcredit extended Configures Fibre Channel extended BB_credits on an interface.
8-34
Chapter 8
F Commands fcs plat-check-global vsan
fcs plat-check-global vsan

To enable FCS platform and node name checking fabric wide, use the fcs plat-check-global vsan command in configuration mode. To disable this feature, use the no form of the command. fcs plat-check-global vsan vsan-id no fcs plat-check-global vsan vsan-id
Syntax Description
vsan-id
Specifies the VSAN ID for platform checking, which is from 1 to 4096.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
switch# config terminal switch(config)# fcs plat-check-global vsan 2
Related Commands
Command show fcs
Description Displays fabric configuration server information.
8-35
Chapter 8 fcs register
F Commands
fcs register
To register FCS attributes, use the fcs register command in configuration mode. To disable this feature, use the no form of the command. fcs register platform name name vsan vsan-id fcs register no platform name name vsan vsan-id
Syntax Description
platform name name vsan vsan-id
Specifies name of the platform to register. Maximum size is 255 characters. Specifies the VSAN ID. The range is 1 to 4096.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to register FCS attributes.

switch# config terminal switch(config)# fcs register switch(config-fcs-register)# platform Platform1 vsan 10
Related Commands
Command show fcs
Description Displays fabric configuration server information.
8-36
Chapter 8
F Commands fcsp
fcsp
To configure an Fibre Channel Security Protocol (FC-SP) authentication mode for a specific interface in a FC-SP-enabled switch, use the fcsp command. To disable an FC-SP on the interface, use the no form of the command. fcsp {auto-active | auto-passive | on | off} [timeout-period] no fcsp
Syntax Description
auto-active auto-passive on off timeout-period
Configures the auto-active mode to authenticate the specified interface. Configures the auto-passive mode to authenticate the specified interface. Configures the auto-active mode to authenticate the specified interface. Configures the auto-active mode to authenticate the specified interface. Specifies the time out period to reauthenticate the interface. The time ranges from 0 (defaultno authentication is performed) to 100,000 minutes.
Defaults
Auto-passive.
Command Modes
Configuration mode.
Command History
Usage Guidelines
To use this command, FC-SP must be enabled using the fcsp enable command.
Examples
The following example turns on the authentication mode for ports 1 to 3 in Fibre Channel interface 2.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# interface fc 2/1 - 3 switch(config-if)# fcsp on switch(config-if)#
The following example reverts to the factory default of auto-passive for these three interfaces.
switch(config-if)# no fcsp
The following example changes these three interfaces to initiate FC-SP authentication, but does not permit reaunthentication.
switch(config-if)# fcsp auto-active 0
The following example changes these three interfaces to initiate FC-SP authentication and permits reaunthentication within two hours (120 minutes) of the initial authentication attempt.
switch(config-if)# fcsp auto-active 120
8-37
Chapter 8 fcsp
F Commands
Related Commands Command fcsp enable show interface Description Enable FC-SP. Displays an interface configuration for a specified interface.
8-38
Chapter 8
F Commands fcsp dhchap
fcsp dhchap
To configure DHCHAP options in a switch, use the fcsp dhchap command in configuration mode. This command is only available when the FC-SP feature is enabled. Use the no form of the command to revert to factory defaults. fcsp dhchap {devicename switch-wwn password [0 | 7] password | dhgroup [0 | 1| 2 | 3 | 4] | hash [md5 | sha1] | password [0 | 7] password [wwn wwn-id] no fcsp dhchap {devicename switch-wwn password [0 | 7] password | dhgroup [0 | 1| 2 | 3 | 4] | hash [md5 | sha1] | password [0 | 7] password [wwn-id]
Syntax Description
devicename switch-wwn dhgroup 0 1| 2 | 3 | 4 hash md5 sha1 password 0 7 password wwn-id
Configures a password of another device in the fabric Provides the WWN of the device being configured Configures DHCHAP Diffie-Hellman group priority list. Null DHno exchange is performed (default). Specifies one or more of the groups specified by the standards. Configures DHCHAP Hash algorithm priority list in order of preference. Specifies the MD5 Hash algorithm. Specifies the SHA-1 Hash algorithm Configures DHCHAP password for the local switch. Specifies a clear text password. Specifies a password in encrypted text. Provides the password with a maximum of 64 alphanumeric characters The WWN ID with the format hh:hh:hh:hh:hh:hh:hh:hh.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
You can only see the fcsp dhchap command if you issue the fcsp enable command. Using SHA-1 as the hash algorithm may prevent RADIUS or TACACS+ usage. If you change the DH group configuration, ensure to change it globally for all switches in the fabric.
8-39
Chapter 8 fcsp dhchap
F Commands
Examples The following example enables FC-SP.
switch## config terminal switch(config)# # fcsp enable switch (config)#
The following example configures the use of only the SHA-1 hash algorithm.
switch(config)# fcsp dhchap hash sha1
The following example configures the use of only the MD-5 hash algorithm.
switch(config)# fcsp dhchap hash md5
The following example defines the use of the default hash algorithm priority list of MD-5 followed by SHA-1 for DHCHAP authentication.
switch(config)# fcsp dhchap hash md5 sha1
The following example reverts to the factory default priority list of the MD-5 hash algorithm followed by the SHA-1 hash algorithm.
switch(config)# no fcsp dhchap hash sha1
The following example prioritizes the use of DH group 2, 3, and 4 in the configured order.
switch(config)# fcsp dhchap group 2 3 4
The following example reverts to the DHCHAP factory default order of 0, 4, 1, 2, and 3 respectively.
switch(config)# no fcsp dhchap group 0
The following example configures a clear text password for the local switch.
switch(config)# fcsp dhchap password 0 mypassword
The following example configures a clear text password for the local switch to be used for the device with the specified WWN.
switch(config)# fcsp dhchap password 0 mypassword 30:11:bb:cc:dd:33:11:22
The following example removes the clear text password for the local switch to be used for the device with the specified WWN.
switch(config)# no fcsp dhchap password 0 mypassword 30:11:bb:cc:dd:33:11:22
The following example configures a password entered in an encrypted format for the local switch.
switch(config)# fcsp dhchap password 7 sfsfdf
The following example configures a password entered in an encrypted format for the local switch to be used for the device with the specified WWN.
switch(config)# fcsp dhchap password 7 sfsfdf 29:11:bb:cc:dd:33:11:22
The following example removes the password entered in an encrypted format for the local switch to be used for the device with the specified WWN.
switch(config)# no fcsp dhchap password 7 sfsfdf 29:11:bb:cc:dd:33:11:22
The following example configures a clear text password for the local switch to be used with any connecting device.
switch(config)# fcsp dhchap password mypassword1
8-40
Chapter 8
F Commands fcsp dhchap
The following example configures a password for another switch in the fabric which is identified by the Switch WWN device name.
switch(config)# fcsp dhchap devicename 00:11:22:33:44:aa:bb:cc password NewPassword
The following example removes the password entry for this switch from the local authentication database.
switch(config)# no fcsp dhchap devicename 00:11:22:33:44:aa:bb:cc password NewPassword
The following example configures a clear text password for another switch in the fabric which is identified by the Switch WWN device name.
switch(config)# fcsp dhchap devicename 00:11:55:66:00:aa:bb:cc password 0 NewPassword
The following example configures a password entered in an encrypted format for another switch in the fabric which is identified by the Switch WWN device name.
switch(config)# fcsp dhchap devicename 00:11:22:33:55:aa:bb:cc password 7 asdflkjh
Related Commands
Command fcsp enable show fcsp
Description Enable FC-SP. Displays configured FC-SP information.
8-41
Chapter 8 fcsp enable
F Commands
fcsp enable
To enable the Fibre Channel Security Protocol (FC-SP) in a switch, use the fcsp enable command in configuration mode. Further FC-SP commands are available when the FC-SP feature is enabled. To disable FC-SP, use the no form of the command. fcsp enable no fcsp enable
Syntax Descriptionf
fcsp enable
Specifies the FC-SP feature in the switch. Enables the FC-SP feature in this switch.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example enables FC-SP.

switch# config terminal switch(config)# fcsp enable switch(config)#
Related Commands
Command show fcsp
Description Displays configured FC-SP information.
8-42
Chapter 8
F Commands fcsp timeout
fcsp timeout
To configure the timeout value for FC-SP message, use the fcsp timeout command in configuration mode. Use the no form of the command to revert to factory defaults. fcsp timeout timeout-period no fcsp timeout timeout-period
Syntax Description
timeout-period
Specifies the time out period. The time ranges from 20 to 100 seconds. The default is 30 seconds.
Defaults
30 seconds
Command Modes
Configuration mode.
Command History
Usage Guidelines
You can only see the fcsp timeout command if you issue the fcsp enable command.
Examples
The following example configures the FCSP timeout value.

switch# config terminal switch(config)# fcsp enable switch(config)# fcsp timeout 60
Related Commands
Command fcsp enable show fcsp
Description Enable FC-SP. Displays configured FC-SP information.
8-43
Chapter 8 fctimer
F Commands
fctimer
To change the default Fibre Channel timers, use the fctimer command in configuration mode. To revert to the default values, use the no form of the command. fctimer {d_s_tov milliseconds [vsan vsan-id] | e_d_tov milliseconds [vsan vsan-id] | r_a_tov milliseconds [vsan vsan-id]} no fctimer {d_s_tov milliseconds [vsan vsan-id] | e_d_tov milliseconds [vsan vsan-id] | r_a_tov milliseconds [vsan vsan-id]}
Syntax Description
d_s_tov milliseconds e_d_tov milliseconds r_a_tov milliseconds vsan vsan-id
Specifies the distributed services time out value. The range is 5000 to 100000 milliseconds. Specifies the error detect time out value. The range is 1000 to 100000 milliseconds, with a default of 2000. Specifies the resolution allocation time out value. The range is 5000 to 100000 milliseconds, with a default of 10000. Specifies the VSAN ID. The range is 1 to 4096.
Command Modes
Configuration mode.
Command History
Usage Guidelines
The Cisco MDS 9000, Brocade, and McData FC Error Detect (ED_TOV) and Resource Allocation (RA_TOV) timers default to the same values. They can be changed if needed. In accordance with the FC-SW2 standard, these values must be the same on each switch within in the fabric. Use the vsan option to configure different TOV values for VSANs with special types of links like FC or IP tunnels.
Examples
The following examples show how to change the default Fibre Channel timers.
switch# config terminal switch(config)# fctimer e_d_tov 5000 switch(config)# fctimer r_a_tov 7000
Related Commands
Command show fctimer
Description Displays the configured Fibre Channel timer values.
8-44
Chapter 8
F Commands fctimer abort
fctimer abort
To discard a Fibre Channel timer (fctimer) Cisco Fabric Services (CFS) distribution session in progress, use the fctimer abort command in configuration mode. fctimer abort
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to discard a CFS distribution session in progress.
switch# config terminal switch(config)# fctimer abort
Related Commands
Command fctimer distribute show fctimer
Description Enables CFS distribution for fctimer. Displays fctimer information.
8-45
Chapter 8 fctimer commit
F Commands
fctimer commit
To apply the pending configuration pertaining to the Fibre Channel timer (fctimer) Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the fctimer commit command in configuration mode. fctimer commit
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to commit changes to the active Fibre Channel timer configuration.
switch# config terminal switch(config)# fctimer commit
Related Commands
Command fctimer distribute show fctimer
Description Enables CFS distribution for fctimer. Displays fctimer information.
8-46
Chapter 8
F Commands fctimer distribute
fctimer distribute
To enable Cisco Fabric Services (CFS) distribution for Fibre Channel timer (fctimer), use the fctimer distribute command. To disable this feature, use the no form of the command. fctimer distribute no fctimer distribute
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Command History
Release 2.0(1b)
Usage Guidelines
Before distributing the Fibre Channel timer changes to the fabric, the temporary changes to the configuration must be committed to the active configuration using the fctimer commit command.
Examples
The following example shows how to change the default Fibre Channel timers.
switch# config terminal switch(config)# fctimer distribute
Related Commands
Command fctimer commit show fctimer
Description Commits the Fibre Channel timer configuration changes to the active configuration. Displays fctimer information.
8-47
Chapter 8 fctrace
F Commands
fctrace
To trace the route to an N port, use the fctrace command in EXEC mode. fctrace {device-alias aliasname | fcid fcid vsan vsan-id [timeout value] | pwwn pwwn-id [timeout seconds]}
Syntax Description
device-alias aliasname fcid fcid pwwn pwwn-id vsan vsan-id timeout seconds
Specifies the device alias name. Maximum length is 64 characters. The FCID of the destination N port, with the format 0xhhhhhh The PWWN of the destination N port, with the format hh:hh:hh:hh:hh:hh:hh:hh. Specifies a VSAN ID. The range is 1 to 4093. Configures the timeout value. The range is 1 to 10.
Defaults
By default, the period to wait before timing out is 5 seconds.
Command Modes
EXEC mode.
Command History
Release 1.0(2) 2.0(1b)
Modification This command was introduced. Added the device-alias aliasname option.
Usage Guidelines
None.
Examples
The following example traces a route to the specified fcid in VSAN 1.

switch# fctrace fcid 0x660000 vsan 1 Route present for : 0x660000 20:00:00:05:30:00:5f:1e(0xfffc65) Latency: 0 msec 20:00:00:05:30:00:61:5e(0xfffc66) Latency: 0 msec 20:00:00:05:30:00:61:5e(0xfffc66)
The following example traces a route to the specified device alias in VSAN 1.
switch# fctrace device-alias x vsan 1 Route present for : 21:01:00:e0:8b:2e:80:93 20:00:00:05:30:00:4a:e2(0xfffc67)
8-48
Chapter 8
F Commands fc-tunnel
fc-tunnel
To terminate a Fibre Channel tunnel in a destination switch, use the fc-tunnel command. To remove a configuration or revert it to factory defaults, use the no form of the command. fc-tunnel {enable | explicit-path name [next-address ip-address {loose | strict}] | tunnel-id-map tunnel-id interface fc slot-number} no fc-tunnel {enable | explicit-path name | tunnel-id-map tunnel-id}
Syntax Description
enable explicit-path name next-address ip-address loose strict tunnel-id-map tunnel-id interface fc slot/port
Enables the FC tunnel feature Specifies an explicit path. Maximum length is 16 characters. Specifies the IP address of the next hop switch. Specifies that a direct connection to the next hop is not required. Specifies that a direct connection to the next hop is required. Specifies fc-tunnel id to outgoing interface. The range is 1 to 255. Configures the Fiber Channel interface in the destination switch.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
All VSANs with RSPAN traffic must be enabled. If a VSAN containing RSPAN traffic is not enabled, it will be dropped. The FC tunnel can only be configured in the same subnet as the VSAN interface. The Fibre Channel tunnel feature must be enabled (the interface fc-tunnel command) on each switch in the end-to-end path of the Fibre Channel fabric in which RSPAN is to be implemented
8-49
Chapter 8 fc-tunnel
F Commands
Examples The following example enables the FC tunnel feature.
switch# config terminal switchS(config)# fc-tunnel enable
The following example places you at the explicit path prompt for the path named Path 1and specifies that the next hop VSAN interface IP addresses.
switch# config terminal switchS(config)# fc-tunnel explicit-path Path1 switchS(config-explicit-path)# next-address 10.10.10.2 strict switchS(config-explicit-path)# next-address 10.10.10.3 strict switchS(config-explicit-path)# next-address 10.10.10.4 strict
The following example places you at the explicit path prompt for the path named Path 3 and configures a minimum cost path in which this IP address exists.
switchS(config)# fc-tunnel explicit-path Path3 switchS(config-explicit-path)# next-address 10.10.10.3 loose
The following example configures the FC tunnel (100) in the destination switch (switch D).
switchD(config)# fc-tunnel tunnel-id-map 100 interface fc2/1
The following example creates two explicit paths and configures the next hop addresses for each path in the source switch (switch S).
switchS# config t switchS(config)# fc-tunnel explicit-path Path1 switchS(config-explicit-path)# next-address 10.10.10.2 switchS(config-explicit-path)# next-address 10.10.10.3 switchS(config-explicit-path)# next-address 10.10.10.4 switchS(config-explicit-path)# exit switchS(config)# fc-tunnel explicit-path Path3 switchS(config-explicit-path)# next-address 10.10.10.3
strict strict strict
loose
The following example references the configured path in the source switch (switch S).
switchS# config t switchS(config)# interface fc-tunnel 100 switchS(config)# explicit-path Path1
Related Commands
Command show span session show fc-tunnel tunnel-id-map
Description Displays all SPAN session information. Displays FC tunnel egress mapping information
8-50
Chapter 8
F Commands ficon swap
ficon swap
To enable the FICON feature in a specified VSAN, use the ficon swap command in configuration mode. ficon swap portnumber port-number port-number [after swap noshut]
Syntax Description
portnumber port-number after swap noshut
Configures the FICON port number for this interface. Specifies the port numbers that must be swapped Initializes the port shut down after the ports are swapped.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The ficon swap portnumber old-port-number new port-number command causes all configuration associated with old-port-number and new port-number to be swapped, including VSAN configurations. This command is only associated with the two ports in concerned. You must issue this VSAN-independent command from the EXEC mode. If you specify the ficon swap portnumber after swap noshut command, the ports will automatically be initialize. Refer to the Cisco MDS 9000 Family Configuration Guide for further information.
Examples
The following example swaps the contents of ports 3 with port 15, shuts them down, and automatically initializes both ports.
switch# ficon swap portnumber 3 15 after swap noshut
The following example swaps the contents of ports 3 with port 15 and shuts them down.
switch# ficon swap portnumber 3 15
Related Commands
Command show ficon
8-51
Chapter 8 ficon vsan (EXEC mode)
F Commands
ficon vsan (EXEC mode)

To configure FICON related parameters in EXEC mode, use the ficon vsan command. To remove the configuration or revert to the default values, use the no form of the command. ficon vsan vsan-id | apply file file-name | copy file old-file-name new-file-name | offline | online}
Syntax Description
vsan-id apply file file-name copy file old-file-name new-file-name offline online
Enters the FICON configuration mode for the specified VSAN (from 1 to 4096). Specifies the existing FICON configuration file name after switch initialization. Maximum length is 80 characters. Makes a copy of the specified FICON configuration file. Specifies the old (existing) FICON configuration file name Specifies the new name for the copied file. Logs out all ports in the VSAN that needs to be suspended. Removes the offline condition and to allow ports to log on again.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
When an MDS switch is booting up with saved configuration, if FICON is enabled on a VSAN, the IPL configuration file is applied automatically by the SAN-OS software after the switch initialization is completed. Use the ficon vsan vsan-id copy file exiting-file-name save-as-file-name command to copy an existing FICON configuration file. You can see the list of existing configuration files by issuing the show ficon vsan vsan-id command
Examples
The following example applies the configuration from the saved files to the running configuration.
switch# ficon vsan 2 apply file SampleFile
The following example copies an existing FICON configuration file called IPL and renames it to IPL3.
switch# ficon vsan 20 copy file IPL IPL3
Related Commands
Command show ficon
8-52
Chapter 8
F Commands ficon vsan (configuration mode)
ficon vsan (configuration mode)

To enable the FICON feature in a specified VSAN, use the ficon vsan command in configuration mode. To disable the feature or to revert to factory defaults, use the no form of the command. ficon vsan vsan-id
Syntax Description
vsan vsan-id
Enters the FICON configuration mode for the specified VSAN (from 1 to 4096).
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
An IPL configuration file is automatically created Once you enable FICON, you cannot disable in-order delivery, fabric binding, or static domain ID configurations. When you disable FICON, the FICON configuration file is also deleted.
Examples
The following example is enables FICON on VSAN 2.

switch(config)# ficon vsan 2
The following example is disables FICON on VSAN 6.

switch(config)# no ficon vsan 6
Related Commands
Command show ficon
8-53
Chapter 8 file
F Commands
file
To access FICON configuration files in a specified VSAN, use the file command. To disable the feature or to revert to factory defaults, use the no form of the command. file file-name no file file-name
Syntax Description
file file-name
Creates or accesses the FICON configuration file in the specified VSAN
Defaults
None.
Command Modes
Command History
Usage Guidelines
The configuration file submode allows you to create and edit FICON configuration files. If a specified file does not exist, it is created. Up to 16 files can be saved. Each file name is restricted to 8 alphanumeric characters.
Examples
The following example accesses the FICON configuration file called IplFile1 for VSAN 2. If this file does not exist, it is created.
switch# config terminal switch(config)# ficon vsan 2 switch(config-ficon)# file IplFile1 switch(config-ficon-file)#
The following example deletes a previously-created FICON configuration file.

switch(config-ficon)# no file IplFileA
Related Commands
Command ficon vsan show ficon
Description Enable FICON for a VSAN. Displays configured FICON details.
8-54
Chapter 8
F Commands find
find
To display a list of files on a file system, use the find command in EXEC mode. find filename
Syntax Description
filename
Specifies a search string to match to the files in the default directory. Maximum length is 64 characters.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Use the find (Flash file system) command to display more detail about the files in a particular file system.
Examples
The following example is sample output of all files that begin with the letter a:
switch# find a ./accountingd ./acl ./ascii_cfg_server ./arping
Related Commands
Command cd dir
Description Changes the default directory or file system. Displays all files in a given file system.
8-55
Chapter 8 format
F Commands
format
To erase all the information on a module, use the format command in EXEC mode. format {bootflash: | slot0:}
Syntax Description
bootflash: slot0:
Specifies bootflash: memory. Specifies the Flash device in slot 0.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The SAN-OS software only supports Cisco-certified CompactFlash devices that are formatted using Cisco MDS switches. Using uncertified CompactFlash devices may result in unpredictable consequences; formatting CompactFlash devices using other platforms may result in errors.
Examples
The following example erases all information on the bootflash memory.

switch# format bootflash:
8-56
Chapter 8
F Commands fspf config vsan
fspf config vsan

To configure an FSPF feature for the entire VSAN, use the fspf config vsan command in configuration mode. To delete FSPF configuration for the entire VSAN, use the no form of the command. fspf config vsan vsan-id min-ls-arrival ls-arrival-time min-ls-interval ls-interval-time region region-id spf {hold-time spf-holdtime | static} fspf config vsan vsan-id no min-ls-arrival no min-ls-interval no region no spf {hold-time | static} no fspf config vsan vsan-id
Syntax Description
vsan-id min-ls-arrival ls-arrival-time
Specifies a VSAN ID. The range is 1 to 4093. Specifies the minimum time before a new link state update for a domain will be accepted by switch. The parameter ls-arrival-time is an integer specifying time in milliseconds. The range is 0 to 65535.
min-ls-interval ls-interval-time Specifies the minimum time before a new link state update for a domain will be generated by the switch. The parameter ls-interval-time is an integer specifying time in milliseconds. The range is 0 to 65535. region region-id Specifies the autonomous region to which the switch belongs. The backbone region has region-id=0. The parameter region-id is an unsigned integer value ranging from 0 to 255. Specifies parameters related to SPF route computation. Specifies the time between two consecutive SPF computations. If the time is small then routing will react faster to changes but CPU usage will be more. The parameter spf-holdtime is an integer specifying time in milliseconds. The range is 0 to 65535. Forces static SPF computation.
spf hold-time spf-holdtime
static
Defaults
In the FSPF configuration mode, the default is dynamic. If configuring spf hold-time, the default value for FSPF is 0. If configuring min-ls-arrival, the default value for FSPF is 1000 msecs. If configuring min-ls-interval, the default value for FSPF is 5000 msecs.
Command Modes
Configuration mode.
Command History
8-57
Chapter 8 fspf config vsan
F Commands
Usage Guidelines This command configures FSPF on VSANs globally. For the commands issued in FSPF configuration mode, you do not have to specify the VSAN number every time. This prevents configuration errors that might result from specifying the wrong VSAN number for these commands.
Examples
The following example configures FSPF globally in VSAN 1, deletes the FSPF configured in VSAN 3, disables FSPF in VSAN 5, and enables FSPF in VSAN 7.
switch## config terminal switch(config)# # switch(config)# fspf config vsan 1 switch-config-(fspf-config)# spf static switch-config-(fspf-config)# exit switch(config)# switch(config)# no fspf config vsan 3 switch(config)#
Related Commands
Command show fspf interface fspf enable fspf cost fspf hello-interval fspf passive fspf retrasmit
Description Displays information for each selected interface. Enables FSPF routing protocol in the specified VSAN (from the switch(config-if)# prompt). Configures the cost for the selected interface in the specified VSAN (from the switch(config-if)# prompt). Specifies the hello message interval to verify the health of a link in the VSAN (from the switch(config-if)# prompt). Disables the FSPF protocol for the specified interface in the specified VSAN (from the switch(config-if)# prompt). Specifies the retransmit time interval for unacknowledged link state updates in specified VSAN (from the switch(config-if)# prompt).
8-58
Chapter 8
F Commands fspf cost
fspf cost
To configure FSPF link cost for an FCIP interface, use the fspf cost command. To revert to the default value, use the no form of the command. fspf cost link-cost vsan vsan-id no fspf cost link-cost vsan vsan-id
Syntax Description
link-cost vsan vsan-id
Enters FSPF link cost in seconds. The range is 1 to 65535. Specifies a VSAN ID. The range is 1 to 4093.
Defaults
1000 seconds for 1 Gbps 500 seconds for 2 Gbps
Command Modes
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode. FSPF tracks the state of links on all switches in the fabric, associates a cost with each link in its database, and then chooses the path with a minimal cost. The cost associated with an interface can be changed using the fspf cost command to implement the FSPF route selection.
Examples
The following example configures the FSPF link cost on an FCIP interface.
switch# config terminal switch(config)# interface fcip 1 switch(config-if)# fspf cost 5000 vsan 1
Related Commands
Command show fspf interface show interface fcip
Description Displays information for each selected interface. Displays an interface configuration for a specified FCIP interface.
8-59
Chapter 8 fspf dead-interval
F Commands
fspf dead-interval
To set the maximum interval for which a hello message must be received before the neighbor is considered lost, use the fspf dead-interval command. To revert to the default value, use the no form of the command. fspf dead-interval seconds vsan vsan-id no fspf dead-interval seconds vsan vsan-id
Syntax Description
seconds vsan vsan-id
Specifies the FSPF dead interval in seconds. The rage is 2 to 65535. Specifies a VSAN ID. The range is 1 to 4093.
Defaults
80 seconds
Command Modes
Command History
Usage Guidelines
Note
This value must be the same in the ports at both ends of the ISL.
Caution
An error is reported at the command prompt if the configured dead time interval is less than the hello time interval.
Examples
The following example configures the maximum interval of 400 seconds for a hello message before the neighbor is considered lost.
switch# config terminal switch(config)# interface fcip 1 switch(config-if)# fspf dead-interval 4000 vsan 1
Related Commands
8-60
Chapter 8
F Commands fspf enable vsan
fspf enable vsan

To enable FSPF for a VSAN, use the fspf enable command in configuration mode. To disable FSPF routing protocols, use the no form of the command. fspf enable vsan vsan-id no fspf enable vsan vsan-id
Syntax Description
vsan vsan-id
Defaults
Enabled
Command Modes
Configuration mode.
Command History
Usage Guidelines
This command configures FSPF on VSANs globally.
Examples
The following example enables FSPF in VSAN 5 and disables FSPF in VSAN 7.
switch## config terminal switch(config)# fspf enable vsan 5 switch(config)# no fspf enable vsan 7
Related Commands
Command fspf config vsan show fspf interface
Description Configures FSPF features for a VSAN. Displays information for each selected interface.
8-61
Chapter 8 fspf hello-interval
F Commands
fspf hello-interval
To verify the health of the link, use the fspf hello-interval command. To revert to the default value, use the no form of the command. fspf hello-interval seconds vsan vsan-id no fspf hello-interval seconds vsan vsan-id
Syntax Description
hello-interval seconds vsan vsan-id
Specifies the FSPF hello-interval in seconds. The rage is 2 to 65535. Specifies a VSAN ID. The range is 1 to 4093.
Defaults
20 seconds
Command Modes
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode. This command configures FSPF for the specified FCIP interface.
Note
Examples
The following example configures a hello interval of 3 seconds on VSAN 1.

switch# config terminal switch(config)# interface fcip 1 switch(config-if)# fspf hello-interval 3 vsan 1
Related Commands
8-62
Chapter 8
F Commands fspf passive
fspf passive
To disable the FSPF protocol for selected interfaces, use the fspf passive command. To revert to the default state, use the no form of the command. fspf passive vsan vsan-id no fspf passive vsan vsan-id
Syntax Description
vsan vsan-id
Defaults
FSPF is enabled.
Command Modes
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode. By default, FSPF is enabled on all E ports and TE ports. FSPF can be disabled by setting the interface as passive using the fspf passive command.
Note
FSPF must be enabled on the ports at both ends of the ISL for the protocol to operate correctly.
Examples
The following example disables the FSPF protocol for the selected interface on VSAN 1.
switch# config terminal switch(config)# interface fcip 1 switch(config-if)# fspf passive vsan 1
Related Commands
8-63
Chapter 8 fspf retransmit-interval
F Commands
fspf retransmit-interval
To specify the time after which an unacknowledged link state update should be transmitted on the interface, use the fspf retransmit-interval command. To revert to the default value, use the no form of the command. fspf retransmit-interval seconds vsan vsan-id no spf retransmit-interval seconds vsan vsan-id
Syntax Description
seconds vsan vsan-id
Specifies FSPF retransmit interval in seconds. The range is 1 to 65535. Specifies a VSAN ID. The range is 1 to 4093.
Defaults
5 seconds
Command Modes
Command History
Usage Guidelines
Note
Examples
The following example specifies a retransmit interval of 6 seconds after which an unacknowledged link state update should be transmitted on the interface for VSAN 1.
switch# config terminal switch(config)# interface fcip 1 switch(config-if)# fspf retransmit-interval 6 vsan 1
Related Commands
8-64
C H A P T E R
G Commands
9-1
Chapter 9 group
G Commands
group
To configure a Modular Exponentiation (MODP) Diffie-Hellman (DH) group for an IKE protocol policy, use the group command in IKE policy configuration submode. To revert to the default, use the no form of the command. group {1 | 2 | 3} no group
Syntax Description
1 2 3
Specifies 768-bit MODP DH group. Specifies 1024-bit MODP DH group. Specifies 1536-bit MODP DH group.
Defaults
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to configure the DH group for the IKE protocol.
switch# config terminal switch(config)# crypto ike domain ipsec switch(config-ike-ipsec)# policy 1 switch(config-ike-ipsec-policy)# group 1
Related Commands
Command crypto ike domain ipsec crypto ike enable policy
Description Enters IKE configuration mode. Enables the IKE protocol. Configures IKE policy parameters.
9-2
Chapter 9
G Commands gzip
gzip
To compress (zip) a specified file using LZ77 coding, use the gzip command in EXEC mode. gzip {bootflash: | slot0: | volatile:} filename
Syntax Description
bootflash: slot0: volatile: filename
Source location for the file to be compressed and destination of the compressed file. Source location for the file to be compressed and destination of the compressed file. Source location for the file to be compressed and destination of the compressed file.This is the default directory. The name of the file to be compressed.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
This command is useful in compressing large files. The output of the show tech-support command can directed to a file and compressed for further use. The gzip command replaces the source file with a compressed .gz file.
Examples
This example directs the output of the show tech-support command to a file (Samplefile) and then zips the file and displays the difference in the space used up in the volatile: directory:
switch# show tech-support > Samplefile Building Configuration ... switch# dir 1525859 Jul 04 00:51:03 2003 Samplefile Usage for volatile:// 1527808 bytes used 19443712 bytes free 20971520 bytes total switch# gzip volatile:Samplefile switch# dir 266069 Jul 04 00:51:03 2003 Samplefile.gz Usage for volatile:// 266240 bytes used 20705280 bytes free 20971520 bytes total
Related Commands
Command gunzip
Description Uncompresses LZ77 coded files.
9-3
Chapter 9 gunzip
G Commands
gunzip
To uncompress (unzip) LZ77 coded files, use the gunzip command in EXEC mode. gunzip {bootflash: | slot0: | volatile:} filename
Syntax Description
Source location for the compressed file and destination of the uncompressed file. Source location for the compressed file and destination of the uncompressed file. Source location for the compressed file and destination of the uncompressed file. This is the default directory. The name of the compressed file.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
This command is useful in uncompressing large files. The gunzip command replaces the compressed.gz source file with an uncompressed file.
Examples
This example unzips a compressed file on volatile: directory and displays the space used:
switch# dir 266069 Jul 04 00:51:03 2003 Samplefile.gz Usage for volatile:// 266240 bytes used 20705280 bytes free 20971520 bytes total switch# gunzip Samplefile switch# dir 1525859 Jul 04 00:51:03 2003 Samplefile Usage for volatile:// 1527808 bytes used 19443712 bytes free 20971520 bytes total
Related Commands
Command gzip
Description Compresses a specified file using LZ77 coding.
9-4
C H A P T E R
10
H Commands
10-1
Chapter 10 hash
H Commands
hash
To configure a hash algorithm for an IKE protocol policy, use the hash command in IKE policy configuration submode. To revert to the default, use the no form of the command. hash {md5 | sha} no hash
Syntax Description
md5 sha
1. MD5 = Message-Digest
Specifies the MD51 hash algorithm. Specifies the SHA2.
2. SHA = Secure Hash Algorithm
Defaults
sha
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to configure the hash algorithm for the IKE protocol.
switch# config terminal switch(config)# crypto ike domain ipsec switch(config-ike-ipsec)# policy 1 switch(config-ike-ipsec-policy)# hash md5
Related Commands
Command crypto ike domain ipsec crypto ike enable policy show crypto ike domain ipsec
Description Enters IKE configuration mode. Enables the IKE protocol. Configures IKE policy parameters. Displays IKE information for the IPsec domain.
10-2
Chapter 10
H Commands host
host
Use the host command to configure the switch offline state, the mainframe access control parameters, and the mainframe time stamp parameters. To disable the configuration or to revert to factory defaults, use the no form of the command. host {control [switch offline] | port control | set-timestamp} no host {control [switch offline] | port control | set-timestamp}
Syntax Description
control switch offline port control set-timestamp
Allows the host control of FICON. Allows the host to move the switch to an offline state and shut down the ports (default). Enables the host to configure FICON parameters. Allows the host to set the director clock
Defaults
Host offline control enabled.
Command Modes
FICON configuration mode.
Command History
Usage Guidelines
By default, the clock in each VSAN is the same as the switch hardware clock. Mainframe users are allowed to change the VSAN-clock.
Examples
The following example prohibits mainframe users from moving the switch to an offline state.
switch# config terminal switch(config)# ficon vsan 2 switch(config-ficon)# no host control switch offline
The following example allows the host to move the switch to an offline state and shut down the ports.
switch(config-ficon)# host control switch offline
The following example prohibits mainframe users to configure FICON parameters in the Cisco MDS switch (default).
switch(config-ficon)# no host port control
The following example allows mainframe users to configure FICON parameters in the Cisco MDS switch.
switch(config-ficon)# host port control
10-3
Chapter 10 host
H Commands
The following example prohibits mainframe users from changing the VSAN-specific clock.
switch(config-ficon)# no host set-timestamp
The following example allows the host to set the clock on this switch (default).
switch(config-ficon)# host set-timestamp
Related Commands
10-4
C H A P T E R
11
I Commands
11-1
Chapter 11 in-order-guarantee
I Commands
in-order-guarantee
To enable in-order delivery, use the in-order-guarantee command in configuration mode. To disable in-order delivery, use the no form of the command. in-order-guarantee [vsan vsan-id] no in-order-guarantee [vsan vsan-id]
Syntax Description
vsan vsan-id
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 1.3(4)
Usage Guidelines
In-order delivery of data frames guarantees frame delivery to a destination in the same order that they were sent by the originator.
Examples
The following example shows how to enable in-order delivery for the entire switch.
switch# config terminal switch(config) # in-order-guarantee
The following example shows how to disable in-order delivery for the entire switch.
switch(config)# no in-order-guarantee
The following example shows how to enable in-order delivery for a specific VSAN.
switch(config)# in-order-guarantee vsan 3452
The following example shows how to disable in-order delivery for a specific VSAN.
switch(config)# no in-order-guarantee vsan 101
Related Commands
Command show in-order-guarantee
Description Displays the in-order-guarantee status.
11-2
Chapter 11
I Commands initiator
initiator
To configure the initiator version and address, use the initiator command IKE configuration submode. To revert to the default, use the no form of the command. initiator version version address ip-address no initiator version version address ip-address
Syntax Description
version address ip-address
Specifies the protocol version number. The only valid value is 1. Specifies the IP address for the IKE peer. The format is A.B.C.D.
Defaults
IKE version 2.
Command Modes
IKE configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how initiator information for the IKE protocol.
switch# config terminal switch(config)# crypto ike domain ipsec switch(config-ike-ipsec)# initiator version 1 address 10.1.1.1
Related Commands
Command crypto ike domain ipsec crypto ike enable
Description Enters IKE configuration mode. Enables the IKE protocol.
11-3
Chapter 11 install all
I Commands
install all
To upgrade all modules in any Cisco MDS 9000 family switch, use the install all command. This upgrade can happen nondisruptively or disruptively depending on the current configuration of your switch. install all [{asm-sfn | kickstart | ssi | system} URL]
Syntax Description
asm-sfn filename system ssi kickstart URL
Upgrades the ASM image. Upgrades the system image. Upgrades the SSI image. Upgrades the kickstart image. The location URL of the source file to be installed.
The following table lists the aliases for URL. bootflash: slot0: volatile: tftp: ftp: sftp: scp: image-filename Source location for internal bootflash memory. Source location for the CompactFlash memory or PCMCIA card. Source location for the volatile file system. Source location for a Trivial File Transfer Protocol (TFTP) network server. The syntax for this URL is tftp:[[//location]/directory]/filename. Source location for a File Transfer Protocol (FTP) network server. The syntax for this URL is ftp:[[//location]/directory]/filename. Source location for a Secure Trivial File Transfer Protocol (SFTP) network server. The syntax for this URL is sftp:[[//<username@>location]/directory]/filename. Source location for a Secure Copy Protocol (SCP) network server. The syntax for this URL is scp:[[//location]/directory]/filename. The name of the source image file.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.0(3) 1.2(2) 2.0(1b)
Modification This command was introduced. Added the asm-sfn keyword and made all keywords optional. Added the ssi keyword.
Usage Guidelines
The install all command upgrades all modules in any Cisco MDS 9000 Family switch. To copy a remote file, specify the entire remote path exactly as it is.
11-4
Chapter 11
I Commands install all
Caution
If a switchover is required when you issue the install all command from a Telnet or SSH session, all open sessions are terminated. If no switchover is required, the session remains unaffected. The software issues a self-explanatory warning at this point and provides the option to continue or terminate the installation. See the Cisco MDS 9000 Family Configuration Guide for detailed procedures.
Examples
The following example displays the result of the install all command if the system and kickstart files are specified locally.
switch# install all sys bootflash:isan-1.3.1 kickstart bootflash:boot-1.3.1 Verifying image bootflash:/boot-1.3.1 [####################] 100% -- SUCCESS Verifying image bootflash:/isan-1.3.1 [####################] 100% -- SUCCESS Extracting slc version from image bootflash:/isan-1.3.1. [####################] 100% -- SUCCESS Extracting ips version from image bootflash:/isan-1.3.1. [####################] 100% -- SUCCESS Extracting system version from image bootflash:/isan-1.3.1. [####################] 100% -- SUCCESS Extracting kickstart version from image bootflash:/boot-1.3.1. [####################] 100% -- SUCCESS Extracting loader version from image bootflash:/boot-1.3.1. [####################] 100% -- SUCCESS
Compatibility check is done: Module bootable Impact ------ -------- -------------1 yes non-disruptive 2 yes disruptive 3 yes disruptive 4 yes non-disruptive 5 yes non-disruptive 6 yes non-disruptive
Install-type -----------rolling rolling rolling rolling reset reset
Reason -----Hitless upgrade is not supported Hitless upgrade is not supported
Images will be upgraded according to following table: Module Image Running-Version New-Version ------ ---------- -------------------- -------------------1 slc 1.3(2a) 1.3(1) 1 bios v1.1.0(10/24/03) v1.1.0(10/24/03) 2 ips 1.3(2a) 1.3(1) 2 bios v1.1.0(10/24/03) v1.1.0(10/24/03) 3 ips 1.3(2a) 1.3(1) 3 bios v1.1.0(10/24/03) v1.1.0(10/24/03) 4 slc 1.3(2a) 1.3(1) 4 bios v1.1.0(10/24/03) v1.1.0(10/24/03) 5 system 1.3(2a) 1.3(1)
Upg-Required -----------yes no yes no yes no yes no yes
11-5
I Commands
5 5 5 6 6 6 6 kickstart bios loader system kickstart bios loader 1.3(2a) v1.1.0(10/24/03) 1.2(2) 1.3(2a) 1.3(2a) v1.1.0(10/24/03) 1.2(2) 1.3(1) v1.1.0(10/24/03) 1.2(2) 1.3(1) 1.3(1) v1.1.0(10/24/03) 1.2(2) [n] y yes no no yes yes no no
Do you want to continue with the installation (y/n)? Install is in progress, please wait. Syncing image bootflash:/boot-1.3.1 to standby. [####################] 100% -- SUCCESS
Syncing image bootflash:/isan-1.3.1 to standby. [####################] 100% -- SUCCESS Jan 18 23:40:03 Hacienda %VSHD-5-VSHD_SYSLOG_CONFIG_I: Configuring console from Performing configuration copy. [####################] 100% -- SUCCESS Module 6: Waiting for module online.
|
Auto booting bootflash:/boot-1.3.1 bootflash:/isan-1.3.1... Booting kickstart image: bootflash:/boot-1.3.1.... .....................................Image verification OK Starting kernel... INIT: version 2.78 booting Checking all filesystems..r.r.. done. Loading system software Uncompressing system image: bootflash:/isan-1.3.1 CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC CCCCCCCCCCCCCCCCCCCCCCCC INIT: Entering runlevel: 3
The following example displays the file output continuation of the install all command on the console of the standby supervisor module.
Hacienda(standby)# Auto booting bootflash:/boot-1.3.1 bootflash:/isan-1.3.1... Booting kickstart image: bootflash:/boot-1.3.1.... .....................................Image verification OK Starting kernel... INIT: version 2.78 booting Checking all filesystems..r.r.. done. Loading system software Uncompressing system image: bootflash:/isan-1.3.1 CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC CCCCCCCCCCCCCCCCCCCCCCCC INIT: Entering runlevel: 3
Continue on installation process, please wait. The login will be disabled until the installation is completed. Module 6: Waiting for module online. Jan 18 23:43:02 Hacienda %PORT-5-IF_UP: Interface mgmt0 is up Jan 18 23:43:19 Hacienda %LICMGR-3-LOG_LIC_NO_LIC: No license(s) present for feature FM_SERVER_PKG. Application(s) shutdown in 53 days.
11-6
Chapter 11
Jan 18 23:43:19 Hacienda %LICMGR-3-LOG_LIC_NO_LIC: No license(s) present for feature ENTERPRISE_PKG. Application(s) shutdown in 50 days. Jan 18 23:43:19 Hacienda %LICMGR-3-LOG_LIC_NO_LIC: No license(s) present for feature SAN_EXTN_OVER_IP. Application(s) shutdown in 50 days. Jan 18 23:43:19 Hacienda %LICMGR-3-LOG_LICAPP_NO_LIC: Application port-security running without ENTERPRISE_PKG license, shutdown in 50 days Jan 18 23:43:19 Hacienda %LICMGR-4-LOG_LICAPP_EXPIRY_WARNING: Application Roles evaluation license ENTERPRISE_PKG expiry in 50 days Jan 18 23:44:54 Hacienda %BOOTVAR-5-NEIGHBOR_UPDATE_AUTOCOPY: auto-copy supported by neighbor, starting... Module 1: Non-disruptive upgrading. [# ] 0%Jan 18 23:44:56 Hacienda %MODULE-5-STANDBY_SUP_OK: Supervisor 5 is standby Jan 18 23:44:55 Hacienda %IMAGE_DNLD-SLOT1-2-IMG_DNLD_STARTED: Module image download process. Please wait until completion... Jan 18 23:45:12 Hacienda %IMAGE_DNLD-SLOT1-2-IMG_DNLD_COMPLETE: Module image download process. Download successful. Jan 18 23:45:48 Hacienda %MODULE-5-MOD_OK: Module 1 is online [####################] 100% -- SUCCESS Module 4: Non-disruptive upgrading. [# ] 0%Jan 18 23:46:12 Hacienda %IMAGE_DNLD-SLOT4-2-IMG_DNLD_STARTED: Module image download process. Please wait until completion... Jan 18 23:46:26 Hacienda %IMAGE_DNLD-SLOT4-2-IMG_DNLD_COMPLETE: Module image download process. Download successful. Jan 18 23:47:02 Hacienda %MODULE-5-MOD_OK: Module 4 is online [####################] 100% -- SUCCESS Module 2: Disruptive upgrading. ... -- SUCCESS Module 3: Disruptive upgrading. ... -- SUCCESS Install has been successful. MDS Switch Hacienda login:
The following example displays the result of the install all command if the system and kickstart files are specified remotely.
switch# install all system scp://[email protected]/tftpboot/HKrel/qa/vegas/final/m9500-sf1ek9-mz.1.3.2a.bin kickstart scp://[email protected]/tftpboot/HKrel/qa/vegas/final/m9500-sf1ek9-kickstart-mz.1.3.2a.bin For scp://[email protected], please enter password: For scp://[email protected], please enter password: Copying image from scp://[email protected]/tftpboot/HKrel/qa/vegas/final/m9500-sf1ek9-kickstart-mz.1.3.2a.bin to bootflash:///m9500-sf1ek9-kickstart-mz.1.3.2a.bin. [####################] 100% -- SUCCESS Copying image from scp://[email protected]/tftpboot/HKrel/qa/vegas/final/m9500-sf1ek9-mz.1.3.2a.bin to bootflash:///m9500-sf1ek9-mz.1.3.2a.bin. [####################] 100% -- SUCCESS Verifying image bootflash:///m9500-sf1ek9-kickstart-mz.1.3.2a.bin [####################] 100% -- SUCCESS
11-7
I Commands
Verifying image bootflash:///m9500-sf1ek9-mz.1.3.2a.bin [####################] 100% -- SUCCESS Extracting slc version from image bootflash:///m9500-sf1ek9-mz.1.3.2a.bin. [####################] 100% -- SUCCESS Extracting ips version from image bootflash:///m9500-sf1ek9-mz.1.3.2a.bin. [####################] 100% -- SUCCESS Extracting system version from image bootflash:///m9500-sf1ek9-mz.1.3.2a.bin. [####################] 100% -- SUCCESS Extracting kickstart version from image bootflash:///m9500-sf1ek9-kickstart-mz.1.3.2a.bin. [####################] 100% -- SUCCESS Extracting loader version from image bootflash:///m9500-sf1ek9-kickstart-mz.1.3.2a.bin. [####################] 100% -- SUCCESS
Compatibility check is done: Module bootable Impact ------ -------- -------------1 yes non-disruptive 2 yes disruptive 3 yes non-disruptive 4 yes non-disruptive 5 yes non-disruptive 6 yes non-disruptive 7 yes non-disruptive 8 yes non-disruptive 9 yes disruptive
Install-type -----------rolling rolling rolling rolling reset reset rolling rolling rolling
Reason -----Hitless upgrade is not supported
Hitless upgrade is not supported
Images will be upgraded according to following table: Module Image Running-Version New-Version ------ ---------- -------------------- -------------------1 slc 1.3(1) 1.3(2a) 1 bios v1.1.0(10/24/03) v1.0.8(08/07/03) 2 ips 1.3(1) 1.3(2a) 2 bios v1.1.0(10/24/03) v1.0.8(08/07/03) 3 slc 1.3(1) 1.3(2a) 3 bios v1.1.0(10/24/03) v1.0.8(08/07/03) 4 slc 1.3(1) 1.3(2a) 4 bios v1.1.0(10/24/03) v1.0.8(08/07/03) 5 system 1.3(1) 1.3(2a) 5 kickstart 1.3(1) 1.3(2a) 5 bios v1.1.0(10/24/03) v1.0.8(08/07/03) 5 loader 1.2(2) 1.2(2) 6 system 1.3(1) 1.3(2a) 6 kickstart 1.3(1) 1.3(2a) 6 bios v1.1.0(10/24/03) v1.0.8(08/07/03) 6 loader 1.2(2) 1.2(2) 7 slc 1.3(1) 1.3(2a) 7 bios v1.1.0(10/24/03) v1.0.8(08/07/03) 8 slc 1.3(1) 1.3(2a) 8 bios v1.1.0(10/24/03) v1.0.8(08/07/03) 9 ips 1.3(1) 1.3(2a) 9 bios v1.1.0(10/24/03) v1.0.8(08/07/03) Do you want to continue with the installation (y/n)? [n]
Upg-Required -----------yes no yes no yes no yes no yes yes no no yes yes no no yes no yes no yes no
11-8
Chapter 11
Related Commands Command install module bios install module loader show version Description Upgrades the supervisor or switching module BIOS. Upgrades the bootloader on the active or standby supervisor or modules. Displays software image version information.
11-9
Chapter 11 install license
I Commands
install license
To program the supervisor or switching module BIOS, use the install license command. install license [bootflash: | slot0: | volatile:] file-name
Syntax Description
bootflash: slot0: volatile: file-name
Source location for the license file. Source location for the license file. Source location for the license file. The name of the license file.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.2(1)
Usage Guidelines
If a target file name is provided after the source URL, the license file is installed with that name. Otherwise, the filename in the source URL is used. This command also verifies the license file before installing it.
Examples
The following example installs a file named license-file which resides in the bootflash: directory..
switch# install license bootflash:license-file
Related Commands
Command show license
Description Displays license information.
11-10
Chapter 11
I Commands install module bios
install module bios

To program the supervisor or switching module BIOS, use the install module bios command. install module module-number bios {system [bootflash: | slot0: | volatile: | system-image]}
Syntax Description
module-number system bootflash: slot0: volatile: system-image
From slot 1 to 9 in a Cisco MDS 9500 Series switch. From slot 1 to 2 in a Cisco MDS 9200 Series switch. Specifies the system image to use (optional). If system is not specified, the current running image is used. Source location for internal bootflash memory Source location for the CompactFlash memory or PCMCIA card. Source location for the volatile file system. The name of the system or kickstart image.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.0(3)
Usage Guidelines
If the BIOS is upgraded, you need to reboot to make the new BIOS effective. You can schedule the reboot at a convenient time so traffic will not be impacted. The console baud rate automatically reverts to the default rate (9600) after any BIOS upgrade. The URL is always the system image URL in the supervisor module, and points to the bootflash: or slot0: directories.
Examples
The following example shows how to perform a nondisruptive upgrade for the system.
switch# install module 1 bios Started bios programming .... please wait ### BIOS upgrade succeeded for module 1
In this example, the switching module in slot 1 was updated.
11-11
Chapter 11 install module epld
I Commands
install module epld

To upgrade the electrically programmable logical devices (EPLDs) module, use the install module epld command. This command is only for supervisor modules, not switching modules. install module module-number epld [bootflash: |ftp: | scp: | sftp: | tftp: | volatile:]
Syntax Description
module-number bootflash: ftp scp sftp tftp volatile:
Enters the number for the standby supervisor modules or any other line card. Source location for internal bootflash memory. Local/Remote URI containing EPLD Image. Local/Remote URI containing EPLD Image. Local/Remote URI containing EPLD Image. Local/Remote URI containing EPLD Image. Source location for the volatile file system.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.2(1)
Usage Guidelines
Issue this command from the active supervisor module to update any other module. If you forcefully upgrade a module that is not online, all EPLDs are forcefully upgraded. If the module is not present in the switch, an error is returned. If the module is present, the command process continues. Do not insert or extract any modules while an EPLD upgrade or downgrade is in progress.
Examples
The following example upgrades the EPLDs for the module in slot 2.
switch# install module 2 epld scp://[email protected]/users/dino/epld.img The authenticity of host '10.6.16.22' can't be established. RSA1 key fingerprint is 55:2e:1f:0b:18:76:24:02:c2:3b:62:dc:9b:6b:7f:b7. Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added '10.6.16.22' (RSA1) to the list of known hosts. [email protected]'s password: epld.img 100% |*****************************| 1269 KB 00:00 Module Number 2 EPLD Curr Ver New Ver ---------------------------------------------------Power Manager 0x06 XBUS IO 0x07 0x08
11-12
Chapter 11
I Commands install module epld
UD chip Fix Sahara 0x05 0x05 0x05
Module 2 will be powered down now!! Do you want to continue (y/n) ? y \ <------------------------------------------------------------progress Module 2 EPLD upgrade is successful
twirl
The following example forcefully upgrades the EPLDs for the module in slot 2.
switch# install module 2 epld scp://[email protected]/epld-img-file-path Module 2 is not online, Do you want to continue (y/n) ? y [email protected]'s password: epld.img 100% |*****************************| 1269 KB \ <------------------------------------------------------------progress twirl Module 2 EPLD upgrade is successful
00:00
Related Commands
Command show version module number epld show version epld
Description Displays the current EPLD versions. Displays the available EPLD versions.
11-13
Chapter 11 install module loader
I Commands
install module loader

To upgrade the bootloader on either the active or standby supervisor module, use the install module loader command. This command is only for supervisor modules, not switching modules. install module module-number loader kickstart [bootflash: | slot0: | volatile: | kickstart-image]
Syntax Description
module-number kickstart bootflash: slot0: volatile: kickstart-image
Enters the module number for the active or standby supervisor modules (only slot 5 or 6). Specifies the kickstart image to use. Source location for internal bootflash memory Source location for the CompactFlash memory or PCMCIA card. Source location for the volatile file system. The name of the kickstart image.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.0(3)
Usage Guidelines
Before issuing the install module loader command, be sure to read the release notes to verify compatibility issues between the boot loader and the kickstart or system images. If you install a loader version that is the same as the currently-installed version, the loader will not be upgraded. When both the current version and the installed version are the same, use the init system command to force a loader upgrade.
Examples
The following example shows how to perform a non disruptive upgrade for the system.
switch# install module 6 loader bootflash:kickstart_image
This example displays the command being issued on the standby supervisor module in slot 6.
Related Commands
Command show version
Description Verify the output before and after the upgrade.
11-14
Chapter 11
I Commands interface
interface
To configure an interface on the Cisco MDS 9000 Family of switches, use the interface command in configuration mode. interface {cpp | fc | fc-tunnel | fcip | gigabitethernet | iscsi | mgmt | port-channel | svc | vsan}
Syntax Description
cpp fc fc-tunnel fcip gigabitethernet iscsi mgmt port-channel svc vsan
Configures a Control Plane Process (CPP) interface for the Advanced Services Module (ASM)see the interface cpp command. Configures a Fiber Channel interfacesee the interface fc command. Configures a Fiber Channel link interfacesee the interface fc-tunnel command. Configures a Fibre Channel over IP (FCIP) interfacesee the interface fcip command. Configures a Gigabit Ethernet interfacesee the interface gigabitethernet command. Configures an iSCSI interfacesee the interface iscsi command. Configures a management interfacesee the interface mgmt command. Configures a PortChannel interfacesee the interface port-channel command. Configures a SAN Volume Controller (SVC) interface for the Caching Services Module (CSM)see the interface svc command. Configures a VSAN interfacesee the interface vsan command.
Defaults
Disabled.
Command Modes
Configuration mode
Command History
Release 1.0(2)
Usage Guidelines
You can specify a range of interfaces by issuing a command with the following example format: interface fc1/1 - 5 , fc2/5 - 7 The spaces are required before and after the dash ( - ) and before and after the comma ( , ).
Examples
The following example selects the mgmt 0 interface and enters interface configuration submode.
switch# config terminal switch(config)# interface mgmt 0 switch(config-if)#
11-15
Chapter 11 interface
I Commands
Related Commands Command show interface Description Displays an interface configuration for a specified interface.
11-16
Chapter 11
I Commands interface fc
interface fc
To configure a Fibre Channel interface on the Cisco MDS 9000 Family of switches, use the interface fc command in EXEC mode. To revert to defaults, use the no form of the command. interface fc slot/port channel-group {group-id [force] | auto} fcdomain rcf-reject vsan vsan-id fspf {cost link-cost vsan vsan-id | ficon portnumber portnumber | dead-interval seconds vsan vsan-id | hello-interval seconds vsan vsan-id | passive vsan vsan-id | retransmit-interval seconds vsan vsan-id} interface fc slot/port no channel-group {group-id [force] | auto} no fcdomain rcf-reject vsan vsan-id no fspf {cost link_cost vsan vsan-id | ficon portnumber portnumber | dead-interval seconds vsan vsan-id | hello-interval seconds vsan vsan-id | passive vsan vsan-id | retransmit-interval seconds vsan vsan-id}
Syntax Description
slot/port channel-group group-id force auto fcdomain rcf-reject vsan vsan-id fspf cost link-cost dead-interval seconds ficon portnumber portnumber hello-interval seconds passive retransmit-interval seconds
Specifies a slot number and port number. Adds to or removes from a Port Channel. Specifies a Port Channel group number from 1 to 128. Forcefully adds a port. Enables autocreation of port channels. Enters the interface submode. Configures the rcf-reject flag. Specifies the VSAN ID. The range is 1 to 4093. Configures FSPF parameters. Configures FSPF link cost. The range is 1 to 65535. Configures FSPF dead interval in seconds. The range is 2 to 65535. Configures FICON parameters. Configures the FICON port number for this interface. Configures FSPF hello-interval. The range is 1 to 65535. Enables or disables FSPF on the interface. Configures FSPF retransmit interface in seconds. The range is 1 to 65535.
Defaults
Disabled.
Command Modes
Configuration mode.
11-17
Chapter 11 interface fc
I Commands
Command History Release 1.0(2) 2.0(1b) Modification This command was introduced. Added the auto option to the channel-group keyword.
Usage Guidelines
You can specify a range of interfaces by issuing a command with the following example format: interfacespacefc1/1space-space5space,spacefc2/5space-space7 Refer to the Cisco MDS 9000 Family Configuration Guide for information on port number allocation. Use the no shutdown command to enable the interface. The channel-group auto command enables autocreation of port channels. If autocreation of port channels is enabled for an interface, you must first disable this configuration before downgrading to earlier software versions or before configuring the interface in a manually configured channel group.
Examples
The following example configures ports 1 to 4 in Fibre Channel interface 9.

switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# int fc9/1 - 4
The following example enables the Fibre Channel interface.

switch# config terminal switch(config)# interface fc1/1 switch(config-if)# no shutdown
The following example assigns the FICON port number to the selected Fibre Channel interface.
switch# config terminal switch(config)# interface fc1/1 switch(config-if)# ficon portnumber 15
Related Commands
Command show interface shutdown
Description Displays an interface configuration for a specified interface. Disables and enables an interface.
11-18
Chapter 11
I Commands interface fc-tunnel
interface fc-tunnel
To configure a Fibre Channel tunnel and facilitate RSPAN traffic in the Cisco MDS 9000 Family of switches, use the interface fc-tunnel command. To remove a configured tunnel or revert to factory defaults, use the no form of the command. interface fc-tunnel number destination ip-address explicit-path path-name source ip-address] no interface fc-tunnel number no destination ip-address | no explicit-path path-name no source ip-address no interface fc-tunnel number
Syntax Description
number destination ip-address
Specifies a tunnel ID range form 1 to 255. Maps the IP address of the destination switch
explicit-path path-name Specifies a name for the explicit path. Maximum length is 16 alphanumeric characters. source ip-address Maps the IP address of the source switch
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.2(1)
Usage Guidelines
None.
Examples
The following example initiates the FC tunnel (100) in the source switch (switch S).
switch(config)# config terminal switch(config)# interface fc-tunnel 100 switch(config-if)#
The following example maps the IP address of the source switch (switch S) to the FC tunnel (100).
switchS(config-if)# source 10.10.10.1
11-19
Chapter 11 interface fc-tunnel
I Commands
The following example maps the IP address of the destination switch (switch D) to the FC tunnel (100).
switch(config-if)# destination 10.10.10.2
The following example enables traffic flow through this interface.

switch(config-if)# no shutdown
The following example references the configured path in the source switch (switch S).
switch# config t switch(config)# interface fc-tunnel 100 switch(config)# explicit-path Path1
Related Commands
Command fc-tunnel explicit-path
Description Configures a new or existing next-hop path.
show interface fc-tunnel Displays an FC tunnel interface configuration for a specified interface.
11-20
Chapter 11
I Commands interface fcip
interface fcip
To configure a Fibre Channel over IP Protocol (FCIP) interface on the Cisco MDS 9000 Family of switches, use the interface fcip command. To disable a FCIP interface, use the no form of the command. interface fcip interface_number bport bport-keepalives channel-group number [force] fcdomain rcf-reject vsan vsan-id ficon portnumber portnumber | fspf {cost link-cost | dead-interval seconds | hello-interval seconds | passive | retransmit-interval seconds} vsan vsan-id passive-mode peer-info ipaddr ip-address [port number] qos control control-value data data-value special-frame peer-wwn pwwn-id tcp-connections number time-stamp [acceptable-diff number] use-profile profile-id interface fcip interface_number no bport no bport-keepalives no channel-group number [force] no fcdomain rcf-reject vsan vsan-id no ficon portnumber portnumber no fspf {cost link-cost | dead-interval seconds | hello-interval seconds | passive | retransmit-interval seconds} vsan vsan-id no qos control-value data data-value no passive-mode no peer-info ipaddr ip-address [port number] no special-frame peer-wwn pwwn-id no tcp-connections number no time-stamp [acceptable-diff number] no use-profile profile-id
Syntax Description
interface-number bport bport-keepalives channel-group number force fcdomain rcf-reject vsan vsan-id fspf cost link-cost dead-interval seconds
Configures the specified interface from 1 to 255. Sets the B port mode. Sets the B port keepalive responses. Specifies a PortChannel number from 1 to 128. Forcefully adds a port. Enters the fcdomain mode for this FCIP interface Configures the rcf-reject flag. Specifies a VSAN ID. The range is 1 to 4093. Configures FSPF parameters. Enters FSPF link cost. The range is 1 to 65535 Specifies the dead interval in seconds. The range is 1 to 65535.
11-21
Chapter 11 interface fcip
I Commands
ficon portnumber portnumber hello-interval seconds passive retransmit-interval passive-mode peer-info ipaddr ip-address port number qos control control-value data data-value special-frame peer-wwn pwwn-id switchport tcp-connections number time-stamp acceptable-diff number use-profile profile-id Configures FICON parameters. Configures the FICON port number for this interface. Specifies FSPF hello-interval in seconds. The range is 1 to 65535. Enables or disables FSPF on the interface. Specifies FSPF retransmit interface in seconds. The range is 1 to 65535. Configures a passive connection. Configures the peer information. Specifies the peer IP address. Specifies the peer port number. The range is 1 to 65535. Configures the differentiated services code point (DSCP) value to mark all IP packets. Specifies the control value for DSCP. Specifies the data value for DSCP. Configures special frames. Specifies the peer WWN for special frames. Configures switchport parameters. Specifies the number of TCP connection attempts. Valid values are 1 or 2. Configures time-stamp. Specifies the acceptable time difference for time-stamps. The range is 1 to 60000. Specifies the interface using an existing profile ID. The range is 1 to 255.
Defaults
Disabled
Command Modes
Configuration mode
Command History
Release 1.1(1) 1.3(1) 2.0(1b)
Modification This command was introduced. Added the ficon portnumber subcommand. Added the qos subcommand.
Usage Guidelines
You can specify a range of interfaces by issuing a command with the following example format: interface fcip1space-space5space,spacefcip10space-space12space Refer to the Cisco MDS 9000 Family Configuration Guide for information on port number allocation.
11-22
Chapter 11
I Commands interface fcip
Examples The following example selects an FCIP interface and enters interface configuration submode.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# interface fcip 1 switch(config-if)#
The following example assigns the FICON port number to the selected FCIP interface.
switch# config terminal switch(config)# interface fcip 51 switch(config-if)# ficon portnumber 234
Related Commands
Command show interface fcip
Description Displays an interface configuration for a specified FCIP interface.
11-23
Chapter 11 interface gigabitethernet
I Commands
interface gigabitethernet
To configure an Gigabit Ethernet interface on the Cisco MDS 9000 Family of switches, use the interface gigabitethernet command. To revert to the default values, use the no form of the command. interface gigabitethernet slot/port cdp enable channel-group group-id [force] isns profile-name interface gigabitethernet slot/port no cdp enable no channel-group no isns profile-name
Syntax Description
slot/port cdp enable channel-group group-id force isns profile-name
Specifies a slot number and port number. Enables Cisco Discovery Protocol (CDP) configuration parameters. Adds to or removes from a PortChannel. The range is 1 to 128. Forcefully adds a port. Specifies the profile name to tag the interface. Maximum length is 64 characters.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 1.0(3a) 1.1(1a) 1.3(1)
Modification This command was introduced. Added the channel-group subcommand. Added the isns subcommand.
Usage Guidelines
You can specify a range of interfaces by issuing a command with the following example format: interface gigabitethernet1/1space-space2space,spacegigabitethernet3/1space-space2
Examples
The following example configures the Gigabit Ethernet interface at slot 4 port 1.
switch# config terminal switch(config)# interface gigabitethernet 4/1 switch(config-if)#
11-24
Chapter 11
I Commands interface gigabitethernet
The following example enters a IP address and subnet mask for the selected Gigabit Ethernet interface.
switch(config-if)# ip address 10.1.1.100 255.255.255.0
The following example changes the IP maximum transmission unit (MTU) value for the selected Gigabit Ethernet interface.
switch(config-if)# switchport mtu 3000
The following example creates a VR ID for the selected Gigabit Ethernet interface, configures the virtual IP address for the VR ID (VRRP group), and assigns a priority.
switch(config-if)# vrrp 100 switch(config-if-vrrp)# address 10.1.1.100 switch(config-if-vrrp)# priority 10
The following example adds the selected Gigabit Ethernet interface to a channel group. If the channel group does not exist, it is created, and the port is shut down.
switch(config-if)# channel-group 10 gigabitethernet 4/1 added to port-channel 10 and disabled please do the same operation on the switch at the other end of the port-channel, then do no shutdown at both ends to bring them up
Related Commands
Description Displays an interface configuration for a specified interface.
11-25
Chapter 11 interface iscsi
I Commands
interface iscsi
To configure an iSCSI interface on the Cisco MDS 9000 Family of switches, use the interface iscsi command. To revert to default values, use the no form of the command. interface iscsi slot/port mode {pass-thru | store-and-forward} tcp qos value interface iscsi slot/port no mode {pass-thru | store-and-forward | cut-thru} no tcp qos value no interface iscsi slot/port
Syntax Description
slot/port mode pass-thru store-and-forward cut-thru tcp qos value
Specifies a slot number and port number. Configures a forwarding mode. Forwards one frame at a time. Forwards data in one assembled unit (default). Forwards one frame at a time without waiting for the exchange to complete. Configures the differentiated services code point (DSCP) value to apply to all outgoing IP packets. The range is 0 to 63.
Defaults
Disabled. The TCP QoS default is 0. The forwarding mode default is store-and-forward.
Command Modes
Configuration mode.
Command History
Release 1.3(1) 2.1(1)
Modification This command was introduced. Added the cut-thru option for the mode subcommand.
Usage Guidelines
To configure iSCSI interface, enable iSCSI using the iscsi enable command. You can specify a range of interfaces by issuing a command with the following example format: interface iscsi space fc1/1space-space5space,spacefc2/5space-space7
11-26
Chapter 11
I Commands interface iscsi
Examples The following example enables the iSCSI feature.
switch# config t switch(config)# iscsi enable
The following example enables the store-and-forward mode for iSCSI interfaces 9/1 to 9/4.
switch(config)# interface iscsi 9/1 - 4 switch(config-if)# mode store-and-forward
The following example reverts to using the default pass-thru mode for iSCSI interface 9/1.
switch(config)# interface iscsi 9/1 switch(config-if)# mode pass-thru
Related Commands
Command iscsi enable show interface
Description Enables iSCSI. Displays an interface configuration for a specified interface.
11-27
Chapter 11 interface mgmt
I Commands
interface mgmt
To configure a management interface on the Cisco MDS 9000 Family of switches, use the interface mgmt command in configuration mode. interface mgmt number
Syntax Description
number
Specifies the management interface number which is 0.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
When you try to shutdown a management interface(mgmt0), a follow-up message confirms your action before performing the operation. Use the force option to bypass this confirmation, if required.
Examples
The following example configures the management interface, displays the options available for the configured interface, and exits to configuration mode.
switch# config terminal switch(config)# switch(config)# interface mgmt 0 switch(config-if)# exit switch(config)#
The following example shuts down the interface without using the force option:
switch# config terminal switch(config)# interface mgmt 0 switch(config-if)# shutdown Shutting down this interface will drop all telnet sessions. Do you wish to continue (y/n)? y
The following example shuts down the interface using the force option:
switch# config terminal switch(config)# interface mgmt 0 switch(config-if)# shutdown force switch(config-if)#
11-28
Chapter 11
I Commands interface mgmt
Related Commands Command show interface mgmt Description Displays interface configuration for specified interface.
11-29
Chapter 11 interface port-channel
I Commands
interface port-channel
To configure a PortChannel interface on the Cisco MDS 9000 Family of switches, use the interface port-channel command. interface port-channel number channel mode active fcdomain rcf-reject vsan vsan-id fspf [cost link_cost | dead-interval seconds | ficon portnumber portnumber | hello-interval seconds | isns profile-name | passive | retransmit-interval seconds] interface port-channel number no channel mode active no fcdomain rcf-reject vsan vsan-id no fspf [cost link_cost | dead-interval seconds | ficon portnumber portnumber | hello-interval seconds | isns profile-name | passive | retransmit-interval seconds] no interface port-channel number
Syntax Description
number channel mode active fcdomain rcf-reject vsan vsan-id fspf cost link_cost dead-interval seconds ficon hello-interval seconds isns profile-name passive retransmit-interval seconds
Enter PortChannel number. The range is 1 to 128. Configures the channel mode for the PortChannel interface Enter the interface submode Configure the rcf-reject flag Specify the vsan range The ID of the VSAN is from 1 to 4093. Configure FSPF parameters Configure FSPF link cost Enter FSPF link cost 1-65535 Configure FSPF dead interval Enter dead interval (in sec) 2-65535 Configures FICON parameters. Configure FSPF hello-interval Enter hello interval (in sec) 1-65535 Tags this interface to the Internet Storage Name Service (iSNS) profile. SPecifies the profile name to tag the interface. Enable/disable FSPF on the interface Configure FSPF retransmit interface Enter retransmit interval (in sec) 1-65535
portnumber portnumber Configures the FICON port number for this interface.
Defaults
Disabled
Command Modes
Configuration mode
11-30
Chapter 11
I Commands interface port-channel
Command History Release 1.0(2) 1.3(1) Modification This command was introduced. Added channel mode active subcommand.
Usage Guidelines
Refer to the Cisco MDS 9000 Family Configuration Guide for information on port number allocation.
Examples
The following example enters configuration mode and configures a PortChannel interface.
switch# config terminal switch(config)# interface port-channel 32 switch(config-if)#
The following example assigns the FICON port number to the selected PortChannel port.
switch# config terminal switch(config)# interface Port-channel 1 switch(config-if)# ficon portnumber 234
Related Commands
Description Displays interface configuration for specified interface.
11-31
Chapter 11 interface vsan
I Commands
interface vsan
To configure a VSAN interface on the Cisco MDS 9000 Family of switches, use the interface vsan command. To remove a VSAN interface, use the no form of the command. interface vsan vsan-id no interface vsan vsan-id
Syntax Description
vsan-id
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example selects a VSAN interface and enters interface configuration submode.
switch# config terminal switch(config)# interface vsan 1 switch(config-if)#
Related Commands
Description Displays interface configuration for specified interface.
11-32
Chapter 11
I Commands ip access-group
ip access-group
To create an access group to use an access list, use the ip access-group command in interface mode. Use the no form of this command to negate a previously issued command or revert to factory defaults. ip access-group group-name [in | out]
Syntax Description
group-name in out
Specifies the IP access-group name. Maximum length is 64 alphanumeric characters and the text is case insensitive. Specifies that the group is for ingress traffic. Specifies that the group is for egress traffic.
Defaults
Groups are created for both ingress and egress traffic.
Command Modes
Interface mode.
Command History
Release 1.2(1)
Usage Guidelines
The access-group command controls access to an interface. Each interface can only be associated with one access list. The access group becomes active on creation. We recommend creating all rules in an access list, before creating the access group that uses this access -list. If you create an access group before an access-list, all packets in that interface are dropped, because the access list is empty. The access-group configuration for the ingress traffic applies to both local and remote traffic. The access-group configuration for the egress traffic applies only to local traffic. You can create a different access-group for each type of traffic.
Examples
The following example creates an access group called aclPermit for both the ingress and egress traffic (default)
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ip access-list aclPermit permit ip any any switch(config)# interface Gigabitethernet 3/1 switch(config-if)# ip access-group aclPermit
The following example deletes the access group called aclPermit.

switch(config-if)# no ip access-group aclPermit
11-33
Chapter 11 ip access-group
I Commands
The following example creates an access group called aclDenyTcp (if it does not already exist) for ingress traffic.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ip access-list aclDenyTcp deny tcp any any switch(config)# interface gigabitethernet 3/1 switch(config-if)# ip access-group aclDenyTcp in
The following example deletes the access group called aclDenyTcp for ingress traffic.
switch(config-if)# no ip access-group aclDenyTcp in
The following example creates an access group called aclPermitUdp (if it does not already exist) for local egress traffic.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ip access-list aclPermitUdp permit udp 192.168.32.0 0.0.7.255 any switch(config)# interface gigabitethernet 3/1 switch(config-if)# ip access-group aclPermitUdp out
The following example deletes the access group called aclPermitUdp for local egress traffic.
switch(config-if)# no ip access-group aclPermitUdp out
Related Commands
Command ip access-list show ip access-list
Description Configures IP access control lists. Displays the IP-ACL configuration information.
11-34
Chapter 11
I Commands ip access-list
ip access-list
To configure IP access control lists (ACLs), use the ip access-list command in configuration mode. To negate a previously issued command or revert to factory defaults, use the no form of the command. ip access-list list-name {deny | permit} ip-protocol {src-addr src-wildcard} {dest-addr dest-wildcard | operator port-value} [operator port port-value] [established | icmp-type icmp-value] [tos tos-value] [log-deny]
Syntax Description
list-name deny permit ip-protocol src-addr
Identifies the IP-ACL with an integer ranging from 1 to 256. Denies access if the conditions match. Provides access if the conditions match. Specifies the name or number (integer range from 0 to 255) of an IP protocol. The IP protocol name can be icmp, ip, tcp, or udp. Specifies the network from which the packet is sent. There are two ways to specify the source:

A 32-bit quantity in four-part, dotted-decimal format A keyword any as an abbreviation for a destination and a destination-wildcard of 0.0.0.0 255.255.255.255
src-wildcard
Applies the wildcard bits to the source. Each wildcard bit set to zero indicates that the corresponding bit position in the packets IP address must exactly match the bit value in the corresponding position of the packets ip address or it will not be considered a match to this access list. There are two ways to specify the destination wildcard:

dest-addr
Specifies the network from which the packet is sent. There are two ways to specify the destination:

dest-wildcard
Applies the wildcard bits to the destination. There are two ways to specify the destination wildcard:

11-35
Chapter 11 ip access-list
I Commands
operator Compares source or destination ports and has the following options: any = Any destination IP eq = Equal source port gt = Greater than and including source port lt = Less than and including source port range port = Source port range port-value Specifies the decimal number (ranging from 0 to 65535) or one of the following names to indicate a TCP or UDP port. The TCP port names are: dns, ftp, ftp-data, http, ntp, radius, sftp, smtp, snmp, snmp-trap, ssh, syslog, tacacs-ds, telnet, wbem-http, wbem-https, and www. The UDP port names are: dns, ftp, ftp-data, http, ntp, radius, sftp, smtp, snmp, snmp-trap, ssh, syslog, tacacs-ds, telnet, tftp, wbem-http, wbem-https, and www. icmp-type icmp-value Filters ICMP packets by ICMP message type. The range is 0 to 255. The types include: echo, echo-reply, redirect, time-exceeded, traceroute, and unreachable. Indicates an established connection for the TCP protocol. A match occurs if the TCP datagram has the ACK, FIN, PSH, RST, SYN or URG control bits set. The non-matching case is that of the initial TCP datagram to form a connection. Filters packets by the following type of service level: normal-service (0), monetary-cost (1), reliability (2), throughput (4), and delay (8). Sends an information logging message to the console about the packet that is denied entry.
port port-value
established
tos tos-value log-deny
Defaults
Denied.
Command Modes
Configuration mode.
Command History
Release 1.2(1)
Usage Guidelines
Using the log-deny option at the end of the individual ACL entries shows the ACL number and whether the packet was permitted or denied, in addition to port-specific information. This option causes an information logging message about the packet that matches the dropped entry (or entries).
Examples
The following example configures the an IP-ACL called aclPermit and permits IP traffic from any source address to any destination address
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ip access-list aclPermit permit ip any any
11-36
Chapter 11
I Commands ip access-list
The following example removes the IP-ACL called aclPermit.
switch(config-if)# no ip access-group aclPermit
The following example updates aclPermit to deny TCP traffic from any source address to any destination address.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ip access-list aclPermit deny tcp any any
The following example defines an IP-ACL that permits this network. Subtracting 255.255.248.0 (normal mask) from 255.255.255.255 yields 0.0.7.255.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ip access-list aclPermitUdp permit udp 192.168.32.0 0.0.7.255 any
The following example permits all IP traffic from and to the specified networks.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ip access-list aclPermitIpToServer permit ip 10.1.1.0 0.0.0.255 172.16.1.0 0.0.0.255
The following example denies TCP traffic from 1.2.3.0 through source port 5 to any destination.
switch# config terminal Enter configuration commands, one per line. End with CNTL/ switch(config)# ip access-list aclDenyTcpIpPrt5 deny tcp 1.2.3.0 0.0.0.255 eq port 5 any
The following example removes this entry from the IP-ACL.

switch# config terminal Enter configuration commands, one per line. End with CNTL/ switch(config)# no ip access-list aclDenyTcpIpPrt5 deny tcp 1.2.3.0 0.0.0.255 eq port 5 any
Related Commands
Command show ip access-list
Description Displays the IP-ACL configuration information.
11-37
Chapter 11 ip address (FCIP profile configuration submode)
I Commands
ip address (FCIP profile configuration submode)

To assign the local IP address of a Gigabit Ethernet interface to the FCIP profile, use the ip address command. To remove the IP address, use the no form of the command. ip address address no ip address address
Syntax Description
address
Specifies the IP address.
Defaults
Disabled
Command Modes
FCIP profile configuration submode
Command History
Release 1.3(1)
Usage Guidelines
To create a FCIP profile, you must assign a local IP address of a Gigabit Ethernet interface to the FCIP profile.
Examples
The following example assigns the local IP address of a Gigabit Ethernet interface to the FCIP profile.
switch# config terminal switch(config)# fcip profile 5 switch(config-profile)# ip address 10.5.1.1
Related Commands
11-38
Chapter 11
I Commands ip address (interface configuration submode)
ip address (interface configuration submode)

To assign an IP address to a Gigabit Ethernet interface, use the ip address command in interface configuration submode. To remove the IP address, us the no form of the command. ip address address netmask no ip address address netmask
Syntax Description
address netmask
Specifies the IP address. Specifies the network mask.
Defaults
None.
Command Modes
Command History
Release 1.1(2)
Usage Guidelines
None.
Examples
The following example assigns an IP address to a Gigabit Ethernet interface.

switch# config terminal switch(config)# interface gigabitethernet 1/2 switch(config-profile)# ip address 10.5.1.1 255.255.0.0
Related Commands
11-39
Chapter 11 ip-compression
I Commands
ip-compression
To enable compression on the FCIP link, use the ip-compression command in interface configuration submode. To disable compression, use the no form of the command. ip-compression [auto | mode1 | mode2 | mode3] no ip-compression [auto | mode1 | mode2 | mode3]
Syntax Description
auto mode1
Enables automatic compression setting. Enables fast compression for the following high bandwidth links: IPS-4 and IPS-8, less then 100 Mbps MPS-14/2, up to 1 Gbps Enables moderate compression for medium bandwidth links less then 25 Mbps. Enables compression for bandwidth links less then 10 Mbps.
mode2 mode3
Defaults
Disabled.
Command Modes
Command History
Release 1.3(1) 2.0(1b)
Modification This command was introduced. Changed the keywords from high-throughput and high-comp-ratio to mode1, mode2, and mode3.
Usage Guidelines
When no compression mode is entered in the command, the default is auto. The FCIP compression feature introduced in Cisco SAN-OS Release 1.3 allows IP packets to be compressed on the FCIP link if this feature is enabled on that link. By default the FCIP compression is disabled. When enabled, the software defaults to using the auto mode (if a mode is not specified). Cisco SAN-OS Release 2.0(1b) and later, you to configure FCIP compression using one of the following modes:

mode1 is a fast compression mode for high bandwidth links (> 25 Mbps) mode2 is a moderate compression mode for moderately low bandwidth links (between 10 and 25 Mbps) mode3 is a high compression mode for low bandwidth links (< 10 Mbps) auto (default) mode picks the appropriate compression scheme based on the bandwidth of the link (the bandwidth of the link configured in the FCIP profiles TCP parameters)
11-40
Chapter 11
I Commands ip-compression
The IP compression feature behavior differs between the IPS module(s) and the MPS-14/2 modulewhile mode2 and mode3 perform software compression in both modules, mode1 performs hardware-based compression in MPS-14/2 modules, and software compression in IPS-4 and IPS-8 modules. In Cisco MDS SAN-OS Release 2.1(1a) and later, the auto mode option uses a combination of compression modes to effectively utilize the WAN bandwidth. The compression modes change dynamically to maximize the WAN bandwidth utilization.
Examples
The following example enables faster compression.

switch# config terminal switch(config) interface fcip 1 switch(config-if)# ip-compression mode1
The following example enables automatic compression by default.

switch(config-if)# ip-compression
The following example disables compression.

switch(config-if)# no ip-compression
Related Commands
11-41
Chapter 11 ip default-gateway
I Commands
ip default-gateway
To configure the IP address of the default gateway, use the ip default-gateway command. To disable the IP address of the default gateway, use the no form of the command. ip default-gateway destination-ip-address [interface cpp slot_number/processor-number/vsan-id] no ip default-gateway destination-ip-address [interface cpp slot/processor-number/vsan-id]
Syntax Description
destination-ip-address interface cpp slot processor-number vsan-id
Specifies the IP address, Configures an interface. Specifies a virtualization IPFC interface. Specifies a slot number of the ASM. Specifies the processor number for the IPFC interface. The current processor number is always 1. Specifies the ID of the management VSAN. The range 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following examples configures the IP default gateway to 1.1.1.4.

switch# config terminal switch(config)# ip default-gateway 1.1.1.4
Related Commands
Command show ip route
Description Displays the IP address of the default gateway.
11-42
Chapter 11
I Commands ip default-network
ip default-network
To configure the IP address of the default network, use the ip default-network command in configuration mode. To disable the IP address of the default network, use the no form of the command. ip default-network ip-address no ip default-network ip-address
Syntax Description
ip-address
Specifies the IP address of the default network.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following examples configures the IP address of the default network to 1.1.1.4.
switch# config terminal switch(config)# ip default-network 1.1.1.4
11-43
Chapter 11 ip domain-list
I Commands
ip domain-list
To configure the IP domain list, use the ip domain-list command in configuration mode. To disable the IP domain list, use the no form of the command. ip domain-list domain-name no ip domain-list domain-name
Syntax Description
domain-name
Specifies the domain name for the IP domain list. Maximum length is 80 characters.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example configures the IP domain list.

switch# config terminal switch(config)# ip domain MyList
11-44
Chapter 11
I Commands ip domain-lookup
ip domain-lookup
To enable the DNS server lookup feature, use the ip domain-lookup command in configuration mode. Use the no form of this command to disable this feature. ip domain-lookup no ip domain-lookup
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
Instead of IP addresses, you can configure the switch using meaningful names. The configured name automatically looks up the corresponding IP address.
Examples
The following example configures a DNS server lookup feature.

switch# config terminal switch(config)# ip domain-lookup
11-45
Chapter 11 ip domain-name
I Commands
ip domain-name
To configure a domain name, use the ip domain-name command in configuration mode. To delete a domain name, use the no form of the command. ip domain-name domain-name no ip domain-name domain-name
Syntax Description
domain-name
Specifies the domain name.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example configures a domain name.

switch# config terminal switch(config)# ip domain-name MyDomain
11-46
Chapter 11
I Commands ip name-server
ip name-server
To configure a name server, use the ip name-server command in configuration mode. To disable this feature, use the no form of the command. ip name-server ip-address no ip name-server ip-address
Syntax Description
ip-address
Specifies the IP address for the name server.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
You can configure a maximum of six servers. By default, no server is configured.
Examples
The following example configure a name server with an IP address of 1.1.1.4.

switch# config terminal switch(config)# ip name-server 1.1.1.4
The following example specifies the first address (15.1.0.1) as the primary server and the second address (15.2.0.0) as the secondary sever.
switch(config)# ip name-server 15.1.0.1 15.2.0.0
The following example deletes the configured server(s) and reverts to factory default.
switch(config)# no ip name-server
11-47
Chapter 11 ip route
I Commands
ip route
To configure a static route, use the ip route command in configuration mode. ip route ip-address subnet-mask [nexthop_ip-address] [interface {gigabitethernet slot /port | mgmt 0 | port-channel channel-id | vsan vsan-id} | distance distance-number] no ip route ip-address subnet-mask [nexthop_ip-address] [interface {gigabitethernet slot /port | mgmt 0 | port-channel channel-id | vsan vsan-id} | distance distance-number]
Syntax Description
ip-address subnet-mask nexthop_ip-address interface gigabitethernet slot /port mgmt 0 port-channel channel-id vsan vsan-id distance distance-number
Specifies the IP address for the route. Specifies the subnet mask for the route. Specifies the IP address of the next hop switch. Configures the interface associated with the route. Specifies a Gigabit Ethernet interface at a port and slot. Specifies the managment interface (mgmt 0). Specifies a PortChannel interface. The range is 1 to 128. Specifies a VSAN ID. The range is 1 to 4093. Specifies the distance metric for this route. It can be from 0 to 32766.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following examples shows how to configure a static route.

switch# config terminal switch(config)# IP route 10.0.0.0 255.0.0.0 20.20.20.10 distance 10 interface vsan 1
Related Commands
Command show ip route
Description Displays the IP address routes configured in the system.
11-48
Chapter 11
I Commands ip routing
ip routing
To enable the IP forwarding feature, use the ip routing command in configuration mode. To disable this feature, use the no form of the command. ip routing no ip routing
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example enables the IP forwarding feature.

switch# config terminal switch(config)# ip routing
11-49
Chapter 11 iscsi authentication
I Commands
iscsi authentication
To configure the default authentication method for iSCSI, use the iscsi authentication command. To revert to the default, use the no form of the command. iscsi authentication {chap | chap-none | none | username username password [0 | 7] password} no iscsi authentication {chap | chap-none | none | username}
Syntax Description
chap-none chap none username username password 0 7 password
Configure either the CHAP or no authentication. Configures the Challenge Handshake Authentication Protocol (CHAP) authentication method. Specifies that no authentication is required for the selected interface Assigns CHAP username to be used when switch is authenticated. Configures the password for the username. Specifies that the password is a cleartext CHAP password. Specifies that the password is an encrypted CHAP password. Specifies a password for the username.
Defaults
chap-none The default password is a cleartext password.
Command Modes
Configuration mode
Command History
Release 1.1(1) 2.0(1b)
Modification This command was introduced. Added the username option.
Usage Guidelines
By default, the Cisco MDS 9000 Family switch accepts an iSCSI initiator with either no authentication or CHAP authentication. If CHAP authentication is always required, use the iscsi authentication chap command. If no authentication is always required, use the iscsi authentication none command. Use the chap-none option to override the global configuration which might have been configured to allow only one optioneither CHAP or nonenot both.
Examples
The following example configures CHAP only for ISCSI authentication.

switch# config terminal switch(config)# iscsi authentication chap
11-50
Chapter 11
I Commands iscsi authentication
Related Commands Command show iscsi global Description Displays all iSCSI initiators configured by the user.
11-51
Chapter 11 iscsi enable
I Commands
iscsi enable
To enable the iSCSI feature in any Cisco MDS switch, issue the iscsi enable command. To disable this feature, use the no form of the command. iscsi enable no iscsi enable
Syntax Description
Defaults
Disabled
Command Modes
Configuration mode
Command History
Release 1.3(1)
Usage Guidelines
The configuration and verification commands for the iSCSI feature are only available when iSCSI is enabled on a switch. When you disable this feature, all related configurations are automatically discarded.
Examples
The following command enables the iSCSI feature.

switch(config)# iscsi enable
The following command disables the iSCSI feature (default).

switch(config)# no iscsi enable
11-52
Chapter 11
I Commands iscsi import target fc
iscsi import target fc

To allow dynamic mapping of Fibre Channel targets, use the iscsi import target fc command. To disable this feature, use the no form of the command. iscsi import target fc no iscsi import target fc
Syntax Description
Defaults
Disabled
Command Modes
Configuration mode
Command History
Release 1.1(1)
Usage Guidelines
This command directs iSCSI to dynamically import all Fibre Channel targets into iSCSI.
Examples
The following example allows dynamic mapping of Fibre Channel targets.

switch# config terminal switch(config)# iscsi import target fc
The following example disables dynamic mapping of Fibre Channel targets.

switch(config)# no iscsi import target fc
Related Commands
Command show iscsi global
Description Displays all iSCSI initiators configured by the user..
11-53
Chapter 11 iscsi initiator idle-timeout
I Commands
iscsi initiator idle-timeout

To configure the iSCSI initiator idle timeout, use the iscsi initiator idle-timeout command. To revert to the default, use the no form of the command. iscsi initiator idle-timeout seconds no iscsi initiator idle-timeout seconds
Syntax Description
seconds
Specifies the timeout in seconds. The range is 0 to 3600.
Defaults
300 seconds
Command Modes
Configuration mode
Command History
Release 1.3
Usage Guidelines
When the idle timeout value is set to 0, the initiator information is cleared immediately after the last session from the initiator terminates.
Examples
The following example configures the iSCSI initiator idle timeout to 180 seconds.
switch# config terminal switch(config)# iscsi initiator idle-timeout 180
The following example reverts the default value of 300 seconds.

switch# config terminal switch(config)# no iscsi initiator idle-timeout 240
Related Commands
Command show iscsi global
Description Displays global iSCSI configuration information.
11-54
Chapter 11
I Commands iscsi initiator ip-address
iscsi initiator ip-address

To assign persistent WWNs to an iSCSI initiator or assign an iSCSI initiator into VSANs other than the default VSAN, use the iscsi initiator ip-address command. To revert to the default, use the no form of the command. iscsi initiator ip-address ipaddress static {nwwn | pwwn} {wwn-id | system-assign number} vsan vsan-id iscsi initiator ip-address ipaddress no static {nwwn | pwwn} {wwn-id | system-assign number} no vsan vsan-id no iscsi initiator ip-address ipaddress
Syntax Description
ipaddress nwwn pwwn wwn-id system-assign number vsan vsan-id
Specifies the initiator IP address. Configures the inititiator node WWN hex value. Configures the peer WWN for special frames. Enters the pWWN or nWWN ID. Generates the nWWN value automatically. The number ranges from 1 to 64. Specifies a VSAN ID. The range is 1 to 4093.
Defaults
Disabled.
Command Modes
Configuration mode
Command History
Release 1.1(1)
Usage Guidelines
Under a circumstance where an iSCSI initiator needs to have a persistent binding to FC WWNs, this command should be used. Also, an iSCSI initiator can be put into multiple VSANs. An iSCSI host can become a member of one or more VSANs.
Examples
The following command configures an iSCSI initiator. using the IP address of the initiator node.
switch(config)# iscsi initiator ip address 10.50.1.1
The following command deletes the configured iSCSI initiator.

switch(config)# no iscsi initiator ip address 10.5.0.0
11-55
Chapter 11 iscsi initiator ip-address
I Commands
The following command uses the switch's WWN pool to allocate the nWWN for this iSCSI initiator and keeps it persistent.
switch(config-(iscsi-init))# static nWWN system-assign
The following command assigns the user provided WWN as nWWN for the iSCSI initiator. You can only specify one nWWN for each iSCSI node.
switch(config-(iscsi-init))# nWWN 20:00:00:05:30:00:59:11
The following command uses the switch's WWN pool to allocate two pWWNs for this iSCSI initiator and keeps it persistent.
switch(config-(iscsi-init))# static pWWN system-assign 2
The following command assigns the user provided WWN as pWWN for the iSCSI initiator.
switch(config-(iscsi-init))# pWWN 21:00:00:20:37:73:3b:20
Related Commands
Command show iscsi initiator
Description Displays information about configured iSCSI initiators.
11-56
Chapter 11
I Commands iscsi initiator name
iscsi initiator name

To configure an iSCSI initiator name and change to iSCSI configuration mode, use the iscsi initiator name command. To revert to factory defaults, use the no form of the command. iscsi initiator name name no iscsi initiator name name
Syntax Description
name
Enters the initiator name to be used. The minimum length is 16 characters and maximum is 223 characters.
Defaults
Disabled
Command Modes
Configuration mode
Command History
Release 1.3(2)
Usage Guidelines
Under a circumstance where an iSCSI initiator needs to have a persistent binding to FC WWNs, this command should be used. Also, an iSCSI initiator can be put into multiple VSANs. An iSCSI host can become a member of one or more VSANs.
Examples
The following example configures an iSCSI initiator using the iSCSI name of the initiator node.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# iscsi initiator name iqn.1987-02.com.cisco.initiator
Related Commands
11-57
Chapter 11 iscsi interface vsan-membership
I Commands
iscsi interface vsan-membership

To configure VSAN membership for iSCSI interfaces, use the iscsi interface vsan-membership command. Use the no form of this command to disable this feature or to revert to factory defaults. iscsi interface vsan-membership no iscsi interface vsan-membership
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode
Command History
Release 1.3(1)
Usage Guidelines
If the iscsi interface vsan-membership command is disabled, you will not be able to configure iSCSI VSAN membership
Examples
The following command enables the iSCSI interface VSAN membership.

switch# config terminal switch(config)# iscsi interface vsan-membership
The following command disables the iSCSI interface VSAN membership (default).
switch(config)# no iscsi interface vsan-membership
Related Commands
11-58
Chapter 11
I Commands iscsi save-initiator
iscsi save-initiator
To permanently save the automatically-assigned nWWN/pWWN mapping, use the iscsi save-initiator command. iscsi save-initiator [ip-address ip-address | name name]
Syntax Description
ip-address ip-address name name
Specifies the initiator IP address. Specifies the initiator name to be used from 1 to 255 characters. The minimum length is 16 characters.
Defaults
If initiator name or IP address is not specified, the nWWN/pWWN mapping for all initiators becomes permanent.
Command Modes
Configuration mode
Command History
Release 1.3(1)
Usage Guidelines
After executing the iscsi save-initiator command, issue the copy running-config startup-config to save the nWWN/pWWN mapping across switch reboots.
Examples
The following example shows how to save the nWWN/pWWN mapping for all the initiators.
switch(config)# iscsi save-initiator
The following example shows how to save the nWWN/pWWN mapping for an initiator named iqn.1987-02.com.cisco.initiator.
switch(config)# iscsi save-initiator name iqn.1987-02.com.cisco.initiator
Related Commands
Command iscsi initiator show iscsi initiator
Description Configures an iSCSI initiator. Displays information about configured iSCSI initiators.
11-59
Chapter 11 iscsi virtual-target name
I Commands
iscsi virtual-target name

To create a static iSCSI virtual target, use the iscsi virtual-target command. To revert to the default values, use the no form of the command. iscsi virtual-target name name advertise interface {gigabitethernet slot/port[.subinterface] | port-channel channel-id[.subinterface]} all-initiator-permit initiator {initiator-name | ip-address ipaddress [netmask]} permit pwwn pwwn-id [fc-lun number iscsi-lun number [secondary-pwwn pwwn-id [sec-lun number]] | secondary-pwwn pwwn-id] revert-primary-port trespass iscsi virtual-target name name no advertise interface {gigabitethernet slot/port[.subinterface] | port-channel channel-id[.subinterface]} no all-initiator-permit no initiator {initiator-name | ip-address ipaddress [netmask]} permit no pwwn pwwn-id [fc-lun number iscsi-lun number [secondary-pwwn pwwn-id [sec-lun number]] | secondary-pwwn pwwn-id] no revert-primary-port no trespass no iscsi virtual-target name name
Syntax Description
name advertise interface gigabitethernet slot/port[.subinterface] port-channel channel-id[.subinterface] all-initiator-permit initiator initiator-name ip-address ip-address ip-subnet permit pwwn pwwn-id secondary-pwwn pwwn-id fc-lun number iscsi-lun number sec-lun number trespass
Enters the virtual target name to be used. The minimum length is 16 characters and maximum of 223 bytes. Advertises the virtual target name on the specified interface. Selects the Gigabit Ethernet interface or subinterface to configure. Selects the Port Channel interface or subinterface to configure. Enables all iSCSI initiator access to this target. Configures specific iSCSI initiator access to this target. Specifies the iSCSI initiator name to be used access a specified target. Maximum length is 255 characters. Specifies the iSCSI initiator IP address. Specifies all initiators in the subnet. Permits access to the specified target. Specifies the peer WWN ID for special frames. Specifies the secondary pWWN ID. Specifies the Fibre Channel Logical Unit Number (LUN). Specifies the iSCSI virtual target number. Specifies the secondary Fibre Channel LUN. Moves LUNs forcefully from one port to another.
11-60
Chapter 11
I Commands iscsi virtual-target name
Defaults Disabled.
Command Modes
Configuration mode.
Command History
Release 1.1(1) 1.3(1)
Modification This command was introduced. Added revert-to-primary and trespass subcommands.
Usage Guidelines
This command is used to configure a static iSCSI target for access by iSCSI initiators. A virtual target may contain a subset of LUs of an FC target or one whole FC target. Do not specify the LUN if you wish to map the whole Fibre Channel target to an iSCSI target. All Fibre Channel LUN targets are exposed to iSCSI. One iSCSI target cannot contain more than one Fibre Channel target.
Examples
The follow example creates a static virtual target and enters ISCSI target configuration submode.
switch# config terminal switch(config)# iscsi virtual-target name 0123456789ABDEFGHI switch(config-iscsi-tgt)#
The following command advertises the virtual target only on the specified interface. By default, it is advertised on all interfaces in all IPS modules.
switch(config-iscsi-tgt)# advertise interface gigabitethernet 4/1
The following command maps a virtual target node to a Fibre Channel target.
switch(config-iscsi-tgt)# pWWN 26:00:01:02:03:04:05:06
The following command enters the secondary pWWN for the virtual target node.
switch(config-iscsi-tgt)# pWWN 26:00:01:02:03:04:05:06 secondary-pwwn 66:00:01:02:03:04:05:02
Use the LUN option to map different Fibre Channel LUNs to different iSCSI virtual targets. If you have already mapped the whole Fibre Channel target, you will not be able to use this option.
switch(config-iscsi-tgt)# pWWN 26:00:01:02:03:04:05:06 fc-lun 0 iscsi-lun 0
The following command allows the specified iSCSI initiator node to access this virtual target. You can issue this command multiple times to allow multiple initiators.
switch(config-iscsi-tgt)# initiator iqn.1987-02.com.cisco.initiator1 permit
The following command prevents the specified initiator node from accessing virtual targets.
switch(config-iscsi-tgt)# no initiator iqn.1987-02.com.cisco.initiator1 permit
The following command allows the specified IP address to access this virtual target:
switch(config-iscsi-tgt)# initiator ip-address 10.50.1.1 permit
11-61
Chapter 11 iscsi virtual-target name
I Commands
The following command prevents the specified IP address from accessing virtual targets:
switch(config-iscsi-tgt)# no initiator ip-address 10.50.1.1 permit
The following command allows all initiators in this subnetwork to access this virtual target:
switch(config-iscsi-tgt)# initiator ip-address 10.50.0.0 255.255.255.0 permit
The following command prevents all initiators in this subnetwork from accessing virtual targets:
switch(config-iscsi-tgt)# no initiator ip-address 10.50.0.0 255.255.255.0 permit
The following command allows all initiator nodes to access this virtual target.
switch(config-iscsi-tgt)# all-initiator-permit
The following command prevents any initiator node from accessing virtual targets.
switch(config-iscsi-tgt)# no all-initiator-permit
The following command configures a primary and secondary port and moves the LUNs from one port to the other using the trespass command.
switch# config terminal switch(config)#iscsi virtual-target name iqn.1987-02.com.cisco.initiator switch(config-iscsi-tgt)# pwwn 50:00:00:a1:94:cc secondary-pwwn 50:00:00:a1:97:ac switch(config-iscsi-tgt)# trespass
Related Commands
Command show iscsi virtual target
Description Displays information about iSCSI virtual targets.
11-62
Chapter 11
I Commands isns
isns
To tag a Gigabit Ethernet or PortChannel interface to an Internet Storage Name Service (iSNS) profile, use the isns command in interface configuration submode. To untag the interface, use the no form of the command. isns profile-name no isns profile-name
Syntax Description
profile-name
Specifies the iSNS profile name.
Defaults
Disabled.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, iSNS must be enabled using the isns-server enable command. Use the isns reregister command in EXEC mode to reregister associated iSNS objects (tagged to an iSNS profile) with the iSNS server.
Examples
The following example shows how to tag a Gigabit Ethernet interface to an iSNS profile.
switch# config terminal switch(config)# interface gigabitethernet 1/2 switch(config-if)# isns Profile1
The following example shows how to tag a PortChannel interface to an iSNS profile.
switch# config terminal switch(config)# interface port-channel 2 switch(config-if)# isns Profile2
Related Commands
Command isns-server enable isns reregister show interface gigabitethernet
Description Enables the iSNS server. Reregisters the iSNS object. Displays configuration and status information for a specified Gigabit Ethernet interface.
11-63
Chapter 11 isns
I Commands
Command show interface port-channel show isns Description Displays configuration and status information for a specified PortChannel interface. Displays iSNS information.
11-64
Chapter 11
I Commands isns distribute
isns distribute
To enable Cisco Fabric Services (CFS) distribution for Internet Storage Name Service (iSNS), use the isns distribute command. To disable this feature, use the no form of the command. isns distribute no isns distribute
Syntax Description
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, iSNS must be enabled using the isns-server enable command. You can configure the pWWN and nWWN of iSCSI initiators and permit a group of iSCSI initiators to share a given nWWN/pWWN pair by using a proxy initiator. The number of iSCSI initiators that register with the iSNS server is more than the number of iSCSI targets that register with the iSNS server. To synchronize the iSCSI initiator entries across switches, you can distribute the iSCSI initiator configuration to iSNS servers across switches.
Examples
The following example shows how to initiate iSNS information distribution.

switch# config terminal switch(config)# isns distribute
The following example shows how to cancel iSNS information distribution.

switch# config terminal switch(config)# no isns distribute
Related Commands
Command isns-server enable show isns
Description Enables the iSNS server. Displays iSNS information.
11-65
Chapter 11 isns esi retries
I Commands
isns esi retries

To configure the number of entity status inquiry (ESI) retry attempts, use the isns esi retries command in configuration mode. To revert to the default value, use the no form of the command. isns esi retries number no isns esi retries number
Syntax Description
number
Specifies the number of retries. The range is 0 to 10.
Defaults
3 retries.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, Internet Storage Name Service (iSNS) must be enabled using the isns-server enable command. The iSNS client queries the ESI port at user-configured intervals. Receipt of a response indicates that the client is still alive. Based on the configured value, the interval specifies the number of failed tries before which the client is deregistered from the server.
Examples
The following example shows how change the ESI retries limit to eight.
switch# config terminal switch(config)# isns esi retries 8
Related Commands
Command isns-server enable show isns
Description Enables the iSNS server. Displays iSNS information.
11-66
Chapter 11
I Commands isns profile name
isns profile name

To create an Internet Storage Name Service (iSNS) profile and enter iSNS profile configuration submode, use the isns profile name command in configuration mode. To delete the iSNS profile, use the no form of the command. isns profile name profile-name no isns profile name profile-name
Syntax Description
profile-name
Specifies the profile name. Maximum length is 64 characters.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.3(1)
Usage Guidelines
To use this command, iSNS must be enabled using the isns-server enable command.
Examples
The following example shows how to specify an iSNS profile name and enter iSNS profile configuration submode.
switch# config terminal switch(config)# isns profile name UserProfile switch(config-isns-profile)#
Related Commands
Command server show isns
Description Configures a server IP address in an iSNS profile. Displays iSNS information.
11-67
Chapter 11 isns reregister
I Commands
isns reregister
To register all Internet Storage Name Service (iSNS) objects for an interface that is already tagged to an iSNS profile, use the isns register command. isns reregister {gigabitethernet slot/number | port-channel channel-group}
Syntax Description
gigabitethernet slot/port port-channel channel-group
Specifies tagged Gigabit Ethernet interface slot and port. Specifies tagged PortChannel group. The range is 1 to 128.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.3(1)
Usage Guidelines
Use this command to reregister portals and targets with the iSNS server for a tagged interface.
Examples
The following command re-registers portal and targets for a tagged interface:
switch# isns reregister gigabitethernet 1/4
Related Commands
Command show isns profile
Description Displays details for configured iSNS profiles.
11-68
Chapter 11
I Commands isns-server enable
isns-server enable
To enable the Internet Storage Name Service (iSNS) server, use the isns-server enable command in configuration mode. To disable iSNS, use the no form of the command. isns-server enable no isns-server enable
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
Performing the isns-server enable command enables the commands used to configure iSNS.
Examples
The following example shows how to enable iSNS.

switch# config terminal switch(config)# isns-server enable
The following example shows how to disable iSNS.

switch# config terminal switch(config)# no isns-server enable
Related Commands
Command isns distribute isns esi retries isns profile name server show isns
Description Enables iSNS distributed support. Configures ESI retry attempts. Creates and configures iSNS profiles. Configures iSNS server attributes. Displays iSNS information.
11-69
Chapter 11 ivr abort
I Commands
ivr abort
To discard an Inter-VSAN Routing (IVR) CFS distribution session in progress, use the ivr abort command in configuration mode. ivr abort
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to discard an IVR CFS distribution session in progress.
switch# config terminal switch(config)# ivr abort
Related Commands
Command ivr distribute show ivr
Description Enables CFS distribution for IVR. Displays IVR CFS distribution status and other details.
11-70
Chapter 11
I Commands ivr commit
ivr commit
To apply the pending configuration pertaining to the Inter-VSAN Routing (IVR) Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the ivr commit command in configuration mode. ivr commit
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to apply an IVR configuration to the switches in the fabric.
switch# config terminal switch(config)# ivr commit
Related Commands
Command ivr distribute show ivr
Description Enables CFS distribution for IVR. Displays IVR CFS distribution status and other details.
11-71
Chapter 11 ivr copy auto-topology user-configured-topology
I Commands
ivr copy auto-topology user-configured-topology

To copy the automatically discovered Inter-VSAN Routing (IVR) VSAN topology into the user configured topology, use the ivr copy auto-topology user-configured-topology command in EXEC mode. ivr copy auto-topology user-configured-topology
Syntax Description
Defaults
None.
Command Modes
EXEC configuration mode.
Command History
Release 2.1(1a)
Usage Guidelines
After using the ivr copy auto-topology user-configured-topology command to copy the automatically discovered VSAN topology into the user configured topology you must use the ivr commit command to apply the pending configuration changes to the IVR topology using Cisco Fabric Services (CFS) distribution.
Examples
The following example copies the automatically discovered VSAN topology into the user configured topology.
switch# ivr copy auto-topology user-configured-topology
Related Commands
Command ivr commit show ivr vsan topology
Description Applies the changes to the IVR topology. Displays the IVR VSAN topology configuration
11-72
Chapter 11
I Commands ivr distribute
ivr distribute
To enable Cisco Fabric Services (CFS) distribution for Inter-VSAN Routing (IVR), use the ivr distribute command. To disable this feature, use the no form of the command. ivr distribute no ivr distribute
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to enable IVR fabric distribution.

switch# config terminal switch(config)# ivr distribute
Related Commands
Command ivr commit show ivr
Description Commits temporary IVR configuration changes to the active configuration. Displays IVR CFS distribution status and other details.
11-73
Chapter 11 ivr enable
I Commands
ivr enable
To enable the Inter-VSAN Routing (IVR) feature, use the ivr enable command in configuration mode. To disable this feature, use the no form of the command. ivr enable no ivr enable
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 1.3(1)
Usage Guidelines
The IVR feature must be enabled in all edge switches in the fabric that participate in the IVR. The configuration and display commands for the IVR feature are only available when IVR is enabled on a switch. When you disable this configuration, all related configurations are automatically discarded.
Examples
The following command enters the configuration mode and enables the IVR feature on this switch.
switch# config terminal Enter configuration commands, one per line. switch(config)# ivr enable End with CNTL/Z.
Related Commands
Command show ivr
Description Displays IVR feature information.
11-74
Chapter 11
I Commands ivr nat
ivr nat
To explicitly enable Network Address Translation (NAT) functionality for Inter-VSAN Routing (IVR), use the ivr nat command in configuration mode. To disable this feature, use the no form of the command. ivr nat no ivr nat
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.1(1a)
Usage Guidelines
The ivr nat command allows you to explicitly enable NAT functionality of IVR. Upgrading to SAN-OS Release 2.x from SAN-OS Release 1.3.x does not automatically enable the Fibre Channel NAT functionality. This command also allows you to continue to operate in non-NAT mode even in SAN-OS Release 2.x and later.
Note
You might need to operate in non-NAT mode to support proprietary protocols that embed FCIDs in the frame payloads.
Examples
The following example shows how to explicitly enable NAT functionality for IVR.
switch# config terminal Enter configuration commands, one per line. switch(config)# ivr nat End with CNTL/Z.
Related Commands
Command show ivr
11-75
Chapter 11 ivr refresh
I Commands
ivr refresh
To refresh devices being advertised by Inter-VSAN Routing (IVR), use the ivr refresh command in EXEC mode. ivr refresh
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(2)
Usage Guidelines
None.
Examples
The following example shows refresh devices being advertised by IVR.

switch# ivr refresh
Related Commands
Command ivr enable ivr withdraw domain
Description Enables the Inter-VSAN Routing (IVR) feature. Withdraws an overlapping virtual domain from a specified VSAN.
11-76
Chapter 11
I Commands ivr service-group name
ivr service-group name

To configure an Inter-VSAN Routing (IVR) service group, use the ivr service-group name command in configuration mode. To disable this feature, use the no form of the command. ivr service-group name service-group no ivr service-group name service-group
Syntax Description
service-group
Specifies the service group name.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.1(1a)
Usage Guidelines
In a complex network topology, you might only have a few IVR-enabled VSANs. To reduce the amount of traffic to non-IVR-enabled VSANs, you can configure a service group that restricts the traffic to the IVR-enabled VSANs. Only one service group allowed in a network. When a new IVR-enabled switch is added to the network, you must update the service group to include the new VSANs. Before configuring an IVR service group, you must enable the following:

IVR using the ivr enable command IVR distribution using the ivr distribute command Automatic IVR topology discovery using the ivr vsan-topology auto command.
Using the autonomous-fabric-id (IVR service group configuration) command, you can restrict the IVR traffic to the AFIDs and VSANs configured in the service group.
Examples
The following example shows how to configure an IVR service group and change to IVR service group configuration mode.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ivr enable switch(config)# ivr vsan-topology auto switch(config)# ivr service-group name serviceGroup1 switch(config-ivr-sg)#
11-77
Chapter 11 ivr service-group name
I Commands
Related Commands Command ivr enable ivr vsan-topology auto show ivr Description Enables the Inter-VSAN Routing (IVR) feature Enables automatic discovery of the IVR topology. Displays IVR feature information.
11-78
Chapter 11
I Commands ivr virtual-fcdomain-add
ivr virtual-fcdomain-add
To add the Inter-VSAN Routing (IVR) virtual domains in a specific VSAN(s) to the assigned domains list in that VSAN, use the ivr virtual-fcdomain-add command. To delete the IVR virtual domains, use the no form of the command. ivr virtual-fcdomain-add vsan-ranges vsan-range no ivr virtual-fcdomain-add vsan-ranges vsan-range
Syntax Description
vsan-ranges vsan-range
Specifies the IVR VSANs or range of VSANs. The range of values for a VSAN ID is 1 to 4093.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 1.3(4)
Usage Guidelines
Use the no ivr virtual-fcdomain-add command to remove the currently active domains from the fcdomain manager list in a specified VSAN.
Examples
The following command adds the IVR virtual domains in VSAN 1.

switch# config terminal switch(config)# ivr virtual-fcdomain-add vsan-ranges 1
The following command reverts to the factory default of not adding IVR virtual domains.
switch# config terminal switch(config)# ivr virtual-fcdomain-add vsan-ranges 1
Related Commands
Command show ivr virtual-fcdomain-add-status ivr withdraw domain
Description Displays the configured VSAN topology for a fabric. Removes overlapping domains.
11-79
Chapter 11 ivr vsan-topology
I Commands
ivr vsan-topology
To configure manual or automatic discovery of the Inter-VSAN Routing (IVR) topology, use the ivr vsan-topology command in configuration mode. ivr vsan-topology {activate | auto}
Syntax Description
activate auto
Configures manual discovery of the IVR topology and disables automatic discovery mode. Configures automatic discovery of the IVR topology.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 1.3(1) 2.1(1a)
Modification This command was introduced. Added auto keyword.
Usage Guidelines
To use this command you must first enable IVR using the ivr enable command and configure the IVR database using the ivr vsan-topology database command.
Caution
Active IVR topologies cannot be deactivated. You can only switch to automatic topology discovery mode.
Examples
The following ivr vsan-topology activate command activates the VSAN topology database:
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ivr enable switch(config)# ivr vsan-topology database switch(config-ivr-topology-db)# autonomous-fabric-id 1 switch 20:00:00:00:30:00:3c:5e vsan-ranges 2,2000 switch(config)# ivr vsan-topology activate
The following command enables VSAN topology database auto mode, which allows the switch to automatically discover the IVR topology.
switch(config)# ivr vsan-topology auto
11-80
Chapter 11
I Commands ivr vsan-topology
Related Commands Command ivr enable autonomous-fabric-id (IVR topology database configuration) show ivr Description Enables the Inter-VSAN Routing (IVR) feature. Configure an autonomous phobic ID into the IVR topology database. Displays IVR feature information.
11-81
Chapter 11 ivr vsan-topology database
I Commands
ivr vsan-topology database

To configure an Inter-VSAN Routing (IVR) topology database, use the ivr vsan-topology database command in configuration mode. To delete an IVR topology database, use the no form of the command. ivr vsan-topology database no ivr vsan-topology database
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.3(1)
Usage Guidelines
To use this command you must first enable IVR using the ivr enable command. You can have up to 64 VSANs (or 128 VSANs as of Cisco MDS SAN-OS Release 2.1(1a)) in an IVR topology. Specify the IVR topology using the following information:

The switch WWNs of the IVR-enabled switches. A minimum of two VSANs to which the IVR-enabled switch belongs. The autonomous fabric ID (AFID), which distinguishes two VSANs that are logically and physically separate, but have the same VSAN number. Cisco MDS SAN-OS Release 1.3(1) and later supports only one default AFID (AFID 1) and thus does not support non-unique VSAN IDs in the network. As of Cisco MDS SAN-OS Release 2.1(1a), you can specify up to 64 AFIDs.
Note
The use of a single AFID does not allow for VSANs that are logically and physically separate but have the same VSAN number in an IVR topology.
Caution
You can only configure a maximum of 128 IVR-enabled switches and 64 distinct VSANs (or 128 distinct VSANs as of Cisco MDS SAN-OS Release 2.1(1a)) in an IVR topology. The no ivr vsan-topology database command only clears the configured database, not the active database. You can only delete the user-defined entries in the configured database. Auto mode entries only exist in the active database.
11-82
Chapter 11
I Commands ivr vsan-topology database
Examples The following command enters configuration mode, enables the IVR feature, enters the VSAN topology database, and configures the pWWN-VSAN association for VSANs 2 and 2000:
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ivr enable switch(config)# ivr vsan-topology database switch(config-ivr-topology-db)# autonomous-fabric-id 1 switch 20:00:00:00:30:00:3c:5e vsan-ranges 2,2000
Related Commands
Command ivr enable autonomous-fabric-id (IVR topology database configuration) show ivr
Description Enables the Inter-VSAN Routing (IVR) feature. Configure an autonomous phobic ID into the IVR topology database Displays IVR feature information.
11-83
Chapter 11 ivr withdraw domain
I Commands
ivr withdraw domain

To withdraw overlapping virtual domain from a specified VSAN, use the ivr withdraw domain command in EXEC mode. ivr withdraw domain domain-id vsan vsan-id
Syntax Description
domain-id vsan vsan-id
Specifies the domain id. The range is 1 to 239. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.3(4)
Usage Guidelines
When you enable the ivr virtual-fcdomain-add command, links may fail to come up due to overlapping virtual domain identifiers. If so, temporarily withdraw the overlapping virtual domain from that VSAN using the ivr withdraw domain command in EXEC mode.
Examples
The following command withdraws overlapping domains.

switch# ivr withdraw domain 10 vsan 20
Related Commands
Command show ivr virtual-fcdomain-add-status
Description Displays the configured VSAN topology for a fabric.
11-84
Chapter 11
I Commands ivr zone name
ivr zone name

To configure a zone for Inter-VSAN Routing (IVR), use the ivr zone name command. To disable a zone for IVR, use the no form of the command. ivr zone name ivzs-name no ivr zone name ivz-name
Syntax Description
ivz-name
Specifies the IVZ name. Maximum length is 59 characters.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.3(1)
Usage Guidelines
This command enters IVR zone configuration submode.
Examples
The following command enters the configuration mode, enables the IVR feature, creates an IVZ, and adds a pWWN-VSAN member.
switch# config terminal switch(config)# ivr enable switch(config)# ivr zone name Ivz_vsan2-3 switch(config-ivr-zone)# member pwwn 21:00:00:e0:8b:02:ca:4a vsan 3
Related Commands
Command show ivr
11-85
Chapter 11 ivr zoneset
I Commands
ivr zoneset
To configure a zoneset for Inter-VSAN Routing (IVR), use the ivr zoneset command. To revert to the factory defaults, use the no form of the command. ivr zoneset {activate name ivzs-name [force] | name ivzs-name} no ivr zoneset {activate name ivzs-name [force] | name ivzs-name}
Syntax Description
activate force name ivzs-name
Activates a previously-configured IVZS. Forces a IVZS activation Specifies the IVZS name. Maximum length is 59 characters.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.3(1)
Usage Guidelines
This command enters IVR zoneset configuration submode.
Examples
The following command enters the configuration mode, enables the IVR feature, creates an IVZS, adds a IVZ member, and activates the IVZS.
switch# config terminal switch(config)# ivr enable switch(config)# ivr zoneset switch(config-ivr-zoneset)# switch(config-ivr-zoneset)# switch(config)# ivr zoneset
name Ivr_zoneset1 member Ivz_vsan2-3 exit activate name IVR_ZoneSet1
Related Commands
Command show ivr
11-86
C H A P T E R
12
J Commands
12-1
Chapter 12 job name
J Commands
job name
To assign a job to a command schedule, use the job name command. To remove the job, use the no form of the command. job name job-name no job name job-name
Syntax Description
job-name
Specifies the job name for the command schedule to run.
Defaults
None.
Command Modes
Scheduler schedule configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, the command scheduler must be enabled using the scheduler enable command. You can configure multiple jobs in a command schedule.
Examples
The following example shows how to specified the job for a command schedule.
switch# config terminal switch(config)# scheduler schedule name MySchedule switch(config-schedule)# job name MyJob
Related Commands
Command scheduler enable scheduler schedule name show scheduler
Description Enables the command scheduler. Configures a schedule for the command scheduler. Displays scheduler information.
12-2
C H A P T E R
13
K Commands
13-1
Chapter 13 keepalive
K Commands
keepalive
To configure the message keepalive interval for the IKE protocol, use the keepalive command in IKE configuration submode. To revert to the default, use the no form of the command. keepalive seconds no keepalive [seconds]
Syntax Description
seconds
Specifies the number of seconds for the keepalive interval. The range is 120 to 86400.
Defaults
3600 seconds or 1 hour.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
The keepalive interface only applies to IKE version 2 tunnels. To use this command, the IKE protocol must be enabled using the crypto ike enable command.
Examples
The following example shows how to configure the keepalive interval.

switch# config terminal switch(config)# crypto ike domain ipsec switch(config-ike-ipsec)# keepalive 7200
Related Commands
13-2
Chapter 13
K Commands kernel core
kernel core
Use the kernel core command to generate a core dump for each module. Use the no form of this command to negate the command or revert to its factory kernel core {limit number | module slot {force | level {all | header | kernel | ram | used-ram} | target ipaddress} no kernel core {limit number | module slot {force | level {all | header | kernel | ram | used-ram} | target ipaddress}
Syntax Description
limit number module slot force level all header kernel ram used-ram target ipaddress
Limits the number of modules for which the core is generated. The range is 1 to 6. Configures the module requiring the core generation. Forces a module to dump kernel core. Specifies the core dump level for the selected module. Dumps all the memory (requires 1G of space) Dumps kernel header only. Dumps all kernel memory pages. Dumps all the RAM pages. Dumps all the used RAM pages. Configures the external server IP address on the same physical LAN.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 1.1(1)
Usage Guidelines
Core dumps performed on the supervisor module can lead to packet loss, even in a dual supervisor configuration.
Examples
The following example limits core generation to two modules.

switch(config)# kernel core limit 2 succeeded
The following example configures module 5 to generate cores.

switch(config)# kernel core module 5 succeeded
13-3
Chapter 13 kernel core
K Commands
The following example configures module 5 to generate only header-level cores.
switch(config)# kernel core module 5 level header succeeded
The following example configures the external server.

switch(config)# kernel core target 10.50.5.5 succeeded
Related Commands
Command show kernel show running-config
Description Displays configured kernel core settings. Displays all switch configurations saved to PSS.
13-4
Chapter 13
K Commands key
key
To configure the preshared key for the IKE protocol, use the key command in IKE configuration submode. To revert to the default, use the no form of the command. key key-id address ip-address no key key-id address ip-address
Syntax Description
key-id address ip-address
Specifies the ID for the preshared key. Maximum length is 128 characters. Specifies the peer IP address. The format is A.B.C.D.
Defaults
None.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to configure the key.

switch# config terminal switch(config)# crypto ike domain ipsec switch(config-ike-ipsec)# key ctct address 10.10.100.231
Related Commands
Command crypto ike domain ipsec crypto ike enable show crypto ike domain ipsec
Description Enters IKE configuration mode. Enables the IKE protocol. Displays IKE information for the IPsec domain.
13-5
Chapter 13 key
K Commands
13-6
C H A P T E R
14
L Commands
14-1
Chapter 14 lifetime seconds
L Commands
lifetime seconds
To configure the security association (SA) lifetime duration for an IKE protocol policy, use the lifetime seconds command in IKE policy configuration submode. To revert to the default, use the no form of the command. lifetime seconds seconds no lifetime [seconds seconds]
Syntax Description
seconds
Specifies the lifetime duration in seconds. The range is 600 to 86400.
Defaults
86,400 seconds.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, the IKE protocol must be enabled using the crypto ike enable command. The lifetime seconds command overrides the default.
Examples
The following example shows how to configure the SA lifetime duration for the IKE protocol.
switch# config terminal switch(config)# crypto ike domain ipsec switch(config-ike-ipsec)# policy 1 switch(config-ike-ipsec-policy)# lifetime seconds 6000
Related Commands
Command crypto ike domain ipsec crypto ike enable policy
Description Enters IKE configuration mode. Enables the IKE protocol. Configures IKE protocol policy.
14-2
Chapter 14
line com1
To configure auxiliary COM 1 port, use the line com1 command. To negate the previously issued command or to revert to factory defaults, use the no form of the command. line com1 --> databits number | flowcontrol hardware | modem {in | init-string {default | user-input} | set-string user-input string} | parity {even | none | odd} | speed speed | stopbits {1 | 2} line com1 --> no databits number | no flowcontrol hardware | no modem {in | init-string | set-string user-input} | no parity {even | none | odd} | no speed speed | no stopbits {1 | 2}
Syntax Description
databits number flowcontrol hardware modem in init-string default set-string user-input string parity even none odd speed speed stopbits 1 2
Specifies the number of databits per character. The range is 5 to 8. Enables modem flowcontrol on the COM1 port. Enables the modem mode. Enables the COM 1 port to only connect to a modem. Writes the default initialization string to the modem. Sets the user-specified initilization string to its corresponding profile. Maximum length is 80 characters. Sets terminal parity. Sets even parity. Sets no parity. Sets odd parity. Sets the transmit and receive speeds. The range is 110 to 115, 200 baud. Sets async line stopbits. Sets one stop bit. Sets two stop bits.
init-string user-default Writes the provided initialization string to the modem.
Defaults
9600 Baud 8 databits 1 stopbit Parity none Default init string
14-3
Chapter 14 line com1
L Commands
Command History
Usage Guidelines
The line com1 command available in config t command mode. The line com1 configuration commands are available in config-com1 submode. You can perform the configuration specified in this section only if you are connected to the console port or the COM1 port. We recommend you use the default initialization string. If the required options are not provided in the user-input string, the initialization string is not processed. You must first set the user-input string before initializing the string.
Examples
The following example configures a line console and sets the options for that terminal line.
switch## config terminal switch(config)# switch(config)# line com1 switch(config-com1)# databits 6 switch(config-com1)# parity even switch(config-com1)# stopbits 1
The following example disables the current modem from executing its functions.
switch# config terminal switch(config)# line com1 switch(config-com1)# no modem in
The following example enables (default) the COM1 port to only connect to a modem.
switch# config terminal switch(config)# line com1 switch(config-com1)# modem in
The following example Writes the provides initialization string to the modem. This is the default.
switch# config terminal switch(config)# line com1 switch(config-com1)# modem init-string default
The following example assigns the user-specified initialization string to its corresponding profile.
switch# config terminal switch(config)# line com1 switch(config-com1)# modem set-string user-input ATE0Q1&D2&C1S0=3\015
The following example deletes the configured initialization string.

switch# config terminal switch(config)# line com1 switch(config-com1)# no modem set-string user-input ATE0Q1&D2&C1S0=3\015
The following example writes the user-specified initialization string to the modem.
switch# config terminal switch(config)# line com1 switch(config-com1)# modem init-string user-input
14-4
Chapter 14
Related Commands Command line console line vty show line com1 Description Configure primary terminal line. Configure virtual terminal line. Displays COM1 information.
14-5
Chapter 14 line console
L Commands
line console
To configure a terminal line, use the line console command. To negate the previously issued command or to revert to factory defaults, use the no form of the command. line console --> databits number | exec-timeout minutes | modem {in | init-string | set-string user-input} | parity {even | none | odd} | speed speed | stopbits {1 | 2} line console --> no databits number | no exec-timeout minutes | no modem {in | init-string {default | user-input} | set-string user-input string} | no parity {even | none | odd} | no speed speed | no stopbits {1 | 2}
Syntax Description
databits number exec-timeout minutes modem in init-string default set-string user-input string init-string user-input parity even none odd speed speed stopbits 1 2
Specifies the number of databits per character. The range is 5 to 8. Configure exec timeout in minutes. The range is 0 to 525,600. To disable, set to 0 minutes. Enables the modem mode. Enables the COM 1 port to only connect to a modem. Writes the default initialization string to the modem. Sets the user-specified initilization string to its corresponding profile. Maximum length is 80 characters. Writes the provided initialization string to the modem. Sets terminal parity. Sets even parity. Sets no parity. Sets odd parity. Sets the transmit and receive speeds. The range is 110 to 115, 200 baud. Sets async line stopbits. Sets one stop bit. Sets two stop bits.
Defaults
9600 Baud 8 databits 1 stopbit Parity none Default init string
14-6
Chapter 14
L Commands line console
Command History
Usage Guidelines
The line console command available in config t command mode. The line console configuration commands are available in config-console submode.
Examples
The following example configures a line console and sets the options for that terminal line.
switch## config terminal switch(config)# # switch(config)# line console switch(config-console)# databits 60 switch(config-console)# exec-timeout 60 switch(config-console)# flowcontrol software switch(config-console)# parity even switch(config-console)# stopbits 1
The following example disables the current modem from executing its functions.
switch# config terminal switch(config)# line console switch(config-console)# no modem in
The following example enables (default) the COM1 port to only connect to a modem.
switch# config terminal switch(config)# line console switch(config-console)# modem in
The following example Writes the provides initialization string to the modem. This is the default.
switch# config terminal switch(config)# line console switch(config-console)# modem init-string default
The following example assigns the user-specified initialization string to its corresponding profile.
switch# config terminal switch(config)# line console switch(config-console)# modem set-string user-input ATE0Q1&D2&C1S0=3\015
The following example deletes the configured initialization string.

switch# config terminal switch(config)# line console switch(config-console)# no modem set-string user-input ATE0Q1&D2&C1S0=3\015
The following example writes the user-specified initialization string to the modem.
switch# config terminal switch(config)# line console switch(config-console)# modem init-string user-input
14-7
Chapter 14 line console
L Commands
Related Commands Command line vty line com1 show line console Description Configure virtual terminal line. Configures the auxiliary COM 1 port Displays console information.
14-8
Chapter 14
L Commands line vty
line vty
To configure a virtual terminal line, use the line vty command. To negate the previously issued command or to revert to factory defaults, use the no form of the command. line vty --> exec-timeout minutes | session-limit number line vty --> no exec-timeout | no session-limit number
Syntax Description
exec-timeout minutes session-limit number
Configures timeout in minutes. The range is 0 to 525600. To disable, set to 0 minutes. Configures the number of VSH sessions. The range is 1 to 64.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
The line vty command available in config t command mode. line vty configuration commands available in config-line submode.
Examples
The following example configures a virtual terminal line and sets the timeout for that line.
switch## config terminal switch(config)# line vty switch(config-line)# exec-timeout 60
Related Commands
Command line console line com1
Description Configure primary terminal line. Confgiures the auxiliary COM 1 port
14-9
Chapter 14 logging abort
L Commands
logging abort
To discard the logging Cisco Fabric Services (CFS) distribution session in progress, use the logging abort command in configuration mode. logging abort
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to discard logging CFS distribution session in progress.
switch# config terminal switch(config)# logging abort
Related Commands
14-10
Chapter 14
L Commands logging commit
logging commit
To apply the pending configuration pertaining to the logging Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the logging commit command in configuration mode. logging commit
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to commit changes to the active logging configuration.
switch# config terminal switch(config)# logging commit
Related Commands
14-11
Chapter 14 logging console
L Commands
logging console
To set console logging, use the logging console command. To negate the previously issued command or to revert to factory defaults, use the no form of the command. logging console [severity-level] no logging console [severity-level]
Syntax Description
severity-level
Specifies the maximum severity of messages logged. The range is 0 to 7, where 0 is emergency, 1 is alert, 2 is critical, 3 is error, 4 is warning, 5 is notify, 6 is informational, and 7 is debugging.
Defaults
Disabled. The default severity level is 2.
Command Modes
Configuration mode.
Command History
Usage Guidelines
The switch logs messages at or above the configured severity level.
Examples
The following example reverts console logging to the factory set default severity level of 2 (critical). Logging messages with a severity level of 2 or above will be displayed on the console.
switch# config terminal switch(config)# logging console 2
Related Commands
Description Displays logging configuration information.
14-12
Chapter 14
L Commands logging distribute
logging distribute
To enable Cisco Fabric Services (CFS) distribution for logging, use the logging distribute command. To disable this feature, use the no form of the command. logging distribute no logging distribute
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Command History
Release 2.0(1b)
Usage Guidelines
Before distributing the Fibre Channel timer changes to the fabric, the temporary changes to the configuration must be committed to the active configuration using the logging commit command.
Examples
The following example shows how to change the distribute logging configuration changes.
switch# config terminal switch(config)# logging distribute
Related Commands
Command logging commit show logging
Description Commits the logging configuration changes to the active configuration. Displays logging information.
14-13
Chapter 14 logging level
L Commands
logging level
To modify message logging facilities, use the logging level command. To negate the previously issued command or to revert to factory defaults, use the no form of the command. logging level facility-name severity-level no logging level facility-name severity-level
Syntax Description
facility-name severity-level
Specifies the required facility name (for example acl, or ivr, or port, etc.) Specifies the maximum severity of messages logged. The range is 0 to 7, where 0 is emergency, 1 is alert, 2 is critical, 3 is error, 4 is warning, 5 is notify, 6 is informational, and 7 is debugging.
Defaults
Disabled
Command Modes
Configuration mode
Command History
Usage Guidelines
Examples
Configures Telnet or SSH logging for the kernel facility at level 4 (warning). As a result, logging messages with a severity level of 4 or above will be displayed.
switch# config terminal switch(config)# logging level kernel 4
14-14
Chapter 14
L Commands logging logfile
logging logfile
To set message logging for logfile, use the logging logfile command.To negate the previously issued command or to revert to factory defaults, use the no form of the command. logging logfile filename severity-level [size filesize] no logging logfile
Syntax Description
filename severity-level
Specifies the log filename. Maximum length is 80 characters. Specifies the maximum severity of messages logged. The range is 0 to 7, where 0 is emergency, 1 is alert, 2 is critical, 3 is error, 4 is warning, 5 is notify, 6 is informational, and 7 is debugging. Specifies the log file size. The range is 4096 to 4194304 bytes.
size filesize
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Examples
The following example configures logging information for errors or events above a severity level of 3 (errors) to be logged in a file named ManagerLogFile. By configuring this limit, the file size is restricted to 3,000,000 bytes.
switch# config terminal switch(config)# logging logfile ManagerLogFile 3 size 3000000
Related Commands
14-15
Chapter 14 logging module
L Commands
logging module
To set message logging for linecards, use the logging module command. To negate the previously issued command or to revert to factory defaults, use the no form of the command. logging module [severity-level] no logging module [severity-level]
Syntax Description
severity-level
Specifies the maximum severity of messages logged. The range is 0 to 7, where 0 is emergency, 1 is alert, 2 is critical, 3 is error, 4 is warning, 5 is notify, 6 is informational, and 7 is debugging.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example sets message logging for modules at level 7.

switch## config terminal switch(config)# logging module 7
Related Commands
14-16
Chapter 14
L Commands logging monitor
logging monitor
To set monitor message logging, use the logging monitor command. To negate the previously issued command or to revert to factory defaults, use the no form of the command. logging monitor severity level
Syntax Description
logging monitor severity level
Sets message logging. 0-7 0-emerg;1-alert;2-crit;3-err;4-warn;5-notif;6-inform;7-debug
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example sets terminal line (monitor) message logging at level 2.
switch## config terminal switch(config)# logging monitor 2
Related Commands
14-17
Chapter 14 logging server
L Commands
logging server
To set message logging for the remote server, use the logging server command. logging server [hostname | ip address severity_level | facility auth | authpriv | cron | daemon | ftp | kernel | local0 | local1 | local2 | local3 | local4 | local5 | local6 | local7 | lpr | mail | news | syslog | user | uucp]
Syntax Description
logging server hostname ip address severity_level facility auth authpriv cron daemon ftp kernel local0 local1 local2 local3 local4 local5 local6 local7 lpr mail news syslog user uucp
Sets message logging for remote server. Enters host name for remote server. Enters the IP address for the remote server. Enter severity level of message. 0-emerg;1-alert;2-crit;3-err;4-warn;5-notif;6-inform;7-debug Facility to use when forwarding to server Use auth facility Use authpriv facility Use Cron/at facility Use daemon facility Use file transfer system facility Use kernel facility Use local0 facility Use local1 facility Use local2 facility Use local3 facility Use local4 facility Use local5 facility Use local6 facility Use local7 facility Use lpr facility Use mail facility Use USENET news facility Use syslog facility Use user facility Use Unix-to-Unix copy system facility
Defaults
None.
Command Modes
Configuration mode.
Command History
14-18
Chapter 14
L Commands logging server
Examples
Enable message logging to the specified remote server for level 7 messages.
switch## config terminal switch(config)# logging sever sanjose 7
Related Commands
14-19
Chapter 14 logging server
L Commands
14-20
C H A P T E R
15
M Commands
15-1
Chapter 15 match
M Commands
match
To configure QoS class map match criteria, use the match command in class map configuration submode. Remove QoS class map match criteria, use the no form of the command. match {any | destination-address fc-id [mask address-mask] | destination-device-alias name | destination-wwn wwn-id | input-interface fc slot/port | source-address fc-id [mask address-mask] | source-device-alias name | source-wwn wwn-id} no match {any | destination-address fc-id [mask address-mask] | destination-device-alias name | destination-wwn wwn-id | input-interface fc slot/port | source-address fc-id [mask address-mask] | source-device-alias name | source-wwn wwn-id}
Syntax Description
any destination-address fc-id mask address-mask destination-device-alias name destination-wwn wwn-id input-interface fc slot/port source-address fc-id source-device-alias name source-wwn wwn-id
Enables matching of any frame. Specifies the destination FCID to match frames. Specifies an address mask to match frames. The range is 0x0 to 0xffffffff. Specifies the destination device alias to match frames. Maximum length is 64 characters. Specifies the destination WWN to match frames. Specifies the source Fibre Channel interface to match frames. Specifies the source FCID to match frames. Specifies the source device alias to match frames. Maximum length is 64 characters. Specifies the source WWN to match frames.
Defaults
None.
Command Modes
Class map configuration submode.
Command History
Release 1.3(1) 2.0(1b)
Modification This command was introduced. Added the destination-device-alias and source-device-alias options.
Usage Guidelines
You can access this command only if you enable the QoS data traffic feature using the qos enable command.
15-2
Chapter 15
M Commands match
Examples The following example creates a class map called MyClass1 and places you in the class map configuration submode to match any (default) criteria specified for this class.
switch# config terminal switch(config)# qos class-map MyClass1 match-any switch(config-cmap)# match any
The following example specifies a destination address match for frames with the specified destination FCID.
switch(config-cmap)# match destination-address 0x12ee00
The following example specifies a source address and mask match for frames with the specified source FCID. Mask refers to a single or entire area of FCIDs.
switch(config-cmap)# match source-address 0x6d1090 mask 0
The following example specifies a destination WWN to match frames.

switch(config-cmap)# match destination-wwn 20:01:00:05:30:00:28:df Operation in progress. Please check class-map parameters
The following example specifies a source WWN to match frames.

switch(config-cmap)# match source-wwn 23:15:00:05:30:00:2a:1f Operation in progress. Please check class-map parameters
The following example specifies a source interface to match frames.

switch(config-cmap)# match input-interface fc 2/1 Operation in progress. Please check class-map parameters
The following example removes a match based on the specified source interface.
switch(config-cmap)# no match input-interface fc 3/5
Related Commands
Command qos enable show qos
Description Enables QoS. Displays QoS information.
15-3
Chapter 15 match address
M Commands
match address
To configure match addresses in an IPsec crypto map with an access control list (ACL), use the match address command in IPsec crypto map configuration submode. To not match addresses, use the no form of the command. match address acl-name no match address [acl-name]
Syntax Description
acl-name
Specifies the ACL name. Maximum length is 64 characters.
Defaults
None.
Command Modes
IPsec crypto map configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to match addresses in an IPsec crypto map with an ACL.
switch# config terminal switch(config)# crypto map domain ipsec x 1 switch(config-crypto-map-ip)# match address UserACL
Related Commands
15-4
Chapter 15
M Commands mcast root
mcast root
To configure the multicast feature, use the mcast root command in configuration mode. To revert to the default, use the no form of the command. mcast root {lowest | principal} vsan vsan-id no mcast root {lowest | principal} vsan vsan-id
Syntax Description
lowest principal vsan vsan-id
Specifies the lowest domain switch as root. Specifies the principal switch as root. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
principal
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to configure the multicast root VSAN.
switch# config terminal switch(config)# mcast root principal vsan 4001
Related Commands
Command show mcast
Description Displays multicast information.
15-5
Chapter 15 member (ivr zone configuration submode)
M Commands
member (ivr zone configuration submode)

To add a member name to an Inter-VSAN Routing (IVR) zone, use the member command in IVR zone configuration submode. To remove a member name from an fcalias, use the no form of the command. member {device-alias aliasname {lun lun-id vsan vsan-id autonomous-fabric-id afid | vsan vsan-id autonomous-fabric-id afid} | pwwn pwwn-id {lun lun-id vsan vsan-id autonomous-fabric-id afid | vsan vsan-id autonomous-fabric-id afid}} no member {device-alias aliasname {lun lun-id vsan vsan-id autonomous-fabric-id afid | vsan vsan-id autonomous-fabric-id afid} | pwwn pwwn-id {lun lun-id vsan vsan-id autonomous-fabric-id afid | vsan vsan-id autonomous-fabric-id afid}}
Syntax Description
device-alias aliasname lun lun-id vsan vsan-id autonomous-fabric-id afid pwwn pwwn-id
Specifies the member device alias. Maximum length is 64 characters. Specifies the member LUN ID. The format is 0xhhhh[:hhhh[:hhhh[:hhhh]]], where h is a hexadecimal digit. Specifies the VSAN ID. The range is 1 to 4093. Specifies the AFID to the local VSAN. Specifies the member pWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal digit.
Defaults
None.
Command Modes
IVR zone configuration submode.
Command History
Release 1.3(1) 2.1(1a)
Modification This command was introduced. Added lun parameter.
Usage Guidelines
You can configure an IVR zone member based on the specified pWWN and LUN value or, based on the specified pWWN, LUN value, and AFID.
Examples
The following example shows how to configures an IVR zone member based on the device alias VSAN, and the AFID.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ivr zone name IvrLunZone switch(config-ivr-zone)# member device-alias Switch4 vsan 1 autonomous-fabric-id 14
15-6
Chapter 15
M Commands member (ivr zone configuration submode)
The following example shows how to configures an IVR zone member based on the pWWN, VSAN, and the AFID.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ivr zone name IvrLunZone switch(config-ivr-zone)# member pwwn 29:00:00:05:30:00:06:ea vsan 1 autonomous-fabric-id 14
Related Commands
Command show ivr zone
Description Displays the IVR zone information.
15-7
Chapter 15 member (zone configuration and zoneset-zone configuration submode)
M Commands
member (zone configuration and zoneset-zone configuration submode)

To add a member name to a Fibre Channel zone set zone member, use the member command in zone set zone configuration submode. To remove a member name from a zone set zones, use the no form of the command. member {device-alias aliasname [lun lun-id] | domain-id domain-id port-number port | fcalias alias-name [lun lun-id] | fcid fc-id [lun lun-id] | fwwn fwwn-id | interface fc slot/port [domain-id domain-id | swwn swwn-id] | ip-address ip-address | pwwn pwwn-id [lun lun-id] | symbolic-nodename nodename} no member {device-alias aliasname [lun lun-id] | domain-id domain-id port-number port | fcid fc-id [lun lun-id] | fwwn fwwn-id | interface fc slot/port [domain-id domain-id | swwn swwn-id] | ip-address ip-address | pwwn pwwn-id [lun lun-id] | symbolic-nodename nodename}
Syntax Description
device-alias aliasname lun lun-id domain-id domain-id alias-name port-number port fcid fc-id fwwn fwwn-id interface fc slot/port swwn swwn-id ip-address ip-address pwwn pwwn-id symbolic-nodename nodename
Specifies the member device alias. Maximum length is 64 characters. Specifies the member LUN ID. The format is 0xhhhh[:hhhh[:hhhh[:hhhh]]], where h is a hexadecimal digit. Specifies the member domain ID. The range is 1 to 239. The name of the fcalias. Maximum length is 64 characters. Specifies the member port number. The range is 0 to 255. Specifies the member FCID. The format is 0xhhhhhh, where h is a hexadecimal digit. Specifies the member fWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal digit. Specifies the member interface ID. Specifies the member sWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal digit. Specifies a member IP address. Specifies the member pWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal digit. Specifies the member symbolic node name. The maximum length is 255 characters.
Defaults
This command can be used in both zone configuration submode and zoneset-zone configuration submode.
Command Modes
Zone set zone configuration submode and zoneset-zone configuration submode.
15-8
Chapter 15
M Commands member (zone configuration and zoneset-zone configuration submode)
Command History Release 1.0(2) 2.1(1a) Modification This command was introduced. Added zoneset-zone configuration submode.
Usage Guidelines
Create a zone set zone member only if you need to add member to a zone from the zone set prompt.
Examples
The following example shows how to configure an fcalias called AliasSample on VSAN 3.
switch# config terminal Enter configuration commands, one per line. switch(config)# zone name zs1 vsan 1 switch(config-zone)# member fcid 0x111112 switch(config-zone)# End with CNTL/Z.
The following example shows how to configure an fcalias called AliasSample on VSAN 3.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# zoneset name ZoneSet1 vsan 1 switch(config-zoneset-zone)# member fcid 0x111112
Related Commands
Command
Description
zoneset (configuration Used to specify a name for a zone set. mode) zone name (zone set configuration submode) show zoneset Configures a zone in a zoneset.
Displays zone set information.
15-9
Chapter 15 member (zoneset configuration submode)
M Commands
member (zoneset configuration submode)

To configure zone set zone members, use the member command in zone set configuration submode. To remove a zone set member, use the no form of the command. member member-name no member member-name
Syntax Description
member-name
Specifies the member name. Maximum length is 64 characters.
Defaults
None.
Command Modes
Zone set configuration submode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to add a member zone to a zone set.
switch# config terminal switch(config)# zoneset name Zoneset1 vsan 10 switch(config-zoneset)# member ZoneA
Related Commands
Command show zone zoneset name
Description Displays zone information. Creates a zone set.
15-10
Chapter 15
M Commands mkdir
mkdir
To create a directory in the Flash file system, use the mkdir command in EXEC mode. mkdir directory
Syntax Description
directory
Name of the directory to create.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
This command is only valid on Class C Flash file systems. You can specify whether to create the directory on bootflash:, slot0, or volatile:. If you do not specify the device, the switch creates the directory on the current directory.
Examples
The following example creates a directory called test in the slot0: directory.
switch# mkdir slot0:test
The following example creates a directory called test at the current directory level. If the current directory is slot0:mydir, this command creates a directory called slot0:mydir/test.
switch# mkdir test
Related Commands
Command dir rmdir
Description Displays a list of files on a file system. Removes an existing directory in the Flash file system.
15-11
Chapter 15 modem connect line
M Commands
modem connect line

To enable a modem connection when the switch is already in operation, use the modem connect line command in EXEC mode. modem connect line {com1 | console}
Syntax Description
com1 console
Connects the modem through a COM1 line connection Connects the modem through a console line connection
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Usage Guidelines
If the switch is already in operation when the modem is connected, issue this command to notify the software that a modem is going to be added. You must issue the modem connect line command before setting the user-input string for initialization.
Examples
The following example announces a modem connection from the line console.
switch# modem connect line console
The following example announces a modem connection from the COM1 port.
switch# modem connect line com1
15-12
Chapter 15
M Commands move
move
To remove a file from the source file and place it in the destination file, use the move command in EXEC mode. move {bootflash: | slot0: | volatile:}[directory/]filename {bootflash: | slot0: | volatile:}[directory/]filename
Syntax Description
bootflash: slot0: volatile: directory filename
Source or destination location for internal bootflash memory. Source or destination location for the CompactFlash memory or PCMCIA card. Source or destination location for volatile memory. Specifies the name of the directory. Specifies the name of the file to move or create.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
If you do not specify the directory name in the command line, the switch prompts you for it.
Examples
The following example moves the file called samplefile from the slot0 directory to the mystorage directory.
switch# move slot0:samplefile slot0:mystorage/samplefile
Related Commands
Command dir mkdir rmdir
Description Displays a list of files on a file system. Creates a directory in the Flash file system. Removes an existing directory in the Flash file system.
15-13
Chapter 15 mutual-chap username (iSCSI initiator mode)
M Commands
mutual-chap username (iSCSI initiator mode)

To assign a username and password for initiator challenge (mutual CHAP) to an iSCSI initiator, use the mutual-chap username command in iSCSI initiator configuration submode. To disable this feature, use the no form of the command. mutual-chap username username password {0|7} password no mutual-chap username username password {0|7} password
Syntax Description
username password 0 7 password
Specifies the username for iSCSI login authentication. Configures the password for the username. Specifies that the password is a cleartext CHAP password. Specifies that the password is an encrypted CHAP password. Specifies a password for the username.
Defaults
None.
Command Modes
iSCSI initiator configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to configuring a username, password type, and password for initiator challenge (mutual CHAP).
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# iscsi initiator name iqn.1987-02.com.cisco.initiator switch(config-iscsi-init)# mutual-chap username userName password 0 cisco switch(config-iscsi-init)#
Related Commands
Command iscsi initiator name show iscsi initiator
Description Assigns an iSCSI name and changes to iSCSI initiator configuration submode. Displays information about configured iSCSI initiators.
15-14
C H A P T E R
16
N Commands
16-1
Chapter 16 nasb module
N Commands
nasb module
To enable Network-Accelerated Serverless Backup (NASB) on a VSAN and map it to the Storage Services Module (SSM) where the feature has been enabled, use the nasb module command in EXEC mode. To disable this feature, use the no form of the command. nasb module slot-number vsan vsan-id [control] no nasb module slot-number vsan vsan-idr
Syntax Description
slot-number vsan vsan-id control
Specifies slot number of the connected module. Configures up to five VSANs to be added to the database. The range is 1 to 4096. Configures XCOPY target LUNs as control LUNs rather than disk LUNs.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.1(1a)
Usage Guidelines
This feature must be enabled on the SSM using the ssm enable feature command before you can configure NASB.
Examples
The following example configures NASB on the SSM installed in slot 4 with a link to VSAN 1.
switch# config terminal Enter configuration commands, one per line. switch(config)# nasb module 4 vsan 1 End with CNTL/Z.
Related Commands
Command ssm enable feature show nasb
Description Enables the NASB feature on the Advanced Services Module (ASM) or Storage Services Module (SSM). Displays the NASB configuration on the SSM.
16-2
Chapter 16
N Commands nport pwwn
nport pwwn
To configure the nport pWWN for the SAN extension tuner, use the nport pwwn command in SAN extension configuration mode. To revert to the default value, use the no form of the command. nport pwwn pwwn-id vsan vsan-id interface gigabitethernet slot/port no nport pwwn pwwn-id vsan vsan-id interface gigabitethernet slot/port
Syntax Description
pwwn-id vsan vsan-id interface gigabitethernet slot/port
Specifies the port WWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number. Specifies the VSAN ID. The range is 1 to 4093. Specifies the Gigabit Ethernet interface slot and port.
Defaults
None.
Command Modes
SAN extension configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to add an entry to the SAN extension tuner database.
switch# san-ext-tuner switch(san-ext)# nport pwwn 11:22:33:44:55:66:77:88 vsan 1 interface gigabitethernet 1/1
Related Commands
Command san-ext-tuner show san-ext-tuner
Description Enters SAN extension configuration mode. Shows SAN extension tuner information.
16-3
Chapter 16 ntp
N Commands
ntp
To configure NTP settings on the switch, use the ntp command in configuration mode. ntp {peer hostname | server | tstamp-check}
Syntax Description
peer hostname server tstamp-check
The hostname/IP address of the NTP peer (Max Size - 80). The hostname/IP address of the NTP server (Max Size - 80). Enables or disables the Timestamp Check.
Defaults
This command has no default settings.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
This example forms a server association with a server.

switch(config)# ntp server 10.10.10.10 switch(config)#
This example forms a peer association with a peer. You can specify multiple associations.
switch(config)# ntp peer 10.20.10.0 switch(config)#
16-4
Chapter 16
N Commands ntp abort
ntp abort
To discard the Network Time Protocol (NTP) Cisco Fabric Services (CFS) distribution session in progress, use the ntp abort command in configuration mode. ntp abort
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to configure NTP CFS distribution session in progress.
switch# config terminal switch(config)# ntp abort
Related Commands
Command ntp distribute show ntp
Description Enables CFS distribution for NTP. Displays NTP information.
16-5
Chapter 16 ntp commit
N Commands
ntp commit
To apply the pending configuration pertaining to the Network Time Protocol (NTP) Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the ntp commit command in configuration mode. ntp commit
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to commit changes to the active NTP configuration.
switch# config terminal switch(config)# ntp commit
Related Commands
Command ntp distribute show ntp
Description Enables CFS distribution for NTP. Displays NTP information.
16-6
Chapter 16
N Commands ntp distribute
ntp distribute
To enable Cisco Fabric Services (CFS) distribution for Network Time Protocol (NTP), use the ntp distribute command. To disable this feature, use the no form of the command. ntp distribute no ntp distribute
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Command History
Release 2.0(1b)
Usage Guidelines
Before distributing the Fibre Channel timer changes to the fabric, the temporary changes to the configuration must be committed to the active configuration using the ntp commit command.
Examples
The following example shows how to distribute the active NTP configuration to the fabric.
switch# config terminal switch(config)# ntp distribute
Related Commands
Command ntp commit show ntp
Description Commits the NTP configuration changes to the active configuration. Displays NTP information.
16-7
Chapter 16 nwwn (DPVM database configuration submode)
N Commands
nwwn (DPVM database configuration submode)

To add a device to a dynamic port VSAN membership (DPVM) database using the nWWN, use the nwwn command in DPVM database configuration submode. To remove a device from a DPVM database using the nWWN, use the no form of the command. nwwn nwwn-id vsan vsan-id no nwwn nwwn-id vsan vsan-id
Syntax Description
nwwn-id vsan vsan-id
Specifies the node WWN ID. The format is hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
DPVM database configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to add an entry to the DPVM database.
switch# config terminal switch(config)# dpvm database switch(config-dpvm-db)# nwwn 11:22:33:44:55:66:77:88 vsan 1
The following example shows how to delete an entry from the DPVM database.
switch(config-dpvm-db)# no nwwn 11:22:33:44:55:66:77:88 vsan 1
Related Commands
Command dpvm database show dpvm
Description Configures the DPVM database. Displays DPVM database information.
16-8
Chapter 16
N Commands nwwn (SAN extension configuration mode)
nwwn (SAN extension configuration mode)

To configure the nWWN for the SAN extension tuner, use the nwwn command in SAN extension configuration submode. nwwn nwwn-id
Syntax Description
nwwn-id
Specifies the nWWN address. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number.
Defaults
None.
Command Modes
SAN extension configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to add an entry to the SAN extension tuner database.
switch# san-ext-tuner switch(san-ext)# nwwn 20:42:00:0b:46:79:f1:80
Related Commands
Command san-ext-tuner show san-ext-tuner
Description Enters SAN extension configuration mode. Shows SAN extension tuner information.
16-9
Chapter 16 nwwn (SAN extension configuration mode)
N Commands
16-10
C H A P T E R
17
P Commands
17-1
Chapter 17 passive-mode
P Commands
passive-mode
To configure the required mode to initiate an IP connection, use the passive-mode command. To enable passive mode for the FCIP interface, use the no form of the command. passive-mode no passive-mode
Syntax Description
This command has no keywords or arguments.
Defaults
Disabled
Command Modes
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode. By default, the active mode is enabled to actively attempt an IP connection. If you enable the passive mode, the switch does not initiate a TCP connection and merely waits for the peer to connect to it.
Examples
The following example enables passive mode on an FCIP interface.

switch# config terminal switch(config)# interface fcip 1 switch(config-if)# passive-mode
Related Commands
17-2
Chapter 17
P Commands peer-info ipaddr
peer-info ipaddr
To configure the peer information for the FCIP interface, use the peer-info ipaddr command. To remove the peer information for the FCIP interface, use the no form of the command. peer-info ipaddr address [port number] no peer-info ipaddr address [port number]
Syntax Description
ipaddr address port number
Configures the peer IP address. Configures a peer port. The range is 1 to 65535.
Defaults
None.
Command Modes
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode. The basic FCIP configuration uses the peers IP address to configure the peer information. You can also use the peers port number, port profile ID, or port WWN to configure the peer information. If you do not specify a port, the default 3225 port number is used to establish connection.
Examples
The following command assigns an IP address to configure the peer information. Since no port is specified, the default port number, 3225, is used.
switch# config terminal switch(config)# interface fcip 10 switch(config-if)# peer-info ipaddr 10.1.1.1
The following command deletes the assigned peer port information.

switch(config-if)# no peer-info ipaddr 10.10.1.1
The following command assigns the IP address and sets the peer TCP port to 3000. The valid port number range is from 0 to 65535.
switch(config-if)# peer-info ipaddr 10.1.1.1 port 3000
The following command deletes the assigned peer port information.

switch(config-if)# no peer-info ipaddr 10.1.1.1 port 2000
17-3
Chapter 17 peer-info ipaddr
P Commands
Related Commands Command show interface fcip Description Displays an interface configuration for a specified FCIP interface.
17-4
Chapter 17
P Commands periodic-inventory notification
periodic-inventory notification
To enable the periodic inventory notification message dispatches, use the periodic-inventory notification command Call Home configuration submode. To revert to the default state, use the no form of the command. periodic-inventory notification [interval days] no periodic-inventory notification
Syntax Description
interval days
Specifies the notification interval. The range is 1 to 30.
Defaults
Disabled. The initial default interval is 7 days.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to enable periodic inventory notification and use the default interval.
switch# config terminal switch(config)# callhome switch(config-callhome)# periodic-inventory notification
The following example shows how to enable periodic inventory notification and set the interval to 10 days.
switch# config terminal switch(config)# callhome switch(config-callhome)# periodic-inventory notification interval 10
Related Commands
Command callhome show callhome
Description Enters Call Home configuration submode. Displays Call Home configuration information.
17-5
Chapter 17 phone-contact
P Commands
phone-contact
To configure the telephone contact number with the Call Home function, use the phone-contact command in Call Home configuration submode. To disable this feature, use the no form of the command. phone-contact number no phone-contact number
Syntax Description
number
(Optional) Configures the customers phone number. Allows up to 20 alphanumeric characters in international phone format.
Note
Do not use spaces. Use the + prefix before the number.
Defaults
None.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to configure the telephone contact number with the Call Home function.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# callhome switch(config-callhome)# phone-contact +1-800-123-4567
Related Commands
17-6
Chapter 17
P Commands ping
ping
To diagnose basic network connectivity, use the ping (packet internet groper) command in EXEC mode. ping {host-name | system-address}
Syntax Description
host-name system-address
Host name of system to ping. Maximum length is 64 characters. Address of system to ping.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The ping program sends an echo request packet to an address, and then awaits a reply. The ping output can help you evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning. Verify connectivity to the TFTP server using the ping command. To abnormally terminate a ping session, type the Ctrl-C escape sequence
Examples
The following example pings system 192.168.7.27.

switch# ping 192.168.7.27 PING 192.168.7.27 (192.168.7.27): 56 data bytes 64 bytes from 192.168.7.27: icmp_seq=0 ttl=255 time=0.4 64 bytes from 192.168.7.27: icmp_seq=1 ttl=255 time=0.2 64 bytes from 192.168.7.27: icmp_seq=2 ttl=255 time=0.2 64 bytes from 192.168.7.27: icmp_seq=3 ttl=255 time=0.2
ms ms ms ms
--- 192.168.7.27 ping statistics --13 packets transmitted, 13 packets received, 0% packet loss round-trip min/avg/max = 0.2/0.2/0.4 ms
17-7
Chapter 17 policy
P Commands
policy
To enter IKE policy configuration and configure a policy for the IKE protocol, use the policy command in IKE configuration submode. To delete the policy, use the no form of the command. policy priority no policy priority
Syntax Description
priority
Specifies the priority for the IKE policy. The range is 1 to 255, where 1 is the high priority and 255 is the lowest.
Defaults
None.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to configure a policy priority number for the IKE protocol.
switch# config terminal switch(config)# crypto ike domain ipsec switch(config-ike-ipsec)# policy 1 switch(config-ike-ipsec-policy)#
Related Commands
17-8
Chapter 17
P Commands port
port
To assign the TCP port number of a Gigabit Ethernet interface to the FCIP profile or a listener peer port for a ISCSI interface, use the port command. Use the no form of the command to negate the command or revert to factory defaults. port number no port number
Syntax Description
port number
Configures a peer port. The range is 1 to 65535.
Defaults
Disabled
Command Modes
Fcip profile configuration submode Interface configuration submode
Command History
Usage Guidelines
Associates the profile with the assigned local port number. If a port number is not assigned for a FCIP profile, the default TCP port 3225 is used.
Examples
The following example configures port 5000 on FCIP interface 5.

switch# config terminal switch(config)# fcip profile 5 switch(config-profile)# port 5000
The following example configures port 4000 on ISCSI interface 2/1.

switch# config terminal switch(config)# interface iscsi 2/1 switch(config-profile)# port 4000
Related Commands
17-9
Chapter 17 port-channel persistent
P Commands
port-channel persistent
To convert an autocreated PortChannel to a persistent PortChannel, use the port-channel persistent command in EXEC mode. port-channel port-channel-id persistent
Syntax Description
port-channel-id
Specifies the port channel ID. The range is 1 to 128.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
This command is not reversible. A user-created channel group cannot be converted to an autocreated channel group.When the port-channel persistent command is applied to an autocreated channel group, the channel group number does not change and the member ports properties change to those of a user-created channel group. The channel mode remains active.
Examples
The following example shows how to change the properties of an autocreated channel group to a persistent channel group.
switch# port-channel 10 persistent
Related Commands
Command port-channel protocol show port-channel
Description Enables the PortChannel protocol. Displays PortChannel information.
show interface port-channel Displays PortChannel interface information.
17-10
Chapter 17
P Commands port-security
port-security
To configure port security features and reject intrusion attempts, use the port-security command in configuration mode. Use the no form of the command to negate the command or revert to factory defaults. port-security {activate vsan vsan-id [force | no-auto-learn] | auto-learn vsan vsan-id | database vsan vsan-id {any-wwn | pwwn wwn | nwwn wwn | swwn wwn} [fwwn wwn | interface {fc slot/port | port-channel number} | swwn wwn [interface {fc slot/port | port-channel number}]]} no port-security {activate vsan vsan-id [force | no-auto-learn] | auto-learn vsan vsan-id | database vsan vsan-id {any-wwn | pwwn wwn | nwwn wwn | swwn wwn} [fwwn wwn | interface {fc slot/port | port-channel number} | swwn wwn [interface {fc slot/port | port-channel number}]]}
Syntax Description
activate auto-learn database any-wwn nwwn wwn pwwn wwn swwn wwn fwwn wwn interface fc slot/port port-channel number vsan vsan-id force no-auto-learn
Activates a port security database for the specified VSAN and automatically enables auto-learn. Enables auto-learning for the specified VSAN. Enters the port security database configuration mode for the specified VSAN. Specifies any WWN to login to the switch. Specifies the node WWN as the Nx port connection. Specifies the port WWN as the Nx port connection. Specifies the switch WWN as the xE port connection. Specifies a fabric WWN login. Specifies the device or switch port interface through which each device is connected to the switch. Specifies a Fibre Channel interface by the slot and port. Specifies a PortChannel interface. The range is 1 to 128. Specifies the VSAN ID. The range is 1 to 4093. Forces the database activation. Disables the autolearn feature for the port security database.
Defaults
Disabled.
Command Modes
Configuration mode.
17-11
Chapter 17 port-security
P Commands
Command History Release 1.2(1) 2.0(1b) Modification This command was introduced. Add the optional swwn keyword to the subcommands under the port-security database vsan command.
Usage Guidelines
When you activate the port security feature, the auto-learn option is also automatically enabled. You can choose to activate the port-security feature and disable autolearn using the port-security activate vsan number no-auto-learn command. In this case, you need to manually populate the port security database by individually securing each port. If the auto-learn option is enabled on a VSAN, you cannot activate the database for that VSAN without the force option.
Examples
The following example activates the port security database for the specified VSAN, and automatically enables autolearning.
switch# config terminal switch(config)# port-security activate vsan 1
The following example deactivates the port security database for the specified VSAN, and automatically disables auto-learn.
switch# config terminal switch(config)# no port-security activate vsan 1
The following example disables the auto-learn feature for the port security database in VSAN 1.
switch# config terminal switch(config)# port-security activate vsan 1 no-auto-learn
The following example enables auto-learning so the switch can learn about any device that is allowed to access VSAN 1. These devices are logged in the port security active database.
switch# config terminal switch(config)# port-security auto-learn vsan 1
The following example disables auto-learning and stops the switch from learning about new devices accessing the switch. Enforces the database contents based on the devices learnt up to this point.
switch# config terminal switch(config)# no port-security auto-learn vsan 1
The following example enters the port security database mode for the specified VSAN.
switch# config terminal switch(config)# port-security database vsan 1 switch(config-port-security)#
The following example configures any WWN to login through the specified interfaces.
switch(config-port-security)# any-wwn interface fc1/1 - fc1/8
The following example configures the specified pWWN to only log in through the specified fWWN.
switch(config-port-security)# pwwn 20:11:00:33:11:00:2a:4a fwwn 20:81:00:44:22:00:4a:9e
The following example deletes the specified pWWN configured in the previous step.
switch(config-port-security)# no pwwn 20:11:00:33:11:00:2a:4a fwwn 20:81:00:44:22:00:4a:9e
17-12
Chapter 17
P Commands port-security
The following example configures the specified pWWN to only log in through the specified sWWN.
switch(config-port-security)# pwwn 20:11:00:33:11:00:2a:4a swwn 20:00:00:0c:85:90:3e:80
The following example deletes the specified pWWN configured in the previous step.
switch(config-port-security)# no pwwn 20:11:00:33:11:00:2a:4a swwn 20:00:00:0c:85:90:3e:80
The following example configures the specified nWWN to log in through the specified fWWN.
switch(config-port-security)# nwwn 26:33:22:00:55:05:3d:4c fwwn 20:81:00:44:22:00:4a:9e
The following example configures the specified pWWN to login through any port on the local switch.
switch(config-port-security)# pwwn 20:11:33:11:00:2a:4a:66
The following example configures the specified sWWN to only login through PortChannel 5.
switch(config-port-security)# swwn 20:01:33:11:00:2a:4a:66 interface port-channel 5
The following example configures any WWN to log in through the specified interface.
switch(config-port-security)# any-wwn interface fc3/1
The following example deletes the wildcard configured in the previous step.
switch(config-port-security)# no any-wwn interface fc2/1
The following example deletes the port security configuration database from the specified VSAN.
switch# config terminal switch(config)# no port-security database vsan 1 switch(config)#
The following example forces the VSAN 1 port security database to activate despite conflicts.
switch(config)# port-security activate vsan 1 force
Related Commands
Command show port-security database
Description Displays configured port security information.
17-13
Chapter 17 port-security abort
P Commands
port-security abort
To discard the port security Cisco Fabric Services (CFS) distribution session in progress, use the port-security abort command in configuration mode. port-security abort vsan vsan-id
Syntax Description
vsan vsan-id
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to discard a port security CFS distribution session in progress.
switch# config terminal switch(config)# port-security abort vsan 33
Related Commands
Command port-security distribute show port-security
Description Enables CFS distribution for port security. Displays port security information.
17-14
Chapter 17
P Commands port-security commit
port-security commit
To apply the pending configuration pertaining to the port security Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the port-security commit command in configuration mode. port-security commit vsan vsan-id
Syntax Description
vsan vsan-id
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to commit changes to the active port security configuration.
switch# config terminal switch(config)# port-security commit vsan 13
Related Commands
Command port-security distribute show port-security
Description Enables CFS distribution for port security. Displays port security information.
17-15
Chapter 17 port-security database
P Commands
port-security database
To copy the port security database or to view the difference within the port security database, use the port-security database command in EXEC mode. port-security database {copy | diff {active | config}} vsan vsan-id
Syntax Description
port-security database copy diff active config vsan vsan-id
Activates a port security database for the specified VSAN and automatically enables auto-learn. Enters the port security database configuration mode for the specified VSAN. Copies the active database to the configuration database. Provides the difference between the active and configuration port security database. Writes the active database to the configuration database. Writes the configuration database to the active database. Specifies the VSAN ID. The ranges is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
If the active database is empty, the port-security database is empty. Use the port-security database diff active command to resolve conflicts.
Examples
The following example copies the active to the configured database.

switch# port-security database copy vsan 1
The following example provides the differences between the active database and the configuration database.
switch# port-security database diff active vsan 1
The following example provides information on the differences between the configuration database and the active database.
switch# port-security database diff config vsan 1
17-16
Chapter 17
P Commands port-security database
Related Commands Command Description
port-security database Copies and provides information on the differences within the port security database. show port-security database Displays configured port security information.
17-17
Chapter 17 port-security distribute
P Commands
port-security distribute
To enable Cisco Fabric Services (CFS) distribution for port security, use the port-security distribute command. To disable this feature, use the no form of the command. port-security distribute no port-security distribute
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Command History
Release 2.0(1b)
Usage Guidelines
Before distributing the Fibre Channel timer changes to the fabric, the temporary changes to the configuration must be committed to the active configuration using the port-security commit command.
Examples
The following example shows how to distribute the port security configuration to the fabric.
switch# config terminal switch(config)# port-security distribute
Related Commands
Command port-security commit show port-security
Description Commits the port security configuration changes to the active configuration. Displays port security information.
17-18
Chapter 17
P Commands port-security enable
port-security enable
To enable port security, use the port-security enable command in configuration mode. To disable port security, use the no form of the command. port-security enable no port-security enable
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
Issuing the port-security enable command enables the other commands used to configure port security.
Examples
The following example shows how to enable port security.

switch# config terminal switch(config)# port-security enable
The following example shows how to disable port security.

switch# config terminal switch(config)# no port-security enable
Related Commands
Command show port-security
Description Displays port security information.
17-19
Chapter 17 port-track enable
P Commands
port-track enable
To enable port tracking for indirect errors, use the port-track enable command in configuration mode. To disable this feature, use the no form of the command. port-track enable no port-track enable
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
The software brings the linked port down when the tracked port goes down. When the tracked port recovers from the failure and comes back up again, the tracked port is also brought up automatically (unless otherwise configured).
Examples
The following example shows how to enable port tracking.

switch# config terminal switch(config)# port-track enable
The following example shows how to disable port tracking.

switch# config terminal switch(config)# no port-track enable
Related Commands
Command show interface fc show interface port-channel
Description Displays configuration and status information for a specified Fibre Channel interface. Displays configuration and status information for a specified PortChannel interface.
17-20
Chapter 17
P Commands port-track force-shut
port-track force-shut
To force a shutdown of a tracked port, use the port-track force-shut command in interface configuration submode. To reenable the port tracking, use the no form of the command. port-track force-shut no port-track force-shut
Syntax Description
Defaults
None.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
Use the port-track force-shut to keep the linked port down, even though the tracked port comes back up. You must explicitly bring the port up when required using the no port-track force-shut command.
Examples
The following example shows how to force the shutdown of an interface and the interfaces that it is tracking.
switch# config terminal switch(config)# interface fc 1/2 switch(config-if)# oport-track force-shut
Related Commands
Command port-track enable show interface fc show interface port-channel
Description Enables port tracking. Displays configuration and status information for a specified Fibre Channel interface. Displays configuration and status information for a specified PortChannel interface.
17-21
Chapter 17 port-track interface
P Commands
port-track interface
To enable port tracking for specific interfaces, use the port-track interface command in interface configuration submode. To disable this feature, use the no form of the command. port-track interface {fc slot/port | fcip port | gigabitethernet slot/port | port-channel port} [vsan vsan-id] no port-track interface {fc slot/port | fcip port | gigabitethernet slot/port | port-channel port} [vsan vsan-id]
Syntax Description
fc slot/port fcip port gigabitethernet slot/port port-channel port vsan vsan-id
Specifies a Fibre Channel interface. Specifies a FCIP interface. Specifies a Gigabit Ethernet interface. Specifies a PortChannel interface. The range is 1 to 128. Specifies a VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
When the ports that an interface is tracking goes down, the interface also goes down. When the tracked port comes backup, the linked interface also comes back up. Use the port-track force-shut command to keep the linked interface down.
Examples
The following example shows how to enable port tracking for specific interfaces.
switch# config terminal switch(config)# interface fc 1/2 switch(config-if)# port-track interface port-channel 2 switch(config-if)# port-track interface fcip 5
Related Commands
Command port-track enable port-track force-shut
Description Enables port tracking. Forcefully shuts an interface for port tracking.
17-22
Chapter 17
P Commands port-track interface
Command show interface fc Description Displays configuration and status information for a specified Fibre Channel interface.
show interface port-channel Displays configuration and status information for a specified PortChannel interface.
17-23
Chapter 17 portaddress
P Commands
portaddress
To enable the FICON feature in a specified VSAN, use the ficon vsan command in configuration mode. To disable the feature or to revert to factory defaults, use the no form of the command. portaddress portaddress block name string prohibit portaddress portaddress portaddress portaddress no block no name string no prohibit portaddress portaddress
Syntax Description
portnumber block name string prohibit portaddress
Specifies the FICON port number for this interface. The range is 0 to 254. Blocks a port address. Configures a name for the port address. Maximum length is 24 characters. Prohibit communication with a portaddress.
Defaults
None.
Command Modes
Command History
Usage Guidelines
The shutdown/no shutdown port state is independent of the block/no block port state. If a port is shutdown, unblocking that port will not initialize the port. You cannot block or prohibit CUP port (0XFE). If you prohibit ports, the specified ports are prevented from communicating with each other. Unimplemented ports are always prohibited.
Examples
The following example disables a port address and retains it in the operationally down state.
switch# config terminal switch(config)# ficon vsan 2 switch(config-ficon)# portaddress 1 switch(config-ficon-portaddr)# block
17-24
Chapter 17
P Commands portaddress
The following example enables the selected port address and reverts to the factory default of the port address not being blocked.
switch(config-ficon-portaddr)# no block
The following example prohibits port address 1 in VSAN 2 from talking to ports 3.
switch(config-ficon-portaddr)# prohibit portaddress 3
The following example removes port address 5 from a previously-prohibited state.

switch(config-ficon-portaddr)# no prohibit portaddress 5
The following example assigns a name to the port address.

switch(config-ficon-portaddr)# name SampleName
The following example deletes a previously configured port address name.

switch(config-ficon-portaddr)# no name SampleName
Related Commands
Command show ficon
17-25
Chapter 17 power redundancy-mode
P Commands
power redundancy-mode
To configure the capacity of the power supplies on the Cisco MDS 9500 Family of switches, use the power redundancy-mode command in configuration mode. Use the no form of the command to negate the command or revert to factory defaults. power redundancy-mode {combined [force] | redundant} no power redundancy-mode {combined [force] | redundant}
Syntax Description
combined force redundant
Configures power supply redundancy mode as combined. Forces combined mode without prompting. Configures power supply redundancy mode as redundant.
Defaults
Redundant mode.
Command Modes
Configuration mode
Command History
Usage Guidelines
If power supplies with different capacities are installed in the switch, the total power available differs based on the configured mode: In redundant mode, the total power is the lesser of the two power supply capacities. This reserves enough power to keep the system powered on in case of a power supply failure. This is the recommended or default mode. In combined mode, the total power is twice the lesser of the two power supply capacities. In case of a power supply failure, the entire system could be shut down, depending on the power usage at that time. When a new power supply is installed, the switch automatically detects the power supply capacity. If the new power supply has a capacity that is lower than the current power usage in the switch and the power supplies are configured in redundant mode, the new power supply will be shut down. When you change the configuration from combined to redundant mode and the system detects a power supply that has a capacity lower than the current usage, the power supply is shut down. If both power supplies have a lower capacity than the current system usage, the configuration is not allowed.
Examples
The following examples demonstrate how the power supply redundancy mode could be set.
switch(config)# power redundancy-mode combined WARNING: This mode can cause service disruptions in case of a power supply failure. Proceed ? [y/n] y switch(config)# power redundancy-mode redundant
17-26
Chapter 17
P Commands power redundancy-mode
Related Commands Command show environment power copy running-config startup-config Description Displays status of power supply modules, power supply redundancy mode, and power usage summary. Copies all running configuration to the startup configuration.
17-27
Chapter 17 poweroff module
P Commands
poweroff module
To power off individual modules in the system, use the poweroff module command in configuration mode. Use the no form of this command to power up the specified module. poweroff module slot no poweroff module slot
Syntax Description
slot
Specifies the slot number for the module.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Use the poweroff module command to power off individual modules. The poweroff module command cannot be used to power off supervisor modules.
Examples
The following example powers off and powers up module 1.

switch# config terminal switch(config)# poweroff module 1 switch(config)# switch(config)# no poweroff module 1 switch(config)#
Related Commands
Command show module copy running-config startup-config
Description Displays information for a specified module. Copies all running configuration to the startup configuration.
17-28
Chapter 17
P Commands priority
priority
To configure the priority in a QoS policy map class, use the priority command in QoS policy class map configuration submode. To disable this feature, use the no form of the command. priority {high | low | medium} no priority {high | low | medium}
Syntax Description
high low medium
Configures the frames matching the class-map as high priority. Configures the frames matching the class-map as low priority. The default. Configures the frames matching the class-map as medium priority.
Defaults
The default priority is low.
Command Modes
QoS policy map class configuration submode.
Command History
Release 1.3(1)
Usage Guidelines
Before you can configure the priority in a QoS policy map class you must first:

Enable the QoS data traffic feature using the qos enable command. Configure a QoS class map using the qos class-map command. Configure a QoS policy map using the qos policy-map command. Configure a QoS policy map class using the class command.
Examples
The following example shows how to select the QoS policy class-map1 and configure the frame priority as high.
switch(config-pmap)# class class-map1 switch(config-pmap-c)# priority high Operation in progress. Please check class-map parameters switch(config-pmap-c)#
Related Commands
Command qos enable qos class-map qos policy-map
Description Enables the QoS data traffic feature on the switch. Configures a QoS class map. Configure a QoS policy map.
17-29
Chapter 17 priority
P Commands
Command class show qos Description Configure a QoS policy map class. Displays the current QoS settings.
17-30
Chapter 17
P Commands purge fcdomain fcid
purge fcdomain fcid

To purge persistent FCIDs, use the purge fcdomain fcid command in EXEC mode. purge fcdomain fcid vsan vsan-id
Syntax Description
vsan vsan-id
Indicates that FCIDs are to be purged for a VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to purge all dynamic, unused FCIDs in VSAN 4
switch# purge fcdomain fcid vsan 4 switch#
The following example shows how to purge all dynamic, unused FCIDs in VSANs 4, 5, and 6.
switch# purge fcdomain fcid vsan 3-5 switch#
17-31
Chapter 17 purge module
P Commands
purge module
To delete configurations in the running configuration for nonexistent modules, use the purge module command in EXEC mode. purge module slot running-config
Syntax Description
slot running-config
Specifies the module slot number. Purges the running configuration from the specified module.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
This command cannot be issued on a supervisor module.
Examples
The following example displays the output of the purge module command issued on the module in slot 8.
switch# purge module 8 running-config switch#
17-32
Chapter 17
P Commands pwd
pwd
To display the current directory location, use the pwd command in EXEC mode. pwd
Syntax Description
This command has no keywords or arguments.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example changes the directory and displays the current directory.
switch# cd bootflash:logs switch# pwd bootflash:/logs
Related Commands
Command cd dir
Description Changes the current directory to the specified directory. Displays the contents of a directory.
17-33
Chapter 17 pwwn (DPVM database configuration submode)
P Commands
pwwn (DPVM database configuration submode)

To add a device to a dynamic port VSAN membership (DPVM) database using the pWWN, use the pwwn command in DPVM database configuration submode. To remove a device from a DPVM database using the pWWN, use the no form of the command. pwwn pwwn-id vsan vsan-id no pwwn pwwn-id vsan vsan-id
Syntax Description
pwwn-id vsan vsan-id
Specifies the port WWN ID. The format is hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
DPVM database configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to add an entry to the DPVM database.
switch# config terminal switch(config)# dpvm database switch(config-dpvm-db)# pwwn 11:22:33:44:55:66:77:88 vsan 1
The following example shows how to delete an entry from the DPVM database.
switch(config-dpvm-db)# no pwwn 11:22:33:44:55:66:77:88 vsan 1
Related Commands
Command dpvm database show dpvm
Description Configures the DPVM database. Displays DPVM database information.
17-34
C H A P T E R
18
Q Commands
18-1
Chapter 18 qos class-map
Q Commands
qos class-map
To create and define a traffic class with match criteria that will be used to identify traffic, use the qos class-map command in configuration mode. To remove a previously-configured class, use the no form of the command. qos class-map class [match-all | match-any] no qos class-map class
Syntax Description
class-name match-all match-any
Specifies a class map name. Maximum length is 63 alpha-numeric characters. Specifies a logical AND operator for all matching statements in this class. (default). Specifies a logical OR operator for all matching statements in this class.
Defaults
match-all
Command Modes
Configuration mode.
Command History
Usage Guidelines
Examples
The following example shows how to create a QoS class map and enter class map configuration mode.
switch# config terminal switch(config)# qos class-map MyClass1 switch(config-cmap)#
Related Commands
Command show qos
Description Displays configured QoS information.
18-2
Chapter 18
Q Commands qos control priority
qos control priority

To enable the QoS priority assignment for control traffic feature on the Cisco MDS 9000 family of switches, use the qos control command in configuration mode. To revert to the factory default, use the no form of the command. qos control priority 0 no qos priority control 0
Syntax Description
Specifies the lowest priority. To revert to the highest priority, use the no form of the command.
Defaults
Enabled and priority 7 are the defaults.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example sets the QoS priority assignment to the highest level.
switch# config terminal switch(config)# no qos control priority 0
Related Commands
Command show qos
18-3
Chapter 18 qos enable
Q Commands
qos enable
To enable the QoS priority assignment for data traffic feature on the Cisco MDS 9000 family of switches, use the qos enable command in configuration mode. To disable the QoS priority assignment for control traffic feature, use the no form of the command. qos enable no qos enable
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example disables the QoS priority assignment feature.

switch# config terminal switch(config)# qos enable
Related Commands
Command show qos
18-4
Chapter 18
Q Commands qos dwrr-q
qos dwrr-q
To associate a weight with a deficit weighted round robin (DWRR) scheduler queue, use the qos dwrr-q command in configuration mode. To remove a previously-configured class, use the no form of the command. qos dwrr-q {high | low | medium} weight value no qos dwrr-q {high | low | medium} weight value
Syntax Description
high low medium weight value
Assigns the DWRR queue high option to DWRR queues. Assigns the DWRR queue low option to DWRR queues. Assigns the DWRR queue medium option to DWRR queues. Specifies DWRR queue weight
Defaults
10
Command Modes
Configuration mode.
Command History
Usage Guidelines
Examples
The following example specifies the DWRR queue priority.

switch# config terminal switch(config)# qos dwrr-q high weight 50
The following example reverts to the default value of 10.

switch(config)# no qos dwrr-q high weight 50
Related Commands
Command show qos
18-5
Chapter 18 qos policy-map
Q Commands
qos policy-map
To specify the class of service, use the qos policy-map command in configuration mode. To remove a previously configured class, use the no form of the command. qos policy-map policy-name no qos policy-map policy-name
Syntax Description
policy-name
Specifies a policy map name. Maximum length is 63 alphanumeric characters.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 1.3(1)
Usage Guidelines
You can access this command only if you enable the QoS data traffic feature using the qos enable command. As an alternative, you can map a classmap to a Differentiated Services Code Point (DSCP).The DSCP is an indicator of the service level for a specified frame. The DSCP value ranges from 0 to 63. A dscp value of 46 is disallowed.
Examples
The following example creates a policy map called MyPolicy and places you in the policy-map submode.
switch(config)# qos policy-map MyPolicy switch(config-pmap)#
Related Commands
Command qos enable show qos
Description Enables the QoS data traffic feature on the switch. Displays configured QoS information.
18-6
Chapter 18
Q Commands qos priority
qos priority
To configure the quality of server (QoS) priority attribute in a zone attribute group, use the qos priority command in zone attribute configuration submode. To revert to the default, use the no form of the command. qos priority {high | low | medium} no qos priority {high | low | medium}
Syntax Description
high low medium
Specifies high priority. Specifies low priority. Specifies medium priority.
Defaults
Low.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to set the QoS priority attribute for a zone attribute group.
switch# config terminal switch(config)# zone-attribute-group name admin-attributes vsan 10 switch(config-attribute-group)# qos priority medium
Related Commands
Command show zone-attribute-group zone-attribute-group name
Description Displays zone attribute group information. Configures zone attribute groups.
18-7
Chapter 18 qos service
Q Commands
qos service
To apply a service policy, use the qos service command in configuration mode. To remove a previously-configured class, use the no form of the command. qos service policy policy-name vsan vsan-id no qos service policy policy-name vsan vsan-id
Syntax Description
policy policy-name vsan vsan-id
Associates a policy map with the VSAN. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Examples
The following example applies a configured policy to VSAN 3.

switch(config)# qos service policy MyPolicy vsan 3 Operation in progress. Please check policy-map parameters
The following example deletes a configured policy that was applied to VSAN 7.
switch(config)# no qos service policy OldPolicy vsan 7 Operation in progress. Please check policy-map parameters
Related Commands
Command show qos
18-8
Chapter 18
Q Commands quiesce
quiesce
To gracefully shut down an ISL in a PortChannel, use the quiesce command in configuration mode. To disable this feature, use the no form of the command. quiesce interface fc slot/port no queisce interface fc slot/port
Syntax Description
interface fc slot/port
Specifies the interface to be quiesced.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.3(1) 2.0(2b)
Modification This command was introduced. This command was deprecated and the functionality integrated into the shutdown command.
Usage Guidelines
The following conditions return an error:

The interface is not part of port-channel The interface is not up The interface is the last operational interface in the PortChannel
Examples
The following example gracefully shuts down the one end of the ISL link in a PortChannel.
switchA# quiesce interface fc 2/1 WARNING: this command will stop forwarding frames to the specified interfaces. It is intended to be used to gracefully shutdown interfaces in a port-channel. The procedure is: 1. quiesce the interfaces on both switches. 2. shutdown the interfaces administratively. Do you want to continue? (y/n) [n] y
Related Commands
Description Displays interface configuration and status information.
18-9
Chapter 18 quiesce
Q Commands
18-10
C H A P T E R
19
R Commands
19-1
Chapter 19 radius abort
R Commands
radius abort
To discard a RADIUS Cisco Fabric Services (CFS) distribution session in progress, use the radius abort command in configuration mode. radius abort
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to discard a RADIUS CFS distribution session in progress.
switch# config terminal switch(config)# radius abort
Related Commands
Command radius distribute show radius
Description Enables CFS distribution for RADIUS. Displays RADIUS CFS distribution status and other details.
19-2
Chapter 19
R Commands radius commit
radius commit
To apply the pending configuration pertaining to the RADIUS Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the radius commit command in configuration mode. radius commit
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to apply a RADIUS configuration to the switches in the fabric.
switch# config terminal switch(config)# radius commit
Related Commands
Command radius distribute show radius
Description Enables CFS distribution for RADIUS. Displays RADIUS CFS distribution status and other details.
19-3
Chapter 19 radius distribute
R Commands
radius distribute
To enable Cisco Fabric Services (CFS) distribution for RADIUS, use the radius distribute command. To disable this feature, use the no form of the command. radius distribute no radius distribute
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to enable RADIUS fabric distribution.

switch# config terminal switch(config)# radius distribute
Related Commands
Command radius commit show radius
Description Commits temporary RADIUS configuration changes to the active configuration. Displays RADIUS CFS distribution status and other details.
19-4
Chapter 19
R Commands radius-server host
radius-server host
To configure RADIUS server parameters, use the radius command. Use the no form of this command to revert to the factory defaults. radius-server host {server-name | ip-address} [key [0 | 7] shared-secret] [accounting] [acct-port port-number] [auth-port port-number] [authentication] [retransmit count] [timeout seconds [retransmit count]] no radius-server host {server-name | ip-address} [key [0 | 7] shared-secret] [accounting] [acct-port port-number] [auth-port port-number] [authentication] [retransmit count] [timeout seconds [retransmit count]]
Syntax Description
server-name ip-address acct-port port-number authentication accounting key 0
Specifies the RADIUS server DNS name. Maximum length is 256 characters. Specifies the RADIUS server IP address. Configures the RADIUS server port for accounting. Use for authentication. Use for accounting. RADIUS server shared key. Configures a preshared key specified in clear text (indicated by 0) to authenticate communication between the RADIUS client and server. This is the default. Configures a preshared key specified in encrypted text (indicated by 7) to authenticate communication between the RADIUS client and server. Configures a preshared key to authenticate communication between the RADIUS client and server. Configures the number of times the switch tries to connect to a RADIUS server(s) before reverting to local authentication. The range is 1 to five times and the default is 1 time. Specifies the time (in seconds) between retransmissions to the RADIUS server. The default is 1 second and the valid range is 1 to 60 seconds.
auth-port port-number Configures the RADIUS server port for authentication
7 shared-secret retransmit count
timeout seconds
Defaults
None.
Command Modes
Configuration mode.
Command History
19-5
Chapter 19 radius-server host
R Commands
Examples
The following example configures RADIUS server authentication parameters.

switch# config terminal switch(config)# radius-server switch(config)# radius-server switch(config)# radius-server switch(config)# radius-server switch(config)# radius-server switch(config)# radius-server host host host host host host 10.10.2.3 key HostKey 10.10.2.3 auth-port 2003 10.10.2.3 acct-port 2004 10.10.2.3 accounting radius2 key 0 abcd radius3 key 7 1234
Related Commands
Command show radius-server
Description Displays RADIUS server information.
19-6
Chapter 19
R Commands radius-server key
radius-server key
To configure a global RADIUS shared secret, use the radius-server key command. Use the no form of this command to removed a configured shared secret. radius-server key [0 | 7] shared-secret no radius-server key [0 | 7] shared-secret
Syntax Description
Configures a preshared key specified in clear text (indicated by 0) to authenticate communication between the RADIUS client and server. This is the default. Configures a preshared key specified in encrypted text (indicated by 7) to authenticate communication between the RADIUS client and server. Configures a preshared key to authenticate communication between the RADIUS client and server.
7 shared-secret
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
You need to configure the RADIUS preshared key to authenticate the switch to the RADIUS server. The length of the key is restricted to 65 characters and can include any printable ASCII characters (white spaces are not allowed). You can configure a global key to be used for all RADIUS server configurations on the switch. You can override this global key assignment by explicitly using the key option in the radius-server host command.
Examples
The following examples provide various scenarios to configure RADIUS authentication.

switch# config terminal switch(config)# radius-server key AnyWord switch(config)# radius-server key 0 AnyWord switch(config)# radius-server key 7 public
Related Commands
19-7
Chapter 19 radius-server retransmit
R Commands
radius-server retransmit
To globally specify the number of times the switch should try a request with a RADIUS server, use the radius-server retransmit command. To revert to default value, use the no form of the command. radius-server retransmit count no radius-server retransmit count
Syntax Description
count
Configures the number of times the switch tries to connect to a RADIUS server(s) before reverting to local authentication. The range is 1 to 5 times.
Defaults
1 retransmission
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example configures the number of retransmissions to 3.

switch# config terminal switch(config)# radius-server retransmit 3
Related Commands
19-8
Chapter 19
R Commands radius-server timeout
radius-server timeout
To specify the time between retransmissions to the RADIUS servers, use the radius-server timeout command. You can revert the retransmission time to its default by issuing the no form of the command. radius-server timeout seconds no radius-server timeout seconds
Syntax Description
seconds
Specifies the time (in seconds) between retransmissions to the RADIUS server. The range is 1 to 60 seconds.
Defaults
1 second
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example configures the timeout value to 30 seconds.

switch# config terminal switch(config)# radius-server timeout 30
Related Commands
19-9
Chapter 19 reload
R Commands
reload
To reload the entire switch, an active supervisor module, a standby supervisor module, or a specific module, or to force a netboot on a given module, use the reload command in EXEC mode. reload [module module-number force-dnld]
Syntax Description
module module-number Reloads a specific module or active/standby supervisor module. force-dnld Reloads, initiates netboot, and forces the download of the latest module firmware version to a specific module.
Defaults
Reboots the entire switch.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Use the reload command to reboot the system, or to reboot a specific module, or to force a netboot on a specific module. The reload command used by itself, powers down all the modules and reboots the supervisor modules. The reload module module-number command is used if the given slot has a module or standby supervisor module. It then power-cycles that module. If the given slot has an active supervisor module, then it causes the currently active supervisor module to reboot and the standby supervisor module becomes active. The reload module module-number force-dnld command is similar to the previous command. This command forces netboot to be performed. If the slot contains a module, then the module netboots with the latest firmware and updates its corresponding flash with this image.
Examples
The following example uses reload to reboot the system.

switch# reload This command will reboot the system. (y/n)? y
The following example uses reload to initiate netboot on a specific module.

switch# reload module 8 force-dnld
The following example uses reload to reboot a specific module.

switch# reload module 8 reloading module 8 ...
The following example uses reload to reboot an active supervisor module.

switch# reload module 5 This command will cause supervisor switchover. (y/n)? y
19-10
Chapter 19
R Commands reload
Related Commands Command install Description Installs a new software image.
copy system:running-config nvram:startup-config Copies any file from a source to a destination.
19-11
Chapter 19 read command-id
R Commands
read command-id
To configure a SCSI read command for a SAN tuner extension N port, use the read command-id command. read command-id cmd-id target pwwn transfer-size bytes [outstanding-ios value [continuous | num-transactions number]]
Syntax Description
cmd-id target pwwn transfer-size bytes outstanding-ios value continuous
Specifies the command identifier. The range is 0 to 2147483647. Specifies the target port WWN. The format is hh:hh:hh:hh:hh:hh:hh:hh. Specifies the transfer size in multiples of 512 bytes. The range is 512 to 8388608. Specifies the number of outstanding I/Os. The range is 1 to 1024. Specifies that the command is performed continuously.
num-transactions number Specifies a number of transactions. The range is 1 to 2147483647.
Defaults
None.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
To stop a SCSI read command in progress, use the stop command.
Examples
The following example configures a continuous SCSI read command.

switch# san-ext-tuner switch(san-ext)# nWWN 10:00:00:00:00:00:00:00 switch(san-ext)# nport pwwn 12:00:00:00:00:00:00:56 vsan 13 interface gigabitethernet 1/2 switch(san-ext-nport)# read command-id 100 target 22:22:22:22:22:22:22:22 transfer-size 512000 outstanding-ios 2 continuous
Related Commands
Command nport pwwn san-ext-tuner show san-ext-tuner stop
Description Configures a SAN extension tuner N port. Enables the SAN extension tuner feature. Displays SAN extension tuner information. Cancels a SCSI command in progress on a SAN extension tuner N port.
19-12
Chapter 19
R Commands read-only
read-only
To configure the read-only attribute in a zone attribute group, use the read-only command in zone attribute configuration submode. To revert to the default, use the no form of the command. read-only no read-only
Syntax Description
Defaults
Read-write.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
This command only configures the read-only attribute for enhanced zoning. To enable broadcast zoning for basic mode, use the attribute read-only subcommand after entering zone configuration mode using the zone name command.
Examples
The following example shows how to set the read-only attribute for a zone attribute group.
switch# config terminal switch(config)# zone-attribute-group name admin-attributes vsan 10 switch(config-attribute-group)# read-only
Related Commands
Command show zone-attribute-group zone mode enhanced vsan zone name zone-attribute-group name
Description Displays zone attribute group information. Enables enhanced zoning for a VSAN. Configures zone attributes. Configures zone attribute groups.
19-13
Chapter 19 rmdir
R Commands
rmdir
To delete an existing directory from the Flash file system, use the rmdir command in EXEC mode. rmdir [bootflash: | slot0: | volatile:]directory
Syntax Description
bootflash: slot0: volatile: directory
Source or destination location for internal bootflash memory. Source or destination location for the CompactFlash memory or PCMCIA card. Source or destination location for volatile file system. Name of the directory to remove.
Defaults
Uses the current default directory.
Command Modes
EXEC
Command History
Usage Guidelines
This command is only valid on Flash file systems. The rmdir command deletes an existing directory at the current directory level or at a specified directory level. The directory must be empty to be deleted.
Examples
The following example deletes the directory called test in the slot0 directory.
switch# rmdir slot0:test
The following example deletes the directory called test at the current directory level. If the current directory is slot0:mydir, this command deletes the slot0:mydir/test directory.
switch# rmdir test
Related Commands
Command dir mkir
Description Displays a list of files on a file system. Creates a new directory in the Flash file system.
19-14
Chapter 19
R Commands rmon alarm
rmon alarm
To configure a remote monitoring (RMON) alarm, use the rmon alarm command in configuration mode. To delete an RMON alarm, use the no form of the command. rmon alarm alarm-number mib-object sample-interval {absolute | delta} rising-threshold value [rising-event] falling-threshold value [falling-event] [owner alarm-owner] no rmon alarm alarm-number
Syntax Description
alarm-number mib-object
Specifies the RMON alarm number. The range is 1 to 65535. Specifies the MIB object to monitor. Maximum length is 80 characters.
Note
The MIB object identifier must be fully numbered, dotted-decimal notation, not the text string description.
sample-interval absolute delta rising-threshold value rising-event
Specifies the sample interval in seconds. The range is 1 to 2147483647. Tests each sample directly. Tests the delta (or difference) between samples. Specifies the rising threshold value. The range is 2147483648 to 2147483647. Specifies the event to trigger on rising threshold crossing. The range is 1 to 65535.
falling-threshold value Specifies the falling threshold value. The range is 2147483648 to 2147483647. failing-event owner alarm-owner Specifies the event to trigger on rising threshold crossing. The range is 1 to 65535. Specifies an owner for the alarm. Maximum size is 80 characters.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
The events that can be triggered are configured using the rmon event command.
19-15
Chapter 19 rmon alarm
R Commands
Examples The following example configures an RMON alarm.
switch# config terminal switch(config)# rmon alarm 20 1.3.6.1.2.1.2.2.1.14.16777216 900 delta rising-threshold 15 1 falling-threshold 0 owner test
Related Commands
Command rmon event show rmon
Description Configures an RMON event. Displays RMON configuration information.
19-16
Chapter 19
R Commands rmon event
rmon event
To configure a remote monitoring (RMON) event, use the rmon event command in configuration mode. To delete an RMON event, use the no form of the command. rmon event event-number [description text [owner owner-name] | log [trap trap-name] [description text] [owner owner-name] | owner owner-name | trap community-string [description text] [owner owner-name]] no rmon event event-number
Syntax Description
event-number description text owner owner-name log trap community-string
Specifies the RMON event number. The range is 1 to 65535. Specifies a description of the event. Maximum length is 80 characters. Specifies an owner for the alarm. Maximum length is 80 characters Generates an RMON log entry when the event is triggered by an alarm. Generates an SNMP notification when event is triggered by an alarm. Maximum length is 32 characters.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
The events created by this command can be triggered by alarms configured using the rmon alarm command.
Examples
The following example configures an RMON event.

switch# config terminal switch(config)# rmon event 2 log trap eventtrap description CriticalErrors owner Test2
Related Commands
Command rmon alarm show rmon
Description Configures an RMON alarm. Displays RMON configuration information.
19-17
Chapter 19 role abort
R Commands
role abort
To discard an authorization role Cisco Fabric Services (CFS) distribution session in progress, use the role abort command in configuration mode. role abort
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to discard an authorization role CFS distribution session in progress.
switch# config terminal switch(config)# role abort
Related Commands
Command role distribute show role
Description Enables CFS distribution for authorization roles. Displays authorization role information.
19-18
Chapter 19
R Commands role commit
role commit
To apply the pending configuration pertaining to the authorization role Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the role commit command in configuration mode. role commit
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to apply an authorization role configuration to the switches in the fabric.
switch# config terminal switch(config)# role commit
Related Commands
Command role distribute show role
Description Enables CFS distribution for authorization roles. Displays authorization roles information.
19-19
Chapter 19 role distribute
R Commands
role distribute
To enable Cisco Fabric Services (CFS) distribution for authorization roles, use the role distribute command. To disable this feature, use the no form of the command. role distribute no role distribute
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to enable fabric distribution for authorization roles.
switch# config terminal switch(config)# role distribute
Related Commands
Command role commit show role
Description Commits temporary to the authorization role configuration changes to the active configuration. Displays authorization role information.
19-20
Chapter 19
R Commands role name
role name
To configure and assign users to a new role or to modify the profile for an existing role, use the role name command in configuration mode. Use the no form of this command to delete a configured role. role name name [description user description] [rule number permit clear feature name |permit config feature name | permit debug feature name | permit show feature name] [rule number deny clear feature name | deny config feature name | deny debug feature name | deny exec feature name | deny show feature name] no role name name [description user description] [rule number permit clear feature name | permit config feature name | permit debug feature name | permit show feature name] [rule number deny clear feature name | deny config feature name | deny debug feature name | deny exec feature name | deny show feature name]
Syntax Description
name description user description exit no rule number permit deny clear config debug show feature exec name
Adds RADIUS server. The maximum size is 32. Add a description for the role. The maximum size is 80. Add description of users to the role. Exit from this submode Negate a command or set its defaults Enter the rule keyword. Enter the rule number 1-16. Add commands to the role. Remove commands from the role. Clear commands Configuration commands Debug commands Show commands Enter the feature name Exec commands Enter the feature name (Max Size - 32)
Defaults
None.
Command Modes
Configuration mode.
Command History
19-21
Chapter 19 role name
R Commands
Usage Guidelines Roles are assigned rules. Roles are a group of rules defining a users access to certain commands. Users are assigned roles. The rules within roles can be assigned to permit or deny access to the following commands: clear Clear commands config Configuration commands debug Debug commands exec EXEC commands show Show commands These commands can have permit or deny options within that command line.
Examples
The following example shows how to assign users to a new role.

switch# config terminal switch(config)# role name techdocs switch(config-role)# switch(config)# no role name techdocs switch(config)# switch(config-role)# description Entire Tech. Docs. group switch(config-role)# no description switch# config terminal switch(config)# role name sangroup switch(config-role)# switch(config-role)# rule 1 permit config switch(config-role)# rule 2 deny config feature fspf switch(config-role)# rule 3 permit debug feature zone switch(config-role)# rule 4 permit exec feature fcping switch(config-role)# no rule 4 Role: network-operator Description: Predefined Network Operator group. This role cannot be modified Access to Show commands and selected Exec commands
Related Commands
Command show role
Description Displays all roles configured on the switch including the rules based on each role.
19-22
Chapter 19
R Commands rscn
rscn
To configure a registered state change notification (RSCN), a Fibre Channel service that informs Nx ports about changes in the fabric, use the rscn command in configuration mode. rscn {multi-pid | suppress domain-swrscn} vsan vsan-id
Syntax Description
multi-pid vsan vsan-id
Sends RSCNs in multi-PID format. Configures VSAN information or membership. The ID of the VSAN is from 1 to 4093.
suppress domain-swrscn Suppresses transmission of domain format SW-RCSNs.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example configures RSCNs in multi-PID format.

switch# config terminal excal-113(config)# rscn multi-pid vsan 1
Related Commands
Command show rscn src-table show rscn statistics
Description Displays state change registration table, Displays RSCN statistics.
19-23
Chapter 19 run-script
R Commands
run-script
To execute the commands specified in a file, use the run-script command. run-script [bootflash: | slot0: | volatile:]filename
Syntax Description
Source or destination location for internal bootflash memory. Source or destination location for the CompactFlash memory or PCMCIA card. Source or destination location for volatile file system. Name of the file containing the commands.
Defaults
Uses the current default directory.
Command Modes
EXEC mode.
Command History
Usage Guidelines
To use this command, be sure to create the file and specify commands in the required order.
Examples
The following example executes the CLI commands specified in the testfile that resides in the slot0 directory.
switch# show file slot0:testfile conf t interface fc 1/1 no shutdown end sh interface fc1/1
In response to the run-script command, this is the file output:

switch# run-script slot0:testfile 'conf t' Enter configuration commands, one per line. End with CNTL/Z. 'interface fc 1/1' 'no shutdown' 'end' 'sh interface fc1/1' fc1/1 is down (Fcot not present) Hardware is Fibre Channel Port WWN is 20:01:00:05:30:00:48:9e Admin port mode is auto, trunk mode is on vsan is 1
19-24
Chapter 19
R Commands run-script
Beacon is turned off Counter Values (current): 0 frames input, 0 bytes, 0 discards 0 runts, 0 jabber, 0 too long, 0 too short 0 input errors, 0 CRC, 0 invalid transmission words 0 address id, 0 delimiter 0 EOF abort, 0 fragmented, 0 unknown class 0 frames output, 0 bytes, 0 discards Received 0 OLS, 0 LRR, 0 NOS, 0 loop inits Transmitted 0 OLS, 0 LRR, 0 NOS, 0 loop inits Counter Values (5 minute averages): 0 frames input, 0 bytes, 0 discards 0 runts, 0 jabber, 0 too long, 0 too short 0 input errors, 0 CRC, 0 invalid transmission words 0 address id, 0 delimiter 0 EOF abort, 0 fragmented, 0 unknown class 0 frames output, 0 bytes, 0 discards Received 0 OLS, 0 LRR, 0 NOS, 0 loop inits Transmitted 0 OLS, 0 LRR, 0 NOS, 0 loop inits
19-25
Chapter 19 rspan-tunnel
R Commands
rspan-tunnel
To associate and bind the SPAN tunnel (ST) port with the RSPAN tunnel, use the rspan-tunnel command. rspan-tunnel interface fc-tunnel tunnel-id rspan-tunnel
Syntax Description
rspan-tunnel interface fc-tunnel tunnel-id
Configures the remote SPAN (RSPAN) tunnel. Specifies the interface to configure this tunnel. Specifies the FC tunnel interface. The range is 1 to 255.
Defaults
None.
Command Modes
Command History
Usage Guidelines
The interface is not operationally up until the Fibre Channel tunnel mapping is configured in the source and destination switches.
Examples
The following example configures an interface to associate and bind the ST port with the RSPAN tunnel and enables traffic flow trough this interface..
switchS# config t switchS(config)# interface fc2/1 switchS(config-if)# rspan-tunnel interface fc-tunnel 100 switchS(config-if)# no shutdown
19-26
C H A P T E R
20
S Commands
20-1
Chapter 20 santap module
S Commands
santap module
To configure the mapping between the Storage Services Module (SSM) and the VSAN where the appliance is configured, use the santap module command in configuration mode. To disable this feature, use the no form of the command. santap module slot-number appl-vsan vsan-id no santap module slot-number appl-vsan vsan-id
Syntax Description
slot-number appl-vsan vsan-id
Specifies the slot number of the SSM where the control virtual target (CVT) is created. Specifies the appliance VSAN identification number used to communicate with the appliance. The range is 1 to 4093.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.1(1a)
Usage Guidelines
To access this command you must first enable the SANTap feature on the SSM using the ssm enable feature command.
Examples
The following example shows the configuration of the SSM where the SANTap feature is enabled and the VSAN used to communicate with the appliance.
switch# config terminal Enter configuration commands, one per line. switch(config)# santap module 1 appl-vsan 1 End with CNTL/Z.
Related Commands
Command ssm enable feature show santap module
Description Enables the SANTap feature on the SSM. Displays the configuration and statistics of the SANTap feature.
20-2
Chapter 20
S Commands scsi-flow distribute
scsi-flow distribute
To enable SCSI flow distribution through CFS, use the scsi-flow distribute command. To disable the SCSI flow distribution, use the no form of the command. scsi-flow distribute no scsi-flow distribute
Syntax Description
Defaults
Distribution is enabled by default.
Command Modes
Configuration mode.
Command History
Release 2.0(2)
Usage Guidelines
You must enable the SCSI flow feature on the Advanced Services Module (ASM) or the Storage Services Module (SSM) before you can configure a SCSI flow. Use the ssm enable feature module slot-number command to enable the SCSI flow feature on the SSM.
Examples
The following example enables distribution of SCSI flow services using CFS.
switch# config terminal Enter configuration commands, one per line. switch(config)# scsi-flow distribute End with CNTL/Z.
The following example disables distribution of SCSI flow services.

switch(config)# no scsi-flow distribute
Related Commands
Command ssm enable feature show scsi-flow
Description Enables the SCSI flow feature on the SSM. Displays SCSI flow configuration and status.
20-3
Chapter 20 scsi-flow flow-id
S Commands
scsi-flow flow-id
To configure SCSI flow services, use the scsi-flow flow-id command. To disable the SCSI flow services, use the no form of the command. scsi-flow flow-id flow-id {initiator-vsan vsan-id initiator-pwwn wwn target-vsan vsan-id target-pwwn wwn | statistics | write-acceleration [buffers count]} no scsi-flow flow-id flow-id [statistics | write-acceleration]
Syntax Description
flow-id initiator-vsan vsan-id initiator-pwwn wwn target-vsan vsan-id target-pwwn wwn write-acceleration statistics buffers count
Configures the SCSI flow identification number. The range is 1 to 65535. Specifies the initiator VSAN identification number. The range is 1 to 4093. Configures initiator side PWWN. Configures target VSAN identification number of the SCSI flow. Configures the target side PWWN. Enables write acceleration. Enables statistics gathering. Configures the write acceleration buffer count. The range is 1 to 40000 and the default is 1024.
Defaults
Disabled
Command Modes
Configuration mode.
Command History
Release 2.0(2)
Usage Guidelines
You must enable the SCSI flow feature on the Advanced Services Module (ASM) or the Storage Services Module (SSM) before you can configure a SCSI flow. Use the ssm enable feature module slot-number command to enable the SCSI flow feature on the SSM.
20-4
Chapter 20
S Commands scsi-flow flow-id
Examples The following example configures a SCSI flow with a flow identifier of 4 and the following attributes:

Initiator VSAN number101 Initiator port WWN21:00:00:e0:8b:05:76:28 Target VSAN number101 Target portWWN 21:00:00:20:37:38:67:cf
switch# config terminal switch(config)# scsi-flow flow-id 4 initiator-vsan 101 initiator-pwwn 21:00:00:e0:8b:05:76:28 target-vsan 101 target-pwwn 21:00:00:20:37:38:67:cf
The following example disables a SCSI flow with a flow identifier of 4.

switch(config)# no scsi-flow flow-id 4
The following example configures SCSI flow 4 to gather statistics about the SCSI flow.
switch(conf)# scsi-flow flow-id 4 statistics
The following example disables the statistics gathering feature on SCSI flow 4.
switch(conf)# no scsi-flow flow-id 4 statistics
The following example configures SCSI flow 4 with write acceleration.

switch(conf)# scsi-flow flow-id 4 write-acceleration
The following example configures SCSI flow 4 with write acceleration and buffers of 1024 credits.
switch(conf)# scsi-flow flow-id 4 write-acceleration buffer 1024
The following example disables the write acceleration feature on SCSI flow 4.
switch(conf)# no scsi-flow flow-id 4 write-acceleration
Related Commands
Command ssm enable feature show scsi-flow
Description Enables the SCSI flow feature on the SSM. Displays SCSI flow configuration and status.
20-5
Chapter 20 send
S Commands
send
To send a message to all active CLI users currently using the switch, use the send command in EXEC mode. send message-text
Syntax Description
message-text
The text of your message.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
This message is restricted to 80 alphanumeric characters with spaces.
Examples
The following example sends a warning message to all active users about the switch being shut down.
switch# send Shutting down the system in 2 minutes. Please log off. Broadcast Message from admin@excal-112 (/dev/pts/3) at 16:50 ... Shutting down the system in 2 minutes. Please log off.
20-6
Chapter 20
S Commands server
server
To add a server in an Internet Storage Name Service (iSNS) profile, use the server command in iSNS profile configuration submode. To delete a server from an iSNS profile, use the no form of the command. server server-id no server server-id
Syntax Description
server-id
Specifies the server address. The format is A.B.C.D.
Defaults
None.
Command Modes
iSNS profile configuration submode.
Command History
Release 1.3(1)
Usage Guidelines
An iSNS profile can have only one server address. To change the server address, you must delete the current server and add the new one.
Examples
The following example shows how to add a server address to an iSNS profile.
switch# config terminal switch(config)# isns profile name UserProfile switch(config-isns-profile)# server 10.1.1.1
The following example shows how to delete a server address from an iSNS profile.
switch# config terminal switch(config)# isns profile name AdminProfile switch(config-isns-profile)# no server 10.2.2.2
Related Commands
Command isns-server enable isns profile name show isns
Description Enables the iSNS server. Creates iSNS profiles. Displays iSNS information.
20-7
Chapter 20 set (IPsec crypto map configuration submode)
S Commands
set (IPsec crypto map configuration submode)

To configure attributes for IPsec crypto map entries, use the set command in IPsec crytpo map configuration submode. To revert to the default values, use the no form of the command. set {peer {ip-address | auto-peer} | pfs [group1 | group14 | group2 | group5] | security-association lifetime {gigabytes number | kilobytes number | megabytes number | seconds number} | transform-set {set-name | set-name-list}} no set {peer {ip-address | auto-peer} | pfs | security-association lifetime {gigabytes | kilobytes | megabytes | seconds} | transform-set}
Syntax Description
peer ip-address auto-peer pfs group1 group14 group2 group5 security-association lifetime gigabytes number kilobytes number megabytes number seconds number transform-set set-name set-name-list
Specifies an allowed encryption/decryption peer. Specifies a static IP address for the destination peer. Specifies automatic assignment of the address for the destination peer. Specifies the perfect forwarding secrecy. Specifies PFS DH Group1 (768-bit MODP). Specifies PFS DH Group14 (2048-bit MODP). Specifies PFS DH Group2 (1024-bit MODP). Specifies PFS DH Group5 (1536-bit MODP). Specifies the security association lifetime in traffic volume or time in seconds. Specifies a volume-based key duration in gigabytes. The range is 1 to 4095. Specifies a volume-based key duration in kilobytes. The range is 2560 to 2147483647. Specifies a volume-based key duration in megabytes. The range is 3 to 4193280. Specifies a time-based key duration in seconds. The range is 120 to 86400. Configures the transform set name or set name list. Specifies a transform set name. Maximum length is 63 characters. Specifies a comma-separated transform set name list. Maximum length of each name is 63 characters. You can specified a maximum of six lists.
Defaults
None. PFS is disabled by default. When it is enabled without a group parameter, the default is group1. The security association lifetime defaults to global setting configured by the crypto global domain ipsec security-association lifetime command.
Command Modes
IPsec crypto map configuration submode.
20-8
Chapter 20
S Commands set (IPsec crypto map configuration submode)
Command History Release 2.0(1b) Modification This command was introduced.
Usage Guidelines
Examples
The following example shows how to configure IPsec crypto map attributes.
switch# config terminal switch(config)# crypto map domain ipsec x 1 switch(config-crypto-map-ip)# set peer auto-peer
Related Commands
Command crypto global domain ipsec security-association lifetime crypto ipsec enable
Description Configures the global security association lifetime value. Enables IPsec.
20-9
Chapter 20 setup
S Commands
setup
To enter the switch setup mode, use the setup command in EXEC mode. setup
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Refer to the Cisco MDS 9000 Family Configuration Guide for more information on using the setup command. The setup utility guides you through the basic configuration process. Type Ctrl-c at any prompt to skip the remaining configuration options and proceed with what is configured until that point. If you do not wish to answer a previously-configured question, or if you wish to skip answers to any questions press Enter. If a default answer is not available (for example switch name), the switch uses what is previously configured and skips to the next question.
Examples
The following example shows how to enter switch setup mode.

switch# setup ---- Basic System Configuration Dialog ---This setup utility will guide you through the basic configuration of the system. Setup configures only enough connectivity for management of the system. *Note: setup always assumes a predefined defaults irrespective of the current system configuration when invoked from CLI. Press Enter incase you want to skip any dialog. Use ctrl-c at anytime to skip away remaining dialogs. Would you like to enter the basic configuration dialog (yes/no): yes
20-10
Chapter 20
S Commands setup ficon
setup ficon
To enter the automated FICON setup mode, use the setup ficon command in EXEC mode. setup ficon
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.3(1)
Usage Guidelines
Refer to the Cisco MDS 9000 Family Configuration Guide for more information on using the setup ficon command. The setup utility guides you through the basic configuration process. Type Ctrl-c at any prompt to skip the remaining configuration options and proceed with what is configured until that point. If you do not wish to answer a previously-configured question, or if you wish to skip answers to any questions press Enter. If a default answer is not available (for example switch name), the switch uses what is previously configured and skips to the next question.
Examples
The following example shows how to enter switch setup mode.

switch# setup ficon ---- Basic System Configuration Dialog ------ Ficon Configuration Dialog --This setup utility will guide you through basic Ficon Configuration on the system. Press Enter if you want to skip any dialog. Use ctrl-c at anytime to skip all remaining dialogs. Would you like to enter the basic configuration dialog (yes/no): yes
20-11
Chapter 20 shutdown
S Commands
shutdown
To disable an interface, use the shutdown command. To enable an interface, use the no form of the command. shutdown [force] no shutdown [force]
Syntax Description
force
Forces the shutdown of the mgmt 0 interface to avoid the confirmation.
Defaults
None.
Command Modes
Command History
Release 1.0(1)
Usage Guidelines
The default state for interfaces is shutdown. Use the no shutdown command to enable an interface to carry traffic. When you try to shutdown a management interface(mgmt0), a follow-up message confirms your action before performing the operation. Use the force option to bypass this confirmation, if required.
Examples
The following example shows how to enable an interface.

switch# config terminal switch(config)# interface fc 1/2 switch(config-if)# no shutdown
The following example shows how to disable an interface.

switch# config terminal switch(config)# interface mgmt 0 switch(config-if)# shutdown
The following example shows how to forcefully disable the mgmt 0 interface.
switch# config terminal switch(config)# interface mgmt 0 switch(config-if)# shutdown force
20-12
Chapter 20
S Commands shutdown
Related Commands Command interface show interface Description Specifies an interface and enters interface configuration submode. Displays interface information.
20-13
Chapter 20 site-id
S Commands
site-id
To configure the site ID with the Call Home function, use the site-id command in Call Home configuration submode. To disable this feature, use the no form of the command. site-id site-number no site-id site-number
Syntax Description
site-number
(Optional) Identifies the unit to the outsourced throughput. Allows up to 256 alphanumeric characters in free format.
Defaults
None.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to configure the site ID in the Call Home configuration.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# callhome switch(config-callhome)# site-id Site1ManhattanNY
Related Commands
20-14
Chapter 20
S Commands sleep
sleep
To delay an action by a specified number of seconds, use the sleep command. sleep seconds
Syntax Description
seconds
The number of seconds to delay an action.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
This command is useful within scripts. For example, if you create a script called test-script:
switch# show file slot0:test-script discover scsi-target remote sleep 10 show scsi-target disk switch# run-script slot0:test-script
When you execute the slot0:test-script, the switch software executes the discover scsi-target remote command, and then waits for 10 seconds before executing the show scsi-target disk command.
Examples
The following example shows how to delay the switch prompt return.
switch# sleep 30
You will see the switch prompt return after 30 seconds.
20-15
Chapter 20 snmp port
S Commands
snmp port
Use the snmp port command to enable SNMP control of FICON configurations. To disable the configuration or to revert to factory defaults, use the no form of the command. snmp port control no snmp port control
Syntax Description
Defaults
Enabled.
Command Modes
Command History
Release 1.3(1)
Usage Guidelines
By default, SNMP users can configure FICON parameters through the Fabric Manager application. You can prohibit this access, if required, by issuing the no snmp port control command.
Examples
The following example prohibits SNMP users from configuring FICON parameters.
switch(config)# ficon vsan 2 switch(config-ficon)# no snmp port control
The following example allows SNMP users to configure FICON parameters (default).
switch(config-ficon)# snmp port control
Related Commands
20-16
Chapter 20
S Commands snmp-server
snmp-server
To configure the SNMP server information, switch location, and switch name, use the snmp-server command in configuration mode. To remove the system contact information, use the no form of the command. snmp-server {community string [group group-name | ro | rw] | contact [name] | location [location]} no snmp-server {community string [group group-name | ro | rw] | contact [name] | location [location]}
Syntax Description
community string group group-name ro rw contact name location location
Specifies SNMP community string. Maximum length is 32 characters. Specifies group name to which the community belongs. Maximum length is 32 characters. Sets read-only access with this community string. Sets read-write access with this community string. Configures system contact. Specifies the name of the contact. Maximum length is 80 characters. Configures system location. Specifies system location. Maximum length is 80 characters.
Defaults
The default community access is read-only (ro).
Command Modes
Configuration mode
Command History
Release 1.0(3) 2.0(1b)
Modification This command was introduced. Added group option.
Usage Guidelines
None.
Examples
The following example sets the contact information, switch location, and switch name.
switch# config terminal switch(config)# snmp-server contact NewUser switch(config)# no snmp-server contact NewUser switch(config)# snmp-server location SanJose switch(config)# no snmp-server location SanJose switch(config)# snmp-server name NewName switch(config)# no snmp-server name NewName switch(config)# no snmp-server user usernameA
20-17
Chapter 20 snmp-server
S Commands
Related Commands Command show snmp Description Displays SNMP information.
20-18
Chapter 20
S Commands snmp-server enable traps
snmp-server enable traps

To enable SNMP server notifications (informs and traps), use the snmp-server enable traps command in configuration mode. To disable the SNMP server notifications, use the no form of the command. snmp-server enable traps [entity [fru] | fcc | fcdomain | fcns | fdmi | fspf | license | port-security | rscn [els | ils] | snmp [authentication] | vrrp | zone [default-zone-behavior-change | merge-failure | merge-success | request-reject] no snmp-server enable traps [entity [fru] | fcc | fcdomain | fcns | fdmi | fspf | license | port-security | rscn [els | ils] | snmp [authentication] | vrrp | zone [default-zone-behavior-change | merge-failure | merge-success | request-reject]
Syntax Description
entity fru fcc fcdomain fcns fdmi fspf license port-security rscn els ils snmp authentication vrrp zone merge-failure merge-success request-reject
Enables all SNMP entity notifications. Enables only SNMP entity FRU notifications. Enables SNMP Fibre Channel congestion control notifications. Enables SNMP Fibre Channel domain notifications. Enables SNMP Fibre Channel name server notifications. Enables SNMP Fabric Device Management Interface notifications. Enables SNMP Fabric Shortest Path First notifications. Enables SNMP license manager notifications. Enables SNMP port security notifications. Enables all SNMP Registered State Change Notification notifications. Enables only SNMP RSCN ELS notifications. Enables only SNMP RSCN ILS notifications. Enables all SNMP agent notifications. Enables only SNMP agent authentication notifications. Enables SNMP Virtual Router Redundancy Protocol notifications Enables all SNMP zone notifications. Enables only SNMP zone merge failure notifications. Enables only SNMP zone merge success notifications. Enables only SNMP zone request reject notifications.
default-zone-behavior-change Enables only SNMP zone default zone behavior change notifications.
Defaults
All the notifications listed in the Syntax Description table are disabled by default except for the following: entity fru, vrrp, license, and any notification not listed (including the generic notifications such as coldstart, warmstart, and linkupdown).
Command Modes
Configuration mode.
20-19
Chapter 20 snmp-server enable traps
S Commands
Command History Release 2.0(1b) Modification This command was introduced.
Usage Guidelines
If the snmp-server enable traps command is entered without keywords, all notifications (informs and traps) are enabled.
Examples
The following example enables all the SNMP notifications listed in the Syntax Description table.
switch# config terminal switch(config)# snmp-server traps
The following example enables all SNMP entity notifications.

switch# config terminal switch(config)# snmp-server traps entity
Related Commands
Command show snmp snmp-server host
Description Displays SNMP information. Configures SNMP server host information.
20-20
Chapter 20
S Commands snmp-server host
snmp-server host
To specify the recipient of an Simple Network Management Protocol notification operation, use the snmp-server host global configuration command. To remove the specified host, use the no form of the command.
snmp-server host host-address [traps | informs] [version {1 | 2c | 3 [auth | noauth | priv]}] community-string [udp-port port] [notification-type] no snmp-server host host-address [traps | informs] [version {1 | 2c | 3 [auth | noauth | priv]}] community-string [udp-port port] [notification-type]
Syntax Description
host-address traps informs version
Specifies the name or IP address of the host (the targeted recipient). Sends SNMP traps to this host. Sends SNMP informs to this host. Specifies the version of the Simple Network Management Protocol (SNMP) used to send the traps. Version 3 is the most secure model, as it allows packet encryption with the priv keyword. SNMPv1 (default). This option is not available with informs. SNMPv2C. SNMPv3 has three optional keywords (auth, no auth (default), or priv). Enables Message Digest 5 (MD5) and Secure Hash Algorithm (SHA) packet authentication Specifies the noAuthNoPriv security level. Enables Data Encryption Standard (DES) packet encryption (privacy). Sends a password-like community string with the notification operation. Specifies the port UDP port of the host to use. The default is 162.
1 2c 3 auth noauth priv community-string udp-port
Defaults
Sends SNMP traps.
Command Modes
Configuration mode
Command History
Usage Guidelines
If you use the version keyword, one of the following must be specified: 1, 2c, or 3.
Examples
The following example specify the recipient of an SNMP notification.

switch# config terminal switch(config)# snmp-server host 10.1.1.1 traps version 2c abcddsfsf udp-port 500
20-21
Chapter 20 snmp-server user
S Commands
snmp-server user
To configure SNMP user information, use the snmp-server user command in configuration mode. To disable the configuration or to revert to factory defaults, use the no form of the command. snmp-server user username [group-name] [auth {md5 | sha} password [priv [password [auto | localizedkey [auto]]] | aes-128 password [auto | localizedkey [auto] | auto | localizedkey [auto]]] no snmp-server user name [group-name | auth {md5 | sha} password [priv [password [auto | localizedkey [auto]]] | aes-128 password [auto | localizedkey [auto] | auto | localizedkey [auto]]]
Syntax Description
username group-name auth md5 sha password priv aes-128 auto localizedkey
Specifies the user name. Maximum length is 32 characters. Specifies role group to which the user belongs. Maximum length is 32 characters. Sets authentication parameters for the user. Sets HMAC MD5 algorithm for authentication. Uses HMAC SHA algorithm for authentication. Specifies user password. Maximum length is 64 characters. Sets encryption parameters for the user. Sets 128-byte AES algorithm for privacy. Specifies whether the user is autocreated (volatile). Sets passwords in localized key format.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2) 1.0(3) 2.0(1b)
Modification This command was introduced. Added the localizedkey option. Added the auto and aes128 options.
Usage Guidelines
The localized keys are not portable across devices as they contain information on the engine ID of the device. If a configuration file is copied into the device, the passwords may not be set correctly if the configuration file was generated at a different device. We recommend that passwords be explicitly configured to the desired passwords after copying the configuration into the device. SNMP Version 3 is the most secure model, as it allows packet encryption with the priv keyword. To assign multiple roles to a user, perform multiple snmp-server user username group-name commands. The group-name is defined by the role name command.
20-22
Chapter 20
S Commands snmp-server user
Examples The following example sets the user information.
switch# config terminal switch(config)# snmp-server user joe network-admin auth sha abcd1234 switch(config)# snmp-server user sam network-admin auth md5 abcdefgh switch(config)# snmp-server user Bill network-admin auth sha abcd1234 priv abcdefgh switch(config)# no snmp-server user usernameA switch(config)# snmp-server user user1 network-admin auth md5 0xab0211gh priv 0x45abf342 localizedkey
Related Commands
Command role name show snmp snmp-server host
Description Configures role profiles. Displays SNMP information. Configures SNMP server host information.
20-23
Chapter 20 source
S Commands
source
To configure a switched port analyzer (SPAN) source, use the source command in SPAN session configuration submode. To disable this feature, use the no form of the command. source { filter vsan vsan-id | interface { fc slot/port [rx [traffic-type {initiator | mgmt | target}] | tx [traffic-type {initiator | mgmt | target}] | traffic-type {initiator | mgmt | target}] | fcip fcip-id | fv slot/dpp-number/fv-port | iscsi slot/port [rx [traffic-type {initiator | mgmt | target}] | tx [traffic-type {initiator | mgmt | target}] | traffic-type {initiator | mgmt | target}]| port-channel channel-number [rx [traffic-type {initiator | mgmt | target}] | tx [traffic-type {initiator | mgmt | target}] | traffic-type {initiator | mgmt | target}] | sup-fc number [rx [traffic-type {initiator | mgmt | target}] | tx [traffic-type {initiator | mgmt | target}] | traffic-type {initiator | mgmt | target}]} | vsan vsan-id} no source { filter vsan vsan-id | interface { fc slot/port [rx [traffic-type {initiator | mgmt | target}] | tx [traffic-type {initiator | mgmt | target}] | traffic-type {initiator | mgmt | target}] | fcip fcip-id | fv slot/dpp-number/fv-port | iscsi slot/port [rx [traffic-type {initiator | mgmt | target}] | tx [traffic-type {initiator | mgmt | target}] | traffic-type {initiator | mgmt | target}]| port-channel channel-number [rx [traffic-type {initiator | mgmt | target}] | tx [traffic-type {initiator | mgmt | target}] | traffic-type {initiator | mgmt | target}] | sup-fc number [rx [traffic-type {initiator | mgmt | target}] | tx [traffic-type {initiator | mgmt | target}] | traffic-type {initiator | mgmt | target}]} | vsan vsan-id}
Syntax Description
filter vsan vsan-id interface fc slot/port fcip fcip-id
Configures SPAN session filter. Specifies the VSAN ID. The range is 1 to 4093. Specifies the interface type. Specifies the Fibre Channel interface ID at a slot and port. Specifies the FCIP interface ID. The range is 1 to 255.
fv Specifies a virtual F port (FV port) interface in the specified slot along with slot/dpp-number/fv-port the data path processor (DPP) number and the FV port number. iscsi slot/port port-channel channel-number sup-fc number rx traffic-type Configures the iSCSI interface in the specified slot/port. Specifies the PortChannel interface ID. The range is 1 to 128. Specifies the inband interface, which is 0. Specifies SPAN traffic in ingress direction. Configures the SPAN traffic type.
20-24
Chapter 20
S Commands source
initiator mgmt target tx Specifies initiator traffic. Specifies management traffic. Specifies target traffic. Specifies SPAN traffic in egress direction.
Defaults
Disabled.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to create a SPAN session, then configures the SPAN traffic at all sources in VSAN 1.
switch# config terminal Enter configuration commands, one per line. switch(config)# span session 1 switch(config-span)# source vsan 1 End with CNTL/Z.
The following example shows how to configure the SPAN source interface as PortChannel 1.
switch(config-span)# source interface port-channel 1
The following example shows how to configure the SPAN source interface as FC 9/1 with an egress filter for VSAN 1.
switch(config-span)# source interface fc9/1 tx filter vsan 1
The following example shows how to configure the SPAN source interface as FCIP 51.
switch(config-span)# source interface fcip 51
The following example shows how to configure the SPAN source interface as iSCSI interface 4/1.
switch(config-span)# source interface iscsi 4/1
The following example shows how to disable configure the SPAN source interface as FC 9/1 with an egress filter for VSAN 1.
switch(config-span)# no source interface fc9/1 tx filter vsan 1
20-25
Chapter 20 source
S Commands
Related Commands Command switchport span session destination interface suspend show span session Description Configures the switchport mode on the Fibre Channel interface. Selects or configures the SPAN session and changes to SPAN configuration submode. Configures a SPAN destination interface. Suspends a SPAN session. Displays specific information about a SPAN session
20-26
Chapter 20
S Commands span session
span session
To configure a SPAN session, use the span session command. To remove a configured SPAN feature or revert it to factory defaults, use the no form of the command. span session session-id no span session session-id
Syntax Description
session-id
Enter SPAN session ID from 1 to 16.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to configure a SPAN session.

switch# config terminal switch(config)# span session 1 switch(config-span)#
The following example shows how to delete a SPAN session.

switch(config)# no span session 1
Related Commands
Command switchport span session destination interface source suspend show span session
Description Configures the switchport mode on the Fibre Channel interface. Selects or configures the SPAN session and changes to SPAN configuration submode. Configures a SPAN destination interface. Configures a SPAN source. Suspends a SPAN session. Displays specific information about a SPAN session
20-27
Chapter 20 special-frame
S Commands
special-frame
To enable or disable special frames for the FCIP interface, use the special-frame command. To disable the passive mode for the FCIP interface, use the no form of the command. special-frame peer-wwn pwwn-id [profile-id profile-number] no special-frame peer-wwn pwwn-id
Syntax Description
peer-wwn pwwn-id profile-id profile-number
Specifies the peer WWN ID for special frames. Specifies the peer profile ID. The range is 1 to 255.
Defaults
Disabled.
Command Modes
Command History
Release 1.1(1)
Usage Guidelines
Access this command from the switch(config-if)# submode. When a new TCP Connection is established, an FCIP special frame (if enabled) makes one round trip from the FCIP profile and initiates the TCP connect operation to the FCIP profile receiving the TCP connect request and back. Use these frames to identify the FCIP link endpoints, to learn about the critical parameters shared by Fibre Channel and FCIP profile pairs involved in the FCIP link, and to perform configuration discovery
Examples
The following example configures the special frames.

switch# config terminal switch(config)# interface fcip 1 switch(config)# special-frame peer-pwwn 11:11:11:11:11:11:11:11 switch(config)# special-frame peer-pwwn 22:22:22:22:22:22:22:22 profile-id 10
Related Commands
20-28
Chapter 20
S Commands ssh
ssh
To initiate a Secure Shell (SSH) session, use the ssh command in EXEC mode. ssh {hostname | userid@hostname}
Syntax Description
hostname userid
Specifies the name or IP address of the host to access. If no user name is specified, the default is admin. Specifies a user name on a host.
Defaults
The default user name is admin.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to initiate an SSH session using a host name.
switch# ssh host1 admin@1host1's password:
The following example shows how to initiate an SSH session using a host IP address.
switch# ssh 10.2.2.2 [email protected]'s password:
The following example shows how to initiate an SSH session using a user name host name.
switch# ssh user1@host1 user1@1host1's password:
Related Commands
Command show ssh key ssh server enable
Description Displays SSH key information. Enables SSH server.
20-29
Chapter 20 ssh key
S Commands
ssh key
To generate an SSH key, use the ssh key command in configuration mode. To delete the SSH keys, use the no form of the command. ssh key {dsa [bits] | rsa [bits] | rsa1 [bits]} [force] no ssh key
Syntax Description
dsa [bits] rsa [bits] rsa1 [bits] force
Generates a DSA key. The range for the number of bits is 768 to 1856. Generates an RSA key. The range for the number of bits is 768 to 2048. Generates an RSA1 key. The range for the number of bits is 768 to 2048. Forces the generation of keys even when previous keys are present.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to generate an SSH key.

switch# config terminal switch(config)# ssh key rsa1 1024 generating rsa1 key..... generated rsa1 key switch(config)# switch(config)# ssh key dsa 1024 generating dsa key..... generated dsa key switch(config)# switch(config)# ssh key rsa 1024 generating rsa key..... generated rsa key switch(config)# switch(config)# no ssh key cleared RSA keys switch(config)#
20-30
Chapter 20
S Commands ssh key
Related Commands Command show ssh key ssh server enable Description Displays SSH key information. Enables SSH server.
20-31
Chapter 20 ssh server enable
S Commands
ssh server enable

To enable the SSH server, use the ssh server enable command in configuration mode. To disable the SSH service, use the no form of the command. ssh server enable no ssh server enable
Syntax Description
Defaults
Disabled
Command Modes
Configuration mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example enables the SSH server.

switch# config terminal switch(config)# ssh server enable updated switch(config)# no ssh server enable updated
Related Commands
Command show ssh server ssh key
Description Displays SSH server information. Generates an SSH key.
20-32
Chapter 20
S Commands ssm enable feature
ssm enable feature

To enable a feature on the Storage Services Module (SSM), use the ssm enable feature command. To disable the feature on the module, use the no form of the command. ssm enable feature { emcsr {bootflash: uri | module slot-number | slot0: uri} | nasb {interface fc slot/port-port} | module slot-number} | nsp {bootflash: uri | module slot-number | slot0: uri} | santap {interface fc slot/port-port | module slot-number} | scsi-flow {interface fc slot/port-port | module slot-number}} no ssm enable feature { emcsr {bootflash: uri | module slot-number | slot0: uri} | nasb {interface fc slot/port-port} | module slot-number} | nsp {bootflash: uri | module slot-number | slot0: uri} | santap {interface fc slot/port-port | module slot-number} | scsi-flow {interface fc slot/port-port | module slot-number}}
Syntax Description
emcsr nasb nsp santap scsi-flow force bootflash:uri module slot-number slot0:uri interface fc slot/port fc slot/port-port
Enables the EMC Storage Router (EMCSR) feature on the SSM. Enables the Network-Accelerated Serverless Backup (NASB) feature on the SSM. Enables the Network Storage Processor (NSP) feature on the SSM. Enables the SANTap feature on the SSM. Enables the SCSI flow feature on the SSM. Forces an immediate configuration change. Specifies the source location for internal bootflash with image name. Specifies the slot number of the SSM. Specifies the source location for the CompactFlash memory or PC Card with image name. Specifies the interface to be configured. Configures the Fibre Channel interface. Configures the Fibre Channel interface range of ports. See the usage guidelines for this command for a list of interface range restrictions.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(2b) 2.1(1a)
Modification This command was introduced. Added emcsr, nasb, and santap features.
20-33
Chapter 20 ssm enable feature
S Commands
Usage Guidelines Use the ssm enable feature scsi-flow command to enable the SCSI flow feature on an SSM. The features emcsr and nsp can only be provisioned on a module basis. The features nasb, santap, and scsi-flow can be provisioned on either a module or a range of interfaces. The image must be specified when configuring the emcsr and nsp features.
Caution
The force option is only applicable when unprovisioning (using the no parameter). Using the force parameter without the no keyword causes the SSM to reload. For Release 2.1 and later images, intelligent services can be configured on a range of interfaces with the following restrictions:

The minimum range is four interfaces. The range of interfaces must be specified in multiples of four interfaces. For example, 4, 8, 12, 16, 20, 24, 28, 32. Ranges start at the following specific ports: 1, 5, 9, 13, 17, 21, 25, and 29.
Examples
The following example enables the EMCSR feature on the SSM in slot 4.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config) ssm enable feature emcsr module 4
The following example enables the EMCSR feature using the bootflash image name.
switch(config) ssm enable feature emcsr bootflash:image_name
The following example enables the EMCSR feature using the image name found on the PC card Flash module in slot0.
switch(config) ssm enable feature emcsr slot0:image_name
The following example disables the EMCSR feature on the SSM in slot 4.
switch(config) no ssm enable feature emcsr force module 4
The following example enables the NASB feature on the SSM in slot 4.
switch(config) ssm enable feature nasb module 4
The following example enables the NASB feature on the specific Fibre Channel interface range 1 to 4.
switch(config) ssm enable feature nasb interface fc 4/1-4
The following example enables the NSP feature on the SSM in slot 4.
switch(config) ssm enable feature nsp module 4
The following example enables the SANTap feature on the SSM in slot 4.
switch(config) ssm enable feature santap module 4
The following example enables the SCSI flow feature on the SSM in slot 4.
switch(config) ssm enable feature scsi-flow module 4
20-34
Chapter 20
S Commands ssm enable feature
Related Commands Command scsi-flow distribute show scsi-flow Description Configures the SCSI flow services. Displays SCSI flow configuration and status.
20-35
Chapter 20 static (iSCSI initiator submode)
S Commands
static (iSCSI initiator submode)

To assign persistent WWNs to an iSCSI initiator, use the static command in iSCSI initiator configuration submode. To disable this feature, use the no form of the command. static {nwwn | pwwn} {wwn-id | system-assign} no static {nwwn | pwwn} {wwn-id | system-assign}
Syntax Description
nwwn pwwn wwn-id system-assign
Configures the initiator node WWN hex value. Configures the peer WWN for special frames. Specifies the pWWN or nWWN ID. Generates the pWWN or nWWN value automatically.
Defaults
None.
Command Modes
Command History
Release 1.3(2)
Usage Guidelines
None.
Examples
The following example uses the switch WWN pool to allocate the nWWN for this iSCSI initiator and keeps it persistent.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# iscsi initiator name iqn.1987-02.com.cisco.initiator switch(config-iscsi-init)# static nWWN system-assign
The following example uses the switch WWN pool to allocate two pWWNs for this iSCSI initiator and keeps it persistent.
switch(config-iscsi-init)# static pWWN system-assign 2
Related Commands
20-36
Chapter 20
S Commands stop
stop
To stop SCSI commands in progress on a SAN tuner extension N port, use the stop command. stop {all | command-id cmd-id}
Syntax Description
all command-id cmd-id
Stops all SCSI commands. Stop a specific SCSI command identified by the command number. The range is 0 to 2147483647.
Defaults
None.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example stops all SCSI command on a SAN extension tuner N port.
switch# san-ext-tuner switch(san-ext)# nWWN 10:00:00:00:00:00:00:00 switch(san-ext)# nport pwwn 12:00:00:00:00:00:00:56 vsan 13 interface gigabitethernet 1/2 switch(san-ext-nport)# stop all
The following example stops a specific SCSI command on a SAN extension tuner N port.
switch# san-ext-tuner switch(san-ext)# nWWN 10:00:00:00:00:00:00:00 switch(san-ext)# nport pwwn 12:00:00:00:00:00:00:56 vsan 13 interface gigabitethernet 1/2 switch(san-ext-nport)# stop command-id 100
Related Commands
Command nport pwwn read command-id san-ext-tuner show san-ext-tuner write command-id
Description Configures a SAN extension tuner N port. Configures a SCSI read command for a SAN extension tuner N port. Enables the SAN extension tuner feature. Displays SAN extension tuner information. Configures a SCSI write command for a SAN extension tuner N port.
20-37
Chapter 20 streetaddress
S Commands
streetaddress
To configure the street address with the Call Home function, use the streetaddress command in Call Home configuration submode. To disable this feature, use the no form of the command. streetaddress street-address no streetaddress street-address
Syntax Description
street-address
(Optional). Configures the customers street address where the equipment is located. Allows up to 256 alphanumeric characters in free format for the street number, city, state, and zip (combined).
Defaults
None.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to configure the street address in the Call Home configuration.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# callhome switch(config-callhome)# streetaddress 1234 Picaboo Street, AnyCity, AnyState, 12345
Related Commands
20-38
Chapter 20
S Commands suspend
suspend
To suspend a switched port analyzer (SPAN) session, use the suspend command in SPAN session configuration submode. To disable the suspension, use the no form of the command. suspend no suspend
Syntax Description
Defaults
Disabled.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to suspend a SPAN session.

switch# config terminal Enter configuration commands, one per line. switch(config)# span session 1 switch(config-span)# suspend switch(config-span)# do show span session 1 Session 1 (admin suspended) Destination is not configured No session filters configured Ingress (rx) sources are fc3/13, Egress (tx) sources are fc3/13, switch(config-span)# End with CNTL/Z.
The following example shows how to disable the suspension of the SPAN session.
switch(config-span)# no suspend
20-39
Chapter 20 suspend
S Commands
Related Commands Command switchport span session destination interface source show span session Description Configures the switchport mode on the Fibre Channel interface. Selects or configures the SPAN session and changes to SPAN configuration submode. Configures a SPAN destination interface. Configures a SPAN source. Displays specific information about a SPAN session.
20-40
Chapter 20
S Commands switch-priority
switch-priority
To configure the switch priority with the Call Home function, use the switch-priority command in Call Home configuration submode. To disable this feature, use the no form of the command. switch-priority priority-value no switch-priority priority-value
Syntax Description
priority-value
(Optional). Configures the switch priority. Specifies a priority value. 0 is the highest priority and 7 the lowest.
Defaults
None.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows how to configure the switch priority in the Call Home configuration.
switch# config terminal Enter configuration commands, one per line. switch(config)# callhome switch(config-callhome)# switch-priority 0 End with CNTL/Z.
Related Commands
20-41
Chapter 20 switch-wwn
S Commands
switch-wwn
To configure a switch WWN in an autonomous fabric ID (AFID) database, use the switch-wwn command in AFID database configuration submode. To disable this feature, use the no form of this command. switch-wwn wwn-id {autonomous-fabric-id fabric-id vsan-ranges vsan-range | default-autonomous-fabric-id fabric-id vsan-ranges vsan-range} no switch-wwn wwn-id {autonomous-fabric-id fabric-id vsan-ranges vsan-range | default-autonomous-fabric-id fabric-id vsan-ranges vsan-range}
Syntax Description
wwn-id autonomous-fabric-id fabric-id vsan-ranges vsan-range default-autonomousfabric-id fabric-id
Specifies the port WWN, with the format hh:hh:hh:hh:hh:hh:hh:hh. Specifies the fabric ID for the IVR topology. Specifies the IVR VSANs or range of VSANs. The range of values for a VSAN ID is 1 to 4093. Specifies the default fabric ID for the IVR topology.
Defaults
Disabled.
Command Modes
AFID database configuration submode.
Command History
Release 2.1(1a)
Usage Guidelines
Using the default-autonomous-fabric-id keyword configures the default AFID for all VSANs not explicitly associated with an AFID.
Examples
The following example shows adds a switch WWN, AFID, and range of VSANs to the AFID database.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# ivr vsan-topology auto switch(config)# autonomous-fabric-id database switch(config-afid-db)# switch-wwn 28:1d:00:05:30:00:06:ea autonomous-fabric-id 14 vsan-ranges 1-4
The following example shows adds a switch WWN and the default AFID to the AFID database.
switch(config-afid-db)# switch-wwn 28:1d:00:05:30:00:06:ea default-autonomous-fabric-id 16
20-42
Chapter 20
S Commands switch-wwn
Related Commands Command autonomous-fabric-id database show autonomous-fabric-id database Description Enters AFID database configuration submode. Displays the contents of the AFID database.
20-43
Chapter 20 switchname
S Commands
switchname
To change the name of the switch, use the switchname command in configuration mode. To revert the switch name to the default name, use the no form of the command. switchname name no switchname
Syntax Description
name
Specifies a switch name. Maximum length is 32 characters.
Defaults
switch
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example changes the name of the switch to myswitch1.

switch# config terminal switch(config)# switchname myswitch1 myswitch1(config)# myswitch1(config)# no switchname switch(config)#
Related Commands
Command snmp-server
Description Sets the contact information, switch location, and switch name within the limit of 20 characters (without spaces).
20-44
Chapter 20
S Commands switchport
switchport
To configure switchport parameter on a Fibre Channel interface, use the switchport command in interface configuration submode. switchport {beacon | description text | encap eisl | fcrxbbcredit {credit [mode {E | Fx}] | default | extended credit | performance-buffers {buffers | default}} | fcrxbufsize size | mode {auto | E | F | FL | Fx | SD | TL} | speed {1000 | 2000 | auto} | trunk {allowed vsan {[add] vsan-id | all} | mode {auto | off | on}}} no switchport {beacon | description | encap | fcrxbbcredit [extended credit] | fcrxbufsize | mode | speed | trunk allowed vsan [[add] vsan-id | all]}
Syntax Description
slot/port switchport beacon description text encap eisl fcrxbbcredit credit mode E Fx default extended credits performance-buffers {buffers | default} fcrxbufsize size mode auto E F FL Fx SD TL speed 1000
Specifies a slot number and port number. Configures switchport parameters. Enables the beacon for the interface. Specifies the interface description. Maximum length is 80 characters. Configures Enhanced ISL (EISL) encapsulation for the interface. Configures receive BB_credit for the port. Specifies receive BB_credit. The range is 1 to 255 Configures receive BB_credit for specific mode. Specifies receive BB_credit for E or TE mode. Specifies receive BB_credit for F or FL mode. Specifies default receive BB_credits depending on the port mode and capabilities. Specifies extended receive BB_credit. The range is 256 to 3500. Specifies receive BB_credit performance buffers. The range is 1 to 145. The default value is determined by a built-in algorithm. Configures receive data field size for the interface. The range is 256 to 2112 bytes. Configures the port mode. Specifies autosense mode. Specifies E port mode. Specifies F port mode. Specifies FL port mode. Specifies Fx port mode. Specifies SD port mode. Specifies TL port mode. Configures the port speed. Specifies 1000 Mbps speed.
20-45
Chapter 20 switchport
S Commands
2000 auto trunk allowed vsan add vsan-id all mode auto off on Specifies 2000 Mbps speed. Specifies autosense speed. Configures trunking parameters on the interface. Specifies the allowed list for interface(s). Configures the VSAN range. Adds the VSAN ID to the range of allowed VSAN list Specifies the VSAN ID. The range is 1 to 4093. Adds all the VSANs to allowed VSAN list. Configures the trunking mode. Specifies automatic trunking mode. Disables the trunking mode. Enables the trunking mode.
Defaults
The beacon is disabled. The EISL encapsulation is disabled. The default receive data buffer size is 2112 bytes. The mode is auto. The speed is auto. The trunk mode is on.
Command Modes
Command History
Release 1.0(2) 2.0(1b)
Modification This command was introduced. Added the extended option to the fcrxbbcredit keyword.
Usage Guidelines
You can specify a range of interfaces by issuing a command with the following example format: interfacespacefc1/1space-space5space,spacefc2/5space-space7
Tip
The shutdown or no shutdown command for the FCIP or iSCSI interfaces is automatically issued when you change the MTU sizeyou do not need to explicitly issue this command. You must perform the fcrxbbcredit extended enable command in configuration mode to use the switchport fcrxbbcredit extended subcommand to enable extended BB_credits on a Fibre Channel interface.
20-46
Chapter 20
S Commands switchport
Examples The following example configures switchport features for a Fibre Channel interface.
switch# config terminal switch(config)# interface fc 1/23 switch(config-if)# switchport description techdocsSample switch(config-if)# switchport mode E switch(config-if)# switchport trunk mode auto switch(config-if)# switchport trunk allowed vsan all switch(config-if)# switchport trunk allowed vsan 3 switch(config-if)# switchport trunk allowed vsan add 2 switch(config-if)# switchport encap eisl switch(config-if)# switchport fcrxbbcredit performance-buffers 45 switch(config-if)# switchport proxy-initiator nWWN 11:11:11:11:11:11:11:11 pwwn 22:22:22:22:22:22:22:22 switch(config-if)# no switchport proxy-initiator nWWN 11:11:11:11:11:11:11:11 pwwn 22:22:22:22:22:22:22:22 switch(config-if)# switchport fcrxbbcredit extended 2000
Related Commands
Command fcrxbbcredit extended enable show interface
Description Enables extended BB_credits on the switch. Displays an interface configuration for a specified interface.
20-47
Chapter 20 switchport auto-negotiate
S Commands
switchport auto-negotiate
To configure auto-negotiation in Gigabit Ethernet interfaces, use the switchport auto-negotiate command in configuration mode. Use the no form of the command to delete the configured switchport information. switchport auto-negotiate no switchport auto-negotiate
Syntax Description
switchport auto-negotiate
Configures switchport parameters. Automatically negotiates the speed, pause method, and duplex of incoming signals based on the link partner.
Defaults
Enabled
Command Modes
Command History
Usage Guidelines
You can configure the auto-negotiate option for a specified Gigabit Ethernet interface. By default, the port is configured to auto-negotiate. By configuring auto-negotiation, the port automatically detects the speed or pause method, and duplex of incoming signals and synchronizes with them. Access this command from the switch(config-if)# submode for Gigabit Ethernet interfaces.
Examples
The following example configures auto-negotiation on a Gigabit Ethernet interface.

switch# config t switch(config)# interface gigabitethernet 8/1 switch(config-if)# switchport auto-negotiate
The following example disable auto-negotiation on a Gigabit Ethernet interface.

switch(config-if)# no switchport auto-negotiate
Related Commands
Command show interface gigabitethernet
Description Displays an interface configuration for a specified Gigabit Ethernet interface.
20-48
Chapter 20
S Commands switchport ingress-rate
switchport ingress-rate
To configure the port rate limit for a specified interface, use the switchport ingress-rate command in interface configuration mode. Use the no form of the command to delete the configured switchport information. switchport ingress-rate limit no switchport ingress-rate limit
Syntax Description
limit
Specifies the ingress rate limit as a percentage. The range is 1 to 100.
Defaults
Disabled
Command Modes
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode. This command is only available if the following conditions are true:

The QoS feature is enabled using the qos enable command. The command is issued in a Cisco MDS 9100 series switch.
Examples
The following example configures the ingress rate limit on a Fibre Channel interface.
switch# config terminal switch(config)# interface fc 2/5 switch(config-if)# switchport ingress-rate 5
Related Commands
Command show interface fc
Description Displays an interface configuration for a specified Fibre Channel interface.
20-49
Chapter 20 switchport initiator id
S Commands
switchport initiator id
To configure the iSCSI initiator ID mode, use the switchport initiator id command in interface configuration submode. To delete the configured switchport information, use the no form of the command. switchport initiator id {ip-address | name] no switchport initiator id {ip-address | name}
Syntax Description
ip-address name
Identifies initiators using the IP address. Identifies initiators using the specified name.
Defaults
Disabled
Command Modes
Command History
Usage Guidelines
Examples
The following example configures the switchport initiator ID mode for a iSCSI interface.
switch# config terminal switch(config)# interface iscsi 2/5 switch(config-if)# switchport initiator id ip-address switch(config-if)# switchport initiator name
Related Commands
Command show interface iscsi
Description Displays an interface configuration for a specified iSCSI interface.
20-50
Chapter 20
S Commands switchport promiscuous-mode
switchport promiscuous-mode
To configure the promiscuous-mode in Gigabit Ethernet interfaces, use the switchport promiscuous-mode command in interface configuration submode. Use the no form of the command to delete the configured switchport information. switchport promiscuous-mode {off | on} no switchport promiscuous-mode
Syntax Description
off on
Disables promiscuous mode. Enables promiscuous mode.
Defaults
Disabled
Command Modes
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode for Gigabit Ethernet interfaces.
Examples
The following example enables promiscuous mode on a Gigabit Ethernet interface.

switch# config terminal switch(config)# interface gigabitethernet 8/1 switch(config-if)# switchport promiscuous-mode on
The following example disables promiscuous mode on a Gigabit Ethernet interface.

switch(config-if)# switchport promiscuous-mode off
The following example disables promiscuous mode on a Gigabit Ethernet interface.

switch(config-if)# no switchport promiscuous-mode
Related Commands
Command show interface gigabitethernet
Description Displays an interface configuration for a specified Gigabit Ethernet interface.
20-51
Chapter 20 switchport proxy-initiator
S Commands
switchport proxy-initiator
To configure the iSCSI proxy initiator mode, use the switchport proxy-initiator command in interface configuration submode. To delete the configured switchport proxy initiator mode, use the no form of the command. switchport proxy-initiator [nwwn wwn pwwn wwn] no switchport proxy-initiator [nwwn wwn pwwn wwn]
Syntax Description
nwwn wwn pwwn wwn
Specifies the node WWN. Specifies the port WWN.
Defaults
Disabled.
Command Modes
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode. When you do not include the WWNs in the command, the IPS port dynamically assigns a pWWN and nWWN to the proxy initiator.
Examples
The following example configures the switchport proxy initiator mode for a iSCSI interface using WWNs.
switch# config terminal switch(config)# interface iscsi 2/5 switch(config-if)# switchport proxy-initiator nwwn 11:11:11:11:11:11:11:11 pwwn 22:22:22:22:22:22:22:22
The following example configures the switchport proxy initiator mode for a iSCSI interface without WWNs.
switch# config terminal switch(config)# interface iscsi 2/5 switch(config-if)# switchport proxy-initiator
The following example deletes the switchport proxy initiator mode for a iSCSI interface.
switch(config-if)# switchport proxy-initiator
20-52
Chapter 20
S Commands switchport proxy-initiator
Related Commands Command show interface iscsi Description Displays an interface configuration for a specified iSCSI interface.
20-53
Chapter 20 system cores
S Commands
system cores
To enable copying the core and log files periodically, use the system cores command in configuration mode. To revert the switch to factory defaults, use the no form of the command. system cores {slot0: | tftp:} no system cores
Syntax Description
slot0 tftp:
Selects destination file system. Selects destination file system.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Create any required directory before issuing this command. If the directory specified by this command does not exist, the switch software logs a syslog message each time a copy cores is attempted.
Examples
The following example enables periodic copying core and log files.
switch# config terminal switch(config)# system cores slot0:coreSample
The following example disables periodic copying core and log files.
switch(config)# no system cores switch(config)#
Related Commands
Command show system cores
Description Displays the currently configured scheme for copying cores.
20-54
Chapter 20
S Commands system default switchport
system default switchport

To configure default values for various switchport attributes, use the system default switchport command in configuration mode. To revert to the default, use the no form of the command. system default switchport {shutdown | trunk {mode auto | off | on}} no system default switchport shutdown
Syntax Description
shutdown trunk mode auto off on
Disables or enables switch ports by default. Configures trunking parameters as a default. Configures trunking mode. Sets autosense trunking. Disables trunking. Enables trunking.
Defaults
Enabled
Command Modes
Configuration mode
Command History
Usage Guidelines
Attributes configured using this command are applied globally to all future switch port configurations, even if you do not individually specify them at that time.
Examples
The following example configures default values for switchport attributes.

switch# config terminal switch(config)# system default switchport shutdown switch(config-if)# switch(config)# no system default switchport shutdown switch(config-if)# switch(config)# system default switchport trunkmode auto switch(config-if)#
Related Commands
Command show system default switchport
Description Displays default values for switch port attributes.
20-55
Chapter 20 system hap-reset
S Commands
system hap-reset
To configure the HA reset policy, use the system hap-reset command in EXEC mode. Use the no form of this command to disable this feature. system hap-reset system no hap-reset
Syntax Description
Defaults
Enabled
Command Modes
EXEC
Command History
Usage Guidelines
You can disable the HA policy supervisor reset feature (enabled by default) for debugging and troubleshooting purposes.
Examples
The following example enables the supervisor reset HA policy.

switch# system hap-reset
20-56
Chapter 20
S Commands system health
system health
To configure Online System Health Management (OSHM) features for a specified interface or for the entire switch, use the system health command. Use the no form of this command to disable this feature. system health [failure-action | interface {fc slot/port | iscsi slot/port} | loopback frequency seconds] no system health [failure-action | interface {fc slot/port | iscsi slot/port} | loopback frequency seconds]
Syntax Description
interface fc slot/port iscsi slot/port loopback frequency seconds failure-action
Specifies the interface to be configured. Configures the Fiber Channel interface. Selects the iSCSI interface to configure. Configure the OHMS loopback test. Specifies the loopback frequency in seconds loopback frequency ranging from 5 seconds (default) to 255 seconds. Prevents the SAN-OS software from taking any OHMS action for the entire switch.
Defaults
Enabled
Command Modes
Configuration mode
Command History
Usage Guidelines
If you do not configure the loopback frequency value, the default frequency of 5 seconds is used for all modules in the switch.
Examples
The following example disables OHMS in this switch.

switch# config terminal switch(config)# no system health System Health is disabled.
The following example enables (default) OHMS in this switch.

switch(config)# system health System Health is enabled.
The following example enables OHMS in this interface.

switch(config)# no system health interface fc8/1 System health for interface fc8/13 is enabled.
20-57
Chapter 20 system health
S Commands
The following example disables OHMS in this interface.
switch(config)# system health interface fc8/1 System health for interface fc8/13 is disabled.
The following example configures the loopback frequency to be 50 seconds for any port in the switch.
switch(config)# system health loopback frequency 50 The new frequency is set at 50 Seconds.
The following example prevents the switch from taking any failure action.
switch(config)# system health failure-action System health global failure action is now enabled.
The following example prevents the switch configuration to taking OHMS action (default) in case of a failure.
switch(config)# no system health failure-action System health global failure action now disabled.
20-58
Chapter 20
S Commands system health clear-errors
system health clear-errors

To clear previous error conditions stored in the Online System Health Management (OSHM) applications memory, use the system health clear-errors command. system health clear-errors interface {fc slot/port | iscsi slot/port} system health clear-errors module slot [battery-charger | bootflash | cache-disk | eobc | inband | loopback | mgmt]
Syntax Description
interface fc slot/port iscsi slot/port module slot battery-charger bootflash cache-disk eobc inband loopback mgmt
Specifies the interface to be configured. Configures the Fiber Channel interface. Selects the iSCSI interface to configure. Specifies the required module in the switch, Configure the OHMS battery-charger test on the specified module Configures the OHMS bootflash test on the specified module. Configures the OHMS cache-disk test on the specified module. Configures the OHMS EOBC test on the specified module. Configures the OHMS inband test on the specified module. Configures the OHMS loopback test on the specified module. Configures the OHMS management port test on the specified module.
Defaults
Enabled
Command Modes
EXEC mode
Command History
Usage Guidelines
You can clear the error history for Fibre Channel interfaces, iSCSI interfaces, for an entire module, or one particular test for an entire module. The battery-charger, the bootflash, the cache-disk, the eobc, the inband, the loopback, and the mgmt test options can be individually specified for a given module. The management port test cannot be run on a standby supervisor module.
Examples
The following example clears the error history for the specified Fibre Channel interface:
switch# system health clear-errors interface fc 3/1
The following example clears the error history for the specified module:
switch# system health clear-errors interface module 3
20-59
Chapter 20 system health clear-errors
S Commands
The following example clears the management port test error history for the specified module:
switch# system health clear-errors module 2 mgmt
20-60
Chapter 20
S Commands system health external-loopback
system health external-loopback

To explicitly run an external Online System Health Management (OSHM) loopback test on demand (when requested by the user) for a specified interface or module, use the system health external-loopback command. system health external-loopback interface fc slot/port [force]
Syntax Description
interface fc slot/port force
Specifies the interface to be configured. Configures the Fiber Channel interface using the slot and port. Directs the software to use the non-interactive loopback mode.
Defaults
Disabled.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Use this command to run this test on demand for the external devices connected to a switch that is part of a long haul network.
Examples
The following example displays an external loopback command for a Fibre Channel interface.
switch# system health external-loopback interface fc 3/1 This will shut the requested interfaces Do you want to continue (y/n)? External loopback test on interface fc3/1 was successful. [n] y
The following example displays the effect of the force option to implement a forced loopback.
switch# system health external-loopback interface fc 3/1 force External loopback test on interface fc3/1 was successful.
20-61
Chapter 20 system health internal-loopback
S Commands
system health internal-loopback

To explicitly run an internal Online System Health Management (OSHM) loopback test on demand (when requested by the user) for a specified interface or module, use the system health internal-loopback command. system health internal-loopback interface {fc slot/port | iscsi slot/port}
Syntax Description
interface fc slot/port iscsi slot/port
Specifies the interface to be configured. Configures the Fiber Channel interface using the slot and port. Selects the iSCSI interface to configure.
Defaults
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Internal loopback tests send and receive FC2 frames to/from the same ports and provides the round trip time taken in microseconds for both Fibre Channel and iSCSI interfaces.
Examples
The following example performs the internal loopback test for an iSCSI interface.
switch# system health internal-loopback interface iscsi 8/1 Internal loopback test on interface iscsi8/1 was successful. Round trip time taken is 79 useconds
20-62
Chapter 20
S Commands system health module
system health module

To configure Online System Health Management (OSHM) features for a specified module, use the system health module command. Use the no form of this command to disable this feature. system health module slot [battery-charger [failure-action | frequency seconds] | bootflash [failure-action | frequency seconds] | cache-disk [failure-action | frequency seconds] | eobc [failure-action | frequency seconds] | failure-action | inband [failure-action | frequency seconds] | loopback [failure-action] | mgmt [failure-action | frequency seconds]] no system health module slot [battery-charger [failure-action | frequency seconds] | bootflash [failure-action | frequency seconds] | cache-disk [failure-action | frequency seconds] | eobc [failure-action | frequency seconds] | failure-action | inband [failure-action | frequency seconds] | loopback [failure-action] | mgmt [failure-action | frequency seconds]]
Syntax Description
module slot battery-charger frequency seconds failure-action bootflash cache-disk eobc inband loopback mgmt
Specifies the required module in the switch, Configure the OHMS battery-charger test on the specified module Specifies the loopback frequency in seconds loopback frequency ranging from 5 seconds (default) to 255 seconds. Prevents the SAN-OS software from taking any OHMS action for the specified module. Configures the OHMS bootflash test on the specified module. Configures the OHMS cache-disk test on the specified module. Configures the OHMS EOBC test on the specified module. Configures the OHMS inband test on the specified module. Configures the OHMS loopback test on the specified module. Configures the OHMS management port test on the specified module.
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
20-63
Chapter 20 system health module
S Commands
Usage Guidelines If you do not configure the loopback frequency value, the default frequency of 5 seconds is used for all modules in the switch.
Examples
The following example enables the battery-charger test on both batteries in the CSM module residing in slot 8. If the switch does not have a CSM, this message is issued,
switch# config terminal switch(config)# system health module 8 battery-charger battery-charger test is not configured to run on module 8.
The following example enables the cache-disk test on both disks in the CSM module residing in slot 8. If the switch does not have a CSM, this message is issued,
switch(config)# system health module 8 cache-disk cache-disk test is not configured to run on module 8.
The following example enables the bootflash test on Module 8.

switch(config)# system health module 8 bootflash System health for module 8 Bootflash is already enabled.
The following example enables you to prevent the SAN-OS software from taking any OHMS action if any component fails in Module 8.
switch(config)# system health module 8 bootflash failure-action System health failure action for module 8 Bootflash test is now enabled.
The following example enables an already-enabled bootflash test on Module 8.

switch(config)# system health module 8 bootflash failure-action System health failure action for module 8 Bootflash test is already enabled.
The following example disables the bootflash test configuration on Module 8.

switch(config)# no system health module 8 bootflash failure-action System health failure action for module 8 Bootflash test is now disabled.
The following example sets the new frequency of the bootflash test on module 8 to 200 seconds.
switch(config)# system health module 8 bootflash frequency 200 The new frequency is set at 200 Seconds.
The following example enables the EOBC test on Module 8.

switch(config)# system health module 8 eobc System health for module 8 EOBC is now enabled.
The following example enables the inband test on Module 8.

switch(config)# system health module 8 inband System health for module 8 EOBC is now enabled.
The following example enables the loopback test on Module 8.

switch(config)# system health module 8 loopback System health for module 8 EOBC is now enabled.
The following example enables the management test on Module 8.

switch(config)# system health module 8 management System health for module 8 EOBC is now enabled.
20-64
Chapter 20
S Commands system heartbeat
system heartbeat
To enable system heartbeat checks, use the system heartbeat command in EXEC mode. Use the no form of this command to disable this feature. system heartbeat system no heartbeat
Syntax Description
Defaults
Enabled
Command Modes
EXEC
Command History
Usage Guidelines
You can disable the heartbeat checking feature (enabled by default) for debugging and troubleshooting purposes like attaching a GDB to a specified process.
Examples
The following example enables the system heartbeat checks.

switch# system heartbeat
20-65
Chapter 20 system memlog
S Commands
system memlog
To collect system memory statistics, use the system memlog command in EXEC mode. system memlog
Syntax Description
Defaults
Enabled.
Command Modes
EXEC.
Command History
Usage Guidelines
Use this command for debugging and troubleshooting purposes.
Examples
The following example enables system memory logging.

switch# system memlog
20-66
Chapter 20
S Commands system startup-config
system startup-config
To release a system startup configuration lock, use the system startup-config command in EXEC mode. system startup-config unlock lock-id
Syntax Description
unlock lock-id
Configures the system startup-config unlock ID number. The range is 0 to 65536.
Defaults
Disabled.
Command Modes
EXEC.
Command History
Release 2.0(1b)
Usage Guidelines
The system startup-config command allows you to unlock or release the rr_token lock. To determine the lock-id, use the show system internal sysmgr startup-config locks command
Examples
The following example releases the system configuration lock with identifier 1.
switch# system startup-config unlock 1
Related Commands
Command show system
Description Displays system information.
20-67
Chapter 20 system statistics reset
S Commands
system statistics reset

To reset the high availability statistics collected by the system, use the system statistics reset command in EXEC mode. system statistics reset
Syntax Description
Defaults
Enabled.
Command Modes
EXEC.
Command History
Usage Guidelines
You can disable the system statistics reset feature (enabled by default) for debugging and troubleshooting purposes.
Examples
The following example resets the HA statistics.

switch# system statistics reset
20-68
Chapter 20
S Commands system switchover (EXEC mode)
system switchover (EXEC mode)

To specifically initiate a switchover from an active supervisor module to a standby supervisor module, use the system switchover command in EXEC mode. system switchover
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Any switchover function is nonrevertive. Once a switchover has occurred and the failed processor has been replaced or successfully restarted, you cannot switch back to the original, active supervisor module (unless there is a subsequent failure or you issue the system switchover command).
Examples
The following example initiates a HA switchover from an active supervisor module to a standby supervisor module.
switch# system switchover
Related Commands
Command show version compatibility show module show system redundancy status
Description Determines version compatibility between switching modules. Displays the HA-standby state for the standby supervisor module. Determines whether the system is ready to accept a switchover.
20-69
Chapter 20 system switchover (configuration mode)
S Commands
system switchover (configuration mode)

To enable a switchover for the system, use the system switchover command in configuration mode. To revert to the factory default setting, use the no form of the command. system switchover {ha | warm} no system switchover
Syntax Description
ha warm
Specifies HA switchover. Specifies warm switchover.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example enables a HA switchover from an active supervisor module to a standby supervisor module.
switch# config terminal switch(config)# system switchover ha
20-70
Chapter 20
S Commands system trace
system trace
To configure the system trace level, use the system trace command in configuration mode. To disable this feature, use the no form of the command. system trace bit-mask no system trace
Syntax Description
bit-mask
Specifies the bit mask to change the trace level.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
This command is used for debugging purposes.
Examples
The following example shows how to configure the system trace level.
switch# config terminal switch(config)# system trace 0xff
20-71
Chapter 20 system watchdog
S Commands
system watchdog
To enable watchdog checks, use the system watchdog command in EXEC mode. To disable this feature, use the no form of the command. system watchdog system no watchdog
Syntax Description
Defaults
Enabled
Command Modes
EXEC
Command History
Usage Guidelines
If a watchdog is not logged at every 8 seconds by the software, the supervisor module reboots the switch. You can disable the watchdog checking feature (enabled by default) for debugging and troubleshooting purposes like attaching a GDB or a kernel GDB (KGDB) to a specified process.
Examples
The following example enables the supervisor reset HA policy.

switch# system watchdog
20-72
C H A P T E R
21
Show Commands
21-1
Chapter 21 show aaa accounting
Show Commands
show aaa accounting

To display the accounting configuration, use the show aaa accounting command. show aaa accounting
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example displays accounting log configuration.

switch# show aaa accounting default: local
Related Commands
Command aaa accounting default
Description Configure the default accounting method
21-2
Chapter 21
Show Commands show aaa authentication
show aaa authentication

To display configured authentication information, use the show aaa authentication command. show aaa authentication [login error-enable]
Syntax Description
login error-enable
Displays the authentication login error message enable configuration.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.3(1) 2.0(1b)
Modification This command was introduced. Added the login error-enable option.
Usage Guidelines
None.
Examples
The following example displays the configured authentication parameters.

switch# show aaa authentication default: group TacServer local none console: local iscsi: local dhchap: local
The following example displays the authentication login error message enable configuration.
switch# show aaa authentication login error-enable disabled
21-3
Chapter 21 show aaa groups
Show Commands
show aaa groups

To display configured server groups, use the show aaa groups command. show aaa groups
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
To display configured server groups.

switch# show aaa groups radius TacServer
21-4
Chapter 21
Show Commands show accounting log
show accounting log

To display the accounting log contents, use the show accounting log command. show accounting log [size]
Syntax Description
size
Specifies the size of the log to display in bytes. The range is 0 to 250000.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example displays the entire accounting log.

switch# show accounting log 2002:stop:snmp_1033151784_171.71.49.83:admin: Fri Sep 27 18:36:24 2002:start:_1033151784:root Fri Sep 27 18:36:28 2002:update:::fcc configuration requested Fri Sep 27 18:36:33 2002:start:snmp_1033151793_171.71.49.83:admin Fri Sep 27 18:36:33 2002:stop:snmp_1033151793_171.71.49.83:admin: Fri Sep 27 18:39:28 2002:start:snmp_1033151968_171.71.49.96:admin Fri Sep 27 18:39:28 2002:stop:snmp_1033151968_171.71.49.96:admin: Fri Sep 27 18:39:28 2002:start:_1033151968:root Fri Sep 27 18:39:31 2002:update:::fcc configuration requested Fri Sep 27 18:39:37 2002:start:snmp_1033151977_171.71.49.96:admin Fri Sep 27 18:39:37 2002:stop:snmp_1033151977_171.71.49.96:admin: Fri Sep 27 18:39:37 2002:start:snmp_1033151977_171.71.49.96:admin Fri Sep 27 18:42:12 2002:start:snmp_1033152132_171.71.49.96:admin Fri Sep 27 18:42:12 2002:stop:snmp_1033152132_171.71.49.96:admin: Fri Sep 27 18:42:12 2002:start:snmp_1033152132_171.71.49.96:admin Fri Sep 27 18:42:40 2002:start:snmp_1033152160_171.71.49.96:admin ...
The following example displays the 400 bytes of the accounting log.
switch# show accounting log 400 Tue Tue Tue Tue Tue Dec Dec Dec Dec Dec 8 8 8 8 8 22:06:59 22:07:03 22:07:13 22:07:53 22:08:15 1981:start:/dev/pts/2_376697219:admin: 1981:stop:/dev/pts/2_376697219:admin:shell terminated 1981:start:/dev/pts/2_376697233:admin: 1981:stop:/dev/pts/2_376697233:admin:shell terminated 1981:update:/dev/ttyS0_376628597:admin:iSCSI Interface Vsan Enabled
21-5
Chapter 21 show accounting log
Show Commands
Related Commands Command clear accounting log Description Clears the accounting log.
21-6
Chapter 21
Show Commands show arp
show arp
To display Address Resolution Protocol (ARP) entries, use the show arp command. show arp
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
This displays the ARP table.

switch# show arp Protocol Address Internet 171.1.1.1 Internet 172.2.0.1 Age (min) 0 4 Hardware Addr Type Interface 0006.5bec.699c ARPA mgmt0 0000.0c07.ac01 ARPA mgmt0
Related Commands
Command clear arp-cache
Description Clears the arp-cache table entries.
21-7
Chapter 21 show autonomous-fabric-id database
Show Commands
show autonomous-fabric-id database

To display the contents of the AFID database, use the show autonomous-fabric-id database command in EXEC mode. show autonomous-fabric-id database
Syntax Description
Defaults
None
Command Modes
EXEC mode.
Command History
Release 2.1(1a)
Usage Guidelines
None.
Examples
The following example shows contents of the AFID database.

switch# show autonomous-fabric-id database SWITCH WWN Default-AFID -------------------------------------------------------------20:00:00:0c:91:90:3e:80 5
Total:
1 entry in default AFID table
SWITCH WWN AFID VSANS -------------------------------------------------------------20:00:00:0c:91:90:3e:80 10 1,2,5-8
Total: 1 entry in AFID table
Related Commands
Command autonomous-fabric-id (IVR topology database configuration)
Description Configures an autonomous fabric ID into the Inter-VSAN Routing (IVR) topology database.
21-8
Chapter 21
Show Commands show autonomous-fabric-id database
Command autonomous-fabric-id (IVR service group configuration) autonomous-fabric-id database Description Configures an autonomous fabric ID into the IVR service group.
Configures an autonomous fabric ID (AFID) database
21-9
Chapter 21 show banner motd
Show Commands
show banner motd

To display a configured message of the day (MOTD) banner, use the show banner moted command. show banner motd
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The configured MOTD banner is displayed before the login prompt on the terminal whenever a user logs in to a Cisco MDS 9000 Family switch.
Examples
The following example displays the configured banner message.

switch# show banner motd Testing the MOTD Feature
The configured message is visible the next time you log in to the switch:
Testing the MOTD Feature switch login:
Related Commands
Command banner motd
Description Configures the required banner message.
21-10
Chapter 21
Show Commands show boot
show boot
To display the boot variables or modules, use the show boot command. show boot [module [slot | variable-name] | sup-1 | sup-2 | variables]
Syntax Description
module slot variable-name sup-1 sup-2 variables
Displays the boot variables for modules. Specifies a module by the slot number. Specifies the variable. Maximum length is 80 characters. Displays the upper sup configuration. Displays the lower sup configuration. Displays the list of boot variables.
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was modified in Release 1.2(2).
Usage Guidelines
None.
Examples
The following example displays the current contents of the boot variable.
switch# show boot kickstart variable = bootflash:/kickstart-image system variable = bootflash:/system-image Module 2 asm-sfn variable = bootflash:/asm-image
The following example displays the images on the specified ASM.

switch# show boot module Module 2 asm-sfn variable = bootflash:/asm-image
The following example displays a list of all boot variables. The ASM-SFN boot variable is used for the ASM.
switch# show boot variables List of boot variables are: asm-sfn system kickstart
21-11
Chapter 21 show boot auto-copy
Show Commands
show boot auto-copy

To display state of the auto-copy feature, use the show boot auto-copy command. show boot auto-copy [list]
Syntax Description
list
Displays the list of files to be auto-copied
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the current state of the auto-copy feature.
switch# show boot auto-copy Boot variables Auto-Copy ON
The following example displays the ilc1.bin image being copied to the standby supervisor module's bootflash, and once this is successful, the next file will be lasilc1.bin. This command only displays files on the active supervisor module.
switch# show boot auto-copy list File: /bootflash/ilc1.bin Bootvar: ilce File:/bootflash/lasilc1.bin Bootvar: lasilc
The following example displays a typical message when the auto-copy option is disabled or if no files are copied.
switch# show boot auto-copy list No file currently being auto-copied
21-12
Chapter 21
Show Commands show callhome
show callhome
To display Call Home information configured on a switch, use the show callhome command. show callhome [destination-profile [profile {profile | full-txt-destination | short-txt-destination | XML-destination}] | last action status | pending | pending-diff | transport-email]
Syntax Description
destination-profile profile profile full-txt-destination short-txt-destination XML-destination last action status pending pending-diff transport-email
Displays Call Home destination profile information. Specifies the destination profile. Specifies a user defined destination profile. Specifies the full text destination profile. Specifies the short text destination profile. Specifies the XML destination profile. Displays the status of the last CFS commit or discard operation. Displays the status of pending Call Home configuration. Displays the difference between running and pending Call Home configurations. Displays Call Home e-mail transport information.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.0(2) 2.0(1b)
Modification This command was introduced. Added last action status, pending, and pending-diff options.
Usage Guidelines
None.
Examples
The following example displays configured callhome information.

switch# show callhome callhome enabled Callhome Information: contact person name:who@where contact person's email:[email protected] contact person's phone number:310-408-4000 street addr:1234 Picaboo Street, Any city, Any state, 12345 site id:Site1ManhattanNewYork customer id:Customer1234 contract id:Andiamo1234 switch priority:0 duplicate message throttling : enabled
21-13
Chapter 21 show callhome
Show Commands
periodic inventory : disabled periodic inventory time-period : 7 days distribution of callhome configuration data using cfs : disabled
The following example displays all destination profile information.

switch# show callhome destination-profile XML destination profile information maximum message size:250000 email addresses configured: [email protected] Short-txt destination profile information maximum message size:4000 email addresses configured: [email protected] full-txt destination profile information maximum message size:250000 email addresses configured: [email protected]
The following example displays the full-text destination profile.

switch# show callhome destination-profile profile full-txt-destination full-txt destination profile information maximum message size:250000 email addresses configured: [email protected]
The following example displays the short-text destination profile.

switch# show callhome destination-profile profile short-txt-destination Short-txt destination profile information maximum message size:4000 email addresses configured: [email protected]
The following example displays the XML destination profile.

switch# show callhome destination-profile profile XML-destination XML destination profile information maximum message size:250000 email addresses configured: [email protected]
The following example displays e-mail and SMTP information.

switch# show callhome transport-email from email addr:[email protected] reply to email addr:[email protected] return receipt email addr:[email protected] smtp server:server.company.com smtp server port:25
Related Commands
Command callhome
Description Configures Call Home.
21-14
Chapter 21
Show Commands show cdp
show cdp
To display CDP parameters configured globally or for a specific interface, use the show cdp command. show cdp {all | entry [all | name cdp-name] | global | interface [gigabitethernet slot/port | mgmt 0] | neighbors [detail | interface (gigabitethernet slot/port | mgmt 0)] | traffic interface [gigabitethernet slot/port | mgmt 0]}
Syntax Description
all entry all name cdp-name global interface gigabitethernet slot/port mgmt 0 neighbors detail interface traffic
Displays all enabled CDP interfaces. Displays CDP database entries. Displays all CDP entries in the database Displays CDP entries that match a specified name. Maximum length is 256 characters. Displays global CDP parameters. Displays CDP parameters for an interface. Specifies the Gigabit Ethernet interface at the slot number and port number separated by a slash (/). Specifies the Ethernet management interface. Displays all CDP neighbors. Displays detailed information for all CDP neighbors Displays CDP information for neighbors on a specified interface. Displays CDP traffic statistics for an interface.
Defaults
None
Command Modes
EXEC
Command History
Usage Guidelines
This command is allowed only on the active supervisor module in the Cisco MDS 9500 Series.
Examples
The following example displays all CDP capable interfaces and parameters.
switch# show cdp all GigabitEthernet4/1 is up CDP enabled on interface Sending CDP packets every 60 seconds Holdtime is 180 seconds GigabitEthernet4/8 is down CDP enabled on interface Sending CDP packets every 60 seconds Holdtime is 180 seconds mgmt0 is up
21-15
Chapter 21 show cdp
Show Commands
CDP enabled on interface Sending CDP packets every 100 seconds Holdtime is 200 seconds
The following example displays all CDP neighbor entries.

switch# show cdp entry all ---------------------------------------Device ID:069038747(Kiowa3) Entry address(es): IP Address: 172.22.92.5 Platform: WS-C5500, Capabilities: Trans-Bridge Switch Interface: mgmt0, Port ID (outgoing port): 5/22 Holdtime: 136 sec Version: WS-C5500 Software, Version McpSW: 2.4(3) NmpSW: 2.4(3) Copyright (c) 1995-1997 by Cisco Systems Advertisement Version: 1
The following example displays the specified CDP neighbor.

switch# show cdp entry name 0 ---------------------------------------Device ID:0 Entry address(es): IP Address: 0.0.0.0 Platform: DS-X9530-SF1-K9, Capabilities: Host Interface: GigabitEthernet4/1, Port ID (outgoing port): GigabitEthernet4/1 Holdtime: 144 sec Version: 1.1(0.144) Advertisement Version: 2 Duplex: full
The following example displays global CDP parameters.

switch# show cdp global Global CDP information: CDP enabled globally Sending CDP packets every 60 seconds Sending a holdtime value of 180 seconds Sending CDPv2 advertisements is enabled
The following example displays CDP parameters for the management interface.
switch# show cdp interface mgmt 0 mgmt0 is up CDP enabled on interface Sending CDP packets every 60 seconds Holdtime is 180 seconds
The following example displays CDP parameters for the Gigabit Ethernet interface.
switch# show cdp interface gigabitethernet 4/1 GigabitEthernet4/1 is up CDP enabled on interface Sending CDP packets every 80 seconds Holdtime is 200 seconds
21-16
Chapter 21
Show Commands show cdp
The following example displays CDP Neighbors (brief).
switch# show cdp neighbors Capability Codes: R - Router, T - Trans-Bridge, B - Source-Route-Bridge S - Switch, H - Host, I - IGMP, r - Repeater Device ID 0 069038732(Kiowa2 069038747(Kiowa3 069038747(Kiowa3 Local Intrfce Gig4/1 mgmt0 mgmt0 mgmt0 Hldtme 135 132 156 158 Capability H T S T S T S Platform DS-X9530-SF1WS-C5500 WS-C5500 WS-C5500 Port ID Gig4/1 8/11 6/20 5/22
The following example displays CDP neighbors (detail).

switch# show CDP neighbor detail ---------------------------------------Device ID:0 Entry address(es): IP Address: 0.0.0.0 Platform: DS-X9530-SF1-K9, Capabilities: Host Interface: GigabitEthernet4/1, Port ID (outgoing port): GigabitEthernet4/1 Holdtime: 162 sec Version: 1.1(0.144) Advertisement Version: 2 Duplex: full ---------------------------------------Device ID:069038732(Kiowa2) Entry address(es): IP Address: 172.22.91.5 Platform: WS-C5500, Capabilities: Trans-Bridge Switch Interface: mgmt0, Port ID (outgoing port): 8/11 Holdtime: 132 sec Version: WS-C5500 Software, Version McpSW: 2.4(3) NmpSW: 2.4(3) Copyright (c) 1995-1997 by Cisco Systems Advertisement Version: 1
The following example displays the specified CDP neighbor (detail).

switch# show CDP neighbors interface gigabitethernet 4/1 detail ---------------------------------------Device ID:0 Entry address(es): IP Address: 0.0.0.0 Platform: DS-X9530-SF1-K9, Capabilities: Host Interface: GigabitEthernet4/1, Port ID (outgoing port): GigabitEthernet4/1 Holdtime: 144 sec Version: 1.1(0.144) Advertisement Version: 2 Duplex: full
21-17
Chapter 21 show cdp
Show Commands
The following example displays CDP traffic statistics for the management interface.
switch# show cdp traffic interface mgmt 0 ---------------------------------------Traffic statistics for mgmt0 Input Statistics: Total Packets: 1148 Valid CDP Packets: 1148 CDP v1 Packets: 1148 CDP v2 Packets: 0 Invalid CDP Packets: 0 Unsupported Version: 0 Checksum Errors: 0 Malformed Packets: 0 Output Statistics: Total Packets: 2329 CDP v1 Packets: 1164 CDP v2 Packets: 1165 Send Errors: 0
The following example displays CDP traffic statistics for the Gigabit Ethernet interface
switch# show cdp traffic interface gigabitethernet 4/1 ---------------------------------------Traffic statistics for GigabitEthernet4/1 Input Statistics: Total Packets: 674 Valid CDP Packets: 674 CDP v1 Packets: 0 CDP v2 Packets: 674 Invalid CDP Packets: 0 Unsupported Version: 0 Checksum Errors: 0 Malformed Packets: 0 Output Statistics: Total Packets: 674 CDP v1 Packets: 0 CDP v2 Packets: 674 Send Errors: 0
21-18
Chapter 21
Show Commands show cfs
show cfs
To display Cisco Fabric Services (CFS) information, use the show cfs command. show cfs {application [name app-name] | lock [name app-name [vsan vsan-id]] | merge status name app-name [vsan vsan-id] | peers [name app-name [vsan vsan-id]] | status}
Syntax Description
application name app-name lock vsan vsan-id merge status peers status
Displays locally registered applications. Specifies a local application information by name. Maximum length is 64 characters. Displays the state of application logical or physical locks. Specifies a VSAN ID. The range is 1 to 4093. Displays CFS merge information. Displays logical or physical CFS peers. Displays if CFS distribution is enabled or disabled. Enabled is the default configuration.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b) 2.1(1a)
Modification This command was introduced. Added status keyword.
Usage Guidelines
None.
Examples
The following example shows how to display CFS physical peer information for all applications.
switch# show cfs peers Physical Fabric -------------------------------------------------Switch WWN IP Address -------------------------------------------------20:00:00:05:30:00:61:de 172.22.46.223 [Local] 20:00:00:0d:ec:08:66:c0 172.22.46.233 20:00:00:05:30:00:f1:e2 172.22.46.225 20:00:00:05:30:00:eb:46 172.22.46.222 20:00:00:05:30:00:cb:56 172.22.46.224 20:00:00:05:30:00:5b:5e 172.22.46.182 20:00:00:05:30:00:34:9e 172.22.46.220 Total number of entries = 7
21-19
Chapter 21 show cfs
Show Commands
The following example shows how to display CFS information for all applications on the switch.
switch# show cfs application ------------------------------------------Application Enabled Scope ------------------------------------------ivr Yes Physical ntp No Physical role No Physical vsan No Physical radius No Physical tacacs No Physical syslogd No Physical callhome No Physical device-alias Yes Physical port-security No Logical Total number of entries = 10
The following example shows how to display CFS information for the device alias application.
switch# show cfs application name device-alias Enabled Timeout Merge Capable Scope : : : : Yes 5s Yes Physical
The following example shows how to display CFS merge operation information for the device alias application.
switch# show cfs merge status device-alias Physical Merge Status: Success Local Fabric --------------------------------------------------------Switch WWN IP Address --------------------------------------------------------20:00:00:05:30:00:34:9e 172.22.46.220 [Merge Master] 20:00:00:05:30:00:5b:5e 172.22.46.182 20:00:00:05:30:00:61:de 172.22.46.223 20:00:00:05:30:00:cb:56 172.22.46.224 20:00:00:05:30:00:eb:46 172.22.46.222 20:00:00:05:30:00:f1:e2 172.22.46.225
The following example shows whether or not CFS distribution is enabled.

switch# show cfs status Fabric distribution Enabled switch#
To enable CFS distribution, use the cfs distribute command.
21-20
Chapter 21
Show Commands show cimserver
show cimserver
To display the Common Information Models (CIM) configurations and settings, use the show cimserver command. show cimserver [certificateName | HttpsStatus | HttpStatus | status]
Syntax Description
certificateName HttpsStatus HttpStatus status
Displays the installed Secure Socket Layer (SSL) certificate. Displays the HTTP (non-secure) protocol settings for the CIM server. Displays the HTTPS (secure) protocol for the CIM server. Displays the CIM server status
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays CIM server certificate files.

switch# show cimserver certificateName cimserver certificate file name is servcert.pem
The following example displays the CIM server configuration.

switch# show cimserver cimserver is enabled cimserver Http is not enabled cimserver Https is enabled cimserver certificate file name is servcert.pem
The following example displays the CIM server HTTPS status.

switch# show cimserver httpsstatus cimserver Https is enabled
The following example displays the CIM server HTTP status.

switch# show cimserver httpstatus cimserver Http is not enabled
21-21
Chapter 21 show clock
Show Commands
show clock
To display the system date and time and verify the time zone configuration, use the show clock command. show clock
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the system date, time, and time zone configuration.
switch# show clock Fri Mar 14 01:31:48 UTC 2003
21-22
Chapter 21
Show Commands show cores
show cores
To display all the cores presently available for upload from active sup, use the show cores command. show cores
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
In the following example, an FSPF core was generated on the active supervisor (slot 5), an FCC core on the standby supervisor (slot 6) and acltcam and fib on module (slot 8).
switch# show cores Module-num ---------5 6 8 8 Process-name -----------fspf fcc acltcam fib PID --1524 919 285 283 Core-create-time ---------------Jan 9 03:11 Jan 9 03:09 Jan 9 03:09 Jan 9 03:08
21-23
Chapter 21 show crypto global domain ipsec
Show Commands
show crypto global domain ipsec

To display global IPsec crypto map set information, use the show crypto global domain ipsec command. show crypto global domain ipsec [interface gigabitethernet slot/port | security-association lifetime]
Syntax Description
interface gigabitethernet slot/port security-association lifetime
Displays crypto IPsec domain information for the specified Gigabit Ethernet interface slot and port. Displays crypto IPsec domain security association lifetime parameters.
Defaults
Displays IPsec global statistics.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to display crypto global domain IPsec statistics.
switch# show crypto global domain ipsec IPSec global statistics: Number of crypto map sets: 2
The following example shows how to display crypto global domain IPsec statistics for an interface.
switch# show crypto global domain ipsec interface gigabitethernet 1/2 IPSec interface statistics: IKE transaction stats: 0 num Inbound SA stats: 0 num, 512 max Outbound SA stats: 0 num, 512 max
The following example shows how to display crypto global domain IPsec security association lifetime parameters.
switch# show crypto global domain ipsec security-association lifetime Security Association Lifetime: 4500 megabytes/3600 seconds
21-24
Chapter 21
Show Commands show crypto global domain ipsec
Related Commands Command Description
crypto global domain ipsec Configures global attributes for IPsec. security-association lifetime crypto ipsec enable Enables IPsec.
21-25
Chapter 21 show crypto ike domain ipsec
Show Commands
show crypto ike domain ipsec

To display IKE protocol information, use the show crypto ike domain ipsec command. show crypto ike domain ipsec [initiator [address ip-address] | keepalive | key [address ip-address] | policy [policy-number] | sa]
Syntax Description
initiator address ip-address keepalive key policy [policy-number] sa
Displays initiator configuration information. Specifies the initiator peer IP address. Displays keepalive for the IKE protocol in seconds Displays pre-shared authentication keys. Displays IKE configuration policies for IPsec. The range is 1 to 255. Displays IKE Security Associations for IPsec.
Defaults
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to display IKE keepalive value configuration information.
switch# show crypto ike domain ipsec keepalive keepalive 3600
Related Commands
21-26
Chapter 21
Show Commands show crypto map domain ipsec
show crypto map domain ipsec

To map configuration information for IPsec, use the show crypto map domain ipsec command. show crypto map domain ipsec [interface gigabitethernet slot/port | tag tag-name]
Syntax Description
interface gigabitethernet slot/port tag tag-name
Displays IPsec map information for a specific Gigabit Ethernet interface. Displays IPsec map information for a specific tag name. The maximum length is 63 characters.
Defaults
Displays all IPsec map information.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to display IPsec crypto map information.
switch# show crypto map domain ipsec Crypto Map "cm10" 1 ipsec Peer = 10.10.10.4 IP ACL = aclmds10 permit ip 10.10.10.1 255.255.255.255 10.10.10.4 255.255.255.255 Transform-sets: 3des-md5, 3des-sha, des-md5, des-sha, Security Association Lifetime: 450 gigabytes/3600 seconds PFS (Y/N): N Crypto Map "cm10" 2 ipsec Peer = Auto Peer IP ACL = acl10 permit ip 10.10.10.0 255.255.255.0 10.10.10.0 255.255.255.0 Transform-sets: 3des-md5, 3des-sha, des-md5, des-sha, Security Association Lifetime: 450 gigabytes/3600 seconds PFS (Y/N): N Crypto Map "cm11" 1 ipsec Peer = 10.10.11.2 IP ACL = aclany permit ip any any Transform-sets: 3des-md5, 3des-sha, des-md5, des-sha, Security Association Lifetime: 450 gigabytes/3600 seconds PFS (Y/N): N
21-27
Chapter 21 show crypto map domain ipsec
Show Commands
Crypto Map "cm50" 1 ipsec Peer = 10.10.50.2 IP ACL = aclany permit ip any any Transform-sets: 3des-md5, Security Association Lifetime: 450 gigabytes/3600 seconds PFS (Y/N): N Interface using crypto map set cm50: GigabitEthernet1/2.1 Crypto Map "cm51" 1 ipsec Peer = 10.10.51.2 IP ACL = aclany permit ip any any Transform-sets: 3des-md5, Security Association Lifetime: 450 gigabytes/3600 seconds PFS (Y/N): N Interface using crypto map set cm51: GigabitEthernet1/2.2 Crypto Map "cm60" 1 ipsec Peer = 10.10.60.2 IP ACL = acl60 permit ip 10.10.60.0 255.255.255.0 10.10.60.0 255.255.255.0 Transform-sets: 3des-md5, Security Association Lifetime: 450 gigabytes/3600 seconds PFS (Y/N): N Interface using crypto map set cm60: GigabitEthernet1/2 Crypto Map "cm100" 1 ipsec Peer = 10.10.100.221 IP ACL = aclmds100 permit ip 10.10.100.231 255.255.255.255 10.10.100.221 255.255.255.255 Transform-sets: 3des-md5, 3des-sha, des-md5, des-sha, Security Association Lifetime: 450 gigabytes/3600 seconds PFS (Y/N): N Crypto Map "cm100" 2 ipsec Peer = Auto Peer IP ACL = acl100 permit ip 10.10.100.0 255.255.255.0 10.10.100.0 255.255.255.0 Transform-sets: 3des-md5, 3des-sha, des-md5, des-sha, Security Association Lifetime: 450 gigabytes/3600 seconds PFS (Y/N): N
Related Commands
Command crypto ipsec enable
Description Enables IPsec.
crypto map domain ipsec Enters IPsec map configuration mode.
21-28
Chapter 21
Show Commands show crypto sad domain ipsec
show crypto sad domain ipsec

To display IPsec security association database information, use the show crypto sad domain ipsec command. show crypto sad domain ipsec [interface gigabitethernet slot/port [{inbound | outbound} sa-index index]]
Syntax Description
interface gigabitethernet slot/port inbound outbound sa-index index
Displays IPsec security association information for a specific Gigabit Ethernet interface. Specifies the inbound association. Specifies the outbound association. Specifies the security association index. The range is 0 to 2147483647.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to display IPsec security association information.
switch# show crypto sad domain ipsec interface: GigabitEthernet4/1 Crypto map tag: cm10, local addr. 10.10.10.1 protected network: local ident (addr/mask): (10.10.10.0/255.255.255.0) remote ident (addr/mask): (10.10.10.4/255.255.255.255) current_peer: 10.10.10.4 local crypto endpt.: 10.10.10.1, remote crypto endpt.: 10.10.10.4 mode: tunnel, crypto algo: esp-3des, auth algo: esp-md5-hmac current outbound spi: 0x30e000f (51249167), index: 0 lifetimes in seconds:: 120 lifetimes in bytes:: 423624704 current inbound spi: 0x30e0000 (51249152), index: 0 lifetimes in seconds:: 120 lifetimes in bytes:: 423624704
21-29
Chapter 21 show crypto sad domain ipsec
Show Commands
Related Commands Command crypto ipsec enable Description Enables IPsec.
21-30
Chapter 21
Show Commands show crypto spd domain ipsec
show crypto spd domain ipsec

To display the security policy database (SPD), use the show crypto spd domain ipsec command. show crypto spd domain ipsec [interface gigabitethernet slot/port [policy number]]
Syntax Description
interface gigabitethernet slot/port policy number
Displays SPD information for a specific Gigabit Ethernet interface. Specifies a SPD policy number.
Defaults
Displays all SPD information.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to display the SPD.

switch# show crypto spd domain ipsec Policy Database for interface: GigabitEthernet1/1, direction: Both # 0: deny udp any port eq 500 any # 1: deny udp any any port eq 500 # 2: permit ip any any # 63: deny ip any any Policy Database for interface: GigabitEthernet1/2, direction: Both # 0: deny udp any port eq 500 any # 1: deny udp any any port eq 500 # 3: permit ip 10.10.50.1 255.255.255.255 10.10.50.2 255.255.255.255 # 4: permit ip 10.10.51.1 255.255.255.255 10.10.51.2 255.255.255.255 # 63: deny ip any any
Related Commands
Command crypto ipsec enable
Description Enables IPsec.
21-31
Chapter 21 show crypto transform-set domain ipsec
Show Commands
show crypto transform-set domain ipsec

To display transform set information for IPsec, use the show crypto transform-set domain ipsec command. show crypto transform-set domain ipsec [set-name]
Syntax Description
set-name
Specifies the transform set name. Maximum length is 63 characters.
Defaults
Displays information for all transform sets.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to display information for all IPsec transform sets.
switch# show crypto transform-set domain ipsec Transform set: ipsec_default_transform_set {esp-aes-256-ctr esp-aes-xcbc-mac} will negotiate {tunnel}
Related Commands
Command crypto ipsec enable crypto transform-set domain ipsec
Description Enables IPsec. Configures IPsec transform set information.
21-32
Chapter 21
Show Commands show debug
show debug
To display the debug commands configured on the switch, use the show debug command in EXEC mode. show debug all [aaa | acl | arbiter | ascii-cfg | bootvar | callhome | capability | cdp | v | cimserver | confcheck | core | device-alias | dstats | epp | ethport | exceptionlog | fabric_start_cfg_mgr | fc-tunnel | fc2 | fc2d | fcc | fcdomain | fcfwd | fcns | fcs | fdmi | flogi | fs-daemon | fspf | fvp | idehsd | ilc_helper | ipacl | ipconf | ipfc | kadb | kipfc | klm-scsi-target | license | logfile | mcast | mip | module | ntp | platform | port | port-channel | qos | radius | rdl | redundancy | rib | rlir | rscn | scsi-flow | scsi-target | security | sensor | snmp | span | system | SystemHealth | tcap | tlport | ttyd | vni | vp | vrrp | vsan | vshd | wwn | xbar | xbc | zone]
Syntax Description
aaa acl arbiter ascii-cfg bootvar callhome capability cdp cfs cimserver confcheck core device-alias dstats epp ethport exceptionlog fabric_start_cfg_mgr fc-tunnel fc2 fc2d fcc fcdomain fcfwd fcns fcs fdmi flogi fs-daemon fspf
Displays debugging flags of 301. Displays debug flags of ACL Manager. Displays Arbiter debugging flags. Displays all debugging flags of ascii-cfg. Displays bootvar debugging flags. Displays debugging flags of Callhome. Displays all debugging flags of capability. Displays CDP debug flags. Displays CFS debug flags. Displays debugging flags for CIM. Displays all debugging flags of confcheck. Displays debugging flags for feature manager. Displays debugging flags of Device Alias Distribution Service. Displays debugging flags for delta statistics. Displays debugging flags of EPP. Displays debugging flags of Ethernet port. Displays all debugging flags of Exception Logger. Displays debugging flags for fabric startup configuration manager. Displays all debugging flags of mpls_tunnel. Displays all debug elements of FC2. Displays debugging flags of FC2D. Displays all debugging flags of FCC. Displays internal debugging flags of fcdomain. Displays all debug elements of FCFWD. Displays name server debug flags. Displays debug flags of Fabric Config Server. Displays all debugging flags of FDMI. Displays debugging flags of F port Server. Displays debugging flags for file server daemon. Displays all debugging flags of FSPF.
21-33
Chapter 21 show debug
Show Commands
fvp idehsd ilc_helper ipacl ipconf ipfc kadb kipfc klm-scsi-target license logfile mcast mip module ntp platform port port-channel qos radius rdl redundancy rib rlir rscn scsi-flow scsi-target security sensor snmp span system SystemHealth tcap tlport ttyd vni vp vrrp vsan vshd Displays all debugging flags of FVP Manager. Displays IDEHSD debugging flags. Displays ilc_helper debugging flags. Displays all debugging flags of ipacl. Displays IP configuration debugging flags. Displays all debugging flags of IPFC. Displays Kernel ADB debugging flags. Displays IPFC kernel debug flags. Displays debug elements of scsi-target driver. Displays debugging flags for Licensing. Display contents of the logfile. Displays all debug elements of mcast. Displays mip kernel debug flags. Displays all debugging flags of module. Displays the state of NTP debug settings. Displays all debugging flags of platform manager. Displays debugging flags of port. Displays all port-channel debugging flags. Displays QoS debug flags. Displays debugging flags of RADIUS. Displays RDL debug flags. Displays Redundancy drivers debugging flags. Displays all debugging flags of rib. Displays all debugging flags of RLIR. Displays all debugging flags of RSCN. Displays debugging flags of SCSI_FLOW. Displays debugging flags for SCSI target daemon. Displays debugging flags of security and accounting Displays all debugging flags of Sensor Manager. Displays all debugging flags of SNMP server. Displays debugging flags of SPAN. Displays all debugging flags of system. Displays all debugging flags of system health. Displays all debugging flags of Exception Logger. Displays TL Port debug flags. Displays all debugging flags of TTYD. Displays virtual network interface debugging flags. Displays all debugging flags of VP Manager. Displays the debugging flags of VRRP. Displays debugging flags of VSAN manager. Displays all debugging flags of VSHD.
21-34
Chapter 21
Show Commands show debug
wwn xbar xbc zone Displays all debugging flags of WWN Manager. Displays all debugging flags of XBAR. Displays all debugging flags of XBC. Displays zone server debug elements.
Defaults
Displays all debugging configured.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example shows all debug commands configured on the switch.
switch# show debug Show Debug all ILC helper: ILC_HELPER errors debugging is on SCSI Flow Manager: Error debugging is on switch#
The following example displays the debug messages in the specified debug log file.
switch# show debug logfile SampleFile 2004 Jun 28 00:14:17 snmpd[2463]: header_fspfLinkEntry : Sending GETNEXT request for fspfLsrTable for vsanIndex =0,fspfLsrDomainId = 0, fspfLsrType = 0 2004 Jun 28 00:14:17 snmpd[2463]: header_fspfLinkEntry : Sending GETNEXT request for fspfLsrTable for vsanIndex =0,fspfLsrDomainId = 0, fspfLsrType = 0 2004 Jun 28 00:14:17 snmpd[2463]: header_fspfLinkEntry : Recd rsp for GETNEXT fo r entry (vsanIndex=1,fspfLsrDomainId = 10, fspfLsrType=0, fspfLinkIndex = 1,fspf LinkNbrDomainId = 84, fspfLinkPortIndex = 67331,fspfLinkNbrPortIndex = 66064, fs pfLinkType = 1,fspfLinkCost = 500 2004 Jun 28 00:14:17 snmpd[2463]: header_fspfLinkEntry : Sending GETNEXT request for fspfLsrTable for vsanIndex =1,fspfLsrDomainId = 209, fspfLsrType = 0 2004 Jun 28 00:14:17 snmpd[2463]: header_fspfLinkEntry : Sending GETNEXT request for fspfLsrTable for vsanIndex =16777216,fspfLsrDomainId = 3506438144, fspfLsr Type = 0 2004 Jun 28 00:14:17 snmpd[2463]: header_fspfLinkEntry : Sending GETNEXT request for fspfLsrTable for vsanIndex =33554432,fspfLsrDomainId = 4009754624, fspfLsr Type = 16777216
21-35
Chapter 21 show device-alias
Show Commands
show device-alias
To display the device name information, use the show device-alias command. show device-alias {database [pending | pending-diff] | name device-name [pending] | pwwn pwwn-id [pending] | statistics | status]
Syntax Description
database pending pending-diff name device-name pwwn pwwn-id statistics status
Displays the entire device name database. Displays the pending device name database information. Displays the pending differences in the device name database information. Displays device name database information for a specific device name. Displays device name database information for a specific pWWN. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number. Displays device name database statistics. Displays device name database status.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
To make use of fcaliases as device names instead of using the cryptic device name, add only one member per fcalias.
Examples
The following example shows how to display the contents of the device alias database.
switch# show device-alias device-alias device-alias device-alias device-alias device-alias database name efg pwwn 21:00:00:20:37:9c:48:e5 name fred pwwn 10:00:00:00:c9:2d:5a:de name myalias pwwn 21:21:21:21:21:21:21:21 name test pwwn 21:00:00:20:37:6f:db:bb name test2 pwwn 21:00:00:20:37:a6:be:35
Total number of entries = 5
The following example shows how to display all global fcaliases and all VSAN dependent fcaliases.
switch# show device-alias name efg device-alias name efg pwwn 21:00:00:20:37:9c:48:e5
21-36
Chapter 21
Show Commands show device-alias
The following example shows how to display all global fcaliases and all VSAN dependent fcaliases.
switch# show device-alias statistics Device Alias Statistics =========================================== Lock requests sent: 1 Database update requests sent: 1 Unlock requests sent: 1 Lock requests received: 0 Database update requests received: 0 Unlock requests received: 0 Lock rejects sent: 0 Database update rejects sent: 0 Unlock rejects sent: 0 Lock rejects received: 0 Database update rejects received: 0 Unlock rejects received: 0 Merge requests received: 5 Merge request rejects sent: 0 Merge responses received: 0 Merge response rejects sent: 0 Activation requests received: 5 Activation request rejects sent: 0 Activation requests sent: 0 Activation request rejects received: 0 v_226# pwwn 21:00:00:20:37:6f:dc:0e
Related Commands
Command device-alias name device-alias database device-alias distribute
Description Configures device alias names. Configures device alias information. Enables device alias CFS distribution.
21-37
Chapter 21 show dpvm
Show Commands
show dpvm
To display dynamic port VSAN membership (DPVM) information, use the show dpvm command. show dpvm {database [active] | pending | pending-diff | ports [vsan vsan-id] | status}
Syntax Description
database active pending pending-diff ports vsan vsan-id status
Displays both the configured and active DPVM databases. Displays only the active DPVM database. Displays pending DPVM operations. Displays differences between the pending DPVM operations and the active DPVM database. Displays DPVM information for the ports. Specifies a VSAN ID. The range is from 0 to 4093. Displays DPVM status information.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to display DPVM database information.

switch# show dpvm database pwwn 00:00:00:00:00:00:00:01 vsan 1 pwwn 00:00:00:00:00:00:00:02 vsan 1 [Total 2 entries]
Related Commands
Command dpvm database
Description Configures the DPVM database.
21-38
Chapter 21
Show Commands show environment
show environment
To display all environment-related switch information (status of chassis clock, chassis fan modules, power supply modules, power supply redundancy mode and power usage summary, module temperature thresholds and alarm status, use the show environment command. show environment [clock | fan | power | temperature]
Syntax Description
clock fan power temperature
Displays status of chassis clock modules Displays status of chassis fan modules Displays status of power supply modules, power supply redundancy mode and power usage summary. Displays module temperature thresholds and alarm status of temperature sensors.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the status and alarm states of the clock, fan, power supply and temperature sensors.
switch# show environment switch-180# show env Clock: ---------------------------------------------------------Clock Model Hw Status ---------------------------------------------------------A DS-C9500-CL 0.0 ok/active B DS-C9500-CL 0.0 ok/standby
Fan: -----------------------------------------------------Fan Model Hw Status -----------------------------------------------------Chassis WS-9SLOT-FAN 0.0 ok PS-1 --ok PS-2 --ok
21-39
Chapter 21 show environment
Show Commands
Temperature: --------------------------------------------------------------Module Sensor MajorThresh MinorThres CurTemp Status (Celsius) (Celsius) (Celsius) --------------------------------------------------------------1 Outlet 75 60 38 ok 1 Intake 65 50 35 ok 5 5 6 6 9 9 Outlet Intake Outlet Intake Outlet Intake 75 65 75 65 75 65 60 50 60 50 60 50 36 36 40 33 28 40 ok ok ok ok ok ok
Power Supply: ----------------------------------------------------PS Model Power Power Status (Watts) (Amp @42V) ----------------------------------------------------1 DS-CAC-2500W 1153.32 27.46 ok 2 WS-CAC-2500W 1153.32 27.46 ok Mod Model Power Requested (Watts) ------220.08 220.08 220.08 220.08 Power Requested (Amp @42V) ---------5.24 5.24 5.24 5.24 Power Allocated (Watts) --------220.08 220.08 220.08 220.08 Power Allocated (Amp @42V) ---------5.24 5.24 5.24 5.24 Status
--- ------------------1 DS-X9016 5 DS-X9530-SF1-K9 6 DS-X9530-SF1-K9 9 DS-X9016
---------powered-up powered-up powered-up powered-up
Power Usage Summary: -------------------Power Supply redundancy mode: Total Power Capacity Power reserved for Supervisor(s)[-] Power reserved for Fan Module(s)[-] Power currently used by Modules[-]
non-redundant (combined) 2306.64 440.16 210.00 440.16 ------1216.32 ------W W W W
Total Power Available
Related Commands
Command show hardware
Description Displays all hardware components on a system.
21-40
Chapter 21
Show Commands show fabric-binding
show fabric-binding
To display configured fabric binding information, use the show fabric-binding command in EXEC mode. show fabric-binding {database [active] [vsan vsan-id] | efmd statistics [vsan vsan-id] | statistics [vsan vsan-id] | status [vsan vsan-id] | violations [last number]}
Syntax Description
database active vsan vsan-id efmd statistics statistics status violations last number
Displays configured database information. Displays the active database configuration information. Specifies the FICON-enabled VSAN ID. The range is 1 to 4093. Displays Exchange Fabric Membership Data (EFMD) statistics. Displays fabric binding statistics. Displays fabric binding status Displays violations in the fabric binding configuration. Specifies between 1 and 100 recent violations.
Defaults
None
Command Modes
EXEC mode
Command History
Usage Guidelines
None
Examples
The following example displays configured fabric binding database information.

switch# show fabric-binding database -------------------------------------------------Vsan Logging-in Switch WWN Domain-id -------------------------------------------------1 21:00:05:30:23:11:11:11 0x66(102) 1 21:00:05:30:23:1a:11:03 0x19(25) 1 20:00:00:05:30:00:2a:1e 0xea(234) 4 21:00:05:30:23:11:11:11 0x66(102) 4 21:00:05:30:23:1a:11:03 0x19(25) 61 21:00:05:30:23:1a:11:03 0x19(25) 61 21:00:05:30:23:11:11:11 0x66(102) [Total 7 entries]
21-41
Chapter 21 show fabric-binding
Show Commands
The following example displays active fabric binding information.
switch# show fabric-binding database active -------------------------------------------------Vsan Logging-in Switch WWN Domain-id -------------------------------------------------1 21:00:05:30:23:11:11:11 0x66(102) 1 21:00:05:30:23:1a:11:03 0x19(25) 1 20:00:00:05:30:00:2a:1e 0xea(234) 61 21:00:05:30:23:1a:11:03 0x19(25) 61 21:00:05:30:23:11:11:11 0x66(102) 61 20:00:00:05:30:00:2a:1e 0xef(239)
The following example displays active VSAN-specific fabric binding information.

switch# show fabric-binding database active vsan 61 -------------------------------------------------Vsan Logging-in Switch WWN Domain-id -------------------------------------------------61 21:00:05:30:23:1a:11:03 0x19(25) 61 21:00:05:30:23:11:11:11 0x66(102) 61 20:00:00:05:30:00:2a:1e 0xef(239) [Total 3 entries]
The following example displays configured VSAN-specific fabric binding information.

switch# show fabric-binding database vsan 4 -------------------------------------------------Vsan Logging-in Switch WWN Domain-id -------------------------------------------------4 21:00:05:30:23:11:11:11 0x66(102) 4 21:00:05:30:23:1a:11:03 0x19(25) [Total 2 entries]
The following example displays fabric binding statistics.

switch# show fabric-binding statistics Statistics For VSAN: 1 -----------------------Number of sWWN permit: 0 Number of sWWN deny : 0 Total Logins permitted : 0 Total Logins denied : 0 Statistics For VSAN: 4 -----------------------Number of sWWN permit: 0 Number of sWWN deny : 0 Total Logins permitted : 0 Total Logins denied : 0 Statistics For VSAN: 61 -----------------------Number of sWWN permit: 0 Number of sWWN deny : 0 Total Logins permitted : 0 Total Logins denied : 0 Statistics For VSAN: 345 -----------------------Number of sWWN permit: 0 Number of sWWN deny : 0 Total Logins permitted Total Logins denied : 0 : 0
21-42
Chapter 21
Show Commands show fabric-binding
Statistics For VSAN: 346 -----------------------Number of sWWN permit: 0 Number of sWWN deny : 0 Total Logins permitted : 0 Total Logins denied : 0 Statistics For VSAN: 347 -----------------------Number of sWWN permit: 0 Number of sWWN deny : 0 Total Logins permitted : 0 Total Logins denied : 0 Statistics For VSAN: 348 -----------------------Number of sWWN permit: 0 Number of sWWN deny : 0 Total Logins permitted : 0 Total Logins denied : 0 Statistics For VSAN: 789 -----------------------Number of sWWN permit: 0 Number of sWWN deny : 0 Total Logins permitted : 0 Total Logins denied : 0 Statistics For VSAN: 790 -----------------------Number of sWWN permit: 0 Number of sWWN deny : 0 Total Logins permitted Total Logins denied : 0 : 0
The following example displays fabric binding status for each VSAN.
switch# show fabric-binding status VSAN 1 :Activated database VSAN 4 :No Active database VSAN 61 :Activated database VSAN 345 :No Active database VSAN 346 :No Active database VSAN 347 :No Active database VSAN 348 :No Active database VSAN 789 :No Active database VSAN 790 :No Active database
The following example displays EFMD statistics.

switch# show fabric-binding efmd statistics EFMD Protocol Statistics for VSAN 1 ---------------------------------------Merge Requests -> Transmitted : 0 , Received Merge Accepts -> Transmitted : 0 , Received Merge Rejects -> Transmitted : 0 , Received Merge Busy -> Transmitted : 0 , Received Merge Errors -> Transmitted : 0 , Received
: : : : :
0 0 0 0 0
EFMD Protocol Statistics for VSAN 4 ---------------------------------------Merge Requests -> Transmitted : 0 , Received : 0
21-43
Chapter 21 show fabric-binding
Show Commands
Merge Merge Merge Merge Accepts Rejects Busy Errors -> -> -> -> Transmitted Transmitted Transmitted Transmitted : : : : 0 0 0 0 , , , , Received Received Received Received : : : : 0 0 0 0
EFMD Protocol Statistics for VSAN 61 ---------------------------------------Merge Requests -> Transmitted : 0 , Received Merge Accepts -> Transmitted : 0 , Received Merge Rejects -> Transmitted : 0 , Received Merge Busy -> Transmitted : 0 , Received Merge Errors -> Transmitted : 0 , Received
: : : : :
0 0 0 0 0
The following example displays EFMD statistics for a specified VSAN.

switch# show fabric-binding efmd statistics vsan 4 EFMD Protocol Statistics for VSAN 4 ---------------------------------------Merge Requests -> Transmitted : 0 , Received Merge Accepts -> Transmitted : 0 , Received Merge Rejects -> Transmitted : 0 , Received Merge Busy -> Transmitted : 0 , Received Merge Errors -> Transmitted : 0 , Received
: : : : :
0 0 0 0 0
The following example displays fabric binding violations.

switch# show fabric-binding violations ------------------------------------------------------------------------------VSAN Switch WWN [domain] Last-Time [Repeat count] Reason ------------------------------------------------------------------------------3 20:00:00:05:30:00:4a:1e [*] Nov 25 05:44:58 2003 [2] sWWN not found 3 20:00:00:05:30:00:4a:1e [0xeb] Nov 25 05:46:14 2003 [2] Domain mismatch 4 20:00:00:05:30:00:4a:1e [*] Nov 25 05:46:25 2003 [1] Database mismatch
21-44
Chapter 21
Show Commands show fc-tunnel
show fc-tunnel
To display configured Fibre Channel tunnel information, use the show fc-tunnel command. show fc-tunnel [explicit-path [name] | tunnel-id-map]
Syntax Description
explicit-path name tunnel-id-map
Displays all configured explicit paths. Specifies the explicit path name. Maximum length is 16 characters. Displays the mapping information for the outgoing interface.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Multiple tunnel IDs can terminate at the same interface.
Examples
The following example displays the FC tunnel status

switch# show fc-tunnel fc-tunnel is enabled
The following example displays the FC tunnel egress mapping information.

switch# show fc-tunnel tunnel-id-map tunnel id egress interface 150 fc3/1 100 fc3/1
The following example displays explicit mapping information of the FC tunnel.

switch# show fc-tunnel explicit-path Explicit path name: Alternate1 10.20.1.2 loose 10.20.1.3 strict Explicit path name: User2 10.20.50.1 strict 10.20.50.4 loose
21-45
Chapter 21 show fc2
Show Commands
show fc2
To display FC2 information, use the show fc2 command. show fc2 {bind | classf | exchange | exchresp | flogi | nport | plogi | plogi_pwwn | port [brief] | socket | sockexch | socknotify | socknport | vsan}
Syntax Description
bind classf exchange exchresp flogi nport plogi plogi_pwwn port [brief] socket sockexch socknotify socknport vsan
Displays FC2 socket bindings. Displays FC2 classf sessions. Displays FC2 active exchanges. Displays FC2 active responder exchanges. Displays FC2 FLOGI table. Displays FC2 local N ports. Displays FC2 PLOGI sessions. Displays FC2 PLOGI pWWN entries. Displays FC2 physical port table. Displays FC2 active sockets. Displays FC2 active exchanges for each socket. Displays FC2 local N port PLOGI/LOGO notifications for each socket. Displays FC2 local nports per each socket. Displays FC2 VSAN table.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
21-46
Chapter 21
Show Commands show fc2
Examples The following example displays FC2 active socket information.
switch# show fc2 socket SOCKET REFCNT PROTOCOL b2a64b20 2 b2a647e0 3 b2a644a0 3 b2a64160 3 b294b180 3 b294ae40 3 b294a7c0 3 b294a480 2 b294a140 3 b278bb20 3 b278b4a0 3 b278b160 3 b278ae20 3 b1435b00 3 b1434e00 3 b1434ac0 3 b1434780 3 b1434440 2 b1434100 3 b22e2420 2 ... PID RCVBUF RMEM_USED 1421 65535 1418 262142 1417 65535 1417 262142 1411 65535 1411 65535 1410 65535 1410 65535 1409 262142 1409 262142 1407 65535 1407 256000 1407 65535 1408 65535 1406 65535 1406 131072 1406 65535 1405 131072 1405 262142 1372 65535 QLEN 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 NOTSK 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 b1434440 0 0
0 0 0 0 0 0 0 7 0 0 0 0 0 0 0 0 0 0 0 0
The following example displays FC2 socket binding information.

switch# show fc2 bind SOCKET RULE SINDEX b23ba0c0 16 6081000 b2a647e0 7 ffffffff b294b180 7 ffffffff b294ae40 7 ffffffff b294a7c0 7 ffffffff ... VSAN 1 65535 65535 65535 65535 D_ID 0 fffffd fffffd fffc00 fffffd MASK TYPE SUBTYPE M_VALUES 0 0 00:00:00 00:00:00:00:00:00:00:00 ffffff 22 03:01:00 14:15:16:00:00:00:00:00 ffffff 1 02:01:00 61:62:00:00:00:00:00:00 ffff00 22 01:01:00 1b:00:00:00:00:00:00:00 ffffff 1 01:01:00 10:00:00:00:00:00:00:00
The following example displays FC2 local N port information.

switch# show fc2 nport REF VSAN D_ID MASK FL ST EE 3-SO IC RC RS CS EE 1 65535 fffffd ffffff 3 0 008 8000 0000 0000 2112 0064 0000 6 65535 fffc00 ffff00 18b 0 008 8000 0000 0000 2112 0064 0000 2 65535 fffffa ffffff 3 0 008 8000 0000 0000 2112 0064 0000 1 65535 fffffc ffffff 3 0 008 8000 0000 0000 2112 0064 0000 ... IFINDEX CF TC 2-SO IC RC RS CS
ffffffff c800 0128 8000 0000 0000 2112 0064 0 ffffffff c800 0128 8000 0000 0000 2112 0064 0 ffffffff c800 0128 8000 0000 0000 2112 0064 0 ffffffff c800 0128 8000 0000 0000 2112 0064 0
The following example displays FC2 PLOGI session information.

switch# show fc2 plogi HIX ADDRESS VSAN S_ID D_ID IFINDEX FL STATE CF TC 2-SO IC RC RS CS EE 3-SO IC RC RS CS EE EECNT TCCNT 2CNT 3CNT REFCNT 2157 af364064 1 fffc6c 123400 ffffffff 0000 0 0000 0001 8000 0000 2000 0256 0001 0001 8000 0000 2000 0256 0001 0000 0 0 0 0 1
21-47
Chapter 21 show fc2
Show Commands
The following example displays FC2 physical port information.
switch# show fc2 port IX ST MODE EMUL TXPKTS TXDROP F-SO RC RS CS EE 2-SO RS 0 D 1 0 0 0 8000 0000 2112 0001 0001 8000 0256 1 D 1 0 0 0 8000 0000 2112 0001 0001 8000 0256 2 D 1 0 0 0 8000 0000 2112 0001 0001 8000 0256 3 D 1 0 0 0 8000 0000 2112 0001 0001 8000 0256 4 D 1 0 0 0 8000 0000 2112 0001 0001 8000 0256 ... TXERR 3-SO RS 0 8000 0256 0 8000 0256 0 8000 0256 0 8000 0256 0 8000 0256 RXPKTS 0 0 0 0 0 RXDROP 0 0 0 0 0 R_A_TOV 10000 10000 10000 10000 10000 E_D_TOV 2000 2000 2000 2000 2000
The following example displays FC2 local N port PLOGI notifications for each socket.
switch# show fc2 socknotify SOCKET ADDRESS REF VSAN D_ID MASK b2a64160 b27f01e4 6 65535 fffc00 ffff00 b294a7c0 b27f01e4 6 65535 fffc00 ffff00 af8a3a60 b27f01e4 6 65535 fffc00 ffff00 FL 18b 18b 18b ST IFINDEX 0 ffffffff 0 ffffffff 0 ffffffff
The following example displays FC2 local N ports for each socket.
switch# show fc2 socknport SOCKET ADDRESS REF VSAN b2a64160 b27f01e4 6 65535 b294b180 b27f0294 1 65535 b294a7c0 b27f01e4 6 65535 b278ae20 b27f0134 2 65535 b1434e00 b27f0134 2 65535 b1434780 b27f0084 1 65535 af8a3a60 b27f01e4 6 65535 D_ID fffc00 fffffd fffc00 fffffa fffffa fffffc fffc00 MASK ffff00 ffffff ffff00 ffffff ffffff ffffff ffff00 FL 18b 3 18b 3 3 3 18b ST 0 0 0 0 0 0 0 IFINDEX ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff
The following example displays FC2 VSAN table.

switch# show fc2 vsan VSAN X_ID E_D_TOV 1 4 2000 2 1 2000 3 1 2000 4 1 2000 5 1 2000 6 1 2000 7 1 2000 8 1 2000 9 1 2000 10 1 2000 11 1 2000 12 1 2000 13 1 2000 14 1 2000 15 1 2000 16 1 2000 17 1 2000 18 1 2000 .... R_A_TOV 10000 10000 10000 10000 10000 10000 10000 10000 10000 10000 10000 10000 10000 10000 10000 10000 10000 10000 WWN 20:01:00:05:30:00:58:1f 20:02:00:05:30:00:58:1f 20:03:00:05:30:00:58:1f 20:04:00:05:30:00:58:1f 20:05:00:05:30:00:58:1f 20:06:00:05:30:00:58:1f 20:07:00:05:30:00:58:1f 20:08:00:05:30:00:58:1f 20:09:00:05:30:00:58:1f 20:0a:00:05:30:00:58:1f 20:0b:00:05:30:00:58:1f 20:0c:00:05:30:00:58:1f 20:0d:00:05:30:00:58:1f 20:0e:00:05:30:00:58:1f 20:0f:00:05:30:00:58:1f 20:10:00:05:30:00:58:1f 20:11:00:05:30:00:58:1f 20:12:00:05:30:00:58:1f
21-48
Chapter 21
Show Commands show fcalias
show fcalias
To display the member name information in a Fibre Channel alias (fcalias), use the show fcalias command. show fcalias [name fcalias-name] [pending] [vsan vsan-id]
Syntax Description
name fcalias-name pending vsan vsan-id
Displays fcalias information for a specific name. The maximum length is 64. Displays pending fcalias information. Displays fcalias information for a VSAN. The range is 1 to 4093.
Defaults
Displays a list of all global fcaliases and all VSAN dependent fcaliases.
Command Modes
EXEC mode.
Command History
Release 1.0(2) 2.0(1b)
Modification This command was introduced. Added the pending keyword.
Usage Guidelines
To make use of fcaliases as device names instead of using the cryptic device name, add only one member per fcalias.
Examples
The following example displays fcalias configuration information.

switch# show fcalias vsan 1 fcalias name Alias2 vsan 1 fcalias name Alias1 vsan 1 pwwn 21:00:00:20:37:6f:db:dd pwwn 21:00:00:20:37:9c:48:e5
Related Commands
Command fcalias name
Description Configures fcalias names.
21-49
Chapter 21 show fcanalyzer
Show Commands
show fcanalyzer
To display the list of hosts configured for a remote capture, use the show fcanalyzer command. show fcanalyzer
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The DEFAULT keyword shown with an ActiveClient entry specifies that the default port is used in attempting the connection to the client.
Examples
Displays Configured Hosts

switch# show fcanalyzer PassiveClient = 10.21.0.3 PassiveClient = 10.21.0.3 ActiveClient = 10.21.0.3, DEFAULT
21-50
Chapter 21
Show Commands show fcc
show fcc
To view FCC settings, use the show fcc commands. show fcc [statistics interface {fc slot/port | fcip fcip-id | iscsi slot/port}]
Syntax Description
statistics interface fc slot/port fcip fcip-id iscsi slot/port
Displays FCC statistics for a specified interface. Specifies a Fibre Channel interface. Specifies an FCIP interface. The range is 1 to 255. Specifies an iSCSI interface.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
Displays configured FCC information

switch# show fcc fcc is disabled fcc is applied to frames with priority up to 4
21-51
Chapter 21 show fcdomain
Show Commands
show fcdomain
To display the Fibre Channel domain (fcdomain) information, use the show fcdomain command. show fcdomain [address-allocation [cache] | allowed | domain-list | fcid persistent [unused] | statistics [interface {fc slot/port | fcip fcip-id | iscsi slot/port}]] [vsan vsan-id]
Syntax Description
address-allocation cache
Displays statistics for the fcid allocation The cache is used by the principle switch to reassign the FCIDs for a device (disk or host) that exited and reentered the fabric. In the cache content, VSAN refers to the VSAN that contains the device, WWN refers to the device that owned the FCIDs, and mask refers to a single or entire area of FCIDs. Displays a list of allowed domain IDs. Displays list of domain ids granted by the principal sw Displays persistent FCIDs (across reboot) Displays the statistics of fcdomain Specifies a Fibre Channel interface. Specifies an FCIP interface. The range is 1 to 255. Specifies an iSCSI interface. Specifies a VSAN ID. The range is 1 to 4093).
allowed domain-list fcid persistent statistics interface fc slot/port fcip fcip-id iscsi slot/port vsan vsan-id
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.0(2) 2.1(1a)
Modification This command was introduced. The domain-list display was modified to include a virtual IVR description.
Usage Guidelines
Issuing the show fcdomain with no arguments displays all VSANs. The VSANs should be active or you will get an error.
21-52
Chapter 21
Show Commands show fcdomain
Examples The following example displays the fcdomain information for VSAN 1.
switch# show fcdomain vsan 1 The local switch is a Subordinated Switch. Local switch run time information: State: Stable Local switch WWN: 20:01:00:05:30:00:51:1f Running fabric name: 10:00:00:60:69:22:32:91 Running priority: 128 Current domain ID: 0x64(100) verify domain id Local switch configuration information: State: Enabled Auto-reconfiguration: Disabled Contiguous-allocation: Disabled Configured fabric name: 41:6e:64:69:61:6d:6f:21 Configured priority: 128 Configured domain ID: 0x64(100) (preferred) Principal switch run time information: Running priority: 2 Interface ---------------fc2/1 fc2/2 fc2/7 ---------------Role ------------Downstream Downstream Upstream ------------RCF-reject -----------Disabled Disabled Disabled ------------
The following example displays the fcdomain domain list information for VSAN 76.
switch# show fcdomain domain-list vsan 76 Number of domains: 3 Domain ID WWN ------------------------------0xc8(200) 20:01:00:05:30:00:47:df [Principal] 0x63(99) 20:01:00:0d:ec:08:60:c1 [Local] 0x61(97) 50:00:53:0f:ff:f0:10:06 [Virtual (IVR)]
Table 21-1 describes the significant fields shown in the show fcdomain domain-list display.
Table 21-1 show fcdomain Field Descriptions
Field Domain ID WWN Principal Local
Description Lists the domain IDs corresponding to the WWN. Indicates the WWN of the switch (physical or virtual) that requested the corresponding domain ID. Indicates which row of the display lists the WWN and domain ID of the principal switch in the VSAN. Indicates which row of the display lists the WWN and domain ID of the local switch (the switch where you entered the show fcdomain domain-list command). Indicates which row of the display lists the WWN of the virtual switch used by the Inter-VSAN Routing (IVR) manager to obtain the domain ID.
Virtual (IVR)
21-53
Chapter 21 show fcdomain
Show Commands
The following example displays the allowed domain ID lists
switch# show fcdomain allowed vsan 1 Assigned or unallowed domain IDs: 1-96,100,111-239. [Interoperability Mode 1] allowed domain IDs: 97-127. [User] configured allowed domain IDs: 50-110.
21-54
Chapter 21
Show Commands show fcdroplatency
show fcdroplatency
To display the configured Fibre Channel latency parameters, use the show fcdroplatency command. show fcdroplatency [network | switch]
Syntax Description
network switch
Network latency in milliseconds. Switch latency in milliseconds.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the configured Fibre Channel latency parameters.
switch# show fcdroplatency switch latency value:4000 milliseconds network latency value:5000 milliseconds
21-55
Chapter 21 show fcflow stats
Show Commands
show fcflow stats

To display the configured Fibre Channel flow (fcflow) information, use the show fcflow stats command. show fcflow stats [aggregated | usage] module slot [index flow-index]
Syntax Description
aggregated usage module slot index flow-index
Displays aggregated fcflow statistics. Displays flow index usage Displays fcflow statistics for a module in the specified slot. Specifies a fcflow index.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays aggregated fcflow details for the specified module.
switch# show fcflow stats aggregated module 2 Idx VSAN # frames # bytes ---- ---- -------- ------0000 4 387,653 674,235,875 0001 6 34,402 2,896,628
The following example displays fcflow details for the specified module.
switch# show fcflow stats module 2 Idx VSAN D ID S ID mask ---- ---- ----------- ----------- ----0000 4 032.001.002 007.081.012 ff.ff.ff 0001 6 004.002.001 019.002.004 ff.00.00 # frames # bytes -------- ------387,653 674,235,875 34,402 2,896,628
The following example displays fcflow index usage for the specified module.
switch# show fcflow stats usage module 2 2 flows configured configured flow : 3,7
21-56
Chapter 21
Show Commands show fcfwd
show fcfwd
To display the configured fcfwd tables and statistics, use the show fcfwd command. show fcfwd {idxmap [interface-toport | port-to-interface | statistics] | pcmap [interface] | sfib [multicast | statistics | unicast] | spanmap [rx | tx]}
Syntax Description
idxmap interface-to-port port-to-interface statistics pcmap interface sfib multicast statistics unicast spanmap rx tx
Displays FC forward index tables. Displays interface index to port index table. Displays port index to interface index table. Displays index table statistics. Displays FC forward PortChannel table. Displays PortChannel table for an interface. Displays software forwarding tables. Displays multicast software forwarding tables. Displays software forwarding statistics. Displays unicast software forwarding tables. Displays SPAN map tables. Displays SPAN map table in ingress -rx direction. Displays SPAN map table in egress -tx direction.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays fcfwd SPAN map receive information.

switch# show fcfwd spanmap rx SPAN source information: size [c8] dir source vsan bit
drop_thresh destination
21-57
Chapter 21 show fcid-allocation
Show Commands
show fcid-allocation
Use the show fcid allocation command to display the Fibre show fcid-allocation area company-id [company-id]
Channel area list of company IDs.
Syntax Description
area company-id company-id
Selects the auto area list of company IDs. Selects company ID list. Selects the individual company ID (also know as Organizational Unit Identifier, or OUI) to display.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0
Modification New command
Examples
The following example shows the Fibre Channel area company list of company IDs.
switch# show fcid-allocation area company-id Fcid area allocation company id info: 00:50:2E 00:50:8B 00:60:B0 00:A0:B8 00:E0:69 00:E0:8B 00:32:23 +
Total company ids: 7 + - Additional user configured company ids. * - Explicitly deleted company ids from default list. switch#
Table 21-2 describes the significant fields shown in the display.

Table 21-2 show fcid-allocation area company Field Descriptions
Field +
Description Indicates a company ID added to the default list. Indicates a company ID deleted from the default list.
21-58
Chapter 21
Show Commands show fcip
show fcip
To display FCIP profile information, use the show fcip command. show fcip {host-map fcip-id | profile [profile-id | all] | summary | target-map fcip-id}
Syntax Description
host-map fcip-id profile profile-id all summary target-map fcip-id
Displays the information for a map. The range is 1 to 255. Displays the information for the specified profile. Specifies the profile ID. The range is 1 to 255. Specifies all profile IDs. Displays summary information. Displays the information for the specified profile. The range is 1 to 255.
Defaults
None.
Command Modes
EXEC
Command History
Release 1.1(1) 2.0(1b)
Modification This command was introduced. Added the host-map, summary, and target-map keywords.
Usage Guidelines
None.
Examples
The following example displays all FCIP profiles.

switch# show fcip profile all ---------------------------------------------------ProfileId Ipaddr TcpPort ---------------------------------------------------1 41.1.1.2 3225 2 10.10.100.154 3225 3 43.1.1.2 3225 4 44.1.1.100 3225 6 46.1.1.2 3225 7 47.1.1.2 3225
21-59
Chapter 21 show fcip
Show Commands
The following example displays information for a specified FCIP profile.
switch# show fcip profile 7 FCIP Profile 7 Internet Address is 47.1.1.2 (interface GigabitEthernet4/7) Listen Port is 3225 TCP parameters SACK is disabled PMTU discovery is enabled, reset timeout is 3600 sec Keep alive is 60 sec Minimum retransmission timeout is 300 ms Maximum number of re-transmissions is 4 Send buffer size is 0 KB Maximum allowed bandwidth is 1000000 kbps Minimum available bandwidth is 15000 kbps Estimated round trip time is 1000 usec
The following example displays FCIP summary information.

switch# show fcip summary sw172-22-46-223# show fcip summary ------------------------------------------------------------------------------Tun prof Eth-if peer-ip Status T W T Enc Comp Bandwidth rtt E A A max/min (us) ------------------------------------------------------------------------------1 1 GE1/1 10.10.11.2 DOWN N N N N N 1000M/500M 1000 2 2 GE1/2 10.10.60.2 DOWN N N N N N 1000M/500M 1000
Table 21-3 describes the significant fields shown in the previous display.
Table 21-3 show fcip summary Field Descriptions
Field Tun prof Eth-if peer-ip Status TE WA TA Enc Bandwidth max/min rtt (us)
Description Tunnel number for the row. For example, a number 1 indicates tunnel fcip1 and a number 2 indicates fcip2. Tunnel profile. Ethernet interface to which this tunnel is bound. IP address of the tunnel peer port on the far end of the tunnel. State of the tunnel. UP or DOWN Tunnel operating in TE mode. Yes or 'N'o. Write acceleration enabled. Yes or 'N'o. Tape acceleration enabled. Yes or 'N'o. Encryption enabled. Yes or 'N'o. Maximum and minimum bandwidth configured in the profile to which this tunnel is bound. Round trip time (RTT) in microseconds.
Related Commands
Command fcip enable
Description Configures FCIP parameters.
21-60
Chapter 21
Show Commands show fcns database
show fcns database

To display the results of the discovery, or to display the name server database for a specified VSAN or for all VSANs, use the show fcns database command. show fcns database {detail [vsan vsan-id] | domain domain-id [detail] [vsan vsan-range] | fcid fcid-id [detail] vsan vsan-range | local [detail] [vsan vsan-range] | vsan vsan-id}
Syntax Description
detail vsan vsan-id domain domain-id fcid fcid-id local
Displays all objects in each entry. Displays entries for a specified VSAN ID. The range is 1 to 4093. Displays entries in a domain. Displays entry for the given port. Displays local entries.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The discovery can take several minutes to complete, especially if the fabric is large fabric or if several devices are slow to respond. Virtual enclosure ports can be viewed using the show fcns database command.
Examples
The following example displays the contents of the FCNS database:

switch# show fcns database VSAN 1: -------------------------------------------------------------------------FCID TYPE PWWN (VENDOR) FC4-TYPE:FEATURE -------------------------------------------------------------------------0x020101 N 22:04:00:05:30:00:35:e1 (Cisco) scsi-fcp:init isc..w <--iSCSI 0x020102 N 22:02:00:05:30:00:35:e1 (Cisco) scsi-fcp:init isc..w initiator 0x0205d4 NL 21:00:00:04:cf:da:fe:c6 (Seagate) scsi-fcp:target 0x0205d5 NL 21:00:00:04:cf:e6:e4:4b (Seagate) scsi-fcp:target 0x0205d6 NL 21:00:00:04:cf:e6:21:ac (Seagate) scsi-fcp:target 0x0205d9 NL 21:00:00:04:cf:e6:19:9b (Seagate) scsi-fcp:target 0x0205da NL 21:00:00:04:cf:e6:19:62 (Seagate) scsi-fcp:target 0x0205dc NL 21:00:00:04:cf:e6:e9:82 (Seagate) scsi-fcp:target 0x0205e0 NL 21:00:00:04:cf:e6:21:06 (Seagate) scsi-fcp:target 0x0205e1 NL 21:00:00:04:cf:e6:e0:eb (Seagate) scsi-fcp:target Total number of entries = 10 VSAN 2: --------------------------------------------------------------------------
21-61
Chapter 21 show fcns database
Show Commands
FCID TYPE PWWN (VENDOR) FC4-TYPE:FEATURE -------------------------------------------------------------------------0xef0001 N 22:02:00:05:30:00:35:e1 (Cisco) scsi-fcp:init isc..w Total number of entries = 1 VSAN 3: -------------------------------------------------------------------------FCID TYPE PWWN (VENDOR) FC4-TYPE:FEATURE -------------------------------------------------------------------------0xed0001 N 22:02:00:05:30:00:35:e1 (Cisco) scsi-fcp:init isc..w Total number of entries = 1
The following example displays the detailed contents of the FCNS database.
switch# show fcns database detail -----------------------VSAN:1 FCID:0x020101 -----------------------port-wwn (vendor) :22:04:00:05:30:00:35:e1 (Cisco) node-wwn :22:03:00:05:30:00:35:e1 class :2,3 node-ip-addr :10.2.2.12 ipa :ff ff ff ff ff ff ff ff fc4-types:fc4_features:scsi-fcp:init iscsi-gw symbolic-port-name : symbolic-node-name :iqn.1991-05.com.microsoft:oasis2-dell port-type :N port-ip-addr :0.0.0.0 fabric-port-wwn :22:01:00:05:30:00:35:de hard-addr :0x000000 -----------------------VSAN:1 FCID:0x020102 -----------------------port-wwn (vendor) :22:02:00:05:30:00:35:e1 (Cisco) node-wwn :22:01:00:05:30:00:35:e1 class :2,3 node-ip-addr :10.2.2.11 ipa :ff ff ff ff ff ff ff ff fc4-types:fc4_features:scsi-fcp:init iscsi-gw symbolic-port-name : symbolic-node-name :iqn.1987-05.com.cisco.01.14ac33ba567f986f174723b5f9f2377 port-type :N port-ip-addr :0.0.0.0 fabric-port-wwn :22:01:00:05:30:00:35:de hard-addr :0x000000 ... Total number of entries = 10 ====================================================================== -----------------------VSAN:2 FCID:0xef0001 -----------------------port-wwn (vendor) :22:02:00:05:30:00:35:e1 (Cisco) node-wwn :22:01:00:05:30:00:35:e1 class :2,3 node-ip-addr :10.2.2.11 ipa :ff ff ff ff ff ff ff ff fc4-types:fc4_features:scsi-fcp:init iscsi-gw symbolic-port-name : symbolic-node-name :iqn.1987-05.com.cisco.01.14ac33ba567f986f174723b5f9f2377 port-type :N port-ip-addr :0.0.0.0
21-62
Chapter 21
Show Commands show fcns database
fabric-port-wwn hard-addr :22:01:00:05:30:00:35:de :0x000000
Total number of entries = 1
...
The following example displays the management VSAN (VSAN 2).

switch# show fcns database vsan 2 VSAN 2: -------------------------------------------------------------------------FCID TYPE PWWN (VENDOR) FC4-TYPE:FEATURE -------------------------------------------------------------------------0x6d0001 N 10:00:00:05:30:00:94:9f (Cisco) ipfc 0x6d0002 N 10:00:00:05:30:00:94:a0 (Cisco) ipfc virtual:..c_port 0x6d0003 N 24:15:00:05:30:00:94:a0 (Cisco) virtual:volume_owner ... Total number of entries = 24
The following example displays the database for all configured VSANs.
switch# show fcns database VSAN 2: -------------------------------------------------------------------------FCID TYPE PWWN (VENDOR) FC4-TYPE:FEATURE -------------------------------------------------------------------------0x6d0001 N 10:00:00:05:30:00:94:9f (Cisco) ipfc 0x6d0002 N 10:00:00:05:30:00:94:a0 (Cisco) ipfc virtual:..c_port 0x6d0003 N 24:15:00:05:30:00:94:a0 (Cisco) virtual:volume_owner ... Total number of entries = 24 VSAN 3: -------------------------------------------------------------------------FCID TYPE PWWN (VENDOR) FC4-TYPE:FEATURE -------------------------------------------------------------------------0x650001 N 24:0c:00:05:30:00:94:a0 (Cisco) scsi-fcp:init vir..t ... 0x720101 NL 21:00:00:20:37:65:1c:cb (Company) scsi-fcp ... Total number of entries = 30 VSAN 4: -------------------------------------------------------------------------FCID TYPE PWWN (VENDOR) FC4-TYPE:FEATURE -------------------------------------------------------------------------0x6b0001 N 23:26:00:05:30:00:59:20 (Cisco) scsi-fcp:init vir..t ... 0x7800b5 NL 22:00:00:20:37:46:78:97 (Company) scsi-fcp ... 0x780100 N 50:06:04:82:bf:d0:cf:4b (Company) scsi-fcp 250 ... Total number of entries = 27 VSAN 5: -------------------------------------------------------------------------FCID TYPE PWWN (VENDOR) FC4-TYPE:FEATURE -------------------------------------------------------------------------0x6f0001 N 23:43:00:05:30:00:59:20 (Cisco) scsi-fcp:target vi.. ...
21-63
Chapter 21 show fcns database
Show Commands
Related Commands Command asm mgmt-vsan Description Displays the CPP interface configuration for a specified interface.
21-64
Chapter 21
Show Commands show fcns statistics
show fcns statistics

To display the statistical information for a specified VSAN or for all VSANs, use the show fcns statistics command. show fcns statistics [detail] [vsan vsan-id]
Syntax Description
detail vsan vsan-id
Displays detailed statistics. Displays statistics for the specified VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays statistical information for a specified VSAN.

switch# show fcns statistics registration requests received = 27 deregistration requests received = 0 queries received = 57 queries sent = 10 reject responses sent = 14 RSCNs received = 0 RSCNs sent = 0 switch#
21-65
Chapter 21 show fcroute
Show Commands
show fcroute
Use the show fcroute command to view specific information about existing Fibre Channel and FSPF configurations. show fcroute {distance | label [label] vsan vsan-id | multicast [fc-id vsan vsan-id | vsan vsan-id] | summary [vsan vsan-id] | unicast [[host] fc-id fc-mask vsan vsan-id | vsan vsan-id]}
Syntax Description
distance label multicast summary unicast vsan vsan-id fcid-id
Displays FC route preference. Displays label routes. Displays FC multicast routes. Displays FC routes summary. Displays FC unicast routes. The ID of the VSAN (from 1 to 4093). The Fibre Channel ID.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
When the number of routes are displayed in the command output, both visible and hidden routes are included in the total number of routes.
Examples
The following example displays administrative distance.

switch# show fcroute distance Route Distance -------20 40 80 100 120 140 180 200
UUID ---10 22 39 12 17 21 14 64
Name ---RIB FCDOMAIN RIB-CONFIG FSPF FLOGI TLPM MCAST RIB-TEST
21-66
Chapter 21
Show Commands show fcroute
The following example displays multicast routing information.
switch# show fcroute multicast VSAN FC ID # Interfaces ---- -------- -----------1 0xffffff 0 2 0xffffff 1 3 0xffffff 1 4 0xffffff 0 5 0xffffff 0 6 0xffffff 0 7 0xffffff 0 8 0xffffff 0 9 0xffffff 0 10 0xffffff 0
The following example displays FCID information for a specified VSAN.

switch# show fcroute multicast vsan 3 VSAN FC ID # Interfaces ---- -------- -----------3 0xffffff 1
The following example displays FCID and interface information for a specified VSAN.
switch# show fcroute multicast 0xffffff vsan 2 VSAN FC ID # Interfaces ---- -------- -----------2 0xffffff 1 fc1/1
The following example displays unicast routing information.

switch# show fcroute unicast D:direct R:remote P:permanent V:volatile A:active N:non-active # Next Protocol VSAN FC ID/Mask RCtl/Mask Flags Hops Cost -------- ---- -------- -------- ---- ---- ----- ------ ---static 1 0x010101 0xffffff 0x00 0x00 D P A 1 10 static 2 0x111211 0xffffff 0x00 0x00 R P A 1 10 fspf 2 0x730000 0xff0000 0x00 0x00 D P A 4 500 fspf 3 0x610000 0xff0000 0x00 0x00 D P A 4 500 static 4 0x040101 0xffffff 0x00 0x00 R P A 1 103 static 4 0x040102 0xffffff 0x00 0x00 R P A 1 103 static 4 0x040103 0xffffff 0x00 0x00 R P A 1 103 static 4 0x040104 0xffffff 0x00 0x00 R P A 1 103 static 4 0x111211 0xffffff 0x00 0x00 D P A 1 10
The following example displays unicast routing information for a specified VSAN.
switch# show fcroute unicast vsan 4 D:direct R:remote P:permanent V:volatile A:active N:non-active # Next Protocol VSAN FC ID/Mask RCtl/Mask Flags Hops Cost -------- ---- -------- -------- ---- ---- ----- ------ ---static 4 0x040101 0xffffff 0x00 0x00 R P A 1 103 static 4 0x040102 0xffffff 0x00 0x00 R P A 1 103 static 4 0x040103 0xffffff 0x00 0x00 R P A 1 103 static 4 0x040104 0xffffff 0x00 0x00 R P A 1 103 static 4 0x111211 0xffffff 0x00 0x00 D P A 1 10
21-67
Chapter 21 show fcroute
Show Commands
The following example displays unicast routing information for a specified FCID.
switch# show fcroute unicast 0x040101 0xffffff vsan 4 D:direct R:remote P:permanent V:volatile A:active N:non-active # Next Protocol VSAN FC ID/Mask RCtl/Mask Flags Hops Cost -------- ---- -------- -------- ---- ---- ----- ------ ---static 4 0x040101 0xffffff 0x00 0x00 R P A 1 103 fc1/2 Domain 0xa6(166)
The following example displays route database information.

switch# show fcroute summary FC route database created Tue Oct 29 01:24:23 2002 VSAN Ucast Mcast Label Last Modified Time --------------------------------1 2 1 0 Tue Oct 29 18:07:02 2 3 1 0 Tue Oct 29 18:33:24 3 2 1 0 Tue Oct 29 18:10:07 4 6 1 0 Tue Oct 29 18:31:16 5 1 1 0 Tue Oct 29 01:34:39 6 1 1 0 Tue Oct 29 01:34:39 7 1 1 0 Tue Oct 29 01:34:39 8 1 1 0 Tue Oct 29 01:34:39 9 1 1 0 Tue Oct 29 01:34:39 10 1 1 0 Tue Oct 29 01:34:39 Total 19 10 0
2002 2002 2002 2002 2002 2002 2002 2002 2002 2002
The following example displays route database information for a specified VSAN.
switch# show fcroute summary vsan 4 FC route database created Tue Oct 29 01:24:23 2002 VSAN Ucast Mcast Label Last Modified Time --------------------------------4 6 1 0 Tue Oct 29 18:31:16 2002 Total 6 1 0
21-68
Chapter 21
Show Commands show fcs
show fcs
Use the show fcs commands to display the status of the fabric configuration. show fcs {database [vsan vsan-id] | ie [nwwn wwn] vsan vsan-id | platform [name string] vsan vsan-id | port [pwwn wwn] vsan vsan-id] | statistics vsan vsan-id | vsan}
Syntax Description
database ie nwwn wwn vsan vsan-id platform name string port pwwn wwn statistics vsan
Displays local database of FCS. Displays Interconnect Element Objects Information. Specifies a node WWN id. The format is hh:hh:hh:hh:hh:hh:hh:hh. Specifies a VSAN ID. The range is 1 to 4093. Displays Platform Objects Information. Specifies a platform name. Maximum length is 255 characters. Displays Port Objects Information. Specifies a port WWN id. The format is hh:hh:hh:hh:hh:hh:hh:hh. Displays statistics for FCS packets. Displays list of all the VSANs and plat-check-mode for each.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays FCS database information.

switch# show fcs database FCS Local Database in VSAN: 1 -----------------------------Switch WWN : 20:01:00:05:30:00:16:df Switch Domain Id : 0x7f(127) Switch Mgmt-Addresses : snmp://172.22.92.58/eth-ip http://172.22.92.58/eth-ip Fabric-Name : 20:01:00:05:30:00:16:df Switch Logical-Name : 172.22.92.58 Switch Information List : [Cisco Systems*DS-C9509*0*20:00:00:05:30:00 Switch Ports: ------------------------------------------------------------------Interface pWWN Type Attached-pWWNs ------------------------------------------------------------------fc2/1 20:41:00:05:30:00:16:de TE 20:01:00:05:30:00:20:de
21-69
Chapter 21 show fcs
Show Commands
fc2/2 fc2/17 20:42:00:05:30:00:16:de 20:51:00:05:30:00:16:de Unknown TE None 20:0a:00:05:30:00:20:de
FCS Local Database in VSAN: 5 -----------------------------Switch WWN : 20:05:00:05:30:00:12:5f Switch Domain Id : 0xef(239) Switch Mgmt-Addresses : http://172.22.90.171/eth-ip snmp://172.22.90.171/eth-ip http://10.10.15.10/vsan-ip snmp://10.10.15.10/vsan-ip Fabric-Name : 20:05:00:05:30:00:12:5f Switch Logical-Name : 172.22.90.171 Switch Information List : [Cisco Systems*DS-C9509**20:00:00:05:30:00:12:5e] Switch Ports: ------------------------------------------------------------------Interface pWWN Type Attached-pWWNs ------------------------------------------------------------------fc3/1 20:81:00:05:30:00:12:5e TE 22:01:00:05:30:00:12:9e fc3/2 20:82:00:05:30:00:12:5e TE 22:02:00:05:30:00:12:9e fc3/3 20:83:00:05:30:00:12:5e TE 22:03:00:05:30:00:12:9e
The following example displays Interconnect Element object information for a specific VSAN.
switch# show fcs ie vsan 1
IE List for VSAN: 1 ------------------------------------------------------------------IE-WWN IE-Type Mgmt-Id ------------------------------------------------------------------20:01:00:05:30:00:16:df Switch (Local) 0xfffc7f 20:01:00:05:30:00:20:df Switch (Adjacent) 0xfffc64 [Total 2 IEs in Fabric]
This command displays Interconnect Element object information for a specific WWN.
switch# show fcs ie nwwn 20:01:00:05:30:00:16:df vsan 1 IE Attributes ------------Domain-Id = 0x7f(127) Management-Id = 0xfffc7f Fabric-Name = 20:01:00:05:30:00:16:df Logical-Name = 172.22.92.58 Management Address List = snmp://172.22.92.58/eth-ip http://172.22.92.58/eth-ip Information List: Vendor-Name = Cisco Systems Model Name/Number = DS-C9509 Release-Code = 0
This command displays platform information.

switch# show fcs platform name SamplePlatform vsan 1 Platform Attributes ------------------Platform Node Names: 11:22:33:44:55:66:77:88 Platform Type = Gateway Platform Management Addresses: 1.1.1.1
21-70
Chapter 21
Show Commands show fcs
This command displays platform information within a specified VSAN.
switch# show fcs platform vsan 1 Platform List for VSAN: 1 Platform-Names -------------SamplePlatform [Total 1 Platforms in Fabric]
This command displays FCS port information within a specified VSAN.

switch# show fcs port vsan 24 Port List in VSAN: 24 -- IE WWN: 20:18:00:05:30:00:16:df -------------------------------------------------------------------------Port-WWN Type Module-Type Tx-Type ------------------------------------------------------------------------20:41:00:05:30:00:16:de TE_Port SFP with Serial Id Shortwave Laser 20:51:00:05:30:00:16:de TE_Port SFP with Serial Id Shortwave Laser
[Total 2 switch-ports in IE] -- IE WWN: 20:18:00:05:30:00:20:df -------------------------------------------------------------------------Port-WWN Type Module-Type Tx-Type ------------------------------------------------------------------------20:01:00:05:30:00:20:de TE_Port SFP with Serial Id Shortwave Laser 20:0a:00:05:30:00:20:de TE_Port SFP with Serial Id Shortwave Laser
[Total 2 switch-ports in IE]
This command displays ports within a specified WWN.

switch# show fcs port pwwn 20:51:00:05:30:00:16:de vsan 24 Port Attributes --------------Port Type = TE_Port Port Number = 0x1090000 Attached-Port-WWNs: 20:0a:00:05:30:00:20:de Port State = Online
21-71
Chapter 21 show fcs
Show Commands
This command displays FCS statistics.
switch# show fcs statistics FCS Statistics for VSAN: 1 --------------------------FCS Rx Get Reqs :2 FCS Tx Get Reqs :7 FCS Rx Reg Reqs :0 FCS Tx Reg Reqs :0 FCS Rx Dereg Reqs :0 FCS Tx Dereg Reqs :0 FCS Rx RSCNs :0 FCS Tx RSCNs :3 FCS Rx RJTs :3 FCS Tx RJTs :0 FCS Rx ACCs :4 FCS Tx ACCs :2 FCS No Response :0 FCS Retransmit :0 FCS Statistics for VSAN: 30 --------------------------FCS Rx Get Reqs :2 FCS Tx Get Reqs :2 FCS Rx Reg Reqs :0 FCS Tx Reg Reqs :0 FCS Rx Dereg Reqs :0 FCS Tx Dereg Reqs :0 FCS Rx RSCNs :0 FCS Tx RSCNs :0 FCS Rx RJTs :0 FCS Tx RJTs :0 FCS Rx ACCs :2 FCS Tx ACCs :2 FCS No Response :0 FCS Retransmit :0
21-72
Chapter 21
Show Commands show fcsp
show fcsp
To display the status of the Fibre Channel Security Protocol (FC-SP) configuration, use the show fcsp commands. show fcsp [asciiwwn ascii-wwn | dhchap [database] | interface fc slot/port [statistics | wwn] | fcip interface-number [statistics | wwn]]
Syntax Description
asciiwwn ascii-wwn dhchap database interface fc slot/port fcip interface-number statistics wwn
Displays the ASCII representation of the WWN used with AAA server. Displays the DHCHAP hash algorithm status. Displays the contents of the local DHCHAP database. Displays the FC-SP settings for a FC or FCIP interface. Displays the Fibre Channel interface in the specified slot and port. Displays the description of the specified FCIP interface from 1 to 255. Displays the statistics for the specified interface. Displays the FC-SP identity of the other device.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays DHCHAP configurations in FC interfaces.

switch# show fcsp interface fc1/9 fc1/9: fcsp authentication mode:SEC_MODE_ON Status: Successfully authenticated
The following example displays DHCHAP statistics for a FC interfaces.

switch# show fcsp interface fc1/9 statistics fc1/9: fcsp authentication mode:SEC_MODE_ON Status: Successfully authenticated Statistics: FC-SP Authentication Succeeded:5 FC-SP Authentication Failed:0 FC-SP Authentication Bypassed:0
21-73
Chapter 21 show fcsp
Show Commands
The following example displays the FC-SP WWN of the device connected through a specified interface.
switch# show fcsp interface fc 2/1 wwn fc2/1: fcsp authentication mode:SEC_MODE_ON Status: Successfully authenticated Other device's WWN:20:00:00:e0:8b:0a:5d:e7
The following example displays hash algorithm and DHCHAP groups configured for the local switch.
switch# show fcsp dhchap Supported Hash algorithms (in order of preference): DHCHAP_HASH_MD5 DHCHAP_HASH_SHA_1 Supported Diffie Hellman group ids (in order of preference): DHCHAP_GROUP_NULL DHCHAP_GROUP_1536 DHCHAP_GROUP_1024 DHCHAP_GROUP_1280 DHCHAP_GROUP_2048
The following example displays the DHCHAP local password database.

switch# show fcsp dhchap database DHCHAP Local Password: Non-device specific password:mypassword1 Password for device with WWN:29:11:bb:cc:dd:33:11:22 is pjoalf Password for device with WWN:30:11:bb:cc:dd:33:11:22 is mypassword Other Devices' Passwords: Password for device with WWN:00:11:22:33:44:aa:bb:cc is NewPassword
The following example displays he ASCII representation of the device WWN.

switch# show fcsp asciiwwn 30:11:bb:cc:dd:33:11:22 Ascii representation of WWN to be used with AAA servers:Ox_3011bbccdd331122
Related Commands
Command fcsp enable
Description Enables the FC-SP feature for this switch.
21-74
Chapter 21
Show Commands show fctimer
show fctimer
To view the Fibre Channel timers (fctimer), use the show fctimer command. show fctimer [d_s_tov [vsan vsan-id] | distribution status | e_d_tov [vsan vsan-id] | f_s_tov [vsan vsan-id] | last action status | pending | pending-diff | r_a_tov [vsan vsan-id] | session-status | vsan vsan-id]
Syntax Description
d_s_tov distribution status e_d_tov f_s_tov last action status pending pending-diff r_a_tov session-status vsan vsan-id
Displays the distributed services time out value (D_S_TOV) in milliseconds. Displays Cisco Fabric Services (CFS) distribution status information. Displays the error detection time out value (E_D_TOV) in milliseconds. Displays the fabric stability time out value (F_S_TOV) in milliseconds. Displays the status of the last CFS commit or discard operation. Displays the status of pending fctimer commands. Displays the difference between pending database and running config. Displays the resource allocation time out value (R_A_TOV) in milliseconds. Displays the state of fctimer CFS session. Displays information for a VSAN. The range is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.3(1) 2.0(1b)
Modification This command was introduced. Added the distribution status, last action status, pending, pending-diff, and session-status keywords.
Usage Guidelines
None.
Examples
The following example displays configured global TOVs.

switch# show fctimer F_S_TOV D_S_TOV E_D_TOV R_A_TOV ---------------------------------------5000 ms 5000 ms 2000 ms 10000 ms
21-75
Chapter 21 show fctimer
Show Commands
The following example displays configured TOVs for a specified VSAN.
switch# show fctimer vsan 10 vsan no. F_S_TOV D_S_TOV E_D_TOV R_A_TOV ------------------------------------------------10 5000 ms 5000 ms 3000 ms 10000 ms
Related Commands
Command fctimer
Description Configures fctimer parameters.
21-76
Chapter 21
Show Commands show fdmi
show fdmi
To display the Fabric-Device Management Interface (FDMI) database information, use the show fdmi command. show fdmi database [detail [hba-id [hba-id vsan vsan-id | vsan vsan-id] | vsan vsan-id]
Syntax Description
fdmi database detail hba-id hba-id vsan vsan-id
Accesses the FDMI commands. Displays the FDMI database contents. Specifies detailed FDMI information. Displays detailed information for the specified HBA entry. Displays detailed information for the specified HBA entry. Specifies FDMI information for the specified VSAN ranging from 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays all HBA management servers.

switch# show fdmi database Registered HBA List for VSAN 1 10:00:00:00:c9:32:8d:77 21:01:00:e0:8b:2a:f6:54 switch# show fdmi database detail Registered HBA List for VSAN 1 ------------------------------HBA-ID: 10:00:00:00:c9:32:8d:77 ------------------------------Node Name :20:00:00:00:c9:32:8d:77 Manufacturer :Emulex Corporation Serial Num :0000c9328d77 Model :LP9002 Model Description:Emulex LightPulse LP9002 2 Gigabit PCI Fibre Channel Adapter Hardware Ver :2002606D Driver Ver :SLI-2 SW_DATE:Feb 27 2003, v5-2.20a12 ROM Ver :3.11A0 Firmware Ver :3.90A7 OS Name/Ver :Window 2000 CT Payload Len :1300000 Port-id: 10:00:00:00:c9:32:8d:77 -------------------------------
21-77
Chapter 21 show fdmi
Show Commands
HBA-ID: 21:01:00:e0:8b:2a:f6:54 ------------------------------Node Name :20:01:00:e0:8b:2a:f6:54 Manufacturer :QLogic Corporation Serial Num :\74262 Model :QLA2342 Model Description:QLogic QLA2342 PCI Fibre Channel Adapter Hardware Ver :FC5010409-10 Driver Ver :8.2.3.10 Beta 2 Test 1 DBG (W2K VI) ROM Ver :1.24 Firmware Ver :03.02.13. OS Name/Ver :500 CT Payload Len :2040 Port-id: 21:01:00:e0:8b:2a:f6:54
The following example displays VSAN1-specific FDMI information.

switch# show fdmi database detail vsan 1 Registered HBA List for VSAN 1 ------------------------------HBA-ID: 10:00:00:00:c9:32:8d:77 ------------------------------Node Name :20:00:00:00:c9:32:8d:77 Manufacturer :Emulex Corporation Serial Num :0000c9328d77 Model :LP9002 Model Description:Emulex LightPulse LP9002 2 Gigabit PCI Fibre Channel Adapter Hardware Ver :2002606D Driver Ver :SLI-2 SW_DATE:Feb 27 2003, v5-2.20a12 ROM Ver :3.11A0 Firmware Ver :3.90A7 OS Name/Ver :Window 2000 CT Payload Len :1300000 Port-id: 10:00:00:00:c9:32:8d:77 ------------------------------HBA-ID: 21:01:00:e0:8b:2a:f6:54 ------------------------------Node Name :20:01:00:e0:8b:2a:f6:54 Manufacturer :QLogic Corporation Serial Num :\74262 Model :QLA2342 Model Description:QLogic QLA2342 PCI Fibre Channel Adapter Hardware Ver :FC5010409-10 Driver Ver :8.2.3.10 Beta 2 Test 1 DBG (W2K VI) ROM Ver :1.24 Firmware Ver :03.02.13. OS Name/Ver :500 CT Payload Len :2040 Port-id: 21:01:00:e0:8b:2a:f6:54
21-78
Chapter 21
Show Commands show fdmi
The following example displays details for the specified HBA entry.
switch# show fdmi database detail Hba-id 21:01:00:e0:8b:2a:f6:54 vsan 1 Node Name :20:01:00:e0:8b:2a:f6:54 Manufacturer :QLogic Corporation Serial Num :\74262 Model :QLA2342 Model Description:QLogic QLA2342 PCI Fibre Channel Adapter Hardware Ver :FC5010409-10 Driver Ver :8.2.3.10 Beta 2 Test 1 DBG (W2K VI) ROM Ver :1.24 Firmware Ver :03.02.13. OS Name/Ver :500 CT Payload Len :2040 Port-id: 21:01:00:e0:8b:2a:f6:54
21-79
Chapter 21 show ficon
Show Commands
show ficon
To display configured FICON information, use the show ficon command. show ficon [control-device sb3 [vsan vsan-id] | first-available port-number | vsan vsan-id [allegiance | directory-history [key-counter value] | file {all | name filename [portaddress port]} | interface {fc slot/port | fcip fcip-id | port-channel port} | portaddress [port [counters]] [brief] [installed]]
Syntax Description
control-device sb3 vsan vsan-id
Displays FICON control device information. Specifies FICON information for the specified VSAN ranging from 1 to 4093. Displays FICON device allegiance information. Displays FICON directory history. Specifies a key counter. Displays FICON information for a file. Specifies all files. Specifies the name for a file. Specifies a port address for a file. Displays FICON information for an interface. Specifies a Fibre Channel interface. Specifies an FC IP interface. Specifies a PortChannel interface. Displays counter information for the port address. Displays brief FICON information for the port address. Displays FICON information for the installed port address.
first-available port-number Displays the available port numbers allegiance directory-history key-counter value file all name filename portaddress port interface fc slot/port fcip fcip-id port-channel port counters brief installed
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
If FICON is not enabled on a VSAN, you will not be able to view FICON configuration information for that VSAN.
21-80
Chapter 21
Show Commands show ficon
Examples The following example displays configured FICON information
switch# show ficon Ficon information for VSAN 20 Ficon is online VSAN is active Host port control is Enabled Host offline control is Enabled User alert mode is Enabled SNMP port control is Enabled Host set director timestamp is Enabled Active=Saved is Disabled Number of implemented ports are 240 Key Counter is 73723 FCID last byte is 0 Date/Time is set by host to Sun Jun 26 00:04:06.991999 1904 Device allegiance is locked by Host Codepage is us-canada Saved configuration files IPL _TSIRN00
The following example displays port address information

switch# show ficon vsan 2 portaddress Port Address 1 is not installed in vsan 2 Port number is 1, Interface is fc1/1 Port name is Port is not admin blocked Prohibited port addresses are 0,241-253,255 Port Address 2 is not installed in vsan 2 Port number is 2, Interface is fc1/2 Port name is Port is not admin blocked Prohibited port addresses are 0,241-253,255 ... Port Address 239 is not installed in vsan 2 Port name is Port is not admin blocked Prohibited port addresses are 0,241-253,255 Port Address 240 is not installed in vsan 2 Port name is Port is not admin blocked Prohibited port addresses are 0,241-253,255
The following example displays port address information in a brief format.

switch# show ficon vsan 2 portaddress 50-55 brief ------------------------------------------------------------------------------Port Port Interface Admin Status Oper FCID Address Number Blocked Mode ------------------------------------------------------------------------------50 50 fc2/18 on fcotAbsent --51 51 fc2/19 off fcotAbsent --52 52 fc2/20 off fcotAbsent --53 53 fc2/21 off fcotAbsent --54 54 fc2/22 off notConnected --55 55 fc2/23 off up FL 0xea0000 56 55 off up FL 0xea0000
21-81
Show Commands
The following example displays port address counter information.
switch# show ficon vsan 20 portaddress 8 counters Port Address 8(0x8) is up in vsan 20 Port number is 8(0x8), Interface is fc1/8 Version presented 1, Counter size 32b 242811 frames input, 9912794 words 484 class-2 frames, 242302 class-3 frames 0 link control frames, 0 multicast frames 0 disparity errors inside frames 0 disparity errors outside frames 0 frames too big, 0 frames too small 0 crc errors, 0 eof errors 0 invalid ordered sets 0 frames discarded c3 0 address id errors 116620 frames output, 10609188 words 0 frame pacing time 0 link failures 0 loss of sync 0 loss of signal 0 primitive seq prot errors 0 invalid transmission words 1 lrr input, 0 ols input, 5 ols output 0 error summary
The following example displays the contents of the specified FICON configuration file
switch# show ficon vsan 3 file IPL FICON configuration file IPL in vsan 3 Port address 1 Port name is Port is not blocked Prohibited port addresses are 0,81-253,255 Port address 2 Port name is Port is not blocked Prohibited port addresses are 0,81-253,255 Port address 3 Port name is Port is not blocked Prohibited port addresses are 0,81-253,255 Port address 4 Port name is Port is not blocked Prohibited port addresses are 0,81-253,255 ... Port address 80 Port name is Port is not blocked Prohibited port addresses are 0,81-253,255 Port address 254 Port name is Port is not blocked Prohibited port addresses are 0,81-253,255
21-82
Chapter 21
The following example displays all FICON configuration files
switch# show ficon vsan 2 Ficon information for VSAN 2 Ficon is enabled VSAN is active Host control is Enabled Host offline control is Enabled Clock alert mode is Disabled User alert mode is Disabled SNMP control is Disabled Active=Saved is Disabled Number of implemented ports are 240 Key Counter is 9 FCID last byte is 0 Date/Time is same as system time (Sun Dec 14 01:26:30.273402 1980) Device Allegiance not locked Codepage is us-canada Saved configuration files IPL IPLFILE1
The following example displays the specified port addresses for a FICON configuration file
switch# show ficon vsan 2 file iplfile1 portaddress 1-7 FICON configuration file IPLFILE1 in vsan 2 Port address 1 Port name is Port is not blocked Prohibited port addresses are 0,241-253,255 Port address 2 Port name is Port is not blocked Prohibited port addresses are 0,241-253,255 Port address 3 Port name is P3 Port is not blocked Prohibited port addresses are 0,241-253,255 ... Port address 7 Port name is Port is not blocked Prohibited port addresses are 0,241-253,255
The following example displays the specified port address when FICON is enabled
switch# show ficon vsan 2 portaddress 55 Port Address 55 is not installed in vsan 2 Port number is 55, Interface is fc2/23 Port name is Port is not admin blocked Prohibited port addresses are 0,241-253,255 Admin port mode is FL Port mode is FL, FCID is 0xea0000
21-83
Show Commands
The following example displays two port addresses configured with different states
switch# show ficon vsan 2 portaddress 2 Port Address 2(0x2) is not installed in vsan 2 Port number is 2(0x2), Interface is fc1/2 Port name is Port is not admin blocked Prohibited port addresses are 0,241-253,255(0,0xf1-0xfd,0xff) Admin port mode is auto Peer was type model manufactured by switch# show ficon vsan 2 portaddress 1 Port Address 2(0x2) is not installed in vsan 2 Port number is 2(0x2), Interface is fc1/2 Port name is Port name is SampleName Port is admin blocked Prohibited port addresses are 0,241-253,255(0,0xf1-0xfd,0xff) Admin port mode is auto Peer was type model manufactured by
The following example displays control unit information.

switch# show ficon control-device sb3 Control Unit Image:0x80b9c2c VSAN:20 CU:0x20fe00 CUI:0 CUD:0 CURLP:(nil) ASYNC LP:(nil) MODE:1 STATE:1 CQ LEN:0 MAX:0 PRIMARY LP: VSAN:0 CH:0x0 CHI:0 CU:0x0 CUI:0 ALTERNATE LP: VSAN:0 CH:0x0 CHI:0 CU:0x0 CUI:0 Logical Path:0x80b9fb4 VSAN:20 CH:0x200600 CHI:15 CU:0x20fe00 CUI:0 STATE:1 FLAGS:0x1 LINK: OH:0x0 OC:0x0 IH:0x0 IC:0x0 DEV: OH:0x0 OC:0x0 IH:0x0 IC:0x0 SENSE: 00 00 00 00 00 00 00 46 30 20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 IUI:0x0 DHF:0x0 CCW:0x0 TOKEN:0x0 PCCW:0x0 FCCW:0x0 PTOKEN:0x0 FTOKEN:0x0 CMD:0x0 CCW_FLAGS:0x0 CCW_COUNT:0 CMD_FLAGS:0x0 PRIO:0x0 DATA_COUNT:0 STATUS:0x0 FLAGS:0x0 PARAM:0x0 QTP:0x0 DTP:0x0 CQ LEN:0 MAX:0 DESTATUS:0x0
The following example displays the history buffer for the specified VSAN
switch# show ficon vsan 20 director-history Director History Buffer for vsan 20 --------------------------------------------Key Counter Ports Address Changed --------------------------------------------74556 43 74557 44 74558 45 74559 46 74560 47 74561 48 74562 49 74563 50 74564 51 74565 52 74566 53 74567 54 74568 55 74569 56
21-84
Chapter 21
74570 74571 74572 74573 74574 74575 74576 74577 74578 74579 74580 74581 74582 74583 74584 74585 74586 74587 57 58 59 60 61 62 63 64
1-3,5,10,12,14-16,34-40,43-45,47-54,56-57,59-64 3,5 64 1-3,10,12,14-16,34-40,43-45,47-54,56-57,59-64 1 2 3
The following example displays the running configuration information

switch# show running-config ... ficon vsan 2 portaddress 1 block name SampleName prohibit portaddress 3 portaddress 3 prohibit portaddress 1 file IPL
The following example displays the available port numbers:

switch# show ficon first-available port-number Port number 129(0x81) is available
21-85
Chapter 21 show file
Show Commands
show file
To display the contents of a specified file in the file system, use the show file command. show file filename [cksum | md5sum]
Syntax Description
filename cksum md5sum
Specifies a filename. Displays CRC checksum for a file. Displays MD5 checksum for a file.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the contents of the test file that resides in the slot0 directory.
switch# show file slot0:test config t Int fc1/1 no shut end show int
The following example displays the contents of a file residing in the current directory.
switch# show file myfile
The following example displays the CRC checksum for a file.

switch# show file bootflash:vboot-1 cksum 838096258
The following example displays the MD5 checksum for a file.

switch# show file bootflash:vboot-1 md5sum 3d8e05790155150734eb8639ce98a331
21-86
Chapter 21
Show Commands show flogi database
show flogi database

To list all the FLOGI sessions through all interfaces across all VSANs, use the show flogi database command. show flogi database [fcid fcid-id | interface interface | vsan vsan-id]
Syntax Description
fcid fcid-id interface interface vsan vsan-id
Displays FLOGI database entries based on the FCID allocated. Displays FLOGI database entries based on the logged in interface. Displays FLOGI database entries based on the VSAN ID. The range is 1 to 4093.
Defaults
Displays the entire FLOGI database.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Output of this command is first sorted on interface and then on VSANs. In a Fibre Channel fabric, each host or disk requires an FCID. Use the show flogi database command to verify if a storage device is displayed in the Fabric login (FLOGI) table as in the examples below. If the required device is displayed in the FLOGI table, the fabric login is successful. Examine the FLOGI database on a switch that is directly connected to the host HBA and connected ports.
Examples
The following example displays details on the FLOGI database.

switch# show flogi database --------------------------------------------------------------------------INTERFACE VSAN FCID PORT NAME NODE NAME --------------------------------------------------------------------------sup-fc0 2 0xb30100 10:00:00:05:30:00:49:63 20:00:00:05:30:00:49:5e fc9/13 1 0xb200e2 21:00:00:04:cf:27:25:2c 20:00:00:04:cf:27:25:2c fc9/13 1 0xb200e1 21:00:00:04:cf:4c:18:61 20:00:00:04:cf:4c:18:61 fc9/13 1 0xb200d1 21:00:00:04:cf:4c:18:64 20:00:00:04:cf:4c:18:64 fc9/13 1 0xb200ce 21:00:00:04:cf:4c:16:fb 20:00:00:04:cf:4c:16:fb fc9/13 1 0xb200cd 21:00:00:04:cf:4c:18:f7 20:00:00:04:cf:4c:18:f7 Total number of flogi = 6.
21-87
Chapter 21 show flogi database
Show Commands
The following example displays the FLOGI interface.
switch# show flogi database interface fc 1/11 INTERFACE VSAN FCID PORT NAME NODE NAME -------------------- ---- -------- ----------------------- --------------------fc9/13 1 0xa002ef 21:00:00:20:37:18:17:d2 20:00:00:20:37:18:17:d2 fc9/13 1 0xa002e8 21:00:00:20:37:38:a7:c1 20:00:00:20:37:38:a7:c1 fc9/13 1 0xa002e4 21:00:00:20:37:6b:d7:18 20:00:00:20:37:6b:d7:18 fc9/13 1 0xa002e2 21:00:00:20:37:18:d2:45 20:00:00:20:37:18:d2:45 fc9/13 1 0xa002e1 21:00:00:20:37:39:90:6a 20:00:00:20:37:39:90:6a fc9/13 1 0xa002e0 21:00:00:20:37:36:0b:4d 20:00:00:20:37:36:0b:4d fc9/13 1 0xa002dc 21:00:00:20:37:5a:5b:27 20:00:00:20:37:5a:5b:27 fc9/13 1 0xa002da 21:00:00:20:37:18:6f:90 20:00:00:20:37:18:6f:90 fc9/13 1 0xa002d9 21:00:00:20:37:5b:cf:b9 20:00:00:20:37:5b:cf:b9 fc9/13 1 0xa002d6 21:00:00:20:37:46:78:97 20:00:00:20:37:46:78:97 Total number of flogi = 10.
The following example displays the FLOGI VSAN.

switch# show flogi database vsan 1 --------------------------------------------------------------------------INTERFACE VSAN FCID PORT NAME NODE NAME --------------------------------------------------------------------------fc9/13 1 0xef02ef 22:00:00:20:37:18:17:d2 20:00:00:20:37:18:17:d2 fc9/13 1 0xef02e8 22:00:00:20:37:38:a7:c1 20:00:00:20:37:38:a7:c1 fc9/13 1 0xef02e4 22:00:00:20:37:6b:d7:18 20:00:00:20:37:6b:d7:18 fc9/13 1 0xef02e2 22:00:00:20:37:18:d2:45 20:00:00:20:37:18:d2:45 fc9/13 1 0xef02e1 22:00:00:20:37:39:90:6a 20:00:00:20:37:39:90:6a fc9/13 1 0xef02e0 22:00:00:20:37:36:0b:4d 20:00:00:20:37:36:0b:4d fc9/13 1 0xef02dc 22:00:00:20:37:5a:5b:27 20:00:00:20:37:5a:5b:27 fc9/13 1 0xef02da 22:00:00:20:37:18:6f:90 20:00:00:20:37:18:6f:90 fc9/13 1 0xef02d9 22:00:00:20:37:5b:cf:b9 20:00:00:20:37:5b:cf:b9 fc9/13 1 0xef02d6 22:00:00:20:37:46:78:97 20:00:00:20:37:46:78:97 Total number of flogi = 10.
The following example displays the FLOGI FCID.

switch# show flogi database fcid 0xef02e2 --------------------------------------------------------------------------INTERFACE VSAN FCID PORT NAME NODE NAME --------------------------------------------------------------------------fc9/13 1 0xef02e2 22:00:00:20:37:18:d2:45 20:00:00:20:37:18:d2:45 Total number of flogi = 1.
Related Commands
Command show fcns database
Description Displays all the local and remote name server entries
21-88
Chapter 21
Show Commands show fspf
show fspf
To display global FSPF information, use the show fspf command. This information includes:

the domain number of the switch the autonomous region for the switch Min_LS_arrival: the minimum time that must elapse before the switch accepts LSR updates Min_LS_interval: the minimum time that must elapse before the switch can transmit an LSR LS_refresh_time: the interval lapse between refresh LSR transmissions Max_age: the maximum time aa LSR can stay before being deleted show fspf [database [vsan vsan-id [domain domain-id] [detail]] | interface | vsan vsan-id [interface [interface-range]]]
Syntax Description
database
To display information of fspf database for a VSAN. If no other parameters are given all the LSRs in the database are displayed. If more specific information is required then the domain number of the owner of the LSR may be given. Detail gives more detailed information on each LSR. Specifies the VSAN ID. The range is 1 to 4093. The domain of the database. The parameter domain_num is unsigned integers in the range 0-255. Displays detailed FSPF information for the VSAN.
vsan vsan-id domain domain-id detail
interface interface-range Display FSPF interface information for a given VSAN. If the interface number is specified information on the neighbor on that interface is displayed. If no interface is specified information on all interfaces are displayed. The parameter interface-range is of the format fcslot/port fcslot/port.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
21-89
Chapter 21 show fspf
Show Commands
Examples The following example displays FSPF interface information.
switch# show fspf interface vsan 1 fc1/1 FSPF interface fc1/1 in VSAN 1 FSPF routing administrative state is active Interface cost is 500 Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 s FSPF State is FULL Neighbor Domain Id is 0x0c(12), Neighbor Interface index is 0x0f100000 Statistics counters : Number of packets received : LSU 8 LSA 8 Hello 118 Error packets 0 Number of packets transmitted : LSU 8 LSA 8 Hello 119 Retransmitted LSU 0 Number of times inactivity timer expired for the interface = 0
The following example displays FSPF database information.

switch# show fspf database vsan 1 FSPF Link State Database for VSAN 1 Domain 0x0c(12) LSR Type = 1 Advertising domain ID = 0x0c(12) LSR Age = 1686 LSR Incarnation number = 0x80000024 LSR Checksum = 0x3caf Number of links = 2 NbrDomainId IfIndex NbrIfIndex Link Type Cost ----------------------------------------------------------------------------0x65(101) 0x0000100e 0x00001081 1 500 0x65(101) 0x0000100f 0x00001080 1 500 FSPF Link State Database for VSAN 1 Domain 0x65(101) LSR Type = 1 Advertising domain ID = 0x65(101) LSR Age = 1685 LSR Incarnation number = 0x80000028 LSR Checksum = 0x8443 Number of links = 6 NbrDomainId IfIndex NbrIfIndex Link Type Cost ----------------------------------------------------------------------------0xc3(195) 0x00001085 0x00001095 1 500 0xc3(195) 0x00001086 0x00001096 1 500 0xc3(195) 0x00001087 0x00001097 1 500 0xc3(195) 0x00001084 0x00001094 1 500 0x0c(12) 0x00001081 0x0000100e 1 500 0x0c(12) 0x00001080 0x0000100f 1 500 FSPF Link State Database for VSAN 1 Domain 0xc3(195) LSR Type = 1 Advertising domain ID = 0xc3(195) LSR Age = 1686 LSR Incarnation number = 0x80000033 LSR Checksum = 0x6799 Number of links = 4 NbrDomainId IfIndex NbrIfIndex Link Type Cost ----------------------------------------------------------------------------0x65(101) 0x00001095 0x00001085 1 500 0x65(101) 0x00001096 0x00001086 1 500 0x65(101) 0x00001097 0x00001087 1 500 0x65(101) 0x00001094 0x00001084 1 500
This command displays FSPF information for a specified VSAN.
21-90
Chapter 21
Show Commands show fspf
switch# show fspf vsan 1 FSPF routing for VSAN 1 FSPF routing administration status is enabled FSPF routing operational status is UP It is an intra-domain router Autonomous region is 0 SPF hold time is 0 msec MinLsArrival = 1000 msec , MinLsInterval = 5000 msec Local Domain is 0x65(101) Number of LSRs = 3, Total Checksum = 0x0001288b Protocol constants : LS_REFRESH_TIME = 1800 sec MAX_AGE = 3600 sec Statistics counters : Number of LSR that reached MaxAge = 0 Number of SPF computations = 7 Number of Checksum Errors = 0 Number of Transmitted packets : LSU 65 LSA 55 Hello 474 Retranmsitted LSU 0 Number of received packets : LSU 55 LSA 60 Hello 464 Error packets 10
21-91
Chapter 21 show hardware
Show Commands
show hardware
To display switch hardware inventory details, use the show hardware command. show hardware [ipc-channel status]
Syntax Description
ipc-channel status
Displays the status of the interprocess communication (IPC) channels.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the switch hardware inventory details.

switch# show hardware Cisco Storage Area Networking Operating System (SAN-OS) Software TAC support:http://www.cisco.com/tac Copyright (c) 1986-2002 by cisco Systems, Inc. All rights reserved. The copyright for certain works contained herein are owned by Andiamo Systems, Inc. and/or other third parties and are used and distributed under license. Software BIOS: version loader: version kickstart:version system: version
0.0.0 1.0(0.259) 1.0(2) [build 1.0(0.280)] 1.0(2) [build 1.0(0.280)]
BIOS compile time: 10/10/02 kickstart image file is:bootflash:/boot-280 kickstart compile time: 11/20/2002 6:00:00 system image file is: isan-280 system compile time: 11/20/2002 6:00:00 Hardware RAM 963108 kB bootflash:503808 blocks (block size 512b) slot0: 0 blocks (block size 512b) 172.22.92.28 uptime is 0 days 0 hour 31 minute(s) 23 second(s) Last reset Reason:Watchdog Timeout/External Reset System version:1.0(2)
21-92
Chapter 21
Show Commands show hardware
This supervisor carries Pentium processor with 963108 kB of memory Intel(R) Pentium(R) III CPU at 800MHz with 512 KB L2 Cache Rev:Family 6, Model 11 stepping 1 512K bytes of non-volatile memory. 503808 blocks of internal bootflash (block size 512b)
Displays the status of the IPC channel:

switch# show hardware ipc-channel status Active IPC-Channel: A
21-93
Chapter 21 show hosts
Show Commands
show hosts
To display configured DNS host configuration details, use the show hosts command. show hosts
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the configures hosts including the default domain, domain list, and name servers.
switch# show hosts Default domain is cisco.com Domain list: ucsc.edu harvard.edu yale.edu stanford.edu Name/address lookup uses domain service Name servers are 15.1.0.1 15.2.0.0
21-94
Chapter 21
Show Commands show incompatibility system
show incompatibility system

To display the HA compatibility status between the two supervisor modules, use the show incompatibility system command. show incompatibility system [bootflash: | slot0: | volatile:]image-filename
Syntax Description
bootflash: slot0: volatile: image-filename
Source or destination location for internal bootflash memory Source or destination location for the CompactFlash memory or PCMCIA card. Source or destination location for the volatile directory. Specifies the name of the system or kickstart image.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
If the HA compatibility is strict on an active supervisor module, the standby supervisor module synchronization may not succeed and may move into an inconsistent state. If the HA compatibility is loose, the synchronization may happen without errors, but some resources may become unusable when a switchover happens.
Examples
The following examples display kernel core settings.

switch# show incompatibility system bootflash:old-image-y The following configurations on active are incompatible with the system image 1) Feature Index : 67 , Capability : CAP_FEATURE_SPAN_FC_TUNNEL_CFG Description : SPAN - Remote SPAN feature using fc-tunnels Capability requirement : STRICT 2) Feature Index : 119 , Capability : CAP_FEATURE_FC_TUNNEL_CFG Description : fc-tunnel is enabled Capability requirement : STRICT
21-95
Chapter 21 show install all impact
Show Commands
show install all impact

To display the software compatibility matrix of a specific image, use the show install all impact command. show install all impact [asm-sfn image-filename] [kickstart image-filename] [ssi image-filename] [system image-filename]
Syntax Description
asm-sfn kickstart ssi system image-filename
Specifies the ASM SFN boot variable. Specifies the kickstart boot variable. Specifies the SSI boot variable. Specifies the system boot variable. The name of an image.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
Use the show install all impact command to view the effect of updating the system from the running image to another specified image.
switch# show install all impact Verifying image bootflash:/ilc1.bin [####################] 100% -- SUCCESS Verifying image bootflash:/vk73a [####################] 100% -- SUCCESS Verifying image bootflash:/vs73a [####################] 100% -- SUCCESS Extracting slc version from image bootflash:/vs73a. [####################] 100% -- SUCCESS Extracting slc version from image bootflash:/vs73a. [####################] 100% -- SUCCESS Extracting system version from image bootflash:/vs73a. [####################] 100% -- SUCCESS Extracting kickstart version from image bootflash:/vk73a.
21-96
Chapter 21
Show Commands show install all impact
[####################] 100% -- SUCCESS Extracting loader version from image bootflash:/vk73a. [####################] 100% -- SUCCESS Extracting slc version from image bootflash:/vs73a. [####################] 100% -- SUCCESS Compatibility check is done: Module bootable Impact ------ -------- -------------2 yes non-disruptive 4 yes non-disruptive 6 yes non-disruptive 9 yes non-disruptive
Install-type -----------none none none none
Reason ------
Images will be upgraded according to following table: Module Image Running-Version New-Version ------ ---------- -------------------- -------------------2 slc 1.2(1) 1.2(1) 2 bios v1.0.7(03/20/03) v1.0.7(03/20/03) 4 slc 1.2(1) 1.2(1) 4 ilce 1.2(1) 1.2(1) 4 bios v1.0.7(03/20/03) v1.0.7(03/20/03) 6 system 1.2(1) 1.2(1) 6 kickstart 1.2(1) 1.2(1) 6 bios v1.0.7(03/20/03) v1.0.7(03/20/03) 6 loader 1.0(3a) 1.0(3a) 9 slc 1.2(1) 1.2(1) 9 bios v1.0.7(03/20/03) v1.0.7(03/20/03)
Upg-Required -----------no no no no no no no no no no no
The following command displays the error message that is displayed if a wrong image is provided.
switch# show install all impact system bootflash: Compatibility check failed. Return code 0x40930003 (Invalid bootvar specified in the input).
21-97
Chapter 21 show install all status
Show Commands
show install all status

To display the on-going install all command status or the log of the last installed install all command from a Console, SSH, or Telnet session, use the show install all status command. show install all status
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
This command only displays the status of an install all command that is issued form the CLI (not the Fabric Manager).
Examples
Use the show install all status command to view the output of a install all command process.
switch# show install all status There is an on-going installation... <---------------------- in progress installation Enter Ctrl-C to go back to the prompt.
Verifying image bootflash:/b-1.3.0.104 -- SUCCESS
Verifying image bootflash:/i-1.3.0.104 -- SUCCESS
Extracting system version from image bootflash:/i-1.3.0.104. -- SUCCESS
Extracting kickstart version from image bootflash:/b-1.3.0.104. -- SUCCESS
Extracting loader version from image bootflash:/b-1.3.0.104. -- SUCCESS
switch# show install all status This is the log of last installation.
<<<<<< log of last install
21-98
Chapter 21
Show Commands show install all status
Verifying image bootflash:/b-1.3.0.104 -- SUCCESS
Verifying image bootflash:/i-1.3.0.104 -- SUCCESS
Extracting system version from image bootflash:/i-1.3.0.104. -- SUCCESS
Extracting kickstart version from image bootflash:/b-1.3.0.104. -- SUCCESS
Extracting loader version from image bootflash:/b-1.3.0.104. -- SUCCESS
21-99
Chapter 21 show in-order-guarantee
Show Commands
show in-order-guarantee
To display the present configured state of the in-order delivery feature, use the show in-order-guarantee command. show in-order-guarantee
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the present configuration status of the in-order delivery feature.
switch# show in-order-guarantee global inorder delivery configuration:guaranteed VSAN vsan vsan vsan vsan vsan vsan vsan vsan vsan vsan vsan vsan specific settings 1 inorder delivery:guaranteed 101 inorder delivery:not guaranteed 1000 inorder delivery:guaranteed 1001 inorder delivery:guaranteed 1682 inorder delivery:guaranteed 2001 inorder delivery:guaranteed 2009 inorder delivery:guaranteed 2456 inorder delivery:guaranteed 3277 inorder delivery:guaranteed 3451 inorder delivery:guaranteed 3452 inorder delivery:guaranteed 3453 inorder delivery:guaranteed
21-100
Chapter 21
Show Commands show interface
show interface
You can check the status of an interface at any time by using the show interface command. show interface [interface-range] [bbcredit | brief | counters [brief] | description | transceiver [calibrations | details] | trunk vsan [vsan-id]]
Syntax Description
interface-range bbcredit brief counters description transceiver calibrations details trunk vsan vsan-id
Displays the type of interface. Displays buffer-to-buffer credit information. Displays brief information. Displays the interface counter information. Displays the interface description. Displays the transceiver information for a specified interface. Displays transceiver calibration information for the specified interface. Displays detailed transceiver diagnostics information for the specified interface. Displays the trunking status of all VSANs. Displays the trunking status of the specified VSANs. The range is 1 to 4093.
Defaults
Displays information for all interfaces on the switch.
Command Modes
EXEC
Command History
Release 1.0(2) 1.3(1)
Modification This command was introduced. Added the bbcredit keyword and support for cpp and fv interfaces.
Usage Guidelines
You can specify a range of interfaces by issuing a command with the following example format: interface fc1/1 - 5 , fc2/5 - 7 The spaces are required before and after the dash ( - ) and before and after the comma ( , ). The show interface interface-type slot/port transceiver command can only be issued on a switch in the Cisco MDS 9100 Series if the SFP is present. Table 21-4 lists the interface types supported by the show interface command.
21-101
Chapter 21 show interface
Show Commands
Table 21-4 Interface Types for the show interface Command
Interface Type cpp slot/port fc slot/port fc-tunnel tunnel-id fcip interface-number fv slot/dpp-number/fv-port
Description Displays information for a virtualization interface specific to the ASM module. Displays the Fibre Channel interface in the specified slot/port. Displays description of the specified FC tunnel from 1 to 4095. Specifies a FCIP interface. The range is 1 to 255. Displays information for the virtual F port (FV port) interface in the specified slot along with the data path processor (DPP) number and the FV port number. Displays information for a Gigabit Ethernet interface at the specified slot and port. Displays information for a Gigabit Ethernet subinterface at the specified slot and port followed by a dot (.) indicator and the subinterface number. The subinterface range is 1 to 4093. Displays the description of the iSCSI interface in the specified slot and port. Displays the description of the management interface. Displays the PortChannel interface specified by the PortChannel number. The range is 1 to 128. Displays the PortChannel subinterface specified by the PortChannel number followed by a dot (.) indicator and the subinterface number. The port channel number range is 1 to 128. The subinterface range is 1 to 4093. Displays the in-band interface details. Displays information for a VSAN. The range is 1 to 4093.
gigabitethernet slot/port gigabitethernet slot/port. subinterface-number iscsi slot/port mgmt 0 port-channel port-channel-number port-channel port-channel-number .subinterface-number sup-fc 0 vsan vsan-id
Examples
The following example shows how to display information about a Fibre Channel interface.
switch# show interface fc1/11 fc1/11 is up Hardware is Fibre Channel Port WWN is 20:0b:00:05:30:00:59:de Admin port mode is ST Port mode is ST Port vsan is 1 Speed is 1 Gbps Rspan tunnel is fc-tunnel 100 Beacon is turned off 5 minutes input rate 248 bits/sec, 31 bytes/sec, 0 frames/sec 5 minutes output rate 176 bits/sec, 22 bytes/sec, 0 frames/sec 6862 frames input, 444232 bytes 0 discards, 0 errors 0 CRC, 0 unknown class 0 too long, 0 too short 6862 frames output, 307072 bytes 0 discards, 0 errors 0 input OLS, 0 LRR, 0 NOS, 0 loop inits 0 output OLS, 0 LRR, 0 NOS, 0 loop inits
21-102
Chapter 21
16 receive B2B credit remaining 3 transmit B2B credit remaining.
The following example shows how to display information about the in-band interface.
switch# show interface sup-fc0 sup-fc0 is up Hardware is FastEthernet, address is 0000.0000.0000 MTU 2596 bytes, BW 1000000 Kbit 66 packets input, 7316 bytes Received 0 multicast frames, 0 compressed 0 input errors, 0 frame, 0 overrun 0 fifo 64 packets output, 28068 bytes, 0 underruns 0 output errors, 0 collisions, 0 fifo 0 carrier errors
The following example shows how to display information about a VSAN interface.
switch# show interface vsan 2 vsan2 is up, line protocol is up WWPN is 10:00:00:05:30:00:59:1f, FCID is 0xb90100 Internet address is 10.1.1.1/24 MTU 1500 bytes, BW 1000000 Kbit 0 packets input, 0 bytes, 0 errors, 0 multicast 0 packets output, 0 bytes, 0 errors, 0 dropped
The following example shows how to display description information for all interfaces.
switch# show interface description fc1/1 no description fc1/2 no description fc1/15 fcAnl sup-fc0 is up mgmt0 is up vsan1 - IPFC interface port-channel 15 no description port-channel 98 no description
The following example shows how to display brief information for a range of interfaces.
switch# show interface fc2/1 - 5 brief ------------------------------------------------------------------------------Interface Vsan Admin Admin Status Oper Oper Port-channel Mode Trunk Mode Speed Mode (Gbps) ------------------------------------------------------------------------------fc1/1 1 auto on down ---fc1/2 1 auto on fcotAbsent ---fc1/3 1 F -notConnected ---fc1/4 1 auto on fcotAbsent ---fc1/5 1 F -up F 2 -fc1/6 1 auto on fcotAbsent ---fc1/7 1 auto on down ---fc1/8 1 auto on fcotAbsent ---fc1/9 1 auto on fcotAbsent ----
21-103
Show Commands
fc1/10 1 auto on fcotAbsent ---fc1/11 1 auto on down ---fc1/12 1 auto on fcotAbsent ---fc1/13 1 auto on down ---fc1/14 1 auto on fcotAbsent ---fc1/15 1 auto on down ---fc1/16 1 auto on fcotAbsent ---------------------------------------------------------------------------------Interface Status IP Address Speed MTU ------------------------------------------------------------------------------sup-fc0 up -1 Gbps 2596 ------------------------------------------------------------------------------Interface Status IP Address Speed MTU ------------------------------------------------------------------------------mgmt0 up 173.95.112/24 100 Mbps 1500 ------------------------------------------------------------------------------Interface Status IP Address Speed MTU ------------------------------------------------------------------------------vsan1 up 10.1.1.1/24 1 Gbps 1500
The following example shows how to display counter information for a FCIP interface.
switch# show interface fcip 3 counters fcip3 TCP Connection Information 2 Active TCP connections Control connection: Local 43.1.1.2:3225, Remote 43.1.1.1:65532 Data connection: Local 43.1.1.2:3225, Remote 43.1.1.1:65534 30 Attempts for active connections, 0 close of connections TCP Parameters Path MTU 1500 bytes Current retransmission timeout is 300 ms Round trip time: Smoothed 10 ms, Variance: 5 Advertised window: Current: 122 KB, Maximum: 122 KB, Scale: 1 Peer receive window: Current: 114 KB, Maximum: 114 KB, Scale: 1 Congestion window: Current: 2 KB, Slow start threshold: 1048560 KB 5 minutes input rate 64 bits/sec, 8 bytes/sec, 0 frames/sec 5 minutes output rate 64 bits/sec, 8 bytes/sec, 0 frames/sec 910 frames input, 84652 bytes 910 Class F frames input, 84652 bytes 0 Class 2/3 frames input, 0 bytes 0 Error frames timestamp error 0 908 frames output, 84096 bytes 908 Class F frames output, 84096 bytes 0 Class 2/3 frames output, 0 bytes 0 Error frames 0 reass frames
The following example shows how to display counter information for all interfaces.
switch# show interface counters brief ------------------------------------------------------------------------------Interface Input (rate is 5 min avg) Output (rate is 5 min avg) ----------------------------- ----------------------------Rate Total Rate Total MB/s Frames MB/s Frames ------------------------------------------------------------------------------fc9/1 0 0 0 0 fc9/2 0 0 0 0 fc9/3 0 0 0 0 fc9/4 0 0 0 0 ... ------------------------------------------------------------------------------Interface Input (rate is 5 min avg) Output (rate is 5 min avg)
21-104
Chapter 21
----------------------------- ----------------------------Rate Total Rate Total MB/s Frames MB/s Frames ------------------------------------------------------------------------------iscsi4/1 0 0 0 0 iscsi4/2 0 0 0 0 iscsi4/3 0 0 0 0 iscsi4/4 0 0 0 0 ... vsan10 is up, line protocol is up WWPN is 10:00:00:05:30:00:07:23, FCID is 0xee0001 Internet address is 10.1.1.5/24 MTU 1500 bytes, BW 1000000 Kbit 0 packets input, 0 bytes, 0 errors, 0 multicast 0 packets output, 0 bytes, 0 errors, 0 dropped ------------------------------------------------------------------------------Interface Input (rate is 5 min avg) Output (rate is 5 min avg) ----------------------------- ----------------------------Rate Total Rate Total MB/s Frames MB/s Frames ------------------------------------------------------------------------------port-channel 100 0 0 0 0
------------------------------------------------------------------------------Interface Input (rate is 5 min avg) Output (rate is 5 min avg) ----------------------------- ----------------------------Rate Total Rate Total Mbits/s Frames Mbits/s Frames ------------------------------------------------------------------------------fcip2 fcip3 fcip6 fcip7 0 9 8 8 0 0 0 0 0 9 8 8 0 0 0 0
The following example shows how to display information about a FCIP interface.
switch# show interface fcip 3 fcip3 is trunking Hardware is GigabitEthernet Port WWN is 20:ca:00:05:30:00:07:1e Peer port WWN is 20:ca:00:00:53:00:18:1e Admin port mode is auto, trunk mode is on Port mode is TE vsan is 1 Trunk vsans (allowed active) (1,10) Trunk vsans (operational) (1) Trunk vsans (up) (1) Trunk vsans (isolated) (10) Trunk vsans (initializing) () Using Profile id 3 (interface GigabitEthernet4/3) Peer Information Peer Internet address is 43.1.1.1 and port is 3225 Special Frame is disabled Maximum number of TCP connections is 2 Time Stamp is disabled B-port mode disabled TCP Connection Information 2 Active TCP connections Control connection: Local 43.1.1.2:3225, Remote 43.1.1.1:65532 Data connection: Local 43.1.1.2:3225, Remote 43.1.1.1:65534
21-105
Show Commands
30 Attempts for active connections, 0 close of connections TCP Parameters Path MTU 1500 bytes Current retransmission timeout is 300 ms Round trip time: Smoothed 10 ms, Variance: 5 Advertised window: Current: 122 KB, Maximum: 122 KB, Scale: 1 Peer receive window: Current: 114 KB, Maximum: 114 KB, Scale: 1 Congestion window: Current: 2 KB, Slow start threshold: 1048560 KB 5 minutes input rate 64 bits/sec, 8 bytes/sec, 0 frames/sec 5 minutes output rate 64 bits/sec, 8 bytes/sec, 0 frames/sec 866 frames input, 80604 bytes 866 Class F frames input, 80604 bytes 0 Class 2/3 frames input, 0 bytes 0 Error frames timestamp error 0 864 frames output, 80048 bytes 864 Class F frames output, 80048 bytes 0 Class 2/3 frames output, 0 bytes 0 Error frames 0 reass frames 16 receive B2B credit remaining 3 transmit B2B credit remaining.
The following example shows how to display information about a Gigabit Ethernet interface.
switch# show interface gigabitethernet 4/1 GigabitEthernet4/1 is up Hardware is GigabitEthernet, address is 0005.3000.2e12 Internet address is 100.1.1.2/24 MTU 1500 bytes, BW 1000000 Kbit Port mode is IPS Speed is 1 Gbps Beacon is turned off 5 minutes input rate 32 bits/sec, 4 bytes/sec, 0 frames/sec 5 minutes output rate 88 bits/sec, 11 bytes/sec, 0 frames/sec 637 packets input, 49950 bytes 0 multicast frames, 0 compressed 0 input errors, 0 frame, 0 overrun 0 fifo 659 packets output, 101474 bytes, 0 underruns 0 output errors, 0 collisions, 0 fifo 0 carrier errors
The following example shows how to display information about an iSCSI interface.
switch# show interface iscsi 2/1 iscsi2/1 is up Hardware is GigabitEthernet Port WWN is 20:41:00:05:30:00:50:de Admin port mode is ISCSI Port mode is ISCSI Speed is 1 Gbps iSCSI initiator is identified by name Number of iSCSI session: 7, Number of TCP connection: 7 Configured TCP parameters Local Port is 3260 PMTU discover is disabled Keepalive-timeout is 1 sec Minimum-retransmit-time is 300 ms Max-retransmissions 8 Sack is disabled Minimum available bandwidth is 0 kbps Estimated round trip time is 0 usec 5 minutes input rate 265184 bits/sec, 33148 bytes/sec, 690 frames/sec 5 minutes output rate 375002168 bits/sec, 46875271 bytes/sec, 33833 frames/sec iSCSI statistics 6202235 packets input, 299732864 bytes
21-106
Chapter 21
Command 6189718 pdus, Data-out 1937 pdus, 1983488 bytes, 0 fragments 146738794 packets output, 196613551108 bytes Response 6184282 pdus (with sense 4), R2T 547 pdus Data-in 140543388 pdus, 189570075420 bytes
The following example shows how to display transceiver information for a Fibre Channel interface.
switch# show interface fc2/5 transceiver fc2/5 fcot is present name is CISCO-INFINEON part number is V23848-M305-C56C revision is A3 serial number is 30000474 fc-transmitter type is short wave laser cisco extended id is unknown (0x0) SFP Diagnostics Information Temperature : 34.98 Celsius Voltage : 3.31 Volt Current : 7.24 mA Optical Tx Power : -5.99 dBm Optical Rx Power : -23.01 dBm Note: ++ high-alarm; + high-warning; --
low-alarm; -
low-warning
The following example shows how to display detailed transceiver information for a Fibre Channel interface.
switch# show interface fc2/5 transceiver details fc2/5 fcot is present name is CISCO-INFINEON part number is V23848-M305-C56C revision is A3 serial number is 30000474 fc-transmitter type is short wave laser cisco extended id is unknown (0x0) SFP Detail Diagnostics Information ---------------------------------------------------------------------------Alarms Warnings High Low High Low ---------------------------------------------------------------------------Temperature 34.98 C 105.00 C 211.00 C 100.00 C 216.00 C Voltage 3.31 V 3.71 V 2.80 V 3.64 V 2.97 V Current 7.24 mA 19.97 mA 3.07 mA 14.85 mA 4.61 mA Tx Power -5.99 dBm -3.00 dBm -10.51 dBm -4.00 dBm -9.51 dbm Rx Power -23.01 dBm 1.00 dBm -23.98 dBm 0.00 dBm -18.86 dBm ---------------------------------------------------------------------------Note: ++ high-alarm; + high-warning; -- low-alarm; - low-warning
The following example shows how to display calibration information for a Fibre Channel interface.
switch# show interface fc2/5 transceiver calibrations fc2/5 fcot is present name is CISCO-INFINEON part number is V23848-M305-C56C revision is A3 serial number is 30000474 fc-transmitter type is short wave laser cisco extended id is unknown (0x0) SFP is internally calibrated
21-107
Show Commands
The following example shows how to display information about a Fibre Channel tunnel interface.
switch# show interface fc-tunnel 200 fc-tunnel 200 is up Dest IP Addr: 200.200.200.7 Tunnel ID: 200 Source IP Addr: 200.200.200.4 LSP ID: 1 Explicit Path Name:
21-108
Chapter 21
Show Commands show inventory
show inventory
To display the system hardware inventory, use the show inventory command. show inventory
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
This command displays information about the field replaceable units (FRUs) in the switch, including product IDs, serial numbers, and version IDs.
Examples
The following example displays the system inventory information.

switch# show inventory NAME: "Chassis", DESCR: "MDS 9506 chassis" PID: DS-C9506 , VID: 0.1, SN: FOX0712S007 NAME: "Slot 1", DESCR: "2x1GE IPS, 14x1/2Gbps FC Module" PID: DS-X9302-14K9 , VID: 0.301, SN: JAB083100JY NAME: "Slot 5", DESCR: "Supervisor/Fabric-1" PID: DS-X9530-SF1-K9 , VID: 0.0, SN: JAB0747080H NAME: "Slot 6", DESCR: "Supervisor/Fabric-1" PID: DS-X9530-SF1-K9 , VID: 4.0, SN: JAB074004VE NAME: "Slot 17", DESCR: "MDS 9506 Power Supply" PID: DS-CAC-1900W , VID: 1.0, SN: DCA0702601V NAME: "Slot 18", DESCR: "MDS 9506 Power Supply" PID: DS-CAC-1900W , VID: 1.0, SN: DCA0702601U NAME: "Slot 19", DESCR: "MDS 9506 Fan Module" PID: DS-6SLOT-FAN , VID: 0.1, SN: FOX0638S150
21-109
Chapter 21 show ip access-list
Show Commands
show ip access-list
To display the IP access control lists (IP-ACLs) currently active, use the show ip access-list command. show ip access-list [list-number | usage]
Syntax Description
ip access-list list-number usage
Displays the information for all IP-ACLs. Identifies the IP-ACL with an integer ranging from 1 to 256. Specifies the interface type.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays configured IP-ACLs.

switch# show ip access-list usage Access List Name/Number Filters -------------------------------- ------abc 3 x1 3 x3 0 1 IF Status Creation Time ---- --------- ------------7 active Tue Jun 24 17:51:40 2003 1 active Tue Jun 24 18:32:25 2003 not-ready Tue Jun 24 18:32:28 2003
The following example displays a summary of the specified IP-ACL

switch# show ip access-list abc ip access-list abc permit tcp any any (0 matches) ip access-list abc permit udp any any (0 matches) ip access-list abc permit icmp any any (0 matches) ip access-list abc permit ip 10.1.1.0 0.0.0.255 (2 matches) ip access-list abc permit ip 10.3.70.0 0.0.0.255 (7 matches)
21-110
Chapter 21
Show Commands show ip route
show ip route
To display the ip routes currently active, use the show ip route command. show ip route [configured]
Syntax Description
configured
Displays configured IP routes.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays active IP routes.

switch# show ip route Codes: C - connected, S - static Default gateway is 172.22.95.1 C 10.0.0.0/24 is directly connected, vsan1 C 172.22.95.0/24 is directly connected, mgmt0
The following example displays configured IP routes.

switch# show ip route configured default 172.22.31.1 10.10.11.0 10.10.11.1 10.10.50.0 10.10.50.1 10.10.51.0 10.10.51.1 10.10.60.0 10.10.60.1 172.22.31.0 172.22.31.110 0.0.0.0 255.255.255.0 255.255.255.0 255.255.255.0 255.255.255.0 255.255.255.0 0 0 0 0 0 0 mgmt0 GigabitEthernet1/1 GigabitEthernet1/2.1 GigabitEthernet1/2.2 GigabitEthernet1/2 mgmt0
21-111
Chapter 21 show ip routing
Show Commands
show ip routing
To display the IP routing state, use the show ip routing command. show ip routing
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example the IP routing state.

switch# show ip routing ip routing is disabled
21-112
Chapter 21
Show Commands show ips arp
show ips arp

To display the IP storage ARP cache information, use the show ips arp command. show ips arp interface gigabitethernet slot/port
Syntax Description
interface gigabitethernet slot/port
Specifies a Gigabit Ethernet interface by the slot and port.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
Use the show ips arp interface gigabitethernet command to display the ARP cache on the Gigabit Ethernet interfaces. This command takes the main Ethernet interface and as a parameter and returns the ARP cache for that interface.
Examples
The following example displays ARP caches in the specified interface.

switch# show ips arp interface gigabitethernet 4/1 Protocol Address Age (min) Hardware Addr Type Protocol Address Age (min) Hardware Addr Type Internet 172.22.91.1 2 - 00:00:0c:07:ac:01 ARPA Internet 172.22.91.2 0 - 00:02:7e:6b:a8:08 ARPA Internet 172.22.91.17 0 - 00:e0:81:20:45:f5 ARPA Internet 172.22.91.18 0 - 00:e0:81:05:f7:64 ARPA Internet 172.22.91.30 0 - 00:e0:18:2e:9d:19 ARPA ... Interface Interface GigabitEthernet4/4 GigabitEthernet4/4 GigabitEthernet4/4 GigabitEthernet4/4 GigabitEthernet4/4
21-113
Chapter 21 show ips ip route
Show Commands
show ips ip route

To show the IP storage route table information, use the show ips ip route command. show ips ip route interface gigabitethernet slot/port
Syntax Description
interface gigabitethernet slot/port
Specifies a Gigabit Ethernet interface by the slot and port.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example displays the IP route table information for a Gigabit Ethernet interface.
switch# show ips ip route interface gigabitethernet 8/1 Codes: C - connected, S - static No default gateway C 10.1.3.0/24 is directly connected, GigabitEthernet8/1
21-114
Chapter 21
Show Commands show ips stats
show ips stats

To display IP storage statistics, use the show ips stats command. show ips stats {buffer | dma-bridge | icmp | ip | mac} interface gigabitethernet slot/port show ips stats {hw-comp | tcp} {all | interface gigabitethernet slot/port}
Syntax Description
buffer dma-bridge icmp ip mac hw-comp tcp all interface gigabitethernet slot/port
Displays IP storage buffer information. Displays the direct memory access (DMA) statistics. Displays ICMP statistics. Displays IP statistics. Displays MAC statistics. Displays hardware compression statistics. Displays TCP statistics Displays statistical information for all interfaces. Specifies a Gigabit Ethernet interface by the slot and port.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
Use the show ips stats icmp interface gigabitethernet command to obtain ICMP statistics for the selected interface. Use the show ips stats ip interface gigabitethernet 2/1 command to obtain IP statistics for the selected interface. Use the show ips stats mac interface gigabitethernet command to obtain Ethernet statistics for the selected interface. Use the show ips stats tcp interface gigabitethernet command to obtain TCP stats along with the connection list and TCP state or the selected interface.
21-115
Chapter 21 show ips stats
Show Commands
Examples The following example displays iSCSI buffer statistics.
switch# show ips stats buffer interface gigabitethernet 1/2 Buffer Statistics for port GigabitEthernet1/2 Mbuf stats 164248 total mbufs, 82119 free mbufs, 0 mbuf alloc failures 123186 mbuf high watermark, 20531 mbuf low watermark 0 free shared mbufs, 0 shared mbuf alloc failures 82124 total clusters, 77005 free clusters, 0 cluster alloc failures 86230 mbuf high watermark, 78017 mbuf low watermark 0 free shared clusters, 0 shared cluster alloc failures Ether channel stats 0 tcp segments sent, 0 tcp segments received 0 xmit packets sent, 0 xmit packets received 0 config packets sent, 0 config packets received 0 MPQ packet send errors
The following example displays ICMP statistics.

switch# show ips stats icmp interface gigabitethernet 8/1 ICMP Statistics for port GigabitEthernet8/1 2 ICMP messages received 0 ICMP messages dropped due to errors ICMP input histogram 2 echo request ICMP output histogram 2 echo reply
The following example displays IP statistics.

switch# show ips stats ip interface gigabitethernet 8/1 Internet Protocol Statistics for port GigabitEthernet8/1 22511807 total received, 22509468 good, 2459 error 0 reassembly required, 0 reassembled ok, 0 dropped after timeout 27935633 packets sent, 0 outgoing dropped, 0 dropped no route 0 fragments created, 0 cannot fragment
The following example displays MAC statistics.

switch# show ips stats mac interface gigabitethernet 8/1 Ethernet MAC statistics for port GigabitEthernet8/1 Hardware Transmit Counters 28335543 frame 37251751286 bytes 0 collisions, 0 late collisions, 0 excess collisions 0 bad frames, 0 FCS error, 0 abort, 0 runt, 0 oversize Hardware Receive Counters 18992406778 bytes, 22835370 frames, 0 multicasts, 2584 broadcasts 0 bad, 0 runt, 0 CRC error, 0 length error 0 code error, 0 align error, 0 oversize error Software Counters 22835370 received frames, 28335543 transmit frames 0 frames soft queued, 0 current queue, 0 max queue 0 dropped, 0 low memory
21-116
Chapter 21
Show Commands show ips stats
The following example displays TCP statistics.
switch# show ips stats tcp interface gigabitethernet 8/1 TCP Statistics for port GigabitEthernet8/1 Connection Stats 0 active openings, 0 accepts 0 failed attempts, 0 reset received, 0 established Segment stats 23657893 received, 29361174 sent, 0 retransmitted 0 bad segments received, 0 reset sent TCP Active Connections Local Address 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 10.1.3.3:3260 0.0.0.0:3260
Remote Address 10.1.3.106:51935 10.1.3.106:51936 10.1.3.106:51937 10.1.3.106:51938 10.1.3.106:51939 10.1.3.106:51940 10.1.3.106:51941 10.1.3.106:51942 10.1.3.106:51943 10.1.3.106:51944 10.1.3.115:1026 10.1.3.115:1027 10.1.3.115:1028 10.1.3.115:1029 10.1.3.115:1030 10.1.3.115:1031 10.1.3.115:1032 10.1.3.115:1033 10.1.3.115:1034 0.0.0.0:0
State ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH ESTABLISH LISTEN
Send-Q 0 0 0 0 0 0 0 0 0 0 0 0 0 0 48 48 0 0 0 0
Recv-Q 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
21-117
Chapter 21 show ips status
Show Commands
show ips status

To display the IP storage status, use the show ips status command. show ips status [module slot]
Syntax Description
module slot
Identifies the module in the specified slot.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example displays the IP storage status for all modules on the switch.
switch# show Port Port Port Port Port Port Port Port ips 8/1 8/2 8/3 8/4 8/5 8/6 8/7 8/8 status READY READY READY READY READY READY READY READY
The following example displays the IP storage status for the module in slot 9.
switch# show Port Port Port Port Port Port Port Port ips 9/1 9/2 9/3 9/4 9/5 9/6 9/7 9/8 status module 9 READY READY READY READY READY READY READY READY
...
21-118
Chapter 21
Show Commands show iscsi global
show iscsi global

To display global iSCSI configured information, use the show iscsi global command. show iscsi global
Syntax Description
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example displays all configured iSCSI initiators.

switch# show iscsi global iSCSI Global information Authentication:CHAP, NONE Import FC Target:Enabled Number of target nodes:11 Number of portals:8 Number of sessions:10 Failed sessions:9, Last failed initiator name:iqn.1987-05.com.cisco:02.0163c91bbc28.host1
21-119
Chapter 21 show iscsi initiator
Show Commands
show iscsi initiator

To display information about all the iSCSI nodes that are remote to the switch, use the show iscsi initiator command. show iscsi initiator [configured [initiator-name] | detail | fcp-session [detail] | iscsi-session [detail] | summary [name]]
Syntax Description
configured initiator-name detail fcp-session iscsi-session summary name
Displays the configured information for the iSCSI initiator. Specifies the name of an initiator. Displays detailed iSCSI initiator information. Displays the Fibre Channel session details. Displays iSCSI session details. Displays summary information. Displays initiator name information.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
If no parameter is provided the command lists all the active iSCSI initiators. If the iSCSI node name is provided then the command lists the details of that iSCSI initiator.
Examples
The following example displays all iSCSI initiators.

switch# show iscsi initiator iSCSI Node name is iqn.1987-05.com.cisco.01.15cee6e7925087abc82ed96377653c8 iSCSI alias name: iscsi7-lnx Node WWN is 23:10:00:05:30:00:7e:a0 (dynamic) Member of vsans: 1 Number of Virtual n_ports: 1 Virtual Port WWN is 23:12:00:05:30:00:7e:a0 (dynamic) Interface iSCSI 8/3, Portal group tag: 0x382 VSAN ID 1, FCID 0xdc0100 iSCSI Node name is iqn.1987-05.com.cisco:02.91b0ee2e8aa1.iscsi16-w2k iSCSI alias name: ISCSI16-W2K Node WWN is 23:1f:00:05:30:00:7e:a0 (dynamic) Member of vsans: 1 Number of Virtual n_ports: 1 Virtual Port WWN is 23:28:00:05:30:00:7e:a0 (dynamic) Interface iSCSI 8/3, Portal group tag: 0x382 VSAN ID 1, FCID 0xdc0101
21-120
Chapter 21
Show Commands show iscsi initiator
iSCSI Node name is iqn.1987-05.com.cisco.01.b6ca466f8b4d8e848ab17e92f24bf9cc iSCSI alias name: iscsi6-lnx Node WWN is 23:29:00:05:30:00:7e:a0 (dynamic) Member of vsans: 1, 2, 3, 4 Number of Virtual n_ports: 1 Virtual Port WWN is 23:2a:00:05:30:00:7e:a0 (dynamic) Interface iSCSI 8/3, Portal group tag: 0x382 VSAN ID 4, FCID 0xee0000 VSAN ID 3, FCID 0xee0100 VSAN ID 2, FCID 0xee0000 VSAN ID 1, FCID 0xdc0102 ...
The following example displays detailed Information for all iSCSI initiators.
switch# show iscsi initiator detail iSCSI Node name is iqn.1987-05.com.cisco.01.15cee6e7925087abc82ed96377653c8 iSCSI alias name: iscsi7-lnx Node WWN is 23:10:00:05:30:00:7e:a0 (dynamic) Member of vsans: 1 Number of Virtual n_ports: 1 Virtual Port WWN is 23:10:00:05:30:00:7e:a0 (dynamic) Interface iSCSI 8/3, Portal group tag is 0x382 VSAN ID 1, FCID 0xdc0100 No. of FC sessions: 3 No. of iSCSI sessions: 2 iSCSI session details Target node: iqn.com.domainname.172.22.93.143.08-03.gw.22000020374b5247 Statistics: PDU: Command: 0, Response: 0 Bytes: TX: 0, RX: 0 Number of connection: 1 TCP parameters Connection Local 10.1.3.3:3260, Remote 10.1.3.107:34112 Path MTU 1500 bytes Current retransmission timeout is 300 ms Round trip time: Smoothed 2 ms, Variance: 1 Advertised window: Current: 6 KB, Maximum: 6 KB, Scale: 3 Peer receive window: Current: 250 KB, Maximum: 250 KB, Scale: 2 Congestion window: Current: 8 KB Target node: iqn.com.domainname.172.22.93.143.08-03.gw.22000020374b5247 Statistics: PDU: Command: 0, Response: 0 Bytes: TX: 0, RX: 0 Number of connection: 1 TCP parameters Connection Local 10.1.3.3:3260, Remote 10.1.3.107:34112 Path MTU 1500 bytes Current retransmission timeout is 300 ms Round trip time: Smoothed 2 ms, Variance: 1 Advertised window: Current: 6 KB, Maximum: 6 KB, Scale: 3 Peer receive window: Current: 250 KB, Maximum: 250 KB, Scale: 2 Congestion window: Current: 8 KB ...
21-121
Chapter 21 show iscsi session
Show Commands
show iscsi session

To display iSCSI session information, use the show iscsi session command. show iscsi session [incoming] [initiator name] [outgoing] [target name] [detail]
Syntax Description
detail incoming initiator name outgoing target name
Displays detailed iSCSI session information. Displays incoming iSCSI sessions. Displays specific iSCSI initiator session information. Maximum length is 80 characters. Displays outgoing iSCSI sessions Displays specific iSCSI target session information. Maximum length is 80 characters.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
All the parameters are optional in the show iscsi session commands. If no parameter is provided the command lists all the active iSCSI initiator or target sessions. If the IP address or iSCSI node name is provided, then the command lists details of all sessions from that initiator or to that target.
Examples
The following command displays the iSCSI session information.

switch# show iscsi session Initiator iqn.1987-05.com.cisco.01.15cee6e7925087abc82ed96377653c8 Session #1 Target iqn.com.domainname.172.22.93.143.08-03.gw.22000020374b5247 VSAN 1, ISID 000000000000, Status active, no reservation Session #2 Target iqn.com.domainname.172.22.93.143.08-03.gw.220000203738e77d VSAN 1, ISID 000000000000, Status active, no reservation Initiator iqn.1987-05.com.cisco:02.91b0ee2e8aa1.iscsi16-w2k Session #1 Discovery session, ISID 00023d00022f, Status active Session #2 Target iqn.com.domainname.172.22.93.143.08-03.gw.2200002037388bc2 VSAN 1, ISID 00023d000230, Status active, no reservation ...
21-122
Chapter 21
Show Commands show iscsi session
The following command displays the specified iSCSI target.
switch# show iscsi session target iqn.com.domainname.172.22.93.143.08-03.gw.220000203738e77d Initiator iqn.1987-05.com.cisco.01.15cee6e7925087abc82ed96377653c8 Session #1 Target iqn.com.domainname.172.22.93.143.08-03.gw.220000203738e77d VSAN 1, ISID 000000000000, Status active, no reservation
Note
On the IPS module, you can verify what iSCSI initiator IQN has been assigned which pWWN when it logs in by using the show zone active vsan vsan-id command.
switch# zone name iscsi_16_A vsan 16 * fcid 0x7700d4 [pwwn 21:00:00:20:37:c5:2d:6d] * fcid 0x7700d5 [pwwn 21:00:00:20:37:c5:2e:2e] * fcid 0x770100 [symbolic-nodename iqn.1987-05.com.cisco.02.BC3FEEFC431B199F81F33E97E2809C14.NUYEAR]
The following command displays the specified iSCSI initiator.

switch# show iscsi session initiator iqn.1987-05.com.cisco:02.91b0ee2e8aa1.iscsi16-w2k Initiator iqn.1987-05.com.cisco:02.91b0ee2e8aa1.iscsi16-w2k Session #1 Discovery session, ISID 00023d00022f, Status active Session #2 Target iqn.com.domainname.172.22.93.143.08-03.gw.2200002037388bc2 VSAN 1, ISID 00023d000230, Status active, no reservation Session #3 Target iqn.com.domainname.172.22.93.143.08-03.gw.210000203739ad7f VSAN 1, ISID 00023d000235, Status active, no reservation Session #4 Target iqn.com.domainname.172.22.93.143.08-03.gw.210000203739aa3a VSAN 1, ISID 00023d000236, Status active, no reservation Session #5 Target iqn.com.domainname.172.22.93.143.08-03.gw.210000203739ada7 VSAN 1, ISID 00023d000237, Status active, no reservation Session #6 Target iqn.com.domainname.172.22.93.143.08-03.gw.2200002037381ccb VSAN 1, ISID 00023d000370, Status active, no reservation Session #7 Target iqn.com.domainname.172.22.93.143.08-03.gw.2200002037388b54 VSAN 1, ISID 00023d000371, Status active, no reservation Session #8 Target iqn.com.domainname.172.22.93.143.08-03.gw.220000203738a194 VSAN 1, ISID 00023d000372, Status active, no reservation Session #9 Target iqn.com.domainname.172.22.93.143.08-03.gw.2200002037360053 VSAN 1, ISID 00023d000373, Status active, no reservation
21-123
Chapter 21 show iscsi stats
Show Commands
show iscsi stats

To display the iSCSI statistics information, use the show iscsi stats command. show iscsi stats [iscsi slot/port] [clear | detail]
Syntax Description
iscsi slot/port clear detail
Displays statistics for the specified iSCSI interface. Clears iSCSI statistics for the session or interface. Displays detailed iSCSI statistics for the session or interface.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following command displays brief iSCSI statistics.

switch# show iscsi stats iscsi8/1 5 minutes input rate 23334800 bits/sec, 2916850 bytes/sec, 2841 frames/sec 5 minutes output rate 45318424 bits/sec, 5664803 bytes/sec, 4170 frames/sec iSCSI statistics 86382665 packets input, 2689441036 bytes 3916933 Command pdus, 82463404 Data-out pdus, 2837976576 Data-out bytes, 0 fragments 131109319 packets output, 2091677936 bytes 3916876 Response pdus (with sense 0), 1289224 R2T pdus 125900891 Data-in pdus, 93381152 Data-in bytes iscsi8/2 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec iSCSI statistics 0 packets input, 0 bytes 0 Command pdus, 0 Data-out pdus, 0 Data-out bytes, 0 fragments 0 packets output, 0 bytes 0 Response pdus (with sense 0), 0 R2T pdus 0 Data-in pdus, 0 Data-in bytes iscsi8/3 5 minutes input rate 272 bits/sec, 34 bytes/sec, 0 frames/sec 5 minutes output rate 40 bits/sec, 5 bytes/sec, 0 frames/sec iSCSI statistics 30 packets input, 10228 bytes 0 Command pdus, 0 Data-out pdus, 0 Data-out bytes, 0 fragments 30 packets output, 1744 bytes
21-124
Chapter 21
Show Commands show iscsi stats
0 Response pdus (with sense 0), 0 R2T pdus 0 Data-in pdus, 0 Data-in bytes iscsi8/4 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec iSCSI statistics 0 packets input, 0 bytes 0 Command pdus, 0 Data-out pdus, 0 Data-out bytes, 0 fragments 0 packets output, 0 bytes 0 Response pdus (with sense 0), 0 R2T pdus 0 Data-in pdus, 0 Data-in bytes iscsi8/5 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec iSCSI statistics 0 packets input, 0 bytes 0 Command pdus, 0 Data-out pdus, 0 Data-out bytes, 0 fragments 0 packets output, 0 bytes 0 Response pdus (with sense 0), 0 R2T pdus 0 Data-in pdus, 0 Data-in bytes iscsi8/6 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec iSCSI statistics 0 packets input, 0 bytes 0 Command pdus, 0 Data-out pdus, 0 Data-out bytes, 0 fragments 0 packets output, 0 bytes 0 Response pdus (with sense 0), 0 R2T pdus 0 Data-in pdus, 0 Data-in bytes iscsi8/7 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec iSCSI statistics 0 packets input, 0 bytes 0 Command pdus, 0 Data-out pdus, 0 Data-out bytes, 0 fragments 0 packets output, 0 bytes 0 Response pdus (with sense 0), 0 R2T pdus 0 Data-in pdus, 0 Data-in bytes iscsi8/8 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec iSCSI statistics 0 packets input, 0 bytes 0 Command pdus, 0 Data-out pdus, 0 Data-out bytes, 0 fragments 0 packets output, 0 bytes 0 Response pdus (with sense 0), 0 R2T pdus 0 Data-in pdus, 0 Data-in bytes
The following command displays detailed iSCSI statistics.

switch# show iscsi stats detail iscsi8/1 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec iSCSI statistics 0 packets input, 0 bytes 0 Command pdus, 0 Data-out pdus, 0 Data-out bytes, 0 fragments 0 packets output, 0 bytes 0 Response pdus (with sense 0), 0 R2T pdus
21-125
Chapter 21 show iscsi stats
Show Commands
0 Data-in pdus, 0 Data-in bytes iSCSI Forward: Command: 0 PDUs (Received: 0) Data-Out (Write): 0 PDUs (Received 0), 0 fragments, 0 bytes FCP Forward: Xfer_rdy: 0 (Received: 0) Data-In: 0 (Received: 0), 0 bytes Response: 0 (Received: 0), with sense 0 TMF Resp: 0 iSCSI Stats: Login: attempt: 0, succeed: 0, fail: 0, authen fail: 0 Rcvd: NOP-Out: 0, Sent: NOP-In: 0 NOP-In: 0, Sent: NOP-Out: 0 TMF-REQ: 0, Sent: TMF-RESP: 0 Text-REQ: 0, Sent: Text-RESP: 0 SNACK: 0 Unrecognized Opcode: 0, Bad header digest: 0 Command in window but not next: 0, exceed wait queue limit: 0 Received PDU in wrong phase: 0 FCP Stats: Total: Sent: 0 Received: 0 (Error: 0, Unknown: 0) Sent: PLOGI: 0, Rcvd: PLOGI_ACC: 0, PLOGI_RJT: 0 PRLI: 0, Rcvd: PRLI_ACC: 0, PRLI_RJT: 0, Error resp: 0 LOGO: 0, Rcvd: LOGO_ACC: 0, LOGO_RJT: 0 ABTS: 0, Rcvd: ABTS_ACC: 0 TMF REQ: 0 Self orig command: 0, Rcvd: data: 0, resp: 0 Rcvd: PLOGI: 0, Sent: PLOGI_ACC: 0 LOGO: 0, Sent: LOGO_ACC: 0 PRLI: 0, Sent: PRLI_ACC: 0 ABTS: 0 iSCSI Drop: Command: Target down 0, Task in progress 0, LUN map fail 0 CmdSeqNo not in window 0, No Exchange ID 0, Reject 0 Persistent Resv 0 Data-Out: 0, TMF-Req: 0 FCP Drop: Xfer_rdy: 0, Data-In: 0, Response: 0 Buffer Stats: Buffer less than header size: 0, Partial: 0, Split: 0 Pullup give new buf: 0, Out of contiguous buf: 0, Unaligned m_data: 0 iscsi8/2 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec iSCSI statistics 0 packets input, 0 bytes 0 Command pdus, 0 Data-out pdus, 0 Data-out bytes, 0 fragments 0 packets output, 0 bytes 0 Response pdus (with sense 0), 0 R2T pdus 0 Data-in pdus, 0 Data-in bytes iSCSI Forward: Command: 0 PDUs (Received: 0) Data-Out (Write): 0 PDUs (Received 0), 0 fragments, 0 bytes FCP Forward: Xfer_rdy: 0 (Received: 0) Data-In: 0 (Received: 0), 0 bytes Response: 0 (Received: 0), with sense 0 ...
21-126
Chapter 21
Show Commands show iscsi stats
The following command displays detailed statistics for the specified iSCSI interface.
switch# show iscsi stats iscsi 8/1 iscsi8/1 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec iSCSI statistics 0 packets input, 0 bytes 0 Command pdus, 0 Data-out pdus, 0 Data-out bytes, 0 fragments 0 packets output, 0 bytes 0 Response pdus (with sense 0), 0 R2T pdus 0 Data-in pdus, 0 Data-in bytes
21-127
Chapter 21 show iscsi virtual-target
Show Commands
show iscsi virtual-target

To display all the iSCSI nodes that are local to the switch, use the show iscsi virtual-target command. show iscsi virtual-target [configured] [name]
Syntax Description
configured name
Show the information for all iSCSI ports. Show iSCSI information for the specified virtual-target.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
If no parameter is provided the command lists all the active iSCSI virtual targets. If the iSCSI node name is provided then the command lists the details of that iSCSI virtual target.
Examples
The following example displays information on all the iSCSI virtual targets.
switch# show iscsi virtual-target target: abc1 Port WWN 21:00:00:20:37:a6:b0:bf Configured node target: iqn.com.domainname.172.22.93.143.08-03.gw.22000020374b5247 Port WWN 22:00:00:20:37:4b:52:47 , VSAN 1 Auto-created node ... target: iqn.com.domainname.172.22.93.143.08-03.gw.210000203739aa39 Port WWN 21:00:00:20:37:39:aa:39 , VSAN 1 Auto-created node
The following example displays a specified iSCSI virtual target.

switch# show iscsi virtual-target iqn.com.domainname.172.22.93.143.08-03.gw.210000203739a95b target: iqn.com.domainname.172.22.93.143.08-03.gw.210000203739a95b Port WWN 21:00:00:20:37:39:a9:5b , VSAN 1 Auto-created node
The following example displays the trespass status for a virtual target.
switch# show iscsi virtual-target iqn.abc target: abc Port WWN 00:00:00:00:00:00:00:00 Configured node all initiator permit is disabled trespass support is enabled S
21-128
Chapter 21
Show Commands show isns
show isns
To display Internet Storage Name Service (iSNS) information, use the show isns command. show isns {config | database [full | virtual-targets [local | switch switch-wwn]] | entity [all [detail] | id entity-id] | iscsi global config [all | switch switch-wwn]] | node [all [detail] | configured | detail | name node-name | virtual [switch switch-wwn [detail]]] | portal [all [detail] | detail | ipaddress ip-address port tcp-port | virtual [switch switch-wwn [detail]]] | profile [profile-name [counters] | counters] | query profile-name {gigabitethernet slot/port | port-channel port} | stats}
Syntax Description
config database full virtual-targets local switch switch-wwn entity all detail id entity-id iscsi global config node configured name node-name virtual portal ipaddress ip-address port tcp-port profile profile-name counters query profile-name gigabitethernet slot/port port-channel port stats
Displays iSNS server configuration. Displays the iSNS database contents. Specifies all virtual targets or registered nodes in database. Specifies just virtual targets. Specifies only local virtual targets. Specifies a specific switch WWN. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number. Displays entity attributes. Specifies all information. Specifies detailed information. Specifies an entity ID. Maximum length is 255. Displays iSCSI global configuration for import of Fibre Channel targets. Displays node attributes. Specifies configured nodes with detailed information. Specifies the node name. Maximum length is 255. Specifies virtual targets. Displays portal attributes. Specifies the IP address for the portal. Specifies the TCP port for the portal. The range is 1 to 66535. Displays iSNS profile information. Specifies a profile name. Maximum length is 64 characters. Specifies statistics for the interfaces. Specifies a query to send to the iSNS server. Specifies a Gigabit Ethernet interface. Specifies a PortChannel interface. The range is 1 to 128. Displays iSNS server statistics.
21-129
Chapter 21 show isns
Show Commands
Defaults None.
Command Modes
EXEC mode.
Command History
Release 1.3(1) 2.0(1b)
Modification This command was introduced. Added config, database, entity, iscsi, node, portal, and stats options.
Usage Guidelines
To access all but the profile and query options for this command, you must perform the isns-server enable command.
Examples
The following example shows how to display the iSNS configuration.

switch# show isns config Server Name: ips-hac1(Cisco Systems) Up since: Mon Apr 27 06:59:49 1981 Index: 1 Version: 1 TCP Port: 3205 fabric distribute (remote sync): ON ESI Non Response Threshold: 5 Interval(seconds): 60 Database contents Number of Entities: 1 Number of Portals: 0 Number of ISCSI devices: 2 Number of Portal Groups: 0
The following example displays a specified iSNS profile.

switch# show isns profile ABC iSNS profile name ABC tagged interface GigabitEthernet2/3 iSNS Server 10.10.100.204
The following example displays all iSNS profiles

switch# show isns profile iSNS profile name ABC tagged interface GigabitEthernet2/3 iSNS Server 10.10.100.204 iSNS profile name NBV tagged interface GigabitEthernet2/5 iSNS Server 10.10.100.201
21-130
Chapter 21
Show Commands show isns
The following example displays iSNS PDU statistics for a specified iSNS profile.
switch# show isns profile ABC counters iSNS profile name ABC tagged interface GigabitEthernet2/3 iSNS statistics Input 54 pdus (registration/deregistration pdus only) Reg pdus 37, Dereg pdus 17 Output 54 pdus (registration/deregistration pdus only) Reg pdus 37, Dereg pdus 17 iSNS Server 10.10.100.204
The following example displays iSNS PDU statistics for all iSNS profiles.
switch# show isns profile counters iSNS profile name ABC tagged interface GigabitEthernet2/3 iSNS statistics Input 54 pdus (registration/deregistration pdus only) Reg pdus 37, Dereg pdus 17 Output 54 pdus (registration/deregistration pdus only) Reg pdus 37, Dereg pdus 17 iSNS Server 10.10.100.204
iSNS profile name NBV tagged interface GigabitEthernet2/5 iSNS statistics Input 54 pdus (registration/deregistration pdus only) Reg pdus 37, Dereg pdus 17 Output 54 pdus (registration/deregistration pdus only) Reg pdus 37, Dereg pdus 17 iSNS Server 10.10.100.201
Related Commands
Command isns-server enable
Description Enables the iSNS server.
21-131
Chapter 21 show ivr
Show Commands
show ivr
To display various Inter-VSAN Routing (IVR) configurations, use the show ivr command. show ivr [pending | pending-diff | service-group database | status | virtual-domains [vsan vsan-id] | virtual-fcdomain-add-status | vsan-topology [active | configured] | zone [active | name name [active]] | zoneset [active | brief | fabric | name name | status]]
Syntax Description
pending pending-diff vsan vsan-id service-group database status virtual-domains
Displays the IVR pending configuration. Displays the IVR pending configuration differences with the active configuration. Specifies a VSAN ID. The range is 1 to 4093. Displays the status and configuration of the IVR service group database. Displays the status of the configured IVR feature. Displays IVR virtual domains for all local VSANs.
virtual-fcdomain-add- Displays IVR virtual fcdomain status. status vsan-topology active configured zone name name zoneset brief fabric Displays the IVR VSAN topology Displays the active IVR facilities. Displays the configured IVR facilities Displays the Inter-VSA Zone (IVZ) configurations. Specifies the name as configured in the database. Displays the Inter-VSA Zone Set (IVZS) configurations. Displays configured information in brief format. Displays the status of active zone set in the fabric.
Defaults
None.
Command Modes
EXEC
Command History
Release 1.3(1) 2.0(1b) 2.1(1a)
Modification This command was introduced. Added the pending and pending-diff keywords. Added the service-group keywords.
Usage Guidelines
To access this command, you must perform the ivr enable command.
21-132
Chapter 21
Show Commands show ivr
Examples The following example displays the status of the IVR virtual domain configuration.
switch# show ivr virtual-fcdomain-add-status IVR virtual domains are added to fcdomain list in VSANS: 1 (As well as to VSANs in interoperability mode 2 or 3)
The following example displays IVR-enabled switches for a specified VSAN

switch# show ivr enabled-switches vsan 2 AFID VSAN DOMAIN CAPABILITY SWITCH WWN -----------------------------------------------------------------1 2 0x62( 98) 00000001 20:00:00:05:30:01:1b:c2 * Total: 1 ivr-enabled VSAN-Domain pair>
The following example displays IVR service group database configuration.

switch# show ivr service-group database SG-ID SG-NAME AFID VSANS ------------------------------------------------------------------------1 IVR-SG1 10 1-2,6-10 1 IVR-SG1 11 1
Total: 2 entries in service group table
The following example displays the status of the IVR feature

switch# show ivr status Inter-VSAN Routing is enabled
The following example displays the configured IVR VSAN topology

switch# show ivr vsan-topology AFID SWITCH WWN Active Cfg. VSANS -------------------------------------------------------------1 20:00:00:05:30:00:3c:5e yes yes 3,2000 1 20:00:00:05:30:00:58:de yes yes 2,2000 1 20:00:00:05:30:01:1b:c2 * yes yes 1-2 1 20:02:00:44:22:00:4a:05 yes yes 1-2,6 1 20:02:00:44:22:00:4a:07 yes yes 2-5 Total: 5 entries in active and configured IVR VSAN-Topology
Current Status: Inter-VSAN topology is ACTIVE Last activation time: Sat Mar 22 21:46:15 1980
The following example displays the active IVR VSAN topology

switch# show ivr vsan-topology active AFID SWITCH WWN Active Cfg. VSANS -------------------------------------------------------------1 20:00:00:05:30:00:3c:5e yes yes 3,2000 1 20:00:00:05:30:00:58:de yes yes 2,2000 1 20:00:00:05:30:01:1b:c2 * yes yes 1-2 1 20:02:00:44:22:00:4a:05 yes yes 1-2,6 1 20:02:00:44:22:00:4a:07 yes yes 2-5 Total: 5 entries in active IVR VSAN-Topology
Current Status: Inter-VSAN topology is ACTIVE Last activation time: Sat Mar 22 21:46:15
21-133
Chapter 21 show ivr
Show Commands
The following example displays the configured IVR VSAN topology
switch# show ivr vsan-topology configured AFID SWITCH WWN Active Cfg. VSANS -------------------------------------------------------------1 20:00:00:05:30:00:3c:5e yes yes 3,2000 1 20:00:00:05:30:00:58:de yes yes 2,2000 1 20:00:00:05:30:01:1b:c2 * yes yes 1-2 1 20:02:00:44:22:00:4a:05 yes yes 1-2,6 1 20:02:00:44:22:00:4a:07 yes yes 2-5 Total: 5 entries in configured IVR VSAN-Topology
The following example displays the combined user-defined and the automatically discovered IVR VSAN topology database.
switch(config)# show ivr vsan-topology AFID SWITCH WWN Active Cfg. VSANS -------------------------------------------------------------1 20:00:00:0d:ec:04:99:00 yes no 1-4 1 20:00:00:0d:ec:0e:9c:80 * yes no 2,6-7,9 1 20:00:00:0d:ec:0e:b0:40 yes no 1-3,5,8 1 20:00:00:0d:ec:04:99:00 no yes 1-4 1 20:00:00:0d:ec:0e:9c:80 * no yes 2,6-7,9 1 20:00:00:0d:ec:0e:b0:40 no yes 1-3,5,8
Total:
6 entries in active and configured IVR VSAN-Topology
Table 21-5 describes the significant fields shown in the show ivr vsan-topology display.
Table 21-5 show ivr vsan-topology Field Descriptions
Field AFID Switch WWN Active Cfg. VSANS
Description Autonomous fabric ID (AFID) Switch world wide number Automatically discovered Manually configured VSANs configured
The following example displays the IVZ configuration

switch# show ivr zone zone name Ivz_vsan2-3 pwwn 21:00:00:e0:8b:02:ca:4a vsan 3 pwwn 21:00:00:20:37:c8:5c:6b vsan 2 zone name ivr_qa_z_all pwwn 21:00:00:e0:8b:06:d9:1d pwwn 21:01:00:e0:8b:2e:80:93 pwwn 10:00:00:00:c9:2d:5a:dd pwwn 10:00:00:00:c9:2d:5a:de pwwn 21:00:00:20:37:5b:ce:af pwwn 21:00:00:20:37:39:6b:dd pwwn 22:00:00:20:37:39:6b:dd pwwn 22:00:00:20:37:5b:ce:af pwwn 50:06:04:82:bc:01:c3:84
vsan vsan vsan vsan vsan vsan vsan vsan vsan
1 4 1 2 6 6 3 3 5
21-134
Chapter 21
Show Commands show ivr
The following example displays the active IVZS configuration
switch# show ivr zoneset active zoneset name IVR_ZoneSet1 zone name Ivz_vsan2-3 pwwn 21:00:00:e0:8b:02:ca:4a vsan 3 pwwn 21:00:00:20:37:c8:5c:6b vsan 2
The following example displays information for a specified IVZ

switch# show ivr zone name Ivz_vsan2-3 zone name Ivz_vsan2-3 pwwn 21:00:00:e0:8b:02:ca:4a vsan 3 pwwn 21:00:00:20:37:c8:5c:6b vsan 2
The following example displays the specified zone in the active IVZS
switch# show ivr zone name Ivz_vsan2-3 active zone name Ivz_vsan2-3 pwwn 21:00:00:e0:8b:02:ca:4a vsan 3 pwwn 21:00:00:20:37:c8:5c:6b vsan 2
The following example displays the IVZS configuration

switch# show ivr zoneset zoneset name ivr_qa_zs_all zone name ivr_qa_z_all pwwn 21:00:00:e0:8b:06:d9:1d pwwn 21:01:00:e0:8b:2e:80:93 pwwn 10:00:00:00:c9:2d:5a:dd pwwn 10:00:00:00:c9:2d:5a:de pwwn 21:00:00:20:37:5b:ce:af pwwn 21:00:00:20:37:39:6b:dd pwwn 22:00:00:20:37:39:6b:dd pwwn 22:00:00:20:37:5b:ce:af pwwn 50:06:04:82:bc:01:c3:84
vsan vsan vsan vsan vsan vsan vsan vsan vsan
1 4 1 2 6 6 3 3 5
zoneset name IVR_ZoneSet1 zone name Ivz_vsan2-3 pwwn 21:00:00:e0:8b:02:ca:4a vsan 3 pwwn 21:00:00:20:37:c8:5c:6b vsan 2
The following example displays brief information for an IVR VSAN topology
switch# show ivr vsan-topology configured AFID SWITCH WWN Active Cfg. VSANS -------------------------------------------------------------1 20:00:00:05:30:00:3c:5e yes yes 3,2000 1 20:00:00:05:30:00:58:de yes yes 2,2000 1 20:00:00:05:30:01:1b:c2 * yes yes 1-2 1 20:02:00:44:22:00:4a:05 yes yes 1-2,6 1 20:02:00:44:22:00:4a:07 yes yes 2-5 Total: 5 entries in configured IVR VSAN-Topology
The following example displays brief information for the active IVZS
switch# show ivr zoneset brief Active zoneset name IVR_ZoneSet1 zone name Ivz_vsan2-3
21-135
Chapter 21 show ivr
Show Commands
The following example displays the status information for the IVZ
switch# show ivr zoneset Zoneset Status ______________ name : state : last activate time : force option : status per vsan: __________________ vsan status ____ ______ 2 active brief status
IVR_ZoneSet1 activation success Sat Mar 22 21:38:46 1980 off
The following example displays the specified zone set

switch# show ivr zoneset name IVR_ZoneSet1 zoneset name IVR_ZoneSet1 zone name Ivz_vsan2-3 pwwn 21:00:00:e0:8b:02:ca:4a vsan 3 pwwn 21:00:00:20:37:c8:5c:6b vsan 2
Related Commands
Command ivr distribute ivr enable
Description Enables IVR CFS distribution. Enables IVR.
21-136
Chapter 21
Show Commands show kernel core
show kernel core

To display kernel core configuration information, use the show kernel core command. show kernel core {limit | module slot | target}
Syntax Description
limit module slot target
Displays the configured line card limit. Displays the kernel core configuration for a module in the specified slot. Displays the configured target IP address.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following examples display kernel core settings.

switch# show kernel core limit 2 switch# show kernel core target 10.50.5.5 switch# show kernel core module 5 module 5 core is enabled level is header dst_ip is 10.50.5.5 src_port is 6671 dst_port is 6666 dump_dev_name is eth1 dst_mac_addr is 00:00:0C:07:AC:01
21-137
Chapter 21 show license
Show Commands
show license
To display license information, use the show license command. show license [brief | file filename | host-id license-name | usage]
Syntax Description
brief file filename host-id license-name usage
Displays a list of license files installed on a switch. Displays information for a specific license file. Displays host ID used to request node-locked license. Displays information about the current license usage.
Defaults
None.
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following example displays a specific license installed on a switch.

switch# show license file fcports.lic fcports.lic: SERVER this_host ANY VENDOR cisco FEATURE fcports cisco 1.000 permanent 30 HOSTID=VDH=4C0AF664 \ SIGN=24B2B68AA676 <------------------------- fcport license
The following example displays a list of license files installed on a switch.

switch# show license brief fcports.lic ficon.lic
The following example displays all licenses installed on a switch.

switch# show license fcports.lic: SERVER this_host ANY VENDOR cisco FEATURE fcports cisco 1.000 permanent 30 HOSTID=VDH=4C0AF664 \ SIGN=24B2B68AA676 <-------------------------fcport license ficon.lic: FEATURE ficon cisco 1.000 permanent uncounted HOSTID=VDH=4C0AF664 \ SIGN=CB7872B23700 <-----------------------------ficon license
21-138
Chapter 21
Show Commands show license
The following example displays the host IDs, required to request node locked license.
switch# show license host-id License hostid:VDH=4C0AF664
21-139
Chapter 21 show line
Show Commands
show line
To configure a virtual terminal line, use the show line command. show line [com1 [user-input-string] | console [connected | user-input-string]]
Syntax Description
com1 user-input-string console connected
Displays aux line configuration. Displays the user-input initial string. Displays console line configuration. Displays the physical connection status.
Defaults
None.
Command Modes
EXEC.
Command History
Usage Guidelines
None.
Examples
The following example displays configured console settings.

switch## show line console line Console: Speed: 38400 bauds Databits: 8 bits per byte Stopbits: 1 bit(s) Parity: none
The following example displays configured or default COM1 settings.

switch# show line com1 line Aux: Speed: 9600 bauds Databits: 8 bits per byte Stopbits: 1 bit(s) Parity: none Modem In: Enable Modem Init-String default : ATE0Q1&D2&C1S0=1\015 Statistics: tx:17 rx:0 Register Bits:RTS|CTS|DTR|DSR|CD|RI
21-140
Chapter 21
Show Commands show line
Related Commands Command line console line aux clear line Description Configure primary terminal line. Configures the auxiliary COM 1 port Deleted configured line sessions.
21-141
Chapter 21 show logging
Show Commands
show logging
To display the current message logging configuration, use the show logging command. show logging [console | info | last lines | level facility | logfile | module | monitor| nvram [last lines] | pending | pending-diff | server | status]
Syntax Description
console info last lines level facility
Displays console logging configuration. Displays logging configuration. Displays last few lines of logfile. The range is 1 to 9999. Displays facility logging configuration. Facility values include aaa, acl, auth, authpriv, bootvar, callhome, cdp, cfs, cimserver, cron, daemon, device-alias, dstats, ethport, fc2d, fcc, fcd, fcdomain, fcns, fcsp-mgr, fdmi, ficon, flogi, fspf, ftp, ike, ipacl, ipconf, ipfc, ips, ipsec, isns, kernel, license, localn, lpr, mail, mcast, module, news, platform, port, port-security, qos, radius, rdl, rib, rlir, rscn, scsi-target, security, syslog, sysmgr, systemhealth, tacacs, tlport, user, uucp, vni, vrrp-cfg, vsan, vshd, wwm, xbar, zone. Displays contents of logfile. Displays module logging configuration. Displays monitor logging configuration. Displays NVRAM log. Displays the server address pending configuration. Displays the server address pending configuration differences with the active configuration. Displays server logging configuration. Displays the status of the last operation.
logfile module monitor nvram pending pending-diff server status
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.3(1) 2.0(1b)
Modification This command was introduced. Added the pending, pending-diff, and status keywords.
Usage Guidelines
None.
21-142
Chapter 21
Show Commands show logging
Examples The following example displays current system message logging.
switch# show logging Logging console: enabled (Severity: notifications) Logging monitor: enabled (Severity: information) Logging linecard: enabled (Severity: debugging) Logging server: enabled {172.22.0.0} server severity: debugging server facility: local7 {172.22.0.0} server severity: debugging server facility: local7 Logging logfile: enabled Name - external/sampleLogFile: Severity - notifications Size - 3000000 syslog_get_levels :: Error(-1) querying syslog_get_levels :: Error(-1) querying Facility Default Severity ----------------------kern 6 user 3 mail 3 daemon 7 auth 0 syslog 3 lpr 3 news 3 uucp 3 cron 3 authpriv 3 ftp 3 local0 3 local1 3 local2 3 local3 3 local4 3 local5 3 local6 3 local7 3 fspf 3 fcdomain 2 module 5 zone 2 vni 2 ipconf 2 ipfc 2 xbar 3 fcns 2 fcs 2 acl 2 tlport 2 port 5 port_channel 5 fcmpls 0 wwn 3 fcc 2 qos 3 vrrp_cfg 2 fcfwd 0 ntp 2 platform 5 vrrp_eng 2 severity values for fcmpls at SAP 30 severity values for fcfwd at SAP 38 Current Session Severity -----------------------4 3 3 7 0 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 2 5 2 2 2 2 3 2 2 2 2 5 5 0 3 2 3 2 0 2 5 2
21-143
Show Commands
callhome mcast rscn securityd vhbad rib vshd 0(emergencies) 3(errors) 6(information) Nov from Nov from 2 2 2 2 2 2 5 1(alerts) 4(warnings) 7(debugging) 2 2 2 2 2 2 5 2(critical) 5(notifications)
8 16:48:04 excal-113 %LOG_VSHD-5-VSHD_SYSLOG_CONFIG_I: Configuring console pts/1 (171.71.58.56) 8 17:44:09 excal-113 %LOG_VSHD-5-VSHD_SYSLOG_CONFIG_I: Configuring console pts/0 (171.71.58.72)
The following example displays console logging status.

switch# show logging console Logging console: enabled (Severity: notifications)
The following example displays logging facility status.

switch# show logging facility syslog_get_levels :: Error(-1) querying syslog_get_levels :: Error(-1) querying Facility Default Severity ----------------------kern 6 user 3 mail 3 daemon 7 auth 0 syslog 3 lpr 3 news 3 uucp 3 cron 3 authpriv 3 ftp 3 local0 3 local1 3 local2 3 local3 3 local4 3 local5 3 local6 3 local7 3 fspf 3 fcdomain 2 module 5 zone 2 vni 2 ipconf 2 ipfc 2 xbar 3 fcns 2 fcs 2 acl 2 tlport 2 port 5 port_channel 5 fcmpls 0 severity values for fcmpls at SAP 30 severity values for fcfwd at SAP 38 Current Session Severity -----------------------4 3 3 7 0 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 2 5 2 2 2 2 3 2 2 2 2 5 5 0
21-144
Chapter 21
wwn fcc qos vrrp_cfg fcfwd ntp platform vrrp_eng callhome mcast rscn securityd vhbad rib vshd 0(emergencies) 3(errors) 6(information) 3 2 3 2 0 2 5 2 2 2 2 2 2 2 5 1(alerts) 4(warnings) 7(debugging) 3 2 3 2 0 2 5 2 2 2 2 2 2 2 5 2(critical) 5(notifications)
The following example displays logging information.

switch# show logging info Logging console: enabled (Severity: notifications) Logging monitor: enabled (Severity: information) Logging linecard: enabled (Severity: debugging) Logging server: enabled {172.22.95.167} server severity: debugging server facility: local7 {172.22.92.58} server severity: debugging server facility: local7 Logging logfile: enabled Name - external/sampleLogFile: Severity - notifications Size - 3000000 syslog_get_levels :: Error(-1) querying syslog_get_levels :: Error(-1) querying Facility Default Severity ----------------------kern 6 user 3 mail 3 daemon 7 auth 0 syslog 3 lpr 3 news 3 uucp 3 cron 3 authpriv 3 ftp 3 local0 3 local1 3 local2 3 local3 3 local4 3 local5 3 local6 3 local7 3 fspf 3 fcdomain 2 module 5 severity values for fcmpls at SAP 30 severity values for fcfwd at SAP 38 Current Session Severity -----------------------4 3 3 7 0 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 2 5
21-145
Show Commands
zone vni ipconf ipfc xbar fcns fcs acl tlport port port_channel fcmpls wwn fcc qos vrrp_cfg fcfwd ntp platform vrrp_eng callhome mcast rscn securityd vhbad rib vshd 0(emergencies) 3(errors) 6(information) 2 2 2 2 3 2 2 2 2 5 5 0 3 2 3 2 0 2 5 2 2 2 2 2 2 2 5 1(alerts) 4(warnings) 7(debugging) 2 2 2 2 3 2 2 2 2 5 5 0 3 2 3 2 0 2 5 2 2 2 2 2 2 2 5 2(critical) 5(notifications)
The following example displays last few lines of a log file.

switch# show logging last 2 Nov 8 16:48:04 excal-113 %LOG_VSHD-5-VSHD_SYSLOG_CONFIG_I: Configuring console from pts/1 (171.71.58.56) Nov 8 17:44:09 excal-113 %LOG_VSHD-5-VSHD_SYSLOG_CONFIG_I: Configuring console from pts/0 (171.71.58.72)
The following example displays switching module logging status.

switch# show logging module Logging linecard: enabled (Severity: debugging)
The following example displays monitor logging status.

switch# show logging monitor Logging monitor: enabled (Severity: information)
The following example displays server information.

switch# show logging server Logging server: {172.22.95.167} server severity: server facility: {172.22.92.58} server severity: server facility: enabled debugging local7 debugging local7
21-146
Chapter 21
Related Commands Command logging Description Configures logging parameters.
21-147
Chapter 21 show mcast
Show Commands
show mcast
To display multicast information, use the show mcast command. show mcast [vsan vsan-id]
Syntax Description
vsan vsan-id
Displays information for a VSAN. The range is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example displays multicast information.

switch# show mcast Multicast root for VSAN 1 Configured root mode : Principal switch Operational root mode : Principal switch Root Domain ID : 0x15(21)
Multicast root for VSAN 73 Configured root mode : Principal switch Operational root mode : Principal switch Root Domain ID : 0x65(101)
Multicast root for VSAN 99 Configured root mode : Principal switch Operational root mode : Principal switch Root Domain ID : 0xe4(228)
Multicast root for VSAN 4002 Configured root mode : Principal switch Operational root mode : Principal switch Root Domain ID : 0x78(120)
21-148
Chapter 21
Show Commands show mcast
Multicast root for VSAN 4004 Configured root mode : Principal switch Operational root mode : Lowest domain switch Root Domain ID : 0x01(1)
Related Commands
Command mcast root
Description Configures the multicast root VSAN.
21-149
Chapter 21 show module
Show Commands
show module
To verify the status of a module, use the show module command. show module [slot | diag | uptime]
Syntax Description
slot diag uptime
Specifies the slot number for the module. Displays module-related information. Displays the length of time that the modules have been functional in the switch.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
If your chassis has more than one switching module, you will see the progress check if you issue the show module command several times and view the status column each time. The switching module goes through a testing and an initializing stage before displaying an ok status. The following table describes the possible states in which a module can exist. show module Output
powered up
Description The hardware has electrical power. When the hardware is powered up, the software begins booting. The module has established connection with the supervisor and the switching module is performing bootup diagnostics. The diagnostics have passed and the configuration is being downloaded. The switch detects a switching module failure on initialization and automatically attempts to power-cycle the module three (3) times. After the third attempt it continues to display a failed state. The switch is ready to be configured. The switch detects insufficient power for a switching module to power up. In this case, issue a show environment power command to determine power consumption issues.
testing
initializing failure
ok power-denied
active
This module is the active supervisor module and the switch is ready to be configured.
21-150
Chapter 21
Show Commands show module
show module Output
HA-standby
Description This module is the standby supervisor module and that the HA switchover mechanism is enabled. This module is the standby supervisor module.
standby
Use the uptime option to display the time that a specified supervisor module, switching module, or services module is functional in the switch. This time is computed from the time a module goes online after a disruptive upgrade or reset.
Examples
The following example displays information about the modules on the switch.
switch# show module Mod Ports Module-Type --- ----- ------------------------------2 32 Advanced Services Module 4 32 Advanced Services Module 5 0 Supervisor/Fabric-1 6 0 Supervisor/Fabric-1 8 32 1/2 Gbps FC Module Mod --5 6 8 Sw ----------1.2(2) 1.2(2) 1.2(2) Hw -----0.610 0.610 0.3 Model -----------------DS-X9032-SMV DS-X9032-SMV DS-X9530-SF1-K9 DS-X9530-SF1-K9 DS-X9032 Status -----------powered-dn powered-dn active * ha-standby ok
World-Wide-Name(s) (WWN) ---------------------------------------------------21:c1:00:0b:46:79:f1:40 to 21:e0:00:0b:46:79:f1:40
Mod --5 6 8
MAC-Address(es) -------------------------------------00-d0-97-38-b4-01 to 00-d0-97-38-b4-05 00-d0-97-38-b3-f9 to 00-d0-97-38-b3-fd 00-05-30-00-2b-e2 to 00-05-30-00-2b-e6
Serial-Num ---------JAB06350B0H JAB06350B1R jab062407x4
* this terminal session
The following example displays diagnostic information about the modules on the switch.
switch# show module diag Diag status for module 2 (. = PASS, F = FAIL, N = N/A) CPU . SPROM . ASICS . Diag status for module 4 (. = PASS, F = FAIL, N = N/A) CPU . SPROM . ASICS .
The following example displays uptime information about the modules on the switch.
switch# show module uptime ------ Module 1 ----Module Start Time: Wed Apr 14 18:12:48 2004 Up Time: 16 days, 5 hours, 59 minutes, 41 seconds ------ Module 6 ----Module Start Time: Wed Apr 14 18:11:57 2004 Up Time: 16 days, 6 hours, 0 minutes, 32 second
21-151
Chapter 21 show nasb
Show Commands
show nasb
To display the Network-Accelerated Serverless Backup (NASB) configuration on the Storage Services Module (SSM), use the show nasb command in EXEC mode. show nasb [module slot] [vsan vsan-id]
Syntax Description
module slot vsan vsan-id
Specifies the slot number with the SSM where NASB is configured. Displays information for the specified VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.1(1a)
Usage Guidelines
None.
Examples
The following example displays the NASB configuration on all SSM modules in the switch.
switch# show NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module provisioned) NASB: module provisioned) NASB: module provisioned) NASB: module provisioned) NASB: module provisioned) nasb 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 4 vsan 8 vsan 1:DPP-1, 1:DPP-2, 1:DPP-3, 1:DPP-4, 1:DPP-5, 1:DPP-6, 1:DPP-7, 1:DPP-8, 3:DPP-1, 3:DPP-2, 3:DPP-3, 3:DPP-4, 3:DPP-5, 3:DPP-6, 3:DPP-7, 3:DPP-8, 3:DPP-1, VT-nWWN=2700000530002926, VT-nWWN=2702000530002926, VT-nWWN=2704000530002926, VT-nWWN=2706000530002926, VT-nWWN=2708000530002926, VT-nWWN=270a000530002926, VT-nWWN=270c000530002926, VT-nWWN=270e000530002926, VT-nWWN=26f0000530002926, VT-nWWN=26f2000530002926, VT-nWWN=26f4000530002926, VT-nWWN=26f6000530002926, VT-nWWN=26f8000530002926, VT-nWWN=26fa000530002926, VT-nWWN=26fc000530002926, VT-nWWN=26fe000530002926, VT-nWWN=2500000530002926, pWWN=2701000530002926 pWWN=2703000530002926 pWWN=2705000530002926 pWWN=2707000530002926 pWWN=2709000530002926 pWWN=270b000530002926 pWWN=270d000530002926 pWWN=270f000530002926 pWWN=26f1000530002926 pWWN=26f3000530002926 pWWN=26f5000530002926 pWWN=26f7000530002926 pWWN=26f9000530002926 pWWN=26fb000530002926 pWWN=26fd000530002926 pWWN=26ff000530002926 pWWN=2501000530002926 (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (not
8 vsan 3:DPP-2, VT-nWWN=2502000530002926, pWWN=2503000530002926 (not 8 vsan 3:DPP-3, VT-nWWN=2504000530002926, pWWN=2505000530002926 (not 8 vsan 3:DPP-4, VT-nWWN=2506000530002926, pWWN=2507000530002926 (not 8 vsan 3:DPP-5, VT-nWWN=2508000530002926, pWWN=2509000530002926 (not
21-152
Chapter 21
Show Commands show nasb
NASB: module 8 vsan 3:DPP-6, VT-nWWN=250a000530002926, pWWN=250b000530002926 (not provisioned) NASB: module 8 vsan 3:DPP-7, VT-nWWN=250c000530002926, pWWN=250d000530002926 (not provisioned) NASB: module 8 vsan 3:DPP-8, VT-nWWN=250e000530002926, pWWN=250f000530002926 (not provisioned)
The following example displays the NASB configuration on the SSM in slot 4.
switch# show NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module nasb module 4 4 vsan 1:DPP-1, 4 vsan 1:DPP-2, 4 vsan 1:DPP-3, 4 vsan 1:DPP-4, 4 vsan 1:DPP-5, 4 vsan 1:DPP-6, 4 vsan 1:DPP-7, 4 vsan 1:DPP-8, 4 vsan 3:DPP-1, 4 vsan 3:DPP-2, 4 vsan 3:DPP-3, 4 vsan 3:DPP-4, 4 vsan 3:DPP-5, 4 vsan 3:DPP-6, 4 vsan 3:DPP-7, 4 vsan 3:DPP-8, VT-nWWN=2700000530002926, VT-nWWN=2702000530002926, VT-nWWN=2704000530002926, VT-nWWN=2706000530002926, VT-nWWN=2708000530002926, VT-nWWN=270a000530002926, VT-nWWN=270c000530002926, VT-nWWN=270e000530002926, VT-nWWN=26f0000530002926, VT-nWWN=26f2000530002926, VT-nWWN=26f4000530002926, VT-nWWN=26f6000530002926, VT-nWWN=26f8000530002926, VT-nWWN=26fa000530002926, VT-nWWN=26fc000530002926, VT-nWWN=26fe000530002926, pWWN=2701000530002926 pWWN=2703000530002926 pWWN=2705000530002926 pWWN=2707000530002926 pWWN=2709000530002926 pWWN=270b000530002926 pWWN=270d000530002926 pWWN=270f000530002926 pWWN=26f1000530002926 pWWN=26f3000530002926 pWWN=26f5000530002926 pWWN=26f7000530002926 pWWN=26f9000530002926 pWWN=26fb000530002926 pWWN=26fd000530002926 pWWN=26ff000530002926 (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned)
The following example displays the NASB configuration on the SSM in slot 4 and VSAN 1.
switch# show NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module NASB: module nasb module 4 vsan 1 4 vsan 1:DPP-1, VT-nWWN=2700000530002926, 4 vsan 1:DPP-2, VT-nWWN=2702000530002926, 4 vsan 1:DPP-3, VT-nWWN=2704000530002926, 4 vsan 1:DPP-4, VT-nWWN=2706000530002926, 4 vsan 1:DPP-5, VT-nWWN=2708000530002926, 4 vsan 1:DPP-6, VT-nWWN=270a000530002926, 4 vsan 1:DPP-7, VT-nWWN=270c000530002926, 4 vsan 1:DPP-8, VT-nWWN=270e000530002926, pWWN=2701000530002926 pWWN=2703000530002926 pWWN=2705000530002926 pWWN=2707000530002926 pWWN=2709000530002926 pWWN=270b000530002926 pWWN=270d000530002926 pWWN=270f000530002926 (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned) (provisioned)
Table 21-6 describes the significant fields shown in the display.

Table 21-6 show nasb Field Descriptions
Field tpc module vsan DPPVT-nWWN= pWWN= provisioned not provisioned
Description Displays the slot number of the SSM. Displays the VSAN number in the database associated to the NASB process. Displays which of the eight data path processors (DPP) is forwarding the data. Displays the virtual target (VT) node WWN associated with this XCopy LUN. Displays the port WWN associated with this XCopy LUN. Implies the range of FC slot/port-port interfaces has been enabled using the ssm enable feature nasb command. Implies the range of FC slot/port-port interfaces has not been enabled using the ssm enable feature nasb command.
21-153
Chapter 21 show nasb
Show Commands
Related Commands Command nasb module Description Enables TPC on a VSAN and maps it to the SSM where the feature has been enabled.
21-154
Chapter 21
Show Commands show ntp
show ntp
To display the configured Network Time Protocol (NTP) server and peer associations, use the show ntp command. show ntp {peers | pending peers | pending-diff | session-status | statistics [io | local | memory | peer {ipaddr ip-address | name peer-name}] | timestamp-status}
Syntax Description
peers pending peers pending-diff session-status statistics io local memory peer ipaddr ip-address name peer-name timestamp-status
Displays all the peers. Displays pending NTP configuration changes on all peers. Displays the differences between the pending NTP configuration changes and the active NTP configuration. Displays the Cisco Fabric Services (CFS) session status. Displays the NTP statistics Displays the input/output statistics. Displays the counters maintained by the local NTP. Displays the statistics counters related to memory code. Displays the per-peer statistics counter of a peer. Displays the peer statistics for the specified IP address. Displays the peer statistics for the specified peer name. Displays if the timestamp check is enabled.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.0(2) 2.0(1b)
Modification This command was introduced. Added the pending, pending-diff, and session-status keywords.
Usage Guidelines
None.
Examples
The following example displays the NTP peer information.

switch# show ntp peers -------------------------------------------Peer IP Address Serv/Peer -------------------------------------------10.20.10.2 Server 10.20.10.0 Peer
21-155
Chapter 21 show ntp
Show Commands
The following example displays the NTP IO statistics.
switch# show ntp statistics io time since reset: 11152 receive buffers: 9 free receive buffers: 9 used receive buffers: 9 low water refills: 0 dropped packets: 0 ignored packets: 0 received packets: 3 packets sent: 2 packets not sent: 0 interrupts handled: 3 received by int: 3
The following example displays the NTP local statistics.

switch# show ntp statistics local system uptime: 11166 time since reset: 11166 bad stratum in packet: 0 old version packets: 4 new version packets: 0 unknown version number: 0 bad packet format: 0 packets processed: 0 bad authentication: 0
The following example displays the NTP memory statistics information.

switch# show ntp statistics time since reset: 11475 total peer memory: 15 free peer memory: 15 calls to findpeer: 0 new peer allocations: 0 peer demobilizations: 0 hash table counts: 0 0 0 0 memory
0 0 0 0
0 0 0 0
0 0 0 0
0 0 0 0
0 0 0 0
0 0 0 0
0 0 0 0
The following example displays the NTP peer statistics information using the IP address of the peer.
switch# show ntp statistics peer ipaddr 10.1.1.1
The following example displays the NTP peer statistics information using the name of the peer.
switch# show ntp statistics peer name Peer1
The following example displays the NTP timestamp status information.

switch# show ntp timestamp-status Linecard 9 does not support Timestamp check.
Related Commands
Command ntp
Description Configures NTP parameters.
21-156
Chapter 21
Show Commands show port-channel
show port-channel
Use the show port-channel command to view information about existing PortChannel configurations show port-channel {compatibility-parameters | consistency [detail] | database [interface port-channel port-channel-number] | summary | usage}
Syntax Description
compatibility-parameters Displays compatibility parameters. consistency detail database interface port-channel port-channel-number summary usage Displays the database consistency information of all modules. Displays detailed database consistency information. Displays PortChannel database information. Specifies the PortChannel number. The range is 1 to 128. Displays PortChannel summary. Displays PortChannel number usage.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the PortChannel summary.

switch# show port-channel summary NEW
The following example displays the PortChannel compatibility.

switch# show port-channel compatibility-parameters physical port layer fibre channel or ethernet port mode E/TE/AUTO only trunk mode speed port VSAN port allowed VSAN list
21-157
Chapter 21 show port-channel
Show Commands
The following example displays the PortChannel database.
switch# show port-channel database port-channel 2 Administrative channel mode is on Operational channel mode is on Last membership update succeeded First operational port is fc2/2 1 port in total, 1 port up Ports: fc2/2 [up]
The show port-channel consistency command has two optionswithout detail and detail. Command Without Details
switch# show port-channel consistency Database is consistent switch#
Command With Details

switch# show port-channel consistency detail Authoritative port-channel database: ================================================ totally 1 port-channels port-channel 2: 1 ports, first operational port is fc2/2 fc2/2 [up] ================================================ database 1: from module 5 ================================================ totally 1 port-channels port-channel 2: 1 ports, first operational port is fc2/2 fc2/2 [up] ================================================ database 2: from module 2 ================================================ totally 1 port-channels port-channel 2: 1 ports, first operational port is fc2/2 fc2/2 [up] ================================================
The show port-channel usage command displays details of the used and unused PortChannel numbers. PortChannel Usage
switch# show port-channel usage Totally 2 port-channel numbers used ==================================== Used : 3, 9 Unused: 1-2, 4-8, 10-128
21-158
Chapter 21
Show Commands show port-security
show port-security
To display configured port security feature information, use the show port-security database command. show port-security {database [active [vsan vsan-id]] | fwwn fwwn-id vsan vsan-id | interface {fc slot/port | port-channel port} vsan vsan-id | vsan vsan-id] | pending [vsan vsan-id] | pending-diff [vsan vsan-id] | statistics [vsan vsan-id] | status [vsan vsan-id] | violations [last count | vsan vsan-id]}
Syntax Description
database active vsan vsan-id fwwn fwwn-id interface fc slot/port port-channel port pending pending-diff statistics status violations last count
Displays database-related port security information. Displays the activated database information. Displays information for the specified database. Displays information for the specified fabric WWN. Displays information for an interface. Displays information for the specified Fibre Channel interface. Displays information for the specified PortChannel interface. The range is 1 to 128. Displays the server address pending configuration. Displays the server address pending configuration differences with the active configuration. Displays port security statistics. Displays the port security status on a per VSAN basis. Displays violations in the port security database. Displays the last number of lines in the database. The range is 1 to 100.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.2(1) 2.0(1b)
Modification This command was introduced. Added the pending and pending-diff keywords.
Usage Guidelines
The access information for each port can be individually displayed. If you specify the fwwn or interface options, all devices that are paired in the active database (at that point) with the given fWWN or the interface are displayed.
21-159
Chapter 21 show port-security
Show Commands
The show port-security command issued with the last number option displays only the specified number of entries that appear first.
Examples
The following example displays the contents of the port security database.
switch# show port-security database --------------------------------------------------------------------------------------VSAN Logging-in Entity Logging-in Point( Interface) ---------------------------------------------------------------------------------------1 21:00:00:e0:8b:06:d9:1d(pwwn) 20:0d:00:05:30:00:95:de(fc1/13) 1 50:06:04:82:bc:01:c3:84(pwwn) 20:0c:00:05:30:00:95:de(fc1/12) 2 20:00:00:05:30:00:95:df(swwn) 20:0c:00:05:30:00:95:de(port-channel 128) 3 20:00:00:05:30:00:95:de(swwn) 20:01:00:05:30:00:95:de(fc1/1) [Total 4 entries]
The following example displays the output of the active port security database in VSAN 1.
switch# show port-security database vsan 1 -------------------------------------------------------------------------------Vsan Logging-in Entity Logging-in Point (Interface) -------------------------------------------------------------------------------1 * 20:85:00:44:22:00:4a:9e (fc3/5) 1 20:11:00:33:11:00:2a:4a(pwwn) 20:81:00:44:22:00:4a:9e (fc3/1) [Total 2 entries]
The following example displays the active database.

switch# show port-security database active --------------------------------------------------------------------------------------VSAN Logging-in Entity Logging-in Point( Interface) Learnt ---------------------------------------------------------------------------------------1 21:00:00:e0:8b:06:d9:1d(pwwn) 20:0d:00:05:30:00:95:de(fc1/13) Yes 1 50:06:04:82:bc:01:c3:84(pwwn) 20:0c:00:05:30:00:95:de(fc1/12) Yes 2 20:00:00:05:30:00:95:df(swwn) 20:0c:00:05:30:00:95:de(port-channel 128) Yes 3 20:00:00:05:30:00:95:de(swwn) 20:01:00:05:30:00:95:de(fc1/1) [Total 4 entries]
The following example displays the wildcard fwwn port security in VSAN 1.
switch# show port-security database fwwn 20:85:00:44:22:00:4a:9e vsan 1 Any port can login thru' this fwwn
The following example displays the configured fWWN port security in VSAN 1.
switch# show port-security database fwwn 20:01:00:05:30:00:95:de vsan 1 20:00:00:0c:88:00:4a:e2(swwn)
The following example displays the interface port information in VSAN 2.

switch# show port-security database interface fc 1/1 vsan 2 20:00:00:0c:88:00:4a:e2(swwn)
The following example displays the port security statistics.

switch# show port-security statistics Statistics For VSAN: 1 -----------------------Number of pWWN permit: 2 Number of nWWN permit: 2 Number of sWWN permit: 2 Number of pWWN deny : 0 Number of nWWN deny : 0 Number of sWWN deny : 0
21-160
Chapter 21
Show Commands show port-security
Total Logins permitted : 4 Total Logins denied : 0 Statistics For VSAN: 2 -----------------------Number of pWWN permit: 0 Number of nWWN permit: 0 Number of sWWN permit: 2 Number of pWWN deny : 0 Number of nWWN deny : 0 Number of sWWN deny : 0 ...
The following example displays the status of the active database and the autolearn configuration.
switch# show port-security status VSAN 1 :Activated database, auto-learning is enabled VSAN 2 :No Active database, auto-learning is disabled ...
The following example displays the previous 100 violations.

switch# show port-security violations -----------------------------------------------------------------------------------------VSAN Interface Logging-in Entity Last-Time [Repeat count] -----------------------------------------------------------------------------------------1 fc1/13 21:00:00:e0:8b:06:d9:1d(pwwn) Jul 9 08:32:20 2003 [20] 20:00:00:e0:8b:06:d9:1d(nwwn) 1 fc1/12 50:06:04:82:bc:01:c3:84(pwwn) Jul 9 08:32:20 2003 [1] 50:06:04:82:bc:01:c3:84(nwwn) 2 port-channel 1 20:00:00:05:30:00:95:de(swwn) Jul 9 08:32:40 2003 [1] [Total 2 entries]
Related Commands
Command port-security
Description Configures port security parameters.
21-161
Chapter 21 show processes
Show Commands
show processes
To display general information about all the processes, use the show processes command. show processes [cpu | log [details | pid process-id] | memory]
Syntax Description
cpu log details pid process-id memory
Displays processes CPU information. Displays information about process logs. Displays detailed process log information. Displays process information about a specific process ID. The range is 0 to 2147483647. Displays processes memory information.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following examples display general information about system processes.

switch# show process PID State PC ----- ----- -------868 S 2ae4f33e 869 S 2acee33e 870 S 2ac36c24 871 S 2ac44c24 872 S 2ac7a33e ER NR PID: process ID. State: process state D R S T Z NR ER uninterruptible sleep (usually IO) runnable (on run queue) sleeping traced or stopped a defunct (zombie) process Start_cnt ----------1 1 1 1 1 1 0 TTY ---Process ------------snmpd rscn qos port-channel ntp mdog vbuilder
not-running should be running but currently not-running
21-162
Chapter 21
Show Commands show processes
PC: Current program counter in hex format Start_cnt: how many times a process has been started. TTY: Terminal that controls the process. A - usually means a daemon not running on any particular tty. Process: name of the process. ====================================================== 2. show processes cpu (new output) Description: show cpu utilization information about the processes. switch# show processes cpu PID ----842 1112 1269 1276 1277 1278 1279 Runtime(ms) ----------3807 1220 220 2901 738 1159 515 Invoked -------137001 67974 13568 15419 21010 6789 67617 uSecs ----27 17 16 188 35 170 7 1Sec ----0.0 0.0 0.0 0.0 0.0 0.0 0.0 Process ----------sysmgr syslogd fcfwd zone xbar_client wwn vsan
Runtime(ms): cpu time the process has used, expressed in milliseconds Invoked: Number of times the process has been invoked. uSecs: Microseconds of CPU time in average for each process invocation. 1Sec: CPU utilization in percentage for the last 1 second. ====================================================== 3. show processes mem Description: show memory information about the processes. PID ----1277 1278 1279 1293 1294 1295 1296 MemAlloc -------120632 56800 1210220 386144 1396892 214528 42064 StackBase/Ptr ----------------7ffffcd0/7fffefe4 7ffffce0/7ffffb5c 7ffffce0/7ffffbac 7ffffcf0/7fffebd4 7ffffce0/7fffdff4 7ffffcf0/7ffff904 7ffffce0/7ffffb5c Process ---------------xbar_client wwn vsan span snmpd rscn qos
MemAlloc: total memory allocated by the process. StackBase/Ptr: process stack base and current stack pointer in hex format ====================================================== 3. show processes log Description: list all the process logs switch# show processes log Process PID Normal-exit ---------------- ------ ----------fspf 1339 N lichen 1559 rib 1741 N
Stack-trace ----------Y N Y
Core ------N Y N
Log-create-time --------------Jan 5 04:25 N Jan 2 04:49 Jan 1 06:05
Normal-exit: whether or not the process exited normally. Stack-trace: whether or not there is a stack trace in the log. Core: whether or not there exists a core file. Log-create-time: when the log file got generated.
21-163
Chapter 21 show processes
Show Commands
The following example displays the detail log information about a particular process.
switch# show processes log pid 1339 Service: fspf Description: FSPF Routing Protocol Application Started at Sat Jan 5 03:23:44 1980 (545631 us) Stopped at Sat Jan 5 04:25:57 1980 (819598 us) Uptime: 1 hours 2 minutes 2 seconds Start type: SRV_OPTION_RESTART_STATELESS (23) Death reason: SYSMGR_DEATH_REASON_FAILURE_SIGNAL (2) Exit code: signal 9 (no core) CWD: /var/sysmgr/work Virtual Memory: CODE DATA BRK STACK TOTAL Register Set: EBX ESI EAX EAX EFL 00000005 00000000 FFFFFDFE 0000008E (orig) 00000207 ECX EDI XDS EIP ESP 7FFFF8CC 7FFFF6CC 8010002B 2ACE133E 7FFFF654 EDX EBP XES XCS XSS 00000000 7FFFF95C 0000002B 00000023 0000002B 08048000 - 0809A100 0809B100 - 0809B65C 0809D988 - 080CD000 7FFFFD20 23764 KB
Stack: 1740 bytes. ESP 7FFFF654, TOP 7FFFFD20 0x7FFFF654: 0x7FFFF664: 0x7FFFF674: 0x7FFFF684: 00000000 00000005 7FFFF6CC 7FFFF9A4 00000008 7FFFF8CC 00000001 00000008 00000003 00000000 7FFFF95C 7FFFFC34 08051E95 00000000 080522CD 2AC1F18C ................ ................ ........\....".. ........4......*
21-164
Chapter 21
Show Commands show qos
show qos
To display the current QoS settings along with a the number of frames marked high priority, use the show qos command. show qos {class-map [name class-name] | dwrr | policy-map [name policy-name] | service policy [interface fc slot/port | vsan vsan-id] | statistics}
Syntax Description
class-map name class-name dwrr policy-map name policy-name service policy interface fc slot/port vsan vsan-id statistics
Displays QoS class maps. Specifies a class map name. Maximum length is 63 alpha-numeric characters. Displays deficit weighted round robin queue weights. Displays QoS policy-maps. Specifies a policy map name. Maximum length is 63 alpha-numeric characters. Displays QoS service policy associations. Specifies a Fibre Channel interface. Specifies a VSAN ID. The range is 1 to 4093. Displays QoS related statistics.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
To access all but the statistics option for this command, you must perform the qos enable command.
Examples
The following example displays the contents of all class maps.

switch# show qos class-map qos class-map MyClass match-any match dest-wwn 20:01:00:05:30:00:28:df match src-wwn 23:15:00:05:30:00:2a:1f match src-intf fc2/1 qos class-map Class2 match-all match src-intf fc2/14 qos class-map Class3 match-all match src-wwn 20:01:00:05:30:00:2a:1f
21-165
Chapter 21 show qos
Show Commands
The following example displays the contents of a specified class map.
switch# show qos class-map name MyClass qos class-map MyClass match-any match dest-wwn 20:01:00:05:30:00:28:df match src-wwn 23:15:00:05:30:00:2a:1f match src-intf fc2/1
The following example displays all configured policy maps.

switch# show qos policy-map qos policy-map MyPolicy class MyClass priority medium qos policy-map Policy1 class Class2 priority low
The following example displays a specified policy map.

switch# show qos policy-map name MyPolicy qos policy-map MyPolicy class MyClass priority medium
The following example displays scheduled DWRR configurations

switch# show qos dwrr qos dwrr-q high weight 50 qos dwrr-q medium weight 30 qos dwrr-q low weight 20
The following example displays all applied policy maps.

switch# show qos service policy qos service policy MyPolicy vsan 1 qos service policy Policy1 vsan 4
The following example displays QoS statistics.

switch# show qos statistics Total number of FC frames transmitted from the Supervisor= 301431 Number of highest-priority FC frames transmitted = 137679 Current priority of FC control frames = 7 (0 = lowest; 7 = highest)
21-166
Chapter 21
Show Commands show radius
show radius
To display the RADIUS Cisco Fabric Services (CFS) distribution status and other details, use the show radius command. show radius {distribution status | pending | pending-diff}
Syntax Description
distribution status pending pending-diff
Displays the status of the RADIUS CFS distribution. Displays the pending configuration that is not yet applied. Displays the difference between the active configuration and the pending configuration.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example displays the RADIUS distribution status.

switch# show radius distribution status session ongoing: no session db: does not exist merge protocol status: merge activation done last operation: none last operation status: none
Related Commands
Command radius distribute
Description Enables RADIUS CFS distribution.
21-167
Chapter 21 show radius-server
Show Commands
show radius-server
To display all configured RADIUS server parameters, use the show radius-server command. show radius-server [groups | sorted]
Syntax Description
groups sorted
Displays configured RADIUS server group information. Displays RADIUS server information sorted by name.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Only administrators can view the RADIUS pre-shared key.
Examples
switch# show radius-server Global RADIUS shared secret:Myxgqc retransmission count:5 timeout value:10 following RADIUS servers are configured: myradius.cisco.users.com: available for authentication on port:1812 available for accounting on port:1813 172.22.91.37: available for authentication on port:1812 available for accounting on port:1813 RADIUS shared secret:23MHcUnD 10.10.0.0: available for authentication on port:1812 available for accounting on port:1813 RADIUS shared secret:hostkey----> for administrators only
21-168
Chapter 21
Show Commands show rlir
show rlir
To display the information about Registered Link Incident Report (RLIR), Link Incident Record Registration (LIRR), and Distribute Registered Link Incident Record (DRLIR) frames, use the show rlir command. show rilr {erl [vsan vsan-id] | history | recent [interface fc slot/port | portnumber port-number] | statistics [vsan vsan-id]}
Syntax Description
erl vsan-id vsan vsan-id history recent interface fc slot/port portnumber port-number statistics
Displays Established Registration List (ERL) information. Specifies a VSAN ID. The range is 1 to 4093. Displays link incident history. Displays recent link incident. Specifies a Fibre Channel interface at a slot and port. Specifies a port number for the link incidents. The range is 1 to 224. Displays RLIR statistics.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
If available, the host timestamp (marked by the *) is printed along with the switch timestamp. If the host timestamp is not available, only the switch timestamp is printed.
Examples
The following example displays the RLIR statistics for all VSANs.
switch# show rlir statistics Statistics for VSAN: 1 ------------------------Number Number Number Number Number Number Number Number Number Number Number Number of of of of of of of of of of of of LIRR received LIRR ACC sent LIRR RJT sent RLIR sent RLIR ACC received RLIR RJT received DRLIR received DRLIR ACC sent DRLIR RJT sent DRLIR sent DRLIR ACC received DRLIR RJT received = = = = = = = = = = = = 0 0 0 0 0 0 0 0 0 0 0 0
21-169
Chapter 21 show rlir
Show Commands
Statistics for VSAN: 4 ------------------------Number Number Number Number Number Number Number Number Number Number Number Number of of of of of of of of of of of of LIRR received LIRR ACC sent LIRR RJT sent RLIR sent RLIR ACC received RLIR RJT received DRLIR received DRLIR ACC sent DRLIR RJT sent DRLIR sent DRLIR ACC received DRLIR RJT received = = = = = = = = = = = = 0 0 0 0 0 0 0 0 0 0 0 0
Statistics for VSAN: 61 ------------------------Number Number Number Number Number Number Number Number Number Number Number Number of of of of of of of of of of of of LIRR received LIRR ACC sent LIRR RJT sent RLIR sent RLIR ACC received RLIR RJT received DRLIR received DRLIR ACC sent DRLIR RJT sent DRLIR sent DRLIR ACC received DRLIR RJT received = = = = = = = = = = = = 0 0 0 0 0 0 0 0 0 0 0 0
The following example displays the RLIR statistics for a specified VSAN.
switch# show rlir statistics vsan 4 Statistics for VSAN: 4 ------------------------Number Number Number Number Number Number Number Number Number Number Number Number of of of of of of of of of of of of LIRR received LIRR ACC sent LIRR RJT sent RLIR sent RLIR ACC received RLIR RJT received DRLIR received DRLIR ACC sent DRLIR RJT sent DRLIR sent DRLIR ACC received DRLIR RJT received = = = = = = = = = = = = 0 0 0 0 0 0 0 0 0 0 0 0
The following example displays the RLIR statistics for all ERLs.
switch# show rlir erl Established Registration List for VSAN: 2 ---------------------------------------------FC-ID LIRR FORMAT REGISTERED FOR ---------------------------------------------0x0b0200 0x18 always receive
21-170
Chapter 21
Show Commands show rlir
Total number of entries = 1 Established Registration List for VSAN: 100 ---------------------------------------------FC-ID LIRR FORMAT REGISTERED FOR ---------------------------------------------0x0b0500 0x18 conditional receive 0x0b0600 0x18 conditional receive Total number of entries = 2
The following example displays the ERLs for the specified VSAN.
switch# show rlir erl vsan 100 Established Registration List for VSAN: 100 ---------------------------------------------FC-ID LIRR FORMAT REGISTERED FOR ---------------------------------------------0x0b0500 0x18 conditional receive 0x0b0600 0x18 conditional receive Total number of entries = 2
The following example displays the RLIR history.

switch# show rlir history Link incident history ---------------------------------------------------------------------------*Host Time Stamp Switch Time Stamp Port Interface Link Incident ---------------------------------------------------------------------------*Sun Nov 30 21:47:28 2003 Sun Nov 30 13:47:55 2003 2 fc1/2 Implicit Incident *Sun Nov 30 22:00:47 2003 Sun Nov 30 14:01:14 2003 2 fc1/2 NOS Received *Sun Nov 30 22:00:55 2003 Sun Nov 30 14:01:22 2003 2 fc1/2 Implicit Incident *Mon Dec 1 20:14:26 2003 Mon Dec 1 12:14:53 2003 4 fc1/4 Implicit Incident *Mon Dec 1 20:14:26 2003 Mon Dec 1 12:14:53 2003 4 fc1/4 Implicit Incident *Thu Dec 4 04:43:32 2003 Wed Dec 3 20:43:59 2003 2 fc1/2 NOS Received *Thu Dec 4 04:43:41 2003 Wed Dec 3 20:44:08 2003 2 fc1/2 Implicit Incident *Thu Dec 4 04:46:53 2003 Wed Dec 3 20:47:20 2003 2 fc1/2 NOS Received *Thu Dec 4 04:47:05 2003 Wed Dec 3 20:47:32 2003 2 fc1/2 Implicit Incident *Thu Dec 4 04:48:07 2003 Wed Dec 3 20:48:34 2003 2 fc1/2 NOS Received *Thu Dec 4 04:48:39 2003 Wed Dec 3 20:49:06 2003 2 fc1/2 Implicit Incident *Thu Dec 4 05:02:20 2003 Wed Dec 3 21:02:47 2003 2 fc1/2 NOS Received *Thu Dec 4 05:02:29 2003 Wed Dec 3 21:02:56 2003 2 fc1/2 Implicit Incident *Thu Dec 4 05:02:47 2003 Wed Dec 3 21:03:14 2003 4 fc1/4 NOS Received *Thu Dec 4 05:02:54 2003 Wed Dec 3 21:03:21 2003 4 fc1/4 Implicit Incident *Thu Dec 4 05:02:54 2003 Wed Dec 3 21:03:21 2003 4 fc1/4 Implicit Incident ...
21-171
Chapter 21 show rlir
Show Commands
The following example displays recent RLIRs for a specified interface.
switch# show rlir recent interface fc1/1 Recent link incident records ---------------------------------------------------------------------------*Host Time Stamp Switch Time Stamp Port Interface Link Incident ----------------------------------------------------------------------------
*Thu Dec 4 05:02:29 2003 Wed Dec 3 21:02:56 2003 *Thu Dec 4 05:02:54 2003 Wed Dec 3 21:03:21 2003 switch#
2 4
fc1/2 fc1/4
Implicit Incident Implicit Incident
The following example displays the recent RLIRs for a specified port number.
switch# show rlir recent portnumber 1 Recent link incident records ---------------------------------------------------------------------------*Host Time Stamp Switch Time Stamp Port Interface Link Incident ----------------------------------------------------------------------------
*Thu Wed *Thu Wed
Dec 4 05:02:29 2003 Dec 3 21:02:56 2003 Dec 4 05:02:54 2003 Dec 3 21:03:21 2003
2 4
fc1/2 fc1/4
Implicit Incident Implicit Incident
21-172
Chapter 21
Show Commands show rmon
show rmon
To display the remote monitoring (RMON) configuration, use the show rmon command. show rmon {alarms | events}
Syntax Description
alarms events
Displays the configured RMON alarms. Displays the configured RMON events.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example displays the configured RMON alarms.

switch# show rmon alarms Alarm 20 is active, owned by test Monitors 1.3.6.1.2.1.2.2.1.16.16777216 every 256000 second(s) Taking delta samples, last value was 17 Rising threshold is 15, assigned to event 1 Falling threshold is 0, assigned to event 0 On startup enable rising or falling alarm
The following example displays the configured RMON events.

switch# show rmon events Event 2 is active, owned by Test2 Description is CriticalErrors Event firing causes log and trap to community eventtrap, last fired 1
Related Commands
Command rmon alarm rmon event
Description Configures RMON alarms. Configures RMON events.
21-173
Chapter 21 show role
Show Commands
show role
To display roles (and their associated rules) configured on the switch, including those roles that have not yet been committed to persistent storage, use the show role command. show role [name string | pending | pending-diff | status]
Syntax Description
name string pending pending-diff status
Specifies a name of the role. Displays uncommitted role configuration for fabric distribution. Displays the differences between the pending configuration and the active configuration. Displays the status of the latest Cisco Fabric Services (CFS) operation.
Defaults
Displays information for all roles.
Command Modes
EXEC mode.
Command History
Release 1.0(2) 2.0(1b)
Modification This command was introduced. Added the pending, pending-diff, and status options.
Usage Guidelines
The rules are displayed by rule number and are based on each role. All roles are displayed even if role name is not specified. Only network-admin role can access this command.
Examples
The following example shows how to display information for all roles.
switch# show role Role: network-admin Description: Predefined Network Admin group. This role cannot be modified Access to all the switch commands Role: network-operator Description: Predefined Network Operator group. This role cannot be modified Access to Show commands and selected Exec commands Role: sangroup Description: SAN management group ----------------------------------------Rule Type Command-type Feature ----------------------------------------1. permit config * 2. deny config fspf 3. permit debug zone 4. permit exec fcping
21-174
Chapter 21
Show Commands show role
Related Commands
Command role abort role commit role distribute role name
Description Enables authorization role CFS distribution. Enables authorization role CFS distribution. Enables authorization role CFS distribution. Configures authorization roles.
21-175
Chapter 21 show rscn
Show Commands
show rscn
To display registered state change notification (RSCN) information, use the show rscn command. show rscn {scr-table [vsan vsan-id] | statistics [vsan vsan-id]}
Syntax Description
scr-table statistics vsan vsan-id
Displays State Change Registration table. Displays RSCN statistics. Specifies a VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The SCR table cannot be configured, it is only populated if one or more Nx ports send SCR frames to register for RSCN information. If the show rscn scr-table command does not return any entries, no Nx port is interested in receiving RSCN information.
Examples
The following example display RSCN information.

switch# show rscn scr-table vsan 1 SCR table for VSAN: 1 --------------------------------------------FC-ID REGISTERED FOR --------------------------------------------0x1b0300 fabric detected rscns Total number of entries = 1
The following example display RSCN statistics.

switch# show rscn statistics vsan 1 Statistics for VSAN: 1 ------------------------Number Number Number Number Number Number Number Number Number Number of of of of of of of of of of SCR received SCR ACC sent SCR RJT sent RSCN received RSCN sent RSCN ACC received RSCN ACC sent RSCN RJT received RSCN RJT sent SW-RSCN received = = = = = = = = = = 0 0 0 0 0 0 0 0 0 0
21-176
Chapter 21
Show Commands show rscn
Number Number Number Number Number of of of of of SW-RSCN SW-RSCN SW-RSCN SW-RSCN SW-RSCN sent ACC received ACC sent RJT received RJT sent = = = = = 0 0 0 0 0
21-177
Chapter 21 show running-config
Show Commands
show running-config
To display the running configuration file, use the show running-config command show running-config [diff | interface [cpp | fc | fc slot/port | fc-tunnel tunnel-id | fcip fcip-number | gigabitethernet slot/port | iscsi slot/port | mgmt 0 | port-channel | svc | vsan vsan-id] | vsan vsan-id]
Syntax Description
diff interface cpp fc slot/port fc-tunnel tunnel-id fcip fcip-number gigabitethernet slot/port iscsi slot/port mgmt 0 port-channel sup-fc svc vsan vsan-id
Displays the difference between the running and startup configurations. Displays running configuration information for a range of interfaces. Displays the virtualization interface specific to the ASM module (see the interface cpp section on page 27-18). Displays the Fibre Channel interface in the specified slot and port. Displays description of the specified FC tunnel from 1 to 4095. Displays the description of the specified FCIP interface from 1 to 255. Displays the description of the Gigabit Ethernet interface in the specified slot and port. Displays the description of the iSCSI interface in the specified slot and port. Displays the description of the management interface. Displays the description of the PortChannel interface. Displays the inband interface details. Displays the virtualization interface specific to the CSM module (see the interface svc section on page 28-16). Displays VSAN-specific information. The ID ranges from 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
If the running configuration is different from the startup configuration, issue the show startup-config diff command to view the differences.
21-178
Chapter 21
Show Commands show running-config
Examples The following example displays the configuration currently running on the switch.
switch# show running-config Building Configuration ... interface fc1/1 interface fc1/2 interface fc1/3 interface fc1/4 interface mgmt0 ip address 172.22.95.112 255.255.255.0 no shutdown vsan database boot system bootflash:isan-237; sup-1 boot kickstart bootflash:boot-237 sup-1 callhome ip default-gateway 172.22.95.1 switchname switch trunk protocol enable username admin password 5 /AFDAMD4B2xK2
role network-admin
The following example displays the difference between the running configuration and the startup configuration.
switch# show running-config diff Building Configuration ... *** Startup-config --- Running-config ****************** 1,16 **** fcip enable ip default-gateway 172.22.91.1 iscsi authentication none iscsi enable ! iscsi import target fc iscsi virtual-target name vt pWWN 21:00:00:04:cf:4c:52:c1 all-initiator-permit --- 1,20 ---fcip enable + aaa accounting logsize 500 + + + ip default-gateway 172.22.91.1 iscsi authentication none iscsi enable ! iscsi initiator name junk iscsi virtual-target name vt pWWN 21:00:00:04:cf:4c:52:c1 all-initiator-permit
The following example displays running configuration information for a specified interfacein this case, the management interface.
21-179
Chapter 21 show running-config
Show Commands
switch# show running-config interface mgmt0 interface mgmt0 ip address 255.255.255.0 255.255.255.0
The following example displays running configuration information for a specified featurein this case, VSANS.
switch# show running-config feature vsan vsan database vsan 2 suspend vsan 3 vsan 4 vsan database vsan 3 interface fc1/1
21-180
Chapter 21
Show Commands show san-ext-tuner
show san-ext-tuner
To display SAN extension tuner information, use the show san-ext-tuner command. show san-ext-tuner {interface gigabitethernet slot/port [nport pwwn pwwn-id vsan vsan-id counters] | nports}
Syntax Description
interface gigabitethernet slot/port nport pwwn pwwn-id vsan vsan-id counters nports
Displays SAN extension tuner information for a specific Gigabit Ethernet interface. Specifies a Gigabit Ethernet interface. Specifies an N port. Specifies a pWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number. Specifies a VSAN ID. The range is 1 to 4093. Specifies SAN extension tuner counters. Displays SAN extension tuner information for all nports.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to display SAN extension tuner N port information.
switch# show san-ext-tuner nports
Related Commands
Command san-ext-tuner
Description Enters SAN extension tuner configuration mode.
21-181
Chapter 21 show santap module
Show Commands
show santap module

To display the SANTap configuration on the Storage Services Module (SSM), use the show santap module command in EXEC mode. show santap module slot {avt [name | brief] | avtlun | cvt [cvt-id | brief] | dvt [name | brief] | dvtlun | rvt [name | brief] | rvtlun | session [session-id | brief]}
Syntax Description
slot avt avtlun cvt cvt-id dvt dvtlun rvt rvtlun session session-id name brief
Displays SANTap configuration for a module in the specified slot. Displays the appliance virtual target (AVT) configuration. Displays the appliance AVT LUN configuration. Displays the control virtual target (CVT) configuration. Specifies a user configured CVT ID. The range is 1 to 65536. Displays the data virtual target (DVT) configuration. Displays the DVT LUN configuration. Displays the remote virtual target (AVT) configuration. Displays the RVT LUN configuration. Displays the SANTap session information. Specifies a user configured session ID. The range is 1 to 65536. User specified name. Displays a brief format version of the display.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.1(1a)
Usage Guidelines
None.
21-182
Chapter 21
Show Commands show santap module
Examples The following example displays the SANTap AVT configuration.
switch# show santap module 2 avt AVT Information : avt pwwn avt nwwn avt id avt vsan avt if_index hi pwwn tgt pwwn tgt vsan
= = = = = = = =
2a:4b:00:05:30:00:22:25 2a:60:00:05:30:00:22:25 12 4 0x1080000 21:00:00:e0:8b:07:61:aa 22:00:00:20:37:88:20:ef 1
The following example displays the SANTap configuration AVT LUN.

switch# show santap module 2 avtlun AVT LUN Information avt pwwn avt lun xmap id avt id tgt lun : = = = = =
2a:4b:00:05:30:00:22:25 0x0 16 12 0x0
The following example displays the SANTap configuration CVT.

switch# show santap module 2 cvt CVT Information : cvt pwwn cvt nwwn cvt id cvt xmap_id cvt vsan
= = = = =
25:3c:00:05:30:00:22:25 25:3d:00:05:30:00:22:25 1 2 10
The following example displays the SANTap configuration DVT.

switch# show santap module 2 dvt DVT Information : dvt pwwn dvt nwwn dvt id dvt mode dvt vsan dvt fp_port dvt if_index dvt name
= = = = = = = =
22:00:00:20:37:88:20:ef 20:00:00:20:37:88:20:ef 3 3 3 0 0x1080000 MYDVT
The following example displays the SANTap configuration DVTLUN.

switch# show santap module 2 dvtlun DVT LUN Information dvt pwwn dvt lun xmap id dvt id dvt mode dvt vsan tgt pwwn tgt lun tgt vsan : = = = = = = = = =
22:00:00:20:37:88:20:ef 0x0 8 3 0 3 22:00:00:20:37:88:20:ef 0x0 1
21-183
Chapter 21 show santap module
Show Commands
The following example displays the SANTap configuration session.
switch# show santap module 2 session Session Information : session id = host pwwn = dvt pwwn = dvt lun = tgt pwwn = tgt lun = adt pwwn = adt lun = num ranges = dvt id = vdisk id = session state = mrl requested = pwl requested = iol requested =
1 21:00:00:e0:8b:07:61:aa 22:00:00:20:37:88:20:ef 0x0 00:00:00:00:00:00:00:00 0x0 77:77:77:77:77:77:77:77 0x0 0 0 0 0 1 1 0
The following example displays the SANTap configuration RVT.

switch# show santap module 2 rvt RVT Information : rvt pwwn rvt nwwn rvt id rvt vsan rvt if_index
= = = = =
2a:61:00:05:30:00:22:25 2a:62:00:05:30:00:22:25 17 4 0x1080000
The following example displays the SANTap configuration RVTLUN.

switch# show santap module 2 rvtlun RVT LUN Information rvt pwwn rvt lun xmap id rvt id app pwwn app lun app vsan : = = = = = = =
2a:61:00:05:30:00:22:25 0x0 22 17 22:00:00:20:37:39:b1:00 0x0 1
Table 21-7 describes the significant fields shown in the previous displays.
Table 21-7 show santap Field Descriptions
Field app lun app pwwn app vsan avt id avt if_index avt lun avt nwwn avt pwwn
Description Displays the appliance LUN. Displays the appliance port world wide name. Displays the appliance VSAn number. Displays the AVT ID number. Displays the AVT interface index number. Displays the AVT LUN. Displays the AVT Node port world wide name. Displays the AVT port world wide name
21-184
Chapter 21
Show Commands show santap module
Table 21-7 show santap Field Descriptions (continued)
Field avt vsan cvt id cvt nwwn cvt pwwn cvt vsan cvt xmap_id dvt fp_port dvt id dvt if_index dvt lun dvt mode dvt name dvt nwwn dvt pwwn dvt vsan host pwwn num ranges rvt id rvt if_index rvt lun rvt nwwn rvt pwwn rvt vsan session id session state tgt lun tgt pwwn tgt vsan vdisk id xmap id
Description Displays the AVT VSAN number. Displays the CVT ID number. Displays the CVT Node port world wide name. Displays the CVT port world wide name Displays the CVT VSAN number. Displays the CVT Xmap ID number. Displays the DVT fabric port number. Displays the DVT Displays the DVT interface index number. Displays the DVT LUN. Displays the DVT mode. Displays the DVT name. Displays the DVT Node port world wide name. Displays the DVT port world wide name. Displays the DVT VSAN number. Displays the host port world wide name. Displays the number ranges. Displays the RVT ID number. Displays the RVT interface index. Displays the RVT LUN. Displays the RVT Node port world wide name. Displays the RVT port world wide name. Displays the RVT VSAN number. Displays the session ID number. Displays the session state. Displays the target LUN. Displays the target port world wide name. Displays the target VSAN number. Displays the virtual disk ID number. Displays the Xmap ID number.
Related Commands
Command santap module
Description Configures the mapping between the SSM and the VSAN where the appliance is configured
21-185
Chapter 21 show scheduler
Show Commands
show scheduler
To display command scheduler information, use the show scheduler command. show scheduler {config | job [name jobname] | logfile | schedule [name schedulename]}
Syntax Description
config job name jobname logfile schedule name schedulename
Displays command scheduler configuration information. Displays job information. Restricts the output to a specific job name. Maximum length is 31 characters. Displays the log file. Displays schedule information. Restricts the output to a specific schedule name. Maximum length is 31 characters.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, the command scheduler must be enabled using the scheduler enable command.
Examples
The following example displays the command scheduler configuration information.

switch# show scheduler config config terminal scheduler enable end
The following example displays the command scheduler schedule information.

switch# show scheduler schedule configureVsan99 Schedule Name : configureVsan99 -----------------------------------User Name : admin Schedule Type : Run once on Tue Aug 10 09:48:00 2004 Last Execution Time: Tue Aug 10 09:48:00 2004 ----------------------------------------------Job Name Status ----------------------------------------------addMemVsan99 Success (0)
21-186
Chapter 21
Show Commands show scheduler
The following example displays the command scheduler logfile information.
switch# show scheduler logfile Job Name : addMemVsan99 Job Status: Success (0) Schedule Name : configureVsan99 User Name : admin Completion time: Tue Aug 10 09:48:00 2004 --------------------------- Job Output --------------------------config terminal vsan database vsan 99 interface fc1/1 vsan 99 interface fc1/2 vsan 99 interface fc1/3 vsan 99 interface fc1/4
The following example displays the command scheduler configuration information.

switch# show scheduler config config terminal scheduler enable scheduler logfile size 512 end config terminal scheduler job name addMemVsan99 config terminal vsan database vsan 99 interface fc1/1 vsan 99 interface fc1/2 vsan 99 interface fc1/3 vsan 99 interface fc1/4 end config terminal scheduler schedule name configureVsan99 time start 2004:8:10:9:52 job name addMemVsan99 end
Related Commands
Command scheduler enable scheduler job name scheduler schedule name
Description Enables the command scheduler. Configures command scheduler jobs. Configures command schedules.
21-187
Chapter 21 show scsi-flow
Show Commands
show scsi-flow
To display SCSI flow information, use the show scsi-flow command. show scsi-flow [flow-id flow-id]| statistics [flow-id flow-id {lun lun-number}]]
Syntax Description
flow-id flow-id statistics lun lun-number
Displays a specific SCSI flow index. Displays the statistics for the SCSI flow. Displays statics for a specific LUN number.
Defaults
None
Command Modes
EXEC mode.
Command History
Release 2.0(2)
Examples
The following example displays SCSI flow services configuration for all SCSI flow identifiers.
switch# show scsi-flow Flow Id: 3 Initiator VSAN: 101 Initiator WWN: 21:00:00:e0:8b:05:76:28 Target VSAN: 102 Target WWN: 21:00:00:20:37:38:7f:7d Target LUN: ALL LUNs Flow Verification Status: ------------------------Initiator Verification Status: success Target Verification Status: success Initiator Linecard Status: success Target Linecard Status: success Feature Status: --------------Write-Acceleration enabled Write-Acceleration Buffers: 1024 Configuration Status: success Statistics enabled Configuration Status: success Flow Id: 4 Initiator VSAN: 101 Initiator WWN: 21:00:00:e0:8b:05:76:28 Target VSAN: 102 Target WWN: 21:00:00:20:37:38:a7:89 Target LUN: ALL LUNs Flow Verification Status: -------------------------
21-188
Chapter 21
Show Commands show scsi-flow
Initiator Verification Status: success Target Verification Status: success Initiator Linecard Status: success Target Linecard Status: success Feature Status: --------------Write-Acceleration enabled Write-Acceleration Buffers: 1024 Configuration Status: success
Table 21-8 describes the significant fields shown in the show scsi-flow command output.
Table 21-8 show scsi-flow Field Descriptions
Field Initiator Verification Status
Description Verifies that the name server, FLOGI server, and zone server information for the initiator on the local switch are correct.
Target Verification Status Verifies that the names sever and zone server information for the target on the local switch are correct. Initiator Linecard Status Target Linecard Status Verifies that the initiator is connected to an SSM and if DPP provisioning is enabled for the module. Verifies in the following order: 1. The target switch sees the proper name server and zone server information for the initiator. 2. The target switch sees the proper name server, FLOGI server and zone server information for the target. 3. The target is connected to an SSM and if DPP provisioning is enabled for that module.
The following example displays SCSI flow services configuration for a specific SCSI flow identifier.
switch# show scsi-flow flow-id 3 Flow Id: 3 Initiator VSAN: 101 Initiator WWN: 21:00:00:e0:8b:05:76:28 Target VSAN: 102 Target WWN: 21:00:00:20:37:38:7f:7d Target LUN: ALL LUNs Flow Verification Status: ------------------------Initiator Verification Status: success Target Verification Status: success Initiator Linecard Status: success Target Linecard Status: success Feature Status: --------------Write-Acceleration enabled Write-Acceleration Buffers: 1024 Configuration Status: success Statistics enabled Configuration Status: success
21-189
Chapter 21 show scsi-flow
Show Commands
The following example displays SCSI flow services statistics for all SCSI flow identifiers.
switch# show scsi-flow statistics Stats for flow-id 4 LUN=0x0000 -----------------------------Read Stats I/O Total count=2 I/O Timeout count=0 I/O Total block count=4 I/O Max block count=2 I/O Min response time=5247 usec I/O Max response time=10160 usec I/O Active Count=0 Write Stats I/O Total count=199935 I/O Timeout count=0 I/O Total block count=12795840 I/O Max block count=64 I/O Min response time=492 usec I/O Max response time=10056529 usec I/O Active Count=16 Non Read-Write Stats Test Unit Ready=4 Report LUN=38 Inquiry=50 Read Capacity=3 Mode Sense=0 Request Sense=0 Total Stats Rx Frame Count=3792063 Rx Frame Byte Count=6549984752 Tx Frame Count=3792063 Tx Frame Byte Count=6549984752 Error Stats SCSI Status Busy=0 SCSI Status Reservation Conflict=0 SCSI Status Task Set Full=0 SCSI Status ACA Active=0 Sense Key Not Ready=0 Sense Key Medium Error=0 Sense Key Hardware Error=0 Sense Key Illegal Request=0 Sense Key Unit Attention=28 Sense Key Data Protect=0 Sense Key Blank Check=0 Sense Key Copy Aborted=0 Sense Key Aborted Command=0 Sense Key Volume Overflow=0 Sense Key Miscompare=0
21-190
Chapter 21
Show Commands show scsi-flow
The following example displays SCSI flow services statistics for a specific SCSI flow identifier.
switch# show scsi-flow statistics flow-id 4 Stats for flow-id 4 LUN=0x0000 -----------------------------Read Stats I/O Total count=2 I/O Timeout count=0 I/O Total block count=4 I/O Max block count=2 I/O Min response time=5247 usec I/O Max response time=10160 usec I/O Active Count=0 Write Stats I/O Total count=199935 I/O Timeout count=0 I/O Total block count=12795840 I/O Max block count=64 I/O Min response time=492 usec I/O Max response time=10056529 usec I/O Active Count=16
21-191
Chapter 21 show scsi-target
Show Commands
show scsi-target
To display information about existing SCSI target configurations, use the show scsi-target command. show scsi-target {auto-poll | custom-list | devices [vsan vsan-id] [fcid fcid-id] | disk [vsan vsan-id] [fcid fcid-id] | lun [vsan vsan-id] [fcid fcid-id] [os [aix | all | hpux | linux | solaris | windows] | pwwn | status | tape [vsan vsan-id] [fcid fcid-id]}
Syntax Description
auto-poll custom-list devices disk lun os aix all hpux linux solaris windows vsan vsan-range fcid fcid-id status tape pwwn
Displays SCSI target auto polling information. Displays customized discovered targets. Displays discovered scsi-target devices information Displays discovered disk information. Displays discovered SCSI target LUN information. Discovers the specified operating system. Specifies the AIX operating system. Specifies all operating systems. Specifies the HPUX operating system. Specifies the Linux operating system. Specifies the Solaris operating system. Specifies the Windows operating system. Specifies the VSAN ID or VSAN range. The ID range is 1 to 4093. Specifies the FCID of the SCSI target to display. Displays SCSI target discovery status. Displays discovered tape information. Displays discover pWWN information for each OS.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Use the show scsi-target auto-poll command to verify automatic discovery of scsi-targets which come online.
Examples
The following example displays the status of a SCSI discovery.

switch# show scsi-target status discovery completed
21-192
Chapter 21
Show Commands show scsi-target
The following example displays a customized discovered targets:
switch# show scsi-target custom-list --------------VSAN DOMAIN --------------1 56
The following example displays discovered disk information.

switch# show scsi-target disk -------------------------------------------------------------------------------VSAN FCID PWWN VENDOR MODEL REV -------------------------------------------------------------------------------1 0x9c03d6 21:00:00:20:37:46:78:97 Company 4 ST318203FC 0004 1 0x9c03d9 21:00:00:20:37:5b:cf:b9 Company 4 ST318203FC 0004 1 0x9c03da 21:00:00:20:37:18:6f:90 Company 4 ST318203FC 0004 1 0x9c03dc 21:00:00:20:37:5a:5b:27 Company 4 ST318203FC 0004 1 0x9c03e0 21:00:00:20:37:36:0b:4d Company 4 ST318203FC 0004 1 0x9c03e1 21:00:00:20:37:39:90:6a Company 4 ST318203 CLAR18 3844 1 0x9c03e2 21:00:00:20:37:18:d2:45 Company 4 ST318203 CLAR18 3844 1 0x9c03e4 21:00:00:20:37:6b:d7:18 Company 4 ST318203 CLAR18 3844 1 0x9c03e8 21:00:00:20:37:38:a7:c1 Company 4 ST318203FC 0004 1 0x9c03ef 21:00:00:20:37:18:17:d2 Company 4 ST318203FC 0004
The following example displays the discovered LUNs for all OSs.
switch# show scsi-target lun os all ST336607FC from SEAGATE (Rev 0006) FCID is 0xed0001 in VSAN 7, PWWN is 21:00:00:04:cf:fb:42:f8 -------------------------------------------------------------------------------OS LUN Capacity Status Serial Number Device-Id (MB) -------------------------------------------------------------------------------WIN 0x0 36704 Online 3JA1B9QA00007338 C:1 A:0 T:3 20:00:00:04:cf:fb:42:f8 AIX 0x0 36704 Online 3JA1B9QA00007338 C:1 A:0 T:3 20:00:00:04:cf:fb:42:f8 SOL 0x0 36704 Online 3JA1B9QA00007338 C:1 A:0 T:3 20:00:00:04:cf:fb:42:f8 LIN 0x0 36704 Online 3JA1B9QA00007338 C:1 A:0 T:3 20:00:00:04:cf:fb:42:f8 HP 0x0 36704 Online 3JA1B9QA00007338 C:1 A:0 T:3 20:00:00:04:cf:fb:42:f8
The following example displays the discovered LUNs. for the Solaris OS.
switch# show scsi-target lun os solaris ST336607FC from SEAGATE (Rev 0006) FCID is 0xed0001 in VSAN 7, PWWN is 21:00:00:04:cf:fb:42:f8 -------------------------------------------------------------------------------OS LUN Capacity Status Serial Number Device-Id (MB) -------------------------------------------------------------------------------SOL 0x0 36704 Online 3JA1B9QA00007338 C:1 A:0 T:3 20:00:00:04:cf:fb:42:f8
The following example displays auto-polling information. Each user is indicated by the internal UUID number, which indicates that a CSM or an IPS module is in the chassis.
switch# show scsi-target auto-poll auto-polling is enabled, poll_start:0 poll_count:1 poll_type:0 USERS OF AUTO POLLING --------------------uuid:54
21-193
Chapter 21 show scsi-target
Show Commands
The following example displays the port WWN that is assigned to each OS (Windows, AIX, Solaris, Linux, or HPUX).
switch# show scsi-target pwwn -----------------------------OS PWWN -----------------------------WIN 24:91:00:05:30:00:2a:1e AIX 24:92:00:05:30:00:2a:1e SOL 24:93:00:05:30:00:2a:1e LIN 24:94:00:05:30:00:2a:1e HP 24:95:00:05:30:00:2a:1e
21-194
Chapter 21
Show Commands show snmp
show snmp
To display SNMP status and setting information, use the show snmp command. show snmp [community | engineid | group | host | sessions | user]
Syntax Description
community engineid group host sessions user
Displays SNMP community strings. Displays SNMP engine ID information. Displays SNMP group information. Displays SNMP host information. Displays SNMP session information. Displays SNMPv3 user information.
Defaults
Displays the system contact, the system location, packet traffic information, community strings, and user information.
Command Modes
EXEC mode.
Command History
Release 1.0(2) 2.0(1b)
Modification This command was introduced. Added the engineid, group, and sessions keywords.
Usage Guidelines
None.
Examples
The following example displays SNMP information.

switch# show snmp sys contact: sys location: 1631 SNMP packets input 0 Bad SNMP versions 0 Unknown community name 0 Illegal operation for community name supplied 0 Encoding errors 64294 Number of requested variables 1 Number of altered variables 1628 Get-request PDUs 0 Get-next PDUs 1 Set-request PDUs 152725 SNMP packets output 0 Too big errors 1 No such name errors 0 Bad values errors 0 General errors
21-195
Chapter 21 show snmp
Show Commands
Community --------public User ____ admin Access -----rw Group _____ network-admin Auth ____ md5 Priv ____ no
The following example displays SNMP user details.

switch# show snmp user User ____ steve sadmin stever Group _____ network-admin network-admin network-operator Auth ____ md5 md5 md5 Priv ____ des des des
The following example displays SNMP community information.

switch# show snmp community Community --------private public v93RACqPNH Access -----rw ro ro
The following example displays SNMP host information.

switch# show snmp host Host ____ 171.16.126.34 171.16.75.106 171.31.124.81 171.31.157.193 171.31.157.98 171.31.49.25 171.31.49.32 171.31.49.49 171.31.49.49 171.31.49.54 171.31.58.54 171.31.58.81 171.31.58.97 171.31.58.97 171.31.58.97 172.22.00.43 172.22.00.65 172.22.05.234 172.22.05.98 Port ____ 2162 2162 2162 2162 2162 2162 2188 2162 3514 2162 2162 2162 1635 2162 3545 2162 2162 2162 1050 Version _______ v2c v2c v2c v2c v2c v2c v2c v2c v2c v2c v2c v2c v2c v2c v2c v2c v2c v2c v2c Level ______ noauth noauth noauth noauth noauth noauth noauth noauth noauth noauth noauth noauth noauth auth auth noauth noauth noauth noauth Type ____ trap trap trap trap trap trap trap trap trap trap trap trap trap trap trap trap trap trap trap SecName ______ public public public public public public public public public public public public public public public public public public public
The following example displays SNMP engine ID information.

switch# show snmp engineID Local SNMP engineID: 800000090300053000A79E
21-196
Chapter 21
Show Commands show snmp
The following example displays SNMP group information.
switch# show snmp group groupname: network-admin security model: any security level: noAuthNoPriv readview: network-admin-rd writeview: network-admin-wr notifyview: network-admin-rd storage-type: permanent row status: active groupname: network-admin security model: any security level: authNoPriv readview: network-admin-rd writeview: network-admin-wr notifyview: network-admin-rd storage-type: permanent row status: active groupname: network-operator security model: any security level: noAuthNoPriv readview: network-operator-rd writeview: network-operator-wr notifyview: network-operator-rd storage-type: permanent row status: active groupname: network-operator security model: any security level: authNoPriv readview: network-operator-rd writeview: network-operator-wr notifyview: network-operator-rd storage-type: permanent row status: active
21-197
Chapter 21 show span session
Show Commands
show span session

To display specific information about a Switched Port Analyzer (SPAN) session, use the show span session command. show span session [session-id [brief] | brief]
Syntax Description
session-id brief
SPAN session ID (1-16). Displays SPAN session configuration in brief format.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays SPAN sessions in a brief format.

switch# show span session brief -------------------------------------------------------Session Admin Oper Destination State State Interface -------------------------------------------------------7 no suspend active fc2/7
The following example displays a specific SPAN session details.

switch# show span session 7 Session 7 (active) Destination is fc2/7 No session filters configured No ingress (rx) sources Egress (tx) sources are port-channel 7,
21-198
Chapter 21
Show Commands show span session
The following example displays all SPAN sessions.
switch# show span session Session 1 (inactive as no destination) Destination is not specified Session filter vsans are 1 No ingress (rx) sources No egress (tx) sources Session 2 (active) Destination is fc9/5 No session filters configured Ingress (rx) sources are vsans 1 sup-fc0, Egress (tx) sources are sup-fc0,
The following example displays a SPAN session mapped to a FC tunnel interface.

switch# show span session Session 2 (active) Destination is fc-tunnel 100 No session filters configured Ingress (rx) sources are fc2/16, Egress (tx) sources are fc2/16,
21-199
Chapter 21 show sprom
Show Commands
show sprom
To display vendor ID, product component attributes, serial number information that can be used to track field replacable units, use the show sprom command. show sprom {backplane backplane-index | clock clock-module-index | fan | mgmt-module | module module-number sprom-index | powersupply powersupply-index | sup}
Syntax Description
backplane backplane-index clock clock-module-index fan mgmt-module
Display attributes that can be used to uniquely identify a switch. The range is 1 to 2. Display attributes of the clock module. There are two clock modules in a switch. This module is absent in MDS9216 type switch. The range is 1 to 2. Display attributes that uniquely identified fan. Display attributes of management module. This module is only present in MDS9216 type switch.
module module-number Display Vendor ID, product's component attributes for the given switching sprom-index module. There can be up to 4 sub-components in a module. Each of them will have a SPROM associated with it. powersupply powersupply-index Displays attributes of the first or the second power-supply. This contains information about the powersupply capacity in watts when it is used in 110Volts and 220Volts respectively. This information is used for power-budget allocation. The range is 1 to 2. Display Vendor ID, product's component attributes for the current supervisor module
sup
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Use the show sprom command to get unique information about a specific module, supervisor module, switch, power-supply module, or a fan module. If the customer needs to report a problem with a module, supervisor module, switch, power-supply module, or a fan module and does not have access to management station, then he can extract serial number information from show sprom.
21-200
Chapter 21
Show Commands show sprom
Examples The following example displays management module information. This module and command are specific to the Cisco MDS 9216 switch.
switch# show sprom mgmt-module DISPLAY SAM sprom contents: Common block: Block Signature :0xabab Block Version :2 Block Length :156 Block Checksum :0x1295 EEPROM Size :0 Block Count :2 FRU Major Type :0x0 FRU Minor Type :0x0 OEM String :Cisco Systems Inc Product Number :SAM SMITH Serial Number :12345678901 Part Number :SAM-SMITH-06 Part Revision :A0 Mfg Deviation : H/W Version :1.0 Mfg Bits :1 Engineer Use :0 snmpOID :0.0.0.0.0.0.0.0 Power Consump :-200 RMA Code :0-0-0-0 Linecard Module specific block: Block Signature :0x6003 Block Version :2 Block Length :103 Block Checksum :0x3c7 Feature Bits :0x0 HW Changes Bits :0x0 Card Index :9009 MAC Addresses :00-12-34-56-78-90 Number of MACs :4 Number of EOBC links :4 Number of EPLD :0 Port Type-Num :200-16 SRAM size :0 Sensor #1 :0,0 Sensor #2 :0,0 Sensor #3 :0,0 Sensor #4 :0,0 Sensor #5 :0,0 Sensor #6 :0,0 Sensor #7 :0,0 Sensor #8 :0,0
The following command displays supervisor module information.

switch# show sprom DISPLAY supervisor Common block: Block Signature : Block Version : Block Length : Block Checksum : EEPROM Size : Block Count : FRU Major Type : FRU Minor Type : OEM String : Product Number : sup sprom contents: 0xabab 2 156 0x10a8 512 2 0x6002 0x7d0 Cisco Systems DS-X9530-SF1-K9
21-201
Chapter 21 show sprom
Show Commands
Serial Number : abcdefgh Part Number : 73-7523-06 Part Revision : 0.0 Mfg Deviation : 0.0 H/W Version : 0.0 Mfg Bits : 0 Engineer Use : 0 snmpOID : 9.5.1.3.1.1.2.2000 Power Consump : -524 RMA Code : 0-0-0-0 Supervisor Module specific block: Block Signature : 0x6002 Block Version : 2 Block Length : 103 Block Checksum : 0x927 Feature Bits : 0x0 HW Changes Bits : 0x0 Card Index : 9003 MAC Addresses : 00-05-30-00-18-be Number of MACs : 4 Number of EPLD : 1 EPLD A : 0x0 Sensor #1 : 75,60 Sensor #2 : 60,55 Sensor #3 : -127,-127 Sensor #4 : -127,-127 Sensor #5 : -128,-128 Sensor #6 : -128,-128 Sensor #7 : -128,-128 Sensor #8 : -128,-128
Related Commands
Command show hardware
Description Displays brief information about the list of field replacable units in the switch.
21-202
Chapter 21
Show Commands show ssh
show ssh
To display Secure Shell information (SSH), use the show ssh command. show ssh {key [dsa | rsa | rsa1] | server}
Syntax Description
key server dsa rsa rsa1
Displays SSH keys. Displays the SSH server status. Displays DSA SSH keys. Displays RSA SSH keys. Displays RSA1 SSH keys.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
To display the host key pair details for the specified key or for all keys, if no key is specified, use the show ssh key command. To display the status of the SSH protocol (enabled or disabled) and the versions that are enabled for that switch, use the show ssh server command.
Examples
The following example displays SSH server status.

switch# show ssh server ssh is enabled version 1 enabled version 2 enabled
21-203
Chapter 21 show ssh
Show Commands
The following example displays Host Key Pair details.
switch# show ssh key rsa1 Keys generated:Sun Jan 13 07:16:26 1980 1024 35 fingerprint: 1024 67:76:02:bd:3e:8d:f5:ad:59:5a:1e:c4:5e:44:03:07 could not retrieve rsa key information dsa Keys generated:Sun Jan 13 07:40:08 1980 ssh-dss AAAAB3NzaC1kc3MAAABBAJTCRQOydNRel2v7uiO6Fix+OTn8eGdnnDVxw5eJs5OcOEXOyjaW cMMYsEgxc9ada1NElp8Wy7GPMWGOQYj9CU0AAAAVAMCcWhNN18zFNOIPo7cU3t7d0iEbAAAAQBdQ8UAO i/Cti84qFb3kTqXlS9mEhdQUo0lHcH5bw5PKfj2Y/dLR437zCBKXetPj4p7mhQ6Fq5os8RZtJEyOsNsA AABAA0oxZbPyWeR5NHATXiyXdPI7j9i8fgyn9FNipMkOF2Mn75Mi/lqQ4NIq0gQNvQOx27uCeQlRts/Q wI4q68/eaw== fingerprint: 512 f7:cc:90:3d:f5:8a:a9:ca:48:76:9f:f8:6e:71:d4:ae
21-204
Chapter 21
Show Commands show ssm provisioning
show ssm provisioning

To display the attributes of the Storage Services Module (SSM) installed, use the show ssm provisioning command. show ssm provisioning
Command History
Release 2.0(2) 2.1(1a)
Modification This command was introduced. Added Provisioning Status column to the display.
Examples
The following example provisions the SSM installed in the switch.

switch# show ssm provisioning Module Ports Application Provisioning Status ----------------------------------------------------------4 1-32 scsi-flow success
Table 21-9 describes the significant fields shown in the show ssm provisioning command output.
Table 21-9 show ssm provisioning Field Descriptions
Field Module Ports Application Provisioning Status
Description Slot where SSM is installed. Ports available on the SSM. Feature configured on the SSM. Displays the status of the SSM attributes.
Related Commands
Command ssm enable feature
Description Enables the SCSI flow feature on the SSM.
21-205
Chapter 21 show startup-config
Show Commands
show startup-config
To display the startup configuration file, use the show startup-config command show startup-config [log]
Syntax Description
log
Displays execution log of last used ASCII startup configuration.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the switch configuration at startup.

switch# show startup-config vsan database vsan 2 vsan 3 vsan 4 vsan 5 vsan 31 vsan 32 suspend vsan 100 vsan 300 interface port-channel 1 switchport mode E switchport trunk mode off interface port-channel 2 fspf cost 100 vsan 2 switchport mode E no switchport trunk allowed vsan all switchport trunk allowed vsan add 1-99 switchport trunk allowed vsan add 101-4093 interface port-channel 3 switchport mode E switchport trunk mode off interface port-channel 4 switchport mode E no switchport trunk allowed vsan all switchport trunk allowed vsan add 1-99 switchport trunk allowed vsan add 101-4093
21-206
Chapter 21
Show Commands show startup-config
interface port-channel 5 switchport mode E no switchport trunk allowed vsan all switchport trunk allowed vsan add 1-10interface port-channel 5 switchport mode E no switchport trunk allowed vsan all switchport trunk allowed vsan add 1-10 interface port-channel 8 switchport mode E interface vsan1 no shutdown snmp-server community public rw snmp-server user admin network-admin auth md5 0xe84b06201ae3bfb726a2eab9f485eb57 localizedkey snmp-server host 171.69.126.34 traps version 2c public udp-port 2162 snmp-server host 171.69.75.106 traps version 2c public udp-port 2162 vsan database vsan 3 interface fc2/9 vsan 3 interface fc2/14 vsan 5 interface fc9/11 vsan 2 interface fc9/12 vsan 3 interface port-channel 3 vsan 3 interface port-channel 4 vsan 100 interface port-channel 8 boot boot boot boot system bootflash:/isan-8b-u sup-1 kickstart bootflash:/boot-3b sup-1 system bootflash:/isan-8b-u sup-2 kickstart bootflash:/boot-3b sup-2
ip default-gateway 172.22.90.1 power redundancy-mode combined force username admin password 5 HyLyYqb4.q74Y zone name Z1 vsan 1 member pwwn 10:00:00:00:77:99:60:2c member pwwn 21:00:00:20:37:a6:be:14 zone default-zone permit vsan 1 zoneset distribute full vsan 51-58 zoneset name ZS1 vsan 1 member Z1 zoneset activate name ZS1 vsan 1 role network-admin
interface fc2/1 switchport mode E switchport trunk mode off no shutdown interface fc2/2 interface fc2/3 channel-group 1 force no shutdown
21-207
Chapter 21 show startup-config
Show Commands
interface fc2/6 channel-group 2 force no shutdown interface fc2/7 switchport mode E no shutdown no switchport trunk allowed vsan all switchport trunk allowed vsan add 1-25 interface fc2/9 switchport mode E switchport trunk mode off no shutdown interface fc2/10 channel-group 3 force no shutdown interface fc2/12 channel-group 4 force no shutdown interface fc2/14 switchport mode E no shutdown no switchport trunk allowed vsan all switchport trunk allowed vsan add 1-99 switchport trunk allowed vsan add 101-4093 interface fc2/15 channel-group 6 force no shutdown interface fc2/16 channel-group 6 force no shutdown . . . interface fc9/10 switchport mode F no shutdown interface fc9/11 switchport trunk mode off no shutdown interface fc9/12 switchport mode E switchport speed 1000 switchport trunk mode off no shutdown interface fc9/15 no shutdown no switchport trunk allowed vsan all switchport trunk allowed vsan add 1-99 switchport trunk allowed vsan add 101-4093
21-208
Chapter 21
Show Commands show startup-config
interface fc9/16 switchport mode FL no shutdown interface mgmt0 ip address 172.22.90.38 255.255.255.0 no shutdown
21-209
Chapter 21 show switchname
Show Commands
show switchname
To display the switch network name, use the show switchname command. show switchname [serialnum]
Syntax Description
serialnum
Displays switch serial number.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the name of the switch.

switch# show switchname switch-123
The following example displays the switch name and serial number.
switch# show switchname switch-123 Serial Number #1 : FOX0712S007 Serial Number #2 :
21-210
Chapter 21
Show Commands show system
show system
To display the system information, use the show system command. show system {cores | default switchport | directory information | error-id {hex-id | list} | exception-info | pss shrink status [details] | redundancy status | reset-reason [module slot] | resources | uptime}
Syntax Description
cores default switchport directory information error-id hex-id list exception-info pss shrink status details redundancy status reset-reason module slot resources uptime
Displays core transfer option. Displays system default values. Directory information of System Manager. Displays description about errors. Specifies the error ID in hexadecimal format. The range is 0x0 to 0xffffffff. Specifies all error IDs. Displays last exception log information. Displays the last PSS shrink status. Displays detailed information on the last PSS shrink status. Redundancy status. Displays the last four reset reason codes. Specifies the module number to display the reset-reason codes. Show the CPU and memory statistics. Displays how long the system has been up and running.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Use the show system redundancy status command to ensure that the system is ready to accept a switchover.
21-211
Chapter 21 show system
Show Commands
Examples The following example displays the system redundancy status.
switch# show system redundancy status Redundancy mode --------------administrative: HA operational: None This supervisor (sup-2) ----------------------Redundancy state: Active Supervisor state: Active Internal state: Active with no standby Other supervisor (sup-1) -----------------------Redundancy state: Not present
The following example displays the default switch port states.

switch# show system default switchport System default port state is down System default trunk mode is on
The following example displays error information for a specified ID.

switch# show system error-id 0x401D0019 Error Facility: module Error Description: Failed to stop Linecard Async Notification.
The following example displays the system health information.

switch# show system health System Health Services iteration frequency 5 seconds Active SUP arbiter is Working Active SUP bootflash is Working
The following example displays the system reset information.

switch# show system reset reason ----- reset reason for module 6 ----1) At 520267 usecs after Tue Aug 5 16:06:24 1980 Reason: Reset Requested by CLI command reload Service: Version: 1.2(0.73a) 2) At 653268 usecs after Tue Aug 5 15:35:24 1980 Reason: Reset Requested by CLI command reload Service: Version: 1.2(0.45c) 3) No time Reason: Unknown Service: Version: 1.2(0.45c) 4) At 415855 usecs after Sat Aug 2 22:42:43 1980 Reason: Power down triggered due to major temperature alarm Service: Version: 1.2(0.45c)
21-212
Chapter 21
Show Commands show system
The following example displays system-related CPU and memory statistics.
switch# show system resources Load average: 1 minute: 0.43 5 minutes: 0.17 15 minutes: 0.11 Processes : 100 total, 2 running CPU states : 0.0% user, 0.0% kernel, 100.0% idle Memory usage: 1027628K total, 313424K used, 714204K free 3620K buffers, 22278K cache
The following example displays the system uptime.

switch# show system uptime Start Time: Sun Oct 13 18:09:23 2030 Up Time: 0 days, 9 hours, 46 minutes, 26 seconds
Use the show system cores command to display the currently configured scheme for copying cores.
switch# show system cores Transfer of cores is enabled
21-213
Chapter 21 show system health
Show Commands
show system health

To display configured Online System Health Management (OSHM) information, use the show system health command. show system health [module slot | statistics [loopback [interface {fc slot/port| iscsi slot/port} | module slot [timelog] | timelog] | module slot]
Syntax Description
module slot statistics interface fc slot/port iscsi slot/port loopback timelog
Displays information for a module in the switch, Displays OHMS statistics. Specifies the required interface. Specifies the Fiber Channel interface at the specified slot and port. Specifies the iSCSI interface at the specified slot and port. Displays the OHMS loopback test statistics. Displays the loopback round trip times.
Defaults
None
Command Modes
EXEC mode
Command History
Usage Guidelines
None.
Examples
The following example displays the current health of all modules in the switch.
switch# show system health Current health information for module 2. Test Frequency Status Action ----------------------------------------------------------------Bootflash 5 Sec Running Enabled EOBC 5 Sec Running Enabled Loopback 5 Sec Running Enabled ----------------------------------------------------------------Current health information for module 6. Test Frequency Status Action ----------------------------------------------------------------InBand 5 Sec Running Enabled Bootflash 5 Sec Running Enabled EOBC 5 Sec Running Enabled Management Port 5 Sec Running Enabled -----------------------------------------------------------------
21-214
Chapter 21
Show Commands show system health
The following example displays the current health of a specified module.
switch# show system health module 8 Current health information for module 8. Test Frequency Status Action ----------------------------------------------------------------Bootflash 5 Sec Running Enabled EOBC 5 Sec Running Enabled Loopback 5 Sec Running Enabled -----------------------------------------------------------------
The following example displays the health statistics for all modules.
switch# show system health statistics Test statistics for module # 1 -----------------------------------------------------------------------------Test Name State Freq(s) Run Pass Fail CFail Errs -----------------------------------------------------------------------------Bootflash Running 5s 12900 12900 0 0 0 EOBC Running 5s 12900 12900 0 0 0 Loopback Running 5s 12900 12900 0 0 0 -----------------------------------------------------------------------------Test statistics for module # 3 -----------------------------------------------------------------------------Test Name State Freq(s) Run Pass Fail CFail Errs -----------------------------------------------------------------------------Bootflash Running 5s 12890 12890 0 0 0 EOBC Running 5s 12890 12890 0 0 0 Loopback Running 5s 12892 12892 0 0 0 -----------------------------------------------------------------------------Test statistics for module # 5 -----------------------------------------------------------------------------Test Name State Freq(s) Run Pass Fail CFail Errs -----------------------------------------------------------------------------InBand Running 5s 12911 12911 0 0 0 Bootflash Running 5s 12911 12911 0 0 0 EOBC Running 5s 12911 12911 0 0 0 Management Port Running 5s 12911 12911 0 0 0 -----------------------------------------------------------------------------Test statistics for module # 6 -----------------------------------------------------------------------------Test Name State Freq(s) Run Pass Fail CFail Errs -----------------------------------------------------------------------------InBand Running 5s 12907 12907 0 0 0 Bootflash Running 5s 12907 12907 0 0 0 EOBC Running 5s 12907 12907 0 0 0 -----------------------------------------------------------------------------Test statistics for module # 8 -----------------------------------------------------------------------------Test Name State Freq(s) Run Pass Fail CFail Errs -----------------------------------------------------------------------------Bootflash Running 5s 12895 12895 0 0 0 EOBC Running 5s 12895 12895 0 0 0 Loopback Running 5s 12896 12896 0 0 0 ------------------------------------------------------------------------------
21-215
Chapter 21 show system health
Show Commands
The following example displays the statistics for a specified module.
switch# show system health statistics module 3 Test statistics for module # 3 -----------------------------------------------------------------------------Test Name State Freq(s) Run Pass Fail CFail Errs -----------------------------------------------------------------------------Bootflash Running 5s 12932 12932 0 0 0 EOBC Running 5s 12932 12932 0 0 0 Loopback Running 5s 12934 12934 0 0 0 ------------------------------------------------------------------------------
The following example displays the loopback test statistics for the entire switch.
switch# show system health statistics loopback ----------------------------------------------------------------Mod Port Status Run Pass Fail CFail Errs 1 16 Running 12953 12953 0 0 0 3 32 Running 12945 12945 0 0 0 8 8 Running 12949 12949 0 0 0 -----------------------------------------------------------------
The following example displays the loopback test statistics for a specified interface.
switch# show system health statistics loopback interface fc 3/1 ----------------------------------------------------------------Mod Port Status Run Pass Fail CFail Errs 3 1 Running 0 0 0 0 0 -----------------------------------------------------------------
Note
Interface-specific counters will remain at zero unless the module-specific loopback test reports errors or failures.
The following example displays the loopback test time log for all modules.
switch# show system health statistics loopback timelog ----------------------------------------------------------------Mod Samples Min(usecs) Max(usecs) Ave(usecs) 1 1872 149 364 222 3 1862 415 743 549 8 1865 134 455 349 -----------------------------------------------------------------
The following example displays the loopback test statistics for a specified module.
switch# show system health statistics loopback module 8 timelog ----------------------------------------------------------------Mod Samples Min(usecs) Max(usecs) Ave(usecs) 8 1867 134 455 349 -----------------------------------------------------------------
21-216
Chapter 21
Show Commands show tacacs+
show tacacs+
To display the TACACS+ Cisco Fabric Services (CFS) distribution status and other details, use the show tacacs+ command. show tacacs+ {distribution status | pending | pending-diff}
Syntax Description
distribution status pending pending-diff
Displays the status of the TACACS+ CFS distribution. Displays the pending configuration that is not yet applied. Displays the difference between the active configuration and the pending configuration.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to display the TACACS+ distribution status.
switch# show tacacs+ distribution status session ongoing: no session db: does not exist merge protocol status: merge activation done last operation: none last operation status: none
Related Commands
Command tacacs+ enable tacacs+ distribute
Description Enables TACACS+. Initiates TACACS+ configuration distribution.
21-217
Chapter 21 show tacacs-server
Show Commands
show tacacs-server
To display configured TACACS+ servers and groups information, use the show tacacs-server command. show tacacs-server [groups | sorted]
Syntax Description
groups sorted
Displays configured TACACS+ server group information. Displays TACACS+ server information sorted by name.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following command displays the configured TACACS+ server information.

switch# show tacacs-server Global TACACS+ shared secret:tacacsPword timeout value:30 total number of servers:3 following TACACS+ servers are configured: 171.71.58.91: available on port:2 cisco.com: available on port:49 171.71.22.95: available on port:49 TACACS+ shared secret:MyKey
The following command displays the configured TACACS+ server groups.

switch# show tacacs-server groups total number of groups:1 following TACACS+ server groups are configured: group TacServer: server 171.71.58.91 on port 2
21-218
Chapter 21
Show Commands show tech-support
show tech-support
To display information useful to technical support when reporting a problem, use the show tech-support command. show tech-support [brief | details | interface {fc slot/port | gigabitethernet slot/port} vsan vsan-id | module slot | vsan vsan-id]
Syntax Description
brief details interface fc slot/port gigabitethernet slot/port module vsan vsan-id
Provides a summary of the current running state of the switch. Provides detailed information for each show command Display interface status and configuration information Specifies the Fiber Channel interface at the specified slot and port. Specifies the Gigabit Ethernet interface at the specified slot and port. Display module status information Display VSAN status and configuration information. The range is 1 to 4093.
Defaults
The default displays output on a per-command basis, with each command being the title of the output that follows. A line separates the output from the next command. The software removes passwords and other security information.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The show tech-support command is a compilation of several show commands and can be quite lengthy. For a sample display of the output of the show tech-support command, see the individual command explanation for the following commands. If you enter the show tech-support command without arguments, the output displays the equivalent of all the following show commands.

show version show environment show module show hardware show running-config show interface show accounting log show process show process log
21-219
Chapter 21 show tech-support
Show Commands

show processes log details show flash
Examples
The following example displays technical support information for a specific module.
switch# show tech-support module 1 'terminal length 0' 'show module ' Mod Ports Module-Type --- ----- ------------------------------1 16 1/2 Gbps FC/Supervisor 2 32 1/2 Gbps FC Module Mod --1 2 Mod --1 2 Sw ----------1.0(0.271) 1.0(0.271) Hw -----0.0 0.0
Model -----------------DS-X9216-K9-SUP DS-X9032
Status -----------active * ok
World-Wide-Name(s) (WWN) -------------------------------------------------20:01:00:05:30:00:21:9e to 20:10:00:05:30:00:21:9e 20:41:00:05:30:00:21:9e to 20:60:00:05:30:00:21:9e Serial-Num ----------
MAC-Address(es) -------------------------------------00-05-30-00-40-b6 to 00-05-30-00-40-ba 00-05-30-00-11-22 to 00-05-30-00-11-26
* this terminal session 'show environment' Clock: ---------------------------------------------------------Clock Model Hw Status ---------------------------------------------------------A Clock Module -ok/active B Clock Module -ok/standby Fan: -----------------------------------------------------Fan Model Hw Status -----------------------------------------------------Chassis DS-2SLOT-FAN 0.0 ok PS-1 --ok PS-2 --absent Temperature: --------------------------------------------------------------Module Sensor MajorThresh MinorThres CurTemp Status (Celsius) (Celsius) (Celsius) --------------------------------------------------------------1 1 75 60 30 ok 1 2 65 50 28 ok 1 3 -127 -127 40 ok 1 4 -127 -127 36 ok 2 2 2 2 1 2 3 4 75 65 -127 -127 60 50 -127 -127 32 26 41 31 ok ok ok ok
21-220
Chapter 21
Show Commands show tech-support
The show tech-support brief command provides a summary of the current running state of the switch.
vegas01# show tech-support brief Switch Name : vegas01 Switch Type : DS-X9216-K9-SUP Kickstart Image : 1.3(2a) bootflash:///m9200-ek9-kickstart-mz.1.3.1.10.bin System Image : 1.3(2a) bootflash:///m9200-ek9-mz.1.3.1.10.bin IP Address/Mask : 10.76.100.164/24 Switch WWN : 20:00:00:05:30:00:84:9e No of VSANs : 9 Configured VSANs : 1-6,4091-4093 VSAN 1: name:VSAN0001, state:active, interop mode:default domain id:0x6d(109), WWN:20:01:00:05:30:00:84:9f [Principal] active-zone:VR, default-zone:deny name:VSAN0002, state:active, interop mode:default domain id:0x7d(125), WWN:20:02:00:05:30:00:84:9f [Principal] active-zone:<NONE>, default-zone:deny name:VSAN0003, state:active, interop mode:default domain id:0xbe(190), WWN:20:03:00:05:30:00:84:9f [Principal] active-zone:<NONE>, default-zone:deny name:VSAN0004, state:active, interop mode:default domain id:0x5a(90), WWN:20:04:00:05:30:00:84:9f [Principal] active-zone:<NONE>, default-zone:deny name:VSAN0005, state:active, interop mode:default domain id:0x13(19), WWN:20:05:00:05:30:00:84:9f [Principal] active-zone:<NONE>, default-zone:deny name:VSAN0006, state:active, interop mode:default domain id:0x1f(31), WWN:20:06:00:05:30:00:84:9f [Principal] active-zone:<NONE>, default-zone:deny name:VSAN4091, state:active, interop mode:default domain id:0x08(8), WWN:2f:fb:00:05:30:00:84:9f [Principal] active-zone:<NONE>, default-zone:deny name:VSAN4092, state:active, interop mode:default domain id:0x78(120), WWN:2f:fc:00:05:30:00:84:9f [Principal] active-zone:<NONE>, default-zone:deny name:VSAN4093, state:active, interop mode:default domain id:0x77(119), WWN:2f:fd:00:05:30:00:84:9f [Principal] active-zone:<NONE>, default-zone:deny
VSAN
2:
VSAN
3:
VSAN
4:
VSAN
5:
VSAN
6:
VSAN 4091:
VSAN 4092:
VSAN 4093:
------------------------------------------------------------------------------Interface Vsan Admin Admin Status FCOT Oper Oper Port Mode Trunk Mode Speed Channel Mode (Gbps) ------------------------------------------------------------------------------fc1/1 1 auto on fcotAbsent ---fc1/2 1 auto on fcotAbsent ---fc1/3 1 auto on fcotAbsent ---fc1/4 1 auto on fcotAbsent ---fc1/5 1 auto on notConnected swl --fc1/6 1 auto on fcotAbsent ---fc1/7 1 auto on fcotAbsent ---fc1/8 1 auto on fcotAbsent ---fc1/9 1 auto on fcotAbsent ---fc1/10 1 auto on fcotAbsent ----
21-221
Chapter 21 show tech-support
Show Commands
fc1/11 fc1/12 fc1/13 fc1/14 fc1/15 fc1/16 1 1 1 1 1 1 auto auto auto auto auto auto on on on on on on fcotAbsent fcotAbsent fcotAbsent fcotAbsent fcotAbsent fcotAbsent -------------------
------------------------------------------------------------------------------Interface Status Speed (Gbps) ------------------------------------------------------------------------------sup-fc0 up 1 ------------------------------------------------------------------------------Interface Status IP Address Speed MTU ------------------------------------------------------------------------------mgmt0 up 10.76.100.164/24 100 Mbps 1500
Power Supply: ----------------------------------------------------PS Model Power Power Status (Watts) (Amp @42V) ----------------------------------------------------1 WS-CAC-950W 919.38 21.89 ok 2 --absent
Mod Model
--- ------------------1 DS-X9216-K9-SUP 2 DS-X9032
Power Requested (Watts) ------220.08 199.92
Power Requested (Amp @42V) ---------5.24 4.76
Power Allocated (Watts) --------220.08 199.92
Power Allocated (Amp @42V) ---------5.24 4.76
Status
---------powered-up powered-up
Power Usage Summary: -------------------Power Supply redundancy mode: Total Power Capacity Power reserved for Supervisor(s)[-] Power reserved for Fan Module(s)[-] Power currently used by Modules[-]
redundant 919.38 220.08 47.88 199.92 ------451.50 W W W W
Total Power Available
21-222
Chapter 21
Show Commands show telnet server
show telnet server

To display the state of the Telnet access configuration, use the show telnet server command. show telnet server
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the status of the Telnet server.

switch# show telnet server telnet service enabled
21-223
Chapter 21 show terminal
Show Commands
show terminal
To display the terminal information, use the show terminal command show terminal
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays terminal information.

switch# show terminal TTY: Type: vt100 Length: 25 lines, Width: 80 columns Session Timeout: 30 minutes
21-224
Chapter 21
Show Commands show tlport
show tlport
To display configured TL port information, use the show tlport command show tlport {alpa-cache | discapp fcid fcid-id [vsan vsan-id] [verbose] | interface fc slot/port {all | private | proxied | topology | unsupported} | list [vsan vsan-id]}
Syntax Description
alpa-cache discapp fcid fcid-id verbose vsan vsan-id interface fc slot/port all private proxied topology unsupported list
Displays the contents of the ALPA cache. Displays private N port parameters. Specifies the FCID of the N port. Specifies the verbose mode. Specifies the N port VSAN ID. The range is 1 to 4093. Displays TL ports in the selected interface. Specifies the Fiber Channel interface at the specified slot and port. Displays all proxied & private devices on this TL Port. Displays all private devices on this TL Port. Displays all proxied devices on this TL Port. Displays loop topology for this TL Port. Displays all unsupported devices on this TL Port. Displays TL ports in all VSANs.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The show tlport command displays the TL port interface configurations. This command provides a list of all TL ports configured on a box and displays the associated VSAN, the FCID for the port (only domain and area are valid), and the current operational state of the TL port (up or initializing).
21-225
Chapter 21 show tlport
Show Commands
Examples The following example displays the TL ports in all VSANs.
switch# show tlport list ------------------------------Interface Vsan FC-ID State ------------------------- -----fc1/16 1 0x420000 Init fc2/26 1 0x150000 Up
The following example displays the detailed information for a specific TL port.
switch# show tlport interface fc1/16 all fc1/16 is up, vsan 1, FCID 0x420000 -------------------------------------------------------------------------------alpa pWWN nWWN SCSI Type Device FC-ID -------------------------------------------------------------------------------0x01 20:10:00:05:30:00:4a:de 20:00:00:05:30:00:4a:de Initiator Proxied 0xfffc42 0x73 22:00:00:20:37:39:ae:54 20:00:00:20:37:39:ae:54 Target Private 0x420073 0xef 20:10:00:05:30:00:4a:de 20:00:00:05:30:00:4a:de Initiator Switch 0x0000ef
The following example displays TL port information for private devices.

switch# show tlport int fc1/16 pri fc1/16 is up, vsan 1, FCID 0x420000 -----------------------------------------------------------------------alpa pWWN nWWN SCSI Type FC-ID -----------------------------------------------------------------------0x73 22:00:00:20:37:39:ae:54 20:00:00:20:37:39:ae:54 Target 0x420073 0x74 22:00:00:20:37:38:d3:de 20:00:00:20:37:38:d3:de Target 0x420074
The following example displays TL port information for proxied devices.

switch# show tlport int fc1/16 prox fc1/16 is up, vsan 1, FCID 0x420000 -----------------------------------------------------------------------alpa pWWN nWWN SCSI Type FC-ID -----------------------------------------------------------------------0x01 20:10:00:05:30:00:4a:de 20:00:00:05:30:00:4a:de Initiator 0xfffc42 0x02 21:00:00:e0:8b:01:95:e7 20:00:00:e0:8b:01:95:e7 Initiator 0x420100
The following example displays the contents of the alpa-cache.

switch# show tlport alpa-cache --------------------------------------------------------alpa pWWN Interface --------------------------------------------------------0x02 22:00:00:20:37:46:09:bd fc1/2 0x04 23:00:00:20:37:46:09:bd fc1/2
21-226
Chapter 21
Show Commands show topology
show topology
To display topology information for connected switches, use the show topology command. show topology [vsan vsan-id]
Syntax Description
vsan vsan-id
Displays information for a VSAN. The range is 1 to 4093.
Defaults
Displays information for all VSANs.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example displays topology information.

switch# show topology FC Topology for VSAN 1 : -------------------------------------------------------------------------------Interface Peer Domain Peer Interface Peer IP Address -------------------------------------------------------------------------------fc1/1 0xef(239) fc2/15 172.22.46.220 fc1/5 0xe6(230) fc1/5 172.22.46.222 fc1/6 0xe6(230) fc1/6 172.22.46.222 fc1/7 0xe6(230) fc1/7 172.22.46.222 fc1/8 0xe3(227) fc1/1 172.22.46.233 fc1/10 0xe6(230) fc1/10 172.22.46.222 fc1/11 0xe6(230) fc1/11 172.22.46.222 fc1/12 0xe6(230) fc1/12 172.22.46.222 fc1/13 0xe6(230) fc1/13 172.22.46.222 fc1/14 0xe6(230) fc1/14 172.22.46.222 fc1/15 0xe6(230) fc1/15 172.22.46.222 fc1/16 0xe6(230) fc1/16 172.22.46.222 fcip2 0xef(239) fcip2 172.22.46.220 FC Topology for VSAN 73 : -------------------------------------------------------------------------------Interface Peer Domain Peer Interface Peer IP Address -------------------------------------------------------------------------------fc1/1 0x65(101) fc2/15 172.22.46.220 fcip2 0x65(101) fcip2 172.22.46.220
21-227
Chapter 21 show topology
Show Commands
FC Topology for VSAN 4001 : -------------------------------------------------------------------------------Interface Peer Domain Peer Interface Peer IP Address -------------------------------------------------------------------------------fc1/1 0xef(239) fc2/15 172.22.46.220 fc1/5 0xeb(235) fc1/5 172.22.46.222 fc1/6 0xeb(235) fc1/6 172.22.46.222 fc1/7 0xeb(235) fc1/7 172.22.46.222 fc1/8 0xed(237) fc1/1 172.22.46.233 fc1/10 0xeb(235) fc1/10 172.22.46.222 fc1/11 0xeb(235) fc1/11 172.22.46.222 fc1/12 0xeb(235) fc1/12 172.22.46.222 fc1/13 0xeb(235) fc1/13 172.22.46.222 fc1/14 0xeb(235) fc1/14 172.22.46.222 fc1/15 0xeb(235) fc1/15 172.22.46.222 fc1/16 0xeb(235) fc1/16 172.22.46.222 fcip2 0xef(239) fcip2 172.22.46.220 FC Topology for VSAN 4002 : -------------------------------------------------------------------------------Interface Peer Domain Peer Interface Peer IP Address -------------------------------------------------------------------------------fc1/1 0xeb(235) fc2/15 172.22.46.220 fc1/5 0xe9(233) fc1/5 172.22.46.222 fc1/6 0xe9(233) fc1/6 172.22.46.222 fc1/7 0xe9(233) fc1/7 172.22.46.222 fc1/8 0x1c(28) fc1/1 172.22.46.233 fc1/10 0xe9(233) fc1/10 172.22.46.222 fc1/11 0xe9(233) fc1/11 172.22.46.222 fc1/12 0xe9(233) fc1/12 172.22.46.222 fc1/13 0xe9(233) fc1/13 172.22.46.222 fc1/14 0xe9(233) fc1/14 172.22.46.222 fc1/15 0xe9(233) fc1/15 172.22.46.222 fc1/16 0xe9(233) fc1/16 172.22.46.222 fcip2 0xeb(235) fcip2 172.22.46.220 FC Topology for VSAN 4003 : -------------------------------------------------------------------------------Interface Peer Domain Peer Interface Peer IP Address -------------------------------------------------------------------------------fc1/1 0xdd(221) fc2/15 172.22.46.220 fc1/5 0xdb(219) fc1/5 172.22.46.222 fc1/6 0xdb(219) fc1/6 172.22.46.222 fc1/7 0xdb(219) fc1/7 172.22.46.222 fc1/8 0x60(96) fc1/1 172.22.46.233 fc1/10 0xdb(219) fc1/10 172.22.46.222 fc1/11 0xdb(219) fc1/11 172.22.46.222 fc1/12 0xdb(219) fc1/12 172.22.46.222 fc1/13 0xdb(219) fc1/13 172.22.46.222 fc1/14 0xdb(219) fc1/14 172.22.46.222 fc1/15 0xdb(219) fc1/15 172.22.46.222 fc1/16 0xdb(219) fc1/16 172.22.46.222 fcip2 0xdd(221) fcip2 172.22.46.220 FC Topology for VSAN 4004 : -------------------------------------------------------------------------------Interface Peer Domain Peer Interface Peer IP Address -------------------------------------------------------------------------------fc1/9 0x01(1) Port 1 172.22.46.226
21-228
Chapter 21
Show Commands show trunk protocol
show trunk protocol

To display trunk protocol status, use the show trunk protocol command. show trunk protocol
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays trunk protocol status.

switch# show trunk protocol Trunk protocol is enabled
21-229
Chapter 21 show user-account
Show Commands
show user-account
To display configured information about user accounts, use the show user-account command. show user-account [user-name | iscsi]
Syntax Description
user-name iscsi
Displays the user account information for the specified user name. Displays the iSCSI user account information.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays information for a specified user.

switch# show user-account user1 user:user1 this user account has no expiry date roles:network-operator no password set. Local login not allowed Remote login through RADIUS is possible
The following example displays information for all users.

switch# show user-account show user-account user:admin this user account has no expiry date roles:network-admin user:usam expires on Sat May 31 00:00:00 2003 roles:network-admin network-operator user:msam this user account has no expiry date roles:network-operator user:user1 this user account has no expiry date roles:network-operator no password set. local login not allowed Remote login through RADIUS is possible
21-230
Chapter 21
Show Commands show users
show users
To display all users currently accessing the switch, use the show users command. show users
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays all users.

switch# show users admin pts/7 admin pts/9 admin pts/10 admin pts/11 Jan Jan Jan Jan 12 12 13 13 20:56 23:29 03:05 01:53 (10.77.202.149) (modena.cisco.com) (dhcp-171-71-58-120.cisco.com) (dhcp-171-71-49-49.cisco.com)
21-231
Chapter 21 show version
Show Commands
show version
To display the version of system software that is currently running on the switch, use the show version command. show version [epld url | image {bootflash: | slot0: | volatile:}image-filename | module slot [epld]]
Syntax Description
epld url image bootflash: slot0: volatile: image-filename module slot epld
Displays all EPLD versions that are available at the specified URL (bootflash:, ftp:, scp:, sftp:, slot0:, tftp:, or volatile:) Displays the software version of a given image. Specifies internal bootflash memory. Specifies CompactFlash memory or PCMCIA card. Specifies the volatile directory. Specifies the name of the system or kickstart image. Displays the software version of a module in the specified slot. Displays all current versions of EPLDs on a specified module.
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2) and modified in Release 1.0(3).
Usage Guidelines
Use the show version image command to verify the integrity of the image before loading the images. This command can be used for both the system and kickstart images. Use the show version command to verify the version on the active and standby supervisor modules before and after an upgrade.
Examples
The following examples display the versions of the system, kickstart, and failed images.
switch(boot)# show version image bootflash:system_image <------------system image name: m9500-sf1ek9-mz.1.0.3.bin system: version 1.0(3) compiled: 10/25/2010 12:00:00 switch(boot)# image name: kickstart: loader: compiled:
image
show version image bootflash:kickstart_image <-------------kickstart m9500-sf1ek9-kickstart-mz.1.0.3.upg.bin version 1.0(3) version 1.0(3) 10/25/2010 12:00:00
image
21-232
Chapter 21
Show Commands show version
switch# show version image bootflash:bad_image <--------------failure Md5 Verification Failed Image integrity check failed
case
The following example displays current EPLD versions for a specified module.
switch# show version module 2 epld Module Number 2 EPLD Device Version -----------------------------------Power Manager 0x06 XBUS IO 0x07 UD chip Fix 0x05 Sahara 0x05
The following example displays available EPLD versions.

switch# show version epld bootflash:m9000-epld-2.0.1b.img MDS series EPLD image, built on Mon Sep 20 16:39:36 2004 Module Type EPLD Device Version --------------------------------------------------------------MDS 9500 Supervisor 1 XBUS 1 IO 0x09 XBUS 2 IO 0x0c UD Flow Control 0x05 PCI ASIC I/F 0x04 1/2 Gbps FC Module (16 Port) XBUS IO 0x07 UD Flow Control 0x05 PCI ASIC I/F 0x05 1/2 Gbps FC Module (32 Port) XBUS IO 0x07 UD Flow Control 0x05 PCI ASIC I/F 0x05 Advanced Services Module XBUS IO 0x07 UD Flow Control 0x05 PCI ASIC I/F 0x05 PCI Bridge 0x05 IP Storage Services Module (8 Port) Power Manager 0x07 XBUS IO 0x03 UD Flow Control 0x05 PCI ASIC I/F 0x05 Service Module I/F 0x0a IPS DB I/F 0x1a IP Storage Services Module (4 Port) Power Manager 0x07 XBUS IO 0x03 UD Flow Control 0x05 PCI ASIC I/F 0x05 Service Module I/F 0x1a Caching Services Module Power Manager 0x08 XBUS IO 0x03 UD Flow Control 0x05 PCI ASIC I/F 0x05 Service Module I/F 0x72 Memory Decoder 0 0x02 Memory Decoder 1 0x02 MDS 9100 Series Fabric Switch XBUS IO 0x03 PCI ASIC I/F 0x40000003 2x1GE IPS, 14x1/2Gbps FC Module Power Manager 0x07 XBUS IO 0x05 UD Flow Control 0x05 PCI ASIC I/F 0x07 IPS DB I/F 0x1a
21-233
Chapter 21 show version
Show Commands
The following example displays the entire output for the show version command.
switch# show version Cisco Storage Area Networking Operating System (SAN-OS) Software TAC support: http://www.cisco.com/tac Copyright (c) 2002-2003, Cisco Systems, Inc. All rights reserved. The copyrights to certain works contained herein are owned by Andiamo Systems, Inc. and/or other third parties and are used and distributed under license. Some parts of this software are covered under the GNU Public License. A copy of the license is available at http://www.gnu.org/licenses/gpl.html. Software BIOS: loader: kickstart: system:
version version version version
1.0.8 1.1(2) 2.0(1b) [build 2.0(0.6)] [gdb] 2.0(1b) [build 2.0(0.6)] [gdb] 08/07/03 bootflash:///m9500-sf1ek9-kickstart-mzg.2.0.0.6.bin 10/25/2010 12:00:00 bootflash:///m9500-sf1ek9-mzg.2.0.0.6.bin 10/25/2020 12:00:00
BIOS compile time: kickstart image file is: kickstart compile time: system image file is: system compile time:
Hardware RAM 1024584 kB bootflash: 1000944 blocks (block size 512b) slot0: 0 blocks (block size 512b) 172.22.92.181 uptime is 0 days 2 hours 18 minute(s) 1 second(s) Last reset at 970069 usecs after Tue Sep 16 22:31:25 1980 Reason: Reset Requested by CLI command reload System version: 2.0(0.6) Service:
The following examples displays a before and after comparison scenario after the loader version is updated.
switch# show version Cisco Storage Area Networking Operating System (SAN-OS) Software TAC support: http://www.cisco.com/tac Copyright (c) 2002-2003 by Cisco Systems, Inc. All rights reserved. The copyright for certain works contained herein are owned by Andiamo Systems, Inc. and/or other third parties and are used and distributed under license. Software BIOS: version 1.0(3) loader: version 1.0(2) <---------------existing version kickstart: version 1.0(3) system: version 1.0(3) BIOS compile time: 11/18/02 kickstart image file is: bootflash:/kickstart_image kickstart compile time: 1/20/2003 12:00:00 system image file is: bootflash:/system_image system compile time: 1/20/2003 12:00:00 switch# show version Cisco Storage Area Networking Operating System (SAN-OS) Software TAC support: http://www.cisco.com/tac Copyright (c) 2002-2003 by Cisco Systems, Inc. All rights reserved. The copyright for certain works contained herein are owned by
21-234
Chapter 21
Show Commands show version
Andiamo Systems, Inc. and/or other third parties and are used and distributed under license. Software BIOS: version 1.0(3) loader: version 1.0(3) <---------------new version .....
The following example displays the version details for a specified module.
switch# show ver mod 4 Mod No Mod Type 4 LC SW Version 1.0(3) SW Interim Version 1.0(3)
21-235
Chapter 21 show vrrp
Show Commands
show vrrp
To display the VRRP configuration information, use the show vrrp command. show vrrp [statistics | vr group [interface type]]
Syntax Description
statistics vr group interface type
Displays cumulative vrrp statistics for this machine. Displays virtual router information. Specifies the group ID. The range is 1 to 255. Enter mgmt 0 for management interface, or VSAN for the IPFC VSAN interface.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays VRRP configured information.

switch# show vrrp vr 7 interface vsan 2 configuration vr id 7 configuration admin state down priority 100 no authentication advertisement-Interval 1 preempt yes tracking interface vsan1 priority 2 protocol IP
The following example displays VRRP status information.

switch# show vrrp vr 7 interface vsan 2 status vr id 7 status MAC address 00:00:5e:00:01:07 Operational state: init
21-236
Chapter 21
Show Commands show vrrp
The following example displays VRRP statistics.
switch# show vrrp vr 7 interface vsan 2 statistics vr id 7 statistics Become master 0 Advertisement 0 Advertisement Interval Error 0 Authentication Failure 0 TTL Error 0 Priority 0 Received 0 Priority 0 Sent 0 Invalid Type 0 Mismatch Address List 0 Invalid Authentication Type 0 Mismatch Authentication 0 Invalid Packet Length 0
The following example displays VRRP cumulative statistics.

switch# Invalid Invalid Invalid show vrrp statistics checksum 0 version 0 VR ID 0
21-237
Chapter 21 show vsan
Show Commands
show vsan
To display information about configured VSAN, use the show vsan command. show vsan [vsan-id [membership] | membership interface {fc slot/port | fcip fcip-id | fv slot/dpp-number/fv-port | iscsi slot/port | portchannel portchannel-number.subinterface-number}] | usage]
Syntax Description
vsan vsan-id membership interface fc slot/port fcip fcip-id
Displays information for the specified VSAN ID. The range is 1 to 4093. Displays membership information. Specifies the interface type. Specifies a Fibre Channel interface by the slot and port. Specifies a FC IP interface ID. The range is 1 to 255.
fv slot/dpp-number/fv-p Specifies a virtual F port (FV port) interface in the specified slot along with ort the data path processor (DPP) number and the FV port number. port-channel portchannel-number. subinterface-number usage Specifies a PortChannel interface specified by the PortChannel number followed by a dot (.) indicator and the subinterface number. Displays VSAN usage in the system.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
For the show vsan membership interface command, interface information is not displayed if interfaces are not configured on this VSAN. The interface range must be in ascending order and non-overlapping. You can specify a range using a hyphen and several interfaces using commas:
The interface range format for an FC interface range is fcslot/port - port , fcslot/port , fcslot/port (For example, show int fc1/1 - 3 , fc1/5 , fc2/5) The interface range format for an FV interface range is fvslot/dpp/fvport - fvport , fvslot/dpp/port , fvslot/dpp/port (For example, show int fv2/1/1 - 3 , fv2/1/5 , fv2/2/5) The format for a PortChannel is port-channel portchannel-number.subinterface-number (For example, show int port-channel 5.1)
21-238
Chapter 21
Show Commands show vsan
Examples The following examples displays configured VSAN information.
switch# show vsan 1 vsan 1 information name:VSAN0001 state:active interoperability mode:yes verify mode loadbalancing:src-id/dst-id/oxid operational state:up switch# show vsan usage 4 vsan configured configured vsans:1-4 vsans available for configuration:5-4093 switch # show vsan 1 membership vsan 1 interfaces: fc1/1 fc1/2 fc1/3 fc1/4 fc1/10 fc1/11 fc1/12 fc1/13
fc1/5 fc1/14
fc1/6 fc1/15
fc1/7 fc1/16
fc1/9 port-channel 99
The following example displays membership information for all VSANs.

switch # show vsan membership vsan 1 interfaces: fc2/16 fc2/15 fc2/14 fc2/13 fc2/8 fc2/7 fc2/6 fc2/5 fc1/16 fc1/15 fc1/14 fc1/13 fc1/7 fc1/6 fc1/5 fc1/4 vsan 2 interfaces: vsan 7 interfaces: fc1/8 vsan 100 interfaces: vsan 4094(isolated vsan) interfaces:
fc2/12 fc2/4 fc1/12 fc1/3
fc2/11 fc2/3 fc1/11 fc1/2
fc2/10 fc2/2 fc1/10 fc1/1
fc2/9 fc2/1 fc1/9
The following example displays membership information for a specified interface.

switch # show vsan membership interface fc1/1 fc1/1 vsan:1 allowed list:1-4093 switch# show vsan vsan 1 information name:VSAN0001 state:active interoperability mode:default loadbalancing:src-id/dst-id/oxid operational state:up vsan 2 information name:VmVSAN state:active interoperability mode:default loadbalancing:src-id/dst-id/oxid operational state:up vsan 3 information name:Disk_A state:active interoperability mode:default loadbalancing:src-id/dst-id/oxid operational state:up vsan 4 information name:Host_B state:active interoperability mode:default loadbalancing:src-id/dst-id/oxid operational state:up
21-239
Chapter 21 show vsan
Show Commands
vsan 4094:isolated_vsan switch# show vsan membership interface fv 2/1/3 , fv2/1/5 - 7 fv2/1/3 vsan:2 allowed list:1-4093 fv2/1/5 vsan:3 allowed list:1-4093 fv2/1/6 vsan:4 allowed list:1-4093 fv2/1/7 vsan:4 allowed list:1-409
21-240
Chapter 21
Show Commands show wwn
show wwn
To display the status of the WWN configuration, use the show wwn commands. show wwn {status block-id number | switch}
Syntax Description
status block-id number Displays WWN usage and alarm status for a block ID. The range is 34 to 1793. switch Displays switch WWN.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the WWN of the switch.

switch# show wwn switch Switch WWN is 20:01:ac:16:5e:52:00:01
21-241
Chapter 21 show zone
Show Commands
show zone
To display zone information, use the show zone command. show zone [active [vsan vsan-id] | ess [vsan vsan-id] | member {fcalias alias-name | fcid fcid-id [lun lun-id] | pwwn wwn [lun lun-id]} [active | vsan vsan-id] | name string [active] [vsan vsan-id] | statistics [lun-zoning [vsan vsan-id] | read-only-zoning [vsan vsan-id] | vsan vsan-id] | status [vsan vsan-range] vsan [vsan vsan-id]]
Syntax Description
active ess member name statistics status vsan vsan-id lun lun-id lun-zoning read-only-zoning
Displays zones which are part of active zone set. Displays ESS information. Displays all zones in which the given member is part of. Displays members of a specified zone. Displays zone server statistics. Displays zone server current status. Displays zones belonging to the specified VSAN ID. The range is 1 to 4093. Specifies a LUN ID. Displays LUN zoning related statistics Displays read-only zoning related statistics
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.3(4) 2.1(1a)
Modification This command was introduced. Modified the show zone status display.
Usage Guidelines
None.
Examples
The following example displays configured zone information.

switch# show zone zone name Zone3 vsan 1 pwwn 21:00:00:20:37:6f:db:dd pwwn 21:00:00:20:37:9c:48:e5 zone name Zone2 vsan 2
21-242
Chapter 21
Show Commands show zone
fwwn 20:41:00:05:30:00:2a:1e fwwn 20:42:00:05:30:00:2a:1e fwwn 20:43:00:05:30:00:2a:1e zone name Zone1 vsan 1 pwwn 21:00:00:20:37:6f:db:dd pwwn 21:00:00:20:37:a6:be:2f pwwn 21:00:00:20:37:9c:48:e5 fcalias Alias1 zone name Techdocs vsan 3 ip-address 10.15.0.0 255.255.255.0
The following example displays zone information for a specific VSAN.

switch# show zone vsan 1 zone name Zone3 vsan 1 pwwn 21:00:00:20:37:6f:db:dd pwwn 21:00:00:20:37:9c:48:e5 zone name Zone2 vsan 1 fwwn 20:41:00:05:30:00:2a:1e fwwn 20:42:00:05:30:00:2a:1e fwwn 20:43:00:05:30:00:2a:1e fwwn 20:44:00:05:30:00:2a:1e fwwn 20:45:00:05:30:00:2a:1e fwwn 20:46:00:05:30:00:2a:1e fwwn 20:47:00:05:30:00:2a:1e fwwn 20:48:00:05:30:00:2a:1e fwwn 20:49:00:05:30:00:2a:1e fwwn 20:4a:00:05:30:00:2a:1e fwwn 20:4b:00:05:30:00:2a:1e fwwn 20:4c:00:05:30:00:2a:1e fwwn 20:4d:00:05:30:00:2a:1e fwwn 20:4e:00:05:30:00:2a:1e fwwn 20:4f:00:05:30:00:2a:1e fwwn 20:50:00:05:30:00:2a:1e fwwn 20:51:00:05:30:00:2a:1e fwwn 20:52:00:05:30:00:2a:1e fwwn 20:53:00:05:30:00:2a:1e fwwn 20:54:00:05:30:00:2a:1e fwwn 20:55:00:05:30:00:2a:1e fwwn 20:56:00:05:30:00:2a:1e fwwn 20:57:00:05:30:00:2a:1e fwwn 20:58:00:05:30:00:2a:1e fwwn 20:59:00:05:30:00:2a:1e fwwn 20:5a:00:05:30:00:2a:1e fwwn 20:5b:00:05:30:00:2a:1e fwwn 20:5c:00:05:30:00:2a:1e fwwn 20:5d:00:05:30:00:2a:1e fwwn 20:5e:00:05:30:00:2a:1e fwwn 20:5f:00:05:30:00:2a:1e fwwn 20:60:00:05:30:00:2a:1e zone name Zone1 vsan 1 pwwn 21:00:00:20:37:6f:db:dd pwwn 21:00:00:20:37:a6:be:2f pwwn 21:00:00:20:37:9c:48:e5 fcalias Alias1
The following example displays members of a specific zone.

switch# show zone name Zone1 zone name Zone1 vsan 1 pwwn 21:00:00:20:37:6f:db:dd pwwn 21:00:00:20:37:a6:be:2f pwwn 21:00:00:20:37:9c:48:e5 fcalias Alias1
21-243
Show Commands
The following example displays all zones to which a member belongs using the FCID.
switch# show zone member pwwn 21:00:00:20:37:9c:48:e5 VSAN: 1 zone Zone3 zone Zone1 fcalias Alias1
The following example displays the number of control frames exchanged with other switches.
switch# show zone statistics Statistics For VSAN: 1 ********************************** Number of Merge Requests Sent: 24 Number of Merge Requests Recvd: 25 Number of Merge Accepts Sent: 25 Number of Merge Accepts Recvd: 25 Number of Merge Rejects Sent: 0 Number of Merge Rejects Recvd: 0 Number of Change Requests Sent: 0 Number of Change Requests Recvd: 0 Number of Change Rejects Sent: 0 Number of Change Rejects Recvd: 0 Number of GS Requests Recvd: 0 Number of GS Requests Rejected: 0 Statistics For VSAN: 2 ********************************** Number of Merge Requests Sent: 4 ... Number of GS Requests Rejected: 0
The following example displays LUN-zoning details.

switch# show zone statistics lun-zoning LUN zoning statistics for VSAN: 1 ************************************************************ S-ID: 0x123456, D-ID: 0x22222, LUN: 00:00:00:00:00:00:00:00 -----------------------------------------------------------Number of Inquiry commands received: 10 Number of Inquiry data No LU sent: 5 Number of Report LUNs commands received: 10 Number of Request Sense commands received: 1 Number of Other commands received: 0 Number of Illegal Request Check Condition sent: 0 S-ID: 0x123456, D-ID: 0x22222, LUN: 00:00:00:00:00:00:00:01 -----------------------------------------------------------Number of Inquiry commands received: 1 Number of Inquiry data No LU sent: 1 Number of Request Sense commands received: 1 Number of Other commands received: 0 Number of Illegal Request Check Condition sent: 0
The following example displays read-only zone details.

switch# show zone statistics read-only-zoning Read-only zoning statistics for VSAN: 2 ************************************************************ S-ID: 0x33333, D-ID: 0x11111, LUN: 00:00:00:00:00:00:00:64 -----------------------------------------------------------Number of Data Protect Check Condition Sent: 12
21-244
Chapter 21
Show Commands show zone
The following example displays the status of the configured zones.
switch# show zone status VSAN: 1 default-zone: deny distribute: active only Interop: default mode: basic merge-control: allow session: none hard-zoning: enabled Default zone: qos: low broadcast: disabled ronly: disabled Full Zoning Database : Zonesets:0 Zones:0 Aliases: 0 Active Zoning Database : Database Not Available Status: ............ VSAN: 3 default-zone: deny distribute: active only Interop: default mode: basic merge-control: allow session: none hard-zoning: enabled Default zone: qos: low broadcast: disabled ronly: disabled Full Zoning Database : Zonesets:0 Zones:0 Aliases: 0 Active Zoning Database : Database Not Available Status:
The following example checks the status of the zoneset distribute vsan command and displays the default zone attributes of a specific VSAN or all active VSANs.
switch# show zone status vsan 1 VSAN:1 default-zone:deny distribute:active only Interop:default mode:basic merge-control:allow session:none hard-zoning:enabled Default zone: qos:low broadcast:disabled ronly:disabled Full Zoning Database : Zonesets:0 Zones:0 Aliases:0 Active Zoning Database : Database Not Available Status:
Table 21-10 describes the significant fields shown in the show zone status vsan display.
Table 21-10 show zone status Field Descriptions
Field VSAN: default-zone: Default zone:
Description VSAN number displayed Default-zone policy either permit or deny. The Default zone field displays the attributes for the specified VSAN. The attributes include: Qos level, broadcast zoning enabled/disabled, and read-only zoning enabled/disabled. Distribute full-zone set (full) or active-zone set (active only). Displays interop mode. 100 = default, 1 = standard, 2 and 3 = Non-Cisco Vendors. Displays zoning mode either basic or enhanced. Displays merge policy either allow or restrict. If hardware resources (TCAM) becomes full, hard zoning is automatically disabled.
distribute: Interop: mode: merge control: Hard zoning is enabled
21-245
Show Commands
Table 21-10 show zone status Field Descriptions (continued)
Field Full Zoning Database: Active Zoning Database: Status:
Description Displays values of zone database. Displays values of active zone database. Displays status of last zone distribution.
21-246
Chapter 21
Show Commands show zone-attribute-group
show zone-attribute-group
To display the device name information, use the show zone-attribute-group command. show zone-attribute-group [name group-name] [pending] [vsan vsan-id]
Syntax Description
name group-name pending vsan vsan-id
Displays the entire device name database. Displays the pending device name database information. Specifies a VSAN ID. The range is 1 to 4093.
Defaults
Displays information for default zone attribute groups.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to display the contents of pending zone attribute groups.
switch# show zone-autoboot-group pending zone-attribute-group name $default_zone_attr_group$ vsan 4061 zone-attribute-group name admin-group vsan 4061 broadcast
Related Commands
Command zone-attribute-group name
Description Configures zone attribute groups.
21-247
Chapter 21 show zoneset
Show Commands
show zoneset
To display the configured zone sets, use the show zoneset command. show zoneset [name zoneset-name] [brief] [active] [vsan vsan-id]
Syntax Description
name zoneset-name brief active vsan vsan-id
Displays members of a specified zone set. Maximum length is 64 characters. Displays members in brief mode. Displays only active zone sets. Displays zone sets belonging to the specified VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays configured zone set information.

switch# show zoneset vsan 1 zoneset name ZoneSet2 vsan 1 zone name Zone2 vsan 1 fwwn 20:4e:00:05:30:00:2a:1e fwwn 20:4f:00:05:30:00:2a:1e fwwn 20:50:00:05:30:00:2a:1e fwwn 20:51:00:05:30:00:2a:1e fwwn 20:52:00:05:30:00:2a:1e zone name Zone1 vsan 1 pwwn 21:00:00:20:37:6f:db:dd pwwn 21:00:00:20:37:a6:be:2f pwwn 21:00:00:20:37:9c:48:e5 fcalias Alias1 zoneset name ZoneSet1 vsan 1 zone name Zone1 vsan 1 pwwn 21:00:00:20:37:6f:db:dd pwwn 21:00:00:20:37:a6:be:2f pwwn 21:00:00:20:37:9c:48:e5 fcalias Alias1
21-248
Chapter 21
Show Commands show zoneset
The following example displays configured zone set information for a specific VSAN.
switch# show zoneset vsan 2-3 zoneset name ZoneSet2 vsan 1 zone name Zone2 vsan 1 fwwn 20:52:00:05:30:00:2a:1e fwwn 20:53:00:05:30:00:2a:1e fwwn 20:54:00:05:30:00:2a:1e fwwn 20:55:00:05:30:00:2a:1e fwwn 20:56:00:05:30:00:2a:1e zone name Zone1 vsan 1 pwwn 21:00:00:20:37:6f:db:dd pwwn 21:00:00:20:37:a6:be:2f pwwn 21:00:00:20:37:9c:48:e5 fcalias Alias1 zoneset name ZoneSet1 vsan 1 zone name Zone1 vsan 1 pwwn 21:00:00:20:37:6f:db:dd pwwn 21:00:00:20:37:a6:be:2f pwwn 21:00:00:20:37:9c:48:e5 fcalias Alias1
21-249
Chapter 21 show zoneset
Show Commands
21-250
C H A P T E R
22
T Commands
22-1
Chapter 22 tacacs+ abort
T Commands
tacacs+ abort
To discard a TACACS+ Cisco Fabric Services (CFS) distribution session in progress, use the tacacs+ abort command in configuration mode. tacacs+ abort
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to discard a TACACS+ CFS distribution session in progress.
switch# config terminal switch(config)# tacacs+ abort
Related Commands
Command show tacacs+ tacacs+ distribute tacacs+ enable
Description Displays TACACS+ CFS distribution status and other details. Enables CFS distribution for TACACS+. Enables TACACS+.
22-2
Chapter 22
T Commands tacacs+ commit
tacacs+ commit
To apply the pending configuration pertaining to the TACACS+ Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the tacacs+ commit command in configuration mode. tacacs+ commit
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to apply a TACACS+ configuration to the switches in the fabric.
switch# config terminal switch(config)# tacacs+ commit
Related Commands
Command show tacacs+ tacacs+ enable tacacs+ distribute
Description Displays TACACS+ CFS distribution status and other details. Enables TACACS+. Enables CFS distribution for TACACS+.
22-3
Chapter 22 tacacs+ distribute
T Commands
tacacs+ distribute
To enable Cisco Fabric Services (CFS) distribution for TACACS+, use the tacacs+ distribute command. To disable this feature, use the no form of the command. tacacs+ distribute no tacacs+ distribute
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
Examples
The following example shows how to enable TACACS+ fabric distribution.

switch# config terminal switch(config)# tacacs+ distribute
Related Commands
Command show tacacs+ tacacs+ commit tacacs+ enable
Description Displays TACACS+ CFS distribution status and other details. Commits TACACS+ database changes to the fabric. Enables TACACS+.
22-4
Chapter 22
T Commands tacacs+ enable
tacacs+ enable
To enable TACACS+ in a switch, use the tacacs+ enable command in configuration mode. The disable this feature, use the no form of the command. tacacs+ enable no tacacs+ enable
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Further TACACS+ commands are only available when the TACACS+ feature is enabled. Using SHA-1 as the hash algorithm may prevent RADIUS or TACACS+ usage.
Examples
switch# config terminal switch(config)# tacacs+ enable
Related Commands
Command show tacacs-server
Description Displays TACACS+ server information.
22-5
Chapter 22 tacacs-server host
T Commands
tacacs-server host
To configure TACACS+ server options on a switch, use the tacacs-server host command in configuration mode. Use the no form of the command to revert to factory defaults. tacacs-server host {server-name | ip-address} [key [0|7] shared-secret] [port port-number] [timeout seconds] no tacacs-server host {server-name | ip-address} [key [0|7] shared-secret] [port port-number] [timeout seconds]
Syntax Description
server-name ip-address key 0
Enters TACACS+ server DNS name. The maximum character size is 256. Enters TACACS+ server IP address. TACACS+ server's shared secret. Configures a preshared key specified in clear text (indicated by 0) to authenticate communication between the TACACS+ client and server. This is the default. Configures a preshared key specified in encrypted text (indicated by 7) to authenticate communication between the TACACS+ client and server. Configures a preshared key to authenticate communication between the TACACS+ client and server. TACACS+ server port for authentication. The range is 1 to 65535. TACACS+ server timeout period in seconds. Specifies the time (in seconds) between retransmissions to the TACACS+ server. The range is 1 to 60 seconds.
7 shared secret port port-number timeout seconds
Defaults
Timeout: 1 second.
Command Modes
Configuration mode.
Command History
Usage Guidelines
This command is only available when the TACACS+ feature is enabled using the tacacs+ enable command.
Examples
The following example configures TACACS+ authentication.

switch# config terminal switch(config)# tacacs-server host 10.10.2.3 key HostKey switch(config)# tacacs-server host tacacs2 key 0 abcd switch(config)# tacacs-server host tacacs3 key 7 1234
22-6
Chapter 22
T Commands tacacs-server host
Related Commands Command show tacacs-server tacacs+ enable Description Displays TACACS+ server information. Enable TACACS+.
22-7
Chapter 22 tacacs-server key
T Commands
tacacs-server key
To configure a global TACACS+ shared secret, use the tacacs-server key command. Use the no form of this command to removed a configured shared secret. tacacs-server key [0 | 7] shared-secret no tacacs-server key [0 | 7] shared-secret
Syntax Description
key 0
Global TACACS+ shared secret. Configures a preshared key specified in clear text (indicated by 0) to authenticate communication between the TACACS+ client and server. This is the default. Configures a preshared key specified in encrypted text (indicated by 7) to authenticate communication between the TACACS+ client and server. Configures a preshared key to authenticate communication between the TACACS+ client and server.
7 shared-secret
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
You need to configure the TACACS+ preshared key to authenticate the switch to the TACACS+ server. The length of the key is restricted to 65 characters and can include any printable ASCII characters (white spaces are not allowed). You can configure a global key to be used for all TACACS+ server configurations on the switch. You can override this global key assignment by explicitly using the key option in the tacacs-server host command. This command is only available when the TACACS+ feature is enabled using the tacacs+ enable command.
Examples
The following example configures TACACS+ server shared keys.

switch# config terminal switch(config)# tacacs-server key AnyWord switch(config)# tacacs-server key 0 AnyWord switch(config)# tacacs-server key 7 public
22-8
Chapter 22
T Commands tacacs-server key
Related Commands Command show tacacs-server tacacs+ enable Description Displays TACACS+ server information. Enable TACACS+.
22-9
Chapter 22 tacacs-server timeout
T Commands
tacacs-server timeout
To specify the time between retransmissions to the TACACS+ servers, use the tacacs-server timeout command. You can revert the retransmission time to its default by issuing the no form of the command. tacacs-server timeout seconds notacacs-server timeout seconds
Syntax Description
seconds
Specifies the time (in seconds) between retransmissions to the RADIUS server. The default is one (1) second and the valid range is 1 to 60 seconds.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
This command is only available when the TACACS+ feature is enabled using the tacacs+ enable command.
Examples
The following example configures the TACACS+ server timeout value.

switch# config terminal switch(config)# tacacs-server timeout 30
Related Commands
Command show tacacs-server tacacs+ enable
Description Displays TACACS+ server information. Enable TACACS+.
22-10
Chapter 22
T Commands tail
tail
To display the last lines (tail end) of a specified file, use the tail command in EXEC mode. tail filename [number-of-lines]
Syntax Description
filename number-of-lines
The name of the file for which you want to view the last lines. (Optional) The number of lines you want to view. The range is 0 to 80 lines.
Defaults
Displays the last 10 lines.
Command Modes
EXEC mode.
Command History
Usage Guidelines
You need two separate CLI terminals to use this command. In one terminal, execute the run-script or any other desired command. In the other, issue the tail command for the mylog file. On the second terminal session, you will see the last lines of the mylog file (as it grows) that is being saved in response to the command issued in the first terminal. If you specify a long file and would like to exit in the middle, enter Ctrl-c to exit this command.
Examples
The following example displays the last lines (tail end) of a specified file.
switch# run-script slot0:test mylog
In another terminal, issue the tail command for the mylog file.
switch# tail mylog config terminal
In the second CLI terminal, you see the last lines of the mylog file (as it grows) that is being saved in response to the command issued in the first terminal.
22-11
Chapter 22 tcp cwm
T Commands
tcp cwm
To configure congestion window monitoring (CWM) TCP parameters, use the tcp cwm command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp cwm [burstsize size] no tcp cwm [burstsize size]
Syntax Description
burstsize size
Specifies the burstsize ranging from 10 to 100 KB.
Defaults
Enabled. The default FCIP burst size is 10 KB. The default iSCSI burst size is 50 KB
Command Modes
FCIP profile configuration submode.
Command History
Usage Guidelines
Use these TCP parameters to control TCP retransmission behavior in a switch.
Examples
The following example configures a FCIP profile and enables congestion monitoring.
switch# config terminal switch(config)# fcip profile 5 switch(config-profile)# tcp cwm
The following example assigns the burstsize value at 20 KB:

switch(config-profile)# tcp cwm burstsize 20
The following example disables congestion monitoring.

switch(config-profile)# no tcp cwm
The following example leaves the CWM feature in an enabled state but changes the burstsize to the default of 10 KB.
switch(config-profile)# no tcp cwm burstsize 25
Related Commands
Command fcip profile show fcip profile
Description Configures FCIP profile parameters. Displays FCIP profile information.
22-12
Chapter 22
T Commands tcp keepalive-timeout
tcp keepalive-timeout
To configure the interval between which the TCP connection verifies if the FCIP link is functioning, use the tcp keepalive-timeout command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp keepalive-timeout seconds no tcp keepalive-timeout seconds
Syntax Description
seconds
Specifies the time in seconds. The range is 1 to 7200.
Defaults
60 seconds.
Command Modes
Command History
Usage Guidelines
This command can be used to detect FCIP link failures.
Examples
The following example configures a FCIP profile:

switch# config terminal switch(config)# fcip profile 5 switch(config-profile)#
The following example specifies the keepalive timeout interval for the TCP connection:
switch(config-profile)# tcp keepalive-timeout 120
Related Commands
22-13
Chapter 22 tcp maximum-bandwidth-kbps
T Commands
tcp maximum-bandwidth-kbps
To manage the TCP window size in Kbps, use the tcp maximum-bandwidth-kbps command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp max-bandwidth-kbps bandwidth min-available-bandwidth-kbps threshold {round-trip-time-ms milliseconds | round-trip-time-us microseconds} no tcp max-bandwidth-kbps bandwidth min-available-bandwidth-kbps threshold {round-trip-time-ms milliseconds | round-trip-time-us microseconds}
Syntax Description
bandwidth min-available-bandwidth-kbps threshold
Specifies the Kbps bandwidth. The range is 1000 to 1000000. Configures the minimum slow start threshold. Specifies the Kbps threshold. The range is 1000 to 1000000.
round-trip-time-ms milliseconds Configures the estimated round trip time across the IP network to reach the FCIP peer end point in milliseconds. The range is 0 to 300. round-trip-time-us microeconds Configures the estimated round trip time across the IP network to reach the FCIP peer end point in microseconds. The range is 0 to 300000.
Defaults
Enabled. The FCIP defaults are max-bandwidth = 1G, min-available-bandwidth = 500 Kbps, and round-trip-time =1 ms. The iSCSI defaults are max-bandwidth = 1G, min-available-bandwidth = 70 Kbps, and round-trip-time =1 ms.
Command Modes
Command History
Usage Guidelines
The maximum-bandwidth option and the round-trip-time option together determine the window size. The minimum-available-bandwidth option and the round-trip-time option together determine the threshold below which TCP aggressively increases its size. After it reaches the threshold the software uses standard TCP rules to reach the maximum available bandwidth.
Examples

22-14
Chapter 22
T Commands tcp maximum-bandwidth-kbps
The following example configures the maximum available bandwidth at 900 Kbps, the minimum slow start threshold as 300 Kbps, and the round trip time as 10 milliseconds:
switch(config-profile)# tcp max-bandwidth-kbps 900 min-available-bandwidth-kbps 300 round-trip-time-ms 10
The following example reverts to the factory defaults:

switch(config-profile)# no tcp max-bandwidth-kbps 900 min-available-bandwidth-kbps 300 round-trip-time-ms 10
The following example configures the maximum available bandwidth at 2000 Kbps, the minimum slow start threshold as 2000 Kbps, and the round trip time as 200 microseconds:
switch(config-profile)# tcp max-bandwidth-kbps 2000 min-available-bandwidth-kbps 2000 round-trip-time-us 200
Related Commands
22-15
Chapter 22 tcp maximum-bandwidth-mbps
T Commands
tcp maximum-bandwidth-mbps
To manage the TCP window size in Mbps, use the tcp maximum-bandwidth-mbps command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp max-bandwidth-mbps bandwidth min-available-bandwidth-mbps threshold {round-trip-time-ms milliseconds | round-trip-time-us microseconds} no tcp max-bandwidth-mbps bandwidth min-available-bandwidth-mbps threshold {round-trip-time-ms milliseconds | round-trip-time-us microseconds}
Syntax Description
bandwidth min-available-bandwidth-mbps threshold
Specifies the Mbps bandwidth. The range is 1 to 1000. Configures the minimum slow start threshold. Specifies the Mbps threshold. The range is 1 to 1000.
round-trip-time-ms milliseconds Configures the estimated round trip time across the IP network to reach the FCIP peer end point in milliseconds. The range is 0 to 300. round-trip-time-us microeconds Configures the estimated round trip time across the IP network to reach the FCIP peer end point in microseconds. The range is 0 to 300000.
Defaults
Enabled. The FCIP defaults are max-bandwidth = 1G, min-available-bandwidth = 500 Kbps, and round-trip-time =1 ms. The iSCSI defaults are max-bandwidth = 1G, min-available-bandwidth = 70 Kbps, and round-trip-time =1 ms.
Command Modes
Command History
Usage Guidelines
The maximum-bandwidth option and the round-trip-time option together determine the window size. The minimum-available-bandwidth option and the round-trip-time option together determine the threshold below which TCP aggressively increases its size. After it reaches the threshold the software uses standard TCP rules to reach the maximum available bandwidth.
Examples

22-16
Chapter 22
T Commands tcp maximum-bandwidth-mbps
The following example configures the maximum available bandwidth at 900 Mbps, the minimum slow start threshold as 300 Mbps, and the round trip time as 10 milliseconds:
switch(config-profile)# tcp max-bandwidth-mbps 900 min-available-bandwidth-mbps 300 round-trip-time-ms 10
The following example reverts to the factory defaults:

switch(config-profile)# no tcp max-bandwidth-mbps 900 min-available-bandwidth-mbps 300 round-trip-time-ms 10
The following example configures the maximum available bandwidth at 2000 Mbps, the minimum slow start threshold as 2000 Mbps, and the round trip time as 200 microseconds:
switch(config-profile)# tcp max-bandwidth-mbps 2000 min-available-bandwidth-mbps 2000 round-trip-time-us 200
Related Commands
22-17
Chapter 22 tcp max-jitter
T Commands
tcp max-jitter
To estimate the maximum delay jitter experienced by the sender in microseconds, use the tcp max-jitter command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp max-jitter microseconds no tcp max-jitter microseconds
Syntax Description
microseconds
Specifies the delay time in microseconds ranging from 0 to 10000.
Defaults
Enabled. The default value is 100 microseconds for FCIP and 500 microseconds for iSCSI interfaces.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following example configures delay jitter time:

switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# fcip profile 3 switch(config-profile)# tcp max-jitter 600 switch(config-profile)# do show fcip profile 3 FCIP Profile 3 Internet Address is 10.3.3.3 (interface GigabitEthernet2/3) Tunnels Using this Profile: fcip3 Listen Port is 3225 TCP parameters SACK is enabled PMTU discovery is enabled, reset timeout is 3600 sec Keep alive is 60 sec Minimum retransmission timeout is 200 ms Maximum number of re-transmissions is 4 Send buffer size is 0 KB Maximum allowed bandwidth is 1000000 kbps Minimum available bandwidth is 500000 kbps Estimated round trip time is 1000 usec Congestion window monitoring is enabled, burst size is 10 KB Configured maximum jitter is 600 us
22-18
Chapter 22
T Commands tcp max-jitter
Related Commands Command fcip profile show fcip profile Description Configures FCIP profile parameters. Displays FCIP profile information.
22-19
Chapter 22 tcp max-retransmissions
T Commands
tcp max-retransmissions
To specify the maximum number of times a packet is retransmitted before TCP decides to close the connection, use the tcp max-retransmissions command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp max-retransmissions number no tcp max-retransmissions number
Syntax Description
number
Specifies the maximum number. The range is 1 to 8.
Defaults
Enabled
Command Modes
Command History
Usage Guidelines
The default is 4 and the range is from 1 to 8 retransmissions.
Examples

switch# config terminal switch(config)# fcip profile 5
The following example specifies the maximum number of retransmissions :

switch(config-profile)# tcp max-retransmissions 6
Related Commands
22-20
Chapter 22
T Commands tcp min-retransmit-time
tcp min-retransmit-time
To control the minimum amount of time TCP waits before retransmitting, use the tcp min-retransmit-time command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp min-retransmit-time milliseconds no tcp min-retransmit-time milliseconds
Syntax Description
milliseconds
Specifies the time in milliseconds. The range is 200 to 5000.
Defaults
300 milliseconds.
Command Modes
Command History
Usage Guidelines
None.
Examples

The following example specifies the minimum TCP retransmit time for the TCP connection:
switch(config-profile)# tcp min-retransmit-time 500
Related Commands
22-21
Chapter 22 tcp pmtu-enable
T Commands
tcp pmtu-enable
To configure path MTU (PMTU) discovery, use the tcp pmtu-enable command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp pmtu-enable [reset-timeout seconds] no tcp pmtu-enable [reset-timeout seconds]
Syntax Description
reset-timeout seconds
Specifies the PMTU reset timeout. The range is 60 to 3600 seconds.
Defaults
Enabled. 3600 seconds.
Command Modes
Command History
Usage Guidelines
None.
Examples

The following example disables PMTU discovery:

switch(config-profile)# no tcp pmtu-enable
The following example enables PMTU discovery with a default of 3600 seconds:
switch(config-profile)# tcp pmtu-enable
The following example specifies the PMTU reset timeout to 90 seconds:

switch(config-profile)# tcp pmtu-enable reset-timeout 90
The following example leaves the PMTU in an enabled state but changes the timeout to the default of 3600 seconds:
switch(config-profile)# no tcp pmtu-enable reset-timeout 600
22-22
Chapter 22
T Commands tcp pmtu-enable
Related Commands Command fcip profile show fcip profile Description Configures FCIP profile parameters. Displays FCIP profile information.
22-23
Chapter 22 tcp qos
T Commands
tcp qos
To specify the differentiated services code point (DSCP) value to mark all IP packets (type of serviceTOS field in the IP header) on an ISCSI interface, use the tcp qos command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp qos value no tcp qos value
Syntax Description
value
Applies the control DSCP value to all outgoing frames in the control TCP connection.
Defaults
Command Modes
Command History
Usage Guidelines
Examples
The following example configures the TCP QoS value on an iSCSI interface.
switch# config terminal switch(config)# interface iscsi 1/2 switch(config-if)# tcp qos 5
Related Commands
22-24
Chapter 22
T Commands tcp qos control
tcp qos control

To specify the differentiated services code point (DSCP) value to mark all IP packets (type of serviceTOS field in the IP header), use the tcp qos control command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp qos control value data value no tcp qos control value data value
Syntax Description
value data value
Applies the control DSCP value to all FCIP frames in the control TCP connection. Applies the data DSCP value applies to all FCIP frames in the data connection.
Defaults
Enabled.
Command Modes
Command History
Usage Guidelines
Examples

The following example configures the control TCP connection and data connection to mark all packets on that DSCP value:
switch(config-profile)# tcp qos control 3 data 5
Related Commands
22-25
Chapter 22 tcp sack-enable
T Commands
tcp sack-enable
To enable selective acknowledgment (SACK) to overcome the limitations of multiple lost packets during a TCP transmission, use the tcp sack-enable command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp sack-enable no tcp sack-enable
Syntax Description
Defaults
Enabled
Command Modes
Command History
Usage Guidelines
The receiving TCP sends back SACK advertisements to the sender. The sender can then retransmit only the missing data segments.
Examples

The following example enables the SACK mechanism on the switch:

switch(config-profile)# tcp sack-enable
Related Commands
22-26
Chapter 22
T Commands tcp send-buffer-size
tcp send-buffer-size
To define the required additional bufferingbeyond the normal send window size that TCP allows before flow controlling the switchs egress path for the FCIP interface, use the tcp send-buffer-size command. Use the no form of this command to disable this feature or revert to its factory defaults. tcp send-buffer-size size no tcp send-buffer-size size
Syntax Description
size
Specifies the buffer size in KB. The range is 0 to 8192.
Defaults
Enabled. The default FCIP buffer size is 0 KB. The default iSCSI buffer size is 4096 KB
Command Modes
Command History
Usage Guidelines
None.
Examples

The following example configure the advertised buffer size to 5000 KB :

switch(config-profile)# tcp send-buffer-size 5000
Related Commands
22-27
Chapter 22 tcp-connection
T Commands
tcp-connection
To configure the number of TCP connections for the FCIP interface, use the tcp-connection command. To revert to the default, use the no form of the command. tcp-connection number no tcp-connection number
Syntax Description
number
Enters the number of attempts (1 or 2).
Defaults
Two attempts.
Command Modes
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode. Use the tcp-connection option to specify the number of TCP connections from a FCIP link. By default, the switch tries two (2) TCP connections for each FCIP link.
Examples
The following example configures the TCP connections.

switch# config terminal switch(config)# interface fcip 50 switch(config-if)# tcp-connection 1 switch(config-if)# no tcp-connection 1
Related Commands
22-28
Chapter 22
T Commands telnet
telnet
To log in to a host that supports Telnet, use the telnet command in EXEC mode. telnet {hostname | ip-address} [port]
Syntax Description
hostname ip-address port
Specifies a host name. Maximum length is 64 characters. Specifies an IP address. (Optional) Specifies a port number. The range is 0 to 2147483647.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example establishes a Telnet session to the specified IP address.

switch# telnet 172.22.91.153 Trying 172.22.91.153... Connected to 172.22.91.153. Login:xxxxxxxx Password:xxxxxxxxx switch#
Related Commands
Command telnet server enable
Description Enables the Telnet server.
22-29
Chapter 22 telnet server enable
T Commands
telnet server enable

To enable the Telnet server if you wish to return to a Telnet connection from a secure SSH connection, use the telnet server enable command. To disable the Telnet server, use the no form of this command telnet server enable no telnet server enable
Syntax Description
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example enables the Telnet server.

switch(config)# telnet server enable updated
The following example disables the Telnet server.

switch(config)# no telnet server enable updated
Related Commands
Command telnet
Description Logs in to a host that supports Telnet.
22-30
Chapter 22
T Commands terminal
terminal
To configure terminal attributes, use the terminal command in EXEC mode. To revert to the defaults, use the no form of the command. terminal {length lines | monitor | session-timeout | terminal-type type | tree-update | width integer} terminal no {length | monitor | session-timeout | terminal-type | width}
Syntax Description
length lines monitor session-timeout terminal-type type tree-update width integer
Specifies the number of lines on the screen. The range is 0 to 512. Enter 0 to scroll continuously. Copies Syslog output to the current terminal line. Specifies the session timeout value in minutes. The range is 0 to 525600. Enter 0 to disable. Sets the terminal type. Maximum length is 80 characters. Updates the main parse tree. Sets the width of the display terminal, from 0 to 80.
Defaults
The default number of lines for the length is 24. The default width is 80 lines.
Command Modes
EXEC
Command History
Usage Guidelines
Remember that all terminal parameter-setting commands are set locally and do not remain in effect after a session is ended. You must perform this task at the EXEC prompt at each session to see the debugging messages. If the length is not 24 and the width is not 80, then you need to set a length and width.
Examples
The following example displays debug command output and error messages during the current terminal session.
switch# terminal monitor Aug 8 10:32:42 sup48 % LOG_PLATFORM-5-PLATFORM_MOD_CFG_PWRDN: Module 1 powered down Aug 8 10:32:42 sup48 % LOG_PLATFORM-5-PLATFORM_MOD_PWRDN: Module 1 powered down Aug 8 10:32:42 sup48 % LOG_PLATFORM-5-PLATFORM_MOD_INSERT: Module 1 has been inserted Aug 8 10:33:12 sup48 % LOG_PLATFORM-5-PLATFORM_MOD_PWRON: Module 1 powered up Aug 8 10:33:13 sup48 % LOG_MODULE-5-MOD_REG_OK: LCM - Registration succeeded for module 1 Aug 8 10:38:15 sup48 % LOG_PLATFORM-5-PLATFORM_MOD_CFG_PWRDN: Module 1 powered down Aug 8 10:38:15 sup48 % LOG_PLATFORM-5-PLATFORM_MOD_INSERT: Module 1 has been inserted ......
22-31
Chapter 22 terminal
T Commands
The following example stops the current terminal monitoring session.
switch# terminal no monitor
Related Commands
Command show terminal
Description Displays terminal configuration information.
22-32
Chapter 22
T Commands time
time
To configure the time for the command schedule, use the time command. To disable this feature, use the no form of the command. time {daily daily-schedule | monthly monthly-schedule | start {start-time | now} | weekly weekly-schedule} no time
Syntax Description
daily daily-schedule
Configures a daily command schedule. The format is HH:MM, where HH is hours (0 to 23) and MM is minutes (0 to 59). Maximum length is 5 characters. Configures a monthly command schedule. The format is dm:HH:MM, where dow is the day of the month (1 to 31), HH is hours (0 to 23) and MM is minutes (0 to 59). Maximum length is 8 characters. Schedules a job to run at a future time. Specifies the future time to run the job. The format is yyyy:mmm:dd:HH:MM, where yyyy is the year, mmm is the month (jan to dec), dd is the day of the month (1 to 31), HH is hours (0 to 23) and MM is minutes (0 to 59). Maximum length is 18 characters. Starts the job two minutes after the command is entered. Configures a weekly command schedule. The format is dow:HH:MM, where dow is the day of the week (1 to 7, Sun to Sat), HH is hours (0 to 23) and MM is minutes (0 to 59). Maximum length is 10 characters.
monthly monthly-schedule
start start-time
now weekly weekly-schedule
Defaults
Disabled.
Command Modes
Scheduler job configuration submode.
Command History
Release 2.0(1b)
Usage Guidelines
To use this command, the command scheduler must be enabled using the scheduler enable command.
Examples
The following example shows how to configure a command schedule job to run every Friday at 2200.
switch# config terminal switch(config)# scheduler schedule name MySchedule switch(config-schedule)# time weekly 6:22:00
22-33
Chapter 22 time
T Commands
The following example starts a command schedule job in two minutes and repeats every 24 hours.
switch(config-schedule)# time start now repeat 24:00
Related Commands
Command scheduler enable scheduler schedule name show scheduler
Description Enables the command scheduler. Configures a schedule for the command scheduler. Displays schedule information.
22-34
Chapter 22
T Commands time-stamp
time-stamp
To enable FCIP time stamps on a frame, use the time-stamp command. To disable this command for the selected interface, use the no form of the command. time-stamp [acceptable-diff number] no time-stamp [acceptable-diff number]
Syntax Description
acceptable-diff number Configures the acceptable time difference for timestamps in milliseconds. The range is 500 to 10000.
Defaults
Disabled.
Command Modes
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode. The time-stamp option instructs the switch to discard frames that are older than a specified time.
Examples
The following example enables the timestamp for an FCIP interface.

switch# config terminal switch(config)# interface fcip 50 switch(config-if)# time-stamp switch(config-if)# time-stamp acceptable-diff 4000
Related Commands
Description Displays the configuration for a specified FCIP interface.
22-35
Chapter 22 tlport alpa-cache
T Commands
tlport alpa-cache
To manually configure entries in an ALPA cache, use the tlport alpa-cache command tlport alpa-cache interface interface pwwn pwwn alpa alpa no tlport alpa-cache interface interface pwwn pwwn
Syntax Description
interface interface pwwn pwwn alpa alpa
Specifies a Fibre Channel interface. Specifies the peer WWN ID for the ALPA cache entry. Specifies the ALPA cache to which this entry is to be added.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Generally, ALPA cache entries are automatically populated when an ALPA is assigned to a device. Use this command only if you wish to manually add further entries.
Examples
The following example configures the specified pWWN as a new entry in this cache
switch# config terminal switch(config)# tlport alpa-cache interface fc1/2 pwwn 22:00:00:20:37:46:09:bd alpa 0x02
Related Commands
Command show tlport
Description Displays TL port information.
22-36
Chapter 22
T Commands traceroute
traceroute
To print the route an IP packet takes to a network host, use the traceroute command in EXEC mode. traceroute {hostname | ip-address}
Syntax Description
host name ip-address
Specifies a host name. Maximum length is 64 characters. Specifies an IP address.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
This command traces the route an IP packet follows to an internet host by launching UDP probe packets with a small TTL (time to live) then listening for an ICMP (Internet Control Message Protocol) time exceeded reply from a gateway.
Note
Probes start with a TTL of one and increase by one until encountering an ICMP port unreachable. This means that the host was accessed or a maximum flag was hit. A line is printed showing the TTL, address of the gateway and round trip time of each probe. If the probe answers come from different gateways, the address of each responding system is printed.
Examples
The following example prints the route IP packets take to the network host www.cisco.com.
switch# traceroute www.cisco.com traceroute to www.cisco.com (171.71.181.19), 30 hops max, 38 byte packets 1 kingfisher1-92.cisco.com (172.22.92.2) 0.598 ms 0.470 ms 0.484 ms 2 nubulab-gw1-bldg6.cisco.com (171.71.20.130) 0.698 ms 0.452 ms 0.481 ms 3 172.24.109.185 (172.24.109.185) 0.478 ms 0.459 ms 0.484 ms 4 sjc12-lab4-gw2.cisco.com (172.24.111.213) 0.529 ms 0.577 ms 0.480 ms 5 sjc5-sbb4-gw1.cisco.com (171.71.241.174) 0.521 ms 0.495 ms 0.604 ms 6 sjc12-dc2-gw2.cisco.com (171.71.241.230) 0.521 ms 0.614 ms 0.479 ms 7 sjc12-dc2-cec-css1.cisco.com (171.71.181.5) 2.612 ms 2.093 ms 2.118 ms 8 www.cisco.com (171.71.181.19) 2.496 ms * 2.135 ms
22-37
Chapter 22 transfer-ready-size
T Commands
transfer-ready-size
To configure the target transfer ready size for SCSI write commands on a SAN tuner extension N port, use the transfer-ready-size command. transfer-ready-size bytes
Syntax Description
bytes
Specifies the transfer ready size in bytes. The range is 0 to 2147483647.
Defaults
None.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
For a SCSI write command-id command with a larger transfer size, the target performs multiple transfers based on the specified transfer size.
Examples
The following example configures the transfer ready size on a SAN extension tuner N port.
switch# san-ext-tuner switch(san-ext)# nWWN 10:00:00:00:00:00:00:00 switch(san-ext)# nport pwwn 12:00:00:00:00:00:00:56 vsan 13 interface gigabitethernet 1/2 switch(san-ext-nport)# transfer-ready-size 512000
Related Commands
Command nport pwwn san-ext-tuner show san-ext-tuner write command-id
Description Configures a SAN extension tuner N port. Enables the SAN extension tuner feature. Displays SAN extension tuner information. Configures a SCSI write command for a SAN extension tuner N port.
22-38
Chapter 22
T Commands transport email
transport email
To configure the customer ID with the Call Home function, use the transport email command in Call Home configuration submode. To disable this feature, use the no form of the command. transport email {from email-address | reply-to email-address | smtp-server ip-address [port port-number] no transport email {from email-address | reply-to email-address | smtp-server ip-address [port port-number]
Syntax Description
from email-address reply-to email-address
Specifies the from email address. For example: [email protected]. The maximum length is 255 characters. Specifies the reply-to email address. For address, example: [email protected]. The maximum length is 255 characters.
smtp-server ip-address Specifies the SMTP server address, either DNS name or IP address. The maximum length is 255 characters. port port-number (Optional) Changes depending on the server location. The port usage defaults to 25 if no port number is specified.
Defaults
None.
Command Modes
Command History
Release 1.0(2)
Usage Guidelines
None.
Examples
The following example configures the from and reply-to e-mail addresses.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# callhome switch(config-callhome)# transport email from [email protected] switch(config-callhome)# transport email reply-to [email protected]
The following example configures the SMTP server and ports.

switch(config-callhome)# transport email smtp-server 192.168.1.1 switch(config-callhome)# transport email smtp-server 192.168.1.1 port 30
22-39
Chapter 22 transport email
T Commands
Related Commands Command callhome callhome test show callhome Description Configures the Call Home function. Sends a dummy test message to the configured destination(s). Displays configured Call Home information.
22-40
Chapter 22
T Commands trunk protocol enable
trunk protocol enable

To configure the trunking protocol, use the trunk protocol enable command in configuration mode. To disable this feature, use the no form of the command. trunk protocol enable no trunk protocol enable
Syntax Description
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
If the trunking protocol is disabled on a switch, no port on that switch can apply new trunk configurations. Existing trunk configurations are not affectedthe TE port continues to function in trunking mode, but only supports traffic in VSANs that it negotiated previously (when the trunking protocol was enabled). Also, other switches that are directly connected to this switch are similarly affected on the connected interfaces. In some cases, you may need to merge traffic from different port VSANs across a non-trunking ISL. If so, you need to disable the trunking protocol.
Examples
The following example shows how to disable the trunk protocol feature.
switch# config terminal switch(config)# no trunk protocol enable
The following example shows how to enable the trunk protocol feature.
switch(config)# trunk protocol enable
Related Commands
Command show trunk protocol
Description Displays the trunk protocol status.
22-41
Chapter 22 trunk protocol enable
T Commands
22-42
C H A P T E R
23
U Commands
23-1
Chapter 23 undebug all
U Commands
undebug all
To disable all debugging, use the undebug all command. undebug all
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 1.0(2)
Usage Guidelines
Use this command to turn off all debugging.
Examples
The following example shows how to disable all debugging on the switch.
switch# undebug all
Related Commands
Command no debug all show debug
Description Also disables all debug commands configured on the switch. Displays all debug commands configured on the switch.
23-2
Chapter 23
U Commands update license
update license
To update an existing license, use the update license command in EXEC mode. update license {url | bootflash: | slot0: | volatile:} filename
Syntax Description
update license url bootflash: slot0: volatile: filename
Updates an installed, expiring license. Specifies the URL for the license file to be uninstalled. Specifies the license file location in internal bootflash memory. Specifies the license file in the CompactFlash memory or PCMCIA card. Specifies the license file in the volatile file system. Specifies the name of the license file to update.
Command Modes
EXEC mode.
Command History
Examples
The following example updates a specific license.

switch# update license bootflash:sanextn2.lic sanextn1.lic Updating sanextn1.lic: SERVER this_host ANY VENDOR cisco # An example fcports license INCREMENT SAN_EXTN_OVER_IP cisco 1.000 permanent 1 HOSTID=VDH=ABCD \ NOTICE=<LicFileID>san_extn1.lic</LicFileID><LicLineID>0</LicLineID> \ SIGN=33088E76F668 with bootflash:/sanextn2.lic: SERVER this_host ANY VENDOR cisco # An example fcports license INCREMENT SAN_EXTN_OVER_IP cisco 1.000 permanent 1 HOSTID=VDH=ABCD \ NOTICE=<LicFileID>san_extn2.lic</LicFileID><LicLineID>1</LicLineID> \ SIGN=67CB2A8CCAC2 Do you want to continue? (y/n) y Updating license ..done
23-3
Chapter 23 use-profile
U Commands
use-profile
To bind a profile to the FCIP interface, use the use-profile option. To disable a configured profile, use the no form of the option. use-profile profile-id no use-profile profile-id
Syntax Description
use-profile profile-id
Specifies the profile ID to be used. The range is 1 to 255.
Defaults
None.
Command Modes
Command History
Usage Guidelines
Access this command from the switch(config-if)# submode. This command binds the profile with the FCIP interface.
Examples
switch# config terminal switch(config)# interface fcip 50 switch(config-if)# use-profile 100 switch(config-if)# no use-profile 100
Related Commands
Command show interface fcip show fcip
Description Displays an interface configuration for a specified FCIP interface. Displays information about the FCIP profile.
23-4
Chapter 23
U Commands username
username
To define a user, use the username command in configuration mode. Use the no form of a command to undo the configuration or revert to factory defaults. username name [expire date | iscsi | password [0 | 5 | 7] user-password [expire date] [role rolename] | role rolename | sshkey {key-content | file filename}] username name [expire date | iscsi | password [0 | 5 | 7] user-password [expire date] [role rolename] | role rolename | sshkey {key-content | file filename}]
Syntax Description
name expire date iscsi password user-password 0 5 7 role rolename sshkey key_content file filename update-snmpv3
Specifies the name of the user. Maximum length is 32 characters. Specifies the date when this user account expires (in YYYY-MM-DD format). Identifies an iSCSI user. Configures a password for the user. The password is limited to 64 characters. The minimum length is 8 characters. Enters the password. Maximum length is 32 characters. Specifies a clear text password for the user. Specifies a strongly encrypted password for the user. Specifies an encrypted password for the user. Specifies the role name of the user. Maximum length is 32 characters. Configures the SSH public key. Specifies the actual contents of the SSH public key. Specifies a file containing the SSH public key. Updates the local CLI password and the SNMPv3 password. The password is limited to a minimum of 8 characters and a maximum of 64 characters.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2) 2.0(1b)

Removed the update_snmpv3 option. Added level 7 for passwords.
Usage Guidelines
To change the SNMP password, a clear text CLI password is required. You must know the SNMPv3 password to change the password using the CLI. The password specified in the username command is synchronized as the auth and priv passphrases for SNMP user.
23-5
Chapter 23 username
U Commands
Deleting a user using either command results in the user being deleted for both SNMP and CLI. User-role mapping changes are synchronized in SNMP and CLI.
Examples
The following example shows how to define a user.

switch(config)# username knuckles password testpw role bodega switch(config)# do show user-account user:admin this user account has no expiry date roles:network-admin user:knuckles this user account has no expiry date roles:bodega
The following example configures the name for a user to login using iSCSI authentication:.
switch(config)# username iscsi
The following example places you in the mode for the specified role (techdocs). The role submode prompt indicates that you are now in the role submode. This submode is now specific to the techdocs group.
switch(config)# role name techdocs switch(config-role)#
The following example deletes the role called techdocs.

switch(config)# no role name techdocs
The following example assigns a description to the new role. The description is limited to one line and can contain spaces.
switch(config-role)# description Entire Tech. Docs. group
The following example resets the description for the Tech. Docs. group.
switch(config-role)# no description
The following example creates or updates the user account (usam) along with a password (abcd) that is set to expire on 2003-05-31.
switch(config)# username usam password abcd expire 2003-05-31
The following example creates or updates the user account (msam) along with a password (abcd) specified in clear text (indicated by 0).
switch(config)# username msam password 0 abcd role network-operator
The following example specifies an encrypted (specified by 5) password (!@*asdsfsdfjh!@df) for the user account (user1).
switch(config)# username user1 password 5!@*asdsfsdfjh!@df
The following example adds the specified user (usam) to the network-admin role.
switch(config)# username usam role network-admin
The following example deletes the specified user (usam) from the vsan-admin role.
switch(config)# no username usam role vsan-admin
The following example identifies the contents of the SSH key for the specified user (usam).
23-6
Chapter 23
U Commands username
switch(config)# username usam sshkey fsafsd2344234234ffgsdfg
The following example deletes the SSH key content identification for the user (usam).
switch(config)# no username usam sshkey fsafsd2344234234ffgsdfgffsdfsfsfssf
The following example updates the SNMPv3 password for the specified user (joe). The local CLI password and the SNMP password are updated. If user Joe does not exist, the command fails.
switch(config)# username joe password wxyz6789 update-snmpv3 abcd1234
Related Commands
Command role show username
Description Configures user roles. Displays user name information.
23-7
Chapter 23 username (iSCSI initiator mode)
U Commands
username (iSCSI initiator mode)

To assigns a username for iSCSI login authentication, use the username command in iSCSI initiator configuration submode. To disable this feature, use the no form of the command. username username no username username
Syntax Description
username
Specifies the username for iSCSI login authentication.
Defaults
None.
Command Modes
Command History
Release 1.3(2)
Usage Guidelines
None.
Examples
The following example assigns the username iSCSIloginUsername for iSCSI login authentication.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# iscsi initiator name iqn.1987-02.com.cisco.initiator switch(config-iscsi-init)# username iSCSIloginUsername switch(config-iscsi-init)#
Related Commands
23-8
C H A P T E R
24
V Commands
24-1
Chapter 24 vsan (iSCSI initiator mode)
V Commands
vsan (iSCSI initiator mode)

To assign an iSCSI initiator into VSANs other than the default VSAN, use the vsan command in iSCSI initiator configuration submode. To disable this feature, use the no form of the command. vsan vsan-id no vsan vsan-id
Syntax Description
vsan-id
Specifies a VSAN ID. The range 1 to 4093.
Defaults
None.
Command Modes
Command History
Release 1.3(2)
Usage Guidelines
None.
Examples
The following example assigns an iSCSI initiator into a VSAN other than the default VSAN.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# iscsi initiator name iqn.1987-02.com.cisco.initiator switch(config-iscsi-init)# vsan 40 switch(config-iscsi-init)#
Related Commands
24-2
Chapter 24
V Commands vsan database
vsan database
To create multiple fabrics sharing the same physical infrastructure, to assign which ports are in which VSAN, whether Interop mode is on or off, and whether load balancing is per exchange or src-dest ID., use the vsan command. vsan database vsan vsan-id [interface fc slot/port | fcip fcip-id | fv slot/dpp-number/fv-port | iscsi slot/port | port-channel portchannel-number.subinterface-number} | interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id} | name name [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id} | suspend [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id}] | suspend [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id}]] vsan database no vsan vsan-id [interface {fc slot/port | fcip fcip-id | fv slot/dpp-number/fv-port | iscsi slot/port | port-channel portchannel-number.subinterface-number} | interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id} | name name [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id} | suspend [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id}] | suspend [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id}]]
Syntax Description
vsan vsan-id interface fc slot/port fcip fcip-id fv slot/dpp-number/fv-port
Specifies the VSAN ID. The range is 1 to 4093. Adds interfaces to VSAN. Specifies the Fibre Channel interface slot/port. Specifies the FCIP interface. Configures the virtual F port (FV port) interface in the specified slot along with the data path processor (DPP) number and the FV port number. Configures the iSCSI interface in the specified slot/port. Configures the PortChannel interface specified by the PortChannel number followed by a dot (.) indicator and the subinterface number. Turns on interoperability mode. Specifies the interoperability mode. The range is 1 to 3. Configures loadbalancing scheme. Sets src-id/dst-id for loadbalancing. Sets ox-id/src-id/dst-id for loadbalancing (default). Assigns a name to the VSAN. Maximum length is 32 characters. Suspends the VSAN.
iscsi slot/port port-channel portchannel-number. subinterface-number interop mode loadbalancing src-dst-id src-dst-ox-id name name suspend
24-3
Chapter 24 vsan database
V Commands
Defaults None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Change to the VSAN database submode to issue this command. The interface range must be in ascending order and non-overlapping. You can specify a range using a hyphen and several interfaces using commas:
The interface range format for a FC interface range is fcslot/port - port , fcslot/port , fcslot/port (For example, show int fc1/1 - 3 , fc1/5 , fc2/5) The interface range format for a FV interface range is fvslot/dpp/fvport - fvport , fvslot/dpp/port , fvslot/dpp/port (For example, show int fv2/1/1 - 3 , fv2/1/5 , fv2/2/5) The format for a PortChannel is port-channel portchannel-number.subinterface-number (For example, show int port-channel 5.1)
Examples
The following examples show how to create multiple fabrics sharing the same physical infrastructure and to assign which ports are in which VSAN.
switch# config terminal switch(config)# vsan database switch(config-db)# switch-config-db# vsan 2 switch(config-vsan-db)# vsan 2 name TechDoc updated vsan 2 switch(config-vsan-db)# vsan 2 loadbalancing src-dst-id switch(config-vsan-db)# vsan 2 loadbalancing src-dst-ox-id switch(config-vsan-db)# vsan 2 suspend switch(config-vsan-db)# no vsan 2 suspend switch(config-vsan-db)# vsan 2 interface fv2/8/2 switch(config-vsan-db)# vsan 2 interface iscsi 2/1 switch(config-vsan-db)# end switch#
24-4
Chapter 24
V Commands vsan policy deny
vsan policy deny

To configure a vsan-based role, use the vsan policy deny command in configuration mode. Use the no form of this command to delete a configured role. vsan policy deny permit vsan vsan-id vsan policy deny no permit vsan vsan-id no vsan policy deny
Syntax Description
permit vsan vsan-id
Remove commands from the role. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
Permit.
Command Modes
Configuration moderole name submode.
Command History
Usage Guidelines
You can configure a role so that it only allows commands to be performed for a selected set of VSANs. By default, the VSAN policy of a role is permit. In other words, the role can perform commands configured by the rule command in all VSANs. In order to selectively allow VSANs for a role, the VSAN policy needs to be set to deny and then the appropriate VSANs need to be permitted.
Examples
The following example places you in sangroup role submode.

switch# config t switch(config)# role name sangroup switch(config-role)#
The following example changes the VSAN policy of this role to deny and places you in a submode where VSANs can be selectively permitted.
switch(config)# vsan policy deny switch(config-role-vsan)
The following example deletes the configured VSAN role policy and reverts to the factory default (permit).
switch(config-role)# no vsan policy deny
The following example permits this role to perform the allowed commands for VSANs 10 through 30.
switch(config-role)# permit vsan 10-30
24-5
Chapter 24 vsan policy deny
V Commands
The following example removes the permission for this role to perform commands for vsan 15 to 20.
switch(config-role-vsan)# no permit vsan 15-20
24-6
Chapter 24
V Commands vrrp
vrrp
To enable VRRP, use the vrrp command in configuration mode. Use the no form of the command to revert to the factory defaults or to negate a command. vrrp vrrp-number address ip-address [secondary] | advertisement-interval seconds | authentication {md5 keyname spi index | text password}| preempt | priority value | shutdown | track interface {mgmt 0 | vsan vsan-id}} vrrp vrrp-number no address ip-address [secondary] | no advertisement-interval | no authentication | no preempt | no priority | no shutdown | no track} no vrrp vrrp-number
Syntax Description
address ip-address secondary advertisement-interval seconds authentication md5 keyname spi index text password preempt priority value shutdown track interface mgmt 0 vsan vsan-id
Adds or removes an IP address to the virtual router. Specifies a virtual IP address without an owner. Sets the time interval between advertisements. The range is 1 to 255. Configures the authentication method. Sets the MD5 authentication key. Maximum length is 16 characters. Sets the security parameter index. The range is 0x0 to 0xffffff. Sets an authentication password. Maximum length is 8 characters. Enables preemption of lower priority master. Configures the virtual router priority. The range is 1 to 254. Disables the VRRP configuration. Tracks the availability of another interface. Select an interface to track. Specifies the management interface. Specifies a VSAN ID. The range is 1 to 4093.
Defaults
Disabled.
Command Modes
Interface configuration mode.
24-7
Chapter 24 vrrp
V Commands
Command History This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
Enter the Virtual Router configuration submode to access the options for this command. From the VSAN or mgmt0 (management) interface configuration submode, enter vrrp number to enter the switch(config-if-vrrp)# prompt. By default, a virtual router is always disabled (shutdown). VRRP can be configured only if this state is disabled. Be sure to configure at least one IP address before attempting to enable a VR. Refer to the Cisco MDS 9000 Family Configuration Guide.
Examples
The following example enables VRRP configuration.

switch(config-if-vrrp)# no shutdown
The following example disables VRRP configuration.

switch(config-if-vrrp)# shutdown
The following example configures an IP address for the selected VRRP.

switch# config terminal switch(config)# interface vsan 1 switch(config-if)# vrrp 250 switch(config-if-vrrp)# address 10.0.0.10
24-8
C H A P T E R
25
W Commands
The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. Please see the Command Mode section to determine the appropriate mode for each command. For more information, see the Cisco MDS 9000 Family Configuration Guide.
25-1
Chapter 25 write command-id
W Commands
write command-id
To configure a SCSI write command for a SAN tuner extension N port, use the write command-id command. write command-id cmd-id target pwwn transfer-size bytes [outstanding-ios value [continuous | num-transactions number]]
Syntax Description
cmd-id target pwwn transfer-size bytes outstanding-ios value continuous
Specifies the command identifier. The range is 0 to 2147483647. Specifies the target port WWN. The format is hh:hh:hh:hh:hh:hh:hh:hh. Specifies the transfer size in multiples of 512 bytes. The range is 512 to 8388608. Specifies the number of outstanding I/Os. The range is 1 to 1024. Specifies that the command is performed continuously.
num-transactions number Specifies a number of transactions. The range is 1 to 2147483647.
Defaults
The default for outstanding I/Os is 1.
Command Modes
Command History
Release 2.0(1b)
Usage Guidelines
To stop a SCSI write command in progress, use the stop command.
Examples
The following example configures a continuous SCSI write command.

switch# san-ext-tuner switch(san-ext)# nWWN 10:00:00:00:00:00:00:00 switch(san-ext)# nport pwwn 12:00:00:00:00:00:00:56 vsan 13 interface gigabitethernet 1/2 switch(san-ext-nport)# write command-id 100 target 22:22:22:22:22:22:22:22 transfer-size 512000 outstanding-ios 2 continuous
Related Commands
Command nport pwwn san-ext-tuner show san-ext-tuner stop
Description Configures a SAN extension tuner N port. Enables the SAN extension tuner feature. Displays SAN extension tuner information. Cancels a SCSI command in progress on a SAN extension tuner N port.
25-2
Chapter 25
W Commands write-accelerator
write-accelerator
To enable write acceleration and tape acceleration for the FCIP interface, use the write-accelerator command in configuration mode. To disable this feature or revert to the default values, use the no form of the command. write-accelerator [tape-accelerator [flow-control-butter-size bytes]] no write-accelerator [tape-accelerator [flow-control-butter-size]]
Syntax Description
tape-accelerator flow-control-butter-size bytes
Enables tape acceleration. Specifies the flow control buffer size.
Defaults
Disabled. The default flow control buffer size is 256 bytes.
Command Modes
Configuration mode.
Command History
Release 1.3(1) 2.0(1b)
Modification This command was introduced. Added tape-accelerator and flow-control-butter-size options.
Usage Guidelines
The write acceleration feature is disabled by default and must be enabled on both sides of the FCIP link. If it is only enabled on one side of the FCIP tunnel, then the tunnel will not initialize.
Examples
The following command enables write acceleration on the specified FCIP interface.
switch# config terminal switch(config)# interface fcip 51 switch(config-if)# write-accelerator
The following command enables write acceleration and tape acceleration on the specified FCIP interface.
switch# config terminal switch(config)# interface fcip 51 switch(config-if)# write-accelerator tape-accelerator
The following command disables tape acceleration on the specified FCIP interface.
switch# config terminal switch(config)# interface fcip 51 switch(config-if)# no write-accelerator tape-acceleration
25-3
Chapter 25 write-accelerator
W Commands
The following command disables both write acceleration and tape acceleration on the specified FCIP interface.
switch# config terminal switch(config)# interface fcip 51 switch(config-if)# no write-accelerator
Related Commands
25-4
Chapter 25
W Commands write erase
write erase
To clear a startup configuration, enter the write erase command from the EXEC mode prompt. write erase [boot | debug]
Syntax Description
boot debug
Destroys boot configuration. Clears the existing debug configuration.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
Once this command is issued, the switchs startup configuration reverts to factory defaults. The running configuration is not affected. The write erase command erases the entire startup configuration with the exception of any configuration that affects the loader functionality. The write erase boot command only erases the configuration that affects the loader functionality. The loader functionality configuration includes the boot variables and the mgmt0 IP configuration information (IP address, netmask, and default gateway).
Examples
The following example clears the existing startup configuration completely.

switch# write erase
The following example clears the loader functionality configuration.

switch# write erase boot This command will erase the boot variables and the ip configuration of interface mgmt 0
25-5
Chapter 25 wwn secondary-mac
W Commands
wwn secondary-mac
To allocate secondary MAC addresses, use the wwn secondary-mac command. www secondary-mac wwn-id range address-range
Syntax Description
secondary-mac wwn-id The secondary MAC address with the format hh:hh:hh:hh:hh:hh. range address-range The range for the specified WWN. The only valid value is 64.
Command Modes
EXEC
Command History
Usage Guidelines
This command cannot be undone. Changes to the worldwide names are only performed as required. They should not be changed on a daily basis. These changes should be made by an administrator or individual who is completely familiar with switch operations. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.
Examples
The following example allocates a secondary range of MAC addresses.

switch(config)# wwnm secondary-mac 00:99:55:77:55:55 range 64 This command CANNOT be undone. Please enter the BASE MAC ADDRESS again: 00:99:55:77:55:55 Please enter the mac address RANGE again: 64 From now on WWN allocation would be based on new MACs. Are you sure? (yes/no) no You entered: no. Secondary MAC NOT programmed
25-6
C H A P T E R
26
Z Commands
26-1
Chapter 26 zone broadcast enable vsan
Z Commands
zone broadcast enable vsan

To enable zone broadcast frames for a VSAN in basic zoning mode, use the zone broadcast enable command in configuration mode. To disable this feature, use the no form of the command. zone broadcast enable vsan vsan-id no zone broadcast enable vsan vsan-id
Syntax Description
vsan-id
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
Broadcast frames are sent to all Nx Ports. If any NL port attached to an FL port shares a broadcast zone with the source of the broadcast frame,
then the frames are broadcast to all devices in the loop. This command only applies to basic zoning mode.
Examples
The following example shows how to enable zone configuration broadcasting over the fabric.
switch# config terminal switch(config)# zone broadcast enable vsan 10
Related Commands
Command show zone
Description Displays zone information.
26-2
Chapter 26
Z Commands zone clone
zone clone
To clone a zone name, use the zone clone command in configuration mode. zone clone origZone-Name cloneZone-Name vsan vsan-id
Syntax Description
origZone-Name cloneZone-Name vsan vsan-id
Clones a zone attribute group from the current name to a new name. Maximum length of names is 64 characters. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.1(1a)
Usage Guidelines
Use the no form of the zone name (configuration mode) command to delete the zone name.
Examples
The following example creates a clone of the original zone group named origZone into the clone zone group cloneZone on VSAN 45.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# zone clone origZone cloneZone vsan 45
Related Commands
Command show zone
26-3
Chapter 26 zone copy
Z Commands
zone copy
To copy the active zone set to the full zone set, use the zone copy command in EXEC mode. Use the no form of the command to negate the command or revert to the factory defaults. zone copy active -zoneset full-zoneset vsan vsan-id zone copy vsan vsan-id active-zoneset {bootflash: ftp: | full-zoneset | scp: | sftp: | tftp: | volatile:}
Syntax Description
active-zoneset vsan vsan-id full-zoneset bootflash: ftp: scp: sftp: slot0: tftp: volatile:
Copies from the active zone set. Configures to copy active zone set on a VSAN to full zone set.The ID of the VSAN is from 1 to 4093. Copies the active-zone set to the full-zone set. Copies the active-zone set to a location in the bootflash: directory. Copies the active-zone set to a remote location using the FTP protocol. Copies the active-zone set to a remote location using the SCP protocol. Copies the active-zone set to a remote location using the SFTP protocol. Copies the active-zone set to a location in the slot0: directory. Copies the active-zone set to a remote location using the TFTP protocol. Copies the active-zone set to a location in the volatile: directory.
Defaults
None.
Command Modes
EXEC.
Command History
Usage Guidelines
None.
Examples
The following example copies the active zone set to the full zone set.
switch# zone copy active-zoneset full-zoneset vsan 1
The following example copies the active zone set in VSAN 3 to a remote location using SCP.
switch# zone copy vsan 3 active-zoneset scp://guest@myserver/tmp/active_zoneset.txt
Related Commands
Command show zone
26-4
Chapter 26
Z Commands zone default-zone
zone default-zone
To define whether a default zone (nodes not assigned a created zone) permits or denies access to all in the default zone, use the zone default-zone command in configuration mode. Use the no form of the command to negate the command or revert to the factory defaults. zone default-zone [permit] vsan vsan-id no zone default-zone [permit] vsan vsan-id
Syntax Description
permit vsan vsan-id
Permits access to all in the default zone. Sets default zoning behavior for the specified VSAN. The ID of the VSAN is from 1 to 4093.
Defaults
All default zones are permitted access.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example permits default zoning in VSAN 2.

switch# config terminal switch(config)# zone default-zone permit vsan 2
Related Commands
Command show zone
26-5
Chapter 26 zone merge-control restrict vsan
Z Commands
zone merge-control restrict vsan

To restrict zone database merging, use the zone merge-control restrict vsan command in configuration mode. To disable this feature, use the no form of the command. zone merge-control restrict vsan vsan-id no zone merge-control restrict vsan vsan-id
Syntax Description
vsan-id
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
If merge control setting is restricted and the two databases are not identical, the ISLs between the switches are isolated.
Examples
The following example shows how to configure zone merge control.

switch# config terminal switch(config)# zone merge-control restrict vsan 10
Related Commands
Command show zone
26-6
Chapter 26
Z Commands zone mode enhanced vsan
zone mode enhanced vsan

To enable enhanced zoning for a VSAN, use the zone mode enhanced vsan command in configuration mode. To disable this feature, use the no form of the command. zone mode enhanced vsan vsan-id no zone mode enhanced vsan vsan-id
Syntax Description
vsan-id
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
Before using the zone mode enhanced vsan command, verify that all switches in the fabric are capable of working in enhanced zoning mode. If one or more switches are not capable of working in enhanced zoning mode, then the request to enable enhanced zoning mode is rejected. When the zone mode enhanced vsan command completes successfully, the software automatically starts a session, distributes the zoning database using the enhanced zoning data structures, applies the configuration changes, and sends a release change authorization (RCA) to all switches in the fabric. All switches in the fabric then enable enhanced zoning mode.
Examples
The following example shows how to enable enhanced zoning mode.

switch# config terminal switch(config)# zone mode enhanced vsan 10
Related Commands
Command show zone
26-7
Chapter 26 zone name (configuration mode)
Z Commands
zone name (configuration mode)

To create a zone, use the zone name command in configuration mode. Use the no form of the command to negate the command or revert to the factory defaults. zone name zone-name vsan vsan-id attribute {broadcast | qos priority {high | low | medium} | read-only} attribute-group group-name member {device-alias alias-name [lun lun-id] | domain-id domain-id port-number port-number | fcalias name | fcid fcid-value [lun lun-id] | fwwn fwwn-id | interface fc slot/port [domain-id domain-id | swwn swwn-id] | ip-address ip-address [subnet-mask] | pwwn pwwn-id [lun lun-id] | symbolic-nodename identifier} zone name zone-name vsan vsan-id no attribute {broadcast | qos priority {high | low | medium} | read-only} no attribute-group group-name no member {device-alias alias-name [lun lun-id] | domain-id domain-id port-number port-number | fcalias name | fcid fcid-value [lun lun-id] | fwwn fwwn-id | interface fc slot/port [domain-id domain-id | swwn swwn-id] | ip-address ip-address [subnet-mask] | pwwn pwwn-id [lun lun-id] | symbolic-nodename identifier} no zone name zone-name vsan vsan-id
Syntax Description
zone-name vsan vsan-id attribute read-only broadcast qos priority {high | low | medium} attribute-group group-name member device-alias alias-name lun lun-id domain-id domain-id port-number port-number fcalias name fcid fcid-id
Specifies the name of the zone. Maximum length is 64 characters. Specifies the VSAN ID. The range is 1 to 4093. (Optional) Sets zone attributes. Sets read-only attribute for the zone (default is read-write). Sets broadcast attribute for the zone. Sets QoS attribute for the zone (default is low). Configures an attribute group. Maximum length is 64 characters. (Optional) Adds a member to a zone. Adds a member using the device alias name. Specifies the LUN number in hexadecimal format. Adds a member using the domain ID. Adds a member using the port number of the domain ID portnumber association. Adds a member using the fcalias name. Adds a member using the FCID member in the format 0xhhhhhh.
26-8
Chapter 26
Z Commands zone name (configuration mode)
fwwn fwwn-id interface fc slot/port swwn swwn-id ip-address ip-address subnet-mask pwwn pwwn-id symbolic-nodename identifier Adds a member using the fabric port WWN in the format hh:hh:hh:hh:hh:hh:hh:hh. Adds a member using the Fibre Channel interface. Specifies the switch WWN in the format hh:hh:hh:hh:hh:hh:hh:hh. Adds a member using the IP address. Specifies an optional subnet mask. Adds a member using the port WWN in the format hh:hh:hh:hh:hh:hh:hh:hh. Adds a member using the symbolic node name in the form of a name or an IP address.
Defaults
Zone attribute is read-only.
Command Modes
Configuration mode.
Command History
Release 1.0(2) 1.2(1) 2.0(1b)
Modification This command was introduced. Added the attribute, interface, and lun subcommands.

Added the broadcast and qos priority options to the attribute subcommand. Added the attribute-group subcommand. Added the device-alias aliasname [lun lun-id] option to the member subcommand.
Usage Guidelines
Zones are assigned to zone sets, zone sets are then activated from one switch and propagate across the fabric to all switches. Zones allow security by permitting and denying access between nodes (hosts and storage). zone name commands are issued from the configuration mode. Configure a zone for a VSAN from the config-zone submode. Use the show wwn switch command to retrieve the sWWN. If you do not provide a sWWN, the software automatically uses the local sWWN.
Broadcast frames are sent to all Nx ports. If any NL port attached to an FL port shares a broadcast zone with the source of the broadcast frame,
then the frames are broadcast to all devices in the loop.
Examples
The following example configures attributes for the specified zone (Zone1) based on the member type (pWWN, fabric pWWN, FCID, or FC alias) and value specified.
switch# config terminal switch(config)# zone name Zone1 vsan 10 switch(config-zone)# attribute broadcast switch(config-zone)# attribute read-only
26-9
Chapter 26 zone name (configuration mode)
Z Commands
The following example configures members for the specified zone (Zone2) based on the member type (pWWN, fabric pWWN, FCID, or FC alias) and value specified.
switch# config terminal switch(config)# zone name Zone2 vsan 10 switch(config-zone)# attribute broadcast switch(config-zone)# attribute read-only pWWN example: switch(config-zone)# member pwwn 10:00:00:23:45:67:89:ab Fabric pWWN example: switch(config-zone)# member fwwn 10:01:10:01:10:ab:cd:ef FC ID example: switch(config-zone)# member fcid 0xce00d1 FC alias example: switch(config-zone)# member fcalias Payroll Domain ID example: switch(config-zone)# member domain-id 2 portnumber 23 FC alias example: switch(config-zone)# member ipaddress 10.15.0.0 255.255.0.0 Local sWWN interface example: switch(config-zone)# member interface fc 2/1 Remote sWWN interface example: switch(config-zone)# member interface fc2/1 swwn 20:00:00:05:30:00:4a:de Domain ID interface example: switch(config-zone)# member interface fc2/1 domain-id 25
Related Commands
Command show zone zone rename zone-attribute-group name
Description Displays zone information. Renames zones. Configures zone attribute groups.
26-10
Chapter 26
Z Commands zone name (zone set configuration submode)
zone name (zone set configuration submode)

To configure a zone in a zone set, use the zone name command in zone set configuration submode. To delete the zone from the zone set, use the no form of the command. zone name zone-name no zone name zone-name
Syntax Description
zone-name
Specifies the name of the zone. Maximum length is 64 characters.
Defaults
None.
Command Modes
Zone set configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example configure a zone in a zone set.

switch# config terminal switch(config)# zoneset name Sample vsan 1 switch(config-zoneset)# zone name MyZone
The following example deletes a zone from a zone set.

switch(config-zoneset)# no zone name Zone2
Related Commands
Command show zoneset zone name (configuration mode) zoneset
Description Displays zone set information. Configure zones. Configures zone set attributes.
26-11
Chapter 26 zone rename
Z Commands
zone rename
To rename a zone, use the zone rename command in configuration mode. zone rename current-name new-name vsan vsan-id
Syntax Description
Specifies the current fcalias name. Maximum length is 64 characters. Specifies the new fcalias name. Maximum length is 64 characters. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
EXEC mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to rename a zone.

switch# zone rename ZoneA ZoneB vsan 10
Related Commands
Command show zone zone name
Description Displays zone information. Creates and configures zones.
26-12
Chapter 26
Z Commands zone-attribute-group clone
zone-attribute-group clone
To clone a zone attribute group, use the zone-attribute-group clone command in configuration mode. zone attribute clone origAttGrp-Name cloneAttGrp-Name vsan vsan-id
Syntax Description
origAttGrp-Name cloneAttGrp-Name vsan vsan-id
Clones a zone attribute group from the current name to a new name. Maximum length of names is 64 characters. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.1(1a)
Usage Guidelines
To remove the zone attribute group, use the no form of the zone-attribute-group name command.
Examples
The following example shows how to clone a zone attribute group with the original name origZoneAttGrp to a copy named cloneZoneAttGrp on VSAN 45.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# zone-attribute-group clone origZoneAttGrp cloneZoneAttGrp vsan 45
Related Commands
Command show zone-attribute-group
Description Displays zone attribute group information.
26-13
Chapter 26 zone-attribute-group name
Z Commands
zone-attribute-group name
To create and configure a zone attribute group for enhanced zoning, use the zone-attribute-group name command in configuration mode. To remove the zone attribute group, use the no form of the command. zone attribute group name zone-name vsan vsan-id no zone attribute group name zone-name vsan vsan-id
Syntax Description
zone-name vsan vsan-id
Specifies the zone attribute name. Maximum length is 64 characters. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
You can use this command to create a zone attribute group and to modify an existing zone attribute group. Zone attribute groups are only supported for enhanced zoning. You can enable enhanced zoning using the zone mode enhanced vsan command.
Examples
The following example shows how to create a zone attribute group and enter attribute group configuration submode.
switch# config terminal switch(config)# zone-attribute-group name admin-attributes vsan 10 switch(config-attribute-group)#
Related Commands
Command show zone-attribute-group zone mode enhanced vsan
Description Displays zone attribute group information. Enables enhanced zoning for a VSAN.
26-14
Chapter 26
Z Commands zone-attribute-group rename
zone-attribute-group rename
To rename a zone attribute group, use the zone-attribute-group rename command in configuration mode. zone attribute group rename current-name new-name vsan vsan-id
Syntax Description
Specifies the current zone attribute name. Maximum length is 64 characters. Specifies the new zone attribute name. Maximum length is 64 characters. Specifies the VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 2.0(1b)
Usage Guidelines
None.
Examples
The following example shows how to rename a zone attribute group.

switch# config terminal switch(config)# zone-attribute-group rename Group1 Group2 vsan 10
Related Commands
Command
Description
show zone-attribute-group Displays zone attribute group information.
26-15
Chapter 26 zoneset (configuration mode)
Z Commands
zoneset (configuration mode)

To group zones under one zone set, use the zoneset command in configuration mode. To negate the command or revert to the factory defaults, use the no form of the command. zoneset {activate name zoneset-name vsan vsan-id | clone zoneset-currentName zoneset-cloneName | distribute full vsan vsan-id | name zoneset-name vsan vsan-id | rename current-name new-name vsan vsan-id} no zoneset {activate name zoneset-name vsan vsan-id | clone zoneset-currentName zoneset-cloneName | distribute full vsan vsan-id | name zoneset-name vsan vsan-id | rename current-name new-name vsan vsan-id}
Syntax Description
activate clone zoneset-currentName zoneset-cloneName name zoneset-name distribute full vsan vsan-id rename current-name new-name
Activates a zone set Clones a zone set from the current name to a new name. Maximum length of names is 64 characters. Specifies a name for a zone set. Maximum length is 64 characters. Enables zone set propagation. Activates a zone set on the specified VSAN. The range is 1 to 4093. Renames a zone set. Specifies the current fcalias name. Specifies the new fcalias name.
Defaults
None.
Command Modes
Configuration mode.
Command History
Release 1.0(2) 2.0(1b) 2.1(1a)
Modification This command was introduced. Added the rename option. Added the clone option.
Usage Guidelines
Zones are activated by activating the parent zone set.
26-16
Chapter 26
Z Commands zoneset (configuration mode)
Examples The following example activates a zone set named gottons in VSAN 333.
switch# config terminal switch(config)# zoneset activate name gottons vsan 333 Zoneset Activation initiated. check zone status
The following example clones a zone set named zSet1 into a new zoneset named zSetClone in VSAN 45.
switch(config)# zoneset clone existing zSet1 zSetClone vsan 45
Related Commands
Command show zoneset
Description Displays zone set information.
26-17
Chapter 26 zoneset (EXEC mode)
Z Commands
zoneset (EXEC mode)

To merge zone set databases, use the zoneset command in EXEC mode. zoneset {distribute | export | import interface {fc slot-number | fcip interface-number | port-channel port-number}} vsan vsan-id
Syntax Description
distribute export
Distributes the full zone set in the fabric. Exports the zone set database to the adjacent switch on the specified interface. The active zone set in this switch becomes the activated zone set of the merged SAN. Imports the zone set database to the adjacent switch on the specified interface. The active zone set in the adjacent switch becomes the activated zone set of the merged SAN. Configures the interface. Configures a Fibre Channel interface for the specified slot number and port number. Selects the FCIP interface to configure the specified interface from 1 to 255. Merges the zone set database of a VSAN on the specified interface. The ID of the VSAN is from 1 to 4093.
import
interface fc slot-number fcip interface-number
port-channel port-number Specifies PortChannel interface. vsan vsan-id
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
You can also issue the zoneset import and the zoneset export commands for a range of VSANs. The zoneset distribute vsan vsan-id command is supported in interop 2 and interop 3 modesnot in interop 1 mode.
Examples
The following example imports the zone set database from the adjacent switch connected through the VSAN 2 interface.
switch# zoneset import interface fc1/3 vsan 2
The following example exports the zone set database to the adjacent switch connected through VSAN 5.
switch# zoneset export vsan 5
26-18
Chapter 26
Z Commands zoneset (EXEC mode)
The following example distributes the zone set in VSAN 333.
switch# zoneset distribute vsan 333 Zoneset distribution initiated. check zone status
Related Commands
Command show zone status vsan show zoneset
Description Displays the distribution status for the specified VSAN. Displays zone set information.
26-19
Chapter 26 zoneset (EXEC mode)
Z Commands
26-20
C H A P T E R
27
Advanced Services Module Commands

The commands in this chapter are specific to the Advanced Services Module (ASM) used in the Cisco MDS 9216 Switch and the Cisco MDS 9500 Series. All commands are shown here in alphabetical order regardless of command mode. See the About the CLI Command Modes section on page 1-3 to determine the appropriate mode for each command. For more information on virtualization using the ASM, see the Related Documentation section on page xxix.
27-1
Chapter 27 attach moduleshow fcdd
attach moduleshow fcdd

To display the Fibre Channel Device Discovery (FCDD) information, use the show fcdd command. To connect to a ASM, use the attach module command in EXEC mode. To disconnect, use the exit command at the module-number# prompt. attach module slot-number show fcdd option
Syntax Description
attach module slot-number show fcdd option
Attaches to the ASM module. Displays FCDD information. eventlogDisplays information of various state machines historyDisplays FCDD history buffer nvpDisplays FCDD for the virtual Nx port (NVP) pidDisplays Path Ids rescanDisplays FCDD disk rescan information targetDisplays Disk/VM VSAN FC targets
Command Modes
EXEC (attach module mode).
Command History
Usage Guidelines
Access the ASM using the attach module command to obtain VEC-specific configuration information You cannot configure the ASM using this command. After you connect to the image on the module using the attach module command, the prompt changes to module-number#.
Examples
The following example attaches to the ASM in slot 2 and exits from the ASM debug mode.
switch# attach module 2 Attaching to module 1 ... To exit type 'exit', to abort type '$.' module-2#
The following example displays target FCDD information for the ASM in slot 2.
module-2# show fcdd history 1) Event:E_DEBUG, length:67, at 617784 usecs after Thu Sep 18 17:55:04 2003 [103] fcdd_demux(*event=0x7ffffb90,**ret_fsm_event_list=0x7ffff920) 2) Event:E_DEBUG, length:48, at 617759 usecs after Thu Sep 18 17:55:04 2003 [103] fcdd_mts_dequeue_event(*ret_ev=0x7ffffb90) 3) Event:E_DEBUG, length:71, at 617751 usecs after Thu Sep 18 17:55:04 2003 [103] fcdd_get_data_from_queue(*q_entry=0x2d8ea000, *ret_ev=0x7ffffb90) 4) Event:E_DEBUG, length:52, at 617739 usecs after Thu Sep 18 17:55:04 2003 [103] fcdd_dequeue_event: Data Rcvd, Total ticks - 0 5) Event:E_DEBUG, length:20, at 511016 usecs after Thu Sep 18 17:54:57 2003 [103] ...
27-2
Chapter 27
Advanced Services Module Commands attach moduleshow fcdd
module-2# show fcdd nvp vsan 3 FCDD NVP INFO: VSAN pWWN FCID LPI DPP SI IF_INDEX NUM_ZONE -------------------------------------------------------------------------------3 24:0a:00:05:30:00:94:a00x650009 1 1 0x0031 0x01091000 0 ZONE_CNT ZONE_NAME ----------------------module-2# show fcdd pid CNT PID MINOR VSAN TGT_WWN LUN_ID STATE ------------------------------------------------------------------------------0 0x0011 272 3 21:00:00:20:37:46:78:97 00:00:00:00:00:00:00:00 INV_PD 1 0x0012 288 3 21:00:00:20:37:5b:cf:b9 00:00:00:00:00:00:00:00 INV_PD 2 0x0013 304 3 21:00:00:20:37:18:6f:90 00:00:00:00:00:00:00:00 INV_PD 3 0x0014 320 3 21:00:00:20:37:36:0b:4d 00:00:00:00:00:00:00:00 INV_PD 4 0x0015 336 3 21:00:00:20:37:39:90:6a 00:00:00:00:00:00:00:00 INV_PD 5 0x0016 352 3 21:00:00:20:37:18:d2:45 00:00:00:00:00:00:00:00 INV_PD 6 0x0017 368 3 21:00:00:20:37:38:a7:c1 00:00:00:00:00:00:00:00 INV_PD 7 0x0018 384 3 21:00:00:20:37:18:17:d2 00:00:00:00:00:00:00:00 INV_PD 8 0x0019 400 4 22:00:00:20:37:46:78:97 00:00:00:00:00:00:00:00 ACTIV 9 0x001a 416 4 22:00:00:20:37:5b:cf:b9 00:00:00:00:00:00:00:00 ACTIV 10 0x001b 432 4 22:00:00:20:37:18:6f:90 00:00:00:00:00:00:00:00 ACTIV module-2# show fcdd target vsan 3 ======================================= All existing disks in VSAN 3: ======================================= TGT_CNT pWWN FCID SCSI_ID NUM_ZONE REDISC_TMR PERIOD(S) LAST_ACCESS ========================================================================================== 0 21:00:00:20:37:18:17:d2 0x7200c9 7 0 YES 600 Thu Sep 18 18:00:32 2003 LUN_NUM LUN_ID MINOR PID TGT_WWN STATE PERIOD(S) TIMER_STARTED -----------------------------------------------------------------------------------------0 00:00:00:00:00:00:00:00 384 0x0018 21:00:00:20:37:18:17:d2 ACTIVE 0 TGT_CNT pWWN FCID SCSI_ID NUM_ZONE REDISC_TMR PERIOD(S) LAST_ACCESS ========================================================================================== 1 21:00:00:20:37:18:d2:45 0x7200c5 5 0 YES 600 Thu Sep 18 18:00:32 2003 LUN_NUM LUN_ID MINOR PID TGT_WWN STATE PERIOD(S) TIMER_STARTED -----------------------------------------------------------------------------------------0 00:00:00:00:00:00:00:00 352 0x0016 21:00:00:20:37:18:d2:45 ACTIVE 0 TGT_CNT pWWN FCID SCSI_ID NUM_ZONE REDISC_TMR PERIOD(S) LAST_ACCESS ========================================================================================== 2 21:00:00:20:37:5b:cf:b9 0x7200b6 1 0 YES 600 Thu Sep 18 18:00:32 2003 ...
27-3
Chapter 27 attach moduleshow npc
attach moduleshow npc

To display the virtual N port creator (NPC) information, use the show npc command. To connect to a ASM, use the attach module command in EXEC mode. To disconnect, use the exit command at the module-number# prompt. attach module slot-number show npc option
Syntax Description
attach module slot-number show npc option
Attaches to the ASM module. Displays NPC information. history Displays NPC history buffer nvp Displays NPC information for the virtual N port
Command Modes
Command History
Usage Guidelines
Examples
The following example displays target FCDD information for the ASM in slot 2.
module-2# show npc history module-2# show npc history 1) Event:E_DEBUG, length:66, at 123862 usecs after Thu Sep 18 18:24:50 2003 [103] npc_demux(*event=0x7ffffb60,**ret_fsm_event_list=0x7ffff8f0) 2) Event:E_DEBUG, length:71, at 123849 usecs after Thu Sep 18 18:24:50 2003 [105] 0x000000D0: 00 00 00 00 ... 3) Event:E_DEBUG, length:82, at 123818 usecs after Thu Sep 18 18:24:50 2003 [105] 0x000000C0: 00 00 00 0C 00 00 00 00 00 00 00 00 00 00 00 00 ... 4) Event:E_DEBUG, length:82, at 123766 usecs after Thu Sep 18 18:24:50 2003 [105] 0x000000B0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ... 5) Event:E_DEBUG, length:82, at 123714 usecs after Thu Sep 18 18:24:50 2003 [105] 0x000000A0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ... module-2# show npc nvp COUNT VSAN pWWN FCID LPI DPP SI IF_INDEX TCAM_TYPE STATE U_CNT USERS -------------------------------------------------------------------------------
27-4
Chapter 27
Advanced Services Module Commands attach moduleshow npc
----------------------0 2 10:00:00:00:5e:00:01:01 ESTABLISHED 1 [ 31 ] 1 2 10:00:00:05:30:00:59:20 ESTABLISHED 1 [ 31 ] 2 2 23:00:00:05:30:00:59:20 ESTABLISHED 1 [ 918 ] 3 2 23:02:00:05:30:00:59:20 ESTABLISHED 1 [ 918 ] 4 2 23:03:00:05:30:00:59:20 ESTABLISHED 1 [ 918 ] 5 2 23:04:00:05:30:00:59:20 ESTABLISHED 1 [ 918 ] 6 2 23:05:00:05:30:00:59:20 ESTABLISHED 1 [ 918 ] 7 2 23:06:00:05:30:00:59:20 ESTABLISHED 1 [ 918 ] 8 2 23:07:00:05:30:00:59:20 ESTABLISHED 1 [ 918 ] ... 0x6f0000 0x6f0002 0x6f000b 0x6f0003 0x6f0004 0x6f0005 0x6f0006 0x6f0007 0x6f0008 17 17 19 18 1 5 21 25 9 1 0x0030 0x01090000 0x0205 1 0x0030 0x01090000 0x0205 1 0x0032 0x01092000 0x0206 1 0x0031 0x01091000 0x0206 2 0x0020 0x01080000 0x0206 3 0x0024 0x01084000 0x0206 4 0x0034 0x01094000 0x0206 5 0x0038 0x01098000 0x0206 6 0x0028 0x01088000 0x0206
module-2# show npc nvp fsm 23:08:00:05:30:00:59:20 vsan 2 >>>>FSM: <NVP_23:08:00:05:30:00:59:20> has 7 logged transitions<<<<< 1) FSM:<NVP_23:08:00:05:30:00:59:20> Transition at 839998 usecs after Thu Sep 18 17:57:23 2003 Previous state: [NPC_NVP_NULL] Triggered event: [NPC_NVP_EV_NP_CREATION_REQ] Next state: [NPC_NVP_GET_IFINDEX] 2) FSM:<NVP_23:08:00:05:30:00:59:20> Transition at 840179 usecs after Thu Sep 18 17:57:23 2003 Previous state: [NPC_NVP_GET_IFINDEX] Triggered event: [NPC_NVP_EV_IF_INDEX_OK] Next state: [NPC_NVP_FVLOGI_SENT] ... module-2# show npc nvp vsan 2 COUNT VSAN pWWN FCID LPI DPP SI IF_INDEX TCAM_TYPE STATE U_CNT USERS -----------------------------------------------------------------------------------------------------0 2 10:00:00:00:5e:00:01:01 0x6f0000 17 1 0x0030 0x01090000 0x0205 ESTABLISHED 1 [ 31 ] 1 2 10:00:00:05:30:00:59:20 0x6f0002 17 1 0x0030 0x01090000 0x0205 ESTABLISHED 1 [ 31 ] 2 2 23:00:00:05:30:00:59:20 0x6f000b 19 1 0x0032 0x01092000 0x0206 ESTABLISHED 1 [ 918 ] 3 2 23:02:00:05:30:00:59:20 0x6f0003 18 1 0x0031 0x01091000 0x0206 ESTABLISHED 1 [ 918 ] 4 2 23:03:00:05:30:00:59:20 0x6f0004 1 2 0x0020 0x01080000 0x0206 ESTABLISHED 1 [ 918 ] ...
27-5
Chapter 27 attach moduleshow vec
attach moduleshow vec

To display Virtual Enclosure Client (VEC) information, use the show vec command. To connect to a ASM, use the attach module command in EXEC mode. To disconnect, use the exit command at the module-number# prompt. attach module slot-number show vec option
Syntax Description
attach module slot-number show vec option
Attaches to the ASM module. Displays configured VEC information. asm Displays VEC-related ASM information dip Displays Distributed Instantiation Protocol (DIP) information dpp Displays Data Path Processors (DPPs) State dpp-hostmap Displays DPP host maps dpp-lunmap Displays DPP LUN maps error-statistics Displays VEC error statistics fp-port Displays Front panel ports in the ASM history Displays VEC internal history buffer host Displays Logged in hosts initiator-nports Displays Disk/VM VSAN initiator N ports login Displays Disk/VM VSAN process logins pid Displays Path Ids scsi-init Displays SCSI initiator information scsi-tgt Displays SCSI target information target Displays Disk/VM VSAN FC targets tp Displays Trap Port (TP) vep Displays Virtual Enclosure Port (VEP) ves Displays Virtual Enclosure Server(s) (VES) connected to the VEC vlun Displays VLUNs vlun-statistic Displays Vlun error statistics vmvsan-login Displays DIOP logins volume-owners Displays Volume Owners vsans Displays VSANs seen by the VEC xp-login Displays logins (PLOGI/PRLI) to VEPs/TPs (xPs)
Command Modes
Command History
Usage Guidelines
27-6
Chapter 27
Advanced Services Module Commands attach moduleshow vec
Examples The following example attaches to the ASM in slot 2 and exits from the ASM debug mode.
The following example displays target VEC information for the ASM in slot 2.
module-2# show vec target vsan I dpp here there pwwn 3 A 0 72000a 720101 21:00:00:20:37:65:1c:cb 3 A 0 72000a 7201e8 21:00:00:20:37:65:1c:e3 4 A 0 6b0009 7800ba 22:00:00:20:37:18:6f:90 3 A 0 72000a 7202ba 21:00:00:20:37:18:6f:90 4 A 0 6b0009 7800c9 22:00:00:20:37:18:17:d2 3 A 0 72000a 7202c9 21:00:00:20:37:18:17:d2 2 A 2 6f0005 6f0005 23:04:00:05:30:00:59:20 2 A 5 6f0008 6f0005 23:04:00:05:30:00:59:20 3 A 0 72000a 7201ef 21:00:00:20:37:89:ac:7f 4 A 0 6b0009 780100 50:06:04:82:bf:d0:cf:4b 4 A 0 6b0009 7800bc 22:00:00:20:37:36:0b:4d ... target state 83995a8 PRLI_COMPLETE 839a188 PRLI_COMPLETE 83a7ce8 PRLI_COMPLETE 83a5540 PRLI_COMPLETE 83aebd0 PRLI_COMPLETE 83ad410 PRLI_COMPLETE 837de70 PRLI_COMPLETE 83866f8 PRLI_COMPLETE 839ad68 PRLI_COMPLETE 839c998 PRLI_COMPLETE 83a94a8 PRLI_COMPLETE
27-7
Chapter 27 attach moduleshow ves
attach moduleshow ves

To display Virtual Enclosure Server (VES) information, use the show ves command. To connect to a ASM, use the attach module command in EXEC mode. To disconnect, use the exit command at the module-number# prompt, or type $. to forcibly abort the attached session. attach module slot-number show ves option
Syntax Description
attach module slot-number Attaches to the ASM module. show ves option Displays configured VES information for the ASM. dg Displays VES-related Disk Group information diopDisplays Data-path Input Output Protocol (DIOP) information dip Displays Distributed Instantiation Protocol (DIP) history Displays VES internal history buffer lunmap Displays VES lunmap information pid Displays Path Id (PID) information pid-evlog Displays PID event log information pid_vlun_sg Displays PID/VLUN SG Table Information scsi-tgt Displays SCSI Target Module sg Displays Service Group ve Displays Virtual Enclosure (VE) vec Displays Virtual Enclosure Clients (VECs) connected to the VES vep Displays Virtual Enclosure Port (VEP) vlun Displays VLUN Table Information vlun-counters Displays VLUN counters vlun-evlog Displays VLUN event log vsans Displays VSANs seen by the VES
Command Modes
Command History
Usage Guidelines
Access the ASM using the attach module command to obtain VEC -specific configuration information You cannot configure the ASM using this command. After you connect to the image on the module using the attach module command, the prompt changes to module-number#.
Examples
27-8
Chapter 27
Advanced Services Module Commands attach moduleshow ves
The following example displays the virtual enclosure servers service group information for the ASM in slot 2.
module-2# show ves sg Virtual Enclosure Server Service Group Info ---------------------------------------------------------------------No VR-ID IP Address ---------------------------------------------------------------------0 0 15.0.112.2 1 1 15.0.0.10 2 2 15.0.0.11 Number of Service Groups : 3...
The following examples display DIOP information for the ASM in slot 2.
module-2# show ves diop guid VLUN-ID GUID 0000000000000001 c3ef7ce8-1dd1-11b2-a8de-75d21f738aa7 module-2# show ves diop stats DIOP COUNTER : Success Failed VLUN STRATEGY : 0x00000000 0x00000000 VLUN DONE : 0x00000000 0x00000000 DISK REMOTE STRATEGY : 0x00000000 0x00000000 DISK REMOTE DONE : 0x00000000 0x00000000 DISK LOCAL STRATEGY : 0x00000000 0x00000000 DISK LOCAL DONE : 0x00000000 0x00000000 module-2# show ves diop vsvo vsan : 2 fcid : 0x6F000B dpp : 0 module-2# show ves diop xp Hash VSAN FCID pWWN RefCnt 2 2 6F000B 2300000530005920 1 3 2 6F0007 2306000530005920 1 7 2 6F0008 2307000530005920 1 10 2 6F0003 2302000530005920 1 11 2 6F0009 2308000530005920 1 14 2 6F0004 2303000530005920 1 15 2 6F000A 2309000530005920 1 18 2 6F0005 2304000530005920 1 22 2 6F0006 2305000530005920 1
27-9
Chapter 27 attach moduleshow version
attach moduleshow version

To display version information for the ASM module, use the show version command. To connect to a ASM, use the attach module command in EXEC mode. To disconnect, use the exit command at the module-number# prompt, or type $. to forcibly abort the attached session. attach module slot-number show version
Syntax Description
This command does not have any options.
Command Modes
Command History
Usage Guidelines
Access the ASM using the attach module command to obtain VSHA-specific configuration information You cannot configure the ASM using this command. After you connect to the image on the module using the attach module command, the prompt changes to module-number#. Use the show version command to verify the integrity of the image before loading the images. This command can be used for ASM images.
Examples
The following example displays the ASM version in slot 2.

module-2# show version Software BIOS: system:
version 1.0.7 version 1.2(2)
BIOS compile time: system compile Time:
03/20/03 7/11/2003 14:00:00
Hardware RAM 963380 kB bootflash: 500736 blocks (block size 512b) 00:05:30:00:AC:AA uptime is 0 days 21 hours 2 minute(s) 32 second(s)
27-10
Chapter 27
Advanced Services Module Commands attach moduleshow virt-lookup
attach moduleshow virt-lookup

To display virtualization lookup tables, use the show virt-lookup command. To connect to a ASM, use the attach module command in EXEC mode. To disconnect, use the exit command at the module-number# prompt, or type $. to forcibly abort the attached session. attach module slot-number show virt-lookup number [d_id | vol-cfg] [entries | masks | keys | stats]
Syntax Description
attach module slot-number Attaches to the ASM module. show virt-lookup number d_id vol-cfg entries keys masks stats Displays virtualization lookup tables. Specifies one of four table instances of the virtualization engine (ranges from 1 to 4). Displays DID lookup information. Displays volume lookup information. Displays lookup entries. Displays lookup keys. Displays lookup masks. Displays lookup statistics.
Command Modes
Command History
Usage Guidelines
Access the ASM using the attach module command to obtain VSHA-specific configuration information You cannot configure the ASM using this command. After you connect to the image on the module using the attach module command, the prompt changes to module-number#.
Examples
The following example displays virtual engine 1 details for DID entries.
module-2# INDEX 00000000 00000001 00000400 00000401 00000402 show virt-lookup 1 d-id entries V CL EG_IDX RSVD SW_INDEX MASK 1 2 0 000 00000000 0204 1 2 1 000 00000000 0204 1 2 0 000 FFFFFFFF 0205 1 2 0 000 FFFFFFFF 0207 1 2 0 000 FFFFFFFF 0206
27-11
Chapter 27 attach moduleshow virt-lookup
00000403 00000404 00000405 00000406 00000407 00000408 00000409 0000040A 1 1 1 1 1 1 1 1 2 2 2 2 2 2 2 2 1 0 0 1 0 0 1 0 000 000 000 000 000 000 000 000 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF 0206 0206 0206 0206 0206 0206 0206 0206
The following example displays volume lookup mask entries for virtualization engine 2.
module-2# show virt-lookup 2 vol-cfg masks BLKINDEX FL V CL RESERVED RESERVED D_ID 1 3 00000000 00000000 FFFFFF 00001C00 3F S_ID 000000 B1 00 B0 00 IN 1 PI 3 VSAN FFF
The following example displays statistics for volume lookup tables.

module-2# show virt-lookup 3 vol-cfg stats TOTAL USED USED-DPP0 USED-DPP1 8192 6 3 3
27-12
Chapter 27
Advanced Services Module Commands attach moduleshow vsha
attach moduleshow vsha

To display volume server high availability (VSHA) information, use the show vsha command. To connect to a ASM, use the attach module command in EXEC mode. To disconnect, use the exit command at the module-number# prompt, or type $. to forcibly abort the attached session. attach module slot-number show vsha option
Syntax Description
attach module slot-number Attaches to the ASM module. show vsha option Displays configured VSHA information. dg-info Displays VSHA SG-Disk_group information sg-info Displays VSHA SG Information sg-log Displays VSHA SG Event Log
Command Modes
Command History
Usage Guidelines
Access the ASM using the attach module command to obtain VSHA-specific configuration information You cannot configure the ASM using this command. After you connect to the image on the module using the attach module command, the prompt changes to module-number#.
Examples
The following example displays VSHA service group information for the ASM in slot 2.
module-2# show vsha sg-info ---------------------------------------------------------------------VSHA SG Table ---------------------------------------------------------------------System Variables: VmVsan=2, Real_IP=15.0.112.2 , interface_index=0x8080002 ---------------------------------------------------------------------Record:0 VR_ID:1 SG_Name:sg-1 VR_IP:15.0.0.10 Node_ID:1 Record:1 VR_ID:2 SG_Name:sg-2 VR_IP:15.0.0.11 Node_ID:2 ---------------------------------------------------------------------module-4# show vsha sg-info vr_id 1 ---------------------------------------------------------------------VSHA SG Table ---------------------------------------------------------------------System Variables: VmVsan=2, Real_IP=18.0.0.4 , interface_index=0x8180002 Record: 0 VR_ID: 1
27-13
Chapter 27 attach moduleshow vsha
SG_Name: sg1 VR_IP: 18.0.0.24 Node_ID:1 State: VSHA_STANDALONE_MASTER Arbitration_disk: 22000020374BB5990003.0000 Peer_IP: INVALID Flags:0x0 ---------------------------------------------------------------------module-4# show vsha dg-info vr_id 1 ---------------------------------------------------------------------VSHA-DG info for vr_id 1 ---------------------------------------------------------------------Record:0 DG_Name:rahul_dg1 DG_state:DISK_GROUP_O NLINE ---------------------------------------------------------------------module-4# show vsha sg-log vr_id 1 >>>>FSM: <VSHA_SG_1> has 35 logged transitions<<<<< 1) FSM:<VSHA_SG_1> Transition at 596109 usecs after Mon Apr Previous state: [VSHA_NULL] Triggered event: [VSHA_EV_ARBITRATION_DISK_CHG] Next state: [VSHA_NULL] 2) FSM:<VSHA_SG_1> Transition at 163199 usecs after Mon Apr Previous state: [VSHA_NULL] Triggered event: [VSHA_EV_ONLINE_SERVICE_GRP_AS_MASTER] Next state: [VSHA_STANDALONE_MASTER] 3) FSM:<VSHA_SG_1> Transition at 198675 usecs after Mon Apr Previous state: [VSHA_STANDALONE_MASTER] Triggered event: [VSHA_EV_VX_DG_IMPORT_RESP] Next state: [VSHA_STANDALONE_MASTER] 4) FSM:<VSHA_SG_1> Transition at 201051 usecs after Mon Apr Previous state: [VSHA_STANDALONE_MASTER] Triggered event: [VSHA_EV_RESOURCE_MONITOR] Next state: [VSHA_STANDALONE_MASTER] 7 22:50:47 1980
7 22:51:13 1980
7 22:51:13 1980
7 22:51:23 1980
27-14
Chapter 27
Advanced Services Module Commands attach moduleterminal
attach moduleterminal
To configure the terminal for the ASM, use the terminal command in attach module mode. Use the no form of the command to negate a previously-issued command or revert to factory defaults. To connect to a ASM, use the attach module command in EXEC mode. To disconnect, use the exit command at the module-number# prompt, or type $. to forcibly abort the attach session. attach module slot-number terminal length number-of-lines | session-timeout | terminal type | width integer]
Syntax Description
length number-of-lines session-timeout terminal-type width integer
(Optional) Sets the number of lines on the screen. (Optional) Specifies the number of lines on the screen from 0 to 512. Enter 0 to scroll continuously. (Optional) Specifies the session time out. (Optional) Sets the terminal type. (Optional) Sets the width of the display terminal, from 0 to 80. Sets the width of the display terminal, from 0 to 80.
Defaults
The default number of lines for the length is 24. The default width is 80 lines.
Command Modes
EXEC
Command History
Usage Guidelines
Remember that all terminal parameter-setting commands are set locally and do not remain in effect after a session is ended. You must perform this task at the EXEC prompt at each session to see the debugging messages. If the length is not 24 and the width is not 80, then you need to set a length and width.
Examples
The following example enables the session timeout to 0 (will not time out) for the ASM in slot 2.
module-2# terminal session-timeout 0
27-15
Chapter 27 attachpriv module
attachpriv module
To connect to a ASMs Linux prompt, use the attachpriv module command in EXEC mode. To disconnect, use the exit command at the module-number# prompt, or type $. to forcibly abort the attach session. attachpriv module slot-number
Syntax Description
attachpriv module slot-number
Attaches to the Linux prompt. Specifies the slot number for the ASM
Command Modes
EXEC
Command History
Usage Guidelines
You cannot configure the ASM using this command. After you connect to the image on the module using the attachpriv module command, the prompt changes to vmroot@00:05:30:00:AC:AA:/root#. You can only issue Linux-specific commands at this prompt. This command only works with the ASM, not with any other type of module. You must log into the supervisor module with admin privileges in order to run this command.
Caution
The attachpriv module command is for troubleshooting, and should only be used by Cisco or Veritas support personnel. Do not attempt to configure the ASM at the Linux prompt.
Examples
The following example attaches to the ASM in slot 2 and connects to the Linux mode.
switch# attachpriv module 2 Attaching to asm 127.1.2.2 To exit type 'exit', to abort type '$. vmroot@00:05:30:00:AC:AA:/root#
27-16
Chapter 27
Advanced Services Module Commands asm mgmt-vsan
asm mgmt-vsan
To assign the management VSAN for the Advanced Services Module (ASM), use the asm mgmt-vsan command. To revert to factory defaults or to negate a previously issued command, use the no form of the command. asm mgmt-vsan vsan-id module slot-number no asm mgmt-vsan vsan-id module slot-number
Syntax Description
asm mgmt-vsan vsan-id module slot-number
Configures the Advanced Services Module (ASM). Configures the management VSAN. Specifies the ID of the management VSAN from 1 to 4093. Specifies the slot number of the ASM.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
When you specify a management VSAN for the ASM, nine (9) fabric virtual (FV) interfaces are created If you have configured trunking on both switches, you will see 18 FV interfaces instead of 9 FV interfaces. After you configure the interface for a host port, you may set any other port-specific parameters, such as port type or mode.
Examples
The following example configures management VSAN 2 for the ASM in slot 2.
switch# config terminal switch(config)# asm mgmt-vsan 2 module 2
Related Commands
Command show vsan show asm mgmt-vsan
Description Displays all VSAN configurations. Displays the configured management VSAN.
27-17
Chapter 27 interface cpp
interface cpp
To configure a Control Plane Process (CPP) interface on the Cisco MDS 9000 Family of switches, use the interface cpp command. To disable a Fibre Channel interface, use the no form of the command. interface cpp slot_number/processor-number/vsan-id
Syntax Description
interface cpp slot-number processor-number vsan-id
Configures a new interface. Specifies the new interface to be a virtualization IPFC interface. Specifies a slot number of the ASM. Specifies the processor number for the IPFC interface. The current processor number is always 1. Specifies the ID of the management VSAN from 1 to 4093.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
You can specify a range of interfaces by issuing a command with the following example format: interface space fc1/1space-space5space,spacefc2/5space-space7
Examples
The following example configures an IPFC interface for the ASM in slot 2 with a processor ID 1 in management VSAN 2.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# interface cpp 2/1/2 switch(config-if)#
Related Commands
27-18
Chapter 27
Advanced Services Module Commands show asm
show asm
To displays configured information for the ASM, use the show asm command. To revert to factory defaults or to negate a previously issued command, use the no form of the command. show asm disk-group | mgmt-vsan
Syntax Description
asm mgmt-vsan vsan-id module slot-number
Configures the Advanced Services Module (ASM). Configures the management VSAN. Specifies the ID of the management VSAN from 1 to 4093. Specifies the slot number of the ASM.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example displays the disk groups for the ASM in slot 2. Node refers to the ASM in slot 2 and SII refers to the SCSI index instance. When a disk group is created using the VERITAS Storage Foundation (TM) for Networks application, they are stored in the ASM.
switch# show asm disk-group SII Node Disk Group Name === ====== ========================== 3 2 dg1-114 4 2 dg2-114 5 2 dg1-112 6 2 dg2-112 === ====== ========================== switch# show asm mgmt-vsan Module-Id Management VSAN ========= ================== 2 2 ========= ==================
Related Commands
Command asm mgmt-vsan
Description Configures the management VSAN.
27-19
Chapter 27 show flogi database
show flogi database

To list all the FLOGI sessions through all interfaces across all VSANs, use the show flogi database command. show flogi database [fcid fcid-id | interface interface | vsan vsan-id]
Syntax Description
fcid fcid-id interface interface vsan vsan-id
Displays FLOGI database entries based on the FCID allocated. Displays FLOGI database entries based on the logged in interface. Displays FLOGI database entries based on the VSAN ID. The range is 1 to 4093.
Defaults
Displays the entire FLOGI database.
Command Modes
EXEC mode.
Command History
Usage Guidelines
FV interfaces are automatically created when the ASM boots up. You can issue this command for a specific VSAN (management VSAN or discovery VSAN, or host VSAN using the VSAN ID, or you can use the FCID to view a specific interfaces port name and node name. The symbolic port names and node names can only be displayed for a local device.
Examples
The following example displays the virtualization related FV interface information in the FLOGI database.
switch# show flogi database vsan 2 --------------------------------------------------------------------------INTERFACE VSAN FCID PORT NAME NODE NAME --------------------------------------------------------------------------sup-fc0 2 0x6f0001 10:00:00:05:30:00:59:1f 20:00:00:05:30:00:59:1e fv2/1/1 2 0x6f0002 10:00:00:05:30:00:59:20 20:00:00:05:30:00:59:1e fv2/1/2 2 0x6f0003 23:02:00:05:30:00:59:20 22:14:00:05:30:00:59:20 fv2/1/3 2 0x6f000b 23:00:00:05:30:00:59:20 22:14:00:05:30:00:59:20 fv2/1/8 2 0x6f0000 10:00:00:00:5e:00:01:02 20:00:00:05:30:00:59:1e fv2/1/9 2 0x6f000c 10:00:00:00:5e:00:01:01 20:00:00:05:30:00:59:1e fv2/2/1 2 0x6f0004 23:03:00:05:30:00:59:20 22:14:00:05:30:00:59:20 fv2/3/1 2 0x6f0005 23:04:00:05:30:00:59:20 22:14:00:05:30:00:59:20 fv2/4/1 2 0x6f0006 23:05:00:05:30:00:59:20 22:14:00:05:30:00:59:20 fv2/5/1 2 0x6f0007 23:06:00:05:30:00:59:20 22:14:00:05:30:00:59:20 fv2/6/1 2 0x6f0008 23:07:00:05:30:00:59:20 22:14:00:05:30:00:59:20 fv2/7/1 2 0x6f0009 23:08:00:05:30:00:59:20 22:14:00:05:30:00:59:20 fv2/8/1 2 0x6f000a 23:09:00:05:30:00:59:20 22:14:00:05:30:00:59:20
27-20
Chapter 27
Advanced Services Module Commands show interface
show interface
You can check the status of an interface at any time by using the show interface command. show interface [interface range] [brief | counters | description] [cpp slot/process-number/vsan-id] | [fv slot/dpp-number/fv-port] [fc slot/port] | [fc-tunnel tunnel-id] | [fcip interface-number | gigabitethernet | iscsi] | mgmt | port-channel portchannel-number. subinterface-number | sup-fc | transceiver | trunk vsan [vsan-id] | vsan vsan-id
Syntax Description
interface range brief counters description cpp slot/process-number/ vsan-id fv slot/dpp-number/fv-port fc slot/port fc-tunnel tunnel-id fcip interface-number gigabitethernet slot/port iscsi slot/port mgmt port-channel portchannel-number. subinterface-number sup-fc transceiver trunk vsan vsan-id vsan vsan-id
Displays the interfaces in the specified range. Displays brief info of interface. Displays the interface counter information. Displays a description of interface. Displays the virtualization IPFC interface in the specified slot along with the processor number and the VSAN ID. Displays the virtual F port (FV port) interface in the specified slot along with the data path processor (DPP) number and the FV port number. Displays the Fibre Channel interface in the specified slot/port. Displays description of the specified FC tunnel from 1 to 4095. Displays the description of the specified FCIP interface from 1 to 255. Displays the description of the Gigabit Ethernet interface in the specified slot/port. Displays the description of the iSCSI interface in the specified slot/ port. Displays the description of the management interface. Displays the PortChannel interface specified by the PortChannel number followed by a dot (.) indicator and the subinterface number. Displays the inband interface details. Displays the transceiver information for interface. Displays the trunking status of all VSANs. Displays the trunking status of the specified VSANs. Displays the VSAN interface (brief, counters, or description for a specified interface or a range of interfaces)
Defaults
None
Command Modes
EXEC
27-21
Command History This command was modified in Cisco MDS SAN-OS Release 1.2(2).
Usage Guidelines
The interface range must be in ascending order and nonoverlapping. You can specify a range using a hyphen and several interfaces using commas:
The interface range format for a FC interface range is fcslot/port - port , fcslot/port , fcslot/port (For example, show int fc1/1 - 3 , fc1/5 , fc2/5) The interface range format for a FV interface range is fvslot/dpp/fvport - fvport , fvslot/dpp/port , fvslot/dpp/port (For example, show int fv2/1/1 - 3 , fv2/1/5 , fv2/2/5) The interface range format for a CPP interface range is cppslot/process/vsan-id - vsan-id , cppslot/process/vsan-id , cppslot/process/vsan-id (For example, show int cpp2/1/2 - 3 , cpp2/1/5 , cpp2/1/7) The format for a PortChannel is port-channel portchannel-number.subinterface-number (For example, show int port-channel 5.1)
The CPP interface is configured when the IPFC interface is set up.
Examples
The following example displays the various interface commands.

switch# show interface fc1/11 fc1/11 is up Hardware is Fibre Channel Port WWN is 20:0b:00:05:30:00:59:de Admin port mode is ST Port mode is ST Port vsan is 1 Speed is 1 Gbps Rspan tunnel is fc-tunnel 100 Beacon is turned off 5 minutes input rate 248 bits/sec, 31 bytes/sec, 0 frames/sec 5 minutes output rate 176 bits/sec, 22 bytes/sec, 0 frames/sec 6862 frames input, 444232 bytes 0 discards, 0 errors 0 CRC, 0 unknown class 0 too long, 0 too short 6862 frames output, 307072 bytes 0 discards, 0 errors 0 input OLS, 0 LRR, 0 NOS, 0 loop inits 0 output OLS, 0 LRR, 0 NOS, 0 loop inits switch# show interface fc1/1 - 3 , fc1/5 , fc2/5 brief ------------------------------------------------------------------------------Interface Vsan Admin Admin Status FCOT Oper Oper Port Mode Trunk Mode Speed Channel Mode (Gbps) ------------------------------------------------------------------------------fc1/1 3 auto on up swl FL 1 -fc1/2 1 auto on fcotAbsent ---fc1/3 1 auto on fcotAbsent ---fc1/5 3 auto on notConnected swl --fc2/5 5 FX -up swl F 2 --
27-22
Chapter 27
switch# show interface sup-fc0 sup-fc0 is up Hardware is FastEthernet, address is 0000.0000.0000 MTU 2596 bytes, BW 1000000 Kbit 66 packets input, 7316 bytes Received 0 multicast frames, 0 compressed 0 input errors, 0 frame, 0 overrun 0 fifo 64 packets output, 28068 bytes, 0 underruns 0 output errors, 0 collisions, 0 fifo 0 carrier errors switch# show interface vsan 2 vsan2 is up, line protocol is up WWPN is 10:00:00:05:30:00:59:1f, FCID is 0xb90100 Internet address is 10.1.1.1/24 MTU 1500 bytes, BW 1000000 Kbit 0 packets input, 0 bytes, 0 errors, 0 multicast 0 packets output, 0 bytes, 0 errors, 0 dropped switch# show interface description fc1/1 no description fc1/2 no description fc1/15 fcAnl sup-fc0 is up mgmt0 is up vsan1 - IPFC interface port-channel 15 no description port-channel 98 no description switch# show interface fc2/1 - 5 brief ------------------------------------------------------------------------------Interface Vsan Admin Admin Status Oper Oper Port-channel Mode Trunk Mode Speed Mode (Gbps) ------------------------------------------------------------------------------fc1/1 3 auto on up FL 1 -fc1/2 1 auto on fcotAbsent --fc1/3 1 auto on fcotAbsent --fc1/4 3 auto on up FL 1 -fc1/5 3 auto on up F 2 -fc1/6 1 auto on fcotAbsent --fc1/7 1 auto on fcotAbsent --fc1/8 3 auto on fcotAbsent --fc1/9 1 auto on fcotAbsent --fc1/10 1 auto on fcotAbsent --fc1/11 1 auto on fcotAbsent --fc1/12 1 auto on fcotAbsent --fc1/13 1 auto on fcotAbsent --fc1/14 1 auto on fcotAbsent --fc1/15 1 auto on fcotAbsent --fc1/16 1 auto on trunking TE 2 -fc2/1 1 FX -fcotAbsent --fc2/2 1 FX -fcotAbsent --fc2/3 1 FX -fcotAbsent ---
27-23
fc2/4 1 FX -fcotAbsent --fc2/5 5 FX -up F 2 -... ------------------------------------------------------------------------------Interface Status Speed (Gbps) ------------------------------------------------------------------------------sup-fc0 up 1 ------------------------------------------------------------------------------Interface Status IP Address Speed MTU ------------------------------------------------------------------------------mgmt0 up 172.22.36.112/23 100 Mbps 1500 ------------------------------------------------------------------------------Interface Status IP Address Speed MTU ------------------------------------------------------------------------------vsan2 up 15.0.112.0/16 1 Gbps 1500 ------------------------------------------------------------------------------Interface Status IP Address Speed MTU ------------------------------------------------------------------------------cpp2/1/2 up 15.0.112.2/16 1 Gbps 1500 ------------------------------------------------------------------------------Interface VSAN Status Oper Speed Port-channel Mode ------------------------------------------------------------------------------fv2/1/1 2 up F auto -fv2/1/2 2 up F auto -fv2/1/3 2 up F auto -fv2/1/4 3 up F auto -fv2/1/5 3 up F auto -fv2/1/6 4 up F auto -... switch# show interface fcip 3 counters fcip3 TCP Connection Information 2 Active TCP connections Control connection: Local 43.1.1.2:3225, Remote 43.1.1.1:65532 Data connection: Local 43.1.1.2:3225, Remote 43.1.1.1:65534 30 Attempts for active connections, 0 close of connections TCP Parameters Path MTU 1500 bytes Current retransmission timeout is 300 ms Round trip time: Smoothed 10 ms, Variance: 5 Advertised window: Current: 122 KB, Maximum: 122 KB, Scale: 1 Peer receive window: Current: 114 KB, Maximum: 114 KB, Scale: 1 Congestion window: Current: 2 KB, Slow start threshold: 1048560 KB 5 minutes input rate 64 bits/sec, 8 bytes/sec, 0 frames/sec 5 minutes output rate 64 bits/sec, 8 bytes/sec, 0 frames/sec 910 frames input, 84652 bytes 910 Class F frames input, 84652 bytes 0 Class 2/3 frames input, 0 bytes 0 Error frames timestamp error 0 908 frames output, 84096 bytes 908 Class F frames output, 84096 bytes 0 Class 2/3 frames output, 0 bytes 0 Error frames 0 reass frames switch# show interface counters brief ------------------------------------------------------------------------------Interface Input (rate is 5 min avg) Output (rate is 5 min avg)
27-24
Chapter 27
----------------------------- ----------------------------Rate Total Rate Total MB/s Frames MB/s Frames ------------------------------------------------------------------------------fc9/1 0 0 0 0 fc9/2 0 0 0 0 fc9/3 0 0 0 0 fc9/4 0 0 0 0 ... ------------------------------------------------------------------------------Interface Input (rate is 5 min avg) Output (rate is 5 min avg) ----------------------------- ----------------------------Rate Total Rate Total MB/s Frames MB/s Frames ------------------------------------------------------------------------------iscsi4/1 0 0 0 0 iscsi4/2 0 0 0 0 iscsi4/3 0 0 0 0 iscsi4/4 0 0 0 0 ... vsan10 is up, line protocol is up WWPN is 10:00:00:05:30:00:07:23, FCID is 0xee0001 Internet address is 10.1.1.5/24 MTU 1500 bytes, BW 1000000 Kbit 0 packets input, 0 bytes, 0 errors, 0 multicast 0 packets output, 0 bytes, 0 errors, 0 dropped
------------------------------------------------------------------------------Interface Input (rate is 5 min avg) Output (rate is 5 min avg) ----------------------------- ----------------------------Rate Total Rate Total MB/s Frames MB/s Frames ------------------------------------------------------------------------------port-channel 100 0 0 0 0
------------------------------------------------------------------------------Interface Input (rate is 5 min avg) Output (rate is 5 min avg) ----------------------------- ----------------------------Rate Total Rate Total Mbits/s Frames Mbits/s Frames ------------------------------------------------------------------------------fcip2 fcip3 fcip6 fcip7 0 9 8 8 0 0 0 0 0 9 8 8 0 0 0 0
switch# show interface fcip 3 fcip3 is trunking Hardware is GigabitEthernet Port WWN is 20:ca:00:05:30:00:07:1e Peer port WWN is 20:ca:00:00:53:00:18:1e Admin port mode is auto, trunk mode is on Port mode is TE vsan is 1 Trunk vsans (allowed active) (1,10) Trunk vsans (operational) (1) Trunk vsans (up) (1) Trunk vsans (isolated) (10) Trunk vsans (initializing) () Using Profile id 3 (interface GigabitEthernet4/3)
27-25
Peer Information Peer Internet address is 43.1.1.1 and port is 3225 Special Frame is disabled Maximum number of TCP connections is 2 Time Stamp is disabled B-port mode disabled TCP Connection Information 2 Active TCP connections Control connection: Local 43.1.1.2:3225, Remote 43.1.1.1:65532 Data connection: Local 43.1.1.2:3225, Remote 43.1.1.1:65534 30 Attempts for active connections, 0 close of connections TCP Parameters Path MTU 1500 bytes Current retransmission timeout is 300 ms Round trip time: Smoothed 10 ms, Variance: 5 Advertized window: Current: 122 KB, Maximum: 122 KB, Scale: 1 Peer receive window: Current: 114 KB, Maximum: 114 KB, Scale: 1 Congestion window: Current: 2 KB, Slow start threshold: 1048560 KB 5 minutes input rate 64 bits/sec, 8 bytes/sec, 0 frames/sec 5 minutes output rate 64 bits/sec, 8 bytes/sec, 0 frames/sec 866 frames input, 80604 bytes 866 Class F frames input, 80604 bytes 0 Class 2/3 frames input, 0 bytes 0 Error frames timestamp error 0 864 frames output, 80048 bytes 864 Class F frames output, 80048 bytes 0 Class 2/3 frames output, 0 bytes 0 Error frames 0 reass frames switch# show interface gigabitethernet 4/1 GigabitEthernet4/1 is up Hardware is GigabitEthernet, address is 0005.3000.2e12 Internet address is 100.1.1.2/24 MTU 1500 bytes, BW 1000000 Kbit Port mode is IPS Speed is 1 Gbps Beacon is turned off 5 minutes input rate 32 bits/sec, 4 bytes/sec, 0 frames/sec 5 minutes output rate 88 bits/sec, 11 bytes/sec, 0 frames/sec 637 packets input, 49950 bytes 0 multicast frames, 0 compressed 0 input errors, 0 frame, 0 overrun 0 fifo 659 packets output, 101474 bytes, 0 underruns 0 output errors, 0 collisions, 0 fifo 0 carrier errors switch# show interface iscsi 2/1 iscsi2/1 is up Hardware is GigabitEthernet Port WWN is 20:41:00:05:30:00:50:de Admin port mode is ISCSI Port mode is ISCSI Speed is 1 Gbps iSCSI initiator is identified by name Number of iSCSI session: 7, Number of TCP connection: 7 Configured TCP parameters Local Port is 3260 PMTU discover is disabled Keepalive-timeout is 1 sec Minimum-retransmit-time is 300 ms Max-retransmissions 8 Sack is disabled Minimum available bandwidth is 0 kbps Estimated round trip time is 0 usec
27-26
Chapter 27
5 minutes input rate 265184 bits/sec, 33148 bytes/sec, 690 frames/sec 5 minutes output rate 375002168 bits/sec, 46875271 bytes/sec, 33833 frames/sec iSCSI statistics 6202235 packets input, 299732864 bytes Command 6189718 pdus, Data-out 1937 pdus, 1983488 bytes, 0 fragments 146738794 packets output, 196613551108 bytes Response 6184282 pdus (with sense 4), R2T 547 pdus Data-in 140543388 pdus, 189570075420 bytes switch# show interface cpp 2/1/2 cpp2/1/2 is up, line protocol is up WWPN is 10:00:00:05:30:00:94:a0, FCID is 0x6d0002 Internet address is 15.0.114.2/16 MTU 1500 bytes, BW 1000000 Kbit 4679361 packets input, 568734976 bytes, 0 errors, 1202625 multicast 5000574 packets output, 584517419 bytes, 1 errors, 10 dropped switch# show interface transceiver fc1/1 fcot is present but not supported name is IBM part number is IBM42P21SNY revision is AA20 serial number is 53P148700109D vendor specific data (bytes 96-127) 0x49 0x42 0x4D 0x20 0x53 0x46 0x50 0x20 0x41 0x52 0x45 0x20 0x43 0x4C 0x53 0x53 0x20 0x31 0x20 0x4C 0x41 0x45 0x52 0x20 0x53 0x41 0x46 0x45 fc1/2 fcot not present fc1/3 fcot is present but not supported name is IBM part number is IBM42P21SNY revision is AA20 serial number is 53P1487000ZXR vendor specific data (bytes 96-127) 0x49 0x42 0x4D 0x20 0x53 0x46 0x50 0x20 0x41 0x52 0x45 0x20 0x43 0x4C 0x53 0x53 0x20 0x31 0x20 0x4C 0x41 0x45 0x52 0x20 0x53 0x41 0x46 0x45
0x53 0x41 0x53 0x20
0x53 0x41 0x53 0x20
switch# show interface fc-tunnel 200 fc-tunnel 200 is up Dest IP Addr: 200.200.200.7 Tunnel ID: 200 Source IP Addr: 200.200.200.4 LSP ID: 1 Explicit Path Name: Path1 virt-112# show interface fv 2/2/3 fv2/2/3 is up Hardware is Fibre Channel, WWN is 22:13:00:05:30:00:59:20 Port mode is F Speed is auto vsan is 4 Beacon is turned off 0 packets input, 0 bytes, 0 discards 0 input errors, 0 CRC, 0 invalid transmission words 0 address id, 0 delimiter Received 0 runts, 0 jabber, 0 too long, 0 too short 0 EOF abort, 0 fragmented, 0 unknown class 0 OLS, 0 LRR, 0 NOS, 0 loop inits 0 packets output, 0 bytes Transmitted 0 OLS, 0 LRR, 0 NOS, 0 loop inits
switch# show int fv2/1/2
27-27
fv2/1/2 is up Hardware is Fibre Channel, WWN is 22:0b:00:05:30:00:59:20 Port mode is F Speed is auto vsan is 2 Beacon is turned off 0 packets input, 0 bytes, 0 discards 0 input errors, 0 CRC, 0 invalid transmission words 0 address id, 0 delimiter Received 0 runts, 0 jabber, 0 too long, 0 too short 0 EOF abort, 0 fragmented, 0 unknown class 0 OLS, 0 LRR, 0 NOS, 0 loop inits 0 packets output, 0 bytes Transmitted 0 OLS, 0 LRR, 0 NOS, 0 loop inits
27-28
Chapter 27
Advanced Services Module Commands show fvport
show fvport
You can check the status of a virtual F port (FV port) interface at any time by using the show fvport command. show fvport [interface fv slot/dpp-number/fv-port | interface range]
Syntax Description
fvport interface fv slot/dpp-number/fv-port interface range
Displays all FV ports in the switch. Specifies the FV port interface. Displays the FV port interface in the specified slot along with the data path processor (DPP) number and the FV port number. Displays the interfaces in the specified range.
Defaults
None
Command Modes
EXEC
Command History
Usage Guidelines
The interface range must be in ascending order and nonoverlapping. You can specify a range using a hyphen and several interfaces using commas. The interface range format for a FV interface range is fvslot/dpp/fvport - fvport , fvslot/dpp/port , fvslot/dpp/port (For example, show fvport int fv2/1/1 - 3 , fv2/1/5 , fv2/2/5)
Examples
switch# show fvport fv2/1/1 The N Port if_index is The N Port pwwn is The N Port nwwn is The vsan is The FV Port if_index is The FV Port pwwn is The DPP id is The NV port type is The State is Number of create requests minus the number of delete requests = ...
0x01090000 10:00:00:05:30:00:59:20 20:00:00:05:30:00:59:1e 2 0x0e080000 22:0a:00:05:30:00:59:20 0 IPFC ACTIVE
switch# show fvport interface fv2/4/1 , fv2/7/1 - 3 fv2/4/1 The N Port if_index is 0x01094000 The N Port pwwn is 23:05:00:05:30:00:59:20 The N Port nwwn is 23:01:00:05:30:00:59:20 The vsan is 2
27-29
Chapter 27 show fvport
The FV Port if_index is The FV Port pwwn is The DPP id is The NV port type is The State is Number of create requests minus the number of delete requests = fv2/7/1 The N Port if_index is The N Port pwwn is The N Port nwwn is The vsan is The FV Port if_index is The FV Port pwwn is The DPP id is The NV port type is The State is Number of create requests minus the number of delete requests = fv2/7/2 The N Port if_index is The N Port pwwn is The N Port nwwn is The vsan is The FV Port if_index is The FV Port pwwn is The DPP id is The NV port type is The State is Number of create requests minus the number of delete requests = fv2/7/3 The N Port if_index is The N Port pwwn is The N Port nwwn is The vsan is The FV Port if_index is The FV Port pwwn is The DPP id is The NV port type is The State is Number of create requests minus the number of delete requests = 0x0108e000 23:2c:00:05:30:00:59:20 23:2e:00:05:30:00:59:20 4 0x0e098002 23:61:00:05:30:00:59:20 6 INTERNAL PORT ACTIVE 0x0108d000 23:1a:00:05:30:00:59:20 23:46:00:05:30:00:59:20 3 0x0e098001 23:58:00:05:30:00:59:20 6 INTERNAL PORT ACTIVE 0x0108c000 23:08:00:05:30:00:59:20 23:01:00:05:30:00:59:20 2 0x0e098000 23:6a:00:05:30:00:59:20 6 INTERNAL PORT ACTIVE 0x0e08c000 23:67:00:05:30:00:59:20 3 INTERNAL PORT ACTIVE
27-30
C H A P T E R
28
Caching Services Module Commands

The commands in this chapter apply to the SAN Volume Controller (SVC) software and the Caching Services Module (CSM) in Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. For more information on virtualization using the CSM, see the Related Documentation section on page xxix.
28-1
Chapter 28 cluster add
cluster add
To create a cluster with a specified SVC node, use the cluster add command in SVC configuration mode. cluster add cluster-name ip ip-address node svc slot-number/node-number
Syntax Description
cluster add cluster-name
Provides access to cluster commands Specifies a new cluster addition. The cluster name must start with an alphabet and is restricted to 15 alphanumeric characters, including dash (-) and underscore (_). The cluster name cannot be ClusterX, where X is a number. Specifies the IP address of the specified cluster. The IP address must be in the same subnet as the switch management IP address. Specifies the nodes SVC interface Specifies the slot number of the Caching Service Module (CSM). Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
ip ip-address node svc slot-number node-number
Defaults
None.
Command Modes
SVC configuration mode.
Command History
Usage Guidelines
Enter this command while connected to the switch management IP address of a node at which the cluster is being created.
Examples
The following example enters the SVC configuration mode, verifies the status of previously-configured clusters, and adds a cluster called SampleCluster.
switch# svc-config switch(svc)# show nodes local ------------------------------------------------------------------------------Node cluster config cluster node sw node status status version ------------------------------------------------------------------------------svc2/1 No unconfigured free 1.3(1) svc2/2 No unconfigured free 1.3(1) switch(svc)# cluster add SampleCluster ip 10.10.0.1 node svc 2/1 cluster creation going on. Please wait....
28-2
Chapter 28
Caching Services Module Commands cluster add
The status of the newly-added cluster can be verified using the show nodes local command.
switch(svc)# show nodes local ------------------------------------------------------------------------------Node cluster config cluster node sw node status status version ------------------------------------------------------------------------------svc2/1 SampleCluster Yes active active 1.3(1) svc2/2 No unconfigured free 1.3(1)
Related Commands
Command show nodes local
Description Displays the cluster name and status for all nodes in the switch.
28-3
Chapter 28 cluster config
cluster config
To manage cluster configurations on a specified cluster, use the cluster config configuration submode. cluster config cluster-name
Syntax Description
cluster config cluster-name
Provides access to cluster commands Places a previously created cluster in the cluster configuration submode (switch(svc-cluster)#).
Defaults
None.
Command Modes
SVC configuration modecluster configuration submode.
Command History
Usage Guidelines
None.
Examples
The following example enters the SVC configuration mode and adds a cluster called SampleCluster.
switch(svc)# cluster config SampleCluster switch(svc-cluster)#
Related Commands
Command show cluster
Description Displays configured cluster information.
28-4
Chapter 28
Caching Services Module Commands cluster name
cluster name
To perform operations on a previously-configured cluster, use the cluster name command in SVC configuration mode. cluster name cluster-name flash-copy fc-grp-name [prepare | start | stop] cluster name cluster-name remote-copy rc-grp-name {failover | start [aux | clean | force] | stop aux-enable} cluster name cluster-name shutdown [node node-name] cluster name cluster-name start discovery cluster name cluster-name upgrade svc-system [force]}
Syntax Description
cluster name cluster-name prepare start stop remote-copy rc-grp-name failover shutdown node node-name start discovery aux clean upgrade svc-system force aux-enable
Provides access to cluster commands Identifies a previously created cluster to perform an operation. Prepares the FlashCopy consistency group. Starts the FlashCopy for the specified cluster. Starts the background copy for the specified remote copy group Stops the FlashCopy for the specified cluster. Stops the remote copy relationships for the specified remote copy group. Specifies the remote copy consistency group name. Reverses to using the auxiliary VDisks for the specified relationship. Shuts down the entire cluster (gracefully). Specifies a particular node for a graceful shutdown. Starts the background copy for the specified remote copy group. Makes the auxiliary VDisks as primary. Marks the intended secondary VDisks as clean. Upgrades the specified cluster. The new version of the software image is specified to the FTP:, SCP:, SFTP:, TFTP:, bootflash:, or slot0: directories Permits the remote copy operation to starteven if it leads to the loss of data consistency between the primary and secondary. Enables write access o the secondary (or auxiliary) VDisks.
flash-copy fc-grp-name Specifies a previously-configured FlashCopy relationship.
Defaults
None.
Command Modes
28-5
Chapter 28 cluster name
Usage Guidelines
None.
Examples
The following example enters the SVC configuration mode and displays all options under the cluster name command.
switch# svc-config switch(svc)# cluster name SampleCluster ? flash-copy Flash-copy remote-copy Remote copy shutdown Shutdown start Start discovery upgrade Upgrade uri switch(svc)# cluster name SampleCluster flash-copy f1 prepare switch(svc)# cluster name SampleCluster flash-copy f1 start switch(svc)# cluster name SampleCluster flash-copy f1 stop switch(svc)# cluster name SampleCluster remote-copy f1 failover switch(svc)# cluster name SampleCluster remote-copy f1 start switch(svc)# cluster name SampleCluster remote-copy f1 stop switch(svc)# cluster name SampleCluster shutdownn switch(svc)# cluster name SampleCluster shutdown node svc2/1 switch(svc)# cluster name SampleCluster start discovery switch(svc)# cluster name SampleCluster upgrade svc-system bootflash:m9000-ek9-csm-svc_mz.1.3.1.bin
28-6
Chapter 28
Caching Services Module Commands dir modflash:
dir modflash:
To display the contents of the modflash: file system, use the dir modflash: command in EXEC mode. dir modflash://module-number-node-number-path
Syntax Description
modflash: module-number node-number path volatile cores
Flash image that resides on the Caching Services Module (CSM). Specifies the slot number in which the CSM resides. Specifies one of the two nodes in the CSM (SVC node). The options are 1 or 2. Specifies the volatile or the cores paths. Displays the /var and /tmp of the SVC node on the supervisor module and can be used to move files from/to the SVC node. Displays process, kernel crash dumps, and other trace information used to debug software issues.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to list the files on the bootflash directory.
switch# dir modflash://2-2-cores switch# dir modflash://2-2-volatile
Related Commands
Command delete
Description Deletes a file on a Flash memory device.
28-7
Chapter 28 feature enable
feature enable
To enable a specified feature in a cluster, use the feature enable command in the cluster configuration submode. cluster config cluster-name feature enable {capacity number | flash-copy | remote-copy}
Syntax Description
cluster config cluster-name feature enable capacity number flash-copy remote-copy
Provides access to cluster commands Places a previously created cluster in the cluster configuration submode. Enables a specified feature on this cluster. Three features can be enabled: capacity, flash-copy, or remote-copy Configures the virtualization capacity of this cluster. Provides a range from 1- 1677215 Gigabytes. Enables the flash-copy feature for this cluster. Enables the remote-copy feature for this cluster.
Defaults
None.
Command Modes
Command History
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#). By default, flash-copy and remote-copy are disabled and 0 (zero) GB of virtualization capacity is enabled.
Examples
The following example enters the cluster configuration submode for the SampleCluster cluster and assigns a size of 4000 Gigabytes. The next two commands enables the flash-copy and remote-copy features for this cluster.
switch(svc)# cluster config SampleCluster switch(svc-cluster)# feature enable ? capacity Cluster enable feature capacity flash-copy Cluster enable feature flash-copy remote-copy Cluster enable feature remote-copy switch(svc-cluster)# feature enable capacity ? <0-2147483647> Enter the capacity switch(svc-cluster)# feature enable capacity 4000
28-8
Chapter 28
Caching Services Module Commands feature enable
switch(svc-cluster)# feature enable flash-copy switch(svc-cluster)# feature enable remote-copy
Related Commands
Command show cluster name flash-copy show cluster name remote-copy
Description Displays configured flash-copy information for a specified cluster. Displays configured remote copy information for a specified cluster.
28-9
Chapter 28 flash-copy
flash-copy
To create a snapshot (or point-in-time copy) of a specified VDisk or group of VDisks, use the flash-copy command in the cluster configuration submode. cluster config cluster-name flash-copy add fcopy-name flash-copy name fcopy-name map src-vdisk vdisk-name dst-vdisk vdisk-name | [mode copy-on-write | full rate rate] flash-copy rename old-name newname new-name
Syntax Description
cluster config cluster-name flash-copy fcopy-name map src-vdisk vdisk-name dst-vdisk vdisk-name mode copy-on-write full rate rate
Provides access to cluster commands Places a previously created cluster in the cluster configuration submode. Enters the FlashCopy submode for an existing copy name. Creating a mapping between the source and destination VDisks. Specifies the source VDisk for the flash copy. Specifies the destination VDisk for the flash copy. Controls the FlashCopy mode. Copies to the source VDisk only if new information in written to it after FlashCopy is initiated (default). Specifies the background copy rate (ranges from 1 to 100) at which the source VDisk is copied to the destination VDisk even if no new information is written to the source.
flash-copy add fcopy-name Creates a FlashCopy instance.
Defaults
None.
Command Modes
Command History
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#. The flash-copy submode prompt is switch(svc-cluster-flash-copy)#.
Examples
The following example enters the enters the cluster configuration mode for the SampleCluster 1 cluster.
switch(svc)# cluster config SampleCluster
28-10
Chapter 28
Caching Services Module Commands flash-copy
switch(svc-cluster)# flash-copy f2 switch(svc-cluster-flash-copy)# ? Submode Commands: exit Exit from this mode map Flash-copy map mode Flash-copy mode no Negate a command or set its defaults switch(svc-cluster-flash-copy)# map src-vdisk VDISK1 dst-vdisk DDISK1 switch(svc-cluster-flash-copy)# mode copy-on-write switch(svc-cluster-flash-copy)# exit switch(svc-cluster)# flash-copy add FlashC2 switch(svc-cluster)# exit
switch(svc)# show SampleCluster flash-copy ------------------------------------------------------------------------------name status ------------------------------------------------------------------------------fccstgrp0 idle_or_copied f2 idle_or_copied switch(svc)# show SampleCluster flash-copy f2 Flash-copy mapping 1: src vdisk is v2 dest vdisk is v3 state is idle_or_copied copy rate is 50 progress 0% done
Related Commands
Command show SampleCluster name flash-copy
Description Displays configured flash-copy information for a specified SampleCluster.
28-11
Chapter 28 host
host
To create or configure hosts, use the host command in the cluster configuration submode. cluster config cluster-name host add host-name hostport port-wwn host name host-name hostport port-wwn | map vdisk vdisk-name [SCSI-lun lun-number]
Syntax Description
cluster config cluster-name host add host-name hostport port-wwn host name host-name map vdisk vdisk-name SCSI-lun lun-number
Provides access to cluster commands Places a previously created cluster in the cluster configuration submode. Creates a host with one port and assigns the host name. Specifies a port using the port WWN Enters the host submode for an existing host name. Maps a previously configured disk to this host. Specifies the VDisk to be mapped to the host. Specifies a LUN to map the host port. If the LUN number is not specified, the next available number is assigned automatically.
Defaults
None.
Command Modes
Command History
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#). The host submode prompt is switch (svc-cluster-host)#
Examples
The following example enters the cluster configuration mode for SampleCluster and creates a host called Host 1with one port, adds a second port, and maps the VDisk for Host1, and verifies the configured information for Host1.
switch(svc)# cluster config SampleCluster switch(svc-cluster)# host add Host1 hostport 11:22:33:44:aa:bb:cc:dd switch(svc-cluster)# host Host1 switch(svc-cluster-host)# ? Submode Commands: exit Exit from this mode
28-12
Chapter 28
Caching Services Module Commands host
hostport map no Add pWWN to host Map vdisk to host Negate a command or set its defaults
switch(svc-cluster-host)# hostport 22:11:33:55:11:aa:bb:cc switch(svc-cluster)# host add Host1 hostport 35:66:11:22:aa:bb:22:cc switch(svc-cluster)# host Host1 switch(svc-cluster-host)# hostport 35:66:11:22:aa:bb:22:11 switch(svc-cluster-host)# map vdisk Vdisk1 switch(svc-cluster-host)# map vdisk Vdisk1 ssci-lun 10
Related Commands
Command
Description
show cluster name host Displays configured host information for a specified cluster.
28-13
Chapter 28 install module node
install module node

To install the SVC node image, use the install module node command. install module module-number node node-number image svc-system [bootflash: | slot0: | ftp: | sftp: | scp: | svc-image]
Syntax Description
install module module-number
Installs the specified image for the CSM. Switching modules: From slot 1 to 4 and 7 to 9 in a Cisco MDS 9500 Series switch. For slot 2 in a Cisco MDS 9200 Series switch. Supervisor modules: Slot 5 or 6only on the active supervisor module in a Cisco MDS 9500 Series switch. Slot 1upgrades both the supervisor and switching parts of the module in a Cisco MDS 9200 Series switch.
node node-number image svc-system bootflash: ftp scp sftp tftp slot0: svc-image
Selects the SVC node to install the image. Specifies the node number. Specifies the file name of an SVC image. Source location for internal bootflash memory URI containing SVC Image. URI containing SVC Image. URI containing SVC Image. URI containing SVC Image. Source location for the CompactFlash memory or PCMCIA card. The name of the SAN Volume Controller (SVC) image.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
The install module module-number node command installs the new image in the specified node on the CSM module. All previous data in that node is lost.
Examples
The following example shows how to install a new image on an SVC node.
switch# install module 2 node 1 image svc-system scp://[email protected]/auto/isan-src/MAIN_1_3_0_17t/VegasSW/build/gdb.sb-svc/isan/target fs/sb-svc.bin
28-14
Chapter 28
Caching Services Module Commands install module node
SVC reimage going on. Please wait [email protected]'s password: sb-svc.bin 100% |*****************************| 45408 KB svc 2/1 software reimage succeeded
00:53
Related Commands
Command show version compatibility
Description Shows the system software that is currently running on the switch
28-15
Chapter 28 interface svc
interface svc
To configure a SAN Volume Controller (SVC) interface on the Cisco MDS 9000 Family of switches, use the interface svc command. interface svc slot_number/node-number interface svc slot_number/node-number initiator | mgmt | nwwn nwwn-id target vsan vsan-id interface svc slot_number/node-number switchport description | shutdown]
Syntax Description
interface svc slot-number node-number initiator mgmt target vsan vsan-id shutdown nwwn nwwn-id
Configures a new interface. Specifies the new interface to be a SVC interface. Specifies the slot number of the Caching Service Module (CSM). Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module. Configures the initiator or port in the specified VSAN. Configures the management or port in the specified VSAN. Configures the target or port in the specified VSAN. Specifies the VSAN ID ranging from 1 to 4093. Enables or disables an interface. Configured a non-system allocated nWWN for SVC Node.
switchport description Assigns a description to the switchport. Restricted to 80 alphanumeric characters.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
By default, all three N-port types (initiator, mgmt, and target) are in VSAN 1. Explicitly remove it from VSAN 1 if this is not required by your network. The VSAN number can be any number from 1 to 4096. Only 64 VSANs for all initiator/mgmt/target are allowed (meaning, you can have initiator in VSANs 1-30, target in VSANs 31-60, and mgmt in VSANs 61-64). If the target, initiator, and mgmt overlap in VSANs, each overlap is also included in the total VSAN count. A mgmt N-port can only exist in 4 of these 64 VSANs. You can specify a range of interfaces by issuing a command with the following example format: interface svc 1/1 space , space svc 2/1-2
28-16
Chapter 28
Caching Services Module Commands interface svc
This command configures Slot 1 Node 1 as an SVC interface and simultaneously configures Slot 2, Nodes 1and 2 as SVC interfaces. Place the disk, host, and other SVC nodes in the appropriate VSAN for any configuration to be completely established
Examples
The following example configures the initiator N-port on VSAN 1, the target N-port on VSAN 2, and the management N-port on VSAN 3.
switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# interface svc 2/1 switch(config-if)# ? Interface configuration commands: do EXEC command exit Exit from this submode initiator Configure Initiator traffic for SVC Node mgmt Configure traffic for communication with other SVC Nodes no Negate a command or set its defaults nwwn Configured a non-system allocated nWWN for SVC Node shutdown Enable/disable an interface switchport Configure switchport parameters target Configure Target traffic for SVC Node switch(config-if)# initiator vsan 1 switch(config-if)# target vsan 2 switch(config-if)# mgmt vsan 3
Related Commands
28-17
Chapter 28 iogroup
iogroup
To assign a name to I/O groups, use the iogroup command in the cluster configuration submode. Use the no form of this command to delete the configured I/O group alias. cluster config cluster-name iogroup group-id alias alias-name
Syntax Description
cluster config cluster-name iogroup group-id alias alias-name
Provides access to cluster commands Places a previously created cluster in the cluster configuration submode. Identifies one of four I/O groups in the specified cluster. The ID ranges from 1 to 4. Assigns a name to the selected I/O group. The name is restricted to 15 alphanumeric characters.
Defaults
None.
Command Modes
Command History
Usage Guidelines
The no iogroup command deletes the alias name, not the I/O group itself. The cluster configuration submode prompt is (switch(svc-cluster)#).
Examples
The following example enters the cluster configuration mode for SampleCluster and configures a new I/O group. The created group is verified using the show cluster name iogroup command
switch(svc)# cluster config SampleCluster switch(svc-cluster)# iogroup 1 alias SampleIOgroup switch(svc-cluster)# exit
Related Commands
Command
Description
show cluster name iogroup Displays configured I/O group information for a specified cluster.
28-18
Chapter 28
Caching Services Module Commands ip
ip
To modify the IP address for a cluster, use the ip command in the cluster configuration submode. cluster config cluster-name ip ip-address
Syntax Description
cluster config cluster-name ip ip-address
Provides access to cluster commands Places a previously created cluster in the cluster configuration submodes. Specifies the IP address of the cluster.
Defaults
None.
Command Modes
Command History
Usage Guidelines
The IP address of the cluster can be changed, but not deleted. If you connect using the current cluster IP address, that session is lost when the command completes. You must then reconnect using the new IP address. The no form of this command is not allowed. The cluster configuration submode prompt is (switch(svc-cluster)#).
Examples
The following example enters the cluster configuration mode for SampleCluster, configures the IP address, and verifies by displaying this information
switch(svc)# cluster config SampleCluster switch(svc-cluster)# ip 172.22.92.32 switch(svc)# show cluster SampleCluster ip cluster ip address is 172.22.92.32
Related Commands
Command show cluster name ip
Description Displays configured -- information for a specified cluster.
28-19
Chapter 28 mdisk-grp
mdisk-grp
To create and configure a mdsik group, use the mdisk-grp command in the cluster configuration submode. cluster config cluster-name mdisk-grp add grp-name extent size mdisk-grp name grp-name -> mdisk id mdisk-id
Syntax Description
cluster config cluster-name extent size mdisk-grp name grp-name mdisk id mdisk-id
Provides access to cluster commands Places a previously created cluster in the cluster configuration submode. Assigns the extent size of the storage allocation for MDisks in this cluster. The extent size can be 16, 32, 64, 128, 256, or 512 MB. Enters the mdisk submode of an existing MDisk group. Assigns the disk ID ranging from 1 to 4096 to the mdisk in the MDisk group submode.
mdisk-grp add grp-name Adds a mdisk group.
Defaults
None.
Command Modes
Command History
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#). The submode prompt for the MDisk group is switch (svc-cluster-mdisk-grp)#
Examples
The following example enters the cluster configuration mode for SampleCluster, creates an MDisk group, and adds an MDisk to the group.
switch(svc)# cluster config SampleCluster switch(svc-cluster)# mdisk-grp add Mdisk1 extent 512 switch(svc-cluster)# mdisk-grp name Mdisk1 switch(svc-cluster-mdisk-grp)# mdisk id 3 switch(svc)# show cluster SampleCluster mdisk-grp ------------------------------------------------------------------------------name Capacity free extent number number status
28-20
Chapter 28
Caching Services Module Commands mdisk-grp
size(MB) of mdisks of vdisks ------------------------------------------------------------------------------finance 7.56 GB 7.56 GB 16 5 0 online marketing 6.48 GB 6.48 GB 16 5 0 online
Related Commands
Command show cluster name mdisk
Description Displays configured MDisk group information for a specified cluster.
28-21
Chapter 28 migrate vdisk
migrate vdisk
To configure data migration from a VDisk, use the migrate vdisk command in the cluster configuration submode. cluster config cluster-name migrate vdisk vdisk-name new-mdisk-grp grp-name migrate vdisk vdisk-name src-mdisk id mdisk-id num-extents number tgt-mdisk id mdisk-id
Syntax Description
cluster config cluster-name new-mdisk-grp grp-name src-mdisk id mdisk-id num-extents number tgt-mdisk id mdisk-id
Provides access to cluster commands Places a previously created cluster in the cluster configuration submode. Migrates data to a newly specified MDisk group. Specifies the source MDisk for data migration. Specifies the extents of a VDisk for data migration. Specifies the target MDisk for data migration.
migrate vdisk vdisk-name Migrates data from the specified VDisk to a MDisk or MDisk group.
Defaults
None.
Command Modes
Command History
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#).
Examples
The following example enters the cluster configuration mode for SampleCluster, migrates a VDisk to a new MDisk group.
switch(svc)# cluster config SampleCluster switch(svc-cluster)# migrate vdisk Vdisk2 new-mdisk-grp Group5 switch(svc-cluster)# migrate vdisk Vdisk2 src-mdisk id 3 num-extents 2 tgt-mdisk id 4
Related Commands
Command show cluster name status migrate
Description Displays configured MDisk migration status information for a specified cluster.
28-22
Chapter 28
Caching Services Module Commands node
node
To add a node to a cluster or to assign a name to a preconfigured node, use the node command in the cluster configuration submode. cluster config cluster-name node name node-name node nwwn node-wwn node iogroup group-id [alias alias-name]
Syntax Description
cluster config node name node-name nwwn node-wwn iogroup group-id alias alias-name
Provides access to cluster commands Adds a specified node to the cluster being configured. Specifies the node using a 15 alphanumeric characters. Specifies the node using the nWWN with the format hh:hh:hh:hh:hh:hh:hh:hh. Identifies one of four I/O groups in the specified cluster. The ID ranges from 1 to 4. Assigns a name to the selected node. The name is restricted to 156 alphanumeric characters.
Defaults
None.
Command Modes
Command History
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#). The node must first be added before assigning an alias name. The no form of the command deletes the node from the cluster.
Examples
The following example enters the cluster configuration mode for SampleCluster, adds a node by assigning the nWWN, and associates the node with an alias.
switch(svc)# cluster config SampleCluster switch(svc-cluster)# node nwwn 20:00:00:04:cf:e6:e4:df iogroup 1 switch(svc-cluster)# node nwwn 20:00:00:04:cf:e6:e4:df alias NodeAlias
28-23
Chapter 28 node
Related Commands Command show cluster name nodes Description Displays configured node information for a specified cluster.
28-24
Chapter 28
Caching Services Module Commands node svc delete
node svc delete

To delete all cluster configurations from a specific node, use the node svc delete command in SVC configuration mode. node svc slot-number/node-number delete
Syntax Description
node svc slot-number node-number delete
Specifies the nodes SVC interface Specifies the slot number of the Caching Service Module (CSM). Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module. Deletes a cluster information from the specified node.
Defaults
None.
Command Modes
Command History
Usage Guidelines
Use this command if the node has lost communication with a configured cluster.
Examples
The following example enters the SVC configuration mode and adds a cluster called SampleCluster.
switch# svc-config switch(svc)# node svc 2/1 delete
Related Commands
Description Displays configured node information.
28-25
Chapter 28 node svc recover
node svc recover

To initiate cluster recovery on a specified SVC node, use the recover cluster command in SVC configuration mode. node svc slot-number/node-number recover
Syntax Description
node svc slot-number node-number recover
Specifies the nodes SVC interface Specifies the slot number of the Caching Service Module (CSM). Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module. Initiates recovery for a specified node.
Defaults
None.
Command Modes
Command History
Usage Guidelines
Use this command to initiate cluster recovery after a failure. If the output of the show nodes local command displays recovery pause in the node status column.
Examples
The following example initiates recovery for the SVC node 1 in slot 2.
switch# svc-config switch(svc)# node svc 2/1 recover
Related Commands
28-26
Chapter 28
Caching Services Module Commands node svc servicemode
node svc servicemode

To place a node in service mode, use the servicemode node svc command in SVC configuration mode. Use the no form of the command to remove a node from service mode. node svc slot-number/node-number servicemode
Syntax Description
node svc slot-number node-number servicemode
Specifies the nodes SVC interface Specifies the slot number of the Caching Service Module (CSM). Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module. Places a node in service mode.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following example enters the SVC configuration mode and places the specified node in service mode.
switch# svc-config switch(svc)# node svc 2/2 servicemode
Related Commands
28-27
Chapter 28 node svc upgrade
node svc upgrade

To upgrade the software on a specified SVC node, use the upgrade node svc command in SVC configuration mode. node svc slot-number/node-number url upgrade svc-system url
Syntax Description
node svc slot-number node-number upgrade svc-system url
Specifies the nodes SVC interface Specifies the slot number of the Caching Service Module (CSM). Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module. Upgrades the image on the specified node. Specifies the SVC image to be used. The new version of the software image is specified to the FTP:, SCP:, SFTP:, TFTP:, bootflash:, or slot0: directories
Defaults
None.
Command Modes
Command History
Usage Guidelines
This command is valid only if the node is in service mode or the node has been shutdown.
Examples
The following example enters the SVC configuration mode and displays all options in this mode.
switch# svc-config switch(svc)# node svc 2/1 upgrade svc-system ? bootflash: URI containing the system image for ftp: URI containing the system image for scp: URI containing the system image for sftp: URI containing the system image for slot0: URI containing the system image for tftp: URI containing the system image for
SVC SVC SVC SVC SVC SVC
28-28
Chapter 28
Caching Services Module Commands quorum
quorum
To set the quorum disk for a cluster, use the quorum command in the cluster configuration submode. cluster config cluster-name quorum disk [1 | 2 | 3] mdisk disk-id
Syntax Description
cluster config cluster-name quorum disk id mdisk mdisk-id
Provides access to cluster commands Places a previously created cluster in the cluster configuration submode. Configures one of three quorum disks for the specified cluster. The quorum ID ranges from 1 to 3. Specifies the MDisk ID (ranges form 1 to 4096).
Defaults
None.
Command Modes
Command History
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#). You can assign one of 3 possible quorum IDs in any desired order.
Examples
The following example enters the cluster configuration mode for SampleCluster and sets the quorum disk ID.
switch(svc)# cluster config SampleCluster switch(svc-cluster)# quorum disk 2 mdisk 1
28-29
Chapter 28 remote-copy
remote-copy
To create a synchronous copy of a specified VDisk or group of VDisks, use the remote-copy command in the cluster configuration submode. cluster config cluster-name remote-copy add rcopy-name [cluster rcluster-name] remote-copy rcopy-name map src-vdisk vdisk-name aux-vdisk vdisk-name
Syntax Description
cluster config cluster-name remote-copy add rcopy-name remote-copy cluster rcluster-name remote-copy rcopy-name map src-vdisk vdisk-name aux-vdisk vdisk-name
Provides access to cluster commands Places a previously created cluster in the cluster configuration submode. Creates a remote copy instance and assigns a name. Specifies the remote cluster name for the consistency group. Enters the remote-copy submode for an existing copy object. Establishes a relationship between the source and destination VDisks. Specifies the source VDisk for the copy creation. Specifies a VDisk in the remote copy cluster.
Defaults
None.
Command Modes
Command History
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#). The remote-copy submode prompt is switch(svc-cluster-remote-copy)#
Examples
The following example enters the cluster configuration mode for SampleCluster and creates a synchronous copy of a specified disk.
switch(svc)# cluster config SampleCluster switch(svc-cluster)# remote-copy add Rcopy1 switch(svc-cluster)# remote-copy r1 switch(svc-cluster-remote-copy)# ? Submode Commands: exit Exit from this mode
28-30
Chapter 28
Caching Services Module Commands remote-copy
map no Remote-copy map Negate a command or set its defaults
switch(svc-cluster-remote-copy)# map src-vdisk SrcVdisk1 aux-vdisk AuxVdisk1 switch(svc-cluster)# remote-copy add Rcopy1 cluster remote-cluster switch(svc-cluster)# remote-copy name Rcopy1
Related Commands
Command
Description
show cluster name remote-copy Displays configured remote-copy information for a specified cluster.
28-31
Chapter 28 show cluster flash-copy
show cluster flash-copy

To display configured FlashCopy information for a specified cluster, use the show cluster cluster-name flash-copy command. show cluster cluster-name flash-copy [fcopy-name]
Syntax Description
show cluster cluster-name flash-copy fcopy-name
Specifies a previously created cluster name. Displays FlashCopy relationships configured for the specified FlashCopy object.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following examples display configured cluster information.

switch(svc)# show cluster SampleCluster flash-copy ------------------------------------------------------------------------------name status ------------------------------------------------------------------------------fccstgrp0 idle_or_copied f2 idle_or_copied switch(svc)# show cluster SampleCluster flash-copy f2 Flash-copy mapping 1: src vdisk is v2 dest vdisk is v3 state is idle_or_copied copy rate is 50 progress 0% done
28-32
Chapter 28
Caching Services Module Commands show cluster host
show cluster host

To display configured host information for a specific cluster, use the show cluster cluster-name host command. show cluster cluster-name host [host-name | candidate]
Syntax Description
show cluster cluster-name host candidate host-name
Specifies a previously created cluster name. Displays information about hosts and host ports. Lists all candidates that are not part of this entity but are visible to the cluster. Displays information about the specified host.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following examples display configured cluster host information.

switch(svc)# show SampleCluster host ------------------------------------------------------------------------------name number of ports ------------------------------------------------------------------------------oasis15 1 Host1 2
switch(svc)# show SampleCluster host Host1 host Host1: Number of port is 2 Port WWN is 11:22:33:44:aa:bb:cc:dd Port WWN is 22:11:33:55:11:aa:bb:cc LUN 0: vdisk V1 LUN 10: vdisk V2 switch(svc)# show cluster SampleCluster host candidate ------------------------------------------------------------------------------id pwwn ------------------------------------------------------------------------------1 21:00:00:e0:8b:09:e7:04
28-33
Chapter 28 show cluster iogroup
show cluster iogroup

To display configured I/O group information for a specified cluster, use the show cluster cluster-name iogroup command. show cluster cluster-name iogroup [group-id]
Syntax Description
show cluster cluster-name iogroup group-id
Specifies a previously created cluster name. Identifies one of four I/O groups in the specified cluster. Specifies the iogroup ID (ranges from 1 to 4).
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following examples display configured cluster iogroup information.

switch(svc)# show SampleCluster iogroup ----------------------------------------------------------------------------ID NAME NODE-COUNT VLUN_COUNT ----------------------------------------------------------------------------1 Sampleio1 2 3 2 io_grp1 0 0 3 io_grp2 0 0 4 io_grp3 0 0 5 recovery_io_grp 0 0
Note
Only four IDs can be used, the fifth I/O group is internally created and is only used for cluster recovery.
switch(svc)# show SampleCluster iogroup id 2 Io group id 2: Node count is 0 Host LUN count is 0 Contains no nodes
28-34
Chapter 28
Caching Services Module Commands show cluster ip
show cluster ip
To displays configured ip information for a specified cluster, use the show cluster-name ip command. show cluster cluster-name ip
Syntax Description
show cluster cluster-name ip
Specifies a previously created cluster name. Displays the IP address of the specified cluster.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following example displays configured cluster ip information.

switch(svc)# show SampleCluster ip cluster ip address is 172.22.92.32
28-35
Chapter 28 show cluster mdisk
show cluster mdisk

To display configured MDisk information for a specified cluster, use the show cluster cluster-name mdisk command. show cluster cluster-name mdisk {candidate | id mdisk-id [extent]}
Syntax Description
show cluster cluster-name mdisk candidate id mdisk-id extent
Specifies a previously created cluster name. Displays MDisk specific information. Displays all MDisks that are not assigned to a group. Displays details of the specified MDisk ID. Displays information about the specified MDisks extent.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following examples display configured cluster MDisk information.

switch(svc)# show SampleCluster mdisk ------------------------------------------------------------------------------id nwwn mdisk-grp capacity status ------------------------------------------------------------------------------1 20:00:00:04:cf:e6:1b:5b mg1 68.37 GB online 2 20:00:00:04:cf:e6:e5:32 mg1 68.37 GB online 3 20:00:00:04:cf:e6:21:a2 mg1 68.37 GB online 4 20:00:00:04:cf:e6:e1:81 mg1 68.37 GB online 5 20:00:00:04:cf:e6:e4:df 68.37 GB online 6 20:00:00:04:cf:e6:1c:fb 68.37 GB online 7 20:00:00:04:cf:e6:1a:4c 68.37 GB online 8 20:00:00:04:cf:e6:e4:6b 68.37 GB online switch(svc)# show SampleCluster mdisk candidate ------------------------------------------------------------------------------id nwwn capacity ------------------------------------------------------------------------------5 20:00:00:04:cf:e6:e4:df 68.37 GB 6 20:00:00:04:cf:e6:1c:fb 68.37 GB 7 20:00:00:04:cf:e6:1a:4c 68.37 GB 8 20:00:00:04:cf:e6:e4:6b 68.37 GB switch(svc)# show cluster SampleCluster mdisk id 1 mdisk id 1 is online
28-36
Chapter 28
Caching Services Module Commands show cluster mdisk
Is member of mdisk-grp mg1 Controller node WWN is 20:00:00:04:cf:e6:e4:6b Controller port WWN is 22:00:00:04:cf:e6:e4:6b, LUN 00:00:00:00:00:00:00:00 Controller serial number is 3HZ0KZ8W Capacity is 68.37 GB Number of free extents is 2231 switch(svc)# show cluster SampleCluster mdisk id 1 extent ------------------------------------------------------------------------------vdisk number of extents ------------------------------------------------------------------------------v1 2144
28-37
Chapter 28 show cluster mdsik-grp
show cluster mdsik-grp

To display configured MDisk group information for a specified cluster, use the show cluster cluster-name mdisk-grp command. show cluster cluster-name mdisk-grp [grp-name]
Syntax Description
show cluster cluster-name mdisk-grp grp-name
Specifies a previously created cluster name. Displays information about a specified MDisk group.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following examples display configured cluster information for a MDisk group.
switch(svc)# show cluster SampleCluster mdisk-grp -------------------------------------------------------------------------------------name Capacity free extent number number status size(MB) of mdisks of vdisks -------------------------------------------------------------------------------------mg1 410.16 GB 309.16 GB 16 6 1 online switch(svc)# show cluster SampleCluster mdisk-grp mg1 mdisk-grp mg1 is online Total capacity is 410.16 GB Free capacity is 309.16 GB Extent size is 16 MB Number of mdisks is 6 Number of vdisks using this group is 1
28-38
Chapter 28
Caching Services Module Commands show cluster nodes
show cluster nodes

To display configured node information for a specified cluster, use the show cluster cluster-name nodes command. show cluster cluster-name nodes [candidate]
Syntax Description
show cluster cluster-name nodes candidate
Specifies a previously created cluster name. Displays information about nodes in this cluster. Lists all candidates that are not part of this entity but are visible to the cluster.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following example displays configured cluster information for a specified node.
switch(svc)# show cluster SampleCluster nodes Node node1 is online(3) Node WWN is 20:06:00:0b:be:57:73:42 Serial number is JAB072705JH Unique id is 01:00:07:27:30:35:4a:48 Node is in config mode Node is part of iogroup id 1 name io_grp0 Node node2 is online(3) Node WWN is 20:08:00:0b:be:57:73:42 Serial number is JAB076605JH Unique id is 01:00:07:66:30:35:4a:48 Node is in non config mode Node is part of iogroup id 1 name io_grp0 switch1(svc)# show cluster SampleCluster nodes candidate ----------------------------------------------------------------------------NODE NWWN ----------------------------------------------------------------------------switch1.2.1 20:06:00:05:30:00:8d:e0
28-39
Chapter 28 show cluster remote-copy
show cluster remote-copy

To display configured remote-copy information for a specified cluster, use the show cluster cluster-name remote-copy command. show cluster cluster-name remote-copy [rcopy-name]
Syntax Description
show cluster cluster-name remote-copy rcopy-name
Specifies a previously created cluster name. Displays remote copy relationships configured for a specified cluster. Displays the specified remote copy object.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following example displays configured cluster information for the specified copy instance.
switch(svc)# show cluster SampleCluster remote-copy r1 Remote-copy mapping 1: master cluster is SampleCluster master vdisk is v6 aux cluster is c1 aux vdisk is v7 status is inconsistent_stopped progress 0% done Remote-copy mapping 2: master cluster is SampleCluster master vdisk is v8 aux cluster is c1 aux vdisk is v9 status is inconsistent_stopped progress 0% done
28-40
Chapter 28
Caching Services Module Commands show cluster remote-copy-cluster
show cluster remote-copy-cluster

To display configured remote-copy partnership information for a specified cluster, use the show cluster cluster-name remote-copy-cluster command. show cluster cluster-name remote-copy-cluster [rcopy-name]
Syntax Description
show cluster cluster-name Specifies a previously created cluster name. remote-copy-cluster rcopy-name Displays remote copy relationships configured for a specified cluster. Displays the specified remote copy object.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following example displays configured cluster information for the specified copy instance.
switch(svc)# show cluster SampleCluster remote-copy-cluster ----------------------------------------------Cluster Local/remote Bandwidth ----------------------------------------------local-cluster local 10 remote-cluster remote 50
28-41
Chapter 28 show cluster status
show cluster status

To displays progress information for a specified cluster, use the show cluster cluster-name status command. show cluster cluster-name status [flash-copy fcopy-name | remote-copy rcopy-name]
Syntax Description
show cluster cluster-name status flash-copy fcopy-name remote-copy rcopy-name
Specifies a previously created cluster name. Displays the status of a upgrade or copy process. Displays FlashCopy relationships configured for the specified cluster. Displays the specified FlashCopy object. Displays remote copy relationships configured for a specified cluster. Displays the specified remote copy object.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following examples display configured cluster information.

switch(svc)# show cluster SampleCluster status flash-copy fc1 ------------------------------------------------------------------------------src vdisk dest vdisk progress ------------------------------------------------------------------------------v1 v2 100% done v3 v4 100% done switch(svc)# show cluster SampleCluster status remote-copy rc1 ------------------------------------------------------------------------------src vdisk aux vdisk progress ------------------------------------------------------------------------------v5 v6 100% done v7 v8 100% done
28-42
Chapter 28
Caching Services Module Commands show cluster vdisk
show cluster vdisk

To display configured VDisk information for a specified cluster, use the show cluster cluster-name vdisk command. show cluster cluster-name vdisk {vdisk-id [extent | mapped_hosts]}
Syntax Description
show cluster cluster-name vdisk vdisk-id extent mapped_hosts
Specifies a previously created cluster name. Displays configured VDisks in the cluster Displays details of the specified VDisk ID. Displays information about the specified MDisks extent. Displays information about which hosts are mapped to the specified VDisk.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following examples display configured cluster information for VDisks.

switch(svc)# show cluster SampleCluster vdisk v1 extent ------------------------------------------------------------------------------mdisk id number of extents ------------------------------------------------------------------------------1 2144 2 2144 3 2144 5 11 6 11 7 10 switch(svc)# show cluster SampleCluster vdisk v1 mapped_hosts ------------------------------------------------------------------------------host LUN ------------------------------------------------------------------------------oasis15 0
28-43
Chapter 28 show environment battery
show environment battery

To display status of a battery module for the Caching Services Module (CSM), use the show environment battery command. show environment battery module slot-number [detail]
Syntax Description
show environment battery module slot-number detail
Displays the hardware environment in any Cisco MDS 9000 Family switch. Displays the status of the battery in a CSM. Specifies the slot number of the CSM. Provides detailed information about the CSM battery status.
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was modified in Release 1.3(1).
Usage Guidelines
None.
Examples
The following example displays the current contents of the boot variable.
switch# show environment battery module 2 Battery 1: ---------Voltage : 10.343 V Current : 0.000 A Temperature : 23.7 C Current Capacity : 1571 mAHr Full Capacity : 2057 mAHr CySampleClustere Count : 3 Last conditioned in : Week 22 2003 Serial Num : AMB0722009C Battery 2: ---------Voltage : 10.596 V Current : 0.000 A Temperature : 26.6 C Current Capacity : 1701 mAHr Full Capacity : 2032 mAHr CySampleClustere Count : 6 Last conditioned in : Week 22 2003 Serial Num : AMB0722009R switch## show environment battery module 2 detail Battery 1:
28-44
Chapter 28
Caching Services Module Commands show environment battery
---------Voltage : 10.338 V Current : 0.000 A Temperature : 23.7 C Current Capacity : 1571 mAHr Full Capacity : 2057 mAHr Caching Capacity : 6463 MB CySampleClustere Count : 3 Last conditioned in : Week 22 2003 Serial Num : AMB0722009C EEPROM version : 1 Manufacturer Access Remaining Capacity Alarm Remaining Time Alarm Battery Mode AtRate AtRate Time To Full AtRate Time To Empty AtRate OK Temperature Voltage Current Average Current Max Error Relative State of Charge Absolute State of Charge Remaining Capacity Full Charge Capacity Run Time To Empty Average Time To Empty Average Time To Full Charging Current Charging Voltage Battery Status CySampleClustere Count Design Capacity Design Voltage Specification Info Manufacture Date Serial Number Manufacturer Name Device Name Device Chemistry Manufacturer Data Pack Status & Configuration VCELL4 VCELL3 VCELL2 VCELL1 ... : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 0x0 0xc8 0xa 0x6000 0x0 0xffff 0xffff 0x1 0xb97 0x2862 0xd 0x6 0x2 0x4c 0x4f 0x623 0x809 0xffff 0xffff 0x13f2 0x44c 0x3840 0xc0 : 0x3 0x7d0 0x2580 0x21 0x3037 0x0 0x430a 0x4207 0x4e04 0x7507 0x2020 0x0 0x0 0x0 0x0
28-45
Chapter 28 show interface svc
show interface svc

You can check the status of a SVC interface at any time by using the show interface svc command. show interface svc slot-number/node-number [brief | counters | description]
Syntax Description
interface range brief counters description svc slot-number node-number
Displays the interfaces in the specified range. Displays brief info of interface. Displays the interface counter information. Displays a description of interface. Displays the SAN Volume Controller (SVC) interface. Specifies the slot number of the Caching Service Module (CSM). Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module.
Defaults
None
Command Modes
EXEC
Command History
Usage Guidelines
None.
Examples
The following examples display configured SVC interface information.

switch# show interface svc 2/1 svc2/1 is up Node WWN is 10:00:00:00:00:00:00:00 Fabric WWN is 20:41:00:05:30:00:33:1e Target N-port WWN is 27:39:00:05:30:00:33:2a, vsan is 1, FCID is 0x010006 Initiator N-port WWN is 27:3a:00:05:30:00:33:2a, vsan is 1, FCID is 0x010007 Mgmt N-port WWN is 27:3b:00:05:30:00:33:2a, vsan is 1, FCID is 0x010008 5 minutes input rate 16 bits/sec, 2 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 7 frames input, 736 bytes 0 discards, 0 errors 3 frames output, 276 bytes 0 discards, 0 errors switch# show interface svc 8/1-2 svc8/1 is down (Administratively down) Node WWN is 23:34:00:05:30:00:00:02 Fabric WWN is 21:c1:00:05:30:00:00:00 Target N-port WWN is 23:2e:00:05:30:00:00:02, vsan is 1, FCID is 0x000000 Initiator N-port WWN is 23:2f:00:05:30:00:00:02, vsan is 1, FCID is 0x000000 Mgmt N-port WWN is 23:30:00:05:30:00:00:02, vsan is 1, FCID is 0x000000
28-46
Chapter 28
Caching Services Module Commands show interface svc
5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 0 frames input, 0 bytes 0 discards, 0 errors 0 frames output, 0 bytes 0 discards, 0 errors svc8/2 is up Node WWN is 23:35:00:05:30:00:00:02 Fabric WWN is 21:c2:00:05:30:00:00:00 Target N-port WWN is 23:31:00:05:30:00:00:02, vsan is 1, FCID is 0x650003 Initiator N-port WWN is 23:32:00:05:30:00:00:02, vsan is 1, FCID is 0x650004 Mgmt N-port WWN is 23:33:00:05:30:00:00:02, vsan is 1, FCID is 0x650005 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 3268061 frames input, 6602103068 bytes 0 discards, 2 errors 3208131 frames output, 6598470800 bytes 0 discards, 0 errors switch# show interface brief ------------------------------------------------------------------------------Interface Vsan Admin Admin Status FCOT Oper Oper Port Mode Trunk Mode Speed Channel Mode (Gbps) ------------------------------------------------------------------------------fc8/1 1 FX -fcotAbsent ---... fc8/32 1 FX -fcotAbsent ---------------------------------------------------------------------------------Interface Status Speed (Gbps) ------------------------------------------------------------------------------sup-fc0 up 1 ------------------------------------------------------------------------------Interface Status IP Address Speed MTU ------------------------------------------------------------------------------mgmt0 up 172.22.90.21/24 100 Mbps 1500 ------------------------------------------------------------------------------Interface Status ------------------------------------------------------------------------------svc2/1 down svc2/2 up svc4/1 up svc4/2 up switch# show interface svc 2/1 counters svc2/1 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 0 ios/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 0 ios/sec 272 frames input, 89764 bytes 39 input session management frames 19 plogi, 1 plogi_acc, 13 prli, 1 prli_acc 2 logo, 0 logo_acc, 0 prlo, 0 prlo_acc 3 abts, 0 ba_acc, 0 ls_rjt 28 input I/Os, 28 cmd complete, 0 cmd fail 24 reads, 4 writes 0 input errors 0 input discards FCP cmd errors 0 sess not up, 0 no resources, 0 bad frames 0 up layer rjt, 0 out of order, 0 proc unexp exch st 0 drop unexp exch st, 0 no exch match FCP Xrdy errors
28-47
Chapter 28 show interface svc
0 sess not up, 0 no resources, 0 bad frames 0 up layer rjt, 0 out of order, 0 proc unexp exch st 0 drop unexp exch st, 0 no exch match FCP status errors 0 sess not up, 0 no resources, 0 bad frames 0 up layer rjt, 0 out of order, 0 proc unexp exch st 0 drop unexp exch st, 0 no exch match FCP Data errors 0 sess not up, 0 no resources, 0 bad frames 0 up layer rjt, 0 out of order, 0 proc unexp exch st 0 drop unexp exch st, 0 no exch match 0 Incoming Aborts 232 frames output, 84176 bytes 35 output session management frames 6 plogi, 13 plogi_acc, 1 prli, 12 prli_acc 0 logo, 0 logo_acc, 0 prlo, 0 prlo_acc 1 abts, 2 ba_acc, 0 ls_rjt 103 out I/Os, 103 cmd complete, 0 cmd fail 63 reads, 4 writes 0 output errors 0 output discards 0 out ls aborts LS requests while sess not up 0 cmds 0 data xfers 0 status xfers 0 ds xfers switch# show interface svc 4/2 description ------------------------------------------------------------------------------Interface Description ------------------------------------------------------------------------------svc4/2 SampleInt1
28-48
Chapter 28
Caching Services Module Commands show nodes
show nodes
To displays configured information for the CSM, use the show svc command. show nodes {local [detail] | svc slot_number/node-number | version}
Syntax Description
show nodes local detail svc slot-number node-number version
Displays information about the specified nodes. Displays SVC nodes in the switch. Displays detailed node information. Displays node information specific to the SVC interface. Specifies the slot number of the Caching Service Module (CSM). Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module. Displays software version information for each node.
Defaults
None.
Command Modes
Command History
Usage Guidelines
None.
Examples
The following example display configured SVC information and statistics.

switch(svc)# show nodes local detail svc2/1: Is a config node for cluster SampleCluster cluster Status is active Node Status is active svc2/2: Is member of cluster SampleCluster cluster Status is active Node Status is active switch(svc)# show nodes ? local Show nodes in the switch svc SVC Interface version Show node sw versions in the switch <cr> Carriage Return switch(svc)# show nodes svc 2/2 svc2/2: Is not a member of any cluster Cluster Status is unconfigured
28-49
Chapter 28 show nodes
Node Status is free switch(svc)# show nodes version -----------------------------------------------------Node sw version state -----------------------------------------------------svc2/1 1.3(1) Runtime code (5) svc2/2 1.3(1) Runtime code (5)
Related Commands
Command svc config
Description Configures SVC nodes.
28-50
Chapter 28
Caching Services Module Commands show svc
show svc
To displays configured information for the CSM, use the show svc command. show svc port svc slot_number/node-number [detail | initiator | mgmt | target [detail | vsan vsan-id]] | session [detail | initiator | mgmt | peer-wwn pwwn-id | target [detail | vsan vsan-id]] | stats xipc [interface svc slot_number/node-number] | [module slot-number]
Syntax Description
show svc port svc slot-number node-number detail initiator mgmt target vsan vsan-id session peer-pwwn pwwn-id stats module slot-number
Displays configured SVC information. Displays N-port specific SVC information. Specifies the new interface to be a SVC interface. Specifies the slot number of the Caching Service Module (CSM). Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module. Displays detailed information for all N ports Displays a SVC node as an initiator in the specified VSAN. Displays a SVC node as a management node in the specified VSAN. Displays a SVC node as a target in the specified VSAN. Specifies the VSAN ID ranging from 1 to 4093. Displays information specific to the SVC session. Specifies the port WWN of the target or host, with the format hh:hh:hh:hh:hh:hh:hh:hh. Displays SVC statistical information generally used for debugging. Specifies the slot number containing the CSM.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
The following examples display configured SVC information and statistics.

switch# show svc session svc 2/1 svc2/1: Target N-port WWN is 21:00:00:05:30:00:8d:e0, vsan is 2, FCID is 0x610100 pWWN 21:00:00:e0:8b:09:f0:04, nWWN 20:00:00:e0:8b:09:f0:04, FCID 0x610000 Initiator N-port WWN is 20:01:00:05:30:00:8d:e0, vsan is 1, FCID is 0xec0100
28-51
Chapter 28 show svc
pWWN 22:00:00:04:cf:e6:e4:6b, nWWN 20:00:00:04:cf:e6:e4:6b, FCID 0xec00d4 pWWN 22:00:00:04:cf:e6:1a:4c, nWWN 20:00:00:04:cf:e6:1a:4c, FCID 0xec00d5 pWWN 22:00:00:04:cf:e6:1c:fb, nWWN 20:00:00:04:cf:e6:1c:fb, FCID 0xec00d6 pWWN 22:00:00:04:cf:e6:e1:81, nWWN 20:00:00:04:cf:e6:e1:81, FCID 0xec00d9 pWWN 22:00:00:04:cf:e6:e4:df, nWWN 20:00:00:04:cf:e6:e4:df, FCID 0xec00da pWWN 22:00:00:04:cf:e6:21:a2, nWWN 20:00:00:04:cf:e6:21:a2, FCID 0xec00dc pWWN 22:00:00:04:cf:e6:e5:32, nWWN 20:00:00:04:cf:e6:e5:32, FCID 0xec00e0 pWWN 22:00:00:04:cf:e6:1b:5b, nWWN 20:00:00:04:cf:e6:1b:5b, FCID 0xec00e1 Mgmt N-port WWN is 21:02:00:05:30:00:8d:e0, vsan is 3, FCID is 0x7a0000 pWWN 21:03:00:05:30:00:8d:e0, nWWN 20:07:00:05:30:00:8d:e0, FCID 0x7a0001 switch# show svc session svc 2/1 peer-pwwn 22:00:00:04:cf:e6:e4:6b detail svc2/1: Initiator N-port WWN is 20:01:00:05:30:00:8d:e0, vsan is 1, FCID is 0xec0102 pWWN 22:00:00:04:cf:e6:e4:6b, nWWN 20:00:00:04:cf:e6:e4:6b, FCID 0xec00d4 47 frames input, 920 data bytes 2 ELS pkts, 0 BLS pkts 0 FCP commands, 0 FCP xfer ready 20 FCP data frames, 25 FCP status 0 FCP overrun, 15 FCP underrun 0 aborts, 0 bad FC2 drops 0 data excess 27 frames output, 0 data bytes 2 ELS pkts, 0 BLS pkts 25 FCP commands, 0 FCP xfer ready 0 FCP data frames, 0 FCP status 0 aborts 0 open exchanges switch# show svc port svc 2/1 svc2/1: Target N-port in vsan 2 is up Port WWN is 21:00:00:05:30:00:8d:e0, FCID is 0x610101 Initiator N-port in vsan 1 is up Port WWN is 20:01:00:05:30:00:8d:e0, FCID is 0xec0102 Mgmt N-port in vsan 1 is up Port WWN is 20:02:00:05:30:00:8d:e0, FCID is 0xec0103 switch# show svc port svc 2/1 target detail svc2/1: Target N-port in vsan 1 is up Port WWN is 27:39:00:05:30:00:33:2a, FCID is 0x010006 0 sessions, 0 closed, 0 in transition 5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 0 ios/sec 5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec 0 ios/sec 9 frames input, 1064 bytes 0 input session management frames 0 plogi, 0 prli 0 logo, 0 logo_acc 0 prlo, 0 prlo_acc 0 abts, 0 ls_rjt 0 input I/Os, 0 cmd complete, 0 cmd fail 0 reads, 0 writes 0 input errors 0 input discards 5 frames output, 388 bytes 0 output session management frames 0 plogi_acc, 0 prli_acc 0 logo, 0 logo_acc 0 prlo, 0 prlo_acc 0 ba_acc, 0 ls_rjt 0 output I/Os, 0 cmd complete, 0 cmd fail 0 output errors 0 output discards
28-52
Chapter 28
Caching Services Module Commands show svc
switch# show svc session svc 2/1 peer-pwwn 27:46:00:05:30:00:33:2a detail svc2/1: Mgmt N-port WWN is 27:3b:00:05:30:00:33:2a, vsan is 1, FCID is 0x010008 pWWN 27:46:00:05:30:00:33:2a, nWWN 27:48:00:05:30:00:33:2a, FCID 0x010011 19 frames input, 16517 data bytes 2 ELS pkts, 0 BLS pkts 3 FCP commands, 1 FCP xfer ready 10 FCP data frames, 3 FCP status 0 FCP overrun, 2 FCP underrun 0 aborts, 0 bad FC2 drops 0 data excess 19 frames output, 16520 data bytes 2 ELS pkts, 0 BLS pkts 3 FCP commands, 1 FCP xfer ready 10 FCP data frames, 3 FCP status 0 aborts 0 open exchanges FCP Error Stats FCP cmd errors 0 sess not up, 0 no resources, 0 bad frames 0 up layer rjt, 0 out of order, 0 proc unexp exch st 0 drop unexp exch st, 0 no exch match FCP Xfer Rdy errors 0 sess not up, 0 no resources, 0 bad frames 0 up layer rjt, 0 out of order, 0 proc unexp exch st 0 drop unexp exch st, 0 no exch match FCP Status errors 0 sess not up, 0 no resources, 0 bad frames 0 up layer rjt, 0 out of order, 0 proc unexp exch st 0 drop unexp exch st, 0 no exch match FCP Data errors 0 sess not up, 0 no resources, 0 bad frames 0 up layer rjt, 0 out of order, 0 proc unexp exch st 0 drop unexp exch st, 0 no exch match
28-53
Chapter 28 svc-config
svc-config
To perform SAN Volume Controller (SVC) configurations, use the svc-config command. svc-config
Syntax Description
svc-config cluster node show
Enters the SVC configuration mode. Provides access to cluster commands. Provides access to node commands. Displays configured SVC information for the specified node.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
None.
Examples
switch# svc-config switch-sw6(svc)# ? Submode Commands: cluster Cluster commands exit Exit from this mode no Negate a command or set its defaults node Node commands show Show
28-54
Chapter 28
Caching Services Module Commands svc-ibmcli
svc-ibmcli
To perform SAN Volume Controller (SVC) configurations by using IBMs CLI, use the svc-ibmcli command. svc-ibmcli {cluster-name cluster-name [IBM-CLI-command] | node svc slot-number/node-number [IBM-CLI-command]}
Syntax Description
svc-ibmcli cluster-name cluster-name node svc slot-number node-number IBM-CLI-command
Enters the IBM CLI configuration mode. Specifies a new cluster. Specifies a cluster name. Specifies a node in the SVC interface. Specifies the slot number of the Caching Service Module (CSM). Specifies the node number of the SVC instance running on the CSM. This number ranges from 1 to 2 nodes per module. Specifies the IBM TotalStorage command to be executed
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
When you enter the IBM TotalStorage shell, all future commands are interpreted directly by this shell. Type exit to return to the Cisco MDS switch prompt.
Examples
switch# svc-ibmcli cluster-name SampleCluster Attaching to config node for cluster SampleCluster To exit type 'exit', to abort type '$.' IBM_svc:admin> switch# svc-ibmcli node svc 2/1 Attaching to node 2/1 To exit type 'exit', to abort type '$.' IBM_svc:admin>
28-55
Chapter 28 svc-purge-wwn module
svc-purge-wwn module
To remove all configured WWNs for the CSM from the running configuration, use the svc-purge-wwn module command. svc-purge-wwn module module-number
Syntax Description
svc-purge-wwn
Purges the WWN for the CSM.
module module-number Specifies the slot number for the CSM.
Defaults
None.
Command Modes
EXEC mode.
Command History
Usage Guidelines
This command also purges all system allocated pWWNs and nWWNs from the system and will never be used again (by the system or by SVC interfaces). New system values will be allocated for all pWWN/nWWNs for the module.
Examples
switch# svc purge-wwn module 2 !!!WARNING! This command will purge all SVC system allocated WWNs for the specified module. These WWNs will be lost. All user configured WWNs will be removed from the running-config, but not from the startup-config. This operation can take a long time. Other CLI commands on the system may be stopped while this operation is in progress. Are you sure you want to do this? [Y/N] [N] y switch#
28-56
Chapter 28
Caching Services Module Commands vdisk
vdisk
To create a new VDisk or access a new VDisk, use the vdisk command in the cluster configuration submode. cluster config cluster-name vdisk add vdisk-name iogroup group-id mdisk-grp grp-name capacity number | import [clean | mdisk-list | preferred-node | sequential] vdisk name vdisk-name -> expand [capacity | extent mdisk disk-id offset number] | io-throttle number [MB] | iogroup | shrink
Syntax Description
cluster config cluster-name vdisk add vdisk-name iogroup group-id mdisk-grp grp-name capacity number import clean mdisk-list preferred-node sequential vdisk vdisk-name expand capacity extent offset number io-throttle MB shrink
Provides access to cluster commands Places a previously created cluster in the cluster configuration submode. Creates a VDisk of the specified name. Identifies one of four I/O groups in the specified cluster. The ID ranges from 1 to 4. The I/O for the VDisk is serviced by node belonging to that I/O group. Specifies an existing MDisk group from which the VDisk storage originates. Configures the size of this VDisk. Provides a range from 0- 1677215 Gigabytes. Imports a previously unmanaged disk that contains SVC virtualization data. Clears all data in the VDisk. Specifies a list of MDisks. All disks in this list must be part of the MDisk group specifies the preferred node within the two nodes in this group to send I/Os for this VDisk Specifies a sequential virtualization policy. If this option is not specified, the striped (default) virtualization policy is used. Enters the VDisk submode of an existing VDisk. Expands the MDisk capacity. Expands the MDisk by a single extent. Offsets the extent. Limits the amount of I/Os allowed for this VDisk. If MB is not specified, the unit is calculated in I/Os per second. Specifies the I/O throttling in Megabytes. Shrinks the capacity of the VDisk as specified.
Defaults
None.
Command Modes
28-57
Chapter 28 vdisk
Usage Guidelines
The cluster configuration submode prompt is (switch(svc-cluster)#). The VDisk submode prompt is switch (svc-cluster-vdisk)# Extents are allowed from all MDisks in the list
Examples
The following example enters the cluster configuration mode for SampleCluster and --switch(svc)# cluster config SampleCluster switch(svc-cluster)# vdisk add Vdisk1 iogroup 1 mdisk-grp Mdisk1 ? capacity Vdisk add name iogroup mdisk-grp import Vdisk add import switch(svc-cluster)# vdisk add Vdisk1 iogroup 1 mdisk-grp Mdisk1 capacity ? <0-2147483647> Enter the capacity switch(svc-cluster)# vdisk add Vdisk1 iogroup 1 mdisk-grp Mdisk1 capacity 5000 ? gb Vdisk add name iogroup mdisk-grp capacity mb Vdisk add name iogroup mdisk-grp capacity pb Vdisk add name iogroup mdisk-grp capacity tb Vdisk add name iogroup mdisk-grp capacity switch(svc-cluster)# vdisk add Vdisk1 iogroup 1 mdisk-grp Mdisk1 capacity 5000 gb ? clean Vdisk add clean mdisk-list Vdisk add mdisk-list preferred-node Vdisk add sequential mdisk sequential Vdisk add sequential <cr> Carriage Return switch(svc-cluster)# vdisk add VDISK1 iogroup 1 mdisk-grp Mdisk1 capacity 0 gb switch(svc-cluster)# vdisk VDISK1 switch(svc-cluster-vdisk)# ? Submode Commands: exit Exit from this mode expand Expand io-throttle Io throttle iogroup Move vdisk to iogroup no Negate a command or set its defaults shrink Shrink capacity switch(svc-cluster-vdisk)# expand ? capacity Expand capacity extent Expand extent switch(svc-cluster-vdisk)# io-throttle 0 switch(svc-cluster-vdisk)# shrink capacity 1 ? gb Expand capacity mb Expand capacity pb Expand capacity tb Expand capacity switch(svc-cluster-vdisk)# exit switch(svc)# show cluster SampleCluster vdisk ------------------------------------------------------------------------------name capacity iogroup mdisk-grp name policy status -------------------------------------------------------------------------------
28-58
Chapter 28
Caching Services Module Commands vdisk
Vdisk1 Vdisk2 100.00 GB 50.00 GB 1 1 Group1 Group2 striped striped online online
switch(svc)# show cluster SampleCluster vdisk Vdisk1 vdisk Vdisk1 is online Capacity is 100.00 GB Using storage from mdisk-grp Group1 Processed by io group 1 Virtualization policy is striped Preferred node is 2 switch(svc)# show cluster SampleCluster vdisk Vdisk1 extent ------------------------------------------------------------------------------mdisk id number of extents ------------------------------------------------------------------------------1 2134 2 2133 3 2133 switch(svc)# show cluster SampleCluster vdisk Vdisk1 mapped_hosts ------------------------------------------------------------------------------host LUN ------------------------------------------------------------------------------Host1 0
Related Commands
Command show cluster name vdisk
Description Displays configured vdisk information for a specified cluster.
28-59
Chapter 28 vdisk
28-60

Command Book

Uploaded by

Copyright:

Available Formats

Command Book

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Command Book

Uploaded by

Copyright:

Available Formats

S e n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o m .

Cisco MDS 9000 Family Command Reference, Release 2.x

Text Part Number: OL-6970-03

Document Conventions Related Documentation

1-1 1-2 1-3

About the Switch Prompt

About the CLI Command Modes

Using Valid Formats and Ranges

Cisco MDS 9000 Family Command Reference

OL-6970-03, Cisco MDS SAN-OS Release 2.x

2-1 2-2 2-3 2-4 2-6 2-7

aaa accounting logsize aaa accounting default aaa authentication login

active equals saved

attach module attribute qos

B Commands banner motd boot bport

4-1 4-2 4-4

cfs distribute cimserver class

channel mode active

clear accounting log clear arp-cache clear cdp clear cores

clear callhome session

clear counters (EXEC mode)

clear ip access-list counters clear ivr zone database

clear port-security clear processes log

Cisco MDS 9000 Family Command Reference

OL-6970-03, Cisco MDS SAN-OS Release 2.x

clear role session clear rscn statistics

clear scheduler logfile clear screen clear ssh hosts

clear scsi-flow statistics

code-page clock set code-page commit contract-id copy

configure terminal copy licenses

crypto ike domain ipsec rekey sa

crypto map domain ipsec (interface configuration submode)

5-6 5-8 5-10 5-11 5-12 5-13 5-14

device-alias import fcalias

discover custom-list discover scsi-target distribute do

dpvm abort dpvm activate

dpvm auto-learn dpvm commit dpvm database

5-27 5-29 5-30 5-31

Cisco MDS 9000 Family Command Reference

OL-6970-03, Cisco MDS SAN-OS Release 2.x

debug hardware arbiter

debug system health

Cisco MDS 9000 Family Command Reference

OL-6970-03, Cisco MDS SAN-OS Release 2.x

E Commands enable end exit

8-1 8-2 8-3 8-4 8-5

fcdomain rcf-reject fcdroplatency fcflow stats fcid-allocation fcid-last-byte

fcinterop fcid-allocation fcinterop loop-monitor fcip enable fcip profile

fcns proxy-port fcping fcroute

fcns reject-duplicate-pwwn vsan

fcsp dhchap fcsp enable fcsp timeout fctimer

fctimer abort fctimer commit

8-45 8-46 8-47

fctimer distribute fctrace fc-tunnel ficon swap

ficon vsan (EXEC mode) file find format fspf cost

ficon vsan (configuration mode)

fspf config vsan

fspf dead-interval fspf enable vsan fspf hello-interval fspf passive

8-60 8-61 8-62

G Commands group gzip gunzip