22. eth-ring commands
22.1. eth-ring command descriptions
eth-ring [ring-index] number
Synopsis
Enter the eth-ring list instance
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
[ring-index] number
Synopsis
Ring ID
Range
1 to 128
Notes
This element is part of a list key.
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
admin-state keyword
Synopsis
Administrative state of the Ethernet ring
Context
configure eth-ring number admin-state keyword
Tree
Default
disable
Options
enable, disable
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
ccm-hold-time
Synopsis
Enter the ccm-hold-time context
Context
configure eth-ring number ccm-hold-time
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
down number
Synopsis
Hold timer for down event dampening
Context
configure eth-ring number ccm-hold-time down number
Tree
Range
1 to 5000
Units
centiseconds
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
up number
Synopsis
Hold timer for recovery reporting
Context
configure eth-ring number ccm-hold-time up number
Tree
Range
0 to 5000
Default
20
Units
deciseconds
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
compatible-version number
Synopsis
Compatibility version for the Ethernet ring
Context
configure eth-ring number compatible-version number
Tree
Range
1 to 2
Default
2
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
description string
Synopsis
Text description
Context
configure eth-ring number description string
Tree
String Length
0 to 80
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
guard-time number
Synopsis
Ethernet ring guard time
Context
configure eth-ring number guard-time number
Tree
Range
1 to 20
Default
5
Units
deciseconds
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
node-id string
Synopsis
MAC address of the RPL link
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
path [path-index] string
Synopsis
Enter the path list instance
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
[path-index] string
Synopsis
Path ID
String Length
1
Notes
This element is part of a list key.
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
admin-state keyword
Synopsis
Administrative state of the Ethernet ring path
Context
configure eth-ring number path string admin-state keyword
Tree
Default
disable
Options
enable, disable
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
description string
Synopsis
Text description
Context
configure eth-ring number path string description string
Tree
String Length
0 to 80
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
eth-cfm
Synopsis
Enter the eth-cfm context
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
mep md-admin-name reference ma-admin-name reference mep-id number
Synopsis
Enter the mep list instance
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
md-admin-name reference
Synopsis
Admin-assigned maintenance domain index value
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number
Notes
This element is part of a list key.
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
ma-admin-name reference
Synopsis
Maintenance association name
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number
Reference
configure eth-cfm domain string association string
Notes
This element is part of a list key.
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
mep-id number
Synopsis
Maintenance endpoint ID
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number
Range
1 to 8191
Notes
This element is part of a list key.
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
admin-state keyword
Synopsis
Administrative state of the MEP
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number admin-state keyword
Tree
Default
disable
Options
enable, disable
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
alarm-notification
Synopsis
Enter the alarm-notification context
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number alarm-notification
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
fng-alarm-time number
Synopsis
Time that must expire before an FNG alarm is raised
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number alarm-notification fng-alarm-time number
Tree
Range
250 | 500 | 1000
Units
centiseconds
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
fng-reset-time number
Synopsis
Time that must expire before an FNG alarm is reset
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number alarm-notification fng-reset-time number
Tree
Range
250 | 500 | 1000
Units
centiseconds
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
ccm boolean
Synopsis
Generate CCM messages
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number ccm boolean
Tree
Default
false
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
ccm-ltm-priority number
Synopsis
Priority of CCM and LTM messages transmitted by the MEP
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number ccm-ltm-priority number
Tree
Range
0 to 7
Default
7
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
ccm-padding-size number
Synopsis
Number of octets of padding to insert in CCM packets
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number ccm-padding-size number
Tree
Description
This command sets the byte size of the optional Data TLV to be included in the ETH-CC PDU.
This command increases the size of the ETH-CC PDU by the configured value. The base size of the ETH-CC PDU, including the Interface Status TLV and Port Status TLV, is 83 bytes not including the Layer Two encapsulation. CCM padding is not supported when the CCM Interval is less than one second.
Range
3 to 1500
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
control-mep boolean
Synopsis
Enable Ethernet ring control on the MEP
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number control-mep boolean
Tree
Default
false
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
description string
Synopsis
Text description
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number description string
Tree
String Length
1 to 80
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
eth-test
Synopsis
Enable the eth-test context
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number eth-test
Tree
Description
Commands in this context configure parameters used by the ETH-TST packet. The commands must be configured on both the sender and receiver nodes. The test packets are used with the oam eth-cfm eth-test command.
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
bit-error-threshold number
Synopsis
Lowest priority defect allowed to generate fault alarm
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number eth-test bit-error-threshold number
Tree
Range
0 to 11840
Default
1
Units
bit errors
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
test-pattern
Synopsis
Enter the test-pattern context
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number eth-test test-pattern
Tree
Description
Commands in this context specify the test pattern for the ETH-TST frames. The pattern does not have to be the same on the sender and receiver.
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
crc-tlv boolean
Synopsis
Generate a CRC checksum
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number eth-test test-pattern crc-tlv boolean
Tree
Default
false
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
pattern keyword
Synopsis
Test pattern for ETH-test frames
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number eth-test test-pattern pattern keyword
Tree
Default
all-zeros
Options
all-zeros, all-ones
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
grace
Synopsis
Enter the grace context
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number grace
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
eth-ed
Synopsis
Enter the eth-ed context
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number grace eth-ed
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
max-rx-defect-window number
Synopsis
Maximum received ETH-ED expected defect window duration
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number grace eth-ed max-rx-defect-window number
Tree
Range
1 to 86400
Units
seconds
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
priority number
Synopsis
Transmission priority for ETH-ED PDUs
Context
Tree
Range
0 to 7
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
rx-eth-ed boolean
Synopsis
Receive and process ETH-ED ITU-T Y.1731 PDUs on the MEP
Context
Tree
Default
true
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
tx-eth-ed boolean
Synopsis
Transmit ETH-ED PDUs from the MEP
Context
Tree
Default
false
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
eth-vsm-grace
Synopsis
Enter the eth-vsm-grace context
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number grace eth-vsm-grace
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
rx-eth-vsm-grace boolean
Synopsis
Receive and process Nokia ETH-CFM Grace PDU on the MEP
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number grace eth-vsm-grace rx-eth-vsm-grace boolean
Tree
Default
true
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
tx-eth-vsm-grace boolean
Synopsis
Transmit ETH-ED PDUs from the MEP
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number grace eth-vsm-grace tx-eth-vsm-grace boolean
Tree
Default
true
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
low-priority-defect keyword
Synopsis
Lowest priority defect allowed to generate fault alarm
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number low-priority-defect keyword
Tree
Default
all-def
Options
all-def, mac-rem-err-xcon, rem-err-xcon, err-xcon, xcon, no-xcon
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
mac-address string
Synopsis
MAC address of the MEP
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number mac-address string
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
one-way-delay-threshold number
Synopsis
Threshold time limit for one-way delay test
Context
configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number one-way-delay-threshold number
Range
0 to 600
Default
3
Units
seconds
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
port-and-raps-tag string
 | Warning: Modifying this element recreates the parent element automatically for the new value to take effect. |
