[GitHub] [james-project] chibenwa commented on a change in pull request #631: JAMES-3150 Document blob garbage collection

[GitBox <gi...@apache.org>]

chibenwa commented on a change in pull request #631:
URL: https://github.com/apache/james-project/pull/631#discussion_r699228964



##########
File path: src/site/xdoc/server/config-blobstore.xml
##########
@@ -53,14 +53,34 @@
                     The generated startup warning log can be deactivated via the <code>cassandra.blob.store.disable.startup.warning</code> environment
                     variable being positioned to <code>false</code>.
                 </dd>
+                Deduplication requires a garbage collector mechanism to effectively drop blobs. A first implementation
+                based on bloom filters can be used and triggered using the WebAdmin REST API. See
+                xref:distributed/operate/webadmin.adoc#_running_blob_garbage_collection[Running blob garbage collection].
 
+                In order to avoid concurrency issues upon garbage collection, we slice th blobs in generation, the two more recent
+                generation are not garbage collected.
+
+                *deduplication.gc.generation.duration*: Allow controlling the duration of one generation. Longer implies better deduplication
+                but deleted blobs will live longer. Duration, defaults on 30 days, the default unit is days.
+
+                *deduplication.gc.generation.family*: Every time the duration is changes, this integer counter must be incremented to avoid
+                conflicts. Defaults to 1.

Review comment:
       ```suggestion
   ```




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org