Mayastor Installation on MicroK8s

This website/page will be End-of-life (EOL) after 31 August 2024. We recommend you to visit OpenEBS Documentation for the latest Mayastor documentation (v2.6 and above).

Mayastor is now also referred to as OpenEBS Replicated PV Mayastor.

Install Mayastor on MicroK8s

Prerequisite: Prepare a cluster by following the steps outlined in this guide.

To install Mayastor using Helm on MicroK8s, execute the following command:

Command

helm install mayastor mayastor/mayastor -n mayastor --create-namespace  --set csi.node.kubeletDir="/var/snap/microk8s/common/var/lib/kubelet"

Output

NAME: mayastor
LAST DEPLOYED: Thu Sep 22 18:59:56 2022
NAMESPACE: mayastor
STATUS: deployed
REVISION: 1
NOTES:
OpenEBS Mayastor has been installed. Check its status by running:
$ kubectl get pods -n mayastor
For more information or to view the documentation, visit our website at https://openebs.io.

Resolve Known Issue (Calico Vxlan)

During the installation of Mayastor in MicroK8s, Pods with hostnetwork might encounter a known issue where they get stuck in the init state due to the Calico Vxlan bug.

Expected error:

Resolution:

To resolve this error, execute the following command:

Command

microk8s kubectl patch felixconfigurations default --patch '{"spec":{"featureDetectOverride":"ChecksumOffloadBroken=true"}}' --type=merge

For more details about this issue, refer to the GitHub issue.

For further configuration of Mayastor including storage pools, storage class, persistent volume claims, and application setup, refer to the offical documentation.