Cisco MDS 9000 Family Command Reference, Release 2

S e 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 CommandReference, Release 2.xCisco MDS SAN-OS Release 2.0(1b) through Release 2.1(1a)April 2005Corporate HeadquartersCisco Systems, Inc.170 West Tasman DriveSan Jose, CA 95134-1706USAhttp://www.cisco.comTel: 408 526-4000800 553-NETS (6387)Fax: 408 526-4100Text Part Number: OL-6970-03

S e 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 .THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALLSTATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUTWARRANTY 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 THATSHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSEOR 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 publicdomain 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” WITHALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUTLIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OFDEALING, 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 CISCOOR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.CCSP, CCVP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn,and iQuick Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, theCisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Empowering the InternetGeneration, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise,the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX,Post-Routing, Pre-Routing, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, StrataView Plus, TeleRouter, The Fastest Way to Increase Your Internet Quotient,and TransPath 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 relationshipbetween Cisco and any other company. (0502R)Cisco MDS 9000 Family Command ReferenceCopyright 2002–2005 Cisco Systems, Inc. All rights reserved.

S e 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 iDocument ConventionsxxviiiRelated DocumentationxxixObtaining Documentation xxxCisco.com xxxDocumentation DVD xxxOrdering Documentation xxxDocumentation FeedbackxxxiCisco Product Security Overview xxxiReporting Security Problems in Cisco ProductsxxxiObtaining Technical Assistance xxxiiCisco Technical Support Website xxxiiSubmitting a Service Request xxxiiDefinitions of Service Request Severity xxxiiiObtaining Additional Publications and InformationCHAPTER1CLI Overviewxxxiii1-1About the Switch Prompt1-2About the CLI Command Modes1-3Understanding CLI Command Hierarchy 1-4EXEC Mode Options 1-5Configuration Mode 1-6Configuration Mode Commands and SubmodesNavigating Through CLI Commands 1-9Getting Help 1-9Command Completion 1-9Using the no and Default Forms of CommandsEntering CLI Commands 1-10Viewing Switch Configurations 1-10Saving a Configuration 1-13Clearing a Configuration 1-131-61-10Cisco MDS 9000 Family Command ReferenceOL-6970-03, Cisco MDS SAN-OS Release 2.xiii

ContentsS e 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 .Searching and Filtering CLI Output 1-13Multiple Filter Commands 1-14Searching and Filtering CLI Output Examples 1-15Displaying Users 1-18Sending Messages to Users 1-18Using the ping Command 1-18Using traceroute 1-19Setting the Switch’s Shell Timeout 1-19Displaying VTY Sessions 1-19Clearing VTY Sessions 1-20Setting the Switch’s Terminal Timeout 1-20Setting the Switch’s Terminal Type 1-20Setting the Switch’s Terminal Length 1-21Setting the Switch’s Terminal Width 1-21Displaying Terminal Settings 1-21About Flash Devices 1-22Internal bootflash: 1-22External CompactFlash (Slot0)1-22Formatting Flash Disks and File SystemsInitializing bootflash: 1-23Formatting Slot0: 1-231-23Using the File System 1-24Setting the Current Directory 1-24Displaying the Current Directory 1-24Listing the Files in a Directory 1-25Creating a New Directory 1-25Deleting an Existing Directory 1-25Moving Files 1-25Copying Files 1-26Deleting Files 1-26Displaying File Contents 1-26Saving Command Output to a File 1-27Compressing and Uncompressing Files 1-27Displaying the Last Line in a File 1-28Executing Commands Specified in a Script 1-28Setting the Delay Time 1-29Role-Based CLI1-29Using Valid Formats and Ranges1-30Cisco MDS 9000 Family Command ReferenceivOL-6970-03, Cisco MDS SAN-OS Release 2.x

ContentsS e 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 .Using Debug Commands 1-31Generating debug Command Output 1-32Redirecting debug and Error Message Output 1-32Enabling Message Logging 1-33Setting the Message Logging Levels 1-33Limiting the Types of Logging Messages Sent to the Console 1-34Logging Messages to an Internal Buffer 1-34Limiting the Types of Logging Messages Sent to Another Monitor 1-34Logging Messages to a UNIX Syslog Server 1-35Limiting Messages to a Syslog Server 1-35CHAPTER2A Commands2-1aaa accounting logsize2-2aaa accounting default2-3aaa authentication login2-4aaa authentication dhchap defaultaaa authentication iscsi defaultaaa group serverabort2-72-82-10active equals savedarp2-62-112-12attach module2-13attribute qos2-14autonomous-fabric-id (IVR topology database configuration)autonomous-fabric-id (IVR service group configuration)autonomous-fabric-id databaseCHAPTER3B -173-1banner motdboot2-15broadcast3-8C Commands4-1callhome3-74-2callhome test4-4Cisco MDS 9000 Family Command ReferenceOL-6970-03, Cisco MDS SAN-OS Release 2.xv

ContentsS e 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 .cdcdp4-54-6cfs distribute4-8channel mode activecimserverclass4-104-114-13clear accounting logclear arp-cache4-154-16clear callhome sessionclear cdp4-174-18clear cores4-19clear counters (EXEC mode)4-20clear counters (SAN extension N port configuration mode)clear crypto ike domain ipsec saclear crypto sa domain ipsecclear debug-logfileclear device-aliasclear dpvm4-234-254-26clear fcanalyzer4-29clear fcns statisticsclear fcs statistics4-304-31clear fctimer sessionclear ficon4-274-28clear fcflow stats4-324-33clear fspf counters4-34clear ip access-list countersclear ips arp4-354-36clear ivr zone databaseclear license4-374-384-39clear loggingclear ntp4-224-24clear fabric-binding statisticsclear line4-214-404-41clear port-securityclear processes log4-424-44Cisco MDS 9000 Family Command ReferenceviOL-6970-03, Cisco MDS SAN-OS Release 2.x

ContentsS e 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 .clear qos statistics4-45clear radius sessionclear rlir4-464-47clear role session4-48clear rscn statistics4-49clear scheduler logfileclear screen4-504-51clear scsi-flow statisticsclear ssh hosts4-524-53clear system reset-reasonclear tacacs session4-55clear tlport alpa-cacheclear user4-57clear vrrp4-58clear zoneclock4-564-594-60code-page4-62clock gure terminalcopy4-544-674-68copy licenses4-71crypto global domain ipsec security-association lifetimecrypto ike domain ipsec4-73crypto ike domain ipsec rekey sacrypto ike enablecrypto ipsec enable4-724-744-754-76crypto map domain ipsec (configuration mode)4-77crypto map domain ipsec (interface configuration submode)crypto transform-set domain ipseccustomer-id4-794-804-82Cisco MDS 9000 Family Command ReferenceOL-6970-03, Cisco MDS SAN-OS Release 2.xvii

ContentsS e 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 .CHAPTER5D n interface5-6destination-profile5-8device-alias abort5-10device-alias commit5-11device-alias database5-12device-alias distribute5-13device-alias import fcaliasdevice-alias namedir5-155-16disable5-18discover custom-list5-19discover scsi-target5-20distributedo5-225-23dpvm abort5-25dpvm activate5-26dpvm auto-learndpvm commit5-275-29dpvm database5-30dpvm database copy activedpvm database diffdpvm distributedpvm enabledscp65-315-325-345-355-36duplicate-message throttleCHAPTER5-14Debug Commandsdebug aaadebug all5-376-16-26-4debug biosd6-5debug bootvardebug callhome6-66-7Cisco MDS 9000 Family Command ReferenceviiiOL-6970-03, Cisco MDS SAN-OS Release 2.x

ContentsS e 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 .debug cdp6-9debug cfs6-11debug cimserverdebug core6-136-14debug device-aliasdebug dpvm6-156-17debug dstats6-19debug ethport6-20debug exceptionlog6-22debug fabric-bindingdebug fc-tunneldebug fc26-256-27debug fc2d6-30debug fcc6-32debug fcdomaindebug fcfwd6-346-36debug fcnsdebug fcs6-386-40debug fcsp-mgr6-42debug fdmi6-44debug ficon6-46debug flogi6-48debug fm6-50debug fspf6-52debug hardware arbiterdebug idehsddebug ike6-57debug ipacldebug ipsecdebug isnsdebug ivr6-586-59debug ipconfdebug ips6-556-56debug ilc helperdebug ipfc6-236-606-616-626-646-666-68Cisco MDS 9000 Family Command ReferenceOL-6970-03, Cisco MDS SAN-OS Release 2.xix

ContentsS e 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 .debug klm6-70debug license6-72debug logfile6-73debug mcast6-75debug mip6-77debug moduledebug ntp6-786-79debug platformdebug port6-806-82debug port-channeldebug qos6-846-85debug radius6-86debug rd-reg6-88debug rdl errorsdebug rib6-90debug rlir6-91debug rscn6-896-92debug san-ext-tunerdebug scsi-flow6-95debug scsi-target6-97debug securitydebug sensor6-936-986-99debug snmp6-100debug span6-102debug system healthdebug tacacs debug tcap6-1066-108debug tlport6-109debug ttyddebug vni6-1046-1106-111debug vrrpdebug vsandebug wr-reg6-1126-1146-116debug wwn6-117debug xbar6-119Cisco MDS 9000 Family Command ReferencexOL-6970-03, Cisco MDS SAN-OS Release 2.x