...
- A container runtime compatible with Kubernetes (Docker v1.13+, containerd v1.3.7+, etc.).
- Kubernetes v1.16+ (recommend Kubernetes v1.17+).
open-iscsi is installed, and the iscsid daemon is running on all the nodes. This is necessary, since LH relies on iscsiadm on the host to provide persistent volumes to Kubernetes.
Code Block language bash title Install iscsi # If not present, launch the command $ sudo yum install iscsi-initiator-utils -y
RWX support requires that each node has a NFSv4 client installed.
Code Block language bash title Install nfs-utils # If not present, launch the command $ sudo yum install nfs-utils -y
The host filesystem supports the file extents feature to store the data. Currently we support ext4 and XFS.
Code Block language bash title Filesystem type # Check that the database type is "xfs" or "ext4" $ df -T $ df -Th Filesystem Type Size Used Avail Use% Mounted on /dev/vda1 xfs 80G 5.0G 76G 7% /
- curl, findmnt, grep, awk, blkid, lsblk must be installed.
Mount propagation must be enabled.
Code Block language bash title Mount propagation # Insert the following lines into the file "/etc/systemd/system/docker.service.d/mount_propagation_flags.conf" [Service] MountFlags=shared # Then restart the service $ sudo systemctl daemon-reload $ sudo systemctl restart docker.service
A script has been written to help you gather enough information about the factors (note jq maybe required to be installed locally prior to running env check script). To run script
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
$ curl -sSfL https://raw.githubusercontent.com/longhorn/longhorn/v1.1.2/scripts/environment_check.sh | bash
daemonset.apps/longhorn-environment-check created
waiting for pods to become ready (0/3)
all pods ready (3/3)
MountPropagation is enabled!
cleaning up...
daemonset.apps "longhorn-environment-check" deleted
clean up complete |
Installation with Helm
Add the LH Helm repository and fetch the latest charts from the repository
...