Table Of Contents

show bridge-domain

show ethernet cfm domain

show ethernet cfm errors

show ethernet cfm maintenance-points local

show ethernet cfm maintenance-points remote

show ethernet cfm maintenance-points remote crosscheck

show ethernet cfm maintenance-points remote detail

show ethernet cfm mpdb

show ethernet cfm smep

show ethernet cfm statistics

show ethernet cfm traceroute-cache

show ethernet lmi

show ethernet oam discovery

show ethernet oam statistics

show ethernet oam status

show ethernet oam summary

show ethernet service evc

show ethernet service instance

show ethernet service interface

show lacp

show lldp

snmp-server enable traps ethernet cfm alarm

snmp-server enable traps ethernet cfm cc

snmp-server enable traps ethernet cfm crosscheck

snmp-server enable traps ethernet evc

snmp-server enable traps ether-oam

snmp-server host traps evc

source template (eoam)

template (eoam)

traceroute ethernet

traceroute ethernet evc

traceroute ethernet vlan

uni count

show bridge-domain

To display bridge-domain information, use the show bridge-domain command in privileged EXEC mode.

show bridge-domain [bridge-id [mac security [address | last violation | statistics] | split-horizon [group {group-number | all | none}]] | stats]

Syntax Description

bridge-id	(Optional) Identifier for the bridge-domain instance. Integer in the range 1 to Platform_Upper_Bound, where Platform_Upper_Bound is a platform-specific upper limit.
mac security	(Optional) Displays the MAC security status of the specified bridge domain.
address	(Optional) Displays the secure addresses on the specified bridge domain.
last-violation	(Optional) Displays the last violation recorded on the specified bridge domain.
statistics	(Optional) Displays MAC security statistics for the specified bridge domain.
split-horizon	(Optional) Displays bridge-domain information for a split-horizon.
group	(Optional) Displays bridge-domain information for a split-horizon group.
group-number	(Optional) Number of a specific split-horizon group for bridge-domain information display.
all	(Optional) Selects all ports in split-horizon groups for bridge-domain information display.
none	(Optional) Selects ports that do not belong to any split-horizon group for bridge-domain information display.
stats	(Optional) Displays bridge-domain statistics.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.

Usage Guidelines

This command is useful for system monitoring and troubleshooting.

Examples

The following example shows sample output where the MAC addresses on all service instances for a specific bridge domain are displayed:

Router# show bridge-domain 730 mac security address

Port                  MAC Address       Type      Rem. Age(min)

Gi1/0/0 ServInst 1    0001.0001.0001    static    74      

Gi1/0/0 ServInst 1    0001.0001.0002    static    74      

Gi1/0/0 ServInst 1    0001.0001.aaaa    dynamic   74      

Gi1/0/0 ServInst 1    0001.0001.aaab    dynamic   74      

Gi1/0/0 ServInst 2    0002.0002.0002    static    -       

Gi1/0/0 ServInst 2    0002.0002.0003    static    -       

Gi1/0/0 ServInst 2    0002.0002.0004    static    -       

Gi1/0/0 ServInst 2    0002.0002.aaaa    dynamic   -       

Gi1/0/0 ServInst 2    0002.0002.bbbb    dynamic   -       

Gi1/0/0 ServInst 2    0002.0002.cccc    dynamic   -

Table 1 describes the significant fields in the output.

Table 1 show bridge-domain Field Descriptions 

Field	Description
Port	Displays the type and number of the interface and the service instance number for the specified bridge domain.
MAC Address	Displays the MAC addresses on each service instance.
Type	Indicates the type of MAC address by declaring if it was statically configured or dynamically learned.
Rem. Age (min)	Displays the remaining age of the address, in minutes. Note A "-" indicates that the aging is not enabled.

Related Commands

Command	Description
clear bridge-domain	Clears bridge-domain attributes that are not needed.
show ethernet service instance	Displays information about Ethernet service instances.
show ethernet service interface	Displays interface-only information about Ethernet customer service instances.

show ethernet cfm domain

To display information for an Ethernet connectivity fault management (CFM) domain, use the show ethernet cfm domain command in privileged EXEC mode.

show ethernet cfm domain [domain-name | brief]

Syntax Description

domain-name	(Optional) String of a maximum of 154 characters.
brief	(Optional) Specifies a display of brief details about configured maintenance domains.

Command Default

All information about all the configured domains is displayed when the optional keywords are not used.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SXI2	This command was introduced.
12.2(33)SRE	This command was integrated into Cisco IOS Release 12.2(33)SRE.

Usage Guidelines

When a domain name is not specified, information for all domains is shown.

If a domain name has more than 43 characters, a warning message is displayed notifying that the maintenance domain ID (MDID) will be truncated to 43 characters in continuity check messages (CCMs) if "id <fmt> <MDID>" is not configured.

When the brief keyword is used, the command output shows the following summary data:

•Domain name

•Domain index

•Domain level

•Number of maintenance associations in the domain

•Archive hold time for the error and continuity check databases for the domain

Examples

Following is sample output from a show ethernet cfm domain command using the brief keyword:

Router# show ethernet cfm domain brief 

Domain Name                              Index Level Services Archive(min)

Domain_L7                                   19     7        1     100

Domain_L5                                   20     5        1     100

Domain_port                                 18     0        1     100

Router1-cfm#

Table 2 describes the significant fields shown in the display.

Table 2 show ethernet cfm domain brief Field Descriptions 

Field	Description
Domain Name	Name of the domain.
Index	Running counter
Level	Maintenance domain level.
Services	Number of services running.
Archive(min)	Number of the minutes that data from a missing maintenance endpoint (MEP) is kept in the continuity check database or that entries are held in the error database before they are purged.

Following is sample output from a show ethernet cfm domain command when neither of the options is used:

Router# show ethernet cfm domain

Domain Name: Domain_L7

Level: 7 

Total Services : 1

  Services:

  VLAN Dir CC CC-int Static-rmep Crosscheck MaxMEP MA-Name 

  11   Up  Y  10s    Disabled    Disabled   100    cust_700_l7

Domain Name: Domain_L5

Level: 5 

Total Services : 1

  Services:

  VLAN Dir CC CC-int Static-rmep Crosscheck MaxMEP MA-Name 

  9    Up  Y  10s    Disabled    Disabled   100    cust_500_l5

Domain Name: Domain_port

Level: 0 

Total Services : 1

  Services:

  VLAN Dir CC CC-int Static-rmep Crosscheck MaxMEP MA-Name 

none Dwn Y  10s    Disabled    Disabled   100    portmep

Table 3 describes the significant fields shown in the display.

Table 3 show ethernet cfm domain Field Descriptions 

Field	Description
Domain Name	Name of the domain.
Level	Maintenance domain level.
Total Services	Number of services running.
Services	The services currently running.
VLAN	Number of the VLAN.
Dir	Either up (toward the switch) or down (toward the LAN or wire).
CC	Continuity Check message (CCM) status (enabled or disabled).
CC-int	Time between CCMs.
Static-rmep	Status of the remote MEP.
Crosscheck	Status of the cross-check function.
MaxMEP	Number of maximum MEPs allowed.
MA-Name	Name of the maintenance association.

Related Commands

Command	Description
show ethernet cfm maintenance-points remote	Displays information about remote maintenance points in the continuity check database.
show ethernet cfm maintenance-points remote crosscheck	Displays information about remote maintenance points configured statically in a cross-check list.
show ethernet cfm maintenance-points remote detail	Displays information about a remote maintenance point in the continuity check database.

show ethernet cfm errors

To display connectivity fault management (CFM) continuity check error conditions logged on a device since it was last reset or since the log was last cleared, use the show ethernet cfm errors command in privileged EXEC mode.

Cisco pre-Standard CFM Draft 1 (CFM D1)

show ethernet cfm errors [domain domain-name | level level-id]

CFM IEEE 802.1ag Standard (CFM IEEE)

show ethernet cfm errors [configuration | domain-id {mac address | domain-name | dns dns-name | null} [service {ma-name | ma-num | vlan-id vlan-id | vpn-id vpn-id}]]

Syntax Description

domain	(Optional) Indicates that a maintenance domain is specified.
domain-name	(Optional) String of a maximum of 154 characters.
level	(Optional) Indicates that a maintenance level is specified.
level-id	(Optional) Integer from 0 to 7 that identifies the maintenance level.
configuration	(Optional) Displays the configuration error list information; for example, port, VLAN, and error condition.
domain-id	(Optional) Displays by domain ID.
mac-address	(Optional) MAC address of the maintenance domain.
dns	(Optional) Displays a domain name service (DNS).
dns-name	(Optional) String of a maximum of 43 characters.
null	(Optional) Indicates there is not a domain name.
service	(Optional) Displays a maintenance association within the domain.
ma-name	(Optional) String that identifies the maintenance association.
ma-num	(Optional) Integer that identifies the maintenance association.
vlan-id	(Optional) Displays a VLAN.
vlan-id	(Optional) Integer from 1 to 4094 that identifies the VLAN.
vpn-id	(Optional) Displays a virtual private network (VPN).
vpn-id	(Optional) Integer from 1 to 32767 that identifies the VPN.

Command Default

In CFM IEEE, when no maintenance domain is specified, errors for all domains are displayed.

In CFM D1, when no maintenance domain or maintenance level is specified, errors for all domains and all levels are displayed.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2.
15.0(1)XA	This command was integrated into Cisco IOS Release 15.0(1)XA.

Usage Guidelines

Errors that are logged and that the show ethernet cfm errors command displays depend on the version of CFM that is running. Errors include the following:

•MEP-Down—Maintenance End Point (MEP) timed out or is advertising a 0 lifetime.

•Configuration Error—A continuity check message (CCM) is received that has an maintenance point ID (MPID) matching the local device, but the source MAC address is different.

•Forwarding Loop—A CCM is received, that has the same MPID and same MAC address as the local device.

•Cross-connected—A CCM is received and the service ID does not match the service ID configured on the device for that VLAN.

•Cross-check Missing MEP—The cross-checking delay timer has expired, and the configured remote MEP did not come up.

•Cross-check Unknown MEP—An unexpected remote MEP came up.

•Receive AIS—A MEP detects a mismerge, which is an unexpected MEP condition, or a signal fail condition resulting in peer MEPs receiving an alarm indication signal (AIS) frame.

Error conditions are kept in a log for the duration of the archive hold time configured on the maintenance domain or until the error condition is cleared, whichever occurs first.

Examples

The following example shows CFM IEEE sample output from a show ethernet cfm errors command 
using none of the optional keywords or arguments: 

Router# show ethernet cfm errors

--------------------------------------------------------------------------------

MPID Domain Id                                   Mac Address     Type   Id  Lvl 

     MAName                                      Reason                 Age     

--------------------------------------------------------------------------------

37   Domain_port                                 aabb.cc03.ba00  Port   none 0

     portmep                                     Lifetime Timer Expired 89s

401  Domain_L5                                   aabb.cc03.bb99  Vlan   9    5

     cust_500_l5                                 Lifetime Timer Expired 88s

301  Domain_L7                                   aabb.cc03.bb99  Vlan   11   7

     cust_700_l7                                 Lifetime Timer Expired 86s

Table 4 describes the significant fields shown in the display.

Table 4 show ethernet cfm errors Field Descriptions 

Field	Description
MPID	Identifier of the MEP on which the error occurred.
Domain Id	Identifier of the domain affected by the error.
Mac Address	MAC address of the remote MEP on which the error occurred.
Type	Type of MEP (VLAN or port MEP)
Id	Identifier of the VLAN on which the error occurred.
Lvl	Maintenance level at which the error occurred.
MAName	Name of the maintenance association where the error occurred.
Reason	Explanation of why the error occurred.
Age	Time the error has been in the error database.

The following example shows CFM IEEE sample output from a show ethernet cfm errors command 
using the optional configuration keyword: 

Router# show ethernet cfm errors configuration 

--------------------------------------------------------------------------------

CFM Interface      Type  Id     Level  Error type

--------------------------------------------------------------------------------

Et0/0              VLAN  100    1      CFMLeak

Table 5 describes the significant fields shown in the display.

Table 5 show ethernet cfm errors configuration Field Descriptions 

Field	Description
CFM Interface	CFM supported interface on which the error occurred.
Type	Type of MEP (VLAN or port MEP)
Id	Identifier of the VLAN on which the error occurred.
Level	Maintenance level at which the error occurred.
Error type	Type of error.

The following example shows CFM D1 sample output from a show ethernet cfm errors command for CFM error conditions at maintenance level 3:

Router# show ethernet cfm errors level 3

Level Vlan MPID Remote MAC        Reason               Service ID

5     102   40 aabb.cc00.ca10     Receive AIS       service test

Table 6 describes the significant fields shown in the display.

Table 6 show ethernet cfm errors Field Descriptions 

Field	Description
Level	Maintenance level at which the error occurred.
Vlan	VLAN on which the error occurred.
MPID	Identifier of the MEP on which the error occurred.
Remote MAC	The MAC address of the remote MEP on which the error occurred.
Reason	Explanation of why the error occurred.
Service ID	Identifier of the customer affected by the error.

show ethernet cfm maintenance-points local

To display information about maintenance points configured on a device, use the show ethernet cfm maintenance-points local command in privileged EXEC mode.

show ethernet cfm maintenance-points local [detail] [mep | mip] [domain domain-name | interface type number | level level-id | evc evc-name]

Syntax Description

