Cisco ME 3800X Installation manual

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 ME 3800X and ME 3600X Switch
Command Reference
Cisco IOS Release 15.3(1)S
November 2012
Text Part Number: OL-28238-01

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this
URL: 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. (1110R)
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.
Cisco ME 3800X and ME 3600X Switch Command Reference
© 2010—2012 Cisco Systems, Inc. All rights reserved.

iii
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
CONTENTS
Preface xv
Changes to This Document xv
Purpose xv
Audience xvi
Conventions xvi
Related Publications xvii
Obtaining Documentation and Submitting a Service Request xviii
CHAPTER 1Using 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
CHAPTER 2Cisco ME 3800X and ME 3600X Switch
Cisco IOS Commands 2-1
action 2-1
aggregate interval 2-3
aggregate interval burst-cycles 2-5
alarm-contact 2-7
archive download-sw 2-9
archive tar 2-12
archive upload-sw 2-15
bandwidth 2-17
boot config-file 2-20
boot helper 2-21
boot helper-config-file 2-22
boot manual 2-23
boot private-config-file 2-24
boot system 2-25

Contents
iv
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
channel-group 2-26
channel-protocol 2-29
class 2-30
class-map 2-32
clear ipc 2-34
clear lacp 2-35
clear logging onboard 2-36
clear mac address-table 2-37
clear pagp 2-39
clear rep counters 2-40
clear spanning-tree counters 2-41
conform-action 2-43
controller BITS input applique 2-45
controller BITS output applique 2-47
controller BITS shutdown 2-49
copy logging onboard module 2-50
define interface-range 2-52
delete 2-54
deny (MAC access-list configuration) 2-55
diagnostic schedule test 2-58
diagnostic start test 2-60
distribution 2-62
duplex 2-64
errdisable detect cause 2-66
errdisable recovery 2-68
ethernet evc 2-71
ethernet lmi 2-72
ethernet oam remote-failure 2-74
ethernet uni id 2-75
ethernet y1731 delay 2-76
ethernet y1731 loss 2-78
exceed-action 2-80
flowcontrol 2-82
frame consecutive 2-84
frame interval 2-85

Contents
v
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
frequency (IP SLA) 2-86
history interval 2-87
hw-module module logging onboard 2-88
interface port-channel 2-90
interface range 2-92
interface vlan 2-94
ip access-group 2-96
ip address 2-99
ip igmp filter 2-101
ip igmp max-groups 2-102
ip igmp profile 2-104
ip igmp snooping 2-106
ip igmp snooping last-member-query-interval 2-107
ip igmp snooping report-suppression 2-109
ip igmp snooping tcn 2-111
ip igmp snooping tcn flood 2-112
ip igmp snooping vlan immediate-leave 2-113
ip igmp snooping vlan mrouter 2-114
ip igmp snooping vlan static 2-116
ip sla 2-118
ip sla reaction-configuration 2-120
ip sla schedule 2-123
ip ssh 2-126
l2protocol 2-127
l2 vfi 2-129
lacp fast-switchover 2-131
lacp max-bundle 2-132
lacp port-priority 2-133
lacp rate 2-135
lacp system-priority 2-137
location (global configuration) 2-139
location (interface configuration) 2-141
logging event 2-143
logging file 2-144
mac access-group 2-146

Contents
vi
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
mac access-list extended 2-148
mac address-table aging-time 2-150
mac address-table learning 2-152
mac address-table move update 2-154
mac address-table notification 2-156
mac address-table static 2-158
macro apply 2-160
macro description 2-162
macro global 2-163
macro global description 2-165
match (access-map configuration) 2-166
match access-group 2-168
match cos 2-169
match discard-class 2-171
match ip dscp 2-172
match ip precedence 2-174
match mpls experimental topmost 2-176
match qos-group 2-178
match vlan 2-180
max-delay 2-182
mdix auto 2-184
mtu 2-186
network-clock hold-off 2-187
network-clock input-source 2-188
network-clock revertive 2-190
network-clock synchronization ssm option 2-191
network-clock wait-to-restore 2-192
network-clock-select 2-193
network-clock-select hold-off timeout 2-194
network-clock-select hold-timeout 2-195
network-clock-select mode 2-197
network-clock-select option 2-198
network-clock-select output 2-199
network-clock-select wait-to-restore-timeout 2-200
oam protocol cfm svlan 2-201

