跳至主要內容

集群版安装部署

...大约 6 分钟

集群版安装部署

本小节描述如何手动部署包括3个ConfigNode和3个DataNode的实例,即通常所说的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. 有些参数首次启动后不能修改,请参考下方的"参数配置"章节来进行设置。

  3. 推荐部署监控面板,可以对重要运行指标进行监控,随时掌握数据库运行状态,监控面板可以联系商务获取,部署监控面板步骤可以参考:监控面板部署open in new window

准备步骤

  1. 准备IoTDB数据库安装包 :iotdb-enterprise-{version}-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  iotdb-enterprise-{version}-bin.zip
cd  iotdb-enterprise-{version}-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. 激活数据库

方式一:激活文件拷贝激活

  • 依次启动3个confignode节点后,每台机器各自的activation文件夹, 分别拷贝每台机器的system_info文件给天谋工作人员;
  • 工作人员将返回每个ConfigNode节点的license文件,这里会返回3个license文件;
  • 将3个license文件分别放入对应的ConfigNode节点的activation文件夹下;

方式二:激活脚本激活

  • 依次获取3台机器的机器码,分别进入安装目录的sbin目录,执行激活脚本start-activate.sh:

    cd sbin
    ./start-activate.sh
    
  • 显示如下信息,这里显示的是1台机器的机器码 :

    Please copy the system_info's content and send it to Timecho:
    Y17hFA0xRCE1TmkVxILuxxxxxxxxxxxxxxxxxxxxxxxxxxxxW5P52KCccFMVeHTc=
    Please enter license:
    
  • 其他2个节点依次执行激活脚本start-activate.sh,然后将获取的3台机器的机器码都复制给天谋工作人员

  • 工作人员会返回3段激活码,正常是与提供的3个机器码的顺序对应的,请分别将各自的激活码粘贴到上一步的命令行提示处 Please enter license:,如下提示:

    Please enter license:
    Jw+MmF+Atxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5bAOXNeob5l+HO5fEMgzrW8OJPh26Vl6ljKUpCvpTiw==
    License has been stored to sbin/../activation/license
    Import completed. Please start cluster and excute 'show cluster' to verify activation status
    

5. 启动DataNode 节点

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

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

6. 验证部署

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

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

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

出现安装成功界面后,继续看下是否激活成功,使用 show cluster命令

当看到最右侧显示ACTIVATED表示激活成功

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.