detail	(Optional) Indicates that detailed output is specified.
mep	(Optional) Indicates that a maintenance endpoint (MEP) is specified.
mip	(Optional) Indicates that a maintenance intermediate point (MIP) is specified.
domain	(Optional) Indicates that a maintenance domain is specified.
domain-name	(Optional) String of a maximum of 154 characters.
interface	(Optional) Indicates that an interface is specified.
type number	(Optional) Type and number of the interface.
level	(Optional) Indicates that a maintenance level is specified.
level-id	(Optional) Integer from 0 to 7 that identifies the maintenance level.
evc	(Optional) Indicates that an Ethernet virtual circuit (EVC) is specified.
evc-name	(Optional) Identifier of the EVC.

Command Default

When none of the optional keywords and arguments are specified, information about all the maintenance points on the device is shown.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SRD	The detail and evc keywords and the evc-name argument were added.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2. •The evc keyword and evc-name argument are not supported in this release.
15.0(1)XA	This command was modified. The evc keyword and evc-name argument are not supported in this release.

Usage Guidelines

The show ethernet cfm maintenance-points local command allows you to filter output. You can display information about maintenance points as follows:

•Independent of domain or interface

•On a particular interface independent of domain

•On a particular interface belonging to a given domain

•Belonging to a given domain independent of interface

The display may also be restricted to either MEPs or MIPs.

If a domain name has more than 43 characters, a warning message is displayed notifying that the maintenance domain ID (MDID) will be truncated to 43 characters in continuity check messages (CCMs) if "id <fmt> <MDID>" is not configured.

Examples

Following is sample output from a show ethernet cfm maintenance-points local detail command 
when none of the other optional keywords and arguments are specified:

Router# show ethernet cfm maintenance-points local detail 

Local MEPs:

--------------------------------------------------------------------------------

MPID Domain Name                                 Lvl   MacAddress     Type  CC  

     Domain Id                                   Dir   Port           Id        

     MA Name                                           SrvcInst                 

     EVC name                                                                   

--------------------------------------------------------------------------------

301  Domain_L7                                   7     aabb.cc03.bb99 Vlan  Y

     Domain_L7                                   Up    Et0/1          11   

     cust_700_l7                                       N/A

     N/A                                                       

401  Domain_L5                                   5     aabb.cc03.bb99 Vlan  Y

     Domain_L5                                   Up    Et0/1          9    

     cust_500_l5                                       N/A

     N/A                                                       

Total Local MEPs: 2

Local MIPs: None

Table 7 describes the significant fields shown in the display.

Table 7 show ethernet cfm maintenance-points local Field Descriptions 

Field	Description
MPID	Identifier of the maintenance point.
Domain Name	Name of the domain.
Lvl	Maintenance level where the maintenance point is configured.
MacAddress	MAC address of the maintenance point.
Type	Type of MEP (VLAN or port MEP)
CC	Continuity check operational status.
Domain Id	Identifier of the domain.
Dir	Direction which the maintenance point is facing.
Port	Port MEP.
Id	Identifier of the VLAN.
MA Name	Name of the maintenance association.
SrvcInst	MAC address of the MEP.
EVC name	Name of the Ethernet virtual circuit (EVC).

show ethernet cfm maintenance-points remote

To display detailed information about remote maintenance endpoints (MEPs) configured statically in the MEP list and their status in the continuity check database (CCDB), use the show ethernet cfm maintenance-points remote command in privileged EXEC mode.

Cisco pre-Standard Ethernet Connectivity Fault Management Draft 1 (CFM D1)

show ethernet cfm maintenance-points remote [domain domain-name | level level-id]

CFM IEEE 802.1ag Standard (CFM IEEE)

show ethernet cfm maintenance-points remote [domain domain-name | [[crosscheck | static] [domain domain-name | mpid mpid [domain domain-name]] [port | vlan vlan-id]]]

Syntax Description

domain	(Optional) Indicates that a maintenance domain is specified.
domain-name	(Optional) String of a maximum of 154 characters.
level	(Optional) Indicates that a maintenance level is specified.
level-id	(Optional) Integer from 0 to 7 that identifies the maintenance level.
crosscheck	(Optional) Shows the Mep-Up status from the D1 crosscheck function.
static	(Optional) Shows the Mep-Up status from the continuity-check static rmep function.
mpid	(Optional) Shows a remote maintenance point.
mpid	(Optional) Integer from 0 to 8191 that identifies the maintenance point.
port	(Optional) Shows the operational state of the port MEP.
vlan	(Optional) Shows a VLAN configuration.
vlan-id	(Optional) Integer from 1 to 4094 that identifies the VLAN.

Command Default

When neither a domain nor a level (CFM D1 only) is specified, all CCDB MEP entries are displayed.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SRB	The output of this command was enhanced to include the port state values of REMOTE_EE, LOCAL_EE, and TEST.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2.

Usage Guidelines

If a domain name has more than 43 characters, a warning message is displayed notifying that the maintenance domain ID (MDID) will be truncated to 43 characters in continuity check messages (CCMs) if "id <fmt> <MDID>" is not configured.

When no maintenance domain is specified, all entries are displayed; otherwise only entries belonging to the specified domain or level (CFM D1 only) are shown.

Examples

The following example shows output from a show ethernet cfm maintenance-points remote command:

Router# show ethernet cfm maintenance-points remote

--------------------------------------------------------------------------------

MPID  Domain Name                                 MacAddress          IfSt  PtSt

 Lvl  Domain ID                                   Ingress                       

 RDI  MA Name                                     Type Id             SrvcInst  

      EVC Name                                                        Age       

--------------------------------------------------------------------------------

37    Domain_port                                 aabb.cc03.ba00      Up    N/A 

 0    Domain_port                                 Et0/0                         

 -    portmep                                     Port none           N/A       

      N/A                                                             1s

401   Domain_L5                                   aabb.cc03.bb99      Up    Up  

 5    Domain_L5                                   Et0/0.9                       

 -    cust_500_l5                                 Vlan 9              N/A       

      N/A                                                             2s

301   Domain_L7                                   aabb.cc03.bb99      Up    Up  

 7    Domain_L7                                   Et0/0.11                      

 -    cust_700_l7                                 Vlan 11             N/A       

      N/A                                                             0s

Total Remote MEPs: 3

Table 8 describes the significant fields shown in the display.

Table 8 show ethernet cfm maintenance-points remote Field Descriptions 

Field	Description
MPID	Identifier of the MEP.
Lvl	Maintenance level.
RDI	Remote defect indication (RDI) messages on the maintenance point.
Domain Name	Name of the domain.
Domain ID	MAC address of the MEP.
MA Name	Name of the maintenance association.
EVC Name	Identifier of the Ethernet virtual circuit (EVC).
Mac Address	MAC address of the MEP.
Ingress	Port on which the packet is received.
Type Id	Type of service.
IfSt	Operational state of the interface.
SrvcInst	MAC address of the MEP.
Age	Amount of time, in seconds, the entry has been in the database.
PtSt	Operational state of the port MEP. Values are: UP—Operational. DOWN—Not operational. ADMINDOWN—Administratively down. REMOTE_EE—Encountered excessive remote errors. LOCAL_EE—Encountered excessive local errors. TEST—Test state.

Related Commands

Command	Description
show ethernet cfm maintenance-points local	Displays information about maintenance points configured on a device.
show ethernet cfm maintenance-points remote crosscheck	Displays information about remote maintenance points configured statically in a cross-check list.
show ethernet cfm maintenance-points remote detail	Displays information about a remote maintenance point in the continuity check database.

show ethernet cfm maintenance-points remote crosscheck

To display information about remote maintenance points configured statically in a cross-check list, use the show ethernet cfm maintenance-points remote crosscheck command in privileged EXEC mode.

Cisco pre-Standard Connectivity Fault Management Draft 1 (CFM D1)

show ethernet cfm maintenance-points remote crosscheck [mpid id | mac mac-address] [domain domain-name | level level-id] [evc evc-name | vlan vlan-id]

CFM IEEE 802.1ag Standard (CFM IEEE)

show ethernet cfm maintenance-points remote crosscheck [domain domain-name | mpid id [domain domain-name]] [evc evc-name | port | vlan vlan-id]

Syntax Description

mpid	(Optional) Indicates that a maintenance domain is specified.
id	(Optional) Integer from 0 to 8191 that identifies the maintenance domain.
mac	(Optional) Indicates that a maintenance domain is specified.
mac-address	(Optional) MAC address of the remote maintenance point, in the format abcd.abcd.abcd.
domain	(Optional) Indicates that a maintenance domain is specified.
domain-name	(Optional) String of a maximum of 154 characters.
level	(Optional) Indicates that a maintenance level is specified.
level-id	(Optional) Integer from 0 to 7 that identifies the maintenance level.
evc	(Optional) Indicates an Ethernet virtual circuit (EVC) is specified. An EVC is an association of two or more user network interfaces (UNIs).
evc-name	(Optional) String that identifies the EVC.
port	(Optional) Indicates DOWN service direction with no VLAN association.
vlan	(Optional) Indicates a VLAN for configuration.
vlan-id	(Optional) Integer value of 1 to 4094 that identifies the VLAN.

Command Default

When no options are specified, maintenance point IDs (MPIDs), MAC addresses, domains, levels, and VLANs for all maintenance points on the list are displayed.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SRD	This command was modified. The evc keyword and evc-name argument were added on the Cisco 7600 Series Route Switch Processor 720 (RSP 720) and the Cisco 7600 Series Supervisor Engine 720.
12.2(33)SRE	This command was modified. Support for the port keyword was added in Cisco IOS Release 12.2(33)SRE.

Examples

Following is sample output from a show ethernet cfm maintenance-points remote crosscheck command for maintenance points at maintenance level 4:

Router# show ethernet cfm maintenance-points remote crosscheck level 4

-------------------------------------------------------------------------------

MPID Level VLAN Mep-Up Remote Mac                                              

-------------------------------------------------------------------------------

200  4     0    No     aabb.cc00.0310

-------------------------------------------------------------------------------

MPID Level Mep-Up Remote Mac                                                   

           EVC                                                                 

-------------------------------------------------------------------------------

200  4     No     aabb.cc00.0310

           evc_100

Table 9 describes the significant fields shown in the display.

Table 9 show ethernet cfm maintenance-points remote crosscheck Field Descriptions 

Field	Description
MPID	Identifier of the maintenance point.
Level	Maintenance level where the maintenance point is configured.
VLAN	ID of the VLAN on which the maintenance point is configured.
Mep-Up	Operational status of the MEP.
Remote Mac	MAC address of the remote maintenance point.
EVC	ID of the EVC on which the maintenance point is configured.

Related Commands

Command	Description
show ethernet cfm maintenance-points local	Displays information about maintenance points configured on a device.
show ethernet cfm maintenance-points remote	Displays information about remote maintenance points in the continuity check database.
show ethernet cfm maintenance-points remote detail	Displays information about a remote maintenance point in the continuity check database.

show ethernet cfm maintenance-points remote detail

To display information about a remote maintenance point in the continuity check database, use the show ethernet cfm maintenance-points remote detail command in privileged EXEC mode.

Cisco pre-Standard Connectivity Fault Management Draft 1 (CFM D1)

show ethernet cfm maintenance-points remote detail {mac mac-address | mpid id} [domain domain-name | level level-id] [evc evc-name | service service-name | vlan vlan-id]

CFM IEEE 802.1ag Standard (CFM IEEE)

show ethernet cfm maintenance-points remote detail {mac mac-address | mpid id} [domain domain-name | evc evc-name | port | vlan vlan-id]]

Syntax Description

mac	Shows a remote MAC address.
mac-address	MAC address of the remote maintenance point, in the format abcd.abcd.abcd.
mpid	Shows a remote maintenance point.
id	Integer from 0 to 8191 that identifies the maintenance point.
domain	(Optional) Shows a specific maintenance domain.
domain-name	(Optional) String of a maximum of 154 characters.
level	(Optional) Shows a specific maintenance level.
level-id	(Optional) Integer from 0 to 7 that identifies the maintenance level.
evc	(Optional) Shows an Ethernet virtual circuit (EVC). An EVC is an association of two or more user network interfaces (UNIs).
evc-name	(Optional) String that identifies the EVC name.
service	(Optional) Shows a customer service instance.
service-name	(Optional) String that identifies the service instance.
port	(Optional) Shows the operational state of the port MEP.
vlan	(Optional) Shows a VLAN configuration.
vlan-id	(Optional) Integer from 1 to 4094 that identifies the VLAN.

Command Default

When no options are specified, all remote maintenance endpoints (MEPs) matching the specified MAC address or maintenance point ID (MPID) are displayed.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SRD	This command was modified. Output was modified to show detailed information about Receive RDI and EVC. Support for the evc keyword and evc-name argument was added.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2.
15.0(1)XA	This command was modified. Support for the evc keyword and evc-name argument was added in Cisco IOS Release 15.0(1)XA.

Usage Guidelines

Use this command to obtain information about a specific maintenance point by specifying its MPID or to obtain information about all maintenance points that have a particular MAC address.

When a maintenance domain is not specified, all matching maintenance points, independent of their levels (CFM D1 only), are displayed; otherwise, only maintenance points at the specified maintenance domain are shown.

In CFM D1 only, when an EVC is specified, only maintenance points that are members of the EVC are displayed.

When a VLAN is specified, only maintenance points on that VLAN are displayed.

Examples

The following is sample output from a show ethernet cfm maintenance-points remote detail command using the mpid option:

Router# show ethernet cfm maintenance-points remote detail mpid 401

Version: IEEE-CFM

