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 93330ba1 [auto] Generated docs from Apache Ozone master
e1c0e0d885b173fdee81a7abe48696fee6648b91
93330ba1 is described below
commit 93330ba19dc144a9c8712cc1c0e73b5a1e070576
Author: Github Actions <[email protected]>
AuthorDate: Wed Sep 17 12:46:45 2025 +0000
[auto] Generated docs from Apache Ozone master
e1c0e0d885b173fdee81a7abe48696fee6648b91
---
docs/edge/en/sitemap.xml | 2 +-
docs/edge/feature/snapshot.html | 74 +++++++++++++++++++++++++++++++++++++----
docs/edge/interface/ofs.html | 2 +-
docs/edge/sitemap.xml | 2 +-
docs/edge/zh/interface/ofs.html | 2 +-
5 files changed, 71 insertions(+), 11 deletions(-)
diff --git a/docs/edge/en/sitemap.xml b/docs/edge/en/sitemap.xml
index 0c5492fd..1f20ea72 100644
--- a/docs/edge/en/sitemap.xml
+++ b/docs/edge/en/sitemap.xml
@@ -120,7 +120,7 @@
/>
</url><url>
<loc>/feature/snapshot.html</loc>
- <lastmod>2025-07-06T09:02:35-07:00</lastmod>
+ <lastmod>2025-09-16T14:47:35-07:00</lastmod>
</url><url>
<loc>/feature/scm-ha.html</loc>
<lastmod>2025-07-09T20:47:34-07:00</lastmod>
diff --git a/docs/edge/feature/snapshot.html b/docs/edge/feature/snapshot.html
index 26dad5cc..9180a3d3 100644
--- a/docs/edge/feature/snapshot.html
+++ b/docs/edge/feature/snapshot.html
@@ -701,12 +701,72 @@ Refer to the <a
href="https://ozone.apache.org/docs/edge/interface/ofs.html";>Ozo
<p>This section covers key configurations and monitoring for Ozone snapshots.
Tune these in <strong>ozone-site.xml</strong>.</p>
<p><strong>Snapshot-Related Configuration Parameters:</strong></p>
<ul>
-<li><strong><code>ozone.om.fs.snapshot.max.limit</code></strong>: Max
snapshots per bucket (Default: 10000). Safety limit.</li>
-<li><strong><code>ozone.om.snapshot.compaction.dag.max.time.allowed</code></strong>:
Window for efficient SnapshotDiff (Default: 30 days). Older diffs may be
slower.</li>
-<li><strong><code>ozone.om.snapshot.diff.db.dir</code></strong>: Directory for
SnapshotDiff job data. Defaults to OM metadata dir. Use a spacious location for
large diffs.</li>
-<li><strong><code>ozone.om.snapshot.rocksdb.metrics.enabled</code></strong>:
Enable detailed RocksDB metrics for snapshots (Default: false). Use for
debugging/monitoring.</li>
-<li><strong><code>ozone.om.snapshot.load.native.lib</code></strong>: Use
native RocksDB library for snapshot operations (Default: true). Set to false as
a workaround for native library issues.</li>
-<li><strong><code>ozone.om.snapshot.diff.concurrent.max</code></strong>: Max
concurrent SnapshotDiff jobs per OM (Default: 10). Increase if OM resources
allow.</li>
+<li>
+<p><strong>General Snapshot Management</strong></p>
+<ul>
+<li><code>ozone.om.fs.snapshot.max.limit</code>: Max snapshots per bucket
(Default: 10000). Safety limit.</li>
+<li><code>ozone.om.ratis.snapshot.dir</code>: The directory where OM Ratis
snapshots are stored (Default: ratis-snapshot under OM DB dir).</li>
+<li><code>ozone.om.ratis.snapshot.max.total.sst.size</code>: The maximum total
size of SST files to be included in a Ratis snapshot (Default: 100000000).</li>
+<li><code>ozone.om.snapshot.load.native.lib</code>: Use native RocksDB library
for snapshot operations (Default: true). Set to false as a workaround for
native library issues.</li>
+<li><code>ozone.om.snapshot.checkpoint.dir.creation.poll.timeout</code>:
Timeout for polling the creation of the snapshot checkpoint directory (Default:
20s).</li>
+</ul>
+</li>
+<li>
+<p><strong>SnapshotDiff Service</strong></p>
+<ul>
+<li><code>ozone.om.snapshot.diff.db.dir</code>: Directory for SnapshotDiff job
data. Defaults to OM metadata dir. Use a spacious location for large diffs.</li>
+<li><code>ozone.om.snapshot.force.full.diff</code>: Force a full diff for all
snapshot diff jobs (Default: false).</li>
+<li><code>ozone.om.snapshot.diff.disable.native.libs</code>: Disable native
libraries for snapshot diff (Default: false).</li>
+<li><code>ozone.om.snapshot.diff.max.page.size</code>: Maximum page size for
snapshot diff (Default: 1000).</li>
+<li><code>ozone.om.snapshot.diff.thread.pool.size</code>: Thread pool size for
snapshot diff (Default: 10).</li>
+<li><code>ozone.om.snapshot.diff.job.default.wait.time</code>: Default wait
time for a snapshot diff job (Default: 1m).</li>
+<li><code>ozone.om.snapshot.diff.max.allowed.keys.changed.per.job</code>:
Maximum number of keys allowed to be changed per snapshot diff job (Default:
10000000).</li>
+</ul>
+</li>
+<li>
+<p><strong>Snapshot Compaction and Cleanup</strong></p>
+<ul>
+<li><code>ozone.snapshot.key.deleting.limit.per.task</code>: The maximum
number of keys scanned by the snapshot deleting service in a single run
(Default: 20000).</li>
+<li><code>ozone.om.snapshot.compact.non.snapshot.diff.tables</code>: When
enabled, allows compaction of tables not tracked by snapshot diffs after
snapshots are evicted from the cache (Default: false).</li>
+<li><code>ozone.om.snapshot.compaction.dag.max.time.allowed</code>: Window for
efficient SnapshotDiff (Default: 30 days). Older diffs may be slower.</li>
+<li><code>ozone.om.snapshot.prune.compaction.backup.batch.size</code>: Batch
size for pruning compaction backups (Default: 2000).</li>
+<li><code>ozone.om.snapshot.compaction.dag.prune.daemon.run.interval</code>:
Interval for the compaction DAG pruning daemon (Default: 1h).</li>
+<li><code>ozone.om.snapshot.diff.max.jobs.purge.per.task</code>: Maximum
number of snapshot diff jobs to purge per task (Default: 100).</li>
+<li><code>ozone.om.snapshot.diff.job.report.persistent.time</code>:
Persistence time for snapshot diff job reports (Default: 7d).</li>
+<li><code>ozone.om.snapshot.diff.cleanup.service.run.interval</code>: Interval
for the snapshot diff cleanup service (Default: 1m).</li>
+<li><code>ozone.om.snapshot.diff.cleanup.service.timeout</code>: Timeout for
the snapshot diff cleanup service (Default: 5m).</li>
+<li><code>ozone.om.snapshot.cache.cleanup.service.run.interval</code>:
Interval for the snapshot cache cleanup service (Default: 1m).</li>
+<li><code>ozone.snapshot.filtering.limit.per.task</code>: The maximum number
of snapshots to be filtered in a single run of the snapshot filtering service
(Default: 2).</li>
+<li><code>ozone.snapshot.deleting.limit.per.task</code>: The maximum number of
snapshots to be deleted in a single run of the snapshot deleting service
(Default: 10).</li>
+<li><code>ozone.snapshot.filtering.service.interval</code>: Interval for the
snapshot filtering service (Default: 60s).</li>
+<li><code>ozone.snapshot.deleting.service.timeout</code>: Timeout for the
snapshot deleting service (Default: 300s).</li>
+<li><code>ozone.snapshot.deleting.service.interval</code>: Interval for the
snapshot deleting service (Default: 30s).</li>
+<li><code>ozone.snapshot.deep.cleaning.enabled</code>: Enable deep cleaning of
snapshots (Default: false).</li>
+</ul>
+</li>
+<li>
+<p><strong>Performance and Resource Management</strong></p>
+<ul>
+<li><code>ozone.om.snapshot.rocksdb.metrics.enabled</code>: Enable detailed
RocksDB metrics for snapshots (Default: false). Use for
debugging/monitoring.</li>
+<li><code>ozone.om.snapshot.cache.max.size</code>: Maximum size of the
snapshot cache soft limit (Default: 10).</li>
+<li><code>ozone.om.snapshot.db.max.open.files</code>: Maximum number of open
files for the snapshot database (Default: 100).</li>
+</ul>
+</li>
+<li>
+<p><strong>Snapshot Provider (Internal)</strong></p>
+<ul>
+<li><code>ozone.om.snapshot.provider.socket.timeout</code>: Socket timeout for
the snapshot provider (Default: 5s).</li>
+<li><code>ozone.om.snapshot.provider.connection.timeout</code>: Connection
timeout for the snapshot provider (Default: 5s).</li>
+<li><code>ozone.om.snapshot.provider.request.timeout</code>: Request timeout
for the snapshot provider (Default: 5m).</li>
+</ul>
+</li>
+</ul>
+<h3 id="recon-specific-settings">Recon-Specific Settings</h3>
+<p>These settings, defined in <code>ozone-default.xml</code>, apply
specifically to Recon.</p>
+<ul>
+<li><code>ozone.recon.om.snapshot.task.initial.delay</code>: Initial delay for
the OM snapshot task in Recon (Default: 1m).</li>
+<li><code>ozone.recon.om.snapshot.task.interval.delay</code>: Interval for the
OM snapshot task in Recon (Default: 5s).</li>
+<li><code>ozone.recon.om.snapshot.task.flush.param</code>: Flush parameter for
the OM snapshot task in Recon (Default: false).</li>
</ul>
<p>Monitor OM heap usage with many snapshots or large diffs. Enable Ozone
Native ACLs or Ranger for access control.</p>
<p><strong>Monitoring Snapshots:</strong> Use OM metrics (Prometheus, RPC) for
snapshot counts, diff operations, etc. Check OM logs for snapshot-related
messages.</p>
@@ -768,7 +828,7 @@ Refer to the <a
href="https://ozone.apache.org/docs/edge/interface/ofs.html";>Ozo
<footer class="footer">
<div class="container">
<span class="small text-muted">
- Version: 2.1.0-SNAPSHOT, Last Modified: July 6, 2025 <a
class="hide-child link primary-color"
href="https://github.com/apache/ozone/commit/f51bb1bed2a08cb6beb0e40c5d43522fe220e53e";>f51bb1bed2</a>
+ Version: 2.1.0-SNAPSHOT, Last Modified: September 16, 2025 <a
class="hide-child link primary-color"
href="https://github.com/apache/ozone/commit/9a377483cdc228e7f6d84dd4cceeec898a01d6c9";>9a377483cd</a>
</span>
</div>
</footer>
diff --git a/docs/edge/interface/ofs.html b/docs/edge/interface/ofs.html
index a1a226d8..bb6f0dd1 100644
--- a/docs/edge/interface/ofs.html
+++ b/docs/edge/interface/ofs.html
@@ -654,7 +654,7 @@ For example:</p>
<p>Or use the put command to write a file to the bucket.</p>
<div class="highlight"><pre tabindex="0"
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="display:flex;"><span>hdfs
dfs -put /etc/hosts /volume1/bucket1/test</span></span></code></pre></div>
<p>For more usage, see: <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="differences-from-o3fshahahugoshortcode113s5hbhb">Differences from <a
href="../interface/o3fs.html">o3fs</a></h2>
+<h2 id="differences-from-o3fshahahugoshortcode111s5hbhb">Differences from <a
href="../interface/o3fs.html">o3fs</a></h2>
<h3 id="creating-files">Creating files</h3>
<p>OFS doesn’t allow creating keys(files) directly under root or volumes.
Users will receive an error message when they try to do that:</p>
diff --git a/docs/edge/sitemap.xml b/docs/edge/sitemap.xml
index 62d3a86a..d25fd267 100644
--- a/docs/edge/sitemap.xml
+++ b/docs/edge/sitemap.xml
@@ -4,7 +4,7 @@
<sitemap>
<loc>/en/sitemap.xml</loc>
- <lastmod>2025-09-14T10:16:45+08:00</lastmod>
+ <lastmod>2025-09-16T14:47:35-07:00</lastmod>
</sitemap>
diff --git a/docs/edge/zh/interface/ofs.html b/docs/edge/zh/interface/ofs.html
index ec855058..1c37dea5 100644
--- a/docs/edge/zh/interface/ofs.html
+++ b/docs/edge/zh/interface/ofs.html
@@ -484,7 +484,7 @@ ofs://omservice/tmp/key1
<p>或者使用 put 命令向桶中写入一个文件</p>
<div class="highlight"><pre tabindex="0"
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="display:flex;"><span>hdfs
dfs -put /etc/hosts /volume1/bucket1/test</span></span></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>
-<h2 id="与-o3fshahahugoshortcode112s5hbhb-的区别">与 <a
href="../../zh/interface/o3fs.html">o3fs</a> 的区别</h2>
+<h2 id="与-o3fshahahugoshortcode113s5hbhb-的区别">与 <a
href="../../zh/interface/o3fs.html">o3fs</a> 的区别</h2>
<h3 id="创建文件">创建文件</h3>
<p>OFS 不允许直接在根目录或卷下创建键（文件）。
当用户尝试这样做时，他们将收到一个错误消息：</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
