25. Fortville Granularity Configuration of RSS and 32-bit GRE key Tests¶

25.1. Description¶

This document provides test plan for testing the function of Fortville:

Support granularity configuration of RSS

By default Fortville uses hash input set preloaded from NVM image which includes all fields IPv4/v6+TCP/UDP port. Potential problem for this is global configuration per device and can affect all ports. It is required that hash input set can be configurable, such as using IPv4 only or IPv6 only or IPv4/v6+TCP/UDP.
support 32-bit GRE keys

By default Fortville extracts only 24 bits of GRE key to FieldVector (NVGRE use case) but for Telco use cases full 32-bit GRE key is needed. It is required that both 24-bit and 32-bit keys for GRE should be supported. the test plan is to test the API to switch between 24-bit and 32-bit keys

25.1.1. Prerequisites¶

Hardware:
- 1x Fortville_eagle NIC (4x 10G)
- 1x Fortville_spirit NIC (2x 40G)
- 2x Fortville_spirit_single NIC (1x 40G)
Software:
- dpdk: http://dpdk.org/git/dpdk
- scapy: http://www.secdev.org/projects/scapy/
Bind one port to DPDK driver:
```
./usertools/dpdk-devbind.py -b igb_uio 05:00.0
```
Suppose the MAC address of the port is “00:00:00:00:01:00”.

25.2. Test Case 1: test with flow type ipv4-tcp¶

config testpmd on DUT

set up testpmd with Fortville NICs:

./testpmd -c 0x1ffff -n 4 -- -i --coremask=0x1fffe --portmask=0x1 --rxq=16 --txq=16 --tx-offloads=0x8fff

Reta Configuration(optional, if not set, will use default):

testpmd> port config 0 rss reta (hash_index,queue_id)

PMD fwd only receive the packets:
```
testpmd> set fwd rxonly
```
rss received package type configuration:
```
testpmd> port config all rss tcp
```

set hash function:

testpmd>set_hash_global_config 0 toeplitz ipv4-tcp enable

verbose configuration:
```
testpmd> set verbose 8
```
start packet receive:
```
testpmd> start
```

using scapy to send packets with ipv4-tcp on tester:

sendp([Ether(dst="00:00:00:00:01:00")/IP(src="192.168.0.1", dst="192.168.0.2")/TCP(sport=1024,dport=1025)], iface=tester_itf)

then got hash value and queue value that output from the testpmd on DUT.

set hash input set to “none” by testpmd on dut:
```
testpmd> set_hash_input_set 0 ipv4-tcp none select
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the values should be different from the values in step 2.
set hash input set by testpmd on dut, enable src-ipv4 & dst-ipv4:
```
testpmd> set_hash_input_set 0 ipv4-tcp src-ipv4 add
testpmd> set_hash_input_set 0 ipv4-tcp dst-ipv4 add
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the values should be different from the values in step 2.
set hash input set by testpmd on dut, enable src-ipv4, dst-ipv4, tcp-src-port, tcp-dst-port:
```
testpmd> set_hash_input_set 0 ipv4-tcp tcp-src-port add
testpmd> set_hash_input_set 0 ipv4-tcp tcp-dst-port add
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the values should be different with the values from step 3 & step 4, should be same as step 2.
set hash input set by testpmd on dut, enable tcp-src-port, tcp-dst-port:
```
testpmd> set_hash_input_set 0 ipv4-tcp none select
testpmd> set_hash_input_set 0 ipv4-tcp tcp-src-port add
testpmd> set_hash_input_set 0 ipv4-tcp tcp-dst-port add
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the values should be should be different with the values from step2 & step 3 & step 4 & step 5.

So it can be approved that with flow type ipv4-tcp, rss hash can be calculated by only included IPv4 fields or only included TCP fields or both IPv4+TCP fields.

25.3. Test Case 2: test with flow type ipv4-udp¶

config testpmd on DUT

set up testpmd with Fortville NICs:

./testpmd -c 0x1ffff -n 4 -- -i --coremask=0x1fffe --portmask=0x1 --rxq=16 --txq=16 --tx-offloads=0x8fff

Reta Configuration(optional, if not set, will use default):

testpmd> port config 0 rss reta (hash_index,queue_id)

PMD fwd only receive the packets:
```
testpmd> set fwd rxonly
```
rss received package type configuration:
```
testpmd> port config all rss udp
```

set hash function:

testpmd>set_hash_global_config 0 toeplitz ipv4-udp enable

verbose configuration:
```
testpmd> set verbose 8
```
start packet receive:
```
testpmd> start
```

using scapy to send packets with ipv4-udp on tester:

sendp([Ether(dst="00:00:00:00:01:00")/IP(src="192.168.0.1", dst="192.168.0.2")/UDP(sport=1024,dport=1025)], iface=tester_itf))

then got hash value and queue value that output from the testpmd on DUT.

set hash input set to “none” by testpmd on dut:
```
testpmd> set_hash_input_set 0 ipv4-udp none select
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the values should be different from the values in step 2.
set hash input set by testpmd on dut, enable src-ipv4 and dst-ipv4:
```
testpmd> set_hash_input_set 0 ipv4-udp src-ipv4 add
testpmd> set_hash_input_set 0 ipv4-udp dst-ipv4 add
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the values should be different from the values in step 2 & step 3.
set hash input set by testpmd on dut, enable src-ipv4, dst-ipv4, udp-src-port, udp-dst-port:
```
testpmd> set_hash_input_set 0 ipv4-udp udp-src-port add
testpmd> set_hash_input_set 0 ipv4-udp udp-dst-port add
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the values should be should be different with the values from step 3 & step 4, should be same as step 2.
set hash input set by testpmd on dut, enable udp-src-port, udp-dst-port:
```
testpmd> set_hash_input_set 0 ipv4-udp none select
testpmd> set_hash_input_set 0 ipv4-udp udp-src-port add
testpmd> set_hash_input_set 0 ipv4-udp udp-dst-port add
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the values should be should be different with the values from step2 & step 3 & step 4 & step 5.

