Updating WebSphere Automation 1.7.3 or higher prerequisites

After updating to WebSphere Automation 1.7.3 or higher, update 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 upgrade process.

Before you begin

Ensure that you have updated your instance of WebSphere Automation to version 1.7.3 or higher before running this script.

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 External link icon .

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 upgrade script

Download the upgrade-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/upgrade-prereq.sh > upgrade-prereq.sh
chmod +x upgrade-prereq.sh

Updating the prerequisites for WebSphere Automation 1.7.3 or higher

Update the prerequisites by running the following script.

./upgrade-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]
                           [--patch-catalog-sources]

The --instance-namespace flag is a required parameter. If you are installing the WebSphere Automation operator with AllNamespaces mode, you must declare --all-namespaces flag. Only declare --patch-catalog-sources if you want to patch catalog sources to the newest version automatically through the script. For air gap environments, do not declare this flag.

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.

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.9.0 (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
If WSA_VERSION_NUMBER is 1.8.1 or 1.8.2 then:
    COMMON_SERVICES_CASE_VERSION = 4.10.0
If WSA_VERSION_NUMBER is 1.9.0 then:
    COMMON_SERVICES_CASE_VERSION = 4.12.0
If WSA_VERSION_NUMBER is 1.10.0 then:
    COMMON_SERVICES_CASE_VERSION = 4.14.0
If WSA_VERSION_NUMBER is 1.11.0 or 1.11.1 then:
    COMMON_SERVICES_CASE_VERSION = 4.15.0
If WSA_VERSION_NUMBER is 1.12.0 or 1.12.1 then:
    COMMON_SERVICES_CASE_VERSION = 4.17.0
Otherwise:
    COMMON_SERVICES_CASE_VERSION = 4.18.0

Examples

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

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

For OwnNamespace or SingleNamespace mode with default values, run:

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

For AllNamespaces mode with default values, run:

./upgrade-prereq.sh --instance-namespace websphere-automation --all-namespaces

For AllNamespaces mode with optional flags declared, run:

./upgrade-prereq.sh --instance-namespace websphere-automation --cert-manager-namespace cert-manager-namespace --licensing-service-namespace licensing-namespace --all-namespaces --patch-catalog-sources