INSTALL

Kimono Install Notes
--------------------

Requirements
------------
+ PHP 5 (http://www.php.net) (5.0.4 or better is recommended) with MySQL support,
  (additional extensions support might be required for certain services).
+ MySQL Server 4.x (http://www.mysql.com)
+ a PHP-capable webserver, preferably Apache (http://httpd.apache.org)
+ Kimono has been tested on Linux, Mac OS X, Windows 2000, Windows XP and FreeBSD
  but supposedly works on all platforms fullfilling the above requirements.


Getting started
---------------
Create a database and grant a user permissions to it, execute the kimono.sql file
from the "sql" folder on the database server, be sure to select the correct database.

on UNIX you can do:

mysql -u <user> -p <database> < kimono.sql

Open "settings.php" in the "include" folder in a text editor, edit the
variables at to suit your mysql server settings and save the file.

Point your browser to the location of "<install folder>/interface/web/index.php" and
log in using the username and password "admin". Change directory to
"<install folder>interface/daemon" and run "php daemon.php" (or "php.exe daemon.php"
on Windows) to start the daemon.
Find out more about the daemon by using the "--help" switch.

Note: if the web interface seems slow, try enabling the query cache on your
MySQL server, it can speed up recurring database queries tremendously.


Upgrading
---------

When upgrading, you might need to update the database or you might get errors
running kimono. The "sql" folder contains SQL scripts that needs to be executed
prior to running the updated version. First back up your database and then
execute the correct update script. Keep in mind that some configuration values
might be reverted to the default value when upgrading.


Feedback
--------
Please report any feedback or problems in the forum:
http://www.downshift.org/kimono/forum/