Add details about chmod +a vs setfacl

Author: pasdeloup

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