ECFM Commands

10 Jul 2024
39 Minutes to read
Contributors

ECFM Commands

Updated on 10 Jul 2024
39 Minutes to read
Contributors

Article summary

Did you find this summary helpful?

Thank you for your feedback

ECFM (Ethernet Connectivity Fault Management) CLI commands are categorized as follows:

Enable Commands

This section includes ECFM enable commands.

ethernet cfm cc enable

Command Objective:
This command enables the transmission of Continuity Check Messages (CCMs). The level and vlan identifies the Maintenance End Points (MEPs) to which the configuration applies.

The no form of the command disables the transmission of CCMs.

Note: For the transmission of CCMs by the Vlan unaware MEPs, vlan is not to be specified.

Syntax:

ethernet cfm cc enable {domain < domain-name > | level < a,b,c-d >} [service < service-name> | vlan < vlan-id/vfi-id > | service-instance < integer(256- 16777214) >]no ethernet cfm cc enable {domain < domain-name > | level < a,b,c-d >} [service < service-name > | vlan < vlan-id/vfi-id > | service-instance < integer(256-16777214) >]

Parameter Description:

domain< domain-name > - Sets the status of CCM transimisson for the specified Maintenance Domain name. This value is a string with maximum size as 43.
level< a,b,c-d > - Sets the status of CCM transimisson for the specified level at which the maintenance domain is defined. This value ranges from 0 to 7. Use comma as a separator to enter a list of levels. For example: 1,2,4-7
service < service-name > - Sets the status of CCM transimisson for the specified service name at which the maintenance domain is defined. This value is a string with maximum size as 43.

vlan < vlan-id/vfi-id > – Sets the status of CCM transimisson for the specified VLAN / VFI ID. This value ranges from 1 to 65535.

< vlan –id > – VLAN ID is a unique value that represents the specific VLAN. This value ranges from 1 to 4094.
< vfi-id > – VFI ID is a VLAN created in the system which contains Pseudo wires and Attachment Circuits as member ports. This creates a logical LAN for the VPLS service. This value ranges from 4096 to 65535.
Notes:
The VLAN ID 4095 is reserved and may be used to indicate a wildcard match for the VID in management operations or Filtering Database entries.
VFI IDs 4096 and 4097 are reserved identifiers used in MPLS PW.
The theoretical maximum for the maximum number of VFI is 65535 but the actual number of VFI supported is a sizing constant. Based on this, the maximum number of VFI ID accepted in the management interface is restricted. For example if 100 VFIs are supported, the maximum number of VFI supported will be restricted to maximum number of VLANs + 100. An error message is displayed for any value beyond this range.
vlan-list – Sets the CCM parameters for the specified VLAN list. Use comma separator to enter the list of vlan ids. For example: 1,2,100-102

service-instance< integer(256-16777214) > - Sets the status of CCM transimisson for the specified service instance. This value ranges from 256 to 16777214.

Mode:
Global Configuration Mode/ Switch Configuration Mode

Note: This command executes only if:
ECFM is started in the switch.
Maintenance Domain is created.

Maintenance Association is created for the maintenance domain.

Default:

interval - one-sec
role - fault-management

Example:

Your Product(config-switch)# ethernet cfm cc enable level 0 vlan 2

ethernet cfm enable

Command Objective:
This command enables a Connectivity Fault Management (CFM) processing globally on a device or on an interface.

The no form of the command disables the CFM processing globally on a device or on an interface.

Syntax:
ethernet cfm enable

no ethernet cfm enable

Mode:
Global Configuration Mode / Switch Configuration Mode or Interface Configuration Mode

Default:
Disable

Note: This command executes only if ECFM is started on the switch.

Example:

Your Product(config-switch)# ethernet cfm enable

Your Product(config-if)# ethernet cfm enable

ethernet cfm offload

Command Objective:
This command enables CCM Offloading on all the MEPs in the system and overwrites the per MEP offloading configuration.

The no form of the command disables CCM Offloading on all the MEPs on the device.

Syntax:
ethernet cfm offload

no ethernet cfm offload

Mode:
Global Configuration Mode / Switch Configuration Mode

Default:
By default, the CCM Offloading is disabled.

Note: This command executes only if ECFM is started on the switch.

Example:

Your Product(config-switch)#ethernet cfm offload

ethernet cfm start

Command Objective:
This command starts an Ethernet connectivity fault Management (CFM), processing globally on the switch.

The no form of the command shuts down the Ethernet CFM processing on the switch.

Syntax:
ethernet cfm start

no ethernet cfm start

Mode:
Global Configuration Mode / Switch Configuration Mode

Default:
ECFM is shutdown

Note: This command executes only if bridge mode is set for the switch.

Example:

Your Product(config-switch)# ethernet cfm start

Configuration Commands

This section includes ECFM configuration commands.

ethernet cfm cc

Command Objective:
This command configures the parameters (that is, Interval and Role) for CCMs (Continuity Check Messages). The level and vlan identifies the service (Maintenance Association) to which the configuration applies.

The no form of the command sets the CCM interval and role parameter to the default value (that is, one minute and Fault-Management respectively) for the MA at the specified level and vlan.

Note: For VLAN unaware services (Maintenance Association), vlan is not to be specified.

Syntax:

ethernet cfm cc {domain < domain-name > | level < a,b,c-d >} [service < service-name > | vlan {< vlan-id/vfi-id > | vlan-list} | service-instance < integer(256-16777214) >] [interval {three-hundred-hertz | ten-ms | hundred-ms | one-sec | ten-sec | one-min | ten-min}] [role {fault-management | performance-monitoring | protection-switching}]no ethernet cfm cc {domain < domain-name > | level < a,b,c-d >} [{service < service-name > | vlan < vlan-id/vfi-id > | service-instance < integer(256-16777214) >}] ([interval] [role])

