General instructions for a kOOL installation

Here you'll find some installation instructions. Be sure to read them carefully.

To be able to run kOOL on your own server, you should know how to run a basic webserver with apache, php and mysql.

To get the most out of your kOOL installation you should also have access to an LDAP server and be able to run WebDAV on your webserver.

Supported platforms

So far kOOL has only been tested on GNU/Linux Systems based on Debian (sarge/etch). But it should run on all kinds of GNU/Linux distributions.

kOOL might also run on a windows server. Only the fileshare functionality will not work, because hard links are used in certain cases, which are not supported on windows filesystems.

If you manage to run kOOL on other platforms, we would like to know about it. Also improvements to the installation process and instructions are very welcome.

Basic apache configuration

The following configuration directives for apache are provided in the hope, that they are helpful. They work on the testing system, but are not guaranteed to work on yours.

Replace "kOOL_demo" with the name of your kOOL directory.

Enable CGI for fileshare

<IfModule mod_alias.c>

<Directory /var/www/kOOL_demo/fileshare/cgi>
    AllowOverride None
    Options ExecCGI
    Order allow,deny
    Allow from all
</Directory>

</IfModule>

VirtualHost configuration

<VirtualHost ip.of.your.server:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/kOOL_demo
    ServerName your.kool.com
    ScriptAlias /fileshare/cgi/ /var/www/kOOL_demo/fileshare/cgi/

</VirtualHost>

PEAR classes

kOOL depends on some PEAR classes to allow certain functionalities (see http://pear.php.net )::

Auth: For authentication
DB: For database access
Calendar: For calendar views
OLE, Spreadsheet_Excel_Writer: For excel export