Prerequisites for installing the server software on Red Hat OpenShift

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

The following section describes each prerequisite in detail:

Internet access

You must have access to the internet to install Rational® Test Automation Server.

Entitlement key

You must copy an Entitlement key from Container software library to pull the images used by the server software. For more information, refer to Creating an API key.

Red Hat OpenShift platform

You must set up a Red Hat OpenShift platform.

For more information about hardware and software requirements, see System Requirements.

Backup user data

If you want to migrate user data from a previous version of the product during the installation of the server software, then you must perform the following tasks:

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.4 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 Jaeger.

    • Optional: 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 configure the OpenShift software-defined networking (SDN) to provide a unified cluster network that enables communication between pods across the OpenShift Container Platform cluster. The default installation includes the NetworkPolicy resources and these resources are acted upon only if you configure the SDN appropriately. For more information, refer to the OpenShift SDN default CNI network provider section in the RedHat OpenShift documentation.

  • You must have access to the OpenShift cluster with required privileges. You can 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

Mandatory software

You must install the following software on Red Hat OpenShift:

  • Helm V3.3.4 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.

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
data-{my-rtas}-datasets-postgresql-0 2 GB

ReadWriteOnce

CLI Abbreviation: 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}-rabbitmq-0 8 GB RWO Notifications between services
data-{my-rtas}-keycloak-postgresql-0 2 GB RWO Users and resource ownership
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

ReadWriteMany

CLI Abbreviation: RWX

 User provided third party libraries
Note: {my-rtas} is the release name that you provide during the installation of the server software.

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.
Disclaimer: This release contains access to the virtualized services feature in Rational® Test Automation Server as a Tech Preview. The Tech Preview is intended for you to view the capabilities of virtualized services offered by Rational® Test Automation Server V10.1.2, and to provide your feedback to the product team. You are permitted to use the information only for evaluation purposes and not for use in a production environment. IBM provides the information without obligation of support and "as is" without warranty of any kind.