Card, MDA, and port command reference

Context

config>port

config>lag

Platforms

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

Description

This command creates a text description for a configuration context to help identify the content in the configuration file.

The no form of this command removes any description string from the context.

Parameters

long-description-string

Specifies the description character string. Strings can be up to 160 characters 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.

Context

config>card

config>card>mda

config>port

config>port>ethernet

config>lag

config>port>ethernet>efm-oam

config>port>ethernet>ssm

config>redundancy>multi-chassis>peer>mc-lag

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 disables an entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics.

The operational state of the entity is disabled as well as the operational state of any entities contained within.

The no form of this command administratively enables an entity.

Default

card — no shutdown

mda — no shutdown

lag — shutdown

mc-lag — shutdown

port — shutdown

Special Cases

MC-LAG protocol handling for 7210 SAS-Mxp

When the no shutdown command is issued in the config>redundancy>multi-chassis>peer>mc-lag context, resources are allocated to enable the node to process the protocol.

The resources are deallocated when you issue the config>redundancy>multi-chassis>peer>mc-lag>shutdown command.

Context

config

Platforms

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

Description

This mandatory command enables the chassis card Input/Output Module (IOM), slot, and MDA CLI context.

The no form of this command cannot be used on fixed IOM and MDA cards that are auto equipped and auto provisioned.

Default

the IOM card is equipped and provisioned for slot 1

Parameters

slot-number

Specifies the slot number of the card in the chassis.

Context

config>card

Platforms

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

Description

This command configures the card slot. The card type can be preprovisioned, meaning that the card does not need to be installed in the chassis.

A card must be provisioned before an MDA or port can be configured.

A card can only be provisioned in a slot that is vacant, meaning no other card can be provisioned (configured) for that particular slot.

A card can only be provisioned in a slot if the card type is allowed in the slot. An error message is generated if an attempt is made to provision a card type that is not allowed.

A high severity alarm is raised if an administratively enabled card is removed from the chassis. The alarm is cleared when the correct card type is installed or the configuration is modified. A low severity trap is issued when a card is removed that is administratively disabled.

An appropriate alarm is raised if a partial or complete card failure is detected. The alarm is cleared when the error condition ceases.

In a virtual chassis (VC), when the TiMOS image boots up on the CPM-IMM and the IMM-only cards/nodes, users must provision the card type on each member node so that the software knows which hardware platforms are members of the VC. The software can then determine the logical IMM types that are part of the VC. Provisioning the card type is a mandatory step in the bring up of virtual chassis system in order for all the member nodes to be fully functional.

The no form of this command cannot be used as the IOM card is fixed.

Default

the IOM card is equipped and preprovisioned for slot 1

Parameters

card-type

Specifies the type of card to be configured and installed in that slot.

Values

iom-sas (7210 SAS-Mxp, and 7210 SAS-Sx/S 1/10GE (standalone))

imm-sas-10sfp+1xfp | imm-sas-10sfp | imm-sas-2xfp | imm-sas-b-4sfp+ | imm-sas-b-2sfp+ | imm-sas-b-10sfp-1sfp+ | imm-sas-b-11csfp | imm-sas-b-16tx | imm-sas-c-1qsfp28 (7210 SAS-R6)

imm-sas-b-4sfp+ | imm-sas-b-4xfp | imm-sas-b-2sfp+ | imm-sas-b-10sfp-1sfp+ | imm-sas-b-11csfp | imm-sas-b-16tx | imm-sas-c-1qsfp28 (7210 SAS-R12)

sas-sx-24sfp-4sfpp | sas-sx-48sfp-4sfpp | sas-sx-24t-4sfpp | sas-sx-48t-4sfpp | sas-s-24sfp-4sfpp | sas-s-48sfp-4sfpp | sas-s-24t-4sfpp | sas-s-48t-4sfpp | sas-sx-24tp-4sfpp | sas-sx-48tp-4sfpp | sas-s-24tp-4sfpp | sas-s-48tp-4sfpp (7210 SAS-Sx 1/10GE (standalone-vc))

Context

config>card

Platforms

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

Description

This command attaches the system resource-profile policy. The system resource profile parameters are defined as a policy. The user must configure the system resource profile policy and associate it with the IMM card. The software reads the configured policy and allocates resources appropriately per IMM card. It allows users to allocate resources to different features per IMM card.

For more information about the CLI descriptions for System Resource Profile parameters, see the 7210 SAS-Mxp, R6, R12, S, Sx, T Basic System Configuration Guide.

Default

system attaches the default system resource-profile to each IMM when it is booted up

Parameters

policy-id

Specifies the system resource profile policy to use for this card.

Values

1 to 16

Context

config>card

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 MDA CLI context to configure MDAs.

Parameters

mda-slot

Specifies the MDA slot number to be configured. Fixed ports on the panel of the chassis belong to MDA 1.

Values

1

Context

config>card>mda

Platforms

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

Description

This command configures a specific MDA type to the device configuration for the slot. The MDA can be preprovisioned but an MDA must be provisioned before ports can be configured. Ports can be configured after the MDA is correctly provisioned.

All 7210 SAS platforms (unless noted otherwise) support a fixed MDA. The fixed MDA (addressed as mda 1) is auto-equipped and auto-provisioned on boot up. It cannot be deleted. An error message is shown in case a no mda-type command is executed on a fixed MDA.

The no form of this command deletes the MDA from the configuration.

Default

MDA 1 is auto-equipped and auto-provisioned by default during boot up

Parameters

mda-type

Specifies the type of MDA selected for the slot position.

Values

7210 SAS-T, 7210 SAS-Sx/S 1/10GE, 7210 SAS-Sx 10/100GE, 7210 SAS-Mxp — The logical MDA with fixed ports is auto-provisioned

7210 SAS-R6, 7210 SAS-R12 — The logical MDA (which is named based on the type of IMM) is auto-provisioned

Context

config>card>mda

Platforms

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

Description

This command enables Synchronous Ethernet on the Ethernet ports that support Synchronous Ethernet. When Synchronous Ethernet is enabled, the timing information is derived from the Ethernet ports.

Synchronous Ethernet is supported for both Ethernet SFP ports and fixed copper ports. It is highly recommended to use copper port only for distribution of synchronous Ethernet and not as a reference.

See the 7210 SAS-Mxp, R6, R12, S, Sx, T Basic System Configuration Guide for more information about Synchronous Ethernet.

The no form of this command disables Synchronous Ethernet on the MDA.

Default

no sync-e

Context

config>port

Platforms

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

Description

Commands in this context configure egress and ingress pool policy parameters.

Context

config>port

Platforms

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

Description

Commands in this context configure egress and ingress pool policy parameters.

Context

config>port>access

Platforms

7210 SAS-T

Description

Commands in this context configure access pool parameters.

Context

config>port>access

config>port>network

config>port>uplink

Platforms

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

Description

Commands in this context specify the slope policy that is configured in the config>qos>slope-policy context.

Context

config>port>ethernet>access

Platforms

7210 SAS-Mxp, 77210 SAS-R6, and 7210 SAS-R12.

Description

This command configures Ethernet access ingress port QoS parameters.

Context

config>port>access>egress

config>port>network>egress

config>port>access>uplink>egress

Platforms

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

Description

Commands in this context configure the slope policy for the queues associated with this port.

Default

default

Parameters

name

Specifies the pool name, a string up to 32 characters 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

Context

config>port>access>egress>pool

config>port>access>uplink>pool

config>port>network>egress

Platforms

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

Description

This command specifies an existing slope policy which defines high and low priority RED slope parameters and the time average factor. The policy is defined in the config>qos>slope-policy context.

Parameters

name

Specifies the policy name, a string up to 32 characters.

Context

config>port>ethernet>access>egress

Platforms

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

Description

This command associates a access-egress QoS policy to the access port.

On 7210 SAS-T operating in access uplink mode, this policy is used to enable port-based marking and configuring port-based queue parameters. For more information, see the 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide.

On 7210 SAS-T operating in network mode, this policy is used to enable port-based marking and configuring port-based queue parameters. For more information, see the 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide.

On 7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, when SAP based egress queuing is configured, this policy is to used configure only marking values for packets sent out of access ports. For more information, see the 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide and the 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide.

On 7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, when port-based queues are used on access ports, this policy is used to configure marking values and to configure the port-based queue parameters. For more information, see the 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide and the 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide.

On 7210 SAS-Sx/S 1/10GE(standalone and standalone-VC) and 7210 SAS-Sx 10/100GE, this policy is used to enable port-based marking and configuring port-based queue parameters. For more information, see the 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide.

The no form of this command removes the explicit association of a user configured QoS policy and associates a default QoS policy with the port.

Parameters

policy-id

Specifies an existing QoS policy to be assigned to the port.

Values

1 to 65535

Context

config>port>ethernet>access>uplink

Platforms

Only supported on 7210 SAS platforms configured in the access-uplink operating mode

Description

This command associates a network QoS policy to the access-uplink port.

On 7210 SAS-T operating in access uplink mode, this policy is used to enable marking on egress and classification and metering/policing on port ingress. For more information, see the 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide.

The no form of this command removes the explicit association of a user configured QoS policy and associates a default QoS policy with the port.

Parameters

policy-id

Specifies an existing QoS policy to be assigned to the port.

Values

1 to 65535

Context

config>port>ethernet>network

Platforms

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

Description

This command associates a network QoS policy to a network port.

Parameters

policy-id

Specifies an existing QoS policy to be assigned to the network port.

Values

1, 3 to 65535

Context

config>port>ethernet>access>egress

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

Commands in this context configure override values for the specified queue. These values will override the values specified in the associated access egress QoS policy.

The no form of this command removes all existing queue override commands.

Context

config>port>ethernet>access>egress>queue-override

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

Commands in this context modify the queue parameters associated with a particular queue.

The no form of this command removes the queue override commands for this queue.

Parameters

queue-id

Specifies the ID of the queue.

Values

1 to 8

Context

config>port>ethernet>access>egress>queue-override>queue

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command overrides the adaptation-rule CIR and PIR values defined in the access egress QoS policy assigned to the port.

This command defines the method used by the system to derive the operational CIR and PIR settings when the queue is provisioned in hardware. For the CIR and PIR parameters individually, the system attempts to derive the best operational rate depending on the defined constraint.

The no form of this command removes adaptation-rule override parameters on the queue and applies the adaptation-rule defined for the queue in the access egress QoS policy.

Default

no adaptation-rule

Parameters

pir

Specifies the constraints enforced when adapting the PIR defined within the queue queue-id rate command. The pir parameter requires a qualifier that defines the constraint used when deriving the operational PIR for the queue. When the rate command is not specified, the default constraint applies.

cir

Specifies the constraints enforced when adapting the CIR defined within the queue queue-id rate command. The cir parameter requires a qualifier that defines the constraint used when deriving the operational CIR for the queue. When the cir parameter is not specified, the default constraint applies.

max | min | closest

Specifies the criteria to use to compute the operational CIR and PIR values for this queue, while maintaining a minimum offset.

Values

max — The max (maximum) option is mutually exclusive with the min and closest options. The hardware step size varies with the configured rate.

min — The min (minimum) option is mutually exclusive with the max and closest options. The hardware step size varies with the configured rate.

closest — The closest parameter is mutually exclusive with the min and max parameter. The hardware step size varies with the configured rate.

Context

config>port>ethernet>access>egress>queue-override>queue

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command overrides the percent-rate or rate CIR and PIR values defined in the access egress QoS policy assigned to the port.

The percent-rate command enables support for configuring a queue PIR and CIR as a percentage of the egress port line rate (that is, the port limit). When the rates are expressed as a port limit, the actual rates used per instance of the queue will vary based on the port speed or the configured port egress rate. For example, when the same QoS policy is used on a 1 Gigabit and a 10 Gigabit Ethernet port, the queue rates will be 10 times greater on the 10 Gigabit port because of the difference in port speeds.

