Achievo Installation

From Achievo/ATK Wiki

Jump to: navigation, search

Contents

Installation Procedure

Note that this guide does not describe how to install a webserver or PHP or a database server. See the documentation for these programs on how to install those. This installation guide assumes that you already have a working webserver with PHP 5.2.x+ support and a MySQL 5+ database installed.

Important: this is the installation instruction for Achievo versions 1.0.RC1 and higher. The setup.php script mentioned did not yet exist in older versions. Older versions all contain a doc/ directory though inside the tar.gz file, which contains an INSTALL file describing how to get Achievo installed without a setup.php script.

Unpacking

After you've downloaded Achievo, untar the entire achievo archive to a place where you can access it with your webserver.

example:

    $ cd /usr/local/apache/htdocs # change to a web accessible directory
    $ tar xzvf ~user/achievo_x.x.tar.gz # unpack the tar.gz file

optional:

    $ ln -s achievo_x.x achievo # make a symbolic link

Create the database

Create an empty database in mysql and a user that has create, alter, select, insert, update, delete, lock tables, create view, drop and index-access on the database.

example (assuming your mysql root password is 'secret'):


    $ mysql -u root --password=secret
    mysql> create database achievo_1_0;
    mysql> grant create,alter,select,insert,update,delete,lock tables,
           create view,drop,index 
           on achievo_1_0.* to achievo@localhost identified by 'secret';
    mysql> quit;

This creates a database named 'achievo_1_0', and a user with username 'achievo' and password 'secret'.

Note: the create,alter,create view,drop and index privileges are only needed during installation and upgrades. You can revoke these privileges once the installation is complete.

Configure Achievo's database connection

Edit the file config.inc.php in the achievo directory, and set the $config_db["default"]["host"], $config_db["default"]["driver"], $config_db["default"]["db"], $config_db["default"]["user"] and $config_db["default"]["password"] variables to match your setup. example:

    $config_db["default"]["driver"] = "mysql";
    $config_db["default"]["host"] = "localhost";
    $config_db["default"]["db"]   = "achievo_1_0";
    $config_db["default"]["user"] = "achievo";
    $config_db["default"]["password"] = "secret";

Configure administrator login

In the same configuration file there is a variable $config_administratorpassword. This is the password you need on your first login. You might want to change this password.

There are some other things in the config-file that you can change, but for your first configuration, you can leave those settings to the default.

The Achievo database setup script

After editing the configuration file, point your browser to the setup.php script in the Achievo directory. For example:

    http://yourserver/achievo/setup.php

You'll be prompted to login. Enter 'administrator' as username and the password you've set in step 4.

Follow the instructions. Achievo will first perform some system checks, to see if your PHP configuration is up to date. If it discovers any problems, it will tell you how to solve them. If everything is ok, it will install the database for you.

Finished!

Once the setup.php script is completed, you'll be ready to run Achievo. You can point your browser to the Achievo directory, like this:

    http://yourserver/achievo/

If this is the first time you're using Achievo, you might want to take the Guided Tour, which will show you everything you should do to make Achievo useable for your users.

Cron script setup

Achievo contains some useful cron scripts that can be run periodically from a cron job. See the doc/CRON file in the Achievo distribution for available cron features and instructions.

Personal tools
Navigation