Upgrading Content-Aware Storage (CAS)

Steps to upgrade Content-Aware Storage (CAS) service.

Before you begin

Open the IBM Fusion user interface, go to the Services tab and check the current version of CAS in the Installed section.

Note: You cannot skip version when upgrading CAS to the latest version. For example, if CAS v1.0.4 is installed as your current version, upgrading to v1.1.0 requires an upgrade path of 1.0.4 > 1.0.5 > 1.0.6 > 1.0.7 > 1.1.0.

Procedure

Open the IBM Fusion user interface.
Go to the Services tab. In the Installed section, click Upgrade service in the ellipsis overflow menu of Content-Aware Storage.
Alternatively, you can go to the Settings > Upgrades page, and view the upgrade status and in progress upgrades. If you can run service upgrades in parallel in a non-disruptive manner, click Upgrade (<number of upgrades available>).
In the Upgrade service window, click Upgrade.
The upgrade starts and you can see the upgrade status. After the completion of upgrade, a success notification is displayed.
Note: Wait for a minute or more to see the upgrade status in the Services tab of the IBM Fusion user interface. You can also find the latest version in the Services tab when the upgrade completes.

Upgrade considerations for CAS v1.0.6 and earlier to v1.1.0

If you are upgrading from CAS v1.0.6 or earlier, start by upgrading to CAS v1.0.7 through the IBM Fusion user interface. After IBM Fusion initiates the upgrade, you must manually approve the process in OpenShift® before it can continue to CAS v1.1.0 by following these steps:

Manual approval that is required after CAS v1.0.7
After Fusion completes the upgrade to CAS v1.0.7, the next upgrade step (from v1.0.7 to v1.1.0) does not start automatically.

Before you continue, verify that the CAS subscription in OpenShift is configured as follows:
- Update approval: Manual
OpenShift path:

Operators > Installed Operators > Project: ibm-cas > Content Aware Storage > Subscription
Verify whether CAS v1.0.7 is installed correctly
Before you approve the upgrade to version 1.1.0, verify that the environment is ready. To confirm Kafka readiness for the next upgrade step, ensure that Kafka is running in KRaft mode.
```
oc get kafka -n ibm-cas -o yaml | yq '.items[0].status.kafkaMetadataState'
```
Expected output:
```
KRaft
```
When the value is KRaft, you can approve the next upgrade safely.
Approve upgrade to CAS v1.1.0
1. After confirming readiness, go to Operators > Installed Operators and select the project as ibm-cas.
2. Open Content Aware Storage, go to the Subscription tab, and click 1 requires approval.
3. Select Preview install plan.
4. Click Approve.
The installation process of CAS v1.1.0 is triggered.

While the upgrade is waiting for manual approval in OpenShift, IBM Fusion displays the service status as Upgrading. This behavior is expected. IBM Fusion remains in this state until you approve the upgrade to version 1.1.0 in the OpenShift UI. After approval and installation are complete, IBM Fusion updates the version and marks the service as Healthy.