Prerequisites for installing the server software on Red Hat OpenShift

To install Rational® Test Automation Server on the Red Hat OpenShift platform, you must first perform certain tasks.

The following section describes each prerequisite in detail:

Red Hat OpenShift platform

You must set up a Red Hat OpenShift platform with the following additional resource requirements:

  • 256 GB of disk space
  • 16 GB of RAM (in addition to what OpenShift offers)
  • 8 CPUs

For more information about specific system requirements, see System Requirements.

OpenShift Kubernetes Engine

OpenShift Kubernetes Engine is a product that permits you to use an enterprise-class Kubernetes environment as a production platform to launch containerized applications.

  • You must have set up OpenShift Kubernetes Engine and installed the following components in your IT infrastructure:

    • Red Hat OpenShift Container Platform V4.2 or later. For more information, refer to the Red Hat OpenShift documentation.

    • Dynamic Volume Provisioning or manually created Persistent Volumes (PV) of an appropriate size that are already available. For more information, refer to the Dynamic provisioning section in the Red Hat OpenShift documentation.

    • Jaeger operator to trace test logs and Jaeger-based reports when you run tests. For more information, refer to the Installing the Jaeger operator.

    • Red Hat Service Mesh V1.1 or later, when additional service virtualization features are required. For more information, refer to the Red Hat OpenShift Service Mesh overview section in the Red Hat OpenShift documentation.

  • You must have access to the OpenShift cluster with required privileges. Run the following command on the OpenShift command-line interface to gain access:
    oc login -u kubeadmin -p {password} https://api.{openshift-cluster-dns-name}:6443

Other software

You must have installed the following additional softwares on Red Hat OpenShift:

  • Helm V3.1.3 or later. For more information, refer to the Installing Helm section in the Helm documentation.

  • OpenShift CLI. For more information, refer to the Getting started with the CLI section in the Red Hat OpenShift documentation.

Persistent storage

Rational® Test Automation Server requires persistent storage in addition to the minimum resources required by the cluster. Depending on the workload, you might require additional persistent storage. The Kubernetes framework provides persistent storage for users and administrators. The persistent storage provides an API that abstracts details about how storage is provided than consumed. You can manage resources of a cluster by using the following APIs:

  • PersistentVolume (PV) - This is a resource in the cluster that is similar to a node in a cluster resource.

  • PersistentVolumeClaim (PVC) - This is a request for storage by a user.

For more information about persistent storage, refer to the Persistent Volumes section in the Kubernetes documentation.

You can set the pod securityContext.fsGroup for each of the following PersistentVolume by using Helm parameters if your PersistentVolume provisioner requires securityContext.fsGroup. The default configuration creates the PersistentVolumeClaim that dynamically provision the PersistentVolume. The following table lists the PersistentVolumeClaim, its size, and access mode during the configuration:

PersistentVolumeClaim Size Access Mode Content Platform supported
Kubernetes OpenShift
data-{my-rtas}-keycloak-postgresql-0 2 GB

ReadWriteOnce

CLI Abbreviation: RWO

 Users and resource ownership ✓ ✓
data-{my-rtas}-datasets-postgresql-0 2 GB RWO Edits to Datasets ✓ ✓
data-{my-rtas}-execution-postgresql-0 2 GB RWO Infrastructure details ✓ ✓
data-{my-rtas}-gateway-postgresql-0 2 GB RWO Project details ✓ ✓
data-{my-rtas}-kafka-0 8 GB RWO Notifications between services ✓ ✓
data-{my-rtas}-kafka-zookeeper-0 8 GB RWO Zookeeper state ✓ ✓
data-{my-rtas}-results-0 8 GB RWO Reports ✓ ✓
data-{my-rtas}-results-postgresql-0 2 GB RWO Execution result metadata ✓ ✓
data-{my-rtas}-rm-postgresql-0 2 GB RWO Source details ✓ ✓
data-{my-rtas}-tam-0 32 GB RWO Cloned git repositories ✓ ✓
data-{my-rtas}-tam-postgresql-0 8 GB RWO Test asset metadata ✓ ✓
data-{my-rtas}-userlibs-0 1 GB RWO User provided third party libraries ✓ ✘
data-{my-rtas}-userlibs-0 1 GB

ReadWriteMany

CLI Abbreviation: RWX

 User provided third party libraries ✘ ✓
Note: You must substitute {my-rtas} with the release name that you provided for the server.

Service virtualization through Istio

The default configuration does not enable service virtualization through Istio. To use the service virtualization feature, you must configure it appropriately and it must be installed by a cluster-admin. For more information about how to enable service virtualization through Istio, see Installing the server software on Red Hat OpenShift.