CR03

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o m

Cisco MDS 9000 Family Command Reference, Release 4.xCisco MDS NX-OS Release 4.1(3) February 2009

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

Text Part Number: OL-18089-01


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. CCDE, CCENT, Cisco Eos, Cisco HealthPresence, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries. All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0812R) Cisco MDS 9000 Family Command Reference ! 2009 Cisco Systems, Inc. All rights reserved.


CONTENTSNew and Changed Information Prefacelxv lxv lxv lxvi xxxiii

Audience

Organization

Document Conventions

Related Documentation lxvii Release Notes lxvii Compatibility Information lxvii Regulatory Compliance and Safety Information lxvii Hardware Installation lxvii Cisco Fabric Manager lxviii Command-Line Interface lxviii Intelligent Storage Networking Services Configuration Guides Troubleshooting and Reference lxviii Installation and Configuration Note lxix Obtaining Documentation and Submitting a Service RequestCHAPTER

lxviii

lxix

1

CLI Overview

1-1 1-2 1-3

About the Switch Prompt

About the CLI Command Modes

Understanding CLI Command Hierarchy 1-4 EXEC Mode Options 1-5 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 Port Names and Port Mapping 1-14

1-14

Cisco MDS 9000 Family Command Reference OL-18089-01, Cisco MDS NX-OS Release 4.x

iii

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mEntering CLI Commands 1-16 Viewing Switch Configurations Saving a Configuration 1-19 Clearing a Configuration 1-19

1-16

Searching and Filtering CLI Output 1-20 Multiple Filter Commands 1-21 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-25 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-27 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-30 Defining Command Aliases About Flash Devices 1-30 Internal bootflash: 1-31 External CompactFlash (Slot0)1-30

1-31 1-31

Formatting Flash Disks and File Systems 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-34 Creating a New Directory 1-34 Deleting an Existing Directory 1-34 Moving Files 1-34 Copying Files 1-35Cisco MDS 9000 Family Command Reference

iv

OL-18089-01, Cisco MDS NX-OS Release 4.x

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mDeleting 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 CLI1-38 1-39

Using Valid Formats and Ranges

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-44CHAPTER

2

A Commands

2-1 2-2 2-3 2-4 2-5

aaa accounting logsize aaa accounting default

aaa authentication dhchap default aaa authentication iscsi default aaa authentication login aaa group server abort2-11 2-12 2-13 2-15 2-16 2-9 2-6

aaa authentication login password-aging enable

2-8

action cli

action counter

action event-default action exception log action forceshut2-17

action overbudgetshut action policy-default

2-18 2-19


v

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o maction reload action syslog alert-group arp attach2-27 2-28 2-29 2-30 2-20 2-21

action snmp-trap2-22

active equals saved2-25

2-24

attachpriv

attributes (DMM job configuration submode) attribute failover auto attribute qos authentication2-32 2-33 2-31

autonomous-fabric-id (IVR topology database configuration) autonomous-fabric-id (IVR service group configuration) autonomous-fabric-id database auto-volgrpCHAPTER

2-35

2-37

2-39

2-40

3

B Commands banner motd boot bport3-4 3-6

3-1 3-2

bport-keepalive broadcastCHAPTER

3-7

3-8

4

C Commands callhome cd cdp4-5 4-6

4-1 4-2 4-4

callhome test

cfs distribute

4-8 4-10 4-12

cfs ipv4 distribute cfs ipv6 distribute cfs region4-18

cfs ipv4 mcast-address4-14

cfs ipv6 mcast-address cfs static-peers4-20

4-16

Cisco MDS 9000 Family Command Reference

vi


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mchannel mode active channel-group cimserver4-23 4-25 4-22 4-21

cimserver clearcertificate cimserver loglevel class4-27 4-29 4-26

clear accounting log clear arp-cache clear asic-cnt clear cdp clear cores4-34 4-35 4-30 4-31

clear callhome session

4-33

clear counters (EXEC mode)

4-36 4-37

clear counters (SAN extension N port configuration mode) clear crypto ike domain ipsec sa clear crypto sa domain ipsec clear debug-logfile clear device-alias clear dpvm4-42 4-43 4-44 4-40 4-41 4-38 4-39

clear dpvm merge statistics clear fabric-binding statistics clear fcanalyzer clear fcflow stats clear fcns statistics clear fcs statistics clear fctimer session clear fc-redirect config clear ficon4-53 4-54 4-45 4-46 4-47 4-48 4-49 4-50

clear fc-redirect decommission-switch clear fspf counters

4-51

clear install failure-reason clear ip access-list counters clear ips arp clear ips stats4-57 4-58

4-55 4-56

clear ips stats fabric interface

4-59


vii

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mclear ipv6 access-list clear ipv6 neighbors clear islb session4-60 4-61 4-62 4-63 4-64

clear ivr fcdomain database clear ivr zone database clear license clear line clear ntp clear logging4-69 4-70 4-72 4-73 4-74 4-66 4-67 4-68 4-65

clear ivr service-group database

clear port-security clear processes log clear qos statistics clear radius session clear rlir4-75

clear rmon alarms clear rmon hcalarms clear rmon log

4-77 4-78 4-79

clear rmon all-alarms4-80

clear role session clear rscn statistics clear santap module

4-81 4-82

clear rscn session vsan

4-83 4-84 4-85

clear ssm-nvram santap module clear scheduler logfile clear screen clear sdv4-87 4-88 4-86

clear scsi-flow statistics4-89

clear snmp hostconfig clear ssh hosts4-91

4-90

clear system reset-reason clear tacacs+ session clear tlport alpa-cache clear user clear vrrp4-95 4-96 4-93

4-92

4-94


viii


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mclear zone4-97 4-98 4-100 4-102

cli alias name

cli var name (EXEC) clock4-103 4-105 4-106

cli var name (configuration) clock set

cloud discover cloud discovery cluster commit4-110

4-107 4-109

cloud-discovery enable code-page4-111

4-113 4-114

commit (DMM job configuration submode) contract-id copy4-117 4-120 4-121 4-115 4-116

configure terminal copy licenses counter4-122

copy ssm-nvram standby-sup crypto ca authenticate crypto ca crl request crypto ca enroll crypto ca export crypto ca import4-128 4-130 4-132 4-134 4-135 4-124 4-126

crypto ca test verify crypto ca trustpoint

crypto global domain ipsec security-association lifetime crypto ike domain ipsec crypto ike enable crypto ipsec enable crypto key zeroize rsa4-140 4-141 4-142 4-144 4-146 4-138 4-139

4-137

crypto ike domain ipsec rekey sa

crypto key generate rsa

crypto map domain ipsec (configuration mode)

crypto map domain ipsec (interface configuration submode)

4-148


ix

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mcrypto transform-set domain ipsec customer-idCHAPTER

