Quantum Fabric on Red Hat OpenShift

Overview

This document specifies the steps that you can follow to get Quantum Fabric up and running on your OpenShift Cluster and assumes a basic understanding of OpenShift and Kubernetes concepts. The setup occurs with minimal manual intervention and leverages Red Hat OpenShift to package different components as portable container images with all the required binaries and libraries.

NOTE:

For versions V9 ServicePack 5 or later, containers for the Fabric components run on the Red Hat Universal Base Image (UBI).
For versions V9 ServicePack 4 or earlier, containers for the Fabric components run on a Debian image.

Prerequisites

A Red Hat OpenShift cluster that consists of master and worker nodes
- For V9SP5 or earlier, use OpenShift v4.5.24
- For V9SP6 or later, use OpenShift v4.10
- For 2024.04 or later, use OpenShift v4.14
A database that is setup external to the OpenShift Cluster
For information about the supported databases and their versions, refer to Supported Databases.
A publicly available host name
This is applicable if you are not using a host name that is generated by OpenShift.
SSL Certificates
This is applicable if you want to run your cluster setup with HTTPS.
FabricOpenShift.zip file
This zip file contains the scripts that you can use to configure and setup an instance of Quantum Fabric. You can download the file from the Quantum Downloads page.
Helm installation
This is applicable for V9 ServicePack 6 or later versions.
For more information, see Install Helm in this document, or refer to the Helm documentation.

Supported Databases

Quantum Fabric on OpenShift supports the following database servers:

Database Type	Supported Versions	Certified Versions
Postgres	14.4	Not Available
MySQL	5.6, 5.7, 8.0.26	5.7, 8.0.26
Microsoft SQL Server	2016, 2017	Not Available
Oracle	Oracle 12c (12.1.0.1.0), Oracle 18c	Not Available

NOTE:

MySQL 8 and MySQL 8 Cluster are supported from certain versions of Quantum Fabric. For more information, refer to the Quantum Fabric - Supported OS, Application Servers, and Databases Guide.
Multi-node setups for Quantum Fabric are not supported with Postgres.

Architecture

Red Hat OpenShift is available on a variety of platforms, and it is also available as a managed service from public cloud vendors such as IBM, AWS and Azure.

For example, the following architecture diagram showcases Red Hat OpenShift on IBM Cloud, which provides an idea of the setup when considering how to deploy Fabric by using a public cloud managed service.

The following diagram shows how you can set up the Fabric project. Each VM corresponds to one worker node, as depicted in the earlier architecture diagram. The worker and database VMs can be setup in the same zone or in multiple zones based on considerations for high availability.

Install Helm

On your OpenShift instance, open a terminal console.
Download the compatible version of Helm by running the following command:
```
wget https://get.helm.sh/helm-v3.9.0-linux-amd64.tar.gz
```
Extract the Helm binary by running the following command:
```
tar -zxvf /tmp/helm-v3.9.0-linux-amd64.tar.gz
```
Move the binary to the proper location by running the following command:
```
mv linux-amd64/helm /usr/bin/
```

.You can then install and deploy Quantum Fabric by using Helm charts. For more information, refer to Deploy Fabric using Helm Charts.