From d42095a60ef40fa8c17346e63e5990426ff92553 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Thu, 17 Dec 2015 09:39:40 +0200 Subject: Add section to INSTALL-DEV on granting Apache2 access to brep/ --- INSTALL-DEV | 30 ++++++++++++++++++++++++------ 1 file changed, 24 insertions(+), 6 deletions(-) (limited to 'INSTALL-DEV') 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 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 with your login and "www-data" with the user under which -apache2 is running. - CREATE DATABASE brep; CREATE USER ; GRANT ALL PRIVILEGES ON DATABASE brep TO ; @@ -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 and 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 and with the actual absolute paths You may want to replace /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 -- cgit v1.1