GridGain Developers Hub

Connecting to Demo Cluster

GridGain provides a preconfigured demo you can use to see what a real application look like from within Control Center.

If you already have a GridGain cluster, you can skip this step and connect to your own cluster as described in the next step.

Prerequisites

You will need some tools preconfigured to run the the demo cluster:

  • Docker 19 or later, or Docker Desktop Community 2.3 or later, including Docker Compose 1.25.5 or later

  • Apache Maven 3.3 or later

Download the Demo Project

The demo project has a simple preconfigured GridGain cluster that you can run with Docker and a simple application that simulates load on the cluster. Download, window="_blank" and unzip the demo source repository or use Git to clone the repository:

git clone https://github.com/GridGain-Demos/ignite-streaming-monitoring-demo.git

Start the Demo GridGain Cluster

To start the demo cluster:

  1. Launch Docker.

  2. Open a terminal window and navigate to the root of the demo you have downloaded or cloned.

  3. To start a two-node GridGain cluster, with each node running as a separate container, run:

    docker-compose -f docker/ignite-cluster.yaml up -d --scale ignite-server-node=2

    The cluster nodes will store data in ignite-streaming-monitoring-demo\work\db folder. By default, 150MB is allocated per node.

Prepare for Attachment to Control Center

To work with a local copy of Control Center:

  1. Connect to the container of the first cluster node:

    docker exec -it docker-ignite-server-node-1 bash
  2. Go into the /opt/gridgain/bin/ folder of the container:

    cd /opt/gridgain/bin/
  3. Instruct the cluster to connect to the local Control Center container:

    ./management.sh http://host.docker.internal:3000
  4. Generate a new one-time token to register the cluster with Control Center:

    ./management.sh --token

    The token appears in the response to the --token command:

    Token response
  5. Copy the token aside to use it to Attach Cluster to Control Center.

  6. Quit the node’s container:

    exit

Now, the cluster is configured to work with the local installation of Control Center.

Attach Cluster to Control Center

To attach cluster:

  1. In Control Center, click Attach cluster.

  2. In the Attach cluster wizard that opens:

    1. Make sure you have GridGain selected.

    2. Enter the connection token.

    3. Click Continue.

      The wizard shows the process of the attachment.

      Once the cluster is attached to Control Center, you can see the dashboard with metrics.

  3. Activate your cluster from the Dashboard to enable subsequent steps.

Launch Market Orders Application

Now that the cluster is running and connected, launch the application to simulate load for it. You need Internet connection, as the application will connect to PubNub Market Order data stream.

  1. Create an executable file:

    mvn clean package
  2. Dockerize the application:

    docker build -f docker/StreamingAppDockerfile -t ignite-streaming-app .
  3. Deploy the application in Docker:

    docker-compose -f docker/ignite-streaming-app.yaml up -d

Check Messages

Your cluster should be receiving messages. You can check what those messages are from SQL screen, for example:

SELECT * FROM Trade ORDER BY order_date DESC LIMIT 10;

Next Steps

Now you have a working cluster with some simulated load. Feel free to explore and try various Control Center features. GridGain nodes you launched are running GridGain Community, but you can do the same steps by starting Apache Ignite or GridGain Ultimate nodes.

To explore more feature of Control Center you can: