跳至主要內容

集群版安装部署

...大约 5 分钟

集群版安装部署

本小节将以IoTDB经典集群部署架构3C3D(3个ConfigNode和3个DataNode)为例,介绍如何部署集群,即通常所说的3C3D集群。3C3D集群架构图如下:

注意事项

  1. 部署时推荐优先使用hostname进行IP配置,可避免后期修改主机ip导致数据库无法启动的问题。设置hostname需要在目标服务器上配置/etc/hosts,如本机ip是192.168.1.3,hostname是iotdb-1,则可以使用以下命令设置服务器的 hostname,并使用hostname配置IoTDB的cn_internal_addressdn_internal_address

    echo "192.168.1.3  iotdb-1" >> /etc/hosts 
    
  2. 有些参数首次启动后不能修改,请参考下方的"参数配置"章节来进行设置。

准备步骤

  1. 准备IoTDB数据库安装包 :apache-iotdb-{version}-all-bin.zip(安装包获取见:链接open in new window

  2. 按环境要求配置好操作系统环境(系统环境配置见:链接open in new window

安装步骤

假设现在有3台linux服务器,IP地址和服务角色分配如下:

节点ip主机名服务
192.168.1.3iotdb-1ConfigNode、DataNode
192.168.1.4iotdb-2ConfigNode、DataNode
192.168.1.5iotdb-3ConfigNode、DataNode

1. 设置主机名

在3台机器上分别配置主机名,设置主机名需要在目标服务器上配置/etc/hosts,使用如下命令:

echo "192.168.1.3  iotdb-1"  >> /etc/hosts
echo "192.168.1.4  iotdb-2"  >> /etc/hosts
echo "192.168.1.5  iotdb-3"  >> /etc/hosts 

2. 参数配置

解压安装包并进入安装目录

unzip  apache-iotdb-{version}-all-bin.zip 
cd  apache-iotdb-{version}-all-bin

环境脚本配置

  • ./conf/confignode-env.sh 配置

    配置项说明默认值推荐值备注
    MEMORY_SIZEIoTDB ConfigNode节点可以使用的内存总量可按需填写,填写后系统会根据填写的数值来分配内存重启服务生效
  • ./conf/datanode-env.sh 配置

    配置项说明默认值推荐值备注
    MEMORY_SIZEIoTDB DataNode节点可以使用的内存总量可按需填写,填写后系统会根据填写的数值来分配内存重启服务生效

通用配置

打开通用配置文件./conf/iotdb-common.properties,可根据部署方式设置以下参数:

配置项说明192.168.1.3192.168.1.4192.168.1.5
cluster_name集群名称defaultClusterdefaultClusterdefaultCluster
schema_replication_factor元数据副本数,DataNode数量不应少于此数目333
data_replication_factor数据副本数,DataNode数量不应少于此数目222

ConfigNode 配置

打开ConfigNode配置文件./conf/iotdb-confignode.properties,设置以下参数

配置项说明默认推荐值192.168.1.3192.168.1.4192.168.1.5备注
cn_internal_addressConfigNode在集群内部通讯使用的地址127.0.0.1所在服务器的IPV4地址或hostname,推荐使用hostnameiotdb-1iotdb-2iotdb-3首次启动后不能修改
cn_internal_portConfigNode在集群内部通讯使用的端口1071010710107101071010710首次启动后不能修改
cn_consensus_portConfigNode副本组共识协议通信使用的端口1072010720107201072010720首次启动后不能修改
cn_seed_config_node节点注册加入集群时连接的ConfigNode 的地址,cn_internal_address:cn_internal_port127.0.0.1:10710第一个CongfigNode的cn_internal_address:cn_internal_portiotdb-1:10710iotdb-1:10710iotdb-1:10710首次启动后不能修改

DataNode 配置

打开DataNode配置文件 ./conf/iotdb-datanode.properties,设置以下参数:

配置项说明默认推荐值192.168.1.3192.168.1.4192.168.1.5备注
dn_rpc_address客户端 RPC 服务的地址0.0.0.00.0.0.00.0.0.00.0.0.00.0.0.0重启服务生效
dn_rpc_port客户端 RPC 服务的端口66676667666766676667重启服务生效
dn_internal_addressDataNode在集群内部通讯使用的地址127.0.0.1所在服务器的IPV4地址或hostname,推荐使用hostnameiotdb-1iotdb-2iotdb-3首次启动后不能修改
dn_internal_portDataNode在集群内部通信使用的端口1073010730107301073010730首次启动后不能修改
dn_mpp_data_exchange_portDataNode用于接收数据流使用的端口1074010740107401074010740首次启动后不能修改
dn_data_region_consensus_portDataNode用于数据副本共识协议通信使用的端口1075010750107501075010750首次启动后不能修改
dn_schema_region_consensus_portDataNode用于元数据副本共识协议通信使用的端口1076010760107601076010760首次启动后不能修改
dn_seed_config_node节点注册加入集群时连接的ConfigNode地址,即cn_internal_address:cn_internal_port127.0.0.1:10710第一个CongfigNode的cn_internal_address:cn_internal_portiotdb-1:10710iotdb-1:10710iotdb-1:10710首次启动后不能修改

3. 启动ConfigNode节点

先启动第一个iotdb-1的confignode, 保证种子confignode节点先启动,然后依次启动第2和第3个confignode节点

cd sbin
./start-confignode.sh    -d      #“-d”参数将在后台进行启动 

4. 启动DataNode 节点

分别进入iotdb的sbin目录下,依次启动3个datanode节点:

cd sbin
./start-datanode.sh   -d   # “-d”参数将在后台进行启动  

5. 验证部署

可直接执行./sbin目录下的Cli启动脚本:

./start-cli.sh  -h  ip(本机ip或域名)  -p  端口号(6667)

成功启动后,出现如下界面显示IOTDB安装成功。

​ 可以使用show cluster 命令查看集群信息:

Copyright © 2024 The Apache Software Foundation.
Apache IoTDB, IoTDB, Apache, the Apache feather logo, and the Apache IoTDB project logo are either registered trademarks or trademarks of The Apache Software Foundation in all countries

Have a question? Connect with us on QQ, WeChat, or Slack. Join the community now.