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

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

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

Description

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

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

Default

5 deciseconds

Parameters

value

Specifies the guard-time.

Values

1 to 20 deciseconds

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

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

Description

This command configures eth-ring dampening timers.

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 down-timeout parameter applies only to ring path CCM. It does NOT apply to the ring port link state. To dampen ring port link state transitions, use hold-time parameter from the physical member port.

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 dampen member port link state transitions, use hold-time parameter from the physical member port.

The no form of this command reverts the up and down timer to the default values.

Parameters

down-timeout

Specifies the down timeout, in deciseconds.

Values

0 to 5000

up-timeout

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

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

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

Parameters

owner

Specifies a G.8032 RPL type of owner.

nbr

Specifies a G.8032 RPL type of neighbor.

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

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

Specifies a MAC address in the format 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>sub-ring

Platforms

Supported on all 7210 SAS platforms as described in this document

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

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

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

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

1 to 4094

description

Syntax

description long-description-string

no description

Context

config>eth-ring>path

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds a text description for the ring path.

The no form of this command removes the text description.

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

Description

This command configures the G.8032 path as a ring protection link 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 sets the rpl-end to default no rpl-end.

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

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

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

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

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

Description

This command enables the context 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

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

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

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 will be 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

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

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

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 MAC address of the MEP.

Values

6-byte unicast mac-address (xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx) of the MEP. 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

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

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

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command administratively enables or disables the path.

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

Default

shutdown

shutdown

Syntax

[no] shutdown

Context

config>eth-ring

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command administratively enables/disables the Ethernet ring.

The no form of this command disables/enables the ring.

Default

shutdown

description

Syntax

description long-description-string

no description

Context

config>eth-tunnel

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds a text description for the eth-tunnel.

The no form of this command removes the text description.

Default

‟Eth-tunnel”

Parameters

string

Specifies the text description up to 160 characters.

split-horizon-group

Syntax

split-horizon-group group-name

no split-horizon-group

Context

config>lag

config>port

Platforms

7210 SAS-D and 7210 SAS-Dxp

Description

This command associates a split horizon group to which this port or LAG belongs. For LAGs, all the member ports of the LAG are added to the split horizon group. The split-horizon-group must be configured in the config context.

Configuring or removing the association of the port requires the following conditions to be satisfied:

  • There are no applications associated with the port/lag (like SAPs on the port, and so on).

  • The port or LAG should be administratively shutdown.

  • The port should not be part of a LAG.

  • To change split horizon group of a port or LAG, the old split horizon group should be first removed from the port or LAG, and then the new split horizon group can be configured.

The no form of this command removes the port or all member ports of the LAG from the split horizon group.

Parameters

group-name

Specifies the name of the split horizon group up to 32 characters. The string must be composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.