cisco mds 9000 family command reference, release 4.x

Send documenta t ion comments to mdsfeedback -doc@c i sco .comAmericas HeadquartersCisco Systems, Inc.170 West Tasman DriveSan Jose, CA 95134-1706 USAhttp://www.cisco.comTel: 408 526-4000

800 553-NETS (6387)Fax: 408 527-0883

Cisco MDS 9000 Family Command Reference, Release 4.xCisco MDS NX-OS Release 4.2(7a)

August 2010

Text Part Number: OL-19352-02

Send documenta t ion comments to mdsfeedback -doc@c i sco .comTHE 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 documenta t ion comments to mdsfeedback -doc@c i sco .com

OL-19352-02, Cisco MDS NX-OS Release 4.x

Getting Help 1-13Command CompletioUsing the no and DePort Names and Porn 1-13C O N T E N T S

New and Changed Information xxxiii

Preface lxv

Audience lxv

Organization lxv

Document Conventions lxvi

Related Documentation 1-lxviiRelease Notes 1-lxviiRegulatory Compliance and Safety Information 1-lxviiCompatibility Information 1-lxviiHardware Installation 1-lxviiiSoftware Installation and Upgrade 1-lxviiiCisco NX-OS 1-lxviiiCisco Fabric Manager 1-lxviiiCommand-Line Interface 1-lxixIntelligent Storage Networking Services Configuration Guides 1-lxixTroubleshooting and Reference 1-lxix

C H A P 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-4EXEC Mode Options 1-5

EXEC Mode Commands for the Cisco MDS 9000 Family 1-5EXEC 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-7Configuration Mode Commands for the Cisco MDS 9000 Family 1-7Configuration 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-13iiiCisco MDS 9000 Family Command Reference

fault Forms of Commands 1-14t Mapping 1-14


ContentsEntering CLI Commands 1-16Viewing Switch Configurations 1-16Saving a Configuration 1-19Clearing a Configuration 1-19

Searching and Filtering CLI Output 1-19Multiple Filter Commands 1-20Searching and Filtering CLI Output Examples 1-21Displaying Users 1-24Sending Messages to Users 1-24Using the ping Command 1-24Using traceroute 1-24Setting the Switchs Shell Timeout 1-25

Displaying VTY Sessions 1-25Clearing VTY Sessions 1-26

Setting the Switchs Terminal Timeout 1-26Setting the Switchs Terminal Type 1-26Setting the Switchs Terminal Length 1-26Setting the Switchs Terminal Width 1-26Displaying Terminal Settings 1-27

Using CLI Variables 1-27User-Defined CLI Session Variables 1-27User-Defined CLI Persistent Variables 1-28System Defined Variables 1-29

Using Command Aliases 1-29Defining Command Aliases 1-30

About Flash Devices 1-30Internal bootflash: 1-31External CompactFlash (Slot0) 1-31

Formatting Flash Disks and File Systems 1-31Initializing bootflash: 1-32Formatting Slot0: 1-32

Using the File System 1-32Setting the Current Directory 1-33Displaying the Current Directory 1-33Listing the Files in a Directory 1-33Creating a New Directory 1-34Deleting an Existing Directory 1-34Moving Files 1-34Copying Files 1-35ivCisco MDS 9000 Family Command Reference



ContentsDeleting Files 1-35Displaying File Contents 1-35Saving Command Output to a File 1-36Directing show Command Output to a File 1-36Compressing and Uncompressing Files 1-36Displaying the Last Line in a File 1-37Executing Commands Specified in a Script 1-37Setting the Delay Time 1-38

Role-Based CLI 1-38

Using Valid Formats and Ranges 1-39

Using Debug Commands 1-40Generating debug Command Output 1-41Redirecting debug and Error Message Output 1-41

Enabling Message Logging 1-42Setting the Message Logging Levels 1-42Limiting the Types of Logging Messages Sent to the Console 1-43Logging Messages to an Internal Buffer 1-43Limiting the Types of Logging Messages Sent to Another Monitor 1-43Logging Messages to a UNIX Syslog Server 1-44Limiting Messages to a Syslog Server 1-44

C H A P 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-21vCisco MDS 9000 Family Command Reference



Contentsaction 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

C H A P 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

C H A P 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-16viCisco MDS 9000 Family Command Reference



Contentscfs 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-57viiCisco MDS 9000 Family Command Reference



Contentsclear 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-94viiiCisco MDS 9000 Family Command Reference



Contentsclear 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-146ixCisco MDS 9000 Family Command Reference



Contentscrypto 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

C H A P 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-35xCisco MDS 9000 Family Command Reference



Contentsdistribute 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

C H A P 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-29xiCisco MDS 9000 Family Command Reference



Contentsdebug 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-85xiiCisco MDS 9000 Family Command Reference



Contentsdebug 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

C H A P T E R 7 E Commands 7-1

egress-sa 7-2xiiiCisco MDS 9000 Family Command Reference



Contentsemail-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

C H A P 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-25xivCisco MDS 9000 Family Command Reference



Contentsfcdomain 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-73xvCisco MDS 9000 Family Command Reference



Contentsficon 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

