diff options
| -rw-r--r-- | INSTALL-DEV | 30 |
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 |