diff --git a/docs/website/installation.php b/docs/website/installation.php index c7a26a85..f25548aa 100644 --- a/docs/website/installation.php +++ b/docs/website/installation.php @@ -5,7 +5,7 @@

Before Starting

Debian Users

-

Ideally you will be running a recent Debian release and will +

Ideally you will be running a recent Debian (or Ubuntu) release and will be able to add:

 deb http://debian.mcmillan.net.nz/debian unstable awm
@@ -14,11 +14,25 @@ deb http://debian.mcmillan.net.nz/debian unstable awm
 can use apt-get or synaptic or some other equivalent package
 manager to fetch and install rscds and all the dependencies.

+

This repository is signed by my public key, which you can install so that +you don't get asked for confirmation all the time:

+ +
+sudo apt-key advanced --keyserver subkeys.pgp.net --recv-keys CCA377BD77494424B0DB674F8C90347F8F068012
+
+

Skip to the "Database Setup" part if you have done that already.

Other Linux Users

+

RPM Packages of RSCDS

+

I have created RPM packages of RSCDS and libawl-php from the .deb packages +using "alien". I don't know how well these work, so would appreciate feedback +about your success with them.

+ +

Gentoo, Slackware, BSD and the rest

+

You will need to download the latest versions of the rscds and awl packages from the sourceforge download page for rscds.

You will need to untar these. Preferably you will untar them from within the "/usr/share" directory and everything @@ -49,7 +63,7 @@ a number of years.

The PostgreSQL database may be installed on a server other @@ -74,9 +88,16 @@ and which will be granted minimum privileges for the application.

createuser --no-createdb --no-createrole general
+

PostgreSQL 7.4 named things slightly differently, so you +should use something like:

+ +
+createuser --no-createdb --no-adduser general
+
+

You may need to become the 'postgres' user to do this, in which case you will need to be the postgres user to create the database as well. -For example:

+For example (for PostgreSQL 8.x):

 su postgres -c createuser --no-createdb --no-createrole general
 
@@ -142,6 +163,9 @@ installed from a package.

able to browse to that address and see a page telling you that you need to configure RSCDS.

+

On Debian systems (or derivatives such as Ubuntu), when you are +using Apache 2, you should put this definition in the /etc/apache2/sites-available +directory and you can use the 'a2ensite' command to enable it.

RSCDS Configuration

@@ -225,6 +249,15 @@ leaves passwords readable like this for security reasons.

If all is working then you should be ready to configure a client to use this, and the docs for that are elsewhere.

+

Upgrades

+ +

Whenever you upgrade the RSCDS application to a new version you will need to +run dba/update-rscds-database which will apply any pending database patches, as well as +enabling any new translations.

+ +

In due course the running of this script will be able to be handled by +the packaging system, but that change will not happen until early 2007.

+ \ No newline at end of file