Deployment Guide
Making open source more inclusive
I. Planning
Expand section "I. Planning" Collapse section "I. Planning"
1. 1. Identify your Workloads
2. 2. Identify your Use Case
  Expand section "2. Identify your Use Case" Collapse section "2. Identify your Use Case"
  1. 2.1. Converged Mode
  2. 2.2. Independent mode
3. 3. Verify Prerequisites
  Expand section "3. Verify Prerequisites" Collapse section "3. Verify Prerequisites"
  1. 3.1. Converged mode
    
    Expand section "3.1. Converged mode" Collapse section "3.1. Converged mode"
    
    3.1.1. Supported Versions
    
    3.1.2. Environment Requirements
    
    Expand section "3.1.2. Environment Requirements" Collapse section "3.1.2. Environment Requirements"
    
    3.1.2.1. Installing Red Hat Openshift Container Storage with OpenShift Container Platform on Red Hat Enterprise Linux 7
    
    Expand section "3.1.2.1. Installing Red Hat Openshift Container Storage with OpenShift Container Platform on Red Hat Enterprise Linux 7" Collapse section "3.1.2.1. Installing Red Hat Openshift Container Storage with OpenShift Container Platform on Red Hat Enterprise Linux 7"
    
    3.1.2.1.1. Setting up the Openshift Master as the Client
    
    3.1.2.2. OpenShift Container Platform Options
    
    3.1.3. Red Hat OpenShift Container Platform and Red Hat Openshift Container Storage Requirements
    
    3.1.4. Deployment and Scaling Guidelines
  2. 3.2. Independent mode
    
    Expand section "3.2. Independent mode" Collapse section "3.2. Independent mode"
    
    3.2.1. Supported Versions
    
    3.2.2. Environment Requirements
    
    Expand section "3.2.2. Environment Requirements" Collapse section "3.2.2. Environment Requirements"
    
    3.2.2.1. Installing Red Hat Openshift Container Storage with OpenShift Container Platform on Red Hat Enterprise Linux 7
    
    Expand section "3.2.2.1. Installing Red Hat Openshift Container Storage with OpenShift Container Platform on Red Hat Enterprise Linux 7" Collapse section "3.2.2.1. Installing Red Hat Openshift Container Storage with OpenShift Container Platform on Red Hat Enterprise Linux 7"
    
    3.2.2.1.1. Setting up the Openshift Master as the Client
    
    3.2.2.2. OpenShift Container Platform Options
    
    3.2.3. Red Hat OpenShift Container Platform and Red Hat Openshift Container Storage Requirements
    
    3.2.4. Red Hat Gluster Storage Requirements
    
    3.2.5. Deployment and Scaling Guidelines
II. Deploy
Expand section "II. Deploy" Collapse section "II. Deploy"
1. 4. Deploying Containerized Storage in Converged Mode
  Expand section "4. Deploying Containerized Storage in Converged Mode" Collapse section "4. Deploying Containerized Storage in Converged Mode"
  1. 4.1. Specify Advanced Installer Variables
  2. 4.2. Deploying Red Hat Openshift Container Storage in Converged Mode
  3. 4.3. Deploying Red Hat Openshift Container Storage in Converged Mode with Registry
  4. 4.4. Deploying Red Hat Openshift Container Storage in Converged Mode with Logging and Metrics
  5. 4.5. Deploying Red Hat Openshift Container Storage in Converged mode for Applications with Registry, Logging, and Metrics
  6. 4.6. Single OCS cluster installation
  7. 4.7. Configure Heketi to Place Bricks Across Zones
  8. 4.8. Verify your Deployment
  9. 4.9. Creating an Arbiter Volume (optional)
    
    Expand section "4.9. Creating an Arbiter Volume (optional)" Collapse section "4.9. Creating an Arbiter Volume (optional)"
    
    4.9.1. Creating an Arbiter Volume
    
    Expand section "4.9.1. Creating an Arbiter Volume" Collapse section "4.9.1. Creating an Arbiter Volume"
    
    4.9.1.1. Creating an Arbiter Volume using Heketi CLI
    
    4.9.1.2. Creating an Arbiter Volume using the Storageclass file
    
    4.9.2. Creating Block Hosting Volume as an Arbiter Volume
