GridGain Developers Hub

Attaching a GridGain 9 Cluster

This page explains how to attach a GridGain 9 cluster to Control Center.

You can attach as many clusters as your license supports.

Start the Cluster

  1. Follow the GridGain 9 documentation to start the cluster.

  2. Copy aside the URL address of the cluster as you will need it to connect to the cluster from within Control Center.

Cluster must have open ingress on REST and client ports (10300 and 10800, respectively, in the default configuration) for the Control Center backend to connect.

Enable Connection to Secured Clusters

If your cluster is secured (has SSL/TLS configured), and if it uses self-signed certificates, you need to pass the cluster’s trust store parameters to Control Center. This can be done by setting up the JVM_OPTS environment variable:

JVM_OPTS=-Xms1g -Xmx2g -server -XX:MaxMetaspaceSize=256m -XX:MaxDirectMemorySize=1g -Djavax.net.ssl.trustStore=/some/local/path/truststore.p12 -Djavax.net.ssl.trustStorePassword=changeit

Attach the Cluster to Control Center

To attach the cluster to Control Center:

  1. Click the + icon on the Control Center toolbar.

  2. In he Attach cluster dialog that opens, select the GridGain 9 tab.

    Attach GridGain 9 cluster
  3. In the URL of the GridGain REST API field, enter the cluster URL.

  4. If the node you are connecting to is hidden behind an entity like a NAT or a load balancer, enter that entity’s address(es) in the Client connections field. The format is either host:port or host. Make sure you have mapped the node address to the NAT/balancer address in the cluster.

  5. To enable SSL encryption in Nebula/cluster communications, select the SSL enabled check box.

  6. If you are attaching a secure cluster, enter Username and Password that correspond to the credentials of one of the users included in the cluster configuration.

  7. Click Continue.

    The dialog indicates that the cluster has been found.

    GridGain 9 cluster found
  8. Click Attach.

The attached cluster displays in the My cluster screen.

It’s status is Uninitialized. You must initialize the cluster to enable monitoring and management activities.