installation notes

INSTALL

@@ -0,0 +1,46 @@
+w.c.s. - Installation Instructions
+==================================
+
+Prerequisites
+-------------
+
+- Python 2.5 <http://www.python.org/>
+- Quixote 2.5 <http://www.mems-exchange.org/software/quixote/>
+- Lasso 2.2 <http://lasso.entrouvert.org/> for Liberty/SAML support
+
+
+Installation
+------------
+
+w.c.s. uses the standard distutils Python package; just run::
+
+  python setup.py install
+
+and you're done.
+
+
+Configuration
+-------------
+
+w.c.s. has been tested with Quixote configured through SCGI with Apache and 2
+The recommended configuration is to use SCGI version 1.8 or later (as it has
+the SCGIMount directive).
+
+SCGI usage requires an additional server to run, 'wcsctl.py start', the Debian
+package installs a init.d script automatically.
+
+  <VirtualHost *>
+      ServerAdmin webmaster@example.com
+      ServerName www.example.com
+      DocumentRoot /usr/share/wcs/web/
+      Alias /qo/ /usr/share/wcs/qommon/
+  
+      SCGIMount / 127.0.0.1:3001
+      <LocationMatch "^/(css|images|js|qo)/.*">
+          SCGIHandler off
+      </LocationMatch>
+  
+      CustomLog /var/log/apache2/wcs-access.log combined
+      ErrorLog /var/log/apache2/wcs-error.log
+  
+  </VirtualHost>