User Manual Command Reference (Volume 3) Versatile Routing Platform

Table of Contents

Table of Contents
Chapter 1.1 1.2 1.3 1.4 1.5 1.6 1 Traffic Classification and Policing ...................................................................... 1-1 clear car ................................................................................................................... 1-1 rate-limit ................................................................................................................... 1-1 rate-limit-list.............................................................................................................. 1-3 show car................................................................................................................... 1-4 show rate-limit-list ..................................................................................................... 1-5 debug car ................................................................................................................. 1-5

Chapter 2 QoS Configuration Command ............................................................................. 1-7 2.1 PQ Configuration Commands .................................................................................... 1-7 2.1.1 priority-group .................................................................................................. 1-7 2.1.2 priority-list default............................................................................................ 1-8 2.1.3 priority-list interface......................................................................................... 1-9 2.1.4 priority-list protocol .......................................................................................... 1-9 2.1.5 priority-list queue-limit.................................................................................... 1-11 2.1.6 show queuing priority .................................................................................... 1-12 2.1.7 debug priority-queue...................................................................................... 1-12 2.2 CQ Configuration Commands .................................................................................. 1-12 2.2.1 custom-group................................................................................................ 1-13 2.2.2 custom-list default ......................................................................................... 1-13 2.2.3 custom-list interface ...................................................................................... 1-14 2.2.4 custom-list protocol ....................................................................................... 1-15 2.2.5 custom-list queue byte-count ......................................................................... 1-16 2.2.6 custom-list queue limit................................................................................... 1-17 2.2.7 show queuing custom.................................................................................... 1-17 2.2.8 debug custom-queue..................................................................................... 1-18 2.3 Weighted Fair Queuing Configuration....................................................................... 1-18 2.3.1 fair-queue ..................................................................................................... 1-18 2.3.2 show queueing fair ...................................................................................... 1-19 2.3.3 debug fair-queue........................................................................................... 1-19

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 1
Traffic Classification and Policing

Chapter 1 Traffic Classification and Policing

The CAR configuration commands include: l l l l l l clear car rate-limit-list rate-limit show car show rate-limit-list debug car

1.1 clear car

To delete the CAR rule, use the clear car command. clear car { all | interface type number }

Syntax Description
all Clear up the CAR statistical information on all the interfaces. type the type of the interface. number the number of the interface.

Command Mode
Privileged user mode

1.2 rate-limit
To apply the CAR rule to a certain interface, use the rate-limit command. Use the no form of this command to delete a CAR rule. rate-limit { input | output } [ access-group access-list-number | rate-limit-group rate-limit-number ] bps normal-burst-size maximum-burst-size conform-action action exceed-action action no rate-limit { input | output } [ access-group access-list-number | rate-limit-group rate-limit-number ] bps normal-burst-size maximum-burst-size conform-action action exceed-action action

Syntax Description
input Limit the speed of the input packet on an interface. output Limit the speed of the output packet on an interface.

1-1

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 1
Traffic Classification and Policing

access-group Limit the speed of the packet matching access-list-number by using access control list. rate-limit rate-limit-number Limit the speed of the packet matching rate-list-number by using CAR rule. access-limit-number the number of access control list, defined by the access-list command, ranging 1 to 199. rate-limit-number the number of CAR rule defined by the rate-limit command. When limiting the speed of input data on the input interface, the value of rate-limit-number ranges 1 to 199. (For CAR rule based on priority, it ranges 1 to 99. For CAR rule based on MAC address, it ranges 1 to 199.) When limiting the speed of output data on the output interface, the value of rate-limit-number ranges 1 to 99. Note: when neither access-group nor rate-limit is configured, it indicates that the speed of all the IP packets through the interface will be limited. bps the normal traffic, ranging 8,000 to 2,000,000,000bps. normal-burst-size the burst traffic in normal cases, ranging 8,000 to 2,000,000bps. maximum-burst-size the maximum burst traffic, ranging 8,000 to 8,000,000bps. conform-action the action taken on the packet when packet traffic conforms to the committed traffic. action the action to be taken. For the packets conforming to committed traffic, the actions to be taken include: l l l l l continue Continue to search matched rules, that is, deliver the packet to the following command rate-limit to handle. drop Drop the current packets. set-prec-continue new-prec Reset the precedence of the packet and deliver it to the following command rate-limit to handle. set-prec-transmit new-prec Reset the precedence of the packet and send it. transmit the packet can be transmitted directly.

