Generic commands

description

Syntax

description description-string

no description

Context

config>qos>access-egress

Platforms

7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

Description

This command creates a text description stored in the configuration file for a configuration context.

The description command associates a text string with a configuration context to help identify the context in the configuration file.

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

Parameters

description-string

Specifies a text string describing the entity. Allowed values are any string up to 80 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.

access-egress

Syntax

access-egress policy-id [create]

no access-egress policy-id

Context

config>qos

Platforms

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

Description

This command creates or edits an access egress QoS policy. The policy can be applied to multiple access ports. The access egress policy is common to services (SAPs) that are all egressing on a particular port.

Any changes made to an existing policy are applied to all access ports on which the policy is specified.

The remarking parameters and queue parameters are used when port-based queuing is configured

This command is used to create or edit a access egress QoS policy. The egress policy defines the queue parameters (CIR/PIR) for each of the forwarding class traffic as they egress on the access port. Policies in effect are templates that can be applied to multiple access ports as long as the scope of the policy is template. There are 8 queues always available per port for which parameters are configurable.

Parameters

policy-id

Specifies the value that uniquely identifies the access-egress policy.

Values

1 to 65535

create

Keyword to create an access-egress policy. The create keyword requirement can be enabled or disabled in the environment>create context.

fc

Syntax

fc fc-name [create]

no fc fc-name

Context

config>qos>access-egress

Platforms

7210 SAS-T (access-uplink mode)

Description

This command defines the fc node within the access egress QoS policy is used to contain the explicitly defined dot1p marking commands for the fc-name.

Note:

When the mapping for the fc-name and marking value is not defined, the node for fc-name is not displayed in the show configuration or save configuration output.

The no form of this command removes the explicit dot1p marking commands for the fc-name.

Parameters

fc-name

Specifies the forwarding class for which dot1p marking is to be edited. The value given for fc-name must be one of the predefined forwarding classes in the system.

Values

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

create

Keyword to create an access-egress policy. The create keyword requirement can be enabled or disabled in the environment>create context.

de-mark

Syntax

[no] de-mark [force de-value]

Context

config>qos>access-egress>fc

Platforms

7210 SAS-T (access-uplink mode)

Description

This command explicitly defines the marking of the DEI bit for fc fc-name according to the in and out of profile status of the packet (fc-name may be used to identify the dot1p-value).

If no de-value is present, the default values are used for the marking of the DEI bit: for example, 0 for in-profile packets, 1 for out-of-profile ones – see IEEE 802.1ad-2005 standard.

If the de-value is specifically mentioned in the command line it means this value is to be used for all the packets of this forwarding class regardless of their in/out of profile status.

Parameters

de-value

Specifies the DEI value to use for this forwarding class.

Values

0 or 1

dot1p

Syntax

[no] dot1p dot1p-value

Context

config>qos>access-egress>fc

Platforms

7210 SAS-T (access-uplink mode)

Description

This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.

DEI marking can be enabled using the de-mark command along with this command for the command to take effect. When the de-mark command is configured along with this command, the DEI bit is marked in the packet to indicate the profile of the packet. The DEI bit is marked to 0 to indicate in-profile/green packet and 1 to indicate out-of-profile/yellow packet. If the force de-value parameter is specified then the DEI bit is set to specified value for all packets.

If the no form of this command is executed then software will use the dot1p-in-profile and dot1p-out-profile if configured, else it will use default values.

Note:

The following rules are applied by software to determine the Dot1p values to when both dot1p command and dot1p-in-profile and dot1p-out-profile command is specified:

  1. If de-mark is not configured, then dot1p [in | out]-profile values are considered. Even if dot1p value is configured, it is configured it is ignored and if ‛dot1p [in | out]-profile’ value is not configured then default values are considered for that FC.

  2. If de-mark is configured and if dot1p value is configured then it is considered. Else if ‛dot1p [in | out]-profile’ value is configured it is considered. In this case, dot1p value, has the precedence over ‛dot1p [in | out]-profile’.

Default

no dot1p

Parameters

dot1p-value

Specifies the 802.1p value to set for in-profile frames in this forwarding class.

Values

0 to 7

dot1p-in-profile

Syntax

dot1p-in-profile dot1p-priority

no dot1p-in-profile

Context

config>qos>>access-egress>fc

Platforms

7210 SAS-T (access-uplink mode)

Description

The command will add the capability to mark on an egress the in and out of profile status via a certain dot1p combination, similarly with the DEI options. It may be used when the internal in and out of profile status needs to be communicated to an adjacent network/customer device that does not support the DEI bit.

This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets with in-profile status (or green color) of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.

