Installation Instructions Open eClass 2.1

The Open eClass platform is a complete Course Management System. It is the solution offered by the Greek Academic Network GUnet to support Asynchronous eLearning Services. It is mainly designed, developed and supported by the GUnet Asynchronous eLearning Group and is distributed for free as open-source software.

The Asynchronous Open eClass 2.1 eLearning platform has been tested and operates wwell in:

In the following pages platform's installation instructions are presented analytically:

Actions before installation - prequisities:

A series of applications needs to exist and operate in order for the eClass platform to be installed and operate as well. These applications are:

1. Web Server (Apache 1.3.x or 2.x)

Apache has to be able to control pages of the .php .inc. type. If you have not set the server yet, adding the following line to the httpd.conf file is enough:

AddType application/x-httpd-php .php .inc

You will also have to define that the default charset of pages sent by the Web Server is UTF-8. In Apache, this can be done by placing the following statement in the httpd.conf file:

AddDefaultCharset UTF-8

If you use apache 1.3.x, deactivate directory indexing for safety and security. Add the -Indexes option on the httpd.conf to the list of Options. If eClass is installed on /var/www/, add httpd.conf to the following statement:

<Directory /var/www/>
................
Options -Indexes
................
</Directory>

For Windows Only. If Microsoft Webserver (IIS) runs on your computer, you will have to deactivate it. Follow Start->Programs->Administrative Tools->Services and click on 'stop' in order to stop the «World Wide Web Publishing Service». Click right on the service and click on «Disabled» from the «Startup type» options to disable IIS permanently. Please notice that platform Open eClass operates without any problems under IIS web server, but without being exhaustive tested.

2. Scripting Language PHP (versions >= 4.3.0)

The platform operates without any problems with >= 4.3.0 and 5.x versions. 5.x.

During PHP installation, it is important to activate the Apache support for PHP. Note that you will need to activate support for mysql, zlib, pcre and gd modules in PHP. If you wish to use an LDAP server to authenticate users, you have to activate the module for the ldap support as well. Most of the PHP distributions have built-in support for these modules (except for the Ldap module maybe). Satisfaction of the above is checked during Open eClass installation.

You will also have to define the following parameters on the php.ini file:

register_globals = on

short_open_tag = on

As far as the maximum file size allowed to be uploaded on the platform is concerned, you can adjust it to the following lines in the php.ini file:

What is more, if a PHP note comes up during the application, search for the error_reporting variable in the php.ini file and define the following value:

error_reporting = E_ALL & ~E_NOTICE

Finally, you are advised to define the default charset again by the following line: default_charset = "UTF-8"

As soon as you have finished with changes, restart Apache Web Server.

3. DatabaseMySQL (versions 4.1.x or 5.x)

Along with the MySQL installation, a user account with database creation rights has to be created.

You should also be sure that MySQL is not running on a strict mode. For that reason, you should check if the

--sql-mode
parameter that exists in the my.cnf or my.ini configuration file for UNIX and Windows users correspondingly, has a value or not. If it does (e.g. --sql-mode=STRICT_TRANS_TABLES or --sql-mode=STRICT_ALL_TABLES), then turn it into a blank one (--sql-mode="").

4. Mail Servers sendmail or postfix (optional)

In some of the platform operations (e.g. during users' registration), emails are sent. If any of the email mission applications does not function, platform mails are not sent anywhere.

For Windows only: Alternatively, in order to install the above, use the EasyPHP package or XAMPP package.


Installation in Unix / Linux systems (Solaris / Redhat, Debian, Suse, Ubuntu etc)

Installation Process:

You can decompress the openeclass-2.1.tar.gz file using the tar xzvf openeclass-2.1.tar.gz command. The sub-directory created during decompression of the packet includes all the application files. This sub-directory has to be placed in an accessible point by the computer web server.

To give access rights to web server you can type the following commands (if the web server runs as a www-data user)

		cd (path of eclass) (e.g. cd /opt/eclass)
		chown -R www-data *
		find ./ -type f -exec chmod 664 {} \;
		find ./ -type d -exec chmod 775 {} \;
		

Administrator's rights (root) are usually necessary for the above commands.

In order to start installing, visit the /install/ sub-directory address with a web browser. If, for example, the main eclass directory is located in http://www.example.gr/eclass/, the address you have to type is http://www.example.gr/eclass/install/. Then follow the platform installation guide steps like the ones presented on your screen. Note that during the installation process you will be required the following:


Installation in Ms Windows systems (Win2000, WinXP, Win2003)

Installation Process:

Decompress the openeclass-2.1.zip file in the root directory of the Apache. The subdirectory created during the decompression of the package includes all files of the application. This sub-directory has to be placed in an accessible path by the web server.

In order to start installation, visit the /install/ sub-directory address with a web browser. If, for example, the main eclass directory is located in http://www.example.gr/eclass/, the address you have to type is http://www.example.gr/eclass/install/. Then follow the platform installation guide steps like the ones presented on your screen. Note that during the installation process you will be required the following:


Actions after Installation - Further Settings: