This is an automated email from the ASF dual-hosted git repository.
yiguolei pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 4bb4c1d8df0 update wg document (#1755)
4bb4c1d8df0 is described below
commit 4bb4c1d8df09f7fafab573b23da48062d0c35cf3
Author: wangbo <wan...@apache.org>
AuthorDate: Fri Jan 10 18:19:00 2025 +0800
update wg document (#1755)
## Versions
- [x] dev
- [x] 3.0
- [ ] 2.1
- [ ] 2.0
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---
docs/admin-manual/workload-management/workload-group.md | 16 +++++++++++++---
.../admin-manual/workload-management/workload-group.md | 12 ++++++++++--
.../admin-manual/workload-management/workload-group.md | 12 ++++++++++--
.../admin-manual/workload-management/workload-group.md | 12 ++++++++++--
.../admin-manual/workload-management/workload-group.md | 16 +++++++++++++---
.../admin-manual/workload-management/workload-group.md | 16 +++++++++++++---
6 files changed, 69 insertions(+), 15 deletions(-)
diff --git a/docs/admin-manual/workload-management/workload-group.md
b/docs/admin-manual/workload-management/workload-group.md
index 1510f750fdf..a57acb18adf 100644
--- a/docs/admin-manual/workload-management/workload-group.md
+++ b/docs/admin-manual/workload-management/workload-group.md
@@ -101,12 +101,22 @@ chmod 770 /sys/fs/cgroup/doris
chown -R doris:doris /sys/fs/cgroup/doris
```
-5. If using CGroup V2, the following steps are required.
-This is because CGroup V2 has stricter permission control, and write
permissions to the cgroup.procs file in the root directory are necessary to
move processes between groups.
- If it is CGroup V1, this step is not required.
+5. If the current environment is using CGroup v2, the following steps are
required. If it is CGroup v1, this step can be skipped.
+* Modify the permissions of the cgroup.procs file in the root directory. This
is necessary because CGroup v2 has stricter permission controls,
+and write permissions to the cgroup.procs file in the root directory are
required to move processes between CGroup directories.
```shell
chmod a+w /sys/fs/cgroup/cgroup.procs
```
+* In CGroup v2, the cgroup.controllers file lists the available controllers
for the current directory, and the cgroup.subtree_control file lists the
controllers available for the subdirectories.
+ Therefore, it is necessary to check if the doris directory has the cpu
controller enabled. If the cgroup.controllers file in the doris directory does
not include cpu, it means the cpu controller is not enabled. You can enable it
by executing the following command in the doris directory.
+ This command works by modifying the cgroup.subtree_control file in the
parent directory to allow the doris directory to use the cpu controller.
+```
+// After running this command, you should be able to see the cpu.max file in
the doris directory,
+// and the output of cgroup.controllers should include cpu.
+// If the command fails, it means that the parent directory of doris also does
not have the cpu controller enabled,
+// and you will need to enable the cpu controller for the parent directory.
+echo +cpu > ../cgroup.subtree_control
+```
6. Modify the BE configuration to specify the path of the cgroup.
```shell
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/workload-group.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/workload-group.md
index a73792a0257..ea43f650b29 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/workload-group.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/workload-group.md
@@ -95,11 +95,19 @@ chmod 770 /sys/fs/cgroup/doris
chown -R doris:doris /sys/fs/cgroup/doris
```
-5. 如果目前环境里生效的是CGroup v2版本，那么还需要做以下操作。这是因为CGroup
v2对于权限管控比较严格，需要具备根目录的cgroup.procs文件的写权限才能实现进程在group之间的移动。
- 如果是CGroup v1那么不需要这一步。
+5. 如果目前环境里生效的是 CGroup v2 版本，那么还需要进行以下两步操作。 如果是 CGroup v1 那么可以跳过当前步骤。
+* 修改根目录下的 cgroup.procs 文件权限，这是因为 CGroup v2 对于权限管控比较严格，需要具备根目录的 cgroup.procs
文件的写权限才能实现进程在 CGroup 目录之间的移动。
```shell
chmod a+w /sys/fs/cgroup/cgroup.procs
```
+* 在 CGroup V2 中，cgroup.controllers 保存了当前目录可用的控制器，cgroup.subtree_control
保存了当前目录的子目录的可用控制器。
+因此需要确认 doris 目录是否已经启用 cpu 控制器，如果 doris 目录下的 cgroup.controllers 中不包含 cpu ，那么说明
cpu 控制器未启用，可以在 doris 目录中执行以下命令，
+这个命令是通过修改父级目录的 cgroup.subtree_control 文件使得 doris 目录可以使用 cpu 控制器。
+```
+// 预期该命令执行完成之后，可以在 doris 目录下看到 cpu.max 文件，且 cgroup.controllers 的输出包含 cpu。
+// 如果该命令执行失败，则说明 doris 目录的父级目录也未启用 cpu 控制器，需要为父级目录启用 cpu 控制器。
+echo +cpu > ../cgroup.subtree_control
+```
6. 修改 BE 的配置，指定 cgroup 的路径
```shell
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/workload-group.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/workload-group.md
index e7aa2a44ef8..5b4eceed5fb 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/workload-group.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/workload-group.md
@@ -95,11 +95,19 @@ chmod 770 /sys/fs/cgroup/doris
chown -R doris:doris /sys/fs/cgroup/doris
```
-5. 如果目前环境里生效的是 CGroup v2 版本，那么还需要做以下操作。这是因为 CGroup v2 对于权限管控比较严格，需要具备根目录的
cgroup.procs 文件的写权限才能实现进程在 group 之间的移动。
- 如果是 CGroup v1 那么不需要这一步。
+5. 如果目前环境里生效的是 CGroup v2 版本，那么还需要进行以下两步操作。 如果是 CGroup v1 那么可以跳过当前步骤。
+* 修改根目录下的 cgroup.procs 文件权限，这是因为 CGroup v2 对于权限管控比较严格，需要具备根目录的 cgroup.procs
文件的写权限才能实现进程在 CGroup 目录之间的移动。
```shell
chmod a+w /sys/fs/cgroup/cgroup.procs
```
+* 在 CGroup V2 中，cgroup.controllers 保存了当前目录可用的控制器，cgroup.subtree_control
保存了当前目录的子目录的可用控制器。
+ 因此需要确认 doris 目录是否已经启用 cpu 控制器，如果 doris 目录下的 cgroup.controllers 中不包含 cpu
，那么说明 cpu 控制器未启用，可以在 doris 目录中执行以下命令，
+ 这个命令是通过修改父级目录的 cgroup.subtree_control 文件使得 doris 目录可以使用 cpu 控制器。
+```
+// 预期该命令执行完成之后，可以在 doris 目录下看到 cpu.max 文件，且 cgroup.controllers 的输出包含 cpu。
+// 如果该命令执行失败，则说明 doris 目录的父级目录也未启用 cpu 控制器，需要为父级目录启用 cpu 控制器。
+echo +cpu > ../cgroup.subtree_control
+```
6. 修改 BE 的配置，指定 cgroup 的路径
```shell
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/workload-management/workload-group.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/workload-management/workload-group.md
index ca5c02b911c..a30f68392e1 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/workload-management/workload-group.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/workload-management/workload-group.md
@@ -95,11 +95,19 @@ chmod 770 /sys/fs/cgroup/doris
chown -R doris:doris /sys/fs/cgroup/doris
```
-5. 如果目前环境里生效的是CGroup v2版本，那么还需要做以下操作。这是因为CGroup
v2对于权限管控比较严格，需要具备根目录的cgroup.procs文件的写权限才能实现进程在group之间的移动。
- 如果是CGroup v1那么不需要这一步。
+5. 如果目前环境里生效的是 CGroup v2 版本，那么还需要进行以下两步操作。 如果是 CGroup v1 那么可以跳过当前步骤。
+* 修改根目录下的 cgroup.procs 文件权限，这是因为 CGroup v2 对于权限管控比较严格，需要具备根目录的 cgroup.procs
文件的写权限才能实现进程在 CGroup 目录之间的移动。
```shell
chmod a+w /sys/fs/cgroup/cgroup.procs
```
+* 在 CGroup V2 中，cgroup.controllers 保存了当前目录可用的控制器，cgroup.subtree_control
保存了当前目录的子目录的可用控制器。
+ 因此需要确认 doris 目录是否已经启用 cpu 控制器，如果 doris 目录下的 cgroup.controllers 中不包含 cpu
，那么说明 cpu 控制器未启用，可以在 doris 目录中执行以下命令，
+ 这个命令是通过修改父级目录的 cgroup.subtree_control 文件使得 doris 目录可以使用 cpu 控制器。
+```
+// 预期该命令执行完成之后，可以在 doris 目录下看到 cpu.max 文件，且 cgroup.controllers 的输出包含 cpu。
+// 如果该命令执行失败，则说明 doris 目录的父级目录也未启用 cpu 控制器，需要为父级目录启用 cpu 控制器。
+echo +cpu > ../cgroup.subtree_control
+```
6. 修改 BE 的配置，指定 cgroup 的路径
```shell
diff --git
a/versioned_docs/version-2.1/admin-manual/workload-management/workload-group.md
b/versioned_docs/version-2.1/admin-manual/workload-management/workload-group.md
index ca179b79214..6fefef1562a 100644
---
a/versioned_docs/version-2.1/admin-manual/workload-management/workload-group.md
+++
b/versioned_docs/version-2.1/admin-manual/workload-management/workload-group.md
@@ -101,12 +101,22 @@ chmod 770 /sys/fs/cgroup/doris
chown -R doris:doris /sys/fs/cgroup/doris
```
-5. If using CGroup V2, the following steps are required.
- This is because CGroup V2 has stricter permission control, and write
permissions to the cgroup.procs file in the root directory are necessary to
move processes between groups.
- If it is CGroup V1, this step is not required.
+5. If the current environment is using CGroup v2, the following steps are
required. If it is CGroup v1, this step can be skipped.
+* Modify the permissions of the cgroup.procs file in the root directory. This
is necessary because CGroup v2 has stricter permission controls,
+ and write permissions to the cgroup.procs file in the root directory are
required to move processes between CGroup directories.
```shell
chmod a+w /sys/fs/cgroup/cgroup.procs
```
+* In CGroup v2, the cgroup.controllers file lists the available controllers
for the current directory, and the cgroup.subtree_control file lists the
controllers available for the subdirectories.
+ Therefore, it is necessary to check if the doris directory has the cpu
controller enabled. If the cgroup.controllers file in the doris directory does
not include cpu, it means the cpu controller is not enabled. You can enable it
by executing the following command in the doris directory.
+ This command works by modifying the cgroup.subtree_control file in the
parent directory to allow the doris directory to use the cpu controller.
+```
+// After running this command, you should be able to see the cpu.max file in
the doris directory,
+// and the output of cgroup.controllers should include cpu.
+// If the command fails, it means that the parent directory of doris also does
not have the cpu controller enabled,
+// and you will need to enable the cpu controller for the parent directory.
+echo +cpu > ../cgroup.subtree_control
+```
6. Modify the BE configuration to specify the path of the cgroup.
```shell
diff --git
a/versioned_docs/version-3.0/admin-manual/workload-management/workload-group.md
b/versioned_docs/version-3.0/admin-manual/workload-management/workload-group.md
index ca179b79214..6fefef1562a 100644
---
a/versioned_docs/version-3.0/admin-manual/workload-management/workload-group.md
+++
b/versioned_docs/version-3.0/admin-manual/workload-management/workload-group.md
@@ -101,12 +101,22 @@ chmod 770 /sys/fs/cgroup/doris
chown -R doris:doris /sys/fs/cgroup/doris
```
-5. If using CGroup V2, the following steps are required.
- This is because CGroup V2 has stricter permission control, and write
permissions to the cgroup.procs file in the root directory are necessary to
move processes between groups.
- If it is CGroup V1, this step is not required.
+5. If the current environment is using CGroup v2, the following steps are
required. If it is CGroup v1, this step can be skipped.
+* Modify the permissions of the cgroup.procs file in the root directory. This
is necessary because CGroup v2 has stricter permission controls,
+ and write permissions to the cgroup.procs file in the root directory are
required to move processes between CGroup directories.
```shell
chmod a+w /sys/fs/cgroup/cgroup.procs
```
+* In CGroup v2, the cgroup.controllers file lists the available controllers
for the current directory, and the cgroup.subtree_control file lists the
controllers available for the subdirectories.
+ Therefore, it is necessary to check if the doris directory has the cpu
controller enabled. If the cgroup.controllers file in the doris directory does
not include cpu, it means the cpu controller is not enabled. You can enable it
by executing the following command in the doris directory.
+ This command works by modifying the cgroup.subtree_control file in the
parent directory to allow the doris directory to use the cpu controller.
+```
+// After running this command, you should be able to see the cpu.max file in
the doris directory,
+// and the output of cgroup.controllers should include cpu.
+// If the command fails, it means that the parent directory of doris also does
not have the cpu controller enabled,
+// and you will need to enable the cpu controller for the parent directory.
+echo +cpu > ../cgroup.subtree_control
+```
6. Modify the BE configuration to specify the path of the cgroup.
```shell
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For additional commands, e-mail: commits-h...@doris.apache.org