Contents
vii
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
pagp learn-method 2-202
pagp port-priority 2-204
permit (MAC access-list configuration) 2-206
police 2-209
policy-map 2-213
port-channel load-balance 2-216
port-type 2-218
priority 2-219
ql-enabled rep-segment 2-221
queue-limit 2-222
random-detect 2-225
random-detect cos 2-228
random-detect cos-based 2-230
random-detect dscp 2-231
random-detect exponential-weighting-constant 2-234
random-detect precedence 2-236
rep admin vlan 2-238
rep block port 2-239
rep lsl-age-timer 2-242
rep preempt delay 2-244
rep preempt segment 2-246
rep segment 2-247
rep stcn 2-250
reserved-only 2-252
rmon collection stats 3-1
service instance 3-2
service password-recovery 3-4
service-policy (interface and service-instance configuration modes) 3-6
set cos 3-8
set discard-class 3-10
set dscp 3-11
set mpls 3-13
set network-clocks 3-15
set precedence 3-17
set qos-group 3-19

Contents
viii
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
setup 3-21
shape average 3-24
show access-lists 3-26
show archive status 3-29
show boot 3-30
show cable-diagnostics tdr 3-32
show class-map 3-34
show controllers bits 3-35
show controllers cpu-interface 3-36
show controllers ethernet-controller 3-38
show controllers utilization 3-43
show diagnostic 3-45
show env 3-49
show errdisable detect 3-52
show errdisable flap-values 3-54
show errdisable recovery 3-56
show etherchannel 3-58
show ethernet service evc 3-61
show flowcontrol 3-62
show interfaces 3-64
show interfaces counters 3-71
show interfaces rep 3-74
show interfaces transceiver 3-76
show inventory 3-79
show ip igmp profile 3-80
show ip igmp snooping 3-81
show ip igmp snooping groups 3-83
show ip igmp snooping mrouter 3-85
show ipc 3-86
show lacp 3-90
show location 3-94
show logging onboard 3-97
show mac access-group 3-101
show mac address-table 3-103
show mac address-table address 3-105

Contents
ix
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
show mac address-table aging-time 3-107
show mac address-table bridge-domain 3-109
show mac address-table count 3-111
show mac address-table dynamic 3-113
show mac address-table interface 3-115
show mac address-table learning 3-117
show mac address-table move update 3-118
show mac address-table notification 3-120
show mac address-table static 3-122
show mac address-table vlan 3-124
show network-clocks 3-126
show pagp 3-128
show parser macro 3-130
show policy-map 3-132
show port-type 3-135
show rep topology 3-137
show spanning-tree 3-140
show storm-control 3-146
show udld 3-148
show version 3-150
show vfi 3-152
show vlan 3-154
show vlan access-map 3-157
show vlan filter 3-158
shutdown 4-1
shutdown vlan 4-2
snmp mib rep trap-rate 4-3
snmp-server enable traps 4-4
snmp-server host 4-8
snmp trap mac-notification change 4-12
spanning-tree bpdufilter 4-14
spanning-tree bpduguard 4-16
spanning-tree cost 4-18
spanning-tree etherchannel guard misconfig 4-20
spanning-tree extend system-id 4-22

Contents
x
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
spanning-tree guard 4-23
spanning-tree link-type 4-25
spanning-tree loopguard default 4-27
spanning-tree mode 4-29
spanning-tree mst configuration 4-30
spanning-tree mst cost 4-32
spanning-tree mst forward-time 4-34
spanning-tree mst hello-time 4-35
spanning-tree mst max-age 4-36
spanning-tree mst max-hops 4-37
spanning-tree mst port-priority 4-38
spanning-tree mst pre-standard 4-40
spanning-tree mst priority 4-41
spanning-tree mst root 4-42
spanning-tree port-priority 4-44
spanning-tree portfast (global configuration) 4-46
spanning-tree portfast (interface configuration) 4-48
spanning-tree vlan 4-50
speed 4-53
storm-control 4-55
switchport 4-58
switchport access vlan 4-60
switchport backup interface 4-62
switchport block 4-66
switchport host 4-68
switchport mode 4-69
switchport trunk 4-71
system env temperature threshold alert 4-73
test cable-diagnostics tdr 4-74
traceroute mac 4-75
traceroute mac ip 4-78
udld 4-80
udld port 4-82
udld reset 4-84
uni count 4-85

