Installing the WebSphere Automation operator prerequisites

For new installations of WebSphere Automation 1.7 or 1.8, install the IBM foundational services prerequisites, which include IBM Cloud Pak foundational services, IBM Cert Manager operator, IBM Licensing operator, and ingress network policies. A script is provided to simplify the installation process.

Before you begin

You must have yq installed to run the script. If you do not have yq installed, run the following code snippet. If your architecture is different than the one indicated by the BINARY parameter, change the value of the BINARY parameter to the appropriate value from the list on this page: https://github.com/mikefarah/yq/releases/latest.

BINARY=yq_linux_amd64 
wget https://github.com/mikefarah/yq/releases/latest/download/${BINARY} -O /usr/bin/yq && chmod +x /usr/bin/yq

Downloading the prerequisites installation script

Download the install-prereq.sh installation script by using the following commands. If you have previously downloaded this script, download it again to make sure that you have the most recent instance. The script is occasionally updated.

curl https://raw.githubusercontent.com/IBM/ibm-websphere-automation/main/scripts/cs4-prereqs/install-prereq.sh > install-prereq.sh
chmod +x install-prereq.sh

Running the prerequisites installation script

Run the installation script.

./install-prereq.sh --instance-namespace WSA_INSTANCE_NAMESPACE
                    [--websphere-automation-version] WSA_VERSION_NUMBER \
                    [--cert-manager-namespace CERT_MANAGER_NAMESPACE] \
                    [--licensing-service-namespace LICENSING_SERVICE_NAMESPACE] \
                    [--cert-manager-catalog-source CERT_MANAGER_CATALOG_SOURCE] \
                    [--licensing-service-catalog-source LICENSING_SERVICE_CATALOG_SOURCE] \
                    [--common-services-catalog-source] COMMON_SERVICES_CATALOG_SOURCE \
                    [--common-services-case-version COMMON_SERVICES_CASE_VERSION] \
                    [--all-namespaces]

During the execution of the WebSphere Automation script, the --instance-namespace flag is a required parameter. Make sure that the installation mode you select for running the prerequisite installation script matches the mode that is used for installing the WebSphere Automation operator.

The WebSphere Automation operator can be installed in two different modes.

AllNamespaces installation mode: Install the operator inside the openshift-operators namespace. This mode makes the operator available across all namespaces, allowing you to deploy WebSphere Automation instances in any namespace within the cluster. If you are installing the WebSphere Automation operator with AllNamespaces installation mode, you must declare --all-namespaces flag.
OwnNamespace installation mode: Install both the operator and the WebSphere Automation instance within the same namespace, referred to as WSA_INSTANCE_NAMESPACE.

Use the OwnNamespace installation mode if you plan to install multiple instances of WebSphere Automation in the same Red Hat OpenShift Container Platform cluster, or if you plan to install other IBM Cloud Paks in the same cluster. For more information, see the installation documentation for the other IBM Cloud Paks that you want to install in the same cluster.

The chosen mode should match the one that is used during the prerequisite script execution.

For air gap environments only, set the --common-services-catalog-source flag and set the value of the COMMON_SERVICES_CATALOG_SOURCE variable to opencloud-operators.

Other flags are optional. If they are not specified, the following default values are used.

CERT_MANAGER_NAMESPACE = ibm-cert-manager
LICENSING_SERVICE_NAMESPACE = ibm-licensing
CERT_MANAGER_CATALOG_SOURCE = ibm-cert-manager-catalog
LICENSING_SERVICE_CATALOG_SOURCE = ibm-licensing-catalog
COMMON_SERVICES_CATALOG_SOURCE = ibm-operator-catalog
WSA_VERSION_NUMBER = 1.8.1 (the value is the version number that you want to install)

If WSA_VERSION_NUMBER is 1.7.0, 1.7.1, or 1.7.2 then:
    COMMON_SERVICES_CASE_VERSION = 4.4.0
If WSA_VERSION_NUMBER is 1.7.3 then:
    COMMON_SERVICES_CASE_VERSION = 4.6.4
If WSA_VERSION_NUMBER is 1.7.4 then:
    COMMON_SERVICES_CASE_VERSION = 4.8.0
If WSA_VERSION_NUMBER is 1.7.5 or 1.8.0 then:
    COMMON_SERVICES_CASE_VERSION = 4.9.0
Otherwise:
    COMMON_SERVICES_CASE_VERSION = 4.10.0

Examples

In the following examples, if optional flags are not defined, their default values are used. Use the optional flags to specify values that are different than the default ones.

Change any other namespace values in the following examples to match the namespaces you have defined in your cluster.

For OwnNamespace mode with default values, run:

./install-prereq.sh --instance-namespace websphere-automation

For AllNamespaces mode with default values, run:

./install-prereq.sh --instance-namespace websphere-automation \
                    --all-namespaces

For AllNamespaces mode with optional flags declaration, run:

./install-prereq.sh --instance-namespace websphere-automation \
                    --cert-manager-namespace cert-manager-namespace \
                    --licensing-service-namespace licensing-namespace \
                    --all-namespaces