Table Of Contents
Carrier Ethernet Commands
ais
alarm
bridge-domain (global)
bridge-domain (service instance)
cfm encapsulation
cfm mep domain
channel-group (interface)
clear bridge-domain mac table
clear ethernet cfm ais
clear ethernet cfm errors
clear ethernet cfm maintenance-points remote
clear ethernet cfm statistics
clear ethernet cfm traceroute-cache
clear ethernet lmi statistics
clear ethernet oam statistics
clear ethernet service instance
clear lldp
continuity-check
cos (CFM)
disable (CFM-AIS-link)
errdisable recovery cause mac-security
ethernet cfm ais
ethernet cfm ais link-status
ethernet cfm ais link-status global
ethernet cfm alarm
ethernet cfm cc
ethernet cfm cc enable level evc
ethernet cfm cc enable level vlan
ethernet cfm domain level
ethernet cfm enable
ethernet cfm enable (interface)
ethernet cfm global
ethernet cfm ieee
ethernet cfm logging
ethernet cfm mep crosscheck
ethernet cfm mep crosscheck start-delay
ethernet cfm mep domain mpid
ethernet cfm mep level mpid vlan
ethernet cfm mip
ethernet cfm mip level
ethernet cfm traceroute cache
ethernet cfm traceroute cache hold-time
ethernet cfm traceroute cache size
ethernet evc
ethernet lmi
ethernet lmi ce-vlan map
ethernet lmi global
ethernet lmi interface
Carrier Ethernet Commands
ais
To enable the Alarm Indication Signal (AIS) function for a specific maintenance association, use the ais command in Ethernet connectivity fault management (CFM) service configuration mode. To disable AIS configuration, use the no form of this command.
ais [expiry-threshold threshold | level level-id | period seconds | suppress-alarms]
no ais [expiry-threshold | level | period | suppress-alarms]
Syntax Description
expiry-threshold
|
(Optional) Configures the expiry threshold.
|
threshold
|
(Optional) Integer from 2 to 255. The default is 3.5.
|
level
|
(Optional) Indicates a maintenance level where AIS frames for maintenance endpoints (MEPs) belonging to the service will be sent.
|
level-id
|
(Optional) Integer from 0 to 7 that identifies the maintenance level.
|
period
|
(Optional) Configures the AIS transmission period for all MEPS in the maintenance association.
|
seconds
|
(Optional) Integer value 1 or 60 that indicates the AIS transmission period in seconds. The default is 60.
|
suppress-alarms
|
(Optional) Configures alarm suppression.
|
Command Default
The AIS function is enabled on specific maintenance associations.
Command Modes
Ethernet CFM service configuration (config-ecfm-srv)
Command History
Release
|
Modification
|
15.0(1)XA
|
This command was introduced.
|
Usage Guidelines
Alarms are suppressed when a MEP goes into a RX AIS (receipt of an AIS frame) defect condition.
When you specify level with the ais command, you can transmit AIS messages to a higher maintenance association without configuring a maintenance intermediate point (MIP) for that maintenance association.
Output of the show running all command shows "ais expiry-threshold 3.5" when the default expiry threshold is configured, "ais period 60" when the default transmission period is configured, and "no ais suppress-alarms" when the default value for the suppress-alarms option is configured.
Examples
The following example shows how to enable the AIS function at level 5 with a transmission period of one second:
Router(config)# ethernet cfm domain operatorA level 5
Router(config-ecfm)# service vlan-id 10 port
Router(config-ecfm-srv)# ais period 1
Router(config-ecfm-srv)# ais level 5
Related Commands
Command
|
Description
|
show running all
|
Shows the running configuration with default values.
|
alarm
To configure an alarm when fault alarms are enabled, use the alarm command in Ethernet connectivity fault management (CFM) interface configuration mode. To remove the configuration, use the no form of this command.
alarm {delay mseconds | notification {all | error-xcon | mac-remote-error-xcon | none |
remote-error-xcon | xcon} | reset mseconds}
no alarm {delay | notification {all | error-xcon | mac-remote-error-xcon | none |
remote-error-xcon | xcon} | reset}
Syntax Description
Syntax Description
delay
|
Sets a delay time value during which one or more defects must be present before a fault alarm is issued.
|
mseconds
|
Integer from 2500 to 10000 that specifies the number of milliseconds for either a delay or a reset of an alarm.
The default is 2500 for the delay option. The default is 10000 for the reset option.
|
notification
|
Sets the defects that are to be reported if fault alarms are enabled.
|
all
|
Reports all defects: DefRDI, DefMACStatus, DefRemote, DefError, and DefXcon.
|
error-xcon
|
Reports only DefError and DefXcon defects.
|
mac-remote-error-xcon
|
Reports only DefMACStatus, DefRemote, DefError, and DefXcon (default) defects. This option is the default.
|
none
|
No defects are reported.
|
remote-error-xcon
|
Reports only DefRemote, DefError, and DefXcon defects.
|
xcon
|
Reports only DefXcon defects.
|
reset
|
Sets a reset time value that, after a fault alarm, no defects must be present before another fault alarm is enabled.
|
Command Default
Alarms are disabled.
Command Modes
Ethernet CFM interface configuration (config-if-ecfm-mep)
Command History
Release
|
Modification
|
12.2(33)SXI2
|
This command was introduced.
|
Usage Guidelines
This command overrides the global ethernet cfm alarm command.
If a higher priority defect occurs after a lower priority defect has triggered an alarm but before the alarm has reset, immediately issue another fault alarm for the higher priority defect.
Output of the show running all command displays "alarm delay 2500" when the default value for the delay option is configured, "alarm mac-remote-error-xcon" when the default value for the notification option is configured, and "alarm reset 10000" when the default value for the reset option is configured.
Examples
The following example shows how to set up notifications for all defects:
Router(config)# ethernet cfm domain test level 5
Router(config-ecfm)# service vlan-id 17 vlan 17
Router(config-ecfm-srv)# exit
Router(config-ecfm)# exit
Router(config-if)# ethernet cfm mep domain test mpid 5 vlan 17
Router(config-if-ecfm-mep)# alarm notification all
Router(config-if-ecfm-mep)#
The following example shows how to set the time during which one or more defects must be present
before a fault alarm is issued to 7000 milliseconds:
Router(config)# ethernet cfm domain test level 5
Router(config-ecfm)# service vlan-id 17 vlan 17
Router(config-ecfm-srv)# exit
Router(config-ecfm)# exit
Router(config-if)# ethernet cfm mep domain test mpid 5 vlan 17
Router(config-if-ecfm-mep)# alarm delay 7000
Related Commands
Command
|
Description
|
ethernet cfm alarm
|
Configures an alarm for Ethernet CFM.
|
show running all
|
Shows the running configuration with default values.
|
bridge-domain (global)
To configure components on a bridge domain and to enter bridge-domain configuration mode, use the bridge-domain command in global configuration mode. To remove the configured components from the bridge domain and to return the components to the bridge-domain default state, use the no form of this command.
bridge-domain bridge-id
no bridge-domain bridge-id
Syntax Description
bridge-id
|
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.
|
Command Default
No components are configured on the bridge domain.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
Usage Guidelines
When the bridge-domain command is executed, the command mode changes from global configuration mode (config) to bridge-domain configuration mode (config-bdomain).
In bridge-domain configuration mode, components can be configured on the bridge domain; for example, the MAC address limiting security component.
Note
The bridge-domain (service instance) command binds a service instance to a bridge-domain instance.
Examples
The following example shows how to configure a MAC address limit of 10 on bridge domain 100 and place the CLI in bridge-domain configuration mode:
Router# configure terminal
Router(config)# bridge-domain 100
Router(config-bdomain)# mac limit maximum addresses 10
Related Commands
Command
|
Description
|
bridge-domain (service instance)
|
Binds a service instance to a bridge domain.
|
mac limit maximum addresses
|
Specifies the MAC address limit on a bridge domain.
|
bridge-domain (service instance)
To bind a service instance to a bridge domain instance, use the bridge-domain command in service instance configuration mode. To unbind a service instance from a bridge domain instance, use the no form of this command.
bridge-domain bridge-id [split-horizon [group group-id]]
no bridge-domain bridge-id [split-horizon [group group-id]]
Syntax Description
bridge-id
|
Identifier for the bridge domain instance. Integer in the range 1 to Platform-Specific Upper Limit, where Platform-Specific Upper Limit is the maximum allowed by the platform.
|
split-horizon
|
(Optional) Configures a port or service instance as a member of a split-horizon group.
|
group
|
(Optional) Defines the split-horizon group.
|
group-id
|
(Optional) An identifier for the split-horizon group. Range is 1 to 65533.
|
Command Default
The service instance is not bound to a bridge domain instance.
Command Modes
Service instance configuration (config-if-svc)
Command History
Release
|
Modification
|
12.2(33)SRB
|
This command was introduced.
|
12.2(33)SRD
|
The split-horizon keyword was added.
|
Usage Guidelines
Use the bridge-domain (service instance) command to bind a service instance to a bridge domain.
Note
The bridge-domain (config) command allows a user to configure components on a bridge domain. For example, the MAC Address Limiting security component can be configured on a bridge domain using this command.
Examples
The following example shows how to bind a bridge domain to a service instance:
Router# configure terminal
Router(config)# interface gigabitethernet 2/0/0
Router(config-if)# service instance 100 ethernet
Router(config-if-srv)# encapsulation dot1q 100
Router(config-if-srv)# bridge-domain 200
Related Commands
Command
|
Description
|
bridge-domain (config)
|
Enables the user to configure components on a bridge domain.
|
ethernet service instance
|
Configures an Ethernet service instance on an interface and places the CLI in service instance configuration mode.
|
cfm encapsulation
To configure connectivity fault management (CFM) Ethernet frame encapsulation, use the cfm encapsulation command in service instance configuration mode. To remove the encapsulation, use the no form of this command.
cfm encapsulation {dot1ad vlan-id | dot1q vlan-id} [cos cos-value] [dot1q vlan-id | second-dot1q
vlan-id] [cos cos-value]
no cfm encapsulation {dot1ad vlan-id | dot1q vlan-id} [cos cos-value] [dot1q vlan-id |
second-dot1q vlan-id] [cos cos-value]
Syntax Description
dot1ad
|
Indicates the 802.1ad provider bridges encapsulation type.
|
vlan-id
|
Integer from 1 to 4094 that specifies the VLAN on which to send CFM frames out.
|
dot1q
|
(Optional) Supports the IEEE 802.1q standard for encapsulation of traffic and specifies the outer dot1q encapsulation tag.
|
cos
|
(Optional) Indicates the class-of-service (CoS) for CFM packets.
|
cos-value
|
(Optional) Integer from 0 to 7 that specifies the CoS.
|
second-dot1q
|
(Optional) Specifies the inner dot1q encapsulation tag. Valid option only when you first select the outer dot1q encapsulation tag. When the dot1ad encapsulation type is selected first, dot1q is a valid option.
|
Command Default
CFM Ethernet frame encapsulation is not configured.
Command Modes
Service instance configuration (config-if-srv)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
Usage Guidelines
To use the cfm encapsulation command, you must first configure a bridge domain in Ethernet service configuration mode by using the bridge-domain command.
When a range of VLANs is configured under the Ethernet flow point, the cfm encapsulation command configures the VLAN ID on which to send locally sourced CFM frames. The VLAN ID specified must be within the range configured in the encapsulation command.
The cfm encapsulation command does not support untagged service instances.
Examples
The following example shows how to configure the cfm encapsulation command:
ethernet cfm domain CUSTOMER level 7 direction outward
service customer_100 evc evc_100
ethernet cfm domain MIP level 7
ethernet cfm domain PROVIDER level 4
service provider_100 evc evc_100
mep crosscheck mpid 200 evc evc_100 mac aabb.cc00.0310
service instance 100 ethernet evc_100
cfm encapsulation dot1q 1 cos 2 second-dot1q 3 cos 4
Related Commands
Command
|
Description
|
bridge-domain
|
Binds the service instance to a bridge domain instance.
|
service instance ethernet
|
Configures an Ethernet service instance on an interface and places the CLI in service instance configuration mode.
|
cfm mep domain
To configure a maintenance endpoint (MEP) for a domain, use the cfm mep domain command in service instance configuration mode. To remove the MEP, use the no form of this command.
cfm mep domain domain-name [inward | outward] mpid mpid-value [cos cos-value]
no cfm mep domain domain-name [inward | outward] mpid mpid-value
Syntax Description
domain-name
|
String from 1 to 154 characters that identifies the domain name.
|
inward
|
(Optional) Indicates inward direction of connectivity fault management (CFM) packets.
|
outward
|
(Optional) Indicates outward direction of CFM packets.
|
mpid
|
Indicates the maintenance point ID (MPID).
|
mpid-value
|
Integer from 1 to 8191 that identifies the MPID.
|
cos
|
(Optional) Indicates the class-of-service (CoS) for CFM packets.
|
cos-value
|
(Optional) Integer from 0 to 7 that specifies the CoS.
|
Command Default
The direction of CFM packets is inward.
Command Modes
Service instance configuration (config-if-srv)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
Usage Guidelines
The cfm mep domain command defines an Ethernet flow point (EFP) as a MEP. To use the cfm mep domain command, you must first configure a bridge domain in service instance configuration mode by issuing the bridge-domain command.
Examples
The following example shows how to configure the cfm mep domain command:
ethernet cfm domain CUSTOMER level 7 direction outward
service customer_100 evc evc_100
ethernet cfm domain MIP level 7
ethernet cfm domain PROVIDER level 4
service provider_100 evc evc_100
mep crosscheck mpid 200 evc evc_100 mac aabb.cc00.0310
service instance 100 ethernet evc_100
cfm mep domain CUSTOMER outward mpid 1001
Related Commands
Command
|
Description
|
bridge-domain
|
Binds the service instance to a bridge domain instance.
|
service instance ethernet
|
Configures an Ethernet service instance on an interface and places the CLI in service instance configuration mode.
|
channel-group (interface)
To assign and configure an EtherChannel interface to an EtherChannel group, use the channel-group command in interface configuration mode. To remove the channel-group configuration from the interface, use the no form of this command.
channel-group channel-group-number mode {active | on | passive}
no channel-group channel-group-number
Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
channel-group channel-group-number mode on
no channel-group channel-group-number
Cisco ASR 1000 Series Routers
channel-group channel-group-number mode {active | passive}
no channel-group
Cisco Catalyst Switches
channel-group channel-group-number mode {active | on | auto [non-silent] | desirable
[non-silent] | passive}
no channel-group channel-group-number
Syntax Description
channel-group-number
|
Integer that identifies the channel-group. Valid values are from 1 to 256; the maximum number of integers that can be used is 64.
• For Fast EtherChannel groups, the number is an integer from 1 to 4. This number is the one previously assigned to the port-channel interface.
• On the Cisco ASR 1000 series router, valid values are from 1 to 64.
|
mode
|
Specifies the EtherChannel mode of the interface.
|
active
|
Enables Link Aggregation Control Protocol (LACP) unconditionally.
|
on
|
Enables EtherChannel only.
|
auto
|
Places a port into a passive negotiating state in which the port responds to Port Aggregation Protocol (PAgP) packets that it receives but does not initiate PAgP packet negotiation.
|
non-silent
|
(Optional) Used with the auto or desirable mode when traffic is expected from the other device.
|
desirable
|
Places a port into an active negotiating state in which the port initiates negotiations with other ports by sending PAgP packets.
|
passive
|
Enables LACP only when an LACP device is detected. This is the default state.
|
Command Default
No channel groups are assigned.
Command Modes
Interface configuration (config-if)
Command History
Release
|
Modification
|
11.1CA
|
This command was introduced.
|
12.0(7)XE
|
Support for this command was implemented on Cisco Catalyst 6000 series switches.
|
12.1(3a)E3
|
The number of valid values for the number argument was changed; see the "Usage Guidelines" section for valid values.
|
12.2(2)XT
|
This command was implemented on the Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series routers.
|
12.2(8)T
|
Support for this command was implemented on the Cisco 2600 series, the Cisco 3600 series, and the Cisco 3700 series routers and integrated into Cisco IOS Release 12.2(8)T.
|
12.2(14)SX
|
Support for this command was implemented on the Supervisor Engine 720.
|
12.2(17d)SXB
|
Support for this command on the Supervisor Engine 2 was integrated into Cisco IOS Release 12.2(17d)SXB.
|
12.2(18)SXE
|
This command was changed to support advanced QinQ translation on QinQ link bundles using GE-WAN interfaces on an OSM-2+4GE-WAN+ OSM on Cisco 7600 series routers.
|
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.
|
Usage Guidelines
OSMs are not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 32.
IP Address for the Physical Interface
You do not have to disable the IP address that is assigned to a physical interface that is part of a channel group, but Cisco highly recommends doing so.
Layer 2 and Layer 3 Port Channels
You can create both Layer 2 and Layer 3 port channels by entering the interface port-channel command or, when the channel-group gets its first physical interface assignment. The port channels are not created at run time, nor are they created dynamically.
You do not have to create a port-channel interface before assigning a physical interface to a channel group. A port-channel interface is automatically created when the channel group gets its first physical interface, if it is not already created.
Propagation of Configuration and Attribute Changes
Any configuration or attribute changes you make to the port-channel interface are propagated to all interfaces within the same channel group as the port channel. (for example, configuration changes are also propagated to the physical interfaces that are not part of the port-channel, but are part of the channel group.)
The on Keyword
When you use the on keyword, a usable EtherChannel exists only when a port group in on mode is connected to another port group in the on mode.
Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
You do not have to create a port-channel interface before assigning a physical interface to a channel group. A port-channel interface is created automatically when the channel group gets its first physical interface, if it is not already created.
Cisco ASR 1000 Series Routers
The Cisco ASR 1000 series router has the following prerequisites and restriction:
•
A port-channel must be created before member links are assigned to it.
•
IP addresses must be disabled on member links before those links can be included in a port-channel.
•
Fast Ethernet interfaces are not supported.
Cisco Catalyst Switches
The number of valid values for number depends on the software release. For software releases prior to Cisco IOS Release 12.1(3a)E3, valid values are from 1 to 256; for Cisco IOS Release 12.1(3a)E3, 12.1(3a)E4, and 12.1(4)E1, valid values are from 1 to 64. Cisco IOS Release 12.1 E and later releases support a maximum of 64 values ranging from 1 to 256.
The channel-group number is global and is shared between all the channeling protocols. If a specific channel number is used for the PAgP-enabled interfaces of a channel group, that same channel number cannot be used for configuring a channel that has LACP-enabled interfaces or vice versa.
Entering the auto or desirable keyword enables PAgP on the specified interface; the command will be rejected if it is issued on an LACP-enabled interface.
The active and passive keywords are valid on PAgP-disabled interfaces only.
You can change the mode for an interface only if it is the only interface that is designated to the specified channel group.
The on keyword forces the bundling of the interface on the channel without any negotiation.
You can manually configure a switch with PAgP on one side and LACP on the other side in the on mode.
With the on mode, a usable EtherChannel exists only when a port group in on mode is connected to another port group in on mode.
If you enter the channel group command on an interface that is added to a channel with a different protocol than the protocol you are entering, the command is rejected.
If the interface belongs to a channel, the no form of this command is rejected.
All ports in the same channel group must use the same protocol; you cannot run two protocols on one channel group.
PAgP and LACP are not compatible; both ends of a channel must use the same protocol.
You can change the protocol at any time, but this change causes all existing EtherChannels to reset to the default channel mode for the new protocol.
Configure all ports in an EtherChannel to operate at the same speed and duplex mode (full duplex only for LACP mode).
All ports in a channel must be on the same DFC-equipped module. You cannot configure any of the ports to be on other modules.
On systems that are configured with nonfabric-enabled modules and fabric-enabled modules, you can bundle ports across all modules, but those bundles cannot include a DFC-equipped module port.
You do not have to create a port-channel interface before assigning a physical interface to a channel group. A port-channel interface is created automatically when the channel group gets its first physical interface, if it is not already created.
You do not have to disable the IP address that is assigned to a physical interface that is part of a channel group, but it is highly recommended.
You can create both Layer 2 and Layer 3 port channels by entering the interface port-channel command or when the channel group gets its first physical interface assignment. The port channels are not created at runtime or dynamically.
Any configuration or attribute changes that you make to the port-channel interface are propagated to all interfaces within the same channel group as the port channel (for example, configuration changes are also propagated to the physical interfaces that are not part of the port channel but are part of the channel group).
When configuring Layer 2 EtherChannels, you cannot put Layer 2 LAN ports into manually created port-channel logical interfaces.
Only the on mode is supported when using this command with GE-WAN ports on the OSM-2+4GE-WAN+ OSM to create QinQ link bundles for advanced QinQ translation. Also, you cannot use the channel-group command on GE-WAN interfaces if MPLS is configured. You must remove all IP, MPLS, and other Layer 3 configuration commands before using the channel-group command with GE-WAN interfaces.
Note
The GE-WAN interfaces on an OSM-2+4GE-WAN+ OSM behave slightly differently than other interfaces if you want to move the interface from one group to another. To move most other interfaces, you can enter the channel-group command again to delete the interface from the old group and move it to the new group. For GE-WAN ports, however, you must manually remove the interface from the group by entering the no channel-group command before assigning it to a new group.
Caution 
Do not enable Layer 3 addresses on the physical EtherChannel interfaces. Assigning bridge groups on the physical EtherChannel interfaces causes loops in your network.
For a complete list of guidelines, see the "Configuring EtherChannel" section of the Cisco 7600 Series Router Cisco IOS Software Configuration Guide.
Fast EtherChannel
Before you assign a Fast Ethernet interface to a Fast EtherChannel group, you must first create a port-channel interface. To create a port-channel interface, use the interface port-channel global configuration command.
If the Fast Ethernet interface has an IP address assigned, you must disable it before adding the Fast Ethernet interface to the Fast EtherChannel. To disable an existing IP address on the Fast Ethernet interface, use the no ip address command in interface configuration mode.
The Fast EtherChannel feature allows multiple Fast Ethernet point-to-point links to be bundled into one logical link to provide bidirectional bandwidth of up to 800 Mbps. Fast EtherChannel can be configured between Cisco 7500 series routers and Cisco 7000 series routers with the 7000 Series Route Switch Processor (RSP7000) and 7000 Series Chassis Interface (RSP7000CI) or between a Cisco 7500 series router or a Cisco 7000 series router with the RSP7000 and RSP700CI and a Cisco Catalyst 5000 switch.
A maximum of four Fast Ethernet interfaces can be added to a Fast EtherChannel group.
Caution 
The port-channel interface is the routed interface. Do not enable Layer 3 addresses on the physical
Fast Ethernet interfaces. Do not assign bridge groups on the physical Fast Ethernet interfaces
because it creates loops. Also, you must disable spanning tree.
To display information about the Fast EtherChannel, use the show interfaces port-channel EXEC command.
For more guidelines see the "Configuring EtherChannel" section of the Cisco 7600 Series Router Cisco IOS Software Configuration Guide and the "Configuring EtherChannel" section of the Catalyst 6500 Series Switch Cisco IOS Software Configuration Guide.
Examples
This example shows how to add EtherChannel interface 1/0 to the EtherChannel group that is specified by port-channel 1:
Router(config-if)# channel-group 1 mode on
The following example shows how to add interface Fast Ethernet 1/0 to the Fast EtherChannel group specified by port-channel 1:
Router(config)# interface port-channel 1
Router(config)# interface fastethernet 1/0
Router(config-if)# channel-group 1
Related Commands
Command
|
Description
|
interface
|
Creates a port-channel virtual interface and puts the CLI in interface configuration mode when the port-channel keyword is used.
|
ip address
|
Sets a primary or secondary IP address on an interface.
|
show etherchannel
|
Displays the EtherChannel information for a channel.
|
show interfaces port-channel
|
Displays traffic that is seen by a specific port channel.
|
clear bridge-domain mac table
To clear any learned addresses from a bridge domain, use the clear bridge-domain mac table command in privileged EXEC mode.
clear bridge-domain bridge-id mac table [address]
Syntax Description
bridge-id
|
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.
|
address
|
(Optional) Secure address in the specified MAC table.
Note If this option is not specified, all dynamically learned addresses are removed.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
Usage Guidelines
Use the clear bridge-domain mac table command to purge MAC addresses that have been dynamically learned by the bridge domain.
Examples
The following example shows how to clear all dynamically learned MAC addresses in the MAC table of bridge domain 12:
Router# clear bridge-domain 12 mac table
The following example shows how to clear a specific MAC address from the MAC table of bridge domain 12:
Router# clear bridge-domain 12 mac table 0001.0001.aaaa
Related Commands
Command
|
Description
|
show bridge-domain
|
Displays information about a bridge domain.
|
clear ethernet cfm ais
To clear a maintenance end point (MEP) or server maintenance end point (SMEP) out of the Alarm Indication Signal (AIS) defect condition, use the clear ethernet cfm ais command in privileged EXEC mode.
Ethernet Connectivity Fault Management (CFM) Cisco Proprietary Draft 1 (CFM D1)
clear ethernet cfm ais {domain domain-name mpid mpid-id {evc name | vlan vlan-id} |
link-status interface Ethernet number}
Ethernet CFM IEEE 802.1ag Standard (CFM IEEE)
clear ethernet cfm ais {domain domain-name mpid mpid-id vlan vlan-id |
link-status interface Ethernet number}
Syntax Description
domain
|
Indicates that a maintenance domain is specified.
|
domain-name
|
String of a maximum of 154 characters that identifies the domain.
|
mpid
|
Indicates that a maintenance point ID (MPID) is specified.
|
mpid-id
|
An integer in the range of 1 to 8191 that identifies the MPID.
|
evc
|
Indicates that an Ethernet virtual circuit (EVC) is specified.
|
name
|
String identifying the EVC name.
|
vlan
|
Indicates that a VLAN is specified.
|
vlan-id
|
An integer in the range 1 to 4094 that identifies the VLAN.
|
link-status
|
Indicates either a SMEP or a link up/link down condition.
|
interface
|
Indicates that an interface is specified.
|
Ethernet
|
Type of interface.
|
number
|
Integer from 0 to 15 that identifies the Ethernet interface.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
15.0(1)XA
|
This command was integrated into Cisco IOS Release 15.0(1)XA.
|
Usage Guidelines
If a MEP does not exit the AIS state when all errors are resolved, use the clear ethernet cfm ais command with the domain and mpid keywords to clear the AIS defect condition. If a SMEP does not exit the AIS state when all errors are resolved, use the clear ethernet cfm ais command with the link-status interface keywords to clear the AIS defect condition.
Examples
The following example shows how to clear a SMEP of an AIS defect condition:
Router# clear ethernet cfm ais link-status interface ethernet0/0
The following examples show how to clear a MEP of an AIS defect condition:
Router# clear ethernet cfm ais domain xxx mpid 100 vlan 11
Router# clear ethernet cfm ais domain xxx mpid 100 evc test
Related Commands
Command
|
Description
|
ethernet cfm ais
|
Enables AIS generation from a SMEP.
|
s
clear ethernet cfm errors
To clear continuity check error conditions logged on a device, use the clear ethernet cfm errors command in privileged EXEC mode.
Cisco pre-Standard Connectivity Fault Management Draft 1.0 (CFM D1)
clear ethernet cfm errors [domain domain-name | level level-id]
CFM IEEE 802.1ag Standard (CFM IEEE)
clear ethernet cfm errors [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
|
(Optional) Clears errors for a maintenance domain.
|
domain-name
|
(Optional) String of a maximum of 154 characters.
|
level
|
(Optional) Clears errors for a maintenance level.
|
level-id
|
(Optional) Integer in the range of 0 to 7 that identifies the maintenance level.
|
domain-id
|
(Optional) Clears errors by domain ID.
|
mac-address
|
(Optional) MAC address of the maintenance domain.
|
domain-number
|
(Optional) Integer in the range of 0 to 65535.
|
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
The error database is unchanged; existing entries remain in the database.
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 clear ethernet cfm errors command to purge error database entries that are not needed and when you want to work with a cleared database. Also, use this command with a specified domain if you want to clear errors for that domain.
In CFM IEEE, 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
The following example shows a clear ethernet cfm errors command for errors at maintenance level 3. No output is generated when this command is issued.
Router# clear ethernet cfm errors level 3
The following example shows how to clear errors for a DNS on VLAN 17. No output is generated when this command is issued.
Router# clear ethernet cfm errors domain-id dns Service10 service vlan-id 17
Related Commands
Command
|
Description
|
show ethernet cfm errors
|
Displays CFM continuity check error conditions logged on a device since it was last reset or since the log was last cleared.
|
clear ethernet cfm maintenance-points remote
To purge the contents of the continuity check database, use the clear ethernet cfm maintenance-points remote command in privileged EXEC mode.
Cisco pre-Standard Connectivity Fault Management Draft 1.0 (CFM D1)
clear ethernet cfm maintenance-points remote [domain domain-name | level level-id]
CFM IEEE 802.1ag Standard (CFM IEEE)
clear ethernet cfm maintenance-points remote [domain domain-name]
Syntax Description
domain
|
(Optional) Indicates that a maintenance domain is specified.
|
domain-name
|
(Optional) String of a maximum of 154 characters that identifies the domain.
|
level
|
(Optional) Indicates that a maintenance level is specified.
• This keyword is not available in CFM IEEE.
|
level-id
|
(Optional) Integer in the range of 0 to 7 that identifies the maintenance level.
• This argument is not available in CFM IEEE.
|
Command Default
The continuity check database is unchanged; existing entries remain in the database.
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 this command to clear the entire continuity check database or clear the database for a specific domain or level. When a domain is specified, only entries for that domain are purged. When a level is specified, entries for all domains at that level are purged.
If a maintenence domain is not specified, the entire continuity check database is cleared.
In CFM IEEE, the level keyword and level-id argument are not supported. Also, 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
The following example shows a clear ethernet cfm maintenance-points remote command. No output is generated when this command is issued.
Router# clear ethernet cfm maintenance-points remote
Related Commands
Command
|
Description
|
show ethernet cfm maintenance-points remote
|
Displays information about remote maintenance points in the continuity check database.
|
clear ethernet cfm statistics
To clear a maintenance endpoint (MEP) or server maintenance endpoint (SMEP) out of the Alarm Indication Signal (AIS) defect condition, use the clear ethernet cfm ais command in privileged EXEC mode.
clear ethernet cfm statistics [mpid mpid-id]
Syntax Description
mpid
|
Indicates that a maintenance point ID (MPID) is specified.
|
mpid-id
|
An integer in the range of 1 to 8191 that identifies the MPID.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SXI2
|
This command was introduced.
|
Usage Guidelines
If a MEP does not exit the AIS state when all errors are resolved, use the clear ethernet cfm ais command with the domain and mpid keywords to clear the AIS defect condition. If a SMEP does not exit the AIS state when all errors are resolved, use the clear ethernet cfm ais command with the link-status interface keywords to clear the AIS defect condition.
Examples
The following example shows how to clear connectivity fault management (CFM) statistics from a SMEP of an AIS defect condition:
Router# clear ethernet cfm statistics mpid 800
Related Commands
Command
|
Description
|
clear ethernet cfm ais
|
Clears a MEP or SMEP out of the AIS defect condition.
|
s
clear ethernet cfm traceroute-cache
To remove the contents of the traceroute cache, use the clear ethernet cfm traceroute-cache command in privileged EXEC mode.
clear 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 clear ethernet cfm traceroute-cache command to remove traceroute cache entries from previous traceroute operations issued on the device. This command also provides visibility into maintenance intermediate points and maintenance end points of a domain as they were recorded when the operation was performed.
Examples
The following example shows the clear ethernet cfm traceroute-cache command:
Router# clear ethernet cfm traceroute-cache
Related Commands
Command
|
Description
|
ethernet cfm traceroute cache
|
Enables caching of Ethernet CFM data learned through traceroute messages.
|
show ethernet cfm traceroute-cache
|
Displays the contents of the traceroute cache.
|
clear ethernet lmi statistics
To clear Ethernet local management interface (LMI) statistics counters for all interfaces or for a specific interface, use the clear ethernet lmi statistics command in privileged EXEC mode.
clear ethernet lmi statistics [interface type number]
Syntax Description
interface
|
(Optional) Specifies the interface on which to clear counters.
|
type
|
(Optional) 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
|
(Optional) Integer that identifies the interface.
|
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
This command resets counters and is useful when you want to monitor Ethernet LMI errors for a period of time. For example, to monitor errors for 1 hour, you would issue the clear ethernet lmi statistics command to reset the counter. At the end of the hour, you would issue the show ethernet lmi statistics command to display errors that occurred during that one-hour time period.
Examples
The following example shows how to clear Ethernet LMI statistics counters on all interfaces:
Router# clear ethernet lmi statistics
Clear "show ethernet lmi" statistics counters on all interfaces [confirm]
The following example shows how to clear Ethernet LMI statistics counters on the Gigabit Ethernet 1/0 interface:
Router# clear ethernet lmi statistics interface gigabitethernet 1/0
Clear "show ethernet lmi" statistics counters on this interface [confirm]
Related Commands
Command
|
Description
|
show ethernet lmi
|
Displays Ethernet LMI Ethernet virtual connections (EVCs) configured on a device.
|
show interface
|
Displays statistics for all interfaces configured on a device.
|
clear ethernet oam statistics
To reset Ethernet operations, maintenance, and administration (OAM) counters and event statistics on all interfaces or on a specific interface, use the clear ethernet oam statistics command in privileged EXEC mode.
clear 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
Use this command when you are debugging or testing and you want all statistics cleared. After this command is issued, the cleared statistics cannot be restored.
Examples
The following example shows how to clear counters and event statistics for all interfaces:
Router# clear ethernet oam statistics
Related Commands
Command
|
Description
|
show ethernet oam statistics
|
Displays detailed information about Ethernet OAM packets.
|
clear ethernet service instance
To clear Ethernet service instance attributes such as MAC addresses and statistics or to purge Ethernet service instance errors, use the clear ethernet service instance command in privileged EXEC mode.
clear ethernet service instance {id id interface type number
{errdisable | mac table [address] | stats} | interface type number stats}
Syntax Description
id
|
Indicates that a specific service instance is specified.
|
id
|
Identifies the service instance.
|
interface
|
Indicates that a specific interface is specified.
|
type
|
Type of interface.
|
number
|
Number of the interface.
|
errdisable
|
Indicates that a clear action for an error-disabled state is specified.
|
mac table
|
Indicates that a MAC table is specified.
|
address
|
Secure address in the specified MAC table.
|
stats
|
Indicates that service instance statistics are specified.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
Usage Guidelines
Use the clear ethernet service instance command to clear service instance attributes that are not needed and to purge service instance errors.
Examples
The following example shows how to clear an error-disabled state on service instance 100 on interface Gigabit Ethernet 1/1:
Router(#) clear ethernet service instance id 100 interface GigabitEthernet 1/1 errdisable
Related Commands
Command
|
Description
|
show ethernet service instance
|
Displays information about Ethernet service instances.
|
clear lldp
To reset either Link Layer Discovery Protocol (LLDP) traffic counters or the table that contains LLDP information about neighbors, use the clear lldp command in privileged EXEC mode.
clear lldp {counters | table}
Syntax Description
counters
|
Specifies that the traffic counters are cleared.
|
table
|
Specifies that the LLDP table is cleared.
|
Command Default
The LLDP traffic counters are not reset, and the table of LLDP information is not cleared.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SXH
|
This command was introduced.
|
Usage Guidelines
Use this command for informational purposes or to test a symptom of network malfunction such as packet loss.
Examples
The following example shows how to clear the LLDP counters and display LLDP traffic. The output from the show lldp traffic command shows that all the traffic counters have been reset to zero.
Router# clear lldp counters
Router# show lldp traffic
Total frames received in error: 0
Total frames discarded: 0
Total TLVs unrecognized: 0
The following example shows how to clear the LLDP table. The output of the show lldp neighbors command shows that all information has been deleted from the table.
Router# show lldp neighbors
(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
Related Commands
Command
|
Description
|
show lldp
|
Displays information about LLDP in the network.
|
continuity-check
To enable the transmission of continuity check messages (CCMs), use the continuity-check command in Ethernet connectivity fault management (CFM) service configuration mode. To disable message transmission, use the no form of this command.
continuity-check [interval time | loss-threshold threshold | static rmep]
no continuity-check [interval time | loss-threshold | static rmep]
Syntax Description
interval
|
(Optional) Configures the time period between message transmissions.
|
time
|
(Optional) Time period between message transmissions. Valid values are as follows:
• 100ms—100 milliseconds
• 10m—10 minutes
• 10ms—10 milliseconds
• 10s—10 seconds
• 1m—1 minute
• 1s—1 second
• 3.3ms—3.3 milliseconds
The values supported are platform dependent. For the Cisco Catalyst 6500 series switch, the values supported are 10m, 10s, and 1m.
|
loss-threshold
|
(Optional) Sets the number of CCMs that should be missed before declaring that a remote maintenance endpoint (MEP) is down.
|
threshold
|
(Optional) Integer from 2 to 255. The default is 3.
|
static
|
(Optional) Verifies that the MEP received in the CCM is valid.
|
rmep
|
(Optional) MEP defined using the mep mpid command.
|
Command Default
CCMs are not transmitted.
Command Modes
Ethernet CFM service configuration (config-ecfm-srv)
Command History
Release
|
Modification
|
12.2(33)SXI2
|
This command was introduced.
|
Usage Guidelines
The static MEP list configured using the mep mpid command is used to verify whether a MEP received in a CCM is valid. If the MEP in the received CCM is not configured in the MEP list, an error CCM received fault alarm is set.
Output of the show running all command displays "continuity-check interval 1s" when the default interval period is configured and "continuity-check loss-threshold 3" when the default loss threshold is configured.
Examples
The following example shows how to configure a loss threshold of 50 CCMs:
Router(config)# ethernet cfm domain operatorA level 5
Router(config-ecfm)# service vlan-id 10 port
Router(config-ecfm-srv)# continuity-check loss-threshold 50
Related Commands
Command
|
Description
|
mep mpid
|
Statically defines MEPs within a maintenance association.
|
show running all
|
Shows the running configuration with default values.
|
cos (CFM)
To set the class of service (CoS) for a maintenance endpoint (MEP) that will be sent in Ethernet connectivity fault management (CFM) messages, use the cos command in the Ethernet CFM interface configuration mode. To set the CoS to the highest priority allowed on the interface, use the no form of this command.
cos cos-value
no cos
Syntax Description
cos-value
|
Integer from 0 to 7 that identifies the CoS. The default is 0.
|
Command Default
If this command is not configured, the default CoS value is used.
Command Modes
Ethernet CFM interface configuration (config-if-ecfm-mep)
Command History
Release
|
Modification
|
12.2(33)SXI2
|
This command was introduced.
|
Usage Guidelines
This command is used to set the priority of messages.
CoS may not be supported on all platforms.
Examples
The following example shows how to set the CoS to 5:
Router(config)# ethernet cfm domain test level 5
Router(config-ecfm)# service vlan-id 17 vlan 17
Router(config-ecfm-srv)# exit
Router(config-ecfm)# exit
Router(config-if)# ethernet cfm mep domain test mpid 5 vlan 17
Router(config-if-ecfm-mep)# cos 5
Router(config-if-ecfm-mep)#
disable (CFM-AIS-link)
To disable the generation of Alarm Indication Signal (AIS) frames resulting from a link-status change (server maintenance endpoint [SMEP]), use the disable command in Ethernet connectivity fault management (CFM) SMEP AIS configuration mode (config-ais-link-cfm). To enable AIS frame generation, use the no form of this command.
disable
no disable
Syntax Description
This command has no arguments or keywords.
Command Default
AIS frames are generated.
Command Modes
CFM SMEP AIS configuration mode (config-ais-link-cfm)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
15.0(1)XA
|
This command was integrated into Cisco IOS Release 15.0(1)XA.
|
Usage Guidelines
When the default value is configured, "no disable" is displayed when the show running all command is issued.
Examples
The following example shows how to disable AIS frame generation after a link-status change:
Router(config)# ethernet cfm ais link-status global
Router(config-ais-link-cfm)# disable
Related Commands
Command
|
Description
|
show running all
|
Shows the running configuration with default values.
|
errdisable recovery cause mac-security
To enable automatic recovery of a service instance after a MAC security violation, use the errdisable recovery cause mac-security command in service instance configuration mode. To disable the automatic recovery mechanism, use the no form of this command.
errdisable recovery cause mac-security interval
no errdisable recovery cause mac-security interval
Syntax Description
interval
|
Time, in seconds, to recover from a MAC security violation. Range is 30 to 86400.
|
Command Default
Automatic recovery of a service instance is disabled.
Command Modes
Service instance configuration (config-if-srv)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
Usage Guidelines
A cause is the reason why the error-disabled state occurred. When a cause is detected on a service instance, the service instance is placed in the error-disabled state (an operational state that is similar to the shutdown state). When you enable automatic error recovery, the service instance is brought out of the error-disabled state and allowed to retry the operation after all the causes have timed out. If you do not enable automatic error recovery, the service instance stays in the error-disabled state until the shutdown and no shutdown commands are issued.
Alternatively, you can use the clear ethernet service instance command to bring the service instance out of the error-disabled state.
Examples
The following example shows how to enable the automatic recovery of service instance 200 after a MAC security violation and to specify a recovery time of 30 seconds.
Router# configure terminal
Router(config)# interface gigabitethernet 3/0/1
Router(config-if)# service instance 200 ethernet
Router(config-if-srv)# encapsulation dot1Q 200
Router(config-if-srv)# bridge-domain 100
Router(config-if-srv)# mac security
Router(config-if-srv)# errdisable recovery cause mac-security 30
Related Commands
Command
|
Description
|
clear ethernet service instance
|
Clears the Ethernet service instance error-disable state.
|
show ethernet service instance
|
Displays information about Ethernet service instances.
|
ethernet cfm ais
To configure Alarm Indication Signal (AIS) generation from a server maintenance end point (SMEP), use the ethernet cfm ais command in global configuration mode. To disable AIS generation from a SMEP, use the no form of this command.
ethernet cfm ais [domain domain-name {evc name | vlan vlan id}] | [link-status global]
no ethernet cfm ais [domain domain-name {evc name | vlan vlan id}] | [link-status global]
Syntax Description
domain
|
(Optional) Indicates that a maintenance domain is specified and places the command-line interface (CLI) in Ethernet CFM AIS MEP configuration mode to configure AIS-specific commands for a maintenance association.
In Ethernet CFM AIS MEP configuration mode, the following commands are available:
• default—Sets the command to its default
• disable—Disables AIS transmission
• exit—Exits the configuration mode
• expiry-threshold—Specifies the AIS expiry threshold
– threshold-value—Integer in the range of 2 to 225
• level—Sets a maintenance level to send AIS
– level-id— Integer in the range of 0 to 7 that identifies the maintenance level
• no—Negates a command or sets its default
• period—Sets the AIS transmission period
– seconds—Integer in the range of 1 to 60
• suppress-alarms—Suppresses alarms
|
domain-name
|
(Optional) String of a maximum of 154 characters that identifies the domain.
|
evc
|
(Optional) Indicates that an Ethernet virtual circuit (EVC) is specified.
|
name
|
(Optional) String identifying the EVC name.
|
vlan
|
(Optional) Indicates that a VLAN is specified.
|
vlan-id
|
(Optional) Integer in the range 1 to 4094 identifying the VLAN.
|
link-status
|
(Optional) Enables or disables AIS generation from a SMEP on an interface supporting link status and 802.3ah interworking.
|
global
|
Places the CLI in Ethernet CFM AIS MEP configuration mode to configure AIS specific commands for a SMEP with link status and 802.3ah interworking.
Ethernet CFM AIS SMEP configuration commands:
• default—Sets a command to its defaults
• disable—Disables AIS transmission
• exit—Exits the configuration mode
• level—Indicates a maintenance level
– level-id—Integer in the range of 0 to 7 that identifies the maintenance level
• no—Negates a command or sets its defaults
• period—Sets the AIS transmission period
– seconds—Integer in the range of 1 to 60
|
Command Default
AIS generation is enabled.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
Usage Guidelines
The ethernet cfm ais command allows you to configure, enable, or disable AIS generation from a MEP or SMEP. To change default values for AIS generation on a SMEP, use the link-status global keywords. To change default values for AIS generation on a MEP, use the domain keyword.
To change the default configuration, you must enter the relevant configuration mode and use the keywords and arguments shown in Table 8.
Table 8 ethernet cfm ais Configuration Options
Type
|
Description
|
default
|
Sets a command to its default.
|
disable
|
Disables AIS transmission.
|
exit
|
Exits from configuration mode.
|
expiry-threshold threshold-value
|
Configures the AIS specific expiry threshold parameter for the maintenance association. The threshold-value argument is an integer in the range of 2 to 225. The default expiry threshold is 3.5.
|
level level-id
|
Configures the maintenance level to send AIS frames transmitted for all MEPs under the maintenance association. The default level is the immediate maintenance association level.
|
period seconds
|
Configures the MEP-specific AIS transmission period interval for all MEPs under the MA. The default is 60.
|
suppress-alarms
|
When a MEP receives an AIS, connectivity fault management (CFM) trap generation is suppressed. To override this behavior, the no suppress-alarms command can be used to allow generation of CFM traps even if a MEP is receiving AIS messages.
|
Examples
The following example shows how to specify AIS generation on a domain named PROVIDER across all VLANs:
Router(config)# ethernet cfm ais domain PROVIDER vlan 1-4094
Router(config-ais-mep-cfm)# disable
Router(config-ais-mep-cfm)# period 60
Router(config-ais-mep-cfm)# level 5
Router(config-ais-mep-cfm)# expiry-threshold 30
Router(config-ais-mep-cfm)# no suppress-alarms
Router(config-ais-mep-cfm)# exit
The following example shows how to specify AIS generation on a domain named PROVIDER on EVC XX:
Router(config)# ethernet cfm ais domain PROVIDER evc XX
Router(config-ais-mep-cfm)# disable
Router(config-ais-mep-cfm)# period 1
Router(config-ais-mep-cfm)# level 7
Router(config-ais-mep-cfm)# expiry-threshold 25
Router(config-ais-mep-cfm)# no suppress-alarms
Router(config-ais-mep-cfm)# exit
The following example shows how to specify AIS configuration on a SMEP:
Router(config)# ethernet cfm ais link-status global
Router(config-ais-link-cfm)# disable
Router(config-ais-link-cfm)# period 1
Router(config-ais-link-cfm)# level 5
Router(config-ais-link-cfm)# exit
Related Commands
Command
|
Description
|
clear ethernet cfm ais
|
Clears a MEP or SMEP of the AIS defect condition.
|
ethernet cfm ais link-status
To enable Alarm Indication Signal (AIS) generation from a server maintenance endpoint (SMEP), use the ethernet cfm ais link-status command in interface configuration mode. To disable AIS generation, use the no form of this command.
ethernet cfm ais link-status [level level-id | period seconds]
no ethernet cfm ais link-status [level | period]
Syntax Description
level
|
(Optional) Indicates a maintenance domain level where the AIS will be sent.
|
level-id
|
(Optional) Integer from 0 to 7 that identifies the maintenance level.
|
period
|
(Optional) Configures the AIS transmission period generated by the SMEP on the interface.
|
seconds
|
(Optional) Integer value 1 or 60 that indicates the AIS transmission period in seconds. The default is 60.
|
Command Default
AIS frames are not generated.
Command Modes
Interface configuration (config-if)
Command History
Release
|
Modification
|
15.0(1)XA
|
This command was introduced.
|
Usage Guidelines
This command has precedence over the ethernet cfm ais link-status global command issued in global configuration mode.
Examples
The following example shows how to configure AIS generation with a transmission period of 60 seconds:
Router(config-if)# ethernet cfm ais link-status period 60
Related Commands
Command
|
Description
|
ethernet cfm ais link-status global
|
Globally enables AIS generation and places the CLI in CFM SMEP AIS configuration mode.
|
ethernet cfm ais link-status global
To globally enable Alarm Indication Signal (AIS) generation and place the command-line interface (CLI) in CFM SMEP AIS configuration mode (config-ais-link-cfm) to configure AIS commands for a server maintenance endpoint (SMEP), use the ethernet cfm ais link-status global command in global configuration mode. To remove the global AIS configuration, use the no form of this command.
ethernet cfm ais link-status global
no ethernet cfm ais link-status global
Syntax Description
This command has no arguments or keywords.
Command Default
AIS generation is enabled.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
15.0(1)XA
|
This command was integrated into Cisco IOS Release 15.0(1)XA.
|
Usage Guidelines
The ethernet cfm ais link-status global command changes configuration modes to allow you to configure AIS commands for a SMEP.
Examples
The following example shows how to configure AIS commands for a SMEP:
Router(config)# ethernet cfm ais link-status global
Router(config-ais-link-cfm)#
ethernet cfm alarm
To configure an alarm for Ethernet connectivity fault management (CFM), use the ethernet cfm alarm command in global configuration mode. To restore the command options' default values, use the no form of this command.
ethernet cfm alarm {delay mseconds | notification {all | error-xcon | mac-remote-error-xcon |
none | remote-error-xcon | xcon} | reset mseconds}
no ethernet cfm alarm {delay | notification {all | error-xcon | mac-remote-error-xcon | none |
remote-error-xcon | xcon} | reset}
Syntax Description
Syntax Description
delay
|
Sets a delay time value during which one or more defects must be present before a fault alarm is issued.
|
mseconds
|
Integer from 2500 to 10000 that specifies the number of milliseconds for either a delay or a reset of an alarm.
• The default is 2500 for the delay option. The default is 10000 for the reset option.
|
notification
|
Sets the defects that are to be reported if fault alarms are enabled. This configuration is global and can be overridden by the fault alarm configurations on a supported interface.
|
all
|
Reports all defects: DefRDI, DefMACStatus, DefRemote, DefError, and DefXcon.
|
error-xcon
|
Reports only DefError and DefXcon defects.
|
mac-remote-error-xcon
|
Reports only DefMACStatus, DefRemote, DefError, and DefXcon (default) defects. This option is the default.
|
none
|
No defects are reported.
|
remote-error-xcon
|
Reports only DefRemote, DefError, and DefXcon defects.
|
xcon
|
Reports only DefXcon defects.
|
reset
|
Sets a reset time value that, after a fault alarm, no defects must be present before another fault alarm is enabled.
|
Command Default
Ethernet CFM alarms are disabled.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
12.2(33)SXI2
|
This command was integrated into Cisco IOS Release 12.2(33)SXI2.
|
Usage Guidelines
If a higher priority defect occurs after a lower priority defect has triggered an alarm but before the alarm has reset, immediately issue another fault alarm for the higher priority defect.
Output of the show running all command displays "ethernet cfm alarm delay 2500" when the default value for the delay option is configured and "ethernet cfm alarm reset 10000" when the default value for the reset option is configured.
Examples
The following example shows how to set up notification for all defects:
Router(config)# ethernet cfm alarm notification all
The following example shows how to set the time during which one or more defects must be present
before a fault alarm is issued to 5000 milliseconds:
Router(config)# ethernet cfm alarm delay 5000
Related Commands
Command
|
Description
|
show running all
|
Shows the running configuration with default values.
|
ethernet cfm cc
To set parameters for continuity check messages (CCMs), use the ethernet cfm cc command in global configuration mode. To reset parameters to their default values, use the no form of this command.
ethernet cfm cc level {any | level-id | level-id-level-id | [,level-id-level-id]} {evc evc-name | vlan
{vlan-id | any | vlan-id-vlan-id | [,vlan-id-vlan-id]}} [interval seconds] [loss-threshold
num-msgs]
no ethernet cfm cc level {any | level-id | level-id-level-id | [,level-id-level-id]} {evc evc-name | vlan
{vlan-id | any | vlan-id-vlan-id | [,vlan-id-vlan-id]}} [interval seconds] [loss-threshold
num-msgs]
Syntax Description
level
|
Indicates a maintenance level for the configuration.
|
any
|
Indicates that all levels are to be configured.
|
level-id
|
Integer from 0 to 7 that identifies a maintenance level.
|
level-id-level-id
|
Integers from 0 to 7 that define a range of levels to be configured. The hyphen is required to separate starting and ending values that define the range.
|
,level-id-level-id
|
(Optional) Integers from 0 to 7 that define a list of ranges to be configured. The comma must be entered to separate ranges. The hyphen is required to separate starting and ending values that are used to define each range of levels to be configured.
|
evc
|
Indicates an Ethernet virtual circuit (EVC) is configured.
|
evc-name
|
String that identifies the EVC.
|
vlan
|
Indicates a VLAN for configuration.
|
vlan-id
|
Integer from 1 to 4094 that identifies a VLAN to be configured.
|
any
|
Indicates that all VLANs are to be configured.
|
vlan-id-vlan-id
|
Integers from 1 to 4094 that define a range of VLANs to be configured. The hyphen is required to separate starting and ending values that are used to define the range.
|
,vlan-id-vlan-id
|
(Optional) Integers from 1 to 4094 that define a list of VLAN ranges to be configured. The comma must be entered to separate ranges. The hyphen is required to separate starting and ending values that are used to define each range of VLANs.
|
interval
|
(Optional) Specifies, in seconds, the time between CCM transmissions.
|
seconds
|
(Optional) Integer value in the range of 10 to 65535. The default is 30.
|
loss-threshold
|
(Optional) Indicates the maximum number of CCMs that can be missed before declaring that a maintenance endpoint (MEP) is down.
|
num-msgs
|
(Optional) Integer in the range of 2 to 255 that specifies the maximum number of CCMs that can be lost before a MEP is declared down. The default is 2.
|
Command Default
For all maintenance levels and VLANs configured on a device, the interval is 30 seconds and the loss-threshold is 2.
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)SRD
|
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.
|
Usage Guidelines
The ethernet cfm cc command is used to set parameters for generating and receiving CCMs in one of the following ways:
•
Globally (per device)
•
For a maintenance domain
•
For a particular customer service instance (CSI)
•
For a combination of maintenance domain and CSI
When the ethernet cfm cc command is issued, the system may perform optimizations by concatenating possible ranges, and the configuration may not go through nonvolatile generation (NVGEN) as it was originally entered.
If you configure the ethernet cfm cc command with the default values for interval and loss threshold, these parameters will not display after NVGEN. If you configure the command with at least one parameter not at the default value, all parameters are displayed.
An EVC is an association of two or more user network interfaces (UNIs).
Note
This command is not supported in the Connectivity Fault Management 802.1ag Standard (CFM IEEE).
Examples
The following example shows how to configure an Ethernet CFM level ID of 5 for all VLANs, with messages transmitted every 30 seconds and a remote MEP declared down after two messages are missed. Note that the interval and loss-threshold parameters are configured for the default values and do not display after NVGEN.
Router(config)# ethernet cfm cc level 5 vlan any interval 30 loss-threshold 2
(NVGEN)ethernet cfm cc level 5 vlan any
The following example shows how to configure an Ethernet CFM level ID of 5 for all VLANs, with messages transmitted every 1000 seconds and a remote MEP declared down after two messages (the default value) are missed:
Router(config)# ethernet cfm cc level 5 vlan any interval 1000 loss-threshold 2
(NVGEN)ethernet cfm cc level 5 vlan any interval 1000
The following example shows how to configure an Ethernet CFM level ID of 5 for all VLANs, with messages transmitted every 1000 seconds and a remote MEP declared down after 7 messages are missed (neither value is a default value):
Router(config)# ethernet cfm cc level 5 vlan any interval 1000 loss-threshold 7
(NVGEN)ethernet cfm cc level 5 vlan any interval 1000 loss-threshold 7
The following example shows how to configure Ethernet CFM for multiple levels for VLANs 100 to 200 with messages transmitted every 50 seconds and a remote MEP declared down after 5 messages are missed (neither value is a default value):
Router(config)# ethernet cfm cc level 1-5 vlan 100-200 interval 50 loss-threshold 5
Router(config)# no ethernet cfm cc level 2-3 vlan 50-150 interval 50 loss-threshold 5
(NVGEN)ethernet cfm cc level 2-3 vlan 151-200 interval 50 loss-threshold 5
ethernet cfm cc level 1,4-5 vlan 100-200 interval 50 loss-threshold 5
The following example shows how to configure Ethernet CFM level ID of 5 for EVC evc5, with messages transmitted every 50 seconds and a remote MEP declared down after 3 messages are missed (neither value is a default value):
Router(config)# ethernet cfm cc level 5 evc evc5 interval 50 loss-threshold 3
(NVGEN)ethernet cfm cc level 5 evc evc5 interval 50 loss-threshold 3
ethernet cfm cc enable level evc
To globally enable transmission of continuity check messages (CCMs), use the ethernet cfm cc enable level evc command in global configuration mode. To disable transmission of CCMs, use the no form of this command.
ethernet cfm cc enable level {any | level-id | ,level-id | level-id-level-id | ,level-id-level-id} evc
evc-name
no ethernet cfm cc enable level {any | level-id | ,level-id | level-id-level-id | ,level-id-level-id} evc
evc-name
Syntax Description
any
|
Enables CCMs for all levels.
|
level-id
|
Integer from 0 to 7 that identifies a maintenance level.
|
,level-id
|
Integers from 0 to 7, separated by commas, that list levels to be enabled.
|
level-id-level-id
|
Integers from 0 to 7 that define a range of levels to be enabled. The hyphen is required to separate starting and ending values that define the range.
|
,level-id-level-id
|
Integers from 0 to 7 that define a list of ranges to be enabled. The comma must be entered to separate ranges. The hyphen is required to separate starting and ending values that are used to define each range of levels to be enabled.
|
evc-name
|
String that identifies the Ethernet virtual circuit (EVC).
|
Command Default
No CCMs are transmitted.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
Usage Guidelines
Use the ethernet cfm cc enable level evc command to enable transmission of CCMs in one of the following ways:
•
Globally (per device)
•
For a particular level
•
For a particular EVC
•
For a combination of level and EVC
Examples
The following example shows how to configure the ethernet cfm cc enable level evc command for EVC evc5:
Router (config)# ethernet cfm cc enable level 5 evc evc5
How you enter the ethernet cfm cc enable level evc command and the format you see in the configuration may be different. For example, if you enter:
Router(config)# ethernet cfm cc enable level 1,2,3,4,5 evc evc1
The configuration shows the following:
ethernet cfm cc enable level 1-5 evc evc1
To shorten the length of the command, you also can enter it as shown in the following example:
Router(config)# ethernet cfm cc enable level 1-5 evc evc1
Related Commands
Command
|
Description
|
ethernet cfm cc enable level vlan
|
Enables transmission of CCMs.
|
ethernet cfm cc enable level vlan
Use the ethernet cfm cc enable level vlan command in global configuration mode to globally enable transmission of continuity check messages (CCMs). To disable transmission of CCMs, use the no form of this command.
ethernet cfm cc enable level {any | level-id | ,level-id | level-id-level-id | ,level-id-level-id}
vlan {any | vlan-id | ,vlan-id | vlan-id-vlan-id | ,vlan-id-vlan-id}
no ethernet cfm cc enable level {any | level-id | ,level-id | level-id-level-id | ,level-id-level-id}
vlan {any | vlan-id | ,vlan-id | vlan-id-vlan-id | ,vlan-id-vlan-id}
Syntax Description
Syntax DescriptionCommand Syntax]
any
|
Enables CCMs for all levels.
|
level-id
|
Integer from 0 to 7 that identifies a maintenance level.
|
,level-id
|
Integers from 0 to 7, separated by commas, that list levels to be enabled.
|
level-id-level-id
|
Integers from 0 to 7 that define a range of levels to be enabled. The hyphen is required to separate starting and ending values that define the range.
|
,level-id-level-id
|
Integers from 0 to 7 that define a list of ranges to be enabled. The comma must be entered to separate ranges. The hyphen is required to separate starting and ending values that are used to define each range of levels to be enabled.
|
any
|
Indicates all VLANs are to be configured.
|
vlan-id
|
Integer from 1 to 4094 that identifies a VLAN to be configured.
|
,vlan-id
|
Integers from 1 to 4094, separated by commas, that list VLANs to be configured.
|
vlan-id-vlan-id
|
Integers from 1 to 4094 that define a range of VLANs to be configured. The hyphen is required to separate starting and ending values that are used to define the range.
|
,vlan-id-vlan-id
|
Integers from 1 to 4094 that define a list of VLAN ranges to be configured. The comma must be entered to separate ranges. The hyphen is required to separate starting and ending values that are used to define each range of VLANs.
|
Command Default
No CCMs are transmitted.
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.
|
Usage Guidelines
Use the ethernet cfm cc enable level vlan command to enable transmission of CCMs in one of the following ways:
•
Globally (per device)
•
For a particular level
•
For a particular VLAN
•
For a combination of level and VLAN
How you enter the ethernet cfm cc enable level vlan command and the format you see in the configuration may be different. For example, if you enter:
Router(config)# ethernet cfm cc enable level 1,2,3,4,5 vlan 100,101,102,103,105
The configuration shows the following:
ethernet cfm cc enable level 1-5 vlan 100-103,105
To shorten the length of the command, you also can enter it this way.
Examples
The following examples show how this command functions:
1.
The command already configured is:
ethernet cfm cc enable level 1-5 vlan 100-200
2.
You configure this new command:
Router(config)# no ethernet cfm cc enable level 2-3 vlan 50-150
3.
The following commands are generated as a result of the command you have just configured. Note that these commands are different from the command you entered.
ethernet cfm cc enable level 1,4-5 vlan 100-200
ethernet cfm cc enable level 2-3 vlan 151-200
ethernet cfm domain level
To define a connectivity fault management (CFM) maintenance domain at a particular maintenance level and put the command-line interface (CLI) into Ethernet CFM configuration mode, use the ethernet cfm domain level command in global configuration mode. To remove the CFM domain at the specified level, use the no form of this command.
ethernet cfm domain domain-name level level-id [direction outward]
no ethernet cfm domain domain-name level level-id
Syntax Description
domain-name
|
String of a maximum of 154 characters that identifies the domain.
|
level-id
|
Integer from 0 to 7 that identifies the maintenance level.
|
direction outward
|
(Optional) Specifies the domain direction as outward (toward the wire). The default direction is inward.
Note The outward keyword is supported only in Cisco IOS Release 12.4(11)T and later releases. This keyword is not supported in Cisco IOS Release 12.2(33)SXH or 12.2(33)SXI2.
|
Command Default
No maintenance domains are assigned to maintenance levels if this command is not issued.
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.
The direction outward keywords were added.
|
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
When a router is in Ethernet CFM configuration mode, parameters specific to a maintenance domain can be set. Several domains, with different names, can be configured at the same maintenance level; however, a single domain cannot be associated with multiple levels.
In CFM IEEE, 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 this command places the CLI in Ethernet configuration mode, in CFM D1 the mode prompt is "config-ether-cfm" and in CFM IEEE the mode prompt is "config-ecfm."
Examples
The following example shows how to define an outward facing domain named domain1 at level 6 and that the CLI mode changes to Ethernet CFM configuration mode:
Router(config)# ethernet cfm domain domain1 level 6 direction outward
Router(config-ether-cfm)#
The following example shows how to define a domain named cust10 at level 5 and also shows the Ethernet CFM configuration mode prompt that is displayed in the CFM IEEE Standard implementation:
Router(config)# ethernet cfm domain cust10 level 5
Related Commands
Command
|
Description
|
show ethernet cfm domain
|
Displays information about maintenance points configured on a device.
|
show ethernet cfm maintenance-points local
|
Displays information about maintenance points configured on a device.
|
ethernet cfm enable
To enable connectivity fault management (CFM) processing globally on a device, use the ethernet cfm enable command in global configuration mode. To disable CFM processing globally on a device, use the no form of this command.
ethernet cfm enable
no ethernet cfm enable
Syntax Description
This command has no arguments or keywords.
Command Default
Ethernet CFM is disabled.
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.
|
Usage Guidelines
Ethernet CFM is disabled by default and must be enabled explicitly. When CFM is configured, hardware resources (for example, port-ASIC match-registers) are allocated for CFM.
Examples
The following example shows how to enable CFM processing globally on a device:
Router(config)# ethernet cfm enable
ethernet cfm enable (interface)
To enable connectivity fault management (CFM) processing on an interface, use the ethernet cfm enable command in interface configuration mode. To disable CFM processing on an interface, use the no form of this command.
ethernet cfm enable
no ethernet cfm enable
Syntax Description
This command has no arguments or keywords.
Command Default
Ethernet CFM is enabled.
Command Modes
Interface configuration (config-if)
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.
|
Usage Guidelines
Ethernet CFM is enabled by default on an interface and must be disabled explicitly. When CFM is disabled on an interface, hardware resources (for example, port-ASIC match-registers) are released for that interface.
This command is mutually exclusive of maintenance intermediate point (MIP) and maintenance end point (MEP) configuration commands. The interface must be enabled before any MEPs or MIPs can be configured. Similarly, disabling a port that has MIPs or MEPs configured is not allowed. The user must first unconfigure the maintenance points.
When CFM processing is disabled on an interface, all CFM frames that arrive at that interface are forwarded as normal data traffic, and are not processed by the CPU.
Examples
The following example shows how to disable and then enable CFM processing on an interface:
Router(config-if)# no ethernet cfm enable
Router(config-if)# ethernet cfm enable
ethernet cfm global
To enable Ethernet connectivity fault management (CFM) globally on a device, use the ethernet cfm global command in global configuration mode. To disable CFM globally on a device, use the no form of this command.
ethernet cfm global
no ethernet cfm global
Syntax Description
This command has no arguments or keywords.
Command Default
Ethernet CFM is disabled.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
12.2(33)SXI2
|
This command was introduced.
|
Usage Guidelines
Ethernet CFM is disabled by default and must be enabled explicitly. When CFM is configured, hardware resources (for example, port-ASIC match registers) are allocated for CFM.
This command is supported only in the Ethernet CFM IEEE 802.1ag Standard implementation.
Examples
The following example shows how to enable CFM globally on a device:
Router(config)# ethernet cfm global
ethernet cfm ieee
To enable the Ethernet Connectivity Fault Management 802.1ag Standard (CFM IEEE) version of CFM, use the ethernet cfm ieee command in global configuration mode. To disable the CFM IEEE version, use the no form of this command.
ethernet cfm ieee
no ethernet cfm ieee
Syntax Description
This command has no arguments or keywords.
Command Default
Ethernet CFM IEEE is disabled.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
12.2(33)SXI2
|
This command was introduced.
|
Usage Guidelines
An Ethernet CFM IEEE image can support both Cisco pre-Standard CFM Draft 1 (CFM D1) and CFM IEEE. An explicit command-line interface (CLI) command is required to ensure that CFM IEEE is running.
Examples
The following example shows how to enable Ethernet CFM IEEE:
Router(config)# ethernet cfm ieee
ethernet cfm logging
To enable Ethernet Connectivity Fault Management (CFM) syslog messages, use the ethernet cfm logging command in global configuration mode. To disable CFM syslog messages, use the no form of this command.
Cisco pre-Standard CFM Draft 1 (CFM D1)
ethernet cfm logging [ais | alarm {cisco | ieee}]
no ethernet cfm logging [ais | alarm {cisco | ieee}]
CFM IEEE 802.1ag Standard (CFM IEEE)
ethernet cfm logging [ais | alarm {cisco | ieee} | lck]
no ethernet cfm logging [ais | alarm {cisco | ieee} | lck]
Syntax Description
ais
|
(Optional) Enables syslog messages specific to the CFM Alarm Indication Signal (AIS) feature.
|
alarm
|
(Optional) Specifies an alarm.
|
cisco
|
(Optional) Enables alarm syslog messages for Cisco MIBs.
|
ieee
|
(Optional) Enables alarm syslog messages for IEEE MIBs for all VLAN services.
|
lck
|
(Optional) Enables syslog messages specific to the CFM Locked Signal function (LCK).
|
Command Default
CFM logging is not enabled.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
12.2(33)SRD
|
This command was introduced.
|
12.2(33)SXI2
|
This command was integrated into Cisco IOS Release 12.2(33)SXI2.
|
Examples
The following example shows how to enable all Ethernet CFM syslog messages:
Router(config)# ethernet cfm logging
The following example shows how to enable all alarm syslog messages for Cisco MIBs:
Router(config)# ethernet cfm logging alarm cisco
The following example shows how to enable syslog messages specific to the CFM AIS feature:
Router(config)# ethernet cfm logging ais
ethernet cfm mep crosscheck
To enable cross-checking between the list of configured remote maintenance endpoints (MEPs) of a domain and MEPs learned through continuity check messages (CCMs), use the ethernet cfm mep crosscheck command in privileged EXEC mode. To disable cross-checking, use the ethernet cfm mep crosscheck disable command.
Cisco pre-Standard Connectivity Fault Management Draft 1 (CFM D1)
ethernet cfm mep crosscheck {enable | disable} level {level-id | level-id-level-id
[,level-id-level-id]} {vlan {vlan-id | any | vlan-id-vlan-id [ ,vlan-id-vlan-id]} | evc evc-name}
CFM IEEE 802.1ag Standard (CFM IEEE)
ethernet cfm mep crosscheck {enable | disable} domain domain-name {port | vlan{vlan-id |
vlan-id-vlan-id | ,vlan-id-vlan-id}}
Syntax Description
Syntax DescriptionCommand Syntax]
enable
|
Indicates that cross-checking will occur.
|
disable
|
Indicates that cross-checking will not occur.
|
level
|
Indicates a maintenance level for configuration.
|
level-id
|
Integer from 0 to 7 that identifies the maintenance level.
|
level-id-level-id
|
Integer values from 0 to 7. The hyphen is required to separate starting and ending level ID values that are used to define the range of IDs.
|
,level-id-level-id
|
(Optional) Integer values from 0 to 7. The comma must be entered to separate level ID ranges. The hyphen is required to separate starting and ending level ID values that are used to define each range of IDs.
|
vlan
|
Indicates a VLAN for cross-checking.
|
vlan-id
|
Integer from 1 to 4094 that identifies the VLAN.
|
any
|
Indicates all VLANs are to be configured.
• This option is supported only in CFM D1.
|
vlan-id-vlan-id
|
Integer values from 1 to 4094. The hyphen is required to separate starting and ending VLAN ID values that are used to define a range of IDs.
|
,vlan-id-vlan-id
|
(Optional) Integer values from 1 to 4094. The comma must be entered to separate VLAN ID ranges. The hyphen is required to separate starting and ending VLAN ID values that are used to define each range of IDs.
|
evc
|
Identifies the Ethernet virtual circuit (EVC).
• This option is supported only in CFM D1.
|
evc-name
|
String that identifies the EVC.
• This option is supported only in CFM D1.
|
domain
|
Specifies a maintenance domain.
|
domain-name
|
String of a maximum of 154 characters that identifies the maintenance domain.
|
port
|
Specifies a DOWN service direction with no VLAN associations (untagged).
|
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 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)SXI2
|
This command was integrated into Cisco IOS Release 12.2(33)SXI2.
|
Usage Guidelines
Before you issue this command, you must configure a static list of MEPs using the mep crosscheck mpid vlan command. To enable cross-checking after a device has booted up, you must issue the ethernet cfm mep crosscheck enable command.
A no form of this command does not exist. Cross-checking is disabled when you issue the command with the disable keyword.
In CFM IEEE, 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.
To view the results of a cross-check operation, use the show ethernet cfm maintenance-points remote crosscheck command. To view errors in the cross-check operation, use the show ethernet cfm errors command. Both commands are used in privileged EXEC mode.
Traps are generated after a cross-check operation is completed if cross-check traps are already enabled and, if as the result of the cross-check operation, a condition warrants a trap to be sent.
An EVC is an association of two or more user network interfaces (UNIs). EVCs are not supported in Cisco IOS Release 12.2(33)SXI2.
Examples
The following example shows how to enable an Ethernet CFM MEP cross-check on a port MEP in CFM IEEE:
Router# ethernet cfm mep crosscheck enable domain customerA port
The following example shows how to enable an Ethernet CFM MEP cross-check in CFM D1 at level 2 for VLAN IDs in the range of 3000 to 3375:
Router# ethernet cfm mep crosscheck enable level 2 vlan 3000-3375
Related Commands
Command
|
Description
|
mep crosscheck mpid vlan
|
Statically defines a remote MEP within a maintenance domain.
|
show ethernet cfm errors
|
Displays CFM continuity check error conditions logged on a device since it was last reset or since the log was last cleared.
|
show ethernet cfm maintenance-points remote crosscheck
|
Displays detailed information about remote MEPs in the cross-check list that were statically configured.
|
ethernet cfm mep crosscheck start-delay
To configure the maximum amount of time that a device waits for remote maintenance endpoints (MEPs) to come up before the cross-check operation is started, use the ethernet cfm mep crosscheck start-delay command in global configuration mode. To restore the default number of seconds a device waits, use the no form of this command.
ethernet cfm mep crosscheck start-delay delay
no ethernet cfm mep crosscheck start-delay delay
Syntax Description
Syntax DescriptionCommand Syntax]
delay
|
Integer from 1 to 65535 that specifies the number of seconds a device waits for remote MEPs to come up before the cross-check is started. The default is 30.
|
Command Default
The start delay interval is enabled with a default of 30 seconds.
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
If continuity check intervals in your network are greater than 30 seconds (the delay default), you must configure the start-delay to match the greatest interval to avoid unnecessary traps.
When the default value is configured, "ethernet cfm mep crosscheck start-delay 30" is displayed when the show running all command is issued.'
Examples
The following example shows how to set the maximum number of seconds that a device will wait for remote MEPs to come up before the cross-check operation is started to 700:
Router(config)# ethernet cfm mep crosscheck start-delay 700
Related Commands
Command
|
Description
|
show running all
|
Shows the running configuration with default values.
|
ethernet cfm mep domain mpid
To set a port as internal to a maintenance domain and define it as a maintenance endpoint (MEP), use the ethernet cfm mep domain mpid command in interface configuration mode. Also, use this command to place the command-line interface (CLI) in Ethernet connectivity fault management (CFM) MEP configuration mode (config-if-ecfm-mep). To restore the default configuration of the port, use the no form of this command.
ethernet cfm mep domain domain-name mpid mpid {port | vlan vlan-id}
no ethernet cfm mep domain domain-name mpid mpid {port | vlan vlan-id}
Syntax Description
domain-name
|
String of a maximum of 154 characters.
|
mpid
|
Integer from 1 to 8191 that identifies the MEP.
|
port
|
Configures the DOWN service direction with no VLAN association (untagged).
|
vlan
|
Configures a VLAN.
|
vlan-id
|
Integer from 1 to 4094 that identifies a VLAN.
|
Command Default
This command is disabled.
Command Modes
Interface configuration (config-if)
Command History
Release
|
Modification
|
12.2(33)SXI2
|
This command was introduced.
|
Usage Guidelines
A single interface may belong to multiple domains, meaning that you can issue multiple instances of the ethernet cfm mep domain mpid command for different domains.
If a specified domain has not been configured, an error message is displayed and the command is rejected.
If an interface is manually provisioned to have a maintenance intermediate point (MIP) at a certain maintenance level and you attempt to configure it as a MEP for a VLAN on the same or a higher level, an error message is displayed and the command is rejected.
If the VLAN for which a MEP is configured is removed from an interface, the MEP configuration is also removed; the VLAN and the definition of the MEP are interrelated.
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
The following example shows how to set a port as internal to a maintenance domain, define it as a maintenance endpoint (MEP), and configure VLAN 17:
Router(config)# interface ethernet 0/1
Router(config-if)# ethernet cfm mep domain CustomerB mpid 5 vlan 17
ethernet cfm mep level mpid vlan
To set an interface as a domain boundary (edge), define it as a maintenance endpoint (MEP), and set direction for the MEP, use the ethernet cfm mep level mpid vlan command in interface configuration mode. To restore the default configuration of the interface, use the no form of this command.
ethernet cfm mep level level-id [inward | outward domain domain-name] mpid id vlan {any |
vlan-id | ,vlan-id | vlan-id-vlan-id | ,vlan-id-vlan-id}
no ethernet cfm mep level level-id [inward | outward domain domain-name] mpid id vlan {any
| vlan-id | ,vlan-id | vlan-id-vlan-id | ,vlan-id-vlan-id}
Syntax Description
Syntax DescriptionCommand Syntax]
level-id
|
Integer from 0 to 7 that identifies the maintenance level at which the MEP is defined.
|
inward
|
(Optional) Indicates the direction of the MEP is toward the device. This is the default.
|
outward
|
(Optional) Sets an interface as outward (toward the wire).
|
domain
|
(Optional) Identifies the domain in which the MEP will be configured.
|
domain-name
|
(Optional) String of a maximum of 154 characters that identifies the domain.
|
id
|
Integer from 0 to 8191 that identifies the MEP.
|
any
|
Indicates all VLANs are to be configured.
|
vlan-id
|
Integer from 1 to 4094 that identifies a VLAN to be configured.
|
,vlan-id
|
Integers from 1 to 4094, separated by commas, that list VLANs to be configured.
|
vlan-id-vlan-id
|
Integers from 1 to 4094 that define a range of VLANs to be configured. The hyphen is required to separate starting and ending values that are used to define the range.
|
,vlan-id-vlan-id
|
Integers from 1 to 4094 that define a list of VLAN ranges to be configured. The comma must be entered to separate ranges. The hyphen is required to separate starting and ending values that are used to define each range of VLANs.
|
Command Default
No MEPs are configured until this command is issued.
Command Modes
Interface configuration (config-if)
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.
The outward and domain keywords and the domain-name argument were added.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
12.2(33)SRD
|
This command was added to support outward facing MEPs on switch ports on Cisco 7600 series routers.
|
Usage Guidelines
Following is the order in which you must configure Ethernet connectivity fault management (CFM) elements:
1.
Domain at the same level as the MEP to be configured
2.
Service within the domain
3.
Maintenance intermediate point (MIP) at a level higher than the MEP if the domain is not an outward domain
4.
MEP
If you do not configure elements in this sequence, the ethernet cfm mep level mpid vlan command will fail. An exception is at maintenance level 7, where configuring a MIP on the interface before you configure a MEP is not required. Configuring a MIP on an interface also is not required when you are configuring an outward facing MEP.
A single interface may belong to multiple domains, which means you can issue multiple instances of the ethernet cfm mep level mpid vlan command for different domains and for different VLANs.
More than one domain can be configured at a single level. The level plus VLAN indicates the domain to which the MEP belongs.
You can configure a single MEP, a list of MEPs, or a range of MEPs so that there is one MEP per VLAN and all MEPs share the same level, direction, and maintenance endpoint ID (MPID).
If the direction of the MEP is not stated, the default is inward facing (toward the Bridge). When you specify an outward MEP, you must provide a domain name. If the specified domain has not been configured or if the specified domain has not been tagged as outward, an error message will display and the command will be rejected.
All MEPs and MIPs must be removed from an interface before MEPs at level 7 can be configured. Also, when you remove MEP configurations at Level 7, you should first remove all lower level MEPs. If you try to configure a MEP on an interface with a level higher than the MIP level, the command will be rejected and an error message will be displayed.
If an interface is provisioned to be a MIP for a certain maintenance level and you try to configure the interface as an inward MEP for a VLAN at the same level, the command will be rejected and an error message will display. If a VLAN for which a MEP is configured is removed from an interface, the MEP configuration remains, but the MEP is inactive and does not transmit or receive messages because the definition of the MEP is associated with the VLAN.
Examples
The following example shows how to set interface Ethernet 0/1 as a domain boundary and define it as a MEP at level 5, with a MPID of 5 on VLAN 101, and then issue the show ethernet cfm maintenance-points local command to display the list of configured MEPs in the device:
Router(config)# interface ethernet 0/1
Router(config-if)# ethernet cfm mep level 5 mpid 5 vlan 101
Router(config-if)# Ctrl-Z
Router(config)# show ethernet cfm maintenance-points local
The following example shows how to set interface Ethernet 0/1 as outward for maintenance domain domain1 and define it as a MEP at level 5 with the MEP ID 700 on VLAN 5:
Router(config)# interface ethernet 0/1
Router(config-if)# ethernet cfm mep level 5 outward domain domain1 mpid 700 vlan 5
The following example shows how to set interface Ethernet 5/0 as a domain boundary and define it as a MEP at level 7, with a MPID of 3001 on VLAN 100 on a switch port:
Router(config)# interface ethernet 5/0
Router(config-if)# switchport
Router(config-if)# switchport mode trunk
Router(config-if)# ethernet cfm mep level 7 outward domain CUSTOMER mpid 3001 vlan 100
The following example shows how to set interface Ethernet 5/0 as a domain boundary and define it as a MEP at level 7, with a MPID of 3001 on VLAN 100 on a routed port:
Router(config)# interface ethernet 5/0
Router(config-if)# ethernet cfm mep level 7 outward domain CUSTOMER mpid 3001 vlan 100
Router(config-if)# interface Ethernet5/0.100
Router(config-if)# encapsulation dot1Q 100
Related Commands
Command
|
Description
|
ethernet cfm domain
|
Defines a CFM domain at a specified maintenance level.
|
ethernet cfm mip level
|
Provisions a MIP at a specified maintenance level on an interface.
|
service vlan
|
Sets a universally unique ID for a customer service instance within a maintenance domain.
|
show ethernet cfm maintenance-points local
|
Displays maintenance points configured on a device.
|
ethernet cfm mip
To globally provision maintenance intermediate points (MIPs) at a specified maintenance level for VLAN IDs that are not associated with specific maintenance associations (MAs) and to enable level filtering, use the ethernet cfm mip command in global configuration mode. To remove a MIP, use the no form of this command.
ethernet cfm mip {auto-create level level-id vlan {vlan-id | vlan-id-vlan-id | ,vlan-id-vlan-id}
[lower-mep-only] [sender-id chassis] | filter}
no ethernet cfm mip {auto-create level level-id vlan {vlan-id | vlan-id-vlan-id | ,vlan-id-vlan-id}
[lower-mep-only] [sender-id chassis] | filter}
Syntax Description
auto-create
|
Dynamically creates a connectivity fault management (CFM) MIP.
|
level
|
Specifies a maintenance domain level.
|
level-id
|
Integer from 0 to 7 that identifies the maintenance level.
|
vlan
|
Indicates a VLAN for configuration.
|
vlan-id
|
Integer from 1 to 4094 that identifies the VLAN to be configured.
|
vlan-id-vlan-id
|
Integers from 1 to 4094 that define a range of VLANs to be configured.
• The hyphen is required to separate the starting and ending VLAN ID values that are used to define the range of VLAN IDs.
|
,vlan-id-vlan-id
|
Integers from 1 to 4094 that define a range of VLANs to be configured.
• The comma is required to separate VLAN ranges.
|
lower-mep-only
|
(Optional) Creates a MIP only if a MEP is configured at the next lower active maintenance domain level for the VLAN ID on the port.
|
sender-id
|
(Optional) Configures the Sender ID option to send for VLAN IDs that are not associated with specific maintenance associations.
If the sender-id option is not configured, the Sender ID TLV is not included in messages.
|
chassis
|
(Optional) Sends the chassis ID.
|
filter
|
Configures a CFM MIP filter that drops all CFM frames at a lower level independent of whether they come from the wire or relay function side.
• Level filtering is disabled by default.
|
Command Default
MIPs are not provisioned.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
12.2(33)SXI2
|
This command was introduced.
|
Usage Guidelines
MIPs will be provisioned only if all the policies have been met.
This command has lower precedence than the manual MIP ethernet cfm mip level (interface configuration mode) configuration command. For example, if you manually configure a MIP for a particular MA, that configuration overrides the MIP created by the global ethernet cfm mip command for that MA.
Examples
The following example shows how to dynamically create a MIP at maintenance level 6 and configure VLAN 500 if a MEP is configured at the next lower active maintenance domain level for the VLAN ID on the port:
Router(config)# ethernet cfm mip auto-create level 6 vlan 500 lower-mep-only
Related Commands
Command
|
Description
|
cfm mip level
|
Sets a port as internal to a maintenance domain, and defines it as a MIP for a MA.
|
ethernet cfm mip level
|
Sets a port as internal to a maintenance domain, and defines it as a MIP.
|
ethernet cfm mip level
To provision a maintenance intermediate point (MIP) at a specified maintenance level on an interface, use the ethernet cfm mip level command in interface configuration mode. To restore the default configuration of the interface, use the no form of this command.
Cisco pre-Standard Connectivity Fault Management Draft 1 (CFM D1)
ethernet cfm mip level level-id
no ethernet cfm mip level level-id
CFM IEEE 802.1ag Standard (CFM IEEE)
ethernet cfm mip level level-id [vlan {vlan-id | vlan-id-vlan-id | ,vlan-id-vlan-id}]
no ethernet cfm mip level level-id [vlan {vlan-id | vlan-id-vlan-id | ,vlan-id-vlan-id}]
Syntax Description
Syntax Description
level-id
|
Integer from 0 to 7 that specifies the maintenance levels at which MIPs can be defined.
|
vlan
|
(Optional) Indicates a VLAN for configuration.
|
vlan-id
|
(Optional) Integer from 1 to 4094 that identifies the VLAN to be configured.
|
vlan-id-vlan-id
|
(Optional) Integers from 1 to 4094 that define a valid range of VLANs to be configured.
• The hyphen is required to separate the starting and ending VLAN ID values that are used to define the range of VLAN IDs.
|
,vlan-id-vlan-id
|
(Optional) Integers from 1 to 4094 that define a valid range of VLANs to be configured.
• The comma is required to separate VLAN ranges.
|
Command Default
No MIPs are configured.
Command Modes
Interface configuration (config-if)
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
If you do not configure a VLAN, this command creates MIPs for all VLANs on an interface.
In the CFM D1 implementation, you must first configure a domain using the ethernet cfm domain command at the level you want to configure the MIP; otherwise, the ethernet cfm mip level command is rejected. In the CFM IEEE implementation, preconfiguring a domain is not required.
You cannot configure a MIP at a level lower than the level of already configured maintenance endpoints (MEPs) on an interface.
Configuring a MIP using this command is known as a manual MIP and has precedence over the mip auto-create command.
Examples
The following example shows how to provision a MIP at maintenance level 5 and then issue the show ethernet cfm maintenance-points local command to display the list of configured MIPs in the device:
Router(config-if)# ethernet cfm mip level 5
Router(config-if)# Ctrl-Z
Router# show ethernet cfm maintenance-points local
Related Commands
Command
|
Description
|
ethernet cfm domain
|
Defines a CFM domain.
|
mip auto-create
|
Enables the automatic creation of a MIP at a maintenance domain level.
|
show ethernet cfm maintenance-points local
|
Displays information about maintenance points configured on a device.
|
ethernet cfm traceroute cache
To enable caching of Ethernet connectivity fault management (CFM) data learned through traceroute messages, use the ethernet cfm traceroute cache command in global configuration mode. To disable caching, use the no form of this command.
ethernet cfm traceroute cache
no ethernet cfm traceroute cache
Syntax Description
This command has no arguments or keywords.
Command Default
Caching is disabled.
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
Setting a traceroute cache allows you to store the results of traceroute operations initiated on the device.
Examples
The following example shows how to enable Ethernet CFM traceroute cache:
Router(config)# ethernet cfm traceroute cache
Related Commands
ethernet cfm traceroute cache hold-time
|
Sets a maximum time that Ethernet CFM traceroute cache entries will be retained.
|
ethernet cfm traceroute cache size
|
Sets a maximum number for entries in an Ethernet CFM traceroute cache table.
|
ethernet cfm traceroute cache hold-time
To set the time that Ethernet connectivity fault management (CFM) traceroute cache entries are retained, use the ethernet cfm traceroute cache hold-time command in global configuration mode. To remove the configured time, use the no form of this command.
ethernet cfm traceroute cache hold-time minutes
no ethernet cfm traceroute cache hold-time
Syntax Description
Syntax DescriptionCommand Syntax]
minutes
|
Integer in the range of 1 to 65535 that specifies the number of minutes that cache entries will be retained. The default is 100.
|
Command Default
Entries are retained for 100 minutes.
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
Before you can issue this command, you must have enabled traceroute caching using the ethernet cfm traceroute cache command.
If traceroute cache is enabled and not empty and you change the hold time to less than the currently configured time, the change is rejected. You are prompted to clean up the table before the new hold time can be accepted. For example:
Router(config)# ethernet cfm traceroute cache hold-time 5
Please clean up the cache before setting smaller hold-time
current hold time = 100 Command Aborted.
Output of the show running all command displays "ethernet cfm traceroute cache hold-time 100" when traceroute cache is enabled and the default value of 100 is configured.
Examples
The following example shows how to set the retention time for entries in an Ethernet CFM traceroute cache table to 5 minutes:
Router(config)# ethernet cfm traceroute cache hold-time 5
Related Commands
ethernet cfm traceroute cache
|
Enables caching of Ethernet CFM data learned from traceroute messages.
|
ethernet cfm traceroute cache size
|
Sets a maximum number for entries in an Ethernet CFM traceroute cache table.
|
show running all
|
Shows the running configuration with default values.
|
ethernet cfm traceroute cache size
To set a maximum size for the Ethernet connectivity fault management (CFM) traceroute cache table, use the ethernet cfm traceroute cache size command in global configuration mode. To remove the configured size, use the no form of this command.
ethernet cfm traceroute cache size entries
no ethernet cfm traceroute cache size
Syntax Description
entries
|
Number of entries in the traceroute cache table, expressed as an integer in the range of 1 to 4095. The default is 100.
|
Command Default
If traceroute cache is enabled, traceroute replies are cached up to a maximum of 100 entries.
If traceroute cache is disabled, traceroute replies are not cached; the default size is 0.
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
Before you can issue this command, you must have enabled traceroute caching using the ethernet cfm traceroute cache command.
Entries in the traceroute cache table are single replies from remote devices—not the number of operations on the device. In Cisco pre-Standard CFM Draft 1 when the maximum cache size is reached, new replies cannot be added until you clear the cache or increase its size. In CFM IEEE 802.1ag Standard when the maximum cache size is reached, the oldest traceroute operation is removed to make room for a new traceroute operation.
Output of the show running all command displays "ethernet cfm traceroute cache size 100" when traceroute cache is enabled and the default value of 100 is configured.
Setting the number of entries lower than the number of entries currently cached causes this command to be rejected, and you are prompted to clear the traceroute cache.
Examples
The following example shows how to set the maximum number of entries in an Ethernet CFM traceroute cache table to 2500:
Router(config)# ethernet cfm traceroute cache size 2500
Related Commands
Command
|
Description
|
ethernet cfm traceroute cache
|
Enables caching of Ethernet CFM data learned from traceroute messages.
|
ethernet cfm traceroute cache hold-time
|
Sets the maximum time that Ethernet CFM traceroute cache entries will be retained.
|
show running all
|
Shows the running configuration with default values.
|
ethernet evc
To define an Ethernet virtual connection (EVC) and to enter EVC configuration mode, use the ethernet evc command in global configuration mode. To delete the EVC, use the no form of this command.
ethernet evc evc-id
no ethernet evc evc-id
Syntax Description
evc-id
|
String from 1 to 100 characters that identifies the EVC.
|
Command Default
No EVCs are defined.
Command Modes
Global configuration (config)
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
After you enter the ethernet evc command, the device enters EVC configuration mode and the following configuration commands are available:
•
default—Sets the EVC to its default states.
•
exit—Exits EVC configuration mode and returns the CLI to global configuration mode.
•
no—Negates a command or returns a command to its default setting.
•
oam protocol—Configures the Ethernet operations, administration, and maintenance (OAM) protocol and sets parameters.
•
uni count—Configures a UNI count for the EVC.
Examples
The following example shows how to define an EVC named test1 and to enter EVC configuration mode:
Router(config)# ethernet evc test1
Related Commands
Command
|
Description
|
oam protocol
|
Configures the EVC OAM protocol.
|
service instance
|
Configures an Ethernet service instance and attaches an EVC to it.
|
show ethernet service evc
|
Displays information about configured EVCs.
|
uni count
|
Sets the UNI count for an EVC.
|
ethernet lmi
To set Ethernet local management interface (LMI) parameters for a user-network interface (UNI), use the ethernet lmi command in interface configuration mode. To remove Ethernet LMI parameters on a UNI, use the no form of this command.
ethernet lmi {n391 | n393 | t391 | t392} value
no ethernet lmi {n391 | n393 | t391 | t392}
Syntax Description
n391
|
Polling counter on the customer equipment. A polling counter polls the status of the UNI and all Ethernet virtual connections (EVCs).
|
n393
|
An error counter for customer equipment or for a metro Ethernet network.
|
t391
|
Polling timer on the customer equipment. A polling timer transmits status enquiries and when status messages are not received, records errors.
|
t392
|
Polling verification timer on the metro Ethernet network. The polling verification timer verifies status enquiries received. When a timer expires, an error is recorded and the timer is restarted.
Note The t392 timer is valid only on Ethernet LMI provider edge (PE) devices. It is not available on customer edge (CE) devices.
|
value
|
Integer value within ranges that vary depending on the keyword with which it is used. Valid values are as follows:
• n391—1 to 65000. Default is 360.
• n393—1 to 10. Default is 4.
• t391—5 to 30 (seconds). Default is 10.
• t392—5 to 30 (seconds); default is 15 or 0 to 0 (0-0), which disables the timer.
|
Command Default
Ethernet LMI parameters are not set on any UNIs.
Command Modes
Interface configuration (config-if)
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
The value for the polling verification timer (t392) should be greater than the value for the polling timer (t391).
The polling verification timer (t392) can be disabled.
A very high value for the polling timer (t391) means more time spent detecting Ethernet LMI link-down errors.
Examples
The following example shows how to set a polling counter for 30 seconds on interface Ethernet 1/0:
Router# configure terminal
Router(config)# interface ethernet 1/0
Router(config-if)# ethernet lmi t391 30
ethernet lmi ce-vlan map
To configure Ethernet Local Management Interface (LMI) parameters, use the ethernet lmi ce-vlan map command in Ethernet service configuration mode. To remove the configuration, use the no form of this command.
ethernet lmi ce-vlan map {vlan-id [untagged] | any | default | untagged}
no ethernet lmi ce-vlan map {vlan-id | any | default | untagged}
Syntax Description
vlan-id
|
Integer in the range of 1 to 4094 that identifies the customer VLAN or VLANs to map to.
• You can enter a range of VLAN IDs using a hyphen (-) between IDs or enter a series of VLAN IDs using a comma (,) to separate each one.
|
untagged
|
Map untagged VLANs.
(Optional) When used with a range or series of VLANs, the untagged keyword is optional.
|
any
|
Map all VLANs (untagged and VLANs 1 to 4094).
|
default
|
Map to the default service instance.
• You can use the default keyword only if you have already mapped the service instance to a VLAN or a group of VLANs.
|
Command Default
No Ethernet LMI mapping parameters are defined.
Command Modes
Ethernet service configuration (config-if-srv)
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
If you intend to use the ethernet lmi ce-vlan map any command, you must first configure all-to-one bundling on the interface.
Use this command to configure an Ethernet LMI customer VLAN-to-EVC map for a particular user-network interface (UNI).
Ethernet LMI mapping parameters are related to the bundling characteristics set by entering the ethernet uni command in interface configuration mode.
•
Using the default UNI attribute (bundling and multiplexing) supports multiple EVCs and multiple VLANs.
•
Entering the ethernet uni bundle command supports only one EVC with one or more VLANs.
•
Entering the ethernet uni bundle all-to-one command supports multiple VLANs but only one EVC. If you use the ethernet lmi ce-vlan map any command in Ethernet service configuration mode, you must first configure all-to-one bundling on the interface.
•
Entering the ethernet uni multiplex command supports multiple EVCs with only one VLAN per EVC.
Examples
The following example shows how to configure an Ethernet LMI customer VLAN-to-EVC map to test customer VLAN 101 in service instance 333 on the interface:
Router(config)# interface ethernet 2/1
Router(config-if)# service instance 333 ethernet test
Router(config-if-srv)# ethernet lmi ce-vlan map 101
Related Commands
Command
|
Description
|
service instance ethernet
|
Defines an Ethernet service instance and enters Ethernet service configuration mode.
|
show ethernet service instance
|
Displays information about configured Ethernet service instances.
|
ethernet lmi global
To enable Ethernet local management interface (LMI) functionality globally on a device, use the ethernet lmi global command in global configuration mode. To disable Ethernet LMI globally on a device, use the no form of this command.
ethernet lmi global
no ethernet lmi global
Syntax Description
This command has no arguments or keywords.
Command Default
Ethernet LMI is disabled.
Command Modes
Global configuration (config)
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
Ethernet LMI is disabled by default on an interface and must be explicitly enabled. The ethernet lmi global command enables Ethernet LMI on all interfaces for an entire device. The benefit of this command is that you can enable Ethernet LMI on all interfaces with one command compared to enabling Ethernet LMI separately on each interface.
To disable Ethernet LMI on a specific interface after the ethernet lmi global command has been issued, the no ethernet lmi interface command must be issued on that interface.
The sequence in which the ethernet lmi interface and ethernet lmi global commands are issued is significant. The latest command issued overrides the prior command issued.
Examples
The following example shows how to enable Ethernet LMI globally on a device:
Router(config)# ethernet lmi global
Related Commands
Command
|
Description
|
ethernet lmi interface
|
Enables Ethernet LMI for a user-network interface.
|
ethernet lmi interface
To enable Ethernet local management interface (LMI) on a user-network interface (UNI), use the ethernet lmi interface command in interface configuration mode. To remove Ethernet LMI on a UNI, use the no form of this command.
ethernet lmi interface
no ethernet lmi interface
Syntax Description
This command has no arguments or keywords.
Command Default
Ethernet LMI parameters are not set on any UNIs.
Command Modes
Interface configuration (config-if)
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
This command enables Ethernet LMI processing on an interface if the ethernet lmi global command has not been issued. When the ethernet lmi global command has been issued, Ethernet LMI is enabled on all interfaces. In this case, the no ethernet lmi interface command overrides the ethernet lmi global command and disables Ethernet LMI processing on the interface.
The sequence in which the commands are issued is significant. The latest command issued overrides the prior command issued.
Examples
The following example shows how to enable Ethernet LMI on interface Ethernet 1/0:
Router# configure terminal
Router(config)# interface ethernet 1/0
Router(config-if)# ethernet lmi interface
Related Commands
Command
|
Description
|
ethernet lmi global
|
Enables Ethernet LMI functionality globally on a device.
|