If the port speed changes after the queue is created, the queue PIR and CIR will be recalculated based on the defined percentage value.

The rate and percent-rate commands override one another. If the current rate for a queue is defined using the percent-rate command and the rate command is executed, the percent-rate values are deleted. Similarly, the percent-rate command causes any rate command values to be deleted. A queue rate may dynamically be changed back and forth from a percentage to an explicit rate at anytime.

The no form of this command, when defined within an egress queue-override command, reverts to the defined PIR and CIR within the access egress QoS policy associated with the queue.

Default

no percent-rate

Parameters

cir cir-percent

Specifies the queue CIR as a percentage that is dependent on the use of the port-limit.

Values

0.00 to 100.00

Default

0.00

pir pir-percent

Specifies the queue PIR as a percentage that is dependent on the use of the port-limit.

Values

0.01 to 100.00

Default

100.00

Context

config>port>ethernet>access>egress>queue-override>queue

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command overrides the queue management policy defined in the access egress QoS policy assigned to the port.

This command associates the specified queue management policy with this queue.

The queue management policy specifies the queue buffer parameters and queue slope policy parameters.

The no form of this command associates the queue management policy for this queue as defined in the access egress QoS policy.

Default

no queue-mgmt

Parameters

name

Specifies the name of the queue management policy, up to 32 characters.

Context

config>port>ethernet>access>egress>queue-override>queue

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command overrides the queue mode defined in the access egress QoS policy assigned to the port.

This command determines whether the queue operates in strict or weighted mode.

The no form of this command associates the queue-mode for this queue as defined in access egress QoS policy.

Default

no queue-mode

Parameters

queue-mode

Specifies the queue mode.

Values

strict: Setting the queue mode to strict mode influences the CIR loop and the PIR loop. In both the CIR loop and the PIR loop, the scheduler schedules the queues in the order of their priority (that is, the weights are disregarded).

weighted: Setting the queue mode to weighted mode influences the CIR loop and the PIR loop as follows.

• In the CIR loop, the scheduler distributes the available bandwidth to all the strict and then to all the weighted queues in round-robin fashion, up to the configured CIR rate.

• In the PIR loop, after examining all the strict queues, the scheduler examines the weighted queues and distributes the available bandwidth, if any, in the proportion of the configured weights.

Context

config>port>ethernet>access>egress>queue-override>queue

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command overrides the CIR and PIR values defined in the access egress QoS policy assigned to the port.

This command defines the administrative PIR and the administrative CIR parameters for the queue. The PIR defines the maximum rate at which the queue can transmit packets through the port. Defining a PIR does not necessarily guarantee that the queue can transmit at the intended rate. The actual rate sustained by the queue can be limited by oversubscription factors or available egress bandwidth. The CIR defines the rate at which the system prioritizes the queue over other queues competing for the same bandwidth.

The rate command can be executed at anytime, altering the PIR and CIR for all queues created on the access ports.

The rate and percent-rate commands override one another. If the current rate for a queue is defined using the percent-rate command and the rate command is executed, the percent-rate values are deleted. Similarly, the percent-rate command causes any rate command values to be deleted. A queue rate may dynamically be changed back and forth from a percentage to an explicit rate at anytime.

The no form of this command removes the percent-rate parameter and applies the rate or percent-rate as specified for the queue in access egress QoS policy.

Default

no rate

Parameters

cir cir-rate

Specifies that the cir parameter overrides the default administrative CIR used by the queue. If the rate command is not executed or the cir parameter is not explicitly specified, the default CIR value is used.

Values

0 to 100000000, max

Default

0

pir pir-rate

Specifies the administrative PIR rate, in kilobits, for the queue. When the rate command is executed, a PIR setting is optional. If the rate command is not executed, the default PIR of maximum value is used.

Values

0 to 100000000, max

Default

max — The max keyword implies the maximum port Ethernet speed or the egress-port rate.

Context

config>port>ethernet>access>egress>queue-override>queue

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command overrides the weight defined in the access egress QoS policy assigned to the port.

For queues configured with queue-mode in weighted mode, weight values are considered only in the PIR loop. That is, in the CIR loop the CIR of the queues are met if bandwidth is available, and in the PIR loop the configured weight values determine the proportion of available bandwidth allocated to this queue relative to other queues configured in weighted mode.

The no form of this command removes the configured queue-override weight value and applies the weight value as defined in access-egress QoS policy for that queue.

Default

no weight

Parameters

weight

Specifies the weight value. The value is an integer that specifies the proportion of available bandwidth to be allocated to this queue relative to other queues.

Values

1 to 15

Context

config>port>ethernet>access>ingress

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command associates a dot1p classification policy with an Ethernet port.

The dot1p classification policy is applicable only when table-based classification is enabled on the access port. It is used to classify only bridged packets received on this port and processed in the context of an RVPLS service with a SAP configured on this port. The dot1p classification policy defines the mapping of IP dot1p values to forwarding class (FC) and profile (in-profile or out-profile).

The no form of this command removes the dot1p classification policy from its association with the Ethernet port.

Default

no dot1p-classification

Parameters

policy-id

Specifies the policy ID.

Values

1 to 65535

Context

config>port>ethernet>access>ingress

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command associates a DSCP classification policy with an Ethernet port.

The DSCP classification policy is applicable only when table-based classification is enabled on the access port. It is used to classify only bridged packets received on this port and processed in the context of an RVPLS service with a SAP configured on this port. The DSCP classification policy defines the mapping of IP DSCP values to forwarding class (FC) and profile (in-profile or out-profile).

The no form of this command removes the DSCP classification policy from its association with the Ethernet port.

Default

no dscp-classification

Parameters

policy-id

Specifies the policy ID.

Values

1 to 65535

Context

config>port>ethernet>access>ingress

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command assigns a default FC and profile to non-IP Ethernet packets received on this port and processed in the context of an RVPLS service that has a SAP configured on this port.

Non-IP tagged and untagged packets are assigned the untagged-fc fc because they do not have a DSCP field available to match in the DSCP classification policy.

The no form of this command reverts the assigned FC to the default value.

Default

be

Parameters

fc

Specifies the fc value.

Values

be | l2 | af | l1 | h2 | ef | h1 | nc

Default

be

Context

config>port>ethernet>access>ingress

Platforms

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

Description

This command associates an access ingress policy with an access port configured to use the port-mode option in the configure port ethernet access-ingress-qos-mode command.

The qos command is ignored if the configure port ethernet access-ingress-qos-mode command is configured to use the sap-mode option.

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

Default

qos 1

Parameters

policy-id

Specifies the access ingress QoS policy ID.

Values

1 to 65535

Context

config

Platforms

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

Description

This command configures ports. Before a port can be configured, the chassis slot must be provisioned with a valid card type and the MDA parameter must be provisioned with a valid MDA type. (See card and mda commands.)

Parameters

port-id

Specifies the physical port ID in the slot/mda/port format.

Context

config>port

Platforms

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

Description

This command configures the Dense Wavelength Division Multiplexing (DWDM) parameters.

Context

config>port>dwdm

Platforms

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

Description

This command configures the Dense Wavelength Division Multiplexing (DWDM) ITU channel at which a tunable MDA optical interface will be configured to operate. It is expressed in a form that is derived from the laser's operational frequency. For example, 193.40 THz corresponds to DWDM ITU channel 34 in the 100 GHz grid and 193.45 THz corresponds to DWDM ITU channel 345 in the 50 GHz grid. A provisioned MDA type must have DWDM tunable optics (m1-10gb-dwdm-tun).

The DWDM channel must set to a non-zero value before the port is set to no shutdown.

The port must be shut down before changing the DWDM channel.

The DWDM channel must be on a physical port.

Parameters

channel

Specifies the channel.

Values

0, 17 to 61, 175 to 605
where:	17 to 61 is used for 100GHz channels
	175, 185 to 605 is used for 50GHz channels
	0 only valid on disabled (shutdown) ports

Context

config>port>ethernet

config>lag

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 DEI based classification on access ports, network ports, access-uplink or hybrid ports.

If enabled, DEI value in the Ethernet packet header is used to determine the initial profile/color of the packet when the meter/policer used to police the FC is configured in color-aware mode. If the meter used to police the FC is configured in color-blind mode, then the DEI value of the packet has no effect. When in color-aware mode, DEI value of 0 is interpreted as in-profile or green packet and DEI value of 1 is interpreted as out-of-profile or yellow packet. In color-aware mode, the following behavior is accorded to packets classified with initial profile/color as in-profile/green and out-of-profile/yellow:

• If a green packet is received and the color-aware meter is within the CIR rate, then packet is assigned a final profile of green and it is assigned a final profile of yellow if the meter exceeds the CIR rate and is within the PIR rate.

• If a yellow packet is received and the color-aware meter is above the CIR rate and within the PIR rate, then the packet is assigned a final profile of yellow.

That is, in color-aware mode, yellow/out-of-profile packets cannot eat into the CIR bandwidth. It is exclusively reserved for green/in-profile packets.

The final profile assigned at ingress is used by egress to determine the WRED slope to use. The WRED slope determines whether the packet is eligible to be assigned a buffer and can be queued up on egress queue for transmission.

For more information, see the 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide.

Default

no enable-dei

Context

config>port>ethernet

Platforms

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

Description

This command enables the provisioning of an existing port-scheduler-policy to a port or channel.

The default scheduling done for a port is strict scheduling. When a port-scheduler-policy is applied to the port, the scheduling behavior changes to the one specified in the policy (Strict, RR, WRR, WDRR, WRR/WDRR + Strict).

The no form of this command removes the associated default port scheduler policy from an egress port.

Parameters

port-scheduler-policy-name

Specifies an existing port-scheduler-policy configured in the config>qos context.

Context

config>port>ethernet

config>lag

Platforms

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

Description

Access: An access port is used for customer facing traffic on which services are configured. A Service Access Point (SAP) can only be configured on an access port. When a port is configured for access mode, the appropriate encap-type must be specified to distinguish the services on the port. Once an Ethernet port has been configured for access mode, multiple services can be configured on the Ethernet port.

Access-uplink: Access-uplink ports are used to provide native Ethernet connectivity in service provider transport or infrastructure network. This can be achieved by configuring port mode as access uplink. With this option, the encap-type can be configured to only qinq. Access-uplink SAPs, which are QinQ SAPs, can only be configured on an access uplink port to allow the operator to differentiate multiple services being carried over a single access uplink port. It is supported only on 7210 SAS-T configured in access-uplink mode.

Network: A network port participates in the service provider transport or infrastructure network when a network mode is selected. When the network option is configured, the encap-type can be configured to either null or dot1q.

Hybrid: A hybrid Ethernet port allows the combination of network and access modes of operation on a per-VLAN basis and must be configured as either dot1q or QinQ encapsulation. When the hybrid port is configured to the dot1q encapsulation, the user configures a SAP inside a service by providing the SAP ID which must include the port-id value of the hybrid mode port and an unused VLAN tag value. The format is <port-id>:qtag1. A SAP of format <port-id>:* is also supported. The user configures a network IP interface under config>router>interface>port by providing the port name which consists of the port-id of the hybrid mode port and an unused VLAN tag value. The format is <portid>:qtag1.

The user must explicitly enter a valid value for qtag1. The <port-id>:* value is not supported on a network IP interface. The 4096 VLAN tag space on the port is shared among VLAN SAPs and VLAN network IP interfaces. When the hybrid port is configured to QinQ encapsulation, the user configures a SAP inside a service by providing the SAP ID which must include the port-id value of the hybrid mode port and the outer and inner VLAN tag values.

The format is <port-id>:qtag1.qtag2. A SAP of format <port-id>: qtag1.* is also supported. The outer VLAN tag value must not have been used to create an IP network interface on this port. In addition, the qtag1.qtag2 value combination must not have been used by another SAP on this port. The user configures a network IP interface under config>router>interface>port by providing the port name which consists of the port-id of the hybrid mode port and a VLAN tag value. The format is <portid>:qtag1.*. An outer VLAN tag qtag2 of * is used to create an IP network interface. In addition, the qtag1.qtag2 value combination must not have been used on another SAP or IP network interface on this port.

