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:

  1. Configuration changes, such as added or changed configuration parameters, including the new component’s version

  2. 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

  1. Update the Axual helm repository to download the latest charts available

    helm repo update
    bash

  2. Upgrade Axual Platform

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

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

  1. Update the Axual helm repository to download the latest charts available

    helm repo update
    bash

  2. Upgrade Axual Operator

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

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.

  1. Modify the Kafka version in your values.yaml file

    Example:

    platform:
  core:
    kafka:
      kafka:
        version: 3.4.0
    yaml

  2. 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
    bash

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.