Connecting to Cloud 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 cluster on Cloud Dedicated, you need to authorize clients to allow them to connect to your cluster.

Using a Preconfigured Client

Your cluster comes with the following clients, which are preconfigured to connect to your cluster:

To download any of these clients, complete the following steps:

Sign in to the Cloud console
Select your cluster.
Select the relevant option in the Connect Client section of your Dashboard.

To download the CLC client, select the CLI option.
Follow the on-screen instructions.

For a complete tutorial, see the Cloud Hello World topic.

Configure Your Own Client

You can access the information needed to connect your own clients through the Advanced option.

To obtain the connection credentials for your cluster, complete the following steps:

Sign in to the Cloud console.
Select your cluster.
Select the Advanced option in the Connect Client section of your Dashboard.

The connection credentials display.

The connection credentials consist of the following:

Credential	Description
Cluster Name	A unique name that identifies your cluster. Select the Copy icon (overlapping squares) to copy the Cluster Name to your clipboard.
Discovery Token	A unique token that maps to the current IP address of the cluster. Cluster IP addresses can change. This token allows clients to identify the current IP address of the cluster and connect to it. Select Reveal to display the Discovery Token. Select the Copy icon to copy the Discovery Token to your clipboard.
Keystore and Truststore Password	The password that a client can use to access the private key file. Select Reveal to display the password. Select the Copy icon to copy the password to your clipboard.
Download keystore file	Select to download the files for the certificate authority, certificate, and private key that a client needs to authenticate over TLS.

Credential

Description

Cluster Name

A unique name that identifies your cluster.

Select the Copy icon (overlapping squares) to copy the Cluster Name to your clipboard.

Discovery Token

A unique token that maps to the current IP address of the cluster.

Cluster IP addresses can change. This token allows clients to identify the current IP address of the cluster and connect to it.

Select Reveal to display the Discovery Token. Select the Copy icon to copy the Discovery Token to your clipboard.

Keystore and Truststore Password

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

Select Reveal to display the password. Select the Copy icon to copy the password to your clipboard.

Download keystore file

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

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 Cloud console and select your cluster.
Go to SQL.
Enter your SQL queries.

For full details see Executing SQL Queries.

Next Steps

Developer Guide for Cloud.