Parameter Description:

domain< domain-name > - Configures the CCM parameters for the specified Maintenance Domain name. This value is a string with maximum size as 43.
level< a,b,c-d > - Configures the CCM parameters for the specified level at which the maintenance domain is defined. This value ranges from 0 to 7. Use comma as a separator to enter a list of levels. For example: 1,2,4-7
service < service-name > - Configures the CCM parameters for the specified the service name at which the maintenance domain is defined. This value is a string with maximum size as 43.

vlan – Configures the CCM parameters for the specified VLAN / VFI ID/Vlan List. This value ranges from 1 to 65535.

< vlan –id > – VLAN ID is a unique value that represents the specific VLAN. This value ranges from 1 to 4094.
< vfi-id > – VFI ID is a VLAN created in the system which contains Pseudo wires and Attachment Circuits as member ports. This creates a logical LAN for the VPLS service. This value ranges from 4096 to 65535.
Notes:
The VLAN ID 4095 is reserved and may be used to indicate a wildcard match for the VID in management operations or Filtering Database entries.
VFI IDs 4096 and 4097 are reserved identifiers used in MPLS PW.
The theoretical maximum for the maximum number of VFI is 65535 but the actual number of VFI supported is a sizing constant. Based on this, the maximum number of VFI ID accepted in the management interface is restricted. For example if 100 VFIs are supported, the maximum number of VFI supported will be restricted to maximum number of VLANs + 100. An error message is displayed for any value beyond this range.
vlan-list – Sets the CCM parameters for the specified VLAN list. Use comma separator to enter the list of vlan ids. For example: 1,2,100-102

service-instance< integer(256-16777214) > - Configures the CCM parameters for the specified service instance. This value ranges from 256 to 16777214.

interval – Sets the time between CCM transmissions. Options are:

three-hundred-hertz – CCMs are sent every 3 1/3 milliseconds. This timer is not supported in the software . It can only be configured in the hardware.
ten-ms – CCMs are sent every 10 milliseconds.
hundred-ms – CCMs are sent every 100 milliseconds.
one-sec – CCMs are sent every second.
ten-sec – CCMs are sent every 10 seconds.
one-min – CCMs are sent every minute.
ten-min – CCMs are sent every 10 minutes.

role – Configures the ETH-CC role to be performed. Options are:

fault-management – ETH-CC is used for Fault Management.
performance-monitoring – ETH-CC is used for Performance Monitoring.

Note: Performance Monitoring is applicable only for point-to-point Maintenance Entity (ME).

protection-switching – ETH-CC is used for Protection Switching.

Mode:
Global Configuration Mode / Switch Configuration Mode

Note: This command executes only if:
ECFM is started in the switch.
Maintenance Domain is created.

Maintenance Association is created for the maintenance domain.

Default:

interval - one-sec
role - fault-management

Example:

Your Product(config-switch)#  ethernet cfm cc domain d1 service ss interval ten-sec role protection-switching

ethernet cfm domain

Command Objective:
This command creates a CFM(Connectivity Fault Management) Maintenance Domain (MD) at a particular maintenance level and enters into the MD mode which allows the user to execute all the commands that supports MD mode.

The no form of this command deletes the configured CFM MD. All the associated Maintenance Associations with this domain must be removed, prior to the removal of the Maintenance Domain.

Syntax:
ethernet cfm domain [format {dns-like-name | mac-addr | char-string | none}] name < domain-name > level < level-id(0-7) >

no ethernet cfm domain [format {dns-like-name | mac-addr | char-string | none}] name < domain-name > level < level-id(0-7) >

Parameter Description:

format - Sets the format of the configured CFM maintenance domain. The options are:

dns-like-name - Sets the format of the CFM maintenance domain as DNS(Domain Name Service).
mac-addr - Sets the format of the CFM maintenance domain as MAC address plus a two-octet identifier.
char-string - Sets the format of the CFM maintenance domain as Plain ASCII character RFC2579 display string. The character codes 0-31 (decimal) are not used.
none - Specifies that the maintenance domain name is not used. In this case, a zero length OCTET STRING for the Domain Name field is acceptable.

name < domain-name > - Configures an unique name for the created domain. This value is a string with maximum size as 43.

Notes:

The range and type of this value differs with the format selected.

Maintenance Domain name must be unique throughout the system.

level < level-id(0-7) > - Configures the maintenance level for the created domain.at which the maintenance domain is defined. This value ranges from 0 to 7. Higher level value correspond to higher Maintenance Domains with the greatest physical reach and the highest values for customers' CFM PDUs.Lower level value correspond to lower Maintenance Domains with more limited physical reach and the lowest values for CFM PDUs, protecting single bridges or physical links.

Mode:
Global Configuration Mode / Switch Configuration Mode

Note: This command executes only if ECFM is started in the switch.

Example:

Your Product(config-switch)# ethernet cfm domain format dns-like-name name domain1 level 0

Your Product(config-ether-ecfm)#

ethernet cfm mep

Command Objective:
This command configures the MEP (Maintenance End Point) for an service-instance and enters into the MEP configuration mode which allows the user to execute all the commands that supports MEP mode. This command sets an interface as a domain boundary (edge), defines it as a MEP (Maintenance End Point), sets direction for the MEP and sets the operational status of the MEP.

The no form of the command removes the MEP configuration from the interface.

Note: For VLAN unaware MEP, VLAN is not to be specified.

