MySQL NDB Cluster集群配置文件

2.2NDB集群配置文件

MySQL Cluster的两个配置文件：

my.cnf：为所有的MySQL Cluster可执行文件指定了选项。通过运行在Cluster中的每个可执行文件，必须能够访问该文件。

config.ini：此文件（有时称为全局配置文件）仅由NDB群集管理服务器读取，然后NDB集群管理服务器将其中包含的信息分发给参与集群的所有进程。 config.ini包含集群中涉及的每个节点的描述。包括数据节点的配置参数和集群中所有节点之间的连接的配置参数。

管理服务器不会在每次重新启动管理服务器时读取全局配置文件，而是在第一次启动时缓存配置，此后，只有在满足下列条件之一时才会读取全局配置文件：

（1）使用--initial选项启动管理服务器。  当使用--initial时，全局配置文件重新读取，现有的任何缓存文件会被删除，管理服务器创建一个新的配置缓存。

（2）使用--reload选项启动管理服务器。  --reload选项使管理服务器将其缓存与全局配置文件进行比较。如果它们不同，管理服务器将创建新的配置缓存; 保留现有配置缓存，但不使用。如果管理服务器的缓存和全局配置文件包含相同的配置数据，则使用现有缓存，并且不会创建新缓存。

（3）使用--config-cache = FALSE启动管理服务器。  此禁用 --config-cache（默认情况下启用），可用于强制管理服务器完全绕过配置缓存。在这种情况下，管理服务器会忽略可能存在的配置缓冲，始终从config.ini文件中读取其配置数据 。

（4）找不到配置缓存。  在这种情况下，管理服务器读取全局配置文件并创建包含与文件中相同的配置数据的缓存。

2.2.1定义NDB集群管理节点参数

编辑config.ini文件

vi /var/lib/mysql-cluster/config.ini

[NDB_MGMD]部分用于配置管理节点。如果使用多个管理节点，则可以在一个[ndb_mgmd default]部分中指定所有管理节点的共有参数。

以下参数都是可选的，如果省略则采用其默认值。

NDB Cluster restart types

符号	重启类型	描述
N	Node	可以使用滚动重启来更新该参数。（后面章节会介绍滚动重启步骤）。
S	System	必须完全关闭所有集群节点，然后重新启动，以实现此参数的更改。
I	Initial	必须使用--inital选项重启启动数据节点才能更新该参数。

Property	Value
Version (or later)	NDB 7.5.0
Type or units	unsigned
Default	[none]
Range	1 - 255
Restart Type	IS

（1）NodeId

集群中的每个节点都具有唯一标识。对于管理节点，范围由1到255（包括1和255）范围内的整数值表示。所有集群内部消息都使用此ID来寻址节点。所以无论任何节点类型，每个NDB集群节点都必须是唯一的。

（2）PortNumber

Property	Value
Version (or later)	NDB 7.5.0
Type or units	unsigned
Default	1186
Range	0 - 64K
Restart Type	S

管理服务器侦听配置请求和管理命令的端口号

（3）HostName

Property	Value
Version (or later)	NDB 7.5.0
Type or units	name or IP address
Default	[none]
Range	...
Restart Type	N

定义管理节点的主机名。

（4）LogDestination

Property	Value
Version (or later)	NDB 7.5.0
Type or units	{CONSOLE|SYSLOG|FILE}
Default	[see text]
Range	...
Restart Type	N

指定发送集群日志记录存放的位置。有三个选项CONSOLE、SYSLOG、FILE，FILE是默认值：

CONSOLE：将日志输出到标准输出。

SYSLOG：将日子发送到syslog设备。

FILE将集群日志输出到文件。可以指定以下值：

filename：日志文件名。默认日志文件名为ndb_nodeid_cluster.log。

maxsize：日志文件的最大大小（以字节为单位）。如果超出指定大小，将通过附加.n到文件名来重命名旧的日志文件。

maxfiles：最大日志文件数。

例：FILE:filename=cluster.log,maxsize=1000000,maxfiles=6。

（5）ArbitrationRank

Property	Value
Version (or later)	NDB 7.5.0
Type or units	0-2
Default	1
Range	0 - 2
Restart Type	N

