Migrate Axual Platform to Axual Streaming & Governance

Introduction

This document aims to provide you an overview of the steps required to migrate 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 migration at any checkpoint.

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

Prerequisite

  • You are migrating an Axual platform deployed with Axual Helm Charts 0.17.11

  • You are not overriding any Axual component versions

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

  • You are migrating to Governance Charts 0.3.4

  • You are migrating to Streaming Charts 0.3.4

Steps Overview

The Keycloak migration is not in scope as part of this migration.

  1. Management Stack Migration

    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 Migration

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

  3. Cluster Stack Migration

    1. Start a standalone Cluster-API

    2. Migrate Axual Operator to the Strimzi Operator

    3. Migrate Kafka

  4. Instance Stack Migration

    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 Migration

    1. Disable Platform-UI and Platform-API

    2. Disable Instance-API and Discovery-API

    3. Disable Stream-Browse and Cluster-Browse

  6. Optional Migration

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