Contents
xi
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
uni-vlan 4-87
violate-action 4-88
vlan 4-90
vlan access-map 4-93
vlan dot1q tag native 4-95
vlan filter 4-96
vpn id 4-97
xconnect 4-98
APPENDIX ACisco ME 3800X and ME 3600X Switch
Boot Loader Commands A-1
arp A-2
boot A-3
cat A-5
copy A-6
delete A-7
dir A-8
flash_init A-10
format A-11
fsck A-12
help A-13
memory A-14
mgmt_clr A-15
mgmt_init A-16
mgmt_show A-17
mkdir A-18
more A-19
peek A-20
ping A-21
poke A-22
rename A-23
reset A-24
rmdir A-25
set A-26
set_param A-29
sleep A-30

Contents
xii
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
type A-31
unset A-32
version A-34
APPENDIX BCisco ME 3800X and ME 3600X Switch
Debug Commands B-1
debug bridge-domain B-2
debug etherchannel B-3
debug ethernet service B-4
debug interface B-6
debug ip igmp filter B-7
debug ip igmp max-groups B-8
debug ip igmp snooping B-9
debug lacp B-10
debug mac-notification B-11
debug matm B-12
debug matm move B-13
debug network-clock B-14
debug nvram B-15
debug pagp B-16
debug pm B-17
debug rep B-19
debug qos B-20
debug spanning-tree B-21
debug spanning-tree bpdu B-23
debug spanning-tree bpdu-opt B-24
debug spanning-tree mstp B-25
debug spanning-tree switch B-27
debug spanning-tree vlan-shim B-29
debug sw-vlan B-31
debug sw-vlan ifs B-32
debug sw-vlan notification B-33
debug udld B-35
debug vfi B-37
debug vrrp B-38
debug xconnect B-39

Contents
xiii
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
APPENDIX CAcknowledgments for Open-Source Software C-1
I NDEX

Contents
xiv
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01

xv
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
Preface
This preface contains information about the Cisco ME 3800X and ME 3600X Switch Command
Reference, Cisco IOS Release 15.3(1)S document:
•Changes to This Document, page xv
•Purpose, page xv
•Audience, page xvi
•Conventions, page xvi
•Related Publications, page xvii
•Obtaining Documentation and Submitting a Service Request, page xviii
Changes to This Document
Table 1 lists the technical changes made to this document.
Purpose
If you have a service support contract and order a software license or if you order a switch, you receive
the universal software image, available in crypto an noncrypto versions. If you do not have a service
support contract, such as a SMARTnet contract, download the image from Cisco.com.
The ME 3600X supports these licenses:
•Metro IP access is the universal image.
•Advanced Metro IP access license.
•10 Gigabit Ethernet upgrade license.
The ME 3800X supports these licenses plus a scaled license that can be installed with any of these
licenses to increase the supported values for that license, for example, more MAC addresses, VLANs,
IPv4 routes, and so on. You must purchase the scaled license.
•Metro Ethernet services is the universal image.
Table 1 Changes to This Document
Revision Date Change Summary
OL-28238-01 November 2012 Initial release of this document.

xvi
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
Preface
•Metro IP services license.
•Metro Aggregation services license.
For differences in feature support for each license, see the software configuration guide.
To install a software image, see the switch release notes and the “Working with the Cisco IOS File
System, Configuration Files, and Software Images” chapter in the software configuration guide.
This guide provides the information you need about the Layer 2 and Layer 3 commands that have been
created or changed for use with the switch. For information about the standard Cisco IOS commands, see
Master Index for Cisco IOS Software Release 15.3.
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 you might encounter. For more information, see the
system message guide for this release.
For the latest documentation updates, see the release notes for this release.
Audience
This guide is for the networking professional using the Cisco IOS command-line interface (CLI) to
manage the Cisco Metro Ethernet (ME) 3800X and ME 3600X switches, 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. You should also have experience working with the concepts and
terminology of Ethernet and local area networking.
Conventions
This 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.
•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.
Interactive examples use these conventions:
•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 (< >).
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.