The no form of this command reverts to the default.

Default

network

Parameters

network

Specifies that the Ethernet port is configured as service access (available only in network mode).

access

Specifies that the Ethernet port is configured for transport network use.

access uplink

Specifies that the Ethernet port is configured for transport (Ethernet uplinks available only in access-uplink mode).

hybrid

Specifies that the Ethernet port is configured for hybrid use (available only in network mode).

Context

config>port>ethernet

Platforms

7210 SAS-T (access-uplink), 7210 SAS-Sx/S 1/10GE (standalone), and 7210 SAS-Sx 10/100GE (standalone)

Description

This command specifies the operational group to be monitored by the object under which it is configured. The oper-group name must be already configured in the config>system context before its name is referenced in this command.

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

Default

no monitor-oper-group

Parameters

name

Specifies a character string of maximum 32 ASCII characters identifying the existing group instance.

Context

config>port>ethernet

config>lag

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 a specific MAC address to an Ethernet port, Link Aggregation Group (LAG), or Ethernet tunnel.

Only one MAC address can be assigned to a port. When multiple mac commands are entered, the last command overwrites the previous command. When the command is issued while the port is operational, IP will issue an ARP, if appropriate, and BPDUs are sent with the new MAC address.

The no form of this command reverts the MAC address to the default value.

Default

a default MAC address is assigned by the system from the chassis MAC address pool

Parameters

ieee-address

Specifies the 48-bit MAC address in the form aa:bb:cc:dd:ee:ff or aa-bb-cc-dd-ee-ff where aa, bb, cc, dd, ee and ff are hexadecimal numbers. Allowed values are any non-broadcast, non-multicast MAC and non-IEEE reserved MAC addresses.

Context

config>port>ethernet

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 maximum payload MTU size for an Ethernet port. The Ethernet port level MTU parameter indirectly defines the largest physical packet the port can transmit or the far-end Ethernet port can receive. Packets received larger than the MTU will be discarded. Packets that cannot be fragmented at egress and exceed the MTU are discarded.

The value specified for the MTU includes the destination MAC address, source MAC address, the Ethertype or Length field and the complete Ethernet payload. The MTU value does not include the preamble, start of frame delimiter or the trailing CRC.

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

Default

The default MTU value depends on the (sub-)port type, mode, and encapsulation. Default MTU values lists the default MTU values.

Parameters

mtu-bytes

Sets the maximum allowable size of the MTU, expressed as an integer.

Values

512 to 9212

Context

config>port>ethernet

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures Layer 2 or Layer 3 multicast egress replication on a port. That is, with RVPLS IGMPv3 snooping-based multicast, a port on which receivers are present can be configured to do either Layer 2 multicast replication—where IP TTL is not decremented and the source MAC address is not replaced with the 7210 SAS chassis MAC or IP interface MAC address—or Layer 3 multicast replication—where IP TTL is decremented and the source MAC address is replaced.

This command is supported in network mode

All SAPs on the specified port have the same behavior, therefore the reference to port instead of SAP in the following behavior description:

• If the l3-fwd keyword is used, then for both IP multicast and RVPLS IGMP snooping multicast traffic forwarded out of the specified port, the following processing is done:

  • For IP multicast traffic processed in the context of RVPLS service, the source MAC address is replaced with the chassis MAC address if no IP interface is associated with the RVPLS service. If there is an IES IP interface associated with RVPLS service, the IES interface MAC address is used. In addition, the IP TTL value is decremented by one.

  • For IP multicast traffic processed in the context of IES or VPRN IP interface, the source MAC address is replaced with the MAC address of the IP interface. In addition, the IP TTL value is decremented by 1. If the IP TTL is not greater than 0, the packet is dropped.

• If the l2-switch keyword is used, then for both IP multicast and RVPLS IGMP snooping multicast traffic forwarded out of the specified port, the following processing is done:

  • For IP multicast traffic processed in the context of RVPLS service, the source MAC address is not replaced. Instead, the original MAC address in the packet is retained. In addition, the IP TTL value is not decremented.

  • Users must not enable IP multicast on this port.

Default

l3-fwd

Parameters

l2-switch

Specifies that IGMP snooping on the port (egress) with Layer 2 multicast lookup is enabled.

l3-fwd

Specifies that IP multicast (Layer 3) lookups on the port (egress) is enabled.

Context

config>port>ethernet

Platforms

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

Description

This command turns on either IP multicast or IGMP snooping on a port. The l2-mc and ip-mc options are mutually exclusive.On 7210 SAS port ingress, either IGMP snooping Layer 2 multicast lookup can be enabled or IP multicast Layer 3 multicast lookup can be enabled.

The ip-mc keyword must be enabled on ports where multicast sources are located and an RVPLS SAP is configured to receive the multicast streams.

Default

l2-mc

Parameters

l2-mc

Specifies that IGMP snooping on the port (ingress) with Layer 2 multicast lookup is enabled.

ip-mc

Specifies that IP multicast (Layer-3) lookups on the port (ingress) is enabled. This parameter is not supported on 7210 SAS-Sx 10/100GE platforms.

Context

config>port

Platforms

7210 SAS-T, 7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx 1/10GE, and 7210 SAS-Sx 10/100GE

Description

This command enables Precision Time Protocol (PTP) port-based hardware timestamping on the port in both egress and ingress directions. For more information about PTP port-based hardware timestamping, including configuration guidelines, see the 7210 SAS-Mxp, R6, R12, S, Sx, T Basic System Configuration Guide.

The no version of this command disables PTP port-based hardware timestamping on the port.

Default

ptp-hw-timestamp

Context

config>system

Platforms

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

Description

This command specifies the port to assign for system use when using port loopback with the following tools: mac-swap, mirroring, testhead OAM, and NG-MVPN, when the node is acting as a P2MP bud router on the 7210 SAS-R6 or 7210 SAS-R12. When configured, the system uses the resources of the port, and the port is not available for configuring services.

A single port cannot be shared among these tools simultaneously. The system displays an error if users attempt to configure the same port for use with multiple OAM tools or use the tool without first configuring the port resources for the tool.

To use these OAM tools simultaneously, this command must be executed once for each OAM tool with a different port ID. For example, users can dedicate two ports for use by executing the loopback-no-svc-port mirror 1/1/1 command for use with the mirroring OAM tool, followed by the loopback-no-svc-port mac-swap 1/1/2 command for use by the mac-swap OAM tool.

Alternatively, users can dedicate two ports by executing the loopback-no-svc-port testhead 1/1/1 command for use by the testhead OAM tool, followed by executing the loopback-no-svc-port mac-swap 1/1/2 command for use by the mac-swap OAM tool.

The system verifies whether any services are configured on the port specified using this command; if services are configured, the command fails.

The no form of this command disables the use of this port by the specified OAM tool.

Parameters

mac-swap-port-id

Specifies that the loopback port (in the slot/mda/port format) is dedicated for use by the mac-swap OAM tool.

mirror-port-id

Specifies that the loopback port (in the slot/mda/port format) is dedicated for use by the mirroring OAM tool.

testhead-port-id

Specifies that the loopback port (in the slot/mda/port format) is dedicated for use by the testhead OAM tool.

p2mpbud-port-id

Specifies the loopback port (in the slot/mda/port format) to use for P2MP LSP, which is used with NG-MVPN feature. Applicable only to 7210 SAS-R6 and 7210 SAS-R12 devices.

p2mp-bud-classification

Keyword to enable ingress FC classification for packets that are received on a P2MP LSP on a network port IP interface and that are replicated to IP multicast receivers. This keyword allows users to prioritize multicast traffic to IP receivers in the service. In addition, it enables the capability to mark the packet with IP DSCP values while sending the multicast stream out of the IP interface. Applicable only to 7210 SAS-R6 and 7210 SAS-R12 devices.

Note:

Before using this keyword, users must ensure that sufficient resources are available in the network ingress CAM resource pool and MPLS EXP ingress profile map resource pool. Use the tools>dump>system-resources command to check resource availability.

Context

config>port

Platforms

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

Description

Commands in this context configure Ethernet port attributes.

This context can only be used when configuring Fast Ethernet, gigabit, or 10Gig Ethernet LAN ports on an appropriate MDA.

Context

config>port>ethernet

Platforms

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

Description

This command configures an Ethernet port for access, network, or hybrid mode of operation.

An access port or channel is used for customer facing traffic on which services are configured. A Service Access Point (SAP) can only be configured on an access port or channel. When a port is configured for access mode, the appropriate encap-type must be specified to distinguish the services on the port. Once an Ethernet port has been configured for access mode, multiple services can be configured on the Ethernet port.

A network port or channel participates in the service provider transport or infrastructure network when a network mode is selected. When the network option is configured, the encap-type cannot be configured for the port/channel.

When network mode is selected on a SONET/SDH path, the appropriate control protocols are activated when the need arises. For example, configuring an IP interface on the SONET path activates IPCP while the removal of the IP interface causes the IPCP to be removed. The same applies for MPLS, MPLSCP, and OSICP. When configuring a SONET/SDH port, the mode command must be entered in the channel context or an error message is generated.

The no form of this command reverts to the default.

Default

network

Parameters

access

Specifies that the Ethernet port is configured as service access.

network

Specifies that the Ethernet port is configured for transport network use.

hybrid

Specifies that the Ethernet port is configured for hybrid use.

Context

config>port>ethernet

config>lag

Platforms

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

Description

This command configures either a per-SAP ingress QoS policy or a per-port access ingress QoS policy on the access port.

This command is supported only in the high SAP scale mode, which is configured using the config>system>resource-profile>sap-scale-mode high command on the 7210 SAS-Mxp, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE, and the config>system>global-res-profile>sap-scale-mode high command on the 7210 SAS-R6 and 7210 SAS-R12.

When the access-ingress-qos-mode command is configured on the access port with the sap-mode option specified, per-SAP ingress QoS policies are used for SAPs configured on the port. Attempts to attach an access ingress QoS policy fail.

When the access-ingress-qos-mode command is configured with the port-mode option specified, access ingress QoS policies associated with the port are used for ingress classification and metering and policing. If a user-defined access ingress QoS policy is associated with the port, the user must reset the access ingress policy ID to 1 before changing access-ingress-qos-mode to sap-mode; otherwise, the change fails.

When the user enables the access-ingress-qos-mode command with the port-mode option, the IP DSCP and dot1p classification policies configured in the context of the access port ingress QoS are used. See the 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide and 7210 SAS-Mxp, R6, R12, S, Sx, T Quality of Service Guide for more information about the config qos access-ingress command.

LAG member ports can be configured to use either the sap-mode or port-mode; a mix of the two modes is not allowed. When operating in port-mode, all LAG members have the same access ingress QoS policy as the primary LAG member. The policy defines the classification and policing rates for all traffic received on all ports of the LAG. For example, if the user configures the classification entry dot1p 7 to FC nc and the meter 1 CIR and PIR to 100 Mb/s and 2 Gb/s respectively, traffic received on the LAG member ports with a dot1p value of 7 are assigned FC nc at ingress and are rate-limited to 2 Gb/s. For inter-card LAG scenarios, each card is programmed separately for 2 Gb/s.

A node can have a mix of ports configured as access, hybrid, and network ports, where some access ports are configured to use sap-mode access ingress QoS and other access ports are configured to use port-mode access ingress QoS.

SAPs configured on ports in hybrid port mode cannot be configured to use per-port access ingress QoS policies.

Before configuring the access-ingress-qos-mode command with the port-mode option specified, use the configure system resource-profile ingress-internal-tcam qos-access-port-ingress-resource command to allocate the appropriate resources from the ingress-internal-tcam resource pool for use by the access ingress QoS policies. If no resources are allocated, changing the existing access ingress QoS mode to port-mode will fail. In addition, if access ports are currently configured to use port-mode access ingress QoS, setting the qos-access-port-ingress-resource command to 0 is not allowed.

