- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
04-HQoS Commands | 179.23 KB |
Contents
Forwarding class configuration commands
Forwarding group configuration commands
forwarding-group profile (forwarding-group view)
Drop profile configuration commands
Forwarding profile configuration commands
display qos forwarding-profile
Scheduler policy configuration commands
display qos scheduler-policy diagnosis interface
display qos scheduler-policy interface
display qos scheduler-policy name
forwarding-group profile (scheduler-policy view)
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 Failed—Indicates 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