exceed-action the action taken on the packets when the packets do not conforms to the committed traffic. action the action to be taken. For the packets conforming to committed traffic, the actions to be taken include: l l l l l continue Continue to search matched rules, that is, deliver the packet to the following command rate-limit to handle. drop Drop the current packets. set-prec-continue new-prec Reset the precedence of the packet and deliver it to the following command rate-limit to handle. set-prec-transmit new-prec Reset the precedence of the packet and send it. transmit the packet can be transmitted directly.

Default
No CAR rule applied on the interface.

1-2

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 1
Traffic Classification and Policing

Command Mode
Interface configuration mode

Usage Guideline
This command is used to handle only IP packets. Repetitive execution of this command will configure multiple CAR rules on the interface.

Related Command
rate-limit, show rate-limit-list

1.3 rate-limit-list
To specify or modify the CAR rule, use the rate-limit-list command. Use the no form of this command to delete the existing CAR rule. 1) Specify the CAR rule based on precedence. rate-limit-list precedence-rate-limit-number { precedence | mask prec-mask ] no rate-limit-list precedence-rate-limit-number { precedence | mask prec-mask ] 2) Specify the CAR rule based on MAC address. rate-limit-list macaddress-rate-limit-number mac-address conform-action action exceed-action action no rate-limit-list macaddress-rate-limit-number mac-address

Syntax Description
precedence- rate-limit-number the number of the CAR rule based on the precedence, ranging 1 to 99. macaddress- rate-limit-number the number of the CAR rule based on MAC address, ranging 100 to 199. precedence the precedence level, ranging 0 to 7. mac-address the hexadecimal MAC address in the format of xxxx.xxxx.xxxx. prec-mask the mask of the precedence, ranging 0 to FF.

Default
No CAR rules of any forms is specified.

Command Mode
Global configuration mode

Usage Guideline
pre-mask is defined as follows:
1-3

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 1
Traffic Classification and Policing

The mask of precedence 0 is 00000001. The mask of precedence 1 is 00000010. Accordingly, the mask of precedence 7 can be calculated as 10000000. If the precedence 1 and 7 is to be matched, the eventual mask is 10000010, that is, the prec-mask is 82 in hex system. For one precedence-rate-limit-number or macaddress-rate-limit-number, only one CAR rule can be defined. The subsequent CAR rule will cover the original one. But for different precedence-rate-limit-number or macaddress-rate-limit-number, two or more CAR rules can be defined.

Related Command
rate-limit show rate-limit-list

1.4 show car

To show the statistics of CAR, use the show car command. show car { all | interface type number }

Syntax Description
all Show the statistics of CAR on all the interfaces. type the type of the interface. number the number of the interface.

Command Mode
Privileged user mode

Example
Quidway# show car interface serial 0
Interface name: Serial0 <Input> Matched: rate-limit-group 1 Params: rate 8000 bps, normal burst 8000 bytes, maximum burst 8000 bytes From 2-00-00 0:00:00 to 257--50-07 8477:06:00 Conformed 0 packets, 0 bytes ; action: continue Exceeded 0 packets, 0 bytes; action: continue Matched: rate-limit-group 1 Params: rate 8000 bps, normal burst 8000 bytes, maximum burst 8000 bytes From 19-00-00 19:00:00 to 257--50-07 8477:06:00 Conformed 0 packets, 0 bytes ; action: continue Exceeded 0 packets, 0 bytes; action: drop Matched: none 0 packets, 0 bytes ; action: transmit <Output>

1-4