In addition, before executing this command, the user must ensure that access port scheduling is configured using the configure system resource-profile qos port-scheduler-mode command on the 7210 SAS-Mxp, and the configure system global-res-profile qos port-scheduler-mode command on the 7210 SAS-R6 and 7210 SAS-R12, after which high SAP scale mode can be configured using the sap-scale-mode high command. This is a per-node configuration and requires a node reboot for the change to take effect. The node must be rebooted in the high SAP scale mode and qos-access-port-ingress-resource must have enough resources to change the access-ingress-qos-mode command to port-mode.

Default

access-ingress-qos-mode sap-mode

Parameters

sap-mode

Keyword to enable the access ingress QoS SAP mode; that is, per-SAP ingress QoS policies are used for SAPs configured on the access port.

port-mode

Keyword to enable the access ingress QoS port mode; that is, access ingress QoS policies associated with the access port are used for ingress classification and metering and policing.

Context

config>port>ethernet

Platforms

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

Description

This command configures Ethernet access port QoS parameters.

Context

config>port>ethernet>access

Platforms

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

Description

This command configures Ethernet access egress port QoS parameters.

Context

config>port>ethernet

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 speed and duplex autonegotiation on Fast Ethernet ports and enables far-end fault indicator support on Gigabit ports.

There are three possible settings for autonegotiation:

• ‟on” or enabled with full port capabilities advertised

• ‟off” or disabled where there are no autonegotiation advertisements

• ‟limited” where a single speed/duplex is advertised.

When autonegotiation is enabled on a port, the link attempts to automatically negotiate the link speed and duplex parameters. If autonegotiation is enabled, the configured duplex and speed parameters are ignored.

When autonegotiation is disabled on a port, the port does not attempt to autonegotiate and will only operate at the speed and duplex settings configured for the port.

If the autonegotiate limited keyword option is specified the port will autonegotiate but will only advertise a specific speed and duplex. The speed and duplex advertised are the speed and duplex settings configured for the port. One use for limited mode is for multispeed gigabit ports to force gigabit operation while keeping autonegotiation enabled for compliance with IEEE 801.3.

7210 SAS requires that autonegotiation be disabled or limited for ports in a Link Aggregation Group to guarantee a specific port speed.

The no form of this command disables autonegotiation on this port.

Default

autonegotiate

Parameters

limited

Specifies that the Ethernet interface will automatically negotiate link parameters with the far end, but will only advertise the speed and duplex mode specified by the Ethernet speed and duplex commands.

Context

config>port>ethernet

Platforms

7210 SAS-Mxp and 7210 SAS-Sx 1/10GE (fiber variants only)

Description

This command configures the connection type on the Ethernet combo port. The combo port provides two physical interface options to the user, SFP or copper. This command allows the user specify the physical interface to use.

When configured as an SFP port, the combo port allows for fiber-based connectivity with the flexibility of using suitable optics for longer reach. When configured as a fixed copper port, it provides cheaper connectivity for shorter reach. The SFP port supports speeds of 100/1000 Mb/s and the copper port can support speeds of 10/100/1000 Mb/s.

The combo port can be configured either as an SFP port or a copper port. That is, both the interfaces cannot be used simultaneously.

Default

connection-type sfp

Parameters

connection-type

Specifies the type of Ethernet combo port.

Values

sfp, copper, auto

Context

config>port>ethernet

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 Ethernet CRC Monitoring parameters.

Context

config>port>ethernet>crc-monitor

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 error rate at which to declare the Signal Failure condition on an Ethernet interface.

The value represents a ratio of errored frames over total frames received over seconds of the sliding window. The CRC errors on the interface are sampled once per second. A default of 10 seconds is used when there is no additional window-size configured. The multiplier keyword is optional.

The no form of this command reverts to the default value of 1. If the multiplier keyword is omitted, the multiplier will revert to the default value of 1.

Default

no sd-threshold

Parameters

threshold

Specifies the rate of CRC errored Ethernet frames.

Values

1 to 9

multiplier

Specifies the multiplier used to scale the CRC error ratio.

Values

1 to 9

Context

config>port>ethernet>crc-monitor

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 error rate at which to declare the Signal Degrade condition on an Ethernet interface.

The value represents a ratio of errored frames over total frames received over seconds of the sliding window. The CRC errors on the interface are sampled once per second. A default of 10 seconds is used when there is no additional window-size configured. The multiplier keyword is optional.

The no form of this command reverts to the default value of 1. If the multiplier keyword is omitted, the multiplier will revert to the default value of 1.

Default

no sf-threshold

Parameters

threshold

Represents the rate of CRC errored Ethernet frames.

Values

1 to 9

multiplier

Represents the multiplier used to scale the CRC error ratio.

Values

1 to 9

Context

config>port>ethernet>crc-monitor

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 sliding window size over which the Ethernet frames are sampled to detect signal fail or signal degrade conditions. The command is used jointly with the sf-threshold and the sd-threshold to configure the sliding window size.

Default

10

Parameters

seconds

Specifies the size of the sliding window in seconds over which the errors are measured.

Values

5 to 60

Context

config>port>ethernet

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 system to allow to bring a port operationally down in the event the systems has detected internal max transmit errors.

Default

no down-on-internal-error

Context

config>port>ethernet

Platforms

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

Description

This command specifies the Ethertype expected when the port's encapsulation type is dot1q. Dot1q encapsulation is supported only on Ethernet interfaces.

When the dot1-etype is configured to a value other than 0x8100 (the default value) on a port, the outermost tag in the received packet is matched against the configured value and if there is a match then it is treated as a Dot1q packet and the VLAN ID is used to match against the configured Dot1q SAPs on the port to find the Dot1q SAP the packet should be matched to.

The no form of this command reverts the dot1q-etype value to the default.

Default

0x8100

Parameters

value

Specifies the Ethertype to expect.

Values

0x0600 to 0xffff — or 1536 to 65535

Context

config>port>ethernet

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 duplex of a Fast Ethernet port when autonegotiation is disabled. If the port is configured to autonegotiate this parameter is ignored.

Default

full

Parameters

full

Sets the link to full duplex mode

half

Sets the link to half duplex mode

Context

config>port>ethernet

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 EFM-OAM attributes.

Context

config>port>ethernet>efm-oam

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 reactions to loopback control OAM PDUs from peers.

The no form of this command disables reactions to loopback control OAM PDUs.

Default

no accept-remote-loopback

Context

config>port>ethernet>efm-oam

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 mode of OAM operation for this Ethernet port. These two modes differ in that active mode causes the port to continually send out efm-oam info PDUs while passive mode waits for the peer to initiate the negotiation process. A passive mode port cannot initiate monitoring activities (such as loopback) with the peer.

Default

active

Parameters

active

Provides capability to initiate negotiation and monitoring activities.

passive

Relies on peer to initiate negotiation and monitoring activities.

Context

config>port>ethernet>efm-oam

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 transmit interval of OAM PDUs.

The minimum efm-oam session time-out value supported is 300 milliseconds. That is, user can configure "transmit-interval 1 multiplier 3" as the minimum value.

Default

transmit-interval 10 multiplier 5

Parameters

interval

Specifies the transmit interval in 100s of milliseconds.

Values

1 to 600

multiplier multiplier

Specifies the multiplier for transmit-interval to set local link down timer.

Values

2 to 5

Context

config>port>ethernet>efm-oam

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 EFM OAM PDU tunneling. Enabling tunneling will allow a port mode Epipe SAP to pass OAM frames through the pipe to the far end.

The no form of this command disables tunneling.

Default

no tunneling

Context

config>port>ethernet

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 rate of traffic leaving the network.

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

Default

no egress-rate

Parameters

sub-rate

Specifies the egress rate, in kilobits per second (kbps).

Values

1 to 10000000

max-burst size-in-kbits

Specifies the maximum egress burst, in kilobits (Kbits).

Values

32 to 16384

Context

config>port>ethernet

config>lag

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12.

Description

This command enables the use of a table-based IP DSCP classification policy to assign FC and profile to RVPLS bridged IP packets received on access port ingress. This command works in conjunction with the SAP ingress QoS policy associated with the RVPLS service. The match-criteria entries from the RVPLS SAP ingress policy are ignored and instead the IP DSCP classification is used to assign the FC and profile. Only meters from the SAP ingress policy are used to rate-limit the traffic mapped to different FCs.

The DSCP classification policy that is enabled by the enable-table-classification command is specified in the config>port>ethernet>access>ingress context, using the dscp-classification command.

This command has no effect on a network port.

The no form of this command disables the use of a DSCP classification policy for RVPLS bridged packets.

Default

no enable-table-classification

Context

config>port>ethernet

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 encapsulation method used to distinguish customer traffic on an Ethernet access port, or different VLANs on a network port.

The no form of this command reverts to the default.

Default

null

Parameters

dot1q

Specifies that ingress frames carry 802.1Q tags where each tag signifies a different service.

null

Specifies that ingress frames will not use any tags to delineate a service. As a result, only one service can be configured on a port with a null encapsulation type.

qinq

Specifies QinQ encapsulation for QinQ access SAPs.

Context

config>port>ethernet

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command allows rate changes received in ETH-BN messages on a port-based MEP to update the egress rate used on the port. The egress rate is capped by the minimum of the configured egress-rate and the maximum port rate.

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

Default

no eth-bn-egress-rate-changes

Context

config>port>ethernet

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

Commands in this context configure 802.1ag CFM parameters.

Context

config>port>ethernet>eth-cfm

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command provisions the maintenance endpoint (MEP).

The no form of this command removes the configuration.

Default

no mep

Parameters

mep-id

Specifies the maintenance association endpoint identifier.

Values

1 to 8191

md-index

Specifies the maintenance domain (MD) index value.

Values

1 to 4294967295

ma-index

Specifies the MA index value.

Values

1 to 4294967295

Context

config>port>ethernet>eth-cfm>mep

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

Commands in this context configure ETH-BN message handling.

Context

config>port>ethernet>eth-cfm>mep>eth-bn

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command enables the reception and processing of ETH-BN messages, and the retrieval and processing of the current bandwidth field for inclusion in dynamic egress rate adjustments.

The received rate is a Layer 2 rate, and is expected to be in Mb/s. If this rate is a link rate (including preamble, start frame delimiter, and inter-frame gap), it requires the configuration of frame-based accounting in the config>port>ethernet context.

The no form of this command disables the reception and processing of ETH-BN messages.

Default

no receive

Context

config>port>ethernet>eth-cfm>mep>eth-bn

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command sets the pace for update messages to and from the ETH-CFM subsystem to the QoS subsystem. The most recent update messages are held by the ETH-CFM subsystem, but the most recent update is held until the expiration of the pacing timer.

Default

rx-update-pacing 5

Parameters

seconds

Specifies the time to wait before sending subsequent updates (in seconds).

Values

1 to 600

Context

config>port>ethernet

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 port link dampening timers, which reduce the number of link transitions reported to upper layer protocols. The hold-time value is used to dampen interface transitions.

When an interface transitions from an up state to a down state, it is immediately advertised to the rest of the system if the hold-time down interval is 0, but if the hold-time down interval is greater than 0, interface down transitions are not advertised to upper layers until the hold-time down interval has expired. When an interface transitions from a down state to an up state, it immediately advertised to the rest of the system if the hold-time up interval is 0, but if the hold-time up interval is greater than 0 interface, up transitions are not advertised until the hold-time up interval has expired.

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

Default

down 0 seconds — No port link down dampening is enabled, link down transitions are immediately reported to upper layer protocols

up 0 seconds — No port link up dampening is enabled, link up transitions are immediately reported to upper layer protocols

Parameters

up hold-timeup

Specifies the interval, in seconds or centiseconds, before an interface transitions from a down state to an up state is reported to upper layer protocols.

