Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 8. Setting up the Environment

This chapter outlines the details for setting up the environment for Red Hat Gluster Storage Container Converged in OpenShift.

8.1. Preparing the Red Hat OpenShift Container Platform Cluster

Execute the following steps to prepare the Red Hat OpenShift Container Platform cluster:
  1. On the master or client, execute the following command to login as the cluster admin user:
    Copy to Clipboard Toggle word wrap 
    # oc login
    For example:
    Copy to Clipboard Toggle word wrap 
     oc login
Authentication required for https://dhcp46-24.lab.eng.blr.redhat.com:8443 (openshift)
Username: test
Password:
Login successful.

You have access to the following projects and can switch between them with 'oc project <project_name>':

  * default
    kube-system
    logging
    management-infra
    openshift
    openshift-infra
  

Using project "default".
  2. On the master or client, execute the following command to create a project, which will contain all the containerized Red Hat Gluster Storage services:
    Copy to Clipboard Toggle word wrap 
    # oc new-project <project_name>
    For example:
    Copy to Clipboard Toggle word wrap 
    # oc new-project storage-project

Now using project "storage-project" on server "https://master.example.com:8443"
  3. After the project is created, execute the following command on the master node to enable the deployment of the privileged containers as Red Hat Gluster Storage container can only run in the privileged mode.
    Copy to Clipboard Toggle word wrap 
    # oadm policy add-scc-to-user privileged -z default
  4. Execute the following steps on the master to set up the router:

    Note

    If a router already exists, proceed to Step 5. To verify if the router is already deployed, execute the following command:
    Copy to Clipboard Toggle word wrap 
    # oc get dc --all-namespaces
    1. Execute the following command to enable the deployment of the router:
      Copy to Clipboard Toggle word wrap 
      # oadm policy add-scc-to-user privileged -z router
    2. Execute the following command to deploy the router:
      Copy to Clipboard Toggle word wrap 
      # oadm router storage-project-router --replicas=1
    3. Edit the subdomain name in the config.yaml file located at /etc/origin/master/master-config.yaml.
      For example:
      Copy to Clipboard Toggle word wrap 
      subdomain: "cloudapps.mystorage.com"
      For more information, refer https://access.redhat.com/documentation/en-us/openshift_container_platform/3.6/html-single/installation_and_configuration/#customizing-the-default-routing-subdomain.
    4. Restart the master OpenShift services by executing the following command:
      Copy to Clipboard Toggle word wrap 
      # systemctl restart atomic-openshift-master
      For OpenShift Container Platform 3.7 execute the following command to restart the services :
      Copy to Clipboard Toggle word wrap 
      # systemctl restart atomic-openshift-master-api atomic-openshift-master-controllers

      Note

      If the router setup fails, use the port forward method as described in Appendix C, Client Configuration using Port Forwarding .
    For more information regarding router setup, see https://access.redhat.com/documentation/en/openshift-container-platform/3.6/paged/installation-and-configuration/chapter-4-setting-up-a-router
  5. Execute the following command to verify if the router is running:
    Copy to Clipboard Toggle word wrap 
    # oc get dc <router_name>
    For example:
    Copy to Clipboard Toggle word wrap 
    # oc get dc storage-project-router
NAME                   REVISION   DESIRED   CURRENT   TRIGGERED BY
storage-project-router   1          1         1         config

    Note

    Ensure you do not edit the /etc/dnsmasq.conf file until the router has started.
  6. After the router is running, the client has to be setup to access the services in the OpenShift cluster. Execute the following steps on the client to set up the DNS.
    1. Execute the following command to find the IP address of the router:
      Copy to Clipboard Toggle word wrap 
      # oc get pods -o wide --all-namespaces | grep router
storage-project storage-project-router-1-cm874        1/1       Running   119d       10.70.43.132   dhcp43-132.lab.eng.blr.redhat.com
    2. Edit the /etc/dnsmasq.conf file and add the following line to the file:
      Copy to Clipboard Toggle word wrap 
      address=/.cloudapps.mystorage.com/<Router_IP_Address>
      where, Router_IP_Address is the IP address of the node where the router is running.
    3. Restart the dnsmasq service by executing the following command:
      Copy to Clipboard Toggle word wrap 
      # systemctl restart dnsmasq
    4. Edit /etc/resolv.conf and add the following line:
      Copy to Clipboard Toggle word wrap 
      nameserver 127.0.0.1
    For more information regarding setting up the DNS, see https://access.redhat.com/documentation/en/openshift-container-platform/3.6/single/installation-and-configuration/#envirornment-requirements.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.