Upgrading multiple CP4BA instances in All Namespaces from 23.0.2

From 24.0.0-IF001 You can upgrade multiple Cloud Pak for Business Automation instances in All Namespaces from 23.0.2-IF006 to 24.0.0.

Before you begin

  • The steps in the Procedure section are applicable to your Cloud Pak for Business Automation deployment if:
    • You configured your Cloud Pak for Business Automation in 23.0.2-IF006 in All Namespaces.
    • Your Cloud Pak for Business Automation and Cloud Pak foundational services are installed in openshift-operators namespace.
    • You have multiple instances of Cloud Pak for Business Automation installed.
    Note: You must upgrade all instances of Cloud Pak for Business Automation one by one.
  • Download cert-kubernetes to a Linux® based machine (RHEL or macOS) to update the catalog sources for the new release.

    All the installation and upgrade artifacts are contained in the cert-kubernetes repository. It is recommended to use the latest interim fix of the release, but if you do need a previous version then you can find them all in the Cloud Pak for Business Automation download document.

    Tip: Use the move right arrow Move right arrow in the 24.0.0 release to find all the available interim fixes.

    To download the cert-kubernetes repository.

    1. Open the Cloud Pak for Business Automation download document, find the card for the latest 24.0.0 interim fix, click Cert Kubernetes, and then select and copy the displayed command.
    2. Run the copied git clone command to download the files.
  • If your Cloud Pak for Business Automation includes Business Automation Insights, make sure that you evaluated your migration and chosen a strategy before you start your migration. For more information, see Premigrating Business Automation Insights data to OpenSearch.

About this task

You can upgrade all the Cloud Pak for Business Automation 23.0.2-IF006 deployments that you created from the operators in All Namespaces to Cloud Pak for Business Automation 24.0.0-IF001.

The procedure assumes that you have two Cloud Pak for Business Automation instances and you want to upgrade to 24.0.0. You can follow the same steps for more than two Cloud Pak for Business Automation instances.

When you run the script, the script output displays some details. Steps that are tagged as:
  • [INFO]: Provides details of the actions that the script takes.
  • [ATTENTION]: Provides important details that you need to know or do during the upgrade.
  • [NEXT ACTION]: Provides the commands or script that you need to run to proceed with upgrade.

Procedure

  1. Log in to the target cluster from a client.
    oc login https://<CLUSTERIP>:<port> -u <ADMINISTRATOR>
  2. Open multiple CLI windows and keep them open side by side. Each CLI window is used to upgrade one Cloud Pak for Business Automation instance.
  3. Change the directory to the scripts folder under cert-kubernetes/scripts.
  4. In the first CLI window, run the cp4a-deployment.sh script from cert-kubernetes in the upgradeOperator mode.
    ./cp4a-deployment.sh -m upgradeOperator -n <first_project_name>

    Where <first_project_name> is the namespace of the first Cloud Pak for Business Automation instance you want to upgrade.

    1. If the script detects Elasticsearch and IBM Business Automation Insights, the script then asks if you completed the migration from Elasticsearch to OpenSearch. Select No if you did not complete the migration and then go to Installing OpenSearch and migrating Elasticsearch data. Select Yes if you completed migration from Elasticsearch to OpenSearch.
      Remember: Business Automation Insights uses Elasticsearch, and so does Process Federation Server. If you have either of these components in the cluster and you want to upgrade them, then you must migrate from Elasticsearch to OpenSearch.
      Note: If your Cloud Pak for Business Automation includes IBM Business Automation Workflow without Business Automation Insights, you do not need to migrate Elasticsearch to OpenSearch because IBM Process Federation Server is removed in the upgrade. If you want to continue to use IBM Process Federation Server after the upgrade, then you do need to migrate your Elasticsearch data.
    2. If the script detects Elasticsearch and no Business Automation Insights component, then the script asks if you are planning to use IBM Process Federation Server after the upgrade and if you want to perform the migration of Elasticsearch to OpenSearch? (Yes/No).
      • If you select Yes, the script asks if you completed the migration from Elasticsearch to OpenSearch. Select No if you did not complete the migration and then go to Installing OpenSearch and migrating Elasticsearch data. Select Yes if you completed migration from Elasticsearch to OpenSearch.
      • If you select No, continue to upgrade the CP4BA operators without migrating Elasticsearch.
  5. In the second CLI window, do the following steps.
    • If Business Automation Insights is installed.
      Run the following command.
      ./cp4a-deployment.sh -m upgradeOperator -n <second_project_name>

      Where <second_project_name> is the namespace of the second Cloud Pak for Business Automation instance you want to upgrade.

      If the script detects Elasticsearch and IBM Business Automation Insights, the script then asks if you completed the migration from Elasticsearch to OpenSearch. Select No if you did not complete the migration and then go to Installing OpenSearch and migrating Elasticsearch data. Select Yes if you completed migration from Elasticsearch to OpenSearch

    • If Business Automation Insights is not installed.
      Run the following command.
      ./cp4a-deployment.sh -m upgradeOperator -n <second_project_name> --cpfs-upgrade-mode <mode> --original-cp4ba-csv-ver 23.2.6
      Where
      • <second_project_name> is the namespace of the second Cloud Pak for Business Automation instance you want to upgrade..
      • <mode> must be shared2shared. shared2shared is the only supported path of upgrade when you upgrade from an All Namespaces deployment.
      Run the following command to verify the original version of the Cloud Pak for Business Automation CSV.
      oc get csv -n <second_project_name> |grep ibm-cp4a-operator | awk {'print $1'} | xargs oc get csv -ojsonpath='{.spec.replaces}
    Note: The script output displays the following command that you need to run as the next action. Do not run the command now. You need to run this command later.
    ./cp4a-deployment.sh -m upgradeDeployment -n <second_project_name>
  6. In the first CLI window, run the following command if you have Business Automation Insights and you completed the migration of Elasticsearch to OpenSearch. Otherwise, you can skip this step.
    ./cp4a-deployment.sh -m upgradeOperator -n <first_project_name>

    Where <first_project_name> is the namespace of the first Cloud Pak for Business Automation instance you want to upgrade.

    Note: The script output displays the following command that you need to run as the next action. Do not run the command now. You need to run this command later.
    ./cp4a-deployment.sh -m upgradeDeployment -n <first_project_name>
  7. In the second CLI window, run the following command if you have Business Automation Insights and you completed the migration of Elasticsearch to OpenSearch. Otherwise, you can skip this step.
    ./cp4a-deployment.sh -m upgradeOperator -n <second_project_name> --cpfs-upgrade-mode shared2shared --original-cp4ba-csv-ver 23.2.6

    Where <second_project_name> is the namespace of the second Cloud Pak for Business Automation instance you want to upgrade.

    Run the following command to verify the original version of the Cloud Pak for Business Automation CSV.
    oc get csv -n <second_project_name> |grep ibm-cp4a-operator | awk {'print $1'} | xargs oc get csv -ojsonpath='{.spec.replaces}
    Where <second_project_name> is the namespace of the second Cloud Pak for Business Automation instance you want to upgrade.
    Note: The script output displays the following command that you need to run as the next action. Do not run the command now. You need to run this command later.
    ./cp4a-deployment.sh -m upgradeDeployment -n <second_project_name>

What to do next

Go to and complete the steps in Upgrading your CP4BA deployment version from 23.0.2 for each of your Cloud Pak for Business Automation instances. Perform the steps on each of the CLI windows.