Configuring RDMA

You can configure RDMA either before creating the storage cluster or after it already exists, but it is recommended to enable it when no cluster is present. In this case, the RDMA setting is saved and automatically applied during cluster creation or when nodes join later.

If a cluster is already active, changing the RDMA setting updates all nodes. Online nodes are reconfigured immediately, and offline nodes are updated once they come back online.

If a node is removed from the cluster, its RDMA configuration is cleared to prevent issues when it joins again.

Limitations

You cannot perform other storage cluster modifications while changing the RDMA configuration.

Prerequisites

You have checked the RDMA network by following the instructions in Checking the RDMA network.

To configure RDMA before creating the storage cluster

Admin panel

Use the Enable RDMA toggle switch on the Settings > System settings > Storage performance screen.

Command-line interface

Use the following command:

vinfra cses-config change (--enable | --disable)

--enable: Enable RDMA
--disable: Disable RDMA

For example, to enable RDMA for the storage cluster, run:

# vinfra cses-config change --enable

You can check that the setting has been applied by running vinfra cses-config show:

# vinfra cses-config show
+-------+-------+
| Field | Value |
+-------+-------+
| rdma  | True  |
+-------+-------+

To configure RDMA with the existing storage cluster

Use the following command:

vinfra cses-config change (--enable | --disable) --force

--enable: Enable RDMA
--disable: Disable RDMA
--force: Enable/disable RDMA even if a cluster exists

For example, to enable RDMA with the existing storage cluster, run:

# vinfra cses-config change --enable --force

You can check that the setting has been applied by running vinfra cses-config show:

# vinfra cses-config show
+-------+-------+
| Field | Value |
+-------+-------+
| rdma  | True  |
+-------+-------+

To disable RDMA, run:

# vinfra cses-config change --disable --force