Upgrading Automation assets

The Operator Lifecycle Manager (OLM) attempts to upgrade an operator when a new version is available to the cluster. If the operator subscription is set to Automatic approval, no action is required. Otherwise, approve the InstallPlan created by OLM to upgrade the operator.

1. Open the OpenShift web console.

2. Click Operators > Installed Operators.

3. Select the Automation assets operator.

4. To approve the InstallPlan, click the Upgrade available link adjacent to the Automation assets operator.

5. At the prompt,click Preview Install Plan, then click Approve.

To upgrade the operator channel:

1. Open the OpenShift web console.

2. Click Operators > Installed Operators.

3. Select the Automation assets operator.

4. In the Subscription Details pane, select the Channel field and change to the new channel. This manual step is required, even when automatic upgrades are configured.

Update the AssetRepository custom resource (installed instance). When Automation assets was installed, the update function may have been configured to either happen automatically, or be done manually. In a situation where an upgraded Automation assets operator might support new versions:

• If your CR spec.version is set to use a channel, and the operator supports a newer version in that channel, your Automation assets deployment is automatically upgraded.

• If your CR spec.version is set to use a specific version, upgrade your instance by updating the spec.version in the AssetRepository CR.

Updating the instance using the Platform UI

Log into the Platform UI and in the navigation menu, click Integration instances to find your installed instance. If your instance can be upgraded, you see a blue information icon that indicates there are new versions available.

To update the version and license of your operand, click the three-dot icon to see available options for editing the CR.

Updating the instance in the OpenShift Console

In the OpenShift web console, click Operators > Installed Operators. Select the IBM Automation foundation assets operator, then click the Asset Repository tab. Your instance should be listed. Click the instance and click the YAML view tab. Update the spec section and update the license and version values.

Roll back to a previous version of the operand with one of these methods (similar to upgrade):

• Update spec.version in the AssetRepository CR.

• Use the Cloud Pak for Integration instance (Platform UI).

Before upgrading, you can choose to migrate information assets to your new installation.

1. Back up your data. Choose which information assets you want to migrate:

   • Remote assets - Click Remotes and note down all remote configurations (git urls, asset types, and so on).

   • Local assets - Delete all remotes so that only local assets remain, then click Browse Assets and download each asset in the list.

2. Install the 2021.4.1 Automation assets.

   Follow the procedure in Automation assets deployment.

3. Restore your data.

   • Remote assets - Click Remotes and recreate all the remotes using the configuration noted down in the first step. See the "Remotes" section in Automation assets deployment for more information.

   • Local assets - Click Browse Assets and select your Automation assets instance. Use Add assets to upload all the assets downloaded in the backup stage.