MAC Address: aabb.cc03.bb99

Domain Name: Domain_L5

MA Name: cust_500_l5

Level: 5

VLAN: 9

MPID: 401

Sender Chassis ID: Router3-cfm

Incoming Port(s): Ethernet0/0.9

CC Lifetime(sec): 35

Age of Last CC Message(sec): 10

CC Packet Statistics: 91/0 (Received/Error)

MEP interface status: Up

MEP port status: Up

Receive RDI: FALSE

Router#

Table 10 describes the significant fields shown in the display.

Table 10 show ethernet cfm maintenance-points remote detail Field Descriptions 

Field	Description
Version	Version of CFM that is running.
MAC Address	MAC address of the remote MEP
Domain Name	Name of the domain.
MA Name	Name of the maintenance association.
Level	Maintenance domain level.
VLAN	Configured VLAN.
MPID	Identifier of the maintenance point.
Sender Chassis ID	Name of the other switch or router when sender-id is configured on that device.
Incoming Port(s)	Identifier of the port that receives the message.
CC Lifetime(sec)	Amount of time, in seconds, that the message should remain in the database before being purged.
Age of Last CC Message(sec)	Amount of time, in seconds, the previous continuity check message (CCM) has been in the database.
CC Packet Statistics	Number of packets received and number of packets with errors.
MEP interface status	Operational state of the MEP interface.
MEP port status	Operational state of the MEP port.
Receive RDI	Receive status of remote defect indication (RDI) messages on the maintenance point.

Related Commands

Command	Description
show ethernet cfm maintenance-points local	Displays information about maintenance points configured on a device.
show ethernet cfm maintenance-points remote	Displays information about remote maintenance points in the continuity check database.
show ethernet cfm maintenance-points remote crosscheck	Displays information about remote maintenance points configured statically in a cross-check list.

show ethernet cfm mpdb

To display the contents of a maintenance intermediate point (MIP) continuity check database (CCDB), use the show ethernet cfm mpdb command in privileged EXEC mode.

show ethernet cfm mpdb [domain-id {mac-address domain-number | domain-name | dns dns-name | null}] [service {ma-name | ma-num | vlan-id vlan-id | vpn-id vpn-id}]

Syntax Description

domain-id	(Optional) Displays by domain ID.
mac-address	(Optional) MAC address of the maintenance domain.
domain-number	(Optional) Integer from 0 to 65535.
domain-name	(Optional) String of a maximum of 43 characters.
dns	(Optional) Specifies a domain name service (DNS).
dns-name	(Optional) String of a maximum of 43 characters.
null	(Optional) Indicates there is not a domain name.
service	(Optional) Specifies a maintenance association within the domain.
ma-name	(Optional) String that identifies the maintenance association.
ma-num	(Optional) Integer that identifies the maintenance association.
vlan-id	(Optional) Specifies a VLAN.
vlan-id	(Optional) Integer from 1 to 4094 that identifies the VLAN.
vpn-id	(Optional) Specifies a virtual private network (VPN).
vpn-id	(Optional) Integer from 1 to 32767 that identifies the VPN.

Command Default

When no maintenance domain is specified, all entries are displayed.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SXI2	This command was introduced.
12.2(33)SRE	This command was integrated into Cisco IOS Release 12.2(33)SRE.

Usage Guidelines

Use this command to display cataloged information received from MEPs.

Examples

The following example shows sample output from a show ethernet cfm mpdb command:

Router# show ethernet cfm mpdb 

* = Can Ping/Traceroute to MEP

--------------------------------------------------------------------------------

MPID  Domain Name                                 MacAddress          Version   

Lvl   Domain ID                                   Ingress                       

Expd  MA Name                                     Type Id             SrvcInst  

      EVC Name                                                        Age       

--------------------------------------------------------------------------------

220 * Domain_L5                                   aabb.cc03.b999      IEEE-CFM 

5     Domain_L5                                   Et0/0.1       

EXPD  cust_500_l5                                 Vlan 9              N/A       

      N/A                                                             87s

101 * Domain_L7                                   aabb.cc03.b999      IEEE-CFM 

7     Domain_L7                                   Et0/0.11      

-     cust_700_l7                                 Vlan 11             N/A       

      N/A                                                             1s

Total Remote MEPs: 2

Table 11 describes the significant fields shown in the display.

Table 11 show ethernet cfm mpdb Field Descriptions 

Field	Description
MPID	Maintenance endpoint ID.
Domain Name	Maintenance domain name.
MacAddress	MAC address of the remote MEP.
Version	Version of the CFM protocol that is running.
Lvl	Maintenance domain level.
Domain ID	Maintenance domain identifier.
Ingress	Interface receiving connectivity fault management traffic.
Expd	Lifetime timer has expired.
MA Name	Name of the maintenance association.
Type Id	Identifies a port MEP, VLAN, or Bridge Domain (BD). "None" indicates an untagged port MEP and a number indicates a VLAN or BD.
SrvcInst	Service instance
EVC Name	Identifier of the Ethernet virtual circuit (EVC).
Age	Age of message in the MIP CCDB.

show ethernet cfm smep

To display connectivity fault management (CFM) system maintenance end point (SMEP) settings on a device, use the show ethernet cfm smep command in privileged EXEC mode.

Ethernet Connectivity Fault Management (CFM) Cisco Proprietary Draft 1 (CFM D1)

show ethernet cfm smep [interface gigabitethernet number]

Ethernet CFM IEEE 802.1ag Standard (CFM IEEE)

show ethernet cfm smep [interface {gigabitethernet number | port-channel number}]

Syntax Description

interface	(Optional) Displays information about an interface.
gigabitethernet	(Optional) Displays information about a Gigabit Ethernet interface.
number	(Optional) •Integer from 1 to 6 that identifies a Gigabit Ethernet interface. •Integer from 1 to 564 that identifies a port channel.
port-channel	(Optional) Displays information about a configured port channel.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.
15.0(1)XA	This command was modified. Support for the port channel keyword was introduced in Cisco IOS Release 15.0(1)XA.

Usage Guidelines

This command allows filtering on a per-interface basis.

Alarm Indication Signal (AIS) messages are sent by default at the configured maintenance intermediate point (MIP) level if an AIS level is not configured.

Examples

The following example shows sample output from the show ethernet cfm smep command:

Router# show ethernet cfm smep

SMEP Settings:

--------------

Interface: GigabitEthernet1/1

LCK-Status: CFM Disabled

LCK Period: 60000 (ms)

Level to transmit LCK: Default

AIS-Status: CFM Disabled

AIS Period: 60000 (ms)

Level to transmit AIS: Default

Defect Condition: No Defect

Table 12 describes the significant fields shown in the display.

Table 12 show ethernet cfm smep Field Descriptions 

Field	Description
Interface	Specifies the interface type.
LCK-Status	Locked Signal function (LCK) sending status of the interface.
LCK Period	LCK transmission period on the interface.
Level to transmit LCK	Displays the level at which LCK frames are transmitted.
AIS-Status	AIS sending status of the interface.
AIS Period	AIS transmission period on the interface.
Level to transmit AIS	Displays the level at which AIS frames are transmitted.
Defect Condition	Displays the defect condition detected on the interface.

show ethernet cfm statistics

To display Ethernet connectivity fault management (CFM) information, use the show ethernet cfm statistics command in privileged EXEC mode.

show ethernet cfm statistics [domain [domain-name [service {ma-name | ma-num | vlan-id vlan-id | vpn-id vpn-id}]] | mpid mpid]

Syntax Description

domain	(Optional) Configures a maintenance domain.
domain-name	(Optional) String of a maximum of 154 characters.
service	(Optional) Configures a maintenance association within the domain.
ma-name	(Optional) String that identifies the maintenance association.
ma-num	(Optional) Integer that identifies the maintenance association.
vlan-id	(Optional) Configures a VLAN.
vlan-id	(Optional) Integer from 1 to 4094 that identifies the VLAN.
vpn-id	(Optional) Configures a virtual private network (VPN).
vpn-id	(Optional) Integer from 1 to 32767 that identifies the VPN.
mpid	(Optional) Configures a maintenance point identifier.
mpid	(Optional) Integer from 1 to 8191 that identifies the maintenance point.

Command Default

All domains are displayed when none of the keywords or arguments are selected.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SXI2	This command was introduced.
12.2(33)SRE	This command was integrated into Cisco IOS Release 12.2(33)SRE.

Usage Guidelines

Use this command to display an overview of transmitted and received messages.

If a domain name has more than 43 characters, a warning message is displayed notifying that the maintenance domain ID (MDID) will be truncated to 43 characters in continuity check messages (CCMs) if "id <fmt> <MDID>" is not configured.

Examples

Following is sample output from a show ethernet cfm statistics command:

Router# show ethernet cfm statistics 

BRAIN MAC: aabb.cc03.b999

DomainName: Domain_L7

MA Name: cust_700_l7

MPID: 101

  Last clearing of counters:  never

  CCMs:

    Transmitted:                242   Rcvd Seq Errors:        0

  LTRs:

    Unexpected Rcvd:              0

  LBRs:

    Transmitted:                  0   Rcvd Seq Errors:        0

    Rcvd in order:                0   Rcvd Bad MSDU:          0

DomainName: Domain_L5

MA Name: cust_500_l5

MPID: 220

  Last clearing of counters:  never

  CCMs:

    Transmitted:                202   Rcvd Seq Errors:        0

  LTRs:

    Unexpected Rcvd:              0

  LBRs:

    Transmitted:                  0   Rcvd Seq Errors:        0

    Rcvd in order:               10   Rcvd Bad MSDU:          0

DomainName: Domain_port

MA Name: portmep

MPID: 112

  Last clearing of counters:  never

  CCMs:

    Transmitted:                278   Rcvd Seq Errors:        0

  LTRs:

    Unexpected Rcvd:              0

  LBRs:

    Transmitted:                  0   Rcvd Seq Errors:        0

    Rcvd in order:                0   Rcvd Bad MSDU:          0

Table 13 describes the significant fields shown in the display.

Table 13 show ethernet cfm statistics Field Descriptions 

Field	Description
BRAIN MAC	Bridge brain MAC address.
DomainName	Domain name.
MA Name	Maintenance association name.
MPID	Maintenance point identifier.
CCMs	Continuity check messages transmitted.
LTRs	Linktrace responses.
LBRs	Loopback responses.

show ethernet cfm traceroute-cache

To display the contents of the traceroute cache, use the show ethernet cfm traceroute-cache command in privileged EXEC mode.

show ethernet cfm traceroute-cache

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2.

Usage Guidelines

Use the show ethernet cfm traceroute-cache command to display the contents of the traceroute cache; for example, to see the maintenance intermediate points (MIPs) and maintenance endpoints (MEPs) of a domain as they were discovered. The data is historic. The traceroute cache stores entries from previous traceroute operations.

Examples

The following example shows output from a show ethernet cfm traceroute-cache command:

Router# show ethernet cfm traceroute-cache

Traceroute to aabb.cc03.b999 on Domain Domain_L5, Level 5, vlan 9 issued at 01:25:22

path found via MPDB

B = Intermediary Bridge

! = Target Destination

* = Per hop Timeout

--------------------------------------------------------------------------------

                             MAC      Ingress      Ingr Action  Relay Action    

  Hops   Host             Forwarded   Egress       Egr Action   Previous Hop    

--------------------------------------------------------------------------------

! 1                    aabb.cc03.b999                           RlyHit:MEP     

                       Not Forwarded                            aabb.cc03.bb99

Table 14 describes the significant fields shown in the display.

Table 14 show ethernet cfm traceroute-cache Field Descriptions 

Field	Description
Hops	Number of hops of the traceroute.
Host	Name of the device.
MAC	Bridge Brain MAC address of the device.
Ingress	Receiving port.
Ingr Action	Action on the ingress port: IngOk, IngFilter, IngBlocked.
Relay Action	Type of relay action performed: RlyNone, RlyUnknown, RlyFDB, RlyCCDB, RlyFiltered.
Forwarded	Traceroute forwarded or not forwarded.
Egress	Sending port.
Egr Action	Action on the egress port: EgrNone, EgrTTL, EgrDown, EgrBlocked, EgrOk, EgrGVRP, EgrDomainBoundary, EgrFiltered.
Previous Hop	MAC address of the neighboring device.

Related Commands

Command	Description
clear ethernet cfm traceroute-cache	Removes the contents of the traceroute cache.
ethernet cfm traceroute-cache	Enables caching of Ethernet CFM data learned through traceroute messages.
traceroute ethernet	Sends Ethernet CFM traceroute messages to a destination MAC address.

show ethernet lmi

To display Ethernet local management interface (LMI) Ethernet virtual connections (EVCs) configured on a device, use the show ethernet lmi command in privileged EXEC mode.

show ethernet lmi {{evc [detail evc-id [interface type number] | map interface type number]} | {parameters | statistics} interface type number | uni map [interface type number]}

Syntax Description

evc	Displays information about an EVC.
detail	(Optional) Displays detailed information about a specified EVC.
evc-id	(Optional) String of a maximum of 100 characters that identifies an EVC.
interface	Indicates that an interface is specified. This keyword is optional except with the parameters and statistics keywords.
type	String that identifies the type of interface. Valid options are the following: •ethernet—Ethernet IEEE 802.3 interface •fastethernet—Fast Ethernet IEEE 802.3 interface •gigabitethernet—Gigabit Ethernet IEEE 802.3z interface
number	Integer that identifies the interface.
map	(Optional) Indicates a VLAN map.
parameters	Displays Ethernet LMI parameters.
statistics	Displays Ethernet LMI statistics.
uni map	Displays information about the user-network interface (UNI).

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.4(9)T	This command was introduced.
12.2(33)SRB	Support for this command on the Cisco 7600 router was integrated into Cisco  IOS Release 12.2(33)SRB.