Syntax:
ethernet cfm mep { domain < domain-name > | < level-id (0-7) >} [inward] mpid < mpid (1-8191) > [{service < service-name > | vlan < vlan-id/vfi-id > | service-instance < integer (256-16777214)>}][active]

no ethernet cfm mep { domain < domain-name > | level < level-id(0-7) >} [inward] mpid < id (1-8191) > [{service < service-name > | vlan < vlan-id/vfi-id > | service-instance < service-instance (256-16777214) >}] [active]

Parameter Description:

domain < domain-name > - Configures the MEP for the specified maintenance domain name. This value is a string with maximum size as 43.
level< 0-7 > - Configures the MEP for the specified maintenance domain level for the MEP at which the maintenance domain is defined. This value ranges from 0 to 7.
inward - Specifies the direction of the MEP as inward (up MEP) on the bridge port.Up MEP sends Continuity Check Messages towards the MAC Relay Entity. By default, the MEP direction is outward (down MEP); down MEP sends Continuity Check Messages away from the MAC Relay Entity.
mpid < id (1-8191) > - Configures the MEP ID at which the maintenance domain is defined. This value is unique over a given Maintenance Entity, identifying a specific Maintenance Entity Group End Point. This value ranges from 1 to 8191.
service < service-name > - Configures the MEP for the specified service name at which the maintenance association is defined. This value is a string with maximum size as 43.
vlan < vlan-id/vfi-id > - Configures MEP for the specified VLAN / VFI ID. This value ranges from 1 to 65535.

< vlan –id > -VLAN ID is a unique value that represents the specific VLAN. This value ranges from 1 to 4094.
< vfi-id > - VFI ID is a VLAN created in the system which contains Pseudo wires and Attachment Circuits as member ports. This creates a logical LAN for the VPLS service. This value ranges from 4096 to 65535.
Notes:
The VLAN ID 4095 is reserved and may be used to indicate a wildcard match for the VID in management operations or Filtering Database entries.
VFI IDs 4096 and 4097 are reserved identifiers used in MPLS PW.
The theoretical maximum for the maximum number of VFI is 65535 but the actual number of VFI supported is a sizing constant. Based on this, the maximum number of VFI ID accepted in the management interface is restricted. For example if 100 VFIs are supported, the maximum number of VFI supported will be restricted to maximum number of VLANs + 100. An error message is displayed for any value beyond this range.
On a particular interface, only one MEP can be configured at a particular level, VLAN ID and direction.

service-instance < integer (256-16777214) > - Configures the service instance identifier for which the MEP is defined. This is required only for the ISID aware MEP. This is applicable only for ports in PBB bridge mode. This value ranges from 256 to 16777214.
active - Sets the operational status of the MEP.

Mode:
Interface Configuration Mode (Physical)

Default:

Direction of MEP - outward
Operation status - inactive

Note: This command executes only if:

Domain is created at the same level as the MEP which is to be configured and Service is created within the domain.
If a Service (Maintenance Association) is to be associated with more than one Vlan-id, then its Primary VLAN ID is mapped to all the associated VLAN Ids with the command ethernet cfm associate vlan-id primary-vlan-id.
MA Mep List with MepId of the MEP is configured with the command mep crosscheck mpid. < Id > [vlan < vlan-id >]
For ISID, PIP should not be configured as an UP MEP, as this has no significance.

Example:

Your Product(config-if)# ethernet cfm mep domain domain1 mpid 20 vlan 10

ethernet cfm proactive slm

Command Objective:
This command start or stop the measurement of frame loss for SLM proactive

The no form of the command deletes the configured frame loss measurement for SLM proactive

Syntax:
ethernet cfm proactive slm {start | stop} {domain < string(43) > | level< integer(0-7) >} {service < string(45) > | vlan < vlan_vfi_id > } local-mpid < integer(1-8191) > {remote-mpid < integer(1-8191) > | remote-mac < ucast_mac >} test-id < integer(1-65535) > [test-name < string(33) >] [priority < integer(0-7) >] [interval {ten-ms | hundred-ms | one-sec | ten-sec}] [frame-pattern < string(9558) >] [drop-enable]

no ethernet cfm proactive slm domain < domain-name > service < service-name > local-mpid < local-mepid(1-8191) > remote-mpid < peer-mepid(1-8191) > test-id < value(1-65535) > [switch < string (32) >]

Parameter Description:

SLM - Configures the measurement of frame loss for SLM

start - Starts measurement of single ended frame loss
stop - Stops measurement of single ended frame loss

domain < string(43) > - Configures the SLM pro active for the specified domain name. This value is a string with maximum size as 43.
level - Configures the maintanenace level for the SLM. This value ranges from 0 to 7
service < string(45) > - Configures the service name for the SLM. This value is string of maximum size 45.
vlan < vlan_vfi_id > - Configures the frame loss measurement for the specified VLAN ID. This value ranges from 1 to 65535.

< vlan –id > - VLAN ID is a unique value that represents the specific VLAN. This value ranges from 1 to 4094.
< vfi-id > - VFI ID is a VLAN created in the system which contains Pseudo wires and Attachment Circuits as member ports . This creates a logical LAN for the VPLS service. This value ranges from 4096 to 65535.
Notes:
The VLAN ID 4095 is reserved and may be used to indicate a wildcard match for the VID in management operations or Filtering Database entries.
VFI IDs 4096 and 4097 are reserved identifiers used in MPLS PW.
The theoretical maximum for the maximum number of VFI is 65535 but the actual number of VFI supported is a sizing constant. Based on this, the maximum number of VFI ID accepted in the management interface is restricted. For example if 100 VFIs are supported, the maximum number of VFI supported will be restricted to maximum number of VLANs + 100. An error message is displayed for any value beyond this range.