User Manual Command Reference (Volume 3) Versatile Routing Platform

Matched: none 0 packets, 0 bytes ; action: transmit

Chapter 1
Traffic Classification and Policing

1.5 show rate-limit-list

To show one or all the CAR rules, use the show rate-limit-list command. show rate-limit-list [ rate-list-number ]

Syntax Description
rate-list-number the number of CAR rules, ranging 1 to 199. If it is not configured, all of the CAR rules will be displayed.

Command Mode
Privileged user mode

Usage Guideline
This command is used to show one or all the CAR rules. if the specified rate-listnumber does not exit, on information will be shown.

Example
1) Show the first CAR rule. Quidway#show rate-limit-list 1
Rate-limit access list 1 mask 3D

2) Show all of the CAR rules.

Quidway# show rate-limit-list
Rate-limit access list 1 mask 3D Rate-limit access list 100 7777.9999.1111

1.6 debug car

To enable CAR debugging information output, use the debug car command. debug car { in | out }

Syntax Description
in Enable CAR debugging information output on the input interface. out Enable CAR debugging information output on the output interface.

1-5

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 1
Traffic Classification and Policing

Command Mode
Privileged user mode

1-6

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

Chapter 2 QoS Configuration Command

2.1 PQ Configuration Commands
QoS configuration commands include PQ configuration commands and CQ configuration commands. PQ (Priority Queue) configuration commands include: l l l l l l priority-list default priority-list default priority-list interface priority-list protocol priority-list queue-limit debug priority-queue

2.1.1 priority-group
To assign the specified priority list to an interface, use the priority-group command. To return to the default, so as to remove the specified priority group assignment, use the no form of this command. priority-group list-number no priority-group

Syntax Description
list-number Group number of the priority list, ranging 1 to 16.

Default
The default congestion management policy at the interfaces is FIFO

Command Mode
Interface configuration mode

Usage Guideline
The command is used only at the Ethernet interface or Serial interface (encapsulated with PPP, FR and HDLC) mode.

Example
! Apply the priority list 10 on the Ethernet 0.

2-7

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

Quidway(config-if-Ethernet0)# priority-group 10

Related Command
priority-list default, priority-list interface, priority-list protocol, priority-list queue-limit, show queuing priority, show interface, show queue interface

2.1.2 priority-list default

To assign a priority for those packets that do not match any other rule in the priority list, use the priority-list default command. To return to the default, use the no form of this command. Priority-list list-number default {high | medium | normal | low } no priority-list list-number default

Syntax Description
list-number Group number of the priority list, ranging 1 to 16. high, medium, normal and low Corresponding to the four levels of priority queue.

Default
normal

Command Mode
Global configuration mode

Usage Guideline
This command is used to configure multiple classification rules for each group in the priority list. During traffic classification, the system matches packets among the rule list. If matching a certain rule, a packet will be classified into the priority queue specified by this command; or it will enter the default priority queue.

Example
! Assign a low priority for those packets that do not match any other rule in the priority list 1. Quidway(config)# priority-list 1 default low

Related Command
priority-list interface, priority-list protocol, priority-list queue-limit, queuing priority, priority-group, show interface, show queue interface show

2-8

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

2.1.3 priority-list interface

To establish queuing priorities on packets entering from a given interface, use the priority-list interface command. To return to the default, so as to remove an entry from the list, use the no form of this command. priority-list list-number interface type number { high | medium | normal | low } no priority-list list-number interface type number {high | medium | normal | low }

Syntax Description
list-number Group number of the priority list, ranging 1 to 16. Type Interface type. number Interface number. high, medium, normal and low Corresponding to the four levels of priority queue.

Default
No queuing priorities are established

Command Mode
Global configuration mode

Usage Guideline
The system matches a packet to a rule according to the set order. When the packet matches a certain rule, the search process is completed.

Example
! Establish a medium priorities for packets entering from a interface Serial0. Quidway(config)# priority-list 1 interface serial 0 medium

