Prerequisites for installing the server software in an air-gapped environment

You must complete certain tasks before you install Rational® Test Automation Server in an air-gapped environment on the Red Hat OpenShift platform.

The following sections describe each prerequisite in detail:

Entitlement key

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

Red Hat OpenShift Container Platform

You must install Red Hat OpenShift Container Platform (OCP) and have cluster administrator privileges. For more information, refer to the Red Hat OpenShift documentation.

For more information about specific versions of software requirements, see System Requirements.

You can run the following command on the Red Hat OpenShift command-line interface to gain cluster administrator access:
oc login -u kubeadmin -p {password} https://api.{openshift-cluster-dns-name}:6443
You can run the following command to obtain the default value of openshift-cluster-dns-name: 
oc get --namespace=openshift-ingress-operator ingresscontroller/default -ojsonpath='{.status.domain}'

Bastion host

You must set up a Bastion host that has Linux installed. You must also have internet access.

A bastion host is a server that is provisioned with a public IP address and must be accessible through remote access Secure Shell (SSH).
Note: You must ensure that the Bastion host has access to your OCP cluster.

For more information refer to the IBM Cloud Docs.

Docker registry

You must set up a local Docker registry to store the images of Rational® Test Automation Server and ensure that it has access to the OCP cluster and the Bastion host.

For more information refer to the Red Hat OpenShift documentation.

Mandatory software

You must install the following software on Red Hat OpenShift:

  • Red Hat OpenShift command-line interface (CLI) on the Bastion host. For more information, refer to the Getting started with the CLI section in the Red Hat OpenShift documentation.

  • IBM Cloud Pak CLI (cloudctl) on the Bastion host to manage Container Application Software for Enterprises (CASE). For more information, refer to the cloud-pak-cli repository.

  • Helm. For more information, refer to the Installing a Helm chart on an Red Hat OpenShift Container Platform cluster section in the Red Hat OpenShift documentation.

Service virtualization usage metrics

You must perform the following tasks so that Rational® Test Automation Server shows the correct usage of service virtualization metrics:

  • Create the cluster-monitoring-config ConfigMap object to configure the Red Hat OpenShift Container Platform (OCP) monitoring stack, if the ConfigMap does not exist.

    For more information about creating a cluster monitoring config map, based on the version of OCP that you use, refer to Creating a cluster monitoring config map.

  • Enable the user workload monitoring services in the Red Hat OpenShift cluster to show the service virtualization usage metrics in Rational® Test Automation Server.

    For more information about the enabling monitoring of your services, based on the version of OCP that you use, refer to Enabling monitoring of your services