xvii
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
Preface
Caution Means reader be careful. In this situation, you might do something that could result in equipment
damage or loss of data.
Related Publications
These documents provide complete information about the switch and are available from these Cisco.com
sites:
ME 3800X switch:
http://www.cisco.com/en/US/products/ps10965/tsd_products_support_series_home.html
ME 3600X switch:
http://www.cisco.com/en/US/products/ps10956/tsd_products_support_series_home.html
Note Before installing, configuring, or upgrading the switch, see these documents:
•For initial configuration information, see the “Configuring the Switch with the CLI-Based Setup
Program” appendix in the hardware installation guide.
•For upgrading information, see the “Downloading Software” section in the release notes.
•Release Notes for the Cisco ME 3800X and ME 3600X Switch
Note See the release notes on Cisco.com for the latest information.
•Cisco ME 3800X and ME 3600X Switch Software Configuration Guide
•Cisco ME 3800X and ME 3600X Switch Command Reference
•Cisco ME 3800X and ME 3600X Switch Hardware Installation Guide
•Cisco ME 3800X and ME 3600X Switch Getting Started Guide
•Installation Notes for the Cisco ME 3800X and ME 3600X Switch Power-Supply and Fan Modules
•Regulatory Compliance and Safety Information for the Cisco ME 3800X and ME 3600X Switches
•Cisco Small Form-Factor Pluggable Modules Installation Notes
•Cisco CWDM GBIC and CWDM SFP Installation Notes
These compatibility matrix documents are available from this Cisco.com site:
http://www.cisco.com/en/US/products/hw/modules/ps5455/products_device_support_tables_list.html
•Cisco Gigabit Ethernet Transceiver Modules Compatibility Matrix
•Cisco 100-Megabit Ethernet SFP Modules Compatibility Matrix
•Cisco CWDM SFP Transceiver Compatibility Matrix
•Cisco Small Form-Factor Pluggable Modules Compatibility Matrix
•Compatibility Matrix for 1000BASE-T Small Form-Factor Pluggable Modules

xviii
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
Preface
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional
information, see the monthly What’s 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 What’s 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.

CHAPTER
1-1
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
1
Using the Command-Line Interface
The Cisco Metro Ethernet (ME) 3600 and 3800 Series switches are supported by Cisco IOS software.
This chapter describes how to use the switch command-line interface (CLI) to configure software
features.
For a complete command descriptions, see these sections:
•For the configuration and monitoring commands that support these features, see Chapter 2, “Cisco
ME 3800X and ME 3600X Switch Cisco IOS Commands.”
•For information on the boot loader commands, see Appendix A, “Cisco ME 3800X and ME 3600X
Switch Boot Loader Commands.”
•For information on the debug commands, see Appendix B, “Cisco ME 3800X and ME 3600X
Switch Debug Commands.”
•For information on the show platform commands, see Appendix C, “Acknowledgments for
Open-Source Software.”
•For more information on Cisco IOS Release 15.3, see the Cisco IOS Release 15.3 Command
Summary.
For task-oriented configuration steps, see the software configuration guide for this release.
In this document, unless otherwise specified, IP refers to IP version 4 (IPv4).
CLI Command Modes
This 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

1-2
Cisco ME 3800X and ME 3600X Switch Command Reference
OL-28238-01
Chapter 1 Using the Command-Line Interface
CLI Command Modes
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.
User EXEC Mode
After 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 display a
comprehensive list of commands, enter a question mark (?) at the prompt.
Switch> ?
Table 1-1 Command Modes Summary
Command Mode Access Method Prompt Exit or Access Next Mode
User EXEC This is the first level of access.
(For the switch) Change terminal
settings, perform basic tasks, and
list system information.
Switch> Enter the logout command.
To enter privileged EXEC mode, enter
the enable command.
Privileged EXEC From user EXEC mode, enter the
enable command.
Switch# To exit to user EXEC mode, enter the
disable command.
To enter global configuration mode,
enter the configure 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,
specify an interface by entering
the interface command followed
by an interface identification.
Switch(config-if)# To exit to privileged EXEC mode,
enter the end command, or press
Ctrl-Z.
To exit to global configuration mode,
enter the exit command.
VLAN
configuration
In global configuration mode,
enter the vlan vlan-id command.
Switch(config-vlan)# To exit to global configuration mode,
enter the exit command.
To return to privileged EXEC mode,
enter the end command, or press
Ctrl-Z.
Line configuration From global configuration mode,
specify a line by entering the line
command.
Switch(config-line)# To exit to global configuration mode,
enter the exit command.
To return to privileged EXEC mode,
enter the end command, or press
Ctrl-Z.