Related Command
priority-list default, priority-list protocol, priority-list queue-limit, show queuing priority, priority-group, show interface, show queue interface

2.1.4 priority-list protocol

To establish queuing priorities based upon the protocol type, use the priority-list protocol command. To return to the default, so as to remove a priority list entry assigned by protocol type, use the no form of the command. priority-list list-number protocol protocol-name { high | medium | normal | low } queue-keyword keyword-value no priority-list list-number protocol protocol-name { high | medium | normal | low} queue-keyword keyword-value
2-9

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

Syntax Description
list-number Group number of the preference list. protocol-name Protocol type, which can be IP or IPX. high, medium, normal and low Corresponding to the four levels of priority queue. When the protocol-name is IPX, the values of queue-keyword and keyword-value are shown in the following table: Table QC-2-1 Values of queue-keyword and keyword-value when the protocol is IPX
queue-keyword null lt gt keyword-value null Length Length Description Any IPX packet will enter into the queue Any IPX packet whose length is less than a certain value will enter into the priority queue Any IPX packet whose length is greater than a certain value will enter into the priority queue

When the protocol-name is IP, the values of queue-keyword and keyword-value are shown in the following table: Table QC-2-2 Values of queue-keyword and keyword-value when the protocol is IP
queue-keyword null fragments list lt gt tcp udp keyword-value null null access-list-number Length Length Port number Port number Description Any IP packet will enter to the queue. Any IP packet that is a fragment will enter into the priority queue. Any IP packet that complies the access-list-number (normal) definition will enter into the priority queue Any IP packet whose length is less than a certain value will enter into the priority queue. Any IP packet whose length is greater than a certain value will enter into the priority queue. Any IP packet whose source or destination TCP port number is the specified port number will enter into the queue. Any IP packet whose source or destination UDP port number is the specified port number will enter into the priority queue.

Default
No queuing priorities are established

Command Mode
Global configuration mode

Usage Guideline
The system matches a packet to a rule according to the set order. When the packet matches a certain rule, the search process is completed.

2-10

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

Example
! Establish queuing priorities based upon the IP. Any packet that matches the accesslist 100 will enter into the high priority queue. Quidway(config)# priority-list 1 protocol ip high list 100

Related Command
priority-list default, priority-list interface, priority-list queue-limit , show queuing priority, priority-group, show interface, show queue interface

2.1.5 priority-list queue-limit

To specify the maximum number of packets that can be waiting in each of the priority queue, use the priority-list queue-limit command. To return to the default, so as to select the normal queue, use the no form of this command. priority-list list-number queue-limit [ high-limit medium-limit normal-limit low-limit ] no priority-list list-number queue-limit

Syntax Description
list-number Group number of the priority list, ranging 1 to 16. high-limit, medium-limit, normal-limit and low-limit Four length values of priority queues, ranging 0 to 32767.

Default
The default length values of the queues are shown in the following table: Table QC-2-3 Default length values of the queues
Queue High Medium Normal Low Length 20 40 60 80

Command Mode
Global configuration mode

Usage Guideline
If a queue is full, any new packet will be dropped.

Example
! Specify the maximum number of packets waiting in the priority queue 1 to 10.
2-11

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

Quidway(config)# priority-list 1 queue-limit 10 40 60 80

Related Command
priority-list default, priority-list interface, priority-list protocol, show queuing priority, priority-group, show interface, show queue interface

2.1.6 show queuing priority

To display the configured priority list, use the show queuing priority command. show queuing priority

Command Mode
Privileged user mode

Usage Guideline
This command is used to list the status of the queue. If a certain value is the same as the default value, it will not be shown.

Example
Quidway# show queuing priority
List 1 1 1 1 Queue high medium normal low Args 645 22 123 567

protocol ip

2.1.7 debug priority-queue

Open the debug information switch of priority-queue. debug priority-queue

Command Mode
Privileged user mode

2.2 CQ Configuration Commands

CQ (Customized Queue) configuration commands include: l l l custom-group custom-list default custom-list interface