4-149

4-151

5

D Commands

5-1 5-2 5-3 5-4

data-pattern-file

deadtime (radius group configuration) deadtime (tacacs+ group configuration) delete5-5 5-7

delete ca-certificate delete certificate delete crl description5-10 5-8

deny (IPv6-ACL configuration)5-14 5-15 5-17

5-11

destination interface destination-profile

device-alias (IVR fcdomain database configuration submode) device-alias (SDV virtual device configuration submode) device-alias abort device-alias commit device-alias database device-alias distribute5-22 5-23 5-24 5-25 5-26 5-27 5-21

5-20

device-alias import fcalias device-alias mode enhanced device-alias name dir5-30 5-32 5-33 5-34 5-35 5-29

disable discover

discover custom-list discover scsi-target distribute5-37 5-38

dmm module do5-42

dmm module job dpvm abort dpvm activate dpvm auto-learnx5-44

5-40

5-45 5-46


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mdpvm commit dpvm database5-48 5-49 5-51

dpvm database copy active dpvm database diff dpvm distribute dpvm enable dscp5-57 5-55 5-52 5-54

dpvm overwrite-duplicate-pwwn duplicate-message throttleCHAPTER

5-56

5-58

6

Debug Commands debug aaa debug all debug biosd debug bootvar debug callhome debug cert-enroll debug cdp debug cfs debug cloud debug core debug dpvm debug dstats debug ethport6-11 6-13 6-2 6-4 6-5

6-1

6-6 6-7 6-9

debug cimserver6-16 6-18

6-15

debug device-alias6-21 6-23 6-24

6-19

debug exceptionlog debug fabric-binding debug fc-tunnel debug fc2 debug fc2d debug fcc debug fcfwd debug fcns debug fcsOL-18089-01, Cisco MDS NX-OS Release 4.x

6-26 6-27

6-29

6-31 6-33 6-35 6-37

debug fcdomain6-41 6-43

6-39


xi

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mdebug fcsp-mgr debug fdmi debug ficon debug flogi debug fm debug fspf debug idehsd debug ike debug ipacl debug ipconf debug ipfc debug ips debug ipsec debug isns debug ivr debug klm debug logfile debug mcast debug mip debug ntp debug npv debug obfl debug plog debug port debug module6-80 6-81 6-83 6-84 6-47 6-49 6-51 6-53 6-54 6-56 6-45

debug hardware arbiter6-57 6-58 6-59

debug ilc_helper6-60 6-61 6-62 6-63 6-65 6-67 6-69 6-71

debug license

6-73 6-74 6-76

6-78 6-79

debug platform6-86 6-87

debug port-channel debug port-resources debug qos debug radius debug rd-reg debug rdl errors6-92 6-93 6-95

6-89 6-90

6-96


xii


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mdebug rib debug rlir debug rscn6-97 6-98 6-99 6-100

debug san-ext-tuner debug scsi-flow debug scsi-target debug sdv6-105 6-107 6-108 6-109 6-111 6-113

6-102 6-104

debug security debug sensor debug sme debug snmp debug span debug tacacs+ debug tcap debug tlport debug ttyd debug vni debug vrrp debug vsan debug wr-reg debug wwn debug xbar debug xbc debug zoneCHAPTER

debug system health6-117 6-119 6-120 6-121 6-122 6-123 6-125 6-127 6-128 6-130

6-115

debug xbar_driver6-132 6-133

6-131

7

E Commands enable end7-5 7-3

7-1 7-2

email-contact encryption7-4

enrollment terminal event7-9

7-6 7-7

errdisable detect cause link-down event manager appletOL-18089-01, Cisco MDS NX-OS Release 4.x

7-13Cisco MDS 9000 Family Command Reference

xiii

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mevent manager policy exitCHAPTER

7-14 7-15

event manager environment7-16

8

F Commands fabric8-2

8-1

fabric-binding activate

8-3 8-5 8-6 8-7

fabric-binding database copy fabric-binding database diff fabric-binding database vsan fabric-binding enable fabric-membership fcalias clone fcalias name fcalias rename fcanalyzer fcc enable fcc priority fcdomain8-14 8-16 8-17 8-18 8-21 8-22 8-11 8-12 8-13 8-9 8-10

fcdomain abort vsan fcdomain commit vsan fcdomain distribute fcdomain rcf-reject fcdroplatency fcflow stats fcid-allocation fcid-last-byte8-25 8-27 8-29 8-31

8-23 8-24

fcinterop fcid-allocation fcinterop loop-monitor fcip enable fcip profile8-34 8-35 8-36

8-32 8-33

fcns proxy-port fcping fcroutexiv8-38

fcns reject-duplicate-pwwn vsan fc-redirect version2 enable8-43 8-40

8-37


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mfcrxbbcredit extended enable fcs plat-check-global vsan fcs register f8-49 8-50 8-53 8-54 8-47 8-48 8-45

8-46

fcs virtual-device-add fcsp dhchap fcsp enable fcsp timeout fctimer8-55 8-56 8-57 8-58

fctimer abort fctimer commit

fctimer distribute fctrace fc-tunnel feature8-59 8-60 8-62 8-64

ficon enable

ficon logical-port assign port-numbers ficon port default-state prohibit-all ficon slot assign port-numbers ficon swap8-70 8-72 8-68

8-66

8-67

ficon-tape-accelerator vsan ficon vsan (EXEC mode) file find8-77 8-78 8-74

ficon vsan (configuration mode)

8-76

flex-attach virtual-pwwn

8-79 8-80 8-81

flex-attach virtual-pwwn auto format fspf cost8-82 8-84

flex-attach virtual-pwwn interface fspf config vsan8-86 8-87 8-88 8-89

fspf dead-interval fspf enable vsan fspf hello-interval fspf passive8-90


xv

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mfspf retransmit-intervalCHAPTER

8-91

9

G Commands group gzip gunzip9-2 9-3 9-5

9-1

CHAPTER

10

H Commands hash host10-2 10-3

10-1

hw-module logging onboardCHAPTER

10-5

11

I Commands identity initiator install all

11-1 11-2 11-4

in-order-guarantee11-5 11-6

install clock-module install license11-14

11-12

install module bios install module epld install module loader install ssi interface interface fc interface fcip interface iscsi interface mgmt interface sme interface vsan ip access-group11-19 11-20

11-15 11-16 11-18

interface bay | ext11-23

11-22

interface fc-tunnel11-27

11-25

interface gigabitethernet11-31 11-33

11-29

interface port-channel11-36

11-34

interface sme (Cisco SME cluster node configuration submode)11-39 11-40

11-37


xvi


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mip access-list11-42 11-45

ip address (FCIP profile configuration submode) ip address (interface configuration) ip-compression11-47 11-49 11-50 11-46

