Apache IoTDB时序数据库，单机和集群环境搭建那些事儿分享

说到搭建Apache IoTDB，咱们就从最简单的单机版开始聊起，根据IoTDB官网的“快速开始”指南，单机部署真的非常 straightforward，你得确保电脑上已经装好了Java环境，版本得是1.8或者更高，这是它运行的基础,你可以去Oracle或者OpenJDK的网站上下载安装。

就是去Apache IoTDB的官方网站或者镜像站下载最新的发布版本，下载下来的是一个压缩包，比如叫apache-iotdb-1.2.0-bin.zip，你把它解压到你喜欢的任意目录就行，比如在Linux下可以解压到/opt/下面，在Windows下解压到D:\tools\之类的路径，这个解压后的文件夹，就是IoTDB的家了，我们管它叫IOTDB_HOME。

进入IOTDB_HOME目录，你会看到里面有几个重要的文件夹。conf目录是放配置文件的，sbin目录是放启动和停止脚本的，单机版搭建，绝大部分情况你都不需要修改任何配置，直接用默认的就行,特别省心。

启动数据库服务就在命令行里搞定，如果你是Linux或者Mac用户，打开终端，切换到IOTDB_HOME的sbin目录下，运行这个命令：./start-standalone.sh，要是Windows用户呢，就运行start-standalone.bat，运行之后，如果没有报错，屏幕上会打印出一些启动日志，告诉你IoTDB正在启动，最后通常会有一行说服务已经成功启动在某个端口上（默认是6667）。

怎么确认它真的跑起来了呢？有两个小方法，一是用IoTDB自带的命令行客户端工具去连接一下，还是在sbin目录下，运行start-cli.sh（或者Windows下的start-cli.bat），如果连接成功，你会看到一个全新的命令行提示符，比如IoTDB>，这就说明数据库服务没问题，你可以在这里面执行SQL语句玩玩了，另一个方法是打开浏览器，访问http://localhost:18080，这是IoTDB的监控页面，能看到系统的基本状态,证明Web服务也是正常的。

单机版适合自己学习、测试，或者数据量不大的生产环境，但要是数据量特别大，或者对高可用性有要求（就是怕一台机器宕机了服务就彻底停了）,那就得考虑集群版了。

根据IoTDB官方文档关于集群部署的章节，集群搭建比单机要复杂一些，因为它涉及到多台机器之间的协调，IoTDB集群主要依赖两个核心组件：ConfigNode和DataNode，ConfigNode负责管理集群的元数据，比如有哪些DataNode、数据是怎么分布的，相当于集群的“大脑”和“调度中心”，DataNode才是真正存储时序数据和处理读写请求的“干活节点”。

搭建集群的第一步是部署ConfigNode，你需要至少部署一个ConfigNode（生产环境建议至少三个，以防单点故障），在每一台要运行ConfigNode的机器上，你都需要解压一份IoTDB的安装包，关键的一步是修改conf/iotdb-confignode.properties配置文件，里面有几个参数必须设置对，比如config_node_rpc_address要设成本机对的IP地址（不能是127.0.0.1，否则其他机器找不到它），config_node_internal_port是内部通信端口，如果部署多个ConfigNode，你还需要在配置里指定所有ConfigNode的地址列表，让它们能互相发现,组成集群。

配置好后，在每台机器上运行sbin/start-confignode.sh启动ConfigNode，启动成功后，你可以通过REST API或者日志查看集群状态,确认ConfigNode已经正常启动并识别了同伴。

接下来就是部署DataNode了，同样，在计划好的机器上解压安装包，然后修改conf/iotdb-datanode.properties文件，这个文件里，最重要的配置是dn_rpc_address（本机IP）和dn_internal_address（本机IP），还有就是dn_target_config_node_list，这个参数必须指向你已经启动好的那个ConfigNode集群的任意一个节点的地址和端口，这个配置就是告诉DataNode：“快去那个地址找组织报到！”

配置完成后，在每台DataNode机器上运行sbin/start-datanode.sh，DataNode启动后，会自动向ConfigNode注册自己,ConfigNode就会把它纳入集群的管理范围。

等所有的ConfigNode和DataNode都启动完毕，一个基本的IoTDB集群就搭建好了，你可以通过任意一个DataNode的地址和端口（默认6667）用客户端去连接，就像连接单机版一样，集群会自动处理请求的路由和数据的分布，同样，你也可以通过任意节点的18080端口访问监控界面,查看整个集群的健康状况和数据分布情况。

无论是单机还是集群，搭建过程中最容易出错的点往往是一些细节：比如Java环境没装好或者版本不对；防火墙端口没开，导致节点之间无法通信；还有就是配置文件里的IP地址写成了127.0.0.1，这在单机没事，在集群里其他机器就找不到它了，所以搭建的时候，特别是集群,一定要细心检查网络和配置。

IoTDB的单机搭建非常友好，几乎开箱即用，集群搭建虽然步骤多，但思路清晰，只要按照官方文档一步步来，耐心调试,也能成功搞定。