By admin, August 14, 2009 7:39 pm


At this time (initial release 0.1.0) the installation process is very basic. There’s no installer, you’ll have to do most of the work yourself. However the results will be worth it I promise. If you get stuck on any of the steps below then there’s plent of help available. Here’s the process:

  1. Get an AMP stack (preferably a LAMP stack) that meets the requirements.
  2. Download and install CakePHP into the root directory of your web server (or a sub-directory if preferred). On most systems that’ll be the htdocs directory, for example /srv/www/htdocs/
  3. Make sure CakePHP is working properly with particular regard to .htaccess and the Apache mod_rewrite module. For instance the CakePHP homepage on your server should be nicely formatted with colour. If it looks very plain then it’s likely you need to do some web server configuration. There’s details of how to do this in the CakePHP installation instructions. Also try searching the CakePHP Google group.

    In particular you may need a .htaccess file in your top CakePHP directory (I did). My .htaccess file contains this:

    <IfModule mod_rewrite.c>
       RewriteEngine on
       RewriteRule    ^$ app/webroot/    [L]
       RewriteRule    (.*) app/webroot/$1 [L]

  4. Create a database. Call it what you like, just make sure you’ve a note of the database administration user name and password.
  5. Download KPInator and uncompress it. Move the contents of the release folder  into the app directory in your CakePHP installation. Overwrite any files that already exist there.
  6. Edit your CakePHP database configuration file app/config/database.php. Update your database_config class with your host name and database parameters.
  7. In the directory app/config/sql is a file used to create the tables and populate some of them. You should import this into your database. If you’re not familiar with MySQL then the PHPMyAdmin tool is brilliant for working with the database.The file name is kpinator_install.sql.
  8. Download JPGraph and install this into your vendors directory. Under your  CakePHP top directory you should then have vendors/jpgraph

That’s all there is to it. You can now log into your KPInator system using your web browser. For example if you’ve installed KPInator into a subdirectory called ‘kpis’ then the url would be:


The initial user name and password is admin and admin. Log in as the admin user and use the Chnage Password facility to change the password to something more secure.

Let me know through the support system if you run into any problems.


Leave a Reply

Panorama theme by Themocracy