ip default-gateway ip default-network ip domain-list ip domain-name ip name-server ip route ip routing11-55 11-56 11-51

ip domain-lookup

11-52 11-53 11-54

ips netsim delay-ms ips netsim delay-us ips netsim drop nth ips netsim enable

11-57 11-58 11-59 11-61

ips netsim drop random11-63

ips netsim max-bandwidth-kbps ips netsim max-bandwidth-mbps ips netsim qsize ips netsim reorder ipv6 access-list ipv6 address ipv6 enable ipv6 nd ipv6 route ipv6 routing11-70 11-72 11-66 11-67 11-69

11-64 11-65

ipv6 address autoconfig11-73 11-74 11-76 11-78 11-79

ipv6 traffic-filter

iscsi authentication iscsi dynamic initiator iscsi enable11-86

11-80 11-82

iscsi duplicate-wwn-check

11-84

iscsi enable module iscsi import target fc

11-87 11-88


xvii

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o miscsi initiator idle-timeout iscsi initiator ip-address iscsi initiator name iscsi save-initiator islb abort islb commit islb distribute islb initiator11-100 11-101 11-102 11-104 11-106 11-108 11-92 11-93 11-89 11-90

iscsi interface vsan-membership11-95 11-97

iscsi virtual-target name

islb save-initiator islb vrrp isns11-110

islb virtual-target name islb zoneset activate11-113 11-115 11-116 11-117 11-118

11-112

isns distribute isns esi retries isns profile name isns reregister ivr abort ivr commit11-120

isns-server enable11-121

11-119

ivr copy active-service-group user-configured-service-group ivr copy active-topology user-configured-topology ivr copy active-zoneset full-zoneset ivr distribute ivr enable ivr nat11-126 11-127 11-128 11-124 11-125 11-123

11-122

ivr copy auto-topology user-configured-topology

ivr fcdomain database autonomous-fabric-num11-129 11-130 11-131 11-133 11-135 11-136

ivr refresh

ivr service-group activate ivr service-group name ivr virtual-fcdomain-add ivr virtual-fcdomain-add2


xviii


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mivr vsan-topology11-137 11-139

ivr vsan-topology database ivr withdraw domain ivr zone name ivr zone rename ivr zoneset ivr zoneset renameCHAPTER

11-141

11-142 11-143

11-144 11-145

12

J Commands job name

12-1 12-2

CHAPTER

13

K Commands keepalive kernel core key13-5

13-1 13-2 13-3

key-ontapeCHAPTER

13-7

14

L Commands line com1 line console line vty

14-1 14-2

lifetime seconds14-3 14-6

14-9 14-10

link (SDV virtual device configuration submode) link-state-trap load-balancing logging abort logging commit logging console logging distribute logging level logging logfile logging module logging monitor logging server logging timestamp14-11 14-12

link-state-trap (SME)14-13 14-14 14-15 14-16

14-17

14-18 14-19 14-20 14-21 14-22 14-24Cisco MDS 9000 Family Command Reference


xix

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mCHAPTER

15

M Commands match15-2

15-1

match address mcast root15-5

15-4

member (fcalias configuration submode) member (ivr zone configuration)15-8

15-6

member (zone configuration and zoneset-zone configuration submode) member (zoneset configuration submode) metric (iSLB initiator configuration) mkdir move15-14 15-15 15-13 15-12

15-10

modem connect line15-16

mutual-chap username (iSCSI initiator configuration and iSLB initiator configuration)CHAPTER

15-17

16

N Commands node16-3

16-1 16-2

native-autonomous-fabric-num npiv enable nport pwwn npv enable16-4 16-5 16-6

npv auto-load-balance disruptive npv traffic-map server-interface ntp16-9 16-10 16-11 16-12 16-13

16-7 16-8

ntp abort ntp commit

ntp distribute ntp sync-retry

nwwn (DPVM database configuration submode) nwwn (SAN extension configuration mode)CHAPTER

16-14

16-15

17

O Commands odrt.bin ocsp url

17-17 17-18 17-20 17-22 17-24

out-of-service

out-of-service module out-of-service xbarxx

17-25


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mCHAPTER

18

P Commands

18-1 18-2 18-3 18-5

passive-mode

password strength-check peer-info ipaddr18-6

peer (DMM job configuration submode) periodic-inventory notification permit (IPv6-ACL configuration) phone-contact ping policy port18-13 18-15 18-16 18-17 18-12 18-8 18-9

port-channel persistent port-license18-18

port-monitor activate port-monitor enable port-monitor name port-security18-22

18-19 18-20 18-21

port-security abort port-security commit

18-25 18-26 18-27 18-29 18-30 18-31 18-32 18-33

port-security database port-security distribute port-security enable port-track enable port-track interface port-type portaddress18-35 18-37

port-track force-shut

power redundancy-mode poweroff module priority18-42 18-44 18-41

18-39

purge fcdomain fcid purge module pwc pwd18-46 18-47 18-45

pwwn (DPVM database configuration submode)

18-48


xxi

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mpwwn (fcdomain database configuration submode) pwwn (SDV virtual device configuration submode)CHAPTER

18-49 18-50

19

Q Commands

19-1 19-2 19-3

qos class-map qos dwrr-q qos enable qos priority qos service quiesceCHAPTER

qos control priority19-4 19-5

qos policy-map19-7 19-8

19-6

19-9

20

R Commands radius abort

20-1 20-2 20-3 20-4 20-5 20-6

radius commit radius distribute

radius-server deadtime radius-server host radius-server key20-7 20-9

radius-server directed-request

radius-server retransmit radius-server timeout

20-10 20-11 20-12 20-13

rate-mode bandwidth-fairness rate-mode oversubscription-limit reload20-15 20-17

read command-id read-only20-19

revocation-check rmdir20-24 20-25 20-27

20-20 20-22

rlir preferred-cond fcid rmon alarm rmon event rmon hcalarm role abort role commit

20-29

20-31 20-32


xxii


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mrole distribute role name rsakeypair rscn20-38 20-39 20-40 20-33

20-34 20-36

rscn abort vsan rscn commit vsan rscn distribute rscn event-tov rule20-44 20-45

20-41 20-42

run-script

rspan-tunnelCHAPTER

20-47

21

S Commands

21-1 21-2

san-ext-tuner enable santap module scheduler21-7 21-4

scaling batch enable

21-6

scheduler aaa-authentication scsi-flow distribute scsi-flow flow-id scsi-target21-14 21-16 21-17 21-11 21-12

21-9

sdv abort vsan sdv commit vsan sdv enable

21-18 21-19

sdv virtual-device name security-mode send server21-21 21-22 21-20

server (configure session submode) server (radius configuration) server (tacacs+ configuration) setup setup21-29 21-30 21-31 21-25 21-26

21-23 21-24

server (DMM job configuration submode)

