Dokeos 1.8.6.2 FREE : Installation Guide

Documentation > Installation Guide

Thank you for downloading Dokeos Babel FREE.

This guide explains how to install Dokeos FREE. Please read this fully before proceeding with the installation.

Check Dokeos PRO and Dokeos MEDICAL for a complete learning suite with a Service Level Agreement.

Contents

  1. Pre-requisites
  2. Installation of Dokeos LMS
  3. Upgrade from a previous version of Dokeos
  4. Troubleshooting
  5. Administration section
  6. LDAP 
  7. Mathematical formulas with LaTeX


1. Pre-requisites

Dokeos can be installed on Windows, Linux, Mac OS X and UNIX servers indifferently. However, we recommend the use of Linux server for optimal flexibility, remote control and scalability.

Dokeos is mainly a LMS running Apache 1.3, 2.0, MySQL 5.1 and PHP 5.1 (the so called AMP trilogy).

All these software are open source and freely available.

To run Dokeos LMS on your server, you need to install WAMP, LAMP or MAMP:

MySQL database server

You will need a login and password allowing to administrate and create at least one database. By default, Dokeos will create a new database for each course created. It means your host should allow you to create and administrate several databases. You can also install Dokeos using only one database, in that case you have to select this option during the installation.

2. Installation of Dokeos LMS


The following directories need to be readable, writeable and executable for everyone: (where 'dokeos' is the directory in which you installed Dokeos)

On Linux, Mac OS X and BSD operating systems you can use the CHMOD 777 command for this (although we recommend you seek advice from an experienced system administrator). In Windows, you may need to check the properties of the folders (by right-clicking on them).

2.5. The following files need to be readable and writeable for the web browser, only during the installation process:

On Linux, Mac OS X and BSD operating systems you can use the CHMOD 666 command for this (although we recommend you seek advice from an experienced system administrator). In Windows, you may need to check the properties of the files and folders (by right-clicking on them).

NOTES:
Do not modify the home_*.html files directly. Instead, choose "Configure the homepage" in the Dokeos administration section.

Windows : with combination packages like XAMPP, out of the box, login and password for MySQL should probably remain empty.

Configuration and security after installation


PHP configuration

To get the best of Dokeos, you need to finetune PHP settings. Consider :
max_execution_time = 300    ; Maximum execution time of each script, in seconds
max_input_time = 600 ; Maximum amount of time each script may spend parsing request data
memory_limit = 256M      ; Maximum amount of memory a script may consume (128MB)
post_max_size = 64M
upload_max_filesize = 100M

Some users could meet problems if their PHP settings don't fit these ones:

Past Dokeos versions required register_globals to be set to On. This is no longer necessary, this can be set to Off and Dokeos will work fine.

BSD users: these php libraries have to be included during php installation:

You might also add the following php modules and packages:


Valid XHTML 1.0 Transitional Valid CSS