From bb393f38ebeac38b4bfe56916ed0b6e9fd5f07d6 Mon Sep 17 00:00:00 2001 From: Sascha Wiswedel Date: Mon, 16 Nov 2020 11:43:57 +0100 Subject: [PATCH] documented usage of variables for external storages Signed-off-by: Sascha Wiswedel --- .../images/externalStorages_variables.png | Bin 0 -> 4962 bytes .../external_storage_configuration_gui.rst | 17 +++++++++++++++++ .../configuration_user/user_auth_ldap.rst | 1 + 3 files changed, 18 insertions(+) create mode 100644 admin_manual/configuration_files/external_storage/images/externalStorages_variables.png diff --git a/admin_manual/configuration_files/external_storage/images/externalStorages_variables.png b/admin_manual/configuration_files/external_storage/images/externalStorages_variables.png new file mode 100644 index 0000000000000000000000000000000000000000..7136012622885e9131768c05541e629afe0ac868 GIT binary patch literal 4962 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 literal 0 HcmV?d00001 diff --git a/admin_manual/configuration_files/external_storage_configuration_gui.rst b/admin_manual/configuration_files/external_storage_configuration_gui.rst index ccf066d3d..2596e0c2c 100644 --- a/admin_manual/configuration_files/external_storage_configuration_gui.rst +++ b/admin_manual/configuration_files/external_storage_configuration_gui.rst @@ -48,6 +48,23 @@ re-check your configuration and network availability. If there is an error on the storage, it will be marked as unavailable for ten minutes. To re-check it, click the colored icon or reload your Admin page. +Usage of variables for mount paths +---------------------------------- + +The external storage mounting mechanism accepts variables in the mount path. + +Use ``$user`` for automatic substitution with the logged in user's username. + +Use ``$home`` for automatic substitution with a configurable home directory variable +(requires LDAP, see :ref:`LDAP_Special_Attributes` in the LDAP configuration documentation for details) + +In the following example, the mount point for a logged in user "alice" would substitute +to ``/opt/userDirectories/alice/myPictures``. + +.. figure:: external_storage/images/externalStorages_variables.png + :alt: External storage user variable substitution + + User and group permissions -------------------------- diff --git a/admin_manual/configuration_user/user_auth_ldap.rst b/admin_manual/configuration_user/user_auth_ldap.rst index 82b9c0817..6527696fd 100644 --- a/admin_manual/configuration_user/user_auth_ldap.rst +++ b/admin_manual/configuration_user/user_auth_ldap.rst @@ -424,6 +424,7 @@ Default password policy DN: | *cn=default,ou=policies,dc=my-company,dc=com* +.. _LDAP_Special_Attributes: Special attributes ^^^^^^^^^^^^^^^^^^