Fixes #304 - Added hint for symlink

zammad · Sep 19, 2023 · fb5096c · fb5096c
1 parent 2346475
commit fb5096c
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 1 deletion.
diff --git a/locale/admin-docs.pot b/locale/admin-docs.pot
@@ -13260,7 +13260,7 @@ msgstr ""
 msgid "Storage"
 msgstr ""
 
-#: ../settings/system/storage.rst:21
+#: ../settings/system/storage.rst:31
 msgid "Storage Mechanism"
 msgstr ""
 
@@ -13273,10 +13273,22 @@ msgid "By default we're writing to the ``Database`` - you can switch to ``Filesy
 msgstr ""
 
 #: ../settings/system/storage.rst:15
+msgid "🤔 **But which one to use?**"
+msgstr ""
+
+#: ../settings/system/storage.rst:17
 msgid "We strongly encourage you to use filesystem storage on busy instances. This will greatly improve system performance (de-crease database load and size)."
 msgstr ""
 
 #: ../settings/system/storage.rst:21
+msgid "**You noticed slow updates of Zammad?**"
+msgstr ""
+
+#: ../settings/system/storage.rst:23
+msgid "While Zammad is beeing updated, it enforces a recursive \"change owner\" (chown) for this directory. For instances with many files this can be time consuming. To mitigate that you can move your files and create a symlink in ``/opt/zammad/storage/`` to the new directory. Of course you have to make sure on your own that the permissions are always correct."
+msgstr ""
+
+#: ../settings/system/storage.rst:31
 msgid "Moving attachments from Database to Filesystem can be run during production use."
 msgstr ""
 

diff --git a/settings/system/storage.rst b/settings/system/storage.rst
@@ -12,10 +12,20 @@ Storage Mechanism
 
    .. note::
 
+      🤔 **But which one to use?**
+
       We strongly encourage you to use filesystem storage on busy instances.
       This will greatly improve system performance (de-crease database load
       and size).
 
+      **You noticed slow updates of Zammad?**
+
+      While Zammad is beeing updated, it enforces a recursive "change owner"
+      (chown) for this directory. For instances with many files this can
+      be time consuming. To mitigate that you can move your files and create a
+      symlink in ``/opt/zammad/storage/`` to the new directory. Of course you
+      have to make sure on your own that the permissions are always correct.
+
    .. tip::
 
       Moving attachments from Database to Filesystem can be run during