You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ozone.apache.org by gi...@apache.org on 2024/12/07 12:46:23 UTC
(ozone-site) branch asf-site updated: [auto] Generated docs from Apache Ozone master 51c6ed65add3775ff7f4481aacccf5015e354b2b
This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/ozone-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 7349c1fc [auto] Generated docs from Apache Ozone master 51c6ed65add3775ff7f4481aacccf5015e354b2b
7349c1fc is described below
commit 7349c1fc0b29676175aa943e45c375a71bf644a1
Author: Github Actions <no...@github.com>
AuthorDate: Sat Dec 7 12:46:19 2024 +0000
[auto] Generated docs from Apache Ozone master 51c6ed65add3775ff7f4481aacccf5015e354b2b
---
docs/edge/concept.html | 2 +-
docs/edge/concept/containers.html | 2 +-
docs/edge/concept/datanodes.html | 44 +-
docs/edge/concept/overview.html | 2 +-
docs/edge/concept/ozonemanager.html | 2 +-
docs/edge/concept/recon.html | 2 +-
docs/edge/concept/storagecontainermanager.html | 4 +-
docs/edge/design.html | 12 +-
docs/edge/design/configless.html | 2 +-
docs/edge/design/decommissioning.html | 2 +-
docs/edge/design/dn-merge-rocksdb.html | 2 +-
docs/edge/design/ec.html | 2 +-
docs/edge/design/gdpr.html | 2 +-
docs/edge/design/httpfs.html | 2 +-
docs/edge/design/index.xml | 11 +-
docs/edge/design/locks.html | 2 +-
docs/edge/design/multiraft.html | 2 +-
docs/edge/design/namespace-support.html | 2 +-
docs/edge/design/nfs.html | 2 +-
docs/edge/design/nonrolling-upgrade.html | 2 +-
docs/edge/design/ofs.html | 2 +-
docs/edge/design/omha.html | 2 +-
docs/edge/design/omprepare.html | 2 +-
...t.html => overwrite-key-only-if-unchanged.html} | 227 +++---
docs/edge/design/ozone-enhancement-proposals.html | 2 +-
docs/edge/design/recon1.html | 2 +-
docs/edge/design/recon2.html | 2 +-
docs/edge/design/s3-performance.html | 2 +-
docs/edge/design/s3gateway.html | 2 +-
docs/edge/design/scmha.html | 2 +-
docs/edge/design/secure-s3.html | 2 +-
docs/edge/design/storage-class.html | 2 +-
docs/edge/design/symmetric-token-signatures.html | 2 +-
docs/edge/design/tde.html | 2 +-
docs/edge/design/token.html | 2 +-
docs/edge/design/topology.html | 2 +-
docs/edge/design/trash.html | 2 +-
docs/edge/design/typesafeconfig.html | 2 +-
docs/edge/design/upgrade-dev-primer.html | 2 +-
docs/edge/design/volume-management.html | 2 +-
docs/edge/en/sitemap.xml | 346 ++++----
docs/edge/feature.html | 2 +-
docs/edge/feature/decommission.html | 5 +-
docs/edge/feature/dn-merge-rocksdb.html | 10 +-
docs/edge/feature/erasurecoding.html | 14 +-
docs/edge/feature/faircallqueue.html | 2 +-
docs/edge/feature/index.xml | 2 +-
docs/edge/feature/nonrolling-upgrade.html | 19 +-
docs/edge/feature/observability.html | 2 +-
docs/edge/feature/om-ha.html | 2 +-
docs/edge/feature/prefixfso.html | 2 +-
docs/edge/feature/quota.html | 2 +-
docs/edge/feature/recon.html | 2 +-
docs/edge/feature/reconfigurability.html | 2 +-
.../feature/s3-multi-tenancy-access-control.html | 2 +-
docs/edge/feature/s3-multi-tenancy-setup.html | 2 +-
docs/edge/feature/s3-multi-tenancy.html | 2 +-
docs/edge/feature/s3-tenant-commands.html | 2 +-
docs/edge/feature/scm-ha.html | 6 +-
docs/edge/feature/snapshot.html | 4 +-
docs/edge/feature/streaming-write-pipeline.html | 2 +-
docs/edge/feature/topology.html | 2 +-
docs/edge/index.html | 2 +-
docs/edge/index.xml | 140 ++--
docs/edge/interface.html | 2 +-
docs/edge/interface/cli.html | 7 +-
docs/edge/interface/csi.html | 4 +-
docs/edge/interface/httpfs.html | 4 +-
docs/edge/interface/javaapi.html | 2 +-
docs/edge/interface/o3fs.html | 2 +-
docs/edge/interface/ofs.html | 7 +-
docs/edge/interface/reconapi.html | 50 +-
docs/edge/interface/s3.html | 5 +-
docs/edge/interface/swaggerreconapi.html | 2 +-
docs/edge/recipe.html | 2 +-
docs/edge/recipe/botoclient.html | 7 +-
docs/edge/recipe/prometheus.html | 2 +-
docs/edge/recipe/sparkozonefsk8s.html | 2 +-
docs/edge/security.html | 2 +-
docs/edge/security/gdpr.html | 2 +-
docs/edge/security/index.xml | 16 +-
docs/edge/security/secureozone.html | 2 +-
docs/edge/security/securingdatanodes.html | 2 +-
docs/edge/security/securingozonehttp.html | 7 +-
docs/edge/security/securings3.html | 2 +-
docs/edge/security/securingtde.html | 2 +-
docs/edge/security/securityacls.html | 2 +-
docs/edge/security/securitywithranger.html | 2 +-
docs/edge/sitemap.xml | 4 +-
docs/edge/start.html | 2 +-
docs/edge/start/fromsource.html | 2 +-
docs/edge/start/kubernetes.html | 2 +-
docs/edge/start/minikube.html | 2 +-
docs/edge/start/onprem.html | 4 +-
docs/edge/start/runningviadocker.html | 2 +-
docs/edge/start/startfromdockerhub.html | 2 +-
docs/edge/swagger-resources/recon-api.yaml | 19 +-
docs/edge/tools.html | 39 +-
docs/edge/tools/admin.html | 126 ++-
docs/edge/tools/auditparser.html | 2 +-
docs/edge/tools/debug.html | 904 +++++++++++++++++++++
docs/edge/tools/genconf.html | 2 +-
docs/edge/tools/index.xml | 9 +
docs/edge/tools/logsinozone.html | 2 +-
docs/edge/tools/testtools.html | 2 +-
docs/edge/zh/concept.html | 82 +-
docs/edge/zh/concept/containers.html | 82 +-
docs/edge/zh/concept/datanodes.html | 124 ++-
docs/edge/zh/concept/overview.html | 82 +-
docs/edge/zh/concept/ozonemanager.html | 82 +-
docs/edge/zh/concept/recon.html | 84 +-
docs/edge/zh/concept/storagecontainermanager.html | 82 +-
docs/edge/zh/feature.html | 82 +-
docs/edge/zh/feature/decommission.html | 85 +-
docs/edge/zh/feature/dn-merge-rocksdb.html | 88 +-
docs/edge/zh/feature/erasurecoding.html | 82 +-
docs/edge/zh/feature/index.xml | 2 +-
docs/edge/zh/feature/observability.html | 82 +-
docs/edge/zh/feature/om-ha.html | 82 +-
docs/edge/zh/feature/prefixfso.html | 82 +-
docs/edge/zh/feature/quota.html | 82 +-
docs/edge/zh/feature/recon.html | 82 +-
docs/edge/zh/feature/reconfigurability.html | 82 +-
docs/edge/zh/feature/scm-ha.html | 82 +-
docs/edge/zh/feature/topology.html | 82 +-
docs/edge/zh/index.html | 82 +-
docs/edge/zh/index.xml | 152 +++-
docs/edge/zh/interface.html | 152 +++-
docs/edge/{ => zh}/interface/cli.html | 330 ++++----
docs/edge/zh/interface/csi.html | 84 +-
docs/edge/zh/interface/index.xml | 32 +-
docs/edge/zh/interface/javaapi.html | 86 +-
docs/edge/zh/interface/o3fs.html | 84 +-
docs/edge/zh/interface/{o3fs.html => ofs.html} | 251 ++++--
docs/edge/zh/interface/reconapi.html | 594 +++++++++++++-
docs/edge/zh/interface/s3.html | 87 +-
docs/edge/zh/recipe.html | 107 ++-
.../zh/recipe/{prometheus.html => botoclient.html} | 298 ++++---
docs/edge/zh/recipe/index.xml | 9 +
docs/edge/zh/recipe/prometheus.html | 82 +-
docs/edge/zh/recipe/sparkozonefsk8s.html | 82 +-
docs/edge/zh/security.html | 114 ++-
docs/edge/zh/security/gdpr.html | 82 +-
docs/edge/zh/security/index.xml | 23 +-
docs/edge/zh/security/secureozone.html | 82 +-
docs/edge/zh/security/securingdatanodes.html | 84 +-
...curingdatanodes.html => securingozonehttp.html} | 355 ++++++--
docs/edge/zh/security/securings3.html | 82 +-
docs/edge/zh/security/securingtde.html | 82 +-
docs/edge/zh/security/securityacls.html | 82 +-
docs/edge/zh/security/securitywithranger.html | 82 +-
docs/edge/zh/sitemap.xml | 252 ++++--
docs/edge/zh/start.html | 82 +-
docs/edge/zh/start/fromsource.html | 82 +-
docs/edge/zh/start/kubernetes.html | 82 +-
docs/edge/zh/start/minikube.html | 82 +-
docs/edge/zh/start/onprem.html | 88 +-
docs/edge/zh/start/runningviadocker.html | 82 +-
docs/edge/zh/start/startfromdockerhub.html | 82 +-
docs/edge/zh/tools.html | 124 ++-
docs/edge/zh/tools/{genconf.html => admin.html} | 104 ++-
docs/edge/zh/tools/auditparser.html | 82 +-
docs/edge/zh/tools/debug.html | 854 +++++++++++++++++++
docs/edge/zh/tools/genconf.html | 82 +-
docs/edge/zh/tools/index.xml | 18 +
docs/edge/zh/tools/testtools.html | 82 +-
166 files changed, 7232 insertions(+), 2345 deletions(-)
diff --git a/docs/edge/concept.html b/docs/edge/concept.html
index fac50efa..7c410723 100644
--- a/docs/edge/concept.html
+++ b/docs/edge/concept.html
@@ -629,7 +629,7 @@ understand how ozone works in depth.
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/5ce6f0eab381389fd04c3130531b3ec626acbc65">5ce6f0eab3</a>
</span>
</div>
</footer>
diff --git a/docs/edge/concept/containers.html b/docs/edge/concept/containers.html
index 13d18596..d76d52c2 100644
--- a/docs/edge/concept/containers.html
+++ b/docs/edge/concept/containers.html
@@ -529,7 +529,7 @@ Blocks are local information and not managed by SCM. Therefore even if billions
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 25, 2022 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/17d86f179244a9cf9bd331c136e041dcb80cdfb6">17d86f1792</a>
</span>
</div>
</footer>
diff --git a/docs/edge/concept/datanodes.html b/docs/edge/concept/datanodes.html
index 0389505f..1e0bb3d7 100644
--- a/docs/edge/concept/datanodes.html
+++ b/docs/edge/concept/datanodes.html
@@ -521,6 +521,48 @@ blocks that get reported. That is a 40x reduction in the block reports.</p>
<p>This extra indirection helps tremendously with scaling Ozone. SCM has far
less block data to process and the namespace service (Ozone Manager) as a
different service are critical to scaling Ozone.</p>
+<h2 id="notable-configurations">Notable configurations</h2>
+<table>
+<thead>
+<tr>
+<th>key</th>
+<th>default</th>
+<th><div style="width: 300px;">description</div></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>dfs.container.ratis.datanode.storage.dir</td>
+<td>none</td>
+<td>This directory is used for storing Ratis metadata like logs.</td>
+</tr>
+<tr>
+<td>ozone.scm.datanode.id.dir</td>
+<td>none</td>
+<td>The path that datanodes will use to store the datanode ID.</td>
+</tr>
+<tr>
+<td>hdds.datanode.dir</td>
+<td>none</td>
+<td>Determines where HDDS data will be stored on the local filesystem.</td>
+</tr>
+<tr>
+<td>hdds.datanode.dir.du.reserved</td>
+<td>none</td>
+<td>Reserved space in bytes per volume. Always leave this much space free for non dfs use.</td>
+</tr>
+<tr>
+<td>ozone.metadata.dirs</td>
+<td>none</td>
+<td>Directory to store persisted data (RocksDB).</td>
+</tr>
+<tr>
+<td>ozone.recon.address</td>
+<td>0.0.0.0:9891</td>
+<td>RPC address of the Recon. Use <a href="host:port">host:port</a> to connect Recon.</td>
+</tr>
+</tbody>
+</table>
@@ -540,7 +582,7 @@ different service are critical to scaling Ozone.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: September 23, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/0fcb64564d88defc8d2c0ab585bff5717c26632b">0fcb64564d</a>
</span>
</div>
</footer>
diff --git a/docs/edge/concept/overview.html b/docs/edge/concept/overview.html
index f63189a2..59891eef 100644
--- a/docs/edge/concept/overview.html
+++ b/docs/edge/concept/overview.html
@@ -540,7 +540,7 @@ or object store protocols that call into O3 Native protocol.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/5ce6f0eab381389fd04c3130531b3ec626acbc65">5ce6f0eab3</a>
</span>
</div>
</footer>
diff --git a/docs/edge/concept/ozonemanager.html b/docs/edge/concept/ozonemanager.html
index 518d0555..5db33007 100644
--- a/docs/edge/concept/ozonemanager.html
+++ b/docs/edge/concept/ozonemanager.html
@@ -662,7 +662,7 @@ the data from the data node.</li>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 1, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/6c7af5c0b797b6d12a730e35304bc764dd1051f0">6c7af5c0b7</a>
</span>
</div>
</footer>
diff --git a/docs/edge/concept/recon.html b/docs/edge/concept/recon.html
index 49793f2e..8580b4f8 100644
--- a/docs/edge/concept/recon.html
+++ b/docs/edge/concept/recon.html
@@ -704,7 +704,7 @@ OVER_REPLICATED, MIS_REPLICATED) in the cluster at any given time</li>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 1, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/6c7af5c0b797b6d12a730e35304bc764dd1051f0">6c7af5c0b7</a>
</span>
</div>
</footer>
diff --git a/docs/edge/concept/storagecontainermanager.html b/docs/edge/concept/storagecontainermanager.html
index e3434c24..cd1f2335 100644
--- a/docs/edge/concept/storagecontainermanager.html
+++ b/docs/edge/concept/storagecontainermanager.html
@@ -550,7 +550,7 @@ token infrastructure depends on this certificate infrastructure.</p>
<li>Block data is deleted in the background. Need a list to follow the progress.</li>
</ul>
</li>
-<li>Valid cert, Revoked certs</li>
+<li>Valid cert</li>
<li>Used by the internal Certificate Authority to authorize other Ozone services</li>
</ul>
<h2 id="notable-configurations">Notable configurations</h2>
@@ -609,7 +609,7 @@ token infrastructure depends on this certificate infrastructure.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: June 11, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/0c47b0f3bfaf39f1625295a2631c21276c48b9f8">0c47b0f3bf</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design.html b/docs/edge/design.html
index 9b05fb0a..a19af786 100644
--- a/docs/edge/design.html
+++ b/docs/edge/design.html
@@ -449,6 +449,16 @@ s=d.getElementsByTagName('script')[0];
</thead>
<tbody>
+ <tr>
+ <td>2024-04-05</td>
+ <td>
+ <a href="https://issues.apache.org/jira/browse/HDDS-10657">HDDS-10657</a>
+ </td>
+ <td><a href="./design/overwrite-key-only-if-unchanged.html">Overwriting an Ozone Key only if it has not changed.</a></td>
+ <td>A minimal design illustrating how to replace a key in Ozone only if it has not changes since it was read.</td>
+ <td>accepted</td>
+ </tr>
+
<tr>
<td>2023-05-17</td>
<td>
@@ -764,7 +774,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT
+ Version: 2.0.0-SNAPSHOT
</span>
</div>
</footer>
diff --git a/docs/edge/design/configless.html b/docs/edge/design/configless.html
index 2b31ec14..abd15977 100644
--- a/docs/edge/design/configless.html
+++ b/docs/edge/design/configless.html
@@ -474,7 +474,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9872253e89377624dfea5fb9b321538fc70f91c4">9872253e89</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/decommissioning.html b/docs/edge/design/decommissioning.html
index a242df63..0d5de1d5 100644
--- a/docs/edge/design/decommissioning.html
+++ b/docs/edge/design/decommissioning.html
@@ -1306,7 +1306,7 @@ Containers to copy (0) = Replica Count (1) - inflight copies (1)
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 9, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/45eee3fa5d29f49eaed0758d1703d446d56e70fb">45eee3fa5d</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/dn-merge-rocksdb.html b/docs/edge/design/dn-merge-rocksdb.html
index 6e3bbf1d..4875fead 100644
--- a/docs/edge/design/dn-merge-rocksdb.html
+++ b/docs/edge/design/dn-merge-rocksdb.html
@@ -471,7 +471,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: May 26, 2022 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/a6b5174fbbc9282a59b2765433666d4c13399f2e">a6b5174fbb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/ec.html b/docs/edge/design/ec.html
index f06a1d21..7196357b 100644
--- a/docs/edge/design/ec.html
+++ b/docs/edge/design/ec.html
@@ -478,7 +478,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/5ce6f0eab381389fd04c3130531b3ec626acbc65">5ce6f0eab3</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/gdpr.html b/docs/edge/design/gdpr.html
index 639dc84b..a9250bae 100644
--- a/docs/edge/design/gdpr.html
+++ b/docs/edge/design/gdpr.html
@@ -472,7 +472,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9872253e89377624dfea5fb9b321538fc70f91c4">9872253e89</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/httpfs.html b/docs/edge/design/httpfs.html
index 02c2f947..cc3a7f15 100644
--- a/docs/edge/design/httpfs.html
+++ b/docs/edge/design/httpfs.html
@@ -473,7 +473,7 @@ to interact and integrate with Ozone.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 7, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/584d68bd51276b57479350dc773cbefb53f67461">584d68bd51</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/index.xml b/docs/edge/design/index.xml
index c5f03872..495506ec 100644
--- a/docs/edge/design/index.xml
+++ b/docs/edge/design/index.xml
@@ -6,7 +6,16 @@
<description>Recent content in Designs on Ozone</description>
<generator>Hugo -- gohugo.io</generator>
<language>en-us</language>
- <lastBuildDate>Wed, 17 May 2023 00:00:00 +0000</lastBuildDate><atom:link href="/design/index.xml" rel="self" type="application/rss+xml" />
+ <lastBuildDate>Fri, 05 Apr 2024 00:00:00 +0000</lastBuildDate><atom:link href="/design/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Overwriting an Ozone Key only if it has not changed.</title>
+ <link>/design/overwrite-key-only-if-unchanged.html</link>
+ <pubDate>Fri, 05 Apr 2024 00:00:00 +0000</pubDate>
+
+ <guid>/design/overwrite-key-only-if-unchanged.html</guid>
+ <description>A minimal design illustrating how to replace a key in Ozone only if it has not changes since it was read.</description>
+ </item>
+
<item>
<title>Ozone Token Signatures using Symmetric Keys</title>
<link>/design/symmetric-token-signatures.html</link>
diff --git a/docs/edge/design/locks.html b/docs/edge/design/locks.html
index a5a839db..b0d5de01 100644
--- a/docs/edge/design/locks.html
+++ b/docs/edge/design/locks.html
@@ -471,7 +471,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9872253e89377624dfea5fb9b321538fc70f91c4">9872253e89</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/multiraft.html b/docs/edge/design/multiraft.html
index 98eada13..715ea7f8 100644
--- a/docs/edge/design/multiraft.html
+++ b/docs/edge/design/multiraft.html
@@ -472,7 +472,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: July 27, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/e643ab2761f66bd223a73242c530e29c686244d3">e643ab2761</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/namespace-support.html b/docs/edge/design/namespace-support.html
index 5c6d6a28..c6c4f30d 100644
--- a/docs/edge/design/namespace-support.html
+++ b/docs/edge/design/namespace-support.html
@@ -474,7 +474,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 12, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/ec38f01de82ecb6dab4294924e4602fe87ee6c06">ec38f01de8</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/nfs.html b/docs/edge/design/nfs.html
index e407893a..09226ba1 100644
--- a/docs/edge/design/nfs.html
+++ b/docs/edge/design/nfs.html
@@ -477,7 +477,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9872253e89377624dfea5fb9b321538fc70f91c4">9872253e89</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/nonrolling-upgrade.html b/docs/edge/design/nonrolling-upgrade.html
index 71be1433..7cf9f0c2 100644
--- a/docs/edge/design/nonrolling-upgrade.html
+++ b/docs/edge/design/nonrolling-upgrade.html
@@ -473,7 +473,7 @@ upgrades in Ozone.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 6, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/3ea88e1403f957297435e238d1c8b57f0ea2304d">3ea88e1403</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/ofs.html b/docs/edge/design/ofs.html
index 0fd4cb11..253bf46d 100644
--- a/docs/edge/design/ofs.html
+++ b/docs/edge/design/ofs.html
@@ -474,7 +474,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/5ce6f0eab381389fd04c3130531b3ec626acbc65">5ce6f0eab3</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/omha.html b/docs/edge/design/omha.html
index 3a75ae59..55ae1932 100644
--- a/docs/edge/design/omha.html
+++ b/docs/edge/design/omha.html
@@ -481,7 +481,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9872253e89377624dfea5fb9b321538fc70f91c4">9872253e89</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/omprepare.html b/docs/edge/design/omprepare.html
index 519aadc8..b755f773 100644
--- a/docs/edge/design/omprepare.html
+++ b/docs/edge/design/omprepare.html
@@ -497,7 +497,7 @@ prepared state by using the following command.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 13, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/6e027a1befda1004f81ff1d169ec25f98bd452e0">6e027a1bef</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/volume-management.html b/docs/edge/design/overwrite-key-only-if-unchanged.html
similarity index 54%
copy from docs/edge/design/volume-management.html
copy to docs/edge/design/overwrite-key-only-if-unchanged.html
index 8ca56fd2..3e4b3cce 100644
--- a/docs/edge/design/volume-management.html
+++ b/docs/edge/design/overwrite-key-only-if-unchanged.html
@@ -431,14 +431,14 @@ s=d.getElementsByTagName('script')[0];
<div class="col-sm-9 col-sm-offset-3 col-md-10 col-md-offset-2 main-content">
<div class="col-md-9">
- <h1><a href="https://issues.apache.org/jira/browse/HDDS-3331">[HDDS-3331]</a> Ozone Volume Management (accepted) </h1>
- <div><i>Authors: Marton Elek, Arpit Agarwal, Sanjay Radia</i><div class="pull-right">2020-04-02</div></div>
+ <h1><a href="https://issues.apache.org/jira/browse/HDDS-10657">[HDDS-10657]</a> Overwriting an Ozone Key only if it has not changed. (accepted) </h1>
+ <div><i>Authors: Stephen ODonnell</i><div class="pull-right">2024-04-05</div></div>
<p> </p>
<div class="panel panel-success">
<div class="panel-heading">Summary</div>
<div class="panel-body">
- A simplified version of mapping between S3 buckets and Ozone volume/buckets
+ A minimal design illustrating how to replace a key in Ozone only if it has not changes since it was read.
</div>
</div>
@@ -455,136 +455,119 @@ s=d.getElementsByTagName('script')[0];
See the License for the specific language governing permissions and
limitations under the License. See accompanying LICENSE file.
-->
-<h2 id="introduction">Introduction</h2>
-<p>This document explores how we can improve the Ozone volume semantics especially with respect to the S3 compatibility layer.</p>
-<h2 id="the-problems">The Problems</h2>
+<p>Ozone offers write semantics where the last writer to commit a key wins. Therefore multiple writers can concurrently write the same key, and which ever commits last will effectively overwrite all data that came before it.</p>
+<p>As an extension of this, there is no “locking” on a key which is being replaced.</p>
+<p>For any key, but especially a large key, it can take significant time to read and write it. There are scenarios where it would be desirable to replace a key in Ozone, but only if the key has not changed since it was read. With the absence of a lock, such an operation is not possible today.</p>
+<h2 id="as-things-stand">As Things Stand</h2>
+<p>Internally, all Ozone keys have both an objectID and UpdateID which are stored in OM as part of the key metadata.</p>
+<p>Each time something changes on the key, whether it is data or metadata, the updateID is changed. It comes from the ratis transactionID and is generally an increasing number.</p>
+<p>When an existing key is over written, its existing metadata including the ObjectID and ACLs are mirrored onto the new key version. The only metadata which is replaced is any custom metadata stored on the key by the user. Upon commit, the updateID is also changed to the current Ratis transaction ID.</p>
+<p>Writing a key in Ozone is a 3 step process:</p>
<ol>
-<li>Unprivileged users cannot enumerate volumes.</li>
-<li>The mapping of S3 buckets to Ozone volumes is confusing. Based on external feedback it’s hard to understand the exact Ozone URL to be used.</li>
-<li>The volume name is not friendly and cannot be remembered by humans.</li>
-<li>Ozone buckets created via the native object store interface are not visible via the S3 gateway.</li>
-<li>We don’t support the revocation of access keys.</li>
+<li>The key is opened via an Open Key request from the client to OM</li>
+<li>The client writes data to the data nodes</li>
+<li>The client commits the key to OM via a Commit Key call.</li>
</ol>
-<p>We explore some of these in more detail in subsequent sections.</p>
-<h3 id="volume-enumeration-problem">Volume enumeration problem</h3>
-<p>Currently when a user enumerates volumes, they see the list of volumes that they own. This means that when an unprivileged user enumerates volumes, it always gets any empty list. Instead users should be able to see all volumes that they have been granted read or write access to.</p>
-<p>This also has an impact on <a href="https://issues.apache.org/jira/browse/HDDS-2665">ofs</a> which makes volumes appear as top-level directories.</p>
-<h3 id="s3-to-hcfs-path-mapping-problem">S3 to HCFS path mapping problem</h3>
-<p>Ozone has the semantics of volume <em>and</em> buckets while S3 has only buckets. To make it possible to use the same bucket both from Hadoop world and via S3 we need a mapping between them.</p>
-<p>Currently we maintain a map between the S3 buckets and Ozone volumes + buckets in <code>OmMetadataManagerImpl</code></p>
-<pre><code>s3_bucket --> ozone_volume/ozone_bucket
-</code></pre><p>The current implementation uses the <code>"s3" + s3UserName</code> string as the volume name and the <code>s3BucketName</code> as the bucket name. Where <code>s3UserName</code> is is the <code>DigestUtils.md5Hex(kerberosUsername.toLowerCase())</code></p>
-<p>To create an S3 bucket and use it from o3fs, you should:</p>
+<p>Note, that as things stand, it is possible to lose metadata updates (eg ACL changes) when a key is overwritten.</p>
<ol>
-<li>Get your personal secret based on your kerberos keytab</li>
+<li>If the key exists, then a new copy of the key is open for writing.</li>
+<li>While the new copy is open, another process updates the ACLs for the key</li>
+<li>On commit, the new ACLs are not copied to the new key as the new key made a copy of the existing metadata at the time the key was opened.</li>
</ol>
-<pre><code>> kinit -kt /etc/security/keytabs/testuser.keytab testuser/scm
-> ozone s3 getsecret
-awsAccessKey=testuser/scm@EXAMPLE.COM
-awsSecret=7a6d81dbae019085585513757b1e5332289bdbffa849126bcb7c20f2d9852092
-</code></pre><ol start="2">
-<li>Create the bucket with S3 cli</li>
-</ol>
-<pre><code>> export AWS_ACCESS_KEY_ID=testuser/scm@EXAMPLE.COM
-> export AWS_SECRET_ACCESS_KEY=7a6d81dbae019085585513757b1e5332289bdbffa849126bcb7c20f2d9852092
-> aws s3api --endpoint http://localhost:9878 create-bucket --bucket=bucket1
-</code></pre><ol start="3">
-<li>And identify the ozone path</li>
-</ol>
-<pre><code>> ozone s3 path bucket1
-Volume name for S3Bucket is : s3c89e813c80ffcea9543004d57b2a1239
-Ozone FileSystem Uri is : o3fs://bucket1.s3c89e813c80ffcea9543004d57b2a1239
-</code></pre><h2 id="proposed-solution1">Proposed solution[1]</h2>
-<h3 id="supporting-multiple-access-keys-5-from-the-problem-listing">Supporting multiple access keys (#5 from the problem listing)</h3>
-<p>Problem #5 can be easily supported with improving the <code>ozone s3</code> CLI. Ozone has a separated table for the S3 secrets and the API can be improved to handle multiple secrets for one specific kerberos user.</p>
-<h3 id="solving-the-mapping-problem-2-4-from-the-problem-listing">Solving the mapping problem (#2-4 from the problem listing)</h3>
-<ol>
-<li>Let’s always use <code>s3v</code> volume for all the s3 buckets <strong>if the bucket is created from the s3 interface</strong>.</li>
-</ol>
-<p>This is an easy an fast method, but with this approach not all the volumes are available via the S3 interface. We need to provide a method to publish any of the ozone volumes / buckets.</p>
-<ol start="2">
-<li>Let’s improve the existing toolset to expose <strong>any</strong> Ozone volume/bucket as an s3 bucket. (Eg. expose <code>o3:/vol1/bucketx</code> as an S3 bucket <code>s3://foobar</code> )</li>
-</ol>
-<p><strong>Implementation</strong>:</p>
-<p>The first part is easy compared to the current implementation. We don’t need any mapping table any more.</p>
-<p>To implement the second (expose ozone buckets as s3 buckets) we have multiple options:</p>
-<ol>
-<li>Store some metadata (** s3 bucket name **) on each of the buckets</li>
-<li>Implement a <strong>symbolic link</strong> mechanism which makes it possible to <em>link</em> to any volume/buckets from the “s3” volume.</li>
-</ol>
-<p>The first approach required a secondary cache table and it violates the naming hierarchy. The s3 bucket name is a global unique name, therefore it’s more than just a single attribute on a specific object. It’s more like an element in the hierarchy. For this reason the second option is proposed:</p>
-<p>For example if the default s3 volume is <code>s3v</code></p>
+<p>With the technique described in the next section, that problem is removed in this design, as the ACL update will change the updateID, and the key will not be committed.</p>
+<h2 id="atomic-key-replacement">Atomic Key Replacement</h2>
+<p>In relational database applications, records are often assigned an update counter similar to the updateID for a key in Ozone. The data record can be read and displayed on a UI to be edited, and then written back to the database. However another user could have made an edit to the same record in the mean time, and if the record is written back without any checks, those edits could be lost.</p>
+<p>To combat this, “optimistic locking” is used. With Optimistic locking, no locks are actually involved. The client reads the data along with the update counter. When it attempts to write the data back, it validates the record has not change by including the updateID in the update statement, eg:</p>
+<pre><code>update customerDetails
+set <columns = values>
+where customerID = :b1
+and updateCounter = :b2
+</code></pre><p>If no records are updated, the application must display an error or reload the customer record to handle the problem.</p>
+<p>In Ozone the same concept can be used to perform an atomic update of a key only if it has not changed since the key details were originally read.</p>
+<p>To do this:</p>
<ol>
-<li>Every new buckets created via s3 interface will be placed under the <code>/s3v</code> volume</li>
-<li>Any existing <strong>Ozone</strong> buckets can be exposed by linking to it from s3: <code>ozone sh bucket link /vol1/bucket1 /s3v/s3bucketname</code></li>
+<li>The client reads the key details as usual. The key details can be extended to include the existing updateID as it is currently not passed to the client. This field already exists, but when exposed to the client it will be referred to as the key generation.</li>
+<li>The client can inspect the read key details and decide if it wants to replace the key.</li>
+<li>The client opens a new key for writing with the same key name as the original, passing the previously read generation in a new field. Call this new field expectedGeneration.</li>
+<li>On OM, it receives the openKey request as usual and detects the presence of the expectedGeneration field.</li>
+<li>On OM, it first ensures that a key is present with the given key name and having a updateID == expectedGeneration. If so, it opens the key and stored the details including the expectedGeneration in the openKeyTable. As things stand, the other existing key metadata copied from the original key is stored in the openKeyTable too.</li>
+<li>The client continues to write the data as usual. This can be the same data in a different format (eg Ratis to EC conversion), or new data in the key depending on the application’s needs.</li>
+<li>On commit key, the client does not need to send the expectedGeneration again, as the open key contains it.</li>
+<li>On OM, on commit key, it validates the key still exists with the given key name and its stored updateID is unchanged when compared with the expectedGeneration. If so the key is committed, otherwise an error is returned to the client.</li>
</ol>
-<p><strong>Lock contention problem</strong></p>
-<p>One possible problem with using just one volume is using the locks of the same volume for all the S3 buckets (thanks Xiaoyu). But this shouldn’t be a big problem.</p>
+<p>Note that any change to a key will change the updateID. This is existing behaviour, and committing a rewritten key will also modify the updateID. Note this also offers protection against concurrent rewrites.</p>
+<p>An optional enhancement for large keys, is that on each block allocation the expectedGeneration can be checked against the current key version to ensure it has not changed. This would allow the rewrite to fail early if a large multi block key is modified.</p>
+<h3 id="alternative-proposal">Alternative Proposal</h3>
<ol>
-<li>We hold only a READ lock. Most of the time it can acquired without any contention (writing lock is required only to change owner / set quota)</li>
-<li>For symbolic link the read lock is only required for the first read. After that the lock of the referenced volume will be used. In case of any performance problem multiple volumes and links can be used.</li>
+<li>Pass the expected expectedGeneration to the rewrite API which passes it down to the relevant key stream, effectively saving it on the client</li>
+<li>Client attaches the expectedGeneration to the commit request to indicate a rewrite instead of a put</li>
+<li>OM checks the passed generation against the stored update ID and returns the corresponding success/fail result</li>
</ol>
-<p>Note: Sanjay is added to the authors as the original proposal of this approach.</p>
-<h4 id="implementation-details">Implementation details</h4>
-<ul>
-<li><code>bucket link</code> operation creates a link bucket. Links are like regular buckets, stored in DB the same way, but with two new, optional pieces of information: source volume and bucket. (The bucket being referenced by the link is called “source”, not “target”, to follow symlink terminology.)</li>
-<li>Link buckets share the namespace with regular buckets. If a bucket or link with the same name already exists, a <code>BUCKET_ALREADY_EXISTS</code> result is returned.</li>
-<li>Link buckets are not inherently specific to a user, access is restricted only by ACL.</li>
-<li>Link buckets retain their owner ACLs, which are inherited from the default ACLs of their volume. Additionally, link buckets allow anyone to have READ and WRITE permissions, which is similar to Linux POSIX symbolic.</li>
-<li>All add/set/remove ACL operation proxy to the source bucket. Getacl operation of a link bucket shows link bucket’s ACL.</li>
-<li>Links are persistent, ie. they can be used until they are deleted.</li>
-<li>Existing bucket operations (info, delete, ACL) work on the link object in the same way as they do on regular buckets. No new link-specific RPC is required.</li>
-<li>Links are followed for key operations (list, get, put, etc.). Read permission on the source bucket is required for this.</li>
-<li>Checks for existence of the source bucket, as well as ACL, are performed only when following the link (similar to symlinks). Source bucket is not checked when operating on the link bucket itself (eg. deleting it). This avoids the need for reverse checks for each bucket delete or ACL change.</li>
-<li>Bucket links are generic, not restricted to the <code>s3v</code> volume.</li>
-</ul>
-<h2 id="alternative-approaches-and-reasons-to-reject">Alternative approaches and reasons to reject</h2>
-<p>To solve the the <em>s3 bucket name to ozone bucket name mapping</em> problem some other approaches are also considered. They are rejected but keeping them in this section together with the reasons to reject.</p>
-<h3 id="1-predefined-volume-mapping">1. Predefined volume mapping</h3>
+<p>The advantage of this alternative approach is that it does not require the expectedGeneration to be stored in the openKey table.</p>
+<p>However the client code required to implement this appears more complex due to having different key commit logic for Ratis and EC and the parameter needing to be passed through many method calls.</p>
+<p>PR <a href="https://github.com/apache/ozone/pull/5524">#5524</a> illustrates this approach for the atomicKeyCreation feature which was added to S3.</p>
+<p>The existing implementation for key creation stores various attributes (metadata, creation time, ACLs, ReplicationConfig) in the openKey table, so storing the expectedGeneration keeps with that convention, which is less confusing for future developers.</p>
+<p>In terms of forward / backward compatibility both solutions are equivalent. Only a new parameter is required within the KeyArgs passed to create and commit Key.</p>
+<p>If an upgraded server is rolled back, it will still be able to deal with an openKey entry containing expectedGeneration, but it will not process it atomically.</p>
+<h3 id="scope">Scope</h3>
+<p>The intention is to first implement this for OBS buckets. Then address FSO buckets. FSO bucket handling will reuse the same fields, but the handlers on OM are different. We also need to decide on what should happen if a key is renamed or moved folders during the rewrite.</p>
+<p>Multi-part keys need more investigation and hence are also excluded in the initial version.</p>
+<h2 id="changes-required">Changes Required</h2>
+<p>In order to enable the above steps on Ozone, several small changes are needed.</p>
+<h3 id="wire-protocol">Wire Protocol</h3>
<ol>
-<li>Let’s support multiple <code>ACCESS_KEY_ID</code> for the same user.</li>
-<li>For each <code>ACCESS_KEY_ID</code> a volume name MUST be defined.</li>
-<li>Instead of using a specific mapping table, the <code>ACCESS_KEY_ID</code> would provide a <strong>view</strong> of the buckets in the specified volume.</li>
+<li>The expectedGeneration needs to be added to the KeyInfo protobuf object so it can be stored in the openKey table.</li>
+<li>The expectedGeneration needs to be added to the keyArgs protobuf object, which is passed from the client to OM when creating a key.</li>
</ol>
-<p>With this approach the used volume will be more visible and – hopefully – understandable.</p>
-<p>Instead of using <code>ozone s3 getsecret</code>, following commands would be used:</p>
+<p>No new messages need to be defined.</p>
+<h3 id="on-om">On OM</h3>
+<p>No new OM handlers are needed. The existing OpenKey and CommitKey handlers will receive the new expectedGeneration and perform the checks.</p>
+<p>No new locks are needed on OM. As part of the openKey and commitKey, there are existing locks taken to ensure the key open / commit is atomic. The new checks are performed under those locks, and come down to a couple of long comparisons, so add negligible overhead.</p>
+<h3 id="on-the-client">On The Client</h3>
<ol>
-<li><code>ozone s3 secret create --volume=myvolume</code>: To create a secret and use myvolume for all of these buckets</li>
-<li><code>ozone s3 secret list</code>: To list all of the existing S3 secrets (available for the current user)</li>
-<li><code>ozone s3 secret delete <ACCESS_KEY_ID</code>: To delete any secret</li>
+<li>We need to allow the updateID (called generation on the client) of an existing key to be accessible when an existing details are read, by adding it to OzoneKey and OzoneKeyDetails. There are internal object changes and do no impact any APIs.</li>
+<li>To pass the expectedGeneration to OM on key open, it would be possible to overload the existing OzoneBucket.createKey() method, which already has several overloaded versions, or create a new explicit method on Ozone bucket called rewriteKey, passing the expectedGeneration, eg:</li>
</ol>
-<p>The <code>AWS_ACCESS_KEY_ID</code> should be a random identifier instead of using a kerberos principal.</p>
-<ul>
-<li><strong>pro</strong>: Easier to understand</li>
-<li><strong>con</strong>: We should either have global unique bucket names or it will be possible to see two different buckets with</li>
-<li><strong>con</strong>: It can be hard to remember which volumes are assigned to a specific ACCESS_KEY_ID</li>
-</ul>
-<h3 id="3-string-magic">3. String Magic</h3>
-<p>We can try to make volume name visible for the S3 world by using some structured bucket names. Unfortunately the available separator characters are very limited:</p>
-<p>For example we can’t use <code>/</code></p>
-<pre><code>aws s3api create-bucket --bucket=vol1/bucket1
-
-Parameter validation failed:
-Invalid bucket name "vol1/bucket1": Bucket name must match the regex "^[a-zA-Z0-9.\-_]{1,255}$" or be an ARN matching the regex "^arn:(aws).*:s3:[a-z\-0-9]+:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-]{1,63}$"
-</code></pre><p>But it’s possible to use <code>volume-bucket</code> notion:</p>
-<pre><code>aws s3api create-bucket --bucket=vol1-bucket1
-</code></pre><ul>
-<li><strong>pro</strong>: Volume mapping is visible all the time.</li>
-<li><strong>con</strong>: Harder to use any external tool with defaults (all the buckets should have at least one <code>-</code>)</li>
-<li><strong>con</strong>: Hierarchy is not visble. The uniform way to separated elements in fs hierarchy is <code>/</code>. It can be confusing.</li>
-<li></li>
-</ul>
-<h3 id="4-remove-volume-from-ozonefs-paths">4. Remove volume From OzoneFs Paths</h3>
-<p>We can also make volumes a lightweight <em>bucket group</em> object by removing it from the ozonefs path. With this approach we can use all the benefits of the volumes as an administration object but it would be removed from the <code>o3fs</code> path.</p>
-<ul>
-<li><strong>pro</strong>: can be the most simple solution. Easy to understand as there are no more volumes in the path.</li>
-<li><strong>con</strong>: Bigger change (all the API can’t be modified to make volumes optional)</li>
-<li><strong>con</strong>: Harder to dis-joint namespaces based on volumes. (With the current scheme, it’s easier to delegate the responsibilities for one volumes to a different OM).</li>
-<li><strong>con</strong>: We lose volumes as the top-level directories in <code>ofs</code> scheme.</li>
-<li><strong>con</strong>: One level of hierarchy might not be enough in case of multi-tenancy.</li>
-<li><strong>con</strong>: One level of hierarchy is not enough if we would like to provide separated level for users and admins</li>
-<li><strong>con</strong>: Hierarchical abstraction can be easier to manage and understand</li>
-</ul>
+<pre><code>public OzoneOutputStream rewriteKey(String volumeName, String bucketName, String keyName, long size, long expectedGeneration, ReplicationConfig replicationConfigOfNewKey)
+ throws IOException
+
+// Can also add an overloaded version of these methods to pass a metadata map, as with the existing
+// create key method.
+</code></pre><p>This specification is roughly in line with the exiting createKey method:</p>
+<pre><code> public OzoneOutputStream createKey(
+ String volumeName, String bucketName, String keyName, long size,
+ ReplicationConfig replicationConfig,
+ Map<String, String> metadata)
+</code></pre><p>An alternative, is to create a new overloaded createKey, but it is probably less confusing to have the new rewriteKey method:</p>
+<pre><code> public OzoneOutputStream createKey(
+ String volumeName, String bucketName, String keyName, long size,
+ ReplicationConfig replicationConfig, long expectedUpdateID)
+</code></pre><p>The intended usage of this API, is that the existing key details are read, perhaps inspected and then used to open the new key, and then data is written. In this example, the key is overwritten with the same data in a different replication format. Equally, the key could be rewritten with the original data modified in some application specific way. The atomic check guarantees against lost updates if another application thread is attempting to update the same key in a diffe [...]
+<pre><code>OzoneKeyDetails exisitingKey = bucket.getKey(keyName);
+// Insepect the key and decide if overwrite is desired:
+boolean shouldOverwrite = ...
+if (shouldOverwrite) {
+ try (OutputStream os = bucket.rewriteKey(existingKey.getBucket, existingKey.getVolume,
+ existingKey.getKeyName, existingKey.getSize(), existingKey.getGeneration(), newRepConfig) {
+ os.write(bucket.readKey(keyName))
+}
+</code></pre><h2 id="upgrade-and-compatibility">Upgrade and Compatibility</h2>
+<h3 id="client-server-protocol">Client Server Protocol</h3>
+<p>If a newer client is talking to an older server, it could call the new atomic API but the server will ignore it without error. The client server versioning framework can be used to avoid this problem.</p>
+<p>No new protobuf messages are needed and hence no new Client to OM APIs as the existing APIs are used with an additional parameter.</p>
+<p>A single extra field is added to the KeyArgs object, which is passed from the client to OM on key open and commit. This is a new field, so it will be null if not set, and the server will ignore it if it does not expect it.</p>
+<h3 id="disk-layout">Disk Layout</h3>
+<p>A single extra field is added to the OMKeyInfo object which is stored in the openKey table. This is a new field, so it will be null if not set, and the server will ignore it if it does not expect it.</p>
+<p>There should be no impact on upgrade / downgrade with the new field added in this way.</p>
+<h2 id="other-storage-systems">Other Storage Systems</h2>
+<p>Amazon S3 does not offer a facility like this.</p>
+<p>Google Cloud has a concept of a generationID which is used in various <a href="https://cloud.google.com/storage/docs/json_api/v1/objects/update">API calls</a>.</p>
+<h2 id="further-ideas">Further Ideas</h2>
+<p>The intention of this initial design is to make as few changes to Ozone as possible to enable overwriting a key if it has not changed.</p>
+<p>It would be possible to have separate generation IDs for metadata changes and data changes to give a more fine grained approach.</p>
+<p>It would also be possible to expose these IDs over the S3 interface as well as the Java interface.</p>
+<p>However both these options required more changes to Ozone and more API surface to test and support.</p>
+<p>The changes suggested here are small, and carry little risk to existing operations if the new field is not passed. They also do not rule out extending the idea to cover a separate metadata generation if such a thing is desired by enough users.</p>
</div>
@@ -597,7 +580,7 @@ Invalid bucket name "vol1/bucket1": Bucket name must match the regex &
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 29, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/1eaddc43d6be487a07c661db8daa5b2ddac9dd46">1eaddc43d6</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/ozone-enhancement-proposals.html b/docs/edge/design/ozone-enhancement-proposals.html
index 4ef5a814..398e0404 100644
--- a/docs/edge/design/ozone-enhancement-proposals.html
+++ b/docs/edge/design/ozone-enhancement-proposals.html
@@ -644,7 +644,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 9, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/45eee3fa5d29f49eaed0758d1703d446d56e70fb">45eee3fa5d</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/recon1.html b/docs/edge/design/recon1.html
index c9d308e5..8abadc6e 100644
--- a/docs/edge/design/recon1.html
+++ b/docs/edge/design/recon1.html
@@ -477,7 +477,7 @@ other components and store it and do historical queries (eg. out-of-disk-space t
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9872253e89377624dfea5fb9b321538fc70f91c4">9872253e89</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/recon2.html b/docs/edge/design/recon2.html
index 6b9a1de3..7a6c50f6 100644
--- a/docs/edge/design/recon2.html
+++ b/docs/edge/design/recon2.html
@@ -473,7 +473,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: July 27, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/e643ab2761f66bd223a73242c530e29c686244d3">e643ab2761</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/s3-performance.html b/docs/edge/design/s3-performance.html
index bfd0410e..96d14759 100644
--- a/docs/edge/design/s3-performance.html
+++ b/docs/edge/design/s3-performance.html
@@ -644,7 +644,7 @@ public class OzoneClientProducer {
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 9, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/45eee3fa5d29f49eaed0758d1703d446d56e70fb">45eee3fa5d</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/s3gateway.html b/docs/edge/design/s3gateway.html
index da158e7b..422191b1 100644
--- a/docs/edge/design/s3gateway.html
+++ b/docs/edge/design/s3gateway.html
@@ -474,7 +474,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9872253e89377624dfea5fb9b321538fc70f91c4">9872253e89</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/scmha.html b/docs/edge/design/scmha.html
index 729279fb..c6da48eb 100644
--- a/docs/edge/design/scmha.html
+++ b/docs/edge/design/scmha.html
@@ -480,7 +480,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 18, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9e4bcb2d1d03587f966f930c70ab38e8fd06633c">9e4bcb2d1d</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/secure-s3.html b/docs/edge/design/secure-s3.html
index efa9bda3..e02a6665 100644
--- a/docs/edge/design/secure-s3.html
+++ b/docs/edge/design/secure-s3.html
@@ -481,7 +481,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: May 20, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/17ecc58e3c17ff132a31029dc53b4a361362418a">17ecc58e3c</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/storage-class.html b/docs/edge/design/storage-class.html
index ed482538..0db70a11 100644
--- a/docs/edge/design/storage-class.html
+++ b/docs/edge/design/storage-class.html
@@ -471,7 +471,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/5ce6f0eab381389fd04c3130531b3ec626acbc65">5ce6f0eab3</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/symmetric-token-signatures.html b/docs/edge/design/symmetric-token-signatures.html
index 6c4dfd5e..db560d1f 100644
--- a/docs/edge/design/symmetric-token-signatures.html
+++ b/docs/edge/design/symmetric-token-signatures.html
@@ -471,7 +471,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: July 31, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/36d64ffac9b6047be281e46f1d95ef85623db3f1">36d64ffac9</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/tde.html b/docs/edge/design/tde.html
index a89555f3..8fef796a 100644
--- a/docs/edge/design/tde.html
+++ b/docs/edge/design/tde.html
@@ -471,7 +471,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9872253e89377624dfea5fb9b321538fc70f91c4">9872253e89</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/token.html b/docs/edge/design/token.html
index c5f6a8b8..53220788 100644
--- a/docs/edge/design/token.html
+++ b/docs/edge/design/token.html
@@ -469,7 +469,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9872253e89377624dfea5fb9b321538fc70f91c4">9872253e89</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/topology.html b/docs/edge/design/topology.html
index 9f0c438f..896cc071 100644
--- a/docs/edge/design/topology.html
+++ b/docs/edge/design/topology.html
@@ -473,7 +473,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/5ce6f0eab381389fd04c3130531b3ec626acbc65">5ce6f0eab3</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/trash.html b/docs/edge/design/trash.html
index f577003f..98e723ab 100644
--- a/docs/edge/design/trash.html
+++ b/docs/edge/design/trash.html
@@ -469,7 +469,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: January 13, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/253e97c218a519293fbbba27530f7cc2bbdad4ca">253e97c218</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/typesafeconfig.html b/docs/edge/design/typesafeconfig.html
index b50b779c..1d67cb8d 100644
--- a/docs/edge/design/typesafeconfig.html
+++ b/docs/edge/design/typesafeconfig.html
@@ -473,7 +473,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 9, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/a1d53b0781f5a9c89b665210e6853ed551892e47">a1d53b0781</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/upgrade-dev-primer.html b/docs/edge/design/upgrade-dev-primer.html
index 7343f113..21ec5b46 100644
--- a/docs/edge/design/upgrade-dev-primer.html
+++ b/docs/edge/design/upgrade-dev-primer.html
@@ -559,7 +559,7 @@ functionality.</li>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 28, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/5927bd26a61edf964c1ea429f61d27eec4713165">5927bd26a6</a>
</span>
</div>
</footer>
diff --git a/docs/edge/design/volume-management.html b/docs/edge/design/volume-management.html
index 8ca56fd2..8b5410e3 100644
--- a/docs/edge/design/volume-management.html
+++ b/docs/edge/design/volume-management.html
@@ -597,7 +597,7 @@ Invalid bucket name "vol1/bucket1": Bucket name must match the regex &
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: May 24, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/4e32dbaacd80c6d39521579fda04444ea2a95418">4e32dbaacd</a>
</span>
</div>
</footer>
diff --git a/docs/edge/en/sitemap.xml b/docs/edge/en/sitemap.xml
index f5de47fe..14e8e666 100644
--- a/docs/edge/en/sitemap.xml
+++ b/docs/edge/en/sitemap.xml
@@ -3,7 +3,7 @@
xmlns:xhtml="http://www.w3.org/1999/xhtml">
<url>
<loc>/</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-12-05T22:06:34+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -14,9 +14,22 @@
hreflang="en"
href="/"
/>
+ </url><url>
+ <loc>/security/secureozone.html</loc>
+ <lastmod>2024-10-21T00:15:13+08:00</lastmod>
+ <xhtml:link
+ rel="alternate"
+ hreflang="zh"
+ href="/zh/security/secureozone.html"
+ />
+ <xhtml:link
+ rel="alternate"
+ hreflang="en"
+ href="/security/secureozone.html"
+ />
</url><url>
<loc>/concept/overview.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-08-07T18:35:36+02:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -29,10 +42,20 @@
/>
</url><url>
<loc>/interface/ofs.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-05-04T13:52:01-06:00</lastmod>
+ <xhtml:link
+ rel="alternate"
+ hreflang="zh"
+ href="/zh/interface/ofs.html"
+ />
+ <xhtml:link
+ rel="alternate"
+ hreflang="en"
+ href="/interface/ofs.html"
+ />
</url><url>
<loc>/feature/decommission.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-03-05T16:04:33+05:30</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -45,7 +68,7 @@
/>
</url><url>
<loc>/start.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2019-06-28T18:59:33-04:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -58,7 +81,7 @@
/>
</url><url>
<loc>/feature/om-ha.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-02-01T02:08:09+05:30</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -71,7 +94,7 @@
/>
</url><url>
<loc>/feature/erasurecoding.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-03-24T23:03:07+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -84,10 +107,10 @@
/>
</url><url>
<loc>/feature/snapshot.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-04-01T12:52:48+05:30</lastmod>
</url><url>
<loc>/feature/scm-ha.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-11-06T18:31:29+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -99,24 +122,24 @@
href="/feature/scm-ha.html"
/>
</url><url>
- <loc>/security/secureozone.html</loc>
+ <loc>/feature/streaming-write-pipeline.html</loc>
<lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ </url><url>
+ <loc>/security/securingtde.html</loc>
+ <lastmod>2024-10-21T00:15:13+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
- href="/zh/security/secureozone.html"
+ href="/zh/security/securingtde.html"
/>
<xhtml:link
rel="alternate"
hreflang="en"
- href="/security/secureozone.html"
+ href="/security/securingtde.html"
/>
- </url><url>
- <loc>/feature/streaming-write-pipeline.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
</url><url>
<loc>/interface/o3fs.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2022-02-28T21:18:28+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -129,7 +152,7 @@
/>
</url><url>
<loc>/concept/ozonemanager.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-02-01T15:02:58+05:30</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -142,7 +165,7 @@
/>
</url><url>
<loc>/feature/dn-merge-rocksdb.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-11-25T14:32:03+05:30</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -155,7 +178,7 @@
/>
</url><url>
<loc>/feature/prefixfso.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-01-26T08:55:43-08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -168,7 +191,7 @@
/>
</url><url>
<loc>/feature/topology.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-03-29T13:32:17+05:30</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -180,21 +203,34 @@
href="/feature/topology.html"
/>
</url><url>
- <loc>/security/securingtde.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <loc>/security/gdpr.html</loc>
+ <lastmod>2024-10-21T00:15:13+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
- href="/zh/security/securingtde.html"
+ href="/zh/security/gdpr.html"
/>
<xhtml:link
rel="alternate"
hreflang="en"
- href="/security/securingtde.html"
+ href="/security/gdpr.html"
+ />
+ </url><url>
+ <loc>/security/securingdatanodes.html</loc>
+ <lastmod>2024-10-21T00:15:13+08:00</lastmod>
+ <xhtml:link
+ rel="alternate"
+ hreflang="zh"
+ href="/zh/security/securingdatanodes.html"
+ />
+ <xhtml:link
+ rel="alternate"
+ hreflang="en"
+ href="/security/securingdatanodes.html"
/>
</url><url>
<loc>/concept.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-08-07T18:35:36+02:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -207,7 +243,7 @@
/>
</url><url>
<loc>/concept/storagecontainermanager.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-06-11T09:17:37+02:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -219,76 +255,73 @@
href="/concept/storagecontainermanager.html"
/>
</url><url>
- <loc>/security/gdpr.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <loc>/interface/s3.html</loc>
+ <lastmod>2024-12-04T15:41:48-05:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
- href="/zh/security/gdpr.html"
+ href="/zh/interface/s3.html"
/>
<xhtml:link
rel="alternate"
hreflang="en"
- href="/security/gdpr.html"
+ href="/interface/s3.html"
/>
</url><url>
- <loc>/interface/s3.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <loc>/feature/quota.html</loc>
+ <lastmod>2024-10-21T00:15:13+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
- href="/zh/interface/s3.html"
+ href="/zh/feature/quota.html"
/>
<xhtml:link
rel="alternate"
hreflang="en"
- href="/interface/s3.html"
+ href="/feature/quota.html"
/>
</url><url>
- <loc>/security/securingdatanodes.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <loc>/security/securingozonehttp.html</loc>
+ <lastmod>2024-10-21T00:15:13+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
- href="/zh/security/securingdatanodes.html"
+ href="/zh/security/securingozonehttp.html"
/>
<xhtml:link
rel="alternate"
hreflang="en"
- href="/security/securingdatanodes.html"
+ href="/security/securingozonehttp.html"
/>
</url><url>
<loc>/interface/cli.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
- </url><url>
- <loc>/feature.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-07-27T00:58:25+05:30</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
- href="/zh/feature.html"
+ href="/zh/interface/cli.html"
/>
<xhtml:link
rel="alternate"
hreflang="en"
- href="/feature.html"
+ href="/interface/cli.html"
/>
</url><url>
- <loc>/feature/quota.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <loc>/feature.html</loc>
+ <lastmod>2021-02-02T17:10:05+01:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
- href="/zh/feature/quota.html"
+ href="/zh/feature.html"
/>
<xhtml:link
rel="alternate"
hreflang="en"
- href="/feature/quota.html"
+ href="/feature.html"
/>
</url><url>
<loc>/interface/reconapi.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-08-11T21:33:21+05:30</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -300,11 +333,21 @@
href="/interface/reconapi.html"
/>
</url><url>
- <loc>/security/securingozonehttp.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <loc>/security/securings3.html</loc>
+ <lastmod>2024-10-21T00:15:13+08:00</lastmod>
+ <xhtml:link
+ rel="alternate"
+ hreflang="zh"
+ href="/zh/security/securings3.html"
+ />
+ <xhtml:link
+ rel="alternate"
+ hreflang="en"
+ href="/security/securings3.html"
+ />
</url><url>
<loc>/interface/javaapi.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-08-07T18:35:36+02:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -317,7 +360,7 @@
/>
</url><url>
<loc>/concept/containers.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2022-02-25T10:25:55+05:30</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -329,34 +372,34 @@
href="/concept/containers.html"
/>
</url><url>
- <loc>/security/securings3.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <loc>/security.html</loc>
+ <lastmod>2019-09-19T16:41:00-07:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
- href="/zh/security/securings3.html"
+ href="/zh/security.html"
/>
<xhtml:link
rel="alternate"
hreflang="en"
- href="/security/securings3.html"
+ href="/security.html"
/>
</url><url>
- <loc>/security.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <loc>/security/securityacls.html</loc>
+ <lastmod>2024-10-21T00:15:13+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
- href="/zh/security.html"
+ href="/zh/security/securityacls.html"
/>
<xhtml:link
rel="alternate"
hreflang="en"
- href="/security.html"
+ href="/security/securityacls.html"
/>
</url><url>
<loc>/interface/csi.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-12-04T15:41:48-05:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -368,21 +411,21 @@
href="/interface/csi.html"
/>
</url><url>
- <loc>/security/securityacls.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <loc>/security/securitywithranger.html</loc>
+ <lastmod>2024-10-21T00:15:13+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
- href="/zh/security/securityacls.html"
+ href="/zh/security/securitywithranger.html"
/>
<xhtml:link
rel="alternate"
hreflang="en"
- href="/security/securityacls.html"
+ href="/security/securitywithranger.html"
/>
</url><url>
<loc>/concept/datanodes.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-09-23T17:47:30+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -393,25 +436,12 @@
hreflang="en"
href="/concept/datanodes.html"
/>
- </url><url>
- <loc>/security/securitywithranger.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
- <xhtml:link
- rel="alternate"
- hreflang="zh"
- href="/zh/security/securitywithranger.html"
- />
- <xhtml:link
- rel="alternate"
- hreflang="en"
- href="/security/securitywithranger.html"
- />
</url><url>
<loc>/interface/httpfs.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-03-21T14:26:59+05:30</lastmod>
</url><url>
<loc>/feature/recon.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-11-24T16:27:12-08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -424,7 +454,7 @@
/>
</url><url>
<loc>/concept/recon.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-02-01T15:02:58+05:30</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -437,7 +467,7 @@
/>
</url><url>
<loc>/feature/observability.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-02-11T05:43:48-08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -450,7 +480,7 @@
/>
</url><url>
<loc>/recipe.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2019-09-19T14:42:33+02:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -463,13 +493,13 @@
/>
</url><url>
<loc>/feature/nonrolling-upgrade.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-06-27T23:37:16-04:00</lastmod>
</url><url>
<loc>/feature/s3-multi-tenancy.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2022-03-07T12:09:51-08:00</lastmod>
</url><url>
<loc>/start/startfromdockerhub.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2022-04-01T22:17:32+02:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -482,7 +512,7 @@
/>
</url><url>
<loc>/feature/reconfigurability.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-02-23T23:49:21+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -495,16 +525,16 @@
/>
</url><url>
<loc>/feature/s3-multi-tenancy-setup.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2022-07-13T11:21:00-07:00</lastmod>
</url><url>
<loc>/feature/s3-tenant-commands.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-02-13T12:23:07+03:00</lastmod>
</url><url>
<loc>/feature/s3-multi-tenancy-access-control.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2022-04-20T11:07:50-07:00</lastmod>
</url><url>
<loc>/start/onprem.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-06-03T08:09:31-07:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -517,7 +547,7 @@
/>
</url><url>
<loc>/start/minikube.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2019-09-16T15:41:17+02:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -530,7 +560,7 @@
/>
</url><url>
<loc>/start/kubernetes.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-03-09T18:59:26+10:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -543,7 +573,7 @@
/>
</url><url>
<loc>/start/runningviadocker.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2019-09-16T15:41:17+02:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -556,7 +586,7 @@
/>
</url><url>
<loc>/start/fromsource.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-11-04T09:06:13+01:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -567,99 +597,125 @@
hreflang="en"
href="/start/fromsource.html"
/>
+ </url><url>
+ <loc>/tools/debug.html</loc>
+ <lastmod>2024-10-30T12:13:52+05:30</lastmod>
+ <xhtml:link
+ rel="alternate"
+ hreflang="zh"
+ href="/zh/tools/debug.html"
+ />
+ <xhtml:link
+ rel="alternate"
+ hreflang="en"
+ href="/tools/debug.html"
+ />
</url><url>
<loc>/design.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-04-29T10:37:20+01:00</lastmod>
+ </url><url>
+ <loc>/design/overwrite-key-only-if-unchanged.html</loc>
+ <lastmod>2024-04-29T10:37:20+01:00</lastmod>
</url><url>
<loc>/design/symmetric-token-signatures.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-07-31T14:07:54-07:00</lastmod>
</url><url>
<loc>/design/secure-s3.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-05-20T10:11:53+03:00</lastmod>
</url><url>
<loc>/design/httpfs.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-03-07T07:56:35+01:00</lastmod>
</url><url>
<loc>/tools/logsinozone.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-02-06T13:08:14+08:00</lastmod>
</url><url>
<loc>/design/dn-merge-rocksdb.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2022-05-26T10:38:25+08:00</lastmod>
</url><url>
<loc>/design/namespace-support.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-04-12T18:39:59+02:00</lastmod>
</url><url>
<loc>/design/nonrolling-upgrade.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-04-06T09:41:12-07:00</lastmod>
</url><url>
<loc>/design/omprepare.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-04-13T09:19:51-07:00</lastmod>
</url><url>
<loc>/design/upgrade-dev-primer.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-04-28T11:57:26-04:00</lastmod>
</url><url>
<loc>/design/s3-performance.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-03-09T18:59:26+10:00</lastmod>
</url><url>
<loc>/design/ec.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-08-07T18:35:36+02:00</lastmod>
</url><url>
<loc>/design/ofs.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-08-07T18:35:36+02:00</lastmod>
</url><url>
<loc>/design/storage-class.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-08-07T18:35:36+02:00</lastmod>
</url><url>
<loc>/design/volume-management.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-05-24T14:49:40+08:00</lastmod>
</url><url>
<loc>/design/nfs.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-04-07T06:58:59+02:00</lastmod>
</url><url>
<loc>/tools/admin.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-01-18T19:24:12-08:00</lastmod>
+ <xhtml:link
+ rel="alternate"
+ hreflang="zh"
+ href="/zh/tools/admin.html"
+ />
+ <xhtml:link
+ rel="alternate"
+ hreflang="en"
+ href="/tools/admin.html"
+ />
</url><url>
<loc>/design/scmha.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-03-18T10:03:44+01:00</lastmod>
</url><url>
<loc>/design/token.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-04-07T06:58:59+02:00</lastmod>
</url><url>
<loc>/design/trash.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-01-13T03:44:35+08:00</lastmod>
</url><url>
<loc>/design/recon2.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-07-27T16:46:41+08:00</lastmod>
</url><url>
<loc>/design/decommissioning.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-03-09T18:59:26+10:00</lastmod>
</url><url>
<loc>/design/gdpr.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-04-07T06:58:59+02:00</lastmod>
</url><url>
<loc>/design/locks.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-04-07T06:58:59+02:00</lastmod>
</url><url>
<loc>/design/ozone-enhancement-proposals.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-03-09T18:59:26+10:00</lastmod>
</url><url>
<loc>/design/configless.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-04-07T06:58:59+02:00</lastmod>
</url><url>
<loc>/design/multiraft.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-07-27T16:46:41+08:00</lastmod>
</url><url>
<loc>/design/typesafeconfig.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-10-09T14:42:45+02:00</lastmod>
</url><url>
<loc>/design/recon1.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-04-07T06:58:59+02:00</lastmod>
</url><url>
<loc>/design/tde.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-04-07T06:58:59+02:00</lastmod>
</url><url>
<loc>/tools/genconf.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2019-09-19T14:42:33+02:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -672,7 +728,7 @@
/>
</url><url>
<loc>/tools/auditparser.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-01-14T11:18:08+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -685,16 +741,16 @@
/>
</url><url>
<loc>/design/topology.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-08-07T18:35:36+02:00</lastmod>
</url><url>
<loc>/design/s3gateway.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-04-07T06:58:59+02:00</lastmod>
</url><url>
<loc>/design/omha.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-04-07T06:58:59+02:00</lastmod>
</url><url>
<loc>/tools.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-03-07T07:56:35+01:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -707,10 +763,10 @@
/>
</url><url>
<loc>/feature/faircallqueue.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-06-29T00:30:39+03:00</lastmod>
</url><url>
<loc>/interface.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-08-07T18:35:36+02:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -723,13 +779,23 @@
/>
</url><url>
<loc>/interface/swaggerreconapi.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2023-11-15T14:55:19+05:30</lastmod>
</url><url>
<loc>/recipe/botoclient.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-03-02T11:11:58-08:00</lastmod>
+ <xhtml:link
+ rel="alternate"
+ hreflang="zh"
+ href="/zh/recipe/botoclient.html"
+ />
+ <xhtml:link
+ rel="alternate"
+ hreflang="en"
+ href="/recipe/botoclient.html"
+ />
</url><url>
<loc>/recipe/prometheus.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2020-12-09T16:34:00+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -742,7 +808,7 @@
/>
</url><url>
<loc>/recipe/sparkozonefsk8s.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2021-05-31T10:12:49+08:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
@@ -755,7 +821,7 @@
/>
</url><url>
<loc>/tools/testtools.html</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2022-04-11T19:12:00+02:00</lastmod>
<xhtml:link
rel="alternate"
hreflang="zh"
diff --git a/docs/edge/feature.html b/docs/edge/feature.html
index 1f670c45..432e14d3 100644
--- a/docs/edge/feature.html
+++ b/docs/edge/feature.html
@@ -838,7 +838,7 @@ There is a custom IdentityProvider implementation for Ozone that must be specifi
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 2, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/23d21827560e79e939a902dee8396bf6f7b2c6d8">23d2182756</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/decommission.html b/docs/edge/feature/decommission.html
index 127ad536..e084e271 100644
--- a/docs/edge/feature/decommission.html
+++ b/docs/edge/feature/decommission.html
@@ -501,6 +501,9 @@ s=d.getElementsByTagName('script')[0];
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">ozone admin datanode decommission <span style="color:#f92672">[</span>-hV<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-id<span style="color:#f92672">=</span><scmServiceId><span style="color:#f92672">]</span>
<span style="color:#f92672">[</span>--scm<span style="color:#f92672">=</span><scm><span style="color:#f92672">]</span> <span style="color:#f92672">[</span><hosts>...<span style="color:#f92672">]</span>
</code></pre></div><p>You can enter multiple hosts to decommission multiple datanodes together.</p>
+<p>To view the status of a decommissioning datanode, you can execute the following command:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">ozone admin datanode status decommission <span style="color:#f92672">[</span>-hV<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-id<span style="color:#f92672">=</span><scmServiceId><span style="color:#f92672">]</span> <span style="color:#f92672">[</span>--scm<span style="color:#f92672">=</span>< [...]
+</code></pre></div><p>You can pass the IP address or UUID of one datanode to view only the details related to that datanode.</p>
<p><strong>Note:</strong> To recommission a datanode you may execute the below command in cli,</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">ozone admin datanode recommission <span style="color:#f92672">[</span>-hV<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-id<span style="color:#f92672">=</span><scmServiceId><span style="color:#f92672">]</span>
<span style="color:#f92672">[</span>--scm<span style="color:#f92672">=</span><scm><span style="color:#f92672">]</span> <span style="color:#f92672">[</span><hosts>...<span style="color:#f92672">]</span>
@@ -549,7 +552,7 @@ other OMs.</li>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 5, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/80592135edffbcec2087edfd70c3b31b70841ebc">80592135ed</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/dn-merge-rocksdb.html b/docs/edge/feature/dn-merge-rocksdb.html
index dc7f536b..7dedc3b1 100644
--- a/docs/edge/feature/dn-merge-rocksdb.html
+++ b/docs/edge/feature/dn-merge-rocksdb.html
@@ -479,11 +479,11 @@ s=d.getElementsByTagName('script')[0];
limitations under the License.
-->
<p>In Ozone, user data are separated into blocks and stored in HDDS Containers. Containers are the fundamental replication unit of Ozone/HDDS. Each Container has its metadata and data. Data are saved as files on disk. Metadata is saved in RocksDB.</p>
-<p>Currently there will be one RocksDB for each Container on datanode. With user data continously grow, there will be hundreds of thousands of RocksDB instances on one datanode. It’s a big challenge to manage this amount of RocksDB instances in one JVM.</p>
-<p>Unlike the current approach, this “Merge Container RocksDB in DN” feature will use only one RocksDB for each data volume, holding all metadata of Containers in this RocksDB.</p>
+<p>Earlier, there was one RocksDB for each Container on datanode. With user data continously growing, there will be hundreds of thousands of RocksDB instances on one datanode. It’s a big challenge to manage this amount of RocksDB instances in one JVM.</p>
+<p>Unlike the previous approach, this “Merge Container RocksDB in DN” feature will use only one RocksDB for each data volume, holding all metadata of Containers in this RocksDB.</p>
<h2 id="configuration">Configuration</h2>
-<p>This is mainly a DN feature, which doesn’t require much configuration.</p>
-<p>Here is a configuration which disable this feature if the current one RocksDB for each container mode is more preferred. Please be noted that once the feature is enabled, it’s strongly suggested not to disable it in later.</p>
+<p>This is mainly a DN feature, which doesn’t require much configuration. By default, it is enabled.</p>
+<p>Here is a configuration which disables this feature if the “one RocksDB for each container” mode is more preferred. Please be noted that once the feature is enabled, it’s strongly suggested not to disable it in later.</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-XML" data-lang="XML"><span style="color:#f92672"><property></span>
<span style="color:#f92672"><name></span>hdds.datanode.container.schema.v3.enabled<span style="color:#f92672"></name></span>
<span style="color:#f92672"><value></span>false<span style="color:#f92672"></value></span>
@@ -527,7 +527,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: November 25, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/c4b2056e6f3e965c8df75bb8cf62aef182fcb86a">c4b2056e6f</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/erasurecoding.html b/docs/edge/feature/erasurecoding.html
index 3044b82a..682e0c5f 100644
--- a/docs/edge/feature/erasurecoding.html
+++ b/docs/edge/feature/erasurecoding.html
@@ -598,8 +598,7 @@ the configuration keys <code>ozone.server.default.replication.type</code> and <c
<span style="color:#f92672"><name></span>ozone.server.default.replication.type<span style="color:#f92672"></name></span>
<span style="color:#f92672"><value></span>EC<span style="color:#f92672"></value></span>
<span style="color:#f92672"></property></span>
-
-<span style="color:#f92672"><property></span>
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-XML" data-lang="XML"><span style="color:#f92672"><property></span>
<span style="color:#f92672"><name></span>ozone.server.default.replication<span style="color:#f92672"></name></span>
<span style="color:#f92672"><value></span>RS-6-3-1024k<span style="color:#f92672"></value></span>
<span style="color:#f92672"></property></span>
@@ -614,6 +613,15 @@ any replication config or bucket does not have any default values.</p>
<h4 id="setting-ec-replication-config-while-creating-keysfiles">Setting EC Replication Config While Creating Keys/Files</h4>
<p>We can pass the EC Replication Config while creating the keys irrespective of bucket Replication Config.</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">ozone sh key put <Ozone Key Object Path> <Local File> --type EC --replication rs-6-3-1024k
+</code></pre></div><p>When using ofs/o3fs, we can pass the EC Replication Config by setting the configuration keys <code>ozone.replication.type</code> and <code>ozone.replication</code>.</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-XML" data-lang="XML"><span style="color:#f92672"><property></span>
+ <span style="color:#f92672"><name></span>ozone.replication.type<span style="color:#f92672"></name></span>
+ <span style="color:#f92672"><value></span>EC<span style="color:#f92672"></value></span>
+<span style="color:#f92672"></property></span>
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-XML" data-lang="XML"><span style="color:#f92672"><property></span>
+ <span style="color:#f92672"><name></span>ozone.replication<span style="color:#f92672"></name></span>
+ <span style="color:#f92672"><value></span>rs-3-2-1024k<span style="color:#f92672"></value></span>
+<span style="color:#f92672"></property></span>
</code></pre></div><p>In the case bucket already has default EC Replication Config, there is no need of passing EC Replication Config while creating key.</p>
<h3 id="enable-intel-isa-l">Enable Intel ISA-L</h3>
<p>Intel Intelligent Storage Acceleration Library (ISA-L) is an open-source collection of optimized low-level functions used for
@@ -645,7 +653,7 @@ The default value of java.library.path depends on the OS and Java version. For e
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 24, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/b267a578313da15cb0b5e40fddc4d003c8c222d4">b267a57831</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/faircallqueue.html b/docs/edge/feature/faircallqueue.html
index 8fc81428..7f9bff1e 100644
--- a/docs/edge/feature/faircallqueue.html
+++ b/docs/edge/feature/faircallqueue.html
@@ -529,7 +529,7 @@ Furthermore, this port will have to be part of every configuration name.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: June 29, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/43f7575775de7fb55a418a1ef2ca0f847f420a29">43f7575775</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/index.xml b/docs/edge/feature/index.xml
index 6fa5c15e..98b2d3a5 100644
--- a/docs/edge/feature/index.xml
+++ b/docs/edge/feature/index.xml
@@ -90,7 +90,7 @@
<item>
<title>Quota in Ozone</title>
<link>/feature/quota.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Thu, 22 Oct 2020 00:00:00 +0000</pubDate>
<guid>/feature/quota.html</guid>
<description>Introduction to Ozone Quota</description>
diff --git a/docs/edge/feature/nonrolling-upgrade.html b/docs/edge/feature/nonrolling-upgrade.html
index c69a3fe8..da4b80bd 100644
--- a/docs/edge/feature/nonrolling-upgrade.html
+++ b/docs/edge/feature/nonrolling-upgrade.html
@@ -546,23 +546,6 @@ s=d.getElementsByTagName('script')[0];
</code></pre></li>
</ol>
<p>At this point, the cluster is finalized and the upgrade is complete.</p>
-<h2 id="features-requiring-finalization">Features Requiring Finalization</h2>
-<p>Below is a list of backwards incompatible features and the version in which they were introduced. These features can only be used on a finalized ozone cluster with at least the specified version. Run <code>ozone version</code> to get the current version of your Ozone cluster.</p>
-<h3 id="version-120">Version 1.2.0</h3>
-<ul>
-<li>
-<p><a href="../feature/prefixfso.html">Prefix based File System Optimization</a></p>
-<ul>
-<li>Although new 1.2.0 clusters can use this feature, it is currently not supported for clusters upgraded to 1.2.0, even after finalizing.</li>
-</ul>
-</li>
-<li>
-<p><a href="../feature/scm-ha.html">SCM High Availability</a></p>
-<ul>
-<li>Although new 1.2.0 clusters can use this feature, it is currently not supported for clusters upgraded to 1.2.0, even after finalizing.</li>
-</ul>
-</li>
-</ul>
@@ -582,7 +565,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: June 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/50c5a78c797bb6d26f4b71f07ff4e58b0e8541cd">50c5a78c79</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/observability.html b/docs/edge/feature/observability.html
index 90c363fb..dab3842e 100644
--- a/docs/edge/feature/observability.html
+++ b/docs/edge/feature/observability.html
@@ -667,7 +667,7 @@ status: VOLUME_ALREADY_EXISTS
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 11, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9b5b8d6b326ad2644e0b5d4f603f0356aa2bacb7">9b5b8d6b32</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/om-ha.html b/docs/edge/feature/om-ha.html
index a70d3be0..ab2f8577 100644
--- a/docs/edge/feature/om-ha.html
+++ b/docs/edge/feature/om-ha.html
@@ -565,7 +565,7 @@ using the <em>force</em> option. The <em>force</em> option allows to continue wi
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 1, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/5748d4066499b7c01d4251ebc262adc86a953fcf">5748d40664</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/prefixfso.html b/docs/edge/feature/prefixfso.html
index 1600c40f..78988c72 100644
--- a/docs/edge/feature/prefixfso.html
+++ b/docs/edge/feature/prefixfso.html
@@ -537,7 +537,7 @@ Supported values are <code>OBJECT_STORE</code>, <code>FILE_SYSTEM_OPTIMIZED</cod
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: January 26, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/e806fd6ce8ef9d705884e573f6aee21be6b385e8">e806fd6ce8</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/quota.html b/docs/edge/feature/quota.html
index ac9222d4..c323f74b 100644
--- a/docs/edge/feature/quota.html
+++ b/docs/edge/feature/quota.html
@@ -597,7 +597,7 @@ bin/ozone sh bucket info /volume1/bucket1
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/8568075ddb75b4a6785cdb31b00b4a592058dc78">8568075ddb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/recon.html b/docs/edge/feature/recon.html
index 71ddc226..31b3f7c9 100644
--- a/docs/edge/feature/recon.html
+++ b/docs/edge/feature/recon.html
@@ -506,7 +506,7 @@ the following command.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: November 24, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/1a304ba81c9d52e2fb3a67e669d08c729a4113ae">1a304ba81c</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/reconfigurability.html b/docs/edge/feature/reconfigurability.html
index d6c57502..758615d7 100644
--- a/docs/edge/feature/reconfigurability.html
+++ b/docs/edge/feature/reconfigurability.html
@@ -580,7 +580,7 @@ Reconfig successfully 3 nodes, failure 0 nodes.<br></p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 23, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/e9f11f0b5fe07acc380eb3f5dfea544d794d4812">e9f11f0b5f</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/s3-multi-tenancy-access-control.html b/docs/edge/feature/s3-multi-tenancy-access-control.html
index 99e66584..30f5a932 100644
--- a/docs/edge/feature/s3-multi-tenancy-access-control.html
+++ b/docs/edge/feature/s3-multi-tenancy-access-control.html
@@ -572,7 +572,7 @@ they could edit the bucket policies on their own, for example, to share the buck
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 20, 2022 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/f127fa9944babae59b18a535993745ba698da3b9">f127fa9944</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/s3-multi-tenancy-setup.html b/docs/edge/feature/s3-multi-tenancy-setup.html
index f8226efe..e92ca425 100644
--- a/docs/edge/feature/s3-multi-tenancy-setup.html
+++ b/docs/edge/feature/s3-multi-tenancy-setup.html
@@ -545,7 +545,7 @@ docker-compose exec scm bash
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: July 13, 2022 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/3f3577a45290a2a989eb310d56577544c60b8225">3f3577a452</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/s3-multi-tenancy.html b/docs/edge/feature/s3-multi-tenancy.html
index 7c38ed5b..9dac22f3 100644
--- a/docs/edge/feature/s3-multi-tenancy.html
+++ b/docs/edge/feature/s3-multi-tenancy.html
@@ -546,7 +546,7 @@ generated when an Ozone cluster admin or tenant admin assigns the user to the te
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 7, 2022 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/ecb685a6cf8aa463e9a3e1836900e56c52ed5597">ecb685a6cf</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/s3-tenant-commands.html b/docs/edge/feature/s3-tenant-commands.html
index 2eb69f5d..1bf49cd2 100644
--- a/docs/edge/feature/s3-tenant-commands.html
+++ b/docs/edge/feature/s3-tenant-commands.html
@@ -752,7 +752,7 @@ bash-4.2$ diff file1-get.txt README.md
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 13, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7370676dcf476a01094f7efa97aba98780a5073f">7370676dcf</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/scm-ha.html b/docs/edge/feature/scm-ha.html
index 1e210c8d..2022e863 100644
--- a/docs/edge/feature/scm-ha.html
+++ b/docs/edge/feature/scm-ha.html
@@ -519,7 +519,7 @@ s=d.getElementsByTagName('script')[0];
<pre><code>ozone scm --init
</code></pre><p>Second and third nodes should be <em>bootstrapped</em> instead of init. These clusters will join to the configured RAFT quorum. The id of the current server is identified by DNS name or can be set explicitly by <code>ozone.scm.node.id</code>. Most of the time you don’t need to set it as DNS based id detection can work well.</p>
<pre><code>ozone scm --bootstrap
-</code></pre><p>Note: both commands perform one-time initialization. SCM still needs to be started by running <code>ozone scm --daemon start</code>.</p>
+</code></pre><p>Note: both commands perform one-time initialization. SCM still needs to be started by running <code>ozone --daemon start scm</code>.</p>
<h2 id="auto-bootstrap">Auto-bootstrap</h2>
<p>In some environments (e.g. Kubernetes) we need to have a common, unified way to initialize SCM HA quorum. As a reminder, the standard initialization flow is the following:</p>
<ol>
@@ -535,7 +535,7 @@ s=d.getElementsByTagName('script')[0];
<p>Note: SCM still needs to be started after the init/bootstrap process.</p>
<pre><code>ozone scm --init
ozone scm --bootstrap
-ozone scm --daemon start
+ozone --daemon start scm
</code></pre><p>For Docker/Kubernetes, use <code>ozone scm</code> to start it in the foreground.</p>
<h2 id="scm-ha-security">SCM HA Security</h2>
<p>
@@ -626,7 +626,7 @@ bin/ozone debug ldb --db<span style="color:#f92672">=</span>/tmp/metadata/scm.db
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: November 6, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/2547ac0438ec0374f75227f60a35b11ad9a986a4">2547ac0438</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/snapshot.html b/docs/edge/feature/snapshot.html
index cdb6f64a..508e40d4 100644
--- a/docs/edge/feature/snapshot.html
+++ b/docs/edge/feature/snapshot.html
@@ -515,7 +515,7 @@ Ozone also provides SnapshotDiff API. Whenever a user issues a SnapshotDiff betw
<hr>
<h3 id="cluster-and-hardware-configuration">Cluster and Hardware Configuration</h3>
<p>Snapshot feature places additional demands on the cluster in terms of CPU, memory and storage. Cluster nodes running Ozone Managers and Ozone Datanodes should be configured with extra storage capacity depending on the number of active snapshots that the user wants to keep. Ozone Snapshots consume incremental amount of space per snapshot. e.g. if the active object store has 100 GB data (before replication) and a snapshot is taken, then the 100 GB of space will be locked in that snapsho [...]
-<p>Similarly, nodes running Ozone Manager should be configured with extra memory depending on how many snapshots are concurrently read from. This also depepnds on how many concurrent SnapshotDiff jobs are expected in the cluster. By default, an Ozone Manager allows 10 concurrent SnapshotDiff jobs at a time, which can be increased in config.</p>
+<p>Similarly, nodes running Ozone Manager should be configured with extra memory depending on how many snapshots are concurrently read from. This also depends on how many concurrent SnapshotDiff jobs are expected in the cluster. By default, an Ozone Manager allows 10 concurrent SnapshotDiff jobs at a time, which can be increased in config.</p>
@@ -535,7 +535,7 @@ Ozone also provides SnapshotDiff API. Whenever a user issues a SnapshotDiff betw
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 1, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/83d75861b0266160b219acde72d769eb0f9d5ac4">83d75861b0</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/streaming-write-pipeline.html b/docs/edge/feature/streaming-write-pipeline.html
index 2c5d193d..2f2d51ca 100644
--- a/docs/edge/feature/streaming-write-pipeline.html
+++ b/docs/edge/feature/streaming-write-pipeline.html
@@ -585,7 +585,7 @@ as the existing <code>createKey</code> and <code>createMultipartKey</code> metho
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf7d6</a>
</span>
</div>
</footer>
diff --git a/docs/edge/feature/topology.html b/docs/edge/feature/topology.html
index e167cf6a..c9fdce5e 100644
--- a/docs/edge/feature/topology.html
+++ b/docs/edge/feature/topology.html
@@ -550,7 +550,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 29, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/cce3c7ea79ec19657d10f011ddeaf3067a2f83bd">cce3c7ea79</a>
</span>
</div>
</footer>
diff --git a/docs/edge/index.html b/docs/edge/index.html
index 149613b8..82c55046 100644
--- a/docs/edge/index.html
+++ b/docs/edge/index.html
@@ -491,7 +491,7 @@ like Kubernetes.</em></em> <p></p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: December 5, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/e7cb0fb027236bf036e463a49e35fa8ab086d135">e7cb0fb027</a>
</span>
</div>
</footer>
diff --git a/docs/edge/index.xml b/docs/edge/index.xml
index b5a7ed66..eef16e55 100644
--- a/docs/edge/index.xml
+++ b/docs/edge/index.xml
@@ -6,6 +6,15 @@
<description>Recent content in Overview on Ozone</description>
<generator>Hugo -- gohugo.io</generator>
<language>en-us</language><atom:link href="/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Securing Ozone</title>
+ <link>/security/secureozone.html</link>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
+
+ <guid>/security/secureozone.html</guid>
+ <description>Overview of Ozone security concepts and steps to secure Ozone Manager and SCM.</description>
+ </item>
+
<item>
<title>Overview</title>
<link>/concept/overview.html</link>
@@ -69,15 +78,6 @@
<description>HA setup for Storage Container Manager to avoid any single point of failure.</description>
</item>
- <item>
- <title>Securing Ozone</title>
- <link>/security/secureozone.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/security/secureozone.html</guid>
- <description>Overview of Ozone security concepts and steps to secure Ozone Manager and SCM.</description>
- </item>
-
<item>
<title>Streaming Write Pipeline</title>
<link>/feature/streaming-write-pipeline.html</link>
@@ -87,6 +87,15 @@
<description>A new write pipeline using Ratis Streaming.</description>
</item>
+ <item>
+ <title>Transparent Data Encryption</title>
+ <link>/security/securingtde.html</link>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
+
+ <guid>/security/securingtde.html</guid>
+ <description>TDE allows data on the disks to be encrypted-at-rest and automatically decrypted during access.</description>
+ </item>
+
<item>
<title>O3fs (Hadoop compatible)</title>
<link>/interface/o3fs.html</link>
@@ -133,12 +142,21 @@
</item>
<item>
- <title>Transparent Data Encryption</title>
- <link>/security/securingtde.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <title>GDPR in Ozone</title>
+ <link>/security/gdpr.html</link>
+ <pubDate>Tue, 17 Sep 2019 00:00:00 +0000</pubDate>
- <guid>/security/securingtde.html</guid>
- <description>TDE allows data on the disks to be encrypted-at-rest and automatically decrypted during access.</description>
+ <guid>/security/gdpr.html</guid>
+ <description>Support to implement the &ldquo;Right to be Forgotten&rdquo; requirement of GDPR</description>
+ </item>
+
+ <item>
+ <title>Securing Datanodes</title>
+ <link>/security/securingdatanodes.html</link>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
+
+ <guid>/security/securingdatanodes.html</guid>
+ <description>Explains different modes of securing data nodes. These range from kerberos to auto approval.</description>
</item>
<item>
@@ -150,15 +168,6 @@
<description>Storage Container Manager or SCM is the core metadata service of Ozone. SCM provides a distributed block layer for Ozone.</description>
</item>
- <item>
- <title>GDPR in Ozone</title>
- <link>/security/gdpr.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/security/gdpr.html</guid>
- <description>Support to implement the &ldquo;Right to be Forgotten&rdquo; requirement of GDPR</description>
- </item>
-
<item>
<title>S3 Protocol</title>
<link>/interface/s3.html</link>
@@ -169,12 +178,21 @@
</item>
<item>
- <title>Securing Datanodes</title>
- <link>/security/securingdatanodes.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <title>Quota in Ozone</title>
+ <link>/feature/quota.html</link>
+ <pubDate>Thu, 22 Oct 2020 00:00:00 +0000</pubDate>
- <guid>/security/securingdatanodes.html</guid>
- <description>Explains different modes of securing data nodes. These range from kerberos to auto approval.</description>
+ <guid>/feature/quota.html</guid>
+ <description>Introduction to Ozone Quota</description>
+ </item>
+
+ <item>
+ <title>Securing HTTP</title>
+ <link>/security/securingozonehttp.html</link>
+ <pubDate>Wed, 17 Jun 2020 00:00:00 +0000</pubDate>
+
+ <guid>/security/securingozonehttp.html</guid>
+ <description>Secure HTTP web-consoles for Ozone services</description>
</item>
<item>
@@ -188,15 +206,6 @@ There are some functionality which couldn&rsquo;t be accessed without using
Creating volumes with quota Managing internal ACLs Creating buckets with encryption key All of these are one-time, administration tasks. Applications can use Ozone without this CLI using other interface like Hadoop Compatible File System (o3fs or ofs) or S3 interface.</description>
</item>
- <item>
- <title>Quota in Ozone</title>
- <link>/feature/quota.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/feature/quota.html</guid>
- <description>Introduction to Ozone Quota</description>
- </item>
-
<item>
<title>Recon API</title>
<link>/interface/reconapi.html</link>
@@ -207,12 +216,12 @@ There are some functionality which couldn&rsquo;t be accessed without using
</item>
<item>
- <title>Securing HTTP</title>
- <link>/security/securingozonehttp.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <title>Securing S3</title>
+ <link>/security/securings3.html</link>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
- <guid>/security/securingozonehttp.html</guid>
- <description>Secure HTTP web-consoles for Ozone services</description>
+ <guid>/security/securings3.html</guid>
+ <description>Ozone supports S3 protocol, and uses AWS Signature Version 4 protocol which allows a seamless S3 experience.</description>
</item>
<item>
@@ -234,12 +243,12 @@ There are some functionality which couldn&rsquo;t be accessed without using
</item>
<item>
- <title>Securing S3</title>
- <link>/security/securings3.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <title>Ozone ACLs</title>
+ <link>/security/securityacls.html</link>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
- <guid>/security/securings3.html</guid>
- <description>Ozone supports S3 protocol, and uses AWS Signature Version 4 protocol which allows a seamless S3 experience.</description>
+ <guid>/security/securityacls.html</guid>
+ <description>Native Ozone Authorizer provides Access Control List (ACL) support for Ozone without Ranger integration.</description>
</item>
<item>
@@ -252,12 +261,12 @@ There are some functionality which couldn&rsquo;t be accessed without using
</item>
<item>
- <title>Ozone ACLs</title>
- <link>/security/securityacls.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <title>Apache Ranger</title>
+ <link>/security/securitywithranger.html</link>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
- <guid>/security/securityacls.html</guid>
- <description>Native Ozone Authorizer provides Access Control List (ACL) support for Ozone without Ranger integration.</description>
+ <guid>/security/securitywithranger.html</guid>
+ <description>Apache Ranger is a framework to enable, monitor and manage comprehensive data security across the Hadoop platform.</description>
</item>
<item>
@@ -269,15 +278,6 @@ There are some functionality which couldn&rsquo;t be accessed without using
<description>Ozone supports Amazon&rsquo;s Simple Storage Service (S3) protocol. In fact, You can use S3 clients and S3 SDK based applications without any modifications with Ozone.</description>
</item>
- <item>
- <title>Apache Ranger</title>
- <link>/security/securitywithranger.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/security/securitywithranger.html</guid>
- <description>Apache Ranger is a framework to enable, monitor and manage comprehensive data security across the Hadoop platform.</description>
- </item>
-
<item>
<title>HttpFS Gateway</title>
<link>/interface/httpfs.html</link>
@@ -432,6 +432,24 @@ kubernetes/examples folder of the ozone distribution contains kubernetes deploym
If you want to build from sources, Please untar the source tarball (or clone the latest code from the git repository) and run the ozone build command.</description>
</item>
+ <item>
+ <title>Ozone Debug</title>
+ <link>/tools/debug.html</link>
+ <pubDate>Mon, 14 Oct 2024 00:00:00 +0000</pubDate>
+
+ <guid>/tools/debug.html</guid>
+ <description>Ozone Debug command can be used for all the debugging related tasks.</description>
+ </item>
+
+ <item>
+ <title>Overwriting an Ozone Key only if it has not changed.</title>
+ <link>/design/overwrite-key-only-if-unchanged.html</link>
+ <pubDate>Fri, 05 Apr 2024 00:00:00 +0000</pubDate>
+
+ <guid>/design/overwrite-key-only-if-unchanged.html</guid>
+ <description>A minimal design illustrating how to replace a key in Ozone only if it has not changes since it was read.</description>
+ </item>
+
<item>
<title>Ozone Token Signatures using Symmetric Keys</title>
<link>/design/symmetric-token-signatures.html</link>
diff --git a/docs/edge/interface.html b/docs/edge/interface.html
index acc77bcb..0512f1c2 100644
--- a/docs/edge/interface.html
+++ b/docs/edge/interface.html
@@ -690,7 +690,7 @@ There are some functionality which couldn’t be accessed without using ozon
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/5ce6f0eab381389fd04c3130531b3ec626acbc65">5ce6f0eab3</a>
</span>
</div>
</footer>
diff --git a/docs/edge/interface/cli.html b/docs/edge/interface/cli.html
index fbeffaa7..44f99b9c 100644
--- a/docs/edge/interface/cli.html
+++ b/docs/edge/interface/cli.html
@@ -451,6 +451,11 @@ s=d.getElementsByTagName('script')[0];
+
+
+ <a href="../zh/interface/cli.html"><span class="label label-success">中文</span></a>
+
+
</div>
@@ -704,7 +709,7 @@ encrypted-bucket key1
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: July 27, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/2193187aad108467c140fc0533d44a109f290d02">2193187aad</a>
</span>
</div>
</footer>
diff --git a/docs/edge/interface/csi.html b/docs/edge/interface/csi.html
index 9c580679..3fb594c1 100644
--- a/docs/edge/interface/csi.html
+++ b/docs/edge/interface/csi.html
@@ -496,7 +496,7 @@ through goofys.</p>
<p>If you don’t have an Ozone cluster on kubernetes, you can reference <a href="../start/kubernetes.html">Kubernetes</a> to create one. Use the resources from <code>kubernetes/examples/ozone</code> where you can find all the required Kubernetes resources to run cluster together with the dedicated Ozone CSI daemon (check <code>kubernetes/examples/ozone/csi</code>)</p>
<p>Now, create the CSI related resources by execute the follow command.</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">kubectl create -f /ozone/kubernetes/examples/ozone/csi
-</code></pre></div><h2 id="crete-pv-test-and-visit-the-result">Crete pv-test and visit the result.</h2>
+</code></pre></div><h2 id="create-pv-test-and-visit-the-result">Create pv-test and visit the result.</h2>
<p>Create pv-test related resources by execute the follow command.</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">kubectl create -f /ozone/kubernetes/examples/ozone/pv-test
</code></pre></div><p>Attach the pod scm-0 and put a key into the /s3v/pvc* bucket.</p>
@@ -537,7 +537,7 @@ through goofys.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: December 4, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/cb0a402bea59da76fe51c51cd61ab4bfe99417cb">cb0a402bea</a>
</span>
</div>
</footer>
diff --git a/docs/edge/interface/httpfs.html b/docs/edge/interface/httpfs.html
index 85340f69..94b06ceb 100644
--- a/docs/edge/interface/httpfs.html
+++ b/docs/edge/interface/httpfs.html
@@ -558,7 +558,7 @@ HttpFS HTTP web-service API calls are HTTP REST calls that map to an Ozone file
</tr>
<tr>
<td>Iteratively List a Directory</td>
-<td>supported</td>
+<td>unsupported</td>
</tr>
</tbody>
</table>
@@ -673,7 +673,7 @@ HttpFS HTTP web-service API calls are HTTP REST calls that map to an Ozone file
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/d70d247a494a69cad28e96d003b25ae4856b8641">d70d247a49</a>
</span>
</div>
</footer>
diff --git a/docs/edge/interface/javaapi.html b/docs/edge/interface/javaapi.html
index 80d642c2..8af4819a 100644
--- a/docs/edge/interface/javaapi.html
+++ b/docs/edge/interface/javaapi.html
@@ -590,7 +590,7 @@ introStream<span style="color:#f92672">.</span><span style="color:#a6e22e">read<
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 7, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/5ce6f0eab381389fd04c3130531b3ec626acbc65">5ce6f0eab3</a>
</span>
</div>
</footer>
diff --git a/docs/edge/interface/o3fs.html b/docs/edge/interface/o3fs.html
index c94bb786..61271615 100644
--- a/docs/edge/interface/o3fs.html
+++ b/docs/edge/interface/o3fs.html
@@ -554,7 +554,7 @@ whereas the host name in the config <code>ozone.om.address</code> is ignored.</p
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 28, 2022 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/898ccbb46fd52b19030758da3d97b621ae709e0e">898ccbb46f</a>
</span>
</div>
</footer>
diff --git a/docs/edge/interface/ofs.html b/docs/edge/interface/ofs.html
index fa1f2ed1..0c5ad445 100644
--- a/docs/edge/interface/ofs.html
+++ b/docs/edge/interface/ofs.html
@@ -451,6 +451,11 @@ s=d.getElementsByTagName('script')[0];
+
+
+ <a href="../zh/interface/ofs.html"><span class="label label-success">中文</span></a>
+
+
</div>
@@ -634,7 +639,7 @@ information.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: May 4, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/ecaa76b669a44dfef53f3004b1b2937ca5440d16">ecaa76b669</a>
</span>
</div>
</footer>
diff --git a/docs/edge/interface/reconapi.html b/docs/edge/interface/reconapi.html
index b8565d47..2868352b 100644
--- a/docs/edge/interface/reconapi.html
+++ b/docs/edge/interface/reconapi.html
@@ -478,8 +478,9 @@ s=d.getElementsByTagName('script')[0];
See the License for the specific language governing permissions and
limitations under the License.
-->
-<p>The Recon API v1 is a set of HTTP endpoints that help you understand the current
-state of an Ozone cluster and to troubleshoot if needed.</p>
+<p>The Recon API v1 offers a collection of HTTP endpoints designed to provide insights into the current state of an Ozone cluster,
+facilitating monitoring, management, and troubleshooting. These endpoints allow administrators to access critical cluster
+metadata, container status, key management, and more.</p>
<p>Endpoints that are marked as <em>admin only</em> can only be accessed by Kerberos users
specified in the <strong>ozone.administrators</strong> or <strong>ozone.recon.administrators</strong>
configurations of a secure cluster. See <a href="../security/secureozone.html">Securing Ozone</a> for more information.
@@ -506,7 +507,7 @@ To restrict access to these endpoints, set the following configurations:</p>
</tr>
</tbody>
</table>
-<p>Checkout an interactive version of the API powered by Swagger <a href="../interface/swaggerreconapi.html">here</a></p>
+<p>Access an interactive version of the API, complete with detailed descriptions and example requests, powered by Swagger <a href="../interface/swaggerreconapi.html">here</a></p>
<h2 id="containers-admin-only">Containers (admin only)</h2>
<h3 id="get-apiv1containers">GET /api/v1/containers</h3>
<p><strong>Parameters</strong></p>
@@ -1255,6 +1256,30 @@ If <code>volume</code> is specified, it returns only the buckets under <code>vol
<span style="color:#960050;background-color:#1e0010">...</span>
]
}
+</code></pre></div><h3 id="put-apiv1datanodesremove">PUT /api/v1/datanodes/remove</h3>
+<p><strong>Parameters</strong></p>
+<ul>
+<li>uuids (List of node uuids in JSON array format).</li>
+</ul>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">[
+ <span style="color:#e6db74">"50ca4c95-2ef3-4430-b944-97d2442c3daf"</span>
+]
+</code></pre></div><p><strong>Returns</strong></p>
+<p>Returns the list of datanodes which are removed successfully and list of datanodes which were not found.</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"removedNodes"</span>: {
+ <span style="color:#f92672">"totalCount"</span>: <span style="color:#ae81ff">1</span>,
+ <span style="color:#f92672">"datanodes"</span>: [
+ {
+ <span style="color:#f92672">"uuid"</span>: <span style="color:#e6db74">"50ca4c95-2ef3-4430-b944-97d2442c3daf"</span>,
+ <span style="color:#f92672">"hostname"</span>: <span style="color:#e6db74">"ozone-datanode-4.ozone_default"</span>,
+ <span style="color:#f92672">"state"</span>: <span style="color:#e6db74">"DEAD"</span>,
+ <span style="color:#f92672">"pipelines"</span>: <span style="color:#66d9ef">null</span>
+ }
+ ],
+ <span style="color:#f92672">"message"</span>: <span style="color:#e6db74">"Success"</span>
+ }
+}
</code></pre></div><h2 id="pipelines">Pipelines</h2>
<h3 id="get-apiv1pipelines">GET /api/v1/pipelines</h3>
<p><strong>Parameters</strong></p>
@@ -1333,6 +1358,23 @@ response object being the upper cap for file size range.</p>
<span style="color:#f92672">"fileSize"</span>: <span style="color:#ae81ff">1024</span>,
<span style="color:#f92672">"count"</span>: <span style="color:#ae81ff">2</span>
}]
+</code></pre></div><h3 id="get-apiv1utilizationcontainercount">GET /api/v1/utilization/containerCount</h3>
+<p><strong>Parameters</strong></p>
+<ul>
+<li>
+<p>containerSize (optional)</p>
+<p>Filters the results based on the given container size. The smallest container size being tracked for count is 512 MB (512000000 bytes).</p>
+</li>
+</ul>
+<p><strong>Returns</strong></p>
+<p>Returns the container counts within different container size ranges, with <code>containerSize</code> representing the size range and <code>count</code> representing the number of containers within that range.</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> [{
+ <span style="color:#f92672">"containerSize"</span>: <span style="color:#ae81ff">2147483648</span>,
+ <span style="color:#f92672">"count"</span>: <span style="color:#ae81ff">9</span>
+ }, {
+ <span style="color:#f92672">"containerSize"</span>: <span style="color:#ae81ff">1073741824</span>,
+ <span style="color:#f92672">"count"</span>: <span style="color:#ae81ff">3</span>
+ }]
</code></pre></div><h2 id="metrics">Metrics</h2>
<h3 id="get-apiv1metricsapi">GET /api/v1/metrics/:api</h3>
<p><strong>Parameters</strong></p>
@@ -1382,7 +1424,7 @@ Example: /api/v1/metrics/query?query=ratis_leader_election_electionCount</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 11, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/b5bec1cd74b590e910832fa31e510cd3c8a8b25e">b5bec1cd74</a>
</span>
</div>
</footer>
diff --git a/docs/edge/interface/s3.html b/docs/edge/interface/s3.html
index 50a8e609..45b128fa 100644
--- a/docs/edge/interface/s3.html
+++ b/docs/edge/interface/s3.html
@@ -624,9 +624,6 @@ ozone sh bucket link /vol1/bucket1 /s3v/common-bucket
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">aws s3api --endpoint http://localhost:9878 create-bucket --bucket buckettest
</code></pre></div><p>Or</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">aws s3 ls --endpoint http://localhost:9878 s3://buckettest
-</code></pre></div><h3 id="s3-fuse-driver-goofys">S3 Fuse driver (goofys)</h3>
-<p><a href="https://github.com/kahing/goofys">Goofys</a> is a S3 FUSE driver. As Ozone S3 gateway is AWS S3 compatible, it can be used to mount any Ozone buckets as an OS level mounted filesystem.</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">goofys --endpoint http://localhost:9878 bucket1 /mount/bucket1
</code></pre></div>
@@ -646,7 +643,7 @@ ozone sh bucket link /vol1/bucket1 /s3v/common-bucket
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: December 4, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/cb0a402bea59da76fe51c51cd61ab4bfe99417cb">cb0a402bea</a>
</span>
</div>
</footer>
diff --git a/docs/edge/interface/swaggerreconapi.html b/docs/edge/interface/swaggerreconapi.html
index 5c982ae2..de858ef4 100644
--- a/docs/edge/interface/swaggerreconapi.html
+++ b/docs/edge/interface/swaggerreconapi.html
@@ -127,7 +127,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: November 15, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/066215dbc6f5b94eb4da95020f9207e5e6bb0f56">066215dbc6</a>
</span>
</div>
</footer>
diff --git a/docs/edge/recipe.html b/docs/edge/recipe.html
index 6db0452d..f782c893 100644
--- a/docs/edge/recipe.html
+++ b/docs/edge/recipe.html
@@ -562,7 +562,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: September 19, 2019 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/f361a9be5cea972d0f2abab51a6bd5e976574ecc">f361a9be5c</a>
</span>
</div>
</footer>
diff --git a/docs/edge/recipe/botoclient.html b/docs/edge/recipe/botoclient.html
index 5b418cce..5a5c9585 100644
--- a/docs/edge/recipe/botoclient.html
+++ b/docs/edge/recipe/botoclient.html
@@ -451,6 +451,11 @@ s=d.getElementsByTagName('script')[0];
+
+
+ <a href="../zh/recipe/botoclient.html"><span class="label label-success">中文</span></a>
+
+
</div>
@@ -642,7 +647,7 @@ in Ozone volume ‘s3v’. Please note ‘ETag’s is required a
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 2, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/b07162b5cea577a2c785cc93fb6953c8628fbf5f">b07162b5ce</a>
</span>
</div>
</footer>
diff --git a/docs/edge/recipe/prometheus.html b/docs/edge/recipe/prometheus.html
index e91238c7..21aff694 100644
--- a/docs/edge/recipe/prometheus.html
+++ b/docs/edge/recipe/prometheus.html
@@ -563,7 +563,7 @@ docker-compose up -d
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: December 9, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/cdc2c1333f78151ab5f00ad555da201fc4129e75">cdc2c1333f</a>
</span>
</div>
</footer>
diff --git a/docs/edge/recipe/sparkozonefsk8s.html b/docs/edge/recipe/sparkozonefsk8s.html
index e52fab79..0428ee44 100644
--- a/docs/edge/recipe/sparkozonefsk8s.html
+++ b/docs/edge/recipe/sparkozonefsk8s.html
@@ -587,7 +587,7 @@ candle: 2
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: May 31, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/fa4ddbccf361e4df1f0421fd8193f5e22cd7c9c6">fa4ddbccf3</a>
</span>
</div>
</footer>
diff --git a/docs/edge/security.html b/docs/edge/security.html
index 8d87d818..b082057e 100644
--- a/docs/edge/security.html
+++ b/docs/edge/security.html
@@ -697,7 +697,7 @@ depth, please take a look at <a href="https://issues.apache.org/jira/secure/atta
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: September 19, 2019 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/88fabf9b4e4f10383dcffd9a8821ca05f373cbd4">88fabf9b4e</a>
</span>
</div>
</footer>
diff --git a/docs/edge/security/gdpr.html b/docs/edge/security/gdpr.html
index 7d318368..a54edc2a 100644
--- a/docs/edge/security/gdpr.html
+++ b/docs/edge/security/gdpr.html
@@ -538,7 +538,7 @@ and <code>-g</code> flags.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/8568075ddb75b4a6785cdb31b00b4a592058dc78">8568075ddb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/security/index.xml b/docs/edge/security/index.xml
index 086fef9b..f64c7aa6 100644
--- a/docs/edge/security/index.xml
+++ b/docs/edge/security/index.xml
@@ -9,7 +9,7 @@
<item>
<title>Securing Ozone</title>
<link>/security/secureozone.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
<guid>/security/secureozone.html</guid>
<description>Overview of Ozone security concepts and steps to secure Ozone Manager and SCM.</description>
@@ -18,7 +18,7 @@
<item>
<title>Transparent Data Encryption</title>
<link>/security/securingtde.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
<guid>/security/securingtde.html</guid>
<description>TDE allows data on the disks to be encrypted-at-rest and automatically decrypted during access.</description>
@@ -27,7 +27,7 @@
<item>
<title>GDPR in Ozone</title>
<link>/security/gdpr.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Tue, 17 Sep 2019 00:00:00 +0000</pubDate>
<guid>/security/gdpr.html</guid>
<description>Support to implement the &ldquo;Right to be Forgotten&rdquo; requirement of GDPR</description>
@@ -36,7 +36,7 @@
<item>
<title>Securing Datanodes</title>
<link>/security/securingdatanodes.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
<guid>/security/securingdatanodes.html</guid>
<description>Explains different modes of securing data nodes. These range from kerberos to auto approval.</description>
@@ -45,7 +45,7 @@
<item>
<title>Securing HTTP</title>
<link>/security/securingozonehttp.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Wed, 17 Jun 2020 00:00:00 +0000</pubDate>
<guid>/security/securingozonehttp.html</guid>
<description>Secure HTTP web-consoles for Ozone services</description>
@@ -54,7 +54,7 @@
<item>
<title>Securing S3</title>
<link>/security/securings3.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
<guid>/security/securings3.html</guid>
<description>Ozone supports S3 protocol, and uses AWS Signature Version 4 protocol which allows a seamless S3 experience.</description>
@@ -63,7 +63,7 @@
<item>
<title>Ozone ACLs</title>
<link>/security/securityacls.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
<guid>/security/securityacls.html</guid>
<description>Native Ozone Authorizer provides Access Control List (ACL) support for Ozone without Ranger integration.</description>
@@ -72,7 +72,7 @@
<item>
<title>Apache Ranger</title>
<link>/security/securitywithranger.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
<guid>/security/securitywithranger.html</guid>
<description>Apache Ranger is a framework to enable, monitor and manage comprehensive data security across the Hadoop platform.</description>
diff --git a/docs/edge/security/secureozone.html b/docs/edge/security/secureozone.html
index 0c6500ea..cfd33e89 100644
--- a/docs/edge/security/secureozone.html
+++ b/docs/edge/security/secureozone.html
@@ -657,7 +657,7 @@ principal name and a corresponding <a href="https://web.mit.edu/kerberos/krb5-la
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/8568075ddb75b4a6785cdb31b00b4a592058dc78">8568075ddb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/security/securingdatanodes.html b/docs/edge/security/securingdatanodes.html
index 490cbcff..80c63ef9 100644
--- a/docs/edge/security/securingdatanodes.html
+++ b/docs/edge/security/securingdatanodes.html
@@ -554,7 +554,7 @@ for itself.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/8568075ddb75b4a6785cdb31b00b4a592058dc78">8568075ddb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/security/securingozonehttp.html b/docs/edge/security/securingozonehttp.html
index 1fc5d9bd..00361708 100644
--- a/docs/edge/security/securingozonehttp.html
+++ b/docs/edge/security/securingozonehttp.html
@@ -451,6 +451,11 @@ s=d.getElementsByTagName('script')[0];
+
+
+ <a href="../zh/security/securingozonehttp.html"><span class="label label-success">中文</span></a>
+
+
</div>
@@ -770,7 +775,7 @@ change hdds.datanode.http.auth.simple.anonymous.allowed to true.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/8568075ddb75b4a6785cdb31b00b4a592058dc78">8568075ddb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/security/securings3.html b/docs/edge/security/securings3.html
index 0f8b8187..12cb17ec 100644
--- a/docs/edge/security/securings3.html
+++ b/docs/edge/security/securings3.html
@@ -530,7 +530,7 @@ S3 API.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/8568075ddb75b4a6785cdb31b00b4a592058dc78">8568075ddb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/security/securingtde.html b/docs/edge/security/securingtde.html
index aa67797d..f9df1572 100644
--- a/docs/edge/security/securingtde.html
+++ b/docs/edge/security/securingtde.html
@@ -591,7 +591,7 @@ to read/write a key in the encrypted bucket.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/8568075ddb75b4a6785cdb31b00b4a592058dc78">8568075ddb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/security/securityacls.html b/docs/edge/security/securityacls.html
index b9cabccd..85dd73e1 100644
--- a/docs/edge/security/securityacls.html
+++ b/docs/edge/security/securityacls.html
@@ -634,7 +634,7 @@ ACL user:testuser:r<span style="color:#f92672">[</span>DEFAULT<span style="color
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/8568075ddb75b4a6785cdb31b00b4a592058dc78">8568075ddb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/security/securitywithranger.html b/docs/edge/security/securitywithranger.html
index af01c81b..6cbb76af 100644
--- a/docs/edge/security/securitywithranger.html
+++ b/docs/edge/security/securitywithranger.html
@@ -609,7 +609,7 @@ authorizer. Please add the following properties to the ozone-site.xml.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/8568075ddb75b4a6785cdb31b00b4a592058dc78">8568075ddb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/sitemap.xml b/docs/edge/sitemap.xml
index b5aaad0b..71a9d78f 100644
--- a/docs/edge/sitemap.xml
+++ b/docs/edge/sitemap.xml
@@ -4,14 +4,14 @@
<sitemap>
<loc>en/sitemap.xml</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-12-04T15:41:48-05:00</lastmod>
</sitemap>
<sitemap>
<loc>zh/sitemap.xml</loc>
- <lastmod>2024-02-27T17:33:44+05:30</lastmod>
+ <lastmod>2024-12-04T15:41:48-05:00</lastmod>
</sitemap>
diff --git a/docs/edge/start.html b/docs/edge/start.html
index ebebf23c..4ad63df4 100644
--- a/docs/edge/start.html
+++ b/docs/edge/start.html
@@ -672,7 +672,7 @@ If you are a Hadoop ninja, and wise in the ways of Apache, you already know that
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: June 28, 2019 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/d2a8ee30236210e11c2e8268757b5c4614fcc07e">d2a8ee3023</a>
</span>
</div>
</footer>
diff --git a/docs/edge/start/fromsource.html b/docs/edge/start/fromsource.html
index 0c9b21ba..13dd0431 100644
--- a/docs/edge/start/fromsource.html
+++ b/docs/edge/start/fromsource.html
@@ -531,7 +531,7 @@ docker-compose up -d
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: November 4, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/1cf43ace9603119b4895f1072ef828a5ae04514d">1cf43ace96</a>
</span>
</div>
</footer>
diff --git a/docs/edge/start/kubernetes.html b/docs/edge/start/kubernetes.html
index 78dac0b0..babf3823 100644
--- a/docs/edge/start/kubernetes.html
+++ b/docs/edge/start/kubernetes.html
@@ -521,7 +521,7 @@ kubectl port-forward scm-0 9876:9876
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 9, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/45eee3fa5d29f49eaed0758d1703d446d56e70fb">45eee3fa5d</a>
</span>
</div>
</footer>
diff --git a/docs/edge/start/minikube.html b/docs/edge/start/minikube.html
index 90a0b1f9..6700696f 100644
--- a/docs/edge/start/minikube.html
+++ b/docs/edge/start/minikube.html
@@ -535,7 +535,7 @@ Opening kubernetes service default/s3g-public in default browser...
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: September 16, 2019 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/b0859b49c4a196bbdc16605f38ff51a59968b718">b0859b49c4</a>
</span>
</div>
</footer>
diff --git a/docs/edge/start/onprem.html b/docs/edge/start/onprem.html
index ede9e2d1..dfbb29ad 100644
--- a/docs/edge/start/onprem.html
+++ b/docs/edge/start/onprem.html
@@ -487,7 +487,7 @@ capable of running independently. The components of ozone are the same in both a
<li>Ozone Manager - Is the server that is in charge of the namespace of Ozone. Ozone Manager is responsible for all volume, bucket and key operations.</li>
<li>Storage Container Manager - Acts as the block manager. Ozone Manager
requests blocks from SCM, to which clients can write data.</li>
-<li>Datanodes - Ozone data node code runs inside the HDFS datanode or in the independent deployment case runs an ozone datanode daemon.</li>
+<li>Datanodes - Ozone Datanodes is the server that stores all the containers created by SCM. Datanode is the service that handles all data reads and writes from the Ozone Client.</li>
</ol>
<h2 id="setting-up-an-ozone-only-cluster">Setting up an Ozone only cluster</h2>
<ul>
@@ -645,7 +645,7 @@ up.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: June 3, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/ce5bbb0f4a079b11fa397a7ab6b57c1ee2829c13">ce5bbb0f4a</a>
</span>
</div>
</footer>
diff --git a/docs/edge/start/runningviadocker.html b/docs/edge/start/runningviadocker.html
index 97306df9..801e6ee9 100644
--- a/docs/edge/start/runningviadocker.html
+++ b/docs/edge/start/runningviadocker.html
@@ -534,7 +534,7 @@ While you are there, please don’t forget to check out the ozone configurat
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: September 16, 2019 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/b0859b49c4a196bbdc16605f38ff51a59968b718">b0859b49c4</a>
</span>
</div>
</footer>
diff --git a/docs/edge/start/startfromdockerhub.html b/docs/edge/start/startfromdockerhub.html
index 33b267bc..10f23553 100644
--- a/docs/edge/start/startfromdockerhub.html
+++ b/docs/edge/start/startfromdockerhub.html
@@ -553,7 +553,7 @@ our bucket.
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 1, 2022 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/0262c8ac3abefd3df45d908f8316f9594a06051c">0262c8ac3a</a>
</span>
</div>
</footer>
diff --git a/docs/edge/swagger-resources/recon-api.yaml b/docs/edge/swagger-resources/recon-api.yaml
index 9ff32877..c0272a3d 100644
--- a/docs/edge/swagger-resources/recon-api.yaml
+++ b/docs/edge/swagger-resources/recon-api.yaml
@@ -530,6 +530,21 @@ paths:
application/json:
schema:
$ref: '#/components/responses/DatanodesSummary'
+
+ /datanodes/remove:
+ get:
+ tags:
+ - Datanodes
+ summary: Removes datanodes from Recon's memory and nodes table in Recon DB.
+ operationId: removeDatanodes
+ responses:
+ '200':
+ description: Successful Operation
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/responses/RemovedDatanodesResponse'
+
/pipelines:
get:
tags:
@@ -1514,6 +1529,8 @@ components:
leaderCount:
type: integer
example: 1
+ RemovedDatanodesResponse:
+ type: object
PipelinesSummary:
type: object
properties:
@@ -1659,4 +1676,4 @@ components:
type: array
example:
- 1599159384.455
- - "5"
\ No newline at end of file
+ - "5"
diff --git a/docs/edge/tools.html b/docs/edge/tools.html
index 0f01557e..8c896609 100644
--- a/docs/edge/tools.html
+++ b/docs/edge/tools.html
@@ -515,6 +515,25 @@ ozone-site.xml.</li>
<div class="row">
+ <div class="col-sm-6">
+ <div class="card">
+ <div class="card-body">
+ <h2 class="card-title">
+
+ Ozone Debug
+ </h2>
+ <p class="card-text">Ozone Debug command can be used for all the debugging related tasks.</p>
+ <a href="./tools/debug.html"
+ class=" btn btn-primary btn-lg">Ozone Debug</a>
+ </div>
+ </div>
+ </div>
+
+
+
+
+
+
<div class="col-sm-6">
<div class="card">
<div class="card-body">
@@ -530,10 +549,14 @@ ozone-site.xml.</li>
</div>
+ </div>
+
+ <div class="row">
+
<div class="col-sm-6">
<div class="card">
<div class="card-body">
@@ -549,14 +572,10 @@ ozone-site.xml.</li>
</div>
- </div>
-
- <div class="row">
-
<div class="col-sm-6">
<div class="card">
<div class="card-body">
@@ -572,10 +591,14 @@ ozone-site.xml.</li>
</div>
+ </div>
+
+ <div class="row">
+
<div class="col-sm-6">
<div class="card">
<div class="card-body">
@@ -591,14 +614,10 @@ ozone-site.xml.</li>
</div>
- </div>
-
- <div class="row">
-
<div class="col-sm-6">
<div class="card">
<div class="card-body">
@@ -614,6 +633,8 @@ ozone-site.xml.</li>
</div>
+ </div>
+
</div>
@@ -628,7 +649,7 @@ ozone-site.xml.</li>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 7, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/584d68bd51276b57479350dc773cbefb53f67461">584d68bd51</a>
</span>
</div>
</footer>
diff --git a/docs/edge/tools/admin.html b/docs/edge/tools/admin.html
index d3f0062b..a6473253 100644
--- a/docs/edge/tools/admin.html
+++ b/docs/edge/tools/admin.html
@@ -451,6 +451,11 @@ s=d.getElementsByTagName('script')[0];
+
+
+ <a href="../zh/tools/admin.html"><span class="label label-success">中文</span></a>
+
+
</div>
@@ -484,7 +489,124 @@ s=d.getElementsByTagName('script')[0];
<li><code>ozone admin replicationmanager</code>: Can be used to check the status of the replications (and start / stop replication in case of emergency).</li>
<li><code>ozone admin om</code>: Ozone Manager HA related tool to get information about the current cluster.</li>
</ul>
-<p>For more detailed usage see the output of the <code>--help</code>.</p>
+<p>For more detailed usage see the output of <code>--help</code>.</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone admin --help
+Usage: ozone admin <span style="color:#f92672">[</span>-hV<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>--verbose<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-conf<span style="color:#f92672">=</span><configurationPath><span style="color:#f92672">]</span>
+ <span style="color:#f92672">[</span>-D<span style="color:#f92672">=</span><String<span style="color:#f92672">=</span>String><span style="color:#f92672">]</span>... <span style="color:#f92672">[</span>COMMAND<span style="color:#f92672">]</span>
+Developer tools <span style="color:#66d9ef">for</span> Ozone Admin operations
+ -conf<span style="color:#f92672">=</span><configurationPath>
+
+ -D, --set<span style="color:#f92672">=</span><String<span style="color:#f92672">=</span>String>
+
+ -h, --help Show this help message and exit.
+ -V, --version Print version information and exit.
+ --verbose More verbose output. Show the stack trace of the errors.
+Commands:
+ containerbalancer ContainerBalancer specific operations
+ replicationmanager ReplicationManager specific operations
+ safemode Safe mode specific operations
+ printTopology Print a tree of the network topology as reported by SCM
+ cert Certificate related operations
+ container Container specific operations
+ datanode Datanode specific operations
+ pipeline Pipeline specific operations
+ namespace Namespace Summary specific admin operations
+ om Ozone Manager specific admin operations
+ reconfig Dynamically reconfigure server without restarting it
+ scm Ozone Storage Container Manager specific admin operations
+</code></pre></div><p>Some of those subcommand usages has been detailed in their dedicated feature documentation pages. For instance, <a href="../feature/decommission.html">Decommissioning</a>, <a href="../feature/nonrolling-upgrade.html">Non-Rolling Upgrades and Downgrades</a>.</p>
+<h2 id="list-open-files">List open files</h2>
+<p>List open files admin command lists open keys in Ozone Manager’s <code>OpenKeyTable</code>.
+Works for all bucket types.
+Argument <code>--prefix</code> could be root (<code>/</code>), path to a bucket (<code>/vol1/buck</code>) or a key prefix (for FSO buckets the key prefix could contain parent object ID). But it can’t be a volume.</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone admin om lof --help
+Usage: ozone admin om list-open-files <span style="color:#f92672">[</span>-hV<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>--json<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-l<span style="color:#f92672">=</span><limit><span style="color:#f92672">]</span>
+ <span style="color:#f92672">[</span>-p<span style="color:#f92672">=</span><pathPrefix><span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-s<span style="color:#f92672">=</span><startItem><span style="color:#f92672">]</span>
+ <span style="color:#f92672">[</span>--service-host<span style="color:#f92672">=</span><omHost><span style="color:#f92672">]</span>
+ <span style="color:#f92672">[</span>--service-id<span style="color:#f92672">=</span><omServiceId><span style="color:#f92672">]</span>
+Lists open files <span style="color:#f92672">(</span>keys<span style="color:#f92672">)</span> in Ozone Manager.
+ -h, --help Show this help message and exit.
+ --json Format output as JSON
+ -l, --length<span style="color:#f92672">=</span><limit> Maximum number of items to list
+ -p, --prefix<span style="color:#f92672">=</span><pathPrefix> Filter results by the specified path on the server
+ side.
+ -s, --start<span style="color:#f92672">=</span><startItem> The item to start the listing from.
+ i.e. continuation token. This will be excluded from
+ the result.
+ --service-host<span style="color:#f92672">=</span><omHost>
+ Ozone Manager Host. If OM HA is enabled, use
+ --service-id instead. If you must use
+ --service-host with OM HA, this must point
+ directly to the leader OM. This option is
+ required when --service-id is not provided or
+ when HA is not enabled.
+ --service-id, --om-service-id<span style="color:#f92672">=</span><omServiceId>
+ Ozone Manager Service ID
+ -V, --version Print version information and exit.
+</code></pre></div><h3 id="example-usages">Example usages</h3>
+<ul>
+<li>In human-readable format, list open files (keys) under bucket <code>/volumelof/buck1</code> with a batch size of 3:</li>
+</ul>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone admin om lof --service-id<span style="color:#f92672">=</span>om-service-test1 --length<span style="color:#f92672">=</span><span style="color:#ae81ff">3</span> --prefix<span style="color:#f92672">=</span>/volumelof/buck1
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash"><span style="color:#ae81ff">5</span> total open files <span style="color:#f92672">(</span>est.<span style="color:#f92672">)</span>. Showing <span style="color:#ae81ff">3</span> open files <span style="color:#f92672">(</span>limit 3<span style="color:#f92672">)</span> under path prefix:
+ /volume-lof/buck1
+
+Client ID Creation time Hsync<span style="color:#960050;background-color:#1e0010">'</span>ed Open File Path
+111726338148007937 1704808626523 No /volume-lof/buck1/-9223372036854774527/key0
+111726338151415810 1704808626578 No /volume-lof/buck1/-9223372036854774527/key1
+111726338152071171 1704808626588 No /volume-lof/buck1/-9223372036854774527/key2
+
+To get the next batch of open keys, run:
+ ozone admin om lof -id<span style="color:#f92672">=</span>om-service-test1 --length<span style="color:#f92672">=</span><span style="color:#ae81ff">3</span> --prefix<span style="color:#f92672">=</span>/volume-lof/buck1 --start<span style="color:#f92672">=</span>/-9223372036854775552/-9223372036854775040/-9223372036854774527/key2/111726338152071171
+</code></pre></div><ul>
+<li>In JSON, list open files (keys) under bucket <code>/volumelof/buck1</code> with a batch size of 3:</li>
+</ul>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone admin om lof --service-id<span style="color:#f92672">=</span>om-service-test1 --length<span style="color:#f92672">=</span><span style="color:#ae81ff">3</span> --prefix<span style="color:#f92672">=</span>/volumelof/buck1 --json
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"openKeys"</span> : [ {
+ <span style="color:#f92672">"keyInfo"</span> : {
+ <span style="color:#f92672">"metadata"</span> : { },
+ <span style="color:#f92672">"objectID"</span> : <span style="color:#ae81ff">-9223372036854774015</span>,
+ <span style="color:#f92672">"updateID"</span> : <span style="color:#ae81ff">7</span>,
+ <span style="color:#f92672">"parentObjectID"</span> : <span style="color:#ae81ff">-9223372036854774527</span>,
+ <span style="color:#f92672">"volumeName"</span> : <span style="color:#e6db74">"volume-lof"</span>,
+ <span style="color:#f92672">"bucketName"</span> : <span style="color:#e6db74">"buck1"</span>,
+ <span style="color:#f92672">"keyName"</span> : <span style="color:#e6db74">"key0"</span>,
+ <span style="color:#f92672">"dataSize"</span> : <span style="color:#ae81ff">4194304</span>,
+ <span style="color:#f92672">"keyLocationVersions"</span> : [ <span style="color:#960050;background-color:#1e0010">...</span> ],
+ <span style="color:#f92672">"creationTime"</span> : <span style="color:#ae81ff">1704808722487</span>,
+ <span style="color:#f92672">"modificationTime"</span> : <span style="color:#ae81ff">1704808722487</span>,
+ <span style="color:#f92672">"replicationConfig"</span> : {
+ <span style="color:#f92672">"replicationFactor"</span> : <span style="color:#e6db74">"THREE"</span>,
+ <span style="color:#f92672">"requiredNodes"</span> : <span style="color:#ae81ff">3</span>,
+ <span style="color:#f92672">"replicationType"</span> : <span style="color:#e6db74">"RATIS"</span>
+ },
+ <span style="color:#f92672">"fileName"</span> : <span style="color:#e6db74">"key0"</span>,
+ <span style="color:#f92672">"acls"</span> : [ <span style="color:#960050;background-color:#1e0010">...</span> ],
+ <span style="color:#f92672">"path"</span> : <span style="color:#e6db74">"-9223372036854774527/key0"</span>,
+ <span style="color:#f92672">"file"</span> : <span style="color:#66d9ef">true</span>,
+ <span style="color:#f92672">"replicatedSize"</span> : <span style="color:#ae81ff">12582912</span>,
+ <span style="color:#f92672">"objectInfo"</span> : <span style="color:#e6db74">"OMKeyInfo{volume='volume-lof', bucket='buck1', key='key0', dataSize='4194304', creationTime='1704808722487', objectID='-9223372036854774015', parentID='-9223372036854774527', replication='RATIS/THREE', fileChecksum='null}"</span>,
+ <span style="color:#f92672">"hsync"</span> : <span style="color:#66d9ef">false</span>,
+ <span style="color:#f92672">"latestVersionLocations"</span> : { <span style="color:#960050;background-color:#1e0010">...</span> },
+ <span style="color:#f92672">"updateIDset"</span> : <span style="color:#66d9ef">true</span>
+ },
+ <span style="color:#f92672">"openVersion"</span> : <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"clientId"</span> : <span style="color:#ae81ff">111726344437039105</span>
+ }, {
+ <span style="color:#f92672">"keyInfo"</span> : { <span style="color:#960050;background-color:#1e0010">...</span> },
+ <span style="color:#f92672">"openVersion"</span> : <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"clientId"</span> : <span style="color:#ae81ff">111726344440578050</span>
+ }, {
+ <span style="color:#f92672">"keyInfo"</span> : { <span style="color:#960050;background-color:#1e0010">...</span> },
+ <span style="color:#f92672">"openVersion"</span> : <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"clientId"</span> : <span style="color:#ae81ff">111726344441233411</span>
+ } ],
+ <span style="color:#f92672">"totalOpenKeyCount"</span> : <span style="color:#ae81ff">5</span>,
+ <span style="color:#f92672">"hasMore"</span> : <span style="color:#66d9ef">true</span>,
+ <span style="color:#f92672">"contToken"</span> : <span style="color:#e6db74">"/-9223372036854775552/-9223372036854775040/-9223372036854774527/key2/111726344441233411"</span>
+}
+</code></pre></div><p>Note in JSON output mode, field <code>contToken</code> won’t show up at all in the result if there are no more entries after the batch (i.e. when <code>hasMore</code> is <code>false</code>).</p>
@@ -504,7 +626,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: January 18, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/082d759448e3995b9330f8e914bb5bab171acaf2">082d759448</a>
</span>
</div>
</footer>
diff --git a/docs/edge/tools/auditparser.html b/docs/edge/tools/auditparser.html
index ac6d3ab6..a96594c8 100644
--- a/docs/edge/tools/auditparser.html
+++ b/docs/edge/tools/auditparser.html
@@ -549,7 +549,7 @@ Load command creates the audit table described above.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: January 14, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/bc49c45a4cf2ee48e39047c038a11773e47326fa">bc49c45a4c</a>
</span>
</div>
</footer>
diff --git a/docs/edge/tools/debug.html b/docs/edge/tools/debug.html
new file mode 100644
index 00000000..1e7ef0f3
--- /dev/null
+++ b/docs/edge/tools/debug.html
@@ -0,0 +1,904 @@
+
+
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+
+ <meta name="description" content="Apache Ozone Documentation">
+
+ <title>Documentation for Apache Ozone</title>
+
+
+ <link href="../css/bootstrap.min.css" rel="stylesheet">
+
+
+ <link href="../css/ozonedoc.css" rel="stylesheet">
+
+
+
+ <link href="../swagger-resources/swagger-ui.css" rel="stylesheet">
+
+
+ <script>
+ var _paq = window._paq = window._paq || [];
+
+
+
+ _paq.push(['disableCookies']);
+
+
+ _paq.push(['trackPageView']);
+ _paq.push(['enableLinkTracking']);
+ (function() {
+ var u="//analytics.apache.org/";
+ _paq.push(['setTrackerUrl', u+'matomo.php']);
+ _paq.push(['setSiteId', '34']);
+ var d=document, g=d.createElement('script'),
+s=d.getElementsByTagName('script')[0];
+ g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
+ })();
+ </script>
+
+
+ </head>
+
+
+<body>
+
+
+<nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container-fluid">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#sidebar" aria-expanded="false" aria-controls="navbar">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a href="../index.html" class="navbar-left ozone-logo">
+ <img src="../ozone-logo-small.png"/>
+ </a>
+ <a class="navbar-brand hidden-xs" href="../index.html">
+ Apache Ozone/HDDS Documentation
+ </a>
+ <a class="navbar-brand visible-xs-inline" href="#">Apache Ozone</a>
+ </div>
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav navbar-right">
+ <li><a href="https://github.com/apache/ozone">Source</a></li>
+ <li><a href="https://ozone.apache.org">Apache Ozone</a></li>
+ <li><a href="https://apache.org">ASF</a></li>
+ </ul>
+ </div>
+ </div>
+</nav>
+
+
+ <div class="wrapper">
+ <div class="container-fluid">
+ <div class="row">
+
+<div class="col-sm-2 col-md-2 sidebar" id="sidebar">
+ <ul class="nav nav-sidebar">
+
+
+
+ <li class="">
+
+ <a href="../index.html">
+
+
+
+ <span>Overview</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../start.html">
+
+
+
+ <span>Getting Started</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../concept.html">
+
+ <span>Architecture</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../concept/overview.html">Overview</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../concept/ozonemanager.html">Ozone Manager</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../concept/storagecontainermanager.html">Storage Container Manager</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../concept/containers.html">Containers</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../concept/datanodes.html">Datanodes</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../concept/recon.html">Recon</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+ <a href="../feature.html">
+
+ <span>Features</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../feature/decommission.html">Decommissioning</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/om-ha.html">OM High Availability</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/erasurecoding.html">Ozone Erasure Coding</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/snapshot.html">Ozone Snapshot</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/scm-ha.html">SCM High Availability</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/streaming-write-pipeline.html">Streaming Write Pipeline</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/dn-merge-rocksdb.html">Merge Container RocksDB in DN</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/prefixfso.html">Prefix based File System Optimization</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/topology.html">Topology awareness</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/quota.html">Quota in Ozone</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/recon.html">Recon Server</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/observability.html">Observability</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/nonrolling-upgrade.html">Non-Rolling Upgrades and Downgrades</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/s3-multi-tenancy.html">
+
+ <span>S3 Multi-Tenancy</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+ <a href="../feature/s3-multi-tenancy-setup.html">Setup</a>
+ </li>
+
+ <li class="">
+ <a href="../feature/s3-tenant-commands.html">Tenant commands</a>
+ </li>
+
+ <li class="">
+ <a href="../feature/s3-multi-tenancy-access-control.html">Access Control</a>
+ </li>
+
+ </ul>
+
+ </li>
+
+ <li class="">
+
+ <a href="../feature/reconfigurability.html">Reconfigurability</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+ <a href="../interface.html">
+
+ <span>Client Interfaces</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../interface/ofs.html">Ofs (Hadoop compatible)</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../interface/o3fs.html">O3fs (Hadoop compatible)</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../interface/s3.html">S3 Protocol</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../interface/cli.html">Command Line Interface</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../interface/reconapi.html">Recon API</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../interface/javaapi.html">Java API</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../interface/csi.html">CSI Protocol</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../interface/httpfs.html">HttpFS Gateway</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+ <a href="../security.html">
+
+ <span>Security</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../security/secureozone.html">Securing Ozone</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../security/securingtde.html">Transparent Data Encryption</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../security/gdpr.html">GDPR in Ozone</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../security/securingdatanodes.html">Securing Datanodes</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../security/securingozonehttp.html">Securing HTTP</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../security/securings3.html">Securing S3</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../security/securityacls.html">Ozone ACLs</a>
+
+ </li>
+
+ <li class="">
+
+ <a href="../security/securitywithranger.html">Apache Ranger</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../tools.html">
+
+
+
+ <span>Tools</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../recipe.html">
+
+
+
+ <span>Recipes</span>
+ </a>
+ </li>
+
+
+ <li><a href="../design.html"><span><b>Design docs</b></span></a></li>
+ <li class="visible-xs"><a href="#">References</a>
+ <ul class="nav">
+ <li><a href="https://github.com/apache/ozone"><span class="glyphicon glyphicon-new-window" aria-hidden="true"></span> Source</a></li>
+ <li><a href="https://ozone.apache.org"><span class="glyphicon glyphicon-new-window" aria-hidden="true"></span> Apache Ozone</a></li>
+ <li><a href="https://apache.org"><span class="glyphicon glyphicon-new-window" aria-hidden="true"></span> ASF</a></li>
+ </ul></li>
+ </ul>
+
+</div>
+
+ <div class="col-sm-10 col-sm-offset-2 col-md-10 col-md-offset-2 main-content">
+
+
+
+ <div class="col-md-9">
+ <nav aria-label="breadcrumb">
+ <ol class="breadcrumb">
+ <li class="breadcrumb-item"><a href="../index.html">Home</a></li>
+ <li class="breadcrumb-item" aria-current="page"><a href="../tools.html">Tools</a></li>
+ <li class="breadcrumb-item active" aria-current="page">Ozone Debug</li>
+ </ol>
+ </nav>
+
+
+
+<div class="pull-right">
+
+
+
+
+
+ <a href="../zh/tools/debug.html"><span class="label label-success">中文</span></a>
+
+
+</div>
+
+
+ <div class="col-md-9">
+ <h1>Ozone Debug</h1>
+
+ <!---
+ 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.
+-->
+<p>Ozone Debug command (<code>ozone debug</code>) is a collection of developer tools intended to help in debugging and get more information of various components of ozone.</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">Usage: ozone debug <span style="color:#f92672">[</span>-hV<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>--verbose<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-conf<span style="color:#f92672">=</span><configurationPath><span style="color:#f92672">]</span>
+ <span style="color:#f92672">[</span>-D<span style="color:#f92672">=</span><String<span style="color:#f92672">=</span>String><span style="color:#f92672">]</span>... <span style="color:#f92672">[</span>COMMAND<span style="color:#f92672">]</span>
+Developer tools <span style="color:#66d9ef">for</span> Ozone Debug operations
+ -conf<span style="color:#f92672">=</span><configurationPath>
+ path to the ozone configuration file
+ -D, --set<span style="color:#f92672">=</span><String<span style="color:#f92672">=</span>String>
+ Map of <span style="color:#f92672">(</span>configuration_key,configuration_value<span style="color:#f92672">)</span> <span style="color:#66d9ef">for</span> any
+ configuration overrides
+ -h, --help Show this help message and exit.
+ -V, --version Print version information and exit.
+ --verbose More verbose output. Show the stack trace of the errors.
+Commands:
+ chunkinfo returns chunk location information about an
+ existing key
+ print-log-dag, pld Create an image of the current compaction log DAG
+ in OM.
+ find-missing-padding, fmp List all keys with any missing padding, optionally
+ limited to a volume/bucket/key URI.
+ recover recover the lease of a specified file. Make sure
+ to specify file system scheme <span style="color:#66d9ef">if</span> ofs:// is not
+ the default.
+ prefix Parse prefix contents
+ ldb Parse rocksdb file content
+ read-replicas Reads every replica <span style="color:#66d9ef">for</span> all the blocks associated
+ with a given key.
+ container Container replica specific operations to be
+ executed on datanodes only
+ ratislogparser Shell of printing Ratis Log in understandable text
+</code></pre></div><p>For more detailed usage see the output of <code>--help</code> for each of the subcommands.</p>
+<h2 id="ozone-debug-ldb">ozone debug ldb</h2>
+<p>Ozone heavily uses RocksDB for storing metadata. This tool helps parse the contents of RocksDB belonging to Ozone Roles.
+Supported DB’s : Ozone Manager (om.db) , StorageContainerManager (scm.db), Datanode/Container (container.db)
+Below is the usage:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">Usage: ozone debug ldb --db<span style="color:#f92672">=</span><dbPath> <span style="color:#f92672">[</span>COMMAND<span style="color:#f92672">]</span>
+Parse rocksdb file content
+ --db<span style="color:#f92672">=</span><dbPath> Database File Path
+Commands:
+ scan Parse specified metadataTable
+ list_column_families, ls list all column families in db.
+ value-schema Schema of value in metadataTable
+</code></pre></div><h3 id="list_column_families-command">list_column_families command</h3>
+<p><code>list_column_families</code> command lists all the column families in the db provided.</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone debug ldb --db<span style="color:#f92672">=</span>/path/to/scm.db ls
+default
+sequenceId
+revokedCertsV2
+pipelines
+crls
+crlSequenceId
+meta
+containers
+validCerts
+validSCMCerts
+scmTransactionInfos
+deletedBlocks
+statefulServiceConfig
+revokedCerts
+move
+</code></pre></div><h3 id="scan-command">scan command</h3>
+<p><code>scan</code> command parses a particular column family of a rocksdb provided and prints the records.</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">Usage: ozone debug ldb scan <span style="color:#f92672">[</span>--compact<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>--count<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>--with-keys<span style="color:#f92672">]</span>
+ <span style="color:#f92672">[</span>--batch-size<span style="color:#f92672">=</span><batchSize><span style="color:#f92672">]</span> --cf<span style="color:#f92672">=</span><tableName>
+ <span style="color:#f92672">[</span>--cid<span style="color:#f92672">=</span><containerId><span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-d<span style="color:#f92672">=</span><dnDBSchemaVersion><span style="color:#f92672">]</span>
+ <span style="color:#f92672">[</span>-e<span style="color:#f92672">=</span><endKey><span style="color:#f92672">]</span> <span style="color:#f92672">[</span>--fields<span style="color:#f92672">=</span><fieldsFilter><span style="color:#f92672">]</span>
+ <span style="color:#f92672">[</span>--filter<span style="color:#f92672">=</span><filter><span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-l<span style="color:#f92672">=</span><limit><span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-o<span style="color:#f92672">=</span><fileName><span style="color:#f92672">]</span>
+ <span style="color:#f92672">[</span>-s<span style="color:#f92672">=</span><startKey><span style="color:#f92672">]</span> <span style="color:#f92672">[</span>--thread-count<span style="color:#f92672">=</span><threadCount><span style="color:#f92672">]</span>
+Parse specified metadataTable
+ --batch-size<span style="color:#f92672">=</span><batchSize>
+ Batch size <span style="color:#66d9ef">for</span> processing DB data.
+ --cf, --column_family, --column-family<span style="color:#f92672">=</span><tableName>
+ Table name
+ --cid, --container-id<span style="color:#f92672">=</span><containerId>
+ Container ID. Applicable <span style="color:#66d9ef">if</span> datanode DB Schema is V3
+ --compact disable the pretty print the output
+ --count, --show-count
+ Get estimated key count <span style="color:#66d9ef">for</span> the given DB column family
+ Default: false
+ -d, --dnSchema, --dn-schema<span style="color:#f92672">=</span><dnDBSchemaVersion>
+ Datanode DB Schema Version: V1/V2/V3
+ -e, --ek, --endkey<span style="color:#f92672">=</span><endKey>
+ Key at which iteration of the DB ends
+ --fields<span style="color:#f92672">=</span><fieldsFilter>
+ Comma-separated list of fields needed <span style="color:#66d9ef">for</span> each value.
+ eg.<span style="color:#f92672">)</span> <span style="color:#e6db74">"name,acls.type"</span> <span style="color:#66d9ef">for</span> showing name and type
+ under acls.
+ --filter<span style="color:#f92672">=</span><filter> Comma-separated list of <span style="color:#e6db74">"<field>:<operator>:<value>"</span>
+ where <field> is any valid field of the record,
+ <operator> is <span style="color:#f92672">[</span>EQUALS,LESSER, GREATER or REGEX<span style="color:#f92672">]</span>.
+ <span style="color:#f92672">(</span>EQUALS compares the exact string, REGEX compares
+ with a valid regular expression passed, and
+ LESSER/GREATER works with numeric values<span style="color:#f92672">)</span>, <value>
+ is the value of the field.
+ eg.<span style="color:#f92672">)</span> <span style="color:#e6db74">"dataSize:equals:1000"</span> <span style="color:#66d9ef">for</span> showing records
+ having the value <span style="color:#ae81ff">1000</span> <span style="color:#66d9ef">for</span> dataSize,
+ <span style="color:#e6db74">"keyName:regex:^key.*</span>$<span style="color:#e6db74">"</span> <span style="color:#66d9ef">for</span> showing records
+ having keyName that matches the given regex.
+ -l, --limit, --length<span style="color:#f92672">=</span><limit>
+ Maximum number of items to list.
+ -o, --out<span style="color:#f92672">=</span><fileName> File to dump table scan data
+ -s, --sk, --startkey<span style="color:#f92672">=</span><startKey>
+ Key from which to iterate the DB
+ --thread-count<span style="color:#f92672">=</span><threadCount>
+ Thread count <span style="color:#66d9ef">for</span> concurrent processing.
+ --with-keys Print a JSON object of key->value pairs <span style="color:#f92672">(</span>default<span style="color:#f92672">)</span>
+ instead of a JSON array of only values.
+</code></pre></div><p>By default, the contents are printed on the console, but it can be redirected to a file using the <code>--out</code> option. <br>
+<code>--length</code> can be used to limit the number of records being printed. <br>
+<code>--count</code> doesn’t print the records, it shows the approximate number of records. This is not accurate. <br>
+<code>ozone debug ldb scan</code> command provides many filtering options to make debugging easier, elaborated below: <br></p>
+<div class="alert alert-success" role="alert">
+ Multiple filtering options can be used together in a single command.
+</div>
+<h4 id="--startkey-and---endkey">–startkey and –endkey</h4>
+<p>As the names suggest, these options specify the keys from/until which the iteration needs to happen. <br>
+<code>--startkey</code> specifies which key to start iterating from, it is inclusive. <code>--endkey</code> specifies which key to stop iterating at, it is exclusive.</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone debug ldb --db<span style="color:#f92672">=</span>/path/to/om.db scan --cf<span style="color:#f92672">=</span>volumeTable --startkey<span style="color:#f92672">=</span>vol3 --endkey<span style="color:#f92672">=</span>vol5
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{ <span style="color:#f92672">"/vol3"</span>: {
+ <span style="color:#f92672">"metadata"</span> : { },
+ <span style="color:#f92672">"objectID"</span> : <span style="color:#ae81ff">-9999</span>,
+ <span style="color:#f92672">"updateID"</span> : <span style="color:#ae81ff">4000</span>,
+ <span style="color:#f92672">"adminName"</span> : <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"ownerName"</span> : <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"volume"</span> : <span style="color:#e6db74">"vol3"</span>,
+ <span style="color:#f92672">"creationTime"</span> : <span style="color:#ae81ff">1707192335309</span>,
+ <span style="color:#f92672">"modificationTime"</span> : <span style="color:#ae81ff">1714057412205</span>,
+ <span style="color:#f92672">"quotaInBytes"</span> : <span style="color:#ae81ff">22854448694951936</span>,
+ <span style="color:#f92672">"quotaInNamespace"</span> : <span style="color:#ae81ff">100000000</span>,
+ <span style="color:#f92672">"usedNamespace"</span> : <span style="color:#ae81ff">1</span>,
+ <span style="color:#f92672">"acls"</span> : [ {
+ <span style="color:#f92672">"type"</span> : <span style="color:#e6db74">"USER"</span>,
+ <span style="color:#f92672">"name"</span> : <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"aclScope"</span> : <span style="color:#e6db74">"ACCESS"</span>
+ } ],
+ <span style="color:#f92672">"refCount"</span> : <span style="color:#ae81ff">0</span>
+}
+, <span style="color:#f92672">"/vol4"</span>: {
+ <span style="color:#f92672">"metadata"</span> : { },
+ <span style="color:#f92672">"objectID"</span> : <span style="color:#ae81ff">-888</span>,
+ <span style="color:#f92672">"updateID"</span> : <span style="color:#ae81ff">5000</span>,
+ <span style="color:#f92672">"adminName"</span> : <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"ownerName"</span> : <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"volume"</span> : <span style="color:#e6db74">"vol4"</span>,
+ <span style="color:#f92672">"creationTime"</span> : <span style="color:#ae81ff">1696280979907</span>,
+ <span style="color:#f92672">"modificationTime"</span> : <span style="color:#ae81ff">1696280979907</span>,
+ <span style="color:#f92672">"quotaInBytes"</span> : <span style="color:#ae81ff">2251799813685250</span>,
+ <span style="color:#f92672">"quotaInNamespace"</span> : <span style="color:#ae81ff">100000000</span>,
+ <span style="color:#f92672">"usedNamespace"</span> : <span style="color:#ae81ff">2</span>,
+ <span style="color:#f92672">"acls"</span> : [ {
+ <span style="color:#f92672">"type"</span> : <span style="color:#e6db74">"USER"</span>,
+ <span style="color:#f92672">"name"</span> : <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"aclScope"</span> : <span style="color:#e6db74">"ACCESS"</span>
+ } ],
+ <span style="color:#f92672">"refCount"</span> : <span style="color:#ae81ff">0</span>
+}
+ }
+</code></pre></div><h4 id="--fields">–fields</h4>
+<p>There are multiple fields in each record. <code>--fields</code> option allows us to choose the specific fields to display.</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone debug ldb --db<span style="color:#f92672">=</span>/path/to/om.db scan --cf<span style="color:#f92672">=</span>keyTable -l<span style="color:#f92672">=</span><span style="color:#ae81ff">1</span> --fields<span style="color:#f92672">=</span><span style="color:#e6db74">"volumeName,bucketName,keyName,keyLocationVersions.ve [...]
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{ <span style="color:#f92672">"/vol1/ozone-legacy-bucket/10T-1-terasort-input/"</span>: {
+ <span style="color:#f92672">"keyLocationVersions"</span> : [ {
+ <span style="color:#f92672">"version"</span> : <span style="color:#ae81ff">0</span>
+ } ],
+ <span style="color:#f92672">"keyName"</span> : <span style="color:#e6db74">"10T-1-terasort-input/"</span>,
+ <span style="color:#f92672">"bucketName"</span> : <span style="color:#e6db74">"ozone-legacy-bucket"</span>,
+ <span style="color:#f92672">"acls"</span> : [ {
+ <span style="color:#f92672">"name"</span> : <span style="color:#e6db74">"om"</span>
+ }, {
+ <span style="color:#f92672">"name"</span> : <span style="color:#e6db74">"scm"</span>
+ }, {
+ <span style="color:#f92672">"name"</span> : <span style="color:#e6db74">"testuser"</span>
+ } ],
+ <span style="color:#f92672">"volumeName"</span> : <span style="color:#e6db74">"vol1"</span>
+}
+}
+</code></pre></div><h4 id="--filter">–filter</h4>
+<p><code>--filter</code> can be used to select records whose value matches a given condition. The filter is given in this format: <code><field>:<operator>:<value></code>,
+where <code><field></code> is any valid field from the value of the record, <code><operator></code> is one of the 4 supported operations <code>[equals, regex, lesser, greater]</code>, <code><value></code> is the value used for the comparison. <br>
+‘Equals’ and ‘regex’ work with string, bool and numerical fields, ‘lesser’ and ‘greater’ work only with numerical values. <br>
+Multiple filters can also be given in one command, they need to be separated by commas. <br>
+Using <code>equals</code> operator:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone debug ldb --db<span style="color:#f92672">=</span>/path/to/om.db scan --cf<span style="color:#f92672">=</span>volumeTable --filter<span style="color:#f92672">=</span><span style="color:#e6db74">"usedNamespace:equals:2"</span>
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"/vol4"</span>: {
+ <span style="color:#f92672">"metadata"</span>: {},
+ <span style="color:#f92672">"objectID"</span>: <span style="color:#ae81ff">-888</span>,
+ <span style="color:#f92672">"updateID"</span>: <span style="color:#ae81ff">5000</span>,
+ <span style="color:#f92672">"adminName"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"ownerName"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"volume"</span>: <span style="color:#e6db74">"vol4"</span>,
+ <span style="color:#f92672">"creationTime"</span>: <span style="color:#ae81ff">1696280979907</span>,
+ <span style="color:#f92672">"modificationTime"</span>: <span style="color:#ae81ff">1696280979907</span>,
+ <span style="color:#f92672">"quotaInBytes"</span>: <span style="color:#ae81ff">2251799813685250</span>,
+ <span style="color:#f92672">"quotaInNamespace"</span>: <span style="color:#ae81ff">100000000</span>,
+ <span style="color:#f92672">"usedNamespace"</span>: <span style="color:#ae81ff">2</span>,
+ <span style="color:#f92672">"acls"</span>: [
+ {
+ <span style="color:#f92672">"type"</span>: <span style="color:#e6db74">"USER"</span>,
+ <span style="color:#f92672">"name"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"aclScope"</span>: <span style="color:#e6db74">"ACCESS"</span>
+ }
+ ],
+ <span style="color:#f92672">"refCount"</span>: <span style="color:#ae81ff">0</span>
+ }
+, <span style="color:#f92672">"/vol5"</span>: {
+ <span style="color:#f92672">"metadata"</span> : { },
+ <span style="color:#f92672">"objectID"</span> : <span style="color:#ae81ff">-956599</span>,
+ <span style="color:#f92672">"updateID"</span> : <span style="color:#ae81ff">45600</span>,
+ <span style="color:#f92672">"adminName"</span> : <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"ownerName"</span> : <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"volume"</span> : <span style="color:#e6db74">"vol5"</span>,
+ <span style="color:#f92672">"creationTime"</span> : <span style="color:#ae81ff">1807192332309</span>,
+ <span style="color:#f92672">"modificationTime"</span> : <span style="color:#ae81ff">1914057410005</span>,
+ <span style="color:#f92672">"quotaInBytes"</span> : <span style="color:#ae81ff">7785494951936</span>,
+ <span style="color:#f92672">"quotaInNamespace"</span> : <span style="color:#ae81ff">100000000</span>,
+ <span style="color:#f92672">"usedNamespace"</span> : <span style="color:#ae81ff">2</span>,
+ <span style="color:#f92672">"acls"</span> : [ {
+ <span style="color:#f92672">"type"</span> : <span style="color:#e6db74">"USER"</span>,
+ <span style="color:#f92672">"name"</span> : <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"aclScope"</span> : <span style="color:#e6db74">"ACCESS"</span>
+ } ],
+ <span style="color:#f92672">"refCount"</span> : <span style="color:#ae81ff">0</span>
+}
+ }
+</code></pre></div><p>Using <code>lesser</code> operator (<code>greater</code> operator can also be used in the same way):</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone debug ldb --db<span style="color:#f92672">=</span>/path/to/om.db scan --cf<span style="color:#f92672">=</span>volumeTable --filter<span style="color:#f92672">=</span><span style="color:#e6db74">"usedNamespace:lesser:2"</span>
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"/vol2"</span>: {
+ <span style="color:#f92672">"metadata"</span>: {},
+ <span style="color:#f92672">"objectID"</span>: <span style="color:#ae81ff">-73548</span>,
+ <span style="color:#f92672">"updateID"</span>: <span style="color:#ae81ff">2384</span>,
+ <span style="color:#f92672">"adminName"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"ownerName"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"volume"</span>: <span style="color:#e6db74">"vol2"</span>,
+ <span style="color:#f92672">"creationTime"</span>: <span style="color:#ae81ff">11980979907</span>,
+ <span style="color:#f92672">"modificationTime"</span>: <span style="color:#ae81ff">1296280979900</span>,
+ <span style="color:#f92672">"quotaInBytes"</span>: <span style="color:#ae81ff">417913685250</span>,
+ <span style="color:#f92672">"quotaInNamespace"</span>: <span style="color:#ae81ff">100000000</span>,
+ <span style="color:#f92672">"usedNamespace"</span>: <span style="color:#ae81ff">1</span>,
+ <span style="color:#f92672">"acls"</span>: [
+ {
+ <span style="color:#f92672">"type"</span>: <span style="color:#e6db74">"USER"</span>,
+ <span style="color:#f92672">"name"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"aclScope"</span>: <span style="color:#e6db74">"ACCESS"</span>
+ }
+ ],
+ <span style="color:#f92672">"refCount"</span>: <span style="color:#ae81ff">0</span>
+ }
+ }
+</code></pre></div><p>Using <code>regex</code> operator:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone debug ldb --db<span style="color:#f92672">=</span>/path/to/om.db scan --cf<span style="color:#f92672">=</span>volumeTable --filter<span style="color:#f92672">=</span><span style="color:#e6db74">"volume:regex:^v.*2</span>$<span style="color:#e6db74">"</span>
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"/vol2"</span>: {
+ <span style="color:#f92672">"metadata"</span>: {},
+ <span style="color:#f92672">"objectID"</span>: <span style="color:#ae81ff">-73548</span>,
+ <span style="color:#f92672">"updateID"</span>: <span style="color:#ae81ff">2384</span>,
+ <span style="color:#f92672">"adminName"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"ownerName"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"volume"</span>: <span style="color:#e6db74">"vol2"</span>,
+ <span style="color:#f92672">"creationTime"</span>: <span style="color:#ae81ff">11980979907</span>,
+ <span style="color:#f92672">"modificationTime"</span>: <span style="color:#ae81ff">1296280979900</span>,
+ <span style="color:#f92672">"quotaInBytes"</span>: <span style="color:#ae81ff">417913685250</span>,
+ <span style="color:#f92672">"quotaInNamespace"</span>: <span style="color:#ae81ff">100000000</span>,
+ <span style="color:#f92672">"usedNamespace"</span>: <span style="color:#ae81ff">1</span>,
+ <span style="color:#f92672">"acls"</span>: [
+ {
+ <span style="color:#f92672">"type"</span>: <span style="color:#e6db74">"USER"</span>,
+ <span style="color:#f92672">"name"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"aclScope"</span>: <span style="color:#e6db74">"ACCESS"</span>
+ }
+ ],
+ <span style="color:#f92672">"refCount"</span>: <span style="color:#ae81ff">0</span>
+ }
+ }
+</code></pre></div><p>Using multiple filters:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone debug ldb --db<span style="color:#f92672">=</span>/path/to/om.db scan --cf<span style="color:#f92672">=</span>volumeTable --filter<span style="color:#f92672">=</span><span style="color:#e6db74">"usedNamespace:equals:2,volume:regex:^.*4</span>$<span style="color:#e6db74">"</span>
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"/vol4"</span>: {
+ <span style="color:#f92672">"metadata"</span>: {},
+ <span style="color:#f92672">"objectID"</span>: <span style="color:#ae81ff">-888</span>,
+ <span style="color:#f92672">"updateID"</span>: <span style="color:#ae81ff">5000</span>,
+ <span style="color:#f92672">"adminName"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"ownerName"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"volume"</span>: <span style="color:#e6db74">"vol4"</span>,
+ <span style="color:#f92672">"creationTime"</span>: <span style="color:#ae81ff">1696280979907</span>,
+ <span style="color:#f92672">"modificationTime"</span>: <span style="color:#ae81ff">1696280979907</span>,
+ <span style="color:#f92672">"quotaInBytes"</span>: <span style="color:#ae81ff">2251799813685250</span>,
+ <span style="color:#f92672">"quotaInNamespace"</span>: <span style="color:#ae81ff">100000000</span>,
+ <span style="color:#f92672">"usedNamespace"</span>: <span style="color:#ae81ff">2</span>,
+ <span style="color:#f92672">"acls"</span>: [
+ {
+ <span style="color:#f92672">"type"</span>: <span style="color:#e6db74">"USER"</span>,
+ <span style="color:#f92672">"name"</span>: <span style="color:#e6db74">"om"</span>,
+ <span style="color:#f92672">"aclScope"</span>: <span style="color:#e6db74">"ACCESS"</span>
+ }
+ ],
+ <span style="color:#f92672">"refCount"</span>: <span style="color:#ae81ff">0</span>
+ }
+ }
+</code></pre></div><h3 id="value-schema-command">value-schema command</h3>
+<p><code>value-schema</code> command shows the schema of the value stored in a column-family of a rocksdb, i.e., it shows the fields stored in the value and it’s datatype.
+<code>--depth</code> can be used optionally to limit the level until which the fields are fetched.</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone debug ldb --db<span style="color:#f92672">=</span>/data/metadata/om.db value-schema --cf<span style="color:#f92672">=</span>keyTable --depth<span style="color:#f92672">=</span><span style="color:#ae81ff">1</span>
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"OmKeyInfo"</span> : {
+ <span style="color:#f92672">"bucketName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"metadata"</span> : <span style="color:#e6db74">"struct"</span>,
+ <span style="color:#f92672">"fileName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"creationTime"</span> : <span style="color:#e6db74">"long"</span>,
+ <span style="color:#f92672">"isFile"</span> : <span style="color:#e6db74">"boolean"</span>,
+ <span style="color:#f92672">"acls"</span> : <span style="color:#e6db74">"struct"</span>,
+ <span style="color:#f92672">"keyName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"replicationConfig"</span> : <span style="color:#e6db74">"struct"</span>,
+ <span style="color:#f92672">"encInfo"</span> : <span style="color:#e6db74">"struct"</span>,
+ <span style="color:#f92672">"dataSize"</span> : <span style="color:#e6db74">"long"</span>,
+ <span style="color:#f92672">"tags"</span> : <span style="color:#e6db74">"struct"</span>,
+ <span style="color:#f92672">"keyLocationVersions"</span> : <span style="color:#e6db74">"struct"</span>,
+ <span style="color:#f92672">"updateID"</span> : <span style="color:#e6db74">"long"</span>,
+ <span style="color:#f92672">"ownerName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"modificationTime"</span> : <span style="color:#e6db74">"long"</span>,
+ <span style="color:#f92672">"parentObjectID"</span> : <span style="color:#e6db74">"long"</span>,
+ <span style="color:#f92672">"volumeName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"fileChecksum"</span> : <span style="color:#e6db74">"struct"</span>,
+ <span style="color:#f92672">"objectID"</span> : <span style="color:#e6db74">"long"</span>
+}
+ }
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone debug ldb --db<span style="color:#f92672">=</span>/data/metadata/om.db value-schema --cf<span style="color:#f92672">=</span>keyTable
+</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"OmKeyInfo"</span> : {
+ <span style="color:#f92672">"bucketName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"metadata"</span> : { },
+ <span style="color:#f92672">"fileName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"creationTime"</span> : <span style="color:#e6db74">"long"</span>,
+ <span style="color:#f92672">"isFile"</span> : <span style="color:#e6db74">"boolean"</span>,
+ <span style="color:#f92672">"acls"</span> : {
+ <span style="color:#f92672">"toStringMethod"</span> : { },
+ <span style="color:#f92672">"hashCodeMethod"</span> : { },
+ <span style="color:#f92672">"name"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"type"</span> : {
+ <span style="color:#f92672">"name"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"value"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"ordinal"</span> : <span style="color:#e6db74">"int"</span>
+ },
+ <span style="color:#f92672">"aclScope"</span> : {
+ <span style="color:#f92672">"name"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"ordinal"</span> : <span style="color:#e6db74">"int"</span>
+ },
+ <span style="color:#f92672">"aclBits"</span> : <span style="color:#e6db74">"int"</span>
+ },
+ <span style="color:#f92672">"keyName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"replicationConfig"</span> : { },
+ <span style="color:#f92672">"encInfo"</span> : {
+ <span style="color:#f92672">"ezKeyVersionName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"keyName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"edek"</span> : { },
+ <span style="color:#f92672">"cipherSuite"</span> : {
+ <span style="color:#f92672">"unknownValue"</span> : {
+ <span style="color:#f92672">"value"</span> : <span style="color:#e6db74">"int"</span>
+ },
+ <span style="color:#f92672">"name"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"algoBlockSize"</span> : <span style="color:#e6db74">"int"</span>,
+ <span style="color:#f92672">"ordinal"</span> : <span style="color:#e6db74">"int"</span>
+ },
+ <span style="color:#f92672">"version"</span> : {
+ <span style="color:#f92672">"unknownValue"</span> : {
+ <span style="color:#f92672">"value"</span> : <span style="color:#e6db74">"int"</span>
+ },
+ <span style="color:#f92672">"name"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"description"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"version"</span> : <span style="color:#e6db74">"int"</span>,
+ <span style="color:#f92672">"ordinal"</span> : <span style="color:#e6db74">"int"</span>
+ },
+ <span style="color:#f92672">"iv"</span> : { }
+ },
+ <span style="color:#f92672">"dataSize"</span> : <span style="color:#e6db74">"long"</span>,
+ <span style="color:#f92672">"tags"</span> : { },
+ <span style="color:#f92672">"keyLocationVersions"</span> : {
+ <span style="color:#f92672">"isMultipartKey"</span> : <span style="color:#e6db74">"boolean"</span>,
+ <span style="color:#f92672">"locationVersionMap"</span> : { },
+ <span style="color:#f92672">"version"</span> : <span style="color:#e6db74">"long"</span>
+ },
+ <span style="color:#f92672">"updateID"</span> : <span style="color:#e6db74">"long"</span>,
+ <span style="color:#f92672">"ownerName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"modificationTime"</span> : <span style="color:#e6db74">"long"</span>,
+ <span style="color:#f92672">"parentObjectID"</span> : <span style="color:#e6db74">"long"</span>,
+ <span style="color:#f92672">"volumeName"</span> : <span style="color:#e6db74">"String"</span>,
+ <span style="color:#f92672">"fileChecksum"</span> : { },
+ <span style="color:#f92672">"objectID"</span> : <span style="color:#e6db74">"long"</span>
+ }
+}
+</code></pre></div>
+
+
+ <a class="btn btn-success btn-lg" href="../tools/logsinozone.html">Next >></a>
+
+ </div>
+
+ </div>
+ </div>
+ </div>
+ </div>
+ <div class="push"></div>
+ </div>
+
+
+
+<footer class="footer">
+ <div class="container">
+ <span class="small text-muted">
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 30, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/c4d68573f76c8a1528a4d07d558371dba159c37d">c4d68573f7</a>
+ </span>
+ </div>
+</footer>
+
+
+
+<script src="../js/jquery-3.5.1.min.js"></script>
+<script src="../js/ozonedoc.js"></script>
+<script src="../js/bootstrap.min.js"></script>
+
+
+</body>
+
+</html>
\ No newline at end of file
diff --git a/docs/edge/tools/genconf.html b/docs/edge/tools/genconf.html
index 0c8199b1..e49598fd 100644
--- a/docs/edge/tools/genconf.html
+++ b/docs/edge/tools/genconf.html
@@ -500,7 +500,7 @@ This template file can be edited to replace with proper values.</p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: September 19, 2019 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/f361a9be5cea972d0f2abab51a6bd5e976574ecc">f361a9be5c</a>
</span>
</div>
</footer>
diff --git a/docs/edge/tools/index.xml b/docs/edge/tools/index.xml
index df155093..fa036d84 100644
--- a/docs/edge/tools/index.xml
+++ b/docs/edge/tools/index.xml
@@ -7,6 +7,15 @@
<generator>Hugo -- gohugo.io</generator>
<language>en-us</language>
<lastBuildDate>Tue, 10 Oct 2017 00:00:00 +0000</lastBuildDate><atom:link href="/tools/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>Ozone Debug</title>
+ <link>/tools/debug.html</link>
+ <pubDate>Mon, 14 Oct 2024 00:00:00 +0000</pubDate>
+
+ <guid>/tools/debug.html</guid>
+ <description>Ozone Debug command can be used for all the debugging related tasks.</description>
+ </item>
+
<item>
<title>Logs in Ozone</title>
<link>/tools/logsinozone.html</link>
diff --git a/docs/edge/tools/logsinozone.html b/docs/edge/tools/logsinozone.html
index a69fe749..15b57235 100644
--- a/docs/edge/tools/logsinozone.html
+++ b/docs/edge/tools/logsinozone.html
@@ -508,7 +508,7 @@ appender.rolling.strategy.delete.ifLastModified.age=30d
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 6, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/471f1b2a9332ce0d813fa3ba454f692d6dddc223">471f1b2a93</a>
</span>
</div>
</footer>
diff --git a/docs/edge/tools/testtools.html b/docs/edge/tools/testtools.html
index 3534a2cd..125b5c61 100644
--- a/docs/edge/tools/testtools.html
+++ b/docs/edge/tools/testtools.html
@@ -544,7 +544,7 @@ Total Execution time: 00:00:16,898
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 11, 2022 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/2522127b1c0bc12038265faeb667c9c0592e53bc">2522127b1c</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/concept.html b/docs/edge/zh/concept.html
index a6204389..03222f4d 100644
--- a/docs/edge/zh/concept.html
+++ b/docs/edge/zh/concept.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -554,7 +584,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 5, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/19cb481896f091ec5c02fe4010a5ab428302f38f">19cb481896</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/concept/containers.html b/docs/edge/zh/concept/containers.html
index 0fddcf62..734ff843 100644
--- a/docs/edge/zh/concept/containers.html
+++ b/docs/edge/zh/concept/containers.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -457,7 +487,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: November 15, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/45e30d6eb0b5e0cfaffe246a977e0cf98d492a9b">45e30d6eb0</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/concept/datanodes.html b/docs/edge/zh/concept/datanodes.html
index 3e6ea946..eb494822 100644
--- a/docs/edge/zh/concept/datanodes.html
+++ b/docs/edge/zh/concept/datanodes.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -423,6 +453,48 @@ s=d.getElementsByTagName('script')[0];
<h3 id="容器的位置发现">容器的位置发现</h3>
<p>SCM 如何获得容器的位置?这一点和现有的 HDFS 十分相似。数据节点会定期发送类似于块报告的容器报告,容器报告比块报告的内容简洁的多,比如,对于一个存储容量为 196 TB 的集群,Ozone 大概会拥有四万个容器,相比于 HDFS 的一百五十万个块,块报告数量缩减为四十分之一。</p>
<p>这种间接管理的方式大大地提高了 Ozone 的扩展性,因为 SCM 需要处理的块数据大大减少,且命名服务(OM)作为一个独特的服务主体对于扩展 Ozone 具有重要意义。</p>
+<h2 id="需要关注的配置项">需要关注的配置项</h2>
+<table>
+<thead>
+<tr>
+<th>配置项</th>
+<th>默认值</th>
+<th><div style="width:300px;">描述</div></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>dfs.container.ratis.datanode.storage.dir</td>
+<td>none</td>
+<td>该目录用于存储 Ratis 元数据,如日志。</td>
+</tr>
+<tr>
+<td>ozone.scm.datanode.id.dir</td>
+<td>none</td>
+<td>数据节点上用于存储数据节点 ID 的路径。</td>
+</tr>
+<tr>
+<td>hdds.datanode.dir</td>
+<td>none</td>
+<td>此配置决定数据节点上的数据将存储在本地文件系统的哪个位置。</td>
+</tr>
+<tr>
+<td>hdds.datanode.dir.du.reserved</td>
+<td>none</td>
+<td>每个卷保留的存储空间(以字节为单位)。始终为非DFS用途保留这么多空闲空间。</td>
+</tr>
+<tr>
+<td>ozone.metadata.dirs</td>
+<td>none</td>
+<td>用于存储持久化数据(RocksDB)的目录。</td>
+</tr>
+<tr>
+<td>ozone.recon.address</td>
+<td>0.0.0.0:9891</td>
+<td>Recon的RPC地址。 使用 <a href="host:port">host:port</a> 连接到Recon。</td>
+</tr>
+</tbody>
+</table>
@@ -442,7 +514,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: September 23, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/0fcb64564d88defc8d2c0ab585bff5717c26632b">0fcb64564d</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/concept/overview.html b/docs/edge/zh/concept/overview.html
index 45ff5fda..b22e5fd0 100644
--- a/docs/edge/zh/concept/overview.html
+++ b/docs/edge/zh/concept/overview.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -441,7 +471,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 5, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/19cb481896f091ec5c02fe4010a5ab428302f38f">19cb481896</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/concept/ozonemanager.html b/docs/edge/zh/concept/ozonemanager.html
index 4896938c..bf3bcf41 100644
--- a/docs/edge/zh/concept/ozonemanager.html
+++ b/docs/edge/zh/concept/ozonemanager.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -575,7 +605,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 20, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/52ec27cf19e1d360c1d64bf7fc6181173124192a">52ec27cf19</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/concept/recon.html b/docs/edge/zh/concept/recon.html
index 477d2770..f323d1c4 100644
--- a/docs/edge/zh/concept/recon.html
+++ b/docs/edge/zh/concept/recon.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -413,7 +443,7 @@ s=d.getElementsByTagName('script')[0];
<br/>
<p>在较高的层次上,Recon 收集和汇总来自 Ozone Manager(OM)、Storage Container Manager(SCM)和数据节点(DN)的元数据,并充当中央管理和监视控制台。Ozone 管理员可以使用 Recon 查询系统的当前状态,而不会使 OM 或 SCM 过载。</p>
-<p>Recon 维护多个数据库,以支持批处理,更快的查询和持久化聚合信息。它维护 OM DB 和 SCM DB 的本地副本,以及用于持久存储聚合信息的 SQL 数据库。</p>
+<p>Recon 维护多个数据库,以支持批处理,更快地查询和持久化聚合信息。它维护 OM DB 和 SCM DB 的本地副本,以及用于持久存储聚合信息的 SQL 数据库。</p>
<p>Recon 还与 Prometheus 集成,提供一个 HTTP 端点来查询 Prometheus 的 Ozone 指标,并在网页用户界面(Web UI)中显示一些关键时间点的指标。</p>
<h2 id="recon-和-ozone-manager">Recon 和 Ozone Manager</h2>
<figure><img src="../../concept/ReconOmDesign.png" width="800px"/>
@@ -577,7 +607,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: June 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/9f1f7ed23801f219a41d9dd9283cc6fdf57381c8">9f1f7ed238</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/concept/storagecontainermanager.html b/docs/edge/zh/concept/storagecontainermanager.html
index 88c8a01b..fd12381b 100644
--- a/docs/edge/zh/concept/storagecontainermanager.html
+++ b/docs/edge/zh/concept/storagecontainermanager.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -529,7 +559,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: December 17, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/1b6f7dbed61a9e70969b6682707ce19e99c459bb">1b6f7dbed6</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature.html b/docs/edge/zh/feature.html
index 294b1ec6..eb29a916 100644
--- a/docs/edge/zh/feature.html
+++ b/docs/edge/zh/feature.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -660,7 +690,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 16, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/66ee3b4420182fa3d97381827e06837df261beeb">66ee3b4420</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature/decommission.html b/docs/edge/zh/feature/decommission.html
index fe60a5b7..f0c43715 100644
--- a/docs/edge/zh/feature/decommission.html
+++ b/docs/edge/zh/feature/decommission.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -429,6 +459,9 @@ s=d.getElementsByTagName('script')[0];
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">ozone admin datanode decommission <span style="color:#f92672">[</span>-hV<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-id<span style="color:#f92672">=</span><scmServiceId><span style="color:#f92672">]</span>
<span style="color:#f92672">[</span>--scm<span style="color:#f92672">=</span><scm><span style="color:#f92672">]</span> <span style="color:#f92672">[</span><hosts>...<span style="color:#f92672">]</span>
</code></pre></div><p>您可以输入多个主机,以便一起Decommission多个DataNode。</p>
+<p>查看 Decommission时datanode 的状态,可以执行下面的命令,</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">ozone admin datanode status decommission <span style="color:#f92672">[</span>-hV<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-id<span style="color:#f92672">=</span><scmServiceId><span style="color:#f92672">]</span> <span style="color:#f92672">[</span>--scm<span style="color:#f92672">=</span>< [...]
+</code></pre></div><p>您可以指定一个 Datanode 的 IP address 或 UUID 以查看该 Datanode 相关的详细信息。</p>
<p><strong>Note:</strong> 要Recommission某台DataNode的时候,可在命令行执行以下命令,</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">ozone admin datanode recommission <span style="color:#f92672">[</span>-hV<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>-id<span style="color:#f92672">=</span><scmServiceId><span style="color:#f92672">]</span>
<span style="color:#f92672">[</span>--scm<span style="color:#f92672">=</span><scm><span style="color:#f92672">]</span> <span style="color:#f92672">[</span><hosts>...<span style="color:#f92672">]</span>
@@ -475,7 +508,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 5, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/80592135edffbcec2087edfd70c3b31b70841ebc">80592135ed</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature/dn-merge-rocksdb.html b/docs/edge/zh/feature/dn-merge-rocksdb.html
index 4c670ed0..c8a30aaa 100644
--- a/docs/edge/zh/feature/dn-merge-rocksdb.html
+++ b/docs/edge/zh/feature/dn-merge-rocksdb.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -407,10 +437,10 @@ s=d.getElementsByTagName('script')[0];
limitations under the License.
-->
<p>在 Ozone 中,用户数据被分割成blocks并存储在 HDDS Container中。Container是 Ozone/HDDS 的基本复制单元。每个Container都有自己的元数据和数据, 数据以文件形式保存在磁盘上,元数据保存在RocksDB中。</p>
-<p>目前,数据节点上的每个Container都有一个RocksDB。随着用户数据的不断增长,一个DataNode上将会有成百上千个RocksDB实例。在一个JVM中管理如此多的RocksDB实例是一个巨大的挑战。</p>
-<p>与当前使用方法不同,“Merge Container RocksDB in DN"功能将为每个Volume只使用一个RocksDB,并在此RocksDB中保存所有Container的元数据。</p>
+<p>之前,数据节点上每个Container都有一个RocksDB。随着用户数据的不断增长,一个DataNode上将会有成百上千个RocksDB实例。在一个JVM中管理如此多的RocksDB实例是一个巨大的挑战。</p>
+<p>与以前的用法不同,“Merge Container RocksDB in DN"功能将为每个Volume只使用一个RocksDB,并在此RocksDB中保存所有Container的元数据。</p>
<h2 id="配置">配置</h2>
-<p>这主要是DataNode的功能,不需要太多配置。</p>
+<p>这主要是DataNode的功能,不需要太多配置。默认情况下,它是启用的。</p>
<p>如果更倾向于为每个Container使用一个RocksDB的模式,那么这下面的配置可以禁用上面所介绍的功能。请注意,一旦启用该功能,强烈建议以后不要再禁用。</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-XML" data-lang="XML"><span style="color:#f92672"><property></span>
<span style="color:#f92672"><name></span>hdds.datanode.container.schema.v3.enabled<span style="color:#f92672"></name></span>
@@ -455,7 +485,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: November 25, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/c4b2056e6f3e965c8df75bb8cf62aef182fcb86a">c4b2056e6f</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature/erasurecoding.html b/docs/edge/zh/feature/erasurecoding.html
index b5e812eb..2fe7e97c 100644
--- a/docs/edge/zh/feature/erasurecoding.html
+++ b/docs/edge/zh/feature/erasurecoding.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -530,7 +560,7 @@ EC 要求集群中 datanode 的数量至少和带宽数量相等,因此对于
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 17, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/c23ba9a1169227480c28efce43c0403e19164b3d">c23ba9a116</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature/index.xml b/docs/edge/zh/feature/index.xml
index 0be4c531..0d504738 100644
--- a/docs/edge/zh/feature/index.xml
+++ b/docs/edge/zh/feature/index.xml
@@ -72,7 +72,7 @@
<item>
<title>Ozone 中的配额</title>
<link>/zh/feature/quota.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Thu, 22 Oct 2020 00:00:00 +0000</pubDate>
<guid>/zh/feature/quota.html</guid>
<description>Ozone中的配额</description>
diff --git a/docs/edge/zh/feature/observability.html b/docs/edge/zh/feature/observability.html
index db318098..8dce0895 100644
--- a/docs/edge/zh/feature/observability.html
+++ b/docs/edge/zh/feature/observability.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -567,7 +597,7 @@ status: VOLUME_ALREADY_EXISTS
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 11, 2022 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/2522127b1c0bc12038265faeb667c9c0592e53bc">2522127b1c</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature/om-ha.html b/docs/edge/zh/feature/om-ha.html
index 26dfed12..968d19e4 100644
--- a/docs/edge/zh/feature/om-ha.html
+++ b/docs/edge/zh/feature/om-ha.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -482,7 +512,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 13, 2022 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/6e2de9932447f8bfb4cf4ddd7de56fe44cabdcb6">6e2de99324</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature/prefixfso.html b/docs/edge/zh/feature/prefixfso.html
index 9a016109..4c6ca506 100644
--- a/docs/edge/zh/feature/prefixfso.html
+++ b/docs/edge/zh/feature/prefixfso.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -455,7 +485,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: January 26, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/e806fd6ce8ef9d705884e573f6aee21be6b385e8">e806fd6ce8</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature/quota.html b/docs/edge/zh/feature/quota.html
index 8eb1f2b1..043453f9 100644
--- a/docs/edge/zh/feature/quota.html
+++ b/docs/edge/zh/feature/quota.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -520,7 +550,7 @@ bin/ozone sh bucket info /volume1/bucket1
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 21, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/8568075ddb75b4a6785cdb31b00b4a592058dc78">8568075ddb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature/recon.html b/docs/edge/zh/feature/recon.html
index 75504661..6e3aae45 100644
--- a/docs/edge/zh/feature/recon.html
+++ b/docs/edge/zh/feature/recon.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -428,7 +458,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: August 16, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/66ee3b4420182fa3d97381827e06837df261beeb">66ee3b4420</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature/reconfigurability.html b/docs/edge/zh/feature/reconfigurability.html
index 78b65181..dd8f94f7 100644
--- a/docs/edge/zh/feature/reconfigurability.html
+++ b/docs/edge/zh/feature/reconfigurability.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -506,7 +536,7 @@ Reconfig successfully 3 nodes, failure 0 nodes.<br></p>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 23, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/e9f11f0b5fe07acc380eb3f5dfea544d794d4812">e9f11f0b5f</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature/scm-ha.html b/docs/edge/zh/feature/scm-ha.html
index 66791864..38255726 100644
--- a/docs/edge/zh/feature/scm-ha.html
+++ b/docs/edge/zh/feature/scm-ha.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -548,7 +578,7 @@ bin/ozone debug ldb --db<span style="color:#f92672">=</span>/tmp/metadata/scm.db
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 25, 2023 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7357f752e481037e7d4eb2a05b61f9cb15323f1e">7357f752e4</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/feature/topology.html b/docs/edge/zh/feature/topology.html
index 1a6e8abd..c2c77aa2 100644
--- a/docs/edge/zh/feature/topology.html
+++ b/docs/edge/zh/feature/topology.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -478,7 +508,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: January 19, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/900c6ff0f33f5abd0c92578b9a64e6fe4d475242">900c6ff0f3</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/index.html b/docs/edge/zh/index.html
index 660e036a..011cdba6 100644
--- a/docs/edge/zh/index.html
+++ b/docs/edge/zh/index.html
@@ -262,6 +262,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../zh/security/securings3.html">安全化 S3</a>
@@ -288,7 +294,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -298,6 +346,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -326,30 +380,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -418,7 +448,7 @@ Ozone 不仅能存储数十亿个不同大小的对象,还支持在容器化
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: December 8, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/404aa6b06eb96138815bdb0d178a3b6999406098">404aa6b06e</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/index.xml b/docs/edge/zh/index.xml
index 0a104ce6..45319ced 100644
--- a/docs/edge/zh/index.xml
+++ b/docs/edge/zh/index.xml
@@ -6,6 +6,15 @@
<description>Recent content in 概述 on Ozone</description>
<generator>Hugo -- gohugo.io</generator>
<language>en-us</language><atom:link href="/zh/index.xml" rel="self" type="application/rss+xml" />
+ <item>
+ <title>安全化 Ozone</title>
+ <link>/zh/security/secureozone.html</link>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
+
+ <guid>/zh/security/secureozone.html</guid>
+ <description>简要介绍 Ozone 中的安全概念以及安全化 OM 和 SCM 的步骤。</description>
+ </item>
+
<item>
<title>概览</title>
<link>/zh/concept/overview.html</link>
@@ -25,21 +34,21 @@
</item>
<item>
- <title>Decommissioning</title>
- <link>/zh/feature/decommission.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <title>Ofs (兼容 Hadoop 的文件系统)</title>
+ <link>/zh/interface/ofs.html</link>
+ <pubDate>Thu, 14 Sep 2017 00:00:00 +0000</pubDate>
- <guid>/zh/feature/decommission.html</guid>
- <description>Decommissioning of SCM, OM and Datanode.</description>
+ <guid>/zh/interface/ofs.html</guid>
+ <description>Hadoop Compatible file system allows any application that expects an HDFS like interface to work against Ozone with zero changes. Frameworks like Apache Spark, YARN and Hive work against Ozone without needing any change. <strong>Global level view.</strong></description>
</item>
<item>
- <title>安全化 Ozone</title>
- <link>/zh/security/secureozone.html</link>
+ <title>Decommissioning</title>
+ <link>/zh/feature/decommission.html</link>
<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
- <guid>/zh/security/secureozone.html</guid>
- <description>简要介绍 Ozone 中的安全概念以及安全化 OM 和 SCM 的步骤。</description>
+ <guid>/zh/feature/decommission.html</guid>
+ <description>Decommissioning of SCM, OM and Datanode.</description>
</item>
<item>
@@ -69,6 +78,15 @@
<description>Storage Container Manager 的 HA 设置可以避免任何单点故障。</description>
</item>
+ <item>
+ <title>透明数据加密</title>
+ <link>/zh/security/securingtde.html</link>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
+
+ <guid>/zh/security/securingtde.html</guid>
+ <description>透明数据加密(Transparent Data Encryption,TDE)以密文形式在磁盘上保存数据,但可以在用户访问的时候自动进行解密。</description>
+ </item>
+
<item>
<title>Ozone Manager</title>
<link>/zh/concept/ozonemanager.html</link>
@@ -115,12 +133,21 @@
</item>
<item>
- <title>透明数据加密</title>
- <link>/zh/security/securingtde.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <title>Ozone 中的 GDPR</title>
+ <link>/zh/security/gdpr.html</link>
+ <pubDate>Tue, 17 Sep 2019 00:00:00 +0000</pubDate>
- <guid>/zh/security/securingtde.html</guid>
- <description>透明数据加密(Transparent Data Encryption,TDE)以密文形式在磁盘上保存数据,但可以在用户访问的时候自动进行解密。</description>
+ <guid>/zh/security/gdpr.html</guid>
+ <description>Ozone 中的 GDPR</description>
+ </item>
+
+ <item>
+ <title>安全化 Datanode</title>
+ <link>/zh/security/securingdatanodes.html</link>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
+
+ <guid>/zh/security/securingdatanodes.html</guid>
+ <description>解释安全化 datanode 的不同模式,包括 Kerberos、证书的手动颁发和自动颁发等。</description>
</item>
<item>
@@ -141,15 +168,6 @@
<description>Ozone 支持 容器存储接口 (CSI) 协议。你可以通过 Ozone CSI 挂载 Ozone 桶的方式使用 Ozone。</description>
</item>
- <item>
- <title>Ozone 中的 GDPR</title>
- <link>/zh/security/gdpr.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/zh/security/gdpr.html</guid>
- <description>Ozone 中的 GDPR</description>
- </item>
-
<item>
<title>S3 协议接口</title>
<link>/zh/interface/s3.html</link>
@@ -160,12 +178,21 @@
</item>
<item>
- <title>安全化 Datanode</title>
- <link>/zh/security/securingdatanodes.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <title>Ozone 中的配额</title>
+ <link>/zh/feature/quota.html</link>
+ <pubDate>Thu, 22 Oct 2020 00:00:00 +0000</pubDate>
- <guid>/zh/security/securingdatanodes.html</guid>
- <description>解释安全化 datanode 的不同模式,包括 Kerberos、证书的手动颁发和自动颁发等。</description>
+ <guid>/zh/feature/quota.html</guid>
+ <description>Ozone中的配额</description>
+ </item>
+
+ <item>
+ <title>安全化 HTTP</title>
+ <link>/zh/security/securingozonehttp.html</link>
+ <pubDate>Wed, 17 Jun 2020 00:00:00 +0000</pubDate>
+
+ <guid>/zh/security/securingozonehttp.html</guid>
+ <description>安全化 Ozone 服务的 HTTP 网络控制台</description>
</item>
<item>
@@ -177,15 +204,6 @@
<description>Ozone 支持 Amazon S3 协议,你可以原封不动地在 Ozone 上使用基于 S3 客户端和 S3 SDK 的应用。</description>
</item>
- <item>
- <title>Ozone 中的配额</title>
- <link>/zh/feature/quota.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-
- <guid>/zh/feature/quota.html</guid>
- <description>Ozone中的配额</description>
- </item>
-
<item>
<title>Recon API</title>
<link>/zh/interface/reconapi.html</link>
@@ -196,27 +214,46 @@
</item>
<item>
- <title>Containers</title>
- <link>/zh/concept/containers.html</link>
+ <title>命令行接口</title>
+ <link>/zh/interface/cli.html</link>
<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
- <guid>/zh/concept/containers.html</guid>
- <description>容器(Ozone的基本复制单元)的相关描述。</description>
+ <guid>/zh/interface/cli.html</guid>
+ <description>Ozone shell 是从命令行与 Ozone 交互的主要接口。在后台,它调用 Java API.
+有些功能只能通过使用 ozone sh 命令才能访问。例如:
+ 创建带有配额的卷 管理内部 ACL 创建带有加密的键的桶 所有这些命令都是一次性的管理任务。应用程序也可以使用其他接口,如 Hadoop 兼容文件系统(o3fs 或 ofs)或 S3 接口来实现相同功能而无需使用 Ozone 命令行接口。
+Ozone shell 的帮助菜单可以在 对象 级别 或者 动作 级别被调出.
+示例命令:
+ozone sh volume --help 这条命令展示了卷的所有可用的 动作 命令
+或者也可以用来解释具体的某个 动作 ,例如:
+ozone sh volume create --help 这条命令输出卷的create动作的所有命令行选项
+通用命令格式 Ozone shell 命令采取以下形式:
+ ozone sh object action url
+ ozone 脚本用于调用所有 Ozone 子命令。通过 sh 命令调用 ozone shell 命令。</description>
</item>
<item>
<title>安全化 S3</title>
<link>/zh/security/securings3.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
<guid>/zh/security/securings3.html</guid>
<description>Ozone 支持 S3 协议,并使用 AWS Signature Version 4 protocol which allows a seamless S3 experience.</description>
</item>
+ <item>
+ <title>Containers</title>
+ <link>/zh/concept/containers.html</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/zh/concept/containers.html</guid>
+ <description>容器(Ozone的基本复制单元)的相关描述。</description>
+ </item>
+
<item>
<title>Ozone 访问控制列表</title>
<link>/zh/security/securityacls.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
<guid>/zh/security/securityacls.html</guid>
<description>Ozone 原生的授权模块提供了不需要集成 Ranger 的访问控制列表(ACL)支持。</description>
@@ -225,7 +262,7 @@
<item>
<title>Apache Ranger</title>
<link>/zh/security/securitywithranger.html</link>
- <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+ <pubDate>Wed, 03 Apr 2019 00:00:00 +0000</pubDate>
<guid>/zh/security/securitywithranger.html</guid>
<description>Apache Ranger 是一个用于管理和监控 Hadoop 平台复杂数据权限的框架。</description>
@@ -349,6 +386,24 @@ cd smoketest ./test.sh 你也可以只执行最基本的验收测试:
cd smoketest ./test.sh --env ozone basic 验收测试会启动一个基于 docker-compose 的小型 ozone 集群,然后验证 ozone shell 和文件系统是否完全可用。</description>
</item>
+ <item>
+ <title>Ozone Debug</title>
+ <link>/zh/tools/debug.html</link>
+ <pubDate>Mon, 14 Oct 2024 00:00:00 +0000</pubDate>
+
+ <guid>/zh/tools/debug.html</guid>
+ <description>Ozone Debug 命令可用于所有与调试相关的任务。</description>
+ </item>
+
+ <item>
+ <title>Ozone Admin</title>
+ <link>/zh/tools/admin.html</link>
+ <pubDate>Wed, 25 Mar 2020 00:00:00 +0000</pubDate>
+
+ <guid>/zh/tools/admin.html</guid>
+ <description>Ozone Admin 命令可以用于所有与管理有关的任务。</description>
+ </item>
+
<item>
<title>配置生成</title>
<link>/zh/tools/genconf.html</link>
@@ -367,6 +422,15 @@ cd smoketest ./test.sh --env ozone basic 验收测试会启动一个基于 docke
<description>审计解析器工具用来查看 Ozone 的审计日志。</description>
</item>
+ <item>
+ <title>使用 Boto3 客户端访问 Ozone 对象存储</title>
+ <link>/zh/recipe/botoclient.html</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/zh/recipe/botoclient.html</guid>
+ <description>如何使用 Boto3 客户端访问 Ozone 对象存储?</description>
+ </item>
+
<item>
<title>使用 Prometheus 监控</title>
<link>/zh/recipe/prometheus.html</link>
diff --git a/docs/edge/zh/interface.html b/docs/edge/zh/interface.html
index 5488f174..9d831561 100644
--- a/docs/edge/zh/interface.html
+++ b/docs/edge/zh/interface.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="active">
<a href="../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -376,7 +406,7 @@ s=d.getElementsByTagName('script')[0];
</div>
- <h1>编程接口</h1>
+ <h1>客户端接口</h1>
</div>
<div class="col-md-9">
@@ -442,11 +472,11 @@ Ozone 是一个多协议文件系统,用户可以通过多种协议访问 Ozon
<div class="card-body">
<h2 class="card-title">
- Ozone 文件系统
+ Ofs (兼容 Hadoop 的文件系统)
</h2>
- <p class="card-text">Hadoop 文件系统兼容使得任何使用类 HDFS 接口的应用无需任何修改就可以在 Ozone 上工作,比如基于 Apache Spark、YARN 和 Hive 等框架的应用。</p>
- <a href="../zh/interface/o3fs.html"
- class=" btn btn-primary btn-lg">Ozone 文件系统</a>
+ <p class="card-text">Hadoop Compatible file system allows any application that expects an HDFS like interface to work against Ozone with zero changes. Frameworks like Apache Spark, YARN and Hive work against Ozone without needing any change. <strong>Global level view.</strong></p>
+ <a href="../zh/interface/ofs.html"
+ class=" btn btn-primary btn-lg">Ofs (兼容 Hadoop 的文件系统)</a>
</div>
</div>
</div>
@@ -460,6 +490,25 @@ Ozone 是一个多协议文件系统,用户可以通过多种协议访问 Ozon
<div class="row">
+ <div class="col-sm-6">
+ <div class="card">
+ <div class="card-body">
+ <h2 class="card-title">
+
+ Ozone 文件系统
+ </h2>
+ <p class="card-text">Hadoop 文件系统兼容使得任何使用类 HDFS 接口的应用无需任何修改就可以在 Ozone 上工作,比如基于 Apache Spark、YARN 和 Hive 等框架的应用。</p>
+ <a href="../zh/interface/o3fs.html"
+ class=" btn btn-primary btn-lg">Ozone 文件系统</a>
+ </div>
+ </div>
+ </div>
+
+
+
+
+
+
<div class="col-sm-6">
<div class="card">
<div class="card-body">
@@ -475,10 +524,14 @@ Ozone 是一个多协议文件系统,用户可以通过多种协议访问 Ozon
</div>
+ </div>
+
+ <div class="row">
+
<div class="col-sm-6">
<div class="card">
<div class="card-body">
@@ -494,14 +547,10 @@ Ozone 是一个多协议文件系统,用户可以通过多种协议访问 Ozon
</div>
- </div>
-
- <div class="row">
-
<div class="col-sm-6">
<div class="card">
<div class="card-body">
@@ -517,6 +566,39 @@ Ozone 是一个多协议文件系统,用户可以通过多种协议访问 Ozon
</div>
+ </div>
+
+
+
+
+
+ <div class="row">
+
+ <div class="col-sm-6">
+ <div class="card">
+ <div class="card-body">
+ <h2 class="card-title">
+
+ 命令行接口
+ </h2>
+ <p class="card-text">Ozone shell 是从命令行与 Ozone 交互的主要接口。在后台,它调用 Java API.
+有些功能只能通过使用 ozone sh 命令才能访问。例如:
+ 创建带有配额的卷 管理内部 ACL 创建带有加密的键的桶 所有这些命令都是一次性的管理任务。应用程序也可以使用其他接口,如 Hadoop 兼容文件系统(o3fs 或 ofs)或 S3 接口来实现相同功能而无需使用 Ozone 命令行接口。
+Ozone shell 的帮助菜单可以在 对象 级别 或者 动作 级别被调出.
+示例命令:
+ozone sh volume --help 这条命令展示了卷的所有可用的 动作 命令
+或者也可以用来解释具体的某个 动作 ,例如:
+ozone sh volume create --help 这条命令输出卷的create动作的所有命令行选项
+通用命令格式 Ozone shell 命令采取以下形式:
+ ozone sh object action url
+ ozone 脚本用于调用所有 Ozone 子命令。通过 sh 命令调用 ozone shell 命令。</p>
+ <a href="../zh/interface/cli.html"
+ class=" btn btn-primary btn-lg">命令行接口</a>
+ </div>
+ </div>
+ </div>
+
+
</div>
@@ -531,7 +613,7 @@ Ozone 是一个多协议文件系统,用户可以通过多种协议访问 Ozon
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 5, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/e34de9fbdbb7c78a5a415d8fe234f0db408fad61">e34de9fbdb</a>
</span>
</div>
</footer>
diff --git a/docs/edge/interface/cli.html b/docs/edge/zh/interface/cli.html
similarity index 69%
copy from docs/edge/interface/cli.html
copy to docs/edge/zh/interface/cli.html
index fbeffaa7..a24e4772 100644
--- a/docs/edge/interface/cli.html
+++ b/docs/edge/zh/interface/cli.html
@@ -12,14 +12,14 @@
<title>Documentation for Apache Ozone</title>
- <link href="../css/bootstrap.min.css" rel="stylesheet">
+ <link href="../../css/bootstrap.min.css" rel="stylesheet">
- <link href="../css/ozonedoc.css" rel="stylesheet">
+ <link href="../../css/ozonedoc.css" rel="stylesheet">
- <link href="../swagger-resources/swagger-ui.css" rel="stylesheet">
+ <link href="../../swagger-resources/swagger-ui.css" rel="stylesheet">
<script>
@@ -58,10 +58,10 @@ s=d.getElementsByTagName('script')[0];
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
- <a href="../index.html" class="navbar-left ozone-logo">
- <img src="../ozone-logo-small.png"/>
+ <a href="../../zh/index.html" class="navbar-left ozone-logo">
+ <img src="../../ozone-logo-small.png"/>
</a>
- <a class="navbar-brand hidden-xs" href="../index.html">
+ <a class="navbar-brand hidden-xs" href="../../zh/index.html">
Apache Ozone/HDDS Documentation
</a>
<a class="navbar-brand visible-xs-inline" href="#">Apache Ozone</a>
@@ -88,11 +88,11 @@ s=d.getElementsByTagName('script')[0];
<li class="">
- <a href="../index.html">
+ <a href="../../zh/index.html">
- <span>Overview</span>
+ <span>概述</span>
</a>
</li>
@@ -100,56 +100,56 @@ s=d.getElementsByTagName('script')[0];
<li class="">
- <a href="../start.html">
+ <a href="../../zh/start.html">
- <span>Getting Started</span>
+ <span>快速入门</span>
</a>
</li>
<li class="">
- <a href="../concept.html">
+ <a href="../../zh/concept.html">
- <span>Architecture</span>
+ <span>概念</span>
</a>
<ul class="nav">
<li class="">
- <a href="../concept/overview.html">Overview</a>
+ <a href="../../zh/concept/overview.html">概览</a>
</li>
<li class="">
- <a href="../concept/ozonemanager.html">Ozone Manager</a>
+ <a href="../../zh/concept/ozonemanager.html">Ozone Manager</a>
</li>
<li class="">
- <a href="../concept/storagecontainermanager.html">Storage Container Manager</a>
+ <a href="../../zh/concept/storagecontainermanager.html">Storage Container Manager</a>
</li>
<li class="">
- <a href="../concept/containers.html">Containers</a>
+ <a href="../../zh/concept/datanodes.html">数据节点</a>
</li>
<li class="">
- <a href="../concept/datanodes.html">Datanodes</a>
+ <a href="../../zh/concept/containers.html">Containers</a>
</li>
<li class="">
- <a href="../concept/recon.html">Recon</a>
+ <a href="../../zh/concept/recon.html">Recon</a>
</li>
@@ -159,117 +159,69 @@ s=d.getElementsByTagName('script')[0];
<li class="">
- <a href="../feature.html">
+ <a href="../../zh/feature.html">
- <span>Features</span>
+ <span>特性</span>
</a>
<ul class="nav">
<li class="">
- <a href="../feature/decommission.html">Decommissioning</a>
+ <a href="../../zh/feature/decommission.html">Decommissioning</a>
</li>
<li class="">
- <a href="../feature/om-ha.html">OM High Availability</a>
+ <a href="../../zh/feature/erasurecoding.html">纠删码</a>
</li>
<li class="">
- <a href="../feature/erasurecoding.html">Ozone Erasure Coding</a>
+ <a href="../../zh/feature/om-ha.html">高可用 OM</a>
</li>
<li class="">
- <a href="../feature/snapshot.html">Ozone Snapshot</a>
+ <a href="../../zh/feature/scm-ha.html">高可用 SCM</a>
</li>
<li class="">
- <a href="../feature/scm-ha.html">SCM High Availability</a>
+ <a href="../../zh/feature/dn-merge-rocksdb.html">在DataNode上合并Container的RocksDB</a>
</li>
<li class="">
- <a href="../feature/streaming-write-pipeline.html">Streaming Write Pipeline</a>
+ <a href="../../zh/feature/prefixfso.html">基于前缀的文件系统优化</a>
</li>
<li class="">
- <a href="../feature/dn-merge-rocksdb.html">Merge Container RocksDB in DN</a>
+ <a href="../../zh/feature/topology.html">拓扑感知能力</a>
</li>
<li class="">
- <a href="../feature/prefixfso.html">Prefix based File System Optimization</a>
+ <a href="../../zh/feature/quota.html">Ozone 中的配额</a>
</li>
<li class="">
- <a href="../feature/topology.html">Topology awareness</a>
+ <a href="../../zh/feature/recon.html">Recon 服务器</a>
</li>
<li class="">
- <a href="../feature/quota.html">Quota in Ozone</a>
-
- </li>
-
- <li class="">
-
- <a href="../feature/recon.html">Recon Server</a>
-
- </li>
-
- <li class="">
-
- <a href="../feature/observability.html">Observability</a>
-
- </li>
-
- <li class="">
-
- <a href="../feature/nonrolling-upgrade.html">Non-Rolling Upgrades and Downgrades</a>
-
- </li>
-
- <li class="">
-
- <a href="../feature/s3-multi-tenancy.html">
-
- <span>S3 Multi-Tenancy</span>
- </a>
- <ul class="nav">
-
- <li class="">
- <a href="../feature/s3-multi-tenancy-setup.html">Setup</a>
- </li>
-
- <li class="">
- <a href="../feature/s3-tenant-commands.html">Tenant commands</a>
- </li>
-
- <li class="">
- <a href="../feature/s3-multi-tenancy-access-control.html">Access Control</a>
- </li>
-
- </ul>
-
- </li>
-
- <li class="">
-
- <a href="../feature/reconfigurability.html">Reconfigurability</a>
+ <a href="../../zh/feature/reconfigurability.html">动态加载配置</a>
</li>
@@ -279,57 +231,57 @@ s=d.getElementsByTagName('script')[0];
<li class="">
- <a href="../interface.html">
+ <a href="../../zh/security.html">
- <span>Client Interfaces</span>
+ <span>安全</span>
</a>
<ul class="nav">
<li class="">
- <a href="../interface/ofs.html">Ofs (Hadoop compatible)</a>
+ <a href="../../zh/security/secureozone.html">安全化 Ozone</a>
</li>
<li class="">
- <a href="../interface/o3fs.html">O3fs (Hadoop compatible)</a>
+ <a href="../../zh/security/securingtde.html">透明数据加密</a>
</li>
<li class="">
- <a href="../interface/s3.html">S3 Protocol</a>
+ <a href="../../zh/security/gdpr.html">Ozone 中的 GDPR</a>
</li>
- <li class="active">
+ <li class="">
- <a href="../interface/cli.html">Command Line Interface</a>
+ <a href="../../zh/security/securingdatanodes.html">安全化 Datanode</a>
</li>
<li class="">
- <a href="../interface/reconapi.html">Recon API</a>
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
</li>
<li class="">
- <a href="../interface/javaapi.html">Java API</a>
+ <a href="../../zh/security/securings3.html">安全化 S3</a>
</li>
<li class="">
- <a href="../interface/csi.html">CSI Protocol</a>
+ <a href="../../zh/security/securityacls.html">Ozone 访问控制列表</a>
</li>
<li class="">
- <a href="../interface/httpfs.html">HttpFS Gateway</a>
+ <a href="../../zh/security/securitywithranger.html">Apache Ranger</a>
</li>
@@ -339,57 +291,87 @@ s=d.getElementsByTagName('script')[0];
<li class="">
- <a href="../security.html">
+ <a href="../../zh/interface.html">
- <span>Security</span>
+ <span>客户端接口</span>
</a>
<ul class="nav">
- <li class="">
+ <li class="active">
- <a href="../security/secureozone.html">Securing Ozone</a>
+ <a href="../../zh/interface/cli.html">命令行接口</a>
</li>
- <li class="">
-
- <a href="../security/securingtde.html">Transparent Data Encryption</a>
-
- </li>
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
+ </a>
+ <ul class="nav">
<li class="">
- <a href="../security/gdpr.html">GDPR in Ozone</a>
+ <a href="../../zh/interface/javaapi.html">Java API</a>
</li>
<li class="">
- <a href="../security/securingdatanodes.html">Securing Datanodes</a>
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
</li>
<li class="">
- <a href="../security/securingozonehttp.html">Securing HTTP</a>
+ <a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
</li>
<li class="">
- <a href="../security/securings3.html">Securing S3</a>
+ <a href="../../zh/interface/csi.html">CSI 协议</a>
</li>
<li class="">
- <a href="../security/securityacls.html">Ozone ACLs</a>
+ <a href="../../zh/interface/s3.html">S3 协议接口</a>
</li>
<li class="">
- <a href="../security/securitywithranger.html">Apache Ranger</a>
+ <a href="../../zh/interface/reconapi.html">Recon API</a>
</li>
@@ -397,31 +379,7 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../tools.html">
-
-
-
- <span>Tools</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../recipe.html">
-
-
-
- <span>Recipes</span>
- </a>
- </li>
-
-
- <li><a href="../design.html"><span><b>Design docs</b></span></a></li>
+ <li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
<li><a href="https://github.com/apache/ozone"><span class="glyphicon glyphicon-new-window" aria-hidden="true"></span> Source</a></li>
@@ -439,9 +397,9 @@ s=d.getElementsByTagName('script')[0];
<div class="col-md-9">
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
- <li class="breadcrumb-item"><a href="../index.html">Home</a></li>
- <li class="breadcrumb-item" aria-current="page"><a href="../interface.html">Client Interfaces</a></li>
- <li class="breadcrumb-item active" aria-current="page">Command Line Interface</li>
+ <li class="breadcrumb-item"><a href="../../zh/index.html">Home</a></li>
+ <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">客户端接口</a></li>
+ <li class="breadcrumb-item active" aria-current="page">命令行接口</li>
</ol>
</nav>
@@ -451,11 +409,16 @@ s=d.getElementsByTagName('script')[0];
+ <a href="../../interface/cli.html"><span class="label label-success">English</span></a>
+
+
+
+
</div>
<div class="col-md-9">
- <h1>Command Line Interface</h1>
+ <h1>命令行接口</h1>
<!---
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -473,48 +436,43 @@ s=d.getElementsByTagName('script')[0];
See the License for the specific language governing permissions and
limitations under the License.
-->
-<p>Ozone shell is the primary interface to interact with Ozone from the command line. Behind the scenes it uses the <a href="../interface/javaapi.html">Java API</a>.</p>
-<p>There are some functionality which couldn’t be accessed without using <code>ozone sh</code> commands. For example:</p>
+<p>Ozone shell 是从命令行与 Ozone 交互的主要接口。在后台,它调用 <a href="../../zh/interface/javaapi.html">Java API</a>.</p>
+<p>有些功能只能通过使用 <code>ozone sh</code> 命令才能访问。例如:</p>
<ol>
-<li>Creating volumes with quota</li>
-<li>Managing internal ACLs</li>
-<li>Creating buckets with encryption key</li>
+<li>创建带有配额的卷</li>
+<li>管理内部 ACL</li>
+<li>创建带有加密的键的桶</li>
</ol>
-<p>All of these are one-time, administration tasks. Applications can use Ozone without this CLI using other interface like Hadoop Compatible File System (o3fs or ofs) or S3 interface.</p>
-<p>Ozone shell help can be invoked at <em>object</em> level or at <em>action</em> level.</p>
-<p>For example:</p>
+<p>所有这些命令都是一次性的管理任务。应用程序也可以使用其他接口,如 Hadoop 兼容文件系统(o3fs 或 ofs)或 S3 接口来实现相同功能而无需使用 Ozone 命令行接口。</p>
+<p>Ozone shell 的帮助菜单可以在 <em>对象</em> 级别 或者 <em>动作</em> 级别被调出.</p>
+<p>示例命令:</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">ozone sh volume --help
-</code></pre></div><p>will show all possible actions for volumes.</p>
-<p>Or it can be invoked to explain a specific action like:</p>
+</code></pre></div><p>这条命令展示了卷的所有可用的 <em>动作</em> 命令</p>
+<p>或者也可以用来解释具体的某个 <em>动作</em> ,例如:</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">ozone sh volume create --help
-</code></pre></div><p>which will print the command line options of the <code>create</code> command for volumes.</p>
-<h2 id="general-command-format">General Command Format</h2>
-<p>Ozone shell commands take the following form:</p>
+</code></pre></div><p>这条命令输出卷的<code>create</code>动作的所有命令行选项</p>
+<h2 id="通用命令格式">通用命令格式</h2>
+<p>Ozone shell 命令采取以下形式:</p>
<blockquote>
<p><em>ozone sh object action url</em></p>
</blockquote>
-<p><strong>ozone</strong> script is used to invoke all Ozone sub-commands. The ozone shell is
-invoked via <code>sh</code> command.</p>
-<p>Object can be volume, bucket or key. Actions are various verbs like
-create, list, delete etc.</p>
-<p>Depending on the action, Ozone URL can point to a volume, bucket or key in the following format:</p>
+<p><strong>ozone</strong> 脚本用于调用所有 Ozone 子命令。通过 <code>sh</code> 命令调用 ozone shell 命令。</p>
+<p>对象可以是卷、桶或键。动作可以是创建、列出、删除等。</p>
+<p>根据动作,Ozone URL 可以指向以下格式的卷、桶或键:</p>
<p><em>[schema][server:port]/volume/bucket/key</em></p>
-<p>Where,</p>
+<p>其中,</p>
<ol>
<li>
-<p><strong>Schema</strong> - This should be <code>o3</code> which is the native RPC protocol to access
-Ozone API. The usage of the schema is optional.</p>
+<p><strong>Schema</strong> - 应为 <code>o3</code>,这是访问 Ozone API 的原生 RPC 协议。是否指定 schema 是可选的。</p>
</li>
<li>
-<p><strong>Server:Port</strong> - This is the address of the Ozone Manager. If the port is
-omitted the default port from ozone-site.xml will be used.</p>
+<p><strong>Server:Port</strong> - 应为 Ozone Manager 的地址。如果不指定端口,则将使用 ozone-site.xml 中的默认端口。</p>
</li>
</ol>
-<p>Please see volume commands, bucket commands, and key commands section for more
-detail.</p>
-<h2 id="volume-operations">Volume operations</h2>
-<p>Volume is the top level element of the hierarchy, managed only by administrators. Optionally, quota and the owner user can be specified.</p>
-<p>Example commands:</p>
+<p>请查看卷命令、桶命令和键命令部分了解更多详情。</p>
+<h2 id="卷操作">卷操作</h2>
+<p>卷位于层次结构的顶层,仅由管理员管理。也可以指定所有者用户和配额。</p>
+<p>示例命令:</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh volume create /vol1
</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh volume info /vol1
<span style="color:#f92672">{</span>
@@ -560,20 +518,19 @@ detail.</p>
<span style="color:#f92672">}</span>, <span style="color:#f92672">{</span>
....
<span style="color:#f92672">}</span> <span style="color:#f92672">]</span>
-</code></pre></div><p>If the volume is empty, we can delete the volume using the command below.</p>
+</code></pre></div><p>如果卷为空,我们可以使用以下命令删除卷。</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh volume delete /vol1
Volume vol1 is deleted
-</code></pre></div><p>If the volume contains any buckets or keys, we can delete the volume recursively. This will delete all keys and buckets within the volume, and then delete the volume itself.
-After running this command there is no way to recover deleted contents.</p>
+</code></pre></div><p>如果卷包含任意桶或键,我们可以递归地删除卷。这将删除卷中所有的桶和键,然后删除卷本身。在运行这个命令后,将无法恢复已删除的内容。</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh volume delete -r /vol1
This command will delete volume recursively.
There is no recovery option after using this command, and no trash <span style="color:#66d9ef">for</span> FSO buckets.
Delay is expected running this command.
Enter <span style="color:#e6db74">'yes'</span> to proceed<span style="color:#960050;background-color:#1e0010">'</span>: yes
Volume vol1 is deleted
-</code></pre></div><h2 id="bucket-operations">Bucket operations</h2>
-<p>Bucket is the second level of the object hierarchy, and is similar to AWS S3 buckets. Users can create buckets in volumes, if they have the necessary permissions.</p>
-<p>Command examples:</p>
+</code></pre></div><h2 id="桶操作">桶操作</h2>
+<p>桶是层次结构的第二层级,与 AWS S3 桶相似。如果用户有必要的权限,可以在卷中创建桶。</p>
+<p>示例命令:</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh bucket create /vol1/bucket1
</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh bucket info /vol1/bucket1
<span style="color:#f92672">{</span>
@@ -588,22 +545,21 @@ Volume vol1 is deleted
<span style="color:#e6db74">"sourceVolume"</span> : null,
<span style="color:#e6db74">"sourceBucket"</span> : null
<span style="color:#f92672">}</span>
-</code></pre></div><p>If the bucket is empty we can delete the bucket using the command below.</p>
+</code></pre></div><p>如果桶是空的,我们可以用以下命令来删除桶。</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh bucket delete /vol1/bucket1
Bucket bucket1 is deleted
-</code></pre></div><p>If the bucket contains any keys, we can delete the bucket recursively. This will delete all the keys within the bucket, and then the bucket itself.
-After running this command there is no way to recover deleted contents.</p>
+</code></pre></div><p>如果桶包含任意键,我们可以递归地删除桶。这将删除桶中的所有键,然后删除桶本身。在运行这个命令后,将无法恢复已删除的内容。</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh bucket delete -r /vol1/bucket1
This command will delete bucket recursively.
There is no recovery option after using this command, and deleted keys won<span style="color:#e6db74">'t move to trash.
</span><span style="color:#e6db74">Enter '</span>yes<span style="color:#e6db74">' to proceed'</span>: yes
Bucket bucket1 is deleted
-</code></pre></div><p><a href="../security/securingtde.html">Transparent Data Encryption</a> can be enabled at the bucket level.</p>
-<h2 id="key-operations">Key operations</h2>
-<p>Key is the object which can store the data.</p>
+</code></pre></div><p><a href="../../zh/security/securingtde.html">透明数据加密</a> 可以在桶层级被启用。</p>
+<h2 id="键操作">键操作</h2>
+<p>键是可以存储数据的对象。</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh key put /vol1/bucket1/README.md README.md
</code></pre></div><div class="alert alert-warning" role="alert">
-<p>In this case the standard <code>ozone sh <object_type> <action> <url></code> scheme may be a bit confusing at first, as it results in the syntax <code>ozone sh key put <destination> <source></code> instead of the arguably more natural order of <code><source> <destination></code>.</p>
+<p>在这个命令中,标准的命令顺序 <code>ozone sh <object_type> <action> <url></code> 可能会让使用者困惑, 因为它的格式是 <code>ozone sh key put <destination> <source></code>, 而不是我们习惯的自然的顺序 <code><source> <destination></code>.</p>
</div>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh key info /vol1/bucket1/README.md
<span style="color:#f92672">{</span>
@@ -626,14 +582,14 @@ Bucket bucket1 is deleted
<span style="color:#f92672">}</span>
</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh key get /vol1/bucket1/README.md /tmp/
</code></pre></div><div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh key delete /vol1/bucket1/key1
-</code></pre></div><p>If the key is in an <a href="../feature/prefixfso.html">FSO</a> bucket it will be moved to the trash when deleted. Below is the trash location:</p>
+</code></pre></div><p>如果键是在 <a href="../../zh/feature/prefixfso.html">FSO</a> 桶中,当删除键时它会被移动到回收站,回收站的位置是:</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ /<volume>/<bucket>/.Trash/<user>
-</code></pre></div><p>If the key is in an OBS bucket it will be permanently deleted.</p>
-<h2 id="querying-cli-results">Querying CLI Results</h2>
-<p>Ozone CLI returns JSON responses. <a href="https://stedolan.github.io/jq/manual/">jq</a> is a command line JSON processor that can be used to filter CLI output for desired information.</p>
-<p>For example:</p>
+</code></pre></div><p>如果键是在OBS桶中,它将被永久删除。</p>
+<h2 id="查询命令行结果">查询命令行结果</h2>
+<p>Ozone命令行返回JSON响应。<a href="https://stedolan.github.io/jq/manual/">jq</a> 是一个命令行JSON处理器,可以用来过滤CLI结果以获取所需信息.</p>
+<p>示例命令:</p>
<ul>
-<li>List FSO buckets that are not links.</li>
+<li>列出不是链接的 FSO 桶。</li>
</ul>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh bucket list /s3v | jq <span style="color:#e6db74">'.[] | select(.link==false and .bucketLayout=="FILE_SYSTEM_OPTIMIZED")'</span>
<span style="color:#f92672">{</span>
@@ -653,7 +609,7 @@ Bucket bucket1 is deleted
<span style="color:#e6db74">"link"</span>: false
<span style="color:#f92672">}</span>
</code></pre></div><ul>
-<li>List EC buckets with their replication config.</li>
+<li>列出 EC 桶以及它们的复制策略配置。</li>
</ul>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">$ ozone sh bucket list /vol1 | jq -r <span style="color:#e6db74">'.[] | select(.replicationConfig.replicationType == "EC") | {"name": .name, "replicationConfig": .replicationConfig}'</span>
<span style="color:#f92672">{</span>
@@ -679,7 +635,7 @@ Bucket bucket1 is deleted
<span style="color:#f92672">}</span>
<span style="color:#f92672">}</span>
</code></pre></div><ul>
-<li>List names of encrypted buckets and their encryption key names in tab-separated-value format.</li>
+<li>以制表符分隔的格式列出加密桶的名字以及它们的加密的键名。</li>
</ul>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">
$ ozone sh bucket list /vol1 | jq -r <span style="color:#e6db74">'.[] | select(.encryptionKeyName != null) | [.name, .encryptionKeyName] | @tsv'</span>
@@ -688,8 +644,6 @@ encrypted-bucket key1
</code></pre></div>
- <a class="btn btn-success btn-lg" href="../interface/reconapi.html">Next >></a>
-
</div>
</div>
@@ -704,16 +658,16 @@ encrypted-bucket key1
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 5, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/e34de9fbdbb7c78a5a415d8fe234f0db408fad61">e34de9fbdb</a>
</span>
</div>
</footer>
-<script src="../js/jquery-3.5.1.min.js"></script>
-<script src="../js/ozonedoc.js"></script>
-<script src="../js/bootstrap.min.js"></script>
+<script src="../../js/jquery-3.5.1.min.js"></script>
+<script src="../../js/ozonedoc.js"></script>
+<script src="../../js/bootstrap.min.js"></script>
</body>
diff --git a/docs/edge/zh/interface/csi.html b/docs/edge/zh/interface/csi.html
index 0013c458..d26be941 100644
--- a/docs/edge/zh/interface/csi.html
+++ b/docs/edge/zh/interface/csi.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -368,7 +398,7 @@ s=d.getElementsByTagName('script')[0];
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="../../zh/index.html">Home</a></li>
- <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">编程接口</a></li>
+ <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">客户端接口</a></li>
<li class="breadcrumb-item active" aria-current="page">CSI 协议</li>
</ol>
</nav>
@@ -466,7 +496,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 7, 2021 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/c5a92a20614f22f2c37d599a2ae15ee59c0ecfa9">c5a92a2061</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/interface/index.xml b/docs/edge/zh/interface/index.xml
index 7d711b21..95a8044b 100644
--- a/docs/edge/zh/interface/index.xml
+++ b/docs/edge/zh/interface/index.xml
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
<channel>
- <title>编程接口 on Ozone</title>
+ <title>客户端接口 on Ozone</title>
<link>/zh/interface.html</link>
- <description>Recent content in 编程接口 on Ozone</description>
+ <description>Recent content in 客户端接口 on Ozone</description>
<generator>Hugo -- gohugo.io</generator>
<language>en-us</language><atom:link href="/zh/interface/index.xml" rel="self" type="application/rss+xml" />
<item>
@@ -15,6 +15,15 @@
<description>Ozone 有一套基于原生 RPC 的 API,其它协议都由这个最底层的 API 扩展而来,它也是所有 Ozone 支持的协议中性能最好、功能最全的。</description>
</item>
+ <item>
+ <title>Ofs (兼容 Hadoop 的文件系统)</title>
+ <link>/zh/interface/ofs.html</link>
+ <pubDate>Thu, 14 Sep 2017 00:00:00 +0000</pubDate>
+
+ <guid>/zh/interface/ofs.html</guid>
+ <description>Hadoop Compatible file system allows any application that expects an HDFS like interface to work against Ozone with zero changes. Frameworks like Apache Spark, YARN and Hive work against Ozone without needing any change. <strong>Global level view.</strong></description>
+ </item>
+
<item>
<title>Ozone 文件系统</title>
<link>/zh/interface/o3fs.html</link>
@@ -51,5 +60,24 @@
<description>Recon 服务器支持 HTTP 端点,以帮助故障排除和监听 Ozone 集群。</description>
</item>
+ <item>
+ <title>命令行接口</title>
+ <link>/zh/interface/cli.html</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/zh/interface/cli.html</guid>
+ <description>Ozone shell 是从命令行与 Ozone 交互的主要接口。在后台,它调用 Java API.
+有些功能只能通过使用 ozone sh 命令才能访问。例如:
+ 创建带有配额的卷 管理内部 ACL 创建带有加密的键的桶 所有这些命令都是一次性的管理任务。应用程序也可以使用其他接口,如 Hadoop 兼容文件系统(o3fs 或 ofs)或 S3 接口来实现相同功能而无需使用 Ozone 命令行接口。
+Ozone shell 的帮助菜单可以在 对象 级别 或者 动作 级别被调出.
+示例命令:
+ozone sh volume --help 这条命令展示了卷的所有可用的 动作 命令
+或者也可以用来解释具体的某个 动作 ,例如:
+ozone sh volume create --help 这条命令输出卷的create动作的所有命令行选项
+通用命令格式 Ozone shell 命令采取以下形式:
+ ozone sh object action url
+ ozone 脚本用于调用所有 Ozone 子命令。通过 sh 命令调用 ozone shell 命令。</description>
+ </item>
+
</channel>
</rss>
diff --git a/docs/edge/zh/interface/javaapi.html b/docs/edge/zh/interface/javaapi.html
index 5ad2a4ba..77366590 100644
--- a/docs/edge/zh/interface/javaapi.html
+++ b/docs/edge/zh/interface/javaapi.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -368,7 +398,7 @@ s=d.getElementsByTagName('script')[0];
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="../../zh/index.html">Home</a></li>
- <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">编程接口</a></li>
+ <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">客户端接口</a></li>
<li class="breadcrumb-item active" aria-current="page">Java API</li>
</ol>
</nav>
@@ -497,7 +527,7 @@ introStream<span style="color:#f92672">.</span><span style="color:#a6e22e">read<
- <a class="btn btn-success btn-lg" href="../../zh/interface/o3fs.html">Next >></a>
+ <a class="btn btn-success btn-lg" href="../../zh/interface/ofs.html">Next >></a>
</div>
@@ -513,7 +543,7 @@ introStream<span style="color:#f92672">.</span><span style="color:#a6e22e">read<
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: October 5, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/19cb481896f091ec5c02fe4010a5ab428302f38f">19cb481896</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/interface/o3fs.html b/docs/edge/zh/interface/o3fs.html
index 6ba439e6..78ac1a64 100644
--- a/docs/edge/zh/interface/o3fs.html
+++ b/docs/edge/zh/interface/o3fs.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="active">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -368,7 +398,7 @@ s=d.getElementsByTagName('script')[0];
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="../../zh/index.html">Home</a></li>
- <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">编程接口</a></li>
+ <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">客户端接口</a></li>
<li class="breadcrumb-item active" aria-current="page">Ozone 文件系统</li>
</ol>
</nav>
@@ -496,7 +526,7 @@ hdfs dfs -mkdir /volume1/bucket1</code></pre></div>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: February 28, 2022 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/898ccbb46fd52b19030758da3d97b621ae709e0e">898ccbb46f</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/interface/o3fs.html b/docs/edge/zh/interface/ofs.html
similarity index 60%
copy from docs/edge/zh/interface/o3fs.html
copy to docs/edge/zh/interface/ofs.html
index 6ba439e6..f67a56f4 100644
--- a/docs/edge/zh/interface/o3fs.html
+++ b/docs/edge/zh/interface/ofs.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -299,6 +347,12 @@ s=d.getElementsByTagName('script')[0];
<li class="active">
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
+ <li class="">
+
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
</li>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -368,8 +398,8 @@ s=d.getElementsByTagName('script')[0];
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="../../zh/index.html">Home</a></li>
- <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">编程接口</a></li>
- <li class="breadcrumb-item active" aria-current="page">Ozone 文件系统</li>
+ <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">客户端接口</a></li>
+ <li class="breadcrumb-item active" aria-current="page">Ofs (兼容 Hadoop 的文件系统)</li>
</ol>
</nav>
@@ -379,7 +409,7 @@ s=d.getElementsByTagName('script')[0];
- <a href="../../interface/o3fs.html"><span class="label label-success">English</span></a>
+ <a href="../../interface/ofs.html"><span class="label label-success">English</span></a>
@@ -388,7 +418,7 @@ s=d.getElementsByTagName('script')[0];
<div class="col-md-9">
- <h1>Ozone 文件系统</h1>
+ <h1>Ofs (兼容 Hadoop 的文件系统)</h1>
<!---
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -406,57 +436,27 @@ s=d.getElementsByTagName('script')[0];
See the License for the specific language governing permissions and
limitations under the License.
-->
-<div class="alert alert-warning">
-<p>注意:本页面翻译的信息可能滞后,最新的信息请参看英文版的相关页面。</p>
-</div>
-<p>Hadoop 的文件系统接口兼容可以让任意像 Ozone 这样的存储后端轻松地整合进 Hadoop 生态系统,Ozone 文件系统就是一个兼容 Hadoop 的文件系统。
-目前ozone支持两种协议: o3fs和ofs。两者最大的区别是o3fs只支持在单个bucket上操作,而ofs则支持跨所有volume和bucket的操作。关于两者在操作上的具体区别请参考<a href="../../interface/ofs.html">OFS(英文页面)</a>中的"Differences from o3fs"。</p>
-<h2 id="o3fs的配置及使用">o3fs的配置及使用</h2>
-<p>要创建一个 ozone 文件系统,我们需要先为它选择一个用来存放数据的桶,这个桶会被用作 Ozone 文件系统的后端存储,所有的文件和目录都存储为这个桶中的键。</p>
-<p>如果你还没有可用的卷和桶的话,请使用下面的命令创建:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">ozone sh volume create /volume
-ozone sh bucket create /volume/bucket</code></pre></div>
-<p>创建之后,请使用 <em>list volume</em> 或 <em>list bucket</em> 命令来确认桶已存在。</p>
-<p>请在 core-site.xml 中添加以下条目:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><property></span>
- <span style="color:#f92672"><name></span>fs.AbstractFileSystem.o3fs.impl<span style="color:#f92672"></name></span>
- <span style="color:#f92672"><value></span>org.apache.hadoop.fs.ozone.OzFs<span style="color:#f92672"></value></span>
-<span style="color:#f92672"></property></span>
-<span style="color:#f92672"><property></span>
- <span style="color:#f92672"><name></span>fs.defaultFS<span style="color:#f92672"></name></span>
- <span style="color:#f92672"><value></span>o3fs://bucket.volume<span style="color:#f92672"></value></span>
-<span style="color:#f92672"></property></span></code></pre></div>
+<p>兼容 Hadoop 的文件系统 (HCFS) 接口允许像 Ozone 这样的存储后端轻松集成到 Hadoop 生态系统中。Ozone 文件系统 (OFS) 是一个兼容 Hadoop 的文件系统。</p>
<div class="alert alert-warning" role="alert">
-<p>提示: 对于 <a href="../../zh/feature/om-ha.html">OM HA</a> 集群,需要指定 ozone service id。例如,
-如果 <code>ozone.om.service.ids = ozone1</code>,则 URL 是 <code>o3fs://bucket.volume.ozone1</code>。
-对于非 HA,它可以是 <code>o3fs://bucket.volume</code>。</p>
+<p>目前,Ozone 支持两种协议:<code>o3fs://</code> 和 <code>ofs://</code>。
+o3fs 与 ofs 之间最大的区别在于,<code>o3fs</code> 仅支持在 <strong>单个桶</strong> 上的操作, 而 <code>ofs</code> 支持跨所有卷和桶的操作,并提供所有卷/桶的完整视图。</p>
</div>
-<p>这样会使指定的桶成为 HDFS 的 dfs 命令的默认文件系统,并且将其注册为了 o3fs 文件系统类型。</p>
-<p>你还需要将 ozone-filesystem.jar 文件加入 classpath:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">export HADOOP_CLASSPATH<span style="color:#f92672">=</span>/opt/ozone/share/ozone/lib/ozone-filesystem-hadoop3-*.jar:$HADOOP_CLASSPATH</code></pre></div>
-<p>(注意:当使用Hadoop 2.x时,应该在classpath上添加ozone-filesystem-hadoop2-*.jar)</p>
-<p>当配置了默认的文件系统之后,用户可以运行 ls、put、mkdir 等命令,比如:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">hdfs dfs -ls /</code></pre></div>
-<p>或</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">hdfs dfs -mkdir /users</code></pre></div>
-<p>或者 put 命令。换句话说,所有像 Hive、Spark 和 Distcp 的程序都会在这个文件系统上工作。
-请注意,在这个桶里使用 Ozone 文件系统以外的方法来进行键的创建和删除时,最终都会体现为 Ozone 文件系统中的目录和文件的创建和删除。</p>
-<p>注意:桶名和卷名不可以包含句点。
-此外,文件系统的 URI 可以由桶名和卷名后跟着 OM 主机的 FQDN 和一个可选的端口组成,比如,你可以同时指定主机和端口:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">hdfs dfs -ls o3fs://bucket.volume.om-host.example.com:5678/key</code></pre></div>
-<p>如果 URI 未指定端口,将会尝试从 <code>ozone.om.address</code> 配置中获取端口,如果 <code>ozone.om.address</code> 未配置,则使用默认端口 <code>9862</code>,比如,我们在 <code>ozone-site.xml</code> 中配置 <code>ozone.om.address</code> 如下:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"> <span style="color:#f92672"><property></span>
- <span style="color:#f92672"><name></span>ozone.om.address<span style="color:#f92672"></name></span>
- <span style="color:#f92672"><value></span>0.0.0.0:6789<span style="color:#f92672"></value></span>
- <span style="color:#f92672"></property></span></code></pre></div>
-<p>当我们运行下面的命令:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">hdfs dfs -ls o3fs://bucket.volume.om-host.example.com/key</code></pre></div>
-<p>它其实等价于:</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">hdfs dfs -ls o3fs://bucket.volume.om-host.example.com:6789/key</code></pre></div>
-<p>注意:在这种情况下,<code>ozone.om.address</code> 配置中只有端口号会被用到,主机名是被忽略的。</p>
-<h2 id="ofs的配置及使用">ofs的配置及使用</h2>
-<p>这只是一个通用的介绍。了解更详细的用法,请参考<a href="../../interface/ofs.html">OFS(英文页面)</a>。</p>
-<p>请在 core-site.xml 中添加以下条目:</p>
+<h2 id="基础知识">基础知识</h2>
+<p>有效的 OFS 路径示例:</p>
+<pre><code>ofs://om1/
+ofs://om3:9862/
+ofs://omservice/
+ofs://omservice/volume1/
+ofs://omservice/volume1/bucket1/
+ofs://omservice/volume1/bucket1/dir1
+ofs://omservice/volume1/bucket1/dir1/key1
+
+ofs://omservice/tmp/
+ofs://omservice/tmp/key1
+</code></pre><p>在 OFS 文件系统中,卷和挂载点位于根目录级别。卷的下一级是桶。每个桶下面是键和目录。</p>
+<p>请注意,对于挂载点,目前仅支持临时挂载 /tmp。</p>
+<h2 id="配置">配置</h2>
+<p>请在 <code>core-site.xml</code> 添加下列配置。</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><property></span>
<span style="color:#f92672"><name></span>fs.ofs.impl<span style="color:#f92672"></name></span>
<span style="color:#f92672"><value></span>org.apache.hadoop.fs.ozone.RootedOzoneFileSystem<span style="color:#f92672"></value></span>
@@ -465,22 +465,99 @@ ozone sh bucket create /volume/bucket</code></pre></div>
<span style="color:#f92672"><name></span>fs.defaultFS<span style="color:#f92672"></name></span>
<span style="color:#f92672"><value></span>ofs://om-host.example.com/<span style="color:#f92672"></value></span>
<span style="color:#f92672"></property></span></code></pre></div>
-<p>这样会使该om的所有桶和卷成为 HDFS 的 dfs 命令的默认文件系统,并且将其注册为了 ofs 文件系统类型。</p>
-<p>你还需要将 ozone-filesystem.jar 文件加入 classpath:</p>
+<p>这将使所有的卷和桶成为默认的 Hadoop 兼容文件系统,并注册 ofs 文件系统类型。</p>
+<p>您还需要将 ozone-filesystem-hadoop3.jar 文件添加到 classpath 中:</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">export HADOOP_CLASSPATH<span style="color:#f92672">=</span>/opt/ozone/share/ozone/lib/ozone-filesystem-hadoop3-*.jar:$HADOOP_CLASSPATH</code></pre></div>
-<p>(注意:当使用Hadoop 2.x时,应该在classpath上添加ozone-filesystem-hadoop2-*.jar)</p>
-<p>当配置了默认的文件系统之后,用户可以运行 ls、put、mkdir 等命令,比如:</p>
+<p>(请注意: 在 Hadoop 2.x 中, 请使用 <code>ozone-filesystem-hadoop2-*.jar</code>)</p>
+<p>当默认的文件系统被建立,用户可以运行命令例如ls,put,mkdir等。
+例如:</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">hdfs dfs -ls /</code></pre></div>
-<p>需要注意的是ofs能够作用于所有的桶和卷之上,用户可以使用mkdir自行创建桶和卷,比如创建卷volume1和桶bucket1。</p>
+<p>请注意,ofs 对所有桶和卷都有效。用户可以使用 mkdir 创建桶和卷,例如创建名为 volume1 的卷和名为 bucket1 的桶</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">hdfs dfs -mkdir /volume1
hdfs dfs -mkdir /volume1/bucket1</code></pre></div>
-<p>或者用 put 命令向对应的桶写入文件。</p>
+<p>或者使用 put 命令向桶中写入一个文件</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">hdfs dfs -put /etc/hosts /volume1/bucket1/test</code></pre></div>
-<p>更多用法可以参考: <a href="https://issues.apache.org/jira/secure/attachment/12987636/Design%20ofs%20v1.pdf">https://issues.apache.org/jira/secure/attachment/12987636/Design%20ofs%20v1.pdf</a></p>
+<p>有关更多用法,请参见: <a href="https://issues.apache.org/jira/secure/attachment/12987636/Design%20ofs%20v1.pdf">https://issues.apache.org/jira/secure/attachment/12987636/Design%20ofs%20v1.pdf</a></p>
+<h2 id="与-o3fshahahugoshortcode-s5-hbhb-的区别">与 <a href="../../zh/interface/o3fs.html">o3fs</a> 的区别</h2>
+<h3 id="创建文件">创建文件</h3>
+<p>OFS 不允许直接在根目录或卷下创建键(文件)。
+当用户尝试这样做时,他们将收到一个错误消息:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone fs -touch /volume1/key1
+touch: Cannot create file under root or volume.
+</code></pre></div><h3 id="简化-fsdefaultfs">简化 fs.defaultFS</h3>
+<p>使用 OFS 时,fs.defaultFS(在 core-site.xml 中)不再需要像 o3fs 那样在其路径中具有特定的卷和桶。
+只需设置 OM 主机名或 service ID(在 HA 的情况下):</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><property></span>
+ <span style="color:#f92672"><name></span>fs.defaultFS<span style="color:#f92672"></name></span>
+ <span style="color:#f92672"><value></span>ofs://omservice<span style="color:#f92672"></value></span>
+<span style="color:#f92672"></property></span>
+</code></pre></div><p>客户端将能够访问集群上的所有卷和桶,而无需指定主机名或 service ID。</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone fs -mkdir -p /volume1/bucket1
+</code></pre></div><h3 id="通过-filesystem-shell-直接管理卷和桶">通过 FileSystem shell 直接管理卷和桶</h3>
+<p>管理员可以通过 Hadoop FS shell 轻松创建和删除卷和桶。卷和桶被视为类似于目录,因此如果它们不存在,可以使用 <code>-p</code> 创建:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone fs -mkdir -p ofs://omservice/volume1/bucket1/dir1/
+</code></pre></div><p>请注意,卷和桶名称字符集规则仍然适用。例如,桶和卷名称不接受下划线(<code>_</code>):</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone fs -mkdir -p /volume_1
+mkdir: Bucket or Volume name has an unsupported character : _
+</code></pre></div><h2 id="挂载点和设置-tmp">挂载点和设置 /tmp</h2>
+<p>为了与使用 /tmp/ 的传统 Hadoop 应用程序兼容,我们在 FS 的根目录有一个特殊的临时目录挂载点。
+这个功能将来可能会扩展,以支持自定义挂载路径。</p>
+<p>目前 Ozone 支持两种 /tmp 的配置。第一种(默认)是每个用户的临时目录,
+由一个挂载卷和一个用户特定的临时桶组成。第二种(通过 ozone-site.xml 配置)
+是一个类似粘滞位的临时目录,对所有用户共用,由一个挂载卷和一个共用的临时桶组成。</p>
+<p>重要提示:要使用它,首先,<strong>管理员</strong> 需要创建名为 tmp 的卷(卷名目前是硬编码的)并将其 ACL 设置为 world ALL 访问权限。</p>
+<p>具体来说:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone sh volume create tmp
+$ ozone sh volume setacl tmp -al world::a
+</code></pre></div><p>每个集群中这些命令<strong>仅需要执行一次</strong></p>
+<h3 id="对于每个用户的-tmp-目录-默认">对于每个用户的 /tmp 目录 (默认)</h3>
+<p><strong>每个用户</strong> 都需要先创建并初始化他们自己的 temp 桶一次</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone fs -mkdir /tmp
+2020-06-04 00:00:00,050 <span style="color:#f92672">[</span>main<span style="color:#f92672">]</span> INFO rpc.RpcClient: Creating Bucket: tmp/0238 ...
+</code></pre></div><p>在此之后用户可以向该目录写入,就和向其他常规目录写入一样。例如:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone fs -touch /tmp/key1
+</code></pre></div><h3 id="对于所有用户共享的-tmp-目录">对于所有用户共享的 /tmp 目录</h3>
+<p>要启用类似粘滞位的共享 /tmp 目录,请在 ozone-site.xml 中更新以下配置:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><property></span>
+ <span style="color:#f92672"><name></span>ozone.om.enable.ofs.shared.tmp.dir<span style="color:#f92672"></name></span>
+ <span style="color:#f92672"><value></span>true<span style="color:#f92672"></value></span>
+<span style="color:#f92672"></property></span>
+</code></pre></div><p>然后,在以<strong>管理员</strong>身份设置好 tmp 卷之后,还需要配置一个 tmp 桶,作为所有用户的共享 /tmp 目录,例如:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone sh bucket create /tmp/tmp
+$ ozone sh volume setacl tmp -a user:anyuser:rwlc <span style="color:#ae81ff">\
+</span><span style="color:#ae81ff"></span> user:adminuser:a,group:anyuser:rwlc,group:adminuser:a tmp/tmp
+</code></pre></div><p>在这里,anyuser 是管理员希望授予访问权限的用户名,而 adminuser 是管理员的用户名。</p>
+<p>然后用户可以访问 tmp 目录:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone fs -put ./NOTICE.txt ofs://om/tmp/key1
+</code></pre></div><h2 id="启用回收站的删除操作">启用回收站的删除操作</h2>
+<p>为了在 Ozone 中启用回收站,请将这些配置添加到 core-site.xml:</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><property></span>
+ <span style="color:#f92672"><name></span>fs.trash.interval<span style="color:#f92672"></name></span>
+ <span style="color:#f92672"><value></span>10<span style="color:#f92672"></value></span>
+<span style="color:#f92672"></property></span>
+<span style="color:#f92672"><property></span>
+ <span style="color:#f92672"><name></span>fs.trash.classname<span style="color:#f92672"></name></span>
+ <span style="color:#f92672"><value></span>org.apache.hadoop.ozone.om.TrashPolicyOzone<span style="color:#f92672"></value></span>
+<span style="color:#f92672"></property></span></code></pre></div>
+<p>当启用回收站功能后删除键时,这些键会被移动到每个桶下的一个回收站目录中,因为在 Ozone 中不允许将键在桶之间移动(重命名)。</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ozone fs -rm /volume1/bucket1/key1
+2020-06-04 00:00:00,100 <span style="color:#f92672">[</span>main<span style="color:#f92672">]</span> INFO fs.TrashPolicyDefault: Moved: <span style="color:#e6db74">'ofs://id1/volume1/bucket1/key1'</span> to trash at: ofs://id1/volume1/bucket1/.Trash/hadoop/Current/volume1/bucket1/key1
+</code></pre></div><p>这与 HDFS encryption zone 处理回收站位置的方式非常相似。</p>
+<p><strong>请注意</strong></p>
+<ol>
+<li>可以使用标志 <code>-skipTrash</code> 来永久删除文件,而不将其移动到回收站。</li>
+<li>启用回收站时,不允许在桶或卷级别进行删除操作。在这种情况下,必须使用 skipTrash。
+即,不使用 skipTrash 的情况下,不允许使用 <code>ozone fs -rm -R ofs://vol1/bucket1</code> 或 <code>ozone fs -rm -R o3fs://bucket1.vol1</code> 进行操作。</li>
+</ol>
+<h2 id="递归地列出">递归地列出</h2>
+<p>OFS 支持递归地列出卷、桶和键。</p>
+<p>例如,如果启用了 ACL 的话, 命令 <code>ozone fs -ls -R ofs://omservice/</code> 会递归地列出用户有 LIST 权限的所有卷、桶和键。
+如果禁用了 ACL,这个命令会列出该集群上的所有内容。</p>
+<p>这个功能不会降低服务器性能,因为循环操作是在客户端上进行的。可以将其视为客户端向服务器发出多个请求以获取所有信息的过程。</p>
- <a class="btn btn-success btn-lg" href="../../zh/interface/csi.html">Next >></a>
+ <a class="btn btn-success btn-lg" href="../../zh/interface/o3fs.html">Next >></a>
</div>
@@ -496,7 +573,7 @@ hdfs dfs -mkdir /volume1/bucket1</code></pre></div>
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 10, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/56284239533d01e4661408e273b4e4f6495ee246">5628423953</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/interface/reconapi.html b/docs/edge/zh/interface/reconapi.html
index dc6a0085..ccf76d5b 100644
--- a/docs/edge/zh/interface/reconapi.html
+++ b/docs/edge/zh/interface/reconapi.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -368,7 +398,7 @@ s=d.getElementsByTagName('script')[0];
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="../../zh/index.html">Home</a></li>
- <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">编程接口</a></li>
+ <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">客户端接口</a></li>
<li class="breadcrumb-item active" aria-current="page">Recon API</li>
</ol>
</nav>
@@ -577,6 +607,419 @@ s=d.getElementsByTagName('script')[0];
<p>回传处于给定状态的容器的 UnhealthyContainerMetadata 对象。
不健康的容器状态可能为<code>MISSING</code>, <code>MIS_REPLICATED</code>, <code>UNDER_REPLICATED</code>,<code>OVER_REPLICATED</code>。
响应结构与<code>/containers/unhealthy</code>相同。</p>
+<h3 id="get-apiv1containersmismatch">GET /api/v1/containers/mismatch</h3>
+<p><strong>回传</strong></p>
+<p>回传 OM 和 SCM 之间不匹配容器的列表。</p>
+<ul>
+<li>容器存在于 OM 中,但不存在于 SCM 中。</li>
+<li>容器存在于 SCM 中,但不存在于 OM 中。</li>
+</ul>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">[
+ {
+ <span style="color:#f92672">"containerId"</span> : <span style="color:#ae81ff">1</span>,
+ <span style="color:#f92672">"numberOfKeys"</span> : <span style="color:#ae81ff">3</span>,
+ <span style="color:#f92672">"pipelines"</span> : [
+ <span style="color:#e6db74">"pipelineId"</span> <span style="color:#960050;background-color:#1e0010">:</span> <span style="color:#e6db74">"1423ghjds832403232"</span>,
+ <span style="color:#e6db74">"pipelineId"</span> <span style="color:#960050;background-color:#1e0010">:</span> <span style="color:#e6db74">"32vds94943fsdh4443"</span>,
+ <span style="color:#e6db74">"pipelineId"</span> <span style="color:#960050;background-color:#1e0010">:</span> <span style="color:#e6db74">"32vds94943fsdhs443"</span>
+ ],
+ <span style="color:#f92672">"existsAt"</span> : <span style="color:#e6db74">"OM"</span>
+ }
+ <span style="color:#960050;background-color:#1e0010">...</span>
+]
+</code></pre></div><h3 id="get-apiv1containersmismatchdeleted">GET /api/v1/containers/mismatch/deleted</h3>
+<p><strong>参数</strong></p>
+<ul>
+<li>prevKey (可选)</li>
+</ul>
+<p>返回在SCM中,给定prevKey(容器ID) 后被标记为已删除状态,且在OM中存在的容器集合,
+以便找出映射到这些已删除状态容器的键列表。例如:prevKey=5,跳过直到准确地定位到前一个容器ID。</p>
+<ul>
+<li>
+<p>limit (可选)</p>
+<p>仅返回有限数量的结果。默认限制为1000。</p>
+</li>
+</ul>
+<p><strong>回传</strong></p>
+<p>返回在SCM中已删除但在OM中存在的容器集合,以找出映射到这些已删除状态容器的键列表。</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">[
+ {
+ <span style="color:#f92672">"containerId"</span>: <span style="color:#ae81ff">2</span>,
+ <span style="color:#f92672">"numberOfKeys"</span>: <span style="color:#ae81ff">2</span>,
+ <span style="color:#f92672">"pipelines"</span>: []
+ }
+ <span style="color:#960050;background-color:#1e0010">...</span>
+]
+</code></pre></div><h3 id="get-apiv1keysopen">GET /api/v1/keys/open</h3>
+<p><strong>参数</strong></p>
+<ul>
+<li>
+<p>prevKey (可选)</p>
+<p>返回给定 prevKey id 之后仍然处于打开状态且存在的键/文件集合。
+例如:prevKey=/vol1/bucket1/key1,这将跳过键,直到成功定位到给定的 prevKey。</p>
+</li>
+<li>
+<p>limit (可选)</p>
+<p>仅返回有限数量的结果。默认限制为1000。</p>
+</li>
+</ul>
+<p><strong>回传</strong></p>
+<p>返回处于打开状态的键/文件集合。</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"lastKey"</span>: <span style="color:#e6db74">"/vol1/fso-bucket/dir1/dir2/file2"</span>,
+ <span style="color:#f92672">"replicatedTotal"</span>: <span style="color:#ae81ff">13824</span>,
+ <span style="color:#f92672">"unreplicatedTotal"</span>: <span style="color:#ae81ff">4608</span>,
+ <span style="color:#f92672">"entities"</span>: [
+ {
+ <span style="color:#f92672">"path"</span>: <span style="color:#e6db74">"/vol1/bucket1/key1"</span>,
+ <span style="color:#f92672">"keyState"</span>: <span style="color:#e6db74">"Open"</span>,
+ <span style="color:#f92672">"inStateSince"</span>: <span style="color:#ae81ff">1667564193026</span>,
+ <span style="color:#f92672">"size"</span>: <span style="color:#ae81ff">1024</span>,
+ <span style="color:#f92672">"replicatedSize"</span>: <span style="color:#ae81ff">3072</span>,
+ <span style="color:#f92672">"unreplicatedSize"</span>: <span style="color:#ae81ff">1024</span>,
+ <span style="color:#f92672">"replicationType"</span>: <span style="color:#e6db74">"RATIS"</span>,
+ <span style="color:#f92672">"replicationFactor"</span>: <span style="color:#e6db74">"THREE"</span>
+ },
+ {
+ <span style="color:#f92672">"path"</span>: <span style="color:#e6db74">"/vol1/bucket1/key2"</span>,
+ <span style="color:#f92672">"keyState"</span>: <span style="color:#e6db74">"Open"</span>,
+ <span style="color:#f92672">"inStateSince"</span>: <span style="color:#ae81ff">1667564193026</span>,
+ <span style="color:#f92672">"size"</span>: <span style="color:#ae81ff">512</span>,
+ <span style="color:#f92672">"replicatedSize"</span>: <span style="color:#ae81ff">1536</span>,
+ <span style="color:#f92672">"unreplicatedSize"</span>: <span style="color:#ae81ff">512</span>,
+ <span style="color:#f92672">"replicationType"</span>: <span style="color:#e6db74">"RATIS"</span>,
+ <span style="color:#f92672">"replicationFactor"</span>: <span style="color:#e6db74">"THREE"</span>
+ },
+ {
+ <span style="color:#f92672">"path"</span>: <span style="color:#e6db74">"/vol1/fso-bucket/dir1/file1"</span>,
+ <span style="color:#f92672">"keyState"</span>: <span style="color:#e6db74">"Open"</span>,
+ <span style="color:#f92672">"inStateSince"</span>: <span style="color:#ae81ff">1667564193026</span>,
+ <span style="color:#f92672">"size"</span>: <span style="color:#ae81ff">1024</span>,
+ <span style="color:#f92672">"replicatedSize"</span>: <span style="color:#ae81ff">3072</span>,
+ <span style="color:#f92672">"unreplicatedSize"</span>: <span style="color:#ae81ff">1024</span>,
+ <span style="color:#f92672">"replicationType"</span>: <span style="color:#e6db74">"RATIS"</span>,
+ <span style="color:#f92672">"replicationFactor"</span>: <span style="color:#e6db74">"THREE"</span>
+ },
+ {
+ <span style="color:#f92672">"path"</span>: <span style="color:#e6db74">"/vol1/fso-bucket/dir1/dir2/file2"</span>,
+ <span style="color:#f92672">"keyState"</span>: <span style="color:#e6db74">"Open"</span>,
+ <span style="color:#f92672">"inStateSince"</span>: <span style="color:#ae81ff">1667564193026</span>,
+ <span style="color:#f92672">"size"</span>: <span style="color:#ae81ff">2048</span>,
+ <span style="color:#f92672">"replicatedSize"</span>: <span style="color:#ae81ff">6144</span>,
+ <span style="color:#f92672">"unreplicatedSize"</span>: <span style="color:#ae81ff">2048</span>,
+ <span style="color:#f92672">"replicationType"</span>: <span style="color:#e6db74">"RATIS"</span>,
+ <span style="color:#f92672">"replicationFactor"</span>: <span style="color:#e6db74">"THREE"</span>
+ }
+ ]
+}
+</code></pre></div><h3 id="get-apiv1keysdeletepending">GET /api/v1/keys/deletePending</h3>
+<p><strong>参数</strong></p>
+<ul>
+<li>
+<p>prevKey (可选)</p>
+<p>返回给定 prevKey id 之后处于待删除状态的键/文件集合。
+例如:prevKey=/vol1/bucket1/key1,这将跳过键,直到成功定位到给定的 prevKey。</p>
+</li>
+<li>
+<p>limit (可选)</p>
+<p>仅返回有限数量的结果。默认限制为1000。</p>
+</li>
+</ul>
+<p><strong>回传</strong></p>
+<p>返回处于待删除状态的键/文件集合。</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"lastKey"</span>: <span style="color:#e6db74">"sampleVol/bucketOne/key_one"</span>,
+ <span style="color:#f92672">"replicatedTotal"</span>: <span style="color:#ae81ff">-1530804718628866300</span>,
+ <span style="color:#f92672">"unreplicatedTotal"</span>: <span style="color:#ae81ff">-1530804718628866300</span>,
+ <span style="color:#f92672">"deletedkeyinfo"</span>: [
+ {
+ <span style="color:#f92672">"omKeyInfoList"</span>: [
+ {
+ <span style="color:#f92672">"metadata"</span>: {},
+ <span style="color:#f92672">"objectID"</span>: <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"updateID"</span>: <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"parentObjectID"</span>: <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"volumeName"</span>: <span style="color:#e6db74">"sampleVol"</span>,
+ <span style="color:#f92672">"bucketName"</span>: <span style="color:#e6db74">"bucketOne"</span>,
+ <span style="color:#f92672">"keyName"</span>: <span style="color:#e6db74">"key_one"</span>,
+ <span style="color:#f92672">"dataSize"</span>: <span style="color:#ae81ff">-1530804718628866300</span>,
+ <span style="color:#f92672">"keyLocationVersions"</span>: [],
+ <span style="color:#f92672">"creationTime"</span>: <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"modificationTime"</span>: <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"replicationConfig"</span>: {
+ <span style="color:#f92672">"replicationFactor"</span>: <span style="color:#e6db74">"ONE"</span>,
+ <span style="color:#f92672">"requiredNodes"</span>: <span style="color:#ae81ff">1</span>,
+ <span style="color:#f92672">"replicationType"</span>: <span style="color:#e6db74">"STANDALONE"</span>
+ },
+ <span style="color:#f92672">"fileChecksum"</span>: <span style="color:#66d9ef">null</span>,
+ <span style="color:#f92672">"fileName"</span>: <span style="color:#e6db74">"key_one"</span>,
+ <span style="color:#f92672">"acls"</span>: [],
+ <span style="color:#f92672">"path"</span>: <span style="color:#e6db74">"0/key_one"</span>,
+ <span style="color:#f92672">"file"</span>: <span style="color:#66d9ef">false</span>,
+ <span style="color:#f92672">"latestVersionLocations"</span>: <span style="color:#66d9ef">null</span>,
+ <span style="color:#f92672">"replicatedSize"</span>: <span style="color:#ae81ff">-1530804718628866300</span>,
+ <span style="color:#f92672">"fileEncryptionInfo"</span>: <span style="color:#66d9ef">null</span>,
+ <span style="color:#f92672">"objectInfo"</span>: <span style="color:#e6db74">"OMKeyInfo{volume='sampleVol', bucket='bucketOne', key='key_one', dataSize='-1530804718628866186', creationTime='0', objectID='0', parentID='0', replication='STANDALONE/ONE', fileChecksum='null}"</span>,
+ <span style="color:#f92672">"updateIDset"</span>: <span style="color:#66d9ef">false</span>
+ }
+ ]
+ }
+ ],
+ <span style="color:#f92672">"status"</span>: <span style="color:#e6db74">"OK"</span>
+}
+</code></pre></div><h3 id="get-apiv1keysdeletependingdirs">GET /api/v1/keys/deletePending/dirs</h3>
+<p><strong>参数</strong></p>
+<ul>
+<li>
+<p>prevKey (可选)</p>
+<p>返回给定 prevKey id 之后处于待删除状态的目录集合。
+例如:prevKey=/vol1/bucket1/bucket1/dir1,这将跳过目录,直到成功定位到给定的 prevKey。</p>
+</li>
+<li>
+<p>limit (可选)</p>
+<p>仅返回有限数量的结果。默认限制为1000。</p>
+</li>
+</ul>
+<p><strong>回传</strong></p>
+<p>返回处于待删除状态的目录集合。</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"lastKey"</span>: <span style="color:#e6db74">"vol1/bucket1/bucket1/dir1"</span>,
+ <span style="color:#f92672">"replicatedTotal"</span>: <span style="color:#ae81ff">-1530804718628866300</span>,
+ <span style="color:#f92672">"unreplicatedTotal"</span>: <span style="color:#ae81ff">-1530804718628866300</span>,
+ <span style="color:#f92672">"deletedkeyinfo"</span>: [
+ {
+ <span style="color:#f92672">"omKeyInfoList"</span>: [
+ {
+ <span style="color:#f92672">"metadata"</span>: {},
+ <span style="color:#f92672">"objectID"</span>: <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"updateID"</span>: <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"parentObjectID"</span>: <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"volumeName"</span>: <span style="color:#e6db74">"sampleVol"</span>,
+ <span style="color:#f92672">"bucketName"</span>: <span style="color:#e6db74">"bucketOne"</span>,
+ <span style="color:#f92672">"keyName"</span>: <span style="color:#e6db74">"key_one"</span>,
+ <span style="color:#f92672">"dataSize"</span>: <span style="color:#ae81ff">-1530804718628866300</span>,
+ <span style="color:#f92672">"keyLocationVersions"</span>: [],
+ <span style="color:#f92672">"creationTime"</span>: <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"modificationTime"</span>: <span style="color:#ae81ff">0</span>,
+ <span style="color:#f92672">"replicationConfig"</span>: {
+ <span style="color:#f92672">"replicationFactor"</span>: <span style="color:#e6db74">"ONE"</span>,
+ <span style="color:#f92672">"requiredNodes"</span>: <span style="color:#ae81ff">1</span>,
+ <span style="color:#f92672">"replicationType"</span>: <span style="color:#e6db74">"STANDALONE"</span>
+ },
+ <span style="color:#f92672">"fileChecksum"</span>: <span style="color:#66d9ef">null</span>,
+ <span style="color:#f92672">"fileName"</span>: <span style="color:#e6db74">"key_one"</span>,
+ <span style="color:#f92672">"acls"</span>: [],
+ <span style="color:#f92672">"path"</span>: <span style="color:#e6db74">"0/key_one"</span>,
+ <span style="color:#f92672">"file"</span>: <span style="color:#66d9ef">false</span>,
+ <span style="color:#f92672">"latestVersionLocations"</span>: <span style="color:#66d9ef">null</span>,
+ <span style="color:#f92672">"replicatedSize"</span>: <span style="color:#ae81ff">-1530804718628866300</span>,
+ <span style="color:#f92672">"fileEncryptionInfo"</span>: <span style="color:#66d9ef">null</span>,
+ <span style="color:#f92672">"objectInfo"</span>: <span style="color:#e6db74">"OMKeyInfo{volume='sampleVol', bucket='bucketOne', key='key_one', dataSize='-1530804718628866186', creationTime='0', objectID='0', parentID='0', replication='STANDALONE/ONE', fileChecksum='null}"</span>,
+ <span style="color:#f92672">"updateIDset"</span>: <span style="color:#66d9ef">false</span>
+ }
+ ]
+ }
+ ],
+ <span style="color:#f92672">"status"</span>: <span style="color:#e6db74">"OK"</span>
+}
+</code></pre></div><h2 id="blocks-metadata-admin-only">Blocks Metadata (admin only)</h2>
+<h3 id="get-apiv1blocksdeletepending">GET /api/v1/blocks/deletePending</h3>
+<p><strong>参数</strong></p>
+<ul>
+<li>
+<p>prevKey (可选)</p>
+<p>仅返回给定块ID(prevKey)之后处于待删除状态的块列表。
+例如:prevKey=4,这将跳过 deletedBlocks 表中的键以跳过 prevKey 之前的记录。</p>
+</li>
+<li>
+<p>limit (可选)</p>
+<p>仅返回有限数量的结果。默认限制为1000。</p>
+</li>
+</ul>
+<p><strong>回传</strong></p>
+<p>返回待删除的块列表。</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json">{
+ <span style="color:#f92672">"OPEN"</span>: [
+ {
+ <span style="color:#f92672">"containerId"</span>: <span style="color:#ae81ff">100</span>,
+ <span style="color:#f92672">"localIDList"</span>: [
+ <span style="color:#ae81ff">1</span>,
+ <span style="color:#ae81ff">2</span>,
+ <span style="color:#ae81ff">3</span>,
+ <span style="color:#ae81ff">4</span>
+ ],
+ <span style="color:#f92672">"localIDCount"</span>: <span style="color:#ae81ff">4</span>,
+ <span style="color:#f92672">"txID"</span>: <span style="color:#ae81ff">1</span>
+ }
+ ]
+}
+</code></pre></div><h2 id="namespace-metadata-仅-admin">Namespace Metadata (仅 admin)</h2>
+<h3 id="get-apiv1namespacesummary">GET /api/v1/namespace/summary</h3>
+<p><strong>参数</strong></p>
+<ul>
+<li>
+<p>path</p>
+<p>字符串形式的路径请求,不包含任何协议前缀。</p>
+</li>
+</ul>
+<p><strong>回传</strong></p>
+<p>返回路径的基本信息汇总,包括实体类型和路径下对象的聚合计数。</p>
+<p>如果路径存在,则 <code>status</code> 为 <code>OK</code>,否则为 <code>PATH_NOT_FOUND</code>。</p>
+<p>示例: /api/v1/namespace/summary?path=/</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> {
+ <span style="color:#f92672">"status"</span>: <span style="color:#960050;background-color:#1e0010">OK</span>,
+ <span style="color:#f92672">"type"</span>: <span style="color:#960050;background-color:#1e0010">ROOT</span>,
+ <span style="color:#f92672">"numVolume"</span>: <span style="color:#ae81ff">10</span>,
+ <span style="color:#f92672">"numBucket"</span>: <span style="color:#ae81ff">100</span>,
+ <span style="color:#f92672">"numDir"</span>: <span style="color:#ae81ff">1000</span>,
+ <span style="color:#f92672">"numKey"</span>: <span style="color:#ae81ff">10000</span>
+ }
+</code></pre></div><p>示例: /api/v1/namespace/summary?path=/volume1</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> {
+ <span style="color:#f92672">"status"</span>: <span style="color:#960050;background-color:#1e0010">OK</span>,
+ <span style="color:#f92672">"type"</span>: <span style="color:#960050;background-color:#1e0010">VOLUME</span>,
+ <span style="color:#f92672">"numVolume"</span>: <span style="color:#ae81ff">-1</span>,
+ <span style="color:#f92672">"numBucket"</span>: <span style="color:#ae81ff">10</span>,
+ <span style="color:#f92672">"numDir"</span>: <span style="color:#ae81ff">100</span>,
+ <span style="color:#f92672">"numKey"</span>: <span style="color:#ae81ff">1000</span>
+ }
+</code></pre></div><p>示例: /api/v1/namespace/summary?path=/volume1/bucket1</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> {
+ <span style="color:#f92672">"status"</span>: <span style="color:#960050;background-color:#1e0010">OK</span>,
+ <span style="color:#f92672">"type"</span>: <span style="color:#960050;background-color:#1e0010">BUCKET</span>,
+ <span style="color:#f92672">"numVolume"</span>: <span style="color:#ae81ff">-1</span>,
+ <span style="color:#f92672">"numBucket"</span>: <span style="color:#ae81ff">-1</span>,
+ <span style="color:#f92672">"numDir"</span>: <span style="color:#ae81ff">50</span>,
+ <span style="color:#f92672">"numKey"</span>: <span style="color:#ae81ff">500</span>
+ }
+</code></pre></div><p>示例: /api/v1/namespace/summary?path=/volume1/bucket1/dir</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> {
+ <span style="color:#f92672">"status"</span>: <span style="color:#960050;background-color:#1e0010">OK</span>,
+ <span style="color:#f92672">"type"</span>: <span style="color:#960050;background-color:#1e0010">DIRECTORY</span>,
+ <span style="color:#f92672">"numVolume"</span>: <span style="color:#ae81ff">-1</span>,
+ <span style="color:#f92672">"numBucket"</span>: <span style="color:#ae81ff">-1</span>,
+ <span style="color:#f92672">"numDir"</span>: <span style="color:#ae81ff">10</span>,
+ <span style="color:#f92672">"numKey"</span>: <span style="color:#ae81ff">100</span>
+ }
+</code></pre></div><p>示例: /api/v1/namespace/summary?path=/volume1/bucket1/dir/nestedDir</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> {
+ <span style="color:#f92672">"status"</span>: <span style="color:#960050;background-color:#1e0010">OK</span>,
+ <span style="color:#f92672">"type"</span>: <span style="color:#960050;background-color:#1e0010">DIRECTORY</span>,
+ <span style="color:#f92672">"numVolume"</span>: <span style="color:#ae81ff">-1</span>,
+ <span style="color:#f92672">"numBucket"</span>: <span style="color:#ae81ff">-1</span>,
+ <span style="color:#f92672">"numDir"</span>: <span style="color:#ae81ff">5</span>,
+ <span style="color:#f92672">"numKey"</span>: <span style="color:#ae81ff">50</span>
+ }
+</code></pre></div><p>如果任何 <code>num</code> 字段为 <code>-1</code>,则该路径请求不适用于该实体类型。</p>
+<h3 id="get-apiv1namespacedu">GET /api/v1/namespace/du</h3>
+<p><strong>参数</strong></p>
+<ul>
+<li>
+<p>path</p>
+<p>字符串形式的路径请求,不包含任何协议前缀。</p>
+</li>
+<li>
+<p>files (可选)</p>
+<p>一个布尔值,默认值为 <code>false</code>。如果设置为 <code>true</code>,则会计算路径下键的磁盘使用情况。</p>
+</li>
+<li>
+<p>replica (可选)</p>
+<p>一个布尔值,默认为 <code>false</code>。如果设置为 <code>true</code>,则会计算键的副本大小的磁盘使用情况。</p>
+</li>
+</ul>
+<p><strong>回传</strong></p>
+<p>返回路径下所有子路径的磁盘使用情况。规范化 <code>path</code> 字段,返回路径下直接健的总大小作为
+<code>sizeDirectKey</code>,并以字节为单位返回 <code>size/sizeWithReplica</code>。</p>
+<p>如果路径存在,则 <code>status</code> 为 <code>OK</code>,否则为 <code>PATH_NOT_FOUND</code>。</p>
+<p>示例: /api/v1/namespace/du?path=/vol1/bucket1&files=true&replica=true</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> {
+ <span style="color:#f92672">"status"</span>: <span style="color:#960050;background-color:#1e0010">OK</span>,
+ <span style="color:#f92672">"path"</span>: <span style="color:#e6db74">"/vol1/bucket1"</span>,
+ <span style="color:#f92672">"size"</span>: <span style="color:#ae81ff">100000</span>,
+ <span style="color:#f92672">"sizeWithReplica"</span>: <span style="color:#ae81ff">300000</span>,
+ <span style="color:#f92672">"subPathCount"</span>: <span style="color:#ae81ff">4</span>,
+ <span style="color:#f92672">"subPaths"</span>: [
+ {
+ <span style="color:#f92672">"path"</span>: <span style="color:#e6db74">"/vol1/bucket1/dir1-1"</span>,
+ <span style="color:#f92672">"size"</span>: <span style="color:#ae81ff">30000</span>,
+ <span style="color:#f92672">"sizeWithReplica"</span>: <span style="color:#ae81ff">90000</span>,
+ <span style="color:#f92672">"isKey"</span>: <span style="color:#66d9ef">false</span>
+ },
+ {
+ <span style="color:#f92672">"path"</span>: <span style="color:#e6db74">"/vol1/bucket1/dir1-2"</span>,
+ <span style="color:#f92672">"size"</span>: <span style="color:#ae81ff">30000</span>,
+ <span style="color:#f92672">"sizeWithReplica"</span>: <span style="color:#ae81ff">90000</span>,
+ <span style="color:#f92672">"isKey"</span>: <span style="color:#66d9ef">false</span>
+ },
+ {
+ <span style="color:#f92672">"path"</span>: <span style="color:#e6db74">"/vol1/bucket1/dir1-3"</span>,
+ <span style="color:#f92672">"size"</span>: <span style="color:#ae81ff">30000</span>,
+ <span style="color:#f92672">"sizeWithReplica"</span>: <span style="color:#ae81ff">90000</span>,
+ <span style="color:#f92672">"isKey"</span>: <span style="color:#66d9ef">false</span>
+ },
+ {
+ <span style="color:#f92672">"path"</span>: <span style="color:#e6db74">"/vol1/bucket1/key1-1"</span>,
+ <span style="color:#f92672">"size"</span>: <span style="color:#ae81ff">10000</span>,
+ <span style="color:#f92672">"sizeWithReplica"</span>: <span style="color:#ae81ff">30000</span>,
+ <span style="color:#f92672">"isKey"</span>: <span style="color:#66d9ef">true</span>
+ }
+ ],
+ <span style="color:#f92672">"sizeDirectKey"</span>: <span style="color:#ae81ff">10000</span>
+ }
+</code></pre></div><p>如果 <code>files</code> 设置为 <code>false</code>,则子路径 <code>/vol1/bucket1/key1-1</code> 将被省略。
+如果 <code>replica</code> 设置为 <code>false</code>,则 <code>sizeWithReplica</code> 返回 <code>-1</code>。
+如果路径的实体类型无法具有直接键(例如根目录、卷),则 <code>sizeDirectKey</code> 返回 <code>-1</code>。</p>
+<h3 id="get-apiv1namespacequota">GET /api/v1/namespace/quota</h3>
+<p><strong>参数</strong></p>
+<ul>
+<li>
+<p>path</p>
+<p>路径请求为字符串,不包含任何协议前缀。</p>
+</li>
+</ul>
+<p><strong>回传</strong></p>
+<p>返回路径下允许的配额和已使用的配额。
+只有卷和存储桶具有配额。其他类型不适用于配额请求</p>
+<p>如果请求有效,则 <code>status</code> 为 <code>OK</code>;如果路径不存在,则为 <code>PATH_NOT_FOUND</code>;
+如果路径存在但路径的实体类型不适用于请求,则为 <code>TYPE_NOT_APPLICABLE</code>。</p>
+<p>示例: /api/v1/namespace/quota?path=/vol</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> {
+ <span style="color:#f92672">"status"</span>: <span style="color:#960050;background-color:#1e0010">OK</span>,
+ <span style="color:#f92672">"allowed"</span>: <span style="color:#ae81ff">200000</span>,
+ <span style="color:#f92672">"used"</span>: <span style="color:#ae81ff">160000</span>
+ }
+</code></pre></div><p>如果未设置配额,则 <code>allowed</code> 返回 <code>-1</code>。详情请参阅 [Ozone 中的配额]。
+(<a href="https://ci-hadoop.apache.org/view/Hadoop%20Ozone/job/ozone-doc-master/lastSuccessfulBuild/artifact/hadoop-hdds/docs/public/feature/quota.html">https://ci-hadoop.apache.org/view/Hadoop%20Ozone/job/ozone-doc-master/lastSuccessfulBuild/artifact/hadoop-hdds/docs/public/feature/quota.html</a>)</p>
+<h3 id="get-apiv1namespacedist">GET /api/v1/namespace/dist</h3>
+<p><strong>参数</strong></p>
+<ul>
+<li>
+<p>path</p>
+<p>路径请求为字符串,不包含任何协议前缀。</p>
+</li>
+</ul>
+<p><strong>回传</strong></p>
+<p>返回路径下所有键的文件大小分布。</p>
+<p>如果请求有效,则 <code>status</code> 为 <code>OK</code>;如果路径不存在,则为 <code>PATH_NOT_FOUND</code>;
+如果路径存在,但该路径是一个键,键不具有文件大小分布,则为 <code>TYPE_NOT_APPLICABLE</code>。</p>
+<p>示例: /api/v1/namespace/dist?path=/</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> {
+ <span style="color:#f92672">"status"</span>: <span style="color:#960050;background-color:#1e0010">OK</span>,
+ <span style="color:#f92672">"dist"</span>: [
+ <span style="color:#ae81ff">0</span>,
+ <span style="color:#ae81ff">0</span>,
+ <span style="color:#ae81ff">10</span>,
+ <span style="color:#ae81ff">20</span>,
+ <span style="color:#ae81ff">0</span>,
+ <span style="color:#ae81ff">30</span>,
+ <span style="color:#ae81ff">0</span>,
+ <span style="color:#ae81ff">100</span>,
+ <span style="color:#960050;background-color:#1e0010">...</span>
+ ]
+ }
+</code></pre></div><p>Recon跟踪所有大小从<code>1 KB</code>到<code>1 PB</code>的键。对于小于<code>1 KB</code>的键,映射到第一个箱(索引);
+对于大于<code>1 PB</code>的键,映射到最后一个箱(索引)。</p>
+<p><code>dist</code> 的每个索引都映射到一个文件大小范围(例如 <code>1 MB</code> 到 <code>2 MB</code>)。</p>
<h2 id="集群状态">集群状态</h2>
<h3 id="get-apiv1clusterstate">GET /api/v1/clusterState</h3>
<p><strong>参数</strong></p>
@@ -597,6 +1040,101 @@ s=d.getElementsByTagName('script')[0];
<span style="color:#f92672">"buckets"</span>: <span style="color:#ae81ff">26</span>,
<span style="color:#f92672">"keys"</span>: <span style="color:#ae81ff">25</span>
}
+</code></pre></div><h2 id="volumes-仅-admin">Volumes (仅 admin)</h2>
+<h3 id="get-apiv1volumes">GET /api/v1/volumes</h3>
+<p><strong>参数</strong></p>
+<ul>
+<li>
+<p>prevKey (可选)</p>
+<p>仅返回给定 prevKey 之后的卷。
+示例: prevKey=vol1</p>
+</li>
+<li>
+<p>limit (可选)</p>
+<p>仅返回有限数量的结果。默认限制为1000。</p>
+</li>
+</ul>
+<p><strong>回传</strong></p>
+<p>返回集群中的所有卷。</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> {
+ <span style="color:#f92672">"totalCount"</span>: <span style="color:#ae81ff">4</span>,
+ <span style="color:#f92672">"volumes"</span>: [{
+ <span style="color:#f92672">"volume"</span>: <span style="color:#e6db74">"vol1"</span>,
+ <span style="color:#f92672">"owner"</span>: <span style="color:#e6db74">"testuser"</span>,
+ <span style="color:#f92672">"admin"</span>: <span style="color:#e6db74">"ozone"</span>,
+ <span style="color:#f92672">"creationTime"</span>: <span style="color:#ae81ff">1665588176660</span> ,
+ <span style="color:#f92672">"modificationTime"</span>: <span style="color:#ae81ff">1665590397315</span>,
+ <span style="color:#f92672">"quotaInNamespace"</span>: <span style="color:#ae81ff">2048</span>,
+ <span style="color:#f92672">"quotaInBytes"</span>: <span style="color:#ae81ff">1073741824</span>,
+ <span style="color:#f92672">"usedNamespace"</span>: <span style="color:#ae81ff">10</span>,
+ <span style="color:#f92672">"acls"</span>: [
+ {
+ <span style="color:#f92672">"type"</span>: <span style="color:#e6db74">"USER"</span>,
+ <span style="color:#f92672">"name"</span>: <span style="color:#e6db74">"testuser"</span>,
+ <span style="color:#f92672">"scope"</span>: <span style="color:#e6db74">"ACCESS"</span>,
+ <span style="color:#f92672">"aclList"</span>: [
+ <span style="color:#e6db74">"WRITE"</span>,
+ <span style="color:#e6db74">"READ"</span>,
+ <span style="color:#e6db74">"DELETE"</span>
+ ]
+ }
+ ]
+ },
+ <span style="color:#960050;background-color:#1e0010">...</span>
+ ]
+ }
+</code></pre></div><h2 id="buckets-仅-admin">Buckets (仅 admin)</h2>
+<h3 id="get-apiv1buckets">GET /api/v1/buckets</h3>
+<p><strong>参数</strong></p>
+<ul>
+<li>
+<p>volume (可选)</p>
+<p>卷以字符串形式表示,不包含任何协议前缀。</p>
+</li>
+<li>
+<p>prevKey (可选)</p>
+<p>返回给定 prevKey 之后的存储桶。 如果未指定卷,则忽略 prevKey。
+示例: prevKey=bucket1</p>
+</li>
+<li>
+<p>limit (可选)</p>
+<p>仅返回有限数量的结果。默认限制为1000。</p>
+</li>
+</ul>
+<p><strong>回传</strong></p>
+<p>如果未指定卷或指定的卷是一个空字符串,则返回集群中的所有存储桶。
+如果指定了 <code>volume</code>,则仅返回 <code>volume</code> 下的存储桶。</p>
+<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> {
+ <span style="color:#f92672">"totalCount"</span>: <span style="color:#ae81ff">5</span>,
+ <span style="color:#f92672">"buckets"</span>: [{
+ <span style="color:#f92672">"volumeName"</span>: <span style="color:#e6db74">"vol1"</span>,
+ <span style="color:#f92672">"bucketName"</span>: <span style="color:#e6db74">"buck1"</span>,
+ <span style="color:#f92672">"versioning"</span>: <span style="color:#66d9ef">false</span>,
+ <span style="color:#f92672">"storageType"</span>: <span style="color:#e6db74">"DISK"</span>,
+ <span style="color:#f92672">"creationTime"</span>: <span style="color:#ae81ff">1665588176616</span>,
+ <span style="color:#f92672">"modificationTime"</span>: <span style="color:#ae81ff">1665590392293</span>,
+ <span style="color:#f92672">"usedBytes"</span>: <span style="color:#ae81ff">943718400</span>,
+ <span style="color:#f92672">"usedNamespace"</span>: <span style="color:#ae81ff">40000</span>,
+ <span style="color:#f92672">"quotaInBytes"</span>: <span style="color:#ae81ff">1073741824</span>,
+ <span style="color:#f92672">"quotaInNamespace"</span>: <span style="color:#ae81ff">50000</span>,
+ <span style="color:#f92672">"owner"</span>: <span style="color:#e6db74">"testuser"</span>,
+ <span style="color:#f92672">"bucketLayout"</span>: <span style="color:#e6db74">"OBJECT_STORE"</span>,
+ <span style="color:#f92672">"acls"</span>: [
+ {
+ <span style="color:#f92672">"type"</span>: <span style="color:#e6db74">"USER"</span>,
+ <span style="color:#f92672">"name"</span>: <span style="color:#e6db74">"testuser"</span>,
+ <span style="color:#f92672">"scope"</span>: <span style="color:#e6db74">"ACCESS"</span>,
+ <span style="color:#f92672">"aclList"</span>: [
+ <span style="color:#e6db74">"WRITE"</span>,
+ <span style="color:#e6db74">"READ"</span>,
+ <span style="color:#e6db74">"DELETE"</span>
+ ]
+ }
+ ]
+ },
+ <span style="color:#960050;background-color:#1e0010">...</span>
+ ]
+ }
</code></pre></div><h2 id="数据节点">数据节点</h2>
<h3 id="get-apiv1datanodes">GET /api/v1/datanodes</h3>
<p><strong>参数</strong></p>
@@ -740,6 +1278,8 @@ s=d.getElementsByTagName('script')[0];
</code></pre></div>
+ <a class="btn btn-success btn-lg" href="../../zh/interface/cli.html">Next >></a>
+
</div>
</div>
@@ -754,7 +1294,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: March 14, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/92221930844a9040122cf4c92ee69bc5b3d759fb">9222193084</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/interface/s3.html b/docs/edge/zh/interface/s3.html
index 6b3a2073..c2cb9c23 100644
--- a/docs/edge/zh/interface/s3.html
+++ b/docs/edge/zh/interface/s3.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -368,7 +398,7 @@ s=d.getElementsByTagName('script')[0];
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="../../zh/index.html">Home</a></li>
- <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">编程接口</a></li>
+ <li class="breadcrumb-item" aria-current="page"><a href="../../zh/interface.html">客户端接口</a></li>
<li class="breadcrumb-item active" aria-current="page">S3 协议接口</li>
</ol>
</nav>
@@ -539,9 +569,6 @@ ozone sh bucket link /vol1/bucket1 /s3v/common-bucket
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">aws s3api --endpoint http://localhost:9878 create-bucket --bucket buckettest
</code></pre></div><p>或者</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">aws s3 ls --endpoint http://localhost:9878 s3://buckettest
-</code></pre></div><h3 id="s3-fuse-驱动goofys">S3 Fuse 驱动(goofys)</h3>
-<p>Goofys 是一个 S3 FUSE 驱动,可以将 Ozone 的桶挂载到 POSIX 文件系统。</p>
-<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">goofys --endpoint http://localhost:9878 bucket1 /mount/bucket1
</code></pre></div>
@@ -561,7 +588,7 @@ ozone sh bucket link /vol1/bucket1 /s3v/common-bucket
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: December 4, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/cb0a402bea59da76fe51c51cd61ab4bfe99417cb">cb0a402bea</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/recipe.html b/docs/edge/zh/recipe.html
index f26ce5f8..92ccb9f0 100644
--- a/docs/edge/zh/recipe.html
+++ b/docs/edge/zh/recipe.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="active">
+
+ <a href="../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="active">
-
- <a href="../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -418,6 +448,25 @@ s=d.getElementsByTagName('script')[0];
<div class="row">
+ <div class="col-sm-6">
+ <div class="card">
+ <div class="card-body">
+ <h2 class="card-title">
+
+ Boto3
+ </h2>
+ <p class="card-text">如何使用 Boto3 客户端访问 Ozone 对象存储?</p>
+ <a href="../zh/recipe/botoclient.html"
+ class=" btn btn-primary btn-lg">Boto3</a>
+ </div>
+ </div>
+ </div>
+
+
+
+
+
+
<div class="col-sm-6">
<div class="card">
<div class="card-body">
@@ -433,10 +482,14 @@ s=d.getElementsByTagName('script')[0];
</div>
+ </div>
+
+ <div class="row">
+
<div class="col-sm-6">
<div class="card">
<div class="card-body">
@@ -452,8 +505,6 @@ s=d.getElementsByTagName('script')[0];
</div>
- </div>
-
</div>
@@ -468,7 +519,7 @@ s=d.getElementsByTagName('script')[0];
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 1.5.0-SNAPSHOT, Last Modified: February 27, 2024 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/7939faf7d6c904bf1e4ad32baa5d6d0c1de19003">7939faf</a>
+ Version: 2.0.0-SNAPSHOT, Last Modified: April 22, 2020 <a class="hide-child link primary-color" href="https://github.com/apache/ozone/commit/ca6da463d8a191d93c36b3f2b53c92cf1fe7a0bf">ca6da463d8</a>
</span>
</div>
</footer>
diff --git a/docs/edge/zh/recipe/prometheus.html b/docs/edge/zh/recipe/botoclient.html
similarity index 63%
copy from docs/edge/zh/recipe/prometheus.html
copy to docs/edge/zh/recipe/botoclient.html
index dc3803ba..98dc54d6 100644
--- a/docs/edge/zh/recipe/prometheus.html
+++ b/docs/edge/zh/recipe/botoclient.html
@@ -261,6 +261,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/security/securingozonehttp.html">安全化 HTTP</a>
+
+ </li>
+
<li class="">
<a href="../../zh/security/securings3.html">安全化 S3</a>
@@ -287,7 +293,49 @@ s=d.getElementsByTagName('script')[0];
<li class="">
<a href="../../zh/interface.html">
- <span>编程接口</span>
+ <span>客户端接口</span>
+ </a>
+ <ul class="nav">
+
+ <li class="">
+
+ <a href="../../zh/interface/cli.html">命令行接口</a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/tools.html">
+
+
+
+ <span>工具</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+
+ <a href="../../zh/recipe.html">
+
+
+
+ <span>使用配方</span>
+ </a>
+ </li>
+
+
+
+ <li class="">
+ <a href="../../">
+
+ <span></span>
</a>
<ul class="nav">
@@ -297,6 +345,12 @@ s=d.getElementsByTagName('script')[0];
</li>
+ <li class="">
+
+ <a href="../../zh/interface/ofs.html">Ofs (兼容 Hadoop 的文件系统)</a>
+
+ </li>
+
<li class="">
<a href="../../zh/interface/o3fs.html">Ozone 文件系统</a>
@@ -325,30 +379,6 @@ s=d.getElementsByTagName('script')[0];
</li>
-
- <li class="">
-
- <a href="../../zh/tools.html">
-
-
-
- <span>工具</span>
- </a>
- </li>
-
-
-
- <li class="">
-
- <a href="../../zh/recipe.html">
-
-
-
- <span>使用配方</span>
- </a>
- </li>
-
-
<li><a href="../../design.html"><span><b>Design docs</b></span></a></li>
<li class="visible-xs"><a href="#">References</a>
<ul class="nav">
@@ -369,7 +399,7 @@ s=d.getElementsByTagName('script')[0];
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="../../zh/index.html">Home</a></li>
<li class="breadcrumb-item" aria-current="page"><a href="../../zh/recipe.html">使用配方</a></li>
- <li class="breadcrumb-item active" aria-current="page">使用 Prometheus 监控</li>
+ <li class="breadcrumb-item active" aria-current="page">使用 Boto3 客户端访问 Ozone 对象存储</li>
</ol>
</nav>
@@ -379,7 +409,7 @@ s=d.getElementsByTagName('script')[0];
- <a href="../../recipe/prometheus.html"><span class="label label-success">English</span></a>
+ <a href="../../recipe/botoclient.html"><span class="label label-success">English</span></a>
@@ -388,7 +418,7 @@ s=d.getElementsByTagName('script')[0];
<div class="col-md-9">
- <h1>使用 Prometheus 监控</h1>
+ <h1>使用 Boto3 客户端访问 Ozone 对象存储</h1>
<!---
Licensed to the Apache Software Foundation (ASF) under one or more
... 5159 lines suppressed ...
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@ozone.apache.org
For additional commands, e-mail: commits-help@ozone.apache.org