eth-test mac-address mep mep-id domain md-index association ma-index[priority priority][data-length data-length]
oam>eth-cfm
This command specifies to initiate an Ethernet (signal) test.
specifies a unicast MAC address
specifies the target MEP ID
specifies the MD index
specifies the value used for priority mapping. See Table: Priority Mapping Based on Message Type and MEP Direction to determine how the priority is derived; if it is user-defined, see Table: Y.1731 Priority-to-FC Mapping for the priority-to-FC mappings.
specifies the MA index
specifies the packet size in bytes, expressed as a decimal integer, used for the ETH-CFM test
linktrace mac-address mep mep-id domain md-index association ma-index[ttl ttl-value]
oam>eth-cfm
This command specifies to initiate a linktrace test.
specifies a unicast destination MAC address
specifies the target MEP ID
specifies the MD index
specifies the MA index
specifies the TTL for a returned linktrace
loopback mac-address mep mep-id domain md-index association ma-index[send-count send-count][size data-size][priority priority]
oam>eth-cfm
This command specifies to initiate a loopback test.
specifies a unicast MAC address
specifies the target MEP ID
specifies the MD index
specifies the MA index
specifies the number of messages to send, expressed as a decimal integer. Dot1ag loopback messages are sent back-to-back, with no delay between the transmissions.
specifies the packet size in bytes, expressed as a decimal integer
specifies the value used for priority mapping. See Table: Priority Mapping Based on Message Type and MEP Direction to determine how the priority is derived; if it is user-defined, see Table: Y.1731 Priority-to-FC Mapping for the priority-to-FC mappings.
one-way-delay-test mac-address mep mep-id domain md-index association ma-index[priority priority]
oam>eth-cfm
This command specifies to initiate an ETH-CFM one-way delay test.
specifies a unicast MAC address
specifies the target MEP ID
specifies the MD index
specifies the MA index
specifies the value used for priority mapping. See Table: Priority Mapping Based on Message Type and MEP Direction to determine how the priority is derived; if it is user-defined, see Table: Y.1731 Priority-to-FC Mapping for the priority-to-FC mappings.
two-way-delay-test mac-address mep mep-id domain md-index association ma-index [priority priority]
oam>eth-cfm
This command specifies to initiate an ETH-CFM two-way delay test.
specifies a unicast MAC address
specifies the target MEP ID
specifies the MD index
specifies the MA index
specifies the value used for priority mapping. See Table: Priority Mapping Based on Message Type and MEP Direction to determine how the priority is derived; if it is user-defined, see Table: Y.1731 Priority-to-FC Mapping for the priority-to-FC mappings.
two-way-slm-test mac-address mep mep-id domain md-index association ma-index[prioritypriority] [send-count send-count] [size data-size] [timeout timeout] [interval interval]
oam>eth-cfm
This command specifies to initiate an Ethernet CFM two-way SLM test.
specifies a unicast MAC address
specifies the target MEP ID
specifies the MD index
specifies the MA index
specifies the value used for priority mapping. See Table: Priority Mapping Based on Message Type and MEP Direction to determine how the priority is derived; if it is user-defined, see Table: Y.1731 Priority-to-FC Mapping for the priority-to-FC mappings.
the number of messages to send, expressed as a decimal integer. The message interval value must be expired before the next message request is sent.
the size of the data portion of the data TLV. If 0 is specified, no data TLV is added to the packet.
the timeout parameter in seconds. This value is the length of time that the router will wait for a message reply after sending the message request. If the timeout expires, the requesting router assumes that the message response will not be received. Any response received after the request times out will be silently discarded. The timeout value must be less than or equal to the interval.
the time, in seconds between probes within a test run
single-ended-loss-test mac-address mep mep-id domain md-index association ma-index[priority priority][interval {100ms | 1s}][send-count send-count]
oam>eth-cfm
This command specifies to initiate a loss measurement test between the specified mac-address router and the specified mep-id MEP.
Single-ended and dual-ended loss tests are mutually exclusive tests. Single-ended loss tests can be run when dual-ended loss tests are disabled (under the config>service>epipe>spoke-sdp>eth-cfm>mep or config>router>if>eth-cfm>mep context).
specifies a unicast MAC address
specifies the target MEP ID
specifies the index of the MD to which the MEP is associated, or 0, if none
specifies the index to which the MEP is associated, or 0, if none
specifies the number of LMM messages to send, expressed as a decimal integer
specifies the interval between groups of consecutive LMM packets (for example, if send-count is 5 and interval is 1s, then 5 LMM packets are sent at 1-s intervals)
specifies the value used for priority mapping. See Table: Priority Mapping Based on Message Type and MEP Direction to determine how the priority is derived; if it is user-defined, see Table: Y.1731 Priority-to-FC Mapping for the priority-to-FC mappings.
eth-cfm
config
config>router>interface
config>service>epipe>sap
config>service>epipe>spoke-sdp
config>service>vpls>sap
config>service>vpls>mesh-sdp
config>service>vpls>spoke-sdp
This command enables the context to configure 802.1ag Connectivity Fault Management (CFM) parameters.
domain md-index[format {dns | mac | none | string}][name md-name] level level
domain md-index
no domain md-index
config>eth-cfm
This command configures CFM domain parameters.
The dns, mac, and string keywords apply to dot1ag. The none keyword applies to Y.1731. If the none keyword is used, the association command must use the icc-based or string format. A MEP associated with domain formatnone and association formaticc-basedis a Y.1731 MEP. A MEP associated with domain format none and association format string is a Y.1731 MEP that can interoperate with a dot1ag MEP. All other configurations are associated with dot1ag MEPs.
The no form of the command removes the MD index parameters from the configuration.
specifies the maintenance domain (MD) index value
specifies a value that represents the type (format) of the md-name
specifies a generic maintenance domain (MD) name
specifies the integer identifying the maintenance domain level (MD level). Higher numbers correspond to higher-level maintenance domains (those with the greatest physical reach) with the highest values for customers’ CFM packets. Lower numbers correspond to lower-level maintenance domains (those with more limited physical reach) with the lowest values for single bridges or physical links.
association ma-index[format {icc-based | integer | string | vid | vpn-id}] name ma-name
association ma-index
no association ma-index
config>eth-cfm>domain
This command configures the maintenance association (MA) for the domain.
The integer, string, vid, and vpn-id keywords apply to dot1ag MAs. The icc-based keyword applies to Y.1731 MEGs, and is only available when the domain format is none. A MEP associated with domain format none and association format icc-based is a Y.1731 MEP. A MEP associated with domain format none and association format string is a Y.1731 MEP that can interoperate with a dot1ag MEP. All other configurations are associated with dot1ag MEPs.
specifies the MA index value
specifies a value that represents the type (format) of the ma-name
specifies the part of the maintenance association identifier that is unique within the maintenance domain name
[no] bridge-identifier bridge-id
config>eth-cfm>domain>association
This command configures the service ID for the domain association. The bridge-id should be configured to match the service-id of the service where MEPs for this association will be created. For example, for Epipe service-id 2, set the bridge-id to 2. There is no verification that the service with a matching service-id exists.
This command does not apply to facility MEPs on network interfaces, as these MEPs are not bound to a service.
specifies the bridge ID for the domain association
vlan vlan-id
no vlan
config>eth-cfm>domain>association>bridge-identifier
This command configures the bridge-identifier primary VLAN ID. This command is informational only; no verification is done to ensure that MEPs on this association are on the configured VLAN.
specifies a VLAN ID monitored by MA.
ccm-interval {10ms | 100ms | 1 | 10 | 60 | 600}
no ccm-interval
config>eth-cfm>domain>association
This command configures the CCM transmission interval for all MEPs in the association, in milliseconds and seconds.
The no form of the command reverts to the default value.
10 s
[no] remote-mepid mep-id
config>eth-cfm>domain>association
This command configures the remote maintenance association endpoint MEP identifier.
maintenance association endpoint identifier of a remote MEP whose information from the MEP database is to be returned
slm
config>eth-cfm
This command enables the context to configure ITU-T Synthetic Loss Measurement (ETH-SL).
inactivity-timer timeout
no inactivity-timer
config>eth-cfm>slm
This command configures the time that the responder keeps a test active. If the time between packets exceeds this value within a test, the responder marks the previous test as complete. It treats any new packets from a peer with the same test-id, source MAC address, and MEP-ID as a new test, and indicates this by responding with the sequence number 1.
100 s
specifies the inactivity timeout value, in seconds
cfm-loopback priority {low | high | dot1p}[match-vlan {vlan-range| none}]
no cfm-loopback
config>port>ethernet
This command enables the port to respond to Loopback Messages (LBMs) and sets the queuing and scheduling conditions for handling CFM LBM frames. The user selects the required QoS treatment by enabling the CFM loopback and including the high or low priority with the high or low keyword. The queue parameters and scheduler mappings associated with the high and low keywords are preconfigured and cannot be altered by the user.
The priority dot1p and match-vlan keywords apply only to physical ring ports on the 2-port 10GigE (Ethernet) Adapter card/module.
The parameters and mappings have the following settings:
for network egress, where profiled scheduling is the choice of scheduling:
high-priority: either cir = port_speed, which applies to all frames that are scheduled via an in-profile scheduler, or round-robin (RR) for all other (network egress queue) frames that are in-profile
low-priority: either cir = 0, pir = port_speed, which applies to all frames that are scheduled as out-of-profile, or RR for all other frames that are out-of-profile
for network egress or access egress, where 4-priority scheduling is enabled:
high-priority: either cir = port_speed, which applies to all frames that are scheduled via an expedited in-profile scheduler, or RR for all other (network egress queue) frames that reside in expedited queues and are in an in-profile state
low-priority: either cir = 0, pir = port_speed, which applies to all frames that are scheduled via a best effort out-of-profile scheduler, or RR for all other frames that reside in best-effort queues and are in an out-of-profile state
for the 6-port Ethernet 10Gbps Adapter card, the 8-port Gigabit Ethernet Adapter card, the 10-port 1GigE/1-port 10GigE X-Adapter card, and the v-port on the 2-port 10GigE (Ethernet) Adapter card/module, for network egress, where 16-priority scheduling is enabled:
high-priority: has higher priority than any user frames
low-priority: has lower priority than any user frames
for the physical ring ports on the 2-port 10GigE (Ethernet) Adapter card/module, which can only operate as network egress, the priority of the LBR frame is derived from the dot1p setting of the received LBM frame. Based on the assigned ring-type network queue policy, dot1p-to-queue mapping is handled using the same mapping rule that applies to all other user frames.
CFM loopback support on a physical ring port on the 2-port 10GigE (Ethernet) Adapter card/module differs from other Ethernet ports. For these ports, cfm-loopback is configured using dot1p and an optional list of up to 16 VLANs. The null VLAN is always applied. The CFM LBM will be processed if it does not contain a VLAN header, or if it contains a VLAN header with a VLAN ID that matches one in the configured match-vlan list.
The no form of the command disables the handling of CFM loopback frames.
no cfm-loopback
sets the queue parameters and scheduler mappings, as described above
sets the queue parameters and scheduler mappings, as described above
sets the queue parameters and scheduler mappings on a physical ring port, as described above
sets the matching VLAN IDs that will allow a CFM loopback on a physical ring port when priority is set to dot1p, as described above
[no] hold-mep-up-on-failure
config>service>epipe>sap>eth-cfm
This command keeps an 802.1ag or Y.1731 maintenance association endpoint (MEP) in operation regardless of the operational state of the SAP. The MEP remains in operation when the SAP is down or non-operational.
The no form of the command disables the MEP from remaining in operation when the SAP is down or non-operational.
This command is not supported for VPLS SAPs.
enabled
mep mep-id domain md-index association ma-index[direction {up | down}]
no mep mep-id domain md-index association ma-index
config>router>if>eth-cfm
config>service>epipe>sap>eth-cfm
config>service>epipe>spoke-sdp>eth-cfm
config>service>vpls>sap>eth-cfm
config>service>vpls>mesh-sdp>eth-cfm
config>service>vpls>spoke-sdp>eth-cfm
This command provisions an 802.1ag or a Y.1731 maintenance association endpoint (MEP).
The 7705 SAR supports Up and Down MEPs for both 802.1ag and Y.1731 on Ethernet (Epipe and VPLS) SAPs, Ethernet spoke and mesh SDPs (mesh SDPs are only supported for VPLS), and facility MEPs on network interfaces.
The no form of the command reverts to the default values.
specifies the maintenance association endpoint identifier
specifies the maintenance domain (MD) index value
specifies the MA index value
specifies the direction in which the maintenance association (MEP) faces on the bridge port (up sends Continuity Check Messages (CCMs) toward the fabric, down sends CCMs toward the egress port or line). The direction parameter is not supported on network interfaces.
[no] ais-enable
config>service>epipe>sap>eth-cfm>mep
config>service>vpls>sap>eth-cfm>mep
This command enables the generation and the reception of AIS messages and applies to Y.1731 SAP MEPs only.
disabled
client-meg-level [level [level ...]]
no client-meg-level
config>service>epipe>sap>eth-cfm>mep>ais-enable
config>service>vpls>sap>eth-cfm>mep>ais-enable
This command configures the client maintenance entity group (MEG) levels to use for AIS message generation. Up to seven levels can be provisioned, with the restriction that the client (remote) MEG level must be higher than the local MEG level.
specifies the client MEG level
interval {1 | 60}
no interval
config>service>epipe>sap>eth-cfm>mep>ais-enable
config>service>vpls>sap>eth-cfm>mep>ais-enable
This command specifies the transmission interval of AIS messages in seconds.
the transmission interval of AIS messages in seconds
priority priority-value
no priority
config>service>epipe>sap>eth-cfm>mep>ais-enable
config>service>vpls>sap>eth-cfm>mep>ais-enable
This command specifies the priority of AIS messages originated by the MEP, which is used for priority-mapping OAM frames.
specifies the priority value of the AIS messages originated by the node
[no] ccm-enable
config>router>if>eth-cfm>mep
config>service>epipe>sap>eth-cfm>mep
config>service>epipe>spoke-sdp>eth-cfm>mep
config>service>vpls>sap>eth-cfm>mep
config>service>vpls>mesh-sdp>eth-cfm>mep
config>service>vpls>spoke-sdp>eth-cfm>mep
This command enables the generation of CCM messages.
The no form of the command disables the generation of CCM messages.
ccm-ltm-priority priority
no ccm-ltm-priority
config>router>if>eth-cfm>mep
config>service>epipe>sap>eth-cfm>mep
config>service>epipe>spoke-sdp>eth-cfm>mep
config>service>vpls>sap>eth-cfm>mep
config>service>vpls>mesh-sdp>eth-cfm>mep
config>service>vpls>spoke-sdp>eth-cfm>mep
This command specifies the priority value for Continuity Check Messages (CCMs) and Linktrace Messages (LTMs) transmitted by the MEP.
The default priority is 7, which means that CCM frames map to the NC forwarding class by default.
The no form of the command removes the priority value from the configuration.
7
specifies the value used for priority mapping. See Table: Priority Mapping Based on Message Type and MEP Direction to determine how the priority is derived; if it is user-defined, see Table: Y.1731 Priority-to-FC Mapping for the priority-to-FC mappings.
ccm-tlv-ignore [port-status][interface-status]
no ccm-tlv-ignore
config>router>if>eth-cfm>mep
This command allows the receiving MEP to ignore the specified TLVs in the ETH CCM PDU. Ignored TLVs will be reported as absent and will have no effect on the MEP.
The no form of the command causes the receiving MEP to process all recognized TLVs in the ETH CCM PDU.
n/a
ignore the port status TLV when it is received
ignore the interface status TLV when it is received
description description-string
no description
config>router>if>eth-cfm>mep
config>service>epipe>sap>eth-cfm>mep
config>service>epipe>spoke-sdp>eth-cfm>mep
config>service>vpls>sap>eth-cfm>mep
config>service>vpls>mesh-sdp>eth-cfm>mep
config>service>vpls>spoke-sdp>eth-cfm>mep
This command creates a text description of a MEP. The description can be changed at any time, even while the server is running.
The no form of the command removes the description.
no description
the description character string. Allowed values are any string up to 80 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, or spaces), the entire string must be enclosed within double quotes.
[no] dual-ended-loss-test-enable
config>router>if>eth-cfm>mep
config>service>epipe>sap>eth-cfm>mep
This command enables dual-ended loss measurement testing on a MEP. When enabled, the test runs in the background.
CCM must be enabled before the dual-ended loss measurement test can be enabled.
The dual-ended loss measurement test is not supported for VPLS SAPs.
The dual-ended and single-ended loss measurement tests are mutually exclusive tests. When the dual-ended loss measurement test is enabled, the single-ended test is not available.
The no form of the command disables the dual-ended loss measurement test.
This command applies only to Y.1731 MEPs.
enabled
alarm-clear-threshold percentage
[no] alarm-clear-threshold
config>router>if>eth-cfm>mep>dual-ended-loss-test-enable
config>service>epipe>sap>eth-cfm>mep>dual-ended-loss-test-enable
This command configures a clearing alarm threshold for frame loss measurement, where percentage is defined as (the total number of Tx frames) divided by (the total number of frames dropped) expressed as a percentage.
If a dual-ended-loss alarm is outstanding and the alarm-clear-threshold is configured to a non-zero value, the dual-ended-loss clear alarm will not be raised until the dual-ended-loss ratio drops below the alarm-clear-threshold. If the alarm-clear-threshold is configured to 0, the dual-ended-loss clear alarm is raised immediately when the dual-ended-loss ratio drops below the alarm threshold.
This functionality prevents too many alarms from being generated if the loss ratio is toggling above and below the alarm threshold.
The alarm-clear-threshold cannot be greater than the alarm-threshold.
Setting the percentage to 0 means that no alarm-clear-threshold is configured; clear alarm traps will continue to be sent when the loss ratio is no longer above the alarm threshold. This is equivalent to using the no form of the command.
0.00 to 100.00, adjustable in 0.01% increments
alarm-threshold percentage
no alarm-threshold
config>router>if>eth-cfm>mep>dual-ended-loss-test-enable
config>service>epipe>sap>eth-cfm>mep>dual-ended-loss-test-enable
This command specifies the alarm threshold ratio for frame loss measurement, where percentage is defined as (the total number of Tx frames) divided by (the total number of frames dropped) expressed as a percentage. When the alarm threshold is reached, an alarm is raised.
The no form of the command removes the priority value from the configuration. Setting the percentage to 0.00 is equivalent to using the no form of the command.
0.00 to 100.00, adjustable in 0.01% increments
[no] eth-test-enable
config>router>if>eth-cfm>mep
config>service>epipe>sap>eth-cfm>mep
config>service>vpls>sap>eth-cfm>mep
This command enables an Ethernet (signal) test (ETH-Test) on a MEP. When enabled, the test runs in the background. This command applies to Y.1731 MEPs only.
For this test, operators must configure ETH-Test parameters on both sender and receiver nodes. The ETH-Test can then be run using the following OAM command:
oam eth-cfm eth-test mac-address mep mep-id domain md-index association ma-index [priority priority] [data-length data-length]
A check is done on the provisioning and the test commands to ensure that the MEP is a Y.1731 MEP. If the MEP is not a Y.1731 MEP, the operation fails and an error message in the CLI and SNMP will indicate the problem. A Y.1731 MEP has domain format none and association format icc-based or string (the string keyword enables the Y.1731 MEP to interoperate with a dot1ag MEP).
The no form of the command disables the ETH-Test on a MEP.
enabled
bit-error-threshold bit-errors
config>router>if>eth-cfm>mep>eth-test-enable
config>service>epipe>sap>eth-cfm>mep>eth-test-enable
config>service>vpls>sap>eth-cfm>mep>eth-test-enable
This command configures a threshold for raising SNMP traps for one-way CFM tests.
For bit-error-threshold tests, test results are available only at the destination node. In order for the network management system to collect the results, SNMP traps need to be raised. This threshold is used to control when to raise a trap. When the number of bit errors reaches the threshold, an SNMP trap is raised.
Configuring a threshold value of 0 will cause the node to raise an SNMP trap for every one-way test it receives.
the bit-error threshold
[no] test-pattern {all-zeros | all-ones}[crc-enable]
config>router>if>eth-cfm>mep>eth-test-enable
config>service>epipe>sap>eth-cfm>mep>eth-test-enable
config>service>vpls>sap>eth-cfm>mep>eth-test-enable
This command configures the test pattern for ETH-Test frames.
The no form of the command removes the values from the configuration.
specifies to use all zeros or all ones in the test pattern
specifies to generate a CRC checksum
low-priority-defect {allDef | macRemErrXcon | remErrXcon | errXcon | xcon | noXcon}
config>router>if>eth-cfm>mep
config>service>epipe>sap>eth-cfm>mep
config>service>epipe>spoke-sdp>eth-cfm>mep
config>service>vpls>sap>eth-cfm>mep
config>service>vpls>mesh-sdp>eth-cfm>mep
config>service>vpls>spoke-sdp>eth-cfm>mep
This command specifies the lowest priority defect that is allowed to generate a fault alarm.
remErrXcon
DefRDICCM, DefMACstatus, DefRemoteCCM, DefErrorCCM, and DefXconCCM
DefMACstatus, DefRemoteCCM, DefErrorCCM, and DefXconCCM
only DefRemoteCCM, DefErrorCCM, and DefXconCCM
only DefErrorCCM and DefXconCCM
only DefXconCCM
no defects DefXcon or lower are to be reported
mac-address mac-address
no mac-address
config>service>vpls>sap>eth-cfm>mep
This command specifies the MAC address of the MEP. The command applies to VPLS SAPs only.
The no form of the command resets the MAC address to the MAC address of the port.
n/a
MAC address of the MEP
one-way-delay-threshold seconds
config>router>if>eth-cfm>mep
config>service>epipe>sap>eth-cfm>mep
config>service>vpls>sap>eth-cfm>mep
This command configures a threshold for raising SNMP traps for one-way CFM tests.
For one-way-delay-threshold tests, test results are available only at the destination node. In order for the network management system to collect the results, SNMP traps need to be raised. This threshold is used to control when to raise a trap. When the delay time reaches the threshold, an SNMP trap is raised.
Configuring a threshold value of 0 will cause the node to raise an SNMP trap for every one-way test it receives.
the delay time threshold value