未验证 提交 076a8ace 编写于 作者: P Potato 提交者: GitHub

update cluster docs (#3239)

上级 48328e38
......@@ -26,13 +26,24 @@ PLEASE BE DELIBERATE IF YOU RUN IT IN PRODUCT ENVIRONMENT.__
Note: Please install MinGW or WSL or git bash if you are using Windows.
## Example of pseudo-distributed scaffolding for 1 node and 1 replica
### Compile from source code:
```
mvn clean package -DskipTests
chmod -R 777 ./cluster/target/
nohup ./cluster/target/iotdb-cluster-0.13.0-SNAPSHOT/sbin/start-node.sh >/dev/null 2>&1 &
```
### Use the official website release version:
```
curl -O https://mirrors.bfsu.edu.cn/apache/iotdb/0.12.0/apache-iotdb-0.12.0-cluster-bin.zip
unzip apache-iotdb-0.12.0-cluster-bin.zip
cd apache-iotdb-0.12.0-cluster-bin
sed -i -e 's/^seed_nodes=127.0.0.1:9003,127.0.0.1:9005,127.0.0.1:9007$/seed_nodes=127.0.0.1:9003/g' conf/iotdb-cluster.properties
sed -i -e 's/^default_replica_num=3$/default_replica_num=1/g' conf/iotdb-cluster.properties
nohup ./sbin/start-node.sh >/dev/null 2>&1 &
```
## Example of pseudo-distributed scaffolding for 3 nodes and 1 replica
### Compile from source code:
```
mvn clean package -DskipTests
chmod -R 777 ./cluster/target/
......@@ -40,6 +51,8 @@ nohup ./cluster/target/iotdb-cluster-0.13.0-SNAPSHOT/sbin/start-node.sh ./cluste
nohup ./cluster/target/iotdb-cluster-0.13.0-SNAPSHOT/sbin/start-node.sh ./cluster/target/test-classes/node2conf/ >/dev/null 2>&1 &
nohup ./cluster/target/iotdb-cluster-0.13.0-SNAPSHOT/sbin/start-node.sh ./cluster/target/test-classes/node3conf/ >/dev/null 2>&1 &
```
### Use the official website release version:
You can refer to the following example, but starting multiple instances on a single machine requires handling port and data directory conflicts.
## Example of distributed scaffolding for 3 nodes and 3 replicas
......@@ -48,9 +61,10 @@ Note: If there is no public network IP or private network IP, both can be set to
The operation steps are as follows:
1. Make sure ports 6567, 6667, 9003, 9004, 40010, 40011 and 31999 are open on all three nodes.
2. Use 'mvn clean package -pl cluster -am -DskipTests' to compile the distributed module.
3. Send the generated package (iotdb-cluster-0.13.0-SNAPSHOT) to all servers.
1. Use 'mvn clean package -pl cluster -am -DskipTests' to compile the distributed module or directly go into the [website](https://iotdb.apache.org/Download/) to download the latest version.
2. Make sure ports 6567, 6667, 9003, 9004, 40010, 40011 and 31999 are open on all three nodes.
3. Send the package to all servers.
4. Configure all nodes' seed_nodes in conf/iotdb-cluster.properties as "A_private_ip:9003,B_private_ip:9003,C_private_ip:9003"
5. Configure the internal_ip in conf/iotdb-cluster.properties to be the private_ip of each node.
6. Configure the default_replica_num in conf/iotdb-cluster.properties to be 3.
......
......@@ -25,13 +25,24 @@ __集群模式目前是测试版!请谨慎在生产环境中使用。__
如果您在使用Windows系统,请安装MinGW,WSL或者git bash。
## 1节点1副本伪分布式搭建示例
### 源码编译:
```
mvn clean package -DskipTests
chmod -R 777 ./cluster/target/
nohup ./cluster/target/iotdb-cluster-0.13.0-SNAPSHOT/sbin/start-node.sh >/dev/null 2>&1 &
```
### 使用官网发布版本:
```
curl -O https://mirrors.bfsu.edu.cn/apache/iotdb/0.12.0/apache-iotdb-0.12.0-cluster-bin.zip
unzip apache-iotdb-0.12.0-cluster-bin.zip
cd apache-iotdb-0.12.0-cluster-bin
sed -i -e 's/^seed_nodes=127.0.0.1:9003,127.0.0.1:9005,127.0.0.1:9007$/seed_nodes=127.0.0.1:9003/g' conf/iotdb-cluster.properties
sed -i -e 's/^default_replica_num=3$/default_replica_num=1/g' conf/iotdb-cluster.properties
nohup ./sbin/start-node.sh >/dev/null 2>&1 &
```
## 3节点1副本伪分布式搭建示例
### 源码编译:
```
mvn clean package -DskipTests
chmod -R 777 ./cluster/target/
......@@ -39,6 +50,8 @@ nohup ./cluster/target/iotdb-cluster-0.13.0-SNAPSHOT/sbin/start-node.sh ./cluste
nohup ./cluster/target/iotdb-cluster-0.13.0-SNAPSHOT/sbin/start-node.sh ./cluster/target/test-classes/node2conf/ >/dev/null 2>&1 &
nohup ./cluster/target/iotdb-cluster-0.13.0-SNAPSHOT/sbin/start-node.sh ./cluster/target/test-classes/node3conf/ >/dev/null 2>&1 &
```
### 使用官网发布版本:
可以参考以下示例,不过在一台机器上启动多个实例时需要处理好端口和数据目录的冲突。
## 3节点3副本分布式搭建示例
......@@ -46,10 +59,9 @@ nohup ./cluster/target/iotdb-cluster-0.13.0-SNAPSHOT/sbin/start-node.sh ./cluste
注:如果没有公网 ip 或者私网 ip 则两者设置成一致即可, 只需要保证客户端能够访问到服务端即可。
以下为操作步骤:
1. 保证三个节点的 6567, 6667, 9003, 9004, 40010, 40011 和 31999 端口是开放的。
2. 使用 `mvn clean package -pl cluster -am -DskipTests` 编译分布式模块。
3. 将打出来的包(iotdb-cluster-0.13.0-SNAPSHOT)上传到所有的服务器上。
1. 使用 `mvn clean package -pl cluster -am -DskipTests` 编译分布式模块或直接到 [官网](https://iotdb.apache.org/Download/) 下载最新版本。
2. 保证三个节点的 6567, 6667, 9003, 9004, 40010, 40011 和 31999 端口是开放的。
3. 将包上传到所有的服务器上。
4. 配置所有节点 conf/iotdb-cluster.properties 配置文件中的 seed_nodes 为 "A_private_ip:9003,B_private_ip:9003,C_private_ip:9003"
5. 配置所有节点 conf/iotdb-cluster.properties 配置文件中的 internal_ip 为各自节点的 private_ip。
6. 配置所有节点 conf/iotdb-cluster.properties 配置文件中的 default_replica_num 为 3。
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册