Upgrade a Hazelcast deployment

Before upgrading, you should read the information in the rolling upgrade documentation for Hazelcast Platform.

Each Operator version has been tested with a specific Hazelcast Platform version as listed in the following table. You should use the appropriate version to avoid problems.

Operator version Hazelcast Platform version

5.11

5.4.0

5.12

5.4.0

5.13

5.5.0

5.14

5.5.2

5.15

5.5.4

5.16

5.6.0

Upgrade the deployment

To upgrade your existing Hazelcast deployment to a newer version, update the spec.version field and re-apply.

For example, if the following is the existing configuration:

apiVersion: hazelcast.com/v1alpha1
kind: Hazelcast
metadata:
  name: hazelcast-sample
spec:
  clusterSize: 3
  repository: 'docker.io/hazelcast/hazelcast-enterprise'
  version: '5.6.0-slim'

Apply the following to upgrade your Hazelcast version to 5.6.0:

apiVersion: hazelcast.com/v1alpha1
kind: Hazelcast
metadata:
  name: hazelcast-sample
spec:
  clusterSize: 3
  repository: 'docker.io/hazelcast/hazelcast-enterprise'
  version: '5.6.0-slim'

Check the cluster status

You can check that the upgrade has completed by checking the cluster status:

  • Kubernetes

  • Openshift

kubectl get hazelcast
oc get hazelcast
NAME               STATUS    MEMBERS
hazelcast-sample   Running   3/3