From f70c6c046fe26d9f7f75d9a063c6b481e7174781 Mon Sep 17 00:00:00 2001 From: Jean Pasdeloup Date: Wed, 27 Apr 2016 18:27:43 +0200 Subject: [PATCH] Add details about chmod +a vs setfacl --- book/installation.rst | 22 ++++++++++++---------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/book/installation.rst b/book/installation.rst index cf7fb16d12f..20ed7537f91 100644 --- a/book/installation.rst +++ b/book/installation.rst @@ -229,10 +229,9 @@ If there are any issues, correct them now before moving on. its user to be the same as your CLI user (e.g. for Apache, update the ``User`` and ``Group`` values). - **2. Using ACL on a system that supports chmod +a** + **2. Using ACL on a system that supports chmod +a (MacOS X)** - Many systems allow you to use the ``chmod +a`` command. Try this first, - and if you get an error - try the next method. This uses a command to + MacOS X allows you to use the ``chmod +a`` command. This uses a command to try to determine your web server user and set it as ``HTTPDUSER``: .. code-block:: bash @@ -244,14 +243,12 @@ If there are any issues, correct them now before moving on. $ sudo chmod +a "$HTTPDUSER allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs $ sudo chmod +a "`whoami` allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs + **3. Using ACL on a system that supports setfacl (most Linux/BSD)** - **3. Using ACL on a system that does not support chmod +a** - - Some systems don't support ``chmod +a``, but do support another utility - called ``setfacl``. You may need to `enable ACL support`_ on your partition - and install setfacl before using it (as is the case with Ubuntu). This - uses a command to try to determine your web server user and set it as - ``HTTPDUSER``: + Most Linux and BSD distributions don't support ``chmod +a``, but do support + another utility called ``setfacl``. You may need to `enable ACL support`_ + on your partition and install setfacl before using it. This uses a command + to try to determine your web server user and set it as ``HTTPDUSER``: .. code-block:: bash @@ -261,6 +258,11 @@ If there are any issues, correct them now before moving on. If this doesn't work, try adding ``-n`` option. + .. note:: + + setfacl isn't available on NFS mount points. However, setting cache + and logs over NFS is strongly not recommended for performance. + **4. Without using ACL** If none of the previous methods work for you, change the umask so that the