diff --git a/INSTALL b/INSTALL new file mode 100644 index 000000000..041c07c0b --- /dev/null +++ b/INSTALL @@ -0,0 +1,46 @@ +w.c.s. - Installation Instructions +================================== + +Prerequisites +------------- + +- Python 2.5 +- Quixote 2.5 +- Lasso 2.2 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. + + + 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 + + SCGIHandler off + + + CustomLog /var/log/apache2/wcs-access.log combined + ErrorLog /var/log/apache2/wcs-error.log + +