diff --git a/deployment/cluster-config/cluster-config-docker.md b/deployment/cluster-config/cluster-config-docker.md index e0ac33b702a6406ebfe43b3d730cfa413a6379da..0d067dde9e5fe21268cbdd91ccd071352600ab49 100644 --- a/deployment/cluster-config/cluster-config-docker.md +++ b/deployment/cluster-config/cluster-config-docker.md @@ -39,7 +39,7 @@ id: cluster-config-docker - /bin/bash - -c - | - /kaiwudb/bin/kwbase start-single-node --certs-dir= --listen-addr=0.0.0.0:26257 --advertise-addr=your-host-ip:port --store=/kaiwudb/deploy/kwdb-container --cache=25% + /kaiwudb/bin/kwbase start-single-node --certs-dir= --listen-addr=0.0.0.0:26257 --brpc-addr=:27257 --advertise-addr=your-host-ip:port --store=/kaiwudb/deploy/kwdb-container --cache=25% ``` 4. 保存配置, 重新创建并启动 KWDB 容器。 diff --git a/deployment/cluster-deployment/docker-deployment.md b/deployment/cluster-deployment/docker-deployment.md index ec28c806ba0fbe9119115a069b6f54b25f4c6cdb..658b269ac4b0db442a8e1c1c3f1f358d3a0027a2 100644 --- a/deployment/cluster-deployment/docker-deployment.md +++ b/deployment/cluster-deployment/docker-deployment.md @@ -56,37 +56,43 @@ id: docker-deployment # 启动第一个容器 docker run -d --name kwdb1 --privileged \ --ulimit memlock=-1 --ulimit nofile=1048576 \ - -p 26257:26257 -p 8080:8080 \ - -v /var/lib/kwdb1:/kaiwudb/deploy/kwdb-container \ + -p 26257:26257 \ + -p 27257:27257 \ + -p 8080:8080 \ + -v /var/lib/kaiwudb1:/kaiwudb/deploy/kwdb-container \ -v /dev:/dev \ --ipc shareable -w /kaiwudb/bin \ \ ./kwbase start --insecure --listen-addr=0.0.0.0:26257 \ - --advertise-addr=:26257 --http-addr=0.0.0.0:8080 \ + --advertise-addr=:26257 --brpc-addr=:27257 --http-addr=0.0.0.0:8080 \ --store=/kaiwudb/deploy/kwdb-container --join :26257 # 启动第二个容器 docker run -d --name kwdb2 --privileged \ --ulimit memlock=-1 --ulimit nofile=1048576 \ - -p 26258:26257 -p 8081:8080 \ + -p 26258:26257 \ + -p 27258:27258 \ + -p 8081:8080 \ -v /var/lib/kaiwudb2:/kaiwudb/deploy/kwdb-container \ -v /dev:/dev \ --ipc shareable -w /kaiwudb/bin \ \ ./kwbase start --insecure --listen-addr=0.0.0.0:26257 \ - --advertise-addr=:26258 --http-addr=0.0.0.0:8080 \ + --advertise-addr=:26258 --brpc-addr=:27258 --http-addr=0.0.0.0:8080 \ --store=/kaiwudb/deploy/kwdb-container --join :26257 # 启动第三个容器 docker run -d --name kwdb3 --privileged \ --ulimit memlock=-1 --ulimit nofile=1048576 \ - -p 26259:26257 -p 8082:8080 \ + -p 26259:26257 \ + -p 27259:27259 \ + -p 8082:8080 \ -v /var/lib/kaiwudb3:/kaiwudb/deploy/kwdb-container \ -v /dev:/dev \ --ipc shareable -w /kaiwudb/bin \ \ ./kwbase start --insecure --listen-addr=0.0.0.0:26257 \ - --advertise-addr=:26259 --http-addr=0.0.0.0:8080 \ + --advertise-addr=:26259 --brpc-addr=:27259 --http-addr=0.0.0.0:8080 \ --store=/kaiwudb/deploy/kwdb-container --join :26257 ``` @@ -96,40 +102,46 @@ id: docker-deployment # 启动第一个容器 docker run -d --name kwdb1 --privileged \ --ulimit memlock=-1 --ulimit nofile=1048576 \ - -p 26257:26257 -p 8080:8080 \ + -p 26257:26257 \ + -p 27257:27257 \ + -p 8080:8080 \ -v /etc/kaiwudb/certs: \ - -v /var/lib/kwdb1:/kaiwudb/deploy/kwdb-container \ + -v /var/lib/kaiwudb1:/kaiwudb/deploy/kwdb-container \ -v /dev:/dev \ --ipc shareable -w /kaiwudb/bin \ \ ./kwbase start --certs-dir= --listen-addr=0.0.0.0:26257 \ - --advertise-addr=:26257 --http-addr=0.0.0.0:8080 \ + --advertise-addr=:26257 --brpc-addr=:27257 --http-addr=0.0.0.0:8080 \ --store=/kaiwudb/deploy/kwdb-container --join :26257 # 启动第二个容器 docker run -d --name kwdb2 --privileged \ --ulimit memlock=-1 --ulimit nofile=1048576 \ - -p 26258:26257 -p 8081:8080 \ + -p 26258:26257 \ + -p 27258:27258 \ + -p 8081:8080 \ -v /etc/kaiwudb/certs: \ -v /var/lib/kaiwudb2:/kaiwudb/deploy/kwdb-container \ -v /dev:/dev \ --ipc shareable -w /kaiwudb/bin \ \ ./kwbase start --certs-dir= --listen-addr=0.0.0.0:26257 \ - --advertise-addr=:26258 --http-addr=0.0.0.0:8080 \ + --advertise-addr=:26258 --brpc-addr=:27258 --http-addr=0.0.0.0:8080 \ --store=/kaiwudb/deploy/kwdb-container --join :26257 # 启动第三个容器 docker run -d --name kwdb3 --privileged \ --ulimit memlock=-1 --ulimit nofile=1048576 \ - -p 26259:26257 -p 8082:8080 \ + -p 26259:26257 \ + -p 27259:27259 \ + -p 8082:8080 \ -v /etc/kaiwudb/certs: \ -v /var/lib/kaiwudb3:/kaiwudb/deploy/kwdb-container \ -v /dev:/dev \ --ipc shareable -w /kaiwudb/bin \ \ ./kwbase start --certs-dir= --listen-addr=0.0.0.0:26257 \ - --advertise-addr=:26259 --http-addr=0.0.0.0:8080 \ + --advertise-addr=:26259 --brpc-addr=:27259 --http-addr=0.0.0.0:8080 \ --store=/kaiwudb/deploy/kwdb-container --join :26257 ``` @@ -139,9 +151,9 @@ id: docker-deployment - `--privileged`：给予容器扩展权限。 - `--ulimit memlock=-1`：取消容器内存大小限制。 - `--ulimit nofile=1048576`：设置容器内进程可以打开的最大文件数。 - - `-p`：端口映射，分别映射数据库服务端口（26257）和 HTTP 端口（8080）。 + - `-p`：端口映射，分别映射数据库服务端口（26257）、brpc 端口和 HTTP 端口（8080）。**注意**：容器内外 brpc 端口必须保持一致。 - `-v`：设置容器目录映射： - - 将主机的 `/var/lib/kaiwudb` 目录挂载到容器内的 `/kaiwudb/deploy/kwdb-container` 目录，用于持久化数据存储。 + - 将主机的 `/var/lib/kaiwudbX` 目录挂载到容器内的 `/kaiwudb/deploy/kwdb-container` 目录，用于持久化数据存储。 - 安全模式下，将主机的 `/etc/kaiwudb/certs` 目录挂载到容器内的 `` 目录，用于存放证书和密钥。 - `--ipc shareable`：允许其他容器共享此容器的IPC命名空间。 - `-w /kaiwudb/bin`：将容器内的工作目录设置为 `/kaiwudb/bin`。 @@ -151,6 +163,7 @@ id: docker-deployment - `--certs-dir=`：（安全模式）证书目录位置。 - `--listen-addr=0.0.0.0:26257`：数据库监听的地址和端口。 - `--advertise-addr=:2625X`：数据库向集群中其他节点通信的地址和端口。 + - `--brpc-addr=:2725X`：时序引擎间的 brpc 通信端口，用于节点间通信。 - `--http-addr=0.0.0.0:8080`：HTTP 接口监听的地址和端口。 - `--store=/kaiwudb/deploy/kwdb-container`：指定数据存储位置。 - `--join :26257`：节点连接集群的地址，可指定集群中的一个或多个节点。 diff --git a/deployment/cluster-deployment/kwbase-cli-deployment.md b/deployment/cluster-deployment/kwbase-cli-deployment.md index 06b7b9fd01c0d73b56cd13be7eba19d800fc1343..b124225aaf434f81e2492e5f961f7c1e56a1ec17 100644 --- a/deployment/cluster-deployment/kwbase-cli-deployment.md +++ b/deployment/cluster-deployment/kwbase-cli-deployment.md @@ -59,6 +59,7 @@ id: kwbase-cli-deployment ./kwbase start-single-replica --insecure \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26257 \ + --brpc-addr=:27257 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 @@ -67,6 +68,7 @@ id: kwbase-cli-deployment ./kwbase start-single-replica --insecure \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26258 \ + --brpc-addr=:27258 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 @@ -75,6 +77,7 @@ id: kwbase-cli-deployment ./kwbase start-single-replica --insecure \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26259 \ + --brpc-addr=:27259 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 @@ -88,6 +91,7 @@ id: kwbase-cli-deployment --certs-dir= \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26257 \ + --brpc-addr=:27257 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 @@ -97,6 +101,7 @@ id: kwbase-cli-deployment --certs-dir= \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26258 \ + --brpc-addr=:27258 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 @@ -106,6 +111,7 @@ id: kwbase-cli-deployment --certs-dir= \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26259 \ + --brpc-addr=:27259 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 @@ -120,6 +126,7 @@ id: kwbase-cli-deployment ./kwbase start --insecure \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26257 \ + --brpc-addr=:27257 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 @@ -128,6 +135,7 @@ id: kwbase-cli-deployment ./kwbase start --insecure \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26258 \ + --brpc-addr=:27258 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 @@ -136,6 +144,7 @@ id: kwbase-cli-deployment ./kwbase start --insecure \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26259 \ + --brpc-addr=:27259 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 @@ -149,6 +158,7 @@ id: kwbase-cli-deployment --certs-dir= \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26257 \ + --brpc-addr=:27257 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 @@ -158,6 +168,7 @@ id: kwbase-cli-deployment --certs-dir= \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26258 \ + --brpc-addr=:27258 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 @@ -167,6 +178,7 @@ id: kwbase-cli-deployment --certs-dir= \ --listen-addr=0.0.0.0:26257 \ --advertise-addr=:26259 \ + --brpc-addr=:27259 \ --http-addr=0.0.0.0:8080 \ --store=/var/lib/kaiwudb \ --join=:26257 diff --git a/deployment/cluster-deployment/script-deployment.md b/deployment/cluster-deployment/script-deployment.md index 9976b6f3d6f839662f6c4dd042ad51abd16bf347..0598f1e70cb5c3542d530be6d42bde30eeb1ce69 100644 --- a/deployment/cluster-deployment/script-deployment.md +++ b/deployment/cluster-deployment/script-deployment.md @@ -34,6 +34,7 @@ id: script-deployment secure_mode=tls management_user=kaiwudb rest_port=8080 + brpc_port=27257 kaiwudb_port=26257 data_root=/var/lib/kaiwudb @@ -55,6 +56,7 @@ id: script-deployment - `management_user`：KWDB 的管理用户，默认为 `kaiwudb`。安装部署后，KWDB 创建相应的管理用户以及和管理用户同名的用户组。 - `rest_port`：KWDB Web 服务端口，默认为 `8080`。 - `kaiwudb_port`：KWDB 服务端口，默认为 `26257`。 + - `brpc_port`：KWDB 时序引擎间的 brpc 通信端口，用于节点间通信，默认为 `27257`。 - `data_root`：数据目录，默认为 `/var/lib/kaiwudb`。 - `cpu`: 可选参数，用于指定 KWDB 服务占用当前节点服务器 CPU 资源的比例，默认无限制。取值范围为 `[0,1]`，最大精度为小数点后两位。KWDB 支持调整 CPU 资源占用率。更多信息，参见[配置裸机部署集群](../cluster-config/cluster-config-bare-metal.md)或[配置容器部署集群](../cluster-config/cluster-config-docker.md) 。**注意**：如果部署环境为 Ubuntu 18.04 版本，在裸机部署集群完成后，需要将 `kaiwudb.service` 文件中的 `CPUQuota` 修改为整型值，例如，将 `180.0%` 修改为 `180%`，以确保设置生效。具体操作步骤，参见[配置 CPU 资源占用率](../cluster-config/cluster-config-bare-metal.md#配置-cpu-资源占用率)。 - `local`：本地节点配置 diff --git a/deployment/prepare/before-deploy-bare-metal.md b/deployment/prepare/before-deploy-bare-metal.md index 2fb278286103cbb565c140fa6e2ca4c3a748eb3f..edcc7921a231e4338f67343535ae7116f48d3f23 100644 --- a/deployment/prepare/before-deploy-bare-metal.md +++ b/deployment/prepare/before-deploy-bare-metal.md @@ -73,6 +73,7 @@ KWDB 支持在以下服务器操作系统进行安装部署。 | ------------------------------------- | ------------------------------------------ | | `8080` | 数据库 Web 服务端口 | | `26257` | 数据库服务端口、节点监听端口和对外连接端口 | +| `27257` | 数据库时序引擎间的 brpc 通信端口 | ## 安装包和编译版本 diff --git a/deployment/prepare/before-deploy-docker.md b/deployment/prepare/before-deploy-docker.md index 9e7cc9c467ef9b08ae486e60326888f83f45eade..97a8f913f27799268b2513303ba5db63c3fc859d 100644 --- a/deployment/prepare/before-deploy-docker.md +++ b/deployment/prepare/before-deploy-docker.md @@ -76,6 +76,7 @@ sudo apt-get install docker-compose | ------------------------------------- | ------------------------------------------ | | `8080` | 数据库 Web 服务端口 | | `26257` | 数据库服务端口、节点监听端口和对外连接端口 | +| `27257` | 数据库时序引擎间的 brpc 通信端口 | ### 安装包和镜像 diff --git a/faqs/faqs.md b/faqs/faqs.md index d2dfa91a83779fd5f9c427502f473dc026c67ee9..843e66620297ad01f8046d6eac076307cd522551 100644 --- a/faqs/faqs.md +++ b/faqs/faqs.md @@ -226,7 +226,7 @@ id: faqs ... command: - /bin/bash- -c- | - /kaiwudb/bin/kwbase start-single-node --certs-dir= --listen-addr=0.0.0.0:26257 --advertise-addr=your-host-ip:port --store=/kaiwudb/deploy/kwdb-container --buffer-pool-size=32657 + /kaiwudb/bin/kwbase start-single-node --certs-dir= --listen-addr=0.0.0.0:26257 --brpc-addr=:27257 --advertise-addr=your-host-ip:port --store=/kaiwudb/deploy/kwdb-container --buffer-pool-size=32657 ``` 3. 保存配置，重新创建并启动 KWDB 容器。 diff --git a/quickstart/install-kaiwudb/quickstart-bare-metal.md b/quickstart/install-kaiwudb/quickstart-bare-metal.md index ff2fd1cf77b914f0be6c86ddd2aa575bb0c944ec..23e16ae06c07d4be3142532890e5ff67409d74bc 100644 --- a/quickstart/install-kaiwudb/quickstart-bare-metal.md +++ b/quickstart/install-kaiwudb/quickstart-bare-metal.md @@ -156,6 +156,7 @@ tar -zxvf management_user=kaiwudb rest_port=8080 kaiwudb_port=26257 + # brpc_port=27257 data_root=/var/lib/kaiwudb cpu=1 [local] @@ -176,6 +177,7 @@ tar -zxvf - `management_user`：KWDB 的管理用户，默认为 `kaiwudb`。安装部署后，KWDB 创建相应的管理用户以及和管理用户同名的用户组。 - `rest_port`：KWDB Web 服务端口，默认为 `8080`。 - `kaiwudb_port`：KWDB 服务端口，默认为 `26257`。 + - `brpc_port`：KWDB 时序引擎间的 brpc 通信端口，用于节点间通信。单节点部署时可不指定，指定后系统会自动忽略该设置。 - `data_root`：数据目录，默认为 `/var/lib/kaiwudb`。 - `cpu`: 可选参数，用于指定 KWDB 服务占用当前节点服务器 CPU 资源的比例，默认无限制。取值范围为 `[0,1]`，最大精度为小数点后两位。**注意**：如果部署环境为 Ubuntu 18.04 版本，部署集群后，需要将 `kaiwudb.service` 文件中的 `CPUQuota` 修改为整型值，例如，将 `180.0%` 修改为 `180%`，以确保设置生效。具体操作步骤，参见[配置 CPU 资源占用率](../../deployment/cluster-config/cluster-config-bare-metal.md#配置-cpu-资源占用率)。 - `local`：本地节点配置 diff --git a/quickstart/install-kaiwudb/quickstart-docker.md b/quickstart/install-kaiwudb/quickstart-docker.md index 01811de0e3ea016dc8ad2ce88369dbb68a568588..463aed2c4db39a48fad4eb3e46fa9a9b6d67ddd6 100644 --- a/quickstart/install-kaiwudb/quickstart-docker.md +++ b/quickstart/install-kaiwudb/quickstart-docker.md @@ -164,6 +164,7 @@ KWDB 支持通过以下方式获取容器镜像： management_user=kaiwudb rest_port=8080 kaiwudb_port=26257 + # brpc_port=27257 data_root=/var/lib/kaiwudb cpu=1 [local] @@ -184,6 +185,7 @@ KWDB 支持通过以下方式获取容器镜像： - `management_user`：KWDB 的管理用户，默认为 `kaiwudb`。安装部署后，KWDB 创建相应的管理用户以及和管理用户同名的用户组。 - `rest_port`：KWDB Web 服务端口，默认为 `8080`。 - `kaiwudb_port`：KWDB 服务端口，默认为 `26257`。 + - `brpc_port`：KWDB 时序引擎间的 brpc 通信端口，用于节点间通信。单节点部署时可不指定，指定后系统会自动忽略该设置。 - `data_root`：数据目录，默认为 `/var/lib/kaiwudb`。 - `cpu`: 可选参数，用于指定 KWDB 服务占用当前节点服务器 CPU 资源的比例，默认无限制。取值范围为 `[0,1]`，最大精度为小数点后两位。 - `local`：本地节点配置 diff --git a/tool-command-reference/client-tool/kwbase-sql-reference.md b/tool-command-reference/client-tool/kwbase-sql-reference.md index 7742f22803d3543f5f6fd4a6542891306083520e..a35a8aa96a90bc70cd70d6f80f677ff779b3b670 100644 --- a/tool-command-reference/client-tool/kwbase-sql-reference.md +++ b/tool-command-reference/client-tool/kwbase-sql-reference.md @@ -24,6 +24,7 @@ id: kwbase-sql-reference | `--advertise-addr` | 节点使用的 IP 地址或主机名，与其他节点通过该地址进行通信，采用 `[:]` 格式。如果是主机名，则要求能正常解析地址。如果是 IP 地址，则要求能正常访问 IP 地址。对于 IPv6 地址，使用 `[...]` 表示法，例如：`[::1]:26257` 或 `[fe80::f6f2:::]:26257`。如未指定，则默认使用 `listen-addr` 参数的取值。如只指定部分参数值，未指定的部分则使用 `listen-addr` 参数中相同部分的取值。参数的效果取决于与 `--listen-addr` 参数的组合使用。例如，如果端口号与 `--listen-addr` 参数中使用的端口号不同，则需要设置端口转发。
默认值：`--listen-addr` 参数的取值。 | | `--attrs` | 有序的、使用冒号（`:`）隔开的节点属性列表。节点属性可以是任意字符串，用于指定机器的能力。机器的能力可能包括专有硬件或内核数量（例如 gpu、x16c）。例如，`--attrs=x16c:gpu`。 | | `--background` | 在后台启动 KWDB 节点。该功能与在直接在命令行末尾添加 `&` 类似。但是，当使用 `--background` 选项启动 KWDB 节点时，直到 KWDB 节点准备好接受请求后，控制权才会返回给 shell。
**说明**
`--background` 参数适用于短时间运行和测试服务的场景。目前，由于无法从当前终端完全分离，不推荐在长时间的服务运行中使用该参数。这种情况下，推荐使用服务管理器或者 daemon(8) 等工具。 | +| `--brpc-addr` | 指定时序引擎间的 brpc 通信地址，格式为 `:` 或 `:`:
- 必须包含端口号，否则系统会报错 `failed to start server: --brpc-addr's port not specified`。
- IP 地址可省略，若未指定，系统将依次使用 `--advertise-addr` 或 `--listen-addr` 的 IP。
**说明**
`--advertise-addr` 与 `--brpc-addr` 均为节点间通信地址，因此需确保各节点间网络互通。推荐使用 `--brpc-addr=:` 格式，由系统自动获取 IP 地址。| | `--buffer-pool-size` | AE executor 缓冲池大小。
默认值：4096 | | `--cache` | 缓存大小，多个物理存储设备共享使用。参数值支持准确的内存值（单位：字节）、带小数点的十进制数值（转换为百分比数值）、百分比值：
- `--cache=.25`
- `--cache=25%`
- `--cache=1000000000`：1000000000 字节
- `--cache=1GB`：1000000000 字节
- `--cache=1GiB`：1073741824 字节
默认值：`128 MiB`
**说明**
如果使用带百分比符号（%）的格式，确保系统能够正常识别转义的百分比符号（%）。例如，在某些配置文件中，百分比符号（%）可能被识别为注解符。因此，推荐使用带小数点的十进制数值。 | | `--certs-dir` | 安全证书目录的路径，用于访问、验证以安全模式部署的集群。
默认值：`${HOME}/.kaiwudb-certs/` | @@ -60,6 +61,7 @@ id: kwbase-sql-reference --certs-dir=/root/certs \ --store=/opt/node1 \ --advertise-addr=:26257 \ + --brpc-addr=:27257 \ --listen-addr=:26257 \ --http-addr=:8080 \ --join=,, \ @@ -75,6 +77,7 @@ id: kwbase-sql-reference --insecure \ --store=/opt/node1 \ --advertise-addr=:26257 \ + --brpc-addr=:27257 \ --listen-addr=:26257 \ --http-addr=:8080 \ --join=,, \ @@ -102,6 +105,7 @@ id: kwbase-sql-reference | `--advertise-addr` | 节点使用的 IP 地址或主机名，与其他节点通过该地址进行通信，采用 `[:]` 格式。如果是主机名，则要求能正常解析地址。如果是 IP 地址，则要求能正常访问 IP 地址。对于 IPv6 地址，使用 `[...]` 表示法，例如：`[::1]:26257` 或 `[fe80::f6f2:::]:26257`。如未指定，则默认使用 `listen-addr` 参数的取值。如只指定部分参数值，未指定的部分则使用 `listen-addr` 参数中相同部分的取值。参数的效果取决于与 `--listen-addr` 参数的组合使用。例如，如果端口号与 `--listen-addr` 参数中使用的端口号不同，则需要设置端口转发。
默认值：`--listen-addr` 参数的取值。 | | `--attrs` | 有序的、使用冒号（`:`）隔开的节点属性列表。节点属性可以是任意字符串，用于指定机器的能力。机器的能力可能包括专有硬件或内核数量（例如 gpu、x16c）。例如，`--attrs=x16c:gpu`。 | | `--background` | 在后台启动 KWDB 节点。该功能与在直接在命令行末尾添加 `&` 类似。但是，当使用 `--background` 选项启动 KWDB 节点时，直到 KWDB 节点准备好接受请求后，控制权才会返回给 shell。
**说明**
`--background` 参数适用于短时间运行和测试服务的场景。目前，由于无法从当前终端完全分离，不推荐在长时间的服务运行中使用该参数。这种情况下，推荐使用服务管理器或者 daemon(8) 等工具。 | +| `--brpc-addr` | 指定时序引擎间的 brpc 通信地址，格式为 `:` 或 `:`:
- 必须包含端口号，否则系统会报错 `failed to start server: --brpc-addr's port not specified`。
- IP 地址可省略，若未指定，系统将依次使用 `--advertise-addr` 或 `--listen-addr` 的 IP。
**说明**
`--advertise-addr` 与 `--brpc-addr` 均为节点间通信地址，因此需确保各节点间网络互通。推荐使用 `--brpc-addr=:` 格式，由系统自动获取 IP 地址。| | `--buffer-pool-size` | AE executor 缓冲池大小。
默认值：4096 | | `--cache` | 缓存大小，多个物理存储设备共享使用。参数值支持准确的内存值（单位：字节）、带小数点的十进制数值（转换为百分比数值）、百分比值：
- `--cache=.25`
- `--cache=25%`
- `--cache=1000000000`：1000000000 字节
- `--cache=1GB`：1000000000 字节
- `--cache=1GiB`：1073741824 字节
默认值：`128 MiB`
**说明**
如果使用带百分比符号（%）的格式，确保系统能够正常识别转义的百分比符号（%）。例如，在某些配置文件中，百分比符号（%）可能被识别为注解符。因此，推荐使用带小数点的十进制数值。 | | `--certs-dir` | 安全证书目录的路径，用于访问、验证以安全模式部署的集群。
默认值：`${HOME}/.kaiwudb-certs/` | @@ -133,6 +137,7 @@ id: kwbase-sql-reference --insecure \ --store=/opt/node1 \ --advertise-addr=:26257 \ +--brpc-addr=:27257 \ --listen-addr=:26257 \ --http-addr=:8080 \ --join=