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/

      SCGIMount / 127.0.0.1:3001

      # this part allows serving static files directly from Apache, but it
      # requires to run wcsctl.py collectstatic first.
      Alias /static/ /var/lib/wcs/collectstatic/
      <LocationMatch "^/static">
          SCGIHandler off
      </LocationMatch>

      # this part allows serving the themes directly from Apache, but it
      # requires mod_rewrite
      Alias /themes/ /usr/share/wcs/themes/
      RewriteEngine On
      RewriteCond  /usr/share/wcs/%{REQUEST_URI}  !-f
      RewriteCond  /usr/share/wcs/%{REQUEST_URI}  !-d
      RewriteRule  ^/themes/(.*)$ /var/lib/wcs/%{HTTP_HOST}/themes/$1

      CustomLog /var/log/apache2/wcs-access.log combined
      ErrorLog /var/log/apache2/wcs-error.log

  </VirtualHost>
