Upgrading IBM Business Automation Studio

If you installed IBM Business Automation Studio 19.0.3, 20.0.1, or 20.0.2 and want to continue to build applications and services, you can upgrade to the current version. To upgrade, follow this procedure.

About this task

You must also upgrade the playback server. Follow the instructions in Upgrading IBM Business Automation Application Engine.

1. Get the custom resource YAML file that you used to install Business Automation Studio and update it for the new deployment.
   1. Update the bastudio_configuration and resource_registry_configuration sections.
      • Automatic backup for Resource Registry is recommended. See Enabling Resource Registry disaster recovery for configuration information.
      • To update Business Automation Studio with the minimal required values, use the values in Custom resource templates.
        • If you are upgrading from 19.0.3, add admin_user to the bastudio_configuration sections.
        • If you are upgrading from 19.0.3, add admin_user to the playback_server in the bastudio_configuration section.
        • Change the image tags to the new version (for example, 20.0.2.1 or 20.0.3) in all sections.
        • Persistent storage for JMS is enabled by default in 20.0.2 and later versions. If you didn’t enable persistent storage for JMS using a persistent volume (PV) in 19.0.3 or 20.0.1, make the following change to make sure that JMS can be upgraded successfully.
          • If you don’t plan to use persistent storage for JMS in the new version yet, add the following information in the bastudio_configuration section to disable persistent storage for JMS:

            bastudio_configuration:
                jms_server:
                  storage:
                    ## Whether to enable persistent storage for JMS
                    persistent: false

          • If you want to enable persistent storage for JMS in the new version, you don't need to change any values in your custom resource file, because it's enabled by default. However, you must manually delete the JMS stateful sets. To get the JMS stateful sets, run the following command:

            oc get statefulset

            To delete a JMS stateful set, run the following command:

            oc delete pod icp4adeploy-bastudio-authoring-jms

      • To use the full configuration list and customize the values, update the required values in the bastudio_configuration and resource_registry_configuration sections in your custom resource YAML file based on your configuration. For more information, see IBM Business Automation Studio configuration parameters.
      • To make the replica size more than 1 for this cluster, you must enable the shared storage for the Application Engine playback server. For more information, see Implementing storage.
2. Update the configuration sections for other deployments, such as User Management Service (UMS) and Business Automation Navigator. Go to the upgrade page for each deployment and follow the upgrade instructions to update your custom resource YAML file.