Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 04-HQoS commands | 148.54 KB |
forwarding-group (forwarding group match criterion view)
display qos forwarding-profile
display qos scheduler-policy diagnosis interface
display qos scheduler-policy interface
forwarding-group profile (scheduler-policy match criterion view)
HQoS commands
Forwarding class commands
display qos forwarding-class
Use display qos forwarding-class to display forwarding classes.
Syntax
display qos forwarding-class [ name fc-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
name fc-name: Specifies a forwarding class by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a forwarding class, the command displays all forwarding classes.
Examples
# Display forwarding class BE.
<Sysname> display qos forwarding-class name BE
Forwarding class: BE, ID: 0
# Display all forwarding classes.
<Sysname> display qos forwarding-class
Forwarding class: BE, ID: 0
Forwarding class: L2, ID: 1
Forwarding class: AF, ID: 2
Forwarding class: L1, ID: 3
Forwarding class: H2, ID: 4
Forwarding class: EF, ID: 5
Forwarding class: H1, ID: 6
Forwarding group commands
display qos forwarding-group
Use display qos forwarding-group to display forwarding groups.
Syntax
display qos forwarding-group [ name fg-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
name fg-name: Specifies a forwarding group by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a forwarding group, the command displays all forwarding groups.
Examples
# Display forwarding group testfg1, which has child forwarding groups.
<Sysname> display qos forwarding-group name testfg1
Forwarding group: testfg1, ID: 10
match service-vlan-id 1
Forwarding group: subfg1, ID: 1, profile: fgprofile1
match service-vlan-id 11
Forwarding group: subfg2, ID: 2, profile: fgprofile2
# Display forwarding group testfg2, which has nested forwarding classes.
<Sysname> display qos forwarding-group name testfg2
Forwarding group: testfg2, ID: 10
Forwarding class: BE, ID: 0, profile: fcprofile1
Forwarding class: AF, ID: 1, profile: fcprofile2
Forwarding class: EF, ID: 2, profile: fcprofile3
Forwarding class: NC, ID: 3, profile: fcprofile4
forwarding-class
Use forwarding-class to nest a forwarding class in a forwarding group and specify a forwarding profile for the forwarding class.
Use undo forwarding-class to remove a nested forwarding class from a forwarding group.
Syntax
forwarding-class fc-name profile fp-name
undo forwarding-class fc-name
Default
A user-defined forwarding group does not have nested forwarding classes.
Views
Forwarding group view
Predefined user roles
network-admin
Parameters
fc-name: Specifies a forwarding class by its name. Only these predefined forwarding classes can be specified: BE, L2, AF, L1, H2, EF, H1, and NC.
profile fp-name: Specifies a forwarding profile by its name, a case-sensitive string of 1 to 31 characters.
Usage guidelines
You cannot modify or remove the predefined forwarding classes nested in the predefined forwarding group.
The forwarding profile to be associated must already exist.
You cannot nest a forwarding class in a forwarding group with child forwarding groups nested.
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 (forwarding group match criterion view)
Use forwarding-group to perform the following tasks:
· Nest a forwarding group (child) in a match criterion of another forwarding group (parent).
· Specify a forwarding profile for the child forwarding group.
Use undo forwarding-group to remove the nested forwarding group.
Syntax
forwarding-group sub-fg-name profile fp-name
undo forwarding-group sub-fg-name
Default
A user-defined forwarding group does not have child forwarding groups.
Views
Forwarding group match criterion view
Predefined user roles
network-admin
Parameters
sub-fg-name: Specifies a child forwarding group by its name, a case-sensitive string of 1 to 31 characters.
profile fp-name: Specifies a forwarding profile by its name, a case-sensitive string of 1 to 31 characters.
Usage guidelines
The child forwarding group and the forwarding profile to be specified must already exist.
You cannot nest a forwarding group in a forwarding group with forwarding classes nested.
A forwarding group with forwarding groups nested cannot be nested in another forwarding group.
Examples
# Configure the match criterion VLAN ID 2 for forwarding group testfg. Nest forwarding group subfg in forwarding group testfg, and specify forwarding profile testfp for forwarding group subfg.
<Sysname> system-view
[Sysname] qos forwarding-group testfg
[Sysname-hqos-fg-testfg] match service-vlan-id 2
[Sysname-hqos-fg-testfg-match] forwarding-group subfg profile testfp
match
Use match to configure a match criterion for a parent forwarding group and enter forwarding group match criterion view, or enter the view of an existing match criterion.
Use undo match to delete the configured match criterion.
Syntax
match match-criteria
undo match match-criteria
Default
No match criteria exist.
Views
Forwarding group view
Predefined user roles
network-admin
Parameters
match-criteria: Specifies a match criterion. Table 1 shows the available match criteria.
Table 1 Available match criteria
|
Option |
Description |
|
local-precedence precedence-value |
Matches the local precedence. The precedence-value argument specifies a local precedence value in the range of 0 to 7. |
|
service-vlan-id vlan-id [ customer-vlan-id vlan-id ] |
Matches the service provider VLAN ID (SVLANs) and customer VLAN ID (CVLAN). The vlan-id argument specifies a VLAN ID in the range of 1 to 4094. |
Usage guidelines
Executing the match command only leads you to the forwarding group match criterion view. The configured match criterion takes effect only after a child forwarding group is configured in that view.
You cannot configure the group mode for a forwarding group with forwarding classes nested.
Removing a match criterion also removes the child forwarding group and its associated forwarding profile.
Examples
# Configure the match criterion service VLAN ID 2 and enter forwarding group match criterion view.
<Sysname> system-view
[Sysname] qos forwarding-group testfg
[Sysname-hqos-fg-testfg] match service-vlan-id 2
[Sysname-hqos-fg-testfg-match]
Related commands
forwarding-group profile (scheduler-policy match criterion view)
qos forwarding-group
Use qos forwarding-group to create a user-defined forwarding group and enter its view, or enter the view of an existing forwarding group.
Use undo qos forwarding-group to delete a user-defined forwarding group.
Syntax
qos forwarding-group fg-name
undo qos forwarding-group fg-name
Default
No user-defined forwarding groups exist.
Views
System view
Predefined user roles
network-admin
Parameters
fg-name: Specifies a forwarding group name, a case-sensitive string of 1 to 31 characters. This argument cannot be the name of the predefined forwarding group (default).
Usage guidelines
You cannot modify or delete the predefined forwarding group default (numbered 0).
The system supports a maximum number of 8191 user-defined forwarding groups.
To delete a forwarding group nested in another forwarding group or a scheduler policy, first remove the nesting.
Examples
# Create a forwarding group named testfg.
<Sysname> system-view
[Sysname] qos forwarding-group testfg
[Sysname-hqos-fg-testfg]
Forwarding profile commands
display qos forwarding-profile
Use display qos forwarding-profile to display forwarding profiles.
Syntax
display qos forwarding-profile [ name fp-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
name fp-name: Specifies a forwarding profile by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a forwarding profile, the command displays all forwarding profiles.
Examples
# Display forwarding profile testfp.
<Sysname> display qos forwarding-profile name testfp
Forwarding profile: testfp, ID: 10
GTS: CIR 100(kbps)
WRR: weight 1
Table 2 Command output
|
Field |
Description |
|
Drop profile |
Drop profile name. |
gts
Use gts to configure GTS parameters for a forwarding profile.
Use undo gts to restore the default.
Syntax
gts cir cir-value
undo gts
Default
No GTS configuration exists in a forwarding profile.
Views
Forwarding profile view
Predefined user roles
network-admin
Parameters
cir-value: Specifies the CIR in kbps. The value range for cir-value is 8 to 10000000, in increments of 8.
Examples
# Configure GTS parameters for forwarding profile testfp.
<Sysname> system-view
[Sysname] qos forwarding-profile testfp
[Sysname-hqos-fp-testfp] gts cir 800
qos forwarding-profile
Use qos forwarding-profile to create a user-defined forwarding profile and enter its view, or enter the view of an existing forwarding profile.
Use undo qos forwarding-profile to delete a user-defined forwarding profile.
Syntax
qos forwarding-profile fp-name
undo qos forwarding-profile fp-name
Default
No user-defined forwarding profiles exist.
Views
System view
Predefined user roles
network-admin
Parameters
fp-name: Specifies a forwarding profile name, a case-sensitive string of 1 to 31 characters. This argument cannot be the name of the predefined forwarding profile (default).
Usage guidelines
You cannot modify or delete the predefined forwarding profile default.
To delete a forwarding group nested in another forwarding group or a scheduler policy, first remove the nesting.
Examples
# Create a forwarding profile named testfp.
<Sysname> system-view
[Sysname] qos forwarding-profile testfp
sp
Use sp to enable SP queuing for a forwarding profile.
Use undo sp to restore the default.
Syntax
sp
undo sp
Default
No SP queuing configuration exists in a forwarding profile.
Views
Forwarding profile view
Predefined user roles
network-admin
Examples
# Enable SP queuing for forwarding profile testfp.
<Sysname> system-view
[Sysname] qos forwarding-profile testfp
[Sysname-hqos-fp-testfp] sp
wrr
Use wrr to configure WRR queuing for a forwarding profile.
Use undo wrr to restore the default.
Syntax
wrr [ weight weight-value ]
undo wrr
Default
No WRR queuing configuration exists in a forwarding profile.
Views
Forwarding profile view
Predefined user roles
network-admin
Parameters
weight weight-value: Specifies the scheduling weight in the range of 1 to 15. The default is 1.
Usage guidelines
The weight of a WRR queue determines the percentage of bandwidth assigned to the queue.
Examples
# Configure WRR queuing for forwarding profile testfp.
<Sysname> system-view
[Sysname] qos forwarding-profile testfp
[Sysname-hqos-fp-testfp] wrr weight 2
Scheduler policy commands
display qos scheduler-policy
Use display qos scheduler-policy to display scheduler policies.
Syntax
display qos scheduler-policy [ name sp-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
name sp-name: Specifies a scheduler policy by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a scheduler policy, the command displays all scheduler policies.
Examples
# Display 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: test_sp(1)
| Scheduler unit: byte-count
|
| | Match: service-vlan-id 2
| +--FG(L2): Customer1(2)
| | | FP: Customer1(1)
| | |
| | +--FC: BE(0)
| | | FP: BE(3)
| | |
| | +--FC: AF(1)
| | | FP: default(0)
| | |
| | +--FC: EF(2)
| | | FP: default(0)
| | |
| | +--FC: NC(3)
| | FP: default(0)
| |
| | Match: service-vlan-id 11
| +--FG(L2): Customer2(5)
| | FP: Customer2(2)
| |
| +--FC: BE(0)
| | FP: BE(3)
| |
| +--FC: AF(1)
| | FP: default(0)
| |
| +--FC: EF(2)
| | FP: default(0)
| |
| +--FC: NC(3)
| FP: default(0)
|
| Match: service-vlan-id 21
+--FG(L2): Customer3(6)
| FP: Customer3(6)
|
+--FC: BE(0)
| FP: BE(3)
|
+--FC: AF(1)
| FP: default(0)
|
+--FC: EF(2)
| FP: default(0)
|
+--FC: NC(3)
FP: default(0)
Table 3 Command output
|
Field |
Description |
|
match |
The match mode is used for configuring match criteria. |
|
Number in the brackets |
ID of the field (forwarding class/forwarding group/forwarding profile/scheduler policy). |
display qos scheduler-policy diagnosis interface
Use display qos scheduler-policy diagnosis interface to display diagnosis information about scheduler policies applied to subinterfaces.
Syntax
display qos scheduler-policy diagnosis interface [ interface-type interface-number.subnumber ] outbound
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number.subnumber: Specifies a subinterface by its type and number.
outbound: Specifies scheduler policies applied to the outbound direction.
Usage guidelines
If you do not specify a subinterface, the command displays diagnosis information about all applied scheduler policies.
Examples
# Display diagnosis information about the scheduler policy applied to the outbound direction of Gigabitethernet 1/0/12.1.
<Sysname> display qos scheduler-policy diagnosis interface gigabitethernet 1/0/12.1 outbound
SP -- Scheduler policy FG -- Forwarding group FC -- Forwarding class
FP -- Forwarding profile L -- Layer
--------------------------------------------------------------------------
Interface: Gigabitethernet1/0/12.1
Direction: Outbound
SP: test_sp(1)
|
| | Match: service-vlan-id 2
| +--FG(L2): Customer1(2)
| | | FP: Customer1(1)
| | | Status: Success
| | |
| | +--FC: BE(0)
| | | FP: BE(3)
| | | Status: Queue Failed
| | |
| | +--FC: AF(1)
| | | FP: default(0)
| | | Status: GTS Failed
| | |
| | +--FC: EF(2)
| | | FP: default(0)
| | | Status: Success
| | |
| | +--FC: NC(3)
| | FP: default(0)
| | Status: Success
| |
| | Match: service-vlan-id 11
| +--FG(L2): Customer2(5)
| | FP: Customer2(2)
| | Status: Incomplete
| |
| +--FC: BE(0)
| | FP: BE(3)
| | Status: Incomplete
| |
| +--FC: AF(1)
| | FP: default(0)
| | Status: Incomplete
| |
| +--FC: NC(3)
| FP: default(0)
| Status: Incomplete
| |
| Match: service-vlan-id 21
+--FG(L2): Customer3(6)
| FP: Customer3(6)
| Status: Insufficient resources
|
+--FC: BE(0)
| FP: BE(3)
| Status: Insufficient resources
|
+--FC: AF(1)
| FP: default(0)
| Status: Insufficient resources
|
+--FC: EF(2)
| FP: default(0)
| Status: Insufficient resources
|
+--FC: NC(3)
FP: default(0)
Status: Insufficient resources
Table 4 Command output
|
Field |
Description |
|
Forwarding profile |
Forwarding profile name. |
|
Status |
Issuing status of a forwarding profile: · Incomplete—Incomplete match criteria. · Success—All contents have been issued successfully. · Inactive—A forwarding profile does not take effect. · If a forwarding profile has failed to be issued completely, the following possible reasons are displayed: ¡ Insufficient resources. ¡ Conflicting match rule. ¡ Not support. ¡ GTS Failed—The GTS parameters failed to be issued to a forwarding class or forwarding group. |
display qos scheduler-policy interface
Use display qos scheduler-policy interface to display the statistics and configuration for scheduler policies applied to subinterfaces.
Syntax
display qos scheduler-policy interface [ interface-type interface-number.subnumber ] outbound
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number.subnumber: Specifies a subinterface by its type and number.
outbound: Specifies scheduler policies applied to the outbound direction.
Usage guidelines
If you do not specify a subinterface, the command displays the statistics and configuration for all applied scheduler policies.
Examples
# Display the configuration and statistics for the scheduler policy applied to the outbound direction of Gigabitethernet 1/0/12.1.
<Sysname> display qos scheduler-policy interface gigabitethernet 1/0/12.1 outbound
SP -- Scheduler policy FG -- Forwarding group FC -- Forwarding class
FP -- Forwarding profile L -- Layer
--------------------------------------------------------------------------
Interface: Gigabitethernet1/0/12.1
Direction: Outbound
SP: test_sp(1)
|
| | Match: service-vlan-id 2
| +--FG(L2): Customer1(2)
| | | FP: Customer1(1)
| | |
| | +--FC: BE(0)
| | | FP: BE(3)
| | |
| | +--FC: AF(1)
| | | FP: default(0)
| | |
| | +--FC: EF(2)
| | | FP: default(0)
| | |
| | +--FC: NC(3)
| | FP: default(0)
| |
| | Match: service-vlan-id 11
| +--FG(L2): Customer2(5)
| | FP: Customer2(2)
| |
| +--FC: BE(0)
| | FP: BE(3)
| |
| +--FC: AF(1)
| | FP: default(0)
| |
| +--FC: NC(3)
| FP: default(0)
|
| Match: service-vlan-id 21
+--FG(L2): Customer3(6)
| FP: Customer3(6)
|
+--FC: BE(0)
| FP: BE(3)
|
+--FC: AF(1)
| FP: default(0)
|
+--FC: EF(2)
| FP: default(0)
|
+--FC: NC(3)
FP: default(0)
Table 5 Command output
|
Field |
Description |
forwarding-group profile (scheduler-policy match criterion view)
Use forwarding-group profile to nest a forwarding group in a match criterion of a scheduler policy and specify a forwarding profile for the forwarding group.
Use undo forwarding-group to remove the nested forwarding group from a match criterion of a scheduler policy.
Syntax
forwarding-group fg-name profile fp-name
undo forwarding-group fg-name
Default
The predefined forwarding group is nested in a scheduler policy in group mode.
Views
Scheduler policy match criterion view
Predefined user roles
network-admin
Parameters
fg-name: Specifies a forwarding group by its name, a case-sensitive string of 1 to 31 characters.
profile fp-name: Specifies a forwarding profile by its name, a case-sensitive string of 1 to 31 characters.
Usage guidelines
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 the predefined forwarding group automatically nested in a scheduler policy.
Examples
# Configure the match criterion VLAN ID 1 for scheduler policy testsp. Nest forwarding group testfg in scheduler policy testsp, and specify the forwarding profile testfp for forwarding group testfg.
<Sysname> system-view
[Sysname] qos scheduler-policy testsp
[Sysname-hqos-sp-testsp] match service-vlan-id 1
[Sysname-hqos-sp-testsp-match] forwarding-group testfg profile testfp
Related commands
match
match
Use match to configure a match criterion for a scheduler policy and enter its view, or enter the view of an existing scheduler policy match criterion.
Use undo match to delete the configured match criteria.
Syntax
match match-criteria
undo match match-criteria
Default
A user-defined scheduler policy has no match criteria.
Views
Scheduler policy view
Predefined user roles
network-admin
Parameters
match-criteria: Specifies a match criterion. Table 6 shows the available match criteria.
Table 6 Available match criteria
|
Option |
Description |
|
local-precedence precedence-value |
Matches the local precedence. The precedence-value argument specifies a local precedence value in the range of 0 to 7. |
|
service-vlan-id vlan-id [ customer-vlan-id vlan-id ] |
Matches the outer VLAN ID (SVLAN) and inner VLAN ID (CVLAN). The vlan-id argument specifies a VLAN ID in the range of 1 to 4094. |
Usage guidelines
Executing the match command only leads you to the scheduler policy match criterion view. The configured match criterion takes effect only after a child forwarding group is configured in that view.
Removing a match criterion for a scheduler policy also removes the nested forwarding groups and their associated forwarding profiles for the scheduler policy.
Examples
# Configure the match criterion VLAN ID 1 for scheduler policy testsp.
<Sysname> system-view
[Sysname] qos scheduler-policy testsp
[Sysname-hqos-sp-testsp] match service-vlan-id 1
[Sysname-hqos-sp-testsp-match]
Related commands
forwarding-group profile (scheduler-policy match criterion view)
qos apply scheduler-policy
Use qos apply scheduler-policy to apply a scheduler policy to a subinterface.
Use undo qos apply scheduler-policy to remove a scheduler policy from a subinterface.
Syntax
qos apply scheduler-policy sp-name outbound
undo qos apply scheduler-policy sp-name outbound
Default
No scheduler policy is applied to a subinterface.
Views
Subinterface view
Predefined user roles
network-admin
Parameters
sp-name: Specifies a scheduler policy by its name, a case-sensitive string of 1 to 31 characters.
outbound: Applies a scheduler policy to the outbound direction of an interface.
Examples
# Apply scheduler policy testsp to the outbound direction of GigabitEthernet 1/0/12.1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/12.1
[Sysname-GigabitEthernet1/0/12.1] qos apply scheduler-policy testsp outbound
qos scheduler-policy
Use qos scheduler-policy to create a user-defined scheduler policy and enter its view, or enter the view of an existing scheduler policy.
Use undo qos scheduler-policy to delete a user-defined scheduler policy.
Syntax
qos scheduler-policy sp-name
undo qos scheduler-policy sp-name
Default
No user-defined scheduler policies exist.
Views
System view
Predefined user roles
network-admin
Parameters
sp-name: Specifies a scheduler policy name, a case-sensitive string of 1 to 31 characters.
Usage guidelines
The system supports a maximum number of 256 user-defined scheduler policies.
Examples
# Create a scheduler policy named testsp.
<Sysname> system-view
[Sysname] qos scheduler-policy testsp
scheduler-unit
Use scheduler-unit to specify the scheduling unit for a scheduler policy.
Use undo scheduler-unit to restore the default.
Syntax
scheduler-unit byte-count
undo scheduler-unit
Default
The scheduling unit for a scheduler policy is byte-count.
Views
Scheduler policy view
Predefined user roles
network-admin
Parameters
byte-count: Allocates bandwidth based on the number of bytes.
Examples
# Set the scheduling unit to byte-count for scheduler policy named testsp.
<Sysname> system-view
[Sysname] qos scheduler-policy testsp
[Sysname-hqos-sp-testsp] scheduler-unit byte-count
