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
OS | Kernel | Prerequisite |
---|---|---|
rhel8.1 | 4.18.0-147.el8.x86_64 | modprobe nvme-tcp |
rhel8.2 | 4.18.0-193.el8.x86_64 | modprobe nvme-tcp |
rhel8.3 | 4.18.0-240.el8.x86_64 | modprobe nvme-tcp |
rhel8.4 | 4.18.0-305.el8.x86_64 | modprobe nvme-tcp |
rhel8.5 | 4.18.0-348.23.1.el8_5.x86_64 | modprobe nvme-tcp |
rhel8.6 | 4.18.0-372.9.1.el8.x86_64 | modprobe nvme-tcp |
rhel8.7 | 4.18.0-425.19.2.el8_7.x86_64 | modprobe nvme-tcp |
rhel8.8 | 4.18.0-477.10.1.el8_8.x86_64 | modprobe nvme-tcp |
rhel9.1 | 5.14.0-162.18.1.el9_1.x86_64 | modprobe nvme-tcp |
rhel9.2 | 5.14.0-284.11.1.el9_2.x86_64 | modprobe nvme-tcp |
CentOS Linux 8.5.2111 | 4.18.0-348.7.1.el8_5.x86_64 | modprobe nvme-tcp |
CentOS Stream release 8 | 4.18.0-408.el8.x86_64 | modprobe nvme-tcp |
CentOS Stream release 9 | 5.14.0-229.el9.x86_64 | modprobe nvme-tcp |
Ubuntu 18.04.6 LTS | 5.4.0-1101-aws | apt install linux-modules-extra-$(uname -r) modprobe nvme-tcp |
Ubuntu 20.04.6 LTS | 5.15.0-1036-aws | apt install linux-modules-extra-$(uname -r) modprobe nvme-tcp |
Ubuntu 22.04.2 LTS | 5.19.0-1025-aws | apt install linux-modules-extra-$(uname -r) modprobe nvme-tcp |
Debian 11 (bullseye) | 5.10.0-23-cloud-amd64 | modprobe nvme-tcp |
Debian 12 (bookworm) | 6.1.0-10-cloud-amd64 | modprobe nvme-tcp |
Amazon Linux 2 | Kernel 5.10 AMI 2.0.20230822.0 | modprobe nvme-tcp |
Amazon Linux 2023 | 2023.1.20230825.0 x86_64 HVM kernel-6.1 | modprobe nvme-tcp |
⚠️
There is a NVMe multipath bug on Amazon Linux 2, therefore, NVMe multipathing currently does not work on Amazon Linux 2.