Cisco AJ732A - MDS 9134 Fabric Switch Operating manual

Send documentation comments to mdsfeedbac[email protected]
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: [phone]
800 553-NETS (6387)
Fax: [phone]
Cisco MDS 9000 Family Command
Reference, Release 4.x
Cisco MDS NX-OS Release 4.1(3)
February 2009
Text Part Number: OL-18089-01

Send documentation comments to mdsfeedbac[email protected]
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 UCB’s 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.

Send documentation comments to mdsfeedbac[email protected]
iii
Cisco MDS 9000 Family Command Reference
OL-18089-01, Cisco MDS NX-OS Release 4.x
CONTENTS
New and Changed Information xxxiii
Preface lxv
Audience lxv
Organization lxv
Document Conventions lxvi
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 lxviii
Troubleshooting and Reference lxviii
Installation and Configuration Note lxix
Obtaining Documentation and Submitting a Service Request lxix
CHAPTER 1CLI Overview 1-1
About the Switch Prompt 1-2
About the CLI Command Modes 1-3
Understanding CLI Command Hierarchy 1-4
EXEC Mode Options 1-5
EXEC Mode Commands for the Cisco MDS 9000 Family 1-5
EXEC Mode Commands for the Cisco Fabric Switch for HP c-Class BladeSystem and the Cisco
Fabric Switch for IBM BladeCenter 1-6
Configuration Mode Options 1-7
Configuration Mode Commands for the Cisco MDS 9000 Family 1-7
Configuration Mode Commands for the Cisco Fabric Switch for HP c-Class BladeSystem and the
Cisco Fabric Switch for IBM BladeCenter 1-9
Navigating Through CLI Commands 1-13
Getting Help 1-13
Command Completion 1-13
Using the no and Default Forms of Commands 1-14
Port Names and Port Mapping 1-14

Send documentation comments to mdsfeedbac[email protected]
Contents
iv
Cisco MDS 9000 Family Command Reference
OL-18089-01, Cisco MDS NX-OS Release 4.x
Entering CLI Commands 1-16
Viewing Switch Configurations 1-16
Saving a Configuration 1-19
Clearing a Configuration 1-19
Searching and Filtering CLI Output 1-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 Switch’s Shell Timeout 1-25
Displaying VTY Sessions 1-25
Clearing VTY Sessions 1-26
Setting the Switch’s Terminal Timeout 1-26
Setting the Switch’s Terminal Type 1-26
Setting the Switch’s Terminal Length 1-26
Setting the Switch’s 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 1-30
About Flash Devices 1-30
Internal bootflash: 1-31
External CompactFlash (Slot0) 1-31
Formatting Flash Disks and File Systems 1-31
Initializing bootflash: 1-32
Formatting Slot0: 1-32
Using the File System 1-32
Setting the Current Directory 1-33
Displaying the Current Directory 1-33
Listing the Files in a Directory 1-33
Creating a New Directory 1-34
Deleting an Existing Directory 1-34
Moving Files 1-34
Copying Files 1-35

Send documentation comments to mdsfeedbac[email protected]
Contents
v
Cisco MDS 9000 Family Command Reference
OL-18089-01, Cisco MDS NX-OS Release 4.x
Deleting Files 1-35
Displaying File Contents 1-35
Saving Command Output to a File 1-36
Directing show Command Output to a File 1-36
Compressing and Uncompressing Files 1-36
Displaying the Last Line in a File 1-37
Executing Commands Specified in a Script 1-37
Setting the Delay Time 1-38
Role-Based CLI 1-38
Using Valid Formats and Ranges 1-39
Using Debug Commands 1-40
Generating debug Command Output 1-41
Redirecting debug and Error Message Output 1-41
Enabling Message Logging 1-42
Setting the Message Logging Levels 1-42
Limiting the Types of Logging Messages Sent to the Console 1-43
Logging Messages to an Internal Buffer 1-43
Limiting the Types of Logging Messages Sent to Another Monitor 1-43
Logging Messages to a UNIX Syslog Server 1-44
Limiting Messages to a Syslog Server 1-44
CHAPTER 2A 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 password-aging enable 2-8
aaa group server 2-9
abort 2-11
action cli 2-12
action counter 2-13
action event-default 2-15
action exception log 2-16
action forceshut 2-17
action overbudgetshut 2-18
action policy-default 2-19

Send documentation comments to mdsfeedbac[email protected]
Contents
vi
Cisco MDS 9000 Family Command Reference
OL-18089-01, Cisco MDS NX-OS Release 4.x
action reload 2-20
action snmp-trap 2-21
action syslog 2-22
active equals saved 2-24
alert-group 2-25
arp 2-27
attach 2-28
attachpriv 2-29
attributes (DMM job configuration submode) 2-30
attribute failover auto 2-31
attribute qos 2-32
authentication 2-33
autonomous-fabric-id (IVR topology database configuration) 2-35
autonomous-fabric-id (IVR service group configuration) 2-37
autonomous-fabric-id database 2-39
auto-volgrp 2-40
CHAPTER 3B Commands 3-1
banner motd 3-2
boot 3-4
bport 3-6
bport-keepalive 3-7
broadcast 3-8
CHAPTER 4C Commands 4-1
callhome 4-2
callhome test 4-4
cd 4-5
cdp 4-6
cfs distribute 4-8
cfs ipv4 distribute 4-10
cfs ipv4 mcast-address 4-12
cfs ipv6 distribute 4-14
cfs ipv6 mcast-address 4-16
cfs region 4-18
cfs static-peers 4-20

