Completing the IBM Business Automation Workflow Runtime upgrade

After the operator upgrades your deployment of IBM Business Automation Workflow Runtime, you might need to perform some additional steps to complete the upgrade process.

Procedure

  1. Optional: If you want Business Automation Workflow Runtime to continue to be federated, upgrade Process Federation Server. For more information, see Upgrading Process Federation Server on Red Hat OpenShift from 23.0.2.
  2. Optional: If you enabled full text search or you federated Workflow with Process Federation Server, you must rebuild the case indexes. The process indexes will automatically rebuild in the new OpenSearch cluster.
    For more details on case indexing REST API, see Indexing case instances.
    Note: You can ignore this step if you are using external Elasticsearch or OpenSearch and did not migrate to the OpenSearch that is included with Cloud Pak for Business Automation.
  3. To validate the upgrade:
    1. You can see which images were recently pulled by running a command similar to the following command, where ${NAMESPACE} is your Cloud Pak for Business Automation namespace:
      for i in $(oc get pod -n ${NAMESPACE} --no-headers|awk '{print $1}') 
      do 
        oc describe pod $i| awk '/Pulled/{print "'$i'",$0}'
      done
    2. To check the status of the pods, run the following command:
      oc get pods -n ${NAMESPACE}
    3. Get the URLs and log in to Process Portal, Case Manager Client, and Workplace.
      To get the URL of the web applications and the user credentials to log in, access the Config Maps from the OpenShift® web console.
      • Log in to your cluster web console.
      • Select your namespace.
      • In the left panel, select Workloads > Config Maps.
      • Find cp4ba-access-info. You can get Cloud Pak for Business Automation dashboard information from workflow-server-access-info.
      • Access Process Portal, Case Manager Client, and Workplace by using the URLs in workflow-server-access-info.
    4. Check the status and endpoints for Business Automation Workflow Runtime from the OpenShift console or from the command line.
    • Check the status and endpoints from the OpenShift console.
      1. In the left menu, select Operators > Installed Operators.
      2. At the beginning of the right window, select your project (namespace).
      3. Click the installed operator for IBM Cloud Pak® for Business Automation.
      4. Go to the CP4BA deployment tab page.
      5. Click your deployment (for example, icp4adeploy).
      6. Go to the YAML tab page.
      7. Find the top level status: element. Then check every component's status. For example:
         status:
                  components:
                          ...
                         baw:
                           bawDeployment: Ready
                           bawService: Ready
                           bawZenIntegration: Ready
                         baml:
                           bamlDeployment: Ready
                           bamlService: Ready
                           ...
        
      8. Under status: search for endpoints, then check the endpoints. For example:
        endpoints:
                 ...
                 - name: BAW Login URL
                   scope: External
                   type: UI
                   uri: 'https://baw-bawins1.apps.bawdev.mydomain.com/ProcessPortal'
                   ...
      9. You can also check the endpoints in the Details page.
    • Check the status and endpoints from the command line.
      1. To get your deployment name, run the following command:
        oc get ICP4ACluster -n <your_project>
      2. To get the deployment YAML and check the status and endpoints, run the following command:
          oc get ICP4ACluster icp4adeploy -o yaml