[Sommaire] [Imprimer]

   1  *****************************************************
   2       CLAROLINE 1.8
   3  *****************************************************
   4  
   5  Thank you for downloading Claroline 1.8. This text will guide you
   6  through the basics of installation and operation of Claroline 1.8. Please
   7  ensure you read this fully BEFORE proceeding with the installation.
   8  
   9  TABLE OF CONTENT :
  10  
  11    1. REQUIREMENTS
  12    2. INSTALLATION PROCEDURE
  13       2.1 New Claroline installation
  14       2.2 Upgrade from previous Claroline version
  15    3. TROUBLESHOOTING
  16    4. ADMIN
  17  
  18  REQUIREMENTS
  19  ============
  20  
  21  To install Claroline 1.8 on a computer, whether locally or remotely,
  22  you need the following on your machine :
  23  
  24  1. One of the following Operating systems :
  25  
  26          Linux / BSD / Unix (*)
  27          Windows (9x, Me, NT4, 2000, XP)
  28          MacOs X.
  29  
  30    (*) We thoroughly test Claroline on Debian, Ubuntu and Mandrake distributions,
  31        but other Linux distributions should work too. We've received
  32        positive feedbacks from users working on Red Hat and Suse.
  33        Don't hesitate to notify us of any problem encountered on other
  34        Linux distributions.
  35  
  36  1. A web server (We recommend Apache, but others should work too),
  37  
  38  2. PHP scripting language (version 4.3.10 or later), configured with the
  39     following modules : mysql, zlib, preg. Most of the PHP4 compiled
  40     distributions are provided with these modules. Anyway, their presence
  41     is checked by the Claroline install script.
  42  
  43     Some users could meet problems if their PHP setting doesn't fit
  44     these ones:
  45  
  46          safe_mode            = Off
  47  
  48  3. The MySQL databases server (version 4.0 or later) plus a login/password 
  49     allowing to administrate and create at least one database.
  50  
  51     Claroline can be installed in tow different modes : 'Single
  52     Database' and 'Multi Database'. In 'Multi Database' mode, Claroline
  53     will create a new database for each course created. This mode is
  54     sometimes more appropriate to manage a platform with a huge bulk of
  55     course sites. But it means the database account used by Claroline
  56     has to allow to create and administrate several databases. By
  57     default Claroline is set to be install on a 'single database host'
  58     If you want to use Claroline in 'Multi Database' mode, you have to
  59     select this option on purpose at install.
  60  
  61         WARNING ! If you use the 'single database' install option, it is
  62         recommended to use this database for Claroline use only. If you
  63         share this database with other applications, interferences could
  64         occurs between table names of both applications that could conducts
  65         to serious problems.
  66  
  67  4. Web Write access to web directory where Claroline has been moved
  68     or unzipped to. On a Windows machine locally, this
  69     is not a problem. Remotely, you need to be allowed to CHMOD
  70     through FTP, telnet or any means.
  71  
  72  5. A Mail Transport Agent (MTA). This not absolutely necessary but some
  73     Claroline features will remain silent if you don't provide MTA.
  74     Most Linux distributions provide MTA (Sendmail, Qmail, PostFix,
  75     ...). On Windows machines, no MTA are provided by default. You can
  76     either modify the php.ini file to redirect mail to an MTA available
  77     on an other machine, or install an MTA on the Claroline server.
  78     Several MTA are freely available for Windows (Mercury, Blat,
  79     Netmail95, WMailto , Hamster ...).
  80  
  81  INSTALLATION PROCEDURE
  82  ======================
  83  
  84  NEW CLAROLINE INSTALLATION
  85  --------------------------
  86  
  87  1. Download 'claroline188.tar.gz'
  88  
  89     Windows : download 'claroline188.zip
  90  
  91  
  92  2. Open a shell, go to download directory and type
  93  
  94      tar -zxvf claroline188.tar.gz
  95  
  96     Windows : unzip 'claroline188.zip'.
  97  
  98  3. FTP or move by any means 'index.php' file and 'claroline' directory
  99     to your website on web server (whether web root or subdirectory).
 100     'index.php' should remain where it is, outside 'claroline' directory.
 101  
 102     Windows: If you use easyphp locally (http://www.easyphp.org), just
 103     drag and drop 'index.php' file and 'claroline' directory into
 104     C:\Program Files\easyphp\www\
 105  
 106  4. The following directory need to be readable, writeable and executable
 107     for everyone: 
 108  
 109      chmod ugo+w claroline188/
 110  
 111  4. Open Web Browser and go to
 112  
 113      http://www.mydomain.org/mysite/mydir/claroline/install/
 114  
 115     Windows : with easyphp locally, open:
 116  
 117      http://localhost/claroline/install/ (don't forget the final /).
 118  
 119  5. Follow instructions.
 120  
 121     Windows: if you use easyphp out of the box, login and password
 122     for MySQL should remain empty.
 123  
 124  UPDGRADE FROM PREVIOUS CLAROLINE VERSION
 125  ----------------------------------------
 126  
 127  The upgrade works only from Claroline 1.5.x, 1.6.x and 1.7.x. Older Claroline 
 128  versions should upgrade first to Claroline 1.5.x before upgrade to Claroline 1.8.x
 129  
 130  Before upgrading we heavily recommend you do a full backup of the previous
 131  Claroline directories and databases. If you are unsure how to achieve this
 132  please ask your hosting provider for advice.
 133  
 134  1. Download 'claroline188.tar.gz'
 135  
 136     Windows : download 'claroline188.zip'
 137  
 138  
 139  2. Open a shell, go to download directory and type
 140  
 141      tar -zxvf claroline188.tar.gz
 142  
 143     Windows : unzip 'claroline188.zip'
 144  
 145  
 146  3. Replace your previous Claroline directory and index.php by the new one.
 147  
 148          WARNING ! Don't delete the previous directory before
 149          installing the new one. You will loose your previous
 150          configuration files (eg 'claro_main.conf.php'). Simply
 151          replace the old directory with a new one with a 'copy'
 152          command. That way, the new file versions will overwrite the
 153          old ones and leave the others intact.
 154  
 155  4. Open Web Browser and go to
 156  
 157     http://www.mydomain.org/mysite/mydir/claroline/admin/upgrade/upgrade.php
 158  
 159     Windows with easyPhp locally, open:
 160  
 161     http://localhost/mydir/claroline/admin/upgrade/upgrade.php
 162  
 163  5. Follow instructions.
 164  
 165  TROUBLESHOOTING
 166  ===============
 167  
 168  In case web install doesn't work
 169  
 170  1. Go, if needed, to 'http://www.claroline.net' and ask a question on the
 171     Support forum. Read however the previous messages to see if there is
 172     already an answer to your question.
 173  
 174  
 175  ADMINISTRATION SECTION
 176  ======================
 177  
 178  To access the Claroline administration section, open browser
 179  and go to http://www.mydomain.org/mysite/claroline/admin/
 180  
 181  ==========================================================================
 182              Europe, Belgium, Brussels - October 3 2007
 183  ================================== END ===================================