此参数用于定义哪些节点可以充当仲裁器。只有管理节点和SQL节点可以是仲裁者。ArbitrationRank可以采用以下值之一：

0：该节点永远不会用作仲裁程序。

1：节点具有高优先级; 也就是说，它将优先作为低优先级节点上的仲裁器。

2：表示仅在具有较高优先级的节点不可用于此目的时才用作仲裁器的低优先级节点。

通常，应将管理服务器配置为仲裁程序，方法是将其设置ArbitrationRank 为1（管理节点的缺省值），将所有SQL节点的值设置为0（SQL节点的缺省值）。

（6）DataDir

Property	Value
Version (or later)	NDB 7.5.0
Type or units	path
Default	.
Range	...
Restart Type	N

指定放置管理节点的输出文件的目录。这些文件包括集群日志文件，进程输出文件和守护程序的进程ID（PID）文件。（对于日志文件，可以通过设置FILE参数来覆盖此位置）。

2.2.2定义NDB集群数据节点参数

编辑config.ini文件

vi /var/lib/mysql-cluster/config.ini

在[ndbd]与[ndbd default]部分配置数据节点参数。

HostName必须在[ndbd]中定义。其他所有数据节点公用的参数可以在[ndbd_default]中定义,例如参数 NoOfReplicas应该在[ndbd default]部分中定义，因为它对所有Cluster数据节点都是通用的。

重启类型：

符号	重启类型	描述
N	Node	可以使用滚动重启来更新该参数。（后面章节会介绍滚动重启步骤）。
S	System	必须完全关闭所有集群节点，然后重新启动，以实现此参数的更改。
I	Initial	必须使用--inital选项重启启动数据节点才能更新该参数。

下面是数据节点常用的参数：

（1）NodeId

Property	Value
Version (or later)	NDB 7.5.0
Type or units	unsigned
Default	[none]
Range	1 - 48
Restart Type	IS

NodeID用作所有集群内部消息的节点地址。对于数据节点，是1到48（包括1和48）范围内的整数。群集中的每个节点都必须具有唯一标识符。

NodeId是标识数据节点时唯一支持的参数名称。（Id已在NDB 7.5.0中删除。）

（2）HostName

Property	Value
Version (or later)	NDB 7.5.0
Type or units	name or IP address
Default	localhost
Range	...
Restart Type	N

定义数据节点所在的计算机的主机名。

（3）ServerPort

Property	Value
Version (or later)	NDB 7.5.0
Type or units	unsigned
Default	[none]
Range	1 - 64K
Restart Type	S

集群中的每个节点都使用端口连接到其他节点。默认情况下，此端口是动态分配的，以确保同一主机上没有两个节点接收相同的端口号，因此通常不需要为此参数指定值。

但是，如果您需要能够在防火墙中打开特定端口以允许数据节点和API节点（包括SQL节点）之间的通信，则可以将此参数设置为[ndbd]节中所需端口的编号 或（如果需要）为多个数据节点执行此操作）config.ini文件的[ndbd default]部分 ，然后打开具有该编号的端口，用于来自SQL节点，API节点或两者的传入连接。

（4）NoOfReplicas

Property	Value
Version (or later)	NDB 7.5.0
Type or units	integer
Default	2
Range	1 - 4
Restart Type	IS

此全局参数只能在[ndbd default]节中设置，并定义存储在集群中的每个表的副本数。

警告

设置NoOfReplicas为1表示只有一个所有Cluster数据的副本; 在这种情况下，丢失单个数据节点会导致集群失败，因为该节点不存储其他数据副本。此参数的值必须均匀分配到群集中的数据节点数。例如，如果有两个数据节点，则 NoOfReplicas必须等于1或2，因为2/3和2/4都产生小数值; 如果有四个数据节点，则 NoOfReplicas必须等于1,2或4。

（5）DataDir

Property	Value
Version (or later)	NDB 7.5.0
Type or units	path
Default	.
Range	...
Restart Type	IN

此参数指定放置跟踪文件，日志文件，pid文件和??错误日志的目录。

默认值是数据节点进程工作目录。

