- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-QoS commands | 744.69 KB |
Contents
display qos policy control-plane
display qos policy control-plane pre-defined
display qos policy user-profile
qos apply policy (interface view, control plane view)
qos apply policy (user profile view)
reset qos policy control-plane
QoS policy-based traffic rate statistics collection period commands
Interface channelization commands
display mode channel-bandwidth interface
Traffic policing, GTS, and rate limit commands
qos car percent (interface view)
qos lr outbound (user profile view)
Congestion management commands
display qos queue pq interface
display qos queue cq interface
display qos queue rtpq interface
QoS policy commands
Traffic class commands
description
Use description to configure a description for a traffic class.
Use undo description to delete the description of a traffic class.
Syntax
description text
undo description
Default
No description is configured for a traffic class.
Views
Traffic class view
Predefined user roles
network-admin
Parameters
text: Specifies a description, a case-sensitive string of 1 to 127 characters.
Usage guidelines
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure the description as classifier for traffic class class1.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] description classifier
display traffic classifier
Use display traffic classifier to display traffic classes.
Syntax
display traffic classifier { system-defined | user-defined } [ classifier-name ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
system-defined: Specifies system-defined traffic classes.
user-defined: Specifies user-defined traffic classes.
classifier-name: Specifies a traffic class by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a traffic class, this command displays all traffic classes.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the traffic classes for the active MPU.
Examples
# Display all user-defined traffic classes.
<Sysname> display traffic classifier user-defined
User-defined classifier information:
Classifier: 1 (ID 100)
Operator: AND
Rule(s) :
If-match acl 2000
Classifier: 2 (ID 101)
Operator: AND
Rule(s) :
If-match protocol ipv6
Classifier: 3 (ID 102)
Operator: AND
Rule(s) :
-none-
# Display the system-defined traffic class (default-class).
<Sysname> display traffic classifier system-defined default-class
System-defined classifier information:
Classifier: default-class (ID 0)
Operator: AND
Rule(s) :
If-match any
Field |
Description |
Classifier |
Traffic class name and its match criteria. |
Operator |
Match operator you set for the traffic class. If the operator is AND, the traffic class matches the packets that match all its match criteria. If the operator is OR, the traffic class matches the packets that match any of its match criteria. |
Rule(s) |
Match criteria. |
if-match
Use if-match to define a match criterion.
Use undo if-match to delete a match criterion.
Syntax
if-match [ not ] match-criteria
undo if-match [ not ] match-criteria
Default
No match criterion is configured.
Views
Traffic class view
Predefined user roles
network-admin
Parameters
not: Matches packets that do not conform to the specified criterion.
match-criteria: Specifies a match criterion. Table 2 shows the available match criteria.
Table 2 Available match criteria
Option |
Description |
acl [ ipv6 | mac ] { acl-number | name acl-name } |
Matches an ACL. The value range for the acl-number argument is as follows: · 2000 to 3999 for IPv4 ACLs. · 2000 to 3999 for IPv6 ACLs. · 4000 to 4999 for Layer 2 MAC ACLs. The acl-name argument is a case-insensitive string of 1 to 63 characters, which must start with an English letter. To avoid confusion, make sure the argument is not all. If no VPN instance is specified in an ACL rule, the ACL rule takes effect on only non-VPN packets. |
any |
Matches all packets. |
app-group group-name |
Matches an application group. The group-name argument specifies an application group by its name. The application group must have been created. A nonexistent application group cannot match packets. For more information about creating application groups, see APR in Security Configuration Guide. |
application app-name |
Matches an application. The app-name argument specifies a user-created or system-defined application by its name. |
classifier classifier-name |
Matches a class. The classifier-name argument specifies a class by its name. |
control-plane protocol protocol-name&<1-8> |
Matches control plane protocols. The protocol-name&<1-8> argument specifies a space-separated list of up to eight system-defined control plane protocols. For available system-defined control plane protocols, see Table 3. |
control-plane protocol-group protocol-group-name |
Matches a control plane protocol group. The protocol-group-name argument can be critical, exception, important, management, monitor, normal, or redirect. |
customer-dot1p dot1p-value&<1-8> |
Matches 802.1p priority values in inner VLAN tags of double-tagged packets. The dot1p-value&<1-8> argument specifies a space-separated list of up to eight 802.1p priority values. The value range for the dot1p-value argument is 0 to 7. |
customer-vlan-id vlan-id-list |
Matches VLAN IDs in inner VLAN tags of double-tagged packets. The vlan-id-list argument specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 to vlan-id2. The value for vlan-id2 must be greater than or equal to the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. |
destination-mac mac-address |
Matches a destination MAC address. This option takes effect only on Ethernet interfaces. |
dscp dscp-value&<1-8> |
Matches DSCP values. The dscp-value&<1-8> argument specifies a space-separated list of up to eight DSCP values. The value range for the dscp-value argument is 0 to 63 or keywords shown in Table 5. |
inbound-interface interface-type interface-number |
Matches an input interface specified by its type and number. If this option is configured in a traffic class with logic AND operator, the traffic class is no longer in effect after the card or subcard where the input interface resides is removed. After the removed card or subcard is reinserted, the traffic class takes effect again. If you do not reinsert the card or subcard and add other match criteria to the traffic class, the traffic class does not take effect again. |
ip-precedence ip-precedence-value&<1-8> |
Matches IP precedence values. The ip-precedence-value&<1-8> argument specifies a space-separated list of up to eight IP precedence values. The value range for the ip-precedence-value argument is 0 to 7. |
local-precedence local-precedence-value&<1-8> |
Matches local precedence values. The local-precedence-value&<1-8> argument specifies a space-separated list of up to eight local precedence values. The value range for the local-precedence-value argument is 0 to 7. |
mpls-exp exp-value&<1-8> |
Matches MPLS EXP values. The exp-value&<1-8> argument specifies a space-separated list of up to eight EXP values. The value range for the exp-value argument is 0 to 7. For devices that forward packets in software, MPLS packets do not support IP-related match criteria. |
packet-length { min min-value | max max-value } * |
Matches the packet length. The min-value argument specifies the minimum packet length in bytes. The max-value argument specifies the maximum packet length in bytes. The maximum packet length must be greater than or equal to the minimum packet length. |
protocol protocol-name |
Matches a protocol. The protocol-name argument can be arp, ip, or ipv6. |
qos-local-id local-id-value |
Matches a local QoS ID in the range of 1 to 4095. |
rtp start-port start-port-number end-port end-port-number |
Matches RTP protocol ports. The value ranges for the start-port-number and end-port-number arguments are both 2000 to 65535. This criterion matches RTP packets with an even UDP destination port number in the specified RTP port number range. |
source-mac mac-address |
Matches a source MAC address. This option takes effect only on Ethernet interfaces. |
vpn-instance vpn-name |
Matches a VPN instance. |
vxlan { any | vxlan-id } |
Matches a VXLAN ID. |
Table 3 Available system-defined control plane protocols
Protocol |
Description |
default |
Protocol packets other than the following packet types |
arp |
ARP packets |
bgp |
BGP packets |
bgp4+ |
IPv6 BGP packets |
bpdu-tunnel |
BPDU tunnel packets |
cdp |
CDP packets |
cfd |
CFD packets |
ftp |
FTP packets |
http |
HTTP packets |
https |
HTTPS packets |
icmp |
ICMP packets |
icmpv6 |
ICMPv6 packets |
igmp |
IGMP packets |
isis |
IS-IS packets |
ldp |
LDP packets |
ldp6 |
IPv6 LDP packets |
msdp |
MSDP packets |
ntp |
NTP packets |
ospf-multicast |
OSPF multicast packets |
ospf-unicast |
OSPF unicast packets |
ospf3-multicast |
OSPFv3 multicast packets |
ospf3-unicast |
OSPFv3 unicast packets |
pim-multicast |
PIM multicast packets |
pim-unicast |
PIM unicast packets |
pim6-multicast |
IPv6 PIM multicast packets |
pim6-unicast |
IPv6 PIM unicast packets |
radius |
RADIUS packets |
rip |
RIP packets |
ripng |
RIPng packets |
rsvp |
RSVP packets |
snmp |
SNMP packets |
ssh |
SSH packets |
tacacs |
TACACS packets |
telnet |
Telnet packets |
tftp |
TFTP packets |
vrrp |
VRRP packets |
vrrp6 |
IPv6 VRRP packets |
Usage guidelines
In a traffic class with the logical OR operator, you can configure multiple if-match commands for any of the available match criteria.
When you configure a match criterion that can have multiple values in one if-match command, follow these restrictions and guidelines:
· You can specify up to eight values for any of the following match criteria in one if-match command:
¡ Control plane protocol.
¡ 802.1p priority.
¡ DSCP.
¡ IP precedence.
¡ Local precedence.
¡ MPLS EXP.
· If a packet matches one of the specified values, it matches the if-match command.
· To delete a criterion that has multiple values, the specified values in the undo if-match command must be the same as those specified in the if-match command. The order of the values can be different.
To use an ACL match criterion, the ACL must already exist.
To match the outer header information of VXLAN packets, you can directly use the options supported by an if-match command (excluding if-match acl).
· If the ACL contains deny rules, the if-match command is ignored and the matching process continues.
You can use both AND and OR operators to define the match relationships between the criteria for a class. For example, you can define relationships among three match criteria in traffic class classA as follows:
traffic classifier classB operator and
if-match criterion 1
if-match criterion 2
traffic classifier classA operator or
if-match criterion 3
if-match classifier classB
Examples
# Define a match criterion for traffic class class1 to match the packets with a destination MAC address of 0050-ba27-bed3.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match destination-mac 0050-ba27-bed3
# Define a match criterion for traffic class class2 to match the packets with a source MAC address of 0050-ba27-bed2.
<Sysname> system-view
[Sysname] traffic classifier class2
[Sysname-classifier-class2] if-match source-mac 0050-ba27-bed2
# Define a match criterion for traffic class class1 to match the double-tagged packets with 802.1p priority 3 in the inner VLAN tag.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match customer-dot1p 3
# Define a match criterion for traffic class class1 to match advanced ACL 3101.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match acl 3101
# Define a match criterion for traffic class class1 to match the ACL named flow.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match acl name flow
# Define a match criterion for traffic class class1 to match advanced IPv6 ACL 3101.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match acl ipv6 3101
# Define a match criterion for traffic class class1 to match the IPv6 ACL named flow.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match acl ipv6 name flow
# Define a match criterion for traffic class class1 to match all packets.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match any
# Define a match criterion for traffic class class1 to match the packets with a DSCP value of 1, 6, or 9.
<Sysname> system-view
[Sysname] traffic classifier class1 operator or
[Sysname-classifier-class1] if-match dscp 1 6 9
# Define a match criterion for traffic class class1 to match the packets with an IP precedence value of 1 or 6.
<Sysname> system-view
[Sysname] traffic classifier class1 operator or
[Sysname-classifier-class1] if-match ip-precedence 1 6
# Define a match criterion for traffic class class1 to match the packets with a local precedence value of 1 or 6.
<Sysname> system-view
[Sysname] traffic classifier class1 operator or
[Sysname-classifier-class1] if-match local-precedence 1 6
# Define a match criterion for traffic class class1 to match IP packets.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match protocol ip
# Define a match criterion for traffic class class1 to match the RTP packets with even UDP destination port numbers in the range of 16384 to 32767.
<Sysname> system-view
[Sysname] traffic classifier class1 operator or
[Sysname-classifier-class1] if-match rtp start-port 16384 end-port 32767
# Define a match criterion for traffic class class1 to match the packets with a local QoS ID of 3.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match qos-local-id 3
# Define a match criterion for traffic class class1 to match the packets of the application 3link.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match application 3link
# Define a match criterion for traffic class class1 to match ARP protocol packets.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match control-plane protocol arp
# Define a match criterion for traffic class class1 to match packets of the protocols in protocol group normal.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match control-plane protocol-group normal
# Define a match criterion for traffic class class1 to match packets with the length in the range of 100 to 200 bytes.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1] if-match packet-length min 100 max 200
traffic classifier
Use traffic classifier to create a traffic class and enter its view, or enter the view of an existing traffic class.
Use undo traffic classifier to delete a traffic class.
Syntax
traffic classifier classifier-name [ operator { and | or } ]
undo traffic classifier classifier-name
Default
No traffic classes exist.
Views
System view
Predefined user roles
network-admin
Parameters
classifier-name: Specifies a name for the traffic class, a case-sensitive string of 1 to 31 characters.
operator: Sets the operator to logic AND (the default) or OR for the traffic class.
and: Specifies the logic AND operator. The traffic class matches the packets that match all its criteria.
or: Specifies the logic OR operator. The traffic class matches the packets that match any of its criteria.
Examples
# Create a traffic class named class1.
<Sysname> system-view
[Sysname] traffic classifier class1
[Sysname-classifier-class1]
Related commands
display traffic classifier
Traffic behavior commands
car
Use car to configure a CAR action in absolute value in a traffic behavior.
Use undo car to restore the default.
Syntax
car cir committed-information-rate [ cbs committed-burst-size [ ebs excess-burst-size ] ] [ green action | red action | yellow action ] *
car cir committed-information-rate [ cbs committed-burst-size ] pir peak-information-rate [ ebs excess-burst-size ] [ green action | red action | yellow action ] *
undo car
Default
No CAR action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
cir committed-information-rate: Specifies the committed information rate (CIR) in the range of 8 to 10000000 kbps.
cbs committed-burst-size: Specifies the committed burst size (CBS) in the range of 1000 to 1000000000 bytes. The default value is the product of 62.5 and the CIR.
ebs excess-burst-size: Specifies the excess burst size (EBS) in the range of 0 to 1000000000 bytes. If the PIR is not configured, the default EBS is 0. If the PIR is configured, the default EBS is the product of 62.5 and the PIR.
pir peak-information-rate: Specifies the peak information rate (PIR) in the range of 8 to 10000000 kbps.
green action: Specifies the action to take on packets that conform to the CIR. The default setting is pass.
red action: Specifies the action to take on packets that conform to neither CIR nor PIR. The default setting is discard.
yellow action: Specifies the action to take on packets that conform to the PIR but not to the CIR. The default setting is pass.
action: Specifies the action to take on the packet:
· discard: Drops the packet.
· pass: Permits the packet to pass through.
· remark-dot1p-pass new-cos: Sets the 802.1p priority value of the 802.1p packet to new-cos and permits the packet to pass through. The new-cos argument is in the range of 0 to 7.
· remark-dscp-pass new-dscp: Sets the DSCP value of the packet to new-dscp and permits the packet to pass through. The new-dscp argument is in the range of 0 to 63.
· remark-lp-pass new-local-precedence: Sets the local precedence value of the packet to new-local-precedence and permits the packet to pass through. The new-local-precedence argument is in the range of 0 to 7.
· remark-mpls-exp-pass new-exp: Sets the EXP field value of the MPLS packet to new-exp and permits the packet to pass through. The new-exp argument is in the range of 0 to 7.
· remark-prec-pass new-precedence: Sets the IP precedence of the packet to new-precedence and permits the packet to pass through. The new-precedence argument is in the range of 0 to 7.
Usage guidelines
To use two rates for traffic policing, configure the car command with the pir peak-information-rate option. To use one rate for traffic policing, configure the car command without the pir peak-information-rate option.
If you execute the car command multiple times in the same traffic behavior, the most recent configuration takes effect.
Examples
# Configure a CAR action in traffic behavior database:
· Set the CIR to 200 kbps, CBS to 51200 bytes, and EBS to 0.
· Transmit the conforming packets, and mark the excess packets with DSCP value 0 and transmit them.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] car cir 200 cbs 51200 ebs 0 green pass red remark-dscp-pass 0
car percent
Use car percent to configure a CAR action in percentage in a traffic behavior.
Use undo car to restore the default.
Syntax
car cir percent cir-percent [ cbs cbs-time [ ebs ebs-time ] ] [ green action | red action | yellow action ] *
car cir percent cir-percent [ cbs cbs-time ] pir percent pir-percent [ ebs ebs-time ] [ green action | red action | yellow action ] *
undo car
Default
No CAR action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
cir percent cir-percent: Specifies the CIR in percentage, in the range of 1 to 100. The actual CIR value is cir-percent × interface bandwidth.
cbs cbs-time: Specifies the CBS in milliseconds. The actual CBS value is cbs-time × the actual CIR value. The value range for cbs-time is 50 to 2000. The default value is 500.
ebs ebs-time: Specifies the EBS in milliseconds. The actual EBS value is ebs-time × the actual CIR value. The value range for cbs-time is 0 to 2000. The default EBS is 0.
pir percent pir-percent: Specifies the PIR in percentage, in the range of 1 to 100. The PIR value must be greater than or equal to the CIR value.
green action: Specifies the action to take on packets that conform to the CIR. The default is pass.
red action: Specifies the action to take on packets that conform to neither CIR nor PIR. The default is discard.
yellow action: Specifies the action to take on packets that conform to the PIR but not to the CIR. The default is pass.
action: Sets the action to take on the packet:
· discard: Drops the packet.
· pass: Permits the packet to pass through.
· remark-dot1p-pass new-cos: Sets the 802.1p priority value of the packet to new-cos and permits the packet to pass through. The new-cos argument is in the range of 0 to 7.
· remark-dscp-pass new-dscp: Sets the DSCP value of the packet to new-dscp and permits the packet to pass through. The new-dscp argument is in the range of 0 to 63. Alternatively, you can specify the new-dscp argument with af11, af12, af13, af21, af22, af23, af31, af32, af33, af41, af42, af43, cs1, cs2, cs3, cs4, cs5, cs6, cs7, default, or ef.
· remark-lp-pass new-lp: Sets the local precedence value of the packet to new-lp and permits the packet to pass through. The new-lp argument is in the range of 0 to 7.
· remark-mpls-exp-pass new-exp: Sets the EXP field value of the MPLS packet to new-exp and permits the packet to pass through. The new-exp argument is in the range of 0 to 7.
· remark-prec-pass new-precedence: Sets the IP precedence of the packet to new-precedence and permits the packet to pass through. The new-precedence argument is in the range of 0 to 7.
Usage guidelines
To use two rates for traffic policing, configure the car percent command with the pir percent pir-percent option. To use one rate for traffic policing, configure the car percent command without the pir percent pir-percent option.
A QoS policy that uses a traffic behavior configured with percentage-based CAR can be applied in the inbound or outbound direction of an interface.
If you execute the car percent command multiple times in the same traffic behavior, the most recent configuration takes effect.
A QoS policy that uses a behavior configured with percentage-based CAR can be applied only to interfaces.
The actual CIR value is cir-percent × bandwidth. The actual PIR value is pir-percent × bandwidth. In the policy nesting case, the bandwidth used for the CIR and PIR calculations is determined by using the following rules:
· The top policy uses the interface bandwidth.
· A child policy uses the CIR value in GTS configured in the behavior of the child policy.
· If the CIR value is not available in the behavior, the child policy uses the CIR value in GTS configured in the behavior of the higher-level policy.
· If the CIR value is not available in the behavior of the higher-level policy, the child policy uses the interface bandwidth.
Examples
# Configure a CAR action in percentage in traffic behavior database. The CAR parameters are as follows: CIR is 20% and CBS is 100 ms.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] car cir percent 20 cbs 100
display traffic behavior
Use display traffic behavior to display traffic behaviors.
Syntax
display traffic behavior { system-defined | user-defined } [ behavior-name ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
system-defined: Specifies system-defined traffic behaviors.
user-defined: Specifies user-defined traffic behaviors.
behavior-name: Specifies a behavior by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a traffic behavior, this command displays all traffic behaviors.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays traffic behaviors for the active MPU.
Examples
# Display all user-defined traffic behaviors.
<Sysname> display traffic behavior user-defined
User-defined behavior information:
Behavior: 1 (ID 100)
Marking:
Remark dscp 3
Committed Access Rate:
CIR 112 (kbps), CBS 5120 (Bytes), PIR 1000 (Bytes) , EBS 512 (Bytes)
Green action : pass
Yellow action : pass
Red action : discard
# Display all system-defined traffic behaviors.
<Sysname> display traffic behavior system-defined
System-defined behavior information:
Behavior: be (ID 0)
-none-
Behavior: af (ID 1)
Assured Forwarding:
Bandwidth 20 (%)
Discard Method: Tail
Behavior: ef (ID 2)
Expedited Forwarding:
Bandwidth 20 (%) Cbs-ratio 25
Behavior: be-flow-based (ID 3)
Flow based Weighted Fair Queue:
Max number of hashed queues: 256
Discard Method: IP Precedence based WRED
Exponential Weight: 9
Pre Low High Dis-prob
-------------------------
0 10 30 10
1 10 30 10
2 10 30 10
3 10 30 10
4 10 30 10
5 10 30 10
6 10 30 10
7 10 30 10
Field |
Description |
Behavior |
Name and contents of a traffic behavior. |
Marking |
Information about priority marking. |
Remark dscp |
Action of setting the DSCP value for packets. |
Committed Access Rate |
Information about the CAR action. |
Green action |
Action to take on green packets. |
Yellow action |
Action to take on yellow packets. |
Red action |
Action to take on red packets. |
Assured Forwarding |
Assure forwarding (AF) information. |
Bandwidth |
Bandwidth of the queue. |
none |
No other traffic behavior is configured. |
filter
Use filter to configure a traffic filtering action in a traffic behavior.
Use undo filter to restore the default.
Syntax
filter { deny | permit }
undo filter
Default
No traffic filtering action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
deny: Drops packets.
permit: Transmits packets. The permitted packets can be processed by other class-behavior associations in the same QoS policy.
Examples
# Configure a traffic filtering action as deny in traffic behavior database.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] filter deny
gts
Use gts to configure a GTS action in absolute value in a traffic behavior.
Use undo gts to restore the default.
Syntax
gts cir committed-information-rate [ cbs committed-burst-size [ ebs excess-burst-size ] ] [ queue-length queue-length ]
undo gts
Default
No GTS action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
cir committed-information-rate: Sets the CIR in kbps, which specifies the average traffic rate. The value range for committed-information-rate is 8 to 10000000.
cbs committed-burst-size: Sets the CBS in bytes, which specifies the size of bursty traffic when the actual average rate is not greater than the CIR. The value range for committed-burst-size is 1000 to 1000000000. The default value is the product of 62.5 and the CIR.
ebs excess-burst-size: Sets the EBS in bytes. The value range for peak-information-rate is 0 to 1000000000. The default EBS is 0.
queue-length queue-length: Sets the maximum number of packets allowed in the queue. The default is 50. The value range for queue-length is 1 to 1024 packets.
Usage guidelines
To use two rates for traffic shaping, configure the gts command with the pir peak-information-rate option. To use one rate for traffic shaping, configure the gts command without the pir peak-information-rate option.
A QoS policy that uses a behavior configured with GTS can be applied only to the outbound direction of an interface.
A QoS policy that uses a behavior configured with GTS overwrites the qos gts command on the interface, if both are configured.
If you execute the gts command multiple times in the same traffic behavior, the most recent configuration takes effect.
Examples
# Configure a GTS action in absolute value in traffic behavior database. The GTS parameters are as follows: CIR is 200 kbps, CBS is 51200 bytes, EBS is 0, and the maximum queue length is 100.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] gts cir 200 cbs 51200 ebs 0 queue-length 100
gts percent
gts percent
Use gts percent to configure a GTS action in percentage in a traffic behavior.
Use undo gts to restore the default.
Syntax
gts percent cir cir-percent [ cbs cbs-time [ ebs ebs-time ] ] [ queue-length queue-length ]
undo gts
Default
No GTS action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
cir cir-percent: Specifies the CIR in percentage, in the range of 1 to 100. The actual CIR value is cir-percent × interface bandwidth.
cbs cbs-time: Specifies the CBS in milliseconds. The default cbs-time is 500 milliseconds. The actual CBS value is cbs-time × the actual CIR value. The value range for cbs-time is 50 to 2000. The default is 500.
ebs ebs-time: Specifies the EBS in milliseconds. The default ebs-time is 0 milliseconds. The actual EBS value is ebs-time × the actual CIR value. The value range for ebs-time is 0 to 2000. The default EBS is 0.
queue-length queue-length: Specifies the maximum number of packets allowed in the queue. The default is 50. The value range for queue-length is 1 to 1024 packets.
Usage guidelines
A QoS policy that uses a behavior configured with percentage-based GTS can be applied only to the outbound direction of an interface.
A QoS policy that uses a behavior configured with percentage-based GTS overwrites the qos gts command on the interface, if both configured.
If you execute the gts percent command multiple times in the same traffic behavior, the most recent configuration takes effect.
Examples
# Configure a GTS action in percentage in traffic behavior database. The GTS parameters are as follows: CIR is 50 and CBS is 200 ms.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] gts percent cir 50 cbs 200
Related commands
packet-rate
Use packet-rate to configure a protocol packet rate limiting action in a traffic behavior.
Use undo packet-rate to restore the default.
packet-rate value
undo packet-rate
Default
No protocol packet rate limiting action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
value: Specifies the protocol packet rate in the range of 1 to 1048575 pps.
Usage guidelines
Protocol packet rate limiting can protect the CPU against protocol packet attacks.
If you execute this command multiple times in the same traffic behavior, the most recent configuration takes effect.
Examples
# Configure traffic behavior copp to rate limit the protocol packets sent to the CPU to 1600 pps.
<Sysname> system-view
[Sysname] traffic behavior copp
[Sysname-behavior-copp] packet-rate 1600
remark dot1p
Use remark dot1p to configure an 802.1p priority marking action or an inner-to-outer tag priority copying action in a traffic behavior.
Use undo remark dot1p to restore the default.
Syntax
remark dot1p dot1p-value
undo remark dot1p
Default
No 802.1p priority marking action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
dot1p-value: Specifies the 802.1p priority to be marked for packets, in the range of 0 to 7.
Examples
# Configure traffic behavior database to mark matching traffic with 802.1p 2.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] remark dot1p 2
remark dscp
Use remark dscp to configure a DSCP marking action in a traffic behavior.
Use undo remark dscp to delete the action.
Syntax
remark dscp dscp-value
undo remark dscp
Default
No DSCP marking action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
dscp-value: Specifies a DSCP value, which can be a number from 0 to 63 or a keyword in Table 5.
Table 5 DSCP keywords and values
Keyword |
DSCP value (binary) |
DSCP value (decimal) |
af11 |
001010 |
10 |
af12 |
001100 |
12 |
af13 |
001110 |
14 |
af21 |
010010 |
18 |
af22 |
010100 |
20 |
af23 |
010110 |
22 |
af31 |
011010 |
26 |
af32 |
011100 |
28 |
af33 |
011110 |
30 |
af41 |
100010 |
34 |
af42 |
100100 |
36 |
af43 |
100110 |
38 |
cs1 |
001000 |
8 |
cs2 |
010000 |
16 |
cs3 |
011000 |
24 |
cs4 |
100000 |
32 |
cs5 |
101000 |
40 |
cs6 |
110000 |
48 |
cs7 |
111000 |
56 |
default |
000000 |
0 |
ef |
101110 |
46 |
Examples
# Configure traffic behavior database to mark matching traffic with DSCP 6.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] remark dscp 6
remark flow-id
Use remark flow-id to configure a flow ID marking action in a traffic behavior.
Use undo remark flow-id to restore the default.
Syntax
remark flow-id flow-id
undo remark flow-id flow-id
Default
No flow ID marking action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
flow-id: Specifies a flow ID in the range of 1 to 65535.
Usage guidelines
In a RIR network, the RIR server deploys a traffic profile, NQA link detection results, and a QoS policy to the device.
1. The device selects an appropriate link for packets according to the traffic profile and NQA link detection results.
2. The device identifies packets according to the quintuple and DSCP in QoS parameters, and mark a flow ID for identified packets. Then, the device forwards the packets according to the marked flow ID and selected link.
For more information about RIR, see Layer 3—IP Routing Configuration Guide.
Examples
# Configure traffic behavior behavior1 to mark matching traffic with flow ID 10.
<Sysname> system-view
[Sysname] traffic behavior behavior1
[Sysname-behavior-behavior1] remark flow-id 10
remark ip-precedence
Use remark ip-precedence to configure an IP precedence marking action in a traffic behavior.
Use undo remark ip-precedence to delete the action.
Syntax
remark ip-precedence ip-precedence-value
undo remark ip-precedence
Default
No IP precedence marking action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
ip-precedence-value: Specifies the IP precedence value to be marked for packets, in the range of 0 to 7.
Examples
# Set the IP precedence to 6 for packets.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] remark ip-precedence 6
remark local-precedence
Use remark local-precedence to configure a local precedence marking action in a traffic behavior.
Use undo remark local-precedence to delete the action.
Syntax
remark local-precedence local-precedence-value
undo remark local-precedence
Default
No local precedence marking action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
local-precedence-value: Specifies the local precedence to be marked for packets, in the range of 0 to 7.
Examples
# Configure traffic behavior database to mark matching traffic with local precedence 2.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] remark local-precedence 2
remark qos-local-id
Use remark qos-local-id to configure a local QoS ID marking action in a traffic behavior.
Use undo remark qos-local-id to restore the default.
Syntax
remark qos-local-id local-id-value
undo remark qos-local-id
Default
No local QoS ID marking action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
local-id-value: Specifies the local QoS ID to be marked for packets, in the range of 1 to 4095.
Usage guidelines
You can use one QoS policy to mark the local QoS ID for packets in the inbound direction. Then, you can use another QoS policy to apply other QoS features in the outbound direction based on the marked local QoS ID.
If you execute the remark qos-local-id command multiple times in the same traffic behavior, the most recent configuration takes effect.
Examples
# Configure the action of marking packets with local QoS ID 2.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] remark qos-local-id 2
remark service-class
Use remark service-class to configure an action of marking the MPLS TE service class in a traffic behavior.
Use undo remark service-class to restore the default.
Syntax
remark service-class service-class-value
undo remark service-class
Default
No MPLS TE service class marking action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
service-class-value: Specifies the MPLS TE service class in the range of 0 to 127.
Usage guidelines
If the remark service-class command is executed in a QoS policy:
· The QoS policy can be applied only to the inbound direction of an interface.
· Only one MPLS TE service class marking action can be configured for packets with the same MPLS EXP value on an interface. To modify the MPLS TE service class to be marked, you must remove the existing service class setting and configure a new service class value.
If you execute the remark service-class command multiple times in the same traffic behavior, the most recent configuration takes effect.
You can use the mpls te service-class command to set the MPLS TE service class. For more information, see MPLS TE commands in MPLS Command Reference.
Examples
# Configure an action of marking the MPLS TE service class as 2.
<Sysname> system-view
[Sysname] traffic behavior data
[Sysname-behavior-data] remark service-class 2
remark te-class
Use remark te-class to configure an action of marking the TE class ID in a traffic behavior.
Use undo remark te-class to restore the default.
Syntax
remark te-class te-class-id
undo remark te-class
Default
No TE class ID marking action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
te-class-id: Specifies the TE class ID in the range of 1 to 65535.
Usage guidelines
A TE class ID is used to distinguish service packet types locally. Compared with the DSCP or MPLS TE service class, the TE class ID has a larger value range and can identify more service packet types.
Examples
# Configure an action of marking the TE class ID as 1.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-b1] remark service-id 2
remark tunnel-dscp
Use remark tunnel-dscp to configure an outer DSCP marking action in a traffic behavior.
Use undo remark tunnel-dscp to restore the default.
Syntax
remark tunnel-dscp dscp-value
undo remark tunnel-dscp
Default
No outer DSCP marking action is configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
dscp-value: Specifies the DSCP value to be set for the outer IP header of tunneled packets. The DSCP value can be a number from 0 to 63 or a keyword in Table 5.
Usage guidelines
This command takes effect on the following packets:
· GRE packets.
· VXLAN packets.
· IPv4 over IPv4 tunneled packets.
· IPv6 over IPv4 tunneled packets.
· IPv6 tunneled packets.
· MPLS TE tunneled packets.
The outer DSCP value marking action takes effect only when the QoS policy is applied to an interface.
If you execute the remark tunnel-dscp command multiple times in the same traffic behavior, the most recent configuration takes effect.
Examples
# Configure traffic behavior data to mark matching packets with DSCP value 2 in the outer IP header of tunneled packets.
<Sysname> system-view
[Sysname] traffic behavior data
[Sysname-behavior-data] remark tunnel-dscp 2
traffic behavior
Use traffic behavior to create a traffic behavior and enter its view, or enter the view of an existing traffic behavior.
Use undo traffic behavior to delete a traffic behavior.
Syntax
traffic behavior behavior-name
undo traffic behavior behavior-name
Default
No traffic behaviors exist.
Views
System view
Predefined user roles
network-admin
Parameters
behavior-name: Specifies a name for the traffic behavior, a case-sensitive string of 1 to 31 characters.
Usage guidelines
A traffic behavior can contain multiple actions. Typically, all actions in a traffic behavior are taken on the packets matching the associated traffic class. Some actions might be exclusive with each other in the same behavior.
Examples
# Create a traffic behavior named behavior1.
<Sysname> system-view
[Sysname] traffic behavior behavior1
[Sysname-behavior-behavior1]
Related commands
display traffic behavior
traffic-policy
Use traffic-policy to nest a policy in a traffic behavior.
Use undo traffic-policy to remove child policies from a traffic behavior.
Syntax
traffic-policy policy-name
undo traffic-policy
Default
No policy is nested in a traffic behavior.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
policy-name: Specifies a policy by its name, a string of 1 to 31 characters. If the policy does not exist, it is automatically created.
Usage guidelines
After you nest a child policy in a behavior of a parent policy, the system performs the following operations:
· Performs the associated behavior defined in the parent policy for a class of traffic.
· Uses the child policy to further classify the class of traffic and performs the behaviors defined in the child policy.
When you nest QoS policies, follow these guidelines:
· A parent policy can nest up to two layers of child policies. This child policy cannot be the parent policy itself.
· You can nest only one child policy at one layer of a behavior.
· To configure CBQ in the child policy successfully, configure GTS in the parent policy. Make sure the configured GTS bandwidth is greater than CBQ bandwidth configured in the child policy.
· If GTS bandwidth is set in percentage in the parent policy, you must set CBQ bandwidth in percentage in the child policy. If GTS bandwidth is set as an absolute value in the parent policy, you can set CBQ bandwidth in either format in the child policy.
· A child policy cannot contain GTS actions.
· Policy nesting is available for IPv4 and IPv6 packets.
· To delete the child policy after you apply the parent policy to an interface, first remove the child policy from the parent policy.
Examples
# Nest child policy child in traffic behavior database of the parent policy.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] traffic-policy child
Related commands
traffic behavior
traffic classifier
QoS policy commands
classifier behavior
Use classifier behavior to associate a traffic behavior with a traffic class in a QoS policy.
Use undo classifier to delete a class-behavior association from a QoS policy.
Syntax
classifier classifier-name behavior behavior-name [ mode no-match-count | insert-before before-classifier-name ] *
undo classifier classifier-name
Default
No traffic behavior is associated with a traffic class.
Views
QoS policy view
Predefined user roles
network-admin
Parameters
classifier-name: Specifies a traffic class by its name, a case-sensitive string of 1 to 31 characters.
behavior-name: Specifies a traffic behavior by its name, a case-sensitive string of 1 to 31 characters.
mode no-match-count: Specifies that the device does not count matching packets in the QoS policy. If a QoS policy contains many class-behavior associations, you can specify this parameter to save device resources.
insert-before before-classifier-name: Inserts the new traffic class before an existing traffic class in the QoS policy. The before-classifier-name argument specifies an existing traffic class by its name, a case-sensitive string of 1 to 31 characters. If you do not specify the insert-before before-classifier-name option, the new traffic class is placed at the end of the QoS policy.
Usage guidelines
A traffic class can be associated only with one traffic behavior in a QoS policy.
A QoS policy can contain multiple class-behavior associations. The device matches a packet against the class-behavior associations in their configuration order. When a match is found, the device stops the match process and takes the actions in the matching class-behavior association.
If the specified traffic class or traffic behavior does not exist, the system defines a null traffic class or traffic behavior.
The undo classifier default-class command performs the following operations:
· Deletes the existing class-behavior association for the system-defined class default-class.
· Associates the system-defined class default-class with the system-defined behavior be.
Examples
# Associate traffic class database with traffic behavior test in QoS policy user1.
<Sysname> system-view
[Sysname] qos policy user1
[Sysname-qospolicy-user1] classifier database behavior test
# Associate traffic class database with traffic behavior test in QoS policy user1, and insert traffic class database before an existing traffic class named class-a.
<Sysname> system-view
[Sysname] qos policy user1
[Sysname-qospolicy-user1] classifier database behavior test insert-before class-a
Related commands
qos policy
control-plane
Use control-plane to enter control plane view.
Syntax
control-plane slot slot-number
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies a card by its slot number.
Examples
# Enter the control plane view of slot 3.
<Sysname> system-view
[Sysname] control-plane slot 3
[Sysname-cp-slot3]
display qos policy
Use display qos policy to display QoS policies.
Syntax
display qos policy { system-defined | user-defined} [ policy-name [ classifier classifier-name ] ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
system-defined: Specifies system-defined QoS policies.
user-defined: Specifies user-defined QoS policies.
policy-name: Specifies a QoS policy by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a QoS policy, this command displays all user-defined QoS policies.
classifier classifier-name: Specifies a traffic class by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a traffic class, this command displays all traffic classes.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the QoS policies for the active MPU.
Examples
# Display all user-defined generic QoS policies.
<Sysname> display qos policy user-defined
User-defined QoS policy information:
Policy: 1 (ID 100)
Classifier: 1 (ID 100)
Behavior: 1
Marking:
Remark dscp 3
Committed Access Rate:
CIR 112 (kbps), CBS 51200 (Bytes), EBS 512 (Bytes)
Green action : pass
Yellow action : pass
Red action : discard
Classifier: 3 (ID 102)
Behavior: 3
-none-
# Display user-defined TCP ERSPAN-type QoS policies.
<Sysname> display qos policy user-defined tcp-erspan
User-defined QoS policy information:
TCP ERSPAN policy: 1 (ID 100)
Classifier: 1 (ID 100)
Behavior: 1
Mirroring:
Mirror to the interface: GigabitEthernet1/0/1
# Display the system-defined QoS policy (default).
<Sysname> display qos policy system-defined
Policy: default (ID 0)
Classifier: default-class (ID 0)
Behavior: be
-none-
Classifier: ef (ID 1)
Behavior: ef
Expedited Forwarding:
Bandwidth 20 (%) Cbs-ratio 25
Classifier: af1 (ID 2)
Behavior: af
Assured Forwarding:
Bandwidth 20 (%)
Discard Method: Tail
Classifier: af2 (ID 3)
Behavior: af
Assured Forwarding:
Bandwidth 20 (%)
Discard Method: Tail
Classifier: af3 (ID 4)
Behavior: af
Assured Forwarding:
Bandwidth 20 (%)
Discard Method: Tail
Classifier: af4 (ID 5)
Behavior: af
Assured Forwarding:
Bandwidth 20 (%)
Discard Method: Tail
Table 6 Command output
Field |
Description |
User-defined QoS policy information |
Information about a user-defined QoS policy. |
System-defined QoS policy information |
Information about a system-defined QoS policy. |
Policy |
User-defined generic QoS policy name or system-defined QoS policy name. |
For the output description, see Table 1 and Table 4.
display qos policy advpn
Use display qos vlan-policy to display QoS policies applied to hub-spoke tunnels.
Syntax
display qos policy advpn tunnel number [ ipv4-address | ipv6-address ] [ outbound ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
number: Specifies a tunnel interface by its number.
ipv4-address: Specifies the private IPv4 address of the spoke.
ipv6-address: Specifies the private IPv6 address of the spoke.
outbound: Displays QoS policies applied to outgoing traffic. The command execution result is the same if you do not specify this keyword.
Usage guidelines
If you do not specify a private IP address of the spoke, this command displays QoS policies applied to each hub-spoke tunnel on a tunnel interface.
For more information about hub-spoke tunnels, see ADVPN in IP Tunneling and Security VPN Configuration Guide.
Examples
# Display QoS policies applied to each hub-spoke tunnel on tunnel interface 1.
<Sysname> display qos policy advpn tunnel 1 outbound
Session: Tunnel1 192.168.0.3
Direction: Outbound
Policy: finance
Classifier: default-class
Matched : 0 (Packets) 0 (Bytes)
Operator: AND
Rule(s) :
If-match any
Behavior: be
-none-
Classifier: finance
Matched : 123713988 (Packets) 13608538380 (Bytes)
Operator: AND
Rule(s) :
If-match any
Behavior: finance
Committed Access Rate:
CIR 1500 (kbps), CBS 93750 (Bytes), EBS 0 (Bytes)
Green action : pass
Yellow action : pass
Red action : discard
Green packets : 14980239 (Packets) 1647826290 (Bytes)
Yellow packets: 0 (Packets) 0 (Bytes)
Red packets : 108733781 (Packets) 11960715910 (Bytes)
Session: Tunnel1 192.168.0.4 (inactive)
Direction: Outbound
Policy: business
Table 7 Command output
Field |
Description |
Session |
A tunnel interface and a private IP address of the spoke can uniquely identify a hub-spoke tunnel. The inactive word (if present) indicates that a QoS policy fails to be applied to the hub-spoke tunnel or the applied QoS policy does not exist. |
For the description of other fields, see Table 1 and Table 4.
display qos policy control-plane
Use display qos policy control-plane to display QoS policies applied to a control plane.
Syntax
display qos policy control-plane slot slot-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies a card by its slot number.
Examples
# Display the QoS policy applied to the control plane of slot 1.
<Sysname> display qos policy control-plane slot 0
Control plane slot 0
Direction: Inbound
Policy: 1
Classifier: 1
Operator: AND
Rule(s) :
If-match acl 2000
Behavior: 1
Marking:
Remark dscp 3
Committed Access Rate:
CIR 112 (kbps), CBS 51200 (Bytes), EBS 512 (Bytes)
Green action : pass
Yellow action : pass
Red action : discard
Green packets : 0 (Packets) 0 (Bytes)
Yellow packets: 0 (Packets) 0 (Bytes)
Red packets : 0 (Packets) 0 (Bytes)
Classifier: 2
Operator: AND
Rule(s) :
If-match protocol ipv6
Behavior: 2
Accounting enable:
0 (Packets)
Filter enable: Permit
Marking:
Remark dscp 3
Classifier: 3
Operator: AND
Rule(s) :
-none-
Behavior: 3
-none-
Table 8 Command output
Field |
Description |
Direction |
Direction in which the QoS policy is applied. |
For the description of other fields, see Table 1 and Table 4.
display qos policy control-plane pre-defined
Use display qos policy control-plane pre-defined to display predefined control plane QoS policies.
Syntax
display qos policy control-plane pre-defined [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the predefined control plane QoS policies for all cards.
Examples
# Display the predefined control plane QoS policy of slot 1.
<Sysname> display qos policy control-plane pre-defined slot 1
Pre-defined policy information slot 1
Protocol Priority Bandwidth Group
Default N/A 1000 (pps) N/A
ARP N/A 100000 (kbps) normal
BGP N/A 100000 (kbps) critical
BGPv6 N/A 100000 (kbps) critical
HTTP N/A 100000 (kbps) management
HTTPS N/A 100000 (kbps) management
ICMP N/A 100000 (kbps) monitor
ICMPv6 N/A 100000 (kbps) monitor
IGMP N/A 100000 (kbps) important
IS-IS N/A 100000 (kbps) critical
LDP N/A 100000 (kbps) critical
LDPv6 N/A 100000 (kbps) critical
MSDP N/A 100000 (kbps) critical
NTP N/A 100000 (kbps) important
OSPF Multicast N/A 100000 (kbps) critical
OSPF Unicast N/A 100000 (kbps) critical
OSPFv3 Multicast N/A 100000 (kbps) critical
OSPFv3 Unicast N/A 100000 (kbps) critical
PIM Multicast N/A 100000 (kbps) critical
PIM Unicast N/A 100000 (kbps) critical
PIMv6 Multicast N/A 100000 (kbps) critical
PIMv6 Unicast N/A 100000 (kbps) critical
RADIUS N/A 100000 (kbps) management
RIP N/A 100000 (kbps) critical
RIPng N/A 100000 (kbps) critical
RSVP N/A 100000 (kbps) critical
SNMP N/A 100000 (kbps) management
TACACS N/A 100000 (kbps) management
VRRP N/A 100000 (kbps) important
VRRPv6 N/A 100000 (kbps) important
SSH N/A 100000 (kbps) management
TELNET N/A 100000 (kbps) management
FTP N/A 100000 (kbps) management
TFTP N/A 100000 (kbps) management
Table 9 Command output
Field |
Description |
Pre-defined control plane policy |
Contents of the predefined control plane QoS policy. |
Default |
Protocols other than those listed. |
Group |
Protocol group of the protocol. |
For descriptions of other fields, see Table 3.
display qos policy global
Use display qos policy global to display QoS policies applied globally.
Syntax
display qos policy global [ slot slot-number ] [ inbound | outbound ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
inbound: Specifies the QoS policy applied in the inbound direction.
outbound: Specifies the QoS policy applied in the outbound direction.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays global QoS policies for the active MPU.
Usage guidelines
If you do not specify a direction, this command displays both inbound and outbound global QoS policies.
Examples
# Display generic QoS policies applied globally.
<Sysname> display qos policy global
Direction: Inbound
Policy: 1
Classifier: 1
Operator: AND
Rule(s) :
If-match acl 2000
Behavior: 1
Marking:
Remark dscp 3
Committed Access Rate:
CIR 112 (kbps), CBS 51200 (Bytes), EBS 512 (Bytes)
Green action : pass
Yellow action : pass
Red action : discard
Green packets : 0 (Packets) 0 (Bytes)
Yellow packets: 0 (Packets) 0 (Bytes)
Red packets : 0 (Packets) 0 (Bytes)
Classifier: 3
Operator: AND
Rule(s) :
-none-
Behavior: 3
-none-
# Display information about IPv6-matching QoS policies applied globally.
<Sysname> display qos ipv6-matching policy global
Direction: Inbound
IPv6 Matching policy: 1
Classifier: 1
Operator: AND
Rule(s) :
If-match acl ipv6 3000
Behavior: 1
Marking:
Remark dscp 3
# Display information about TCP ERSPAN-matching QoS policies applied globally.
<Sysname> display qos tcp-erspan policy global
Direction: Inbound
TCP ERSPAN policy: 1
Classifier: 1
Operator: AND
Rule(s) :
If-match acl 3000
Behavior: 1
Mirroring:
Mirror to the interface: GigabitEthernet1/0/1
Table 10 Command output
Field |
Description |
Direction |
Direction in which the QoS policy is applied. |
Green packets |
Statistics about green packets. |
Yellow packets |
Statistics about yellow packets. |
Red packets |
Statistics about red packets. |
For the description of other fields, see Table 1 and Table 4.
display qos policy interface
Use display qos policy interface to display the QoS policies applied to interfaces.
Syntax
display qos policy interface [ interface-type interface-number ] [ slot slot-number [ cpu cpu-number ] ] [ inbound | outbound ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays QoS policies on the active MPU. Only logical interfaces support this option.
inbound: Specifies the QoS policy applied to incoming traffic.
outbound: Specifies the QoS policy applied to outgoing traffic.
Usage guidelines
If you do not specify a direction, this command displays the QoS policy applied to incoming traffic and the QoS policy applied to outgoing traffic.
Examples
# Display the generic QoS policy applied to the incoming traffic of GigabitEthernet 1/0/1.
<Sysname> display qos policy interface gigabitethernet 1/0/1 inbound
Interface: GigabitEthernet1/0/1
Direction: Inbound
Policy: 1
Classifier: 1
Operator: AND
Rule(s) :
If-match acl 2000
Behavior: 1
Marking:
Remark dscp 3
Committed Access Rate:
CIR 112 (kbps), CBS 51200 (Bytes), EBS 512 (Bytes)
Green action : pass
Yellow action : pass
Red action : discard
Green packets : 0 (Packets) 0 (Bytes)
Yellow packets: 0 (Packets) 0 (Bytes)
Red packets : 0 (Packets) 0 (Bytes)
Classifier: 3
Matched : 0 (Packets) 0 (Bytes)
5-minute statistics:
Forwarded: 0/0 (pps/bps)
Dropped : 0/0 (pps/bps)
Operator: AND
Rule(s) :
-none-
Behavior: 3
-none-
# Display the QoS policies applied to all interfaces.
<Sysname> display qos policy interface
Interface: GigabitEthernet1/0/1
Direction: Inbound
Policy: a
Classifier: a
Operator: AND
Rule(s) :
If-match any
Behavior: a
Committed Access Rate:
CIR 112 (kbps), CBS 51200 (Bytes), EBS 0 (Bytes)
Green action : pass
Yellow action : pass
Red action : discard
Green packets : 0 (Packets)
Red packets : 0 (Packets)
Interface: GigabitEthernet1/0/3
Direction: Inbound
Policy: b
Classifier: b
Operator: AND
Rule(s) :
If-match any
Behavior: b
Committed Access Rate:
CIR 112 (kbps), CBS 51200 (Bytes), EBS 0 (Bytes)
Green action : pass
Yellow action : pass
Red action : discard
Green packets : 0(Packets)
Red packets : 0 (Packets)
Table 11 Command output
Field |
Description |
Direction |
Direction in which the QoS policy is applied. |
Policy |
User-defined generic QoS policy name or system-defined QoS policy name. |
Matched |
Number of matching packets. |
Forwarded |
Average rate of successfully forwarded matching packets in a statistics collection period. |
Dropped |
Average rate of dropped matching packets in a statistics collection period. |
Green packets |
Traffic statistics for green packets. |
Yellow packets |
Traffic statistics for yellow packets. |
Red packets |
Traffic statistics for red packets. |
For the description of other fields, see Table 1 and Table 4.
display qos policy user-profile
Use display qos policy user-profile to display QoS policies applied to user profiles.
Syntax
display qos policy user-profile [ name profile-name ] [ user-id user-id ] [ slot slot-number ] [ inbound | outbound ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
name profile-name: Specifies a user profile by its name, a case-sensitive string of 1 to 31 characters. Valid characters include English letters, digits, and underscores (_). The name must start with an English letter and must be unique. If you do not specify a user profile, this command displays QoS policies applied to all user profiles.
user-id user-id: Specifies an online user by a system-assigned, hexadecimal ID in the range of 0 to fffffffe. If you do not specify an online user, this command displays QoS policies applied to user profiles for all online users.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays QoS policies applied to user profiles for all cards.
inbound: Specifies QoS policies applied to incoming traffic.
outbound: Specifies QoS policies applied to outgoing traffic.
Usage guidelines
If you do not specify a direction, this command displays QoS policies applied in the inbound direction and QoS policies applied in the outbound direction.
Examples
# Display the QoS policy applied to user profile abc for a global user.
<Sysname> display qos policy user-profile name abc user-id 30000000 inbound
User-Profile: abc
User ID: 0x30000000(global)
Direction: Inbound
Policy: p1
Classifier: default-class
Matched : 0 (Packets) 0 (Bytes)
Operator: AND
Rule(s) :
If-match any
Behavior: be
-none-
# Display the QoS policy applied to user profile abc for a local user.
<Sysname> display qos policy user-profile name abc user-id 30000001 inbound
User-Profile: abc
slot 2:
User ID: 0x30000001(local)
Direction: Inbound
Policy: p1
Classifier: default-class
Matched : 0 (Packets) 0 (Bytes)
Operator: AND
Rule(s) :
If-match any
Behavior: be
-none-
Table 12 Command output
Field |
Description |
global |
Indicates a global user, who comes online from a global interface such as an aggregate interface. |
local |
Indicates a local user, who comes online from a physical interface. |
Matched |
Number of packets that meet match criteria. |
Direction |
Direction in which the QoS policy is applied. |
Green packets |
Statistics about green packets. |
Yellow packets |
Statistics about yellow packets. |
Red packets |
Statistics about red packets. |
For the description of other fields, see Table 1 and Table 4.
qos apply policy (interface view, control plane view)
Use qos apply policy to apply a QoS policy to an interface or control plane.
Use undo qos apply policy to remove an applied QoS policy.
Syntax
qos apply policy policy-name { inbound | outbound }
undo qos apply policy policy-name { inbound | outbound }
Default
No QoS policy is applied.
Views
Control plane view
Interface view
Predefined user roles
network-admin
Parameters
policy-name: Specifies a QoS policy by its name, a case-sensitive string of 1 to 31 characters.
inbound: Applies the QoS policy to incoming traffic.
outbound: Applies the QoS policy to outgoing traffic. This keyword is not supported in control plane view.
Usage guidelines
The display qos policy interface command output for an interface also contains packet statistics for all interfaces that share the QoS and ACL resource with the interface.
Examples
# Apply QoS policy USER1 to the outgoing traffic of GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos apply policy USER1 outbound
# Apply generic QoS policy USER5 to the incoming traffic of the control plane of slot 0.
<Sysname> system-view
[Sysname] control-plane slot 0
[Sysname-cp-slot0] qos apply policy USER5 inbound
qos apply policy (user profile view)
Use qos apply policy to apply a QoS policy to a user profile.
Use undo qos apply policy to remove a QoS policy applied to a user profile.
Syntax
qos apply policy policy-name { inbound | outbound }
undo qos apply policy policy-name { inbound | outbound }
Default
No QoS policy is applied to a user profile.
Views
User profile view
Predefined user roles
network-admin
Parameters
policy-name: Specifies a QoS policy by its name, a case-sensitive string of 1 to 31 characters.
inbound: Applies the QoS policy to the incoming traffic of the device (traffic sent by online users).
outbound: Applies the QoS policy to the outgoing traffic of the device (traffic received by online users).
Usage guidelines
Deleting a user profile also removes the QoS policies applied to the user profile.
Examples
# Apply QoS policy test to incoming traffic of user profile user.
<Sysname> system-view
[Sysname] user-profile user
[Sysname-user-profile-user] qos apply policy test outbound
qos apply policy global
Use qos apply policy global to apply a QoS policy globally.
Use undo qos apply policy global to remove a globally applied QoS policy.
Syntax
qos apply policy policy-name global { inbound | outbound }
undo qos apply policy policy-name global { inbound | outbound }
Default
No QoS policy is applied globally.
Views
System view
Predefined user roles
network-admin
Parameters
policy-name: Specifies a QoS policy by its name, a case-sensitive string of 1 to 31 characters.
inbound: Applies the QoS policy to the incoming packets on all interfaces.
outbound: Applies the QoS policy to the outgoing packets on all interfaces.
# Globally apply generic QoS policy user1 to the incoming traffic.
<Sysname> system-view
[Sysname] qos apply policy user1 global inbound
qos policy
Use qos policy to create a QoS policy and enter its view, or enter the view of an existing QoS policy.
Use undo qos policy to delete a QoS policy.
Syntax
qos policy policy-name
undo qos policy policy-name
Default
No QoS policies exist.
Views
System view
Predefined user roles
network-admin
Parameters
policy-name: Specifies a name for the QoS policy, a case-sensitive string of 1 to 31 characters.
To delete a QoS policy that has been applied to an object, you must first remove the QoS policy from the object.
Examples
# Create a generic QoS policy named user1.
<Sysname> system-view
[Sysname] qos policy user1
[Sysname-qospolicy-user1]
Related commands
classifier behavior
qos apply policy
qos apply policy global
reset qos policy advpn
Use reset qos vlan-policy to clear the statistics of the QoS policies applied to hub-spoke tunnels.
Syntax
reset qos policy advpn tunnel number [ ipv4-address | ipv6-address ] [ outbound ]
Views
User view
Predefined user roles
network-admin
Parameters
number: Specifies a tunnel interface by its number.
ipv4-address: Specifies the private IPv4 address of the spoke.
ipv6-address: Specifies the private IPv6 address of the spoke.
outbound: Clears the statistics of QoS policies applied to outgoing traffic. The command execution result is the same if you do not specify this keyword.
Usage guidelines
If you do not specify a private IP address of the spoke, this command clears the statistics of QoS policies applied to each hub-spoke tunnel on a tunnel interface.
For more information about hub-spoke tunnels, see ADVPN in IP Tunneling and Security VPN Configuration Guide.
Examples
# Clear the statistics of the QoS policy applied to a hub-spoke tunnel on tunnel interface 1.
<Sysname> reset qos policy advpn tunnel 1 192.168.0.3 outbound
reset qos policy control-plane
Use reset qos policy control-plane to clear the statistics of the QoS policy applied to a control plane.
Syntax
reset qos policy control-plane slot slot-number
Views
User view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies a card by its slot number.
Examples
# Clear the statistics of the QoS policy applied to the control plane of slot 1.
<Sysname> reset qos policy control-plane slot 1
reset qos policy global
Use reset qos policy global to clear the statistics of a global QoS policy.
Syntax
reset qos policy global [ inbound | outbound ]
Views
User view
Predefined user roles
network-admin
Parameters
inbound: Clears the statistics of the global QoS policy applied to incoming traffic globally.
outbound: Clears the statistics of the global QoS policy applied to outgoing traffic globally.
Usage guidelines
If you do not specify a direction, this command clears the statistics of the global QoS policies in both directions.
Examples
# Clear the statistics of the generic QoS policy applied to the incoming traffic globally.
<Sysname> reset qos policy global inbound
QoS policy-based traffic rate statistics collection period commands
qos flow-interval
Use qos flow-interval to set the QoS policy-based traffic rate statistics collection period for an interface.
Use undo qos flow-interval to restore the default.
Syntax
qos flow-interval interval
undo qos flow-interval
Default
The QoS policy-based traffic rate statistics collection period is 5 minutes on an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
interval: Specifies the QoS policy-based traffic rate statistics collection period in minutes. The value range for this argument is 1 to 10.
Usage guidelines
You can enable collection of per-class traffic statistics over a period of time, including the average forwarding rate and drop rate. For example, if you set the statistics collection period to 10 minutes, the system performs the following operations:
· Collects traffic statistics for the most recent 10 minutes.
· Refreshes the statistics every 10/5 minutes, 2 minutes.
The traffic rate statistics collection period of a subinterface is the same as the period configured on the main interface.
Examples
# Set the QoS policy-based traffic rate statistics collection period to 10 minutes on GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos flow-interval 10
Related commands
display qos policy interface
Interface channelization commands
display mode channel-bandwidth interface
Use display mode channel-bandwidth interface to display interface channelization configuration and operation information.
Syntax
display mode channel-bandwidth interface [ interface-type { interface-number | interface-number.subnumber } ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface type. If you do not specify an interface, this command displays the interface channelization configuration for all subinterfaces.
interface-number: Specifies an interface number.
interface-number.subnumber: Specifies a subinterface number. The value range for the subnumber argument is 1 to 4094.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the interface channelization configuration for all cards.
Examples
# Display the interface channelization configuration for GigabitEthernet 1/0/1.1.
<Sysname> display mode channel-bandwidth interface gigabitethernet 1/0/1.1
Subinterface : GE1/0/1.1 Channelized bandwidth : 100 kbps
Passed : 1000 (Packets) 1000 (Bytes)
Delayed : 1000 (Packets) 1000 (Bytes)
# Display the interface channelization configuration for all interfaces.
<Sysname> display mode channel-bandwidth interface
Interface : GE1/0/1 Total bandwidth : 1000000 kbps
Total channelized bandwidth : 600 kbps
Subinterface : GE1/0/1.1 Channelized bandwidth : 100 kbps
Passed : 1000 (Packets) 1000 (Bytes)
Delayed : 1000 (Packets) 1000 (Bytes)
Subinterface : GE1/0/1.2 Channelized bandwidth : 200 kbps
Passed : 1000 (Packets) 1000 (Bytes)
Delayed : 1000 (Packets) 1000 (Bytes)
Subinterface : GE1/0/1.3 Channelized bandwidth : 300 kbps
Passed : 1000 (Packets) 1000 (Bytes)
Delayed : 1000 (Packets) 1000 (Bytes)
Interface : GE1/0/2 Total bandwidth : 1000000 kbps
Total channelized bandwidth : 600 kbps
Subinterface : GE1/0/2.1 Channelized bandwidth : 100 kbps
Passed : 1000 (Packets) 1000 (Bytes)
Delayed : 1000 (Packets) 1000 (Bytes)
Subinterface : GE1/0/2.2 Channelized bandwidth : 200 kbps
Passed : 1000 (Packets) 1000 (Bytes)
Delayed : 1000 (Packets) 1000 (Bytes)
Subinterface : GE1/0/2.3 Channelized bandwidth : 300 kbps
Passed : 1000 (Packets) 1000 (Bytes)
Delayed : 1000 (Packets) 1000 (Bytes)
…
Table 13 Command output
Field |
Description |
Channelized bandwidth |
Channelized bandwidth of the subinterface. |
Slot |
Number of the slot where the aggregate interface resides. |
Interface |
Main interface. |
Total bandwidth |
Total bandwidth of the main interface p. |
Total channelized bandwidth |
Total channelized bandwidth of all subinterfaces configured. |
Passed |
Number of forwarded packets and bytes. |
Delayed |
Number of delayed packets and bytes. |
Related commands
mode channel-bandwidth
mode channel-bandwidth
Use mode channel-bandwidth to set the channelized bandwidth for a subinterface.
Use undo mode channel-bandwidth to restore the default.
Syntax
mode channel-bandwidth bandwidth-value
undo mode channel-bandwidth
Default
The channelized bandwidth is not set for a subinterface.
Views
Subinterface view
Predefined user roles
network-admin
Parameters
bandwidth-value: Specifies the channelized bandwidth in kbps. The value range for this argument is 30 to 9500000.
Usage guidelines
Operating mechanism
By default, all subinterfaces of a main interface share and contend for the bandwidth of the main interface. Subinterfaces that carry key services cannot be guaranteed enough bandwidth. This feature allows subinterfaces of a physical interface or aggregate interface to exclusively use the specified amount of bandwidth.
Restrictions and guidelines
Before configuring the channelized bandwidth for a Layer 3 aggregate subinterface, you must execute the bandwidth command on the aggregate interface.
If you set both the channelized bandwidth and rate limit (configured by using the lr command) for a subinterface, the smaller value is used for rate limiting on that subinterface. If you also configure a network slice channel and specify the channel bandwidth:
· The remaining bandwidth of the subinterface is the channelized bandwidth minus the channel bandwidth. The remaining bandwidth is used to rate limit the traffic other than network slice packets. If the calculated remaining bandwidth is smaller than 1 Mbps, 1 Mbps is used as the rate limit value.
· The remaining bandwidth of the main interface is the total interface bandwidth minus the total channelized bandwidth of all subinterfaces and the total channel bandwidth. If the calculated remaining bandwidth is smaller than 1 Mbps, 1 Mbps is used as the remaining bandwidth.
The total channelized bandwidth of subinterfaces cannot exceed the actual bandwidth of the main interface plus 1 Mbps. The channelized bandwidth takes effect only in the outbound direction.
Examples
# Set the channelized bandwidth to 100 kbps for GigabitEthernet1/0/1.1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1.1
[Sysname-GigabitEthernet1/0/1.1] mode channel-bandwidth 100
Related commands
bandwidth (Layer 2—LAN Switching Command Reference)
display mode channel-bandwidth interface
mpls te max-reservable-bandwidth (MPLS Command Reference)
Traffic policing, GTS, and rate limit commands
Traffic policing commands
display qos car interface
Use display qos car interface to display the CAR information for interfaces.
Syntax
display qos car interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the CAR information for all interfaces.
Examples
# Display the CAR information for GigabitEthernet 1/0/1.
<Sysname> display qos car interface gigabitethernet 1/0/1
Interface: GigabitEthernet1/0/1
Direction: inbound
Rule: If-match any
CIR 128 (kbps), CBS 5120 (Bytes), PIR 128 (kbps), EBS 512 (Bytes)
Green action : pass
Yellow action : pass
Red action : discard
Green packets : 0 (Packets), 0 (Bytes)
Yellow packets: 0 (Packets), 0 (Bytes)
Red packets : 0 (Packets), 0 (Bytes)
Direction: outbound
Rule: If-match acl 2000
CIR 1000 (kbps), CBS 62500 (Bytes), EBS 0 (Bytes)
Green action : pass
Yellow action : pass
Red action : discard
Green packets : 0 (Packets), 0 (Bytes)
Yellow packets: 0 (Packets), 0 (Bytes)
Red packets : 0 (Packets), 0 (Bytes)
# Display the CAR information on GigabitEthernet 1/0/2.
<Sysname> display qos car interface gigabitethernet 1/0/2
Interface: GigabitEthernet1/0/2
Direction: inbound
Rule: If-match any
CIR 50 (%), CBS 600 (ms), EBS 0 (ms), PIR 50 (%)
Green action : pass
Yellow action : pass
Red action : discard
Green packets : 0 (Packets), 0 (Bytes)
Yellow packets: 0 (Packets), 0 (Bytes)
Red packets : 0 (Packets), 0 (Bytes)
Table 14 Command output
Field |
Description |
Interface |
Interface name, including interface type and interface number. |
Direction |
Direction in which traffic policing is applied. |
Rule |
Match criteria. |
CIR |
CIR in kbps (if the CIR is specified in absolute value) or in percentage (if the CIR is specified in percentage). |
CBS |
CBS in bytes (if the CBS is specified in absolute value) or in ms (if the CBS is specified in milliseconds). When the CBS is specified in milliseconds, the actual CBS value is cbs-time × the actual CIR value. |
EBS |
EBS in bytes (if the EBS is specified in absolute value) or in ms (if the EBS is specified in milliseconds). When the EBS is specified in milliseconds, the actual EBS value is ebs-time × the actual CIR value. |
PIR |
PIR in kbps (if the PIR is specified in absolute value) or in percentage (if the PIR is specified in percentage). |
Green action |
Action to take on green packets. |
Yellow action |
Action to take on yellow packets. |
Red action |
Action to take on red packets. |
display qos carl
Use display qos carl to display CAR lists.
Syntax
display qos carl [ carl-index ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
carl-index: Specifies a CAR list by its number in the range of 1 to 199. If you do not specify a CAR list, this command displays all CAR lists.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the CAR lists for the active MPU.
Examples
# Display all CAR lists.
<Sysname> display qos carl
List Rules
1 destination-ip-address range 1.1.1.1 to 1.1.1.2 per-address shared-bandwidth
2 destination-ip-address subnet 1.1.1.1 22 per-address shared-bandwidth
4 dscp 1 2 3 4 5 6 7 cs1
5 mac 0000-0000-0000
6 mpls-exp 0 1 2
9 precedence 0 1 2 3 4 5 6 7
10 source-ip-address range 1.1.1.1 to 1.1.1.2
11 source-ip-address subnet 1.1.1.1 31
display qos tunnel-session
Use display qos tunnel-session to display the QoS configuration and statistics for tunnels on a tunnel interface.
Syntax
display qos tunnel-session interface tunnel number [ identity identity ] [ inbound | outbound ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
tunnel number: Specifies a tunnel interface by its number.
identity identity: Specifies an IPsec P2MP tunnel by its identity. If you do not specify a tunnel, this command displays the QoS configuration and statistics for all tunnels on a tunnel interface. For more information about IPsec P2MP tunnel interfaces, see IPsec configuration in Security Configuration Guide.
inbound: Specifies the inbound direction.
outbound: Specifies the outbound direction.
Usage guidelines
If you do not specify a direction, this command displays the QoS configuration and statistics for both the inbound and outbound directions.
Examples
# Display the QoS configuration and statistics for IPsec P2MP tunnel 1 on tunnel interface 0.
<Sysname> display qos tunnel-session interface tunnel 0 identity 1
Tunnel-session identity: Identity_1
Direction: Inbound
User Profile: a1
Committed Access Rate:
Rule: If-match any
CIR 3333 (kbps), CBS 208312 (Bytes), EBS 0 (Bytes)
Green packets : 0 (Packets) 0 (Bytes)
Yellow packets: 0 (Packets) 0 (Bytes)
Red packets : 0 (Packets) 0 (Bytes)
Rule: If-match acl 2000
CIR 1000 (kbps), CBS 62500 (Bytes), EBS 0 (Bytes)
Green packets : 0 (Packets) 0 (Bytes)
Yellow packets: 0 (Packets) 0 (Bytes)
Red packets : 0 (Packets) 0 (Bytes)
Direction: Outbound
User Profile: a1
Committed Access Rate:
Rule: If-match any
CIR 4444 (kbps), CBS 277750 (Bytes), EBS 0 (Bytes)
Green packets : 0 (Packets) 0 (Bytes)
Yellow packets: 0 (Packets) 0 (Bytes)
Red packets : 0 (Packets) 0 (Bytes)
Rule: If-match acl 3000
CIR 1000 (kbps), CBS 62500 (Bytes), EBS 0 (Bytes)
Green packets : 0 (Packets) 0 (Bytes)
Yellow packets: 0 (Packets) 0 (Bytes)
Red packets : 0 (Packets) 0 (Bytes)
Tunnel-session identity: Identity_2
Direction: Inbound
User Profile: a1
Committed Access Rate:
Rule: If-match any
CIR 3333 (kbps), CBS 208312 (Bytes), EBS 0 (Bytes)
Green packets : 0 (Packets) 0 (Bytes)
Yellow packets: 0 (Packets) 0 (Bytes)
Red packets : 0 (Packets) 0 (Bytes)
Direction: Outbound
User Profile: b1
Table 15 Command output
Field |
Description |
Tunnel-session identity |
Tunnel identity. |
Direction |
Direction to which the QoS policy is applied. |
User Profile |
User profile name. |
Rule |
Packet matching rule: · If-match any—Matches all packets. · If-match acl 2000—Matches packets that permitted by the ACL. |
Line rate |
Traffic rate limiting information based on user profile. |
Passed |
Number and bytes of packets that have been forwarded. |
Discarded |
Number and bytes of dropped packets. |
Delayed |
Number and bytes of delayed packets. |
Active shaping |
Indicates whether the rate limit configuration is activated: · Yes—Activated. · No—Not activated. |
Output queue |
Information about the output queue. |
Urgent queuing |
Urgent queue information. |
Protocol queuing |
Protocol queue information. |
Priority queuing |
Priority queue information. |
Size |
Total number of bytes of packets in the queues. |
Length |
Number of packets allowed in each queue. |
Discards |
Number of dropped packets. |
Top |
Top priority queue. |
Middle |
Middle priority queue. |
Normal |
Normal priority queue. |
Bottom |
Bottom priority queue. |
Related commands
reset qos tunnel-session
qos car (interface view)
Use qos car to configure a CAR policy on an interface.
Use undo qos car to delete a CAR policy from an interface.
Syntax
qos car { inbound | outbound } { any | acl [ ipv6 ] acl-number | carl carl-index } cir committed-information-rate [ cbs committed-burst-size [ ebs excess-burst-size ] ] [ green action | red action | yellow action ] *
qos car { inbound | outbound } { any | acl [ ipv6 ] acl-number | carl carl-index } cir committed-information-rate [ cbs committed-burst-size ] pir peak-information-rate [ ebs excess-burst-size ] [ green action | red action | yellow action ] *
undo qos car { inbound | outbound } { any | acl [ ipv6 ] acl-number | carl carl-index }
Default
No CAR policy is configured on an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
inbound: Performs CAR for incoming packets on the interface.
outbound: Performs CAR for outgoing packets on the interface.
any: Performs CAR for all IP packets in the specified direction.
acl [ ipv6 ] acl-number: Performs CAR for packets matching an ACL specified by its number. The value range for the acl-number argument is 2000 to 3999. If you do not specify ipv6, this option specifies an IPv4 ACL. If you specify ipv6, this option specifies an IPv6 ACL.
carl carl-index: Performs CAR for packets matching a CAR list specified by its number in the range of 1 to 199.
cir committed-information-rate: Specifies the CIR in kbps. The value range for committed-information-rate is 8 to 10000000.
cbs committed-burst-size: Specifies the CBS in bytes, which is the size of bursty traffic when the actual average rate is not greater than the CIR. The value range for committed-burst-size is 1000 to 1000000000. The default value is the product of 62.5 and the CIR.
ebs excess-burst-size: Specifies the EBS in bytes. The value range for excess-burst-size is 0 to 1000000000. The default EBS is 0.
pir peak-information-rate: Specifies the PIR in kbps. The value range for peak-information-rate is 8 to 10000000.
green: Specifies the action to take on packets when the traffic rate conforms to the CIR. The default is pass.
red: Specifies the action to take on packets when the traffic rate conforms to neither CIR nor PIR. The default is discard.
yellow: Specifies the action to take on packets when the traffic rate exceeds the CIR but conforms to the PIR. The default is pass.
action: Specifies the action to take on packets:
· continue: Continues to process the packet by using the next CAR policy.
· discard: Drops the packet.
· pass: Permits the packet to pass through.
· remark-dot1p-continue new-cos: Sets the 802.1p priority value of the 802.1p packet to new-cos and continues to process the packet by using the next CAR policy. The new-cos argument is in the range of 0 to 7.
· remark-dot1p-pass new-cos: Sets the 802.1p priority value of the 802.1p packet to new-cos and permits the packet to pass through. The new-cos argument is in the range of 0 to 7.
· remark-dscp-continue new-dscp: Remarks the packet with a new DSCP value and continues to process the packet by using the next CAR policy. The new-dscp argument is in the range of 0 to 63. Alternatively, you can specify the new-dscp argument with af11, af12, af13, af21, af22, af23, af31, af32, af33, af41, af42, af43, cs1, cs2, cs3, cs4, cs5, cs6, cs7, default, or ef.
· remark-dscp-pass new-dscp: Remarks the packet with a new DSCP value and permits the packet to pass through. The new-dscp argument is in the range of 0 to 63. Alternatively, you can specify the new-dscp argument with af11, af12, af13, af21, af22, af23, af31, af32, af33, af41, af42, af43, cs1, cs2, cs3, cs4, cs5, cs6, cs7, default, or ef.
· remark-mpls-exp-continue new-exp: Sets the EXP field value of the MPLS packet to new-exp and continues to process the packet by using the next CAR policy. The new-exp argument is in the range of 0 to 7.
· remark-mpls-exp-pass new-exp: Sets the EXP field value of the MPLS packet to new-exp and permits the packet to pass through. The new-exp argument is in the range of 0 to 7.
· remark-prec-continue new-precedence: Remarks the packet with a new IP precedence and continues to process the packet by using the next CAR policy. The new-precedence argument is in the range of 0 to 7.
· remark-prec-pass new-precedence: Remarks the packet with a new IP precedence and permits the packet to pass through. The new-precedence argument is in the range of 0 to 7.
Usage guidelines
To use two rates for traffic policing, configure the qos car command with the pir peak-information-rate option. To use one rate for traffic policing, configure the qos car command without the pir peak-information-rate option.
You can configure multiple qos car commands on an interface to define multiple CAR policies. These CAR policies are executed in their configuration order.
When specifying an ACL, follow these restrictions and guidelines:
· If the specified ACL does not exist or does not have any rules, the ACL will not be referenced.
· In the specified ACL, if a rule has the vpn-instance keyword specified, the rule takes effect only on VPN packets. If a rule does not have the vpn-instance keyword specified, the rule takes effect only on packets in the public network.
Examples
# Perform CAR for all packets in the outbound direction of GigabitEthernet 1/0/1. The CAR parameters are as follows:
· CIR is 200 kbps.
· CBS is 5120 bytes.
· EBS is 0.
· Conforming packets are transmitted.
· Excess packets are set with an IP precedence of 0 and transmitted.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos car outbound any cir 200 cbs 5000 ebs 0 green pass red remark-prec-pass 0
Related commands
display qos car interface
qos carl
qos car (user profile view)
Use qos car any to configure a CAR policy for all packets of a user profile.
Use undo qos car to delete a CAR policy from a user profile.
Syntax
qos car { inbound | outbound } any cir committed-information-rate [ cbs committed-burst-size [ ebs excess-burst-size ] ]
qos car { inbound | outbound } any cir committed-information-rate [ cbs committed-burst-size ] pir peak-information-rate [ ebs excess-burst-size ]
undo qos car { inbound | outbound } any
Default
No CAR policy is configured.
Views
User profile view
Predefined user roles
network-admin
Parameters
inbound: Performs CAR for incoming traffic.
outbound: Performs CAR for outgoing traffic.
any: Performs CAR for all traffic.
cir committed-information-rate: Specifies the CIR in kbps. The value range for committed-information-rate is 8 to 10000000.
cbs committed-burst-size: Specifies the CBS in bytes, which is the size of bursty traffic when the actual average rate is not greater than the CIR. The value range for committed-burst-size is 1000 to 1000000000.
ebs excess-burst-size: Specifies the EBS in the range of 0 to 1000000000 bytes. The default is 0.
pir peak-information-rate: Specifies the PIR in kbps.
Usage guidelines
To use two rates for traffic policing, configure the qos car command with the pir peak-information-rate option. To use one rate for traffic policing, configure the qos car command without the pir peak-information-rate option.
The conforming traffic is permitted to pass through, and the excess traffic is dropped.
If you execute the qos car command multiple times for the same user profile or session group profile, the most recent configuration takes effect.
Examples
# Perform CAR for packets received by user profile user. The CAR parameters are as follows:
· The CIR is 200 kbps.
· The CBS is 51200 bytes.
<Sysname> system-view
[Sysname] user-profile user
[Sysname-user-profile-user] qos car outbound any cir 200 cbs 51200
qos car percent (interface view)
Use qos car percent to configure a CAR policy in percentage on an interface.
Use undo qos car to delete a CAR policy from an interface.
Syntax
qos car { inbound | outbound } { any | acl [ ipv6 ] acl-number } percent cir cir-percent [ cbs cbs-time [ ebs ebs-time ] ] [ green action | red action | yellow action ] *
qos car { inbound | outbound } { any | acl [ ipv6 ] acl-number } percent cir cir-percent [ cbs cbs-time ] pir pir-percent [ ebs ebs-time ] [ green action | red action | yellow action ] *
undo qos car { inbound | outbound } { any | acl [ ipv6 ] acl-number }
Default
No CAR policy is configured in percentage on an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
inbound: Performs CAR for incoming packets on the interface.
outbound: Performs CAR for outgoing packets on the interface.
any: Performs CAR for all IP data packets in the specified direction.
acl [ ipv6 ] acl-number: Performs CAR for packets matching an ACL specified by its number. The value range for the acl-number argument is 2000 to 3999. If you do not specify ipv6, this option specifies an IPv4 ACL. If you specify ipv6, this option specifies an IPv6 ACL.
percent cir cir-percent: Specifies the CIR in percentage, in the range of 1 to 100. The actual CIR value is cir-percent × interface bandwidth.
cbs cbs-time: Specifies the CBS in milliseconds. The actual CBS value is cbs-time × the actual CIR value. The value range for cbs-time is 500 to 2000. The default value is 500.
ebs ebs-time: Specifies the EBS in milliseconds. The actual EBS value is ebs-time × the actual CIR value. The value range for excess-burst-size is 0 to 2000. The default EBS is 0.
pir pir-percent: Specifies the PIR in percentage, in the range of 1 to 100. The value for the pir-percent argument must be greater than or equal to the value for the cir-percent argument.
green: Specifies the action to take on packets when the traffic rate conforms to CIR. The default is pass.
red: Specifies the action to take on packets when the traffic rate conforms to neither CIR nor PIR. The default is discard.
yellow: Specifies the action to take on packets when the traffic rate exceeds CIR but conforms to PIR. The default is pass.
action: Specifies the action to take on packets:
· continue: Continues to process the packet by using the next CAR policy.
· discard: Drops the packet.
· pass: Permits the packet to pass through.
· remark-dot1p-continue new-cos: Sets the 802.1p priority value of the packet to new-cos and continues to process the packet by using the next CAR policy. The new-cos argument is in the range of 0 to 7.
· remark-dot1p-pass new-cos: Sets the 802.1p priority value of the packet to new-cos and permits the packet to pass through. The new-cos argument is in the range of 0 to 7.
· remark-dscp-continue new-dscp: Sets the DSCP value of the packet and continues to process the packet by using the next CAR policy. The new-dscp argument is in the range of 0 to 63. Alternatively, you can specify the new-dscp argument with af11, af12, af13, af21, af22, af23, af31, af32, af33, af41, af42, af43, cs1, cs2, cs3, cs4, cs5, cs6, cs7, default, or ef.
· remark-dscp-pass new-dscp: Sets the DSCP value of the packet and permits the packet to pass through. The new-dscp argument is in the range of 0 to 63. Alternatively, you can specify the new-dscp argument with af11, af12, af13, af21, af22, af23, af31, af32, af33, af41, af42, af43, cs1, cs2, cs3, cs4, cs5, cs6, cs7, default, or ef.
· remark-mpls-exp-continue new-exp: Sets the EXP field value of the MPLS packet to new-exp and continues to process the packet by using the next CAR policy. The new-exp argument is in the range of 0 to 7.
· remark-mpls-exp-pass new-exp: Sets the EXP field value of the MPLS packet to new-exp and permits the packet to pass through. The new-exp argument is in the range of 0 to 7.
· remark-prec-continue new-precedence: Sets the IP precedence of the packet and continues to process the packet by using the next CAR policy. The new-precedence argument is in the range of 0 to 7.
· remark-prec-pass new-precedence: Sets the IP precedence of the packet and permits the packet to pass through. The new-precedence argument is in the range of 0 to 7.
Usage guidelines
To use two rates for traffic policing, configure the qos car percent command with the pir pir-percent option. To use one rate for traffic policing, configure the qos car percent command without the pir pir-percent option.
You can configure multiple qos car percent commands on an interface to define multiple CAR policies. These CAR policies are executed in their configuration order.
When specifying an ACL, follow these restrictions and guidelines:
· If the specified ACL does not exist or does not have any rules, the ACL will not be referenced.
· In the specified ACL, if a rule has the vpn-instance keyword specified, the rule takes effect only on VPN packets. If a rule does not have the vpn-instance keyword specified, the rule takes effect only on packets in the public network.
Examples
# Perform CAR for all outgoing packets on GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos car outbound any percent cir 50 cbs 1000
qos carl
Use qos carl to create or modify a CAR list.
Use undo qos carl to delete a CAR list.
Syntax
qos carl carl-index { dscp dscp-list | mac mac-address | mpls-exp mpls-exp-value | precedence precedence-value | { destination-ip-address | source-ip-address } { range start-ip-address to end-ip-address | subnet ip-address mask-length } [ per-address [ shared-bandwidth ] ] [ time-range time-range-name ] }
undo qos carl carl-index
Default
No CAR list is configured.
Views
System view
Predefined user roles
network-admin
Parameters
carl-index: Specifies a CAR list by its number in the range of 1 to 199.
dscp dscp-list: Specifies a list of DSCP values. A DSCP value can be a number from 0 to 63 or any of the following keywords af11, af12, af13, af21, af22, af23, af31, af32, af33, af41, af42, af43, cs1, cs2, cs3, cs4, cs5, cs6, cs7, default, or ef. You can configure up to eight DSCP values in one command line. If the same DSCP value is specified multiple times, the system considers the values to be one value. If a packet matches one of the defined DSCP values, it matches the if-match clause.
mac mac-address: Specifies a MAC address in hexadecimal format.
mpls-exp mpls-exp-value: Specifies an MPLS EXP value in the range of 0 to 7. You can configure up to eight MPLS EXP values in one command line. If the same MPLS EXP value is specified multiple times, the system considers the values to be one value. If a packet matches one of the defined MPLS EXP values, it matches the if-match clause.
precedence precedence: Specifies a precedence value in the range of 0 to 7. You can configure up to eight IP precedence values in one command line. If the same IP precedence value is specified multiple times, the system considers the values to be one value. If a packet matches one of the defined IP precedence values, it matches the if-match clause.
destination-ip-address: Configures a destination IP address-based CAR list.
source-ip-address: Configures a source IP address-based CAR list.
range start-ip-address to end-ip-address: Specifies an IP address range by the start address and end address. The value for end-ip-address must be greater than the value for start-ip-address.
subnet ip-address mask-length: Specifies a subnet by the IP subnet address and IP subnet address mask length.
per-address: Performs per-IP address rate limiting within the network segment. When this keyword is specified, the CIR is dedicated bandwidth for each IP address and is not shared by any other IP address. If you do not specify this keyword, the following events occur:
· Rate limiting is performed for the entire network segment.
· All of the CIR is allocated among all IP addresses in proportion to the traffic load of each IP address.
shared-bandwidth: Specifies that traffic of all IP addresses within the network segment shares the remaining bandwidth (the CIR). If you specify this keyword, all of the CIR is allocated evenly among all IP addresses with traffic load.
time-range time-range-name: Specifies a time range during which the CAR list is in effect. The time-range-name argument is a case-insensitive string of 1 to 63 characters and cannot be all. If the specified time range does not exist, the CAR list can be created but does not take effect until the time range is created. For more information about time ranges, see "Configuring time ranges."
Usage guidelines
You can create a CAR list based on IP precedence, MAC address, MPLS EXP, DSCP, or IP network segment.
If you execute this command multiple times for the same CAR list, the most recent configuration takes effect. If you execute this command multiple times for different CAR lists, multiple CAR lists are created.
To perform rate limiting for a single IP address, use the qos car acl command in interface view.
Examples
# Apply CAR list 1 to the outbound direction of GigabitEthernet 1/0/1 to meet the following requirements:
· The rate of each host on the subnet 1.1.1.0/24 is limited to 512 kbps.
· Traffic of IP addresses in the subnet does not share the remaining bandwidth.
<Sysname> system-view
[Sysname] qos carl 1 source-ip-address subnet 1.1.1.0 24 per-address
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos car outbound carl 1 cir 512 cbs 5120 ebs 0 green pass red discard
# Apply CAR list 2 to the outbound direction of GigabitEthernet 1/0/1 to meet the following requirements:
· The rate of each host in the IP address range of 1.1.2.100 to 1.1.2.199 is limited to 5 Mbps.
· Traffic of IP addresses in the subnet shares the remaining bandwidth.
<Sysname> system-view
[Sysname] qos carl 2 source-ip-address range 1.1.2.100 to 1.1.2.199 per-address shared-bandwidth
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos car outbound carl 2 cir 5120 cbs 51200 ebs 51200 green pass red discard
Related commands
display qos carl
qos car
reset qos tunnel-session
Use reset qos tunnel-session to clear the QoS statistics for tunnels on a tunnel interface.
Syntax
reset qos tunnel-session interface tunnel number [ identity identity ] [ inbound | outbound ]
Views
User view
Predefined user roles
network-admin
Parameters
tunnel number: Specifies a tunnel interface by its number.
identity identity: Specifies an IPsec P2MP tunnel by its identity. If you do not specify a tunnel, this command clears the QoS configuration and statistics for all tunnels on a tunnel interface. For more information about IPsec P2MP tunnel interfaces, see IPsec configuration in Security Configuration Guide.
inbound: Specifies the inbound direction.
outbound: Specifies the outbound direction.
Usage guidelines
If you do not specify a direction, this command clears the QoS statistics for both the inbound and outbound directions.
Examples
# Clear the QoS statistics for all tunnels on tunnel interface 0.
<Sysname> reset qos tunnel-session interface tunnel 0
Related commands
reset qos tunnel-session
GTS commands
display qos gts interface
Use display qos gts interface to display the GTS configuration and statistics for interfaces.
Syntax
display qos gts interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the GTS configuration and statistics for all interfaces.
Examples
# Display the GTS configuration and statistics for all interfaces.
<Sysname> display qos gts interface
Interface: GigabitEthernet1/0/1
Rule: If-match acl 2001
CIR 512 (kbps), CBS 51200 (Bytes), PIR 5120 (kbps), EBS 0 (Bytes)
Queue Length: 100 (Packets)
Queue Size: 70 (Packets)
Passed : 0 (Packets) 0 (Bytes)
Discarded: 0 (Packets) 0 (Bytes)
Delayed : 0 (Packets) 0 (Bytes)
Interface: GigabitEthernet1/0/2
Rule: If-match acl 2001
CIR 64 (kbps), CBS 51200 (Bytes), EBS 0 (Bytes)
Queue Length: 100 (Packets)
Queue Size: 70 (Packets)
Passed : 0 (Packets) 0 (Bytes)
Discarded: 0 (Packets) 0 (Bytes)
Delayed : 0 (Packets) 0 (Bytes)
Table 16 Command output
Field |
Description |
Interface |
Interface name, including the interface type and interface number. |
Rule |
Match criteria. |
CIR |
CIR in kbps (if the CIR is specified in absolute value) or in percentage (if the CIR is specified in percentage). |
CBS |
CBS in bytes (if the CBS is specified in absolute value) or in ms (if the CBS is specified in milliseconds). When the CBS is specified in milliseconds, the actual CBS value is cbs-time × the actual CIR value. |
EBS |
EBS in bytes (if the EBS is specified in absolute value) or in ms (if the EBS is specified in milliseconds). When the EBS is specified in milliseconds, the actual EBS value is ebs-time × the actual CIR value. |
PIR |
PIR in kbps (if the PIR is specified in absolute value) or in percentage (if the PIR is specified in percentage). |
Queue Length |
Number of packets that the buffer can hold. |
Queue Size |
Number of packets in the buffer. |
Passed |
Number and bytes of packets that have been forwarded. |
Discarded |
Number and bytes of dropped packets. |
Delayed |
Number and bytes of delayed packets. |
qos gts (interface view)
Use qos gts to set GTS parameters on an interface.
Use undo qos gts to delete the GTS configuration on an interface.
Syntax
qos gts { any | acl [ ipv6 ] acl-number } cir committed-information-rate [ cbs committed-burst-size [ ebs excess-burst-size ] ] [ queue-length queue-length ]
undo qos gts { any | acl [ ipv6 ] acl-number }
Default
No GTS parameters are configured on an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
any: Shapes all packets.
acl [ ipv6 ] acl-number: Performs GTS for packets matching an ACL specified by its number. The value range for the acl-number argument is 2000 to 3999. If you do not specify ipv6, this option specifies an IPv4 ACL. If you specify ipv6, this option specifies an IPv6 ACL.
cir committed-information-rate: Specifies the CIR in kbps. The value range for committed-information-rate is 8 to 10000000.
cbs committed-burst-size: Specifies the CBS in the range of 1875 to 134217727 bytes. The default value is the product of 62.5 and the CIR.
ebs excess-burst-size: Specifies the EBS in bytes, which is the traffic exceeding CBS when two token buckets are used. The value range for peak-information-rate is 0 to 134217727. The default EBS is 0.
queue-length queue-length: Specifies the maximum number of packets allowed in the queue. The value range for queue-length is 1 to 1024 packets. The default is 50 packets.
Usage guidelines
To use two rates for traffic shaping, configure the qos gts command with the pir peak-information-rate option. To use one rate for traffic shaping, configure the qos gts command without the pir peak-information-rate option.
When specifying an ACL, follow these restrictions and guidelines:
· If the specified ACL does not exist or does not have any rules, the ACL will not be referenced.
· In the specified ACL, if a rule has the vpn-instance keyword specified, the rule takes effect only on VPN packets. If a rule does not have the vpn-instance keyword specified, the rule takes effect only on packets in the public network.
Examples
# Shape the packets matching ACL 2001 on GigabitEthernet 1/0/1. The GTS parameters are as follows:
· The CIR is 200 kbps.
· The CBS is 51200 bytes.
· The EBS is 0.
· The maximum buffer queue length is 100.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos gts acl 2001 cir 200 cbs 51200 ebs 0 queue-length 100
qos gts (user profile view)
Use qos gts to set GTS parameters for a user profile.
Use undo qos gts to restore the default.
Syntax
qos gts any cir committed-information-rate [ cbs committed-burst-size [ ebs excess-burst-size ] ] [ queue-length queue-length ]
undo qos gts any
Default
No GTS parameters are set for a user profile.
Views
User profile view
Predefined user roles
network-admin
Parameters
any: Shapes all packets.
cir committed-information-rate: Specifies the CIR in kbps.The value range for committed-information-rate is 8 to 10000000.
cbs committed-burst-size: Specifies the CBS in bytes.The value range for committed-burst-size is 1000 to 1000000000.
ebs excess-burst-size: Specifies the EBS in bytes. The default for excess-burst-size is 0 bytes.The value range is 0 to 1000000000.
queue-length queue-length: Specifies the maximum number of packets allowed in the queue, in the range of 1 to 1024. The default is 50.
Examples
# Shape the packets received by user profile user. The GTS parameters are as follows:
· The CIR is 200 kbps.
· The CBS is 51200 bytes.
<Sysname> system-view
[Sysname] user-profile user
[Sysname-user-profile-user] qos gts any cir 200 cbs 51200
Rate limit commands
display qos lr
Use display qos lr to display the rate limit configuration and statistics for interfaces.
Syntax
display qos lr interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the rate limit configuration and statistics for all interfaces.
Examples
# Display the rate limit configuration and statistics for all interfaces.
<Sysname> display qos lr interface
Interface: GigabitEthernet1/0/1
Direction: Outbound
CIR 2000 (kbps), CBS 20480 (Bytes), EBS 0 (Bytes)
Passed : 1000 (Packets) 1000 (Bytes)
Delayed : 1000 (Packets) 1000 (Bytes)
Active shaping: No
Table 17 Command output
Field |
Description |
Interface |
Interface name, including the interface type and interface number. |
Direction |
Direction in which the rate limit configuration is applied. |
CIR |
CIR in kbps. |
CBS |
CBS in bytes. |
EBS |
EBS in bytes (if the EBS is specified in absolute value) or in ms (if the EBS is specified in milliseconds). When the EBS is specified in milliseconds, the actual EBS value is ebs-time × the actual CIR value. |
Passed |
Number and bytes of packets that have passed. |
Delayed |
Number and bytes of delayed packets. |
Active shaping |
Indicates whether the rate limit configuration is activated: · Yes—Activated. · No—Not activated. |
qos lr
Use qos lr to configure rate limiting on an interface.
Use undo qos lr to delete the rate limit configuration.
Syntax
qos lr outbound cir committed-information-rate [ cbs committed-burst-size [ ebs excess-burst-size ] ]
undo qos lr outbound
Default
No rate limit is configured on an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
outbound: Limits the rate of outgoing packets.
cir committed-information-rate: Specifies the CIR in kbps. The value range for committed-information-rate varies by interface type.
cbs committed-burst-size: Specifies the CBS. The value range for committed-burst-size varies by interface type. The default value is the product of 62.5 and the CIR.
ebs excess-burst-size: Specifies the EBS in bytes, which is the traffic exceeding CBS when two token buckets are used. The value range for excess-burst-size varies by interface type. The default EBS is 0.
Examples
# Limit the rate of outgoing packets on GigabitEthernet 1/0/1, with CIR 256 kbps and CBS 51200 bytes.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos lr outbound cir 256 cbs 51200
qos lr outbound (user profile view)
Use qos lr outbound to configure traffic rate limiting settings based on user profiles.
Use undo qos lr outbound to restore the default.
Syntax
qos lr outbound { cir committed-information-rate [ cbs committed-burst-size [ ebs excess-burst-size ] ] | peer-advertise-bandwidth }
undo qos lr outbound
Default
No traffic rate limiting settings are configured based on user profiles.
Views
User profile view
Predefined user roles
network-admin
Parameters
cir committed-information-rate: Specifies the CIR. The value range for the committed-information-rate argument is 8 to 10000000.
cbs committed-burst-size: Specifies the CBS. The value range for the committed-burst-size argument is 1000 to 1000000000.
ebs excess-burst-size: Specifies the EBS, which is the traffic exceeding CBS when two token buckets are used. The value range for the excess-burst-size argument is 0 to 1000000000.
peer-advertise-bandwidth: Uses the CIR advertised by the peer tunnel interface. This CIR is configured by using the qos bandwidth downstream command on the peer tunnel interface and advertised during data channel establishment.
Usage guidelines
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure traffic rate limiting settings based on user profile a and use the CIR configured by using the qos bandwidth downstream command on the peer tunnel interface.
<Sysname> system-view
[Sysname] user-profile a
[Sysname-user-profile-a] qos lr outbound peer-advertise-bandwidth
# Configure traffic rate limiting settings based on user profile a and set the CIR to 1000 kbps.
<Sysname> system-view
[Sysname] user-profile a
[Sysname-user-profile-a] qos lr outbound cir 1000
Related commands
qos bandwidth downstream
qos overhead layer
Use qos overhead layer physical to include the physical layer header in calculating the packet length for rate limiting.
Use undo qos overhead layer physical to restore the default.
Syntax
qos overhead layer physical
undo qos overhead layer physical
Default
The device calculates the packet length for rate limiting based on the data link layer frame.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command allows the device to include a 24-byte physical layer header in calculating the packet length for rate limiting. As a best practice, configure this command in scenarios where packets are small and precise rate limiting is required. To save computing resources, do not configure this command if the device processes large packets.
This command takes effect only on Layer 3 Ethernet interfaces and Layer 3 aggregate interfaces.
Examples
# Include the physical layer header in calculating the packet length for rate limiting.
<Sysname> system-view
[Sysname] qos overhead layer physical
Related commands
display qos lr
qos lr
Congestion management commands
Common commands
display qos queue interface
Use display qos queue interface to display the queuing information for interfaces.
Syntax
display qos queue interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the queuing information for all interfaces.
Examples
# Display the queuing information for all interfaces.
<Sysname> display qos queue interface
Interface: GigabitEthernet1/0/1
Output queue: Strict Priority queuing
Interface: GigabitEthernet1/0/2
Output queue: Strict Priority queuing
Interface: GigabitEthernet1/0/3
Output queue: Strict Priority queuing
Interface: GigabitEthernet1/0/4
Output queue: Strict Priority queuing
Interface: GigabitEthernet1/0/5
Output queue: Strict Priority queuing
Interface: GigabitEthernet1/0/6
Output queue: Strict Priority queuing
Table 18 Command output
Field |
Description |
Interface |
Interface name, including the interface type and interface number. |
Output queue |
Type of the current output queue. |
Group |
Number of the group that holds the queue. |
Weight |
Packet-count scheduling weight of the queue. N/A is displayed for a queue that uses the SP scheduling algorithm. |
Byte-count |
Byte-count scheduling weight of the queue. N/A is displayed for a queue that uses the SP scheduling algorithm. |
FIFO queuing commands
display qos queue fifo
Use display qos queue fifo to display the FIFO information for interfaces.
Syntax
display qos queue fifo interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the FIFO information for all interfaces.
Examples
# Display the FIFO information for all interfaces.
<Sysname> display qos queue fifo interface
Interface: GigabitEthernet1/0/2
Output queue - Urgent queuing: Size/Length/Discards 0/100/0
Output queue - Protocol queuing: Size/Length/Discards 0/500/0
Output queue - FIFO queuing: Size/Length/Discards 0/75/0
Table 19 Command output
Field |
Description |
Interface |
Interface name, including the interface type and interface number. |
L2VPN-PW |
A PW is uniquely identified by a combination of the peer PE IP address and PW ID. |
Size |
Total number of bytes of packets in all queues. |
Length |
Number of packets allowed in each queue. |
Discards |
Number of packets dropped. |
qos fifo queue-length
Use qos fifo queue-length to set the FIFO queue length for an interface.
Use undo qos fifo queue-length to restore the default.
Syntax
qos fifo queue-length queue-length
undo qos fifo queue-length
Default
The FIFO queue length is 75.
Views
Interface view
Predefined user roles
network-admin
Parameters
queue-length: Specifies the maximum number of packets allowed in the FIFO queue, in the range of 1 to 4096.
Usage guidelines
For FIFO queuing to take effect on a subinterface, you must configure the rate limit on the subinterface.
Examples
# Set the FIFO queue length to 100.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos fifo queue-length 100
Related commands
display qos queue fifo interface
PQ commands
display qos pql
Use display qos pql to display the PQ list configuration.
Syntax
display qos pql [ pql-index ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
pql-index: Specifies a PQ list by its number in the range of 1 to 16.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the PQ list configuration for the active MPU.
Examples
# Display the configuration of all PQ lists.
<Sysname> display qos pql
Current PQL configuration:
List Queue Parameters
------------------------------------------------------
1 Top Protocol ip less-than 1000
2 Normal Length 80
2 Bottom Length 40
3 Middle Inbound-interface GigabitEthernet1/0/1
4 Top Local-precedence 7
4 0 Protocol ip acl 3001
4 1 Protocol ipv6 acl 3001
4 2 Protocol ip
4 3 Protocol ipv6
Table 20 Command output
Field |
Description |
Queue |
PQ queue type: · 0—Queue 0 in 8-queue PQ. · 1—Queue 1 in 8-queue PQ. · 2—Queue 2 in 8-queue PQ. · 3—Queue 3 in 8-queue PQ. · Bottom—Bottom priority queue in 4-queue PQ or queue 4 in 8-queue PQ. · Normal—Normal priority queue in 4-queue PQ or queue 5 in 8-queue PQ. · Middle—Middle priority queue in 4-queue PQ or queue 6 in 8-queue PQ. · Top—Top priority queue in 4-queue PQ or queue 7 in 8-queue PQ. |
display qos queue pq interface
Use display qos queue pq interface to display the PQ information for interfaces.
Syntax
display qos queue pq interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the PQ information for all interfaces except VA interfaces and dialer interfaces. For information about VA interfaces, see PPP in Layer 2—WAN Access Configuration Guide.
Examples
# Display the PQ information for GigabitEthernet 1/0/1.
<Sysname> display qos queue pq interface gigabitethernet 1/0/1
Interface: GigabitEthernet1/0/1
Output queue - Urgent queuing: Size/Length/Discards 0/100/0
Output queue - Protocol queuing: Size/Length/Discards 0/500/0
Output queue - Priority queuing: PQL 1 Size/Length/Discards
Top: 0/20/0 Middle: 0/40/0 Normal: 0/60/0 Bottom: 0/80/0
3 : 0/80/0 2 : 0/80/0 1 : 0/100/0 0 : 0/100/0
Table 21 Command output
Field |
Description |
Priority queuing: PQL 1 |
PQL 1 indicates the PQ list in use. |
Size |
Total number of bytes of packets in all queues. |
Length |
Number of packets allowed in each queue. |
Discards |
Number of dropped packets. |
Top |
Top priority queue in 4-queue PQ or queue 7 in 8-queue PQ. |
Middle |
Middle priority queue in 4-queue PQ or queue 6 in 8-queue PQ. |
Normal |
Normal priority queue in 4-queue PQ or queue 5 in 8-queue PQ. |
Bottom |
Bottom priority queue in 4-queue PQ or queue 4 in 8-queue PQ. |
qos pq (interface view)
Use qos pq to apply a PQ list to an interface.
Use undo qos pq to restore the default.
Syntax
qos pq pql pql-index
undo qos pq
Default
An interface uses FIFO queuing.
Views
Interface view
Predefined user roles
network-admin
Parameters
pql pql-index: Specifies a PQ list by its number in the range of 1 to 16.
Usage guidelines
If you execute this command multiple times on an interface, the most recent configuration takes effect.
Multiple match criteria can be configured for a PQ list. When a packet arrives, it is examined against match criteria in their configuration order.
· If a match is found, the packet is assigned to the corresponding queue, and the matching process ends.
· If no match is found, the packet is assigned to the default queue.
You must configure the rate limit for the queuing feature to take effect on the following interfaces:
· Tunnel interfaces.
· Subinterfaces.
· Layer 3 aggregate interfaces.
· HDLC link bundle interfaces.
· VT and dialer interfaces configured with PPPoE, PPPoA, or PPPoEoA.
Examples
# Apply PQ list 12 to GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos pq pql 12
qos pq (user profile view)
Use qos pq to apply a PQ list to a user profile.
Use undo qos pq to restore the default.
Syntax
qos pq pql pql-index
undo qos pq
Default
No PQ list is applied to a user profile.
Views
User profile view
Predefined user roles
network-admin
Parameters
pql-index: Specifies a PQ list by its number in the range of 1 to 16.
Usage guidelines
PQ is designed for mission-critical applications. Mission-critical applications require preferential treatment to reduce the response delay when congestion occurs. PQ can flexibly determine the order of forwarding packets by network protocol (for example, IP and IPX), incoming interface, packet length, and source/destination address.
You can execute this command to apply a user profile with a PQ list configured to different interfaces, without configuring the PQ list for each interface.
For a user profile, if you execute this command multiple times, the most recent configuration takes effect.
You can define a set of assignment rules in a PQ list. When a packet arrives, it is examined against match criteria in their configuration order.
· When a match is found, the packet is assigned to the corresponding queue, and the matching process ends.
· If no match is found, the packet is assigned to the default queue.
Examples
# Apply PQ list 12 to user profile a.
<Sysname> system-view
[Sysname] user-profile a
[Sysname-user-profile-a] qos pq pql 12
qos pql default-queue
Use qos pql default-queue to specify a priority queue as the default queue for a PQ list.
Use undo qos pql default-queue to restore the default.
Syntax
4-queue PQ:
qos pql pql-index default-queue { bottom | middle | normal | top }
undo qos pql pql-index default-queue
8-queue PQ:
qos pql pql-index default-queue queue-number
undo qos pql pql-index default-queue
Default
The normal queue is the default queue for a PQ list.
Views
System view
Predefined user roles
network-admin
Parameters
pql-index: Specifies a PQ list by its number in the range of 1 to 16.
top: Specifies the top queue.
middle: Specifies the middle queue.
normal: Specifies the normal queue.
bottom: Specifies the bottom queue.
queue-number: Specifies a queue by its number in the range of 0 to 7. Queue 0 through queue 7 are in ascending order of priority.
Usage guidelines
If a packet does not match any criteria in a PQ list, the packet is assigned to the default queue of the PQ list.
If you execute this command multiple times for the same PQ list, the most recent configuration takes effect.
On devices supporting 8-priority PQ, you can use the command for 4-queue or 8-queue PQ to specify the default queue for packets that match no rules. Queue 4 through queue 7 correspond to the bottom queue, normal queue, middle queue, and top queue, respectively.
Examples
# Specify the bottom queue as the default queue for PQ list 12.
<Sysname> system-view
[Sysname] qos pql 12 default-queue bottom
qos pql inbound-interface
Use qos pql inbound-interface to configure an assignment rule for a PQ list to assign packets received on the specified interface to a priority queue.
Use undo qos pql inbound-interface to delete an assignment rule based on the specified input interface from a PQ list.
Syntax
4-queue PQ:
qos pql pql-index inbound-interface interface-type interface-number queue { bottom | middle | normal | top }
undo qos pql pql-index inbound-interface interface-type interface-number
8-queue PQ:
qos pql pql-index inbound-interface interface-type interface-number queue queue-number
undo qos pql pql-index inbound-interface interface-type interface-number
Default
No assignment rule is configured for a PQ list.
Views
System view
Predefined user roles
network-admin
Parameters
pql-index: Specifies a PQ list by its number in the range of 1 to 16.
interface-type interface-number: Specifies an input interface by its type and number.
top: Specifies the top queue.
middle: Specifies the middle queue.
normal: Specifies the normal queue.
bottom: Specifies the bottom queue.
queue-number: Specifies a queue by its number in the range of 0 to 7. Queue 0 through queue 7 are in ascending order of priority.
Usage guidelines
You can configure this command multiple times for the same PQ list to establish multiple assignment rules based on input interfaces.
On devices supporting 8-priority PQ, you can use the command for 4-queue or 8-queue PQ to configure an assignment rule for a PQ list to assign packets received on the specified interface to a priority queue. Queue 4 through queue 7 correspond to the bottom queue, normal queue, middle queue, and top queue, respectively.
Examples
# In PQ list 12, assign packets received on GigabitEthernet 1/0/1 to the middle queue.
<Sysname> system-view
[Sysname] qos pql 12 inbound-interface gigabitethernet 1/0/1 queue middle
qos pql local-precedence
Use qos pql local-precedence to configure an assignment rule for a PQ list to assign packets with any of the specified local precedence values to a priority queue.
Use undo qos pql local-precedence to delete an assignment rule based on the specified local precedence values from a PQ list.
Syntax
4-queue PQ:
qos pql pql-index local-precedence local-precedence-list queue { bottom | middle | normal | top }
undo qos pql pql-index local-precedence local-precedence-list
8-queue PQ:
qos pql pql-index local-pecedence local-precedence-list queue queue-number
undo qos pql pql-index local-precedence local-precedence-list
Default
No assignment rule is configured for a PQ list.
Views
System view
Predefined user roles
network-admin
Parameters
pql-index: Specifies a PQ list by its number in the range of 1 to 16.
local-precedence-list: Specifies a space-separated list of up to eight local precedence values. The value range is 0 to 7.
top: Specifies the top queue.
middle: Specifies the middle queue.
normal: Specifies the normal queue.
bottom: Specifies the bottom queue.
queue-number: Specifies a queue by its number in the range of 0 to 7. Queue 0 through queue 7 are in ascending order of priority.
Usage guidelines
You can configure this command multiple times for the same PQ list to establish multiple assignment rules based on local precedence values.
On devices supporting 8-priority PQ, you can use the command for 4-queue or 8-queue PQ to configure an assignment rule for a PQ list to assign packets with any of the specified local precedence values to a priority queue. Queue 4 through queue 7 correspond to the bottom queue, normal queue, middle queue, and top queue, respectively.
Examples
# In PQ list 12, assign packets with local precedence 3 to the middle queue.
<Sysname> system-view
[Sysname] qos pql 12 local-precedence 3 queue middle
qos pql protocol
Use qos pql protocol to configure an assignment rule for a PQ list to assign packets of the specified protocol type to a priority queue.
Use undo qos pql protocol to delete an assignment rule based on the specified protocol type from a PQ list.
Syntax
4-queue PQ:
qos pql pql-index protocol { ip | ipv6 } [ queue-key key-value ] queue { bottom | middle | normal | top }
undo qos pql pql-index protocol { ip | ipv6 } [ queue-key key-value ]
8-queue PQ:
qos pql pql-index protocol { ip | ipv6 } [ queue-key key-value ] queue queue-number
undo qos pql pql-index protocol { ip | ipv6 } [ queue-key key-value ]
Default
No assignment rule is configured for a PQ list.
Views
System view
Predefined user roles
network-admin
Parameters
pql-index: Specifies a PQ list by its number in the range of 1 to 16.
top: Specifies the top queue.
middle: Specifies the middle queue.
normal: Specifies the normal queue.
bottom: Specifies the bottom queue.
queue-number: Specifies a queue by its number in the range of 0 to 7. Queue 0 through queue 7 are in ascending order of priority.
queue-key key-value: Matches specific IP or IPv6 packets. If you specify neither the queue-key argument nor the key-value argument, all IP or IPv6 packets are matched.
Table 22 Values of the queue-key argument and the key-value argument
queue-key |
key-value |
Description |
acl |
ACL number in the range of 2000 to 3999 |
Packets matching a specific ACL are enqueued. |
fragments |
N/A |
Fragmented packets are enqueued. |
greater-than |
Length in the range of 0 to 65535 |
Packets greater than a specific size are enqueued. |
less-than |
Length in the range of 0 to 65535 |
Packets smaller than a specific size are enqueued. |
tcp |
Port number in the range of 0 to 65535 or port name |
Packets with a specific source or destination TCP port number are enqueued. |
udp |
Port number in the range of 0 to 65535 or port name |
Packets with a specific source or destination UDP port number are enqueued. |
Usage guidelines
When classifying a packet, the system matches the packet against match criteria in the order configured. When a match is found, the matching process ends.
You can configure this command multiple times for the same PQ list to establish multiple assignment rules based on protocol types.
When specifying an ACL, follow these restrictions and guidelines:
· If the specified ACL does not exist or does not have any rules, the ACL will not be referenced.
· In the specified ACL, if a rule has the vpn-instance keyword specified, the rule takes effect only on VPN packets. If a rule does not have the vpn-instance keyword specified, the rule takes effect only on packets in the public network.
Examples
# In PQ list 5, assign IP packets matching ACL 3100 to the top queue.
<Sysname> system-view
[Sysname] qos pql 5 protocol ip acl 3100 queue top
qos pql protocol mpls exp
Use qos pql protocol mpls exp to configure an assignment rule for a PQ list to assign packets with any of the specified MPLS EXP values to a priority queue.
Use undo qos pql protocol mpls exp to delete an assignment rule based on the specified MPLS EXP values from a PQ list.
Syntax
4-queue PQ:
qos pql pql-index protocol mpls exp exp-list queue { bottom | middle | normal | top }
undo qos pql pql-index protocol mpls exp exp-list
8-queue PQ:
qos pql pql-index protocol mpls exp exp-list queue queue-number
undo qos pql pql-index protocol mpls exp exp-list
Default
No assignment rule is configured for a PQ list.
Views
System view
Predefined user roles
network-admin
Parameters
pql-index: Specifies a PQ list by its number in the range of 1 to 16.
exp-list: Specifies a space-separated list of up to eight MPLS EXP values. The value range is 0 to 7.
top: Specifies the top queue.
middle: Specifies the middle queue.
normal: Specifies the normal queue.
bottom: Specifies the bottom queue.
queue-number: Specifies a queue by its number in the range of 0 to 7. Queue 0 through queue 7 are in ascending order of priority.
Usage guidelines
You can configure this command multiple times for the same PQ list to establish multiple assignment rules based on MPLS EXP values.
On devices supporting 8-priority PQ, you can use the command for 4-queue or 8-queue PQ to configure an assignment rule for a PQ list to assign packets of the specified protocol type to a priority queue. Queue 4 through queue 7 correspond to the bottom queue, normal queue, middle queue, and top queue, respectively.
Examples
# In PQ list 5, assign packets with MPLS EXP value 2 or 4 to the top queue.
<Sysname> system-view
[Sysname] qos pql 5 protocol mpls exp 2 4 queue top
qos pql queue
Use qos pql queue to specify the length of a priority queue in a PQ list.
Use undo qos pql queue to restore the default length for a priority queue in a PQ list.
Syntax
4-queue PQ:
qos pql pql-index queue { bottom | middle | normal | top } queue-length queue-length
undo qos pql pql-index queue { bottom | middle | normal | top } queue-length
8-queue PQ:
qos pql pql-index queue queue-number queue-length queue-length
undo qos pql pql-index queue queue-number queue-length
Default
The queue length values for top, middle, normal, and bottom queues are 20, 40, 60, and 80, respectively.
The queue length values for queue 3 through queue 0 are 80, 80, 100, and 100, respectively.
Views
System view
Predefined user roles
network-admin
Parameters
pql-index: Specifies a PQ list by its number in the range of 1 to 16.
top: Specifies the top queue.
middle: Specifies the middle queue.
normal: Specifies the normal queue.
bottom: Specifies the bottom queue.
queue-number: Specifies a queue by its number in the range of 0 to 7. Queue 0 through queue 7 are in ascending order of priority.
queue-length: Specifies the maximum number of packets allowed in the queue, in the range of 1 to 1024.
Usage guidelines
If a queue is full, all subsequent packets to this queue are dropped.
On devices supporting 8-priority PQ, you can use the command for 4-queue or 8-queue PQ to configure an assignment rule for a PQ list to assign packets with any of the specified MPLS EXP values to a priority queue. Queue 4 through queue 7 correspond to the bottom queue, normal queue, middle queue, and top queue, respectively.
Examples
# In PQ list 10, set the length of the top queue to 10.
<Sysname> system-view
[Sysname] qos pql 10 queue top queue-length 10
# In PQ list 6, set the length of queue 6 to 20.
<Sysname> system-view
[Sysname] qos pql 6 queue queue 6 queue-length 20
CQ commands
display qos cql
Use display qos cql to display the CQ list configuration.
Syntax
display qos cql [ cql-index ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
cql-index: Specifies a CQ list by its number in the range of 1 to 16. If you do not specify a CQ list, this command displays the configuration of all CQ lists.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the CQ list configuration for the active MPU.
Examples
# Display the configuration of all CQ lists.
<Sysname> display qos cql
Current CQL configuration:
List Queue Parameters
------------------------------------------------------
2 3 Protocol ip fragments
3 6 Length 100
3 1 Inbound-interface GigabitEthernet1/0/1
4 5 Local-precedence 7
display qos queue cq interface
Use display qos queue cq interface to display the CQ information for interfaces.
Syntax
display qos queue cq interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the CQ information for all interfaces except VA and dialer interfaces. For information about VA interfaces, see PPP in Layer 2—WAN Access Configuration Guide.
Examples
# Display the CQ information for GigabitEthernet 1/0/1.
<Sysname>display qos queue cq interface gigabitethernet 1/0/1
Interface: GigabitEthernet1/0/1
Output queue - Urgent queuing: Size/Length/Discards 0/100/0
Output queue - Protocol queuing: Size/Length/Discards 0/500/0
Output queue - Custom queuing: CQL 1 Size/Length/Discards
1: 0/20/0 2: 0/20/0 3: 0/20/0
4: 0/20/0 5: 0/20/0 6: 0/20/0
7: 0/20/0 8: 0/20/0 9: 0/20/0
10: 0/20/0 11: 0/20/0 12: 0/20/0
13: 0/20/0 14: 0/20/0 15: 0/20/0
16: 0/20/0
Table 23 Command output
Field |
Description |
Size |
Total number of bytes of packets in all queues. |
Length |
Number of packets allowed in each queue. |
Discards |
Number of dropped packets. |
qos cq
Use qos cq to apply a CQ list to an interface.
Use undo qos cq to restore the default.
Syntax
qos cq cql cql-index
undo qos cq
Default
An interface uses FIFO queuing.
Views
Interface view
Predefined user roles
network-admin
Parameters
cql cql-index: Specifies a CQ list by its number in the range of 1 to 16.
Usage guidelines
If you execute this command multiple times on an interface, the most recent configuration takes effect.
Multiple match criteria can be configured for a CQ list. When a packet arrives, it is examined against match criteria in their configuration order.
· If a match is found, the packet is assigned to the corresponding queue, and the matching process ends.
· If no match is found, the packet is assigned to the default queue.
You must configure the rate limit for the queuing feature to take effect on the following interfaces:
· Tunnel interfaces.
· Subinterfaces.
· Layer 3 aggregate interfaces.
· HDLC link bundle interfaces.
· VT and dialer interfaces configured with PPPoE, PPPoA, or PPPoEoA.
Examples
# Apply CQ list 5 to GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos cq cql 5
qos cql default-queue
Use qos cql default-queue to specify a custom queue as the default queue for a CQ list.
Use undo qos cql default-queue to restore the default.
Syntax
qos cql cql-index default-queue queue-id
undo qos cql cql-index default-queue
Default
Queue 1 is the default queue.
Views
System view
Predefined user roles
network-admin
Parameters
cql-index: Specifies a CQ list by its number in the range of 1 to 16.
queue-id: Specifies a custom queue by its ID in the range of 1 to 16.
Usage guidelines
If a packet does not match any criteria in a CQ list, the packet is assigned to the default queue of the CQ list.
Examples
# Specify queue 2 as the default queue for CQ list 5.
<Sysname> system-view
[Sysname] qos cql 5 default-queue 2
qos cql inbound-interface
Use qos cql inbound-interface to configure an assignment rule for a CQ list to assign packets received on the specified interface to a custom queue.
Use undo qos cql inbound-interface to delete an assignment rule based on the specified input interface from a CQ list.
Syntax
qos cql cql-index inbound-interface interface-type interface-number queue queue-id
undo qos cql cql-index inbound-interface interface-type interface-number
Default
No assignment rule is configured for a CQ list.
Views
System view
Predefined user roles
network-admin
Parameters
cql-index: Specifies a CQ list by its number in the range of 1 to 16.
interface-type interface-number: Specifies an input interface by its type and number.
queue-id: Specifies a custom queue by its ID in the range of 1 to 16.
Usage guidelines
You can configure this command multiple times for the same CQ list to establish multiple assignment rules based on input interfaces.
Examples
# In CQ list 5, assign packets received from GigabitEthernet 1/0/1 to custom queue 3.
<Sysname> system-view
[Sysname] qos cql 5 inbound-interface gigabitethernet 1/0/1 queue 3
qos cql local-precedence
Use qos cql local-precedence to configure an assignment rule for a CQ list to assign packets with any of the specified local precedence values to a custom queue.
Use undo qos cql local-precedence to delete an assignment rule based on the specified local precedence values from a CQ list.
Syntax
qos cql cql-index local-precedence local-precedence-list queue queue-id
undo qos cql cql-index local-precedence local-precedence-list
Default
No assignment rule is configured for a CQ list.
Views
System view
Predefined user roles
network-admin
Parameters
cql-index: Specifies a CQ list by its number in the range of 1 to 16.
local-precedence-list: Specifies a space-separated list of up to eight local precedence values. The value range is 0 to 7.
queue-id: Specifies a custom queue by its ID in the range of 1 to 16.
Usage guidelines
You can configure this command multiple times for the same CQ list to establish multiple assignment rules based on local precedence values.
Examples
# In CQ list 5, assign packets with local precedence 4 to custom queue 3.
<Sysname> system-view
[Sysname] qos cql 5 local-precedence 4 queue 3
qos cql protocol
Use qos cql protocol to configure an assignment rule for a CQ list to assign packets of the specified protocol type to a custom queue.
Use undo qos cql protocol to delete an assignment rule based on the specified protocol type from a CQ list.
Syntax
qos cql cql-index protocol { ip | ipv6 } [ queue-key key-value ] queue queue-id
undo qos cql cql-index protocol { ip | ipv6 } [ queue-key key-value ]
Default
No assignment rule is configured for a CQ list.
Views
System view
Predefined user roles
network-admin
Parameters
cql-index: Specifies a CQ list by its number in the range of 1 to 16.
queue-id: Specifies a custom queue by its ID in the range of 1 to 16.
queue-key key-value: Matches specific IP or IPv6 packets. If you specify neither the queue-key argument nor the key-value argument, all IP or IPv6 packets are matched.
Table 24 Values of the queue-key argument and the key-value argument
queue-key |
key-value |
Description |
acl |
ACL number in the range of 2000 to 3999 |
Packets matching a specific ACL are enqueued. |
fragments |
N/A |
Fragmented packets are enqueued. |
greater-than |
Length in the range of 0 to 65535 |
Packets greater than a specific size are enqueued. |
less-than |
Length in the range of 0 to 65535 |
Packets smaller than a specific size are enqueued. |
tcp |
Port number in the range of 0 to 65535 or port name |
Packets with a specific source or destination TCP port number are enqueued. |
udp |
Port number in the range of 0 to 65535 or port name |
Packets with a specific source or destination UDP port number are enqueued. |
Usage guidelines
When classifying a packet, the system matches the packet against match criteria in their configuration order. When a match is found, the matching process ends.
You can configure this command multiple times for the same CQ list to establish multiple assignment rules based on protocol types.
When specifying an ACL, follow these restrictions and guidelines:
· If the specified ACL does not exist or does not have any rules, the ACL will not be referenced.
· In the specified ACL, if a rule has the vpn-instance keyword specified, the rule takes effect only on VPN packets. If a rule does not have the vpn-instance keyword specified, the rule takes effect only on packets in the public network.
Examples
# In CQ list 5, assign IP packets matching ACL 3100 to custom queue 3.
<Sysname> system-view
[Sysname] qos cql 5 protocol ip acl 3100 queue 3
qos cql protocol mpls exp
Use qos cql protocol mpls exp to configure an assignment rule for a CQ list to assign packets with any of the specified MPLS EXP values to a custom queue.
Use undo qos cql protocol mpls exp to delete an assignment rule based on the specified MPLS EXP values from a CQ list.
Syntax
qos cql cql-index protocol mpls exp exp-list queue queue-id
undo qos cql cql-index protocol mpls exp exp-list
Default
No assignment rule is configured for a CQ list.
Views
System view
Predefined user roles
network-admin
Parameters
cql-index: Specifies a CQ list by its number in the range of 1 to 16.
exp-list: Specifies a space-separated list of up to eight MPLS EXP values. The value range is 0 to 7.
queue-id: Specifies a custom queue by its ID in the range of 1 to 16.
Usage guidelines
You can configure this command multiple times for the same CQ list to establish multiple assignment rules based on MPLS EXP values.
Examples
# In CQ list 5, assign packets with MPLS EXP value 2 or 4 to custom queue 3.
<Sysname> system-view
[Sysname] qos cql 5 protocol mpls exp 2 4 queue 3
qos cql queue
Use qos cql queue to specify the length of a custom queue in a CQ list.
Use undo qos cql queue to restore the default length for a custom queue in a CQ list.
Syntax
qos cql cql-index queue queue-id queue-length queue-length
undo qos cql cql-index queue queue-id queue-length
Default
The queue length is 20 for each queue.
Views
System view
Predefined user roles
network-admin
Parameters
cql-index: Specifies a CQ list by its number in the range of 1 to 16.
queue-id: Specifies a custom queue by its ID in the range of 1 to 16.
queue-length: Specifies the maximum number of packets allowed in a custom queue, in the range of 1 to 1024.
Usage guidelines
If a queue is full, all subsequent packets to this queue are dropped.
Examples
# In CQ list 5, set the length of custom queue 4 to 40.
<Sysname> system-view
[Sysname] qos cql 5 queue 4 queue-length 40
qos cql queue serving
Use qos cql queue serving to specify the number of bytes forwarded from a queue during a cycle.
Use undo qos cql queue serving to restore the default.
Syntax
qos cql cql-index queue queue-id serving byte-count
undo qos cql cql-index queue queue-id serving
Default
The number of bytes forwarded from a queue during a cycle is 1500 bytes.
Views
System view
Predefined user roles
network-admin
Parameters
cql-index: Specifies a CQ list by its number in the range of 1 to 16.
queue-id: Specifies a custom queue by its ID in the range of 1 to 16.
byte-count: Specifies the number of bytes forwarded from a queue during a cycle of queue scheduling. The value range for the byte-count argument is 1 to 16777215 bytes.
Examples
# In CQ list 5, set the byte count to 1400 for queue 2.
<Sysname> system-view
[Sysname] qos cql 5 queue 2 serving 1400
WFQ commands
display qos queue wfq
Use display qos queue wfq to display the WFQ information for interfaces.
Syntax
display qos queue wfq interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the WFQ information for all interfaces except dialer interfaces.
Examples
# Display the WFQ information for GigabitEthernet 1/0/1.
<Sysname> display qos queue wfq interface gigabitethernet 1/0/1
Interface: GigabitEthernet1/0/1
Output queue - Urgent queuing: Size/Length/Discards 0/100/0
Output queue - Protocol queuing: Size/Length/Discards 0/500/0
Output queue - Weighted Fair queuing: Size/Length/Discards 0/64/0
Weight: IP Precedence
Queues: Active/Max active/Total 0/0/128
Table 25 Command output
Field |
Description |
Interface |
Interface name, including the interface type and interface number. |
Size |
Total number of bytes of packets in all queues. |
Length |
Number of packets allowed in each queue. |
Discards |
Number of dropped packets. |
Weight |
Weight type: · IP Precedence. · DSCP. |
Active |
Number of active WFQ queues. |
Max active |
Maximum number of active WFQ queues that was reached. |
Total |
Total number of configured WFQ queues. |
qos wfq
Use qos wfq to apply WFQ to an interface, or modify WFQ parameters.
Use undo qos wfq to restore the default.
Syntax
qos wfq [ dscp | precedence ] [ queue-number total-queue-number | queue-length max-queue-length ] *
undo qos wfq
Default
An interface uses FIFO queuing.
Views
Interface view
Predefined user roles
network-admin
Parameters
dscp: Specifies DSCP as the weight type.
precedence: Specifies IP precedence as the weight type. This is the default weight type.
queue-length max-queue-length: Specifies the maximum number of packets a queue can hold. The value range for the max-queue-length argument is 1 to 1024, and the default is 64.
queue-number total-queue-number: Specifies the total number of queues, which can be 16, 32, 64, 128, 256, 512, 1024, 2048, or 4096. The default is 256.
Usage guidelines
You must configure the rate limit for the queuing feature to take effect on the following interfaces:
· Tunnel interfaces.
· Subinterfaces.
· Layer 3 aggregate interfaces.
· HDLC link bundle interfaces.
· VT and dialer interfaces configured with PPPoE, PPPoA, or PPPoEoA.
Examples
# Apply WFQ to GigabitEthernet 1/0/1, and set the maximum queue length to 100 and the total number of queues to 512.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos wfq queue-length 100 queue-number 512
Related commands
display qos queue wfq interface
RTPQ commands
display qos queue rtpq interface
Use display qos queue rtpq interface to display the RTPQ information for interfaces.
Syntax
display qos queue rtpq interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the RTPQ information for all interfaces except VA interfaces and dialer interfaces. For information about VA interfaces, see PPP in Layer 2—WAN Access Configuration Guide.
Examples
# Display the RTPQ information for GigabitEthernet 1/0/1.
<Sysname> display qos queue rtpq interface
Interface: GigabitEthernet1/0/1
Output queue - RTP queuing: Size/Max/Outputs/Discards 0/0/0/0
Table 26 Command output
Field |
Description |
Size |
Number of packets in a queue. |
Max |
Historical maximum number of packets in the queue. |
Outputs |
Number of sent packets. |
Discards |
Number of dropped packets. |
qos rtpq
Use qos rtpq to enable RTPQ on an interface for RTP packets to specific UDP ports.
Use undo qos rtpq to restore the default.
Syntax
qos rtpq start-port first-rtp-port-number end-port last-rtp-port-number bandwidth bandwidth [ cbs committed-burst-size ]
undo qos rtpq
Default
RTPQ is disabled on an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
start-port first-rtp-port-number: Specifies the start UDP port number in the range of 2000 to 65535.
end-port last-rtp-port-number: Specifies the end UDP port number in the range of 2000 to 65535.
bandwidth bandwidth: Specifies the maximum bandwidth allowed for the RTP priority queue, in the range of 8 to 1000000 kbps.
cbs committed-burst-size: Specifies the CBS in the range of 1500 to 2000000 bytes. The default for the committed-burst-size argument is 25 x bandwidth.
Usage guidelines
You must configure the rate limit for the RTPQ feature to take effect on the following interfaces:
· Tunnel interfaces.
· Subinterfaces.
· Layer 3 aggregate interfaces.
· HDLC link bundle interfaces.
· VT and dialer interfaces configured with PPPoE, PPPoA, PPPoEoA, PPPoFR, or MPoFR.
This command provides preferential service for delay-sensitive applications, such as real-time voice traffic transmission.
Set the bandwidth argument to a value greater than the required bandwidth for real-time applications to allow bursts of traffic.
Examples
# Enable RTPQ on GigabitEthernet 1/0/1 for RTP packets with a destination UDP port number in the range of 16384 to 32767.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos rtpq start-port 16384 end-port 32767 bandwidth 64
CBQ commands
display qos queue cbq
Use display qos queue cbq to display the CBQ information for interfaces.
Syntax
display qos queue cbq interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command the CBQ information for all interfaces except VA interfaces. For information about VA interfaces, see PPP in Layer 2—WAN Access Configuration Guide.
Examples
# Display the CBQ information for all interfaces.
<Sysname> display qos queue cbq interface
Interface: GigabitEthernet1/0/1
Output queue - Urgent queuing: Size/Length/Discards 0/100/0
Output queue - Protocol queuing: Size/Length/Discards 0/500/0
Output queue - Class Based Queuing: Size/Discards 0/0
Queue Size: EF/AF/BE 0/0/0
BE Queues: Active/Max active/Total 0/0/256
AF Queues: Allocated 1
Bandwidth(kbps): Available/Max reserve 74992/75000
Table 27 Command output
Field |
Description |
Interface |
Interface name, including the interface type and interface number. |
Size |
Total number of bytes of packets in all queues. |
Length |
Number of packets allowed in each queue. |
Discards |
Number of dropped packets. |
EF |
EF queue. |
AF |
AF queue. |
BE |
BE queue. |
Active |
Number of active BE queues. |
Max active |
Maximum number of active BE queues allowed. |
Total |
Total number of BE queues. |
Available |
Available bandwidth for CBQ. |
Max reserve |
Maximum reserved bandwidth for CBQ. |
qos reserved-bandwidth
Use qos reserved-bandwidth to set the maximum reserved bandwidth as a percentage of available bandwidth on the interface.
Use undo qos reserved-bandwidth to restore the default.
Syntax
qos reserved-bandwidth pct percent
undo qos reserved-bandwidth
Default
The maximum reserved bandwidth is 80% of available bandwidth on the interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
percent: Specifies the percentage of available bandwidth to be reserved. The value range for this argument is 1 to 100.
Usage guidelines
The maximum reserved bandwidth is set on a per-interface basis. It decides the maximum bandwidth assignable for the QoS queues on an interface. It is typically set no greater than 80% of available bandwidth, considering the bandwidth for control traffic and Layer 2 frame headers.
Use the default maximum reserved bandwidth setting in most situations. If you adjust the setting, make sure the Layer 2 frame header plus the data traffic is under the maximum available bandwidth of the interface.
The maximum available bandwidth of an interface can be set by using the bandwidth command. For more information about this command, see Interface Command Reference.
If you execute the qos reserved-bandwidth pct command multiple times, the most recent configuration takes effect.
Examples
# Set the maximum reserved bandwidth to 70% of available bandwidth on GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos reserved-bandwidth pct 70
queue af
Use queue af to enable assured-forwarding (AF) and set its minimum guaranteed bandwidth.
Use undo queue af to restore the default.
Syntax
queue af bandwidth { bandwidth | pct percentage | remaining-pct remaining-percentage }
undo queue af
Default
AF is not configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
bandwidth: Specifies the bandwidth in kbps. The value range for this argument is 8 to 10000000.
pct percentage: Specifies the percentage of the available bandwidth, in the range of 1 to 100.
remaining-pct remaining-percentage: Specifies the percentage of the remaining bandwidth, in the range of 1 to 100.
Usage guidelines
To associate the traffic behavior configured with the queue af command with a class in a policy, you must follow these requirements:
· The total bandwidth assigned to AF and EF queues in a policy cannot exceed the maximum available bandwidth of the interface where the policy is applied.
· The total percentage of bandwidth assigned to AF and EF in a policy cannot exceed 100.
· The bandwidth assigned to AF and EF in a policy must use the same form, either as an absolute bandwidth value or as a percentage.
If you execute the queue af command multiple times, the most recent configuration takes effect.
Examples
# Configure AF in traffic behavior database and assign the minimum guaranteed bandwidth 200 kbps to it.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] queue af bandwidth 200
display qos queue cbq interface
traffic behavior
queue ef
Use queue ef to configure expedited forwarding (EF) and assign its maximum bandwidth.
Use undo queue ef to restore the default.
Syntax
queue ef bandwidth { bandwidth [ cbs burst ] | pct percentage [ cbs-ratio ratio ] }
undo queue ef
Default
EF is not configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
bandwidth: Specifies the bandwidth in kbps. The value range for this argument is 8 to 10000000.
cbs burst: Sets the CBS in bytes. The value range for this argument is 32 to 1000000000. The default is bandwidth × 25.
pct percentage: Specifies the percentage of the available bandwidth, in the range of 1 to 100.
cbs-ratio ratio: Sets the allowed burst ratio in the range of 25 to 500. This default is 25.
Usage guidelines
You cannot use this command in conjunction with the queue af or queue-length command in the same traffic behavior.
In a policy, the default class cannot be associated with the traffic behavior that has the queue ef command.
The total bandwidth assigned to AF and EF in a policy cannot exceed the maximum available bandwidth of the interface where the policy is applied.
The total percentage of the maximum available bandwidth assigned to AF and EF in a policy cannot exceed 100.
The bandwidths assigned to AF and EF in a policy must have the same type, bandwidth or percentage.
After the queue ef bandwidth pct percentage [ cbs-ratio ratio ] command is used, CBS equals (Interface available bandwidth × percentage × ratio)/100/1000.
After the queue ef bandwidth bandwidth [ cbs burst ] command is used, CBS equals burst. If the burst argument is not specified, CBS equals bandwidth × 25.
If you execute the queue ef command multiple times, the most recent configuration takes effect.
Examples
# Configure EF in traffic behavior database, with the maximum bandwidth as 200 kbps and CBS as 5000 bytes.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] queue ef bandwidth 200 cbs 5000
display qos queue cbq interface
traffic behavior
queue sp
Use queue sp to configure SP.
Use undo queue sp to restore the default.
Syntax
queue sp
undo queue sp
Default
SP is not configured.
Views
Traffic behavior view
Predefined user roles
network-admin
Usage guidelines
The traffic behavior configured with this command cannot be associated with the default class.
The SP queue length is a fixed value, and this value is 500 packets.
You cannot configure this command together with either of the following command combinations in one traffic behavior:
· queue af and queue-length.
· queue ef and queue-length.
Examples
# Configure SP.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] queue sp
Related commands
display qos queue cbq interface
traffic behavior
queue wfq
Use queue wfq to configure WFQ for the default class.
Use undo queue wfq to restore the default.
Syntax
queue wfq [ queue-number total-queue-number ]
undo queue wfq
Default
WFQ is not configured for the default class.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
queue-number total-queue-number: Specifies the number of fair queues, which can be 16, 32, 64, 128, 256, 512, 1024, 2048, or 4096. The default is 256.
Usage guidelines
The traffic behavior configured with this command can only be associated with the default class. This command can be used in conjunction with the queue-length or wred command in the same traffic behavior.
Examples
# Configure the default class to use WFQ with 16 queues.
<Sysname> system-view
[Sysname] traffic behavior test
[Sysname-behavior-test] queue wfq queue-number 16
[Sysname] qos policy user1
[Sysname-qospolicy-user1] classifier default-class behavior test
Related commands
display qos queue cbq interface
traffic behavior
queue-length
Use queue-length to set the queue length used for tail drop.
Use undo queue-length to restore the default.
Syntax
queue-length queue-length
undo queue-length
Default
The queue length used for tail drop is 64 packets.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
queue-length: Specifies the maximum number of packets allowed in the FIFO queue, in the range of 1 to 1024.
Usage guidelines
Before configuring this command, make sure the queue af, queue wfq, or queue ef command has been configured.
The undo queue af, undo queue wfq, or undo queue ef command deletes the queue length configured by using the queue-length command.
If you execute this command multiple times in the same traffic behavior, the most recent configuration takes effect.
Examples
# Set the maximum queue length to 16 and specify tail drop for AF.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] queue af bandwidth 200
[Sysname-behavior-database] queue-length 16
Related commands
queue af
queue wfq
queue ef
wred
Use wred to enable WRED.
Use undo wred to restore the default.
Syntax
wred [ dscp | ip-precedence ]
undo wred
Default
WRED is disabled.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
dscp: Uses the DSCP value for calculating the drop probability for a packet.
ip-precedence: Uses the IP precedence value for calculating the drop probability for a packet. This is the default.
Usage guidelines
You can configure this command only after you have configured the queue af or queue wfq command.
This command and the queue-length command are mutually exclusive in a traffic behavior. After you configure one command, the other command cannot take effect.
The undo wred command also deletes other WRED settings.
Examples
# Enable WRED in traffic behavior database and calculate the drop probabilities based on IP precedence values.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] queue wfq
[Sysname-behavior-database] wred
queue af
queue wfq
wred dscp
Use wred dscp to set the lower limit, upper limit, and drop probability denominator for packets with a DSCP value.
Use undo wred dscp to delete the settings for a DSCP value.
Syntax
wred dscp dscp-value low-limit low-limit high-limit high-limit [ discard-probability discard-prob ]
undo wred dscp dscp-value
Default
The lower limit is 10, and the upper limit is 30.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
dscp-value: Specifies a DSCP value in the range of 0 to 63. This argument can also be represented by using one of the keywords listed in Table 5.
low-limit low-limit: Specifies the lower WRED limit (in packets) in the range of 1 to 1024.
high-limit high-limit: Specifies the upper WRED limit (in packets) in the range of 1 to 1024.
discard-probability discard-prob: Specifies the denominator for drop probability calculation, in the range of 1 to 255. The default is 10.
Usage guidelines
Before configuring this command, make sure DSCP-based WRED is enabled by using the wred command.
The wred dscp command configuration is deleted when the undo wred command is executed.
Removing the queue af or queue wfq command configuration also removes the WRED-related parameters.
Examples
# Set the following parameters for packets with DSCP value 3: lower limit 20, upper limit 40, and drop probability denominator 15.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] queue wfq
[Sysname-behavior-database] wred dscp
[Sysname-behavior-database] wred dscp 3 low-limit 20 high-limit 40 discard-probability 15
queue wfq
wred
wred ip-precedence
Use wred ip-precedence to set the lower limit, upper limit, and drop probability denominator for packets with an IP precedence value.
Use undo wred ip-precedence to delete the settings for an IP precedence value.
Syntax
wred ip-precedence precedence low-limit low-limit high-limit high-limit [ discard-probability discard-prob ]
undo wred ip-precedence precedence
Default
The lower limit is 10, and the upper limit is 30.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
precedence: Specifies an IP precedence value in the range of 0 to 7.
low-limit low-limit: Specifies the lower WRED limit (in packets) in the range of 1 to 1024.
high-limit high-limit: Specifies the upper WRED limit (in packets) in the range of 1 to 1024.
discard-probability discard-prob: Specifies the denominator for drop probability calculation, in the range of 1 to 255. The default is 10.
Usage guidelines
Before configuring this command, make sure IP precedence-based WRED is enabled by using the wred command.
The wred ip-precedence command configuration is deleted when the undo wred command is executed.
Removing the queue af or queue wfq command configuration also removes the WRED-related parameters.
Examples
# Configure the following parameters for packets with IP precedence value 3: lower limit 20, upper limit 40, and drop probability denominator 15.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] queue wfq
[Sysname-behavior-database] wred ip-precedence
[Sysname-behavior-database] wred ip-precedence 3 low-limit 20 high-limit 40 discard-probability 15
queue af
queue wfq
wred
wred weighting-constant
Use wred weighting-constant to set the exponent for WRED to calculate the average queue size.
Use undo wred weighting-constant to restore the default.
Syntax
wred weighting-constant exponent
undo wred weighting-constant
Default
The exponent for WRED to calculate the average queue size is 9.
Views
Traffic behavior view
Predefined user roles
network-admin
Parameters
exponent: Specifies the exponent in the range of 1 to 16.
Usage guidelines
Before configuring this command, make sure the queue af or queue wfq command is configured and WRED is enabled by using the wred command.
The wred weighting-constant command configuration is deleted when the undo wred command is executed.
If you execute the wred weighting-constant command multiple times, the most recent configuration takes effect.
Examples
# Set the WRED exponent to calculate the average queue size to 6.
<Sysname> system-view
[Sysname] traffic behavior database
[Sysname-behavior-database] queue af bandwidth 200
[Sysname-behavior-database] wred ip-precedence
[Sysname-behavior-database] wred weighting-constant 6
Related commands
queue af
queue wfq
wred
Packet information pre-extraction commands
qos pre-classify
Use qos pre-classify to enable packet information pre-extraction on an interface.
Use undo qos pre-classify to disable packet information pre-extraction on an interface.
Syntax
qos pre-classify
undo qos pre-classify
Default
Packet information pre-extraction is disabled on an interface.
Views
Tunnel interface view
Predefined user roles
network-admin
Examples
# Enable packet information pre-extraction on Tunnel 1.
<Sysname> system-view
[Sysname] interface tunnel 1
[Sysname-Tunnel1] qos pre-classify
Congestion avoidance commands
WRED commands
display qos wred interface
Use display qos wred interface to display the WRED information for interfaces.
Syntax
display qos wred interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the WRED information for all interfaces.
Examples
# Display the WRED information for all interfaces.
<Sysname> display qos wred interface
Interface: GigabitEthernet1/0/3
Current WRED configuration:
Exponent: 9 (1/512)
Pre Low High Dis-prob Random-discard Tail-discard
------------------------------------------------------
0 10 30 10 0 0
1 10 30 10 0 0
2 10 30 10 0 0
3 10 30 10 0 0
4 10 30 10 0 0
5 10 30 10 0 0
6 10 30 10 0 0
7 10 30 10 0 0
Table 28 Command output
Field |
Description |
Interface |
Interface type and interface number. |
Exponent |
Exponent for average queue length calculation. |
Pre |
IP precedence of packets. |
DSCP |
DSCP value of packets. |
Low |
Lower limit for packets. |
High |
Higher limit for packets. |
Dis-prob |
Denominator for drop probability calculation. |
Random-discard |
Number of packets dropped by WRED. |
Tail-discard |
Number of packets dropped by tail drop. |
qos wred dscp
Use qos wred dscp to set the lower limit, upper limit, and drop probability denominator for a DSCP value.
Use undo qos wred dscp to restore the default.
Syntax
qos wred dscp dscp-value low-limit low-limit high-limit high-limit discard-probability discard-prob
undo qos wred dscp dscp-value
Default
The lower limit is 10, the upper limit is 30, and the drop probability denominator is 10.
Views
Interface view
Predefined user roles
network-admin
Parameters
dscp-value: Specifies a DSCP value in the range of 0 to 63. This argument can also be represented by using one of the keywords listed in Table 5.
low-limit low-limit: Specifies the lower WRED limit (in packets) in the range of 1 to 1024.
high-limit high-limit: Specifies the upper WRED limit (in packets) in the range of 1 to 1024.
discard-probability discard-prob: Specifies the denominator for drop probability calculation, in the range of 1 to 255.
Usage guidelines
Before configuring this command, enable DSCP-based WRED on the interface with the qos wred dscp enable command. The upper and lower limits restrict the average queue length.
Examples
# Configure the following parameters for packets with DSCP value 63 on GigabitEthernet 1/0/1: lower limit 20, upper limit 40, and drop probability denominator 15.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos wfq queue-length 100 queue-number 512
[Sysname-GigabitEthernet1/0/1] qos wred dscp enable
[Sysname-GigabitEthernet1/0/1] qos wred dscp 63 low-limit 20 high-limit 40 discard-probability 15
Related commands
display qos wred interface
qos wred enable
qos wred enable
Use qos wred enable to enable WRED on an interface.
Use undo qos wred enable to restore the default.
Syntax
qos wred [ dscp | ip-precedence ] enable
undo qos wred [ dscp | ip-precedence ] enable
Default
An interface uses tail drop.
Views
Interface view
Predefined user roles
network-admin
Parameters
dscp: Uses the DSCP values for calculating the drop probability.
ip-precedence: Uses the IP precedence for calculating the drop probability. This is the default.
Usage guidelines
For some devices, you can configure the qos wred enable command to enable WRED on the interface. For other devices, you must enable WFQ on the interface before configuring the qos wred enable command.
Examples
# Enable WRED on GigabitEthernet 1/0/1, and use the IP precedence for drop probability calculation.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos wfq queue-length 100 queue-number 512
[Sysname-GigabitEthernet1/0/1] qos wred ip-precedence enable
Related commands
display qos wred interface
qos wred ip-precedence
Use qos wred ip-precedence to set the lower limit, upper limit, and drop probability denominator for an IP precedence value.
Use undo qos wred ip-precedence to restore the default.
Syntax
qos wred ip-precedence ip-precedence low-limit low-limit high-limit high-limit discard-probability discard-prob
undo qos wred ip-precedence ip-precedence
Default
The lower limit is 10, the upper limit is 30, and the drop probability denominator is 10.
Views
Interface view
Predefined user roles
network-admin
Parameters
ip-precedence precedence: Specifies an IP precedence value in the range of 0 to 7.
low-limit low-limit: Specifies the lower WRED limit (in packets) in the range of 1 to 1024.
high-limit high-limit: Specifies the upper WRED limit (in packets) in the range of 1 to 1024.
discard-probability discard-prob: Specifies the denominator for drop probability calculation, in the range of 1 to 255.
Usage guidelines
Before configuring this command, enable IP precedence-based WRED on the interface with the qos wred enable command.
The upper and lower limits restrict the average queue length.
Examples
# Configure the following parameters for packets with IP precedence value 3 on GigabitEthernet 1/0/1: lower limit 20, upper limit 40, and drop probability denominator 15.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos wfq queue-length 100 queue-number 512
[Sysname-GigabitEthernet1/0/1] qos wred ip-precedence enable
[Sysname-GigabitEthernet1/0/1] qos wred ip-precedence 3 low-limit 20 high-limit 40 discard-probability 15
Related commands
display qos wred interface
qos wred enable
qos wred weighting-constant
Use qos wred weighting-constant to set the exponent for WRED to calculate the average queue size.
Use undo qos wred weighting-constant to restore the default.
Syntax
qos wred weighting-constant exponent
undo qos wred weighting-constant
Default
The exponent for WRED to calculate the average queue size is 9.
Views
Interface view
Predefined user roles
network-admin
Parameters
exponent: Specifies the exponent for average queue length calculation, in the range of 1 to 16.
Usage guidelines
Before configuring this command, enable WRED on the interface with the qos wred enable command.
If you execute the qos wred weighting-constant command multiple times, the most recent configuration takes effect.
Examples
# Set the exponent for the average queue size calculation to 6 on GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] qos wfq queue-length 100 queue-number 512
[Sysname-GigabitEthernet1/0/1] qos wred enable
[Sysname-GigabitEthernet1/0/1] qos wred weighting-constant 6
Related commands
display qos wred interface
qos wred enable
QPPB commands
bgp-policy
Use bgp-policy to enable QPPB, which transmits the apply ip-precedence and apply qos-local-id configuration through BGP routing policies.
Use undo bgp-policy to restore the default.
Syntax
bgp-policy { destination | source } { ip-prec-map | ip-qos-map } *
undo bgp-policy { destination | source } [ ip-prec-map | ip-qos-map ] *
Default
QPPB is disabled.
Views
Interface view
Predefined user roles
network-admin
Parameters
destination: Searches the routing table by destination IP address.
source: Searches the routing table by source IP address. If the source keyword is specified, the source IP address is used as the destination address for inverse lookup.
ip-prec-map: Sets an IP precedence value for matching packets.
ip-qos-map: Sets a local QoS ID for matching packets.
Usage guidelines
The bgp-policy command applies only to the incoming traffic of an interface.
In an MPLS L3VPN, the bgp-policy command is executed after the QoS features are performed in the inbound direction of the PE's public network interface. In any other case, the bgp-policy command is executed before the QoS features.
If you configure either of the following bgp-policy command pairs, both commands in the pair take effect:
· bgp-policy destination ip-prec-map and bgp-policy source ip-qos-map.
· bgp-policy source ip-prec-map and bgp-policy destination ip-qos-map.
If you configure either of the following bgp-policy command pairs, the command with the destination keyword in the pair takes effect:
· bgp-policy destination ip-prec-map and bgp-policy source ip-prec-map.
· bgp-policy destination ip-qos-map and bgp-policy source ip-qos-map.
Examples
# Configure GigabitEthernet 1/0/1 to get the IP precedence and local QoS ID by looking up routes based on destination IP address.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] bgp-policy destination ip-prec-map ip-qos-map
Related commands
apply ip-precedence (Layer 3—IP Routing Command Reference)
apply qos-local-id (Layer 3—IP Routing Command Reference)
route-policy (Layer 3—IP Routing Command Reference)