From 41c0148b87b85d9c779a579428fe3683b3c41123 Mon Sep 17 00:00:00 2001
From: Xiang Zhang <xiangzhang1128@gmail.com>
Date: Thu, 26 Aug 2021 15:47:39 +0800
Subject: [PATCH 1/5] HDDS-5564. feature/PrefixFSO.md translation

---
 .../docs/content/feature/PrefixFSO.zh.md      | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 hadoop-hdds/docs/content/feature/PrefixFSO.zh.md

diff --git a/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md b/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
new file mode 100644
index 000000000000..d508a139f6d5
--- /dev/null
+++ b/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
@@ -0,0 +1,61 @@
+---
+title: "基于前缀的文件系统优化"
+weight: 2
+menu:
+   main:
+      parent: 特性
+summary: 支持Supports atomic rename and delete operation.
+---
+<!---
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+基于前缀的文件系统优化特性支持命名空间中任意级别目录的重命名和删除操作，且操作均能在常数时间内完成。
+
+注意：该特性只在 `ozone.om.enable.filesystem.paths` 启用时有效，这意味着对 Hadoop 文件系统的兼容性优先于对 S3 的兼容性，某些不规范的 S3 键名将会被拒绝或规范化。
+
+当 Ozone 中的桶主要通过兼容 Hadoop 的接口使用，尤其是涉及到较深目录层级下的大量文件时，强烈推荐开启该特性。
+
+## OzoneManager 元数据布局格式
+OzoneManager 支持两种元数据布局格式：简单布局格式和基于前缀的布局格式。
+
+在简单布局格式中，OM 采用全路径名来存储每个键的元数据。在基于前缀的优化布局格式中，OM 将中间目录的元数据存储在  `DirectoryTable` 中，将文件的元数据存储在 `FileTable` 中，如下图所示。两张表中的主键要么是目录名，要么是以父目录唯一标识符为前缀的文件名， 形如 `<parent
+     unique-id>/<filename>`。
+     
+![FSO Format](PrefixFSO-Format.png)
+
+
+### 基于前缀布局的目录删除操作 ###
+下图描述了进行目录删除操作时 OM 的元数据变化。
+![FSO Delete](PrefixFSO-Delete.png)
+
+### 基于前缀布局的目录重命名操作 ###
+下图描述了进行目录重命名操作时 OM 的元数据变化。
+![FSO Rename](PrefixFSO-Rename.png)
+
+## 配置
+该特性默认未启用，可以通过在 `ozone-site.xml` 进行如下配置启用：
+
+```XML
+<property>
+   <name>ozone.om.enable.filesystem.paths</name>
+   <value>true</value>
+</property>
+<property>
+   <name>ozone.om.metadata.layout</name>
+   <value>PREFIX</value>
+</property>
+```
\ No newline at end of file

From 2bdf54bc9da2b32fb7e9fa345e362a9654a99e00 Mon Sep 17 00:00:00 2001
From: Xiang Zhang <xiangzhang1128@gmail.com>
Date: Sun, 5 Sep 2021 14:50:51 +0800
Subject: [PATCH 2/5] suggested changes applied

---
 hadoop-hdds/docs/content/feature/PrefixFSO.zh.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md b/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
index d508a139f6d5..d76913a492f6 100644
--- a/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
+++ b/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
@@ -4,7 +4,7 @@ weight: 2
 menu:
    main:
       parent: 特性
-summary: 支持Supports atomic rename and delete operation.
+summary: 支持原子的重命名和删除操作。
 ---
 <!---
   Licensed to the Apache Software Foundation (ASF) under one or more
@@ -32,8 +32,7 @@ summary: 支持Supports atomic rename and delete operation.
 ## OzoneManager 元数据布局格式
 OzoneManager 支持两种元数据布局格式：简单布局格式和基于前缀的布局格式。
 
-在简单布局格式中，OM 采用全路径名来存储每个键的元数据。在基于前缀的优化布局格式中，OM 将中间目录的元数据存储在  `DirectoryTable` 中，将文件的元数据存储在 `FileTable` 中，如下图所示。两张表中的主键要么是目录名，要么是以父目录唯一标识符为前缀的文件名， 形如 `<parent
-     unique-id>/<filename>`。
+在简单布局格式中，OM 采用全路径名来存储每个键的元数据。在基于前缀的优化布局格式中，OM 将中间目录的元数据存储在 `DirectoryTable` 中，将文件的元数据存储在 `FileTable` 中，如下图所示。两张表中的主键是以父目录唯一标识符为前缀的文件名或目录名， 形如 `<parent unique-id>/<filename>`。
      
 ![FSO Format](PrefixFSO-Format.png)
 
@@ -47,7 +46,7 @@ OzoneManager 支持两种元数据布局格式：简单布局格式和基于前
 ![FSO Rename](PrefixFSO-Rename.png)
 
 ## 配置
