Академический Документы
Профессиональный Документы
Культура Документы
com
Americas 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 527-0883
Cisco MDS 9000 Family Command
Reference, Release 4.x
Cisco MDS NX-OS Release 4.2(7a)
August 2010
Text Part Number: OL-19352-02
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
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.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at
www.cisco.com/go/trademarks. Third party trademarks mentioned 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. (1005R)
Cisco MDS 9000 Family Command Reference
2010 Cisco Systems, Inc. All rights reserved.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
iii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
C O N T E N T S
New and Changed Information xxxiii
Preface lxv
Audience lxv
Organization lxv
Document Conventions lxvi
Related Documentation 1-lxvii
Release Notes 1-lxvii
Regulatory Compliance and Safety Information 1-lxvii
Compatibility Information 1-lxvii
Hardware Installation 1-lxviii
Software Installation and Upgrade 1-lxviii
Cisco NX-OS 1-lxviii
Cisco Fabric Manager 1-lxviii
Command-Line Interface 1-lxix
Intelligent Storage Networking Services Configuration Guides 1-lxix
Troubleshooting and Reference 1-lxix
CHAP T E R 1 CLI Overview 1-1
About the Switch Prompt 1-2
About the CLI Command Modes 1-3
Understanding CLI Command Hierarchy 1-4
EXEC Mode Options 1-5
EXEC Mode Commands for the Cisco MDS 9000 Family 1-5
EXEC Mode Commands for the Cisco Fabric Switch for HP c-Class BladeSystem and the Cisco
Fabric Switch for IBM BladeCenter 1-6
Configuration Mode Options 1-7
Configuration Mode Commands for the Cisco MDS 9000 Family 1-7
Configuration Mode Commands for the Cisco Fabric Switch for HP c-Class BladeSystem and the
Cisco Fabric Switch for IBM BladeCenter 1-9
Navigating Through CLI Commands 1-13
Getting Help 1-13
Command Completion 1-13
Using the no and Default Forms of Commands 1-14
Port Names and Port Mapping 1-14
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
iv
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Entering CLI Commands 1-16
Viewing Switch Configurations 1-16
Saving a Configuration 1-19
Clearing a Configuration 1-19
Searching and Filtering CLI Output 1-19
Multiple Filter Commands 1-20
Searching and Filtering CLI Output Examples 1-21
Displaying Users 1-24
Sending Messages to Users 1-24
Using the ping Command 1-24
Using traceroute 1-24
Setting the Switchs Shell Timeout 1-25
Displaying VTY Sessions 1-25
Clearing VTY Sessions 1-26
Setting the Switchs Terminal Timeout 1-26
Setting the Switchs Terminal Type 1-26
Setting the Switchs Terminal Length 1-26
Setting the Switchs Terminal Width 1-26
Displaying Terminal Settings 1-27
Using CLI Variables 1-27
User-Defined CLI Session Variables 1-27
User-Defined CLI Persistent Variables 1-28
System Defined Variables 1-29
Using Command Aliases 1-29
Defining Command Aliases 1-30
About Flash Devices 1-30
Internal bootflash: 1-31
External CompactFlash (Slot0) 1-31
Formatting Flash Disks and File Systems 1-31
Initializing bootflash: 1-32
Formatting Slot0: 1-32
Using the File System 1-32
Setting the Current Directory 1-33
Displaying the Current Directory 1-33
Listing the Files in a Directory 1-33
Creating a New Directory 1-34
Deleting an Existing Directory 1-34
Moving Files 1-34
Copying Files 1-35
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
v
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Deleting Files 1-35
Displaying File Contents 1-35
Saving Command Output to a File 1-36
Directing show Command Output to a File 1-36
Compressing and Uncompressing Files 1-36
Displaying the Last Line in a File 1-37
Executing Commands Specified in a Script 1-37
Setting the Delay Time 1-38
Role-Based CLI 1-38
Using Valid Formats and Ranges 1-39
Using Debug Commands 1-40
Generating debug Command Output 1-41
Redirecting debug and Error Message Output 1-41
Enabling Message Logging 1-42
Setting the Message Logging Levels 1-42
Limiting the Types of Logging Messages Sent to the Console 1-43
Logging Messages to an Internal Buffer 1-43
Limiting the Types of Logging Messages Sent to Another Monitor 1-43
Logging Messages to a UNIX Syslog Server 1-44
Limiting Messages to a Syslog Server 1-44
CHAP T E R 2 A Commands 2-1
aaa accounting logsize 2-2
aaa accounting default 2-3
aaa authentication dhchap default 2-4
aaa authentication iscsi default 2-5
aaa authentication login 2-6
aaa authentication login ascii-authentication 2-8
aaa authentication login mschapv2 enable 2-9
aaa authorization 2-10
aaa group server 2-12
abort 2-14
action cli 2-15
action counter 2-16
action event-default 2-18
action exception log 2-20
action forceshut 2-21
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
vi
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
action overbudgetshut 2-22
action policy-default 2-23
action reload 2-24
action snmp-trap 2-25
action syslog 2-26
active equals saved 2-28
alert-group 2-29
arp 2-31
attach 2-32
attachpriv 2-33
attributes (DMM job configuration submode) 2-34
attribute failover auto 2-35
attribute qos 2-36
authentication 2-37
autonomous-fabric-id (IVR topology database configuration) 2-39
autonomous-fabric-id (IVR service group configuration) 2-41
autonomous-fabric-id database 2-43
auto-volgrp 2-44
CHAP T E R 3 B Commands 3-1
banner motd 3-2
boot 3-4
bport 3-6
bport-keepalive 3-7
broadcast 3-8
CHAP T E R 4 C Commands 4-1
callhome 4-2
callhome test 4-4
cd 4-5
cdp 4-6
cfs distribute 4-8
cfs ipv4 distribute 4-10
cfs ipv4 mcast-address 4-12
cfs ipv6 distribute 4-14
cfs ipv6 mcast-address 4-16
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
vii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
cfs region 4-18
cfs static-peers 4-20
channel mode active 4-21
channel-group 4-22
cimserver 4-23
cimserver clearcertificate 4-25
cimserver loglevel 4-26
class 4-27
clear accounting log 4-29
clear arp-cache 4-30
clear asic-cnt 4-31
clear callhome session 4-33
clear cdp 4-34
clear cores 4-35
clear counters (EXEC mode) 4-36
clear counters (SAN extension N port configuration mode) 4-37
clear crypto ike domain ipsec sa 4-38
clear crypto sa domain ipsec 4-39
clear debug-logfile 4-40
clear device-alias 4-41
clear dpvm 4-42
clear dpvm merge statistics 4-43
clear fabric-binding statistics 4-44
clear fcanalyzer 4-45
clear fcflow stats 4-46
clear fcns statistics 4-47
clear fcs statistics 4-48
clear fctimer session 4-49
clear fc-redirect config 4-50
clear fc-redirect decommission-switch 4-51
clear ficon 4-53
clear fspf counters 4-54
clear install failure-reason 4-55
clear ip access-list counters 4-56
clear ips arp 4-57
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
viii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
clear ips stats 4-58
clear ips stats fabric interface 4-59
clear ipv6 access-list 4-60
clear ipv6 neighbors 4-61
clear islb session 4-62
clear ivr fcdomain database 4-63
clear ivr service-group database 4-64
clear ivr zone database 4-65
clear license 4-66
clear line 4-67
clear logging 4-68
clear ntp 4-69
clear port-security 4-70
clear processes log 4-72
clear qos statistics 4-73
clear radius-server statistics 4-74
clear radius session 4-75
clear rlir 4-76
clear rmon alarms 4-78
clear rmon all-alarms 4-79
clear rmon hcalarms 4-80
clear rmon log 4-81
clear role session 4-82
clear rscn session vsan 4-83
clear rscn statistics 4-84
clear santap module 4-85
clear ssm-nvram santap module 4-86
clear scheduler logfile 4-87
clear screen 4-88
clear scsi-flow statistics 4-89
clear sdv 4-90
clear snmp hostconfig 4-91
clear ssh hosts 4-92
clear system reset-reason 4-93
clear tacacs-server statistics 4-94
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
ix
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
clear tacacs+ session 4-95
clear tlport alpa-cache 4-96
clear user 4-97
clear vrrp 4-98
clear zone 4-99
cli alias name 4-100
cli var name (EXEC) 4-102
cli var name (configuration) 4-104
clock 4-105
clock set 4-107
cloud discover 4-108
cloud discovery 4-109
cloud-discovery enable 4-111
cluster 4-112
code-page 4-113
commit 4-115
commit (DMM job configuration submode) 4-116
contract-id 4-117
configure terminal 4-118
copy 4-119
copy licenses 4-122
copy ssm-nvram standby-sup 4-123
counter lr-rx 4-124
counter timeout-discards 4-126
counter tx-credit-not-available 4-128
counter credit-loss-reco 4-130
crypto ca authenticate 4-132
crypto ca crl request 4-134
crypto ca enroll 4-136
crypto ca export 4-138
crypto ca import 4-140
crypto ca test verify 4-142
crypto ca trustpoint 4-143
crypto global domain ipsec security-association lifetime 4-145
crypto ike domain ipsec 4-146
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
x
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
crypto ike domain ipsec rekey sa 4-147
crypto ike enable 4-148
crypto ipsec enable 4-149
crypto key generate rsa 4-150
crypto key zeroize rsa 4-152
crypto map domain ipsec (configuration mode) 4-154
crypto map domain ipsec (interface configuration submode) 4-156
crypto transform-set domain ipsec 4-157
customer-id 4-159
CHAP T E R 5 D Commands 5-1
data-pattern-file 5-2
deadtime (radius group configuration) 5-3
deadtime (tacacs+ group configuration) 5-4
delete 5-5
delete ca-certificate 5-7
delete certificate 5-8
delete crl 5-10
deny (IPv6-ACL configuration) 5-11
description 5-14
destination interface 5-15
destination-profile 5-17
device-alias (IVR fcdomain database configuration submode) 5-20
device-alias (SDV virtual device configuration submode) 5-21
device-alias abort 5-22
device-alias commit 5-23
device-alias database 5-24
device-alias distribute 5-25
device-alias import fcalias 5-26
device-alias mode enhanced 5-27
device-alias name 5-29
dir 5-30
disable 5-32
discover 5-33
discover custom-list 5-34
discover scsi-target 5-35
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xi
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
distribute 5-37
dmm module 5-38
dmm module job 5-40
do 5-42
dpvm abort 5-44
dpvm activate 5-45
dpvm auto-learn 5-46
dpvm commit 5-48
dpvm database 5-49
dpvm database copy active 5-51
dpvm database diff 5-52
dpvm distribute 5-54
dpvm enable 5-55
dpvm overwrite-duplicate-pwwn 5-56
dscp 5-57
duplicate-message throttle 5-58
CHAP T E R 6 Debug Commands 6-1
debug aaa 6-2
debug all 6-4
debug biosd 6-5
debug bootvar 6-6
debug callhome 6-7
debug cert-enroll 6-9
debug cdp 6-11
debug cfs 6-13
debug cimserver 6-15
debug cloud 6-16
debug core 6-18
debug device-alias 6-19
debug dpvm 6-21
debug dstats 6-23
debug ethport 6-24
debug exceptionlog 6-26
debug fabric-binding 6-27
debug fc-tunnel 6-29
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
debug fc2 6-31
debug fc2d 6-33
debug fcc 6-35
debug fcdomain 6-37
debug fcfwd 6-39
debug fcns 6-40
debug fcs 6-42
debug fcsp-mgr 6-44
debug fdmi 6-46
debug ficon 6-48
debug flogi 6-50
debug fm 6-52
debug fspf 6-53
debug hardware arbiter 6-55
debug idehsd 6-56
debug ike 6-57
debug ilc_helper 6-58
debug ipacl 6-59
debug ipconf 6-60
debug ipfc 6-61
debug ips 6-62
debug ipsec 6-64
debug isns 6-66
debug ivr 6-68
debug klm 6-70
debug license 6-72
debug logfile 6-73
debug mcast 6-75
debug mip 6-77
debug module 6-78
debug ntp 6-79
debug npv 6-80
debug obfl 6-82
debug platform 6-83
debug plog 6-85
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xiii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
debug port 6-86
debug port-channel 6-88
debug port-resources 6-89
debug qos 6-91
debug radius 6-92
debug rd-reg 6-94
debug rdl errors 6-95
debug rib 6-96
debug rlir 6-97
debug rscn 6-98
debug san-ext-tuner 6-99
debug scsi-flow 6-101
debug scsi-target 6-103
debug sdv 6-104
debug security 6-106
debug sensor 6-107
debug sme 6-108
debug snmp 6-110
debug span 6-112
debug system health 6-114
debug tacacs+ 6-116
debug tcap 6-118
debug tlport 6-119
debug ttyd 6-120
debug vni 6-121
debug vrrp 6-122
debug vsan 6-124
debug wr-reg 6-126
debug wwn 6-127
debug xbar 6-129
debug xbar_driver 6-131
debug xbc 6-132
debug zone 6-133
CHAP T E R 7 E Commands 7-1
egress-sa 7-2
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xiv
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
email-contact 7-3
enable 7-4
encryption 7-5
end 7-6
enrollment terminal 7-7
errdisable detect cause link-down 7-8
errdisable detect cause bit-errors 7-10
errdisable detect cause credit-loss 7-12
errdisable detect cause link-reset 7-14
errdisable detect cause signal-loss 7-16
errdisable detect cause sync-loss 7-18
errdisable detect cause trustsec-violation 7-20
event 7-22
event manager applet 7-27
event manager policy 7-28
event manager environment 7-29
exit 7-30
CHAP T E R 8 F Commands 8-1
fabric 8-2
fabric-binding activate 8-3
fabric-binding database copy 8-5
fabric-binding database diff 8-6
fabric-binding database vsan 8-7
fabric-binding enable 8-9
fabric-membership 8-10
fcalias clone 8-11
fcalias name 8-12
fcalias rename 8-13
fcanalyzer local 8-14
fcanalyzer remote 8-19
fcc enable 8-20
fcc priority 8-21
fcdomain 8-22
fcdomain abort vsan 8-24
fcdomain commit vsan 8-25
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xv
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
fcdomain distribute 8-26
fcdomain rcf-reject 8-27
fcdroplatency 8-28
fcflow stats 8-30
fcid-allocation 8-32
fcid-last-byte 8-34
fcinterop fcid-allocation 8-35
fcinterop loop-monitor 8-36
fcip enable 8-37
fcip profile 8-38
fcns proxy-port 8-39
fcns reject-duplicate-pwwn vsan 8-40
fcping 8-41
fc-redirect version2 enable 8-43
fcroute 8-46
fcrxbbcredit extended enable 8-48
fcs plat-check-global vsan 8-49
fcs register 8-50
fcs virtual-device-add 8-51
fcsp 8-52
fcsp dhchap 8-54
fcsp enable 8-57
fcsp esp sa 8-58
fcsp timeout 8-59
fctimer 8-60
fctimer abort 8-61
fctimer commit 8-62
fctimer distribute 8-63
fctrace 8-64
fc-tunnel 8-65
feature 8-67
ficon enable 8-69
ficon logical-port assign port-numbers 8-71
ficon port default-state prohibit-all 8-72
ficon slot assign port-numbers 8-73
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xvi
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
ficon swap 8-75
ficon-tape-accelerator vsan 8-77
ficon vsan (EXEC mode) 8-79
ficon vsan (configuration mode) 8-81
file 8-82
find 8-83
flex-attach virtual-pwwn 8-84
flex-attach virtual-pwwn auto 8-85
flex-attach virtual-pwwn interface 8-86
flowgroup 8-87
format 8-88
fspf config vsan 8-90
fspf cost 8-92
fspf dead-interval 8-93
fspf enable vsan 8-94
fspf hello-interval 8-95
fspf passive 8-96
fspf retransmit-interval 8-97
CHAP T E R 9 G Commands 9-1
group 9-2
gzip 9-3
gunzip 9-5
CHAP T E R 10 H Commands 10-1
hash 10-2
host 10-3
host 10-4
hw-module logging onboard 10-6
CHAP T E R 11 I Commands 11-1
identity 11-2
ingress-sa 11-4
in-order-guarantee 11-5
initiator 11-6
install all 11-7
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xvii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
install clock-module 11-13
install license 11-15
install module bios 11-16
install module epld 11-17
install module loader 11-19
install ssi 11-20
interface 11-21
interface bay | ext 11-23
interface fc 11-24
interface fc-tunnel 11-26
interface fcip 11-28
interface gigabitethernet 11-30
interface ioa 11-32
interface iscsi 11-33
interface mgmt 11-35
interface port-channel 11-36
interface sme 11-38
interface sme (Cisco SME cluster node configuration submode) 11-39
interface vsan 11-41
ioa cluster 11-42
ioa site-local 11-43
ip access-group 11-44
ip access-list 11-46
ip address (FCIP profile configuration submode) 11-49
ip address (interface configuration) 11-50
ip-compression 11-51
ip default-gateway 11-53
ip default-network 11-54
ip domain-list 11-55
ip domain-lookup 11-56
ip domain-name 11-57
ip name-server 11-58
ip route 11-59
ip routing 11-60
ips netsim delay-ms 11-61
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xviii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
ips netsim delay-us 11-62
ips netsim drop nth 11-63
ips netsim drop random 11-65
ips netsim enable 11-67
ips netsim max-bandwidth-kbps 11-68
ips netsim max-bandwidth-mbps 11-69
ips netsim qsize 11-70
ips netsim reorder 11-71
ipv6 access-list 11-73
ipv6 address 11-74
ipv6 address autoconfig 11-76
ipv6 enable 11-77
ipv6 nd 11-78
ipv6 route 11-80
ipv6 routing 11-82
ipv6 traffic-filter 11-83
iscsi authentication 11-84
iscsi duplicate-wwn-check 11-86
iscsi dynamic initiator 11-88
iscsi enable 11-90
iscsi enable module 11-91
iscsi import target fc 11-92
iscsi initiator idle-timeout 11-93
iscsi initiator ip-address 11-94
iscsi initiator name 11-96
iscsi interface vsan-membership 11-97
iscsi save-initiator 11-98
iscsi virtual-target name 11-100
islb abort 11-103
islb commit 11-104
islb distribute 11-105
islb initiator 11-107
islb save-initiator 11-109
islb virtual-target name 11-111
islb vrrp 11-113
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xix
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
islb zoneset activate 11-115
isns 11-116
isns distribute 11-118
isns esi retries 11-119
isns profile name 11-120
isns reregister 11-121
isns-server enable 11-122
ivr abort 11-123
ivr commit 11-124
ivr copy active-service-group user-configured-service-group 11-125
ivr copy active-topology user-configured-topology 11-126
ivr copy active-zoneset full-zoneset 11-127
ivr copy auto-topology user-configured-topology 11-128
ivr distribute 11-129
ivr enable 11-130
ivr fcdomain database autonomous-fabric-num 11-131
ivr nat 11-132
ivr refresh 11-133
ivr service-group activate 11-134
ivr service-group name 11-136
ivr virtual-fcdomain-add 11-138
ivr virtual-fcdomain-add2 11-139
ivr vsan-topology 11-140
ivr vsan-topology database 11-142
ivr withdraw domain 11-144
ivr zone name 11-145
ivr zone rename 11-146
ivr zoneset 11-147
ivr zoneset rename 11-148
CHAP T E R 12 J Commands 12-1
job name 12-2
CHAP T E R 13 K Commands 13-1
keepalive 13-2
kernel core 13-3
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xx
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
key (sa configuration submode) 13-5
key 13-6
key-ontape 13-8
CHAP T E R 14 L Commands 14-1
lifetime seconds 14-2
line com1 14-3
line console 14-6
line vty 14-9
link (SDV virtual device configuration submode) 14-10
link-state-trap 14-11
link-state-trap (SME) 14-12
load-balancing (Cisco IOA cluster Configuration submode) 14-13
load-balancing 14-14
logging abort 14-15
logging commit 14-16
logging console 14-17
logging distribute 14-18
logging level 14-19
logging logfile 14-20
logging module 14-21
logging monitor 14-22
logging server 14-23
logging timestamp 14-25
CHAP T E R 15 M Commands 15-1
match 15-2
match address 15-4
mcast root 15-5
member (fcalias configuration submode) 15-6
member (ivr zone configuration) 15-8
member (zone configuration and zoneset-zone configuration submode) 15-10
member (zoneset configuration submode) 15-12
metric (iSLB initiator configuration) 15-13
mkdir 15-14
mode 15-15
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxi
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
modem connect line 15-16
monitor counter 15-17
monitor counter tx-discards 15-19
move 15-20
mutual-chap username (iSCSI initiator configuration and iSLB initiator configuration) 15-21
CHAP T E R 16 N Commands 16-1
native-autonomous-fabric-num 16-2
node (Cisco IOA cluster node configuration submode) 16-3
node 16-4
npiv enable 16-5
nport 16-6
nport pwwn 16-7
npv enable 16-8
npv auto-load-balance disruptive 16-9
npv traffic-map server-interface 16-10
ntp 16-11
ntp abort 16-12
ntp commit 16-13
ntp distribute 16-14
ntp sync-retry 16-15
nwwn (DPVM database configuration submode) 16-16
nwwn (SAN extension configuration mode) 16-17
CHAP T E R 17 O Commands 17-19
odrt.bin 17-20
ocsp url 17-22
out-of-service 17-24
out-of-service module 17-26
out-of-service xbar 17-27
CHAP T E R 18 P Commands 18-1
passive-mode 18-2
password strength-check 18-3
peer (DMM job configuration submode) 18-5
peer-info ipaddr 18-6
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
periodic-inventory notification 18-8
permit (IPv6-ACL configuration) 18-9
phone-contact 18-12
ping 18-13
policy 18-15
port 18-16
port-channel persistent 18-17
port-group-monitor enable 18-18
port-group-monitor activate 18-19
port-group-monitor name 18-20
port-group-monitor counter 18-21
port-license 18-23
port-monitor activate 18-24
port-monitor counter 18-25
port-monitor enable 18-27
port-monitor name 18-28
port-security 18-29
port-security abort 18-32
port-security commit 18-33
port-security database 18-34
port-security distribute 18-36
port-security enable 18-37
port-track enable 18-38
port-track force-shut 18-39
port-track interface 18-40
port-type 18-42
portaddress 18-44
power redundancy-mode 18-46
poweroff module 18-48
priority 18-49
purge fcdomain fcid 18-51
purge module 18-52
pwc 18-53
pwd 18-54
pwwn (DPVM database configuration submode) 18-55
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxiii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
pwwn (fcdomain database configuration submode) 18-56
pwwn (SDV virtual device configuration submode) 18-57
CHAP T E R 19 Q Commands 19-1
qos class-map 19-2
qos control priority 19-3
qos dwrr-q 19-4
qos enable 19-5
qos policy-map 19-6
qos priority 19-7
qos service 19-8
quiesce 19-9
CHAP T E R 20 R Commands 20-1
radius abort 20-2
radius commit 20-3
radius distribute 20-4
radius-server deadtime 20-5
radius-server directed-request 20-6
radius-server host 20-7
radius-server key 20-9
radius-server retransmit 20-10
radius-server timeout 20-11
rate-mode bandwidth-fairness 20-12
rate-mode oversubscription-limit 20-13
reload 20-15
read command-id 20-17
read-only 20-19
revocation-check 20-20
rlir preferred-cond fcid 20-22
rmdir 20-24
rmon alarm 20-25
rmon event 20-27
rmon hcalarm 20-29
role abort 20-31
role commit 20-32
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxiv
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
role distribute 20-33
role name 20-34
rsakeypair 20-36
rscn 20-38
rscn abort vsan 20-39
rscn commit vsan 20-40
rscn distribute 20-41
rscn event-tov 20-42
rule 20-44
run-script 20-45
rspan-tunnel 20-47
CHAP T E R 21 S Commands 21-1
salt (sa configuration submode) 21-2
san-ext-tuner enable 21-3
santap module 21-5
scaling batch enable 21-7
scheduler 21-8
scheduler aaa-authentication 21-10
scsi-flow distribute 21-12
scsi-flow flow-id 21-13
scsi-target 21-15
sdv abort vsan 21-17
sdv commit vsan 21-18
sdv enable 21-19
sdv virtual-device name 21-20
security-mode 21-21
send 21-22
server 21-23
server (configure session submode) 21-24
server (DMM job configuration submode) 21-25
server (radius configuration) 21-26
server (tacacs+ configuration) 21-27
set (IPsec crypto map configuration submode) 21-28
setup 21-30
setup 21-31
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxv
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
setup ficon 21-32
shared-keymode 21-33
shutdown 21-34
shutdown (interface configuration submode) 21-35
shutdown (Cisco SME cluster configuration submode) 21-36
site-id 21-37
sleep 21-38
sme 21-39
snmp port 21-40
snmp-server 21-41
snmp-server contact 21-43
snmp-server community 21-44
snmp-server enable traps 21-45
snmp-server traps entity fru 21-48
snmp-server enable traps fcdomain 21-49
snmp-server enable traps link cisco 21-50
snmp-server enable traps zone 21-51
snmp-server globalEnforcePriv 21-52
snmp-server host 21-53
snmp-server location 21-55
snmp-server tcp-session 21-56
snmp-server user 21-57
source 21-59
span max-queued-packets 21-62
span session 21-63
span session source interface 21-64
special-frame 21-65
ssh 21-66
ssh key 21-67
ssh server enable 21-69
ssl 21-70
ssm upgrade delay 21-71
ssm enable feature 21-72
static (iSCSI initiator configuration and iSLB initiator configuration) 21-75
stop 21-77
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxvi
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
streetaddress 21-78
suspend 21-79
switch-priority 21-81
switch-wwn 21-82
switchname 21-84
switchport 21-85
switchport auto-negotiate 21-90
switchport ignore bit-errors 21-91
switchport ingress-rate 21-93
switchport initiator id 21-94
switchport owner 21-95
switchport promiscuous-mode 21-96
switchport proxy-initiator 21-97
system cores 21-99
system delayed-traps enable mode 21-100
system delayed-traps timer 21-101
system default switchport 21-102
system default zone default-zone permit 21-104
system default zone distribute full 21-105
system default zone gs 21-107
system default zone mode enhanced 21-109
system hap-reset 21-110
system health (Configuration mode) 21-111
system health cf-crc-check 21-113
system health cf-re-flash 21-114
system health clear-errors 21-115
system health external-loopback 21-117
system health internal-loopback 21-119
system health module 21-121
system health serdes-loopback 21-124
system heartbeat 21-126
system memlog 21-127
system startup-config 21-128
system statistics reset 21-129
system switchover (EXEC mode) 21-130
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxvii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
system switchover (configuration mode) 21-131
system timeout congestion-drop 21-132
system timeout no-credit-drop 21-134
system trace 21-136
system watchdog 21-137
CHAP T E R 22 Show Commands 22-1
show aaa accounting 22-2
show aaa authentication 22-3
show aaa authentication login mschapv2 22-4
show aaa authentication login ascii-authentication 22-5
show aaa authorization all 22-6
show aaa groups 22-7
show accounting log 22-8
show arp 22-10
show autonomous-fabric-id database 22-11
show banner motd 22-13
show boot 22-14
show boot auto-copy 22-15
show callhome 22-17
show cdp 22-20
show cfs 22-24
show cfs regions 22-26
show cfs status 22-28
show cfs static peers 22-29
show cimserver 22-30
show cimserver indications 22-31
show cimserver logs 22-33
show cimserver status 22-34
show cli alias 22-35
show cli variables 22-36
show clock 22-37
show cloud discovery 22-38
show cloud membership 22-39
show copyright 22-41
show cores 22-42
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxviii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
show crypto ca certificates 22-43
show crypto ca crl 22-45
show crypto ca trustpoints 22-47
show crypto global domain ipsec 22-48
show crypto ike domain ipsec 22-50
show crypto key mypubkey rsa 22-51
show crypto map domain ipsec 22-52
show crypto sad domain ipsec 22-54
show crypto spd domain ipsec 22-56
show crypto transform-set domain ipsec 22-57
show debug 22-58
show debug npv 22-59
show debug sme 22-61
show device-alias 22-62
show device-alias status 22-64
show dmm discovery-log 22-65
show dmm fp-port 22-66
show dmm ip-peer 22-68
show dmm job 22-69
show dmm module 22-72
show dmm srvr-vt-login 22-73
show dmm vt 22-75
ssm enable feature dmm 22-76
storage (DMM job configuration submode) 22-78
show dpvm 22-79
show dpvm merge statistics 22-80
show dpvm merge status 22-81
show environment 22-82
show event manager environment 22-84
show event manager policy 22-85
show fabric-binding 22-86
show fc-tunnel 22-90
show fc2 22-91
show fcalias 22-94
show fcanalyzer 22-95
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxix
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
show fcc 22-96
show fcdomain 22-97
show fcdroplatency 22-101
show fcflow stats 22-102
show fcfwd 22-103
show fcid-allocation 22-104
22-105
show fc-redirect configs 22-106
show fc-redirect active-configs 22-107
show fc-redirect peer-switches 22-109
show fcip 22-111
show fcns database 22-113
show fcns statistics 22-117
show fcroute 22-118
show fcs 22-121
show fcsp 22-125
show fcsp interface 22-127
show fctimer 22-128
show fdmi 22-130
show ficon 22-133
show file 22-139
show flex-attach 22-140
show flex-attach info 22-141
show flex-attach merge status 22-143
show flex-attach virtual-pwwn 22-144
show flogi 22-146
show flogi database interface 22-149
show fspf 22-150
show hardware 22-153
show hardware fabric-mode 22-157
show hosts 22-158
show incompatibility system 22-159
show install all failure-reason 22-161
show install all impact 22-162
show install all status 22-164
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxx
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
show in-order-guarantee 22-166
show interface 22-167
show interface sme 22-176
show ioa cluster 22-178
show ioa cluster summary 22-182
show ioa internal interface ioa 22-183
show interface ioa 22-187
show interface transceiver 22-189
show inventory 22-191
show ip access-list 22-192
show ip arp 22-193
show ip interface 22-194
show ip route 22-196
show ip routing 22-197
show ip traffic 22-198
show ips arp 22-199
show ips ip route 22-200
show ips ipv6 22-201
show ips netsim 22-203
show ips stats 22-204
show ips stats fabric interface 22-207
show ips stats netsim 22-209
show ips status 22-211
show ipv6 access-list 22-212
show ipv6 interface 22-213
show ipv6 neighbours 22-215
show ipv6 route 22-216
show ipv6 routing 22-217
show ipv6 traffic 22-218
show isapi dpp 22-220
show isapi tech-support santap file 22-221
show iscsi global 22-223
show iscsi initiator 22-224
show iscsi session 22-226
show iscsi stats 22-228
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxxi
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
show iscsi virtual-target 22-232
show islb cfs-session status 22-234
show islb initiator 22-235
show islb merge status 22-237
show islb pending 22-238
show islb pending-diff 22-239
show islb session 22-240
show islb status 22-242
show islb virtual-target 22-243
show islb vrrp 22-245
show isns 22-252
show ivr 22-255
show ivr aam pre-deregister-check 22-260
show ivr fcdomain database 22-261
show ivr service-group 22-263
show ivr virtual-fcdomain-add-status2 22-264
show ivr virtual-switch-wwn 22-265
show kernel core 22-266
show license 22-267
show line 22-269
show logging 22-271
show logging onboard credit-loss 22-294
show logging onboard request-timeout 22-296
show logging onboard timeout-drops 22-298
show mcast 22-300
show module 22-302
show ntp 22-310
show npv flogi-table 22-312
show npv internal info 22-313
show npv internal info traffic-map 22-315
show npv traffic-map 22-316
show npv status 22-317
show process creditmon 22-318
show port index-allocation 22-320
show port-channel 22-322
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxxii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
show port-channel database 22-326
show port-channel compatibility-parameters 22-327
show port-channel consistency 22-331
show port-channel internal 22-332
show port-channel summary 22-337
show port-channel usage 22-338
show port-group-monitor status 22-339
show port-monitor active 22-340
show port-group-monitor 22-342
show port internal info interface fc 22-344
show port-license 22-346
show port-monitor 22-347
show port-monitor status 22-349
show port-resources module 22-350
show port-security 22-352
show processes 22-355
show process creditmon 22-358
show role 22-360
show qos 22-362
show radius 22-364
show running-config fcsp 22-365
show running radius 22-366
show radius-server 22-368
show rlir 22-370
show rmon 22-374
show rmon status 22-376
show role 22-377
show rscn 22-379
show running-config 22-381
show san-ext-tuner 22-384
show santap module 22-385
show santap module dvt 22-390
show santap module dvt brief 22-391
show santap module dvtlun 22-393
show santap vttbl dvt 22-394
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxxiii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
show santap vttbl dvt host 22-395
show scheduler 22-396
show scsi-flow 22-398
show scsi-target 22-402
show sdv 22-405
show sme cluster 22-407
show sme transport 22-410
show snmp 22-411
show span drop-counters 22-415
show span max-queued-packets 22-416
show span session 22-417
show sprom 22-419
show ssh 22-422
show ssm provisioning 22-424
show startup-config 22-425
show switchname 22-429
show system 22-430
show system internal snmp credit-not-available 22-433
show system internal snmp lc 22-434
show system default zone 22-436
show system health 22-438
show tacacs+ 22-445
show tacacs-server 22-446
show tech-support 22-448
show tech-support sme 22-454
show telnet server 22-455
show terminal 22-456
show tlport 22-457
show topology 22-459
show trunk protocol 22-461
show user-account 22-462
show users 22-463
show version 22-464
show vrrp 22-468
show vsan 22-471
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxxiv
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
show wwn 22-474
show zone 22-475
show zone analysis 22-479
show zone-attribute-group 22-484
show zoneset 22-485
CHAP T E R 23 T Commands 23-1
tacacs+ abort 23-2
tacacs+ commit 23-3
tacacs+ distribute 23-4
tacacs+ enable 23-5
tacacs-server deadtime 23-6
tacacs-server directed-request 23-7
tacacs-server host 23-8
tacacs-server key 23-10
tacacs-server timeout 23-12
tail 23-13
tape-bkgrp 23-14
tape compression 23-15
tape-device 23-16
tape-keyrecycle 23-17
tape-read command-id 23-18
tape-volgrp 23-20
tape-write command-id 23-21
target (iSLB initiator configuration) 23-23
tcp cwm 23-26
tcp keepalive-timeout 23-27
tcp maximum-bandwidth-kbps 23-28
tcp maximum-bandwidth-mbps 23-30
tcp max-jitter 23-32
tcp max-retransmissions 23-34
tcp min-retransmit-time 23-35
tcp pmtu-enable 23-36
tcp qos 23-38
tcp qos control 23-39
tcp sack-enable 23-40
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxxv
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
tcp send-buffer-size 23-41
tcp-connection 23-42
telnet 23-43
telnet server enable 23-44
terminal 23-45
terminal event-manager bypass 23-47
test aaa authorization 23-48
time 23-49
time-stamp 23-51
tlport alpa-cache 23-52
traceroute 23-53
transfer-ready-size 23-54
transport email 23-55
terminal verify-user 23-57
trunk protocol enable 23-58
tune 23-59
tune-timer 23-62
CHAP T E R 24 U Commands 24-1
undebug all 24-2
update license 24-3
use-profile 24-4
username 24-5
username (iSCSI initiator configuration and iSLB initiator configuration) 24-8
CHAP T E R 25 V Commands 25-1
virtual-domain (SDV virtual device configuration submode) 25-2
virtual-fcid (SDV virtual device configuration submode) 25-3
vrrp 25-4
vsan (iSCSI initiator configuration and iSLB initiator configuration) 25-6
vsan database 25-8
vsan policy deny 25-11
CHAP T E R 26 W Commands 26-1
write command-id 26-2
write-accelerator 26-4
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
Contents
xxxvi
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
write erase 26-6
wwn secondary-mac 26-7
wwn vsan 26-8
CHAP T E R 27 Z Commands 27-1
zone broadcast enable vsan 27-2
zone clone 27-3
zone commit vsan 27-4
zone compact vsan 27-5
zone copy 27-6
zone default-zone 27-8
zone convert zone 27-9
zone merge-control restrict vsan 27-11
zone mode enhanced vsan 27-12
zone name (configuration mode) 27-13
zone name (zone set configuration submode) 27-16
zone rename 27-17
zone-attribute-group clone 27-18
zone-attribute-group name 27-19
zone-attribute-group rename 27-20
zone gs 27-21
zonename (iSLB initiator configuration) 27-23
zoneset (configuration mode) 27-25
zoneset (EXEC mode) 27-27
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
xxxiii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
New and Changed Information
Table 1 summarizes the new and changed commands for Cisco MDS NX-OS Release 4.2(1) and tells
you where they are documented in the Cisco MDS 9000 Family Command Reference .
The Cisco MDS 9000 Family Command Reference applies to Cisco NX-OS Release 4.1(3), but describes
all features in Cisco SAN-OS releases. If you are running Cisco SAN-OS 3.x or lower software on an
MDS switch, refer to the Cisco MDS 9000 Family CLI Command Reference for the release train that
applies to the release on your switch.
Note As of NX-OS Release 4.1(1b), SAN-OS has been changed to NX-OS. References to SAN-OS releases
before 4.1(1b) still apply.
Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference
Feature Description Where Documented
New and Changed Commands for Cisco NX-OS Release 4.2(7a)
Slow drain system timeout congestion-drop command S Commands
system timeout no-credit-drop command
show logging onboard request-timeout
command
show process creditmon command Show Commands
show logging onboard credit-loss command
show logging onboard timeout-drops
command
counter tx-credit-not-available
command
C Commands
counter credit-loss-reco command
counter timeout-discards command
show port-monitor active command Show Commands
show system internal snmp
credit-not-available command
show port internal info interface fc command
show port-monitor command
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
xxxiv
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
New and Changed Information
counter lr-rx command C Commands
monitor counter tx-discards command M Commands
New and Changed Commands for Cisco NX-OS Release 4.2(1)
Call Home destination-profile command
(Deleted Avanti keyword from the syntax
description. Added the Usage guideline)
D Commands
EEM action event-default command
(Added a note)
A Commands
terminal event-manager bypass command
(Added a note)
T Commands
event command
(Added a note)
E Commands
Port Guard errdisable detect cause bit-errors command E Commands
errdisable detect cause credit-loss command
errdisable detect cause link-reset command
errdisable detect cause signal-loss command
errdisable detect cause sync-loss command
errdisable detect cause trustsec-violation
command
feature command
(Added ioa keyword to the syntax description)
F Commands
AAA Enhancement show aaa authentication login mschapv2
command
Show Commands
show aaa authorization all command
clear tacacs-server statistics command C Commands
clear radius-server statistics command
aaa authentication login mschapv2 enable
command
A Commands
aaa authorization command
test aaa authorization command T Commands
terminal verify-user command
FC-redirect with IVR show ivr aam pre-deregister-check command show Commands
FC-ID Visibility show fcns database command
(Changed the command output)
show Commands
IOA ioa site-local command I Commands
ioa cluster command
interface ioa command
Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference
Feature Description Where Documented
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
xxxv
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
New and Changed Information
load-balancing (Cisco IOA cluster
Configuration submode) command
L Commands
nport command N Commands
node (Cisco IOA cluster node configuration
submode) command
flowgroup command F Commands
host command H commands
tune command
show ioa internal interface ioa command Show Commands
show ioa cluster summary command
show interface ioa command
show ioa cluster command
Port Group Monitoring show port-monitor active command show Commands
show port-group-monitor command
show port-group-monitor status command
port-group-monitor activate command P Commands
port-group-monitor name command
port-group-monitor enable command
port-group-monitor counter command
monitor counter command M Commands
Trustsec show running-config fcsp command show Commands
show fcsp interface command
fcsp esp sa command F Commands
fcsp command
ingress-sa command I commands
interface fc command
egress-sa command E Commands
mode command M Commands
key (sa configuration submode) command K Commands
salt (sa configuration submode) command S Commands
New and Changed Commands for Cisco NX-OS Release 4.1(3a)
Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference
Feature Description Where Documented
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
xxxvi
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
New and Changed Information
AAA enhancement aaa authentication login ascii-authentication
command
(enable the password aging command has been
changed from aaa authentication login
password-aging enable to aaa authentication
login ascii-authentication)
A Commands
show aaa authentication login
ascii-authentication command
(enable the password aging command has been
changed from show aaa authentication login
password-aging enable to show aaa
authentication login ascii-authentication)
Show Commands
New and Changed Commands for Cisco NX-OS Release 4.1(3)
Call Home destination-profile command
(Added the HTTPs URL and transport method
to the syntax description)
D Commands
Port Guard errdisable detect cause link-down command E Commands
Port Owner switchport owner command S Commands
F port Trunking feature command
(Added Keywords hhtp-server,
fport-channel-trunk, npiv and npv to the
syntax description)
F Commands
switchport command
(Added the F and NP port mode)
S Commands
show flogi database interface command Show Commands
F port Channeling show port-channel compatibility-parameters
command
Show Commands
show port-channel consistency command
show port-channel database command
show port-channel internal command
show port-channel summary command
show port-channel usage command
channel-group command
(Deleted auto keyword from the syntax
description)
C Commands
port-channel persistent command
(Added usage guideline)
P Commands
clear asic-cnt command C Commands
Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference
Feature Description Where Documented
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
xxxvii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
New and Changed Information
ntp command
(Added a note)
N Commands
show fcns database command
(Changed the command output for show fcns
database detail)
Show Commands
Hardware show system command
(Changed the show system uptime output)
Show Commands
Radius Configuration radius-server host command
(Changed the command output)
R Commands
show running radius command
(Changed the command output)
Show Commands
Scheduler scheduler command
(Deleted a Note)
S Commands
EEM event manager applet command E Commands
errdisable detect cause bit-errors command
event manager policy command
event manager environment command
description command D Commands
show event manager policy command Show Commands
show event manager environment command
action cli command A Commands
action counter command
action event-default command
action exception log command
action forceshut command
action overbudgetshut command
action policy-defaultcommand
action reload command
action snmp-trap commnd
action syslog command
Added SME Commands
SME scaling batch enable command S Commands
Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference
Feature Description Where Documented
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
xxxviii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
New and Changed Information
New and Changed Commands for Cisco NX-OS Release 4.1(1b)
Call Home switch-priority command
(Added usage guidelines)
S Commands
system delayed-traps timer command
system delayed-traps enable mode command
system health system health clear-errors command S Commands
Port-monitor show port-monitor status command Show Commands
show port-resources module command
SNMP show system internal snmp lc command
Scheduler scheduler command
(Added a Note)
S Commands
SSM ssm upgrade delay command S Commands
SANTap show isapi tech-support santap file command
(Added usage guidelines)
Show Commands
show santap module dvt command
show santap module dvtlun command
show santap vttbl dvt command
show santap vttbl dvt host command
SDV show sdv command
(Changed the command output)
Show Commands
attribute failover auto command A Commands
General Configuration feature command F Commands
DPVM clear dpvm merge statistics command C Commands
show dpvm merge statistics command Show Commands
show dpvm merge status command
dpvm overwrite-duplicate-pwwn command D Commands
Generation 3 Modules do command
(Added the command output for extended
receive bbcredit interface)
(Added a Note)
D Commands
show interface command
(Added the command output for bbcredit
information for a switch port)
(Added the command output for interface
capabilities on a 48 port line card)
Show Commands
Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference
Feature Description Where Documented
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
xxxix
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
New and Changed Information
show module command
(Added the command output for a module
resource on a 24 port line card with all ports in
shared mode)
(Added the command output for a module
resource on a 24 port line card with few ports in
shared mode and few port in dedicated mode)
(Added the command output for a module
resource on a 12 port line card with all ports in
dedicated mode)
(Added the command output for a module
resource on a 12 port line card with all ports in
dedicated mode and extended feature enabled)
Show Commands
Hardware show hardware fabric-mode command Show Commands
show version command
(Changed the command output from SAN-OS to
NX-OS)
Show Commands
show hardware command
(Changed the command output from SAN-OS to
NX-OS)
show copyright command
(Changed the command output from SAN-OS to
NX-OS)
Deprecated Commands
(see the feature command for replacement commands)
crypto ike enable command C Commands
dpvm enable command D Commands
fabric-binding enable command F Commands
fcip enable command
fcsp enable command
ficon enable command
ivr enable command I Commands
port-security enable command P Commands
sdv enable command S Commands
tacacs+ enable command T Commands
Added DMM Commands
Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference
Feature Description Where Documented
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
xl
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
New and Changed Information
DMM dmm module job command
(Added the set-vi and modify rate keywords)
D Commands
show dmm module command
(Added the syntax description and the command
output)
Show Commands
Added SME Commands
SME cluster command
(Cluster command is replaced by the feature
command)
C Commands
show tech-support sme command
(Added the command output)
Show Commands
show role command
(Added the command output)
show sme cluster
(Added the syntax description)
show sme transport command
(Added the syntax description)
show debug command
(Added the syntax description)
delete command
(Added the syntax description)
D Commands
Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference
Feature Description Where Documented
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
lxv
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
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 Title Description
Chapter 1 CLI Overview Describes the CLI (command-line interface).
Chapter 2 A Commands Describes all commands beginning with the letter a.
Chapter 3 B Commands Describes all commands beginning with the letter b.
Chapter 4 C Commands Describes all commands beginning with the letter c.
Chapter 5 D Commands Describes all commands beginning with the letter d.
Chapter 6 Debug Commands Describes all the debug commands.
Chapter 7 E Commands Describes all commands beginning with the letter e.
Chapter 8 F Commands Describes all commands beginning with the letter f.
Chapter 9 G Commands Describes all commands beginning with the letter g.
Chapter 10 H Commands Describes all commands beginning with the letter h.
Chapter 11 I Commands Describes all commands beginning with the letter i.
Chapter 12 J Commands Describes all commands beginning with the letter j.
Chapter 13 K Commands Describes all commands beginning with the letter k.
Chapter 14 L Commands Describes all commands beginning with the letter l.
Chapter 15 M Commands Describes all commands beginning with the letter m.
Chapter 16 N Commands Describes all commands beginning with the letter n.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
lxvi
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Preface
Document Conventions
Command descriptions use these conventions:
Screen examples use these conventions:
Chapter 17 O Commands Describes all commands beginning with the letter o.
Chapter 18 P Commands Describes all commands beginning with the letter p.
Chapter 19 Q Commands Describes all commands beginning with the letter q.
Chapter 20 R Commands Describes all commands beginning with the letter r.
Chapter 21 S Commands Describes all commands beginning with the letter s except for
the show commands.
Chapter 22 Show Commands Describes all the show commands.
Chapter 23 T Commands Describes all commands beginning with the letter t.
Chapter 24 U Commands Describes all commands beginning with the letter u.
Chapter 25 V Commands Describes all commands beginning with the letter v.
Chapter 26 W Commands Describes all commands beginning with the letter w.
Chapter 27 Z Commands Describes all commands beginning with the letter z.
Chapter 28 Caching Services
Module Commands
Describes all commands pertaining to the Caching Services
Module (CSM).
Chapter Title Description
Convention Indication
boldface font Commands and keywords are in boldface.
italic font Arguments for which you supply values are in italics.
[ ] Elements in square brackets are optional.
{x | y | z } Required alternative keywords are grouped in braces and separated by vertical
bars.
[ x | y | z ] Optional alternative keywords are grouped in brackets and separated by vertical
bars.
string A nonquoted set of characters. Do not use quotation marks around the string or
the string will include the quotation marks.
Convention Indication
screen font Terminal sessions and information the switch displays are in screen font.
boldface screen
font
Information you must enter is in boldface screen font.
italic 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.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
lxvii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
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. To find a
document online, use the Cisco MDS NX-OS Documentation Locator at:
http://www.cisco.com/en/US/docs/storage/san_switches/mds9000/roadmaps/doclocater.htm
Release Notes
Cisco MDS 9000 Family Release Notes for Cisco MDS NX-OS Releases
Cisco MDS 9000 Family Release Notes for MDS SAN-OS Releases
Cisco MDS 9000 Family Release Notes for Storage Services Interface Images
Cisco MDS 9000 Family Release Notes for Cisco MDS 9000 EPLD Images
Release Notes for Cisco MDS 9000 Family Fabric Manager
Regulatory Compliance and Safety Information
Regulatory Compliance and Safety Information for the Cisco MDS 9000 Family
Compatibility Information
Cisco Data Center Interoperability Support Matrix
Cisco MDS 9000 NX-OS Hardware and Software Compatibility Information and Feature Lists
Cisco MDS NX-OS Release Compatibility Matrix for Storage Service Interface Images
Cisco MDS 9000 Family Switch-to-Switch Interoperability Configuration Guide
Cisco MDS NX-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
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
lxviii
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Preface
Related Documentation
Hardware Installation
Cisco MDS 9500 Series Hardware Installation Guide
Cisco MDS 9200 Series Hardware Installation Guide
Cisco MDS 9100 Series Hardware Installation Guide
Cisco MDS 9124 and Cisco MDS 9134 Multilayer Fabric Switch Quick Start Guide
Software Installation and Upgrade
Cisco MDS 9000 NX-OS Release 4.1(x) and SAN-OS 3(x) Software Upgrade and Downgrade Guide
Cisco MDS 9000 Family Storage Services Interface Image Install and Upgrade Guide
Cisco MDS 9000 Family Storage Services Module Software Installation and Upgrade Guide
Cisco NX-OS
Cisco MDS 9000 Family NX-OS Licensing Guide
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
Cisco MDS 9000 Family NX-OS System Management Configuration Guide
Cisco MDS 9000 Family NX-OS Interfaces Configuration Guide
Cisco MDS 9000 Family NX-OS Fabric Configuration Guide
Cisco MDS 9000 Family NX-OS Quality of Service Configuration Guide
Cisco MDS 9000 Family NX-OS Security Configuration Guide
Cisco MDS 9000 Family NX-OS IP Services Configuration Guide
Cisco MDS 9000 Family NX-OS Intelligent Storage Services Configuration Guide
Cisco MDS 9000 Family NX-OS High Availability and Redundancy Configuration Guide
Cisco MDS 9000 Family NX-OS Inter-VSAN Routing Configuration Guide
Cisco Fabric Manager
Cisco Fabric Manager Fundamentals Configuration Guide
Cisco Fabric Manager System Management Configuration Guide
Cisco Fabric Manager Interfaces Configuration Guide
Cisco Fabric Manager Fabric Configuration Guide
Cisco Fabric Manager Quality of Service Configuration Guide
Cisco Fabric Manager Security Configuration Guide
Cisco Fabric Manager IP Services Configuration Guide
Cisco Fabric Manager Intelligent Storage Services Configuration Guide
Cisco Fabric Manager High Availability and Redundancy Configuration Guide
Cisco Fabric Manager Inter-VSAN Routing Configuration Guide
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
lxix
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Preface
Related Documentation
Cisco Fabric Manager Online Help
Cisco Fabric Manager Web Services Online Help
Command-Line Interface
Cisco MDS 9000 Family Command Reference
Intelligent Storage Networking Services Configuration Guides
Cisco MDS 9000 I/O Acceleration Configuration Guide
Cisco MDS 9000 Family SANTap Deployment Guide
Cisco MDS 9000 Family Data Mobility Manager Configuration Guide
Cisco MDS 9000 Family Storage Media Encryption Configuration Guide
Cisco MDS 9000 Family Secure Erase Configuration Guide
Cisco MDS 9000 Family Cookbook for Cisco MDS SAN-OS
Troubleshooting and Reference
Cisco NX-OS System Messages Reference
Cisco MDS 9000 Family NX-OS Troubleshooting Guide
Cisco MDS 9000 Family NX-OS MIB Quick Reference
Cisco MDS 9000 Family NX-OS SMI-S Programming Reference
Cisco MDS 9000 Family Fabric Manager Server Database Schema
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
lxx
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Preface
Related Documentation
C H A P T E R
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-1
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
1
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-13
Searching and Filtering CLI Output, page 1-19
Using CLI Variables, page 1-27
Using Command Aliases, page 1-29
About Flash Devices, page 1-30
Formatting Flash Disks and File Systems, page 1-31
Using the File System, page 1-32
Role-Based CLI, page 1-38
Using Valid Formats and Ranges, page 1-39
Using Debug Commands, page 1-40
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-2
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
About the Switch Prompt
About the Switch Prompt
If you are connected to the console port when the switch boots up, you see the output shown in
Example 1-1.
Note Refer to the Cisco MDS 9100 Series Hardware Installation Guide, the Cisco MDS 9200 Series Hardware
Installation Guide, the Cisco MDS 9216 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 Displays the 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:
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-3
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
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.
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.
Table 1-1 Frequently Used Switch Command Modes
Mode Description of Use How to Access Prompt
EXEC Enables you to temporarily change
terminal settings, perform basic tests, and
display system information.
Note Changes made in this mode are
generally not saved across system
resets.
At the switch prompt, enter the required
EXEC mode command.
switch#
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 NX-OS 9000 Family
Fundementals Configuration
Guide for further information.
From EXEC mode, enter the config
terminal command.
switch(config)#
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-4
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Understanding CLI Command Hierarchy
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
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
switch prompt (switch#)
cd
write erase
configure
clock
zoneset
interface
fspf
switchport
EXEC mode
Configuration
mode
Configuration
submode
exit
exit
end
7
9
5
2
5
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-5
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
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-38). 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.
The next two sections list the EXEC mode commands for the Cisco MDS 9000 Family, the Cisco Fabric
Switch for HP c-Class BladeSystem, and the Cisco Fabric Switch for IBM BladeCenter. Not all EXEC
mode commands that are supported on the Cisco MDS 9000 Family switches are available on the Cisco
Fabric Switch for HP c-Class BladeSystem and the Cisco Fabric Switch for IBM BladeCenter.
EXEC Mode Commands for the Cisco MDS 9000 Family
switch# ?
Exec commands:
attach Connect to a specific linecard
callhome Callhome commands
cd Change current directory
clear Reset functions
cli CLI commands
clock Manage the system clock
config Enter configuration mode
copy Copy from one file to another
debug Debugging functions
delete Delete a file
dir List files in a directory
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
gunzip Uncompresses LZ77 coded files
gzip Compresses file using LZ77 coding
install Upgrade software
license Enter the license configuration mode
mkdir Create new directory
modem Modem commands
move Move files
no Disable debugging functions
ntp Execute NTP commands
out-of-service Make the current module out-of-service
ping Send echo messages
port-channel Port-Channel related commands
purge Deletes unused data
pwd View current directory
reload Reboot the entire box
rmdir Delete a directory
run-script Run shell scripts
sdv SDV test commands
send Send message to open sessions
setup Run the basic SETUP command facility
show Show running system information
sleep Sleep for the specified number of seconds
ssh SSH to another system
system System management commands
tac-pac Save tac information to a specific location
tail Display the last part of a file
telnet Telnet to another system
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-6
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Understanding CLI Command Hierarchy
terminal Set terminal line parameters
test Test command
traceroute Trace route to destination
undebug Disable Debugging functions (See also debug)
update Update license
write Write current configuration
zone Execute Zone Server commands
zoneset Execute zoneset commands
EXEC Mode Commands for the Cisco Fabric Switch for HP c-Class BladeSystem and the Cisco Fabric
Switch for IBM BladeCenter
switch# ?
Exec commands:
attach Connect to a specific linecard
callhome Callhome commands
cd Change current directory
clear Reset functions
cli CLI commands
clock Manage the system clock
config Enter configuration mode
copy Copy from one file to another
debug Debugging functions
delete Delete a file
dir List files in a directory
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
gunzip Uncompresses LZ77 coded files
gzip Compresses file using LZ77 coding
install Upgrade software
license Enter the license configuration mode
mkdir Create new directory
modem Modem commands
move Move files
no Disable debugging functions
ntp Execute NTP commands
out-of-service Make the current module out-of-service
ping Send echo messages
port-channel Port-Channel related commands
purge Deletes unused data
pwd View current directory
reload Reboot the entire box
rmdir Delete a directory
run-script Run shell scripts
send Send message to open sessions
setup Run the basic SETUP command facility
show Show running system information
sleep Sleep for the specified number of seconds
ssh SSH to another system
system System management commands
tac-pac Save tac information to a specific location
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)
update Update license
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-7
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Understanding CLI Command Hierarchy
write Write current configuration
zone Execute Zone Server commands
zoneset Execute zoneset commands
Configuration Mode Options
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)#
Not all configuration mode commands that are available on the Cisco MDS 9000 Family are available
on the Cisco Fabric Switch for HP c-Class BladeSystem and the Cisco Fabric Switch for IBM
BladeCenter.
The following two sections list the configuration mode commands for the Cisco MDS 9000 Family, the
Cisco Fabric Switch for HP c-Class BladeSystem, and the Cisco Fabric Switch for IBM BladeCenter.
Not all configuration mode commands that are supported on the Cisco MDS 9000 Family switches are
available on the Cisco Fabric Switch for HP c-Class BladeSystem and the Cisco Fabric Switch for IBM
BladeCenter.
Configuration Mode Commands for the Cisco MDS 9000 Family
switch# config terminal
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# ?
Configure commands:
aaa Configure aaa functions
arp [no] remove an entry from the ARP cache
banner Configure banner message
boot Configure boot variables
callhome Enter the callhome configuration mode
cdp CDP Configuration parameters
cfs CFS configuration commands
cimserver Modify cimserver configuration
cli CLI configuration commands
clock Configure time-of-day clock
cloud Configure Cloud Discovery
cloud-discovery Configure Cloud Discovery
crypto Set crypto settings
device-alias Device-alias configuration commands
do EXEC command
dpvm Configure Dynamic Port Vsan Membership
end Exit from configure mode
exit Exit from configure mode
fabric-binding Fabric Binding configuration
fc-tunnel Configure fc-tunnel
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
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-8
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Understanding CLI Command Hierarchy
fcflow Configure fcflow
fcid-allocation Add/remove company id(or OUIs) from auto area list
fcinterop Interop commands
fcip Enable/Disable FCIP
fcns Name server configuration
fcroute Configure FC routes
fcrxbbcredit Enable extended rx b2b credit configuration
fcs Configure Fabric Config Server
fcsp Config commands for FC-SP
fctimer Configure fibre channel timers
fdmi Config commands for FDMI
ficon Configure ficon information
fspf Configure fspf
hw-module Enable/Disable OBFL information
in-order-guarantee Set in-order delivery guarantee
interface Select an interface to configure
ip Configure IP features
ips Various sibyte module related commands
ipv6 Configure IPv6 features
iscsi Enable/Disable iSCSI
islb ISCSI server load-balancing
isns Configure iSNS
isns-server ISNS server
ivr Config commands for IVR
kernel Kernel options
line Configure a terminal line
logging Modify message logging facilities
mcast Configure multicast
no Negate a command or set its defaults
npiv Nx port Id Virtualization (NPIV) feature enable
ntp NTP Configuration
port-security Configure Port Security
port-track Configure Switch port track config
power Configure power supply
poweroff Poweroff a module in the switch
qos QoS Configuration commands
radius Configure RADIUS configuration
radius-server Configure RADIUS related parameters
rib Configure RIB parameters
rmon Remote Monitoring
role Configure roles
rscn Config commands for RSCN
san-ext-tuner Enable/Disable San Extension Tuner tool
scheduler Config commands for scheduler
scsi-target Scsi-target configuration
snmp-server Configure snmp server
span Enter SPAN configuration mode
ssh Configure SSH parameters
switchname Configure system's network name
system System config command
tacacs+ Enable tacacs+
telnet Enable telnet
tlport Configure TL Port information
trunk Configure Switch wide trunk protocol
username Configure user information.
vsan Enter the vsan configuration mode
wwn Set secondary base MAC addr and range for additional WWNs
zone Zone configuration commands
zone-attribute-group Zone attribute group commands
zoneset Zoneset configuration commands
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-9
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Understanding CLI Command Hierarchy
Configuration Mode Commands for the Cisco Fabric Switch for HP c-Class BladeSystem and the
Cisco Fabric Switch for IBM BladeCenter
switch# config terminal
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# ?
Configure commands:
aaa Configure aaa functions
arp [no] remove an entry from the ARP cache
banner Configure banner message
boot Configure boot variables
callhome Enter the callhome configuration mode
cdp CDP Configuration parameters
cfs CFS configuration commands
cimserver Modify cimserver configuration
cli CLI configuration commands
clock Configure time-of-day clock
device-alias Device-alias configuration commands
do EXEC command
dpvm Configure Dynamic Port Vsan Membership
end Exit from configure mode
exit Exit from configure mode
fabric-binding Fabric Binding configuration
fcalias Fcalias configuration commands
fcanalyzer Configure cisco fabric analyzer
fcdomain Enter the fcdomain configuration mode
fcdroplatency Configure switch or network latency
fcflow Configure fcflow
fcid-allocation Add/remove company id(or OUIs) from auto area list
fcinterop Interop commands
fcns Name server configuration
fcroute Configure FC routes
fcrxbbcredit Enable extended rx b2b credit configuration
fcs Configure Fabric Config Server
fcsp Config commands for FC-SP
fctimer Configure fibre channel timers
fdmi Config commands for FDMI
fips Enable/Disable FIPS mode
fspf Configure fspf
hw-module Enable/Disable OBFL information
in-order-guarantee Set in-order delivery guarantee
interface Select an interface to configure
ip Configure IP features
ipv6 Configure IPv6 features
kernel Kernel options
line Configure a terminal line
logging Modify message logging facilities
mcast Configure multicast
no Negate a command or set its defaults
npiv Nx port Id Virtualization (NPIV) feature enable
ntp NTP Configuration
port-security Configure Port Security
port-track Configure Switch port track config
power Configure power supply
poweroff Poweroff a module in the switch
qos QoS Configuration commands
radius Configure RADIUS configuration
radius-server Configure RADIUS related parameters
rate-mode Configure rate mode oversubscription limit
rib Configure RIB parameters
rlir Config commands for RLIR
rmon Remote Monitoring
role Configure roles
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-10
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Understanding CLI Command Hierarchy
rscn Config commands for RSCN
scheduler Config commands for scheduler
scsi-target Scsi-target configuration
sdv Config commands for SAN Device Virtualization
snmp-server Configure snmp server
span Enter SPAN configuration mode
ssh Configure SSH parameters
switchname Configure system's network name
system System config command
tacacs+ Enable tacacs+
tacacs-server Configure TACACS+ server related parameters
telnet Enable telnet
trunk Configure Switch wide trunk protocol
username Configure user information.
vsan Enter the vsan configuration mode
wwn Set secondary base MAC addr and range for additional WWNs
zone Zone configuration commands
zone-attribute-group Zone attribute group commands
zoneset 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 Description
Ctrl-P Up history
Ctrl-N Down history
Ctrl-X-H List history
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-11
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Understanding CLI Command Hierarchy
Table 1-3 displays the commonly used configuration submodes for the Cisco MDS 9000 Family.
Alt-P 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 History search forwards
Ctrl-G Exit
Ctrl-Z End
Ctrl-L Clear screen
Table 1-2 Useful Command Key Description (continued)
Command Description
Table 1-3 Submodes Within the Configuration Mode for the Cisco MDS 9000 Family
Submode Name From Configuration Mode Enter Submode Prompt Configured Information
Call Home callhome
switch(config-callhome)#
Contact, destination, and e-mail
FCS Registration fcs register
switch(config-fcs-register)#
FCS attribute registration
From FCS registration submode:
platform name name vsan
vsan-id
switch(config-fcs-register-att
rib)#
Platform name and VSAN ID
association
Fibre Channel alias fcalias name name vsan vsan-id
switch(config-fcalias)#
Alias member
FSPF fspf config vsan vsan-id
switch(config-(fspf-config))#
Static SPF computation, hold
time, and autonomous region
Interface
configuration
interface type slot/port
switch(config-if)#
Channel groups, Fibre Channel
domains, FSPF parameters,
switch port trunk and beacon
information, and IP address
From the VSAN or mgmt0
(management) interface
configuration submode:
vrrp number
switch(config-if-vrrp)#
Virtual router
iSCSI target iscsi virtual-target name
switch(config-iscsi-tgt)
iSCSI virtual target
iSLB initiator islb initiator
switch(config-islb-init)#
iSCSI server load balancing
(iSLB) initiator
iSLB target islb virtual-target name
switch(config-islb-tgt)
iSCSI server load balancing
(iSLB) virtual target
Line console line console
switch(config-console)#
Primary terminal console
VTY line vty
switch(config-line)#
Virtual terminal line
Role role name
switch(config-role)#
Rule
SPAN span session number
switch(config-span)#
SPAN source, destination, and
suspend session information
VSAN database vsan database
switch(config-vsan-db)#
VSAN database
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-12
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Understanding CLI Command Hierarchy
Table 1-4 displays the commonly used configuration submodes for the Cisco Fabric Switch for HP
c-Class BladeSystem and the Cisco Fabric Switch for IBM BladeCenter.
Zone zone name string vsan vsan-id
switch(config-zone)#
Zone member
Zone set zoneset name name vsan
vsan-id
switch(config-zoneset)#
Zone set member
SDV virtual device sdv virtual-device name
device-name vsan vsan-id
switch(config-sdv-virt-dev)#
SAN Device Virtualization
information
Table 1-3 Submodes Within the Configuration Mode for the Cisco MDS 9000 Family (continued)
Submode Name From Configuration Mode Enter Submode Prompt Configured Information
Table 1-4 Submodes Within the Configuration Mode for the Cisco Cisco Fabric Switch for HP c-Class BladeSystem
and the Cisco Fabric Switch for IBM BladeCenter
Submode Name From Configuration Mode Enter Submode Prompt Configured Information
Call Home callhome
switch(config-callhome)#
Contact, destination, and e-mail
FCS Registration fcs register
switch(config-fcs-register)#
FCS attribute registration
From FCS registration submode:
platform name name vsan
vsan-id
switch(config-fcs-register-att
rib)#
Platform name and VSAN ID
association
Fibre Channel alias fcalias name name vsan vsan-id
switch(config-fcalias)#
Alias member
FSPF fspf config vsan vsan-id
switch(config-(fspf-config))#
Static SPF computation, hold
time, and autonomous region
Interface
configuration
interface type slot/port
switch(config-if)#
Channel groups, Fibre Channel
domains, FSPF parameters,
switch port trunk and beacon
information, and IP address
From the VSAN or mgmt0
(management) interface
configuration submode:
vrrp number
switch(config-if-vrrp)#
Virtual router
Line console line console
switch(config-console)#
Primary terminal console
VTY line vty
switch(config-line)#
Virtual terminal line
Role role name
switch(config-role)#
Rule
SPAN span session number
switch(config-span)#
SPAN source, destination, and
suspend session information
VSAN database vsan database
switch(config-vsan-db)#
VSAN database
Zone zone name string vsan vsan-id
switch(config-zone)#
Zone member
Zone set zoneset name name vsan
vsan-id
switch(config-zoneset)#
Zone set member
SDV virtual device sdv virtual-device name
device-name vsan vsan-id
switch(config-sdv-virt-dev)#
SAN device virtualization
information
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-13
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Navigating Through CLI Commands
Note SPAN is only supported on external ports.
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 fcs
fcanalyzer fcdroplatency fcns fctimer
fcc fcinterop fcroute
switch(config)# fcd<Tab>
fcdomain fcdroplatency
switch(config)# fcdo<Tab>
switch(config)# fcdomain
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-14
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Navigating Through CLI Commands
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.
Port Names and Port Mapping
The Cisco Fabric Switch for HP c-Class BladeSystem has a different port naming convention from the
Cisco MDS 9000 Family. It has eight external ports and they are labeled ext1 through ext8. It has 16
internal ports and they are labeled bay1 through bay16.
Table 1-5 shows the port mapping between the Cisco MDS 9000 Family and the Cisco Fabric Switch for
HP c-Class BladeSystem.
Table 1-5 Port Mapping Between the Cisco MDS 9000 Family and the Cisco Fabric Switch for HP
c-Class BladeSystem
Cisco MDS 9000 Family Port
Cisco Fabric Switch for HP
c-Class BladeSystem Port Port Group
fc1/1 ext8 PortGroup 1
fc1/2 bay6
fc1/3 bay13
fc1/4 bay5
fc1/5 ext7 PortGroup 2
fc1/6 bay14
fc1/7 bay15
fc1/8 bay7
fc1/9 bay4 PortGroup 3
fc1/10 ext1
fc1/11 bay3
fc1/12 bay11
fc1/13 bay12 PortGroup 4
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-15
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Navigating Through CLI Commands
The Cisco Fabric Switch for IBM BladeCenter has a different port naming convention from the Cisco
MDS 9000 Family. There are six external ports and they are labeled ext0 and ext15 through ext19. There
are 14 internal ports and they are labeled bay1 through bay14. Table 1-6 shows the port mapping between
the Cisco MDS 9000 Family switches and the Cisco Fabric Switch for IBM BladeCenter switches.
fc1/14 ext2
fc1/15 bay2
fc1/16 bay1
fc1/17 bay10 PortGroup 5
fc1/18 ext3
fc1/19 bay9
fc1/20 ext 4
fc1/21 bay16 PortGroup 6
fc1/22 bay8
fc1/23 ext6
fc1/24 ext5
Table 1-5 Port Mapping Between the Cisco MDS 9000 Family and the Cisco Fabric Switch for HP
c-Class BladeSystem (continued)
Cisco MDS 9000 Family Port
Cisco Fabric Switch for HP
c-Class BladeSystem Port Port Group
fc1/1 ext8 PortGroup 1
Table 1-6 Port Mapping Between the Cisco MDS 9000 Family and the Cisco Fabric Switch for
IBM BladeCenter
Cisco MDS 9000 Family Port
Cisco Fabric Switch for IBM
BladeCenter Port Port Group
fc1/1 ext19 PortGroup 1
fc1/2 bay10
fc1/3 bay11
fc1/4 bay12
fc1/5 ext18 PortGroup 2
fc1/6 bay9
fc1/7 bay13
fc1/8 bay14
fc1/9 bay8 PortGroup 3
fc1/10 ext17
fc1/11 bay6
fc1/12 bay5
fc1/13 bay7 PortGroup 4
fc1/14 ext16
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-16
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Navigating Through CLI Commands
When you enter commands that require port names for the Cisco Fabric Switch for HP c-Class
BladeSystem or the Cisco Fabric Switch for IBM BladeCenter, use the appropriate naming convention
from either Table 1-5 or Table 1-6. See Example 1-2 and Example 1-3 for typical commands that require
port names.
Example 1-2 interface Command
switch# config t
Enter configuration commands, one per line. End with CNTL/Z.
chester-1(config)# interface ext2
chester-1(config-if)#
Example 1-3 show interface Command
switch# show interface bay 5
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.
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.
fc1/15 bay4
fc1/16 bay2
fc1/17 bay3 PortGroup 5
fc1/18 ext0
fc1/19 bay1
fc1/20 ext15
Table 1-6 Port Mapping Between the Cisco MDS 9000 Family and the Cisco Fabric Switch for
IBM BladeCenter (continued)
Cisco MDS 9000 Family Port
Cisco Fabric Switch for IBM
BladeCenter Port Port Group
fc1/1 ext19 PortGroup 1
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-17
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Navigating Through CLI Commands
Examples 1-4 to 1-10 display a few show command examples.
Example 1-4 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
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-5 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-2006, Cisco Systems, Inc. All rights reserved.
The copyrights to certain works contained herein are owned by
other third parties and are used and distributed under license.
Some parts of this software may be covered under the GNU Public
License or the GNU Lesser General Public License. A copy of
each such license is available at
http://www.gnu.org/licenses/gpl.html and
http://www.gnu.org/licenses/lgpl.html
Software
BIOS: version 1.1.0
loader: version 1.2(2)
kickstart: version 3.0(3) [gdb]
system: version 3.0(3) [gdb]
BIOS compile time: 10/24/03
kickstart image file is: bootflash:///boot-3.0.3
kickstart compile time: 9/15/2006 10:00:00 [10/02/2006 06:26:25]
system image file is: bootflash:///isan-3.0.3
system compile time: 9/15/2006 10:00:00 [10/02/2006 06:45:25]
Hardware
cisco MDS 9509 ("Supervisor/Fabric-1")
Intel(R) Pentium(R) III CPU with 1028604 kB of memory.
bootflash: 251904 kB
slot0: 251904 kB
172.22.31.238 kernel uptime is 0 days 0 hour 2 minute(s) 2 second(s)
Last reset at 744021 usecs after Tue Oct 21 14:55:11 1980
Reason: Reset Requested by CLI command reload
System version: 4.0(0.432)
Service:
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-18
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Navigating Through CLI Commands
Example 1-6 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
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-7 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-8 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.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-19
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Searching and Filtering CLI Output
Example 1-9 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
Example 1-10 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.
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 NX-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.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-20
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Searching and Filtering CLI Output
Note The show command is always entered in EXEC mode.
When output continues beyond what is displayed on your screen, the Cisco MDS NX-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:
Note Cisco MDS NX-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:
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-21.
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.
Command Purpose
switch# show any-command | begin pattern
Begins unfiltered output of the show command with
the first line that contains the pattern.
Command Purpose
switch# show any-command | exclude pattern
Displays output lines that do not contain the pattern.
switch# show any-command | include pattern
Displays output lines that contain the pattern.
switch# show any-command | include pattern1|pattern2
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.
switch# show any-command | count number
Displays the number lines of output in the display.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-21
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Searching and Filtering CLI Output
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-21.
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 0x680000 dynamic
vsan 1 wwn 28:0f:00:05:30:00:06:ea fcid 0x680001 dynamic
vsan 1 wwn 28:10:00:05:30:00:06:ea fcid 0x680002 dynamic
vsan 1 wwn 28:11:00:05:30:00:06:ea fcid 0x680003 dynamic
vsan 1 wwn 28:12:00:05:30:00:06:ea fcid 0x680004 dynamic
vsan 1 wwn 28:13:00:05:30:00:06:ea fcid 0x680005 dynamic
vsan 1 wwn 28:14:00:05:30:00:06:ea fcid 0x680006 dynamic
vsan 1 wwn 28:1f:00:05:30:00:06:ea fcid 0x680007 dynamic
vsan 1 wwn 28:20:00:05:30:00:06:ea fcid 0x680008 dynamic
vsan 1 wwn 21:00:00:e0:8b:05:76:28 fcid 0x680100 area dynamic
vsan 1 wwn 20:c5:00:05:30:00:06:de fcid 0x680200 area dynamic
vsan 1 wwn 28:2b:00:05:30:00:06:ea fcid 0x680012 dynamic
vsan 1 wwn 28:2d:00:05:30:00:06:ea fcid 0x680013 dynamic
vsan 1 wwn 28:2e:00:05:30:00:06:ea fcid 0x680014 dynamic
vsan 1 wwn 28:2f:00:05:30:00:06:ea fcid 0x680015 dynamic
vsan 1 wwn 28:30:00:05:30:00:06:ea fcid 0x680016 dynamic
--More--
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 -- -- --
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-22
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Searching and Filtering CLI Output
fc4/12 1 FX -- sfpAbsent -- -- --
fc4/13 1 FX -- sfpAbsent -- -- --
fc4/14 1 FX -- sfpAbsent -- -- --
fc4/15 1 FX -- sfpAbsent -- -- --
--More--
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
fc4/2 is down (SFP not present)
Hardware is Fibre Channel
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-23
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Searching and Filtering CLI Output
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 swl F 1 --
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 swl -- --
fc4/29 1 FX -- sfpAbsent -- -- --
fc4/30 1 FX -- sfpAbsent -- -- --
fc4/31 1 FX -- sfpAbsent -- -- --
fc4/32 1 FX -- sfpAbsent -- -- --
switch#
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#
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.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-24
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Searching and Filtering CLI Output
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 Jan 12 20:56 (10.77.202.149)
admin pts/9 Jan 12 23:29 (modena.cisco.com)
admin pts/11 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.
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>
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-25
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Searching and Filtering CLI Output
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
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
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-26
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Searching and Filtering CLI Output
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.
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
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-27
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Using CLI Variables
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
Using CLI Variables
The NX-OS CLI parser supports definition and use of variables in CLI commands. CLI variables can be
used as follows:
Entered directly on the command line.
Passed to the child script initiated using the run-script command. The variables defined in the
parent shell are available for use in the child run-script command process.
Passed as command line arguments to the run-script command.
CLI variables have the following characteristics:
You cannot reference a variables through another variable using nested references.
You can define persistent variables that are available across switch reloads.
You can reference only one predefined system variable, the TIMESTAMP variable.
User-Defined CLI Session Variables
You can define CLI variables the persist only for the duration of your CLI session using the cli var name
command in EXEC mode. These CLI variables are useful for scripts that you execute periodically.
The following example shows how to create a user-defined CLI session variable:
switch# cli var name testinterface fc 1/1
You can reference a variable using the syntax $(variable).
The following example shows how to reference a user-defined CLI session variable:
switch# show interface $(testinterface)
fc1/1 is up
Hardware is Fibre Channel, SFP is short wave laser w/o OFC (SN)
Port WWN is 20:01:00:0d:ec:0e:1d:00
Admin port mode is auto, trunk mode is on
snmp traps are enabled
Port mode is F, FCID is 0x01000b
Port vsan is 1
Speed is 2 Gbps
Transmit B2B Credit is 7
Receive B2B Credit is 16
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-28
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Using CLI Variables
Receive data field Size is 2112
Beacon is turned off
5 minutes input rate 256 bits/sec, 32 bytes/sec, 1 frames/sec
5 minutes output rate 256 bits/sec, 32 bytes/sec, 1 frames/sec
232692 frames input, 7447280 bytes
0 discards, 0 errors
0 CRC, 0 unknown class
0 too long, 0 too short
232691 frames output, 7448692 bytes
0 discards, 0 errors
0 input OLS, 0 LRR, 0 NOS, 0 loop inits
1 output OLS, 1 LRR, 0 NOS, 1 loop inits
16 receive B2B credit remaining
7 transmit B2B credit remaining
Use the show cli var command to display user-defined CLI session variable:
The following example displays user-defined CLI session variables:
switch# show cli variables
VSH Variable List
-----------------
TIMESTAMP="2005-10-24-21.29.33"
testinterface="fc 1/1"
Use the cli no var name command to remove user-defined CLI session variables:
The following example removes a user-defined CLI session variable:
switch# cli no var name testinterface
User-Defined CLI Persistent Variables
You can define CLI variables the persist across CLI sessions and switch reloads using the cli var name
command in configuration mode. These CLI variables are configured in the configuration mode and are
saved in the running configuration file.
The following example shows how to create a user-defined CLI persistent variable:
switch# config t
switch(config)# cli var name mgmtport mgmt 0
switch(config)# exit
switch#
You can reference a variable using the syntax $(variable).
The following example shows how to reference a user-defined CLI persistent variable:
switch# show interface $(mgmtport)
mgmt0 is up
Hardware is FastEthernet
Address is 000e.38c6.2c6c
Internet address is 10.10.10.1/24
MTU 1500 bytes, BW 100 Mbps full Duplex
288996 packets input, 97746406 bytes
0 multicast frames, 0 compressed
0 input errors, 0 frame, 0 overrun 0 fifo
9089 packets output, 1234786 bytes, 0 underruns
0 output errors, 0 collisions, 0 fifo
0 carrier errors
Use the show cli var command to display user-defined CLI persistent variable.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-29
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Using Command Aliases
The following example displays user-defined CLI persistent variables:
switch# show cli variables
VSH Variable List
-----------------
TIMESTAMP="2005-10-24-21.37.13"
mgmtport="mgmt 0"
Use the no cli var name command in configuration mode to remove user-defined CLI persistent
variables.
The following example removes a user-defined CLI persistent variable:
switch# config t
switch(config)# no cli var name mgmtport
System Defined Variables
Cisco MDS SAN-OS supports one predefined variable: TIMESTAMP. This variable refers to the time of
execution of the command in the format YYYY-MM-DD-HH.MM.SS.
Note The TIMESTAMP variable name is case sensitive. All letters must be uppercase.
The following example uses $(TIMESTAMP) when periodically gathering statistics into files using the
command scheduler:
switch# config t l
switch(config)# scheduler enable
switch(config)# scheduler logfile size 16
switch(config)# scheduler job name j1
switch(config-job)# show interface mgmt0 | include mgmt > file
switch(config-job)# copy volatile:file bootflash:file.$(TIMESTAMP)
switch(config-job)# end
switch(config)#
The following example uses $(TIMESTAMP) when redirecting show command output to a file:
switch# show running-config > rcfg.$(TIMESTAMP)
Preparing to copy....done
switch# dir volatile:
7231 Oct 03 20:20:42 2005 rcfg.2005-10-03-20.20.42
Usage for volatile://sup-local
8192 bytes used
20963328 bytes free
20971520 bytes total
Using Command Aliases
Command alias support has the following characteristics:
Command aliases are global for all user sessions.
Command aliases are persist across reboots.
Commands being aliased must be typed in full without abbreviation.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-30
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
About Flash Devices
Command alias translation always takes precedence over any keyword in any configuration mode or
submode.
Command alias support is only available on the supervisor module, not the switching modules.
Command alias configuration takes effect for other user sessions immediately.
You cannot override the default command alias alias, which aliases the show cli alias.
Nesting of command aliases is permitted to a maximum depth of 1. One command alias can refer to
another command alias that must refer to a valid command, not to another command alias.
A command alias always replaces the first command keyword on the command line.
You can define command aliases for commands in any configuration submode or the EXEC mode.
Defining Command Aliases
You can define command aliases using the cli alias name command in configuration mode.
This following example shows how to define command aliases.
switch# config t
switch(config)# cli alias name gigint interface gigabitethernet
switch(config)# cli alias name shintbr show interface brief
switch(config)# cli alias name shfcintup "shintbr| include up | include fc"
You can display the command aliases defined on the switch using the alias default command alias.
The following example shows how to display the command aliases defined on the switch.
switch# alias
CLI alias commands
==================
alias :show cli alias
gigint :interface gigabitethernet
shintbr :show interface brief
shfcintup :shintbr | include up | include fc
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).
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-31
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Formatting Flash Disks and File Systems
Figure 1-2 Flash Devices in the Cisco MDS 9000 Supervisor Module
Figure 1-3 External CompactFlash in the Cisco MDS 9000 Supervisor Module
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.
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-30 and Using the File System section on page 1-32 for additional information).
External
CompactFlash
7
9
5
2
7
Internal
bootflash
Internal
bootflash
Cisco MDS 9500 Series Director
Slot 0
Cisco MDS 9216 Switch
8
5
6
0
3
CompactFlash 1
LED
CompactFlash 1
eject button
CompactFlash 1
slot 0
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-32
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Using the File System
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 NX-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.
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-33
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-33
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Using the File System
Displaying the Current Directory, page 1-33
Listing the Files in a Directory, page 1-33
Creating a New Directory, page 1-34
Deleting an Existing Directory, page 1-34
Moving Files, page 1-34
Copying Files, page 1-35
Deleting Files, page 1-35
Displaying File Contents, page 1-35
Saving Command Output to a File, page 1-36
Compressing and Uncompressing Files, page 1-36
Displaying the Last Line in a File, page 1-37
Executing Commands Specified in a Script, page 1-37
Setting the Delay Time, page 1-38
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 is 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
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
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-34
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Using the File System
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.
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.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-35
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Using the File System
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.
Deleting Files
The delete command deletes a specified file or the specified directory and all its contents.
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
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
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-36
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Using the File System
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.
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.
Directing show Command Output to a File
You can direct show command output to a file, either on the volatile file system, on slot0 CompactFlash
memory, or on a remote server.
The following example shows how to direct the show running-config output to a file on the volatile file
system.
switch1# show running-config > volatile:switch1-run.cfg
The following example shows how to direct the show running-config output to a file on slot0
CompactFlash memory.
switch2# show running-config > slot0:switch2-run.cfg
The following example shows how to direct the show running-config output to a file on a TFTP server.
switch3# show running-config > tftp://10.10.1.1/home/suser/switch3-run.cfg
Preparing to copy...done
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.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-37
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Using the File System
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
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
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-38
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Role-Based CLI
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
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.
Send document at i on comment s t o mdsf eedback- doc@ci sco. com
1-39
Cisco MDS 9000 Family Command Reference
OL-19352-02, Cisco MDS NX-OS Release 4.x
Chapter 1 CLI Overview
Using Valid Formats and Ranges
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-7.
Table 1-7 Valid Formats and Ranges
Address Description Valid Format Example Range
MAC address 6 bytes in hexadecimal format separated by colons
(not case-sensitive) .
00:00:0c:24:d2:Fe
IP address 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.
126.2.54.1
VSAN Integer that specifies the VSAN. 7 1 to 4093
VLAN Integer that specifies the VLAN. 11 1 to 4093
Port WWN
(pWWN)
Eight hexadecimal numbers separated by colons (not
case-sensitive).
12:34:56:78:9A:BC:dE:F1
Node WWN
(nWWN)
Eight hexadecimal numbers separated by colons (not
case-sensitive).
12:34:56:78:9A:BC:dE:F1
LUN 8 bytes in hexadecimal format separated by colons. A
minimum of two hex characters are acceptable. The
valid format is hhhh[:hhhh[:hhhh[:hhhh]]].
64
(100d = 64h)