Diogenes Documentation

2. Installation

This document describes the steps you need to take to install the Diogenes content management system on your web server. Installation from source and installation using the Debian packaged version are both described. Finally, upgrading from a previous version of Diogenes is discussed.

2.1. Requirements

To install Diogenes you need:

You can install the following to make use of some Diogenes' optional features:

2.2. Installing Diogenes from source

You can always find the latest version of Diogenes on the Diogenes project page : http://opensource.polytechnique.org/diogenes/.

2.2.1. Extract Diogenes

Extract the Diogenes tarball in the directory of your choice. 

tar zxf diogenes.tar.gz

2.2.2. Create the RCS and spool directories

To store the web pages and files that make up the "barrels" (web sites) you need to create two directories and make them writable by your web server. For example if the user "www-data" owns the web server process you might type: 

mkdir /var/lib/diogenes /var/spool/diogenes
chown www-data /var/lib/diogenes /var/spool/diogenes

We also need to create cache directories for Smarty and for Diogenes. 

mkdir /var/spool/diogenes/templates_c /var/spool/diogenes/diogenes_c
chown www-data /var/spool/diogenes/templates_c /var/spool/diogenes/diogenes_c

You can of course choose your own directory location as long as you make the corresponding change in Diogenes' configuration file (see below).

2.2.3. Create Diogenes database

To function, Diogenes needs a MySQL database and a few tables to start off with. The SQL structure of the database is available in config/db/diogenes.sql.

There are also some entries that need to be created for Diogenes' logging system to work. The corresponding MySQL dump is in config/db/diogenes.logactions.sql

Finally, you will need a MySQL user who has full privileges on the database you chose for Diogenes.

2.2.4. Copy and adjust configuration files

You need to copy the configuration file config/config.diogenes.inc.php.dist into the "include" directory and edit it to fit your local configuration. 

cp config/config.diogenes.inc.php.dist
include/config.diogenes.inc.php
vi include/config.diogenes.inc.php

2.2.5. Adjust your PHP include path

For Diogenes to function, PHP has to be able to locate the PHP files that hold Smarty's class definitions and those for Diogenes's class definitions. If you installed Diogenes to /aaa/bbb/diogenes and the Smarty classes are in /foo/bar/smarty your include_path would look like: 

".:/aaa/bbb/diogenes/include:/foo/bar/smarty"

2.2.6. Create an initial user

The final step in setting up Diogenes is to create a first user account so that you can log in! If you installed Diogenes to http://foo/diogenes/, the easiest way to create this initial user is to visit the page http://foo/diogenes/toplevel/boot.php.

Alternatively, the following MySQL command creates a user called "root" without a password. You can then login and change password using the user account manager. 

use diogenes;
insert into diogenes_auth set username="root",password=MD5(""),perms="admin";

2.3. Upgrading from a previous version of Diogenes

Upon upgrading from a previous version of Diogenes, you need to make sure that your database structure is up to date. Running the config/updatedb.php will take care of this and make the necessary adjustments for you.

2.4. Installing Diogenes using the Debian package

For users of the Debian GNU/Linux operating system, this is by far the most convenient option. The package automatically performs the operations necessary to get Diogenes up and running.

2.4.1. Install the diogenes package

All you need to do is run the following: 

apt-get update
apt-get install diogenes

You will be prompted for information about your MySQL database and Diogenes will be installed for you.

2.4.2. Create an initial user

The instructions of section 2.2.6 will help you create an intial user to administrate Diogenes and you're done!

$Id: page.html,v 1.11 2005/05/16 08:52:11 jeremy.laine.1999 Exp $