server: add README file (#270)

server/README

@@ -0,0 +1,34 @@
+Tabellio Preview Server
+=======================
+
+SCGI server handling calls to various scripts, to provide remote support for
+converting and transforming between formats.
+
+
+Init script
+-----------
+
+init.d/ has init scripts both for Debian and OpenSUSE.
+
+
+Apache configuration
+--------------------
+
+The mod_scgi module has to be installed, then it's a matter of configuring
+a virtual host to pass requests to the SCGI server; a basic configuration
+looks like this::
+
+  <VirtualHost *:80>
+    ServerName preview.tabellio.pcf.be
+    DocumentRoot /opt/preview.tabellio.pcf.be/web
+
+    CustomLog /var/log/apache2/preview.tabellio.pcf.be/access.log combined
+    ErrorLog /var/log/apache2/preview.tabellio.pcf.be/error.log
+
+    <LocationMatch "^/preview/.*">
+      SCGIServer 127.0.0.1:2151
+      SCGIHandler On
+      SCGIServerTimeout 600
+    </LocationMatch>
+
+  </VirtualHost>

server/init.d/tabellio-preview-server.debian.init

@@ -29,7 +29,9 @@ fi
 #	Function that starts the daemon/service.
 #
 d_start() {
-	su $TABELLIO_USER -c $DAEMON --pid $PIDFILE
+	touch $PIDFILE
+	chown $TABELLIO_USER $PIDFILE
+	su $TABELLIO_USER -c "$DAEMON --pid $PIDFILE"
 }
 
 #