Chapter 4. Configuring RoCE
Chapter 4. Configuring RoCE Remote Direct Memory Access (RDMA) over Converged Ethernet (RoCE) is a network protocol that utilizes RDMA over an Ethernet network. For configuration, RoCE requires specific hardware and some of the hardware vendors are Mellanox, Broadcom, and QLogic. 4.1. Overview of RoCE protocol versions The following are the different RoCE versions: RoCE v1 The RoCE version 1 protocol is an Ethernet link layer protocol with Ethertype 0x8915 that enables the communication between any two hosts in the same Ethernet broadcast domain. RoCE v2 The RoCE version 2 protocol exists on the top of either the UDP over IPv4 or the UDP over IPv6 protocol. For RoCE v2, the UDP destination port number is 4791 . The RDMA_CM sets up a reliable connection between a client and a server for transferring data. RDMA_CM provides an RDMA transport-neutral interface for establishing connections. The communication uses a specific RDMA device and message-based data transfers. Important Using different versions like RoCE v2 on the client and RoCE v1 on the server is not supported. In such a case, configure both the server and client to communicate over RoCE v1. RoCE v1 works at the Data Link layer (Layer 2) and only supports the communication of two machines in the same network. By default, RoCE v2 is available. It works at the Network Layer (Layer 3). RoCE v2 supports packet routing that provides a connection with multiple Ethernet. 4.2. Temporarily changing the default RoCE version Using the RoCE v2 protocol on the client and RoCE v1 on the server is not supported. If the hardware in your server supports RoCE v1 only, configure your clients for RoCE v1 to communicate with the server. For example, you can configure a client that uses the mlx5_0 driver for the Mellanox ConnectX-5 InfiniBand device that only supports RoCE v1. Note The changes described here will remain effective until you reboot the host. Prerequisites The client uses an InfiniBand device with RoCE v2 protocol. The server uses an InfiniBand device that only supports RoCE v1. Procedure Create the /sys/kernel/config/rdma_cm/ mlx5_0 / directory: Display the default RoCE mode: Change the default RoCE mode to version 1: 4.3. Configuring Soft-RoCE Soft-RoCE is a software implementation of remote direct memory access (RDMA) over Ethernet, which is also called RXE. Use Soft-RoCE on hosts without RoCE host channel adapters (HCA). Important The Soft-RoCE feature is deprecated and will be removed in RHEL 10. Soft-RoCE is provided as a Technology Preview only. Technology Preview features are not supported with Red Hat production Service Level Agreements (SLAs), might not be functionally complete, and Red Hat does not recommend using them for production. These previews provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process. See Technology Preview Features Support Scope on the Red Hat Customer Portal for information about the support scope for Technology Preview features. Prerequisites An Ethernet adapter is installed Procedure Install the iproute , libibverbs , libibverbs-utils , and infiniband-diags packages: Display the RDMA links: Add a new rxe device named rxe0 that uses the enp0s1 interface: Verification View the state of all RDMA links: List the available RDMA devices: You can use the ibstat utility to display a detailed status:
mkdir /sys/kernel/config/rdma_cm/ mlx5_0 / cat /sys/kernel/config/rdma_cm/ mlx5_0 /ports/ 1 /default_roce_mode RoCE v2 echo "IB/RoCE v1" > /sys/kernel/config/rdma_cm/ mlx5_0 /ports/ 1 /default_roce_mode dnf install iproute libibverbs libibverbs-utils infiniband-diags rdma link show rdma link add rxe0 type rxe netdev enp1s0 rdma link show link rxe0/1 state ACTIVE physical_state LINK_UP netdev enp1s0 ibv_devices device node GUID ------ ---------------- rxe0 505400fffed5e0fb ibstat rxe0 CA 'rxe0' CA type: Number of ports: 1 Firmware version: Hardware version: Node GUID: 0x505400fffed5e0fb System image GUID: 0x0000000000000000 Port 1: State: Active Physical state: LinkUp Rate: 100 Base lid: 0 LMC: 0 SM lid: 0 Capability mask: 0x00890000 Port GUID: 0x505400fffed5e0fb Link layer: Ethernet