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.
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.