Skip to content

Commit 02dfcf0

Browse files
committed
fix: add note about change in behaviour of the job
1 parent bae6fc4 commit 02dfcf0

File tree

1 file changed

+19
-1
lines changed

1 file changed

+19
-1
lines changed

admin_manual/configuration_files/file_versioning.rst

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,4 +54,22 @@ Deactivate background job: ``occ config:app:set --value=no files_versions backgr
5454

5555
Activate background job: ``occ config:app:delete files_versions background_job_expire_versions``
5656

57-
Expire versions: ``occ versions:expire`` or ``occ versions:expire --quiet`` (without the progress bar)
57+
Expire versions: ``occ versions:expire`` or ``occ versions:expire --quiet`` (without the progress bar)
58+
59+
.. note::
60+
61+
*Deviations in behavior: “job run” vs “auto-expiry”*
62+
63+
The ``versions_retention_obligation`` setting behaves slightly differently
64+
depending on whether version expiration is triggered by an *explicit job run*
65+
(for example, via ``occ versions:expire`` or a scheduled background job) or by
66+
*automatic expiry*.
67+
68+
Explicit job-based expiration is *strict* and adheres closely to the configured
69+
``versions_retention_obligation``.
70+
71+
Auto-expiry follows the same retention principles but may apply them more flexibly, allowing minor deviations when
72+
necessary to maintain adequate free storage space.
73+
74+
This distinction can lead to different results depending on whether cleanup is
75+
performed automatically or manually.

0 commit comments

Comments
 (0)