Intel® Ethernet 800 Series Linux Flow Control

Configuration Guide for RDMA Use Cases

ID 635330
Date 07/13/2023
Version 1.3
Document Table of Contents
Document Table of Contents
Notices and Disclaimers Revision History Introduction Background Link-Level Flow Control Priority Flow Control - Fundamentals Congestion Management – Tuning Parameters Priority Flow Control - Planning and Guidelines Priority Flow Control - Verification Troubleshooting
Notices and Disclaimers
Revision History
Introduction
Introduction QoS/Flow Control Limitations on the 800 Series
QoS/Flow Control Limitations on the 800 Series
Background
Ethernet Flow Control Flow Control in RDMA Networks Types of Flow Control: LFC vs. PFC
Ethernet Flow Control
Flow Control in RDMA Networks
Types of Flow Control: LFC vs. PFC
Link-Level Flow Control
LFC Setup Instructions Symmetric vs. Asymmetric LFC
LFC Setup Instructions
Symmetric vs. Asymmetric LFC
Priority Flow Control - Fundamentals
Priority Flow Control - Fundamentals DCB Standards Determining PFC Priority Mode: PCP vs. DSCP Assigning an Application to a Traffic Class
DCB Standards
DCB Standards DCB Willing vs. Non-willing Modes
DCB Willing vs. Non-willing Modes
Determining PFC Priority Mode: PCP vs. DSCP
Assigning an Application to a Traffic Class
Assigning an Application to a Traffic Class Mapping Steps Details
Mapping Steps Details
Step 1: Determine Flow Control Design Needed Step 2: Kernel Priority (sk_prio) or DSCP to UP Mapping Step 3: UP to TC Step 4: Set ToS in the Application (or for All RoCEv2 Traffic)
Step 1: Determine Flow Control Design Needed
Step 2: Kernel Priority (sk_prio) or DSCP to UP Mapping
Step 3: UP to TC
Step 4: Set ToS in the Application (or for All RoCEv2 Traffic)
Congestion Management – Tuning Parameters
Overview DCQCN Congestion Control Parameter Settings
Overview
DCQCN
DCQCN DCQCN Specification
DCQCN Specification
Congestion Control Parameter Settings
Priority Flow Control - Planning and Guidelines
Priority Flow Control - Planning and Guidelines Steps Example Configurations
Steps
Steps Network Host and Switch Setup Willing vs. Non-willing DCB Mode Firmware vs. Software DCB Software DCB Willing Mode Separating and Prioritizing Traffic Streams Configuring ETS: Map Priorities to TCs/Allocate Bandwidth Configuring PFC Run Applications with the Right Priority
Network Host and Switch Setup
Willing vs. Non-willing DCB Mode
Firmware vs. Software DCB
Software DCB Willing Mode
Separating and Prioritizing Traffic Streams
Configuring ETS: Map Priorities to TCs/Allocate Bandwidth
Configuring PFC
Configuring PFC Option A: PCP PFC - Set Priorities for Drop or No-drop Option B: DSCP PFC
Option A: PCP PFC - Set Priorities for Drop or No-drop
Option B: DSCP PFC
Run Applications with the Right Priority
Example Configurations
Example 1 - 800 Series-800 Series Back-to-Back – PCP PFC with Single TC Example 2 - Adapters Connected Through a Switch – Willing Mode on Adapters, DCB Configured on Switch Example 3 - DSCP PFC with Non-Default TCs - Non-Willing Mode on Adapters, ECN Configured Example 4 - PCP PFC with Multiple TCs (1 for RDMA, 1 for LAN) – No VLANs Example 5 - PCP PFC with Multiple TCs (1 for RDMA, 1 for LAN) – with VLANs
Example 1 - 800 Series-800 Series Back-to-Back – PCP PFC with Single TC
Example 2 - Adapters Connected Through a Switch – Willing Mode on Adapters, DCB Configured on Switch
Example 3 - DSCP PFC with Non-Default TCs - Non-Willing Mode on Adapters, ECN Configured
Example 4 - PCP PFC with Multiple TCs (1 for RDMA, 1 for LAN) – No VLANs
Example 5 - PCP PFC with Multiple TCs (1 for RDMA, 1 for LAN) – with VLANs
Priority Flow Control - Verification
Priority Counters Discard Counters tpcdump
Priority Counters
Discard Counters
Discard Counters LAN Packet Drops RDMA Discards
LAN Packet Drops
RDMA Discards
tpcdump
Troubleshooting
Notices and Disclaimers
Revision History
Introduction
Background
Link-Level Flow Control
Priority Flow Control - Fundamentals
Congestion Management – Tuning Parameters
Priority Flow Control - Planning and Guidelines
Priority Flow Control - Verification
Troubleshooting

Step 3: UP to TC

The ETS aspect of DCB is used to configure UP to TC mapping as a table per port.

Option A: PCP/VLAN PFC: UP to TC Mapping

ETS has a up2tc option, configurable on Linux using the lldptool utility.

For example, this command assigns packets marked with prio=2 to TC1, packets with prio=0 to TC2, and all other packet priorities to TC0.

# lldptool -T -i eth0 -V ETS-CFG up2tc=0:2,1:0,2:1,3:0,4:0,5:0,6:0,7:0

Option B: DCSP Based PFC: UP to TC Mapping

In the case of the E800 Series Adapter implementation of DSCP, UP has a one to one mapping to TC. This means that an UP value of 0 is mapped to TC 0, an UP value of 1 is mapped to TC 1, and so on.

Linux traffic shaping utilities like tc or cgroups do not work for RDMA applications because RDMA applications bypass the kernel. If running a combination of LAN and RDMA traffic, you can still use Linux traffic shaping for LAN traffic, but you must use the PCP or DSCP based mappings described in this section for RDMA traffic.

Step 4: Set ToS in the Application (or for All RoCEv2 Traffic)