-该特性默认未启用，可以通过在 `ozone-site.xml` 进行如下配置启用：
+该特性默认未启用，可以通过在 `ozone-site.xml` 进行如下配置来启用：
 
 ```XML
 <property>
@@ -58,4 +57,4 @@ OzoneManager 支持两种元数据布局格式：简单布局格式和基于前
    <name>ozone.om.metadata.layout</name>
    <value>PREFIX</value>
 </property>
-```
\ No newline at end of file
+```

From 429d6d38920d4ebeaf36ff2f97fdde283de0c792 Mon Sep 17 00:00:00 2001
From: Xiang Zhang <xiangzhang1128@gmail.com>
Date: Sun, 5 Sep 2021 14:53:52 +0800
Subject: [PATCH 3/5] full path modified

---
 hadoop-hdds/docs/content/feature/PrefixFSO.zh.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md b/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
index d76913a492f6..4fd5cddb51b4 100644
--- a/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
+++ b/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
@@ -32,7 +32,7 @@ summary: 支持原子的重命名和删除操作。
 ## OzoneManager 元数据布局格式
 OzoneManager 支持两种元数据布局格式：简单布局格式和基于前缀的布局格式。
 
-在简单布局格式中，OM 采用全路径名来存储每个键的元数据。在基于前缀的优化布局格式中，OM 将中间目录的元数据存储在 `DirectoryTable` 中，将文件的元数据存储在 `FileTable` 中，如下图所示。两张表中的主键是以父目录唯一标识符为前缀的文件名或目录名， 形如 `<parent unique-id>/<filename>`。
+在简单布局格式中，OM 采用完整路径名来存储每个键的元数据。在基于前缀的优化布局格式中，OM 将中间目录的元数据存储在 `DirectoryTable` 中，将文件的元数据存储在 `FileTable` 中，如下图所示。两张表中的主键是以父目录唯一标识符为前缀的文件名或目录名， 形如 `<parent unique-id>/<filename>`。
      
 ![FSO Format](PrefixFSO-Format.png)
 

From 317e6104e0b049242666a4eda80e7d905a41f37f Mon Sep 17 00:00:00 2001
From: Siyao Meng <50227127+smengcl@users.noreply.github.com>
Date: Thu, 28 Apr 2022 12:47:09 -0700
Subject: [PATCH 4/5] Amend the doc slightly as the original doc is updated
 since

Change-Id: I17940accb0e10d5cd602bbb9fb0bec6a4f13795d
---
 hadoop-hdds/docs/content/feature/PrefixFSO.zh.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md b/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
index 4fd5cddb51b4..d1a3bb59eb37 100644
--- a/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
+++ b/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
@@ -25,7 +25,13 @@ summary: 支持原子的重命名和删除操作。
 
 基于前缀的文件系统优化特性支持命名空间中任意级别目录的重命名和删除操作，且操作均能在常数时间内完成。
 
-注意：该特性只在 `ozone.om.enable.filesystem.paths` 启用时有效，这意味着对 Hadoop 文件系统的兼容性优先于对 S3 的兼容性，某些不规范的 S3 键名将会被拒绝或规范化。
+若要启用该特性，需要在创建桶时指定 `--layout` 参数为 `FILE_SYSTEM_OPTIMIZED`.
+
+```bash
+ozone sh bucket create /<volume-name>/<bucket-name> --layout FILE_SYSTEM_OPTIMIZED
+```
+
+注意：在启用基于前缀的文件系统优化的桶中，对 Hadoop 文件系统的兼容性优先于对 S3 的兼容性，某些不规范的 S3 键名在操作时将会被拒绝或规范化。
 
 当 Ozone 中的桶主要通过兼容 Hadoop 的接口使用，尤其是涉及到较深目录层级下的大量文件时，强烈推荐开启该特性。
 
@@ -39,10 +45,12 @@ OzoneManager 支持两种元数据布局格式：简单布局格式和基于前
 
 ### 基于前缀布局的目录删除操作 ###
 下图描述了进行目录删除操作时 OM 的元数据变化。
+
 ![FSO Delete](PrefixFSO-Delete.png)
 
 ### 基于前缀布局的目录重命名操作 ###
 下图描述了进行目录重命名操作时 OM 的元数据变化。
+
 ![FSO Rename](PrefixFSO-Rename.png)
 
 ## 配置

From 100d7645bd6a06d9fd936d17575e0d4b90563227 Mon Sep 17 00:00:00 2001
From: Siyao Meng <50227127+smengcl@users.noreply.github.com>
Date: Tue, 2 Aug 2022 12:43:51 -0700
Subject: [PATCH 5/5] Update `Configuration` section.

Change-Id: I9ec0b75a6df192267ccfee3d2395fe1419db7059
---
 .../docs/content/feature/PrefixFSO.zh.md        | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md b/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
index d1a3bb59eb37..6ace5edb81d4 100644
--- a/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
+++ b/hadoop-hdds/docs/content/feature/PrefixFSO.zh.md
@@ -54,15 +54,16 @@ OzoneManager 支持两种元数据布局格式：简单布局格式和基于前
 ![FSO Rename](PrefixFSO-Rename.png)
 
 ## 配置
-该特性默认未启用，可以通过在 `ozone-site.xml` 进行如下配置来启用：
+
+可以在 `ozone-site.xml` 中加入以下配置来设定创建桶时，客户端未指定桶样式时的默认的桶样式：
+可用的值有 `OBJECT_STORE`, `FILE_SYSTEM_OPTIMIZED` 和 `LEGACY`.
+
+若该配置的值为空，则默认值为 `LEGACY`.
 
 ```XML
+
 <property>
-   <name>ozone.om.enable.filesystem.paths</name>
-   <value>true</value>
-</property>
-<property>
-   <name>ozone.om.metadata.layout</name>
-   <value>PREFIX</value>
+    <name>ozone.default.bucket.layout</name>
+    <value/>
 </property>
-```
+```
\ No newline at end of file