09-ACL and QoS Command Reference

HomeSupportResource CenterRoutersH3C SR8800 Series RoutersH3C SR8800Technical DocumentsCommandCommand ReferenceH3C SR8800 Command Reference-Release3347-6W10309-ACL and QoS Command Reference
04-HQoS Commands
Title Size Download
04-HQoS Commands 179.23 KB

HQoS configuration commands

Forwarding class configuration commands

display qos forwarding-class

Syntax

display qos forwarding-class [ fc-name ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

fc-name: Forwarding class name, a case-sensitive string of 1 to 31 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display qos forwarding-class command to display forwarding class information. If no forwarding class is specified, this command displays information about all forwarding classes.

Examples

# Display information about all forwarding classes.

<Sysname> display qos forwarding-class

Forwarding class: BE, ID: 0

 

Forwarding class: AF, ID: 1

 

Forwarding class: EF, ID: 2

 

Forwarding class: NC, ID: 3

remark forwarding-class

Syntax

remark forwarding-class { id fc-id | name fc-name }

undo remark forwarding-class

View

Traffic behavior view

Default level

2: System level

Parameters

id fc-id: Specifies a forwarding class by its ID, range from 0 to 3. Only the ID of a pre-defined forwarding class can be specified.

name fc-name: Specifies a forwarding class by its name, a case-sensitive string of 1 to 31 characters. Only the name of a pre-defined forwarding class can be specified.

Description

Use the remark forwarding-class command to mark traffic with a forwarding class.

Use the undo remark forwarding-class command to delete the forwarding class marking action.

Your marking action configuration can overwrite the old forwarding class marking action (if any) in the traffic behavior.

Examples

# Mark traffic with a forwarding class BE.

<Sysname> system-view

[Sysname] traffic behavior testtb

[Sysname-behavior-testtb] remark forwarding-class name BE

Forwarding group configuration commands

display qos forwarding-group

Syntax

display qos forwarding-group [ fg-name ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

fg-name: Forwarding group name, a case-sensitive string of 1 to 31 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display qos forwarding-group command to display forwarding group information. If no forwarding group is specified, this command displays information about all forwarding groups.

Examples

# Display information about forwarding group testfg.

<Sysname> display qos forwarding-group testfg

Forwarding group: testfg, ID: 10

  Forwarding group: subfg1, ID: 1, profile: fgprofile1

    Forwarding class: BE, ID: 0, profile: profile1

    Forwarding class: AF, ID: 1, profile: profile2

  Forwarding group: subfg2, ID: 2, profile: fgprofile2

    Forwarding class: EF, ID: 2, profile: profile3

Forwarding class: NC, ID: 3, profile: profile4

The profile field in the output indicates the forwarding profile associated with a forwarding class or forwarding group.

forwarding-class profile

Syntax

forwarding-class fc-name profile fp-name

undo forwarding-class fc-name

View

Forwarding group view

Default level

2: System level

Parameters

fc-name: Forwarding class name, a case-sensitive string of 1 to 31 characters.

fp-name: Forwarding profile name, a case-sensitive string of 1 to 31 characters.

Description

Use the forwarding-class command to nest a forwarding class in a forwarding group and specify a forwarding profile for this forwarding class.

Use the undo forwarding-class command to remove the specified forwarding class from the forwarding group.

The forwarding class to be nested in a forwarding group and the forwarding profile to be specified for the forwarding class must already exist.

You cannot nest a forwarding class in a forwarding group with child forwarding groups nested.

You cannot remove a forwarding class from a forwarding group that has been applied to an interface.

Examples

# Nest forwarding class BE in forwarding group testfg and specify forwarding profile testfp for this forwarding class.

<Sysname> system-view

[Sysname] qos forwarding-group testfg

[Sysname-hqos-fg-testfg] forwarding-class BE profile testfp

forwarding-group profile (forwarding-group view)

Syntax

forwarding-group sub-fg-name profile fp-name

undo forwarding-group sub-fg-name

View

Forwarding group view

Default level

2: System level

Parameters

sub-fg-name: Child forwarding group name, a case-sensitive string of 1 to 31 characters.

fp-name: Forwarding profile name, a case-sensitive string of 1 to 31 characters.

Description

Use the forwarding-group profile command to nest a child forwarding group in a forwarding group and specify a forwarding profile for this child forwarding group.

Use the undo forwarding-group command to remove the specified child forwarding group from the forwarding group.

The child forwarding group to be nested in a forwarding group and the forwarding profile to be specified for the child forwarding group must already exist.

You cannot nest a child forwarding group in a forwarding group with nested forwarding classes.

A forwarding group with nested child forwarding groups cannot be nested in another forwarding group.

You cannot nest child forwarding groups in a forwarding group that has been applied to an interface or remove nested child forwarding groups from the forwarding group.

Examples

# Nest child forwarding group subfg in forwarding group testfg and specify forwarding profile testfp for this child forwarding group.

<Sysname> system-view

[Sysname] qos forwarding-group testfg

[Sysname-hqos-fg-testfg] forwarding-group subfg profile testfp

qos copy forwarding-group

Syntax

qos copy forwarding-group fg-source to fg-dest&<1-8>

View

System view

Default level

2: System level

Parameters

fg-source: Source forwarding group name, a case-sensitive string of 1 to 31 characters. The forwarding group identified by this argument must already exist.

fg-dest: Destination forwarding group name, a case-sensitive string of 1 to 31 characters. Up to eight destination forwarding groups can be specified. These forwarding groups must not be ones that already exist.

Description

Use the qos copy forwarding-group command to create multiple forwarding groups from a source forwarding group. Any failure that occurs during a copy process does not affect the destination forwarding groups that have been created successfully.

Examples

# Copy forwarding group fg-source to forwarding group fg-des1 and forwarding group fg-des2.

<Sysname> system-view

[Sysname] qos copy forwarding-group fg-source to fg-des1 fs-des2

qos forwarding-group

Syntax

qos forwarding-group fg-name [ id fg-id ]

undo qos forwarding-group fg-name

View

System view

Default level

2: System level

Parameters

fg-name: User-defined forwarding group name, a case-sensitive string of 1 to 31 characters. This argument cannot take the name of the pre-defined forwarding group.

id fg-id: Specifies a user-defined forwarding group ID, in the range of 0 to 255. The fg-id argument cannot take the pre-defined forwarding group ID. If no ID is specified, the system assigns the lowest free ID to the forwarding group.

Description

Use the qos forwarding-group command to create a forwarding group and enter forwarding group view.

Use the undo qos forwarding-group command to delete the specified user-defined forwarding group.

To delete a forwarding group nested in another forwarding group or scheduler policy, remove the nesting relationship first.

You cannot modify or delete the pre-defined forwarding group (named default and numbered 0).

Examples

# Create forwarding group testfg.

<Sysname> system-view

[Sysname] qos forwarding-group testfg

Drop profile configuration commands

display qos drop-profile

Syntax

display qos drop-profile [ dp-name ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

dp-name: Drop profile name, a case-sensitive string of 1 to 31 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display qos drop-profile command to display drop profile information. If no drop profile is specified, this command displays information about all drop profiles.

Examples

# Display information about drop profile named testdp.

<Sysname> display qos drop-profile testdp

Drop profile: testdp, ID: 10

  Green thresholds: 50/60/30(min/max/prob)

  Yellow thresholds: 50/60/30(min/max/prob)

  Red thresholds: 50/60/30(min/max/prob)

  Weighting constant: 2

Table 1 Output description

Field

Description

Drop profile

Drop profile name

ID

Drop profile ID

Green thresholds

Drop parameters for green packets

Yellow thresholds

Drop parameters for yellow packets

Red thresholds

Drop parameters for red packets

min

Threshold at which packet drop begins

max

Threshold at which all newly arriving packets are dropped

prob

Drop probability

Weighting constant

Exponent for average queue length calculation

 

green

Syntax

green low-limit low-limit high-limit high-limit discard-probability discard-prob

undo green

View

Drop profile view

Default level

2: System level

Parameters

low-limit low-limit: Specifies the lower threshold in packets. When the average queue length reaches the threshold, newly arriving packets are randomly dropped. The low-limit argument ranges from 0 to 10240 and defaults to 10224.

high-limit high-limit: Specifies the upper threshold in packets. When the average queue length reaches the upper threshold, all newly arriving packets are dropped. The high-limit argument ranges from 0 to 10240 and defaults to 10240.

discard-probability discard-prob: Specifies the drop probability. The discard-prob argument ranges from 0 to 100 and defaults to 100.

Description

Use the green command to set drop parameters for green packets.

Use the undo green command to restore the default.

Examples

# Set drop parameters for green packets as follows: set lower threshold to 500, upper threshold to 700, and drop probability to 40.

<Sysname> system-view

[Sysname] qos drop-profile testdp

[Sysname-hqos-dp-testdp] green low-limit 500 high-limit 700 discard-probability 40

qos drop-profile

Syntax

qos drop-profile dp-name [ id dp-id ]

undo qos drop-profile dp-name

View

System view

Default level

2: System level

Parameters

dp-name: User-defined drop profile name, a case-sensitive string of 1 to 31 characters. This argument cannot take the name of the pre-defined drop profile.

id dp-id: Specifies the user-defined drop profile ID, in the range of 0 to 31. The dp-id argument cannot take the ID of the pre-defined drop profile. If no ID is specified, the system assigns the lowest free ID to the drop profile.

Description

Use the qos drop-profile command to create a user-defined drop profile and enter drop profile view.

Use the undo qos drop-profile command to delete a user-defined drop profile.

You cannot delete a drop profiles that have been referenced.

You cannot modify or delete the pre-defined drop profile (named default and numbered 0).

Examples

# Create drop profile testdp.

<Sysname> system-view

[Sysname] qos drop-profile testdp

red

Syntax

red low-limit low-limit high-limit high-limit discard-probability discard-prob

undo red

View

Drop profile view

Default level

2: System level

Parameters

low-limit low-limit: Specifies the lower threshold in packets. When the average queue length reaches the threshold, newly arriving packets are randomly dropped. The low-limit argument ranges from 0 to 10240 and defaults to 10224.

high-limit high-limit: Specifies the upper threshold in packets. When the average queue length reaches the upper threshold, all newly arriving packets are dropped. The high-limit argument ranges from 0 to 10240 and defaults to 10240.

discard-probability discard-prob: Specifies the drop probability. The discard-prob argument ranges from 0 to 100 and defaults to 100.

Description

Use the red command to set drop parameters for red packets.

Use the undo red command to restore the default.

Examples

# Set drop parameters for red packets as follows: set lower threshold to 500, upper threshold to 700, and drop probability to 40.

<Sysname> system-view

[Sysname] qos drop-profile testdp

[Sysname-hqos-dp-testdp] red low-limit 500 high-limit 700 discard-probability 40

weighting-constant

Syntax

weighting-constant exponent

undo weighting-constant

View

Drop profile view

Default level

2: System level

Parameters

exponent: Exponent for average queue length calculation. The exponent argument ranges from 0 to 21 and defaults to 8.

Description

Use the weighting-constant command to set the exponent for average queue length calculation.

Use the undo weighting-constant command to restore the default.

Examples

# Set the exponent for average queue length calculation to 2.

<Sysname> system-view

[Sysname] qos drop-profile testdp

[Sysname-hqos-dp-testdp] weighting-constant 2

yellow

Syntax

yellow low-limit low-limit high-limit high-limit discard-probability discard-prob

undo yellow

View

Drop profile view

Default level

2: System level

Parameters

low-limit low-limit: Specifies the lower threshold in packets. When the average queue length reaches the threshold, newly arriving packets are randomly dropped. The low-limit argument ranges from 0 to 10240 and defaults to 10224.

high-limit high-limit: Specifies the upper threshold in packets. When the average queue length reaches the upper threshold, all newly arriving packets are dropped. The high-limit argument ranges from 0 to 10240 and defaults to 10240.

discard-probability discard-prob: Specifies the drop probability. The discard-prob argument ranges from 0 to 100 and defaults to 100.

Description

Use the yellow command to set drop parameters for yellow packets.

Use the undo yellow command to restore the default.

Examples

# Set drop parameters for yellow packets as follows: set lower threshold to 500, upper threshold to 700, and drop probability to 40.

<Sysname> system-view

[Sysname] qos drop-profile testdp

[Sysname-hqos-dp-testdp] yellow low-limit 500 high-limit 700 discard-probability 40

Forwarding profile configuration commands

bandwidth

Syntax

bandwidth bandwidth-value

undo bandwidth [ bandwidth-value ]

View

Forwarding profile view

Default level

2: System level

Parameters

bandwidth-value: Minimum guaranteed bandwidth (in kbps), in the range of 40 to 2500000.

Description

Use the bandwidth command to set the minimum guaranteed bandwidth for the hardware queue of the forwarding class associated with the forwarding profile.

Use the undo bandwidth command to cancel the configuration.

By default, no minimum guaranteed bandwidth is configured for a forwarding profile.

Examples

# Set the minimum guaranteed bandwidth to 2000 kbps in the forwarding profile testfp.

<Sysname> system-view

[Sysname] qos forwarding-profile testfp

[Sysname-hqos-fp-testfp] bandwidth 2000

display qos forwarding-profile

Syntax

display qos forwarding-profile [ fp-name ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

fp-name: Forwarding profile name, a case-sensitive string of 1 to 31 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display qos forwarding-profile command to display forwarding profile information. If no forwarding profile is specified, this command displays information about all forwarding profiles.

Examples

# Display information about forwarding profile testfp.

<Sysname> display qos forwarding-profile testfp

Forwarding profile: testfp, ID: 1

  cir 320 (kbps), cbs 1024 (Bytes)

  wfq: weight 2

  drop profile: testdp

  bandwidth: 20000(kbps)

drop-profile

Syntax

drop-profile dp-name

undo drop-profile

View

Forwarding profile view

Default level

2: System level

Parameters

dp-name: Drop profile name, a case-sensitive string of 1 to 31 characters.

Description

Use the drop-profile command to bind a drop profile to a forwarding profile.

Use the undo drop-profile command to remove the drop profile from the forwarding profile.

By default, a forwarding profile does not reference any drop profile but adopts tail drop.

Examples

# Bind drop profile testdp to forwarding profile testfp.

<Sysname> system-view

[Sysname] qos forwarding-profile testfp

[Sysname-hqos-fp-testfp] drop-profile testdp

gts cir

Syntax

gts cir cir-value [ cbs cbs-value ]

undo gts

View

Forwarding profile view

Default level

2: System level

Parameters

cir cir-value: Specifies the committed information rate (CIR) in kbps, which ranges from 40 to 10000000 in steps of 40.

cbs cbs-value: Specifies the committed burst size (CBS) in bytes, which ranges from 1024 to 133169152 in steps of 1024. The default CBS value (in bytes) is the traffic transmitted at the rate of CIR within 500 ms.

Description

Use the gts command to configure GTS parameters for a forwarding profile.

Use the undo gts command to delete the GTS configuration.

By default, no GTS parameters are configured for a forwarding profile, and the traffic rate is not limited.

Examples

# Configure GTS parameters for forwarding profile testfp as follows: set the CIR to 320 kbps and CBS to 2048 bytes.

<Sysname> system-view

[Sysname] qos forwarding-profile testfp

[Sysname-hqos-fp-testfp] gts cir 320 cbs 2048

qos forwarding-profile

Syntax

qos forwarding-profile fp-name [ id fp-id ]

undo qos forwarding-profile fp-name

View

System view

Default level

2: System level

Parameters

fp-name: User-defined forwarding profile name, a case-sensitive string of 1 to 31 characters. This argument cannot be the name of a pre-defined forwarding profile.

id fp-id: Specifies the user-defined forwarding profile ID, in the range of 0 to 255. The fp-id argument cannot take any pre-defined forwarding profile ID. If no ID is specified, the system assigns the lowest free ID to the forwarding profile.

Description

Use the qos forwarding-profile command to create a user-defined forwarding profile and enter forwarding profile view.

Use the undo qos forwarding-profile command to delete the specified user-defined forwarding profile.

You cannot delete a forwarding profile that has been referenced.

Examples

# Create a user-defined forwarding profile named testfp.

<Sysname> system-view

[Sysname] qos forwarding-profile testfp

wfq

Syntax

wfq [ weight weight-value ]

undo wfq

View

Forwarding profile view

Default level

2: System level

Parameters

weight weight-value: Specifies the scheduling weight, in the range of 1 to 63. The default scheduling weight is 1.

Description

Use the wfq command to configure the forwarding profile to adopt weighted fair queuing (WFQ) queue scheduling. Queues with the same priority are scheduled according to their weights. The weight of a queue determines the percentage of bandwidth assigned to the queue.

Use the undo wfq command to disable WFQ in the forwarding profile.

By default, a forwarding profile uses WFQ with the scheduling weight 1.

Examples

# Configure forwarding profile testfp to use WFQ queue scheduling, and set the weight to 2.

<Sysname> system-view

[Sysname] qos forwarding-profile testfp

[Sysname-hqos-fp-testfp] wfq weight 2

Scheduler policy configuration commands

display qos scheduler-policy diagnosis interface

Syntax

display qos scheduler-policy diagnosis interface [ interface-type interface-number [ outbound ] ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

interface-type interface-number: Specifies an interface by its type and interface number.

outbound: Displays the diagnosis information in the outbound direction of the specified interface(s).

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display qos scheduler-policy diagnosis interface command to display the diagnosis information of a specific interface. If no interface is specified, this command displays the diagnosis information of all interfaces.

Examples

# Display the diagnosis information in the outbound direction of GigabitEthernet 3/1/1.

<Sysname> display qos scheduler-policy diagnosis interface gigabitEthernet 3/1/1 outbound

SP -- scheduler policy    FG -- forwarding group    FC -- forwarding class

FP -- forwarding profile

----------------------------------------------------------------------

Interface: GigabitEthernet3/1/1

Direction: outbound

SP: sp20

 

  FG: default    FP: default

  Rule: group

  FP status: Success

 

  FG: default

  Rule: group

    FC: BE    FP: default

  FP status: Success

 

  FG: fg10

  Rule: group

    FG: fg11    FP: fp11

    Rule: match qos-local-id 11 to 20

    FP status: GTS Failed

 

  FG: fg10

  Rule: group

    FG: fg11

    Rule: match qos-local-id 11 to 20

      FC: BE    FP: default

    FP status: Success

Table 2 Output description

Field

Description

scheduler policy

Scheduler policy name

forwarding group

Forwarding group name

forwarding class

Forwarding class name

forwarding profile

Forwarding profile name

match

The match mode is adopted for instantiation.

qos-local-id

Match criteria for instantiation

FP status

The issuing status of an forwarding profile:

·       Success indicates all contents have been issued successfully:

·       If a forwarding profile has failed to be issued completely, the reason is displayed. The reason can be:

? GTS Failed—Indicates that the GTS parameters have failed to be issued to a forwarding class/forwarding group.

? WRED Failed—Indicates that the WRED parameters have failed to be issued to a forwarding class/forwarding group.

? WFQ Failed—Indicates that the WFQ queue scheduling algorithm has failed to be issued to a forwarding class/forwarding group.

? Queue bind Failed—Indicates that the queue binding has failed to be issued to a forwarding class/forwarding group.

? Bandwidth FailedIndicates that the minimum guaranteed bandwidth has failed to be applied to a forwarding class/forwarding group.

 

display qos scheduler-policy interface

Syntax

display qos scheduler-policy interface [ interface-type interface-number [ outbound ] ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

interface-type interface-number: Specifies an interface by its type and interface number. If no interface is specified, this command displays the scheduler policy configurations and statistics of all ports.

outbound: Displays the scheduler policy information and traffic statistics in the outbound direction of the specified interface(s). The SR8800 routers support only displaying the information in the outbound direction. Even if you execute this command without the outbound keyword specified, this command still displays the information in the outbound direction.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display qos scheduler-policy interface command to display the scheduler policy information and scheduler policy statistics of an interface.

Examples

# Display the scheduler policy configurations and statistics in the outbound direction of GigabitEthernet 2/1/1 after enabling QoS traffic accounting in the outbound direction.

<Sysname> display qos scheduler-policy interface gigabitethernet 2/1/1 outbound

SP -- scheduler policy   FG -- forwarding group   FC -- forwarding class

FP -- forwarding profile

-------------------------------------------------------------------------------

Interface: GigabitEthernet2/1/1

Direction: Outbound

SP: p1

  FG: default    FP: default

  Rule: group

      Forwarded: 0 packets, 0 bytes

      Forwarded green: 0 packets, 0 bytes

      Forwarded yellow: 0 packets, 0 bytes

      Forwarded red: 0 packets, 0 bytes

      Dropped: 0 packets, 0 bytes

  FG: default

  Rule: group

    FC: BE    FP: default

      Total queue length: 512 packets

      Current queue length: 0 packets, 0% use rate

      Forwarded: 0 packets, 0 bytes

      Forwarded green: 0 packets, 0 bytes

      Forwarded yellow: 0 packets, 0 bytes

      Forwarded red: 0 packets, 0 bytes

      Dropped: 0 packets, 0 bytes

  FG: default

  Rule: group

    FC: AF    FP: default

      Total queue length: 512 packets

      Current queue length: 0 packets, 0% use rate

      Forwarded: 0 packets, 0 bytes

      Forwarded green: 0 packets, 0 bytes

      Forwarded yellow: 0 packets, 0 bytes

      Forwarded red: 0 packets, 0 bytes

      Dropped: 0 packets, 0 bytes

  FG: default

  Rule: group

    FC: EF    FP: default

      Total queue length: 512 packets

      Current queue length: 0 packets, 0% use rate

      Forwarded: 0 packets, 0 bytes

      Forwarded green: 0 packets, 0 bytes

      Forwarded yellow: 0 packets, 0 bytes

      Forwarded red: 0 packets, 0 bytes

      Dropped: 0 packets, 0 bytes

  FG: default

  Rule: group

    FC: NC    FP: default

      Total queue length: 512 packets

      Current queue length: 0 packets, 0% use rate

      Forwarded: 0 packets, 0 bytes

      Forwarded green: 0 packets, 0 bytes

      Forwarded yellow: 0 packets, 0 bytes

      Forwarded red: 0 packets, 0 bytes

      Dropped: 0 packets, 0 bytes

Table 3 Output description

Field

Description

scheduler policy

Scheduler policy name

forwarding group

Forwarding group name

forwarding class

Forwarding class name

forwarding profile

Forwarding profile name

Interface

Interface to which the scheduler policy is applied

Direction

Direction in which the scheduler policy is applied

Rule

Match criteria for instantiation

Total queue length

Total length of the queue

Current queue length

Current length of the queue

use rate

Current queue length/total queue length

Forwarded packets/bytes

Number of forwarded packets/bytes

Forwarded green packets/bytes

Number of forwarded green packets/bytes

Forwarded yellow packets/bytes

Number of forwarded yellow packets/bytes

Forwarded red packets/bytes

Number of forwarded red packets/bytes

Dropped packets/bytes

Number of dropped packets/bytes

 

display qos scheduler-policy name

Syntax

display qos scheduler-policy name [ sp-name ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

sp-name: Scheduler policy name, a case-sensitive string of 1 to 31 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display qos scheduler-policy name command to display scheduler policy information. If no scheduler policy name is specified, this command displays information about all scheduler policies.

Examples

# Display information about scheduler policy test_sp.

<Sysname> display qos scheduler-policy name test_sp

SP -- scheduler policy    FG -- forwarding group    FC -- forwarding class

FP -- forwarding profile    L -- layer

--------------------------------------------------------------------------

SP: sp(1)

 |--FG(L1): default(0)

 |   |      FP: default(0)

 |   |      group

 |   |

 |   |--FC: BE(0)

 |   |      FP: default(0)

 |   |--FC: AF(1)

 |   |      FP: default(0)

 |   |--FC: EF(2)

 |   |      FP: default(0)

 |   |--FC: NC(3)

 |          FP: default(0)

 |

 |--FG(L1): 2(1)

     |      FP: 2(2)

     |      group

     |

     |--FG(L2): 1(2)

         |      FP: 1(1)

         |      match: qos-local-id 2 to 10

         |

         |--FC: BE(0)

         |      FP: 3(3)

         |--FC: AF(1)

         |      FP: default(0)

         |--FC: EF(2)

         |      FP: default(0)

         |--FC: NC(3)

                FP: default(0)

Table 4 Output description

Field

Description

scheduler policy

Scheduler policy name.

forwarding group

Forwarding group name.

forwarding class

Forwarding class name.

forwarding profile

Forwarding profile name.

layer

Layer name.

match

The match mode is adopted for instantiation.

group

The group mode is adopted for instantiation.

qos-local-id

Match criteria for instantiation.

Number in the brackets

Index number of the field (forwarding class/forwarding group/forwarding profile/scheduler policy).

 

forwarding-group group

Syntax

forwarding-group fg-name group

undo forwarding-group fg-name group

View

Scheduler policy layer view

Default level

2: System level

Parameters

fg-name: Forwarding group name, a case-sensitive string of 1 to 31 characters.

Description

Use the forwarding-group group command to instantiate a forwarding group in the group mode.

Use the undo forwarding-group group command to delete the instance generated from the forwarding group in the group mode.

A forwarding group with nested forwarding classes cannot be instantiated in the group mode.

Examples

# Instantiate forwarding group testfg of scheduler policy testsp in the group mode.

<Sysname> system-view

[Sysname] qos scheduler-policy testsp

[Sysname-hqos-sp-testsp] layer 1

[Sysname-hqos-sp-testsp-layer1] forwarding-group testfg group

forwarding-group match

Syntax

forwarding-group fg-name match [ extended ] qos-local-id { local-id-list | local-id1 to local-id2 }

undo forwarding-group fg-name match [ extended ] qos-local-id { local-id-list | local-id1 to local-id2 }

View

Scheduler policy layer view

Default level

2: System level

Parameters

fg-name: Forwarding group name, a case-sensitive string of 1 to 31 characters.

extended: Makes bulk configuration to create a forwarding group instance based on each classification rule.

qos-local-id { local-id-list | local-id1 to local-id2 }: Matches packets by QoS-local-ID marked for them. The local-id-list argument is the list of QoS-local-IDs, for which you can input up to eight QoS-local-IDs. The local-id1 to local-id2 argument specifies a QoS-local-ID range, where the local-id1 argument must be smaller than the local-id2 argument. A QoS-local-ID is in the range of 1 to 4095.

Description

Use the forwarding-group match command to instantiate a forwarding group in the match mode according to the specified match criterion.

Use the undo forwarding-group match command to delete the instance generated from the forwarding group according to the specified match criterion.

In the same scheduler policy, instantiate a parent forwarding group before instantiating its child forwarding groups.

In the same scheduler policy, make sure that the match criterion of a child forwarding group is covered in the match criterion of its parent forwarding group. This restriction is not true for the parent forwarding group instantiated in the group mode.

When applying a scheduler policy to an interface, make sure that the match criterion of each parent forwarding group equals the set of match criteria of its child forwarding groups. This restriction is not true for the parent forwarding group instantiated in the group mode.

In the same scheduler policy, the instantiation match criterion of a forwarding group cannot overlap the instantiation match criterion of any other forwarding group except its parent forwarding group or child forwarding groups.

For any forwarding group in a scheduler policy already applied to a port, you cannot instantiate the forwarding group or delete its instances.

Related commands: forwarding-group group.

Examples

# Instantiate forwarding group testfg in scheduler policy testfp in the match mode.

<Sysname> system-view

[Sysname] qos scheduler-policy testsp

[Sysname-hqos-sp-testsp] layer 1

[Sysname-hqos-sp-testsp-layer1] forwarding-group testfg match extended qos-local-id 1 to 4

forwarding-group profile (scheduler-policy view)

Syntax

forwarding-group fg-name profile fp-name

undo forwarding-group fg-name

View

Scheduler policy view

Default level

2: System level

Parameters

fg-name: Forwarding group name, a case-sensitive string of 1 to 31 characters.

fp-name: Forwarding profile name, a case-sensitive string of 1 to 31 characters.

Description

Use the forwarding-group profile command to nest a forwarding group in a scheduler policy and specify a forwarding profile for this forwarding group.

Use the undo forwarding-group command to remove the specified forwarding group from the scheduler policy.

The forwarding group to be nested in a scheduler policy and the forwarding profile to be specified for the forwarding group must already exist.

You cannot remove any forwarding group from a scheduler policy that has been applied to a port.

You cannot remove the default forwarding group automatically nested in a scheduler policy.

Examples

# Nest forwarding group subfg in scheduler policy testsp and specify forwarding profile testfp for this forwarding group.

<Sysname> system-view

[Sysname] qos scheduler-policy testsp

[Sysname-hqos-sp-testsp] forwarding-group testfg profile testfp

layer

Syntax

layer { 1 | 2 }

View

Scheduler policy view, scheduler policy layer view

Default level

2: System level

Parameters

1: Enters scheduler policy layer 1 view.

2: Enters scheduler policy layer 2 view.

Description

Use the layer command to enter scheduler policy layer view.

Examples

# Enter scheduler policy layer 1 view.

<Sysname> system-view

[Sysname] qos scheduler-policy testsp

[Sysname-hqos-sp-testsp] layer 1

[Sysname-hqos-sp-testsp-layer1]

qos apply scheduler-policy

Syntax

qos apply scheduler-policy sp-name outbound

undo qos apply scheduler-policy outbound

View

Ethernet interface view, port group view, POS interface view, ATM interface view, serial interface view, MP-group interface view

Default level

2: System level

Parameters

sp-name: Scheduler policy name, a case-sensitive string of 1 to 31 characters.

Description

Use the qos apply scheduler-policy command to apply a scheduler policy in the inbound direction of an interface or port group.

Use the undo qos apply scheduler-policy command to remove the scheduler policy applied in the inbound direction of the interface or port group.

Configured in interface view, the setting is effective on the current port only; configured in port group view, the setting is effective on all ports in the port group.

The scheduler policy applied to an interface is mutually exclusive with the QoS policies (including queue-based GTS, port-based WRED, and hardware queue scheduling) applied to the interface.

Examples

# Apply scheduler policy testsp to interface GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet3/1/1

[Sysname-GigabitEthernet3/1/1] qos apply scheduler-policy testsp outbound

# Apply scheduler policy testsp to interface Serial  2/1/19:0.

<Sysname> system-view

[Sysname] interface Serial 2/1/19:0

[Sysname-Serial2/1/19:0]qos apply scheduler-policy testsp outbound

qos copy scheduler-policy

Syntax

qos copy scheduler-policy sp-source to sp-dest

View

System view

Default level

2: System level

Parameters

sp-source: Source scheduler policy name, a case-sensitive string of 1 to 31 characters. The source scheduler policy identified by this argument must already exist.

sp-dest: Destination scheduler policy name, a case-sensitive string of 1 to 31 characters. The specified destination scheduler policy must not be one that already exists.

Description

Use the qos copy scheduler-policy command to create a new scheduler policy of the same contents as the specified source scheduler policy.

Examples

# Copy the contents of scheduler policy sp-source to create a new scheduler policy named sp-dest.

<Sysname> system-view

[Sysname] qos copy scheduler-policy sp-source to sp-dest

qos scheduler-policy

Syntax

qos scheduler-policy sp-name [ id sp-id ]

undo qos scheduler-policy sp-name

View

System view

Default level

2: System level

Parameters

sp-name: User-defined scheduler policy name, a case-sensitive string of 1 to 31 characters.

id sp-id: Specifies a user-defined scheduler policy ID, in the range of 0 to 15. If no ID is specified, the system assigns the lowest free ID to the scheduler policy.

Description

Use the qos scheduler-policy command to create a user-defined scheduler policy and enter scheduler policy view.

Use the undo qos scheduler-policy command to delete the user-defined scheduler policy.

On creation, a user-defined scheduler policy nests the default forwarding group and associates the default forwarding group with the default forwarding profile automatically.

You cannot delete the scheduler policy that has been applied to an interface.

Examples

# Create a user-defined scheduler policy testsp.

<Sysname> system-view

[Sysname] qos scheduler-policy testsp

remark qos-local-id

Syntax

remark qos-local-id local-id-value

undo remark qos-local-id

View

Traffic behavior view

Default level

2: System level

Parameters

local-id-value: QoS local ID to be marked for packets, in the range of 1 to 4095.

Description

Use the remark qos-local-id command to configure the action of setting the specified QoS local ID for packets.

Use the undo remark qos-local-id command to delete the action.

Examples

# Configure the action of marking packets with QoS local ID 2.

<Sysname> system-view

[Sysname] traffic behavior database

[Sysname-behavior-database] remark qos-local-id 2