18.3.3.3 MySQL Cluster SQL Node and API Node Configuration Parameters

The summary table in this section provides information about parameters used in the [mysqld] and [api] sections of a config.ini file for configuring MySQL Cluster SQL nodes and API nodes. For detailed descriptions and other additional information about each of these parameters, see Section 18.3.2.7, “Defining SQL and Other API Nodes in a MySQL Cluster”.

Note

For a discussion of MySQL server options for MySQL Cluster, see Section 18.3.4.2, “MySQL Server Options for MySQL Cluster”; for information about MySQL server system variables relating to MySQL Cluster, see Section 18.3.4.3, “MySQL Cluster System Variables”.

Restart types.  Changes in MySQL Cluster configuration parameters do not take effect until the cluster is restarted. The type of restart required to change a given parameter is indicated in the summary table as follows:

For more information about restart types, see Section 18.3.3, “Overview of MySQL Cluster Configuration Parameters”.

Table 18.4 SQL Node / API Node Configuration Parameters

Parameter NameType or UnitsRestart TypeIn Version ... (and later)
Default Value
Minimum/Maximum or Permitted Values

ArbitrationDelay

millisecondsNNDB 7.2.0
0
0 / 4294967039 (0xFFFFFEFF)

ArbitrationRank

0-2NNDB 7.2.0
0
0 / 2

AutoReconnect

booleanNNDB 7.2.0
false
true, false

BatchByteSize

bytesNNDB 7.2.1
16K
1024 / 1M

BatchSize

recordsNNDB 7.2.1
256
1 / 992

ConnectionMap

stringNNDB 7.2.0
[none]
...

DefaultHashMapSize

LDM threadsNNDB 7.2.11
3840
0 / 3840

DefaultOperationRedoProblemAction

enumerationSNDB 7.2.10
QUEUE
ABORT, QUEUE

EventLogBufferSize

bytesSNDB 7.2.0
8192
0 / 64K

ExecuteOnComputer

nameSNDB 7.2.0
[none]
...

ExtraSendBufferMemory

bytesNNDB 7.2.0
0
0 / 4294967039 (0xFFFFFEFF)

HeartbeatThreadPriority

stringSNDB 7.2.0
[none]
...

HostName

name or IP addressSNDB 7.2.0
[none]
...

Id

unsignedISNDB 7.2.0
[none]
1 / 255

MaxScanBatchSize

bytesNNDB 7.2.0
256K
32K / 16M

NodeId

unsignedISNDB 7.2.0
[none]
1 / 255

TotalSendBufferMemory

bytesNNDB 7.2.0
256K
0 / 4294967039 (0xFFFFFEFF)

wan

booleanNNDB 7.2.0
false
true, false

Note

To add new SQL or API nodes to the configuration of a running MySQL Cluster, it is necessary to perform a rolling restart of all cluster nodes after adding new [mysqld] or [api] sections to the config.ini file (or files, if you are using more than one management server). This must be done before the new SQL or API nodes can connect to the cluster.

It is not necessary to perform any restart of the cluster if new SQL or API nodes can employ previously unused API slots in the cluster configuration to connect to the cluster.