A newer version of Hazelcast Platform is available.

View latest

Supported Versions and Compatibilities

6.0-SNAPSHOT 5.5 5.4 5.3 5.2 5.1 5.0

This section provides the supported versions and interoperability of Hazelcast Platform and its modules.

Semantic Versioning

Hazelcast Platform uses semantic versioning where versions appear in the following format:

major.minor.patch

For example, in Platform version 5.2.1, 5 is the major version, 2 is the minor version, and 1 is the patch version.

Semantic versioning separates new releases into three types:

  • Major: This version may include breaking changes.

  • Minor:This version includes backward-compatible functionality.

  • Patch: This version includes backward-compatible bug fixes.

API Compatibility Exceptions

According to semantic versioning, a Platform job written using the Pipeline API in a previous minor version should compile and have the same behavior in later minor versions.

However, note the following exceptions:

  • Classes in the com.hazelcast.jet.core package provide only patch-level compatibility guarantees.

  • Types and methods annotated with @EvolvingApi and @Beta provide only patch-level compatibility guarantee. These are typically new features where the API is subject to further changes.

  • Types and methods annotated with @PrivateApi, and classes in the impl and internal packages do not provide any compatibility guarantees between versions. These APIs are not meant for public use.

Supported Operating Systems

Hazelcast Platform has been tested against the following operating systems.

Table 1. Supported Operating Systems
OS Platform 5.2.5

RHEL 7, 8

✓

Fedora 17, 25

✓

Windows 10, 11[1]

✓

Windows Server 2016, 2019[1]

✓

macOS

✓

Debian

✓

Ubuntu

✓

Solaris[2]

✓

IBM zOS[2]

✓

AIX 7.2[2]

✓

Supported Virtualization Environments

Environment Platform 5.2.5

VMWare 6.x

✓

Docker 18, 19

✓

Kubernetes (1.14.0 or newer)

✓

Supported Public Cloud Environments

Environment Platform 5.2.5

AWS

✓

GCP

✓

Azure

✓

RedHat OpenShift

✓

Supported Java Virtual Machines

Hazelcast Platform runs on Java, and supports the following JDKs. It may run on other JDK distributions which are not listed here.

Table 2. Supported JDKs
JDK Platform 5.2.5

AdoptOpenJDK 11

✓

AdoptOpenJDK 8

✓

Amazon Corretto 17

✓

Amazon Corretto 11

✓

Amazon Corretto 8

✓

Azul Prime (formerly Zing) 8

✓

Azul Core (formerly Zulu) 17

✓

Azul Core (formerly Zulu) 11

✓

Azul Core (formerly Zulu) 8

✓

IBM SDK, Java Technology Edition 8

✓

Oracle 17

✓

Oracle 11

✓

Oracle 8

✓

Red Hat build of OpenJDK 17

✓

Red Hat build of OpenJDK 11

✓

Red Hat build of OpenJDK 8

✓

Microsoft Build of OpenJDK

✓

Compatibility Guarantees

Cluster Members

Hazelcast Platform members operating on the same major and minor Platform version are always compatible, regardless of the patch version.

Each minor version is always compatible with the previous minor version.

Management Center

All 5.x.y versions of Management Center are compatible with Hazelcast Platform 5.x.y versions. But, it’s recommended to use the same version of Management Center as the Hazelcast Platform version in your cluster. For example, Management Center 5.1.1 may not support all the features of Hazelcast Platform 5.2, or vice versa.

Job States

Hazelcast Platform job states are only backward-compatible across the same minor versions. A newer patch version is able to understand the job states only from the previous patch versions of the same minor version.

If you have a running job, using the rolling upgrades feature, you are able to upgrade the cluster to a newer patch version without losing the state of a running job. See Rolling Upgrades. Also note that jobs must be resubmitted after a rolling upgrade to a newer minor version since they don’t run during upgrades. See Submitting Jobs.

Hazelcast clients that submit jobs (currently only Java clients) are compatible with members running on the same minor version. This means that a client using an older or newer patch version is able to connect and submit a job to a cluster that’s running a different patch version.

Command Line Tools

Hazelcast CLI and cluster admin tools are backwards-compatible across the same minor versions.

Configuration Files

XML and YAML configuration files provided with the Hazelcast Platform package are backward-compatible across the same minor versions. After upgrading a cluster to a new minor version, the configuration files for the previous version can be used without any modification.

Names of Metrics

Hazelcast Platform sends metrics to Management Center and other means such as JMX. The names of these metrics may change across minor versions but not between patch versions.

Client Version Compatibilities

Hazelcast Platform has clients implemented in the following languages:

  • Java

  • C++

  • .NET

  • Python

  • Go

  • Node.js

  • Hazelcast Command Line Client (CLC)

The following table lists the compatibilities between client and Platform/IMDG versions.

Table 3. Client Version Compatibilities
Client Platform and/or IMDG

Java 5.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

Java 4.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

Java 3.6.x through 3.12.x

  • IMDG 3.6.x through 3.12.x

C++ 5.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

C++ 4.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

C++ 3.6.x through 3.12.x

  • IMDG 3.6.x through 3.12.x

  • Platform 5.x.y

  • IMDG 4.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

  • IMDG 3.6.x through 3.12.x

Python 5.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

Python 4.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

Python 3.6.x through 3.12.x

  • IMDG 3.6.x through 3.12.x

Node.js 5.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

Node.js 4.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

Node.js 3.6.x through 3.12.x

  • IMDG 3.6.x through 3.12.x

Go 1.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

Go 0.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

CLC 5.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

CLC 1.x.y

  • Platform 5.x.y

  • IMDG 4.x.y

CLC 0.x.y

  • Platform 5.x.y

  • IMDG 4.x.y
1. All clients of Hazelcast Platform can run on Windows systems. Hazelcast Platform’s Jet Engine is not supported.
2. Tested on demand and not 100% guaranteed (One-off, commercially-reasonable efforts support).
lifebuoy

Help and support