3750mcr latest ios

Catalyst 3750 Metro Switch Command ReferenceCisco IOS Release 12.2(58)SE April 2011

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-9645-10

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 and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party trademarks mentioned 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. (1005R) Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental. Catalyst 3750 Metro Switch Command Reference 2006-2011 Cisco Systems, Inc. All rights reserved.

CONTENTSPrefacexix xix xix xix xx

Audience Purpose Conventions

Filtering show Command Output Related Publicationsxxi

Obtaining Documentation and Submitting a Service Request1

xxi

CHAPTER

Using the Command-Line Interface

1-1

CLI Command Modes 1-1 User EXEC Mode 1-2 Privileged EXEC Mode 1-3 Global Configuration Mode 1-3 Interface Configuration Mode 1-4 VLAN Configuration Mode 1-4 Line Configuration Mode 1-4 Commands Changed in Cisco IOS 12.2(25)EY21-5

CHAPTER

Catalyst 3750 Metro Switch Cisco IOS Commands aaa accounting dot1x action2-5 2-7 2-1 2-3

2-1

aaa authentication dot1x archive download-sw archive tar2-9 2-12

archive upload-sw arp access-list auto qos voip bandwidth boot config-file boot enable-break boot helper2-25 2-20 2-13 2-15

2-23 2-24

boot helper-config-file

2-26

Catalyst 3750 Metro Switch Command Reference OL-9645-10

iii

Contents

boot manual boot system channel-group

2-27 2-28

boot private-config-file2-29 2-30 2-34

channel-protocol class2-35 2-40

class-map

clear ip arp inspection log clear ip dhcp snooping clear ipv6 dhcp conflict clear lacp2-48

2-42 2-43

clear ip arp inspection statistics2-44 2-46

clear l2protocol-tunnel counters clear mac address-table clear pagp2-51 2-52 2-49

2-47

clear mac address-table move update clear rep counters

2-50

clear spanning-tree counters clear vmps statistics clear vtp counters cpu traffic qos cos cpu traffic qos dscp define interface-range delete2-65 2-55 2-56 2-57 2-59

2-53 2-54

clear spanning-tree detected-protocols

cpu traffic qos precedence2-63

2-61

deny (ARP access-list configuration) deny (IPv6 access-list configuration) deny (MAC access-list configuration) dot1x auth-fail max-attempts dot1x auth-fail vlan dot1x default2-80 2-81 2-83 2-85 2-78 2-76

2-66 2-68 2-73

dot1x guest-vlan dot1x host-mode dot1x initialize

Catalyst 3750 Metro Switch Command Reference

iv

OL-9645-10

Contents

dot1x max-reauth-req dot1x max-req2-87

2-86

dot1x port-control

2-88 2-90 2-91 2-92

dot1x re-authenticate dot1x reauthentication

dot1x supplicant force-multicast dot1x system-auth-control dot1x test eapol-capable dot1x test timeout dot1x timeout duplex2-100 2-102 2-96 2-98 2-95 2-93 2-94

dot1x violation-mode errdisable detect cause

errdisable detect cause small-frame errdisable recovery cause small-frame errdisable recovery ethernet evc ethernet lmi2-109 2-110 2-112 2-114 2-107

2-104 2-106

ethernet lmi ce-vlan map ethernet uni ethernet uni id flowcontrol2-116 2-118

ethernet oam remote-failure

2-119 2-121

interface port-channel interface range interface vlan ip access-group ip address2-130 2-123 2-125 2-127

ip arp inspection filter vlan ip arp inspection limit ip arp inspection trust ip arp inspection vlan2-134

2-132

ip arp inspection log-buffer2-138

2-136

ip arp inspection validate

2-140

2-142 2-143

ip arp inspection vlan logging


v

Contents

ip device tracking

2-145 2-146

ip device tracking maximum ip device tracking probe ip dhcp snooping2-149

2-147

ip dhcp snooping binding ip dhcp snooping database

2-150 2-152 2-154 2-156 2-158

ip dhcp snooping information option

ip dhcp snooping information option allowed-untrusted ip dhcp snooping information option format remote-id ip dhcp snooping limit rate ip dhcp snooping trust ip dhcp snooping verify ip dhcp snooping vlan ip igmp filter ip igmp profile ip igmp snooping2-165 2-167 2-159 2-160 2-161 2-162

ip dhcp snooping vlan information option format-type circuit-id string ip igmp max-groups2-169 2-171 2-173 2-175 2-177

2-163

ip igmp snooping querier

ip igmp snooping report-suppression ip igmp snooping vlan immediate-leave ip igmp snooping vlan mrouter ip igmp snooping vlan static ip sla responder twamp ip sla server twamp ip source binding ip ssh2-188 2-186 2-184 2-182 2-178 2-180

ip sticky-arp (global configuration) ip sticky-arp (interface configuration) ip verify source2-194 2-196

2-190 2-192

ip vrf (global configuration) ip vrf (interface configuration) ipv6 access-list ipv6 address dhcp2-200 2-202

2-198

ipv6 dhcp client request vendor

2-203


vi

OL-9645-10

Contents

ipv6 dhcp ping packets ipv6 dhcp pool ipv6 dhcp server ipv6 mld snooping2-205 2-207

2-204

2-209 2-211 2-213 2-215

ipv6 mld snooping last-listener-query-count ipv6 mld snooping last-listener-query-interval ipv6 mld snooping robustness-variable ipv6 mld snooping tcn ipv6 mld snooping vlan ipv6 traffic-filter l2protocol-tunnel lacp port-priority link state group link state track2-223 2-225 2-229 2-219 2-221 2-217

ipv6 mld snooping listener-message-suppression

l2protocol-tunnel cos lacp system-priority2-236

2-230 2-232

2-234

location (global configuration) location (interface configuration) logging event logging file2-241 2-242 2-244

2-237 2-239

mac access-group

mac access-list extended mac address-table learning

2-246 2-248 2-249 2-251 2-253

mac address-table aging-time mac address-table move update mac address-table notification mac address-table static macro apply macro global macro name2-258 2-261 2-255

mac address-table static drop macro description2-262 2-265

2-256

macro global description2-266

match (access-map configuration)

2-268


vii

Contents

match (class-map configuration) mdix auto mls qos2-273 2-275 2-277

2-270

mls qos aggregate-policer mls qos cos2-279

mls qos dscp-mutation mls qos enhanced mls qos map2-285

2-281

2-283

mls qos queue-set output buffers mls qos queue-set output threshold mls qos rewrite ip dscp2-292

2-288 2-290

mls qos srr-queue input bandwidth mls qos srr-queue input buffers mls qos srr-queue input cos-map mls qos srr-queue input dscp-map mls qos srr-queue input threshold mls qos srr-queue output cos-map mls qos srr-queue output cpu-queue mls qos srr-queue output dscp-map mls qos trust monitor session mpls ldp holdtime mpls mtu2-323 2-325 2-328 2-312 2-315

2-294

2-296 2-298 2-300 2-302

mls qos srr-queue input priority-queue

2-304 2-306 2-308 2-310

mls qos vlan-based mpls l2transport route

2-316 2-320

2-322

mvr (global configuration) mvr (interface configuration) oam protocol cfm svlan pagp learn-method pagp port-priority2-335

2-332

2-333

permit (ARP access-list configuration) permit (IPv6 access-list configuration) permit (MAC-access list configuration) police2-347

2-337 2-339 2-344


viii

OL-9645-10

Contents

police aggregate police cir policy-map priority2-351

2-349

police cir percent2-358

2-354

port-channel load-balance2-363 2-365 2-367 2-370

2-361

priority-queue private-vlan queue-limit queue-set

private-vlan mapping2-372 2-374 2-375

random-detect

random-detect dscp

2-378 2-382

random-detect exponential-weighting-constant random-detect precedence remote-span rep admin vlan rep block port rep lsl-age-timer rep preempt delay rep segment rep stcn reserved-only sdm prefer2-401 2-388 2-390 2-385

renew ip dhcp snooping database2-391 2-392 2-396 2-398 2-400

rep preempt segment2-404 2-406

rmon collection stats2-408

2-407

service instance

2-411 2-412 2-414

service password-recovery

service-policy (interface configuration) service-policy (policy-map class) set setup shape2-419 2-421 2-424 2-417

setup express2-426


ix

Contents

show access-lists show archive status show arp access-list show auto qos show boot show class-map

2-428 2-431 2-432

2-433

2-436 2-438 2-439 2-441

show controllers cpu-interface show controllers tcam show cpu traffic qos show dot1q-tunnel show dot1x show dtp show env2-450 2-453 2-455 2-456 2-445 2-447 2-449

