Installation

You can either:

• run ergolang on this server (please contact to have your own login)
• use a copy and run it on your web or localhost server

If you plan to use it not on the main server, read the following

REQUIREMENTS
------------

First you must have the base environment for phpCake

The following 3 are so-called LAMP (Linux), MAMP (Mac) or WAMP (Windows), you can get the separately or in a packet

Apache	-> http://www.apache.org
MySQL	-> http://www.mysql.com
PHP	        -> http://www.php.net

Then you need the cake framework

phpCake -> http://cakephp.org/

SERVER CONFIGURATION
--------------------

You MUST ensure that PHP has been compiled with support for MySQL and Zlib
in order to successfully run Эrgolang.


INSTALLATION
------------

1. DOWNLOAD Эrgolang

	You can obtain the latest Эrgolang release from:

http://www.akademia.ch/websites/ergolang/downloads

       Download the latest version of the scripts and database structure

       Create /var/www/websites/ergolang/cake, which will be seen by your virtual local server as 
       http://localhost/websites/ergolang/cake

	Copy the tar.gz file into this directory.

	$ cp ergolangVx.x.x-Stable.tar.gz /var/www/websites/ergolang/cake

	Change to the working directory e.g.

	$ cd /var/www/websites/ergolang/cake

	Extract the files e.g.

	$ tar -zxvf ergolangVx.x.x-Stable.tar.gz

	This will extract all ergolang files and directories.  Move the contents
	of that directory into a directory within your web server's document
	root or your public HTML directory e.g.

	Alternatively if you downloaded the file to your computer and unpacked
	it locally use a FTP program to upload all files to your server.
	Make sure all PHP, HTML, CSS and JS files are sent in ASCII mode and
	image files (GIF, JPG, PNG) in BINARY mode.

       #clear the cache (usefull also in case of bug) using script clearcache.sh
       cd app
       chmod 700 clearcache.sh
       ./clearcache.sh
      #change tmp permissions if needed
      chmod -R 777 tmp

2. CREATE THE ergolang DATABASE

	ergolang will currently only work with MySQL.  In the following examples,
	"db_user" is an example MySQL user which has the CREATE and GRANT
	privileges.  You will need to use the appropriate user name for your
	system.

	First, you must create a new database for your ergolang site e.g.

	$ mysqladmin -u db_user -p create ergolang

	MySQL will prompt for the 'db_user' database password and then create
	the initial database files.  Next you must login and set the access
	database rights e.g.

	$ mysql -u db_user -p

	Again, you will be asked for the 'db_user' database password.  At the
	MySQL prompt, enter following command:

	GRANT ALL PRIVILEGES ON ergolang.*
		TO nobody@localhost IDENTIFIED BY 'password';

	where:

	'ergolang' is the name of your database
	'nobody@localhost' is the userid of your webserver MySQL account
	'password' is the password required to log in as the MySQL user

	If successful, MySQL will reply with

	Query OK, 0 rows affected

	to activate the new permissions you must enter the command

	flush privileges;

	and then enter '\q' to exit MySQL.

	Alternatively you can use your web control panel or phpMyAdmin to
	create a database for ergolang.

        cp app/config/core.php.default app/config/core.php
        cp app/config/database.php.default app/config/database.php
        edit both files and adapt them to your MySQL and local settings

3. DOWNLOAD DATAS

	You can obtain the latest Эrgolang dictionaries at:

http://www.akademia.ch/websites/ergolang/downloads/vocs

Choose the dictionaries for the language/s you want to learn; for some languages, stemmings and stopwords are available (eg. russian)

4. CONFIGURE ergolang

You can now launch your browser and point it to your ergolang site e.g.

	http://www.mysite.org

You can log into Admin using the username 'admin', password 'passwd'.
PLEASE change the password asap for security reasons


Additional informations are
available at http://www.akademia.ch/websites/ergolang