set (IPsec crypto map configuration submode)

21-27

setup ficonOL-18089-01, Cisco MDS NX-OS Release 4.x


xxiii

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mshared-keymode shutdown21-33 21-34 21-35 21-32

shutdown (interface configuration submode) site-id sleep sme21-36 21-37 21-38 21-39 21-40 21-42 21-43 21-44 21-47 21-48 21-49

shutdown (Cisco SME cluster configuration submode)

snmp port snmp-server

snmp-server contact

snmp-server community snmp-server enable traps

snmp-server traps entity fru

snmp-server enable traps fcdomain snmp-server enable traps link cisco snmp-server enable traps zone snmp-server globalEnforcePriv snmp-server host21-52 21-54 21-55 21-51

21-50

snmp-server location snmp-server user source21-58

snmp-server tcp-session21-56

span max-queued-packets span session special-frame ssh21-65 21-66 21-68 21-62

21-61

span session source interface21-64

21-63

ssh key ssl

ssh server enable21-69

ssm upgrade delay ssm enable feature stop21-76 21-77

21-70 21-71 21-74

static (iSCSI initiator configuration and iSLB initiator configuration) streetaddress


xxiv


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o msuspend21-78 21-80 21-81 21-83 21-84 21-89 21-90

switch-priority switch-wwn switchname switchport

switchport auto-negotiate switchport ignore bit-errors switchport ingress-rate switchport initiator id switchport owner21-94

21-92 21-93

switchport promiscuous-mode switchport proxy-initiator system cores21-98 21-96

21-95

system delayed-traps enable mode system delayed-traps timer system default switchport21-100 21-101

21-99

system default zone default-zone permit system default zone distribute full system default zone mode enhanced system hap-reset21-107 21-104

21-103

21-106

system health (Configuration mode) system health cf-crc-check system health cf-re-flash system health clear-errors21-110 21-111 21-112

21-108

system health external-loopback system health internal-loopback system health module system heartbeat system memlog21-118

21-114 21-116

system health serdes-loopback21-123 21-124 21-125 21-126

21-121

system startup-config system statistics reset

system switchover (EXEC mode) system trace21-129

21-127 21-128

system switchover (configuration mode)


xxv

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o msystem watchdogCHAPTER

21-130

22

Show Commands

22-1 22-2 22-3 22-4

show aaa accounting

show aaa authentication show aaa groups show arp22-8 22-5 22-6

show aaa authentication login password-aging show accounting log

show autonomous-fabric-id database show banner motd show boot22-12 22-13 22-11

22-9

show boot auto-copy show callhome show cdp show cfs22-18 22-22 22-15

show cfs regions show cfs status show cimserver

22-24 22-26 22-27

show cfs static peers22-28

show cimserver indications show cimserver logs show cimserver status show cli alias show clock22-33 22-34 22-31

22-29

22-32

show cli variables22-35

show cloud discovery show cloud membership show copyright show cores22-39 22-40

22-36 22-37

show crypto ca certificates show crypto ca crl22-43

22-41

show crypto ca trustpoints

22-45 22-46

show crypto global domain ipsec show crypto ike domain ipsec show crypto key mypubkey rsaCisco MDS 9000 Family Command Reference

22-48 22-49

xxvi


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mshow crypto map domain ipsec show crypto sad domain ipsec show crypto spd domain ipsec show debug22-56 22-57 22-59 22-60 22-62 22-63 22-50 22-52 22-54 22-55

show crypto transform-set domain ipsec show debug npv show debug sme show device-alias

show device-alias status show dmm discovery-log show dmm fp-port show dmm ip-peer show dmm job show dmm module show dmm vt22-73 22-64 22-66

22-67 22-70 22-71

show dmm srvr-vt-login ssm enable feature dmm show dpvm22-77

22-74 22-76

storage (DMM job configuration submode) show dpvm merge statistics show dpvm merge status show environment22-80 22-82 22-78 22-79

show event manager environment show event manager policy show fabric-binding show fc-tunnel show fc222-89 22-92 22-93 22-88 22-84 22-83

show fcalias show fcc

show fcanalyzer22-94

show fcdomain show fcflow stats show fcfwd

22-95 22-99 22-100

show fcdroplatency22-101

show fcid-allocation

22-102


xxvii

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o m22-103

show fc-redirect configs

22-104 22-105 22-107

show fc-redirect active-configs show fc-redirect peer-switches show fcip22-109 22-111 22-114

show fcns database show fcns statistics show fcroute show fcs show fcsp show fctimer show fdmi show ficon show file22-115 22-118 22-122 22-124 22-126 22-129 22-135

show flex-attach

22-136 22-137 22-139 22-140

show flex-attach info

show flex-attach merge status show flex-attach virtual-pwwn show flogi show fspf22-142

show flogi database interface22-146 22-149

22-145

show hardware show hosts

show hardware fabric-mode22-154

22-153

show incompatibility system show install all failure-reason show install all impact show install all status show in-order-guarantee show interface22-163 22-172 22-158 22-160

22-155 22-157

22-162

show interface sme show inventory show ip arp

show interface transceiver22-176 22-177

22-174

show ip access-list22-178


xxviii


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mshow ip interface show ip route show ip routing show ip traffic show ips arp show ips ipv6 show ips netsim show ips stats show ips ip route22-179

22-181 22-182 22-183 22-184 22-185

22-186 22-188 22-189 22-192

show ips stats fabric interface show ips stats netsim show ips status22-196 22-197 22-198 22-200 22-194

show ipv6 access-list show ipv6 interface show ipv6 neighbours show ipv6 route show ipv6 routing show ipv6 traffic show isapi dpp show iscsi global show iscsi initiator show iscsi session show iscsi stats

22-201 22-202 22-203 22-205 22-206

show isapi tech-support santap file22-208 22-209 22-211 22-213 22-217 22-219

show iscsi virtual-target show islb initiator show islb pending show islb session show islb status show islb vrrp show isns22-220

show islb cfs-session status show islb merge status show islb pending-diff22-227

22-222

22-223 22-224

22-225

show islb virtual-target22-230 22-237

22-228


xxix

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mshow ivr22-240 22-245

show ivr fcdomain database show ivr service-group

22-247 22-248

show ivr virtual-fcdomain-add-status2 show ivr virtual-switch-wwn show kernel core show license show line show mcast show module show ntp22-253 22-255 22-250 22-251 22-249

show logging----from here22-278 22-280

22-288 22-290 22-291 22-293

show npv flogi-table show npv internal info show npv traffic-map show npv status show port-channel

show npv internal info traffic-map22-294 22-295 22-296

show port index-allocation22-298

show port-channel database show port-channel consistency show port-channel internal show port-channel summary show port-channel usage show port-license show port-monitor22-315 22-316

22-302 22-303

show port-channel compatibility-parameters22-307 22-308 22-313 22-314

show port-monitor status show port-monitor active show port-security show processes show role show qos show radius22-328 22-330 22-332 22-322 22-325

22-317 22-318 22-320

show port-resources module


xxx


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mshow running radius show radius-server show rlir show rmon show role show rscn22-337 22-341 22-343 22-333 22-335

show rmon status22-344 22-346

show running-config show san-ext-tuner show santap module

22-348 22-351 22-352 22-357 22-358 22-360

show santap module dvt

show santap module dvt brief show santap module dvtlun show santap vttbl dvt show scheduler show scsi-flow show scsi-target show sdv22-372 22-374 22-377 22-363 22-365 22-369 22-361

show santap vttbl dvt host

22-362

show sme cluster show sme transport show snmp22-378

show span drop-counters show span session show sprom show ssh22-385 22-388 22-383

22-381 22-382

show span max-queued-packets

show ssm provisioning show startup-config show switchname show system22-396

22-390 22-391

22-395

show system internal snmp lc show system default zone show system health show tacacs+22-410 22-403

22-399

22-401


xxxi

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mshow tacacs-server show tech-support show telnet server show terminal show tlport show topology22-422 22-424 22-426 22-427 22-411 22-413 22-419

show tech-support sme22-421

22-420

show trunk protocol show user-account show users show version show vrrp show vsan show wwn show zone22-428 22-429

22-433 22-436 22-439 22-440 22-444 22-449

show zone analysis show zonesetCHAPTER

show zone-attribute-group22-450

23

T Commands

23-1 23-2 23-3 23-4 23-5 23-6 23-7

tacacs+ abort tacacs+ commit

tacacs+ distribute tacacs+ enable

tacacs-server deadtime tacacs-server host tacacs-server key tail23-13 23-14 23-15 23-8 23-10

tacacs-server directed-request

tacacs-server timeout tape-bkgrp tape-device

23-12

tape compression23-16

tape-keyrecycle tape-volgrpxxxii

23-17 23-18

tape-read command-id23-20


Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mtape-write command-id tcp cwm23-26 23-27 23-28 23-30 23-21 23-23

target (iSLB initiator configuration) tcp keepalive-timeout

tcp maximum-bandwidth-kbps tcp maximum-bandwidth-mbps tcp max-jitter23-32 23-34 23-35

tcp max-retransmissions tcp min-retransmit-time tcp pmtu-enable tcp qos23-38 23-39 23-40 23-36

tcp qos control tcp sack-enable tcp-connection telnet terminal time23-43

tcp send-buffer-size23-42

23-41

telnet server enable23-45 23-47 23-49

23-44

time-stamp traceroute

tlport alpa-cache23-51

23-50

transfer-ready-size transport email tune-timerCHAPTER

23-52

23-53 23-55

trunk protocol enable23-56

24

U Commands undebug all

24-1 24-2 24-3

update license use-profile username24-4 24-5

username (iSCSI initiator configuration and iSLB initiator configuration)CHAPTER

24-8

25

V Commands

25-1 25-2

virtual-domain (SDV virtual device configuration submode)


xxxiii

Contents

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mvirtual-fcid (SDV virtual device configuration submode) vrrp25-4 25-6 25-3

vsan (iSCSI initiator configuration and iSLB initiator configuration) vsan database vsan policy denyCHAPTER

25-8 25-11

26

W Commands

26-1 26-2 26-4

write command-id write-accelerator write erase wwn vsanCHAPTER

26-6 26-7

wwn secondary-mac26-8

27

Z Commands zone clone

27-1 27-2

zone broadcast enable vsan27-3 27-4 27-5

zone commit vsan zone compact vsan zone copy27-6

zone default-zone zone convert zone

27-8 27-9 27-11

zone merge-control restrict vsan zone mode enhanced vsan27-12

zone name (configuration mode) zone rename27-17 27-18 27-19

27-13 27-16

zone name (zone set configuration submode) zone-attribute-group clone zone-attribute-group name zone-attribute-group rename zoneset (configuration mode) zoneset (EXEC mode)27-25

27-20 27-21

zonename (iSLB initiator configuration)27-23


xxxiv



New and Changed InformationTable 1 summarizes the new and changed commands for Cisco MDS NX-OS Release 4.1(3) 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 Call Home

Description destination-profile command (Added the HTTPs URL and transport method to the syntax description)

Where Documented D Commands

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

Port Guard Port Owner F port Trunking

errdisable detect cause link-down command switchport owner command feature command (Added features hhtp-server, fport-channel-trunk, npiv and npv to the syntax description) switchport command (Added the F and NP port mode) show flogi database interface command

E Commands S Commands F Commands

S Commands Show Commands


xxxiii

New and Changed Information

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mTable 1 New and Changed Commands in the Cisco MDS 9000 Family Command Reference (continued)

Feature F port Channeling

Description

Where Documented

show port-channel compatibility-parameters Show Commands command 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) port-channel persistent command (Added usage guideline) clear asic-cnt command ntp command (Added a note) show fcns database command (Changed the command output for show fcns database detail) Show Commands C Commands N Commands P Commands C Commands

Hardware Radius Configuration

show system command (Changed the show system uptime output) radius-server host command (Changed the command output) show running radius command (Changed the command output)

Show Commands R Commands Show Commands S Commands E Commands

Scheduler EEM

scheduler command (Deleted a Note) event manager applet command event command event manager policy command event manager environment command description command show event manager policy command show event manager environment command action cli command

D Commands Show Commands A Commands


xxxiv




Feature

Description 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

Where Documented

SME

scaling batch enable command

S Commands


xxxv



Feature Call Home

Description switch-priority command (Added usage guidelines) system delayed-traps timer command system delayed-traps enable mode command

Where Documented S Commands

New and Changed Commands for Cisco NX-OS Release 4.1(1b)

system health Port-monitor SNMP Scheduler SSM SANTap

system health clear-errors command show port-monitor status command show port-monitor active command show system internal snmp lc command scheduler command (Added a Note) ssm upgrade delay command (Added usage guidelines) show santap module dvt command show santap module dvtlun command show santap vttbl dvt command show santap vttbl dvt host command

S Commands Show Commands

S Commands S Commands

show isapi tech-support santap file command Show Commands

SDV

show sdv command (Changed the command output) attribute failover auto command

Show Commands A Commands F Commands C Commands Show Commands D Commands D Commands

General Configuration feature command DPVM clear dpvm merge statistics command show dpvm merge statistics command show dpvm merge status command dpvm overwrite-duplicate-pwwn command Generation 3 Modules do command (Added the command output for extended receive bbcredit interface) (Added a Note) 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


xxxvi




Feature

Description 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)

Where Documented Show Commands

Hardware

show hardware fabric-mode command show version command (Changed the command output from SAN-OS to NX-OS) 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)

Show Commands Show Commands

Deprecated Commands (see the feature command for replacement commands) crypto ike enable command dpvm enable command fabric-binding enable command fcip enable command fcsp enable command ficon enable command ivr enable command port-security enable command sdv enable command tacacs+ enable command Added DMM Commands I Commands P Commands S Commands T Commands C Commands D Commands F Commands


xxxvii



Feature DMM

Description dmm module job command (Added the set-vi and modify rate keywords) show dmm module command (Added the syntax description and the command output) Added SME Commands

Where Documented D Commands Show Commands

SME

cluster command (Cluster command is replaced by the feature command) show tech-support sme command (Added the command output) 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)

C Commands

Show Commands

D Commands


xxxviii



PrefaceThis 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 Chapter 1 Chapter 2 Chapter 3 Chapter 4 Chapter 5 Chapter 6 Chapter 7 Chapter 8 Chapter 9 Chapter 10 Chapter 11 Chapter 12 Chapter 13 Chapter 14 Chapter 15 Chapter 16 Title CLI Overview A Commands B Commands C Commands D Commands Debug Commands E Commands F Commands G Commands H Commands I Commands J Commands K Commands L Commands M Commands N Commands Description Describes the CLI (command-line interface). Describes all commands beginning with the letter a. Describes all commands beginning with the letter b. Describes all commands beginning with the letter c. Describes all commands beginning with the letter d. Describes all the debug commands. Describes all commands beginning with the letter e. Describes all commands beginning with the letter f. Describes all commands beginning with the letter g. Describes all commands beginning with the letter h. Describes all commands beginning with the letter i. Describes all commands beginning with the letter j. Describes all commands beginning with the letter k. Describes all commands beginning with the letter l. Describes all commands beginning with the letter m. Describes all commands beginning with the letter n.


lxv

Preface

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mChapter Chapter 17 Chapter 18 Chapter 19 Chapter 20 Chapter 21 Chapter 22 Chapter 23 Chapter 24 Chapter 25 Chapter 26 Chapter 27 Chapter 28 Title O Commands P Commands Q Commands R Commands S Commands Show Commands T Commands U Commands V Commands W Commands Z Commands Caching Services Module Commands Description Describes all commands beginning with the letter o. Describes all commands beginning with the letter p. Describes all commands beginning with the letter q. Describes all commands beginning with the letter r. Describes all commands beginning with the letter s except for the show commands. Describes all the show commands. Describes all commands beginning with the letter t. Describes all commands beginning with the letter u. Describes all commands beginning with the letter v. Describes all commands beginning with the letter w. Describes all commands beginning with the letter z. Describes all commands pertaining to the Caching Services Module (CSM).

Document ConventionsCommand descriptions use these conventions: Convention boldface font italic font [ ] {x | y | z } [x|y|z] string Indication Commands and keywords are in boldface. Arguments for which you supply values are in italics. Elements in square brackets are optional. Required alternative keywords are grouped in braces and separated by vertical bars. Optional alternative keywords are grouped in brackets and separated by vertical bars. A nonquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.

Screen examples use these conventions: Conventionscreen

