Jiva User Guide

For details of how Jiva works, see Jiva overview page

Jiva is a light weight storage engine that is recommended to use for low capacity workloads. The snapshot and storage management features of the other cStor engine are more advanced and is recommended when snapshots are a need.

Prerequisites

1. Kubernetes version 1.18 or higher.
2. iSCSI initiator utils installed on all the worker nodes

(Click here to view commands to install iSCSI on different OS)

OPERATING SYSTEM	iSCSI PACKAGE	Commands to install iSCSI	Verify iSCSI Status
RHEL/CentOSRHEL/CentOS	iscsi-initiator-utils	sudo yum install iscsi-initiator-utils -y sudo systemctl enable --now iscsid modprobe iscsi_tcp echo iscsi_tcp >/etc/modules-load.d/iscsi-tcp.conf sudo systemctl status iscsid.service	sudo systemctl status iscsid.service
Ununtu/ Debian	open-iscsi	sudo apt install open-iscsi sudo systemctl enable --now iscsid modprobe iscsi_tcp echo iscsi_tcp >/etc/modules-load.d/iscsi-tcp.conf	sudo systemctl status iscsid.service
RancherOS	open-iscsi	sudo ros s enable open-iscsi sudo ros s up open-iscsi	ros service list iscsi

3. Access to install RBAC components into kube-system namespace. 4. OpenEBS localpv-hostpath version 2.6.0 or higher. ``` kubectl apply -f https://openebs.github.io/charts/hostpath-operator.yaml ``` Sample hostpath storage class ``` #Sample storage classes for OpenEBS Local PV apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: openebs-hostpath annotations: openebs.io/cas-type: local cas.openebs.io/config: | # hostpath type will create a PV by # creating a sub-directory under the # BASEPATH provided below. - name: StorageType value: "hostpath" # Specify the location (directory) where # where PV(volume) data will be saved. # A sub-directory with pv-name will be # created. When the volume is deleted, # the PV sub-directory will be deleted. #Default value is /var/openebs/local - name: BasePath value: "/var/openebs/local/" provisioner: openebs.io/local volumeBindingMode: WaitForFirstConsumer reclaimPolicy: Delete ```

See Also:

Understanding Jiva