eth-ring commands

configure 
   —  eth-ring number 
      —  admin-state keyword
      —  apply-groups reference
      —  apply-groups-exclude reference
      —  ccm-hold-time 
         —  down number
         —  up number
      —  compatible-version number
      —  description description-or-empty
      —  guard-time number
      —  node-id mac-address
      —  path string 
         —  admin-state keyword
         —  apply-groups reference
         —  apply-groups-exclude reference
         —  description description-or-empty
         —  eth-cfm 
            —  mep md-admin-name reference ma-admin-name reference mep-id number 
               —  admin-state keyword
               —  alarm-notification 
                  —  fng-alarm-time number
                  —  fng-reset-time number
               —  apply-groups reference
               —  apply-groups-exclude reference
               —  ccm boolean
               —  ccm-ltm-priority number
               —  ccm-padding-size number
               —  control-mep boolean
               —  description description
               —  eth-test 
                  —  bit-error-threshold number
                  —  test-pattern 
                     —  crc-tlv boolean
                     —  pattern keyword
               —  grace 
                  —  eth-ed 
                     —  max-rx-defect-window number
                     —  priority number
                     —  rx-eth-ed boolean
                     —  tx-eth-ed boolean
                  —  eth-vsm-grace 
                     —  rx-eth-vsm-grace boolean
                     —  tx-eth-vsm-grace boolean
               —  low-priority-defect keyword
               —  mac-address mac-unicast-address-no-zero
               —  one-way-delay-threshold number
         —  port-and-raps-tag port-and-encap
         —  rpl-end boolean
      —  revert-time number
      —  rpl-node keyword
      —  sub-ring 
         —  interconnect 
            —  propagate-topology-change boolean
            —  ring-id reference
            —  vpls 
         —  type keyword

eth-ring command descriptions

eth-ring [ring-index] number

Synopsis Enter the eth-ring list instance
Contextconfigure eth-ring number
Treeeth-ring
Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

[ring-index] number

Synopsis Ring ID
Contextconfigure eth-ring number
Treeeth-ring
Range1 to 128

Notes

This element is part of a list key.

Introduced21.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
Contextconfigure eth-ring number admin-state keyword
Treeadmin-state
Optionsenable, disable
Default disable
Introduced21.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
Contextconfigure eth-ring number ccm-hold-time
Treeccm-hold-time
Introduced21.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
Treedown
Range1 to 5000
Unitscentiseconds
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
Treeup
Range0 to 5000
Unitsdeciseconds
Default 20
Introduced21.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
Contextconfigure eth-ring number compatible-version number
Treecompatible-version
Range1 to 2
Default2
Introduced 21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

description description-or-empty

Synopsis Text description
Context configure eth-ring number description description-or-empty
Treedescription
String length0 to 80
Introduced21.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
Treeguard-time
Range1 to 20
Unitsdeciseconds
Default 5
Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

node-id mac-address

Synopsis MAC address of the RPL link
Context configure eth-ring number node-id mac-address
Treenode-id
Introduced21.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
Context configure eth-ring number path string
Treepath
Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

[path-index] string
Synopsis Path ID
Contextconfigure eth-ring number path string
Treepath
String length1

Notes

This element is part of a list key.

Introduced21.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
Contextconfigure eth-ring number path string admin-state keyword
Treeadmin-state
Optionsenable, disable
Default disable
Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

description description-or-empty
Synopsis Text description
Context configure eth-ring number path string description description-or-empty
Treedescription
String length0 to 80
Introduced21.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
Context configure eth-ring number path string eth-cfm
Treeeth-cfm
Introduced21.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
Treemep
Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

md-admin-name reference
Synopsis Maintenance Domain (MD) name
Context configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number
Treemep

Reference

configure eth-cfm domain admin-name

Notes

This element is part of a list key.

Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

mep-id number
Synopsis Maintenance Endpoint (MEP) ID
Context configure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number
Treemep
Range1 to 8191

Notes

This element is part of a list key.

Introduced21.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
Contextconfigure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number alarm-notification
Treealarm-notification

Description

Commands in this context configure the Fault Notification Generator (FNG) time values to raise an alarm or reset the CCM defect alarm. 

Use these timers for network management processes. The timers are not tied into delaying the notification to the fault management system on the network element and do not affect fault propagation mechanisms.

Introduced21.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
Contextconfigure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number ccm-padding-size number
Treeccm-padding-size

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 2 encapsulation. CCM padding is not supported when the CCM interval (configured through configure eth-cfm domain association ccm-interval) is less than 1 second.

Range3 to 1500
Introduced21.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
Treeeth-test

Description

Commands in this context configure information used by the Ethernet Test (ETH-TST) packet. The commands must be configured on both the sender and the receiver nodes. The test packets are used with the oam eth-cfm eth-test command.

Introduced21.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
Contextconfigure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number eth-test test-pattern
Treetest-pattern

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 the receiver.

Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

pattern keyword
Synopsis Test pattern for Ethernet Test frames
Contextconfigure 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
Treepattern

Description

This command specifies the test pattern of the Ethernet Test (ETH-TST) frames. This does not have to be configured the same on the sender and the receiver.

Optionsall-zeros, all-ones
Default all-zeros
Introduced21.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
Treegrace

Description

Commands in this context configure the Nokia ETH-CFM Grace function and the ITU-T Y.1731 Ethernet Expected Default (ETH-ED) function.

Introduced21.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
Treeeth-ed

Description

Commands in this context configure the ITU-T Y.1731 ETH-ED function.

Introduced21.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
Contextconfigure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number grace eth-ed rx-eth-ed boolean
Treerx-eth-ed

Description

This command enables the reception and processing of the ITU-T Y.1731 ETH-ED PDU on the MEP.

Defaulttrue
Introduced21.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
Contextconfigure eth-ring number path string eth-cfm mep md-admin-name reference ma-admin-name reference mep-id number grace eth-vsm-grace
Treeeth-vsm-grace

Description

Commands in this context configure the Nokia ETH-CFM Grace function.

Introduced21.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
Contextconfigure 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
Treerx-eth-vsm-grace

Description

When configured to true, the router enables the Nokia Grace function, which is a vendor-specific PDU that informs MEP peers that the local node may be entering a period of expected defect.

When configured to false, the router disables the Nokia Grace function.

Defaulttrue
Introduced21.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
Treetx-eth-vsm-grace

Description

When configured to true, the router can transmit the Nokia ETH-CFM Grace PDU from the MEP when a system soft reset notification is received for one or more cards.

The Nokia Grace function is a vendor-specific PDU that informs MEP peers that the local node may be entering a period of expected defect.

The operator must configure the configure system eth-cfm grace command to instruct the system that the node is capable of transmitting expected-defect windows to peers. The system can only transmit one form of ETH-CFM grace (Nokia ETH-CFM Grace or ITU-T Y.1731 ETH-ED).

When configured to false, the router disables the transmission of the Nokia ETH-CFM Grace PDU from the MEP.

Defaulttrue
Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

mac-address mac-unicast-address-no-zero
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 mac-unicast-address-no-zero
Treemac-address

Description

This command specifies the MAC address of the MEP.

When unconfigured, the MAC address of the port (if the MEP is on a SAP) or the MAC address of a bridge (if the MEP is on a spoke) is used.

Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

port-and-raps-tag port-and-encap
Warning:

Modifying this element recreates the parent element automatically for the new value to take effect.

SynopsisPort ID and Ring APS tag ID
Contextconfigure eth-ring number path string port-and-raps-tag port-and-encap
Treeport-and-raps-tag
String length1 to 45

Notes

This element is mandatory.

Introduced21.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.

SynopsisEnable path as a Ring Protection Link (RPL) end
Contextconfigure eth-ring number path string rpl-end boolean
Treerpl-end
Defaultfalse
Introduced21.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
Treerevert-time
Range0 | 60 to 720
Unitsseconds
Default 300
Introduced21.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
Contextconfigure eth-ring number rpl-node keyword
Treerpl-node
Optionsowner, 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
Context configure eth-ring number sub-ring
Treesub-ring
Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

interconnect
Synopsis Enter the interconnect context
Contextconfigure eth-ring number sub-ring interconnect
Treeinterconnect
Introduced21.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
Contextconfigure eth-ring number sub-ring interconnect ring-id reference
Treering-id

Reference

configure eth-ring number

Notes

The following elements are part of a choice: ring-id or vpls.

Introduced21.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
Contextconfigure eth-ring number sub-ring interconnect vpls
Treevpls

Notes

The following elements are part of a choice: ring-id or vpls.

Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

type keyword
Synopsis Sub-ring type
Contextconfigure eth-ring number sub-ring type keyword
Treetype
Optionsvirtual-link, non-virtual-link
Introduced21.7.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS