Htb
The following scenario shows how to configure a HTB qdisc.
Test HTB QDisc
Description
In this scenario, a Hierarchy Token Bucket (HTB) qdisc is configured in DUT0 (‘eth0’ interface) to achieve linksharing among a hierarchy of classes. Three classes are created with different matches (filters). Each match is allocated to a single class and evaluated in order.
Scenario
Step 1: Set the following configuration in DUT0:
set interfaces ethernet eth0 address 10.0.0.2/24 set interfaces ethernet eth0 traffic control out QDISC set traffic control QDISC type htb bandwidth 100 set traffic control QDISC type htb class 1 bandwidth percentage 50 set traffic control QDISC type htb class 1 ceiling percentage 100 set traffic control QDISC type htb class 2 bandwidth percentage 20 set traffic control QDISC type htb class 2 ceiling percentage 0 set traffic control QDISC type htb class 3 bandwidth percentage 10 set traffic control QDISC type htb class 3 ceiling percentage 0 set traffic control QDISC type htb match 1 class 1 set traffic control QDISC type htb match 1 ip destination port 8080 set traffic control QDISC type htb match 2 class 2 set traffic control QDISC type htb match 2 ip protocol tcp set traffic control QDISC type htb default-class 3
Step 2: Set the following configuration in DUT1:
set interfaces ethernet eth0 address 10.0.0.1/24
Step 3: Ping IP address 10.0.0.1 from DUT0:
admin@DUT0$ ping 10.0.0.1 count 1 size 56 timeout 1Show output
PING 10.0.0.1 (10.0.0.1) 56(84) bytes of data. 64 bytes from 10.0.0.1: icmp_seq=1 ttl=64 time=0.703 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.703/0.703/0.703/0.000 ms
Step 4: Initiate a bandwidth test from DUT0 to DUT1
admin@DUT1$ monitor test performance server port 8080 admin@DUT0$ monitor test performance client 10.0.0.1 duration 5 port 8080Expect this output in
DUT0:Connecting to host 10.0.0.1, port 8080 [ 5] local 10.0.0.2 port 39210 connected to 10.0.0.1 port 8080 [ ID] Interval Transfer Bitrate Retr Cwnd [ 5] 0.00-1.00 sec 14.5 MBytes 121 Mbits/sec 0 303 KBytes [ 5] 1.00-2.00 sec 11.2 MBytes 94.4 Mbits/sec 0 303 KBytes [ 5] 2.00-3.00 sec 10.8 MBytes 90.2 Mbits/sec 1 386 KBytes [ 5] 3.00-4.00 sec 11.3 MBytes 94.9 Mbits/sec 0 386 KBytes [ 5] 4.00-5.00 sec 11.3 MBytes 94.9 Mbits/sec 0 386 KBytes - - - - - - - - - - - - - - - - - - - - - - - - - [ ID] Interval Transfer Bitrate Retr [ 5] 0.00-5.00 sec 59.1 MBytes 99.2 Mbits/sec 1 sender [ 5] 0.00-5.00 sec 57.1 MBytes 95.8 Mbits/sec receiver iperf Done.
Step 5: Initiate a bandwidth test from DUT0 to DUT1
admin@DUT1$ monitor test performance server port 1234 admin@DUT0$ monitor test performance client 10.0.0.1 duration 5 port 1234Expect this output in
DUT0:Connecting to host 10.0.0.1, port 1234 [ 5] local 10.0.0.2 port 43430 connected to 10.0.0.1 port 1234 [ ID] Interval Transfer Bitrate Retr Cwnd [ 5] 0.00-1.00 sec 2.60 MBytes 21.8 Mbits/sec 9 28.3 KBytes [ 5] 1.00-2.00 sec 2.24 MBytes 18.8 Mbits/sec 0 32.5 KBytes [ 5] 2.00-3.00 sec 2.24 MBytes 18.8 Mbits/sec 0 32.5 KBytes [ 5] 3.00-4.00 sec 2.36 MBytes 19.8 Mbits/sec 0 33.9 KBytes [ 5] 4.00-5.00 sec 2.24 MBytes 18.8 Mbits/sec 0 33.9 KBytes - - - - - - - - - - - - - - - - - - - - - - - - - [ ID] Interval Transfer Bitrate Retr [ 5] 0.00-5.00 sec 11.7 MBytes 19.6 Mbits/sec 9 sender [ 5] 0.00-5.00 sec 11.4 MBytes 19.1 Mbits/sec receiver iperf Done.
Step 6: Run command traffic control show at DUT0 and check if output contains the following tokens:
class 1 class 2 class 3 (default)Show output
Traffic control for interface 'eth0' - 'egress' mode ------------------------------------------------------------------------------------ ID traffic control type parent bytes sent pkts sent pkts dropped ------------------------------------------------------------------------------------ 1:0 QDISC htb root 75278247 49769 2 1:1 QDISC class 1 1:0 62756260 41471 0 1:2 QDISC class 2 1:0 12521131 8290 0 1:3 QDISC class 3 (default) 1:0 856 8 0 2:0 - fq_codel 1:1 62756260 41471 0 3:0 - fq_codel 1:2 12521131 8290 2 4:0 - fq_codel 1:3 856 8 0
Attention
The previous command output should include packets for the different
HTB classes. If not, obtaining debugging information may prove usuful.
This can be achieved by setting the following configuration commands:
set traffic control <NAME> type htb match 1 log <PREFIX> or
set traffic policy <NAME> rule 1 log prefix <PREFIX>.
After generating some traffic, the system journal monitor command
can be used to review log messages.