Install
This document was uploaded by user and they confirmed that they have the permission to share it. If you are author or own the copyright of this book, please report to us by using this DMCA report form. Report DMCA
Overview
Download & View Install as PDF for free.
More details
- Words: 901
- Pages: 4
********************************************* claroline 1.7.1 - install ********************************************* thank you for downloading claroline 1.7 . this text will guide you through the basics of installation and operation of claroline 1.7. please ensure you read this fully before proceeding with the installation. table of content : 1. requirements 2. installation procedure 2.1 new claroline installation 2.2 upgrade from previous claroline version 3. troubleshooting 4. admin
requirements ============ to install claroline 1.7.1 on a computer, whether locally or remotely, you need the following on your machine : 1. one of the following operating systems : linux / bsd / unix (*) windows (9x, me, nt4, 2000, xp) macos x. (*) we thoroughly test claroline on debian and mandrake distributions, but other linux distributions should work too. we've received positive feedbacks from users working on red hat and suse. don't hesitate to notify us of any problem encountered on other linux distributions. 1. a web server (we recommend apache, but others should work too), 2. php scripting language (version 4.3 or later), configured with the following modules : mysql, zlib, preg. most of the php4 compiled distributions are provided with these modules. anyway, their presence is checked by the claroline install script. some users could meet problems if their php setting doesn't fit these ones: safe_mode = off magic_quotes_runtime = off 3. the mysql databases server plus a login/password allowing to administrate and create at least one database. claroline can be installed in tow different modes : 'single database' and 'multi database'. in 'multi database' mode, claroline will create a new database for each course created. this mode is sometimes more appropriate to manage a platform with a huge bulk of course sites. but it means the database account used by claroline
has to allow to create and administrate several databases. by default claroline is set to be install on a 'single database host' if you want to use claroline in 'multi database' mode, you have to select this option on purpose at install. warning ! if you use the 'single database' install option, it is recommended to use this database for claroline use only. if you share this database with other applications, interferences could occurs between table names of both applications that could conducts to serious problems. note 1. the backticks characters (`) inserted inside most of the claroline sql queries since claroline 1.3 doesn't work with mysql versions previous to 3.23.6. note 2. people using mysql 4.1 (or later) could face connection problem. to fix this problem, see on the my sql web site : "client does not support authentication protocol" http://dev.mysql.com/doc/mysql/en/old_client.html 4. web write access to web directory where claroline 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. 5. a mail transport agent (mta). this not absolutely necessary but some claroline features will remain silent if you don't provide mta. most linux distributions provide mta (sendmail, qmail, postfix, ...). on windows machines, no mta are provided by default. you can either modify the php.ini file to redirect mail to an mta available on an other machine, or install an mta on the claroline server. several mta are freely available for windows (mercury, blat, netmail95, wmailto , hamster ...). installation procedure ====================== new claroline installation -------------------------1. download 'claroline171.tar.gz' windows : download 'claroline171.zip'. 2. open a shell, go to download directory and type tar -zxvf claroline171.tar.gz windows : unzip 'claroline171.zip'. 3. ftp or move by any means 'index.php' file and 'claroline' directory to your website on web server (whether web root 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. open web browser and go to http://www.mydomain.org/mysite/mydir/claroline/install/ windows : with easyphp locally, open: http://localhost/claroline/install/ (don't forget the final /). 5. follow instructions. windows: if you use easyphp out of the box, login and password for mysql should remain empty.
updgrade from previous claroline version ---------------------------------------the upgrade works only from claroline 1.5.x and 1.6.x. older claroline versions should upgrade first to claroline 1.5.x before upgrade to claroline 1.7.x before upgrading we heavily recommend you do a full backup of the previous claroline directories and databases. if you are unsure how to achieve this please ask your hosting provider for advice. 1. download 'claroline171.tar.gz' windows : download 'claroline171.zip'. 2. open a shell, go to download directory and type tar -zxvf claroline171.tar.gz windows : unzip 'claroline171.zip'. 3. replace your previous claroline directory and index.php by the new one. warning ! don't delete the previous directory before installing the new one. you will loose your previous configuration files (eg 'claro_main.conf.php'). simply replace the old directory with a new one with a 'copy' command. that way, the new file versions will overwrite the old ones and leave the others intact. 4. open web browser and go to http://www.mydomain.org/mysite/mydir/claroline/admin/upgrade/upgrade.php windows with easyphp locally, open: http://localhost/mydir/laroline/admin/upgrade/upgrade.php 5. follow instructions.
troubleshooting =============== in case web install doesn't work, you can try manual install. 1. go, if needed, to 'http://www.claroline.net' 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 claroline administration section, open browser and go to http://www.mydomain.org/mysite/claroline/admin/ ========================================================================== europe, belgium, louvain-la-neuve - september 28 2005 ================================== end ===================================
requirements ============ to install claroline 1.7.1 on a computer, whether locally or remotely, you need the following on your machine : 1. one of the following operating systems : linux / bsd / unix (*) windows (9x, me, nt4, 2000, xp) macos x. (*) we thoroughly test claroline on debian and mandrake distributions, but other linux distributions should work too. we've received positive feedbacks from users working on red hat and suse. don't hesitate to notify us of any problem encountered on other linux distributions. 1. a web server (we recommend apache, but others should work too), 2. php scripting language (version 4.3 or later), configured with the following modules : mysql, zlib, preg. most of the php4 compiled distributions are provided with these modules. anyway, their presence is checked by the claroline install script. some users could meet problems if their php setting doesn't fit these ones: safe_mode = off magic_quotes_runtime = off 3. the mysql databases server plus a login/password allowing to administrate and create at least one database. claroline can be installed in tow different modes : 'single database' and 'multi database'. in 'multi database' mode, claroline will create a new database for each course created. this mode is sometimes more appropriate to manage a platform with a huge bulk of course sites. but it means the database account used by claroline
has to allow to create and administrate several databases. by default claroline is set to be install on a 'single database host' if you want to use claroline in 'multi database' mode, you have to select this option on purpose at install. warning ! if you use the 'single database' install option, it is recommended to use this database for claroline use only. if you share this database with other applications, interferences could occurs between table names of both applications that could conducts to serious problems. note 1. the backticks characters (`) inserted inside most of the claroline sql queries since claroline 1.3 doesn't work with mysql versions previous to 3.23.6. note 2. people using mysql 4.1 (or later) could face connection problem. to fix this problem, see on the my sql web site : "client does not support authentication protocol" http://dev.mysql.com/doc/mysql/en/old_client.html 4. web write access to web directory where claroline 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. 5. a mail transport agent (mta). this not absolutely necessary but some claroline features will remain silent if you don't provide mta. most linux distributions provide mta (sendmail, qmail, postfix, ...). on windows machines, no mta are provided by default. you can either modify the php.ini file to redirect mail to an mta available on an other machine, or install an mta on the claroline server. several mta are freely available for windows (mercury, blat, netmail95, wmailto , hamster ...). installation procedure ====================== new claroline installation -------------------------1. download 'claroline171.tar.gz' windows : download 'claroline171.zip'. 2. open a shell, go to download directory and type tar -zxvf claroline171.tar.gz windows : unzip 'claroline171.zip'. 3. ftp or move by any means 'index.php' file and 'claroline' directory to your website on web server (whether web root 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. open web browser and go to http://www.mydomain.org/mysite/mydir/claroline/install/ windows : with easyphp locally, open: http://localhost/claroline/install/ (don't forget the final /). 5. follow instructions. windows: if you use easyphp out of the box, login and password for mysql should remain empty.
updgrade from previous claroline version ---------------------------------------the upgrade works only from claroline 1.5.x and 1.6.x. older claroline versions should upgrade first to claroline 1.5.x before upgrade to claroline 1.7.x before upgrading we heavily recommend you do a full backup of the previous claroline directories and databases. if you are unsure how to achieve this please ask your hosting provider for advice. 1. download 'claroline171.tar.gz' windows : download 'claroline171.zip'. 2. open a shell, go to download directory and type tar -zxvf claroline171.tar.gz windows : unzip 'claroline171.zip'. 3. replace your previous claroline directory and index.php by the new one. warning ! don't delete the previous directory before installing the new one. you will loose your previous configuration files (eg 'claro_main.conf.php'). simply replace the old directory with a new one with a 'copy' command. that way, the new file versions will overwrite the old ones and leave the others intact. 4. open web browser and go to http://www.mydomain.org/mysite/mydir/claroline/admin/upgrade/upgrade.php windows with easyphp locally, open: http://localhost/mydir/laroline/admin/upgrade/upgrade.php 5. follow instructions.
troubleshooting =============== in case web install doesn't work, you can try manual install. 1. go, if needed, to 'http://www.claroline.net' 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 claroline administration section, open browser and go to http://www.mydomain.org/mysite/claroline/admin/ ========================================================================== europe, belgium, louvain-la-neuve - september 28 2005 ================================== end ===================================
