Preparing for the upgrade

General prerequisites

Before you upgrade to 2021.3, please make sure:

  • you are running Axual version 2021.2. Use axual.sh status to check the current version.

  • you are performing the deployment with Axual CLI 2021.3

Below you will find specific prerequisites for services that are upgraded or introduced in release 2021.3.

Unset overridden versions

For every component upgrade step, make sure you have not overridden the version of the component, which you might have done as a result or a security update or patch release upgrade. Find below a list of all the platform components and the name of the file where the versions are specified. Make sure all versions are commented out, to make sure the Axual CLI upgrade takes care of starting the right version for the 2021.3 release.

Table 1. Component version file names
Component File names Configuration variable

Broker

platform-config/clusters/{cluster-name}/broker.sh

BROKER_VERSION

Cluster API

platform-config/clusters/{cluster-name}/cluster-api.sh

CLUSTER_API_VERSION

Cluster Browse

platform-config/clusters/{cluster-name}/cluster-browse.sh

CLUSTER_BROWSE_VERSION

Axual Connect

platform-config/tenants/{tenant-name}/instances/{instance-name}/connect.sh

AXUAL_CONNECT_VERSION

Discovery API

platform-config/tenants/{tenant-name}/instances/{instance-name}/disccovery-api.sh

DISCOVERYAPI_VERSION

Exhibitor

platform-config/clusters/{cluster-name}/exhibitor.sh

EXHIBITOR_VERSION

Instance API

platform-config/tenants/{tenant-name}/instances/{instance-name}/instance-api.sh

INSTANCEAPI_VERSION

Platform Metric Provider

platform-config/clusters/{cluster-name}/platform-metric-provider.sh

METRIC_PROVIDER_VERSION

REST Proxy

platform-config/tenants/{tenant-name}/instances/{instance-name}/rest-proxy.sh

RESTPROXY_VERSION

Stream Browse

platform-config/clusters/{cluster-name}/stream-browse.sh

STREAM_BROWSE_VERSION

Management API

platform-config/clusters/{cluster-name}/mgmt-api.sh

MGMT_API_VERSION

Management UI

platform-config/clusters/{cluster-name}/mgmt-ui.sh

MGMT_UI_VERSION

Operation Manager

platform-config/clusters/{cluster-name}/operation-manager.sh

OPERATION_MANAGER_VERSION

Schema Registry (master & slave)

platform-config/tenants/{tenant-name}/instances/{instance-name}/schemaregistry.sh

SCHEMAREGISTRY_VERSION

Next step: Performing the upgrade

This concludes the preparation for the 2021.3 upgrade. You may now continue Performing the Upgrade.