快速上手

以本地环境为例，演示 IoTDB 集群的启动、扩容与缩容。

注意：本文档为使用本地不同端口，进行伪分布式环境部署的教程，仅用于练习。在真实环境部署时，一般不需要修改节点端口，仅需配置节点 IPV4 地址或域名即可。

1. 准备启动环境

解压 apache-iotdb-1.0.0-all-bin.zip 至 cluster0 目录。

2. 启动最小集群

在 Linux 环境中，部署 1 个 ConfigNode 和 1 个 DataNode（1C1D）集群版，默认 1 副本：

./cluster0/sbin/start-confignode.sh
./cluster0/sbin/start-datanode.sh

3. 验证最小集群

最小集群启动成功，启动 Cli 进行验证：

./cluster0/sbin/start-cli.sh

在 Cli 执行 show cluster details 指令，结果如下所示：

IoTDB> show cluster details
+------+----------+-------+---------------+------------+-------------------+----------+-------+-----------------+-------------------+-------+
|NodeID|  NodeType| Status|InternalAddress|InternalPort|ConfigConsensusPort|RpcAddress|RpcPort|DataConsensusPort|SchemaConsensusPort|MppPort|
+------+----------+-------+---------------+------------+-------------------+----------+-------+-----------------+-------------------+-------+
|     0|ConfigNode|Running|      127.0.0.1|       22277|              22278|          |       |                 |                   |       |
|     1|  DataNode|Running|      127.0.0.1|        9003|                   | 127.0.0.1|   6667|            40010|              50010|   8777|
+------+----------+-------+---------------+------------+-------------------+----------+-------+-----------------+-------------------+-------+
Total line number = 2
It costs 0.242s

4. 准备扩容环境

解压 apache-iotdb-1.0.0-all-bin.zip 至 cluster1 目录和 cluster2 目录

5. 修改节点配置文件

对于 cluster1 目录：

修改 ConfigNode 配置：

配置项	值
cn_internal_address	127.0.0.1
cn_internal_port	22279
cn_consensus_port	22280
cn_target_config_node_list	127.0.0.1:22277

修改 DataNode 配置：

配置项	值
dn_rpc_address	127.0.0.1
dn_rpc_port	6668
dn_internal_address	127.0.0.1
dn_internal_port	9004
dn_mpp_data_exchange_port	8778
dn_data_region_consensus_port	40011
dn_schema_region_consensus_port	50011
dn_target_config_node_list	127.0.0.1:22277

对于 cluster2 目录：

修改 ConfigNode 配置：

配置项	值
cn_internal_address	127.0.0.1
cn_internal_port	22281
cn_consensus_port	22282
cn_target_config_node_list	127.0.0.1:22277

修改 DataNode 配置：

配置项	值
dn_rpc_address	127.0.0.1
dn_rpc_port	6669
dn_internal_address	127.0.0.1
dn_internal_port	9005
dn_mpp_data_exchange_port	8779
dn_data_region_consensus_port	40012
dn_schema_region_consensus_port	50012
dn_target_config_node_list	127.0.0.1:22277

6. 集群扩容

将集群扩容至 3 个 ConfigNode 和 3 个 DataNode（3C3D）集群版，指令执行顺序为先启动 ConfigNode，再启动 DataNode：

./cluster1/sbin/start-confignode.sh
./cluster2/sbin/start-confignode.sh
./cluster1/sbin/start-datanode.sh
./cluster2/sbin/start-datanode.sh

7. 验证扩容结果

在 Cli 执行 show cluster details，结果如下：

IoTDB> show cluster details
+------+----------+-------+---------------+------------+-------------------+----------+-------+-----------------+-------------------+-------+
|NodeID|  NodeType| Status|InternalAddress|InternalPort|ConfigConsensusPort|RpcAddress|RpcPort|DataConsensusPort|SchemaConsensusPort|MppPort|
+------+----------+-------+---------------+------------+-------------------+----------+-------+-----------------+-------------------+-------+
|     0|ConfigNode|Running|      127.0.0.1|       22277|              22278|          |       |                 |                   |       |
|     2|ConfigNode|Running|      127.0.0.1|       22279|              22280|          |       |                 |                   |       |
|     3|ConfigNode|Running|      127.0.0.1|       22281|              22282|          |       |                 |                   |       |
|     1|  DataNode|Running|      127.0.0.1|        9003|                   | 127.0.0.1|   6667|            40010|              50010|   8777|
|     4|  DataNode|Running|      127.0.0.1|        9004|                   | 127.0.0.1|   6668|            40011|              50011|   8778|
|     5|  DataNode|Running|      127.0.0.1|        9005|                   | 127.0.0.1|   6669|            40012|              50012|   8779|
+------+----------+-------+---------------+------------+-------------------+----------+-------+-----------------+-------------------+-------+
Total line number = 6
It costs 0.012s

8. 集群缩容

缩容一个 ConfigNode：

# 使用 ip:port 移除
./cluster0/sbin/remove-confignode.sh 127.0.0.1:22279

# 使用节点编号移除
./cluster0/sbin/remove-confignode.sh 2

缩容一个 DataNode：

# 使用 ip:port 移除
./cluster0/sbin/remove-datanode.sh 127.0.0.1:6668

# 使用节点编号移除
./cluster0/sbin/remove-confignode.sh 4

9. 验证缩容结果

在 Cli 执行 show cluster details，结果如下：

IoTDB> show cluster details
+------+----------+-------+---------------+------------+-------------------+----------+-------+-----------------+-------------------+-------+
|NodeID|  NodeType| Status|InternalAddress|InternalPort|ConfigConsensusPort|RpcAddress|RpcPort|DataConsensusPort|SchemaConsensusPort|MppPort|
+------+----------+-------+---------------+------------+-------------------+----------+-------+-----------------+-------------------+-------+
|     0|ConfigNode|Running|      127.0.0.1|       22277|              22278|          |       |                 |                   |       |
|     3|ConfigNode|Running|      127.0.0.1|       22281|              22282|          |       |                 |                   |       |
|     1|  DataNode|Running|      127.0.0.1|        9003|                   | 127.0.0.1|   6667|            40010|              50010|   8777|
|     5|  DataNode|Running|      127.0.0.1|        9005|                   | 127.0.0.1|   6669|            40012|              50012|   8779|
+------+----------+-------+---------------+------------+-------------------+----------+-------+-----------------+-------------------+-------+
Total line number = 4
It costs 0.005s