GridGain Developers Hub

Cluster Configuration Parameters

GridGain 9 cluster configuration is shared across the whole cluster. Regardless of which node you apply the configuration on, it will be propogated to all nodes in the cluster.

Checking Cluster Configuration

To get cluster configuration, use the CLI tool.

  • Start the CLI tool and connect to any node in the cluster.

  • Run the cluster config show command.

The CLI tool will print the full cluster configuration. If you only need a part of the configuration, you can narrow down the search by providing the properties you need as the command argument, for example:

cluster config show transaction

Changing Cluster Configuration

Cluster configuration is changed from the CLI tool. To change the configuration:

  • Start the CLI tool and connect to any node in the cluster.

  • Run the cluster config update command and provide the updated configuration as the command argument, for example:

    cluster config update metaStorage.idleSyncTimeInterval=600

The updated configuration will automatically be applied across the cluster,

Exporting Cluster Configuration

If you need to export cluster configuration to file, use the following command:

bin/gridgain9 cluster config show > cluster-config.txt

Configuration Parameters

Garbage Collection

  "gc" : {
    "batchSize" : 5,
    "lowWatermark" : {
      "dataAvailabilityTime" : 600000,
      "updateFrequency" : 300000
    },
    "threads" : 16
  },
Property Default Description

batchSize

5

Garbage collection batch size.

lowWatermark.dataAvailabilityTime

600000

The duration outdated versions are available for.

lowWatermark.updateFrequency

300000

The frequency of low watermark updates.

threads

16

The number of threads used by garbage collector.

Metastorage Configuration

  "metaStorage" : {
    "idleSyncTimeInterval" : 500
  },
Property Default Description

idleSyncTimeInterval

500

How long it takes to synchronize metastorage.

Metrics Configuration

  "metrics" : {
    "exporters" : [ ]
  },
Property Default Description

exporters

The list of metric exporters currently used. For more information, see Configuring Metrics.

Replication Configuration

  "replication" : {
    "idleSafeTimePropagationDuration" : 1000
  },
Property Default Description

idleSafeTimePropagationDuration

1000

How long it takes for replication of data to be replicated to other nodes in cluster.

Schema Sync Configuration

  "schemaSync" : {
    "delayDuration" : 1000
  },
Property Default Description

delayDuration

1000

The delay between schema being updated and synchronized across the cluster.

Security Configuration

  "security" : {
    "authentication" : {
      "providers" : [ {
        "name" : "default",
        "type" : "basic",
        "users" : [ {
          "password" : "********",
          "roles" : [ "system" ],
          "username" : "ignite",
          "viewName" : "ignite"
        }]
      } ]
    },
    "authorization" : {
      "roles" : [ {
        "name" : "system",
        "privileges" : [ ],
        "viewName" : "system"
      }]
    },
    "enabled" : false,
    "jwt" : {
      "keyTtl" : 1209600000,
      "ttl" : 28800000
    }
  },
Property Default Description

providers.name

The name of the authentication provider.

providers.type

The authentication provider type.

providers.users

The list of users registered in the specific provider.

users.password

User password.

users.roles

The list of roles assigned to the user.

users.username

Case insensitive user name.

users.viewName

Case sensitive user name.

roles.name

Case insensitive role name.

roles.privileges

The list of privileges that are available to users with the role.

roles.viewName

Case sensitive role name.

enabled

false

Defines if authentication is enabled.

jwt.keyTtl

1209600000

TTL for JWT security tokens.

jwt.ttl

28800000

The frequency of private key updates that are used to issue JWT tokens.

SQL Configuration

  "sql" : {
    "statementMemoryQuota" : "10K"
  },
Property Default Description

statementMemoryQuota

10K

The amount of memory that can be used in by a single SQL statement.

Transactions Configuration

  "transaction" : {
    "abandonedCheckTs" : 5000
  }
}
Property Default Description

abandonedCheckTs

5000

The amount of time after which the transaction is considered abandoned.