Indication Terminal sessions and information the switch displays are in screen font. Information you must enter is in boldface screen font. Arguments for which you supply values are in italic screen font. Nonprinting characters, such as passwords are in angle brackets. Default responses to system prompts are in square brackets. An exclamation point (!) or a pound sign (#) at the beginning of a line of code indicates a comment line.

font

boldface screen

fontitalic screen

font

< > [ ] !, #


lxvi


Preface

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mThis 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 Storage Services Interface Images Cisco MDS 9000 Family Release Notes for Cisco MDS SVC Releases Cisco MDS 9000 Family Release Notes for Cisco MDS 9000 EPLD Images

Compatibility Information

Cisco MDS 9000 NX-OS Hardware and Software Compatibility Information Cisco MDS 9000 Family Interoperability Support Matrix Cisco MDS Storage Services Module Interoperability Support Matrix Cisco MDS NX-OS Release Compatibility Matrix for IBM SAN Volume Controller Software for Cisco MDS 9000 Cisco MDS NX-OS Release Compatibility Matrix for Storage Service Interface Images

Regulatory Compliance and Safety Information

Regulatory Compliance and Safety Information for the Cisco MDS 9000 Family

Hardware Installation

Cisco MDS 9124 Multilayer Fabric Switch Quick Start Guide Cisco MDS 9500 Series Hardware Installation Guide Cisco MDS 9200 Series Hardware Installation Guide


lxvii

Preface


Cisco MDS 9100 Series Hardware Installation Guide Cisco MDS 9020 Fabric Switch Hardware Installation Guide

Cisco Fabric Manager

Cisco MDS 9000 Family Fabric Manager Quick Configuration Guide Cisco MDS 9000 Family Fabric Manager Configuration Guide Cisco MDS 9000 Fabric Manager Online Help Cisco MDS 9000 Fabric Manager Web Services Online Help Cisco MDS 9000 Family Fabric Manager Database Schema

Command-Line Interface

Cisco MDS 9000 Family Software Upgrade and Downgrade Guide Cisco MDS 9000 Family Storage Services Module Software Installation and Upgrade Guide Cisco MDS 9000 Family CLI Quick Configuration Guide Cisco MDS 9000 Family CLI Configuration Guide Cisco MDS 9000 Family Command Reference Cisco MDS 9000 Family Quick Command Reference Cisco MDS 9020 Fabric Switch Configuration Guide and Command Reference Cisco MDS 9000 Family SAN Volume Controller Configuration Guide

Intelligent Storage Networking Services Configuration Guides

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 - For Cisco MDS 9500 and 9200 Series

Troubleshooting and Reference

Cisco MDS 9000 Family Troubleshooting Guide Cisco MDS 9000 Family MIB Quick Reference Cisco MDS 9020 Fabric Switch MIB Quick Reference Cisco MDS 9000 Family SMI-S Programming Reference Cisco MDS 9000 Family System Messages Reference Cisco MDS 9020 Fabric Switch System Messages Reference


lxviii


Preface


Installation and Configuration Note

Cisco MDS 9000 Family SSM Configuration Note Cisco MDS 9000 Family Port Analyzer Adapter Installation and Configuration Note Cisco 10-Gigabit Fibre Channel X2 Transceiver Module Installation Note

Obtaining Documentation and Submitting a Service RequestFor information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly Whats New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at: http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html Subscribe to the Whats New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.


lxix

Preface



lxx



CH A P T E R

1

CLI OverviewThis 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-20 Using CLI Variables, page 1-27 Using Command Aliases, page 1-30 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


1-1

Chapter 1 About the Switch Prompt

CLI Overview


About 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 booting Checking all filesystems..... done. Loading system software Uncompressing system image: bootflash:/system_image CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC INIT: Entering runlevel: 3 ---- 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 switch login:


1-2


Chapter 1

CLI Overview About the CLI Command Modes


About 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.Table 1-1 Frequently Used Switch Command Modes

Mode EXEC

Description of Use

How to Access

Promptswitch#

Enables you to temporarily change At the switch prompt, enter the required terminal settings, perform basic tests, and EXEC mode command. display system information.Note

Changes made in this mode are generally not saved across system resets. From EXEC mode, enter the config terminal command.switch(config)#

Configuration mode

Enables you to configure features that affect the system as a whole.Note

Changes made in this mode are saved across system resets if you save your configuration. Refer to the Cisco MDS 9000 Family CLI Configuration Guide for further information.

You can abbreviate commands and keywords by entering just enough characters to make the command unique from other commands. For example, you can abbreviate the config terminal command to conf t.


1-3

Chapter 1 Understanding CLI Command Hierarchy

CLI Overview


Understanding CLI Command 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

switch prompt (switch#)

EXEC mode cd configure write erase exit Configuration zoneset mode exit fspf switchport Configuration79525

clock

interface

end

submode

To execute a command, you enter the command by starting at the top level of the hierarchy. For example, to configure a Fibre Channel interface, use the config terminal command. Once you are in configuration mode, issue the interface command. When you are in the interface submode, you can query the available commands there. The following example shows how to query the available commands in the interface submode:switch# config terminal Enter configuration commands, one per line. End with CNTL/Z. switch(config)# interface fc1/1 switch(config-if)# ? Interface configuration commands: channel-group Add to/remove from a port-channel exit Exit from this submode fcdomain Enter the interface submode fspf To configure FSPF related parameters no Negate a command or set its defaults shutdown Enable/disable an interface switchport Configure switchport parameters


1-4


Chapter 1

CLI Overview Understanding CLI Command Hierarchy


EXEC Mode 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 Familyswitch# ? Exec commands: attach callhome cd clear cli clock config copy debug delete dir discover exit fcping fctrace find format gunzip gzip install license mkdir modem move no ntp out-of-service ping port-channel purge pwd reload rmdir run-script sdv send setup show sleep ssh system tac-pac tail telnet Connect to a specific linecard Callhome commands Change current directory Reset functions CLI commands Manage the system clock Enter configuration mode Copy from one file to another Debugging functions Delete a file List files in a directory Discover information Exit from the EXEC Ping an N-Port Trace the route for an N-Port. Find a file below the current directory Format disks Uncompresses LZ77 coded files Compresses file using LZ77 coding Upgrade software Enter the license configuration mode Create new directory Modem commands Move files Disable debugging functions Execute NTP commands Make the current module out-of-service Send echo messages Port-Channel related commands Deletes unused data View current directory Reboot the entire box Delete a directory Run shell scripts SDV test commands Send message to open sessions Run the basic SETUP command facility Show running system information Sleep for the specified number of seconds SSH to another system System management commands Save tac information to a specific location Display the last part of a file Telnet to another system


1-5


CLI Overview

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mterminal test traceroute undebug update write zone zoneset Set terminal line parameters Test command Trace route to destination Disable Debugging functions (See also debug) Update license Write current configuration Execute Zone Server commands Execute zoneset commands

EXEC Mode Commands for the Cisco Fabric Switch for HP c-Class BladeSystem and the Cisco Fabric Switch for IBM BladeCenterswitch# ? Exec commands: attach callhome cd clear cli clock config copy debug delete dir discover exit fcping fctrace find format gunzip gzip install license mkdir modem move no ntp out-of-service ping port-channel purge pwd reload rmdir run-script send setup show sleep ssh system tac-pac tail telnet terminal test traceroute undebug update Connect to a specific linecard Callhome commands Change current directory Reset functions CLI commands Manage the system clock Enter configuration mode Copy from one file to another Debugging functions Delete a file List files in a directory Discover information Exit from the EXEC Ping an N-Port Trace the route for an N-Port. Find a file below the current directory Format disks Uncompresses LZ77 coded files Compresses file using LZ77 coding Upgrade software Enter the license configuration mode Create new directory Modem commands Move files Disable debugging functions Execute NTP commands Make the current module out-of-service Send echo messages Port-Channel related commands Deletes unused data View current directory Reboot the entire box Delete a directory Run shell scripts Send message to open sessions Run the basic SETUP command facility Show running system information Sleep for the specified number of seconds SSH to another system System management commands Save tac information to a specific location Display the last part of a file Telnet to another system Set terminal line parameters Test command Trace route to destination Disable Debugging functions (See also debug) Update license


1-6


Chapter 1


Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mwrite zone zoneset Write current configuration Execute Zone Server commands 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 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 Familyswitch# 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


1-7


CLI Overview

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mfcflow fcid-allocation fcinterop fcip fcns fcroute fcrxbbcredit fcs fcsp fctimer fdmi ficon fspf hw-module in-order-guarantee interface ip ips ipv6 iscsi islb isns isns-server ivr kernel line logging mcast no npiv ntp port-security port-track power poweroff qos radius radius-server rib rmon role rscn san-ext-tuner scheduler scsi-target snmp-server span ssh switchname system tacacs+ telnet tlport trunk username vsan wwn zone zone-attribute-group zoneset Configure fcflow Add/remove company id(or OUIs) from auto area list Interop commands Enable/Disable FCIP Name server configuration Configure FC routes Enable extended rx b2b credit configuration Configure Fabric Config Server Config commands for FC-SP Configure fibre channel timers Config commands for FDMI Configure ficon information Configure fspf Enable/Disable OBFL information Set in-order delivery guarantee Select an interface to configure Configure IP features Various sibyte module related commands Configure IPv6 features Enable/Disable iSCSI ISCSI server load-balancing Configure iSNS ISNS server Config commands for IVR Kernel options Configure a terminal line Modify message logging facilities Configure multicast Negate a command or set its defaults Nx port Id Virtualization (NPIV) feature enable NTP Configuration Configure Port Security Configure Switch port track config Configure power supply Poweroff a module in the switch QoS Configuration commands Configure RADIUS configuration Configure RADIUS related parameters Configure RIB parameters Remote Monitoring Configure roles Config commands for RSCN Enable/Disable San Extension Tuner tool Config commands for scheduler Scsi-target configuration Configure snmp server Enter SPAN configuration mode Configure SSH parameters Configure system's network name System config command Enable tacacs+ Enable telnet Configure TL Port information Configure Switch wide trunk protocol Configure user information. Enter the vsan configuration mode Set secondary base MAC addr and range for additional WWNs Zone configuration commands Zone attribute group commands Zoneset configuration commands


1-8


Chapter 1



Configuration Mode Commands for the Cisco Fabric Switch for HP c-Class BladeSystem and the Cisco Fabric Switch for IBM BladeCenterswitch# 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


1-9


CLI Overview

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mrscn scheduler scsi-target sdv snmp-server span ssh switchname system tacacs+ tacacs-server telnet trunk username vsan wwn zone zone-attribute-group zoneset Config commands for RSCN Config commands for scheduler Scsi-target configuration Config commands for SAN Device Virtualization Configure snmp server Enter SPAN configuration mode Configure SSH parameters Configure system's network name System config command Enable tacacs+ Configure TACACS+ server related parameters Enable telnet Configure Switch wide trunk protocol Configure user information. Enter the vsan configuration mode Set secondary base MAC addr and range for additional WWNs Zone configuration commands Zone attribute group commands Zoneset configuration commands

Configuration mode, also known as terminal configuration mode, has several submodes. Each of these submodes places you deeper in the prompt hierarchy. When you type exit, the switch backs out one level and returns you to the previous level. When you type end, the switch backs out to the user EXEC level. You can also type Ctrl-Z in configuration mode as an alternative to typing end.Note

When in configuration mode, you can alternatively enter:

Ctrl-Z instead of the end command Ctrl-G instead of the exit command

You can execute an EXEC mode command from a configuration mode or submode prompt. You can issue this command from any submode within the configuration mode. When in configuration mode (or in any submode), enter the do command along with the required EXEC mode command. The entered command is executed at the EXEC level and the prompt resumes its current mode level.switch(config)# do terminal session-timeout 0 switch(config)#

In this example, terminal session-timeout is an EXEC mode commandyou are issuing an EXEC mode command using the configuration mode do command. The do command applies to all EXEC mode commands other than the end and exit commands. You can also use the help (?) and command completion (tab) features for EXEC commands when issuing a do command along with the EXEC command. Table 1-2 lists some useful command keys that can be used in both EXEC and configuration modes:Table 1-2 Useful Command Key Description

Command Ctrl-P Ctrl-N Ctrl-X-H

Description Up history Down history List history


1-10


Chapter 1


Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mTable 1-2 Useful Command Key Description

Command Alt-P

Description History search backwardsNote

The difference between Tab completion and Alt- P or Alt-N is that TAB completes the current word while Alt- P and Alt-N completes a previously-entered command.

Alt-N Ctrl-G Ctrl-Z Ctrl-L

History search forwards Exit End Clear screen

Table 1-3 displays the commonly used configuration submodes for the Cisco MDS 9000 Family.Table 1-3 Submodes Within the Configuration Mode for the Cisco MDS 9000 Family

Submode Name Call Home FCS Registration

From Configuration Mode Enter callhome fcs register From FCS registration submode: platform name name vsan vsan-id

Submode Promptswitch(config-callhome)# switch(config-fcs-register)# switch(config-fcs-register-att rib)#

Configured Information Contact, destination, and e-mail FCS attribute registration Platform name and VSAN ID association Alias member Static SPF computation, hold time, and autonomous region Channel groups, Fibre Channel domains, FSPF parameters, switch port trunk and beacon information, and IP address Virtual router (Refer to the Cisco MDS 9000 Family CLI Configuration Guide for further information.) iSCSI virtual target iSCSI server load balancing (iSLB) initiator iSCSI server load balancing (iSLB) virtual target Primary terminal console Virtual terminal line Rule SPAN source, destination, and suspend session information VSAN database

Fibre Channel alias fcalias name name vsan vsan-id switch(config-fcalias)# FSPF Interface configuration fspf config vsan vsan-id interface type slot/portswitch(config-(fspf-config))#

switch(config-if)#

From the VSAN or mgmt0 (management) interface configuration submode: vrrp number iSCSI target iSLB initiator iSLB target Line console VTY Role SPAN VSAN database iscsi virtual-target name islb initiator islb virtual-target name line console line vty role name span session number vsan database

switch(config-if-vrrp)#

switch(config-iscsi-tgt) switch(config-islb-init)#

switch(config-islb-tgt)

switch(config-console)# switch(config-line)# switch(config-role)# switch(config-span)#

switch(config-vsan-db)#


1-11


CLI Overview

Se n d d o c u m e n t a t i o n c o m m e n t s t o m d s f e e d b a ck - d o c @ c i s c o . c o mTable 1-3 Submodes Within the Configuration Mode for the Cisco MDS 9000 Family (continued)

Submode Name Zone Zone set SDV virtual device

From Configuration Mode Enter zone name string vsan vsan-id zoneset name name vsan vsan-id sdv virtual-device name device-name vsan vsan-id

Submode Promptswitch(config-zone)# switch(config-zoneset)#

Configured Information Zone member Zone set member SAN Device Virtualization information

switch(config-sdv-virt-dev)#

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.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 Call Home FCS Registration

From Configuration Mode Enter callhome fcs register

Submode Promptswitch(config-callhome)# switch(config-fcs-register)#

Configured Information Contact, destination, and e-mail FCS attribute registration

From FCS registration submode: switch(config-fcs-register-att Platform name and VSAN ID rib)# association platform name name vsan vsan-id Fibre Channel alias fcalias name name vsan vsan-id switch(config-fcalias)# FSPF Interface configuration fspf config vsan vsan-id interface type slot/portswitch(config-(fspf-config))#

Alias member Static SPF computation, hold time, and autonomous region Channel groups, Fibre Channel domains, FSPF parameters, switch port trunk and beacon information, and IP address Virtual router (refer to the Cisco MDS 9000 Family CLI Configuration Guide for further information) Primary terminal console Virtual terminal line Rule SPAN source, destination, and suspend session information VSAN database Zone member Zone set member SAN device virtualization information

switch(config-if)#

From the VSAN or mgmt0 (management) interface configuration submode: vrrp number Line console VTY Role SPAN VSAN database Zone Zone set SDV virtual device line console line vty role name span session number vsan database zone name string vsan vsan-id zoneset name name vsan vsan-id sdv virtual-device name device-name vsan vsan-id

switch(config-if-vrrp)#

switch(config-console)# switch(config-line)# switch(config-role)# switch(config-span)#

switch(config-vsan-db)# switch(config-zone)# switch(config-zoneset)#

switch(config-sdv-virt-dev)#


1-12


Chapter 1

CLI Overview Navigating Through CLI Commands


Note

SPAN is only supported on external ports.

Navigating Through CLI CommandsTo 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 HelpIn 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 CompletionIn 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! switch (config)# role ! 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 fcalias fcdomain fcanalyzer fcdroplatency fcc fcinterop switch(config)# fcd fcdomain fcdroplatency switch(config)# fcdo switch(config)# fcdomain fcs fcns fcroute

fctimer


1-13

Chapter 1 Navigating Through CLI Commands

CLI Overview


Using the no and Default Forms of CommandsYou 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 MappingThe 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 M

Documents

CR03