Cisco IOS Carrier Ethernet Command Reference
show bridge-domain through uni count

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.