Install and setup

This user guide will help you to configure Jiva and use Jiva Volumes for running your stateful workloads.

Installing Jiva

• To install the latest Jiva release, execute:

  kubectl apply -f https://openebs.github.io/charts/jiva-operator.yaml

• Next, verify that the Jiva operator and CSI pods are running on your cluster. To get the status of the pods execute:

  kubectl get pod -n openebs

  Sample Output:

  NAME READY STATUS RESTARTS AGE

  jiva-operator-7765cbfffd-vt787 1/1 Running 0 10s

  openebs-localpv-provisioner-57b44f4664-klsrw 1/1 Running 0 118s

  openebs-jiva-csi-controller-0 4/4 Running 0 6m14s

  openebs-jiva-csi-node-56t5g 2/2 Running 0 6m13s

  openebs-jiva-csi-node-xtyhu 2/2 Running 0 6m20s

  openebs-jiva-csi-node-h2unk 2/2 Running 0 6m20s

Provisioning Jiva volumes

• The Jiva volume policies need to be defined before creation of a Jiva volume. Given below is a sample Jiva volume policy CR.
  apiVersion: openebs.io/v1alpha1

  kind: JivaVolumePolicy

  metadata:

  name: example-jivavolumepolicy

  namespace: openebs

  spec:

  replicaSC: openebs-hostpath

  target:

  # This sets the number of replicas for high-availability

  # replication factor <= no. of (CSI) nodes

  replicationFactor: 3

  # disableMonitor: false

  # auxResources:

  # tolerations:

  # resources:

  # affinity:

  # nodeSelector:

  # priorityClassName:

  # replica:

  # tolerations:

  # resources:

  # affinity:

  # nodeSelector:

  # priorityClassName:

note

By default, the volume data is stored at /var/openebs/<pvc-*> on the worker nodes, to change this behavior, a new replicaSC needs to be created.

Creating storage classes

A storage class specifying the above JivaVolumePolicy needs to be created. This will be used to dynamically provision Jiva volumes.

apiVersion: storage.k8s.io/v1

kind: StorageClass

metadata:

name: openebs-jiva-csi-sc

provisioner: jiva.csi.openebs.io

allowVolumeExpansion: true

parameters:

cas-type: "jiva"

policy: "example-jivavolumepolicy"