2. 5. Deploying Container Storage in Independent Mode
  Expand section "5. Deploying Container Storage in Independent Mode" Collapse section "5. Deploying Container Storage in Independent Mode"
  1. 5.1. Setting up a RHGS Cluster
    
    Expand section "5.1. Setting up a RHGS Cluster" Collapse section "5.1. Setting up a RHGS Cluster"
    
    5.1.1. Installing Red Hat Gluster Storage Server on Red Hat Enterprise Linux (Layered Install)
    
    5.1.2. Configuring Port Access
    
    5.1.3. Enabling Kernel Modules
    
    5.1.4. Starting and Enabling Services
    
    5.1.5. Creating 2 TB (or more) Block Volume
  2. 5.2. Specify Advanced Installer Variables
  3. 5.3. Deploying Red Hat Openshift Container Storage in Independent Mode
  4. 5.4. Deploying Red Hat Openshift Container Storage in Independent mode for Applications with Registry, Logging, and Metrics
  5. 5.5. Single OCS cluster installation
  6. 5.6. Configure Heketi to Place Bricks Across Zones
  7. 5.7. Verify your Deployment
  8. 5.8. Creating an Arbiter Volume (optional)
    
    Expand section "5.8. Creating an Arbiter Volume (optional)" Collapse section "5.8. Creating an Arbiter Volume (optional)"
    
    5.8.1. Creating an Arbiter Volume
    
    Expand section "5.8.1. Creating an Arbiter Volume" Collapse section "5.8.1. Creating an Arbiter Volume"
    
    5.8.1.1. Creating an Arbiter Volume using Heketi CLI
    
    5.8.1.2. Creating an Arbiter Volume using the Storageclass file
    
    5.8.2. Creating Block Hosting Volume as an Arbiter Volume
III. Upgrade
Expand section "III. Upgrade" Collapse section "III. Upgrade"
1. 6. Upgrading your Red Hat Openshift Container Storage in Converged Mode
  Expand section "6. Upgrading your Red Hat Openshift Container Storage in Converged Mode" Collapse section "6. Upgrading your Red Hat Openshift Container Storage in Converged Mode"
  1. 6.1. Upgrading the pods in the glusterfs group
    
    Expand section "6.1. Upgrading the pods in the glusterfs group" Collapse section "6.1. Upgrading the pods in the glusterfs group"
    
    6.1.1. Prerequisites
    
    6.1.2. Restoring original label values for /dev/log
    
    6.1.3. Upgrading if existing version deployed by using cns-deploy
    
    Expand section "6.1.3. Upgrading if existing version deployed by using cns-deploy" Collapse section "6.1.3. Upgrading if existing version deployed by using cns-deploy"
    
    6.1.3.1. Upgrading cns-deploy and Heketi Server
    
    6.1.3.2. Upgrading the Red Hat Gluster Storage Pods
    
    6.1.4. Upgrading if existing version deployed by using Ansible
    
    Expand section "6.1.4. Upgrading if existing version deployed by using Ansible" Collapse section "6.1.4. Upgrading if existing version deployed by using Ansible"
    
    6.1.4.1. Upgrading Heketi Server
    
    6.1.4.2. Upgrading the Red Hat Gluster Storage Pods
  2. 6.2. Upgrading the pods in the glusterfs registry group
    
    Expand section "6.2. Upgrading the pods in the glusterfs registry group" Collapse section "6.2. Upgrading the pods in the glusterfs registry group"
    
    6.2.1. Prerequisites
    
    6.2.2. Restoring original label values for /dev/log
    
    6.2.3. Upgrading if existing version deployed by using cns-deploy
    
    Expand section "6.2.3. Upgrading if existing version deployed by using cns-deploy" Collapse section "6.2.3. Upgrading if existing version deployed by using cns-deploy"
    
    6.2.3.1. Upgrading cns-deploy and Heketi Server
    
    6.2.3.2. Upgrading the Red Hat Gluster Storage Registry Pods
    
    6.2.4. Upgrading if existing version deployed by using Ansible
    
    Expand section "6.2.4. Upgrading if existing version deployed by using Ansible" Collapse section "6.2.4. Upgrading if existing version deployed by using Ansible"
    
    6.2.4.1. Upgrading Heketi Server
    
    6.2.4.2. Upgrading the Red Hat Gluster Storage Registry Pods
  3. 6.3. Starting the Heketi Pods
  4. 6.4. Upgrading the client on Red Hat OpenShift Container Platform nodes
2. 7. Upgrading using the playbook
  Expand section "7. Upgrading using the playbook" Collapse section "7. Upgrading using the playbook"
  1. 7.1. Parameters of upgrade playbook
