Cisco MDS 9000 Series Installation 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
Cisco MDS SAN-OS Release 3.0(1) Through 3.2(1)
August 2007

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.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco MDS 9000 Family Command Reference
© 2003–2007 Cisco Systems, Inc. All rights reserved.
C
CVP, the Cisco logo, and the Cisco Square Bridge logo are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn is a service mark of Cisco Systems,
I
nc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press,
C
isco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, Follow Me Browsing,
F
ormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, LightStream, Linksys,
M
eetingPlace, MGX, Networking Academy, Network Registrar, Pack et, PIX, ProConnect, ScriptShare, SMARTnet, StackWise, The Fastest Way to Increase Your Internet
Q
uotient, and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
A
ll 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
b
etween Cisco and any other company. (0705R)

Send documentation comments to mdsfeedbac[email protected]
iii
Cisco MDS 9000 Family Command Reference
OL-8413-07, Cisco MDS SAN-OS Release 3.x
CONTENTS
New and Changed Information xxxiii
Preface xlix
Audience xlix
Organization xlix
Document Conventions l
Related Documentation lii
Release Notes lii
Compatibility Information lii
Regulatory Compliance and Safety Information lii
Hardware Installation lii
Cisco Fabric Manager liii
Command-Line Interface liii
Troubleshooting and Reference liii
Installation and Configuration Note liii
Obtaining Documentation liii
Cisco.com liv
Product Documentation DVD liv
Ordering Documentation liv
Documentation Feedback liv
Cisco Product Security Overview liv
Reporting Security Problems in Cisco Products lv
Product Alerts and Field Notices lvi
Obtaining Technical Assistance lvi
Cisco Technical Support & Documentation Website lvi
Submitting a Service Request lvii
Definitions of Service Request Severity lvii
Obtaining Additional Publications and Information lviii
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

Send documentation comments to mdsfeedbac[email protected]
Contents
iv
Cisco MDS 9000 Family Command Reference
OL-8413-07, Cisco MDS SAN-OS Release 3.x
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-14
Using the no and Default Forms of Commands 1-14
Port Names and Port Mapping 1-15
Entering CLI Commands 1-17
Viewing Switch Configurations 1-17
Saving a Configuration 1-19
Clearing a Configuration 1-20
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-25
Using the ping Command 1-25
Using traceroute 1-25
Setting the Switch’s Shell Timeout 1-26
Displaying VTY Sessions 1-26
Clearing VTY Sessions 1-26
Setting the Switch’s Terminal Timeout 1-27
Setting the Switch’s Terminal Type 1-27
Setting the Switch’s Terminal Length 1-27
Setting the Switch’s Terminal Width 1-27
Displaying Terminal Settings 1-28
Using CLI Variables 1-28
User-Defined CLI Session Variables 1-28
User-Defined CLI Persistent Variables 1-29
System Defined Variables 1-30
Using Command Aliases 1-30
Defining Command Aliases 1-31
About Flash Devices 1-31
Internal bootflash: 1-32
External CompactFlash (Slot0) 1-32

Send documentation comments to mdsfeedbac[email protected]
Contents
v
Cisco MDS 9000 Family Command Reference
OL-8413-07, Cisco MDS SAN-OS Release 3.x
Formatting Flash Disks and File Systems 1-32
Initializing bootflash: 1-32
Formatting Slot0: 1-33
Using the File System 1-33
Setting the Current Directory 1-34
Displaying the Current Directory 1-34
Listing the Files in a Directory 1-34
Creating a New Directory 1-34
Deleting an Existing Directory 1-35
Moving Files 1-35
Copying Files 1-35
Deleting Files 1-36
Displaying File Contents 1-36
Saving Command Output to a File 1-36
Directing show Command Output to a File 1-37
Compressing and Uncompressing Files 1-37
Displaying the Last Line in a File 1-38
Executing Commands Specified in a Script 1-38
Setting the Delay Time 1-39
Role-Based CLI 1-39
Using Valid Formats and Ranges 1-40
Using Debug Commands 1-41
Generating debug Command Output 1-42
Redirecting debug and Error Message Output 1-42
Enabling Message Logging 1-43
Setting the Message Logging Levels 1-43
Limiting the Types of Logging Messages Sent to the Console 1-44
Logging Messages to an Internal Buffer 1-44
Limiting the Types of Logging Messages Sent to Another Monitor 1-44
Logging Messages to a UNIX Syslog Server 1-45
Limiting Messages to a Syslog Server 1-45
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

Send documentation comments to mdsfeedbac[email protected]
Contents
vi
Cisco MDS 9000 Family Command Reference
OL-8413-07, Cisco MDS SAN-OS Release 3.x
aaa authentication login password-aging enable 2-8
aaa group server 2-9
abort 2-11
active equals saved 2-12
alert-group 2-13
arp 2-15
attach 2-16
attachpriv 2-17
attribute qos 2-18
authentication 2-19
autonomous-fabric-id (IVR topology database configuration) 2-21
autonomous-fabric-id (IVR service group configuration) 2-23
autonomous-fabric-id database 2-25
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
channel mode active 4-20
channel-group 4-21
cimserver 4-22
class 4-24

