Add section to INSTALL-DEV on granting Apache2 access to brep/

1 files changed, 24 insertions, 6 deletions

diff --git a/INSTALL-DEV b/INSTALL-DEV
index 37d4571..979ce15 100644
--- a/INSTALL-DEV
+++ b/INSTALL-DEV
@@ -1,11 +1,29 @@
+The goal of this setup is to run the brep Apache2 modules from the development
+build while still being as close to the real deployment as possible. To this
+end, we use default, system-wide installations of both Apache2 and Postgres.
+
+In the below instructions replace <user> with your login and www-data with the
+user under which Apache2 is running (See the "User" directive in the Apache2
+.conf file).
+
+
+0. Checking Permissions
+
+Check that the files in the brep/ directory are readable by "others". If they
+are not, then run the following two commands to grant Apache2 read access:
+
+setfacl -Rdm g:www-data:rx brep
+setfacl --no-mask -Rm g:www-data:rx brep
+
+[Note that strictly speaking www-data in the above two commands is the Apache2
+group, not user. However, most installations use the same name for both.]
+
+
 1. Create PostgreSQL User and Database
 
 $ sudo su postgres
 $ psql
 
-Replace <user> with your login and "www-data" with the user under which
-apache2 is running.
-
 CREATE DATABASE brep;
 CREATE USER <user>;
 GRANT ALL PRIVILEGES ON DATABASE brep TO <user>;
@@ -35,9 +53,9 @@ $ psql -d brep -c 'SELECT name, summary FROM repository'
 
 3. Setup Apache2 Module
 
-Here we assume apache2 is installed and you have an appropriate VirtualServer
+Here we assume Apache2 is installed and you have an appropriate VirtualServer
 ready (the one for the default site is usually a good candidate). Open the
-corresponding apache2 .conf file and add the following inside VirtualServer,
+corresponding Apache2 .conf file and add the following inside VirtualServer,
 replacing <BREP-OUT-ROOT> and <BREP-SRC-ROOT> with the actual absolute paths
 (if you built brep in the source tree, then the two would be the same).
 
@@ -61,7 +79,7 @@ replacing <BREP-OUT-ROOT> and <BREP-SRC-ROOT> with the actual absolute paths
 You may want to replace <BREP-SRC-ROOT>/etc/brep.conf with a custom
 configuration file if you often need to modify it.
 
-Restart apache2 (use the second version for systemd):
+Restart Apache2 (use the second version for systemd):
 
 $ sudo /etc/init.d/apache2 restart
 $ sudo systemctl restart apache2