Ethernet ring commands

eth-ring

Syntax

eth-ring ring-id

no eth-ring

Context

config

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command configures a G.8032 protected Ethernet ring. G.8032 Rings may be configured as major rings with two paths (a&b).

The no form of this command deletes the Ethernet ring specified by the ring ID.

Default

no eth-ring

Parameters

ring-id

Specifies the ring ID.

Values

1 to 128

description

Syntax

description description-string

no description

Context

config>eth-ring

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command adds a text description for the ring.

The no form of this command removes the text description.

Parameters

string

Specifies the text description up to 160 characters.

guard-time

Syntax

guard-time time

no guard-time

Context

config>eth-ring

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command configures the guard time for an Eth-Ring. The guard timer is standard and is configurable from ‟x”ms to 2 seconds

The no form of this command reverts to the default guard-time.

Default

5

Parameters

value

Specifies the guard-time in deciseconds.

Values

1 to 20

revert-time

Syntax

revert-time time

no revert-time

Context

config>eth-ring

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command configures the revert time for an Eth-Ring. It ranges from 60 seconds to 720 second by 1 second intervals.

The no form of this command means non-revertive mode and revert time essentially is 0 meaning the revert timers are not set.

Default

300 seconds

Parameters

value

Specifies the guard-time, in seconds.

Values

60 to 720

ccm-hold-time

Syntax

ccm-hold-time {down down-timeout | up up-timeout}

no ccm-hold-time

Context

config>eth-ring

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command configures Eth-ring dampening timers.

The no form of this command sets the up and down timers to the default values.

down

Syntax

down down-timeout

Context

config>eth-ring>ccm-hold-time

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies the timer, which controls the delay between detecting that ring path is down and reporting it to the G.8032 protection module. If a non-zero value is configured, the CPM will wait for the time specified in the value parameter before reporting it to the G.8032 protection module.

Note:

This parameter applies only to ring path CCM. It does NOT apply to the ring port link state. To damp ring port link state transitions, use hold-time parameter from the physical member port.

Default

0

Parameters

value

Specifies the down timeout in deciseconds.

Values

0 to 5000

up

Syntax

up up-timeout

Context

config>eth-ring>ccm-hold-time

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies the timer, which controls the delay between detecting that ring path is up and reporting it to the G.8032 protection module. If a non-zero value is configured, the CPM will wait for the time specified in the value parameter before reporting it to the G.8032 protection module.

Note:

This parameter applies only to ring path CCM. It does NOT apply to the member port link state. To damp member port link state transitions, use hold-time parameter from the physical member port.

Default

20 deciseconds

Parameters

value

Specifies the hold-time, in deciseconds, for reporting the recovery.

Values

0 to 5000

rpl-node

Syntax

rpl-node <owner | nbr>

no rpl-node

Context

config>eth-ring

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command configures the G.8032 Ring Protection Link (RPL) type as owner or neighbor. When RPL owner or neighbor is specified either the a or b path must be configured with the RPL end command. An owner is responsible for operation of the RPL link. Configuring the RPL as neighbor is optional (can be left as no rpl-node) but if the command is used the nbr is mandatory.

The no form of this command removes the connection to the RPL link.

Default

no rpl-node

node-id

Syntax

node-id mac

no node-id

Context

config>eth-ring

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This optional command configures the MAC address of the RPL control. The default is to use the chassis MAC for the ring control. This command allows the chassis MAC to be overridden with another MAC address.

The no form of this command removes the RPL link.

Default

no node-id

Parameters

mac

<xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx>

sub-ring

Syntax

sub-ring {virtual-link | non-virtual-link}

[no] sub-ring

Context

config>eth-ring

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies this ring-id to be sub-ring as defined in G.8032. By declaring the ring as a sub-ring object, the ring will only have one valid path and the sub-ring will be connected to a major ring or a VPLS instance.

The virtual-link parameter declares that a sub-ring is connected to another ring and that control messages can be sent over the attached ring to the other side of the sub-ring. The non-virtual channel parameter declares that a sub-ring may be connected to a another ring or to a VPLS instance but that no control messages from the sub-ring use the attached ring or VPLS instance. The non-virtual channel behavior is standard G.8032 capability.

The no form of this command deletes the sub-ring and its virtual channel associations.

Default

no sub-ring

Parameters

virtual-link

Specifies the interconnection is to a ring and a virtual link will be used.

non-virtual-link

Specifies the interconnection is to a ring or a VPLS instance and a virtual link will not be used.

compatible-version

Syntax

compatible-version version

[no] compatible-version

Context

config>eth-ring

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command configures the backward compatibility logic for the Ethernet rings.

Default

2

Parameters

version

Specifies the Ethernet ring version.

Values

1 to 2

interconnect

Syntax

interconnect {ring-id ring-index | vpls}

[no] interconnect

Context

config>eth-ring>sub-ring

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command links the G.8032 sub-ring to a ring instance or to a VPLS instance. The ring instance must be a complete ring with two paths but may be a sub-ring or a major ring (declared by its configuration on another node). When the interconnection is to another node, the sub-ring may have a virtual link or a non-virtual-link. When the sub-ring has been configured with a non-virtual link, the sub ring may be alternatively be connected to a VPLS service. This command is only valid on the interconnection node where a single sub-ring port connects to a major ring or terminates on a VPLS service.

The no form of this command removes interconnect node.

Default

no interconnect

Parameters

ring-index

Specifies the ring index of the connection ring for this sub-ring on this node.

Values

1 to 128

vpls

Specifies that the sub- ring is connected to the VPLS instance that contains the sub-ring SAP. This parameter is not supported on 7210 SAS platforms configured in the access-uplink operating mode.

propagate-topology-change

Syntax

propagate-topology-change

[no] propagate-topology-change

Context

config>eth-ring>sub-ring>interconnect

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command configures the G.8032 sub-ring to propagate topology changes. From the sub-ring to the major ring as specified in the G.8032 interconnection flush logic. This command is only valid on the sub-ring and on the interconnection node. Because this command is only valid on a Sub-ring, a virtual link or non-virtual link must be specified for this command to be configured. The command is blocked on major rings (when both path a and b are specified on a ring).

The no form of this command sets propagate to the default

Default

no propagate-topology-change

path

Syntax

path {a | b} [{port-id} raps-tag qtag[.qtag]]

[no] path {a | b}

Context

config>eth-ring

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command assigns the ring (major or sub-ring) path to a port and defines the Ring APS tag. Rings typically have two paths, a and b.

The no form of this command removes the path a or b.

Default

no path

Parameters

path

Specifies the path.

Values

a, b

port-id

Specifies the port ID.

Values

slot/mda/port

qtag [.qtag]

Specifies the qtag. For Dot1q, only the first qtag is used. For QinQ, both qtags can be used.

Values

Dot1q: 1 to 4094

Values

QinQ: (1 to 4094).(1 to 4094)

description

Syntax

description long-description-string

no description

Context

config>eth-ring>path

config>eth-ring>path>eth-cfm>mep

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command adds a text description for the ring path.

The no form of this command removes the text description.

Default

‟”

Parameters

string

Specifies the text description up to 160 characters.

rpl-end

Syntax

rpl-end

no rpl-end

Context

config>eth-ring>path

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command configures the G.8032 path as a Ring Protection Link (RPL) end. The ring should be declared as either a RPL owner or RPL neighbor for this command to be allowed. Only path a or path b can be declared an RPL-end.

The no form of this command reverts to default.

Default

no rpl-end

eth-cfm

Syntax

eth-cfm

Context

config>eth-ring>path

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

Commands in this context configure ETH-CFM parameters.

mep

Syntax

[no] mep mep-id domain md-index association ma-index

Context

config>eth-ring>path>eth-cfm

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command provisions an 802.1ag maintenance endpoint (MEP).

The no form of this command reverts to the default values.

Parameters

mep-id

Specifies the maintenance association (MA) end point identifier.

Values

1 to 81921

md-index

Specifies the maintenance domain (MD) index value.

Values

1 to 4294967295

ma-index

Specifies the MA index value.

Values

1 to 4294967295

ccm-enable

Syntax

[no] ccm-enable

Context

config>eth-ring>path>eth-cfm>mep

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command enables the generation of CCM messages.

The no form of this command disables the generation of CCM messages.

ccm-ltm-priority

Syntax

ccm-ltm-priority priority

no ccm-ltm-priority

Context

config>eth-ring>path>eth-cfm>mep

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies the priority value for CCMs and LTMs transmitted by the MEP.