C H A P T E R 9 G Commands 9-1

group 9-2

gzip 9-3

gunzip 9-5

C H A P T E R 10 H Commands 10-1

hash 10-2

host 10-3

host 10-4

hw-module logging onboard 10-6

C H A P 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-7xviCisco MDS 9000 Family Command Reference



Contentsinstall 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-61xviiCisco MDS 9000 Family Command Reference



Contentsips 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-113xviiiCisco MDS 9000 Family Command Reference



Contentsislb 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

C H A P T E R 12 J Commands 12-1

job name 12-2

C H A P T E R 13 K Commands 13-1

keepalive 13-2

kernel core 13-3xixCisco MDS 9000 Family Command Reference



Contentskey (sa configuration submode) 13-5

key 13-6

key-ontape 13-8

C H A P 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

C H A P 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-15xxCisco MDS 9000 Family Command Reference



Contentsmodem 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

C H A P 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

C H A P 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

C H A P 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-6xxiCisco MDS 9000 Family Command Reference



Contentsperiodic-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-55xxiiCisco MDS 9000 Family Command Reference



Contentspwwn (fcdomain database configuration submode) 18-56

pwwn (SDV virtual device configuration submode) 18-57

C H A P 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

C H A P 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-32xxiiiCisco MDS 9000 Family Command Reference



Contentsrole 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

C H A P 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-31xxivCisco MDS 9000 Family Command Reference



Contentssetup 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-77xxvCisco MDS 9000 Family Command Reference



Contentsstreetaddress 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-130xxviCisco MDS 9000 Family Command Reference



Contentssystem 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

C H A P 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-42xxviiCisco MDS 9000 Family Command Reference



Contentsshow 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-95xxviiiCisco MDS 9000 Family Command Reference



Contentsshow 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-164xxixCisco MDS 9000 Family Command Reference



Contentsshow 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-228xxxCisco MDS 9000 Family Command Reference



Contentsshow 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-322xxxiCisco MDS 9000 Family Command Reference



Contentsshow 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-394xxxiiCisco MDS 9000 Family Command Reference



Contentsshow 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-471xxxiiiCisco MDS 9000 Family Command Reference



Contentsshow wwn 22-474

show zone 22-475

show zone analysis 22-479

show zone-attribute-group 22-484

show zoneset 22-485

C H A P 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-40xxxivCisco MDS 9000 Family Command Reference



Contentstcp 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

C H A P 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

C H A P 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

C H A P T E R 26 W Commands 26-1

write command-id 26-2

write-accelerator 26-4xxxvCisco MDS 9000 Family Command Reference



Contentswrite erase 26-6

wwn secondary-mac 26-7

wwn vsan 26-8

C H A P 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-27xxxviCisco MDS 9000 Family Command Reference


Send documenta t ion comments to mdsfeedback -doc@c i sco .comNew 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 commandshow logging onboard request-timeout commandshow process creditmon command Show Commandsshow logging onboard credit-loss commandshow logging onboard timeout-drops commandcounter tx-credit-not-available command

C Commands

counter credit-loss-reco commandcounter timeout-discards commandxxxiiiCisco MDS 9000 Family Command Reference


show port-monitor active command Show Commandsshow system internal snmp credit-not-available commandshow port internal info interface fc commandshow port-monitor command


New and Changed Information

Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference counter lr-rx command C Commandsmonitor 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 Commandserrdisable detect cause credit-loss commanderrdisable detect cause link-reset commanderrdisable detect cause signal-loss commanderrdisable detect cause sync-loss commanderrdisable detect cause trustsec-violation commandfeature command(Added ioa keyword to the syntax description)

F Commands

AAA Enhancement show aaa authentication login mschapv2 command

Show Commands

show aaa authorization all commandclear tacacs-server statistics command C Commandsclear radius-server statistics commandaaa authentication login mschapv2 enable command

A Commands

aaa authorization commandtest aaa authorization command T Commandsterminal verify-user command

FC-redirect with IVR show ivr aam pre-deregister-check command show CommandsFC-ID Visibility show fcns database command

(Changed the command output)show Commands

IOA ioa site-local command I Commandsioa cluster commandinterface ioa command

Feature Description Where DocumentedxxxivCisco MDS 9000 Family Command Reference




Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference load-balancing (Cisco IOA cluster Configuration submode) command

L Commands

nport command N Commandsnode (Cisco IOA cluster node configuration submode) commandflowgroup command F Commandshost command H commandstune commandshow ioa internal interface ioa command Show Commandsshow ioa cluster summary commandshow interface ioa commandshow ioa cluster command

Port Group Monitoring show port-monitor active command show Commandsshow port-group-monitor commandshow port-group-monitor status commandport-group-monitor activate command P Commandsport-group-monitor name commandport-group-monitor enable commandport-group-monitor counter commandmonitor counter command M Commands

Trustsec show running-config fcsp command show Commandsshow fcsp interface commandfcsp esp sa command F Commandsfcsp commandingress-sa command I commandsinterface fc commandegress-sa command E Commandsmode command M Commandskey (sa configuration submode) command K Commandssalt (sa configuration submode) command S Commands