local-mpid - Specifies the local MEP indentifier which is an unique identifier over a given maintenance association, identifying a specific maintenance association end Point. This value ranges from 1 to 8191
remote-mpid - Specifies the remote MEP indentifier which is an unique identifier over a given maintenance association, identifying a specific maintenance association end Point. This value ranges from 1 to 8191
remote-mac < peer-mac(aa:aa:aa:aa:aa:aa) >} - Specifies the remote MAC address of the peer MEP to which DM message(s) is sent.
test-id < test-id(1-65535) > - Configures the unique testid used in PDU for transmission of the session. This value ranges from 1 to 65535
test-name < string(0-33) > - Configures the unique test name used for the session. This value is the string of maximum size 33
Note: Test-name should be same as pmon name.
priority < value(0-7) > - Configures the priority level for the SLM. This value ranges from 0 to 7
interval - Configures the interval between the two successive SLM transmission to be used by the MEP.

ten-ms - Configures the interval as 10 Milliseconds
hundred-ms - Configures the interval as 100 Milliseconds
one-sec - Configures the interval as 1 Seconds
ten-sec - Configures the interval as 10 Seconds

frame-pattern - Configures the amount of data to be included in the Data TLV. This value is a string of maximum size 9558.
drop-enable - Configures whether the SLM packets are eligible to drop

Mode:
Privileged EXEC Mode

Default:

session - start
test type - single-ended
priority - 7
interval - 100 milliseconds

Example:

Your Product# ethernet cfm proactive slm start domain CUS5 service CUSMA5 local-mpid 2 remote-mpid 1 test-id 2 test-name SLM_TEST interval ten-ms drop-enable

Your Product# ethernet cfm proactive slm stop domain CUS5 service CUSMA5 local-mpid 2 remote-mpid 1 test-id 2 test-name SLM_TEST interval ten-ms drop-enable

ethernet cfm proactive frame delay

Command Objective:
This command start or stop the measurement of the proactive frame delay for a point-to point ETH connection. If start or stop option is not provided then by default it is considered as start.

The no form of the command deletes the configured measurement of the proactive frame delay for a point-to point ETH connection.

Syntax:
ethernet cfm proactive frame delay [{start | stop}] {domain <string(43)> | level <integer(0-7)> } [{service <string(45)>}] local-mpid <integer(1-8191)> {remote-mpid <integer(1-8191)> | mac <ucast_mac>} [interval {ten-ms | hundred-ms | one-sec | ten-sec}] {test-id < integer >}[test-name < string(43) >] [drop-enable]

no ethernet cfm proactive frame delay domain < domain-name > service < service-name > local-mpid <local-mepid(1-8191)> remote-mpid <peer-mepid(1-8191)> test-id <value(1-65535)> [switch <string (32)>]

Parameter Description:

delay - Configures the measurement of proactive frame delay

start - Starts measurement of proactive frame delay
stop - Stops measurement of proactive frame delay

domain < string(43) > - Configures the proactive frame delay for the specified domain name. This value is a string with maximum size as 43.
level< level-id(0-7) > - Configures the maintanenace level for the proactive delay. This value ranges from 0 to 7
service < string(45) > - Configures the service name for the proactive delay. This value is string of maximum size 45.
local-mpid < integer(1-8191) > - Specifies the local MEP indentifier which is an unique identifier over a given maintenance association, identifying a specific maintenance association end Point. This value ranges from 1 to 8191
remote-mpid < integer(1-8191 )> - Specifies the remote MEP indentifier which is an unique identifier over a given maintenance association, identifying a specific maintenance association end Point. This value ranges from 1 to 8191
mac < ucast_mac >} - Specifies the unicast MAC address of the peer MEP.
interval - Configures the interval between the two successive frame delay transmission.

ten-ms - Configures the interval as 10 Milliseconds
hundred-ms - Configures the interval as 100 Milliseconds
one-sec - Configures the interval as 1 Seconds
ten-sec - Configures the interval as 10 Seconds

test-id < integer > - Configures the unique test id of the proactive frame delay measurement. This value ranges from 1 to 4294967295
test-name < string(43) > - Configures the unique test name used for the proactive frame delay measurement. This value is the string of maximum size 43.

Note: Test-name should be same as pmon name
drop-enable - Configures whether the frame delay packets are eligible to drop.

Mode:
Privileged EXEC Mode

Default:

session – start
test type - single-ended
priority - 7
interval - 100 milliseconds

Example:

Your Product# ethernet cfm proactive frame delay start domain CUS5 service CUSMA5 local-mpid 2 remote-mpid 1 interval one-sec test-id 5 drop-enable

Your Product# ethernet cfm proactive frame delay stop domain CUS5 service CUSMA5 local-mpid 2 remote-mpid 1 interval one-sec test-id 5 drop-enable

ethernet cfm slm on-demand

Command Objective:
This command configures SLM on-demand.

Syntax:
ethernet cfm slm on-demand session {start | stop} test-type {single-ended | dual-ended} {domain <string(43)> | level<level-id(0-7)>} {service < service-name > | vlan <vlan_vfi_id> | vsi <vlan_vfi_id> } {mpid <peer-mepid(1-8191)> | mac <peer-mac(aa:aa:aa:aa:aa:aa)>} [priority <value(0-7)>] [interval <value(1-10)>] [frame-pattern <string(0-9558)>] [slm-messages-count <value(1-100)>] [drop-enable] [switch <context_name>]

Mode:
Global Configuration Mode

Example:

Your Product (config)# ethernet cfm slm on-demand session start

