GridGain Developers Hub

Frequently Asked Questions

This section contains answers to common questions and recommendations for common issues.

Control Center lost connection to my cluster after restart

The most common case for this is the cluster ID change. It can happen during the restart of an in-memory cluster, or if persistent data storage was lost for a persistent cluster.

If this happened, you can reattach the cluster and continue monitoring it. However, previously collected data and configuration settings will be lost. To avoid losing cluster information, configure a persistent cluster ID on your GridGain cluster.

Preserving Cluster ID

Without a global team:

For this example, we will assume that Control Center is running on http://mydomain.com:3000.

When starting the cluster, you need to prepare secret, cluster id and cluster tag:

  • Start your cluster and activate.

  • Run the following commands in this order:

    control.bat --property set --name control-center-agent-cluster-secret --val 88f5ea3c-9e50-11ec-b909-0242ac120002 --yes
    control.bat --change-id 11111111-1111-1111-1111-111111111111 --yes
    control.bat --change-tag prod_cluster --yes
    management.bat --uri http://somedomain.com:3000
  • Use the token command once and attach your cluster:

    management.bat --token

If you lose persistence, next time just run all commands except --token again.

With the global team

First, you need to configure the link:https://www.gridgain.com/docs/control-center/latest/managing/teams/teams#global-teams [global team] in Control Center with the account.globalTeam.enabled and account.globalTeam.attachCluster properties. With it configured, you no longer need to create a token.

  • Start your cluster and activate it.

  • Run the following commands in the order you see:

    control.sh --property set --name control-center-agent-cluster-secret --val 88f5ea3c-9e50-11ec-b909-0242ac120002 --yes
    control.sh --change-id 11111111-1111-1111-1111-111111111111 --yes
    control.sh --change-tag prod_cluster --yes

How can I automate connection of clusters to Control Center?

For persistent clusters, you only need to enable the Control Center Global Team by enabling the account.globalTeam.enabled and account.globalTeam.attachCluster properties.

For in-memory clusters, consider adding a small persistent data region. It can be used to store system information, while your caches are still in-memory. If this is not possible, set cluster secret, ID, and other properties after each cluster restart by using the control script. To do this, run the following commands when starting the cluster:

control.sh --property --set --name secret --val UUID
control.sh --change-id UUID

Unless you configure your proxy to allow requests through, you will get 403 error when Control Center agents will try to access Control Center server. Here is an example of nginx configuration file that allows for SSL:

upstream <upstream_name> {
     server <control_center_host>:<control_center_port>;
}
server {
  server_name <proxy_server_hostname>;
  listen 9443 ssl;
  ssl_certificate     /etc/nginx/certs/ssl_test_certs/ggcc.crt;
  ssl_certificate_key /etc/nginx/certs/ssl_test_certs/ggcc.nopass.key;
  ssl_protocols       TLSv1.2;
  ssl_ciphers         HIGH:!aNULL:!MD5;
  access_log /var/log/nginx/access.log;
  error_log /var/log/nginx/error.log;
  location / {
    proxy_pass https://<upstream_name>;
    proxy_set_header Host $host;
  }
  location /api/v1 {
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_pass https://<upstream_name>;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
  location /socket.io {
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_http_version 1.1;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_pass https://<upstream_name>;
  }
  location /browsers {
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_pass_header X-XSRF-TOKEN;
    proxy_pass https://<upstream_name>;
    proxy_set_header Origin https://<upstream_name>;
  }
  location /agents {
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_http_version 1.1;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $host;
    proxy_pass https://<upstream_name>;
  }
}

How do I contact support?

To contact support from the UI, use the Contact Us button in top-right of the screen. You can also send an e-mail to support.cloud@gridgain.com. Our team is constantly monitoring feedback.

Contact Us