跳至主要內容

单机版部署

...大约 5 分钟

单机版部署

本章将介绍如何启动IoTDB单机实例,IoTDB单机实例包括 1 个ConfigNode 和1个DataNode(即通常所说的1C1D)。

注意事项

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

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

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

安装步骤

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

unzip  iotdb-enterprise-{version}-bin.zip
cd  iotdb-enterprise-{version}-bin

2、参数配置

环境脚本配置

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

系统通用配置

打开通用配置文件(./conf/iotdb-common.properties 文件),设置以下参数:

配置项说明默认值推荐值备注
cluster_name集群名称defaultCluster可根据需要设置集群名称,如无特殊需要保持默认即可首次启动后不可修改
schema_replication_factor元数据副本数,单机版此处设置为 111默认1,首次启动后不可修改
data_replication_factor数据副本数,单机版此处设置为 111默认1,首次启动后不可修改

ConfigNode配置

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

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

DataNode 配置

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

配置项说明默认推荐值备注
dn_rpc_address客户端 RPC 服务的地址0.0.0.0所在服务器的IPV4地址或hostname,推荐使用hostname重启服务生效
dn_rpc_port客户端 RPC 服务的端口66676667重启服务生效
dn_internal_addressDataNode在集群内部通讯使用的地址127.0.0.1所在服务器的IPV4地址或hostname,推荐使用hostname首次启动后不能修改
dn_internal_portDataNode在集群内部通信使用的端口1073010730首次启动后不能修改
dn_mpp_data_exchange_portDataNode用于接收数据流使用的端口1074010740首次启动后不能修改
dn_data_region_consensus_portDataNode用于数据副本共识协议通信使用的端口1075010750首次启动后不能修改
dn_schema_region_consensus_portDataNode用于元数据副本共识协议通信使用的端口1076010760首次启动后不能修改
dn_seed_config_node节点注册加入集群时连接的ConfigNode地址,即cn_internal_address:cn_internal_port127.0.0.1:10710cn_internal_address:cn_internal_port首次启动后不能修改

3、启动 ConfigNode 节点

进入iotdb的sbin目录下,启动confignode

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

4、激活数据库

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

  • 启动confignode节点后,进入activation文件夹, 将 system_info文件复制给天谋工作人员
  • 收到工作人员返回的 license文件
  • 将license文件放入对应节点的activation文件夹下;

方式二:激活脚本激活

  • 获取激活所需机器码,进入安装目录的sbin目录,执行激活脚本:
 cd sbin
./start-activate.sh
  • 显示如下信息,请将机器码(即该串字符)复制给天谋工作人员:
Please copy the system_info's content and send it to Timecho:
Y17hFA0xRCE1TmkVxILuCIEPc7uJcr5bzlXWiptw8uZTmTX5aThfypQdLUIhMljw075hNRSicyvyJR9JM7QaNm1gcFZPHVRWVXIiY5IlZkXdxCVc1erXMsbCqUYsR2R2Mw4PSpFJsUF5jHWSoFIIjQ2bmJFW5P52KCccFMVeHTc=
Please enter license:
  • 将工作人员返回的激活码输入上一步的命令行提示处 Please enter license:,如下提示:
Please enter license:
Jw+MmF+AtexsfgNGOFgTm83BgXbq0zT1+fOfPvQsLlj6ZsooHFU6HycUSEGC78eT1g67KPvkcLCUIsz2QpbyVmPLr9x1+kVjBubZPYlVpsGYLqLFc8kgpb5vIrPLd3hGLbJ5Ks8fV1WOVrDDVQq89YF2atQa2EaB9EAeTWd0bRMZ+s9ffjc/1Zmh9NSP/T3VCfJcJQyi7YpXWy5nMtcW0gSV+S6fS5r7a96PjbtE0zXNjnEhqgRzdU+mfO8gVuUNaIy9l375cp1GLpeCh6m6pF+APW1CiXLTSijK9Qh3nsL5bAOXNeob5l+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目录下,启动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.