# CAT-Web installation on Debian and Debian Edu

## Versions

    2010-06-29 by Christian Kuelker, Kurt Gramlich - v0.1
    2010-07-03 by Christian Kuelker, Kurt Gramlich - v0.2
    2010-07-03 by Christian Kuelker, Kurt Gramlich - v0.3
    2010-07-03 by                    Kurt Gramlich - v0.4
    2010-07-15 by                    Kurt Gramlich - v0.5
    2010-07-16 by                    Kurt Gramlich - v0.6
    2010-07-16 by                    Kurt Gramlich - v0.7
    2010-07-17 by Christian Kuelker                - v0.8
    2010-07-30 by                    Kurt Gramlich - v0.9
    2010-07-30 by                    Kurt Gramlich - v1.0
    2010-07-30 by Christian Kuelker                - v1.1
    2010-07-30 by                    Kurt Gramlich - v1.2
    2011-01-10 by Erik Auerswald                   - v1.3

## Prerequisites

You need a working installation of CipUX with CipUX-RPC server up and running.


# Installing CAT-Web

    aptitude update
    aptitude install cipux-cat-web

You have to adjust some directory settings

    for i in log cache; do mkdir -p /var/$i/cipux-cat-web; chmod 750 /var/$i/cipux-cat-web; chown -R www-data:www-data /var/$i/cipux-cat-web; done

Only for Debian Edu you have also to create a link:

    ln -s /usr/share/cipux-cat-web/web /etc/debian-edu/www/cipux

# Configuring access to CAT-Web

List all unregistered CAT modules to see what is available. Use cipadmin as
login and the password you have used for cipadmin while installing CipUX.

    su -l www-data -c 'cipux_cat_web_module --list-deregistered'

The next step is to _register_ and _enable_ the modules you want to use. In any
case you should register index.cgi to see the first page of CAT. As an example
we also register language.cgi as the second module.

    su -l www-data -c 'cipux_cat_web_module --register --enable --add-member admins --verbose --object index.cgi'
    su -l www-data -c 'cipux_cat_web_module --register --enable --add-member admins --verbose --object language.cgi'

# First steps

To access the web front end of CAT use this URL:

    links http://localhost/cipux-cat-web/cat.cgi