Chapter 1. Deploying using local storage devices

Deploying OpenShift Container Storage on OpenShift Container Platform using local storage devices provided by IBM Power Systems enables you to create internal cluster resources. This approach internally provisions base services. Then, all applications can access additional storage classes.

Note

Only internal Openshift Container Storage clusters are supported on IBM Power Systems. See Planning your deployment for more information about deployment requirements.

1.1. Requirements for installing OpenShift Container Storage using local storage devices

  • The cluster must consist of at least three OpenShift Container Platform worker nodes in the cluster with locally attached storage devices on each of them.

    • Each of the three selected nodes must have at least one raw block device available to be used by OpenShift Container Storage.
    • The devices to be used must be empty, that is, there should be no persistent volumes (PVs), volume groups (VGs), or local volumes (LVs) remaining on the disks.
  • You must have a minimum of three labeled nodes.

    • Each node that has local storage devices to be used by OpenShift Container Storage must have a specific label to deploy OpenShift Container Storage pods. To label the nodes, use the following command:

      $ oc label nodes <NodeNames> cluster.ocs.openshift.io/openshift-storage=''

Minimum starting node requirements

See Resource requirements section in Planning guide.

Requirements for upgrading local storage devices

  • You must upgrade to the OpenShift Container Platform 4.7 before deploying OpenShift Container Storage 4.7. For information, see Updating OpenShift Container Platform clusters guide.
  • The Local Storage Operator version must match the Red Hat OpenShift Container Platform version in order to have the Local Storage Operator fully supported with Red Hat OpenShift Container Storage. Upgrading Red Hat OpenShift Container Platform does not upgrade the Local Storage Operator.

1.2. Installing Red Hat OpenShift Container Storage Operator

You can install Red Hat OpenShift Container Storage Operator using the Red Hat OpenShift Container Platform Operator Hub. For information about the hardware and software requirements, see Planning your deployment.

Prerequisites

  • Access to an OpenShift Container Platform cluster using an account with cluster-admin and Operator installation permissions.
  • You must have at least three worker nodes in the RHOCP cluster.
Note

When you need to override the cluster-wide default node selector for OpenShift Container Storage, you can use the following command in command line interface to specify a blank node selector for the openshift-storage namespace:

$ oc annotate namespace openshift-storage openshift.io/node-selector=

Procedure

  1. Navigate in the left pane of the OpenShift Web Console to click Operators → OperatorHub .

    Figure 1.1. List of operators in the Operator Hub

    Screenshot of list of operators in the Operator Hub of the OpenShift Web Console.
  2. Click on OpenShift Container Storage.

    You can use the Filter by keyword text box or the filter list to search for OpenShift Container Storage from the list of operators.

  3. Click Install on the OpenShift Container Storage operator page.

    Figure 1.2. Install Operator page

    Screenshot of OCS Install Operator page.

    After Clicking on Install button, following page will appear.

    Screenshot of Install Operator page.
  4. On the Install Operator page, the following options are selected by default:

    1. Update Channel as stable-4.7
    2. Installation Mode as A specific namespace on the cluster
    3. Installed Namespace as Operator recommended namespace openshift-storage. If Namespace openshift-storage does not exist, it will be created during the operator installation.
    4. Select Approval Strategy as Automatic or Manual.
    5. Click Install.

      If you selected Automatic updates, then the Operator Lifecycle Manager (OLM) automatically upgrades the running instance of your Operator without human intervention. If you selected Manual updates, then the OLM creates an update request. As a cluster administrator, you must then manually approve that update request to have the Operator updated to the new version.

Verification steps

  1. Verify that OpenShift Container Storage Operator shows a green tick indicating successful installation.
  2. Click View Installed Operators in namespace openshift-storage link to verify that OpenShift Container Storage Operator shows the Status as Succeeded on the Installed Operators dashboard.

    Figure 1.3. Installed Operators dashboard

    Screenshot of the installed operators.

1.3. Installing Local Storage Operator

Use this procedure to install the Local Storage Operator from the Operator Hub before creating OpenShift Container Storage clusters on local storage devices.

Procedure

  1. Click Operators → OperatorHub in the left pane of the OpenShift Web Console.
  2. Search for Local Storage Operator from the list of operators and click on it.
  3. Click Install.

    Figure 1.4. Install Operator page

    Screenshot of Install Local storage Operator page.

    After Clicking on Install button, following page will appear.

    Screenshot of Install Operator page.
  4. Set the following options on the Install Operator page:

    1. Update Channel as stable-4.7
    2. Installation Mode as A specific namespace on the cluster
    3. Installed Namespace as Operator recommended namespace openshift-local-storage.
    4. Approval Strategy as Automatic
  5. Click Install.

    Figure 1.5. Installed Operators dashboard

    Screenshot of the installed operators.

Verification steps

  • Verify that the Local Storage Operator shows the Status as Succeeded.

1.4. Creating OpenShift Container Storage cluster on IBM Power Systems

Prerequisites

  • Ensure that all the requirements in the Requirements for installing OpenShift Container Storage using local storage devices section are met.
  • You must have a minimum of three worker nodes with the same storage type and size attached to each node (for example, 200 GB SSD) to use local storage devices on IBM Power Systems.
  • Verify your OpenShift Container Platform worker nodes are labeled for OpenShift Container Storage:

    oc get nodes -l cluster.ocs.openshift.io/openshift-storage -o jsonpath='{range .items[*]}{.metadata.name}{"\n"}'

Procedure

  1. Log into the OpenShift Web Console.
  2. In openshift-local-storage namespace Click OperatorsInstalled Operators from the left pane of the OpenShift Web Console to view the installed operators.

    Figure 1.6. Local Storage Operator page

    Screenshot of Local Storage operator dashboard.
    1. Click the Local Storage installed operator.
    2. On the Operator Details page, click the Local Volume Set link.

      Figure 1.7. Local Volume Set tab

      Screenshot of Local Volume Set tab on Local Storage Operator dashboard.
  3. Click Create Local Volume Set.

    Screenshot of Create Local Volume Set.
    1. Enter the Volume Set name. By default, Storage Class name appears for the Volume Set name.
    2. To discover available disks, you can choose one of the following:

      • All nodes to discover disks in all the nodes.
      • Select nodes to choose a subset of nodes from a list of nodes

        To find specific worker nodes in the cluster, you can filter nodes on the basis of Name or Label. Name allows you to search by name of the node and Label allows you to search by selecting the predefined label.

    3. Select the Disk type. The following options are available:

      All

      Selects all types of disks present on the nodes. By default, this option is selected.

      SSD/NVME

      Selects only SSD NVME type of disks.

      HDD

      Selects only HDD type of disks.

    4. In the Advanced section, you can set the following:

      Volume Mode

      Block is selected by default.

      Disk Size

      Minimum and maximum avaialable size of the device that needs to be included.

      Note

      Choose the minimum disk size equivalent to the size of additional attached disk.

      Max Disk Limit

      This indicates the maximum number of PVs that can be created on a node. If this field is left empty, then PVs are created for all the available disks on the matching nodes.

    5. Click Create.

      The Create button is enabled only after you select a minimum of three nodes. Local Volume Set is created with one volume per worker node with the available disks.

  4. In openshift-storage namespace Click OperatorsInstalled Operators from the left pane of the OpenShift Web Console to view the installed operators.

    Figure 1.8. OpenShift Container Storage Operator page

    Screenshot of OpenShift Container Storage operator dashboard.
    1. Click the OpenShift Container Storage installed operator.
    2. On the Operator Details page, click the Storage Cluster link.

      Figure 1.9. Storage Cluster tab

      Screenshot of Storage Cluster tab on OpenShift Container Storage Operator dashboard.
  5. Click Create Storage Cluster.

    Screenshot of Create Cluster Service page
  6. Select Internal-Attached devices for the Select Mode.

    Screenshot of storage cluster creation
    1. Select the required storage class.
    2. The nodes corresponding to the storage class are displayed based on the storage class that you selected from the drop down.
    3. Click Next.
  7. Again Click Next and then you will be redirected to Review and Create page.

    1. Review the configurations details. To modify any configuration settings, click Back to go back to the previous configuration page.

      Screenshot of Configuration Review
  8. Click Create.

Additional resources

To expand the capacity of the initial cluster, see the Scaling Storage guide.