2-12

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

l l l l l

custom-list protocol custom-list queue byte-count custom-list queue limit show queuing custom debug custom-queue

2.2.1 custom-group
To assign the specified custom list to an interface, use the custom-group command. To return to the default, so as to remove the specified custom group assignment, use the no form of this command. custom-group list-number no custom-group

Syntax Description
list-number Group number of the priority list, ranging 1 to 16.

Default
The default congestion management policy at the interfaces is FIFO.

Command Mode
Interface configuration mode

Usage Guideline
This command is used only at the Ethernet interface and Serial interface (encapsulated with PPP, FR and HDLC) modes.

Example
! Apply the custom list 10 on the Ethernet 0. Quidway(config-if-ethernet0)# custom-group 10

Related Command
custom-list default, custom-list interface, custom-list protocol, custom-list queue byte-count, custom-list queue limit, show queuing custom, show interface, show queue interface

2.2.2 custom-list default

To assign a queue-number for those packets that do not match any other rule in the custom list, use the custom-list default command. To return to the default custom queue number, use the no form of this command.

2-13

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

custom-list list-number default queue-number no custom-list list-number default

Syntax Description
list-number Group number of the custom list, ranging 1 to 16. queue-number Queue number, ranging 0 to 16.

Default
Custom queue number is 16.

Command Mode
Global configuration mode

Usage Guideline
This command is used to configure multiple classification rules for each group in the custom list. During traffic classification, the system matches packets along the rule link. Matching a certain rule, a packet will be classified into the priority queue specified by this rule. Not matching any rule, it will go to the default priority queue.

Example
! Assign a queue-number 1 for those packets that do not match any other rule in the custom list 1. Quidway(config)# custom-list 1 default 1

Related Command
custom-list interface, custom-list protocol, custom-list queue byte-count, custom-list queue limit, show queuing custom, custom-group

2.2.3 custom-list interface

To assign a queue-number to a interface in a specific custom list, use the custom-list interface command. To return to the default, so as to remove a specific queue-number, use the no form of the command. custom-list list-number interface type number queue-number no custom-list list-number interface type number

Syntax Description
list-number Group number of the custom list, ranging 1 to 16. queue-number Queue number, ranging 0 to 16. type Interface name.

2-14

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

number Interface number.

Default
No custom queue is assigned.

Command Mode
Global configuration mode

Usage Guideline
The system matches a packet to a rule according to the set order. When the packet matches a certain rule, the search process is completed.

Example
! Assign a custom queue-number 2 to serial 0 in custom list 1. Quidway(config)# custom-list 1 interface serial 0 2

Related Command
custom-list default, custom-list protocol, custom-list queue byte-count, custom-list queue limit, show queuing custom, custom-group, show interface, show queue interface

2.2.4 custom-list protocol

To establish queuing priorities based upon the protocol type, use the custom-list protocol command. To remove a custom list entry assigned by protocol type, use the no form of the command followed by the appropriate list-number and the protocol keyword. custom-list list-number protocol protocol-name queue-number queue-keyword keyword-value no custom-list list-number protocol protocol-name queue-number queue-keyword keyword-value

Syntax Description
list-number Group number of the custom list, ranging 1 to 16. protocol-name Protocol name, which can be ip or ipx. queue-number Queue number, ranging 0 to 16. queue-keyword keyword-value Their value are the same as those in the priority list.

Default
No custom queue is assigned.

2-15

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

Command Mode
Global configuration mode

Usage Guideline
The system matches a packet to a rule according to the set order. When the packet matches a certain rule, the search process is completed.

Example
! Establish queuing priorities based upon the IP. any packet that matches the accesslist 100 will enter into the priority queue list 3. Quidway(config)# custom-list 1 protocol ip 3 list 100

Related Command
custom-list default, custom-list interface, custom-list queue custom-list queue limit, show queuing custom, custom-group byte-count,

2.2.5 custom-list queue byte-count

