yagagagaga commented on code in PR #1072: URL: https://github.com/apache/doris-website/pull/1072#discussion_r1777273668
########## i18n/zh-CN/docusaurus-plugin-content-docs/current/compute-storage-decoupled/compilation-and-deployment.md: ########## @@ -71,73 +82,221 @@ cat /etc/foundationdb/fdb.cluster cloud_ssb:[email protected]:4500 ``` -### 启停 +### 3.2 启动与停止 -Meta Service 依赖 JAVA 运行环境，并使用 OpenJDK 17。在启动前这两个服务前，请确保已正确设置 `export JAVA_HOME` 环境变量。 +*环境要求* -`doris_cloud` 部署的 `bin` 目录下提供了启停脚本，调用对应的启停脚本即可完成启停。 +确保已正确设置 `JAVA_HOME` 环境变量，指向 OpenJDK 17，进入 `ms` 目录。 -在 `ms` 目录中： +*启动命令* ```Shell export JAVA_HOME=${path_to_jdk_17} bin/start.sh --daemon +``` + +*停止命令* +``` shell bin/stop.sh ``` -若 Meta Service 进程正常启动，将能在 `doris_cloud.out` 文件中观察到 `successfully started` 的输出信息。以下为一个启动的输出信息示例 +*验证启动* -``` -2024-09-02 21:03:53 try to start doris_cloud -process working directory: "/mnt/disk1/gavinchou/debug/doris-cloud/ms" -pid=810125 written to file=./bin/doris_cloud.pid -version:{doris_cloud-0.0.0-debug} code_version:{commit=7d94417e6ca10f3c77bea07caf4994af155b6e99 time=2024-09-02 21:03:01 +0800} build_info:{initiator=gavinchou@VM-10-11-centos build_at=2024-09-02 21:03:01 +0800 build_on=NAME="TencentOS Se -rver" VERSION="3.1 (Final)" } - -run doris_cloud as meta_service and recycler by default -meta-service started -recycler started -successfully started brpc listening on port=6000 time_elapsed_ms=139 -``` +检查 `doris_cloud.out` 文件中是否有 `successfully started` 的输出信息。 -## 将数据回收功能作为单独进程部署 +生产环境中请确保至少有 3 个 Meta Service 节点。 -在一些场景中为了更好的隔离性以及稳定性，我们需要将元数据操作功能和数据回收功能分开不同的进程部署。 +## 4. 数据回收功能独立部署（可选） -在成功部署并启动 Meta Service 之后，Doris 存算分离模式的底座便已完成搭建。 +*准备工作* -`ms`目录也可以用于启动为数据回收功能进程，只需使用不同启动参数启动即可。 -需要注意的是，需要单独准备一个独立的工作目录，二进制以及配置文件都是单独的一份。 +1. 创建新的工作目录（如 `recycler`）。 +2. 复制 `ms` 目录内容到新目录： -使用以下命令从`ms`目录中拷贝二进制文件至一个新的 Recycler 工作目录`re`。 -```Shell -cp -r ms re -``` + ```shell + cp -r ms recycler + ``` + +*配置* -Meta Service 启动脚本可以接受 `--meta-service` 和 `--recycler` 两个参数指定的是当前 Meta Service 进程拥有什么样的能力。 -前者为元数据操作(主要提供一些在线实时元数据操作)， 后者为数据回收功能(离线异步数据回收等流程)。 +在新目录的配置文件中修改 BRPC 监听端口。 -在 re 目录下对配置文件中的 BRPC 的监听端口号按需进行必要修改，然后使用 `--recycler` 参数启动即可。 +*启动数据回收功能* ```Shell export JAVA_HOME=${path_to_jdk_17} bin/start.sh --recycler --daemon - -bin/stop.sh ``` -这样我们得到了一个只有数据回收功能的 Meta Service 进程，它不负责元数据的操作，**在 FE BE 的配置中不要将只有回收功能的 Meta Service 进程其作为 `meta_service_endpoint` 配置的目标**。 +*启动仅元数据操作功能* -同理，我们通过控制启动参数，也可以得到一个只有元数据操作功能的 Meta Service 进程 -在 ms 目录下使用以下参数启动 ```Shell export JAVA_HOME=${path_to_jdk_17} bin/start.sh --meta-service --daemon +``` -bin/stop.sh +## 5. FE 和 BE 的启动流程 + +本节详细说明了在存算分离架构下启动 FE（Frontend）和 BE（Backend）的步骤。 + +### 5.1 启动顺序 + +1. 以 MASTER 角色启动实例的第一个 FE +2. 向实例中添加其他 FE 和 BE +3. 添加第一个 Storage Vault + +### 5.2 启动 MASTER 角色的 FE + +#### 5.2.1 配置 fe.conf + +在 `fe.conf` 文件中，需要配置以下关键参数： + +1. `deploy_mode` + - 描述：指定 doris 启动模式 + - 格式：cloud 表示存算分离模式，其它存算一体模式 + - 示例：`cloud` + +2. `cluster_id` + - 描述：存算分离架构下集群的唯一标识符，不同的集群必须设置不同的 cluster_id + - 格式：int 类型 + - 示例：`12345678` + +3. `meta_service_endpoint` + - 描述：Meta Service 的地址和端口 + - 格式：`IP地址:端口号` + - 示例：`127.0.0.1:5000`, 可以用逗号分割配置多个meta service。 + +#### 5.2.2 启动 FE + +启动命令示例： + +```bash +bin/start_fe.sh --daemon +``` + +第一个 FE 进程初始化集群并以 FOLLOWER 角色工作。 + +### 5.3 添加其他 FE 节点 + +使用以下 SQL 命令添加额外的 FE 节点： Review Comment: ```suggestion 其他节点同样根据上述步骤修改配置文件并启动，使用 mysql 客户端连接 Master 角色的 FE，并用以下 SQL 命令添加额外的 FE 节点： ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