Values

0 to 36000 seconds

0, 10 to 3600000 in centiseconds in 5-centisecond increments

down hold-time down

Specifies the interval, in seconds or centiseconds, before an interface transitions from an up state to a down state is reported to upper layer protocols.

Values

0 to 36000 seconds

0, 10 to 3600000 in centiseconds in 5-centisecond increments

seconds | centiseconds

Specifies the unit of measurement for the hold time.

Context

config>port>ethernet

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 LACP packet tunneling for the Ethernet port. When tunneling is enabled, the port will not process any LACP packets but will tunnel them instead. The port cannot be added as a member to a LAG group.

The no form of this command disables LACP packet tunneling for the Ethernet port.

Default

no lacp-tunnel

Context

config>port>ethernet

Platforms

7210 SAS-T ETR, 7210 SAS-Mxp, 7210 SAS-Sx 1/10GE fiber variants (standalone mode), and 7210 SAS-Sx/S 1/10GE copper PoE variants (standalone mode)

Description

This command enables PoE on this port and allows only 802.3af (Type 1) low-power devices to be connected to the port.

Using the plus parameter enables users to connect Type 2 devices (that is, high-powered devices) compliant to 802.3at standards to the port.

This command must be used to enable PoE on a port before connecting a PoE device to the port. After a port is enabled for PoE, software attempts to detect the type of PoE device (that is, PoE or PoE+ device) connected to the port and the power it is requesting when a PoE device is connected to the port. If the detection is successful and the power request is within the budget that the platform supports, then power is supplied to the connected device. If not, power is not supplied to the port.

The no form of this command disables PoE and PoE+ on this port. If PoE is disabled, the software does not attempt to detect the characteristics of the PoE device connected to the port and not supply power to the port.

Parameters

plus

Specifies the parameter poe-plus to allow support of 802.3at (Type-2) high power devices to be connected to the port.

Context

config>port>ethernet

config>lag

Platforms

Only supported on 7210 SAS platforms configured in the access-uplink operating mode

Description

This command associates the context to the operational group specified in the group-name. The oper-group group-name must be already configured under config>system context before its name is referenced in this command.

The no form of this command removes the association.

Parameters

name

Specifies a character string of maximum 32 ASCII characters identifying the group instance.

Context

config>port>ethernet

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 Ethertype used for Q-in-Q encapsulation.

When the qinq-etype is configured on a port with a value other than the default, the outermost tag in the received packet is matched against the configured value and the inner tag's etype is matched against the default. If there is a match then it is treated as a QinQ packet and the outer VLAN ID and inner VLAN ID is used to match against the configured Q1.Q2 SAPs on the port to find the QinQ SAP the packet should be matched to. If only the outermost tag's etype matches the qinq-etype configured on the port and the VLAN ID matches any of the Q1.* SAP configured on the port, the packet is processed in the context of that SAP. If the outermost tag's etype does not match the configured qinq-etype, then the packet is considered to be a untagged packet.

The no form of this command reverts the qinq-etype value to the default. The default value is not user configurable.

Default

0x8100

Parameters

value

Specifies the qinq-etype to expect.

Values

0x0600 to 0xffff or 1536 to 65535

Ensure that the values do not match any of the IEEE reserved Ethertype values such as 0x8a88, 0x9100, and 0x9200.

Context

config>port>ethernet

Platforms

7210 SAS-R6 and 7210 SAS-R12 with IMM-c QSFP28 card, and 7210 SAS-Sx 10/100GE QSFP28

Description

This command enables Reed–Solomon Forward Error Correction (RS-FEC) on the Ethernet port.

The no form of this command disables RS-FEC.

Default

no rs-fec-mode

Parameters

rs-fec-mode

Specifies the RS-FEC mode to support.

Values

c191-514-528

Context

config>port>ethernet

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 when and if to generate alarms and alarm clear notifications for this port.

Parameters

signal-fail

Specifies an Ethernet signal lost alarm.

remote

Specifies remote faults.

local

Specifies local faults.

Context

config>port>ethernet

Platforms

7210 SAS-T (network and access-uplink), 7210 SAS-R6 and 7210 SAS-R12 (16-port copper IMM-sas-r-b (IMMv2), Combo ports of 7210 SAS-Mxp, Combo ports on 7210 SAS-Sx 1/10GE fiber variant (standalone), and all copper variants of 7210 SAS-Sx/S 1/10GE (standalone)

Description

This command forces the copper port to be a master or slave. Using a value of master ensures that the local node is the syncE master. A syncE master port, distributes the system timing over the copper port to the remote peer node. Using a value of slave ensures that the local node is a syncE slave. A syncE slave port uses the incoming timing information.

With copper ports using 1G speed, the nodes need to determine who will be the master and slave with respect to clock used for transmission and reception. The master-slave relationship between the two ports of the nodes is determined during auto-negotiation of the link parameters and is automated; there is no management intervention in this process. Once this process is complete, the master port transmit clock will be used for receiving the packets on the slave port. However, when syncE is in use, to maintain clock distribution hierarchy (for example, master will be synchronized to a stable reference and will distribute this clock to the slave) one needs to make sure that one of the ports behave as a master while the remote port of the link in question behaves as a slave.

The following conditions must be met before using syncE on the fixed port copper ports:

1. Auto-negotiation (or auto-negotiation limited) must be turned on.

2. This command is required only when the copper port speed is set to 1Gbps.

3. This CLI command is not supported for fiber ports or for fiber ports that use Copper SFPs.

The no form of this command allows the node to automatically determine the master or slave status for the copper port based on the nodes capabilities exchanged during auto-negotiation. That is, depending on the peer setting, the local end could end up as either a master or a slave when the no form of the command is used.

Parameters

master

Specifies that the local node is the synchronous Ethernet master. A synchronous Ethernet master port distributes the system timing over the copper port to the remote peer node.

slave

Specifies that the local node is a synchronous Ethernet slave. A synchronous Ethernet slave port uses the incoming timing information.

Context

config>port>ethernet

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 port speed of an Ethernet port when autonegotiation is disabled. If the port is configured to autonegotiate, this parameter is ignored.

Speed cannot be configured for ports that are part of a Link Aggregation Group (LAG).

Supported values depend on the speed of the Ethernet interface supported on the platform.

On the 7210 SAS-S 1/10GE and 7210 SAS-Sx 1/10GE (copper variants), and on the 7210 SAS-Sx 10/100GE, if 1GE fiber-optic SFPs are used in SFP+ ports, the SFP+ ports must be set to 1000 Mb/s.

SFP+ ports that support SFPs do not support speeds of 10 Mb/s or 100 Mb/s.

Default

varies depending on platform

Parameters

10

Sets the link to 10 Mb/s.

100

Sets the link to 100 Mb/s.

1000

Sets the link to 1000 Mb/s.

10000

Sets the link to 10 000 Mb/s.

Context

config>port>ethernet

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 simple port loopback and port loopback with MAC swap. The command when the optional parameter 'internal' is specified, provides the port loopback without the mac-swap functionality. It enables physical layer loopback of the packets that egress on the SAPs created on a Ethernet port. The packets that egress are looped back into the node instead of being transmitted on to the line. After loopback, the packets ingress the system and are mapped to the same SAP from which they were egressed. The packets that are looped back are processed as per the service configuration of the SAP.

The command when used with service-id and MAC address, provides the port loopback with mac-swap functionality. It enables a physical layer loopback, so that packets which egress on the SAPs created on an Ethernet port are looped back into the system. After loopback, on ingress to the system, the MAC addresses in the Ethernet header are swapped (that is, the source MAC address and destination MAC address is exchanged with each other) by the system before being processed as per the service configuration of the SAP.

On 7210 SAS platforms, use of port loopback with mac-swap, requires resources of another port to be assigned for system use. Users need to assign the resources of either internal virtual port or the resource of the front panel port for use with this OAM tool using the command configure> system> loopback-no-svc-port {mirror | mac-swap| testhead} port-id. The number of internal virtual port resources available for use in different for different platforms and can be obtained using the command show> system> internal-loopback-ports detail. Based on the number of internal virtual port resources and the use of other OAM tool that require the resources of another port, the user may need to assign the resources of a front-panel port if the internal virtual port resources are not available.

Physical layer loopback is used with external third-party Ethernet test devices to diagnose provisioning issues and test end-to-end performance metrics of a service.

For Port loopback without mac-swap:

• Use this command for testing VLL services.

• Enabling this command for testing VPLS services leads to rapid MAC address movement to another port, as source or destination MAC address swap is not performed.

• This command affects all services provisioned on the port.

• Before enabling this command, turn off all layer 2 and IP control protocols (such as LACP, EFM, 802.1x and so on) on the device and its peer to prevent errors such as protocol flaps resulting from timeout and so on.When port loopback feature is to be used for multicast traffic with IGMP snooping enabled in the service, the corresponding datapath has to be statically created using static IGMP groups.

• For loop back to be functional, the following are not required:

  • SFP or XFPs need not be inserted into the device.

  • Ethernet cables need not be plugged in for copper ports.

• When the loop back command is enabled, ensure that Ethernet parameters such as, speed, duplex, auto-negotiation and so on are not modified.

For port loopback with mac-swap:

• This command is available for testing VLL services and VPLS services only.

• When enabled, the command affects all services provisioned on the port.

• Before enabling this command, turn off all layer 2 and IP control protocols (such as LACP, EFM, 802.1x and so on) on the device and its peer to prevent errors such as protocol flaps because of timeout and so on.When port loopback feature is to be used for multicast traffic with IGMP snooping enabled in the service, the corresponding datapath has to be statically created using static IGMP groups.

• When using port loopback with mac-swap enabled, for unicast and unknown-unicast packets, if the packet matches the configured source and destination MAC address it will be swapped and looped back in the service. For broadcast and multicast packets, if the packet matches the configured source MAC address, its source MAC address will be used as the destination MAC address and the system MAC address will be the source MAC address. The packet is looped back in the service as a unicast packet. All other packets sent to the loopback port will be dropped since forwarding of these packets after loopback can potentially cause network wide problems.

• For loop back to be functional, the following are not required:

  • SFP or XFPs need not be inserted into the device.

  • Ethernet cables need not be plugged in for copper ports.

• When the loop back is enabled, ensure that Ethernet parameters such as, speed, duplex, auto-negotiation and so on are not modified.

• When the loopback is enabled, ensure that service parameter and attributes such as ingress qos policy, accounting records, ingress/egress ACLs, and so on are not modified.

  • With port loopback in use, the SAP ingress ACLs with IP-criteria is not recommended for use, since only MAC addresses are swapped.

The recommended procedure for using port loopback with mac-swap is:

• Configure the service and SAP on which loopback is to be enabled.

• Configure the assigned loopback port to be used.

• Send bidirectional learning frames on the SAP under test and spoke or uplink from a traffic tester or one can install static MAC for this purpose. Installing a static MAC is highly recommended because the recommended procedure for enabling port loopback is to shutdown the port –> enable loopback and then execute no shutdown the port.

• Enable port loopback and specify the service, SAP, and the source MAC address (SA) and the destination MAC address (DA). All packets with source MAC matching SA are the only ones processed in the context of the SAP on ingress after the loopback. Any other traffic is dropped on ingress to avoid issues resulting from MAC movement and flooding issues in other services/SAPs because the whole port is in loopback.

• When the port is in loopback, software disable learning and aging on the specified SAP. After the loopback configuration is removed for the port, then the software enables learning and aging for specified SAP. Therefore, port loopback with mac-swap cannot be used for learning or aging.

• It is not recommend to change the service parameters for the SAP and the service when loopback is active. Additionally use of commands which clears the FDB, and so on is highly discouraged.

• Remove the loopback on the SAP port to bring the sap out of MAC swap with loopback mode

The no form of this command disables physical layer loopback on the Ethernet port.

Listed below is the recommended sequence of commands to be executed to perform loop back:

1. Disable the port, execute the command config>port>shutdown.

2. Enable loop back, execute the command config>port>ethernet>loopback internal

3. Enable the port, execute the command config>port>no shutdown.

4. Perform the required tests.

5. Disable the port, execute the command config>port>shutdown.

6. Disable loop back, execute the command config>port>ethernet>no loopback internal

7. Enable the port, execute the command config>port>no shutdown.

8. Enable the required services.

Listed below is the recommended sequence of commands to be executed to perform loop back when SFP or XFPs are inserted into the device:

1. Insert SFP or XFPs. SFP or XFPs are not required in case of fixed copper ports.

2. Enable the port and execute the command config>port>[no] shutdown.

3. Disable the port and execute the command config>port>shutdown.

4. Enable loop back and execute the command config>port>ethernet>loopback internal.

5. Enable the port and execute the command config>port>no shutdown.

6. Perform the required tests.

7. Disable the port and execute the command config>port>shutdown.

8. Disable loop back and execute the command config>port>ethernet>no loopback internal

9. Enable the port and execute the command config>port>no shutdown.

10. Enable the required services.

Listed below is the sequence of commands to be executed to perform loop back when SFP or XFPs are changed:

1. Disable the port, execute the command config>port>shutdown.

2. Insert the new SFP or XFP.

3. Enable the port and execute the command config>port>no shutdown.

4. Disable the port and execute the command config>port>shutdown.

5. Enable loop back and execute the command config>port>ethernet>loopback internal.

6. Enable the port and execute the command config>port>no shutdown.

7. Perform the required tests.

8. Disable the port and execute the command config>port>shutdown.

9. Disable loop back and execute the command config>port>ethernet>no loopback internal.

10. Enable the port and execute the command config>port>no shutdown.

11. Enable the required services.

Parameters

service svc-id

Specifies the unique service identification number or string identifying the service in the service domain. This ID must be unique to this service and may not be used for any other service of any type. The service-id must be the same number used for every on which this service is defined.

Values

service-id 1 to 2147483648

sap <sap-id>

Specifies the physical port identifier portion of the SAP.

Values

sap-id null	- <port-id>
dot1q	- <port-id>:qtag1
qinq	- <port-id>:qtag1.qtag2
port-id	- slot/mda/port[.channel]
id	- 1 to 1000
qtag1	- 0 to 4094
qtag2	- *|1 to 4094

src-mac <SA>

Specifies the source MAC address.

Values

SA 6-byte unicast mac-address (xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx).

dst-mac <DA>

Specifies the destination MAC address.

Values

DA 6-byte unicast mac-address (xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx).

Context

config>port>ethernet

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 Ethernet Synchronous Status Message (SSM).

Context

config>port>ethernet>ssm

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 encoding of synchronous status messages, that is, to select either SDH or SONET set of values. Configuring the code-type is only applicable to Synchronous Ethernet ports. For the code-type, SDH refers to ITU-T G.781 Option-1,while SONET refers to G.781 Option 2 (equivalent to Telcordia GR-253-CORE).

Default

sdh

Parameters

sdh

Specifies the values used on a G.781 Option 1 compliant network.

sonet

Specifies the values used on a G.781 Option 2 compliant network.

Context

config>port>ethernet>ssm

Platforms

7210 SAS-Mxp, 7210 SAS-R, 7210 SAS-Sx 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command allows ESMC frames that are received into the Ethernet port to be tunneled in an Epipe or VPLS service. This configuration is only required for compliance to MEF 6.1.1 EPL Option 2. The port where esmc-tunnel is enabled cannot be used for Synchronous Ethernet.

The no form of this command extracts the ESMC frames on reception by the port. The ESMC frames are not tunneled through the service.

Default

no esmc-tunnel

Context

config>port>ethernet>ssm

config>port>sonet-sdh

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 QL value, transmitted from the SSM channel of the SONET/SDH port or the Synchronous Ethernet port, to be set to QL-DUS/QL-DNU. This capability is provided to block the use of the interface from the SR/ESS for timing purposes.

Default

no tx-dus

Context

config>port>ethernet

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 port-specific 802.1x authentication attributes. This context can only be used when configuring a Fast Ethernet, Gigabit or 10Gig Ethernet or Gigabit Ethernet LAN ports on an appropriate MDA.

Context

config>port>ethernet>dot1x

Platforms

7210 SAS-Sx/S 1/10GE (standalone)

Description

This command configures the guest VLAN that must be configured on the port when there is no response from the RADIUS server or when dot1x authentication is enabled on a port but no EAPOL packets are received from the connected device.

Users must specify the EHS script to be invoked when the logEvent_PORT_tmnxPortDot1xAuthLostGRvC event is raised and configure the guest VLAN in the script using the parameter passed to the script.

The no form of this command disables the guest VLAN assignment.

Default

no guest-service

Parameters

service-id

Specifies the service under which the SAP must be configured using the EHS script. The EHS script must use the NULL (“:0”) tag to configure a NULL SAP if the optional vlan-id parameter is not configured. If vlan-id is configured, it is used as the SAP tag.

Values

service-id: 1 to 2147483647

svc-name: 64 characters maximum

vlan-id

Specifies the VLAN ID. The configured vlan-id cannot be modified if the config>port>ethernet>dot1x>port-control command is set to auto. To modify the service and VLAN ID information, users must set the config>port>ethernet>dot1x>port-control command to either force-auth or force-unauth.

Values

0 to 4049

Context

config>port>ethernet>dot1x

Platforms

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

Description

This command enables MAC-based authentication. To use MAC-based authentication, 802.1x authentication must first be enabled using the port-control auto command.

When MAC-based authentication is enabled, and the mac-auth-wait timer expires, the 7210 SAS begins listening on the port for valid Ethernet frames. The source MAC address of a received frame is used for MAC-based authentication.

MAC authentication and dot1x authentication or VLAN authentication are mutually exclusive and cannot be configured on the same port.

The no form of this command disables MAC-based authentication.

Default

no mac-auth

Context

config>port>ethernet>dot1x

Platforms

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

Description

This command configures the delay period before MAC authentication is activated.

The no form of this command disables the delay and allows MAC authentication to be used immediately.

Default

no mac-auth-wait

Parameters

seconds

Specifies the MAC authentication delay period, in seconds.

Values

1 to 3600

Context

config>port>ethernet>dot1x

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 maximum number of times that the 7210 SAS will send an access request RADIUS message to the RADIUS server. If a reply is not received from the RADIUS server after the specified number of attempts, the 802.1x authentication procedure is considered to have failed.

Default

2

Parameters

max-auth-request

Specifies the maximum number of RADIUS retries.

Values

1 to 10

Context

config>port>ethernet>dot1x

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 802.1x authentication mode.

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

Default

force-auth

Parameters

force-auth

Specifies that 802.1x authentication will be disabled and causes the port to transition to the authorized state without requiring any authentication exchange. The port transmits and receives normal traffic without requiring 802.1x-based host authentication.

force-unauth

Specifies that the port will remain in the unauthorized state, ignoring all attempts by the hosts to authenticate. The switch cannot provide authentication services to the host through the interface.

auto

Specifies that 802.1x authentication will be enabled. The port starts in the unauthorized state, allowing only EAPOL frames to be sent and received through the port. Both the 7210 SAS and the host can initiate an authentication procedure. The port will remain in the unauthorized state (no traffic except EAPOL frames is allowed) until the first client is authenticated successfully. After this, traffic is allowed on the port for all connected hosts.

Context

config>port>ethernet>dot1x

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 period between two authentication sessions during which no EAPOL frames are sent by the 7210 SAS.

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

Default

30

Parameters

seconds

Specifies the quiet period, in seconds.

Values

1 to 3600

Context

config>port>ethernet>dot1x

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 RADIUS policy to be used for 802.1x authentication. An 802.1x RADIUS policy must be configured (under config>security>dot1x) before it can be associated with a port. If the RADIUS policy-id does not exist, an error is returned. Only one 802.1x RADIUS policy can be associated with a port at a time.

The no form of this command removes the RADIUS policy association.

Default

no radius-plcy

Parameters

name

Specifies an existing 802.1x RADIUS policy name.

Context

config>port>ethernet>dot1x

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 period after which re-authentication is performed. This value is only relevant if re-authentication is enabled.

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

Default

3600

Parameters

seconds

Specifies the re-authentication delay period, in seconds.

Values

1 to 9000

Context

config>port>ethernet>dot1x

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 and disables periodic 802.1x reauthentication.

When re-authentication is enabled, the 7210 SAS will reauthenticate clients on the port every re-auth-period seconds.

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

Default

re-authentication

Context

config>port>ethernet>dot1x

Platforms

7210 SAS-Sx/S 1/10GE (standalone)

Description

This command configures the restricted VLAN that must be configured on the port when the RADIUS server returns an authentication failure.

Users must specify the EHS script to be invoked when the logEvent_PORT_tmnxPortDot1xAuthLostGRvC event is raised and configure the restricted VLAN in the script using the parameter passed to the script.

The no form of this command disables the restricted VLAN assignment.

Default

no restricted-service

Parameters

service-id

Specifies the service under which the SAP must be configured using the EHS script. The EHS script must use the NULL (“:0”) tag to configure a NULL SAP if the optional vlan-id parameter is not configured. If vlan-id is configured, it is used as the SAP tag.

Values

service-id: 1 to 2147483647

svc-name: 64 characters maximum

vlan-id

Specifies the VLAN ID. The configured vlan-id cannot be modified if the config>port>ethernet>dot1x>port-control command is set to auto. To modify the service and VLAN ID information, users must set the config>port>ethernet>dot1x>port-control command to either force-auth or force-unauth.

Values

0 to 4049

Context

config>port>ethernet>dot1x

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 period during which the 7210 SAS waits for the RADIUS server to responds to its access request message. When this timer expires, the 7210 SAS will resend the access request message, up to the specified number times.

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

Default

30

Parameters

seconds

Specifies the server timeout period, in seconds.

Values

1 to 300

Context

config>port>ethernet>dot1x

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 period during which the 7210 SAS waits for a client to respond to its EAPOL messages. When the supplicant-timeout expires, the 802.1x authentication session is considered to have failed.

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

Default

30

Parameters

seconds

Specifies the server timeout period, in seconds.

Values

1 to 300

Context

config>port>ethernet>dot1x

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 period after which the 7210 SAS sends a new EAPOL request message.

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

Default

30

Parameters

seconds

Specifies the server transmit period, in seconds.

Values

1 to 3600

Context

config>port>ethernet>dot1x

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 tunneling of dot1x frames. With dot1x tunneling enabled, dot1x frames received on the port are transparently forwarded to the remote end of the service. To forwards dot1x frames transparently, the port on which tunneling is enabled must be configured with NULL SAP and the NULL SAP must be configured in an Epipe service. Tunneling is not supported for any other port encapsulation or when using any other service.

Additionally, dot1x protocol must be disabled on the port (using the configure>port>ethernet>dot1x>port-control force-auth command) before dot1x tunneling can be enabled using this command. If dot1x is configured to use either force-unauath or auto, then dot1x tunneling cannot be enabled. Conversely, if dot1x tunneling is enabled, then port-control force-unauth or port-control auto cannot be configured.

The no form of this command disables dot1x tunneling.

Default

no tunneling

Context

config>port>ethernet>dot1x

Platforms

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

Description

This command enables VLAN-based authentication. To use VLAN-based authentication, 802.1x authentication must first be enabled using the port-control auto command.

When VLAN-based authentication is enabled, all traffic for all VLANs on the port is blocked. VLAN-tagged EAPOL messages are forwarded to the RADIUS server for authentication. If authentication is successful, the VLAN corresponding to the successfully authenticated VLAN-tagged EAPOL message is unblocked and traffic is processed for the configured service. If authentication fails, the VLAN continues to be blocked.

VLAN authentication and MAC authentication are mutually exclusive and cannot be configured on the same port.

The no form of this command disables VLAN-based authentication.

Default

no vlan-auth

Context

config>port>ethernet

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 Ethernet loop detection attributes.

Context

config>port>ethernet>dwl

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 time interval between keep-alive PDUs.

Default

no keep-alive

Parameters

timer

Specifies the time interval, in seconds, between keep-alive PDUs.

Values

1 to 120

Context

config>port>ethernet>dwl

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 minimum wait time before reenabling port after loop detection.

Default

no retry-timeout

Parameters

timer

Specifies the minimum wait time, in seconds, before reenabling port after loop detection.

Values

0, 10 to 160

Context

config>port>ethernet

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 Link Layer Discovery Protocol (LLDP) parameters on the specified port.

Context

config>port>ethernet>lldp

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 tunneling for LLDP frames that use the nearest-bridge-dest-mac as destination MAC address. If enabled using the command tunnel-nearest-bridge-dest-mac, all frames received with the appropriate destination mac address are forwarded transparently to the remote end of the service. To forward these frames transparently, the port on which tunneling is enabled must be configured with NULL SAP and the NULL SAP must be configured in an Epipe service. Tunneling is not supported for any other port encapsulation or when using any other service.

Additionally, before enabling tunneling, admin status for LLDP dest-mac nearest-bridge must be set to disabled or Tx only, using the command admin-status available under configure> port>ethernet>lldp>dest-mac nearest-bridge. If admin-status for dest-mac nearest-bridge is set to receive and process nearest-bridge LLDPDUs (that is, if either rx or tx-rx is set) then it overrides the tunnel-nearest-bridge-dest-mac command.

The following table lists the behavior for LLDP with different values set in use for admin-status and when tunneling is enabled or disabled:

The no form of this command disable LLDP tunneling for frames using nearest-bridge destination MAC address.

Default

no tunnel-nearest-bridge-dest-mac

Context

config>port>ethernet>lldp

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 destination MAC address parameters.

Parameters

bridge-mac

Specifies destination bridge MAC type to use by LLDP.

Values

nearest-bridge — Specifies to use the nearest bridge.

nearest-non-tpmr — Specifies to use the nearest non-Two-Port MAC Relay (TPMR).

nearest-customer — Specifies to use the nearest customer.

Context

config>port>ethernet>lldp>dstmac

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 desired administrative status of the local LLDP agent.

Parameters

rx

Specifies the LLDP agent will receive, but will not transmit LLDP frames on this port.

tx

Specifies that the LLDP agent will transmit LLDP frames on this port and will not store any information about the remote systems connected.

tx-rx

Specifies that the LLDP agent transmits and receives LLDP frames on this port.

disabled

Specifies that the LLDP agent does not transmit or receive LLDP frames on this port. If there is remote systems information which is received on this port and stored in other tables, before the port's admin status becomes disabled, then the information will naturally age out.

Context

config>port>ethernet>lldp>dest-mac

Platforms

7210 SAS-Sx 1/10GE: standalone and standalone-VC

Description

Commands in this context configure the administrative status of the local LLDP-MED agent.

Context

config>port>ethernet>lldp>dest-mac>lldp-med

Platforms

7210 SAS-Sx 1/10GE: standalone and standalone-VC

Description

This command configures the administrative status of the local LLDP-MED agent.

The no form of this command disables the ability to specify the administrative status of the local LLDP-MED agent.

Default

admin-status disabled

Parameters

tx-rx

Keyword that configures the LLDP agent to transmit and receive LLDP-MED TLVs on the configured port.

disabled

Keyword to indicate that the LLDP-MED agent does not transmit or receive LLDP frames with LLDP-MED TLVs on the configured port. If no remote systems information is received on the configured port and stored in other tables before the port administrative status becomes disabled, the information ages out.

Context

config>port>ethernet>lldp>dest-mac>lldp-med

Platforms

7210 SAS-Sx 1/10GE: standalone and standalone-VC

Description

This command configures the network policy information that the node transmits in the Network Policy TLV.

Up to four policies can be configured, as long as the configured application-type for each policy is different. The system includes multiple Network Policy TLVs (if multiple policies are configured), with the policy for each application-type included in its own Network Policy TLV. The Network Policy TLV order in the LLDP message will match the policy order configured in the CLI. If the system cannot fit all configured Network Policy TLVs into the LLDP frame because of size constraints, a log message is generated for the last network policy that exceeds the frame size. The error notification allows the user to adjust the configuration appropriately.

The user must explicitly configure a network policy (with values assigned to the endpoint device) before the transmission and reception of LLDP-MED TLVs on the port is allowed. If a port is configured to transmit the LLDP-MED Network Policy TLV but the user has not configured a network policy, the node will not transmit the Network Policy TLV. The node processes the received Network Policy TLV and displays the TLV values in the LLDP message received from the peer provided that the LLDP-MED receiving processing and Network Policy TLV processing is enabled, regardless of whether network-policy is configured.

The no form of this command removes the association of all network policies with the port.

Default

no network-policy

Parameters

policy-id

Specifies network policy ID.

Values

1 to 65535

Context

config>port>ethernet>lldp>dest-mac>lldp-med

Platforms

7210 SAS-Sx 1/10GE: standalone and standalone-VC

Description

This command configures the specific transmit TLV from the network connectivity TLV set to be transmitted on the port if LLDP-MED TLV transmission is enabled on the port.

The no form of this command removes the configuration.

Default

no tx-tlvs

Parameters

network-policy

Keyword to enable the transmission of the network policy TLV.

mac-phy-config-status

Keyword to enable the transmission of the MAC-PHY Configuration and Status TLV.

Context

config>port>ethernet>lldp>dstmac

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 LLDP notifications.

The no form of this command disables LLDP notifications.

Context

config>port>ethernet>lldp>dest-mac

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 how to encode the PortID TLV transmit to the peer. Some versions of the NSP NFM-P require the default tx-local (ifIndex value) setting to properly build the Layer Two topology map using LLDP. Changing this setting to transmit the ifName (tx-if-name) or ifAlias (tx-if-alias), instead of the ifIndex (tx-local), may affect the ability of the NSP NFM-P to build the Layer 2 topology map using LLDP.

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

Default

portid-subtype tx-local

Parameters

tx-if-alias

Keyword to transmit the ifAlias String (subtype 1) that describes the port as stored in the IF-MIB, either user configured or the default entry (for example, 10/100/Gig Ethernet SFP).

tx-if-name

Keyword to transmit the ifName string (subtype 5) that describes the port as stored in the IF-MIB ifName information.

tx-local

Keyword to specify the interface ifIndex value (subtype 7) as the PortID.

Context

config>port>ethernet>lldp>dstmac

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 which management address to transmit. The operator can choose to send the system IPv4 IP Address, system IPv6 address, or both.

Default

no tx-mgmt-address

Parameters

system

Keyword to transmit the system IPv4 address.

system-ipv6

Keyword to transmit the system IPv6 address. This parameter can only be used on platforms that support IPv6.

Context

config>port>ethernet>lldp>dstmac

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 which LLDP TLVs to transmit.

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

no tx-tlvs

Parameters

port-desc

Specifies that the LLDP agent should transmit port description TLVs.

sys-name

Specifies that the LLDP agent should transmit system name TLVs.

sys-desc

Specifies that the LLDP agent should transmit system description TLVs.

sys-cap

Specifies that the LLDP agent should transmit system capabilities TLVs.

Context

config>port>ethernet

Platforms

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

Description

Commands in this context configure network port parameters.

Context

config>port>access

config>port>ethernet>access>uplink

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 access uplink port parameters.

Context

config>port>ethernet>network

config>port>ethernet>access>uplink

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 an accounting policy that can apply to an interface.

An accounting policy must be configured before it can be associated with an interface. If the accounting policy-id does not exist, an error is returned.

Accounting policies associated with service billing can only be applied to SAPs. Accounting policies associated with network ports can only be associated with interfaces. Only one accounting policy can be associated with an interface at a time.

The no form of this command removes the accounting policy association from the network interface, and the accounting policy reverts to the default.

Parameters

policy-id

Specifies the accounting policy-id of an existing policy. Accounting policies record either service (access) or network information. A network accounting policy can only be associated with the network port configurations. Accounting policies are configured in the config>log>accounting-policy context.

Values

1 to 99

Context

config>port>ethernet>network

config>port>ethernet>access>uplink

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 collection of accounting and statistical data for the network interface. When applying accounting policies, the data, by default, is collected in the appropriate records and written to the designated billing file.

The no form of this command ensures that the statistics are still accumulated by the cards, however, the CPU does not obtain the results and write them to the billing file. If the collect-stats command is issued again (enabled), then the counters written to the billing file will include the traffic collected while the no collect-stats command was in effect.

Default

no collect-stats

Context

config>port>ethernet>access>uplink

config>port>ethernet>access>network

Platforms

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

Description

This command associates a network queue policy with access-uplink port in access-uplink mode or a network port or hybrid port in network mode of operation.

This command specifies the existing network queue policy which defines queue parameters such as CIR and PIR rates, as well as forwarding-class to queue mappings. The network-queue policy is defined in the config>qos>network-queue context.

Parameters

name

Specifies an existing network-queue policy name.

Context

config

Platforms

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

Description

This command configures Link Aggregation Group (LAG) attributes.

A LAG can be used to group two or more ports into one logical link. The number of ports supported in a LAG depends on the platform. The aggregation of multiple physical links allows for load sharing and provides seamless redundancy. If one of the links fails, traffic is redistributed over the remaining links.

The no form of this command deletes the LAG from the configuration. Deleting a LAG is only allowed while the LAG is administratively shut down. Any dependencies, such as IP interface configurations, must be removed from the configuration before the no lag command can be issued.

Parameters

lag-id

Specifies the LAG identifier, expressed as a decimal integer.

Values

1 to 25 (7210 SAS-T, 7210 SAS-Mxp)

1 to 125 (7210 SAS-R6 and 7210 SAS-R12)

1 to 125 (7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE)

Context

config>lag

Platforms

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

Description

This command enables the context to configure BFD over the associated LAG links.

Context

config>lag>bfd

Platforms

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

Description

This command enables BFD over LAG links; additional parameter configuration is required to make the links operational.

BFD session timers are automatically extended during a soft-reset operation on IOMs and IMMs to prevent BFD sessions from timing out and causing protocol events. However, in some cases this behavior is not wanted because it can delay fast reroute transitions, if they are in place. The optional disable-soft-reset-extension command disables the behavior so that the BFD timers are not automatically extended.

The no form of this command disables the automatic extension of BFD timers during an IOM/IMM soft-reset.

Default

no disable-soft-reset-extension

Context

config>lag>bfd

Platforms

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

Description

This command configures the address family for the micro-BFD session over the associated LAG links.

Default

family ipv4

Parameters

ipv4

Keyword to configure IPv4 encapsulation for the micro-BFD session.

Context

config>lag>bfd>family

Platforms

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

Description

This command enables restricting micro-BFD sessions to links in Link Aggregation Control Protocol (LACP) state distributing.

The no form of this command disables restricting micro-BFD sessions.

Default

no bfd-on-distributing-only

Context

config>lag>bfd>family

Platforms

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

Description

This command specifies the IPv4 address of the BFD source.

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

Default

no local-ip-address

Parameters

ip-address

Specifies the IP address.

Values

ipv4-address:

a.b.c.d

Context

config>lag>bfd>family

Platforms

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

Description

This command specifies the maximum interval of time the router will continue to forward traffic over a link after the micro-BFD sessions have transitioned to a down state because the router received an ADMIN-DOWN state from the far end. The timer provides the administrator the configured amount of time to disable or deprovision the micro-BFD session on the local node before forwarding is halted over the associated links.

The no form of this command removes the time interval from the configuration.

Default

max-admin-down-time 0

Parameters

down-interval

Specifies the amount of time, in seconds.

Values

1 to 3600

infinite

Keyword to specify that there is no end time to forward traffic.

Context

config>lag>bfd>family

Platforms

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

Description

This command specifies the maximum interval of time the router will forward traffic over a link that has transitioned from standby to active state before the micro-BFD session must be fully established (up state).

The no form of this command reverts the up-interval parameter to the default, which indicates that forwarding will not start until the BFD session is established.

Default

max-setup-time infinite

Parameters

up-interval

Specifies the amount of time, in milliseconds.

Values

1 to 60000

Default

0

infinite

Keyword to specify that there is no end time to forward traffic over the link; the router will continue to forward traffic over the link infinitely after the micro-BFD session transitions to the down state.

Context

config>lag>bfd>family

Platforms

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

Description

This command specifies the detect multiplier used for a micro-BFD session over the associated LAG links. The session is declared administratively down if a BFD control packet is not received for a period determined by the following equation:

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

Default

multiplier 3

Parameters

multiplier

Specifies the multiplier value.

Values

3 to 20

Context

config>lag>bfd>family

Platforms

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

Description

This command specifies the receive timer used for micro-BFD sessions over the associated LAG links.

The no form of this command removes the receive timer from the configuration.

Default

receive-interval 100

Parameters

interval

Specifies the interval value, in milliseconds.

Values

10 to 100000

Default

100 for CPM3 or later, 1000 for all others

Context

config>lag>bfd>family

Platforms

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

Description

This command configures the IPv4 address of the BFD destination.

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

Default

no remote-ip-address

Parameters

ip-address

Specifies the IP address.

Values

ipv4-address:

a.b.c.d

Context

config>lag>bfd>family

Platforms

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

Description

This command disables micro-BFD sessions for this address family.

The no form of this command re-enables micro-BFD sessions for this address family.

Default

shutdown

Context

config>lag>bfd>family

Platforms

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

Description

This command specifies the transmit timer used for a micro-BFD session over the associated LAG links.

The no form of this command removes the transmit timer from the configuration.

Default

transmit-interval 100

Parameters

transmit-interval

Specifies the transmit interval value, in milliseconds.

Values

10 to 100000

Default

100 for CPM3 or later, 1000 for all others

Context

config>lag

Platforms

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

Description

This command enables OSPF costing of a Link Aggregation Group (LAG) based on the available aggregated, operational bandwidth.

The path cost is dynamically calculated based on the interface bandwidth. OSPF path cost can be changed through the interface metric or the reference bandwidth.

If dynamic cost is configured, then costing is applied based on the total number of links configured and the cost advertised is inversely proportional to the number of links available at the time. This is provided that the number of links that are up exceeds the configured LAG threshold value at which time the configured threshold action determines if, and at what cost, this LAG will be advertised.

For example:

Assume a physical link in OSPF has a cost associated with it of 100, and the LAG consists of four physical links. The cost associated with the logical link is 25. If one link fails then the cost would automatically be adjusted to 33.

If dynamic cost is not configured and OSPF autocost is configured, then costing is applied based on the total number of links configured. This cost will remain static provided the number of links that are up exceeds the configured LAG threshold value at which time the configured threshold action determines if and at what cost this LAG will be advertised.

If dynamic-cost is configured and OSPF autocost is not configured, the cost is determined by the cost configured on the OSPF metric provided the number of links available exceeds the configured LAG threshold value at which time the configured threshold action determines if this LAG will be advertised.

If neither dynamic-cost nor OSPF autocost are configured, the cost advertised is determined by the cost configured on the OSPF metric. This is provided that the number of links available exceeds the configured LAG threshold value, at which time the configured threshold action determines if this LAG will be advertised.

The no form of this command removes dynamic costing from the LAG.

Default

no dynamic-cost

Context

config>lag

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 encapsulation method used to distinguish customer traffic on a LAG. The encapsulation type is configurable on a LAG port. The LAG port and the port member encapsulation types must match when adding a port member.

If the encapsulation type of the LAG port is changed, the encapsulation type on all the port members will also change. The encapsulation type can be changed on the LAG port only if there is no interface associated with it. If the MTU is set to a non default value, it will be reset to the default value when the encap type is changed.All traffic on the port belongs to a single service or VLAN.

The no form of this command reverts to the default.

Default

null

Parameters

dot1q

Specifies that ingress frames carry 802.1Q tags where each tag signifies a different service.

null

Specifies that ingress frames will not use any tags to delineate a service. As a result, only one service can be configured on a port with a null encapsulation type.

qinq

Specifies QinQ encapsulation for QinQ access SAPs.

Context

config>lag

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, in tenths of seconds, which controls the delay between detecting that a LAG is down (all active ports are down) and reporting it to the higher levels.

A non-zero value can be configured, for example, when active/standby signaling is used in a 1:1 fashion to avoid informing higher levels during the small time interval between detecting that the LAG is down and the time needed to activate the standby link.

Default

0

Parameters

down hold-down-time

Specifies the hold-time for event reporting.

Values

0 to 2000

Context

config>lag

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 Link Aggregation Control Protocol (LACP) mode for aggregated Ethernet interfaces only. Per the IEEE 802.3ax standard (formerly 802.3ad), the LACP provides a standardized means for exchanging information between Partner Systems on a link. This allow their Link Aggregation Control instances to reach agreement on the identity of the Link Aggregation Group to which the link belongs, move the link to that Link Aggregation Group, and enable its transmission and reception functions in an orderly manner.

Default

no lacp

Parameters

mode

Specifies the mode in which LACP will operate.

Values

passive — Starts transmitting LACP packets only after receiving packets.

active — Initiates the transmission of LACP packets.

administrative-key admin-key

Specifies an administrative key value to identify the channel group on each port configured to use LACP. This value should be configured only in exceptional cases. If it is not specified, a random key is assigned.

Values

1 to 65535

system-id

Specifies a 6 byte value expressed in the same notation as MAC address.

Values

xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx

priority

Specifies the system priority to be used for the LAG in the context of the MC-LAG.

Values

0 to 65535

Context

config>lag

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 interval signaled to the peer and tells the peer at which rate it should transmit.

Default

fast

Parameters

slow

Specifies that packets are transmitted every 30 seconds.

fast

Specifies that packets are transmitted every second.

Context

config>lag

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 LACP message transmission on standby links.

The no form of this command disables LACP message transmission. This command should be disabled for compatibility when using active/standby groups. This forces a timeout of the standby links by the peer. Use the no form if the peer does not implement the correct behavior regarding the lacp sync bit.

Default

lacp-xmit-stdby

Context

config>lag

Platforms

7210 SAS-Mxp, 7210 SAS-Sx/S 1/10GE (standalone)

Description

This command specifies the operational group to monitor. The state of the operational group affects the state of this LAG. When the operational group is inactive, the state of the LAG goes down, and the LAG uses the configured lag>standby-signaling mechanism (lacp or power-off) to signal its unavailability to the CE.

The no form of this command reverts to the default.

Default

no monitor-oper-group

Parameters

name

Specifies the name of the operational group, up to 32 characters.

Context

config>system

Platforms

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

Description

Commands in this context configure the system-wide LAG hashing algorithm version.

Context

config>system>lag

Platforms

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

Description

This command configures the LAG load-balancing hash-1 algorithm version.

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

Default

lb-hash-1-version v1

Parameters

version

Specifies the version of the hash-1 algorithm. The v1 and v2 options are supported only when configure>lag>load-balancing is set to hash-1. If load-balancing is set to hash-2, the system ignores the v1 or v2 configuration.

Values

v1 — Configures version 1 of the hash-1 algorithm. This version maintains backwards compatibility with earlier releases of the 7210 SAS.

v2 — Configures version 2 of the hash-1 algorithm. This version enables the use of IP address fields and L4 ports with the hash-1 algorithm, which provides better load-balancing of IP traffic in specific scenarios.

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command provides an option per LAG to select the load-balancing hash function to use. For more details about the packet header fields used when the hash function is set to one of these values, see LAG and ECMP hashing.

Default

default

Parameters

hash parameters

Specifies the load-balancing hashing options.

Values

hash-1 — Specifies that the load-balancing function uses hash-1.

hash-2 — Specifies that the load-balancing function uses hash-2.

default —Specifies that, for unicast traffic with LAG mode set to access or hybrid, the default value is hash-1; for all other traffic, the default is hash-2.

Context

config>lag

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 ports to a Link Aggregation Group (LAG).

Multiple ports can be added in one command as long as the limit is not exceeded. On the 7210 SAS-Mxp and 7210 SAS-T, up to four ports can be added to a LAG. On the 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone and standalone-VC) and 7210 SAS-Sx 10/100GE, up to eight ports can be added.

