GridGain Developers Hub

Control Center Binary Package

The easiest way to install Control Center is to download the binary package.

Downloading and Installing the Binary Package

  1. Download Control Center 2023.1.1 from GridGain Downloads.

  2. Unpack the archive into a directory of your choice (“installation directory”).

  3. Once you have unpacked the package, launch Control Center by running control-center.sh (or control-center.bat for Windows) in the installation directory.

Control Center starts with the default configuration and listens on the default port (3000). Open http://localhost:3000 in your browser and sign up for an account.

Explicitly Defining Your Work Folder

By default, Control Center stores all data in $CC_ROOT/work. However, we recommend using a folder outside of the default location to simplify update/upgrade operations. To change the default work folder, do one of the following:

  • Define the IGNITE_WORK_DIR environment variable; for example:

    IGNITE_WORK_DIR=/path/to/cc/work $CC_ROOT/control-center.sh

    Define the JAVA_OPTS env variable; for example:

    JAVA_OPTS="${JAVA_OPTS} -DIGNITE_WORK_DIR=/path/to/cc/work" $CC_ROOT/control-center.sh

  • Explicitly define the work folder in $CC_ROOT/ignite-config.xml:

    <bean class="org.apache.ignite.configuration.IgniteConfiguration">
        ...
        <property name="workDirectory" value="/your/path/to/cc-work"/>

Open Port Requirements

For proper Control Center operation, open the following ports:

  • Port 3000 for Control Center backend;

  • Port 8008 for Control Center frontend;

  • You do not need to open any additional ports for clusters.

SSL Configuration

To configure SSL for the on-premise version of GridGain Control Center:

  1. Create an application.properties file in the Control Center root folder.

  2. Add the following lines to the file:

    server.port=
    server.ssl.client-auth=need
    server.ssl.protocol=TLS
    server.ssl.key-store-type=JKS
    server.ssl.key-store=node.jks
    server.ssl.key-store-password={safe_password}
    server.ssl.trust-store-type=JKS
    server.ssl.trust-store=trust.jks
    server.ssl.trust-store-password={safe_password}
  3. Run the following command:

    bash control-center.sh
  4. Control Center will be started at https://localhost:443.