Synopsis
Port ID and Ring APS tag ID
Context
configure eth-ring number path string port-and-raps-tag string
Tree
String Length
1 to 45
Notes
This element is mandatory.
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
rpl-end boolean
| Warning: Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect. |
Synopsis
Enable path as a Ring Protection Link (RPL) end
Tree
Default
false
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
revert-time number
Synopsis
Revert time for the Ethernet ring
Context
configure eth-ring number revert-time number
Tree
Range
0 | 60 to 720
Default
300
Units
seconds
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
rpl-node keyword
Synopsis
Ring Protection Link (RPL) type for the Ethernet ring
Tree
Options
owner, neighbor
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
sub-ring
Synopsis
Enter the sub-ring context
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
interconnect
Synopsis
Enter the interconnect context
Context
configure eth-ring number sub-ring interconnect
Tree
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
propagate-topology-change boolean
Synopsis
Propagate topology changes
Context
configure eth-ring number sub-ring interconnect propagate-topology-change boolean
Default
false
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
ring-id reference
Synopsis
Ring instance of the connection ring for the sub-ring
Context
configure eth-ring number sub-ring interconnect ring-id reference
Tree
Notes
The following elements are part of a choice: ring-id or vpls.
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS
vpls
Synopsis
Connect sub-ring to VPLS ID that contains sub-ring SAP
Context
configure eth-ring number sub-ring interconnect vpls
Tree
Notes
The following elements are part of a choice: ring-id or vpls.
Introduced
21.7.R1
Platforms
7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS