Upgrading IBM Business Automation Studio

If you installed the previous version of IBM Business Automation Studio and you 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.

Procedure

  1. Get the custom resource YAML file that you used to install Business Automation Studio and update it for the new deployment.
    Update the bastudio_configuration and resource_registry_configuration sections.
    • To update Business Automation Studio with the minimal required values, use the values in Custom resource templates.
      • For a full release, update the release version and appVersion to the new version (for example, 21.0.3).
      • For an interim fix (for example, 21.0.2 IF001), update only the appVersion to the new version (for example, 21.0.2.1).
    • In 21.0.2, updates were made to ensure a consistent hostname for all components. An example of a hostname update would be a change from bas.test1.9.x.x.x.nip.io to bas-test1.9.x.x.x.nip.io.
      If you want to keep the hostname that you defined in a previous release, add the hostname attribute under the bastudio_configuration section. For example:
      bastudio_configuration:
           hostname: "bas.test1.9.x.x.x.nip.io"
      
      For the playback server, add the hostname under the bastudio_configuration.playback_server section. For example:
      bastudio_configuration:
          playback_server
              hostname: "ae-pbk.test1.9.x.x.x.nip.io"
      
      For IBM Resource Registry, add the hostname under the resource_registry_configuration section. For example:
      resource_registry_configuration:
          hostname: "rr.test1.9.x.x.x.nip.io"
    • 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.
  2. Update the configuration sections for other deployments, such as Business Automation Navigator. Go to the upgrade page for each deployment and follow the upgrade instructions to update your custom resource YAML file.

What to do next

Continue to configure the other capabilities that are in your CR file, and make sure that you complete the last step Validating the YAML in your custom resource file before you apply the CR to the operator.