GridGain Developers Hub

My Cluster Screen

My Cluster opens as the first tab of the Dashboard screen when you select Dashboard from the navigation menu. It displays numeric and tabular information for the "current" cluster (selected in the cluster selector tool on the main toolbar).

My Cluster screen

Viewing Cluster Information

Use the widgets to view the relevant cluster information:

Widget Description

Cluster Health

The cluster status:

  • Warnings - at least one of the alerts for the cluster has been triggered

  • Errors - partition loss, PME (Partition Map Exchange) errors, or both

  • Healthy - neither warnings nor errors are observed

Storage

The amount of memory the cluster uses:

  • In-memory

  • On disk

Connections

The cluster connection counters for thin and thick clients. A set of chips for adding connections.

Details

A table of the cluster details, including Type, ID, Owner, etc.

Nodes

A list of cluster’s nodes.

Viewing Cluster Health Details

To view details of the cluster health (status), in the Cluster Health widget, click the View Details link. The Cluster Health Details dialog shows what specific problems, if any, are observed in the cluster.

For GridGain 8 and Apache Ignite clusters:

Cluster health details GridGain 8 and Apache Ignite

For GridGain 9 clusters:

Cluster health details GridGain 9

Viewing Cluster Nodes

The cluster nodes are shown in the Nodes widget at the bottom of the screen.

To auto-size a specific column or all columns in the table, select the corresponding option from the column’s context menu.

To add columns to the table or remove them from the table, select the Table Columns option from the table’s context menu, then select or clear check boxes for the columns on the list that opens.

To define the auto-adjustment timeout, click the Configuration icon above the node list, toggle the auto-adjustment on, then enter the timeout value (in seconds).

GridGain 8 and Apache Ignite

By default, the Nodes widget displays the following columns for GridGain 8 and Apache Ignite clusters:

Column Description

Consistent ID

The consistent ID of the node.

Node ID

The ID of the node.

Status

Whether the node is online. A node that goes down remains registered in the baseline topology until you manually remove it or until it’s removed automatically through baseline autoadjustment.

Node Type

The type of the node: "Coordinator" or "Server."

Baseline

A toggle that enables removing the node from the baseline or adding it to the baseline.

By default, the widget displays only server nodes. To add client nodes to the widget, in the Nodes context menu, toggle on Show client nodes.

GridGain 9

For GridGain 9 clusters, the Nodes widget displays the following columns:

Column Description

Name

The node name.

Node ID

The ID of the node.

Host

The cluster host IP address.

Port

The cluster host port.

CMG

Whether the node is included in Cluster Management Group.

MS

Whether the node is included in the Metastorage Group.

HTTP, HTTPS ports

The ports the node exposes.

Status

Running or Validating - see explanation.

Viewing Graphic Dashboards

To view the default graphic dashboard for the current cluster, click the Default next to the My Cluster tab in the top left corner of the screen.

Switching Between Clusters

If multiple clusters are registered in Control Center, you can switch between clusters by using the Select Cluster control on the top toolbar.

Adding Connections

To add a connection to the cluster, in the Connections widget:

  1. Click the required client/protocol chip.

  2. Proceed to define the new connection.

Sharing Clusters

You can have access to a cluster as:

  • User - a regular user who can view the cluster that had been shared with them individually or via a team, as well as utilize the actions that appear in the cluster’s context menu.

  • Owner - the user who had created or attached the cluster. Owners have extended cluster access rights, including sharing the cluster with teams or users, suspension, removal, etc.

As a cluster owner, you can share that cluster with individual users and/or teams.

Sharing with Users and Teams

To share the current cluster, click Share above the Details widget. The Share Cluster dialog opens.

Share Cluster dialog

The dialog lists users and teams that already have access to the cluster.

In the entry field across the top of the Share Cluster dialog, start typing a Control Center user’s email, an LDAP ID, or a team name. As you type, the incremental search mechanism displays suggestions in a drop-down list. Select one of the suggested users or teams. Alternatively, type the identifier to the end, then click [Enter]. You can add multiple users and/or teams in a single operation. When done, click Share.

The users and teams you have entered appear in the corresponding sections of the Share Cluster dialog. The system notifies the users and team members that a cluster had been shared with them. To close the Share Cluster dialog, click Close.

Stopping a Cluster Share

As a cluster owner, you can stop sharing your cluster with a team or with an individual user (remove access to the cluster that had been previously granted to that team or user).

To stop sharing a cluster with team(s) and/or user(s), click Share above the Details widget.

IN the Share Cluster dialog that opens, select Stop Sharing from the context menu by the required team or user name. In the confirmation dialog, click Stop Sharing.

Activating and Deactivating Cluster

If your current cluster is active, you can deactivate it by selecting the Deactivate option from the context menu next to the Share button, then clicking Deactivate in the confirmation dialog.

If your current cluster is inactive, you can activate it by clicking the Activate button on the top of the screen, then clicking Activate in the confirmation dialog.

Initializing the Cluster

To initialize the attached GridGain 9 cluster:

  1. Click Initialize in the top right corner.

    The Initialize cluster dialog opens.

    Initialize cluster
  2. Add configuration and license file(s) using the Browse button or by dragging and dropping.

  3. Optionally:

    1. Expand the Advanced settings section.

      Advanced settings
    2. Clear the Cluster Management Group (CMG) nodes same as MS nodes check box.

      Advanced settings with checkbox clear
    3. Manually assign MS and CMG nodes.

    4. To reset the MS and CMG nodes to default configurations, click Reset to default.

  4. Click Initialize. The dialog closes. Once the initialization process is completed, the cluster status in the My Cluster screen changes to Active.

Updating Cluster Connection Settings

If you have attached and initialized a GridGain 9 cluster when it was not secure (did not require cluster-level user authentication), AND this cluster became secure afterwards, you need to update the cluster connection settings to support authentication.

To update the cluster connection settings:

  1. From the context menu in the top right corner, select Connection settings.

    Connection settings
  2. In the dialog that opens, enter Username and Password.

  3. Click Save.

Attaching Clusters

To attach a cluster, click + on the top toolbar, then follow the procedure that corresponds to your cluster: