Installing the driver using CLIs

The operator for IBM block storage CSI driver can be installed directly from GitHub from a command line terminal. Installing the CSI (Container Storage Interface) driver is part of the operator installation process.

Use the following steps to install the operator and driver, using GitHub through a command line terminal.

1. Download the manifest from GitHub.

   For Red Hat OpenShift users with IBM Z or PowerPC architecture

   curl -L https://github.com/IBM/ibm-block-csi-operator/releases/download/v1.2.0/ibm-block-csi-operator-non-x86.yaml > ibm-block-csi-operator.yaml

   For all other users

   curl https://raw.githubusercontent.com/IBM/ibm-block-csi-operator/master/deploy/installer/generated/ibm-block-csi-operator.yaml > ibm-block-csi-operator.yaml

2. (Optional): If required, update the image fields in the ibm-block-csi-operator.yaml.

   Note: Updating the namespace to a user-defined namespace may be necessary in order to ensure consistency and avoid trouble installing the operator.

3. Use the kubectl create ns <namespace> command to create a project namespace.
4. Install the operator, while using a user-defined namespace.

   $ kubectl -n <namespace> apply -f ibm-block-csi-operator.yaml

5. Verify the operator running. (Make sure the Status is Running.)

   $ kubectl get pod -l app.kubernetes.io/name=ibm-block-csi-operator -n <namespace>
   NAME                                    READY   STATUS    RESTARTS   AGE
   ibm-block-csi-operator-5bb7996b86-xntss 1/1     Running   0          10m

6. Install the IBM block storage CSI driver by creating an IBMBlockCSI custom resource.
   1. Download the manifest from GitHub.

      For Red Hat OpenShift users with IBM Z or PowerPC architecture

      curl -L https://github.com/IBM/ibm-block-csi-operator/releases/download/v1.2.0/csi.ibm.com_v1.2_ibmblockcsi_cr_ocp.yaml > csi.ibm.com_v1_ibmblockcsi_cr.yaml

      For all other users

      curl https://raw.githubusercontent.com/IBM/ibm-block-csi-operator/master/deploy/crds/csi.ibm.com_v1_ibmblockcsi_cr.yaml > csi.ibm.com_v1_ibmblockcsi_cr.yaml

   2. (Optional): If required, update the image repository and/or tag fields in the csi.ibm.com_v1_ibmblockcsi_cr.yaml.

      Note: Updating the namespace to a user-defined namespace may be necessary in order to ensure consistency and avoid trouble installing the operator.

   3. Install the csi.ibm.com_v1_ibmblockcsi_cr.yaml.

      $ kubectl -n <namespace> apply -f csi.ibm.com_v1_ibmblockcsi_cr.yaml