Send documentation comments to mdsfeedbac[email protected]
Contents
vii
Cisco MDS 9000 Family Command Reference
OL-18089-01, Cisco MDS NX-OS Release 4.x
channel mode active 4-21
channel-group 4-22
cimserver 4-23
cimserver clearcertificate 4-25
cimserver loglevel 4-26
class 4-27
clear accounting log 4-29
clear arp-cache 4-30
clear asic-cnt 4-31
clear callhome session 4-33
clear cdp 4-34
clear cores 4-35
clear counters (EXEC mode) 4-36
clear counters (SAN extension N port configuration mode) 4-37
clear crypto ike domain ipsec sa 4-38
clear crypto sa domain ipsec 4-39
clear debug-logfile 4-40
clear device-alias 4-41
clear dpvm 4-42
clear dpvm merge statistics 4-43
clear fabric-binding statistics 4-44
clear fcanalyzer 4-45
clear fcflow stats 4-46
clear fcns statistics 4-47
clear fcs statistics 4-48
clear fctimer session 4-49
clear fc-redirect config 4-50
clear fc-redirect decommission-switch 4-51
clear ficon 4-53
clear fspf counters 4-54
clear install failure-reason 4-55
clear ip access-list counters 4-56
clear ips arp 4-57
clear ips stats 4-58
clear ips stats fabric interface 4-59

Send documentation comments to mdsfeedbac[email protected]
Contents
viii
Cisco MDS 9000 Family Command Reference
OL-18089-01, Cisco MDS NX-OS Release 4.x
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 session 4-74
clear rlir 4-75
clear rmon alarms 4-77
clear rmon all-alarms 4-78
clear rmon hcalarms 4-79
clear rmon log 4-80
clear role session 4-81
clear rscn session vsan 4-82
clear rscn statistics 4-83
clear santap module 4-84
clear ssm-nvram santap module 4-85
clear scheduler logfile 4-86
clear screen 4-87
clear scsi-flow statistics 4-88
clear sdv 4-89
clear snmp hostconfig 4-90
clear ssh hosts 4-91
clear system reset-reason 4-92
clear tacacs+ session 4-93
clear tlport alpa-cache 4-94
clear user 4-95
clear vrrp 4-96

Send documentation comments to mdsfeedbac[email protected]
Contents
ix
Cisco MDS 9000 Family Command Reference
OL-18089-01, Cisco MDS NX-OS Release 4.x
clear zone 4-97
cli alias name 4-98
cli var name (EXEC) 4-100
cli var name (configuration) 4-102
clock 4-103
clock set 4-105
cloud discover 4-106
cloud discovery 4-107
cloud-discovery enable 4-109
cluster 4-110
code-page 4-111
commit 4-113
commit (DMM job configuration submode) 4-114
contract-id 4-115
configure terminal 4-116
copy 4-117
copy licenses 4-120
copy ssm-nvram standby-sup 4-121
counter 4-122
crypto ca authenticate 4-124
crypto ca crl request 4-126
crypto ca enroll 4-128
crypto ca export 4-130
crypto ca import 4-132
crypto ca test verify 4-134
crypto ca trustpoint 4-135
crypto global domain ipsec security-association lifetime 4-137
crypto ike domain ipsec 4-138
crypto ike domain ipsec rekey sa 4-139
crypto ike enable 4-140
crypto ipsec enable 4-141
crypto key generate rsa 4-142
crypto key zeroize rsa 4-144
crypto map domain ipsec (configuration mode) 4-146
crypto map domain ipsec (interface configuration submode) 4-148

Send documentation comments to mdsfeedbac[email protected]
Contents
x
Cisco MDS 9000 Family Command Reference
OL-18089-01, Cisco MDS NX-OS Release 4.x
crypto transform-set domain ipsec 4-149
customer-id 4-151
CHAPTER 5D Commands 5-1
data-pattern-file 5-2
deadtime (radius group configuration) 5-3
deadtime (tacacs+ group configuration) 5-4
delete 5-5
delete ca-certificate 5-7
delete certificate 5-8
delete crl 5-10
deny (IPv6-ACL configuration) 5-11
description 5-14
destination interface 5-15
destination-profile 5-17
device-alias (IVR fcdomain database configuration submode) 5-20
device-alias (SDV virtual device configuration submode) 5-21
device-alias abort 5-22
device-alias commit 5-23
device-alias database 5-24
device-alias distribute 5-25
device-alias import fcalias 5-26
device-alias mode enhanced 5-27
device-alias name 5-29
dir 5-30
disable 5-32
discover 5-33
discover custom-list 5-34
discover scsi-target 5-35
distribute 5-37
dmm module 5-38
dmm module job 5-40
do 5-42
dpvm abort 5-44
dpvm activate 5-45
dpvm auto-learn 5-46