The no form of this command removes the priority value from the configuration.

Default

the highest priority on the bridge-port

Parameters

priority

Specifies the priority of CCM and LTM messages.

Values

0 to 7

control-mep

Syntax

[no] control-mep

Context

config>eth-ring>path>eth-cfm>mep

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command enables the usage of the CC state by the Ethernet ring for consideration in the protection algorithm. The use of control-mep command is recommended if fast failure detection is required, especially when Link Layer OAM does not provide the required detection time.

The no form of this command disables the use of the CC state by the Ethernet ring.

Default

no control-mep

control-sap-tag

Syntax

control-sap-tag tag-range

no control-sap-tag

Context

config>eth-ring>path>eth-cfm>mep

Platforms

7210 SAS-T, 7210 SAS-Sx/S 1/10GE (standalone and standalone-VC), 7210 SAS-Mxp, 7210 SAS-R6 and 7210 SAS-R12

Description

To support sub-second CCM timers in hardware for G.8032 MEPs, users must reserve a VLAN tag value for exclusive use by G.8032 MEPs configured for a particular ring port (for the MEP configured under the path command). This command tells the system which VLAN tag is reserved for use with this G.8032 MEP. This value can be the same one as configured with raps-tag value. This command turns on the sub-second CCM timers for this MEP. The system checks that the configured value is not in use by any SAP (as a SAP tag) configured on the port and not in use as a control-sap-tag by any other G.8032 instance on that port. A maximum of four hardware-based control MEPs can be configured on a port.

The VLAN should be reserved for all port encapsulation type. NULL encapsulated port, dot1q encapsulated port, and QinQ encapsulated ports that need to use G.8032 MEPs with sub-second CCM timers need to reserve a VLAN for use. Every G.8032 instance configured for the port needs a VLAN value reserved for its use. Each G.8032 ring instance must use a different VLAN value, not in use currently by any other G.8032 instance on the same port.

Note:

  • Users must ensure that the VLAN value specified as control-sap-tag must not be received as the outermost VLAN tag on any of the SAPs in use on the same port. For example, if control-sap-tag is configured as 550, then any SAP (NULL, dot1q, dot1q Default SAP, Q1.Q2 SAP, Q1.* SAP) configured on the port cannot receive any CFM packet that matches the VLAN tag 550.

  • Configuration of the control-sap-tag command is interoperable with other devices. This is an internal tag used for processing CCMs in the fastpath. This tag is not sent on the wire.

The no form of this command reverts the ring port to use the raps-tag value configured for the path and use of 1-second CCM timers.

Parameters

tag-range

Specifies the tag range.

Values

512 to 768, 10 ms and 100 ms CCM timer support (7210 SAS-Mxp)

512 to 768, 100 ms CCM timer support (7210 SAS-T in network mode)

512 to 768,10 ms and 100 ms CCM timer support; control-sap-tag range must be mentioned under resource profile (7210 SAS-Sx/S 1/10GE)

3000 to 3512, 10 ms and 100 ms CCM timer support, control-sap-tag range must be mentioned under resource profile (7210 SAS-R6 and 7210 SAS-R12)

eth-test-enable

Syntax

[no] eth-test-enable

Context

config>eth-ring>path>eth-cfm>mep

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command enables eth-test functionality on MEP. For this test to work, operators need to configure ETH-test parameters on both sender and receiver nodes. The ETH-test then can be done using the following OAM commands:

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 for both the provisioning and test to ensure the MEP is an Y.1731 MEP (MEP provisioned with domain format none, association format icc-based). If not, the operation fails. An error message in the CLI and SNMP will indicate the problem.

test-pattern

Syntax

test-pattern {all-zeros | all-ones} [crc-enable]

no test-pattern

Context

config>eth-ring>path>eth-cfm>mep>eth-test-enable

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command configures the test pattern for Eth-test frames.

The no form of this command removes the values from the configuration.

Default

all-zeros

Parameters

all-zeros

Specifies to use all zeros in the test pattern.

all-ones

Specifies to use all ones in the test pattern.

crc-enable

Specifies that a CRC checksum is generated.

bit-error-threshold

Syntax

bit-error-threshold bit-errors

Context

config>eth-ring>path>eth-cfm>mep

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies the lowest priority defect that is allowed to generate a fault alarm.

