Linux

Linux

To manually connect storage to Linux-based hosts, the following steps are required:

Load Kernel Module

sudo modprobe nvme-tcp

Install nvme-cli Package

If this package is not installed, perform installation, e.g. on RHEL, CentOs and Rocky use:

sudo yum install nvme-cli

To create the connect string, run the following cmd on one of management nodes, copy-paste it and run it on your host:

sbcli lvol connect <UUID>

Verify it is connected with lsblk.

ℹ️
If the lvol is of HA type, NVMe multipath will be configured automatically and the volume will be connected to three cluster nodes instead of one.

Compatibility Matrix

OSKernelPrerequisite
rhel8.14.18.0-147.el8.x86_64modprobe nvme-tcp
rhel8.24.18.0-193.el8.x86_64modprobe nvme-tcp
rhel8.34.18.0-240.el8.x86_64modprobe nvme-tcp
rhel8.44.18.0-305.el8.x86_64modprobe nvme-tcp
rhel8.54.18.0-348.23.1.el8_5.x86_64modprobe nvme-tcp
rhel8.64.18.0-372.9.1.el8.x86_64modprobe nvme-tcp
rhel8.74.18.0-425.19.2.el8_7.x86_64modprobe nvme-tcp
rhel8.84.18.0-477.10.1.el8_8.x86_64modprobe nvme-tcp
rhel9.15.14.0-162.18.1.el9_1.x86_64modprobe nvme-tcp
rhel9.25.14.0-284.11.1.el9_2.x86_64modprobe nvme-tcp
CentOS Linux 8.5.21114.18.0-348.7.1.el8_5.x86_64modprobe nvme-tcp
CentOS Stream release 84.18.0-408.el8.x86_64modprobe nvme-tcp
CentOS Stream release 95.14.0-229.el9.x86_64modprobe nvme-tcp
Ubuntu 18.04.6 LTS5.4.0-1101-awsapt install linux-modules-extra-$(uname -r) modprobe nvme-tcp
Ubuntu 20.04.6 LTS5.15.0-1036-awsapt install linux-modules-extra-$(uname -r) modprobe nvme-tcp
Ubuntu 22.04.2 LTS5.19.0-1025-awsapt install linux-modules-extra-$(uname -r) modprobe nvme-tcp
Debian 11 (bullseye)5.10.0-23-cloud-amd64modprobe nvme-tcp
Debian 12 (bookworm)6.1.0-10-cloud-amd64modprobe nvme-tcp
Amazon Linux 2Kernel 5.10 AMI 2.0.20230822.0modprobe nvme-tcp
Amazon Linux 20232023.1.20230825.0 x86_64 HVM kernel-6.1modprobe nvme-tcp
⚠️
There is a NVMe multipath bug on Amazon Linux 2, therefore, NVMe multipathing currently does not work on Amazon Linux 2.