Connecting to Hazelcast Viridian Clusters

To communicate with a cluster, you need a client. Hazelcast offers clients in a variety of languages as well as a command-line client for quick prototyping and scripting.

You can do the following to connect to the cluster:

Download a preconfigured sample client.
Use advanced setup to configure your own client.
Use the SQL browser in Management Center.

Before you Begin

If you’re using a Viridian Dedicated cluster, you need to authorize clients to allow them to connect to your cluster.

Using a Preconfigured Client

Your cluster comes with a downloadable client that’s preconfigured to connect to your cluster.

Sign into the Hazelcast Viridian console and select your cluster.
Click Connect Client.
Select a client.
Follow the on-screen instructions.

For a complete tutorial, see Hazelcast Viridian Hello World.

Using Advanced Setup

Hazelcast offers a variety of clients that you can download and configure yourself. After downloading a client, you’ll need to configure it with your connection credentials.

To connect your own client to the cluster, you need your cluster’s connection credentials.

Sign into the Hazelcast Viridian console and select your cluster.

Go to Connect Client > Advanced setup:

Configuration	Description
Cluster name	A unique name for your cluster.
Discovery token	A unique token that maps to the current IP address of the cluster. Cluster IP addresses may change. This token allows clients to find out the current IP address of the cluster and connect to it.
TLS files (keystore file)	Files for the certificate authority, certificate, and private key that a client needs to authenticate over TLS.
TLS password (Keystore and truststore password)	The password that a client can use to access the private key file.

Configuration

Description

Cluster name

A unique name for your cluster.

Discovery token

A unique token that maps to the current IP address of the cluster. Cluster IP addresses may change. This token allows clients to find out the current IP address of the cluster and connect to it.

TLS files (keystore file)

Files for the certificate authority, certificate, and private key that a client needs to authenticate over TLS.

TLS password (Keystore and truststore password)

The password that a client can use to access the private key file.

The TLS credentials are necessary only if your cluster has TLS enabled. You can find out if your cluster has TLS enabled in the Cluster Details section of your dashboard.

Using the SQL Browser

You can open a SQL shell in your cluster and submit SQL queries directly from your web browser.

Sign into the Hazelcast Viridian console and select your cluster.
Go to SQL.
Enter your SQL queries.

Next Steps

Developer Guide for Hazelcast Viridian.