****************************
CLAROLINE 1.3.0 INSTALLATION
****************************

Thank you for downloading Claroline 1.3.0.
This README will guide you through the basics 
of installation and operation of Claroline 1.3.0. 
Please ensure you read this fully BEFORE proceeding 
with the installation.



    - Requirements

    - Installation Procedure

        - New Claroline installation

        - Updgrade from previous Claroline version

    - Troubleshooting

    - Admin


REQUIREMENTS
============

To install Claroline 1.3.0 on a server, whether locally or 
remotely, you need the following on the server:

1. A web server (We reccomend Apache, but other should work too),

2. PHP 4.x configured with the following modules : mysql, zlib, preg.
   Most of the PHP4 compiled distributions are provided with these modules.
   Anyway, their presence are checked by the Claroline install script.

       warning : users with PHP 4.2 and superior 
                 should set the parameter 
   
                 register_globals = on 
   
                 in the php.ini file of their server 
                 to claroline work properly.

3. The MySQL databases server plus a login/password allowing to administrate 
   and create several databases (this means claroline 1.3.0 will probably not 
   work if you are allowed by your host a single database on the server),   

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.


INSTALLATION PROCEDURE
======================

NEW CLAROLINE INSTALLATION
--------------------------

1. Download 'claroline130.tar.gz' 

   Windows : download 'claroline130.zip'.

2. Open a shell, go to download directory and type 
   tar -zxvf claroline130.tar.gz

   Windows : unzip 'claroline130.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 claroline/include/config.php if necessary

5. 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 /).

6. Follow instructions.

   Windows: if you use easyphp out of the box, login and password 
   for MySQL should remain empty.


UPDGRADE FROM PREVIOUS CLAROLINE VERSION
----------------------------------------

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 'claroline130.tar.gz' 

   Windows : download 'claroline130.zip'.

2. Open a shell, go to download directory and type 
   tar -zxvf claroline130.tar.gz

   Windows : unzip 'claroline130.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 config.php file. Replace it with 
       a 'copy' command.

4. CHMOD 666 claroline/include/config.php if necessary

5. Open Web Browser and go to 
   http://www.mydomain.org/mysite/mydir/claroline/install/update.php

   Windows with easyphp locally, open: 
   http://localhost/claroline/install/update.php

6. 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 Claroline database and the tables inside it 
   with a mySQL client (we provide the web client phpMyAdmin in the Claroline
   distribution). The complete tables description is available in 
   the 'claroline/sql/' directory.

2. Edit manually the 'claroline/include/config.php.dist' file 
   and rename it 'config.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.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/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'.





=========================================================================

Thomas De Praetere <depraetere@ipm.ucl.ac.be>
Hugues Peeters     <peeters@ipm.ucl.ac.be>
Christophe Gesche  <gesche@ipm.ucl.ac.be>

Europe, Belgium, Louvain-la-Neuve, September 18, 2002.

Tel. +32 10 47 85 48.

================================== END ===================================