The port configuration of the first port added to the LAG is used as a basis to compare with subsequently added ports. If a discrepancy is found with a newly added port, that port will not added to the LAG.

All ports added to a LAG must share the same characteristics (speed, duplex mode, and so on). An error message is displayed when adding ports that do not share the same characteristics.

The no form of this command removes ports from the LAG.

Parameters

port-id

Specifies the physical port ID in the slot/mda/port format.

priority priority

Specifies the port priority used by LACP. The port priority is also used to determine the primary port. The port with the lowest priority is the primary port. In the event of a tie, the lowest port ID becomes the primary port.

Values

1 to 65535

subgroup sub-group-id

Specifies the LAG subgroup identifier. When using subgroups in a LAG, they should only be configured on one side of the LAG, not both. Only having one side perform the active/standby selection will guarantee a consistent selection and fast convergence. The active/standby selection will be signaled through LACP to the other side. The hold time should be configured when using subgroups to prevent the LAG going down when switching between active and standby links in case no links are usable for a short time, especially if a subgroup consists of one member.

Values

1 to 2

Context

config>lag

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 behavior for the Link Aggregation Group (LAG) if the number of operational links is equal to or below a threshold level.

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

Default

‟0” action down

Parameters

value

Specifies the decimal integer threshold number of operational links for the LAG at or below which the configured action will be invoked. If the number of operational links exceeds the port-threshold value, any action taken for being below the threshold value will cease.

