Get Started with Hazelcast Enterprise
This guide gets you started with Hazelcast Enterprise by explaining installation options, getting a license key, and installing a license key.
|Hazelcast Enterprise is a commercial product that offers additional features to the open source distribution, including the security suite and blue/green deployments for clients. If you’re looking to get started with open source Hazelcast, see Install Hazelcast.|
Hazelcast Enterprise is available in binary ZIP/TAR files, a Docker image, or a JAR file.
Download and extract the binaries.
curl 'https://download.hazelcast.com/enterprise/hazelcast-enterprise-5.1-SNAPSHOT.tar.gz' | tar xvzf -
wget 'https://download.hazelcast.com/enterprise/hazelcast-enterprise-5.1-SNAPSHOT.tar.gz' | tar xvzf -
Download and extract the Hazelcast ZIP file.
Hazelcast runs on Java, which means you can add it as a dependency in your Java project.
The Java package includes both a member API and a Java client API. The member API is for embedded topologies where you want to deploy and manage a cluster in the same Java Virtual Machine (JVM) as your applications. The Java client is for connecting to an existing member in a client/server topology.
Download and install a supported JDK.
We recommend installing the AdoptOpenJDK.
Add the following to your
<repository> <id>private-repository</id> <name>Hazelcast Private Repository</name> <url>https://repository.hazelcast.com/release/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> <dependencies> <dependency> <groupId>com.hazelcast</groupId> <artifactId>hazelcast-enterprise</artifactId> <version>5.1-SNAPSHOT</version> </dependency> </dependencies>
Hazelcast Enterprise requires a license key. You can get a 30-day trial license from the Hazelcast website.
<Hazelcast edition>#<Maximum members>#<License key>
<Hazelcast edition>: Name of the product.
<Maximum members>: Maximum number of members that may use the license at the same time.
<License key>: Machine-readable license key.
The first two strings up to the second hash (#) character are optional. These strings just provide a way for you to know important information about the license key.
For example, both of the following formats are valid:
|These licenses are examples and will not work if you install them on members.|
To use Hazelcast Enterprise, you need to install a license key on your members.
|Hazelcast Enterprise license keys are required only for members. You do not need to set a license key for Java clients that are connected to members.|
Add the following to the
hazelcast.xml file in your
<hazelcast> <license-key>Your Enterprise License Key</license-key> </hazelcast>
Add your license to the
HZ_LICENSEKEY environment variable.
docker run -e HZ_LICENSEKEY=<your_license_key> hazelcast/hazelcast-enterprise:5.1-SNAPSHOT
Add your license to the
Config config = new Config(); config.setLicenseKey( "Your Enterprise License Key" );
Starting a cluster
Writing Data to memory
Reading data from memory
Monitoring a cluster with Management Center
Simulating a member failure
If you need more information about managing your license key, see the following resources:
To explore the features of Hazelcast Enterprise, see the following: