wcs/INSTALL

55 lines
1.5 KiB
Plaintext

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>
# 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>