Upgrade Axual Platform to Axual Streaming & Governance

Introduction

This document aims to provide you an overview of the steps required to upgrade a running Axual Platform with axual-helm-charts to streaming-charts and governance-charts.

The document highlights the steps for a generic Axual installation, your installation might differ from this example.

After each step, there is a verification phase, that phase is a checkpoint.

You can stop the upgrade at any checkpoint.

We advise contacting us to have a session to tailor the upgrade to your installation.

Prerequisite

  • You are upgrading an Axual Platform deployed with Axual Helm Charts 0.17.9

  • You are not overriding any Axual component versions

  • All Tenants in the Self-Service Databases have wizardCompleted=true

  • You are upgrading to Governance Charts 0.3.4

  • You are upgrading to Streaming Charts 0.3.3

  • Your Keycloak DB is running on MariaDB 10.3.11 version or later

  • Your Keycloak DB is running on MySQL 8.0 version or later

Steps Overview

  1. Management Stack Upgrade

    1. Start a new Management stack with Axual Governance Charts alongside existing Management stack with Axual Helm Charts.

    2. Switch the Management ingress to point to the Management stack started with Axual Governance Charts

    3. Make the Self-Service cluster(s) ready to be used without Cluster API

    4. Make the Self-Service instance(s) ready to be used without Instance API

  2. Browse & Search Upgrade

    1. Make the Platform-UI to use the Topic-Browse instead of the Stream-Browse

  3. Cluster Stack Upgrade

    1. Start a standalone Cluster-API

    2. Upgrade Axual Operator to the Strimzi Operator

    3. Upgrade Kafka

  4. Instance Stack Upgrade

    1. Start new Rest-Proxy and Schema-Registry components

    2. Switch Rest-Proxy and Schema-Registry ingress to new components

    3. Disable old Rest-Proxy and Schema-Registry components

  5. After Upgrade

    1. Disable Platform-UI and Platform-API

    2. Disable Instance-API and Discovery-API

    3. Disable Stream-Browse and Cluster-Browse

  6. Keycloak Upgrade

    1. Install a new Keycloak instance

    2. Configure API Gateway to connect to the new Keycloak

    3. Uninstall the Keycloak using Axual Helm Charts

  7. Optional Upgrade

    1. (Optional) Upgrade Connect control from Application-Operation-Manager to Platform-Manager

    2. (Optional) Upgrade Connects Vault from one per Platform-Manager to one per Axual-Connect