**************************** Dokeos 1.5.5 INSTALLATION **************************** Thank you for downloading Dokeos 1.5.5 This README will guide you through the basics of installation and operation of Dokeos 1.5.5 Please ensure you read this fully BEFORE proceeding with the installation. CONTENTS - Requirements - Installation Procedure - New Dokeos installation - Upgrade from previous Claroline or Dokeos version - Troubleshooting - Admin - Ldap REQUIREMENTS ============ To install Dokeos 1.5.5 on a server, whether locally or remotely, you need the following on the server: 1. A web server (We recommend Apache, but others should work too), 2. PHP 4.x configured with the following modules : mysql, zlib, preg, xml. You need the ldap module too if you want to use ldap with Dokeos. Most of the PHP4 compiled distributions are provided with these modules. Anyway, their presence is checked by the Dokeos install script. Some users could meet problems if their PHP setting doesn't fit these ones: short_open_tag = On register_globals = On safe_mode = Off magic_quotes_gpc = On magic_quotes_runtime = Off For example, users with PHP 4.2 and superior should set the parameter register_globals = on 3. The MySQL databases server plus a login/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. If you want to use Dokeos on a 'single database host' you have to select this option on puropose at install. Note : it seems the backticks charachters (`) inserted inside most of the Dokeos SQL queries since Claroline 1.3 doesn't work with MySQL versions previous to 3.23.6. 4. Web Write access to web directory where Dokeos has been moved or unzipped to. On a Windows machine locally, this is not a problem. Remotely, you need to be allowed to CHMOD through FTP, telnet or any means. INSTALLATION PROCEDURE ====================== NEW DOKEOS INSTALLATION -------------------------- 1. Download 'dokeos15.tar.gz' Windows : download 'dokeos15.zip'. 2. Open a shell, go to download directory and type tar -zxvf dokeos15.tar.gz Windows : unzip 'dokeos15.zip'. 3. FTP or move by any means 'index.php' file and 'claroline' directory to your website on webserver (whether webroot or subdirectory). 'index.php' should remain where it is, outside 'claroline' directory. Windows: If you use easyphp locally (http://www.easyphp.org), just drag and drop 'index.php' file and 'claroline' directory into C:\Program Files\easyphp\www\ 4. CHMOD 666 the following files : - dokeos/claroline/inc/conf/claro_main.conf.php (if present) 5. CHMOD 777 the following directories : - dokeos/claroline/inc/conf/ - dokeos/claroline/img/ - dokeos/claroline/garbage/ - dokeos/archive/ - dokeos/ 6. Open Web Browser and go to http://www.mydomain.org/mysite/dokeos/claroline/install/ Windows with easyphp locally, open: http://localhost/dokeos/claroline/install/ (don't forget the final /). 7. Click on "New installation" and follow instructions. Windows: if you use easyphp out of the box, login and password for MySQL should remain empty. UPDGRADE FROM PREVIOUS CLAROLINE OR DOKEOS VERSION ---------------------------------------- Before upgrading we heavily recommend you do a full backup of the previous Claroline or Dokeos directories and databases. If you are unsure how to achieve this please ask your hosting provider for advice. 1. Download 'dokeos15.tar.gz' Windows : download 'dokeos15.zip'. 2. Open a shell, go to download directory and type tar -zxvf dokeos15.tar.gz Windows : unzip 'dokeos15.zip'. 3. Move the Dokeos direcory to a different path from the previous version Warning : don't delete the previous directory before installing the new one. When the update is SUCCESSFULLY finished, you can remove the old path. Tips : if you want Dokeos 1.5.5 to be installed in the same directory as the previous version : - move the old directory to a new location (ex. move /claroline/ to /claroline_old/) - uncompress Dokeos 1.5.5 to the old version directory (ex. uncompress Dokeos 1.5.5 to /claroline/) - go to next step 4. CHMOD 666 the following files : - dokeos/claroline/inc/conf/claro_main.conf.php (if present) 5. CHMOD 777 the following directories : - dokeos/claroline/inc/conf/ - dokeos/claroline/img/ - dokeos/claroline/garbage/ - dokeos/archive/ - dokeos/ 6. Open Web Browser and go to http://www.mydomain.org/mysite/dokeos/claroline/install/ Windows with easyphp locally, open: http://localhost/dokeos/claroline/install/ (don't forget the final /). 7. Click on "Update from Dokeos 1.4.2|1.5" and follow instructions. TROUBLESHOOTING =============== In case web install doesn't work, you can try manual install. All the same as web install except that web parts should be replaced by: 1. Create yourself the main Dokeos database and the tables inside it with a mySQL client (we provide the web client phpMyAdmin in the Dokeos distribution). The complete tables description is available in the 'claroline/sql/' directory. 2. Edit manually the 'claroline/inc/conf/claro_main.conf.php.dist' file and rename it 'claro_main.conf.php'. 3. Open browser, go to your new campus URL and click 'Registration', then selecting 'Create course websites' and follow the line. 4. Go, if needed, to 'http://www.dokeos.com' and ask a question on the Support forum. Read however the previous messages to see if there is already an answer to your question. ADMINISTRATION SECTION ====================== To access the Dokeos administration section, open browser and go to http://www.mydomain.org/mysite/mydirectory/admin/ Install script has created a '.htaccess' file to protect claroline/admin. To access admin, use login/password you entered during install. If this doesn't work, delete '.htaccess'. LDAP SECTION ====================== An LDAP module is already provided, but it has to be configured to make it work. 0. Compiling Linux servers: It's possible that you have to recompile php with ldap support. Newer distributions also allow downloading rpms for additional packages. 1. Activating In claroline/inc/conf/claro_main.conf.php, around line 90, you see //for new login module //uncomment these to activate ldap //$extAuthSource['ldap']['login'] = "./claroline/auth/ldap/login.php"; //$extAuthSource['ldap']['newUser'] = "./claroline/auth/ldap/newUser.php"; remove the // from the last two lines to activate LDAP. 2. Settings Ask the LDAP server admin for the settings: - ldap server name - ldap server port (usually 389) - ldap dc You must enter these in claroline/auth/ldap/ldap_var.inc.php //parameters for LDAP module $usesLDAP = TRUE; $usesCurriculum = FALSE; $ldaphost = "myldapserver.com"; // your ldap server $ldapport = 389; // your ldap server's port number $ldapDc = "dc=xx, dc=yy, dc=zz"; //domain 3) Teacher/student status If you wish, you can give teacher/student status to dokeos users according to settings in the ldap server. This is not a standard field however, so you'll have to change some code. claroline/auth/ldap/ldap_var.inc.php around line 189, function putUserInfoInClaroline ($login, $infoArray) if () { $statut = STUDENT; } else { $statut = COURSEMANAGER; } If this seems too difficult, the simplest solution is to just put $statut = STUDENT; and give course manager rights through the admin panel. 4) some LDAP servers do not support anonymous use of the directory services In this case, you need code that binds with a name and password - this code has already been provided, just ask on a forum or email for this. ========================================================================= Email :info@dokeos.com Europe, Belgium, Brussels Tel. +32 2 472 98 75 45 ================================== END ===================================