So it can be approved that with flow type ipv4-udp, rss hash can be calculated by only included IPv4 fields or only included UDP fields or both IPv4+UDP fields.

25.4. Test Case 3: test with flow type ipv6-tcp¶

test method is same as Test Case 1, but it need change all ipv4 to ipv6, and using scapy to send packets with ipv6-tcp on tester:

sendp([Ether(dst="00:00:00:00:01:00")/IPv6(src="3ffe:2501:200:1fff::1", dst="3ffe:2501:200:3::2")/TCP(sport=1024,dport=1025)], iface=tester_itf)

and the test result should be same as Test Case 1.

25.5. Test Case 4: test with flow type ipv6-udp¶

test method is same as Test Case 2, but it need change all ipv4 to ipv6, and using scapy to send packets with ipv6-udp on tester:

sendp([Ether(dst="00:00:00:00:01:00")/IPv6(src="3ffe:2501:200:1fff::1", dst="3ffe:2501:200:3::2")/UDP(sport=1024,dport=1025)], iface=tester_itf)

and the test result should be same as Test Case 2.

25.6. Test Case 5: test dual vlan(QinQ)¶

config testpmd on DUT

set up testpmd with Fortville NICs:

./testpmd -c 0x1ffff -n 4 -- -i --coremask=0x1fffe --portmask=0x1 --rxq=16 --txq=16 --tx-offloads=0x8fff

set qinq on:
```
testpmd> vlan set qinq on <port_id>
```

Reta Configuration(optional, if not set, will use default):

testpmd> port config 0 rss reta (hash_index,queue_id)

PMD fwd only receive the packets:
```
testpmd> set fwd rxonly
```
verbose configuration:
```
testpmd> set verbose 8
```
start packet receive:
```
testpmd> start
```
rss received package type configuration:
```
testpmd> port config all rss ether
```

using scapy to send packets with dual vlan (QinQ) on tester:
```
sendp([Ether(dst="00:00:00:00:01:00")/Dot1Q(id=0x8100,vlan=1)/Dot1Q(id=0x8100,vlan=2)], iface=tester_itf)
```
then got hash value and queue value that output from the testpmd on DUT.
set hash input set to “none” by testpmd on dut:
```
testpmd> set_hash_input_set 0 l2_payload none select
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the value should be same with the values in step 2.
set hash input set by testpmd on dut, enable ovlan field:
```
testpmd> set_hash_input_set 0 l2_payload ovlan add
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the value should be different with the values in step 2.
set hash input set by testpmd on dut, enable ovlan, ivlan field:
```
testpmd> set_hash_input_set 0 l2_payload ivlan add
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the value should be different with the values in step 2 & step 4.

25.7. Test Case 6: 32-bit GRE keys and 24-bit GRE keys test¶

config testpmd on DUT

set up testpmd with Fortville NICs:

./testpmd -c 0x1ffff -n 4 -- -i --coremask=0x1fffe --portmask=0x1 --rxq=16 --txq=16 --tx-offloads=0x8fff

Reta Configuration(optional, if not set, will use default):

testpmd> port config 0 rss reta (hash_index,queue_id)

PMD fwd only receive the packets:
```
testpmd> set fwd rxonly
```
rss received package type configuration:
```
testpmd> port config all rss all
```

set hash function:

testpmd>set_hash_global_config 0 toeplitz ipv4-other enable

verbose configuration:
```
testpmd> set verbose 8
```
start packet receive:
```
testpmd> start
```

using scapy to send packets with GRE header on tester:

sendp([Ether(dst="00:00:00:00:01:00")/IP(src="192.168.0.1",dst="192.168.0.2",proto=47)/GRE(key_present=1,proto=2048,key=67108863)/IP()], iface=tester_itf)

then got hash value and queue value that output from the testpmd on DUT.

set hash input set to “none” by testpmd on dut:
```
testpmd> set_hash_input_set 0 ipv4-other none select
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the value should be different with the values in step 2.
set hash input set by testpmd on dut, enable src-ipv4, dst-ipv4:
```
testpmd> set_hash_input_set 0 ipv4-other src-ipv4 add
testpmd> set_hash_input_set 0 ipv4-other dst-ipv4 add
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the value should be same with the values in step 2.
set hash input set and gre-key-len=3 by testpmd on dut, enable gre-key:
```
testpmd> global_config 0 gre-key-len 3
testpmd> set_hash_input_set 0 ipv4-other gre-key add
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the values should be different with the values in step 2 & step3.
set gre-key-len=4 by testpmd on dut, enable gre-key:
```
testpmd> global_config 0 gre-key-len 4
```
send packet as step 2, got hash value and queue value that output from the testpmd on DUT, the values should be different with the values in step 2 & step3 & step 5.

So with gre-key-len=3 (24bit gre key) or gre-key-len=4 (32bit gre key), different rss hash value and queue value can be got, it can be proved that 32bit & 24bit gre key are supported by Fortville.