Send documentation comments to mdsfeedbac[email protected]
Contents
vii
Cisco MDS 9000 Family Command Reference
OL-8413-07, Cisco MDS SAN-OS Release 3.x
clear accounting log 4-26
clear arp-cache 4-27
clear callhome session 4-28
clear cdp 4-29
clear cores 4-30
clear counters (EXEC mode) 4-31
clear counters (SAN extension N port configuration mode) 4-32
clear crypto ike domain ipsec sa 4-33
clear crypto sa domain ipsec 4-34
clear debug-logfile 4-35
clear device-alias 4-36
clear dpvm 4-37
clear fabric-binding statistics 4-38
clear fcanalyzer 4-39
clear fcflow stats 4-40
clear fcns statistics 4-41
clear fcs statistics 4-42
clear fctimer session 4-43
clear fc-redirect config vt 4-44
clear ficon 4-45
clear fspf counters 4-46
clear install failure-reason 4-47
clear ip access-list counters 4-48
clear ips arp 4-49
clear ips stats 4-50
clear ips stats fabric interface 4-51
clear ipv6 access-list 4-52
clear ipv6 neighbors 4-53
clear islb session 4-54
clear ivr fcdomain database 4-55
clear ivr service-group database 4-56
clear ivr zone database 4-57
clear license 4-58
clear line 4-59
clear logging 4-60

Send documentation comments to mdsfeedbac[email protected]
Contents
viii
Cisco MDS 9000 Family Command Reference
OL-8413-07, Cisco MDS SAN-OS Release 3.x
clear ntp 4-61
clear port-security 4-62
clear processes log 4-64
clear qos statistics 4-65
clear radius session 4-66
clear rlir 4-67
clear role session 4-69
clear rscn session vsan 4-70
clear rscn statistics 4-71
clear santap module 4-72
clear ssm-nvram santap module 4-73
clear scheduler logfile 4-74
clear screen 4-75
clear scsi-flow statistics 4-76
clear sdv 4-77
clear ssh hosts 4-78
clear system reset-reason 4-79
clear tacacs+ session 4-80
clear tlport alpa-cache 4-81
clear user 4-82
clear vrrp 4-83
clear zone 4-84
cli alias name 4-85
cli var name (EXEC) 4-87
cli var name (configuration) 4-89
clock 4-90
clock set 4-92
cloud discover 4-93
cloud discovery 4-94
cloud-discovery enable 4-96
code-page 4-97
commit 4-98
contract-id 4-99
configure terminal 4-100
copy 4-101

Send documentation comments to mdsfeedbac[email protected]
Contents
ix
Cisco MDS 9000 Family Command Reference
OL-8413-07, Cisco MDS SAN-OS Release 3.x
copy licenses 4-104
copy ssm-nvram standby-sup 4-105
crypto ca authenticate 4-106
crypto ca crl request 4-108
crypto ca enroll 4-110
crypto ca export 4-112
crypto ca import 4-114
crypto ca test verify 4-116
crypto ca trustpoint 4-117
crypto global domain ipsec security-association lifetime 4-119
crypto ike domain ipsec 4-120
crypto ike domain ipsec rekey sa 4-121
crypto ike enable 4-122
crypto ipsec enable 4-123
crypto key generate rsa 4-124
crypto key zeroize rsa 4-126
crypto map domain ipsec (configuration mode) 4-128
crypto map domain ipsec (interface configuration submode) 4-130
crypto transform-set domain ipsec 4-131
customer-id 4-133
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
destination interface 5-14
destination-profile 5-16
device-alias (IVR fcdomain database configuration submode) 5-18
device-alias (SDV virtual device configuration submode) 5-19
device-alias abort 5-20
device-alias commit 5-21

Send documentation comments to mdsfeedbac[email protected]
Contents
x
Cisco MDS 9000 Family Command Reference
OL-8413-07, Cisco MDS SAN-OS Release 3.x
device-alias database 5-22
device-alias distribute 5-23
device-alias import fcalias 5-24
device-alias name 5-25
dir 5-26
disable 5-28
discover custom-list 5-29
discover scsi-target 5-30
distribute 5-32
do 5-33
dpvm abort 5-35
dpvm activate 5-36
dpvm auto-learn 5-37
dpvm commit 5-39
dpvm database 5-40
dpvm database copy active 5-41
dpvm database diff 5-42
dpvm distribute 5-44
dpvm enable 5-45
dscp 5-46
duplicate-message throttle 5-47
CHAPTER 6Debug 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