Usage Guidelines

Use this command to check the operational statuses of EVCs.

Examples

The following examples show output from a show ethernet lmi command for interface Ethernet 0/0 using different keywords and arguments.

The following sample output is generated from the show ethernet lmi command using the evc keyword:

Router# show ethernet lmi evc

St  EVC Id                                                       Port          

--- ------------------------------------------------------------ --------------

 A  EVC_MP2MP_101                                                Gi0/1         

 A  EVC_P2P_110                                                  Gi0/1         

Key: St=Status, A=Active, P=Partially Active, I=Inactive, ?=Link Down

The following sample output is generated from the show ethernet lmi command using the evc and optional detail keywords:

Router# show ethernet lmi evc detail EVC_MP2MP_101 

EVC Id: EVC_MP2MP_101

interface Ethernet0/0

  Time since Last Full Report: 00:25:25 

  Ether LMI Link Status: Up

  UNI Status: Up

  UNI Id: router3-e0/0+router-e0/0

  CE-VLAN/EVC Map Type: Bundling

  VLAN: 101

  EVC Status: Active

  EVC Type: Multipoint-to-Multipoint

  Remote UNI Count: Configured = 2, Active = 2

  UNI Id                                   UNI Status    Port

  ------                                   ----------    ----

  router4-e0/0+router1-e0/0                Up            Remote

  router5-e0/0+router6-e0/0                Up            Remote

Table 15 describes the significant fields shown in output of the show ethernet lmi command using the evc and detail keywords.

Table 15 show ethernet lmi evc detail Field Descriptions  

Field	Description
EVC Id	Identifier of the EVC.
Time since Last Full Report	Number of hours, minutes, seconds since the CE requested a detailed report.
Ether LMI Link Status	Operational state of the LMI link.
UNI Status	Operational state of the UNI.
UNI Id	Identifier of the UNI between the CE and PE devices.
CE-VLAN/EVC Map Type	EVC map type: bundling, multiplex, or all-to-one
VLAN	Identifier of the VLAN.
EVC Status	Operational state of the EVC.
EVC Type	Type of connection (point-to-point or multipoint-to-multipoint).
Remote UNI Count	Number of remote UNIs that are configured and the number that are operational.
Port	Type of port, either local or remote, on which the EVC is configured. If the port is local, the interface ID is specified.

The following sample output is generated from the show ethernet lmi command using the map interface keyword:

Router# show ethernet lmi evc map interface Ethernet0/0

UNI Id: router3-e0/0+router-e0/0

St  Evc Id                                   CE-VLAN                           

--- ---------------------------------------- ----------------------------------

  A EVC_MP2MP_101                            101                               

  A EVC_P2P_110                              110                               

Key: St=Status, A=Active, P=Partially Active, I=Inactive, *=Default EVC,

      ?=Link Down

Table 16 describes the significant fields shown in output of the show ethernet lmi command using the evc and map keywords.

Table 16 show ethernet lmi evc map Field Descriptions

Field	Description
UNI Id	Identifier of the UNI between the CE and PE devices.
St	Operational state of the EVC.
Evc Id	Identifier of the EVC.
CE-VLAN	Identifier of the VLAN used by the CE.

The following sample output is generated from the show ethernet lmi command using the parameters and interface keywords:

Router# show ethernet lmi parameters interface Ethernet0/0

E-LMI Parameters for interface Ethernet0/0

 Version : MEF.16-0106

    Mode : CE

    T391 : 10    

    T392 : NA

    N391 : 360   

    N393 : 4 

Table 17 describes the significant fields shown in output of the show ethernet lmi command using the parameters keyword.

Table 17 show ethernet lmi parameters Field Descriptions

Field	Description
Version	Version number of the specification that E-LMI implementation is based on.
Mode	Customer equipment or the Metro Ethernet network.
T391	Polling timer.
T392	Polling verification timer.
N391	Polling counter.
N393	Event counter.

The following sample output is generated from the show ethernet lmi command using the statistics and interface keywords:

Router# show ethernet lmi statistics interface Ethernet0/0

E-LMI Statistics for interface Ethernet0/0

  Ether LMI Link Status: Up

  UNI Status: Up

  UNI Id: router3-e0/0+router-e0/0

  Reliability Errors:

    Status Timeouts                    0  Invalid Sequence Number           0

    Invalid Status Response            0  Unsolicited Status Received       0

  Protocol Errors:

    Invalid Protocol Version           0  Invalid EVC Reference Id          0

    Invalid Message Type               0  Out of Sequence IE                0

    Duplicated IE                      0  Mandatory IE Missing              0

    Invalid Mandatory IE               0  Invalid non-Mandatory IE          0

    Unrecognized IE                    0  Unexpected IE                     0

    Short Message                      0

  Last Full Status Enq Sent     00:50:35  Last Full Status Rcvd      00:50:35

  Last Status Check Sent        00:00:06  Last Status Check Rcvd     00:00:06

  Last clearing of counters     00:09:57

---

Note The UNI Id field displays only when it is available from the provider edge router.

---

Table 18 describes the significant fields shown in output of the show ethernet lmi command using the statistics keyword.

Table 18 show ethernet lmi statistics Field Descriptions  

Field	Description
E-LMI Statistics for interface <interface-id>
Ether LMI Link Status	Operational state of Ethernet LMI connectivity.
UNI Status	Operational state of the UNI.
UNI Id	Identifer of the UNI.
Reliability Errors
Status Timeouts	Number of times that a status request has been sent but not received.
Invalid Sequence Number	Number of times the sequence numbers of Ethernet LMI packets do not match the sequence numbers expected.
Invalid Status Response	Number of times a status response received was invalid and discarded.
Unsolicited Status Received	Number of times status was received that had not been requested.
Protocol Errors
Invalid Protocol Version	Number of times the protocol version in Ethernet LMI packets does not match what is supported.
Invalid EVC Reference Id	Number of times EVC reference IDs are invalid in Ethernet LMI packets.
Invalid Message Type	Number of message types that are not valid for LMI.
Out of Sequence IE	Number of information elements (IEs) that are not in the correct sequence.
Duplicated IE	Number of duplicated IEs.
Mandatory IE Missing	Number of mandatory IEs that are missing.
Invalid Mandatory IE	Number of mandatory IEs that are invalid.
Invalid non-Mandatory IE	Number of non-mandatory IEs that are invalid.
Unrecognized IE	Number of IEs that are not recognized.
Unexpected IE	Number of IEs that are unexpected.
Short Message	Number of times the Ethernet LMI message received is shorter than supported packets.
Last Full Status Enq Sent	Time in hours, minutes, and seconds when the CE sent the last full LMI status request.
Last Full Status Rcvd	Time in hours, minutes, and seconds when the CE received the last full LMI status report.
Last Status Check Sent	Time in hours, minutes, and seconds when the CE sent the last LMI status request.
Last Status Check Rcvd	Time in hours, minutes, and seconds when the CE received the last LMI status report.
Last clearing of counters	Time in hours, minutes, and seconds when the clear ethernet lmi statistics command was issued for the interface.

The following sample output is generated from the show ethernet lmi command using the uni map keyword:

Router# show ethernet lmi uni map

UNI Id                            EVC Id                            Port        

--------------------------------- --------------------------------- ------------

uni_sandiego                      EVC_MP2MP_101                     Gi0/1       

uni_sandiego                      EVC_P2P_110                       Gi0/1       

Router#

The following sample output is generated from the show ethernet lmi command using the uni map and optional interface keywords:

Router# show ethernet lmi uni map interface gigabitethernet 0/1

UNI Id                            EVC Id                            Port        

--------------------------------- --------------------------------- ------------

uni_sandiego                      EVC_MP2MP_101                     Gi0/1       

uni_sandiego                      EVC_P2P_110                       Gi0/1       

Router#

Table 19 describes the significant fields shown in output of the show ethernet lmi command using the uni map keyword and uni map and interface keyword pair.

Table 19 show ethernet lmi uni map and uni map interface Field Descriptions

Field	Description
UNI Id	Identifier of the UNI.
EVC Id	Identifier of the EVC.
Port	Interface on the CE device.

show ethernet oam discovery

To display discovery information for all Ethernet operations, maintenance, and administration (OAM) interfaces or for a specific interface, use the show ethernet oam discovery command in privileged EXEC mode.

show ethernet oam discovery [interface type number]

Syntax Description

interface	(Optional) Specifies an interface.
type	(Optional) Type of Ethernet interface. Valid values are: FastEthernet, GigabitEthernet, TenGigabitEthernet.
number	(Optional) Integer from 1 to 9 that is the number of the Ethernet interface.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.

Usage Guidelines

This command displays the following information pertaining to Ethernet OAM discovery:

•Remote device which is directly connected to this device

•Local and remote OAM configuration and capability

•Local and remote OAM mode

•Remote platform identity

•State of the local discovery state machine

If an interface is specified, only data pertaining to the OAM peer on that interface is displayed; otherwise, data for all OAM peers (on all interfaces) is displayed.

Examples

The following example shows output from a show ethernet oam discovery command for interface GigabitEthernet 6/11:

Router# show ethernet oam discovery interface gigabitethernet6/11

GigabitEthernet6/11

Local client

------------

  Administrative configurations:

    Mode:              active

    Unidirection:      not supported

    Link monitor:      supported (on)

    Remote loopback:   supported

    MIB retrieval:     not supported

    Mtu size:          1500

Operational status:

    Port status:       operational

    Loopback status:   no loopback

    PDU revision:      1

Remote client

-------------

  MAC address: 0030.96fd.6bfa

  Vendor(oui): 0x00 0x00 0x0C (cisco)

  Administrative configurations:

    Mode:              active

    Unidirection:      not supported

    Link monitor:      supported

    Remote loopback:   supported

    MIB retrieval:     not supported

    Mtu size:          1500

Table 20 describes the significant fields shown in the display.

Table 20 show ethernet oam discovery Field Descriptions 

Field	Description
Administrative configurations
Mode	Active or passive mode of the interface
Unidirection	Operational mode
Link monitor	Status of link monitor support
Remote loopback	Status of remote loopback support
MIB retrieval	Capability of requesting MIB objects.
Mtu size	Size of the maximum transmission unit
Operational status
Port status	Operational state of the port
Loopback status	Operational status of the loopback interface
PDU revision	Revision of the OAM configuration. A new revision results from each change to the configuration.
Remote client
MAC address	MAC address of the remote client
Vendor (oui)	Vendor number in hexidecimal

Related Commands

Command	Description
show ethernet oam statistics	Displays detailed information about Ethernet OAM packets.
show ethernet oam status	Displays Ethernet OAM configurations for all interfaces or for a specific interface.
show ethernet oam summary	Displays active Ethernet OAM sessions.

show ethernet oam statistics

To display detailed information about Ethernet operations, maintenance, and administration (OAM) packets, use the show ethernet oam statistics command in privileged EXEC mode.

show ethernet oam statistics [interface type number]

Syntax Description

interface	(Optional) Specifies an interface.
type	(Optional) Type of Ethernet interface. Valid values are: FastEthernet, GigabitEthernet, TenGigabitEthernet.
number	(Optional) Integer from 1 to 9 that is the number of the Ethernet interface.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.

Usage Guidelines

Statistics that this command displays include the following:

•Rx/Tx OAM Protocol Data Unit (PDU) counters

•Link monitoring events, including event logs, if available

•Remote fault detection events

•Remote loopback events

Examples

The following example shows output from a show ethernet oam statistics command for interface GigabitEthernet 6/11:

Router# show ethernet oam statistics interface gigabitethernet 6/11

GigabitEthernet6/11

Counters:

---------

  Information OAMPDU Tx                   : 9723

  Information OAMPDU Rx                   : 9712

  Unique Event Notification OAMPDU Tx     : 0

  Unique Event Notification OAMPDU Rx     : 0

  Duplicate Event Notification OAMPDU TX  : 0

  Duplicate Event Notification OAMPDU RX  : 0

  Loopback Control OAMPDU Tx              : 0

  Loopback Control OAMPDU Rx              : 0

  Variable Request OAMPDU Tx              : 0

  Variable Request OAMPDU Rx              : 0

  Variable Response OAMPDU Tx             : 0

  Variable Response OAMPDU Rx             : 0

  Cisco OAMPDU Tx                         : 0

  Cisco OAMPDU Rx                         : 0

  Unsupported OAMPDU Tx                   : 0

  Unsupported OAMPDU Rx                   : 0

  Frames Lost due to OAM                  : 0

Local event logs:

-----------------

  0 Errored Symbol Period records

  0 Errored Frame records

  0 Errored Frame Period records

  0 Errored Frame Second records

Remote event logs:

------------------

  0 Errored Symbol Period records

  0 Errored Frame records

  0 Errored Frame Period records

  0 Errored Frame Second records

Table 21 describes the significant fields shown in the display.

Table 21 show ethernet oam statistics Field Descriptions 

