Repository List / CipUX / trunk / cipux-core / / cipux / src / doc / install / debian / catweb_release_installation.mkd @ HEAD

# CAT-Web upstream release installation

## Versions

    2010-07-17 by Christian Kuelker                - v0.1

## Prerequisites

You need a working installation of CipUX with CipUX-RPC server up and running
and a running webserver. This guide uses apache2 as an example.

## Installing CAT-Web from upstream release

    perl -e 'use CPANPLUS;use CPANPLUS::Backend;$b=CPANPLUS::Backend->new;$c=$b->configure_object;$c->set_conf(verbose=>1);$c->set_conf(prereqs=>1);$c->set_conf(prefer_makefile=>0);$s=$b->selfupdate_object;$o0=$s->selfupdate(update=>"core",latest=>1);$i=$b->add_custom_source(uri=>"http://release.cipux.org",verbose=>1);$o1=$b->reload_indices;$b->install(modules=>[qw(CipUX::CAT::Web)]);'

## Setup

### Apache2

    invoke-rc.d apache2 restart

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