From 633486fda47481d808053496869257ab4028a9ef Mon Sep 17 00:00:00 2001 From: amaliujia Date: Tue, 2 Jun 2026 10:14:49 +0800 Subject: [PATCH 1/5] Fix broken pip install syntax in documentation. --- hadoop-hdds/docs/content/tools/TestTools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hadoop-hdds/docs/content/tools/TestTools.md b/hadoop-hdds/docs/content/tools/TestTools.md index bde400d84aef..28c244dc5c86 100644 --- a/hadoop-hdds/docs/content/tools/TestTools.md +++ b/hadoop-hdds/docs/content/tools/TestTools.md @@ -60,7 +60,7 @@ Blockade tests are implemented with the help of tests and can be started from th ``` cd blockade -pip install pytest==2.8.7,blockade +pip install pytest==2.8.7 blockade python -m pytest -s . ``` From 4688d064e00b0863e5b0f3a5d911c93a3def4827 Mon Sep 17 00:00:00 2001 From: amaliujia Date: Tue, 2 Jun 2026 12:45:54 +0800 Subject: [PATCH 2/5] Patch: have the Chinese documentation be consistent. --- hadoop-hdds/docs/content/tools/TestTools.zh.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hadoop-hdds/docs/content/tools/TestTools.zh.md b/hadoop-hdds/docs/content/tools/TestTools.zh.md index b6b647c90c7b..3ccdfdd06b76 100644 --- a/hadoop-hdds/docs/content/tools/TestTools.zh.md +++ b/hadoop-hdds/docs/content/tools/TestTools.zh.md @@ -60,7 +60,7 @@ Blockade 测试在其它测试的基础上实现，可以在分发包中的 `./b ``` cd blockade -pip install pytest==2.8.7,blockade +pip install pytest==2.8.7 blockade python -m pytest -s . ``` From 1f33c6d46be8424b6730c10703b57c006d399d20 Mon Sep 17 00:00:00 2001 From: amaliujia Date: Tue, 2 Jun 2026 17:18:51 +0800 Subject: [PATCH 3/5] comments: 1. reword sentences for better reader understanding 2. fix the cd target path --- hadoop-hdds/docs/content/tools/TestTools.md | 4 ++-- hadoop-hdds/docs/content/tools/TestTools.zh.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/hadoop-hdds/docs/content/tools/TestTools.md b/hadoop-hdds/docs/content/tools/TestTools.md index 28c244dc5c86..388b926f33ce 100644 --- a/hadoop-hdds/docs/content/tools/TestTools.md +++ b/hadoop-hdds/docs/content/tools/TestTools.md @@ -56,10 +56,10 @@ cd compose/ozone [Blockade](https://github.com/worstcase/blockade) is a tool to test network failures and partitions (it's inspired by the legendary [Jepsen tests](https://jepsen.io/analyses)). -Blockade tests are implemented with the help of tests and can be started from the `./blockade` directory of the distribution. +The Blockade test suite is shipped with the Ozone distribution as Python tests under `tests/blockade`. After you build or unpack the distribution, run the commands below from that directory: ``` -cd blockade +cd tests/blockade pip install pytest==2.8.7 blockade python -m pytest -s . ``` diff --git a/hadoop-hdds/docs/content/tools/TestTools.zh.md b/hadoop-hdds/docs/content/tools/TestTools.zh.md index 3ccdfdd06b76..b6e30a37f605 100644 --- a/hadoop-hdds/docs/content/tools/TestTools.zh.md +++ b/hadoop-hdds/docs/content/tools/TestTools.zh.md @@ -56,10 +56,10 @@ cd compose/ozone [Blockade](https://github.com/worstcase/blockade) 是一个测试网络故障和分片的工具（灵感来自于大名鼎鼎的[Jepsen 测试](https://jepsen.io/analyses)）。 -Blockade 测试在其它测试的基础上实现，可以在分发包中的 `./blockade` 目录下进行测试。 +Blockade 测试以 Python 脚本形式包含在 Ozone 发行包的 `tests/blockade` 目录中。构建或解压发行包后，进入该目录并运行下面的命令： ``` -cd blockade +cd tests/blockade pip install pytest==2.8.7 blockade python -m pytest -s . ``` From 37995676e05c855289770b6c0397c87952ac587e Mon Sep 17 00:00:00 2001 From: amaliujia Date: Tue, 2 Jun 2026 17:24:26 +0800 Subject: [PATCH 4/5] Comments: continue improve blockade tests description --- hadoop-hdds/docs/content/tools/TestTools.md | 2 +- hadoop-hdds/docs/content/tools/TestTools.zh.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/hadoop-hdds/docs/content/tools/TestTools.md b/hadoop-hdds/docs/content/tools/TestTools.md index 388b926f33ce..fd1d50494d28 100644 --- a/hadoop-hdds/docs/content/tools/TestTools.md +++ b/hadoop-hdds/docs/content/tools/TestTools.md @@ -56,7 +56,7 @@ cd compose/ozone [Blockade](https://github.com/worstcase/blockade) is a tool to test network failures and partitions (it's inspired by the legendary [Jepsen tests](https://jepsen.io/analyses)). -The Blockade test suite is shipped with the Ozone distribution as Python tests under `tests/blockade`. After you build or unpack the distribution, run the commands below from that directory: +The Blockade test suite is shipped as Python tests under `tests/blockade`. After you build or unpack the distribution, run the commands below from that directory: ``` cd tests/blockade diff --git a/hadoop-hdds/docs/content/tools/TestTools.zh.md b/hadoop-hdds/docs/content/tools/TestTools.zh.md index b6e30a37f605..a22e234833d4 100644 --- a/hadoop-hdds/docs/content/tools/TestTools.zh.md +++ b/hadoop-hdds/docs/content/tools/TestTools.zh.md @@ -56,7 +56,7 @@ cd compose/ozone [Blockade](https://github.com/worstcase/blockade) 是一个测试网络故障和分片的工具（灵感来自于大名鼎鼎的[Jepsen 测试](https://jepsen.io/analyses)）。 -Blockade 测试以 Python 脚本形式包含在 Ozone 发行包的 `tests/blockade` 目录中。构建或解压发行包后，进入该目录并运行下面的命令： +Blockade 测试以 Python 脚本形式包含在 `tests/blockade` 目录中。构建或解压发行包后，进入该目录并运行下面的命令： ``` cd tests/blockade From 16a67235df8af71c645c8af4dc38a029f13faf9d Mon Sep 17 00:00:00 2001 From: amaliujia Date: Tue, 2 Jun 2026 21:29:36 +0800 Subject: [PATCH 5/5] Comments. 1. Fix type on repeating words. 2. Simplify the example of Ozone commands. --- hadoop-hdds/docs/content/tools/TestTools.md | 4 ++-- hadoop-hdds/docs/content/tools/TestTools.zh.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/hadoop-hdds/docs/content/tools/TestTools.md b/hadoop-hdds/docs/content/tools/TestTools.md index fd1d50494d28..e6ffb364a21d 100644 --- a/hadoop-hdds/docs/content/tools/TestTools.md +++ b/hadoop-hdds/docs/content/tools/TestTools.md @@ -27,7 +27,7 @@ Note: we have more tests (like TCP-DS, TCP-H tests via Spark or Hive) which are ## Unit test -As every almost every java project we have the good old unit tests inside each of our projects. +As with every Java project, we have the good old unit tests within each of our projects. ## Integration test (JUnit) @@ -82,7 +82,7 @@ The number of volumes/buckets/keys can be configured. The replication type and f For more information use: -bin/ozone freon --help +ozone freon --help For example: diff --git a/hadoop-hdds/docs/content/tools/TestTools.zh.md b/hadoop-hdds/docs/content/tools/TestTools.zh.md index a22e234833d4..05f2c7f07f4f 100644 --- a/hadoop-hdds/docs/content/tools/TestTools.zh.md +++ b/hadoop-hdds/docs/content/tools/TestTools.zh.md @@ -83,7 +83,7 @@ volume/bucket/key的数量是可以配置的。副本type和factor(例如: 3个 更多信息，可使用如下命令查看: -bin/ozone freon --help +ozone freon --help 例如：