Field	Description
Counters
Information OAMPDU Tx	Number of OAM PDUs transmitted
Information OAMPDU Rx	Number of OAM PDUs received
Unique Event Notification OAMPDU Tx	Number of unique event notification OAM PDUs transmitted
Unique Event Notification OAMPDU Rx	Number of unique event notification OAM PDUs received
Duplicate Event Notification OAMPDU Tx	Number of duplicate event notification OAM PDUs transmitted
Duplicate Event Notification OAMPDU Rx	Number of duplicate event notification OAM PDUs received
Loopback Control OAMPDU Tx	Number of loopback control OAM PDUs transmitted
Loopback Control OAMPDU Rx	Number of loopback control OAM PDUs received
Variable Request OAMPDU Tx	Number of OAM PDUs sent to request MIB objects on a remote device
Variable Request OAMPDU Rx	Number of OAM PDUs received and requesting MIB objects on a local device
Variable Response OAMPDU Tx	Number of OAM PDUs sent by the local device in response to a request from a remote device
Variable Response OAMPDU Rx	Number of OAM PDUs sent by the remote device in response to a request from a local device
Cisco OAMPDU Tx	Number of Cisco specific OAM PDUs sent
Cisco OAMPDU Rx	Number of Cisco specific OAM PDUs received
Unsupported OAMPDU Tx	Number of unsupported OAM PDUs sent
Unsupported OAMPDU Rx	Number of unsupported OAM PDUs received
Frames lost due to OAM	Number of frames discarded by the OAM client
Local event logs	Log of events on the local device
Remote event logs	Log of events on the remote device

Related Commands

Command	Description
show ethernet oam discovery	Displays discovery information for all Ethernet OAM interfaces or for a specific interface.
show ethernet oam status	Displays Ethernet OAM configurations for all interfaces or for a specific interface.
show ethernet oam summary	Displays active Ethernet OAM sessions.

show ethernet oam status

To display Ethernet operations, maintenance, and administration (OAM) configurations for all interfaces or for a specific interface, use the show ethernet oam status command in privileged EXEC mode.

show ethernet oam status [interface type slot/[subslot/]port | vlan vlan]

Syntax Description

interface	(Optional) Specifies an interface.
type	(Optional) Type of Ethernet interface. Valid values are: FastEthernet, GigabitEthernet, TenGigabitEthernet.
slot/[subslot/]port	(Optional) Chassis slot number and port number where the Ethernet interface is located. If the Ethernet interface is located on a shared port adapter (SPA), the subslot number may also be required. The subslot is the secondary slot number on the SPA Interface Processor (SIP) where the SPA is installed.
vlan vlan	(Optional) Limits the display to interfaces on the specified VLAN. Range: 1 to 4094

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SXI	This command was modified. Support for the optional vlan keyword and vlan argument was added. The subslot field was added to support Ethernet interfaces located on a SPA.

Usage Guidelines

Use this command to display the runtime settings of link-monitoring and general OAM operations for all interfaces or for a specific interface.

OAM must be operational on the interface or interfaces before you issue this command.

Cisco IOS Release 12.2(33)SXI and later releases allow you to limit the display of switch port information to the specified VLAN.

Examples

The following example shows output from a show ethernet oam status command for interface GigabitEthernet 6/11:

Router# show ethernet oam status interface gigabitethernet 6/11

GigabitEthernet6/11

General

-------

  Mode:                  active

  PDU max rate:          10 packets per second

  PDU min rate:          1 packet per 1 second

  Link timeout:          5 seconds

  High threshold action: no action

Link Monitoring

---------------

  Status: supported (on)

  Symbol Period Error

    Window:              1 million symbols

    Low threshold:       1 error symbol(s)

    High threshold:      none

  Frame Error

    Window:              10 x 100 milliseconds

    Low threshold:       1 error frame(s)

    High threshold:      none

  Frame Period Error

    Window:              1 x 100,000 frames

    Low threshold:       1 error frame(s)

    High threshold:      none

  Frame Seconds Error

    Window:              600 x 100 milliseconds

    Low threshold:       1 error second(s)

    High threshold:      none

Table 22 describes the significant fields shown in the display.

Table 22 show ethernet oam status Field Descriptions 

Field	Description
General
Mode	Active or passive mode of the interface.
PDU max rate	Maximum number of protocol data units (PDUs) transmitted per second.
PDU min rate	Minimum number of PDUs transmitted per second.
Link timeout	Amount of time with inactivity before the link is dropped.
High threshold action	Action that occurs when the high threshold for an error is exceeded.
Link Monitoring
Status	Operational state of the port.
Symbol Period Error
Window	Specified number of error symbols.
Low threshold	Minimum number of error symbols.
High threshold	Maximum number of error symbols.
Frame Error
Window	Specified amount of time in milleseconds.
Low threshold	Minimum number of error frames.
High threshold	Maximum number of error frames.
Frame Period Error
Window	Frequency at which the measurement is taken, in milliseconds.
Low threshold	Minimum number of error frames.
High threshold	Maximum number of error frames.
Frame Seconds Error
Window	Frequency at which the measurement is taken, in milliseconds.
Low threshold	Lowest value at which an event will be triggered.
High threshold	Highest value at which an event will be triggered.

Related Commands

Command	Description
show ethernet oam discovery	Displays discovery information for all Ethernet OAM interfaces or for a specific interface.
show ethernet oam statistics	Displays detailed information about Ethernet OAM packets.
show ethernet oam summary	Displays active Ethernet OAM sessions.

show ethernet oam summary

To display active Ethernet operations, maintenance, and administration (OAM) sessions on a device, use the show ethernet oam summary command in privileged EXEC mode.

show ethernet oam summary

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.

Examples

The following example shows output from a show ethernet oam summary command:

Router# show ethernet oam summary

Symbols:          * - Master Loopback State,  # - Slave Loopback State

Capability codes: L - Link Monitor,  R - Remote Loopback

                  U - Unidirection,  V - Variable Retrieval

  Local                       Remote

Interface       MAC Address    Vendor Mode    Capability

  Fa3/1         0080.09ff.e4a0 00000C active   L R

  Gi6/11        0030.96fd.6bfa 00000C active   L R

Table 23 describes the significant fields shown in the display.

Table 23 show ethernet oam summary Field Descriptions 

Field	Description
Local Interface	Type of local interface
MAC Address	MAC address of the local interface
Remote Vendor	The vendor for the remote device.
Mode	Operational state of the remote interface
Capability	Functions the local interface can perform

Related Commands

Command	Description
show ethernet oam discovery	Displays discovery information for all Ethernet OAM interfaces or for a specific interface.
show ethernet oam status	Displays Ethernet OAM configurations for all interfaces or for a specific interface.
show ethernet oam statistics	Displays detailed information about Ethernet OAM packets.

show ethernet service evc

To display information about Ethernet virtual connections (EVCs), use the show ethernet service evc command in privileged EXEC mode.

show ethernet service evc [detail | id evc-id [detail] | interface type number [detail]]

Syntax Description

detail	(Optional) Displays detailed information about service instances or the specified service instance ID or interface.
id	(Optional) Displays EVC information for the specified service.
evc-id	(Optional) String from 1 to 100 characters that identifies the EVC.
interface	(Optional) Displays service instance information for the specified interface.
type	(Optional) Type of interface.
number	(Optional) Number of the interface.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(25)SEG	This command was introduced.
12.2(33)SRB	This command was integrated into Cisco IOS Release 12.2(33)SRB.

Usage Guidelines

This command is useful for system monitoring and troubleshooting.

Examples

Following is sample output from the show ethernet service evc command:

Router# show ethernet service evc

Identifier                     Type  Act-UNI-cnt Status

BLUE                           P-P       2       Active         

PINK                           MP-MP     2       PartiallyActive

PURPLE                         P-P       2       Active         

BROWN                          MP-MP     2       Active         

GREEN                          P-P       3       Active         

YELLOW                         MP-MP     2       PartiallyActive

BANANAS                        P-P       0       InActive       

TEST2                          P-P       0       NotDefined     

ORANGE                         P-P       2       Active         

TEAL                           P-P       0       InActive 

Table 24 describes the significant fields in the output.

Table 24 show ethernet service evc Field Descriptions 

Field	Description
Identifier	EVC identifier.
Type	Type of connection, for example point-to-point (P-P) or multipoint-to-multipoint (MP-MP).
Act-UNI-cnt	Number of active user network interfaces (UNIs).
Status	Availability status of the EVC.

Related Commands

Command	Description
show ethernet instance	Displays information about Ethernet customer service instances.
show ethernet interface	Displays interface-only information about Ethernet customer service instances.

show ethernet service instance

To display information about Ethernet service instances, use the show ethernet service instance command in privileged EXEC mode.

show ethernet service instance [detail | id id interface type number [detail | mac security [address | last violation | statistics] | platform | stats] | interface type number [detail | platform | stats | summary] | mac security [address | last violation | statistics] | platform | policy-map | stats | summary]

Syntax Description

detail	(Optional) Displays detailed information about service instances or a specific service instance.
id	(Optional) Displays a specific service instance on an interface that does not map to a VLAN.
id	(Optional) Integer from 1 to 4294967295 that identifies a service instance on an interface that does not map to a VLAN.
interface	(Optional) Declares a specific interface selection for the specified service instance.
type	(Optional) Type of interface.
number	(Optional) Number of the interface.
mac security	(Optional) Displays the MAC security status of the specified service instance.
address	(Optional) Displays the secure addresses on the specified service instance.
last violation	(Optional) Displays the last violation recorded on the specified service instance.
statistics	(Optional) Displays MAC security statistics for the specified service instance.
platform	(Optional) Displays platform information for the specified service instance.
stats	(Optional) Displays statistics for the specified service instance.
summary	(Optional) Displays summary information about service instances.
policy-map	(Optional) Displays the policy map for the service instances.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(25)SEG	This command was introduced.
12.2(33)SRB	This command was integrated into Cisco IOS Release 12.2(33)SRB.
12.2(33)SRD	This command was modified. The detail, mac security, address, last violation, statistics, platform, stats, and summary keywords were added.

Usage Guidelines

This command is useful for system monitoring and troubleshooting.

Examples

The following is sample output from the show ethernet service instance command:

Router# show ethernet service instance

Identifier Interface             CE-Vlans

222        FastEthernet0/1       untagged,1-4094

10         FastEthernet0/2

222        FastEthernet0/2       200

333        FastEthernet0/2       default

10         FastEthernet0/3       300

11         FastEthernet0/3

10         FastEthernet0/4       300

10         FastEthernet0/6       untagged,1-4094

10         FastEthernet0/7       untagged,1-4094

10         FastEthernet0/8       untagged,1-4094

10         FastEthernet0/9       untagged

20         FastEthernet0/9

222        FastEthernet0/11      300-350,900-999

333        FastEthernet0/11      100-200,1000,1999-4094

222        FastEthernet0/12      20

333        FastEthernet0/12      10

10         FastEthernet0/13      10

20         FastEthernet0/13      20

30         FastEthernet0/13      30

200        FastEthernet0/13      222

200        FastEthernet0/14      200,222

300        FastEthernet0/14      333

555        FastEthernet0/14      555

Table 25 describes the significant fields shown in the display.

Table 25 show ethernet service instance Field Descriptions 

Field	Description
Identifier	Service instance identifier.
Interface	Interface type and number with which the service instance is associated.
CE-Vlans	Customer edge (CE) device VLAN ID.

Related Commands

Command	Description
clear ethernet service instance	Clears Ethernet service instance attributes such as MAC addresses and statistics and purges Ethernet service instance errors.
show ethernet service interface	Displays interface-only information about Ethernet customer service instances.

show ethernet service interface

To display interface-only information about Ethernet customer service instances for all interfaces or for a specified interface, use the show ethernet service interface privileged EXEC mode.

show ethernet service interface [type number] [detail]

Syntax Description

type	(Optional) Type of interface.
number	(Optional) Number of the interface.
detail	(Optional) Displays detailed information about interfaces or a specified service instance ID or interface.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(25)SEG	This command was introduced.
12.2(33)SRB	This command was integrated into Cisco IOS Release 12.2(33)SRB.

Usage Guidelines

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain "Output" are displayed.

Examples

Following are examples of output from the show ethernet service interface command:

Router# show ethernet service interface gigabitethernet0/1

Interface          Identifier

GigabitEthernet0/1 PE2-G101

Router# show ethernet service interface detail

Interface: FastEthernet0/1

ID:

CE-VLANS:

EVC Map Type: Bundling-Multiplexing

Interface: FastEthernet0/2

ID:

CE-VLANS:

EVC Map Type: Bundling-Multiplexing

Interface: FastEthernet0/3

ID:

CE-VLANS:

EVC Map Type: Bundling-Multiplexing

<output truncated>

Interface: GigabitEthernet0/1

ID: PE2-G101

CE-VLANS: 10,20,30

EVC Map Type: Bundling-Multiplexing

Associated EVCs:

EVC-ID CE-VLAN

WHITE 30

RED 20

BLUE 10

Associated Service Instances:

Service-Instance-ID CE-VLAN

10 10

20 20

30 30

Table 26 describes the significant fields in the output.

Table 26 show ethernet service interface Field Descriptions 

Field	Description
Interface	Interface type and number.
Identifier	EVC identifier.
ID	EVC identifier.
CE-VLANS	VLANs associated with the customer edge (CE) device.
EVC Map Type	UNI service type; for example, Bundling, Multiplexing, All-to-one Bundling.
Associated EVCs	EVCs associated with a device.
EVC-ID CE-VLAN	EVC identifier and associated VLAN.
Associated Service Instances	Service instances associated with a device.
Service-Instance-ID CE-VLAN	Service instance identifier and its associated CE VLAN.

Related Commands

Command	Description
service instance ethernet	Defines an Ethernet service instance and enters Ethernet service configuration mode.
show ethernet evc	Displays information about Ethernet customer service instances.
show ethernet interface	Displays interface-only information about Ethernet customer service instances.

show lacp

To display Link Aggregation Control Protocol (LACP) and multi-chassis LACP (mLACP) information, use the show lacp command in either user EXEC or privileged EXEC mode.

show lacp {channel-group-number {counters | internal [detail] | multi-chassis {group number | port-channel num | neighbor [detail]} | counters | internal [detail] | neighbor [detail] | sys-id}

Syntax Description

channel-group- number	Number of the channel group; following are valid values: •Cisco IOS 12.2 SB and Cisco IOS XE 2.4 releases—from 1 to 64 •Cisco IOS 12.2 SR releases—from 1 to 308 •Cisco IOS 12.2 SX releases—from 1 to 496
counters	Displays information about the LACP traffic statistics.
detail	(Optional) Detailed internal information.
internal	Displays LACP internal information.
multi-chassis	Displays information about mLACP.
group	Displays mLACP redundancy group information,
number	Integer value used with the group and port-channel keywords. •Values from 1 to 4294967295 identify the redundancy group. •Values from 1 to 564 identify the port-channel interface.
port-channel	Displays mLACP port-channel information.
neighbors	Displays information about the LACP neighbor.
sys-id	Displays the LACP system identification. It is a combination of the port priority and the MAC address of the device

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release	Modification
12.2(14)SX	Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB	Support for this command on the Supervisor Engine 2 was extended to Cisco IOS Release 12.2(17d)SXB.
12.2(33)SRA	This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2	This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.2(33)SRB	Support for this command on the Cisco 7600 router was integrated into Cisco IOS Release 12.2(33)SRB.
Cisco IOS XE Release 2.4	This command was integrated into Cisco IOS XE Release 2.4.
12.2(33)SRE	This command was modified. The multi-chassis, group, and port-channel keywords and number argument were added.

Usage Guidelines

Use the show lacp command to troubleshoot problems related to LACP in a network.

If you do not specify a value for the argument channel-group-number, all channel groups are displayed. Values in the range of 257 to 282 are supported on the CSM and the FWSM only.

You can enter the optional channel-group-number to specify a channel group for all keywords except the sys-id keyword.

Examples

show lacp sys-id Example

This example shows how to display the LACP system identification using the show lacp sys-id command:

Router> show lacp sys-id

8000,AC-12-34-56-78-90

The system identification is made up of the system priority and the system MAC address. The first two bytes are the system priority, and the last six bytes are the globally administered individual MAC address that is associated to the system.

LACP Statistics for a Specific Channel Group Examples

This example shows how to display the LACP statistics for a specific channel group:

Router# show lacp 1 counters

              LACPDUs         Marker       LACPDUs

Port       Sent   Recv     Sent   Recv     Pkts Err

---------------------------------------------------

Channel group: 1

  Fa4/1    8      15       0      0         3    0

  Fa4/2    14     18       0      0         3    0

  Fa4/3    14     18       0      0         0

  Fa4/4    13     18       0      0         0

The output displays the following information:

•The LACPDUs Sent and Recv columns display the LACPDUs that are sent and received on each specific interface.

•The LACPDUs Pkts and Err columns display the marker-protocol packets.

The following example shows output from a show lacp channel-group-number counters command:

Router1# show lacp 5 counters

             LACPDUs         Marker      Marker Response    LACPDUs

Port       Sent   Recv     Sent   Recv     Sent   Recv      Pkts Err

---------------------------------------------------------------------

Channel group: 5

Gi5/0/0     21     18       0      0        0      0         0     

Table 27 describes the significant fields shown in the sample output of the show lacp counters command.

Table 27 show lacp number counters Field Descriptions 

Field	Description
LACPDUs Sent Recv	Number of LACP PDUs sent and received.
Marker Sent Recv	Attempts to avoid data loss when a member link is removed from an LACP bundle.
Marker Response Sent Recv	Cisco IOS response to the Marker protocol.
LACPDUs Pkts Err	Number of LACP PDU packets transmitted and the number of packet errors.

The following example shows output from a show lacp internal command:

Router1# show lacp 5 internal

Flags:  S - Device is requesting Slow LACPDUs 

        F - Device is requesting Fast LACPDUs

        A - Device is in Active mode       P - Device is in Passive mode     

Channel group 5

                            LACP port     Admin     Oper    Port        Port

Port      Flags   State     Priority      Key       Key     Number      State

Gi5/0/0   SA      bndl      32768         0x5       0x5     0x42        0x3D

Table 28 describes the significant fields shown in the sample output of the show lacp internal command.

Table 28 show lacp internal Field Descriptions 

Field	Description
Flags	Meanings of each flag value, which indicates a device activity.
Port	Port on which link bundling is configured.
Flags	Indicators of device activity.
State	Activity state of the port. States can be any of the following: •Bndl—Port is attached to an aggregator and bundled with other ports. •Susp—Port is in suspended state, so it is not attached to any aggregator. •Indep—Port is in independent state (not bundled but able to switch data traffic). This condition differs from the previous state because in this case LACP is not running on the partner port. •Hot-sby—Port is in hot standby state. •Down—Port is down.
LACP port Priority	Priority assigned to the port.
Admin Key	Defines the ability of a port to aggregate with other ports.
Oper Key	Determines the aggregation capability of the link.
Port Number	Number of the port.
Port State	State variables for the port that are encoded as individual bits within a single octet with the following meaning: •bit0: LACP_Activity •bit1: LACP_Timeout •bit2: Aggregation •bit3: Synchronization •bit4: Collecting •bit5: Distributing •bit6: Defaulted •bit7: Expired

Internal Information About a Specific Channel Group Example

This example shows how to display internal information for the interfaces that belong to a specific channel:

Router# show lacp 1 internal

Flags:  S - Device sends PDUs at slow rate. F - Device sends PDUs at fast rate.

        A - Device is in Active mode.       P - Device is in Passive mode. 

Channel group 1

                            LACPDUs     LACP Port    Admin   Oper    Port     Port

Port      Flags    State    Interval    Priority     Key     Key     Number   State

Fa4/1     saC      bndl     30s         32768        100     100     0xc1     0x75

Fa4/2     saC      bndl     30s         32768        100     100     0xc2     0x75

Fa4/3     saC      bndl     30s         32768        100     100     0xc3     0x75

Fa4/4     saC      bndl     30s         32768        100     100     0xc4     0x75

Router# 

Table 29 describes the fields that are shown in the example.

Table 29 show lacp internal Command Output Fields 

Field	Description
State	Current state of the port; allowed values are as follows: •bndl—Port is attached to an aggregator and bundled with other ports. •susp—Port is in a suspended state; it is not attached to any aggregator. •indep—Port is in an independent state (not bundled but able to switch data traffic. In this case, LACP is not running on the partner port). •hot-sby—Port is in a hot-standby state. •down—Port is down.
LACPDUs Interval	Interval setting.
LACP Port Priority	Port-priority setting.
Admin Key	Defines the ability of a port to aggregate with other ports.
Oper Key	Determines the aggregation capability of the link.
Port Number	Port number.
Port State	Activity state of the port. •See the Port State description in Table 28 for state variables.

Information About LACP Neighbors for a Specific Port Example

This example shows how to display the information about the LACP neighbors for a specific port channel:

Router# show lacp 1 neighbors

Flags:  S - Device sends PDUs at slow rate. F - Device sends PDUs at fast rate.

        A - Device is in Active mode.       P - Device is in Passive mode.

Channel group 1 neighbors

          Partner                 Partner 

Port      System ID               Port Number     Age     Flags

Fa4/1     8000,00b0.c23e.d84e     0x81            29s     P

Fa4/2     8000,00b0.c23e.d84e     0x82            0s      P

Fa4/3     8000,00b0.c23e.d84e     0x83            0s      P 

Fa4/4     8000,00b0.c23e.d84e     0x84            0s      P

          Port          Admin     Oper      Port

          Priority      Key       Key       State

Fa4/1     32768         200       200       0x81

Fa4/2     32768         200       200       0x81

Fa4/3     32768         200       200       0x81

Fa4/4     32768         200       200       0x81

Router# 

Table 30 describes the fields that are shown in the example.

Table 30 show lacp neighbors Command Output Fields 

Field	Description
Port	Port on which link bundling is configured.
Partner System ID	Peer's LACP system identification (sys-id). It is a combination of the system priority and the MAC address of the peer device.
Partner Port Number	Port number on the peer device
Age	Number of seconds since the last LACP PDU was received on the port.
Flags	Indicators of device activity.
Port Priority	Port priority setting.
Admin Key	Defines the ability of a port to aggregate with other ports.
Oper Key	Determines the aggregation capability of the link.
Port State	Activity state of the port. See the Port State description in Table 28 for state variables.

If no PDUs have been received, the default administrative information is displayed in braces.

Related Commands

Command	Description
clear lacp counters	Clears the statistics for all interfaces belonging to a specific channel group.
lacp port-priority	Sets the priority for the physical interfaces.
lacp system-priority	Sets the priority of the system.

show lldp

To display information about one or all neighboring devices discovered using Link Layer Discovery Protocol (LLDP), use the show lldp command in privileged EXEC mode.

show lldp [entry {* | word} | errors | interface [ethernet number] | neighbors [ethernet number | detail] | traffic]

Syntax Description

entry	(Optional) Displays detailed information for a specific neighbor entry.
*	(Optional) Displays detailed information about all the LLDP neighbors.
word	(Optional) Name of the neighbor about which information is requested.
errors	(Optional) Displays LLDP computational errors and overflows.
interface	(Optional) Displays status and configuration of an interface on which LLDP is enabled.
ethernet	(Optional) Displays an IEEE 802.3 interface on which LLDP is enabled.
number	(Optional) Integer that identifies the interface.
neighbors	(Optional) Displays neighbor entries. Note If the device ID has more than 20 characters, the ID will be truncated to 20 characters in command output because of display constraints.
detail	(Optional) Displays detailed information about a neighbor (or neighbors) including network address, enabled capabilities, hold time, and software version.
traffic	(Optional) Displays LLDP statistics.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SXH	This command was introduced.

Usage Guidelines

Use this command to monitor LLDP activity in a network.

When you use the neighbors keyword, the device ID is truncated to 20 characters in the command output because of display constraints. The show lldp neighbors command functions correctly; only the device ID display is truncated. For detailed neighbor information, use the show lldp neighbors detail command.

Examples

The following is sample output from the show lldp entry * command. Information about all the LLDP neighbors is displayed, including device ID, capabilities, addresses, hold time, and version.

Router# show lldp entry *

Capability codes:

    (R) Router, (B) Bridge, (T) Telephone, (C) DOCSIS Cable Device

    (W) WLAN Access Point, (P) Repeater, (S) Station, (O) Other

Chassis id: aabb.cc00.1f01

Port id: Et1/0

Port Description: Ethernet1/0

System Name: R1.example.com

System Description:

Cisco IOS Software, Solaris Software (UNIX-JS-M)

12.2(20070524:210936) [user1-sierra-0522 105]

Copyright (c) 1986-2007 by Cisco Systems, Inc.

Compiled Fri 25-May-07 10:52 by user1

Time remaining: 136 seconds

System Capabilities: B,R

Enabled Capabilities: R

Management Addresses - not advertised

Auto Negotiation - not supported

Physical media capabilities - not advertised

Media Attachment Unit type - not advertised

---------------------------------------------

Total entries displayed: 1

Table 31 describes the significant fields in the output.

Table 31 show lldp entry * Field Descriptions 

Field	Description
Capability Codes	Type of device that can be discovered. Possible values are as follows: R—Router B—Bridge T—Telephone C—DOCSIS Cable Device W—WLAN Access Point P—Repeater S—Station O—Other
Chassis id	Identifier assigned to the device.
Port id	Identifier of the interface.
Port Description	Description of the interface.
System Name	Name of the device within the network.
System Description	Description of the software operating on the device.
Time remaining	Time remaining before the information is aged out.
System Capabilities	Possible capabilities of the device.
Enabled Capabilities	Subset of possible capabilities that are enabled.
Management Addresses	Layer 3 addresses of the management interface.
Auto Negotiation	Supported and enabled status of all interface autonegotiation capabilities.
Physical media capabilities	Physical characteristics of the interface on which LLDP operates.
Media Attachment Unit type	Numeric value representing the type of the media attachment unit.
Total entries displayed	Number of neighbor devices for which information is displayed.

The following is sample output from the show lldp neighbors command showing information about neighboring devices discovered using LLDP.

Router# show lldp neighbors

Capability codes:

    (R) Router, (B) Bridge, (T) Telephone, (C) DOCSIS Cable Device

    (W) WLAN Access Point, (P) Repeater, (S) Station, (O) Other

Device ID           Local Intf     Hold-time  Capability      Port ID

R1                  Et1/0          150        R               Et1/0

Total entries displayed: 1

Table 32 describes the significant fields shown in the output.

Table 32 show lldp neighbors Field Descriptions

Field	Description
Capability Codes	See Table 31 for details.
Device ID	Name of the neighbor device. Note If the device ID has more than 20 characters, the ID will be truncated to 20 characters in command output because of display constraints.
Local Intf	Local interface through which this neighbor is connected.
Hold-time	Amount of time (in seconds) the current device will hold the LLDP advertisement from a sending device before discarding it.
Capability	Type of device listed in the LLDP Neighbors table. Values correspond to the values of the capability codes.
Port ID	Interface and port number of the neighboring device.
Total entries displayed	Number of neighbor devices for which information is displayed.

The following is sample output from the show lldp interface command for interface Ethernet 0/1:

Router# show lldp interface ethernet 0/1

Ethernet0/1:

    Tx: enabled

    Rx: enabled

    Tx state: IDLE

    Rx state: WAIT FOR FRAME

Table 33 describes the significant fields shown in the output.

Table 33 show lldp interface Field Descriptions

Field	Description
Tx	Ability of the interface to transmit advertisements.
Rx	Ability of the interface to receive advertisements.
Tx state	Current finite state machine state of the interface in transmit mode.
Rx state	Current finite state machine state of the interface in receive mode.

The following is sample output from the show lldp errors command:

Router# show lldp errors

LLDP errors/overflows:

    Total memory allocation failures: 0

    Total encapsulation failures: 0

    Total input queue overflows: 0

    Total table overflows: 0

Table 34 describes the significant fields shown in the output.

Table 34 show lldp errors Field Descriptions

Field	Description
Total memory allocation failures	Number of memory allocation failures.
Total encapsulation failures	Number of LLDP packet encapsulation failures.
Total input queue overflows	Number of times incoming advertisements exceeded the capacity of the LLDP input queue.
Total table overflows	Number of times the LLDP table rejected advertisements because it was full.

The following is sample output from the show lldp traffic command:

Router# show lldp traffic

LLDP traffic statistics:

    Total frames out: 277

    Total entries aged: 0

    Total frames in: 328

    Total frames received in error: 0

    Total frames discarded: 0

    Total TLVs unrecognized: 0

Table 35 describes the significant fields shown in the output.

Table 35 show lldp traffic Field Descriptions 

Field	Definition
Total frames out	Number of advertisements sent from the device.
Total entries aged	Number of neighbor device entries aged out.
Total frames in	Number of advertisements received by the device.
Total frames received in error	Number of times the LLDP advertisements contained errors of any type.
Total frames discarded	Number of times the LLDP process discarded an incoming advertisement.
Total TLVs unrecognized	Number of TLVs that could not be processed because the content of the TLV was not recognized by the device or the content fields were incorrectly specified.

snmp-server enable traps ethernet cfm alarm

To enable Ethernet Connectivity Fault Management (CFM) fault alarm traps, use the snmp-server enable traps ethernet cfm alarm command in global configuration mode. To disable fault alarm traps, use the no form of this command.

snmp-server enable traps ethernet cfm alarm

no snmp-server enable traps ethernet cfm alarm

Syntax Description

This command has no arguments or keywords.

Command Default

Traps are disabled.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.

Usage Guidelines

Use this command to turn on or turn off CFM fault alarm traps.

Examples

The following example shows how to enable CFM fault alarm traps:

Router#

Router(config)# snmp-server enable traps ethernet cfm alarm 

snmp-server enable traps ethernet cfm cc

To enable Simple Network Management Protocol (SNMP) trap generation for Ethernet connectivity fault management (CFM) continuity check events, use the snmp-server enable traps ethernet cfm cc command in global configuration mode. To disable SNMP trap generation for Ethernet CFM continuity check events, use the no form of this command.

snmp-server enable traps ethernet cfm cc [config] [cross-connect] [loop] [mep-down] [mep-up]

no snmp-server enable traps ethernet cfm cc [config] [cross-connect] [loop] [mep-down] [mep-up]

Syntax Description

config	(Optional) Generates a trap when a CFM misconfiguration exists in the network.
cross-connect	(Optional) Generates a trap when a cross-connected service exists in the network.
loop	(Optional) Generates a trap when a forwarding loop exists in the network.
mep-down	(Optional) Generates a trap when a device has lost connectivity with a remote MEP or when connectivity from a previously learned remote MEP is restored after interruption.
mep-up	(Optional) Generates a trap when a new remote maintenance endpoint (MEP) has been discovered and learned by the device or when a change occurs in the port state of a previously discovered remote MEP.

Command Default

When no options are configured, all continuity check traps are enabled.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2.

Usage Guidelines

The configuration error trap (cEtherCfmCcConfigError) is triggered when a device receives a CCM that has the same MPID as a locally configured MEP but a different source MAC Address than its own. The configuration error trap includes the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•The MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•MPID of local MEP that has the same ID as that received in the CCM.

•Name of the interface on which the MEP above is configured.

•MAC Address of the remote device sending the CCM.

The cross-connect service trap (cEtherCfmCcCrossconnect) is generated when a device receives a continuity check message (CCM) whose service ID is different from what is locally configured on the device for the given service VLAN (S-VLAN). This mismatch indicates that there could be a cross-connected service in the network. The trap includes the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•The MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•MPID of remote MEP causing the alarm to be raised.

•MAC address of remote MEP causing the alarm to be raised.

•Service ID reported by the remote MEP.

The loop trap (cEtherCfmCcLoop) is generated when a device receives a CCM that has the same source MAC Address and MPID as its own, thereby indicating that the device is receiving its own CCMs and that a forwarding loop exists in the network. The loop trap includes the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•The MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•MPID of the MEP originating the CCM.

•Name of the interface on which the MEP above is configured.

The mep-down trap (cEtherCfmCcMepDown) notifies the NMS that the device has lost connectivity with a remote MEP. This trap also serves as a clear for Loop, Config, Cross-Connect and Unknown-MEP events.

The mep-down trap is generated in the following cases:

•A valid CCM with a zero hold-time is received from a remote MEP, and the device either has a valid (non-expired) CCDB entry for that MEP or does not have any CCDB entry. In other words, the trap is not generated for an already expired CCDB entry. This trigger has the event code "lastGasp."

•An entry for a remote MEP in the CCDB expires and is archived. This trigger has the event code "timeout."

•A previous configuration error trap is cleared. This trigger has the event code "configClear."

•A previous loop trap is cleared. This trigger has the event code "loopClear."

•A previous Crossconnect trap is cleared. This trigger has the event code "xconnectClear."

•A previous unknown trap is cleared. This trigger has the event code "unknownClear."

The mep-down trap includes the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•The MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•A count of the local MEPs on the same domain and S-VLAN as the remote MEP that are affected by the event.

•A count of the different interfaces on which the local MEPs above are configured.

•MPID of the remote MEP that is being reported down.

•MAC address of the remote MEP that is being reported down.

•Event code indicating one of the following: lastGasp, timeout, configClear, loopClear, xconnectClear, unknownClear.

The mep-up trap (cEtherCfmCcMepUp) serves three functions. One function is to notify the network management system (NMS) that a new MEP has been discovered and learned by the device. The second function is that the trap notifies the NMS that there is a change in the port-state of a previously discovered remote MEP. The third is to notify the NMS when connectivity from a previously discovered MEP is restored after interruption.

Mep-up traps are suppressed while cross-check is operational because the cross-check traps more efficiently convey the status of the service.

The mep-up trap is generated in the following cases:

•A valid CCM with a non-zero hold-time is received from a remote MEP for the first time, and hence an entry is created for that MEP in the continuity check database (CCDB). This trigger has the event code "new."

•A valid CCM with a non-zero hold-time is received from a remote MEP for which the device has an expired entry in the CCDB (that is, the device has an entry for that remote MEP in the archived DB). This trigger has the event code "returning."

•A valid CCM with a non-zero hold-time is received from a remote MEP for which the device has a valid entry in the CCDB and the port-state indicated in the CCM is different from what is cached in the CCDB. This trigger has the event code "portState"

The mep-up trap includes the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•The MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•A count of the local MEPs on the same domain and S-VLAN as the remote MEP that are affected by the event.

•A count of the different interfaces on which the local MEPs above are configured.

•MPID of the remote MEP that is being reported up.

•MAC address of the remote MEP that is being reported up.

•Event code indicating one of the following: new MEP, returning MEP, or port-state change.

•Port state of remote MEP.

Examples

The following example shows how to enable SNMP trap generation for Ethernet CFM continuity checks when a new remote MEP is discovered and learned by the device:

Router(config)# snmp-server enable traps ethernet cfm cc mep-up

snmp-server enable traps ethernet cfm crosscheck

To enable Simple Network Management Protocol (SNMP) trap generation for Ethernet connectivity fault management (CFM) continuity check events, in relation to the cross-check operation between statically configured maintenance endpoints (MEPs) and those learned via continuity check messages (CCMs), use the snmp-server enable traps ethernet cfm crosscheck command in global configuration mode. To disable SNMP trap generation for these continuity check events, use the no form of this command.

snmp-server enable traps ethernet cfm crosscheck [mep-missing] [mep-unknown] [service-up]

no snmp-server enable traps ethernet cfm crosscheck [mep-missing] [mep-unknown] [service-up]

Syntax Description

mep-missing	(Optional) Generates a trap when the cross-check enable timer expires and no CCMs were received from an expected (configured) MEP. One trap is generated per remote MEP.
mep-unknown	(Optional) Generates a trap when an unexpected (unconfigured) MEP comes up. One trap is generated per remote MEP.
service-up	(Optional) Generates a trap when all remote MEPs belonging to a service instance come up.

Command Default

This command is disabled.

When no options are configured, all continuity check event traps are enabled.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2.

Usage Guidelines

For this class of traps to function, cross-check must be enabled on the device. Otherwise, none of these traps will be generated, even if they are configured.

The mep-missing trap (cEtherCfmXCheckMissing) notifies the network management system (NMS) that the device did not receive any CCMs from a remote MEP that it was expecting to be part of the service instance.

The mep-missing trap is generated in the following case:

•After enabling cross-check (ethernet cfm mep crosscheck enable), the device waits for the cross-check-start timeout value specified (ethernet cfm mep crosscheck enable-timeout). When the timeout period has elapsed, the device will cross-check the list of remote MEPs it has learned via CCMs against the static list that has been configured (mep crosscheck mpid vlan). For each remote MEP that is configured in the static list and for which the device has not received a CCM, a mep-missing trap is generated.The mep-missing trap has the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•MPID of the remote MEP that is being reported missing.

•MAC address of the remote MEP that is being reported missing.

The mep-unknown trap (cEtherCfmXCheckUnknown) notifies the NMS that the device received CCMs from a remote MEP that it was not expecting to be part of the service instance.

The mep-unknown trap is generated in the following case:

•After cross-check is in an operational state, the device dynamically examines the list of statically configured remote MEPs against what it learns from CCMs. This occurs after cross-check is enabled and the timer has expired. When the device receives a CCM with non-zero hold time from a remote MEP that does not exist in the static list, the device raises a mep-unknown trap.

The mep-unknown trap has the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•MPID of the remote MEP that is being reported unknown.

•MAC address of the remote MEP that is being reported unknown.

The service-up trap (cEtherCfmXCheckServiceUp) notifies the NMS that the device received CCMs from all remote MEPs within a given service instance.

The service-up trap is generated in the following case:

•When the device receives CCMs from all remote statically configured MEPs before the expiration of the crosscheck enable-timeout period.

The service-up trap has the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

Examples

The following example shows how to enable SNMP trap generation for Ethernet CFM continuity check events when an unexpected (unconfigured) MEP comes up:

Router (config)# snmp-server enable traps ethernet cfm crosscheck mep-unknown

Related Commands

Command	Description
ethernet cfm mep crosscheck enable	Enables cross checking between the list of configured remote MEPs of a domain and MEPs learned through CCMs.
mep crosscheck mpid vlan	Statically defines a remote MEP within a maintenance domain.

snmp-server enable traps ethernet evc

To enable Simple Network Management Protocol (SNMP) Ethernet virtual circuit (EVC) traps, use the snmp-server enable traps ethernet evc command in global configuration mode. To disable SNMP EVC traps, use the no form of this command.

snmp-server enable traps ethernet evc [create] [delete] [status]

no snmp-server enable traps ethernet evc

Syntax Description

create	(Optional) Enables SNMP EVC create traps.
delete	(Optional) Enables SNMP EVC delete traps.
status	(Optional) Enables SNMP EVC status traps.

Command Default

Trap notifications are not sent.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.

Usage Guidelines

Use this command to turn on or turn off SNMP EVC traps.

Examples

The following example shows how to enable SNMP Ethernet EVC traps to be created:

Router# configure terminal

Router(config)# snmp-server enable traps ethernet evc create

Related Commands

snmp-server host traps eve

Enables EVC trap notifications to a specific SNMP host.

snmp-server enable traps ether-oam

To enable Ethernet Operations, Administration, and Maintenance (OAM) MIB traps, use the snmp-server enable traps ether-oam command in global configuration mode. To disable OAM MIB traps, use the no form of this command.

snmp-server enable traps ether-oam

no snmp-server enable traps ether-oam

Syntax Description

This command has no arguments or keywords.

Command Default

OAM traps are disabled.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.

Usage Guidelines

A trap will not be sent if a trap was sent within the last 1 second.

Examples

The following example shows how to enable OAM MIB traps:

Router# configure terminal

Router(config)# snmp-server enable traps ether-oam 

snmp-server host traps evc

To enable Ethernet virtual circuit (EVC) trap notifications to a specific Simple Network Management Protocol (SNMP) host, use the snmp-server host traps evc command in global configuration mode. To disable EVC trap notifications to a specific host, use the no form of this command.

snmp-server host ipaddr traps string evc

no snmp-server host ipaddr traps string

Syntax Description

ipaddr	IPv4 or IPv6 address of the SNMP notification host.
string	SNMPv1 community string, SNMPv2c community string, or SNMPv3 username.

Command Default

EVC trap notifications are not sent to an SNMP host.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.

Usage Guidelines

Use this command to start or stop sending EVC traps to a specific SNMP host.

Examples

The following example shows how to enable EVC trap notifications to an SNMP host:

Router# configure terminal

Router(config)# snmp-server host 172.17.2.0 traps snmphost01 evc

Related Commands

snmp-server enable traps ethernet evc

Enables SNMP EVC traps.

source template (eoam)

To associate a template to an Ethernet operations, maintenance, and administration (OAM) interface, use the source template (eoam) command in interface configuration mode. To remove the source template association, use the no form of this command.

source template template-name

no source template template-name

Syntax Description

template-name

String that identifies the source template.

Command Default

No source template is configured.

Command Modes

Interface configuration (config-if)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.

Usage Guidelines

When this command is used, the interface inherits all the configurations in the template. A benefit of using a source template is that it helps reduce the overall configuration size by grouping repeating commands.

Examples

The following example shows how to create a source template named oam on OAM interface Ethernet 0/1:

Router(config)# interface ethernet 0/1

Router(config-if)# source template oam

Related Commands

template (eoam)

Configures a template for use on Ethernet OAM interfaces and places the device in configuration template mode.

template (eoam)

To configure a template for use on Ethernet operations, maintenance, and administration (OAM) interfaces and enter configuration template mode, use the template (eoam) command in global configuration mode. To remove the template, use the no form of this command.

template template-name

no template template-name

Syntax Description

template-name

String that identifies the template.

Command Default

No templates are configured.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.

Usage Guidelines

This command groups parameters that can be applied (bound) to one or more interfaces that share the same OAM characteristics. A benefit of using the template (eoam) command is that it helps reduce the overall configuration size by grouping repeating commands and streamlines Ethernet OAM interface configuration.

More than one template can be configured but only one template can be associated with a single Ethernet OAM interface. Commands defined in a template may be overridden by explicitly configuring those commands on the interface in interface configuration mode.

Examples

The following example shows how to create an OAM template named oam and enter configuration template mode:

Router(config)# template oam

Router(config-template)#

Related Commands

source template (eoam)

Associates a template to an Ethernet OAM interface.

traceroute ethernet

To send Ethernet connectivity fault management (CFM) traceroute messages to a destination maintenance endpoint (MEP), use the traceroute ethernet command in privileged EXEC mode. This command does not have a no form.

traceroute ethernet {mac-address | mpid mpid} {domain domain-name {evc evc-name | port | vlan vlan-id}} [cos value] [fdb-only | source mpid]

Syntax Description

Syntax DescriptionCommand Syntax]

mac-address	MAC address of a remote MEP in the format abcd.abcd.abcd.
mpid	Specifies a destination MEP.
mpid	Integer from 1 to 8191 that identifies the MEP.
domain	Specifies the domain in which the destination MEP resides.
domain-name	String of a maximum of 154 characters that identifies the domain.
evc	Specifies an Ethernet virtual circuit (EVC).
evc-name	String that identifies the EVC.
port	Specifies a DOWN service with no VLAN association (untagged).
vlan	Specifies a VLAN.
vlan-id	Integer from 1 to 4094 that identifies the VLAN.
cos	(Optional) Specifies a class of service (CoS).
value	(Optional) Integer from 0 to 7 that identifies the CoS.
fdb-only	(Optional) Specifies the forwarding database (FDB) table.
source	(Optional) Specifies a source MEP.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SXI2	This command was introduced.
12.2(33)SRE	This command was modified. Support for the evc keyword was added in Cisco IOS Release 12.2(33)SRE.

Usage Guidelines

If a CoS is not configured, the default is the highest priority allowed for the egress interface.

FDB is another term for the L2 forwarding table. When the fdb-only option is configured, only MAC addresses learned in a bridge's FDB (not information saved in the maintenance intermediate point [MIP] continuity check database [CCDB]) are used to determine the egress port.