Values

0 to 3

action [{dynamic-cost | down}]

Specifies the action to take if the number of active links in the LAG is at or below the threshold value.

When the dynamic-cost action is specified, then dynamic costing will be activated. As a result the LAG will remain operationally up with a cost relative to the number of operational links. The link will only be regarded as operationally down when all links in the LAG are down.

When the down action is specified, then the LAG will be brought operationally down if the number of operational links is equal to or less than the configured threshold value. The LAG will only be regarded as up once the number of operational links exceeds the configured threshold value.

Note:

• The down parameter is supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.

• The dynamic-cost parameter is only supported on 7210 SAS platforms operating in network mode.

Context

config>lag

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 which selection criteria should be used to select the active sub-group.

Default

highest-count

Parameters

highest-count

Specifies sub-group with the highest number of eligible members.

highest-weight

Specifies sub-group with the highest aggregate weight.

best-port

Specifies the selection criteria used with power-off mode of operation. The sub-group containing the port with highest priority port. In case of equal port priorities the sub-group containing the port with the lowest port-id is taken

slave-to-partner

Specifies that, together with the selection criteria, the slave-to-partner keyword should be used to select the active sub-group. An eligible member is a lag-member link which can potentially become active. This means it is operationally up (not disabled) for use by the remote side. The slave-to-partner parameter can be used to control whether this latter condition is taken into account.

Context

config>lag

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 how the state of a member port is signaled to the remote side when the status corresponding to this member port has the standby value.

Default

lacp

Parameters

lacp

Specifies that LACP protocol is used to signal standby links of the LAG.

power-off

Specifies that the lasers of the standby links in the LAG are shutoff to indicate standby status. It allows user to use LAG standby link feature without LACP, if the peer node does not support LACP. This parameter is not supported on 7210 SAS platforms configured in the access-uplink operating mode.

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

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.

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

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

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.

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.

Default

0

Parameters

value

Specifies the down timeout in deciseconds.

Values

0 to 5000

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.

Default

20 deciseconds

Parameters

value

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

Values

0 to 5000

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

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>

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.

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

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.

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

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