====== Installation Instructions ======
Open eClass 2.9


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.6 eLearning platform has been tested and operates well in:
  * Ms Windows environments (Windows NT, Windows 2000, Windows XP, Windows 2003, Windows Vista, Windows 7, Windows 2008)
  * Various Linux distributions (e.g. RedHat, CentOS, Debian, Ubuntu, OpenSuse etc)
  * Other UNIX environments (e.g. Solaris).


Current version of Open eClass DOESN'T include database administration tool phpMyAdmin. If you wish, you can copy folder (path του eclass)/modules/admin/mysql/ in a temporary folder (e.g. /tmp). After upgrade has completed you can restore it to its previous location. Otherwise you can download latest version from [[http://www.phpmyadmin.net/home_page/index.php|here]].



===== 1.  Actions before installation - Prerequisities =====
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.1 Web Server (Apache2.x) ====

Apache has to be able to control pages of the ''.php'' 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

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

It is recommended, for security reasons, to deactivate directory indexing. Add the -Indexes option on the ''httpd.conf'' to the list of Options. If eClass is installed on ''/var/www/html'', add the following statement to ''httpd.conf'':

  <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.

==== 1.2 Scripting Language PHP (versions >= 5.0) ====

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, mbstring and gd modules in PHP. If you wish to use an LDAP server to authenticate users, you have to activate the module for 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:

  short_open_tag = off
  magic_quotes_gpc = off
  magic_quotes_runtime = off

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:

  upload_max_filesize = 80M (predefined value is 2M)
  memory_limit = 25M (predefined value is 8M)
  post_max_size = 95M (predefined value is 8M)
  max_execution_time = 100 (predefined value is 30 sec)

What is more, if a PHP notice comes up during the application, search for the display_errors variable in file php.ini and modify it in:

  display_errors = Off

=== For Windows only. ===

  * In Windows extensions uncomment (;) from the line extension = php_ldap.dll
  * Change the session.save_path variable to an existing path (e.g. session.save_path=c:\winnt\temp\). Also make sure that the apache has access rights on it.
  * Fill in the SMTP server that serves you, e.g. SMTP = mail.gunet.gr
  * Fill the field sendmail_from with a valid sender email address

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.

==== 1.3 Database MySQL (versions 4.1.x or 5.x) ====


Along with the MySQL installation, a user account with database creation rights has to be created. Because of the fact, that openeclass creates a new database for each course, make sure that you have permissions to create databases through php scripts and not through other tools (e.g. Plesk, cPanel etc.)

==== 1.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 submission 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.



===== 2. Installations =====
 

==== 2.1 Unix / Linux systems ====

=== Installation Process: ===


You can decompress the openeclass-2.6.tar.gz file using the ''tar xzvf openeclass-2.6.tar.gz'' command. The sub-directory created during decompression of the packet includes all the application files and 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 (e.g. if the web server runs as a www-data user)

  cd (path of eclass) (e.g. cd /var/www/html/openeclass)
  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/openeclass/, the address you have to type is http://www.example.gr/openeclass/install/. 

Current version of Open eClass DOESN'T include database administration tool phpMyAdmin. If you wish, you can copy folder (path του eclass)/modules/admin/mysql/ in a temporary folder (e.g. /tmp). After upgrade has completed you can restore it to its previous location. Otherwise you can download latest version from [[http://www.phpmyadmin.net/home_page/index.php|here]].

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:

  *     The name of the computer MySQL is installed to (e.g. eclass.gunet.gr, localhost - if they are on the same computer)
  *     A 'username' and a 'password' for a mysql user with database creation and deletion rights.
  *     Name for the main eClass database (default is eclass). Change it however, if there is a database with the same name already.
  *     Platform URL (as this appears on the browser after installation e.g. http://eclass.gunet.gr/openeclass/)
  *     The file path on the server. Make sure that the path is right (e.g. /var/www/html/).
  *     Administrator's Name / Surname and email.
  *     Administrator's Username and Password.
  *     The name you would like to give to the platform (e.g. Open eClass).
  *     Phone number and email helpdesk (several applications meet this email, it could be the same as the administrator's).
  *     Name and address of your institute.

==== 2.2 MS Windows systems ====

===Installation Process===

Decompress the ''openeclass-2.9.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.

Current version of Open eClass DOESN'T include database administration tool phpMyAdmin. If you wish, you can copy folder (path του eclass)/modules/admin/mysql/ in a temporary folder (e.g. /tmp). After upgrade has completed you can restore it to its previous location. Otherwise you can download latest version from [[http://www.phpmyadmin.net/home_page/index.php|here]].

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/openeclass/, the address you have to type is http://www.example.gr/openeclass/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:

  * Computer hostname, in which MySQL is installed to (e.g. eclass.gunet.gr, localhost - if they are on the same computer)
  * A 'username' and a 'password' for MySQL with database creation and deletion rights.
  * Name for the main eClass database (default is eclass). Change it however if there is a database with the same name already.
  * Platform URL (as this appears on the browser after installation e.g.http://eclass.gunet.gr/openeclass/).
  * The file path on the server. Make sure that the path is right (e.g. C:\Program Files\Apache\htdocs\).
  * Administrator's Name / Surname and email.
  * Administrator's Username and Password.
  * The name you would like to give to the platform (e.g. Open eClass).
  * Phone number and email helpdesk (several applications meet this email, it could be the same as the administrator's).
  * Name and address of your institute.




===== 3. Actions after installation =====

==== 3.1 How to modify test courses ====
eClass introduces 3 tentative / general Schools / Faculties. (Faculty 1-Code TMA, Faculty 2-Code TMB etc). You will have to change and adjust them to the Schools-Faculties of your own institute. You can do this through the administrator tool. You will find more and further information for these actions in the Administrator's manual (included in the administator tool).
==== 3.2 How to modify platform logo ====
 In case some institutes intend to substitute the initial eClass logo with one of its own, they just have to substitute the picture.

''(path of Open eClass)/template/classic/img/logo_openeclass.png''

with its own. 
==== 3.3 How to modify platform theme ====
The default theme of platform is 'classic'. You can change it later from the admin tool to 'modern'. Note the change will be visible to users after next login to platform.
==== 3.4 How to modify messages ====
If you want to modify any message of platform then proceed with the following actions: Create a file of type .php with name english.inc.php (or greek.inc.php) and place it in directory (eclass path)/config/. Find the varible name which contains the message you wish to change and assing it the new message. e.g. If you want to change message

  $langAboutText = "The platform version is";

create ''english.inc.php'' in directory (eclass path)/config/ like this:

  <?
  $langAboutText = "Version is";
  ?>

With the above way, you preserve custom messages from future upgrades of platform.

You can modify the names of the basic roles of the users of the platform by modifying the message file ''(eClass_path)/modules/lang/english/common.inc.php
''
You can add a text (e.g. informative) on the left and right of the platform homepage. For that reason, assign the value - message in variables $langExtrasLeft και $langExtrasRight, correspondingly in file ''(path του eClass)/modules/lang/english/common.inc.php'' 
==== 3.5 Support of math symbols ====
Open eClass supports mathematical symbols in subsystems "Exercises", "Forums" and "Announcements". In "Exercises" you can add math symbols in fields "Exercise Description" while a new exercise is created (or modified), in field "Comment" when a new question in an exercise is created (or modified). In subsystem "Forums" when you compose a new message or reply to an existing one and in subsystem "Announcements" when a new announcement is created. Math symbols must be enclosed with tags <m> and </m>. E.g. when you type

  <m>sqrt{x-1}</m> 

square root of x-1 will be drawed. For syntax of all mathematical symbols, read manual in http: / / (Open eClass url)/manuals/PhpMathPublisherHelp.pdf

==== 3.6 PhpMyAdmin ====


Current version of Open eClass DOESN'T include database administration tool phpMyAdmin. If you wish, you can copy folder (path του eclass)/modules/admin/mysql/ in a temporary folder (e.g. /tmp). After upgrade has completed you can restore it to its previous location. Otherwise you can download latest version from [[http://www.phpmyadmin.net/home_page/index.php|here]].


For safety and security reasons, access to phpMyAdmin should be done through the browser's cookies. If you want to change it, you can refer to the config.inc.php file of phpMyAdmin.
==== 3.7 Basic Settings ====
 You can configure several options of platform. After logging as admin user, click in "Admin Tools" and after that, click in "Configuration File". Among other, you can change the available languages (e.g. greek, italian) etc.

By default platform supports uploading of all the usual text, audio, video and image file types. If you desire to add a new file type, type its extension in 'Teacher while list' or 'Student while list' textarea correspondingly. 

==== 3.8  Other settings ====

 If you want to use the platform with a Web server which has the SSL support activated (e.g. https://eclass.gunet.gr), you can do it by defining the urlSecure variable on config.php. e.g.$urlSecure = "https://eclass.gunet.gr"

If you have SSL support activated and you want to enforce it between the platform and native mobile clients for increased security, you can do it by defining the urlMobile variable on config.php. e.g.$urlMobile = "https://eclass.gunet.gr"

Finally, it should be noted to the users of the platform that they need to have javascript activated on their browser.

  * For Internet Explorer users, choose consecutively Internet Options/Security/Custom Level/Security Options from the menu and check the "Scripting of java applets" option.
  * For users Mozilla Firefox, choose consecutively Edit / Preferences / Web features from the menu and check the Enable Java script for Navigator option.

**For Unix / Linux systems only**:

After completing installation, you are advised, for security reasons, to change access rights for the ''/config/config.php'' and ''/install/index.php'' files and allow reading only. 

Persmissions must be set to 444 
  e.g. chmod 444 /config/config.php /install/index.php