New and Changed Commands for Cisco NX-OS Release 4.1(3a)

Feature Description Where DocumentedxxxvCisco MDS 9000 Family Command Reference




Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference 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 CommandsPort Owner switchport owner command S CommandsF 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 CommandsF port Channeling show port-channel compatibility-parameters

commandShow Commands

show port-channel consistency commandshow port-channel database commandshow port-channel internal commandshow port-channel summary commandshow port-channel usage commandchannel-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

Feature Description Where DocumentedxxxviCisco MDS 9000 Family Command Reference




Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference 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 Commandserrdisable detect cause bit-errors commandevent manager policy commandevent manager environment commanddescription command D Commandsshow event manager policy command Show Commandsshow event manager environment commandaction cli command A Commandsaction counter commandaction event-default commandaction exception log commandaction forceshut commandaction overbudgetshut commandaction policy-defaultcommandaction reload commandaction snmp-trap commndaction syslog commandAdded SME Commands

SME scaling batch enable command S Commands

Feature Description Where DocumentedxxxviiCisco MDS 9000 Family Command Reference




Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference 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 commandsystem delayed-traps enable mode command

system health system health clear-errors command S CommandsPort-monitor show port-monitor status command Show Commands

show port-resources module commandSNMP show system internal snmp lc commandScheduler scheduler command

(Added a Note)S Commands

SSM ssm upgrade delay command S CommandsSANTap show isapi tech-support santap file command

(Added usage guidelines)Show Commands

show santap module dvt commandshow santap module dvtlun commandshow santap vttbl dvt commandshow santap vttbl dvt host command

SDV show sdv command(Changed the command output)

Show Commands

attribute failover auto command A CommandsGeneral Configuration feature command F CommandsDPVM clear dpvm merge statistics command C Commands

show dpvm merge statistics command Show Commandsshow dpvm merge status commanddpvm 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

Feature Description Where DocumentedxxxviiiCisco MDS 9000 Family Command Reference




Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference 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 Commandsshow 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 Commandsdpvm enable command D Commandsfabric-binding enable command F Commandsfcip enable commandfcsp enable commandficon enable commandivr enable command I Commandsport-security enable command P Commandssdv enable command S Commandstacacs+ enable command T CommandsAdded DMM Commands

Feature Description Where DocumentedxxxixCisco MDS 9000 Family Command Reference




Table 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference 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 CommandsSME 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

Feature Description Where DocumentedxlCisco MDS 9000 Family Command Reference


Send documenta t ion comments to mdsfeedback -doc@c i sco .comPreface

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.

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

OrganizationThis 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.lxvCisco MDS 9000 Family Command Reference


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.


PrefaceDocument ConventionsCommand 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 CommandsDescribes 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.lxviCisco MDS 9000 Family Command Reference



PrefaceRelated 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 DocumentationThe 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

SoftwarelxviiCisco MDS 9000 Family Command Reference



PrefaceRelated DocumentationHardware 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 GuidelxviiiCisco MDS 9000 Family Command Reference



PrefaceRelated 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 SchemalxixCisco MDS 9000 Family Command Reference



PrefaceRelated DocumentationlxxCisco MDS 9000 Family Command Reference



OL-19352-02, Cisco MDS NX-OS Release 4.xC H A P T E R 1CLI 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-401-1Cisco MDS 9000 Family Command Reference


Chapter 1 CLI Overview About the Switch PromptAbout the Switch PromptIf 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 bootingChecking all filesystems..... done.Loading system softwareUncompressing system image: bootflash:/system_imageCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCINIT: Entering runlevel: 3

---- Basic System Configuration Dialog ----

This setup utility will guide you through the basic configuration ofthe system. Use ctrl-c to abort configuration dialog at any prompt.

Basic management setup configures only enough connectivity formanagement of the system.

Would you like to enter the basic configuration dialog (yes/no): yes

switch login:1-2Cisco MDS 9000 Family Command Reference



Chapter 1 CLI Overview About the CLI Command ModesAbout the CLI Command ModesSwitches 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)#1-3Cisco MDS 9000 Family Command Reference



Chapter 1 CLI Overview Understanding CLI Command HierarchyUnderstanding CLI Command HierarchyThe 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 terminalEnter configuration commands, one per line. End with CNTL/Z.switch(config)# interface fc1/1switch(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 eraseconfigure

clock zoneset interface

fspf switchport

EXEC mode

Configuration mode

Configuration submode

exit

exit

end

7952

51-4Cisco MDS 9000 Family Command Reference



Chapter 1 CLI Overview Understanding CLI Command HierarchyEXEC Mode OptionsWhen 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 system1-5Cisco MDS 9000 Family Command Reference



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 license1-6Cisco MDS 9000 Family Command Reference




write Write current configuration

zone Execute Zone Server commands zoneset Execute zoneset commands

Configuration Mode OptionsConfiguration 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 terminalEnter 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 terminalEnter 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 latency1-7Cisco MDS 9000 Family Command Reference




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

cisco mds 9000 family command reference, release 4.x

Documents

cisco logo

cisco representative

cisco fabric switch

trademarks of cisco

family command reference

documenta t ion comments

c i sco

safety information