Installing, Uninstalling, and Upgrading the Container Storage Interface (CSI) Storage Plugin

This section describes the steps for installing, uninstalling, and upgrading the Container Storage Interface (CSI) Storage Plugin.

About this task

By default, the CSI Driver includes Red Hat Universal Base Image as the base image for FUSE (v1.2.0 or higher) and Loopback NFS (1.0.0 or higher) CSI drivers. If you want to customize the installation, you can build your own container with a FUSE-based POSIX supported OS. See Building Your Own Container for more information.

Installing the CSI Driver

Procedure

  1. Download and install the CSI Driver custom resource definition on the Kubernetes cluster by running the following command: 
    kubectl create -f csi-maprkdf-v<version>.yaml
    where <version> is the driver version being installed.
    FUSE
    kubectl create -f csi-maprkdf-v<version>.yaml
    Loopback NFS
    kubectl create -f csi-maprnfskdf-v<version>.yaml
    When you run the command to install the CSI Driver, the service accounts, rule-based access controls (RBAC), and the statefulset and daemonset are created on the pods on the Kubernetes cluster.
  2. Verify the installation by running the following command. 
    kubectl get pods --all-namespaces -o wide

What to do next

After installing, you can use the CSI Driver to statically and dynamically provision and mount a Data Fabric volume. See Using the Container Storage Interface (CSI) Storage Plugin for more information.

Uninstalling the CSI Driver

Procedure

To uninstall the CSI driver, run the following command: 
kubectl delete -f csi-maprkdf-v<version>.yaml
where <version> is the driver version being installed.
FUSE
kubectl delete -f csi-maprkdf-v<version>.yaml
Loopback NFS
kubectl delete -f csi-maprnfskdf-v<version>.yaml
When you run the command to uninstall, all the pods with the mount provisioned by CSI Driver are removed.

Upgrading the CSI Driver

About this task

Online upgrades for the CSI driver are not currently supported. To perform an offline upgrade, use the following steps:

Procedure

  1. Shut down all application pods that have a persistent volume mounted in the HPE Data Fabric.
  2. Reapply the new CSI driver .yaml, and wait for Kubernetes to restart all the CSI pods: 
    kubectl apply -f csi-maprkdf-<version>.yaml
  3. Restart application pods.