Chapter 3. Creating OpenShift Container Storage cluster

Use this procedure to create an OpenShift Container Storage cluster after you install the OpenShift Container Storage operator.

Prerequisites

Procedure

  1. Log in to the OpenShift Web Console.
  2. Click Operators → Installed Operators to view all the installed operators.

    Ensure that the Project selected is openshift-storage.

  3. Click OpenShift Container StorageCreate Instance link of Storage Cluster.
  4. Select mode as Internal-Attached devices.

    You are prompted to install the Local Storage Operator if it is not already installed. Click Install and follow the procedure as described in Installing Local Storage Operator.

    You can create a dedicated storage class to consume storage by filtering a set of storage volumes.

  5. Discover disks

    1. Choose Select nodes option to select the labeled nodes with attached storage device(s) from data-center zones.

      If the nodes to be selected are tainted and not discovered in the wizard, follow the steps provided in the Red Hat Knowledgebase Solution as a workaround to add tolerations for Local Storage Operator resources.

      If the nodes selected do not match the OpenShift Container Storage cluster requirement of an aggregated 30 CPUs and 72 GiB of RAM, a minimal cluster will be deployed. For minimum starting node requirements, see Resource requirements section in Planning guide.

    2. Click Next.
  6. Create Storage class

    1. Enter the Local Volume Set Name.
    2. Enter the Storage Class Name. By default, the volume set name appears for the storage class name. You can also change the name.
    3. The nodes selected for disk discovery in the previous step are displayed in the Filter Disks By section.

      Choose one of the following:

      • Disks on all nodes to select all the nodes for which you discovered the devices.
      • Disks on selected nodes to select a subset of the nodes for which you discovered the devices. Spread the worker nodes across three different physical nodes, racks or failure domains for high availability.
    4. Select SSD or NVMe to build a supported configuration. You can select HDDs for unsupported test installations.
    5. Expand the Advanced section and set the following options:

      Volume Mode

      Block is selected by default.

      Device Type

      Select disk types. By default, Disk and Part are selected.

      Disk Size

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

      Note

      You must set a minimum size of 100GB for the device.

      Maximum 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.

    6. Click Next. A pop-up to confirm creation of the new storage class is displayed.
    7. Click Yes to continue.
  7. Set Capacity and nodes

    1. Select Enable arbiter checkbox if you want to use the stretch clusters.

      • Select the arbiter zone from the available drop down list.
    2. Select Storage Class. By default, the new storage class created in the previous step is selected.
    3. Selected Nodes shows the nodes selected in the previous step. This list takes a few minutes to display the disks that were discovered in the previous step.

      Note

      Check the zone label for each of the nodes displayed in the selected nodes section to verify that they are correctly labeled.

    4. Click Next.
  8. (Optional) Set Security and network configuration

    1. Select the Enable encryption checkbox to encrypt block and file storage.
    2. Choose any one or both Encryption level:

      • Cluster-wide encryption to encrypt the entire cluster (block and file).
      • Storage class encryption to create encrypted persistent volume (block only) using encryption enabled storage class.
    3. Select the Connect to an external key management service checkbox. This is optional for cluster-wide encryption.

      1. Key Management Service Provider is set to Vault by default.
      2. Enter Vault Service Name, host Address of Vault server ('https://<hostname or ip>'), Port number and Token.
      3. Expand Advanced Settings to enter additional settings and certificate details based on your Vault configuration:

        1. Enter the Key Value secret path in Backend Path that is dedicated and unique to OpenShift Container Storage.
        2. (Optional) Enter TLS Server Name and Vault Enterprise Namespace.
        3. Provide CA Certificate, Client Certificate and Client Private Key by uploading the respective PEM encoded certificate file.
        4. Click Save.
    4. Select Default (SDN) if you are using a single network or Custom (Multus) Network if you plan on using multiple network interfaces.

      1. Select a Public Network Interface from drop down.
      2. Select a Cluster Network Interface from drop down.
    5. Click Next.
  9. Review the configuration details. To modify any configuration settings, click Back to go back to the previous configuration page.
  10. Click Create.

Verification steps

  1. Verify that the final Status of the installed storage cluster shows as Phase: Ready with a green tick mark.

    1. Click OperatorsInstalled OperatorsStorage Cluster link to view the storage cluster installation status.
    2. Alternatively, when you are on the Operator Details tab, you can click on the Storage Cluster tab to view the status.
  2. Click ocs-storagecluster in the Storage Cluster tab.

    1. In the YAML tab, search for the arbiter key in the spec section and check the following:

      • 'enable' is set to true,
      • 'arbiterLocation' is set arbiter,
      • 'replica' is set to 4
      • 'failureDomain' is set to zone.

        spec:
            arbiter:
              enable: true
            [..]
            nodeTopologies:
              arbiterLocation: arbiter
                [..]
              replica: 4
        status:
            conditions:
            [..]
            failureDomain: zone
            [..]
  3. To verify that all components for OpenShift Container Storage are successfully installed, see Verifying your OpenShift Container Storage installation.