Default

1

Parameters

bit-errors

Specifies the lowest priority defect.

Values

0 to 11840

low-priority-defect

Syntax

low-priority-defect {allDef | macRemErrXcon | remErrXcon | errXcon | xcon | noXcon}

Context

config>eth-tunnel>path>eth-cfm>mep

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies the lowest priority defect that is allowed to generate a fault alarm.

Default

remErrXcon

Parameters

allDef

Specifies that the lowest priority defects allowed to generate a fault alarm are DefRDICCM, DefMACstatus, DefRemoteCCM, DefErrorCCM, and DefXconCCM.

macRemErrXcon

Specifies that the lowest priority defects allowed to generate a fault alarm are DefMACstatus, DefRemoteCCM, DefErrorCCM, and DefXconCCM.

remErrXcon

Specifies that the lowest priority defects allowed to generate a fault alarm are DefRemoteCCM, DefErrorCCM, and DefXconCCM.

errXcon

Specifies that the lowest priority defects allowed to generate a fault alarm are DefErrorCCM and DefXconCC.

xcon

Specifies that the lowest priority defect allowed to generate a fault alarm is DefXconCCM.

noXcon

Specifies that no defects DefXcon or lower are to be reported.

mac-address

Syntax

mac-address mac-address

no mac-address

Context

config>eth-ring>path>eth-cfm>mep

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies the MAC address of the MEP.

The no form of this command reverts the MAC address of the MEP back to that of the port (if the MEP is on a SAP) or the bridge (if the MEP is on a spoke-SDP).

Parameters

mac-address

Specifies the 6-byte unicast MAC address of the MEP.

Values

xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx (Using the all zeros address is equivalent to the no form of this command).

one-way-delay-threshold

Syntax

one-way-delay-threshold seconds

Context

config>eth-ring>path>eth-cfm>mep

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command enables one way delay threshold time limit.

Default

3 seconds

Parameters

priority

Specifies the value for the threshold, in seconds.

Values

0 to 600

shutdown

Syntax

[no] shutdown

Context

config>eth-ring>path>eth-cfm>mep

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command administratively enables or disables the MEP.

The no form of this command disables or enables the MEP.

Default

shutdown

shutdown

Syntax

[no] shutdown

Context

config>eth-ring>path

config>eth-ring

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command administratively enables or disables the path.

The no form of this command disables or enables the path.

Default

shutdown

resource-profile

Syntax

resource-profile

Context

config>system

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command configures the system resource profile.

g8032-fast-flood-enable

Syntax

g8032-fast-flood-enable

no g8032-fast-flood-enable

Context

config>system>resource-profile

Platforms

7210 SAS-T

Description

This command enables the G.8032 fast-flood feature.When this command is executed it is stored in the configuration file after admin save is executed. A system reboot is required for this command to take effect.

Nokia recommends to enable this command to improve service failover time due to failures in the ring path. When fast flood is enabled, on a failure detection in one of the paths of the eth-ring, along with MAC flush the system starts to flood the traffic onto the available path.

If this command is present in the configuration file, on reboot the system allocates resources for G.8032, by reducing the amount of resources available for use with ACLs. When this command is used, G.8032 fast-flood needs an entire chunk with ‟512” entries; therefore, the amount of resources available for use with ACLs is reduced by ‟512”. The user needs to free up resources used by ACLs and make them available for use by G.8032, before enabling this command.The user should ensure that the resource usage of ACLs has been appropriately modified before reboot, to make way for use of this feature.User can free up resources either disabling the use of ACLs with a SAP or deleting a SAP, so that an entire chunk of 512 entries is available.

Before enabling the g8032-fast-flood-enable command the user must check if sufficient resources are available.The tools>dump>system-resources command is available to check if sufficient resources are available.The field 'Ingress Shared CAM Entries' shown in the output below of tools>dump>system-resources command, must be more than or equal to 512 (free column in the output shown below).

                           | Total | Allocated | Free
-------------------------------+-----------+-----------+------------
Ingress Shared CAM Entries | 0     | 0         | 512

If the configuration file contains a no form of this command, then the system does not allocate any resources for use by G.8032.The entire resource pool is available for use by ACLs.

The no form of this command takes effect only on reboot.

Default

no g8032-fast-flood-enable