mep crosscheck mpid vlan

Command Objective:
This command statically defines an MEP (Maintenance End Point) in a Crosscheck List (MA-MEP List) within a Maintenance Association. MEP is defined in a list of MEPIDs of a service associated with a provided VLAN or service instance.

Vlan/ Service-Instance unaware MEP can be statically defined by not providing vlan/service-Instance.

The no form of the command deletes statically defined MEP from the Crosscheck List.

Syntax:
mep crosscheck mpid <id(1-8191)> [{service | vlan <vlan-id/vfi-id> | service-instance <integer(256-16777214)>}]

no mep crosscheck mpid <id(1-8191)> [{service | vlan <vlan-id/vfi-id> | service-instance <integer(256-16777214)>]

Parameter Description:

mpid < id(1-8191 )> - Specifies MEP indentifier which is an unique identifier over a given maintenance association, identifying a specific Maintenance End Point. This value ranges from 1 to 8191.
service < service-name > -Specifies the service name at which the maintenance domain is defined. This value is a string with maximum size as 43.
vlan < vlan-id/vfi-id > - Specifies the Primary VLAN ID of service (Maintenance Association) with which remote MEP must be associated. This value ranges from 1 to 65535.

< vlan –id > – VLAN ID is a unique value that represents the specific VLAN. This value ranges from 1 to 4094.
< vfi-id > – VFI ID is a VLAN created in the system which contains Pseudo wires and Attachment Circuits as member ports . This creates a logical LAN for the VPLS service. This value ranges from 4096 to 65535.
Notes:
The VLAN ID 4095 is reserved and may be used to indicate a wildcard match for the VID in management operations or Filtering Database entries.
VFI IDs 4096 and 4097 are reserved identifiers used in MPLS PW.
The theoretical maximum for the maximum number of VFI is 65535 but the actual number of VFI supported is a sizing constant. Based on this, the maximum number of VFI ID accepted in the management interface is restricted. For example if 100 VFIs are supported, the maximum number of VFI supported will be restricted to maximum number of VLANs + 100. An error message is displayed for any value beyond this range.

service-instance< integer(256-16777214) > - Specifies the service-instance in a Provider backbone bridge mode. This value ranges from 256 to 16777214.

Mode:
ECFM Configuration Mode

Note: This command executes only if maintenance association (service) is created for the domain.

Example:

Your Product(config-ether-ecfm)# mep crosscheck mpid 20 vlan 10

service

Command Objective:
This command configures the service (Maintenance Association) at the specified service-instance or VLAN.

The no form of this command deletes the service (Maintenance Association) within a Maintenance Domain. All the MEPs/ MaMepList related to the Maintenance Association must be removed, before removing that Maintenance Association.

Syntax:
service [format {primary-vid | char-string | unsigned-int16 | rfc2865-vpn-id | icc}] name <service_name> [icc <icc_code> umc <umc_code>] [{vlan < vlan <vlan-id/vfi-id>> | service-instance <service-instance(256-16777214)> ] [mip-creation-criteria {none | default | explicit | defer}] [sender-id-permission {none | chassis | manage | chassis-mgt-address | defer}]

no service [format {primary-vid | char-string | unsigned-int16 | rfc2865-vpn-id |icc}] name <service_name>

Parameter Description:

format - Configures the format of the service name. The options are:
name <service_name> Configures a service name for the Maintenance Association. The Service name is unique and duplicate names cannot be created. The value is a string with the maximum size as 43.
Notes:
The range and type of this value differs with the format selected.
Maintenance Association Name must be unique within a Maintenance Domain. The same Maintenance Association Name can be used, if the Maintenance Association exists in different domain.
icc<icc_code> - Configures the ITU Carrier Code (ICC) of the MIP node in ICC based MPLS-TP network. The ICC code consists of 1 to 6 characters with alphabetic or leading alphabetic and trailing numeric characters.
umc<umc_code> - Configures the ITU Carrier Code (ICC) of the MIP node in ICC based MPLS-TP network. The ICC code consists of 1 to 6 characters with alphabetic or leading alphabetic and trailing numeric characters.
vlan <vlan-id/vfi-id> - VLAN ID is a unique value that represents the specific VLAN. This value ranges from 1 to 4094.
service instance <service-instance(256-16777214)> - Configures the service instance with which the service is associated. This value ranges from 256 to 16777214.
mip-creation-Criteria - Indicates whether the management entity is able to create MHF for this Maintenance Association. The option are:
sender-id-permission - Sets the value to control the Sender ID TLV, to be transmitted in CFM PDUs by MHFs associated with this Maintenance Association. The options are:

Mode:
ECFM Configuration Mode

Defaults:
mip-creation-criteria – defer sender- id-permission - defer

Example:

Your Product(config-ether-ecfm)# service format char-string name ss mip-creation-criteria none sender-id-permission none

Your Product(config-ether-ecfm)# service format char-string name ss1 vlan 10

Notes:
The priority is specified when the scheduler is connecting to any of the priorities ( EF, AF, BE) of the next level strict-priority scheduler.

The weight is specified if the scheduler is connecting to a WeightedFairQueing of another scheduler.

set csf

Command Objective:
This command enables or disables the Ethernet-Client Signal Fail (ETH-CSF) feature on the MEP.

Syntax:
set csf {enable | disable} [{rx | tx | both}]

Parameter Description:

enable - Enables the ETH-CSF on the MEP
disable - Disables the ETH-CSF on the MEP
rx – Configures receiving capability for ETH-CSF
tx - Configures transmitting capability for ETH-CSF
both - Configures both receiving and transmitting capabilities for ETH-CSF

Mode:
Interface Configuration Mode

Example:

Your Product(config)# interface gigabitethernet 0/15

Your Product(config-if)# set csf enable

set csf tx interval

Command Objective:
This command configures the CSF transmission interval on the Mep.

Syntax:
set csf tx interval {one-sec | one-min}

Parameter Description:
one-sec – Configures the CSF tx interval as one-sec.
one-min – Configures the CSF tx interval as one-min.

Mode:
Global Configuration Mode

Example:

Your Product (config)# set csf tx interval

set propagation

Command Objective:
This command enables or disables the csf-propagation of the various CSF PDUs to be transmitted by the MEP.

Syntax:
set propagation {enable | disable}

Parameter Description:

enable – Enables the csf-propagation of the various CSF PDUs to be transmitted by the MEP.
disable – Disables the csf-propagation of the various CSF PDUs to be transmitted by the MEP.

Example:

Your Product (config)# set propagation enable

snmp-server enable traps ethernet cfm

Command Objective:
This command enables SNMP traps for CC (continuity check) events.

The no form of the command disables SNMP traps for CC events.

Syntax:
snmp-server enable traps ethernet cfm {[rdi-ccm][mac-status][mep-missing][errored-ccm][cross-connect][loss-of-continuity] [unexpected-period][unexpected-mep][mis-merge] [unexpected-level][local-link-failure][hardware-failure][software-failure] [frame-loss][frame-delay][bit-error][ais-condition][lck-condition][csf-condition] | all }

no snmp-server enable traps ethernet cfm {[rdi-ccm][mac-status][mep-missing][errored-ccm][cross-connect][loss-of-continuity] [unexpected-period][unexpected-mep][mis-merge] [unexpected-level][local-link-failure][hardware-failure][software-failure] [frame-loss][frame-delay][bit-error][ais-condition][lck-condition][csf-condition]} | all }

Parameter Description:

rdi-ccm - Enables traps for remote MEP defect condition. This trap is generated when at least one of the Remote MEP state machines is receiving valid CCMs from its remote MEP that have the RDI bit set
mac-status - Enables traps when some remote MEP reports that its Interface Status TLV is not isUp or all remote MEPs reports that a Port Status TLV contains value other than psUp.
mep-missing - Enables traps for MEP missing defect condition.
errored-ccm - Enables traps when MEP receives atleast one invalid CCM whose CCM interval is not timed out.
cross-connect - Enables traps when MEP receives atleast one CCM from another MAID or a lower MD level whose CCM interval is not timed out.
loss-of-continuity - Enables traps for loss of continuity defect condition.
unexpected-period - Enables traps for unexpected period defect condition.
unexpected-mep - Enables traps for unexpected MEP defect condition.
mis-merge - Enables traps for mismerge defect condition.
unexpected-level - Enables traps for MEG level defect condition.
local-link-failure - Enables traps for local link failure defect condition.
hardware-failure - Enables traps for internal hardware failure defect condition.
software-failure - Enables traps for internal software failure defect condition.
frame-loss - Enables traps when calculated frame loss value is greater than the configured frame loss threshold value.
frame-delay - Enables traps for when calculated frame delay value is greater than the configured frame delay threshold value.
bit-error - Enables traps for bit-error defect condition.
ais-condition - Enables traps for alarm indication defect condition.
lck-condition - Enables traps for locked defect condition.
csf-condition – Enables traps for client signal failure defect condition.
all - Enables traps for all defect conditions.

Mode:
Global Configuration Mode / Switch Configuration Mode

Default:
None of the traps are enabled

Note: This command executes only if ECFM is started in the switch.

Example:

Your Product(config-switch)# snmp-server enable traps ethernet cfm loss-of-continuity frame-delay

Display Commands

This section includes ECFM display commands.

show ethernet cfm domain

Command Objective:
This command displays the information about all the CFM Maintenance Domains configured on a device.

Syntax:
show ethernet cfm domain [name < domain-name > | level < integer(0-7) >] [brief] [switch < context_name >]

Parameter Description:

name < domain-name > - Displays the information about the specified maintenance domain. This value is a string with the maximum size as 43.
level< integer(0-7) > - Displays the information for the maintenance domain level at which the maintenance domain is defined. This value ranges from 0 to 7.
brief - Displays brief information about the CFM Maintenance Domains configured in the system.
switch < context_name > - Displays the information about the maintenance domains configured on a device for the specified context. This value is a string with maximum size as 32. This parameter is specific to multiple instance feature.

Mode:
User Exec Mode / Privileged Exec Mode

Note: This command executes only if ECFM is started on the switch.

Example:

Your Product# show ethernet cfm domain

Switch default
Domain Name : md
Index : 1
Level : 4
Vlan Priority : 7
Drop Eligibility : Disabled
MHF Creation Criteria : none
Sender Id Permission : none
Total Services : 1
Vlan Crosscheck ServiceID
10   Disabled   ma
Crosscheck:
MPID VLAN ISID      Type           Mep-Up
1    10   -         Local          Yes

2    10   -         Remote         No

Your Product# show ethernet cfm domain brief

Domain Name       Index     Level     Services  Archive(min)
md                  1         4         1         100

show ethernet cfm errors

Command Objective:
This command displays the Connectivity Fault Management (CFM) continuity check error conditions logged on a device, since it was last cleared.

Syntax:
show ethernet cfm errors [domain < domain-name > | level < level-id (0-7) >] [switch < context_name >]

Parameter Description:

domain< domain-name > - Displays the Connectivity Fault Management (CFM) continuity check error conditions for the specified Maintenance Domain. This value is a string with the maximum size as 43.
level< level-id (0-7) > - Displays the Connectivity Fault Management (CFM) continuity check error conditions for the specified maintenance domain level identifier. This value ranges from 0 to 7.
switch < context_name > - Displays the Connectivity Fault Management (CFM) continuity check error conditions for the specified context. This value represents unique name of the switch context. This value is a string with maximum size as 32. This parameter is specific to multiple instance.

Mode:
User Exec Mode / Privileged Exec Mode

Note: This command executes only if ECFM is started on the switch.

Example:

Your Product# show ethernet cfm errors

Switch default
Switch 1
MEP-ID :  1
Level VLAN RMEP-ID   Current defect type
----- ---- -------   -------------------
6     5    4         remote defect indication
6     5    2         loss of continuity
6     5    3         loss of continuity
Switch 2
MEP-ID :  4
Level VLAN RMEP-ID   Current defect type
----- ---- -------   -------------------
6     5    1         remote defect indication
6     5    2         loss of continuity
6     5    3         loss of continuity
6     5    5         loss of continuity

show ethernet cfm maintenance-point local

Command Objective:
This command displays the details of all the maintenance points (Maintenance End Point (MEP) or Maintenance Intermediate Point (MIP)) configured on a device.

Syntax:
show ethernet cfm maintenance-point local [mep | mip ] [interface [< interface-type > < interface-number >] | domain < domain-name > | level < level-id (0-7) > ] [switch < context_name >]

Parameter Description:

mep - Displays the details of the MEPS configured on a device.
mip - Displays the details of the MIPS configured on a device.
interface - Displays the type of throughput calculation
< interface-type > - Displays the MEP / MIP information for the specified type of interface. The interface can be:

fastethernet - A version of LAN standard architecture that supports data transfer up to 100 Megabits per second. This is officially referred to as 100BASE-T standard.
gigabitethernet - A version of LAN standard architecture that supports data transfer upto 1 Gigabit per second.
extreme-ethernet - A version of Ethernet that supports data transfer upto 10 Gigabits per second. This Ethernet supports only full duplex links.
i-lan / internal-lan - Internal LAN created on a bridge per IEEE 802.1ap.
port-channel - Logical interface that represents an aggregator which contains several ports aggregated together.

< interface-number > - Displays the MEP / MIP information for the specified interface identifier. This is a unique value that represents the specific interface. This value is a combination of slot number and port number separated by a slash, for interface type other than i-lan and port-channel. For example: 0/1 represents that the slot number is 0 and port number is 1. Only i-lan or port-channel ID is provided, for interface types i-lan and port-channel. For example: 1 represents i-lan and port-channel ID.
domain< domain-name > - Displays the MEP / MIP information for the specified Maintenance Domain. This value is a string with maximum size is 43.
level< level-id (0-7) > - Displays the MEP / MIP information for the specified Maintenance Level. This value ranges from 0 to 7.
switch< context_name > - Displays MEP / MIP information for the specified context. This value represents unique name of the switch context. This value is a string with maximum size as 32. This parameter is specific to multiple instance feature.

Mode:
User Exec Mode / Privileged EXEC Mode

Note: This command executes only if ECFM is started on the switch.

Example:

Your Product# show ethernet cfm maintenance-point local mep

Switch default
-------------------------------------------------------------

MPID  DomainName     Level  VLAN    Type  Port      CC-Status
      ServiceName    ISID    Dir   MAC              MP-Status
      lowestPriorityDefect

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

2     md             4      10       MEP   Gi0/1      Enabled
      ma             -      Down  00:02:02:03:04:01  Active
      mac-Rem-Err-Xcon-Defects

show ethernet cfm proactive frame delay buffer

Command Objective:
This command displays the configuration details of the rolling buffer maintained for Proactive Frame delay calculations measured at various time.

Syntax:
show ethernet cfm proactive frame delay buffer [type {one-way | two-way}] [{domain <string(43)> | level <integer(0-7)> }] [{service <string(45)>}] [{mpid <integer(1-8191)> }] [{test-id }] [switch <string (32)>]

Parameter Description:

type - Displays the type of throughput calculation

one-way - Displays the type as oneway throughput calculation
two-way - Displays the session twoway throughput calculation

domain < string(43) > - Displays the proactive frame delay for the specified domain name. This value is a string with maximum size as 43.
level< level-id(0-7) > - Displays the maintanenace level for the proactive delay. This value ranges from 0 to 7
service < string(45) > - Displays the service name for the proactive delay. This value is string of maximum size 45.
mpid < integer(1-8191 )> - Displays the MEP indentifier which is an unique identifier over a given maintenance association, identifying a specific maintenance association end Point. This value ranges from 1 to 8191.
test-id < integer > - Displays the unique test id of the proactive frame delay measurement. This value ranges from 1 to 4294967295
switch< string (32)> - Displays the proactive frame delay measurement for the specified context. This value represents unique name of the switch context. This value is a string with maximum size as 32. This parameter is specific to multiple instance

Mode:
Privileged EXEC Mode

Example:

Your Product# show eth cfm pro frame delay buffer

Switch default

Interface : Xl0/3
MEP-ID    : 2
RMEP-ID   : 1
Level     : 2
Test-ID   : 5

packets sent = 58, packets Rcvd = 58, packets UnAck = 0

Near End Statistics
-------------------
Frame Delay Variation min/max/avg = 0.000ms/0.000ms/0.000ms
Round Trip Statistics
---------------------
Frame Delay min/max/avg = 0.000ms/0.000ms/0.000ms
Frame Delay Variation min/max/avg = 0.000ms/0.000ms/0.000ms

show ethernet cfm service

Command Objective:
This command displays the information about all the CFM Maintenance Associations configured on a device.

Syntax:
show ethernet cfm service [name < service-name >] [{domain< domain-name > | level < level-id >}] [brief] [switch < context_name >]

Parameter Description:

name < service-name > - Displays the CFM Maintenance Association information configured on a device for the specified service. This value is a string with the maximum size as 43.
domain< domain-name > - Displays the CFM Maintenance Association information configured on a device for the specified domain. This value is a string with the maximum size as 43.
level < level-id > - Displays the CFM Maintenance Association information configured on a device for the specified level. This value ranges from 1 to 7.
brief - Displays a brief CFM Maintenance Association information configured on a device.
switch < context_name > - Displays the CFM Maintenance Association information configured on a device for the specified context. This value is a string with maximum size as 32. This parameter is specific to multiple instance feature.

Mode:
User Exec Mode / Privileged Exec Mode

Note: This command executes only if ECFM is started on the switch.

Example:

Your Product# show ethernet cfm service brief

ServiceName     Index   Primary-Vlan Level MEPs CCM Interval
me1

Your Product# show ethernet cfm service

Service Name : me1
Domain Name  : meg1
Index        : 1
Primary Vid  : 5
Level        : 6
MHF Creation Criteria : defer
Sender Id Permission  : defer
CC Role    : fault management
ICC Code   : me1
UMC Code   : meg1
Total MEPs : 2
Primary Vlan Associations :
None
Crosscheck status : Enabled
Crosscheck:
MPID Vlan Type           Mep-Up Mac Address
1    5    Local          Yes    00:01:02:03:04:03
2    5    Remote         No     Not learned

show ethernet cfm proactive slm

Command Objective:
This command displays the statistics of SLM ProActive.

Syntax:
show ethernet cfm proactive slm domain service local-mpid <local-mepid(1-8191)> [remote-mpid <peer-mepid(1-8191)>] [test-id <value(1-65535)>] [switch <string (32)>]

Parameter:

domain < domain-name > - Displays the configured domain name for the SLM proactive. This value is string of maximum size 43.
service < service-name > - Displays the configured service name for the SLM proactive. This value is string of maximum size 43.
local-mpid < local-mepid(1-8191) > - Displays the configured local mpid for the SLM proactive. This value ranges from 1 to 8191.
remote-mpid < peer-mepid(1-8191) > - Displays the configured remote mpid for the SLM proactive. This value ranges from 1 to 8191.
test-id < value(1-65535) > - Displays the configured testid used for SLM transmission. This value ranges from 1 to 65535.
switch< string (32) > - Displays the SLM Proactive statistics for the specified context. This value represents unique name of the switch context. This value is a string with maximum size as 32. This parameter is specific to multiple instance

Mode:
Privileged EXEC Mode

Example:

Your Product# show eth cfm pro slm domain CUS5 service CUSMA5 local-mpid 2

Switch default
Synthetic Loss Measurement : ProActive
----------------------------------------

Test Id : 2
Test Type : Dual-Ended
Dest Type :  Point-to-Point

Tx Packets                : 5829
Rx Packets                : 5829
Far-End Results:
Far-End Frame Loss Count  : 0
Far-End FLR               : 0

Near-End Results :
Near-End Frame Loss Count : 0
Near-End FLR              : 0

show ethernet cfm y1731-pm stats

Command Objective:
This command displays the statistical information of Y.1731 performance monitoring per MEP.

Syntax:
show ethernet cfm y1731-pm stats domain < domain-name > service < service-name > local-mpid < local-mepid(1-8191) >

Parameter Description:

domain < domain-name > - Displays the Y1731 PM stats information for the specified domain name. This value is a string with maximum size as 43.
level< level-id(0-7) > - Displays the maintanenace level for the proactive delay. This value ranges from 0 to 7
service < service-name > - Displays the service name for the the Y1731 PM stats information. This value is string of maximum size 45.
mpid < integer(1-8191) > - Displays the MEP indentifier which is an unique identifier over a given maintenance association, identifying a specific maintenance association end Point. This value ranges from 1 to 8191.

Example:

Your Product # show ethernet cfm y1731-pm stats domain CUS5 service CUSMA5 local-mpid 1

Switch default
 MEG Identifier        : 1
 ME Identifier         : 1
 MEP Identifier        : 2
 Transmitted SLM Count : 0
 Received SLM Count    : 13497
 Transmitted SLR Count : 13497
 Received SLR Count    : 0
 Transmitted DMM Count : 0
 Received DMM Count    : 9996
 Transmitted DMR Count : 9996
 Received DMR Count    : 0

Clear Commands

This section includes ECFM clear commands.

clear ethernet cfm proactive frame delay buffer

Command Objective:
This command clears the contents of the proactive frame delay buffer.

Syntax:
clear ethernet cfm proactive frame delay buffer [switch <context_name>]

Parameter Description:

switch < contxt_name > - Clears the contents of the proactive frame delay buffer for the specified context. This value represents unique name of the switch context. This value is a string with maximum size as 32. This parameter is specific to multiple instance

Mode:
Privileged EXEC Mode

Note: This command executes only if ECFM is started on the switch.

Example:

Your Product# clear ethernet cfm proactive frame delay buffer

© 2024 Cisco and/or its affiliates. All rights reserved.

For more information about trademarks, please visit: Cisco trademarks
For more information about legal terms, please visit: Cisco legal terms
For legal information about Accedian Skylight products, please visit: Accedian legal terms and tradmarks

Was this article helpful?

What's Next

Interface Commands

Table of contents

Enable Commands
Configuration Commands
Display Commands
Clear Commands