	Debian particularities of the Collabtive installation
	=====================================================

Collabtive's behaviour in Debian varies slightly from the documented
behaviour. It should not affect your system's users, but as an
administrator, you should be aware of the following:

1. Completing the Installation
------------------------------

Collabtive ships with an installation helper, install.php. In order to
run it, point your browser to:

  http://localhost/collabtive/install.php

The installer requires the configuration (/etc/collabtive/config.php)
to be writable to, but for security, we do not ship that file with
write permissions, given that part of its functionality is to create
and populate the initial database, it can be destructive. When you
are ready to configure Collabtive, type the following command as root:

  # chmod u+w /etc/collabtive/config.php

Debian ships with a modified version of the installer that, once the
install has been finished, locks the configuration file and creates an
/etc/collabtive/flags/configured file (its contents are not
important). If this file is found, the installer will not be run.  If
you have to run the install script again, issue as root:

  # rm /etc/collabtive/flags/configured

In order to run the installer, you will also need to make the
configuration file itself writable to. You can do it by issuing again,
as root:

  # chmod u+w /etc/collabtive/config.php

It is VERY recommended you protect this file again as soon as your
system is configured:

  # chmod u-w /etc/collabtive/config.php

2. Updates
----------

Whenever there are Collabtive system updates, upstream recommends
calling the "update.php" file. In the default configuration, it will
be present in:

  http://localhost/collabtive/update.php

When you install new Debian-packaged versions of Collabtive, if the
"wget" package is present, this URL will be called. However, in case
you have moved your host's Collabtive URL, or have any doubts on
whether it was called, you can manually invoke it — It should be safe
to be called repeatedly.

 -- Gunnar Wolf <gwolf@debian.org>, Mon, 28 Oct 2013 18:56:03 -0600
