Cisco Cisco mds 9124 - fabric switch Service 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.3(1a)
April 2008
Text Part Number: OL-16217-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.
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.
CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco StadiumVision, the Cisco logo, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work,
Live, Play, and Learn is a service mark; 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,
iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, 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. (0804R)
Cisco MDS 9000 Family Command Reference
© 2008 Cisco Systems, Inc. All rights reserved.

Send documentation comments to mdsfeedbac[email protected]
iii
Cisco MDS 9000 Family Command Reference
OL-16217-01, Cisco MDS SAN-OS Release 3.x
CONTENTS
New and Changed Information xxxiii
Preface lxv
Audience lxv
Organization lxv
Document Conventions lxvi
Related Documentation lxvii
Release Notes lxvii
Compatibility Information lxviii
Regulatory Compliance and Safety Information lxviii
Hardware Installation lxviii
Cisco Fabric Manager lxviii
Command-Line Interface lxix
Intelligent Storage Networking Services Configuration Guides lxix
Troubleshooting and Reference lxix
Installation and Configuration Note lxix
Obtaining Documentation lxx
Cisco.com lxx
Product Documentation DVD lxx
Ordering Documentation lxx
Documentation Feedback lxxi
Cisco Product Security Overview lxxi
Reporting Security Problems in Cisco Products lxxi
Product Alerts and Field Notices lxxii
Obtaining Technical Assistance lxxii
Cisco Technical Support & Documentation Website lxxiii
Submitting a Service Request lxxiv
Definitions of Service Request Severity lxxiv
Obtaining Additional Publications and Information lxxv
CHAPTER 1CLI Overview 1-1
About the Switch Prompt 1-2
About the CLI Command Modes 1-3
Understanding CLI Command Hierarchy 1-4

Send documentation comments to mdsfeedbac[email protected]
Contents
iv
Cisco MDS 9000 Family Command Reference
OL-16217-01, Cisco MDS SAN-OS Release 3.x
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
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

Send documentation comments to mdsfeedbac[email protected]
Contents
v
Cisco MDS 9000 Family Command Reference
OL-16217-01, Cisco MDS SAN-OS Release 3.x
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-34
Creating a New Directory 1-34
Deleting an Existing Directory 1-34
Moving Files 1-34
Copying Files 1-35
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

Send documentation comments to mdsfeedbac[email protected]
Contents
vi
Cisco MDS 9000 Family Command Reference
OL-16217-01, Cisco MDS SAN-OS Release 3.x
aaa authentication login 2-6
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
auto-volgrp 2-26
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

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

Send documentation comments to mdsfeedbac[email protected]
Contents
viii
Cisco MDS 9000 Family Command Reference
OL-16217-01, Cisco MDS SAN-OS Release 3.x
clear ivr service-group database 4-60
clear ivr zone database 4-61
clear license 4-62
clear line 4-63
clear logging 4-64
clear ntp 4-65
clear port-security 4-66
clear processes log 4-68
clear qos statistics 4-69
clear radius session 4-70
clear rlir 4-71
clear rmon alarms 4-73
clear rmon all-alarms 4-74
clear rmon hcalarms 4-75
clear rmon log 4-76
clear role session 4-77
clear rscn session vsan 4-78
clear rscn statistics 4-79
clear santap module 4-80
clear ssm-nvram santap module 4-81
clear scheduler logfile 4-82
clear screen 4-83
clear scsi-flow statistics 4-84
clear sdv 4-85
clear snmp hostconfig 4-86
clear ssh hosts 4-87
clear system reset-reason 4-88
clear tacacs+ session 4-89
clear tlport alpa-cache 4-90
clear user 4-91
clear vrrp 4-92
clear zone 4-93
cli alias name 4-94
cli var name (EXEC) 4-96
cli var name (configuration) 4-98

Send documentation comments to mdsfeedbac[email protected]
Contents
ix
Cisco MDS 9000 Family Command Reference
OL-16217-01, Cisco MDS SAN-OS Release 3.x
clock 4-99
clock set 4-101
cloud discover 4-102
cloud discovery 4-103
cloud-discovery enable 4-105
cluster 4-106
code-page 4-107
commit 4-109
contract-id 4-110
configure terminal 4-111
copy 4-112
copy licenses 4-115
copy ssm-nvram standby-sup 4-116
crypto ca authenticate 4-117
crypto ca crl request 4-119
crypto ca enroll 4-121
crypto ca export 4-123
crypto ca import 4-125
crypto ca test verify 4-127
crypto ca trustpoint 4-128
crypto global domain ipsec security-association lifetime 4-130
crypto ike domain ipsec 4-131
crypto ike domain ipsec rekey sa 4-132
crypto ike enable 4-133
crypto ipsec enable 4-134
crypto key generate rsa 4-135
crypto key zeroize rsa 4-137
crypto map domain ipsec (configuration mode) 4-139
crypto map domain ipsec (interface configuration submode) 4-141
crypto transform-set domain ipsec 4-142
customer-id 4-144
CHAPTER 5D Commands 5-1
data-pattern-file 5-2
deadtime (radius group configuration) 5-3
deadtime (tacacs+ group configuration) 5-4

Send documentation comments to mdsfeedbac[email protected]
Contents
x
Cisco MDS 9000 Family Command Reference
OL-16217-01, Cisco MDS SAN-OS Release 3.x
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
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 5-29
discover custom-list 5-30
discover scsi-target 5-31
distribute 5-33
do 5-34
dpvm abort 5-36
dpvm activate 5-37
dpvm auto-learn 5-38
dpvm commit 5-40
dpvm database 5-41
dpvm database copy active 5-42
dpvm database diff 5-43
dpvm distribute 5-45
dpvm enable 5-46
dscp 5-47
duplicate-message throttle 5-48
CHAPTER 6Debug Commands 6-1
debug aaa 6-2