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