The destination can be either a MEP or a MIP. If the destination is a MIP, the FDB must have a MAC address entry for that MIP; that is, the FDB has learned the MIP's MAC address via Linktrace responses.

For a bridge domain-VLAN service, the VLAN ID can be used to initiate traceroute.

On the Cisco Catalyst 6500 series switch, an FDB configuration will work only if the origination MEP is a down MEP. Also, for a MEP to clear the Alarm Indication Signal (AIS) defect condition, there should be no corresponding entry in the error database. For example, if you change the remote MEP from an UP MEP to a DOWN MEP, the local entry will time out and enter the AIS defect condition. The database starts receiving a new CC entry based on the newly configured DOWN MEP, but the local AIS defect is not yet cleared. It will remain in the AIS state until either the archive hold time expires or you issue the clear ethernet cfm errors command.

The following example shows a traceroute ethernet command and output:

Router# traceroute ethernet mpid 401 domain Domain_L5 vlan 9

Type escape sequence to abort. TTL 64. Linktrace Timeout is 5 seconds

Tracing the route to aabb.cc03.bb99 on Domain Domain_L5, Level 5, vlan 9

Traceroute sent via Ethernet0/0.9, path found via MPDB

B = Intermediary Bridge

! = Target Destination

* = Per hop Timeout

--------------------------------------------------------------------------------

                             MAC      Ingress      Ingr Action  Relay Action    

  Hops   Host             Forwarded   Egress       Egr Action   Previous Hop     

--------------------------------------------------------------------------------

! 1                    aabb.cc03.bb99                           RlyHit:MEP     

                       Not Forwarded                            aabb.cc03.b999

Related Commands

Command	Description
clear ethernet cfm errors	Removes continuity check error conditions from the error database.
clear ethernet cfm traceroute-cache	Removes the contents of the traceroute cache.
ethernet cfm traceroute-cache	Enables caching of Ethernet CFM data learned through traceroute messages.
show ethernet traceroute-cache	Displays the contents of the traceroute cache.

traceroute ethernet evc

To send Ethernet connectivity fault management (CFM) traceroute messages to a destination MAC address, use the traceroute ethernet evc command in privileged EXEC mode.

traceroute ethernet mac-address {domain domain-name | level level-id} evc evc-name

Syntax Description

mac-address	MAC address of a remote maintenance endpoint (MEP) in the format abcd.abcd.abcd.
domain	Identifies the domain in which the destination MEP resides.
domain-name	String of a maximum of 154 characters that identifies the domain.
level	Indicates the maintenance level where the device with the specified MAC address is located.
level-id	Integer from 0 to 7 that identifies the maintenance level.
evc-name	String that identifies the Ethernet virtual circuit (EVC) name.

Command Default

Sends an Ethernet CFM traceroute message to a specified MAC address.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.

Usage Guidelines

Traceroute messages can be issued only to MEPs. Before you issue the traceroute ethernet evc command, you should have a MEP configured for the same EVC and domain.

Examples

The following example shows how to send an Ethernet CFM traceroute message to MAC address aabb.cc00.1010 in maintenance level 4 on evc_100:

Router# traceroute ethernet aabb.cc00.1010 level 4 evc evc_100

Type escape sequence to abort. TTL 255. Per-Hop Timeout is 10 seconds

Tracing the route to aabb.cc00.1010 on Domain PROVIDER, Level 4, evc evc_100

Traceroute sent via Ethernet6/0

B = Intermediary Bridge

! = Target Destination

* = Per Hop Timeout

--------------------------------------------------------------------------------

                             MAC      Ingress      Ingress Action  Relay Action    

  Hops   Host             Forwarded   Egress       Egress Action   Next Hop        

--------------------------------------------------------------------------------

B 1   PE               aabb.cc00.1011 Et6/0        IngOk        RlyCCDB        

                       Forwarded      Et1/0.100    EgrOK        CE1            

! 2   CE1              aabb.cc00.1010 Et1/0.100    IngOk        RlyNone        

                       Not Forwarded 

Related Commands

Command	Description
clear ethernet cfm traceroute-cache	Removes the contents of the traceroute cache.
ethernet cfm traceroute-cache	Enables caching of Ethernet CFM data learned through traceroute messages.
show ethernet traceroute-cache	Displays the contents of the traceroute cache.
traceroute-ethernet vlan	Sends Ethernet CFM traceroute messages to a destination MAC address.

traceroute ethernet vlan

To send Ethernet connectivity fault management (CFM) traceroute messages to a destination MAC address, use the traceroute ethernet vlan command in privileged EXEC mode.

traceroute ethernet mac-address {domain domain-name | level level-id}
{evc evc-name | vlan vlan-id}

Syntax Description

Syntax DescriptionCommand Syntax]

mac-address	MAC address of a remote MEP in the format abcd.abcd.abcd.
domain	Identifies the domain in which the destination MEP resides.
domain-name	String of a maximum of 154 characters that identifies the domain.
level	Indicates the maintenance level where the device with the specified MAC address is located.
level-id	Integer from 0 to 7 that identifies the maintenance level.
evc	Identifies the Ethernet virtual circuit.
evc-name	String that identifies the EVC name.
vlan	Indicates a VLAN for cross checking.
vlan-id	Integer from 1 to 4094 that identifies the VLAN.

Command Default

Sends an Ethernet CFM traceroute message to a specified MAC address.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SRD	This command was modified. The evc keyword and evc-name argument were introduced on the Cisco 7600 Series Route Switch Processor 720 (RSP 720) and on the Cisco 7600 Series Supervisor Engine 720.

Usage Guidelines

Traceroute messages can be issued only to maintenance endpoints (MEPs). Before you issue the traceroute ethernet vlan command, you should have a MEP configured for the same VLAN or EVC and domain.

Examples

The following example shows how to send an Ethernet CFM traceroute message to MAC address aabb.cc00.1010 in maintenance level 4, EVC evc_100:

Router# traceroute ethernet aabb.cc00.1010 level 4 evc evc_100

Type escape sequence to abort. TTL 255. Per-Hop Timeout is 10 seconds

Tracing the route to aabb.cc00.1010 on Domain PROVIDER, Level 4, evc evc_100

Traceroute sent via Ethernet6/0

B = Intermediary Bridge

! = Target Destination

* = Per Hop Timeout

--------------------------------------------------------------------------------

                             MAC      Ingress      Ingress Action  Relay Action    

  Hops   Host             Forwarded   Egress       Egress Action   Next Hop        

--------------------------------------------------------------------------------

B 1   PE               aabb.cc00.1011 Et6/0        IngOk        RlyCCDB        

                       Forwarded      Et1/0.100    EgrOK        CE1            

! 2   CE1              aabb.cc00.1010 Et1/0.100    IngOk        RlyNone        

                       Not Forwarded 

The following example shows how to send an Ethernet CFM traceroute message to MAC address bc12.cc12.dc12 in maintenance level 3, VLAN ID 2550:

Router# traceroute ethernet bc12.cc12.dc12 level 3 vlan 2550

Type escape sequence to abort. TTL 255. Per-Hop Timeout is 10 seconds

Tracing the route to aabb.cc00.0400 on Domain DOMAIN_OPERATOR_L5_1, Level 5, vlan 7

Traceroute sent via Ethernet1/0.6

--------------------------------------------------------------------------------

                             MAC      Ingress Ingress Action    Relay Action    

  Hops   Host             Forwarded   Egress  Egress Action     Next Hop        

--------------------------------------------------------------------------------

B 1   denver           aabb.cc00.0200                           RlyCCDB        

                       Forwarded      Et0/0   EgrOK             columbus       

! 2   boston           aabb.cc00.0400                           RlyNone        

                       Not Forwarded 

Related Commands

Command	Description
clear ethernet cfm traceroute-cache	Removes the contents of the traceroute cache.
ethernet cfm traceroute-cache	Enables caching of Ethernet CFM data learned through traceroute messages.
show ethernet traceroute-cache	Displays the contents of the traceroute cache.

uni count

To set the user-network interface (UNI) count for an Ethernet virtual connection (EVC), use the uni count command in EVC configuration mode. To return to the default setting, use the no form of this command.

uni count value [multipoint]

no uni count

Syntax Description

value	Integer in the range of 2 to 1024 that is the number of UNIs in the EVC. The default is 2.
multipoint	(Optional) Indicates point-to-multipoint service. This option is available only with a uni count value of 2.

Command Default

The UNI count defaults to 2 and the service defaults to point-to-point service.

Command Modes

EVC configuration (config-evc)

Command History

Release	Modification
12.2(25)SEG	This command was introduced.
12.2(33)SRB	This command was implemented on the Cisco 7600 series routers.

Usage Guidelines

The UNI count determines the type of service in the EVC.

•A UNI count value of 1 or 2—The service defaults to point-to-point service.

•A UNI value of 2—You can leave the service at the default or you can configure point-to-multipoint service by entering the multipoint keyword.

•A UNI value of 3 or greater—The service is point-to-multipoint.

You should know the correct number of maintenance end points (MEPs) in the domain. If you enter a UNI count value greater than the number of endpoints, the UNI status shows as partially active even if all endpoints are up. If you enter a UNI count less than the number of endpoints, UNI status shows as active, even if all endpoints are not up.

---

Caution Configuring a UNI count does not prevent you from configuring more endpoints than the configured number of UNIs. For example, if you configure a UNI count of 5, but you create 10 MEPs, any 5 MEPs in the domain can go down without the status changing to partially active.

---

Examples

The following example shows how to set a UNI count of 2 with point-to-multipoint service:

Router(config)# ethernet evc test1

Router(config-evc)# uni count 2 multipoint

Related Commands

Command	Description
ethernet evc	Defines an EVC and enters EVC configuration mode.