Add some crude installation instructions.

Along the way, make some improvements to the template httpd.conf
fragment.

diff --git a/INSTALL b/INSTALL
new file mode 100644 (file)
index 0000000..7f23222
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,15 @@
+On Fedora, you will need the following packages; details may differ on
+other platforms.
+
+httpd mod_fcgid
+perl-CGI perl-FCGI perl-Date-Calc perl-Template-Toolkit
+perl-DBD-Pg perl-XML-RSS perl-libapreq2
+postgresql-server
+
+Use the etc/httpd.conf.template file to configure Apache, adjusting the
+details to fit your environment.  For each instance of BASEPATH, substitute
+the directory where this INSTALL file is located.
+
+You must run Apache under the same user id that owns the pgcommitfest tree.
+The mod_cgid run directory (on Fedora, the default is /var/run/mod_fgid) must
+also be owned by that user.

diff --git a/etc/httpd.conf.template b/etc/httpd.conf.template
index db8f0414f9b40942f51a709dd64f3c1b2af23446..1512106d373e65a2da68c71e7154cf58309c71c6 100644 (file)
--- a/etc/httpd.conf.template
+++ b/etc/httpd.conf.template
@@ -1,4 +1,7 @@
-AddDefaultCharset UTF-8  # unless already present in default config
+# The following line may already be present in httpd.conf; don't duplicate it.
+AddDefaultCharset UTF-8
+
+Listen 8080
 
 <VirtualHost *:8080>
     DocumentRoot "BASEPATH/html"
@@ -15,3 +18,6 @@ AddDefaultCharset UTF-8  # unless already present in default config
     Options Indexes FollowSymLinks ExecCGI
     AllowOverride None
 </Directory>
+
+# In addition to the above settings, you will need to set User and Group to
+# your user ID - that is, the user that owns the pgcommitfest directory tree.