Performing the upgrade using HELM charts

Typical upgrade steps

A lot of the upgrade steps can be performed without impact on your users. Basically, the deployment or upgrade of components is split in two actions:

Configuration changes, such as added or changed configuration parameters, including the new component’s version
Deployment of the upgraded component, using the helm upgrade command.

Performing the upgrade using HELM charts

Step 1 - Upgrade Axual Platform to 0.14.6

Update the Axual helm repository to download the latest charts available
```
helm repo update
```

Upgrade Axual Platform

helm upgrade --install platform axual-stable/platform --version=0.14.6 -n kafka

This command will restart the all axual-platform pods.

Verify the upgrade by checking the pods and their images:

[clusterShortName]-distributor-connect pod uses image: docker.axual.io/axual/distributor:5.0.2
[clusterShortName]-clusterapi pod uses image: docker.axual.io/axual/clusterapi:2.3.0
selfservice-api pod uses image: docker.axual.io/axual-api:7.0.5
selfservice-ui pod uses image: docker.axual.io/axual/axual-frontend:8.0.5

In selfservice-ui the variable for enabling streamBrowse is renamed from streamBrowseAndSearch to streamBrowseEnabled

Once restarted, verify everything is running fine before moving to next step.

Step 2 - Upgrade Axual Operator to 0.10.0

Update the Axual helm repository to download the latest charts available
```
helm repo update
```

Upgrade Axual Operator

helm upgrade --install strimzi --set watchAnyNamespace=true axual-stable/axual-operator --version=0.10.0 -n kafka

This command will restart the strimzi-cluster-operator, zookeeper and kafka pods.

Verify the upgrade by checking the pods and their images:

strimzi-cluster-operator pod uses image: docker.axual.io/axual/strimzi/operator:0.34.0
zookeeper pod uses image: docker.axual.io/axual/strimzi/kafka:0.34.0-kafka-3.3.1
kafka pod uses image: docker.axual.io/axual/strimzi/kafka:0.34.0-kafka-3.3.1

Once restarted, verify everything is running fine before moving to next step.

Step 3 - Upgrade Kafka to 3.4.0

After Axual Operator has been upgraded, Kafka can be upgraded to the latest version supported by Axual: 3.4.0.

Modify the Kafka version in your values.yaml file

Example:

platform:
  core:
    kafka:
      kafka:
        version: 3.4.0

Upgrade Axual platform using the above modified values.yaml.

helm upgrade --install platform axual-stable/platform -f values.yaml --version=0.14.6 -n kafka

Verify the upgrade by checking the pods and their images:

zookeeper pod uses image: docker.axual.io/axual/strimzi/kafka:0.34.0-kafka-3.4.0
kafka pod uses image: docker.axual.io/axual/strimzi/kafka:0.34.0-kafka-3.4.0

Once restarted, verify everything is running fine.

That’s it!

No other steps are required to upgrade or configure the platform components. You can read through the release blog to find out what has changed since the last release and forward it to your colleagues.