3. 8. Upgrading Your Red Hat Openshift Container Storage in Independent Mode
  Expand section "8. Upgrading Your Red Hat Openshift Container Storage in Independent Mode" Collapse section "8. Upgrading Your Red Hat Openshift Container Storage in Independent Mode"
  1. 8.1. Prerequisites
  2. 8.2. Upgrading nodes and pods in glusterfs group
    
    Expand section "8.2. Upgrading nodes and pods in glusterfs group" Collapse section "8.2. Upgrading nodes and pods in glusterfs group"
    
    8.2.1. Upgrading the Red Hat Gluster Storage Cluster
    
    8.2.2. Upgrading/Migration of Heketi in RHGS node
    
    8.2.3. Upgrading if existing version deployed using cns-deploy
    
    Expand section "8.2.3. Upgrading if existing version deployed using cns-deploy" Collapse section "8.2.3. Upgrading if existing version deployed using cns-deploy"
    
    8.2.3.1. Upgrading Heketi in Openshift node
    
    8.2.3.2. Upgrading Gluster Block
    
    8.2.4. Upgrading if existing version deployed using Ansible
    
    Expand section "8.2.4. Upgrading if existing version deployed using Ansible" Collapse section "8.2.4. Upgrading if existing version deployed using Ansible"
    
    8.2.4.1. Upgrading Heketi in Openshift node
    
    8.2.4.2. Upgrading Gluster Block if Deployed by Using Ansible
    
    8.2.5. Enabling S3 Compatible Object store
  3. 8.3. Upgrading nodes and pods in glusterfs registry group
    
    Expand section "8.3. Upgrading nodes and pods in glusterfs registry group" Collapse section "8.3. Upgrading nodes and pods in glusterfs registry group"
    
    8.3.1. Upgrading the Red Hat Gluster Storage Registry Cluster
    
    Expand section "8.3.1. Upgrading the Red Hat Gluster Storage Registry Cluster" Collapse section "8.3.1. Upgrading the Red Hat Gluster Storage Registry Cluster"
    
    8.3.1.1. Upgrading Heketi Registry pod
    
    8.3.2. Upgrading glusterblock-provisioner Pod
    
    8.3.3. Upgrading Gluster Block
  4. 8.4. Upgrading the client on Red Hat OpenShift Container Platform nodes
IV. Uninstalling
Expand section "IV. Uninstalling" Collapse section "IV. Uninstalling"
1. 9. Uninstall Red Hat Openshift Container Storage
V. Workloads
Expand section "V. Workloads" Collapse section "V. Workloads"
1. 10. Managing Arbitrated Replicated Volumes
  Expand section "10. Managing Arbitrated Replicated Volumes" Collapse section "10. Managing Arbitrated Replicated Volumes"
  1. 10.1. Managing Arbiter Brick Size
  2. 10.2. Managing Arbiter Brick Placement
    
    Expand section "10.2. Managing Arbiter Brick Placement" Collapse section "10.2. Managing Arbiter Brick Placement"
    
    10.2.1. Setting Tags with the Heketi CLI
    
    10.2.2. Removing Tags using Heketi CLI
    
    10.2.3. Viewing Tags with the Heketi CLI
  3. 10.3. Creating Persistent Volumes
2. 11. Setting up Custom Volume Options
VI. Appendix
Expand section "VI. Appendix" Collapse section "VI. Appendix"
1. A. Optional Deployment Method (with cns-deploy)
  Expand section "A. Optional Deployment Method (with cns-deploy)" Collapse section "A. Optional Deployment Method (with cns-deploy)"
  1. A.1. Setting up Converged mode
    
    Expand section "A.1. Setting up Converged mode" Collapse section "A.1. Setting up Converged mode"
    
    A.1.1. Configuring Port Access
    
    A.1.2. Enabling Kernel Modules
    
    A.1.3. Starting and Enabling Services
  2. A.2. Setting up Independent Mode
    
    Expand section "A.2. Setting up Independent Mode" Collapse section "A.2. Setting up Independent Mode"
    
    A.2.1. Installing Red Hat Gluster Storage Server on Red Hat Enterprise Linux (Layered Install)
    
    A.2.2. Configuring Port Access
    
    A.2.3. Enabling Kernel Modules
    
    A.2.4. Starting and Enabling Services
  3. A.3. Setting up the Environment
    
    Expand section "A.3. Setting up the Environment" Collapse section "A.3. Setting up the Environment"
    
    A.3.1. Preparing the Red Hat OpenShift Container Platform Cluster
    
    A.3.2. Deploying Containerized Red Hat Gluster Storage Solutions
    
    A.3.3. Deploying Converged Mode
    
    Expand section "A.3.3. Deploying Converged Mode" Collapse section "A.3.3. Deploying Converged Mode"
    
    A.3.3.1. Deploying Independent Mode
  4. B. Settings that are destroyed when using uninstall playbook
  5. C. Templates
    
    Expand section "C. Templates" Collapse section "C. Templates"
    
    C.1. Glusterblock Provisioner Template
    
    C.2. Sample Inventory File For Converged Mode Setup
    
    C.3. Sample Inventory File For Independent Mode Setup
Legal Notice

Deployment Guide

Red Hat Openshift Container Storage 3.11

Deploying Red Hat Openshift Container Storage 3.11

Customer Content Services Red Hat

ccs@redhat.com

Abstract

This guide describes the prerequisites and provides step-by-step instructions to deploy Red Hat Openshift Container Storage.

Select Your Language

Infrastructure and Management

Cloud Computing

Storage

Runtimes

Integration and Automation

Deployment Guide

Deploying Red Hat Openshift Container Storage 3.11