此参数指定为元数据，REDO日志，UNDO日志（用于磁盘数据表）和数据文件创建的所有文件的目录。默认值是指定的目录DataDir。

注意

在启动ndbd进程之前，此目录必须存在 。

NDB Cluster的推荐目录层次结构包括 /var/lib/mysql-cluster在其下创建节点文件系统的目录。该子目录的名称包含节点ID。例如，如果节点ID为2，则命名此子目录 ndb_2_fs。

（6）BackupDataDir

Property	Value
Version (or later)	NDB 7.5.0
Type or units	path
Default	[see text]
Range	...
Restart Type	IN

指定放置备份的目录。默认备份位置是BACKUP在FileSystemPath参数指定的位置下指定的目录。

（7）DataMemory和IndexMemory

DataMemory和IndexMemory是 [ndbd]指定用于存储实际记录及其索引的内存段大小的参数。

注意

IndexMemory在NDB 7.6中已弃用，并且将在未来版本的NDB Cluster中删除。有关详细信息，请参阅以下说明。

（8）StringMemory

Property	Value
Version (or later)	NDB 7.5.0
Type or units	% or bytes
Default	25
Range	0 - 4294967039 (0xFFFFFEFF)
Restart Type	S

此参数确定为表名等字符串分配的内存量，并在config.ini文件的一个[ndbd]或[ndbd default]部分中 指定 。介于0和100之间的值，被解释为最大默认值的百分比。

在大多数情况下，默认值应该足够了，但是当你有很多 NDB表（1000或更多）时，可能会得到错误773 超出字符串内存，请修改StringMemory配置参数。

2.2.3定义NDB集群SQL节点和其他API节点

config.ini文件中 的[mysqld]和[api] 部分定义MySQL服务器（SQL节点）和用于访问群集数据的其他应用程序（API节点）的行为。所示参数均不是必需的。如果未提供计算机或主机名，则任何主机都可以使用此SQL或API节点。

编辑config.ini文件

vi /var/lib/mysql-cluster/config.ini

重启类型：

符号	重启类型	描述
N	Node	可以使用滚动重启来更新该参数。（后面章节会介绍滚动重启步骤）。
S	System	必须完全关闭所有集群节点，然后重新启动，以实现此参数的更改。
I	Initial	必须使用--inital选项重启启动数据节点才能更新该参数。

下面是SQL节点常用的参数：

（1）NodeId

Property	Value
Version (or later)	NDB 7.5.0
Type or units	unsigned
Default	[none]
Range	1 - 255
Restart Type	IS

NodeId是一个整数值，用于标识所有集群内部消息中的节点。允许的值范围是1到255（包括1和255）。无论节点类型如何，此值对于群集中的每个节点都必须是唯一的。

（2）ConnectionMap

Property	Value
Version (or later)	NDB 7.5.0
Type or units	string
Default	[none]
Range	...
Restart Type	N

 

 

 

 

 

 

 

 

指定要连接的数据节点。

（3）HostName

Property	Value
Version (or later)	NDB 7.5.0
Type or units	name or IP address
Default	[none]
Range	...
Restart Type	N

指定此参数定义SQL节点（API节点）所驻留的计算机的主机名。如果 在文件的给定或部分中没有HostName或未 ExecuteOnComputer指定 ，则SQL或API节点可以使用来自可以与管理服务器主机建立网络连接的任何主机的相应 “ slot”进行连接。

（4）BatchByteSize

Property	Value
Version (or later)	NDB 7.5.0
Type or units	bytes
Default	16K
Range	1K - 1M
Restart Type	N

对于转换为索引的全表扫描或范围扫描的查询，以最佳性能获取正确大小的批处理记录非常重要。可以根据记录数（BatchSize）和字节数（BatchByteSize）来设置适当的大小。实际批量大小受两个参数的限制。

执行查询的速度可能会有40％以上的变化，具体取决于此参数的设置方式。

此参数以字节为单位。默认值为16K。

（5）BatchSize

Property	Value
Version (or later)	NDB 7.5.0
Type or units	records
Default	256
Range	1 - 992
Restart Type	N

此参数以记录数量度量，默认设置为256.最大值为992。