show controllers ethernet-controller

show errdisable detect show errdisable recovery show etherchannel

show errdisable flap-values2-462

2-458 2-460

show ethernet service evc

2-465 2-466 2-468

show ethernet service instance show ethernet service interface show interfaces2-470 2-477

show interfaces counters show interfaces rep show inventory2-480

show interfaces transceiver2-485 2-486 2-490

2-482

show ip arp inspection show ip dhcp snooping

show ip dhcp snooping binding show ip dhcp snooping database show ip dhcp snooping statistics show ip igmp profile show ip igmp snooping2-498 2-499

2-491 2-493 2-495

show ip igmp snooping groups show ip igmp snooping mrouter

2-501 2-503


x

OL-9645-10

Contents

show ip igmp snooping querier show ip sla standards2-506

2-504

show ip sla twamp connection show ip sla twamp session show ip source binding show ip verify source show ipv6 dhcp conflict show ipv6 mld snooping2-511 2-513 2-514 2-510

2-507

2-509

show ipv6 mld snooping address show ipv6 mld snooping mrouter show ipv6 mld snooping querier show ipv6 route updated show l2protocol-tunnel show lacp2-526 2-530 2-522 2-524

2-516 2-518 2-520

show link state group show location2-532

show mac access-group show mac address-table

2-534 2-535 2-537 2-538

show mac address-table address show mac address-table aging-time show mac address-table count show mac address-table dynamic show mac address-table interface show mac address-table learning show mac address-table multicast

2-540 2-542 2-544 2-545 2-546

show mac address-table move update show mac address-table notification show mac address-table static show mac address-table vlan show mls qos2-556 2-557 2-552 2-554

2-548 2-550

show mls qos aggregate-policer show mls qos input-queue show mls qos interface show mls qos maps show mls qos queue-set2-562 2-565 2-558 2-559


xi

Contents

show mls qos vlan show monitor show mvr

2-567

2-568 2-570

show mpls l2transport vc2-574 2-576 2-578

show mvr interface show mvr members show pagp2-580

show parser macro show policy-map show port-security show rep topology show sdm prefer show setup express show spanning-tree show storm-control show system mtu show udld show version show vlan2-605 2-608 2-610

2-582 2-585 2-587 2-590 2-592 2-595 2-596 2-602 2-604

show vlan access-map show vlan filter show vmps show vtp shutdown2-620 2-625 2-626 2-616 2-617

2-615

shutdown vlan

small-frame violation rate snmp mib rep trap-rate snmp-server enable traps snmp-server host2-634

2-627 2-629 2-630

snmp trap mac-notification change spanning-tree backbonefast spanning-tree bpdufilter spanning-tree bpduguard spanning-tree cost2-646 2-641 2-642 2-644

2-639

spanning-tree etherchannel guard misconfig

2-648


xii

OL-9645-10

Contents

spanning-tree extend system-id spanning-tree guard spanning-tree link-type spanning-tree mode spanning-tree mst cost2-651 2-653

2-650

spanning-tree loopguard default2-657

2-655

spanning-tree mst configuration2-661

2-659

spanning-tree mst forward-time spanning-tree mst hello-time spanning-tree mst max-age spanning-tree mst max-hops spanning-tree mst port-priority spanning-tree mst priority spanning-tree mst root spanning-tree port-priority2-672 2-674

2-663 2-664

2-665 2-666 2-668 2-669

spanning-tree mst pre-standard2-671

spanning-tree portfast (global configuration) spanning-tree portfast (interface configuration) spanning-tree uplinkfast spanning-tree vlan speed2-685 2-687 2-689 2-691 2-682 2-680

2-676 2-678

srr-queue bandwidth limit srr-queue bandwidth shape srr-queue bandwidth share storm-control switchport2-693 2-696 2-698

switchport access switchport block switchport host switchport mode

switchport backup interface2-704 2-706 2-707

2-700

switchport mode private-vlan switchport nonegotiate switchport port-security2-712 2-714

2-710

switchport port-security aging

2-718


xiii

Contents

switchport priority extend switchport private-vlan switchport protected switchport trunk2-725 2-724

2-720 2-722

switchport vlan mapping switchport voice vlan system mtu2-734 2-737 2-740

2-729

2-732

traceroute mac traceroute mac ip trust2-742

udld (global configuration) udld (interface configuration) udld reset uni count vlan2-751 2-756 2-748 2-749

2-744 2-746

vlan access-map vlan filter2-758

vmps reconfirm (privileged EXEC) vmps retry vmps server vtp2-767 2-771 2-762 2-763

2-760 2-761

vmps reconfirm (global configuration)

vrf upgrade-cli multi-af-mode xconnectA

2-765

APPENDIX

Catalyst 3750 Metro Switch Boot Loader Commands A-1 boot cat copy delete dirA-7 A-9 A-10 A-11 A-12 A-2 A-4 A-5 A-6

flash_init format fsck help


xiv

OL-9645-10

Contents

memory mkdir more rename reset rmdir set type unset versionB

A-13 A-14 A-15 A-16 A-17 A-18

A-19 A-22 A-23 A-25

APPENDIX

Catalyst 3750 Metro Switch Debug Commands debug auto qos debug backup debug dot1x debug dtpB-6 B-7 B-8 B-2 B-4 B-5

B-1

debug etherchannel debug interface

debug ethernet serviceB-10

debug ip dhcp snooping debug ip igmp filter debug ip igmp max-groups debug ip igmp snooping

B-11

B-12 B-13 B-14 B-15 B-17 B-19

debug ip sla error twamp connection debug ip sla error twamp control server debug ip sla error twamp session

debug ip sla error twamp control reflectorB-21 B-23

debug ip sla trace twamp connection debug ip sla trace twamp control server debug ip sla trace twamp session debug ip verify source packet debug lacp debug matmB-32 B-33

debug ip sla trace twamp control reflectorB-29

B-25 B-27

B-31

debug mac-notificationB-34

debug matm move update

B-35Catalyst 3750 Metro Switch Command Reference

OL-9645-10

xv

Contents

debug monitor debug mpls atom debug mvrdbg debug nvram debug pagp

B-36 B-37 B-38

debug mpls l2transport vlanB-39 B-40 B-41 B-42

debug platform acl debug platform cfm

debug platform backup interfaceB-44 B-45

B-43

debug platform cpu-queues debug platform dot1ad debug platform dot1xB-47 B-48

debug platform etherchannel debug platform forw-tcam

B-49 B-50

debug platform fallback-bridgingB-51

debug platform ip arp inspection debug platform ip igmp snooping debug platform ip multicast debug platform ip unicast debug platform led debug platform matm debug platform mpls debug platform phy debug platform pmB-59 B-60 B-55 B-57

B-52 B-53

debug platform messaging applicationB-62 B-63 B-64 B-66 B-67 B-68

B-61

debug platform port-asic

debug platform port-security debug platform qos-acl-tcam debug platform rep debug platform snmp debug platform spanB-70

debug platform remote-commands debug platform resource-managerB-72 B-73

B-69

B-71

debug platform supervisor-asic debug platform sw-bridgeB-75

B-74


xvi

OL-9645-10

Contents

debug platform tcam debug platform udld debug platform vlan debug pm debug repB-80

B-76 B-78 B-79

debug port-securityB-83

B-82

debug qos-manager debug spanning-tree

B-84 B-85 B-87

debug spanning-tree backbonefast debug spanning-tree bpdu debug spanning-tree mstp debug spanning-tree switch debug sw-vlanB-95 B-97 B-98 B-88 B-89

debug spanning-tree bpdu-opt

B-90 B-92 B-94

debug spanning-tree uplinkfast debug sw-vlan ifs debug sw-vlan vtp debug udld debug vqpcB-101 B-103 B-104

debug sw-vlan notificationB-99

debug xconnectC

APPENDIX

Catalyst 3750 Metro Switch Show Platform Commands C-1 show platform acl show platform cfmC-2 C-3 C-4 C-5

show platform configuration show platform etherchannel show platform forwardC-6

show platform ip igmp snooping show platform ip multicast show platform ip policy show platform ip unicast show platform ipc trace show platform layer4opC-9 C-10 C-11 C-12 C-13

C-8

show platform mac-address-table

C-14


xvii

Contents

show platform messaging show platform monitor show platform mvr table show platform pmC-18

C-15

C-16 C-17

show platform port-asic show platform qosC-24

C-19 C-23

show platform port-security

show platform resource-manager show platform snmp counters show platform spanning-tree show platform stp-instance show platform tb show platform tcam show platform vlanDC-29 C-30 C-32 C-27 C-28

C-25

C-26

APPENDIX

Acknowledgments for Open-Source Software

D-1

INDEX


xviii

OL-9645-10

PrefaceAudienceThis guide is for the networking professional using the Cisco IOS command-line interface (CLI) to manage the Catalyst 3750 Metro switch, hereafter referred to as the switch. Before using this guide, you should have experience working with the Cisco IOS commands and the switch software features. Before using this guide, you should have experience working with the concepts and terminology of Ethernet and local area networking.

PurposeThe Catalyst 3750 Metro switch is supported by a set of enterprise-class features, including Layer 2+ features such as access control lists (ACLs) and quality of service (QoS) and Layer 3 features such as IP unicast routing, IP multicast routing, and fallback bridging. It also includes features for the service provider, including multiprotocol label switching (MPLS), Ethernet over MPLS (EoMPLS), hierarchical QoS, and 802.1Q tunneling. This guide provides the information you need about the commands that have been created or changed for use with the Catalyst 3750 Metro switches. For information about the standard Cisco IOS Release 12.2 commands, see the Cisco IOS documentation set available from the Cisco.com home page by selecting Service and Support > Technical Documents. On the Cisco Product Documentation home page, select Release 12.2 from the Cisco IOS Software drop-down list. This guide does not provide procedures for configuring your switch. For detailed configuration procedures, see the software configuration guide for this release. This guide does not describe system messages that you might encounter. For more information, see the system message guide for this release. For documentation updates, see the release notes for this release.

ConventionsThis publication uses these conventions to convey instructions and information: Command descriptions use these conventions:

Commands and keywords are in boldface text. Arguments for which you supply values are in italic.


xix

Preface

Square brackets ([ ]) means optional elements. Braces ({ }) group required choices, and vertical bars ( | ) separate the alternative elements. Braces and vertical bars within square brackets ([{ | }]) mean a required choice within an optional element. Terminal sessions and system displays are in screen font. Information you enter is in boldface screen font. Nonprinting characters, such as passwords or tabs, are in angle brackets (< >).

Interactive examples use these conventions:

Notes, cautions, and warnings use these conventions and symbols:

Note

Means reader take note. Notes contain helpful suggestions or references to materials not contained in this manual.

Caution

Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data.

Filtering show Command OutputThe show commands have optional output modifiers to filter the command output.

| beginDisplay begins with the line that matches the expression. | excludeDisplay excludes with the line that matches the expression. | includeDisplay includes with the line that matches the expression. expressionExpression in the output to use as a reference point.

Expressions are case sensitive. If you enter | exclude output, the lines that contain output are not displayed, but the lines that contain Output are displayed.


xx

OL-9645-10

Preface

Related PublicationsThese documents provide complete information about the switch and are available from this Cisco.com site: http://www.cisco.com/en/US/products/hw/switches/ps5532/tsd_products_support_series_home.html

Note

Before installing, configuring, or upgrading the switch, see these documents:

For initial configuration information, see the Using Express Setup chapter or the Configuring the Switch with the CLI-Based Setup Program appendix in the hardware installation guide. For upgrade information, see the Downloading Software section in the release notes.

Release Notes for the Catalyst 3750 Metro Switch Catalyst 3750 Metro Switch Software Configuration Guide Catalyst 3750 Metro Switch Command Reference Catalyst 3750 Metro Switch System Message Guide Catalyst 3750 Metro Switch Hardware Installation Guide Cisco Small Form-Factor Pluggable Modules Installation Notes These compatibility matrix documents are available from this Cisco.com site: Cisco Gigabit Ethernet Transceiver Modules Compatibility Matrix Cisco 100-Megabit Ethernet SFP Modules Compatibility Matrix Cisco Small Form-Factor Pluggable Modules Compatibility Matrix Compatibility Matrix for 1000BASE-T Small Form-Factor Pluggable Modules

http://www.cisco.com/en/US/products/hw/modules/ps5455/products_device_support_tables_list.html

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.


xxi

Preface


xxii

OL-9645-10

CH A P T E R

1

Using the Command-Line InterfaceThe Catalyst 3750 Metro switch is supported by Cisco IOS software. This chapter describes how to use the switch command-line interface (CLI) to configure software features. For a complete description of the commands that support these features, see Chapter 2, Catalyst 3750 Metro Switch Cisco IOS Commands. For information on the boot loader commands, see Appendix A, Catalyst 3750 Metro Switch Boot Loader Commands. For information on the debug commands, see Appendix B, Catalyst 3750 Metro Switch Debug Commands. For information on the show platform commands, see Appendix C, Catalyst 3750 Metro Switch Show Platform Commands. For more information on Cisco IOS Release 12.2, see the Cisco IOS Release 12.2 Command Summary. For task-oriented configuration steps, see the software configuration guide for this release.

CLI Command ModesThis section describes the CLI command mode structure. Command modes support specific Cisco IOS commands. For example, the interface interface-id command only works when entered in global configuration mode. These are the main command modes for the switch:

User EXEC Privileged EXEC Global configuration Interface configuration VLAN configuration Line configuration

Table 1-1 lists the main command modes, how to access each mode, the prompt you see in that mode, and how to exit that mode. The prompts listed use the default name Switch.


1-1

Chapter 1 CLI Command Modes


Table 1-1

Command Modes Summary

Command Mode User EXEC

Access Method This is the first level of access. (For the switch) Change terminal settings, perform basic tasks, and list system information.

PromptSwitch>

Exit or Access Next Mode Enter the logout command. To enter privileged EXEC mode, enter the enable command. To exit to user EXEC mode, enter the disable command. To enter global configuration mode, enter the configure command.

Privileged EXEC

From user EXEC mode, enter the Switch# enable command.

Global configuration

From privileged EXEC mode, enter the configure command.

Switch(config)#

To exit to privileged EXEC mode, enter the exit or end command, or press Ctrl-Z. To enter interface configuration mode, enter the interface configuration command.

Interface configuration

From global configuration mode, Switch(config-if)# specify an interface by entering the interface command followed by an interface identification.Switch(config-vlan)# In global configuration mode, enter the vlan vlan-id command.

To exit to privileged EXEC mode, enter the end command, or press Ctrl-Z. To exit to global configuration mode, enter the exit command. To exit to global configuration mode, enter the exit command. To return to privileged EXEC mode, enter the end command, or press Ctrl-Z.

VLAN configuration

Line configuration

From global configuration mode, Switch(config-line)# specify a line by entering the line command.

To exit to global configuration mode, enter the exit command. To return to privileged EXEC mode, enter the end command, or press Ctrl-Z.

User EXEC ModeAfter you access the device, you are automatically in user EXEC command mode. The EXEC commands available at the user level are a subset of those available at the privileged level. In general, use the user EXEC commands to temporarily change terminal settings, perform basic tests, and list system information. The supported commands can vary depending on the version of software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.Switch> ?


1-2

OL-9645-10

Chapter 1

Using the Command-Line Interface CLI Command Modes

Privileged EXEC ModeBecause many of the privileged commands configure operating parameters, privileged access should be password-protected to prevent unauthorized use. The privileged command set includes those commands contained in user EXEC mode, as well as the configure privileged EXEC command through which you access the remaining command modes. If your system administrator has set a password, you are prompted to enter it before being granted access to privileged EXEC mode. The password does not appear on the screen and is case sensitive. The privileged EXEC mode prompt is the device name followed by the pound sign (#).Switch#

Enter the enable command to access privileged EXEC mode:Switch> enable Switch#

The supported commands can vary depending on the version of software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.Switch# ?

To return to user EXEC mode, enter the disable privileged EXEC command.

Global Configuration ModeGlobal configuration commands apply to features that affect the device as a whole. Use the configure privileged EXEC command to enter global configuration mode. The default is to enter commands from the management console. When you enter the configure command, a message prompts you for the source of the configuration commands:Switch# configure Configuring from terminal, memory, or network [terminal]?

You can specify either the terminal or NVRAM as the source of configuration commands. This example shows you how to access global configuration mode:Switch# configure terminal Enter configuration commands, one per line. End with CNTL/Z.

The supported commands can vary depending on the version of software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.Switch(config)# ?

To exit global configuration command mode and to return to privileged EXEC mode, enter the end or exit command, or press Ctrl-Z.


1-3

Chapter 1 CLI Command Modes


Interface Configuration ModeInterface configuration commands modify the operation of the interface. Interface configuration commands always follow a global configuration command, which defines the interface type. Use the interface interface-id command to access interface configuration mode. The new prompt means interface configuration mode.Switch(config-if)#

The supported commands can vary depending on the version of software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.Switch(config-if)# ?

To exit interface configuration mode and to return to global configuration mode, enter the exit command. To exit interface configuration mode and to return to privileged EXEC mode, enter the end command, or press Ctrl-Z.

VLAN Configuration ModeUse this mode to configure normal-range VLANs (VLAN IDs 1 to 1005) or, when VTP mode is transparent, to configure extended-range VLANs (VLAN IDs 1006 to 4094). When VTP mode is transparent, the VLAN and VTP configuration is saved in the running configuration file, and you can save it to the switch startup configuration file by using the copy running-config startup-config privileged EXEC command. The configurations of VLAN IDs 1 to 1005 are saved in the VLAN database if VTP is in transparent or server mode. The extended-range VLAN configurations are not saved in the VLAN database. Enter the vlan vlan-id global configuration command to access config-vlan mode:Switch(config)# vlan 2000 Switch(config-vlan)#

The supported keywords can vary but are similar to the commands available in VLAN configuration mode. To view a comprehensive list of commands, enter a question mark (?) at the prompt.Switch(config-vlan)# ?

For extended-range VLANs, all characteristics except the maximum transmission unit (MTU) size must remain at the default setting. To return to global configuration mode, enter exit; to return to privileged EXEC mode, enter end. All the commands except shutdown take effect when you exit config-vlan mode.

Line Configuration ModeLine configuration commands modify the operation of a terminal line. Line configuration commands always follow a line command, which defines a line number. Use these commands to change terminal parameter settings line-by-line or for a range of lines. Use the line vty line_number [ending_line_number] command to enter line configuration mode. The new prompt means line configuration mode. The following example shows how to enter line configuration mode for virtual terminal line 7:Switch(config)# line vty 0 7


1-4

OL-9645-10

Chapter 1

Using the Command-Line Interface Commands Changed in Cisco IOS 12.2(25)EY

The supported commands can vary depending on the version of software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.Switch(config-line)# ?

To exit line configuration mode and to return to global configuration mode, use the exit command. To exit line configuration mode and to return to privileged EXEC mode, enter the end command, or press Ctrl-Z.

Commands Changed in Cisco IOS 12.2(25)EYTable 1-2 lists describes the commands that have the same function but different syntax than they did in software releases before Cisco IOS Release 12.2(25)EY.Table 1-2 Commands Changed

Releases earlier than Cisco IOS Release 12.2(25)EY debug autoqos xconnect {destination vc-id}

Cisco IOS Release 12.2(25)EY or later debug auto qos xconnect {destination vc-id encapsulation mpls}

Description Enables debugging of the auto-QoS1 feature. Routes a Layer 2 packets over a specified point-to-point virtual connection.

1. auto-QoS = automatic quality of service


1-5

Chapter 1 Commands Changed in Cisco IOS 12.2(25)EY



1-6

OL-9645-10

CH A P T E R

2

Catalyst 3750 Metro Switch Cisco IOS Commandsaaa accounting dot1xUse the aaa accounting dot1x global configuration command to enable authentication, authorization, and accounting (AAA) accounting and to create method lists defining specific accounting methods on a per-line or per-interface basis for 802.1x sessions. Use the no form of this command to disable 802.1x accounting. aaa accounting dot1x {name | default} start-stop {broadcast group {name | radius | tacacs+} [group {name | radius | tacacs+} ... ] | group {name | radius | tacacs+} [group {name | radius | tacacs+} ... ]} no aaa accounting dot1x {name | default}

Syntax Description

name default start-stop

Name of a server group. This is optional when you enter it after the broadcast group and group keywords. Use the accounting methods that follow as the default list for accounting services. Send a start accounting notice at the beginning of a process and a stop accounting notice at the end of a process. The start accounting record is sent in the background. The requested-user process begins regardless of whether or not the start accounting notice was received by the accounting server. Enable accounting records to be sent to multiple AAA servers and send accounting records to the first server in each group. If the first server is unavailable, the switch uses the list of backup servers to identify the first server. Specify the server group to be used for accounting services. These are valid server group names:

broadcast

group

nameName of a server group. radiusList of all RADIUS hosts. tacacs+List of all TACACS+ hosts.

The group keyword is optional when you enter it after the broadcast group and group keywords. You can enter more than optional group keyword. radius tacacs+ (Optional) Enable RADIUS authorization. (Optional) Enable TACACS+ accounting.


2-1

Chapter 2 aaa accounting dot1x

Catalyst 3750 Metro Switch Cisco IOS Commands

Defaults

AAA accounting is disabled.

Command Modes


Command History

Release 12.2(25)EY

Modification This command was introduced.

Usage Guidelines

This command requires access to a RADIUS server.

Note

We recommend that you enter the dot1x reauthentication interface configuration command before configuring 802.1x RADIUS accounting on an interface.

Examples

This example shows how to configure 802.1x accounting:Switch(config)# aaa accounting dot1x default start-stop group radius Switch(config)#

Note

The RADIUS authentication server must be properly configured to accept and log update or watchdog packets from the AAA client.

Related Commands

Command aaa accounting dot1x dot1x reauthentication dot1x test eapol-capable reauth-period

Description Specifies one or more AAA methods for use on interfaces running 802.1x. Enables or disables periodic reauthentication. Sets the number of seconds between re-authentication attempts.


2-2

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands aaa authentication dot1x

aaa authentication dot1xUse the aaa authentication dot1x global configuration command to specify one or more authentication, authorization, and accounting (AAA) methods for use on ports running IEEE 802.1x. Use the no form of this command to disable authentication. aaa authentication dot1x {default} method1 [method2...] no aaa authentication dot1x {default}

Syntax Description

default method1 [method2...]

Use the listed authentication methods that follow this argument as the default list of methods when a user logs in. At least one of the these keywords:

enableUse the enable password for authentication. group radiusUse the list of all RADIUS servers for authentication. lineUse the line password for authentication. localUse the local username database for authentication. local-caseUse the case-sensitive local username database for authentication. noneUse no authentication. The client is automatically authenticated by the switch without using the information supplied by the client.

Note

Though visible in the command-line help strings, the group tacacs+ keyword is not supported.

Defaults

No authentication is performed.

Command Modes


Command History

Release 12.1(14)AX


Usage Guidelines

The method argument identifies the list of methods that the authentication algorithm tries in the given sequence to validate the password provided by the client. The only method that is truly 802.1x-compliant is the group radius method, in which the client data is validated against a RADIUS authentication server. The remaining methods enable AAA to authenticate the client by using locally configured data. For example, the local and local-case methods use the username and password that are saved in the configuration file. The enable and line methods use the enable and line passwords for authentication. If you specify group radius, you must configure the RADIUS server by entering the radius-server host global configuration command.


2-3

Chapter 2 aaa authentication dot1x


If you are not using a RADIUS server, you can use the local or local-case methods, which access the local username database to perform authentication. By specifying the enable or line methods, you can supply the clients with a password to provide access to the switch. Use the show running-config privileged EXEC command to display the configured lists of authentication methods.

Examples

This example shows how to enable AAA and how to create an authentication list for 802.1x. This authentication first tries to contact a RADIUS server. If this action returns an error, the user is allowed access with no authentication.Switch(config)# aaa new-model Switch(config)# aaa authentication dot1x default group radius none

You can verify your settings by entering the show running-config privileged EXEC command.

Related Commands

Command aaa new-model

Description Enables the AAA access control model. For syntax information, select Cisco IOS Security Command Reference, Release 12.2 > Authentication, Authorization, and Accounting > Authentication Commands. Displays the operating configuration. For syntax information, use this link to the Cisco IOS Release 12.2 Command Reference listing page: http://www.cisco.com/en/US/products/sw/iosswrel/ps1835/prod_command_ reference_list.html Select the Cisco IOS Commands Master List, Release 12.2 to navigate to the command.

show running-config


2-4

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands action

actionUse the action access map configuration command to set the action for the VLAN access map entry. Use the no form of this command to set the action to the default value, which is to forward. action {drop | forward} no action

Syntax Description

drop forward

Drop the packet when the specified conditions are matched. Forward the packet when the specified conditions are matched.

Defaults

The default action is to forward packets.

Command Modes

Access-map configuration

Command History

Release 12.1(14)AX


Usage Guidelines

You enter access-map configuration mode by using the vlan access-map global configuration command. If the action is drop, you should define the access map, including configuring any access control list (ACL) names in match clauses, before applying the map to a VLAN, or all packets could be dropped. In access map configuration mode, use the match access map configuration command to define the match conditions for a VLAN map. Use the action command to set the action that occurs when a packet matches the conditions. The drop and forward parameters are not used in the no form of the command.

Examples

This example shows how to identify and apply a VLAN access map vmap4 to VLANs 5 and 6 that causes the VLAN to forward an IP packet if the packet matches the conditions defined in access list al2:Switch(config)# vlan access-map vmap4 Switch(config-access-map)# match ip address al2 Switch(config-access-map)# action forward Switch(config-access-map)# exit Switch(config)# vlan filter vmap4 vlan-list 5-6

You can verify your settings by entering the show vlan access-map privileged EXEC command.


2-5

Chapter 2 action


Related Commands

Command access-list {deny | permit}

Description Configures a standard numbered ACL. For syntax information, select Cisco IOS IP Command Reference, Volume 1 of 3:Addressing and Services, Release 12.2 > IP Services Commands. Creates a named access list. For syntax information, select Cisco IOS IP Command Reference, Volume 1 of 3:Addressing and Services, Release 12.2 > IP Services Commands. Creates a named MAC address access list. Defines the match conditions for a VLAN map. Displays the VLAN access maps created on the switch. Creates a VLAN access map.

ip access-list

mac access-list extended match (access-map configuration) show vlan access-map vlan access-map


2-6

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands archive download-sw

archive download-swUse the archive download-sw privileged EXEC command to download a new image to the switch and to overwrite or keep the existing image. archive download-sw {/force-reload | /imageonly | /leave-old-sw | /no-set-boot | /overwrite | /reload | /safe} source-url

Syntax Description

/force-reload /imageonly /leave-old-sw /no-set-boot /overwrite /reload /safe

Unconditionally force a system reload after successfully downloading the software image. Download only the Cisco IOS software image. Keep the old software version after a successful download. Do not alter the setting of the BOOT environment variable to point to the new software image after it is successfully downloaded. Overwrite the software image in flash memory with the downloaded one. Reload the system after successfully downloading the image unless the configuration has been changed and not been saved. Keep the current software image; do not delete it to make room for the new software image before the new image is downloaded. The current image is deleted after the download. The source URL alias for a local or network file system. These options are supported:

source-url

The syntax for the local flash file system: flash: The syntax for the FTP: ftp:[[//username[:password]@location]/directory]/image-name.tar The syntax for the Remote Copy Protocol (RCP): rcp:[[//username@location]/directory]/image-name.tar The syntax for the TFTP: tftp:[[//location]/directory]/image-name.tar

The image-name.tar is the software image to download and install on the switch.

Note

Though visible in the command-line help strings, the no-version-check keyword is not supported.

Defaults

The current software image is not overwritten with the downloaded image. The new image is downloaded to the flash: file system. The BOOT environment variable is changed to point to the new software image on the flash: file system. Image names are case sensitive; the image file is provided in tar format.


2-7

Chapter 2 archive download-sw


Command Modes

Privileged EXEC

Command History

Release 12.1(14)AX


Usage Guidelines

Using the /safe or /leave-old-sw option can cause the new image download to fail if there is insufficient flash memory. If leaving the software in place prevents the new image from fitting in flash memory due to space constraints, an error results. If you used the /leave-old-sw option and did not overwrite the old image when you downloaded the new one, you can remove the old image by using the delete privileged EXEC command. For more information, see the delete section on page 2-65. Use the /overwrite option to overwrite the image on the flash device with the downloaded one. If you specify the command without the /overwrite option, the download algorithm verifies that the new image is not the same as the one on the switch flash device. If the images are the same, the download does not occur. If the images are different, the old image is deleted, and the new one is downloaded. After downloading a new image, enter the reload privileged EXEC command to begin using the new image, or specify the /reload or /force-reload option in the archive download-sw command.

Examples

This example shows how to download a new image from a TFTP server at 172.20.129.10 and overwrite the image on the switch:Switch# archive download-sw /overwrite tftp://172.20.129.10/test-image.tar

This example shows how to download only the software image from a TFTP server at 172.20.129.10 to the switch:Switch# archive download-sw /imageonly tftp://172.20.129.10/test-image.tar

This example shows how to keep the old software version after a successful download:Switch# archive download-sw /leave-old-sw tftp://172.20.129.10/test-image.tar

Related Commands

Command archive tar archive upload-sw delete

Description Creates a tar file, lists the files in a tar file, or extracts the files from a tar file. Uploads an existing image on the switch to a server. Deletes a file or directory on the flash memory device.


2-8

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands archive tar

archive tarUse the archive tar privileged EXEC command to create a tar file, list files in a tar file, or extract the files from a tar file. archive tar {/create destination-url flash:/file-url} | {/table source-url} | {/xtract source-url flash:/file-url [dir/file...]}

Syntax Description

/create destination-url flash:/file-url

Create a new tar file on the local or network file system. For destination-url, specify the destination URL alias for the local or network file system and the name of the tar file to create. These options are supported:

The syntax for the local flash filesystem: flash: The syntax for the FTP: ftp:[[//username[:password]@location]/directory]/tar-filename.tar The syntax for the Remote Copy Protocol (RCP) is: rcp:[[//username@location]/directory]/tar-filename.tar The syntax for the TFTP: tftp:[[//location]/directory]/tar-filename.tar

The tar-filename.tar is the tar file to be created. For flash:/file-url, specify the location on the local flash file system from which the new tar file is created. An optional list of files or directories within the source directory can be specified to write to the new tar file. If none are specified, all files and directories at this level are written to the newly created tar file.


2-9

Chapter 2 archive tar


/table source-url

Display the contents of an existing tar file to the screen. For source-url, specify the source URL alias for the local or network file system. These options are supported:

The syntax for the local flash file system: flash: The syntax for the FTP: ftp:[[//username[:password]@location]/directory]/tar-filename.tar The syntax for the RCP: rcp:[[//username@location]/directory]/tar-filename.tar The syntax for the TFTP: tftp:[[//location]/directory]/tar-filename.tar

The tar-filename.tar is the tar file to display. /xtract source-url flash:/file-url [dir/file...] Extract files from a tar file to the local file system. For source-url, specify the source URL alias for the local file system. These options are supported:

The syntax for the local flash file system: flash: The syntax for the FTP: ftp:[[//username[:password]@location]/directory]/tar-filename.tar The syntax for the RCP: rcp:[[//username@location]/directory]/tar-filename.tar The syntax for the TFTP: tftp:[[//location]/directory]/tar-filename.tar

The tar-filename.tar is the tar file from which to extract. For flash:/file-url [dir/file...], specify the location on the local flash file system into which the tar file is extracted. Use the dir/file... option to specify an optional list of files or directories within the tar file to be extracted. If none are specified, all files and directories are extracted.

Defaults

None

Command Modes

Privileged EXEC

Command History

Release 12.1(14)AX


Usage Guidelines

Filenames and directory names are case sensitive. Image names are case sensitive.


2-10

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands archive tar

Examples

This example shows how to create a tar file. The command writes the contents of the new-configs directory on the local flash device to a file named saved.tar on the TFTP server at 172.20.10.30.Switch# archive tar /create tftp:172.20.10.30/saved.tar flash:/new-configs

This example shows how to display the contents of the image-tv0-m.tar file that is in flash memory. The contents of the tar file are displayed on the screen.Switch# archive tar /table flash:image-tv0-m.tar info (219 bytes) image-tv0-mz-121/ (directory) image-tv0-mz-121/html/ (directory) image-tv0-mz-121/html/foo.html (0 bytes) image-tv0-mz-121/image-tv0-mz-121.bin (610856 bytes) image-tv0-mz-121/info (219 bytes) info.ver (219 bytes)

This example shows how to display only the image-tv0-mz-121/html directory and its contents:Switch# archive tar /table flash:image-tv0-m.tar image-tv0-mz-121/html image-tv0-mz-121/html/ (directory) image-tv0-mz-121/html/foo.html (0 bytes)

This example shows how to extract the contents of a tar file on the TFTP server at 172.20.10.30. This command extracts just the new-configs directory into the root directory on the local flash file system. The remaining files in the saved.tar file are ignored.Switch# archive tar /xtract tftp://172.20.10.30/saved.tar flash:/ new-configs

Related Commands

Command archive download-sw archive upload-sw

Description Downloads a new image to the switch. Uploads an existing image on the switch to a server.


2-11

Chapter 2 archive upload-sw


archive upload-swUse the archive upload-sw privileged EXEC command to upload an existing switch image to a server. archive upload-sw destination-url

Syntax Description

destination-url

The destination URL alias for a local or network file system. These options are supported:

The syntax for the local flash file system: flash: The syntax for the FTP: ftp:[[//username[:password]@location]/directory]/image-name.tar The syntax for the Remote Copy Protocol (RCP): rcp:[[//username@location]/directory]/image-name.tar The syntax for the TFTP: tftp:[[//location]/directory]/image-name.tar

The image-name.tar is the name of software image to be stored on the server.

Defaults

Uploads the currently running image from the flash: file system.

Command Modes

Privileged EXEC

Command History

Release 12.1(14)AX


Usage Guidelines

The files are uploaded in this sequence: the Cisco IOS image and the info file. After these files are uploaded, the software creates the tar file. Image names are case sensitive.

Examples

This example shows how to upload the currently running image to a TFTP server at 172.20.140.2:Switch# archive upload-sw tftp://172.20.140.2/test-image.tar

Related Commands

Command archive download-sw archive tar

Description Downloads a new image to the switch. Creates a tar file, lists the files in a tar file, or extracts the files from a tar file.


2-12

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands arp access-list

arp access-listUse the arp access-list global configuration command on the switch to define an Address Resolution Protocol (ARP) access control list (ACL) or to add clauses to the end of a previously defined list. Use the no form of this command to delete the specified ARP access list. arp access-list acl-name no arp access-list acl-name This command is available only if your switch is running the enhanced multilayer image (EMI).

Syntax Description

acl-name

Name of the ACL.

Defaults

No ARP access lists are defined.

Command Modes


Command History

Release 12.2(25)EY


Usage Guidelines

After entering the arp access-list command, you enter ARP access-list configuration mode, and these configuration commands are available:

default: returns a command to its default setting. deny: specifies packets to reject. For more information, see the deny (ARP access-list configuration) section on page 2-66. exit: exits ARP access-list configuration mode. no: negates a command or returns to default settings. permit: specifies packets to forward. For more information, see the permit (ARP access-list configuration) section on page 2-337.

Use the permit and deny access-list configuration commands to forward and to drop ARP packets based on the specified matching criteria. When the ARP ACL is defined, you can apply it to a VLAN by using the ip arp inspection filter vlan global configuration command. ARP packets containing only IP-to-MAC address bindings are compared to the ACL. All other types of packets are bridged in the ingress VLAN without validation. If the ACL permits a packet, the switch forwards it. If the ACL denies a packet because of an explicit deny statement, the switch drops the packet. If the ACL denies a packet because of an implicit deny statement, the switch compares the packet to the list of DHCP bindings (unless the ACL is static, which means that packets are not compared to the bindings).


2-13

Chapter 2 arp access-list


Examples

This example shows how to define an ARP access list and to permit both ARP requests and ARP responses from a host with an IP address of 1.1.1.1 and a MAC address of 0000.0000.abcd:Switch(config)# arp access-list static-hosts Switch(config-arp-nacl)# permit ip host 1.1.1.1 mac host 00001.0000.abcd Switch(config-arp-nacl)# end

You can verify your settings by entering the show arp access-list privileged EXEC command.

Related Commands

Command deny (ARP access-list configuration)

Description Denies an ARP packet based on matches compared against the DHCP bindings.

ip arp inspection filter Permits ARP requests and responses from a host configured with a static IP address. vlan permit (MAC-access list configuration) show arp access-list Permits an ARP packet based on matches compared against the DHCP bindings. Displays detailed information about ARP access lists.


2-14

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands auto qos voip

auto qos voipUse the auto qos voip interface configuration command to automatically configure quality of service (QoS) for voice over IP (VoIP) within a QoS domain. Use the no form of this command to return to the default setting. auto qos voip {cisco-phone | cisco-softphone | trust} no auto qos voip [cisco-phone | cisco-softphone | trust]

Syntax Description

cisco-phone

Identify this port as connected to a Cisco IP phone, and automatically configure QoS for VoIP. The QoS labels of inbound packets are trusted only when the phone is detected.

cisco-softphone Identify this port as connected to a device running the Cisco SoftPhone, and automatically configure QoS for VoIP. trust Identify this port as connected to a trusted switch or router, and automatically configure QoS for VoIP. The QoS labels of inbound packets are trusted. For nonrouted ports, the class of service (CoS) value of the inbound packet is trusted. For routed ports, the Differentiated Services Code Point (DSCP) value is trusted.

Defaults

Auto-QoS is disabled on the port. When auto-QoS is enabled, it uses the ingress packet label to categorize traffic, to assign packet labels, and to configure the ingress queues and egress queue-sets. Table 2-1 shows the default settings.

Table 2-1

Traffic Types, Packet Labels, and Queues

VoIP Data Traffic DSCP3 CoS4

VoIP Control Traffic 24, 26 3

Routing Protocol Traffic 48 6

STP1 BPDU2 Traffic 56 7

Real-Time Video Traffic 34 3

All Other Traffic 0, 1 (queue 1)

46 5

CoS-to-Ingress Queue Map CoS-to-Egress Queue Map

2, 3, 4, 5, 6, 7 (queue 2) 5 (queue 1) 3, 6, 7 (queue 2) 4 (queue 3)

2 0, 1 (queue 3) (queue 4)

1. STP = Spanning Tree Protocol 2. BPDU = bridge protocol data unit 3. DSCP = Differentiated Services Code Point 4. CoS = class of service

Table 2-2 shows the generated auto-QoS configuration for the ingress queues.


2-15

Chapter 2 auto qos voip


Table 2-2

Auto-QoS Configuration for the Ingress Queues

Ingress Queue SRR1 shared Priority

Queue Number 1 2

CoS-to-Queue Map 0, 1 2, 3, 4, 5, 6, 7

Queue Weight (Bandwidth) 81 percent 19 percent

Queue (Buffer) Size 67 percent 33 percent

1. SRR = shaped round robin. Ingress queues support shared mode only.

Table 2-3 shows the generated auto-QoS configuration for the egress queue-set.Table 2-3 Auto-QoS Configuration for the Egress Queue-Set

Egress Queue1 Priority (shaped) SRR shared SRR shared SRR shared

Queue Number in the Queue-Set 1 2 3 4

CoS-to-Queue Map 5 3, 6, 7 2, 4 0, 1

Queue Weight (Bandwidth) 10 percent 10 percent 60 percent 20 percent

Queue (Buffer) Size 10 percent 10 percent 26 percent 54 percent

1. On an enhanced-services (ES) port, the srr-queue bandwidth shape interface configuration command is not part of the generated auto qos voip command list.

Command Modes

Interface configuration

Command History

Release 12.1(14)AX 12.2(25)EY

Modification This command was introduced. The cisco-softphone keyword was added, and the generated auto-QoS configuration changed.

Usage Guidelines

Use this command to configure the QoS appropriate for VoIP traffic within the QoS domain. The QoS domain includes the switch, the interior of the network, and edge devices that can classify inbound traffic for QoS. In releases earlier than Cisco IOS Release 12.2(25)EY, auto-QoS configures the switch only for VoIP with Cisco IP Phones on switch ports. In Cisco IOS Release 12.2(25)EY or later, auto-QoS configures the switch for VoIP with Cisco IP Phones on switch and routed ports and for VoIP with devices running the Cisco SoftPhone application. These releases support only Cisco IP SoftPhone Version 1.3(3) or later. Connected devices must use Cisco Call Manager Version 4 or later. To take advantage of the auto-QoS defaults, you should enable auto-QoS before you configure other QoS commands. You can fine-tune the auto-QoS configuration after you enable auto-QoS.


2-16

OL-9645-10

Chapter 2


Note

The switch applies the auto-QoS-generated commands as if the commands were entered from the command-line interface (CLI). An existing user configuration can cause the application of the generated commands to fail, or the user configuration might be overridden by the generated commands. These actions occur without warning. If all the generated commands are successfully applied, any user-entered configuration that was not overridden remains in the running configuration. Any user-entered configuration that was overridden can be retrieved by reloading the switch without saving the current configuration to memory. If the generated commands are not applied, the previous running configuration is restored. If this is the first port on which you have enabled auto-QoS, the auto-QoS-generated global configuration commands are executed, followed by the interface configuration commands. If you enable auto-QoS on another port, only the auto-QoS-generated interface configuration commands for that port are executed. When you enable the auto-QoS feature on the first port, these automatic actions occur:

QoS is globally enabled (mls qos global configuration command), and other global configuration commands are added. When you enter the auto qos voip cisco-phone interface configuration command on a port at the edge of the network that is connected to a Cisco IP phone, the switch enables the trusted boundary feature. The switch uses the Cisco Discovery Protocol (CDP) to detect the presence or absence of a Cisco IP phone. When a Cisco IP phone is detected, the ingress classification on the port is set to trust the QoS label received in the packet. When a Cisco IP phone is absent, the ingress classification is set to not trust the QoS label in the packet. The switch configures ingress queues and the egress queue-set on the port according to the settings in Table 2-2 and Table 2-3. When you enter the auto qos voip cisco-softphone interface configuration command on a port at the edge of the network that is connected to a device running the Cisco SoftPhone, the switch uses policing to decide whether a packet is in or out of profile and to specify the action on the packet. If the packet does not have a DSCP value of 24, 26, or 46 or is out of profile, the switch changes the DSCP value to 0. The switch configures ingress and egress queues on the port according to the settings in Table 2-2 and Table 2-3. When you enter the auto qos voip trust interface configuration command on a port connected to the interior of the network, the switch trusts the CoS value for nonrouted ports or the DSCP value for routed ports in ingress packets (the assumption is that traffic has already been classified by other edge devices). The switch configures the ingress queues and the egress queue-set on the port according to the settings in Table 2-2 and Table 2-3.

You can enable auto-QoS on static, dynamic-access, voice VLAN access, and trunk ports. When enabling auto-QoS with a Cisco IP Phone on a routed port, you must assign a static IP address to the IP phone. To display the QoS commands that are automatically generated when auto-QoS is enabled or disabled, enable debugging before you enable auto-QoS. Use the debug auto qos privileged EXEC command to enable auto-QoS debugging. For more information, see the debug auto qos command.

Note

When a device running Cisco SoftPhone is connected to a switch or routed port, the switch supports only one Cisco SoftPhone application per port. After auto-QoS is enabled, do not modify a policy map or aggregate policer that includes AutoQoS in its name. If you need to modify the policy map or aggregate policer, make a copy of it, and change the copied policy map or policer. To use the new policy map instead of the generated one, remove the generated policy map from the interface, and apply the new policy map.


2-17

Chapter 2 auto qos voip


To disable auto-QoS on a port, use the no auto qos voip interface configuration command. Only the auto-QoS-generated interface configuration commands for this port are removed. If this is the last port on which auto-QoS is enabled and you enter the no auto qos voip command, auto-QoS is considered disabled even though the auto-QoS-generated global configuration commands remain (to avoid disrupting traffic on other ports affected by the global configuration). You can use the no mls qos global configuration command to disable the auto-QoS-generated global configuration commands. With QoS disabled, there is no concept of trusted or untrusted ports because the packets are not modified (the CoS, DSCP, and IP precedence values in the packet are not changed). Traffic is switched in pass-through mode (packets are switched without any rewrites and classified as best effort without any policing). On a port on which the auto qos voip command is enabled, the queue-set ID that is generated depends on the interface:

For a Fast Ethernet interface, auto-QoS generates queue-set 1 (which is the default). For a Gigabit Ethernet interface, auto-QoS generates queue-set 2.

Examples

This example shows how to enable auto-QoS on a port and to trust the QoS labels received in inbound packets when the switch or router connected to a port is a trusted device:Switch(config)# interface gigabitethernet1/0/1 Switch(config-if)# auto qos voip trust

You can verify your settings by entering the show auto qos interface interface-id privileged EXEC command.

Related Commands

Command debug auto qos mls qos cos

Description Enables debugging of the auto-QoS feature. Defines the default CoS value of a port or assigns the default CoS to all inbound packets on the port.

mls qos map {cos-dscp dscp1 ... dscp8 Defines the CoS-to-DSCP map or the DSCP-to-CoS map. | dscp-cos dscp-list to cos} mls qos queue-set output buffers mls qos srr-queue input bandwidth mls qos srr-queue input buffers mls qos srr-queue input cos-map mls qos srr-queue input dscp-map mls qos srr-queue input priority-queue mls qos srr-queue output cos-map mls qos srr-queue output dscp-map mls qos trust queue-set show auto qos Allocates buffers to a queue-set. Assigns SRR weights to an ingress queue. Allocates the buffers between the ingress queues. Maps CoS values to an ingress queue or maps CoS values to a queue and to a threshold ID. Maps DSCP values to an ingress queue or maps DSCP values to a queue and to a threshold ID. Configures the ingress priority queue and guarantees bandwidth. Maps CoS values to an egress queue or maps CoS values to a queue and to a threshold ID. Maps DSCP values to an egress queue or maps DSCP values to a queue and to a threshold ID. Configures the port trust state. Maps a port to a queue-set. Displays the initial configuration that is generated by the auto-QoS feature.


2-18

OL-9645-10

Chapter 2


Command show mls qos interface srr-queue bandwidth shape srr-queue bandwidth share

Description Displays QoS information at the port level. Assigns the shaped weights and enables bandwidth shaping on the four egress queues mapped to a standard port. Assigns the shared weights and enables bandwidth sharing on the four egress queues mapped to a port.


2-19

Chapter 2 bandwidth


bandwidthUse the bandwidth policy-map class configuration command to specify or modify the minimum bandwidth provided to a class belonging to a hierarchical policy map attached to an enhanced-services (ES) port. Use the no form of this command to return to the default setting. bandwidth {bandwidth-kbps | percent percent} no bandwidth

Syntax Description

bandwidth-kbps

Amount of bandwidth in kbps assigned to the class. The range is 200 to 2000000. Allocate the bandwidth in 100-kbps increments; otherwise, the software rounds down the bandwidth to the nearest 100-kbps increment.

percent percent

Percentage of available bandwidth assigned to the parent class. The range is 1 to 100.

Defaults

No bandwidth is specified.

Command Modes

Policy-map class configuration

Command History

Release 12.1(14)AX 12.2(25)EY

Modification This command was introduced. Hierarchical service policies can be applied to inbound traffic received on an ES port.

Usage Guidelines

Use the bandwidth command only in a hierarchical policy map attached to an ES port. This command is not valid for the class-default class in a physical-level policy map. Use the bandwidth command when you configure a policy map for a class defined by the class-map global configuration command. The bandwidth command specifies the minimum bandwidth for traffic in that class when there is traffic congestion in the switch. If the switch is not congested, the class receives more bandwidth than you specify with this command. Class-based weighted fair queueing (CBWFQ) derives the weight for packets belonging to the class from the bandwidth allocated to the class. CBWFQ then uses the weight to ensure that the queue for the class is serviced fairly.

Note

It is important to remember that hard bandwidth guarantees might not be provided and that only relative bandwidths are assured. That is, class bandwidths are always proportional to the specified percentages of the port bandwidth. When the link bandwidth is fixed, class bandwidth guarantees are in proportion to the configured percentages.


2-20

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands bandwidth

These restrictions apply to the bandwidth command:

If the percent keyword is used, the sum of the class bandwidth percentages within a single policy map cannot exceed 99 percent. Percentage calculations are based on the bandwidth available at the parent class (or the port if it is the parent). The amount of bandwidth available to a class is dependent on the amount of bandwidth reserved by the parent class. The amount of bandwidth configured should be large enough to accommodate Layer 2 overhead. A policy map can have all the class bandwidths specified in either kbps or in percentages, but not a mix of both. You cannot specify bandwidth in kbps in a child policy (configured through the service-policy policy-map class configuration command) and then specify bandwidth as a percentage in the parent policy. You cannot use the bandwidth command for the class-default class map in a physical-level policy map. Though visible in the command-line interface, the max-reserved-bandwidth interface configuration command and the bandwidth interface configuration command are not supported on the ES ports.

When you configure the bandwidth command in a class policy, you must also configure the bandwidth or shape policy-map class configuration command in the parent VLAN-level policy. You must configure the bandwidth or the shape policy-map class configuration command before you configure either the queue-limit or the random-detect policy-map class configuration command in a class policy. You cannot use the bandwidth, queue-limit, random-detect, and the shape policy-map class configuration commands with the priority policy-map class configuration command in the same class within the same policy map. However, you can use these commands in the same policy map. When you use the service-policy interface configuration command to attach the policy map containing class configurations to an ES port, the switch determines the available bandwidth.

Examples

This example shows how to set the minimum bandwidth to 2000 kbps for a class called silver-class. The class already exists in the switch configuration.Switch(config)# policy-map polmap6 Switch(config-pmap)# class silver-class Switch(config-pmap-c)# bandwidth 2000

This example shows how to guarantee 30 percent of the bandwidth for class1 and 25 percent of the bandwidth for class2 when CBWFQ is configured. A policy map with two classes is created and is then attached to an ES port.Switch(config)# policy-map policy1 Switch(config-pmap)# class class1 Switch(config-pmap-c)# bandwidth percent 50 Switch(config-pmap-c)# exit Switch(config-pmap)# class class2 Switch(config-pmap-c)# bandwidth percent 25 Switch(config-pmap-c)# exit Switch(config-pmap)# end Switch(config)# interface gigabitethernet1/1/1 Switch(config-if)# service-policy input policy1

This example shows how bandwidth is guaranteed if low-latency queueing (LLQ) and CBWFQ are configured. In this example, LLQ is enabled in a class called voice1.


2-21

Chapter 2 bandwidth


Switch(config)# policy-map policy1 Switch(config-pmap)# class class1 Switch(config-pmap-c)# bandwidth percent 50 Switch(config-pmap-c)# exit Switch(config-pmap)# class class2 Switch(config-pmap-c)# bandwidth percent 25 Switch(config-pmap-c)# exit Switch(config-pmap)# class voice1 Switch(config-pmap-c)# priority Switch(config-pmap-c)# exit Switch(config-pmap)# end Switch(config)# interface gigabitethernet1/1/1 Switch(config-if)# service-policy output policy1

You can verify your settings by entering the show policy-map privileged EXEC command.

Related Commands

Command class policy-map priority queue-limit random-detect service-policy (policy-map class) shape show policy-map

Description Specifies the name of the class whose traffic policy you want to create or change. Creates or modifies a policy map that can be attached to multiple ports to specify a service policy. Enables the strict-priority queue and gives priority to a class of traffic belonging to a policy map attached to an ES port. Configures the maximum threshold for tail drop in a policy map attached to an ES port. Configures Weighted Random Early Detection (WRED) in a policy map attached to an ES port. Creates a service policy as a quality of service (QoS) policy within a policy map. Enables traffic shaping in a policy map attached to an ES port. Displays QoS policy maps.


2-22

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands boot config-file

boot config-fileUse the boot config-file global configuration command to specify the filename that software uses to read and write a nonvolatile copy of the system configuration. Use the no form of this command to return to the default setting. boot config-file flash:/file-url no boot config-file

Syntax Description

flash:/file-url

The path (directory) and name of the configuration file.

Defaults

The default configuration file is flash:config.text.

Command Modes


Command History

Release 12.1(14)AX


Usage Guidelines

Filenames and directory names are case sensitive. This command changes the setting of the CONFIG_FILE environment variable. For more information, see Appendix A, Catalyst 3750 Metro Switch Boot Loader Commands.

Related Commands

Command show boot

Description Displays the settings of the boot environment variables.


2-23

Chapter 2 boot enable-break


boot enable-breakUse the boot enable-break global configuration command to enable interrupting the automatic boot process. Use the no form of this command to return to the default setting. boot enable-break no boot enable-break

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled. The automatic boot process cannot be interrupted by pressing the Break key on the console.

Command Modes


Command History

Release 12.1(14)AX


Usage Guidelines

When you enter this command, you can interrupt the automatic boot process by pressing the Break key on the console after the flash file system is initialized.

Note

Despite the setting of this command, you can interrupt the automatic boot process at any time by pressing the MODE button on the switch front panel. This command changes the setting of the ENABLE_BREAK environment variable. For more information, see Appendix A, Catalyst 3750 Metro Switch Boot Loader Commands.

Related Commands

Command show boot



2-24

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands boot helper

boot helperUse the boot helper global configuration command to dynamically load files during boot loader initialization to extend or patch the functionality of the boot loader. Use the no form of this command to return to the default. boot helper filesystem:/file-url ... no boot helper

Syntax Description

filesystem: /file-url

Alias for a flash file system. Use flash: for the system board flash device. The path (directory) and a list of loadable files to dynamically load during loader initialization. Separate each image name with a semicolon.

Defaults

No helper files are loaded.

Command Modes


Command History

Release 12.1(14)AX


Usage Guidelines

This variable is used only for internal development and testing. Filenames and directory names are case sensitive. This command changes the setting of the HELPER environment variable. For more information, see Appendix A, Catalyst 3750 Metro Switch Boot Loader Commands.

Related Commands

Command show boot



2-25

Chapter 2 boot helper-config-file


boot helper-config-fileUse the boot helper-config-file global configuration command to specify the name of the configuration file to be used by the helper image. If this is not set, the file specified by the CONFIG_FILE environment variable is used by all versions of software that are loaded. Use the no form of this command to return to the default setting. boot helper-config-file filesystem:/file-url no boot helper-config file

Syntax Description


Alias for a flash file system. Use flash: for the system board flash device. The path (directory) and helper configuration file to load.

Defaults

No helper configuration file is specified.

Command Modes


Command History

Release 12.1(14)AX


Usage Guidelines

This variable is used only for internal development and testing. Filenames and directory names are case sensitive. This command changes the setting of the HELPER_CONFIG_FILE environment variable. For more information, see Appendix A, Catalyst 3750 Metro Switch Boot Loader Commands.

Related Commands

Command show boot



2-26

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands boot manual

boot manualUse the boot manual global configuration command to enable manually booting the switch during the next boot cycle. Use the no form of this command to return to the default setting. boot manual no boot manual

Syntax Description

This command has no arguments or keywords.

Defaults

Manual booting is disabled.

Command Modes


Command History

Release 12.1(14)AX


Usage Guidelines

The next time you reboot the system, the switch is in boot loader mode, which is shown by the switch: prompt. To boot the system, use the boot boot loader command, and specify the name of the bootable image. This command changes the setting of the MANUAL_BOOT environment variable. For more information, see Appendix A, Catalyst 3750 Metro Switch Boot Loader Commands.

Related Commands

Command show boot



2-27

Chapter 2 boot private-config-file


boot private-config-fileUse the boot private-config-file global configuration command to specify the filename that software uses to read and write a nonvolatile copy of the private configuration. Use the no form of this command to return to the default setting. boot private-config-file filename no boot private-config-file

Syntax Description

filename

The name of the private configuration file.

Defaults

The default configuration file is private-config.

Command Modes


Command History

Release 12.1(14)AX


Usage Guidelines

Filenames are case sensitive.

Examples

This example shows how to specify the name of the private configuration file to be pconfig:Switch(config)# boot private-config-file pconfig

Related Commands

Command show boot



2-28

OL-9645-10

Chapter 2

Catalyst 3750 Metro Switch Cisco IOS Commands boot system

boot systemUse the boot system global configuration command to specify the image to load during the next boot cycle. Use the no form of this command to return to the default setting. boot system filesystem:/file-url ... no boot system

Syntax Description


Alias for a flash file system. Use flash: for the system board flash device. The path (directory) and name of a bootable image. Separate image names with a semicolon.

Defaults

The switch attempts to automatically boot the system by using information in the BOOT environment variable. If this variable is not set, the switch attempts to load and execute the first executable image it can by performing a recursive, depth-first search throughout the flash file system. In a depth-first search of a directory, each encountered subdirectory is completely searched before continuing the search in the original directory.

Command Modes


Command History

Release 12.1(14)AX


Usage Guidelines

Filenames and directory names are case sensitive. If you are using the archive download-sw privileged EXEC command to maintain system images, you never need to use the boot system command. The boot system command is automatically manipulated to load the downloaded image. This command changes the setting of the BOOT environment variable. For more information, see Appendix A, Catalyst 3750 Metro Switch Boot Loader Commands.

Related Commands

Command show boot



2-29

Chapter 2 channel-group


channel-groupUse the channel-group interface configuration command to assign a port to an EtherChannel group and to enable an EtherChannel mode. Use the no form of this command to remove a port from an EtherChannel group. channel-group channel-group-number mode {active | {auto [non-silent]} | {desirable [non-silent]} | on | passive} no channel-group PAgP modes: channel-group channel-group-number mode {{auto [non-silent]} | {desirable [non-silent}} LACP modes: channel-group channel-group-number mode {active | passive} On mode: channel-group channel-group-number mode on

Syntax Description

channel-group-number mode active

Specify the channel group number. The range is 1 to 12. Specify the EtherChannel mode of the port. Unconditionally enable Link Aggregation Protocol (LACP). Active mode places a port into a negotiating state in which the port initiates negotiations with other ports by sending LACP packets. A channel is formed with another port group in either the active or passive mode.

auto

Enable the Port Aggregation Protocol (PAgP) only if a PAgP device is detected. Auto mode places a port into a passive negotiating state in which the port responds to PAgP packets it receives but does not start PAgP packet negotiation. A channel is formed only with another port group in desirable mode. When auto is enabled, silent operation is the default.

desirable

Unconditionally enable PAgP. Desirable mode places a port int