X-Git-Url: https://the.earth.li/gitweb/?a=blobdiff_plain;f=doc%2Fapache2;fp=doc%2Fapache2;h=5060867ba9c568c2c29b73c1313e98d567f34b3e;hb=f64729f7ef5bf4fde2e86f2cab93dc26f056fae6;hp=0000000000000000000000000000000000000000;hpb=f3745f1a2bbf08e7e1abed1a980f076ffa4f1dfd;p=onak.git

diff --git a/doc/apache2 b/doc/apache2
new file mode 100644
index 0000000..5060867
--- /dev/null
+++ b/doc/apache2
@@ -0,0 +1,23 @@
+Brett's rough guide to onak and Apache2 on Debian:
+
+1) create a new virtual host for apache2 as the config snippet below in
+	/etc/apache2/sites-available/keyserver and symlink it in
+	/etc/apache2/sites-enabled/
+2) edit the /etc/apache2/ports.conf file and add Listen 11371
+3) edit the /etc/apache2/sites-available/default file and change the
+	NameVirtualHost and VirtualHost directives to only play with
+	port 80
+4) make sure that suexec is *NOT* enabled in apache2 (remove the
+	suexec.load symlink from /etc/apache2/mods-enabled/ if it
+	exists), this is because suexec will not run the cgi scripts
+	located in the /usr/lib/cgi-bin/pks directory.
+5) apache2ctl graceful
+6) marvel as it all works.
+
+Apache2 config snippet:
+	<VirtualHost *:11371>
+		DocumentRoot /var/lib/onak
+		ScriptAlias /pks /usr/lib/cgi-bin/pks
+		CustomLog /var/log/apache2/keyserver-access.log combined
+		ErrorLog /var/log/apache2/keyserver-error.log
+	</VirtualHost>