Achievo/Manual/Installation/Installation and update/Installation/windows workstation
From Achievo/ATK Wiki
This manual will describe how to install Achievo on a Windows Workstation like XP or Vista with the help of a WAMP package.
Contents |
Install WAMP
You can use any WAMP package you want, but in the manual we will describe how to install Achievo with the Vertrigo package. After downloading the executable click on it an follow the instructions on the screen.
Install Achievo
Download Achievo and unzip it to a directory of your choice. In this manual we will use the directory C:\www\achievo for it.
Configure Apache
First go to the directory where config files are located, in my installation this is: C:\Program Files\VertrigoServ\Apache\conf. Here you need to create a new directory called: 'vhosts'. Then edit the httpd.conf with your favorite text editor and search for Section 3, Virtual Hosts and make sure you have the following lines:
NameVirtualHost *:80 Include conf/vhosts/*.conf
In the vhosts directory place a file called 'achievo.conf' with:
<VirtualHost *:80>
DocumentRoot "c:\www\achievo"
ServerName achievo
<Directory "C:\www\achievo">
Options Indexes FollowSymLinks Includes
AllowOverride All
Order allow,deny
Allow from All
</Directory>
</VirtualHost>
You can change 'C:\www\achievo' into the directory where you install Achievo.
Hosts file
To access the achievo installation with the url http://achievo you need to edit the hosts file. On Windows XP you can find that on: C:\WINDOWS\system32\drivers\etc Edit the file with your favorite text editor and add the following line:
127.0.0.1 localhost achievo
Probably the localhost will already exist, in that case just add achievo to it (seperated with a space).
Configure MySQL
To setup the database we will use PhpMyAdmin which is included in the Vertrigo package. You can find it by browsing to:
http://localhost
This will give you a menu called 'Tools and Links' where you can find PhpMyAdmin. When it asked for the login enter:
Username: root Password: vertrigo
Search for the 'Create new database' and insert 'achievo_1_3' into the input box below. Then click on create and it will create the database for your Achievo installation.
Important: In this manual we will use the root account to connect to the database, if you are going to use this in production you have to create an user account for this with the rights: create,alter,select,insert,update,delete,lock tables.
Configure Achievo's database connection
Edit the file config.inc.php in the achievo directory, and set the $config_databasehost, $config_databasename, $config_databaseuser and $config_databasepassword, $config_database variables to match your setup.
example:
$config_databasehost = "localhost";
$config_databasename = "achievo_1_3";
$config_databaseuser = "root";
$config_databasepassword = "vertrigo";
$config_database = "mysqli";
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://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://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 cron/README file in the Achievo distribution for available cron features and instructions.
|