If DEI marking is enabled using the de-mark command and the command ‛dot1p dot1p-value’ is used to configure the dot1p value, then this command has no effect. In other words, enabling DEI marking has precedence over this command and the system ignores this command.

When this command is used the DEI Bit is left unchanged by the egress processing if a tag exists. If a new tag is added, the related DEI bit is set to 0.

The no form of this command sets the IEEE 802.1P or IEEE 802.1Q priority bits to 0.

Note:

The following rules are applied by software to determine the Dot1p values to when both dot1p command and dot1p-in-profile and dot1p-out-profile command is specified:

  1. If de-mark is not configured, then dot1p [in|out]-profile values are considered. Even if `dot1p <val>' command is configured it is ignored and if `dot1p [in|out]-profile' value is not configured then default values are considered for that FC.

  2. If de-mark is configured and if `dot1p <value>' command is configured then it is considered. Else if `dot1p [in|out]-profile' value is configured it is considered. In this case `dot1p <val>' has the precedence over `dot1p [in|out]-profile'.

  3. If marking is enabled and both dot1p <val> and dot1-[in|out]-profile commands are not specified, then the default values for default.

Default

0

Parameters

dot1p-priority

Specifies the 802.1p value to set for in-profile frames in this forwarding class.

Values

0 to 7

dot1p-out-profile

Syntax

dot1p-out-profile dot1p-priority

no dot1p-out-profile

Context

config>qos>access-egress>fc

Platforms

7210 SAS-T (access-uplink mode)

Description

The command will add the capability to mark on an egress the in and out of profile status via a certain dot1p combination, similarly with the DEI options. It may be used when the internal in and out of profile status needs to be communicated to an adjacent network/customer device that does not support the DEI bit.

This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets with out-of-profile status (or yellow color) of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.

If DEI marking is enabled using the de-mark command and the dot1p-value is configured, then this command has no effect. In other words, enabling DEI marking has precedence over this command and the system ignores this command.

When this command is used the DEI Bit is left unchanged by the egress processing if a tag exists. If a new tag is added, the related DEI bit is set to 0.

The no form of this command sets the IEEE 802.1P or IEEE 802.1Q priority bits to 0.

Note:

The following rules are applied by software to determine the Dot1p values to when both dot1p command and dot1p-in-profile and dot1p-out-profile command is specified:

  1. If de-mark is not configured, then dot1p [in|out]-profile values are considered. Even if `dot1p <val>' command is configured it is ignored and if `dot1p [in|out]-profile' value is not configured then default values are considered for that FC.

  2. If de-mark is configured and if `dot1p <value>' command is configured then it is considered. Else if `dot1p [in|out]-profile' value is configured it is considered. In this case `dot1p <val>', has the precedence over `dot1p [in|out]-profile'.

  3. If marking is enabled and both dot1p <val> and dot1-[in|out]-profile commands are not specified, then the default values for default.

Default

0

Parameters

dot1p-priority

Specifies the 802.1p value to set for in-profile frames in this forwarding class.

Values

0 to 7

dscp-out-profile

Syntax

dscp-out-profile dscp-name

no dscp-out-profile

Context

config>qos>access-egress>fc

Platforms

7210 SAS-T (in access-uplink mode and network).

Description

This command specifies the out-of-profile DSCP name for the forwarding class. When marking is set, the corresponding DSCP value is used to mark all IP packets with out-of-profile status, on the egress of this forwarding class queue.

When multiple DSCP names are associated with the forwarding class at network egress, the last name entered will overwrite the previous value.

The no form of this command reverts to the factory default out-of-profile dscp-name.

Parameters

dscp-name

Specifies the DSCP name.

Values

be, cp1, cp2, cp3, cp4, cp5, cp6, cp7, cs1, cp9, af11, cp11, af12, cp13, af13, cp15, cs2, cp17, af21, cp19, af22, cp21, af23, cp23, cs3, cp25, af31, cp27, af32, cp29, af33, cp31, cs4, cp33, af41, cp35, af42, cp37, af43, cp39, cs5, cp41, cp42, cp43, cp44, cp45, ef, cp47, nc1, cp49, cp50, cp51, cp52, cp53, cp54, cp55, nc2, cp57, cp58, cp59, cp60, cp61, cp62, cp63

dscp-in-profile

Syntax

dscp-in-profile dscp-name

no dscp-in-profile

Context

config>qos>access-egress>fc

Platforms

7210 SAS-T (access-uplink mode)

Description

This command specifies the in-profile DSCP name for the forwarding class. When marking is set, the corresponding DSCP value is used to mark all IP packets with out-of-profile status, on the egress of this forwarding class queue.

When multiple DSCP names are associated with the forwarding class at network egress, the last name entered will overwrite the previous value.

The no form of this command reverts to the factory default in-profile dscp-name.

Parameters

dscp-name

Specifies the DSCP name.

Values

be, cp1, cp2, cp3, cp4, cp5, cp6, cp7, cs1, cp9, af11, cp11, af12, cp13, af13, cp15, cs2, cp17, af21, cp19, af22, cp21, af23, cp23, cs3, cp25, af31, cp27, af32, cp29, af33, cp31, cs4, cp33, af41, cp35, af42, cp37, af43, cp39, cs5, cp41, cp42, cp43, cp44, cp45, ef, cp47, nc1, cp49, cp50, cp51, cp52, cp53, cp54, cp55, nc2, cp57, cp58, cp59, cp60, cp61, cp62, cp63

queue

Syntax

queue queue-id

Context

config>qos>access-egress

Platforms

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

Description

This command creates the context to modify queue parameters associated with a particular queue. The queue is identifiable by queue ID and FCs are mapped into the queues. See Table: Forwarding class to queue-ID map and Table: Forwarding class-to-queue ID map for 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE for more information.

Parameters

queue-id

Specifies the access egress queue-id associated with an FC. See Table: Forwarding class to queue-ID map and Table: Forwarding class-to-queue ID map for 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE for more information.

Values

1 to 8

remarking

Syntax

remarking {use-dot1p|use-dscp|all}

no remarking

Context

config>qos>network>egress

Platforms

7210 SAS-T (access-uplink mode)

Description

This command enables the system to remark egress packets sent out of access ports. The user can specify if dot1p or dscp or both dot1p and dscp to be used for marking the packets sent out of the port.

When 7210 is operated in access-uplink mode, marking support is available as given below:

  • On access port egress, the behavior is as follows:

    • If the use-dot1p keyword is configured in the access-egress policy, then the dot1p bits are marked in the packet header for all traffic sent out of all SAPs configured on that access port.

    • If the use-dscp keyword is configured in the access-egress policy, then the IP DSCP bits are marked in the packet header for IPv4 traffic sent out of all SAPs configured on that access port.

      Note:

      DSCP marking also marks the IPv4 packets associated with SAPs configured in an Layer 2 VPN service. If this is not required, to avoid this it is recommended to use only dot1p marking on access ports.

    • If the all keyword is configured is configured in the access-egress policy, then the Dot1p bits are marked in the packet header for all traffic (Layer 2 and IPv4) sent out of all SAPs and the IP DSCP bits are marked in the packet header for all IPv4 traffic sent out of all SAPs configured on that access port.

      Note:
      • DSCP marking also marks the packets associated with SAPs configured in an Layer 2 VPN service. If this is not required, to avoid this it is recommended to use only dot1p marking on access ports.

      • If remarking is enabled in access-egress policy, by default use-dot1p is used. If no marking values are specified, then the default FC to Dot1p marking values are used.

The no form of this command disables remarking.

Default

no remarking

remark

Syntax

remark policy-id

no remark

Context

config>qos>access-egress

Platforms

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

Description

This command specifies the remarking policy ID to use for marking packets on access egress (also known as, access port egress).

The remarking policy ID must be associated with the appropriate access egress policy and remarking must be enabled in the access egress policy to enable marking of packets sent out of all SAPs configured on the access port.

Only remarking policy of type dot1p, dscp, or dot1p-dscp is allowed to be used when the remark policy is associated with access-egress. See Table: Summary of remark policy and attachment points for 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE (network mode) and Table: Summary of remark policy and attachment points for 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12, for different remark policies supported on the node and its use.

The no form of this command removes the explicit association of the remark policy and associates the default remark policy. In other words, if remarking is enabled and no remark policy is executed, then the default remark policy is used to mark packets sent out. If no remark policy is executed and remarking is disabled, packets are not remarked.

Parameters

policy-id

Specifies the remark policy.

Values

1 to 65535

remarking

Syntax

no remarking

remarking

Context

config>qos>access-egress

Platforms

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

Description

This command enables the system to remark egress packets sent out of access ports.

When remarking is enabled, the remark policy configured in the QoS policy context is used to determine the FC to QoS bit mapping. For example, when remarking is enabled in the access-egress QoS policy, the remark policy associated with access-egress QoS policy is used to determine the FC to dot1p mapping to use for marking packets sent out of access ports.

See Remark policies for the remark policy that can be used to configure FC to priority bit markings in different QoS policies associated with different service entities. For more information, see Table: Summary of remark policy and attachment points for 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE (network mode) and Table: Summary of remark policy and attachment points for 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

The no form of this command disables remarking.

Default

no remarking