To specify how many bytes the system allows to be delivered from a given queue during a particular cycle, use the custom-list queue byte-count command. To return the byte count to the default value, use the no form of the command. custom-list list-number queue queue-number byte-count byte-count-number no custom-list list-number queue queue-number byte-count

Syntax Description
list-number Group number of the custom list, ranging 1 to 16. queue-number Queue number, ranging 0 to 16. byte-count-number Lower boundary on how many bytes the system allows to be delivered from a given queue during a particular cycle, ranging 0 to 16777215 bytes.

Default
The default lower boundary on how many bytes the system allows to be delivered from a given queue during a particular cycle is 1500 bytes.

Command Mode
Global configuration mode

Example
! Specify bytes the system allowed to be delivered from a given queue 10 in the custom list 1 to 1400.

2-16

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

Quidway(config)#custom-list 1 queue 10 byte-count 1400

Related Command
custom-list default, custom-list interface, custom-list protocol, custom-list queue limit, show queuing custom, custom-group

2.2.6 custom-list queue limit

To designate the queue length limit for a queue, use the custom-list queue limit command. To return the default, use the no form of the command. custom-list list-number queue queue-number limit queue-limit no custom-list list-number queue queue-number limit

Syntax Description
list-number Group number of the custom list, ranging 1 to 16. queue-number Queue number, ranging 0 to 16. queue-limit Maximum number of packets that can be queued at any time, ranging 0 to 32767 packets.

Default
The maximum number of packets that can be queued at any time is 20 packets.

Command Mode
Global configuration mode

Usage Guideline
If a queue is full, any new packet will be dropped.

Example
! Specify the length of queue 10 in custom list 1 to 40. Quidway(config)# custom-list 1 queue 10 limit 40

Related Command
custom-list default, custom-list interface, custom-list protocol, custom-list queue byte-count, show queuing custom, custom-group,

2.2.7 show queuing custom

To list all the content of the custom list, use the show queuing custom command. show queuing custom
2-17

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

Command Mode
Privileged user mode

Usage Guideline
If it is a default value, it will not be shown.

Example
! show queuing custom Quidway# show queuing custom
Current custom-queue-list configuration: List efault Queue Args

2.2.8 debug custom-queue

Open the debug information switch of customized-queue debug priority queue

Command Mode
Privileged user

2.3 Weighted Fair Queuing Configuration

Weighted Fair Queuing Configuration commands include: l l l fair-queue show queueing fair debug fair-queue

2.3.1 fair-queue
To configure the weighted fair queue, use the fair-queue command. Use the no form of this command to restore the default congestion management policy. fair-queue [ discard-threshold [ dynamic-queue-count ] ] no fair-queue

Syntax Description
discard-threshold the maximum number of the packets in the queue. The packets exceeding the number will be dropped. The value ranges 1 to 4096. discard-threshold the total number of the queue. The value can be 16, 32, 64, 128, 256, 512, 1024, 2048 and 4096.

2-18

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

Default
The default congestion management policy is FIFO. The default value of discard-threshold is 64. The default value of dynamic-queue-count is 256.

Command Mode
Interface configuration mode

Usage Guideline
This command can be used to enable non-WFQ interface to apply WFQ policy and specify the WFQ commands at the same time. When the interface adopts WFQ interface, this command can be used to modify WFQ parameters.

Related Command
show queueing fair

2.3.2 show queueing fair

Show the configuration of weighted fair queue. show queueing fair

Command Mode
Privileged user

Usage Guideline
Show the application of WFQ on all the interfaces, and the parameters of WFQ.

Example
Quidway# show queueing fair
Current fair queue configuration: Interface Serial0 Discard threshold 64 Dynamic queue count 256

2.3.3 debug fair-queue

Enabling the information debugging of the weighted fair queue debug fair-queue

2-19

User Manual Command Reference (Volume 3) Versatile Routing Platform

Chapter 2
QoS Configuration Command

Command Mode
Privileged user

Usage Guideline
Use this command to enable or disable the information debugging of WFQ.

2-20