132. QoS Metering Tests¶

The QoS meter sample application is an example that demonstrates the use of DPDK to provide QoS marking and metering, as defined by RFC2697 for Single Rate Three Color Marker (srTCM) and RFC 2698 for Two Rate Three Color Marker (trTCM) algorithm.

The detailed description of the application items and mode can be found in https://doc.dpdk.org/guides/sample_app_ug/qos_metering.html

132.1. Prerequisites¶

The DUT must have two 10G Ethernet ports connected to two ports of IXIA.

Assume two DUT 10G Ethernet ports’ pci device id is as the following,

dut_port_0 : “0000:05:00.0” dut_port_1 : “0000:05:00.1”

Compile DPDK and sample

Bind two ports to dpdk igb_uio driver:

./usertools/dpdk-devbind.py -b igb_uio 05:00.0 05:00.1

The default metering mode is defined in dpdk/examples/qos_meter/main.c:
```
#define APP_MODE        APP_MODE_SRTCM_COLOR_BLIND
```
The input color of packets depends on the value “APP_PKT_COLOR_POS”, which is defined in dpdk/examples/qos_meter/main.c too:
```
#define APP_PKT_COLOR_POS               5
```
The change will descripted in each case.

The policy table is defined in dpdk/examples/qos_meter/main.h:

policer_table[RTE_COLORS][RTE_COLORS] =
{
    { GREEN, RED, RED},
    { DROP, YELLOW, RED},
    { DROP, DROP, RED}
};

In which:

GREEN = 0; YELLOW = 1; RED = 2; DROP = 3.

So the policy action is decided by input_color and output_color.

The application is constrained to use a single core in the EAL core mask and 2 ports only in the application port mask (first port from the port mask is used for RX and the other port in the core mask is used for TX):
```
./<build_target>/examples/dpdk-qos_meter -c 1 -n 4 -- -p 0x3
```

132.4. Test Case: srTCM aware input color RED¶

The input color of packets depends on the value “APP_PKT_COLOR_POS”. Set:
```
#define APP_PKT_COLOR_POS               5
```
Caculate the input_color is “RED”.
Use the default setting, the packets are 64 bytes Ethernet frames, and the metering mode is srTCM aware:
```
#define APP_MODE        APP_MODE_SRTCM_COLOR_AWARE
```
In Color-Aware mode, if the input color is red, then output color is red too. See the RFC 2697 file. The linerate is 14.88Mpps, all packets output_color are marked red, mapping the policer_table[2][2](RED). So the valid frames received on the peer IXIA port is 14.88(Mpps).

132.6. Test Case: trTCM aware mode¶

The input color of packets depends on the value “APP_PKT_COLOR_POS”. Set:
```
#define APP_PKT_COLOR_POS               5
```
Caculate the input_color is “RED”.
Use the default setting, the packets are 64 bytes Ethernet frames, and the metering mode is trTCM aware:
```
#define APP_MODE        APP_MODE_TRTCM_COLOR_AWARE
```
See the RFC 2698 file. If the packet has been precolored as red or if Tp(t)-B < 0, the packet is red, So all packets output_color are marked Red. Mapping the policer_table[2][2](RED). So the valid frames received on the peer IXIA port is 14.88(Mpps).
If Set:
```
#define APP_PKT_COLOR_POS               4
```
Caculate the input_color is “YELLOW”. If the packet has been precolored as yellow or if Tc(t)-B < 0, the packet is yellow and Tp is decremented by B So all packets output_color are marked yellow. Mapping the policer_table[2][2](YELLOW). The valid frames received on the peer IXIA port is 14.88(Mpps).
If Set:
```
#define APP_PKT_COLOR_POS               3
```
Caculate the input_color is “GREEN”. See the RFC 2698 file, all packets output_color are marked green. The valid frames received on the peer IXIA port is 14.88(Mpps).

Mode	Green (Mpps)	Yellow (Mpps)	Red (Mpps)
srTCM blind	1 \| 1		12.88
srTCM color	1 \| 1		12.88
trTCM blind	1 \| 0.5		13.38
trTCM color	1 \| 0.5		13.38
FWD	14.88 \| 0		0

132. QoS Metering Tests¶

132.1. Prerequisites¶

132.2. Test Case: srTCM blind input color RED¶

132.3. Test Case: srTCM blind input color GREEN¶

132.4. Test Case: srTCM aware input color RED¶

132.5. Test Case: trTCM blind mode¶

132.6. Test Case: trTCM aware mode¶

132.7. Test Case: srTCM blind changed CBS and EBS¶