no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
— | en:3.7:install [2021/05/25 16:22] (current) – created - external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ===== Installation Guide ===== | ||
+ | Open eClass 3.11 | ||
+ | |||
+ | |||
+ | 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 Open eClass has been tested and works without problems in: | ||
+ | * Ms Windows | ||
+ | * MacOS X | ||
+ | * Various Linux distributions (e.g. RedHat, CentOS, Debian, Ubuntu, OpenSuse etc) | ||
+ | * Other UNIX environments (e.g. Solaris). | ||
+ | |||
+ | |||
+ | Current version of Open eClass DOESN' | ||
+ | |||
+ | |||
+ | ===== 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 (Apache 2.x) ==== | ||
+ | |||
+ | Apache has to be able to control pages of the '' | ||
+ | |||
+ | AddType application/ | ||
+ | |||
+ | 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, | ||
+ | |||
+ | < | ||
+ | ................ | ||
+ | Options -Indexes | ||
+ | ................ | ||
+ | </ | ||
+ | |||
+ | **For Windows Only** | ||
+ | | ||
+ | If Microsoft Webserver (IIS) runs on your computer, you will have to deactivate it. | ||
+ | * Follow Start-> | ||
+ | * click on ' | ||
+ | * Click right on the service and | ||
+ | * click on «Disabled» from the «Startup type» options to disable IIS permanently. | ||
+ | |||
+ | ==== 1.3 NGINX ===== | ||
+ | |||
+ | We assume that NGINX is configured properly for serving PHP files. | ||
+ | Because of the ' | ||
+ | |||
+ | location ~ [^/ | ||
+ | location ~ \..*/ | ||
+ | return | ||
+ | } | ||
+ | include snippets/ | ||
+ | # | ||
+ | # # With php5-cgi alone: | ||
+ | # | ||
+ | # # With php5-fpm: | ||
+ | fastcgi_pass unix:/ | ||
+ | } | ||
+ | | ||
+ | |||
+ | ==== 1.1.3 IIS ==== | ||
+ | |||
+ | Platform works without problems under IIS although we haven' | ||
+ | |||
+ | |||
+ | ==== 1.2 PHP (versions >= 7.2) ==== | ||
+ | |||
+ | During PHP installation, | ||
+ | |||
+ | You will also have to define the following parameters on the '' | ||
+ | |||
+ | 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, | ||
+ | |||
+ | 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: | ||
+ | * 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 = " | ||
+ | |||
+ | As soon as you have finished with changes, restart Apache Web Server. | ||
+ | |||
+ | ==== 1.3 Apache recommended settings ==== | ||
+ | |||
+ | For starters, you can use the following settings in httpd.conf. (In the following example eclass is installed in / | ||
+ | |||
+ | < | ||
+ | Options | ||
+ | AllowOverride | ||
+ | DirectoryIndex index.php | ||
+ | AddDefaultCharset utf-8 | ||
+ | # php settings | ||
+ | php_flag short_open_tag off | ||
+ | php_flag magic_quotes_gpc off | ||
+ | php_flag register_globals off | ||
+ | php_flag html_errors off | ||
+ | php_flag track_errors off | ||
+ | # error handling | ||
+ | php_flag display_startup_errors Off | ||
+ | php_flag display_errors Off | ||
+ | php_flag log_errors On | ||
+ | # php operational limits | ||
+ | php_admin_value max_execution_time 500 | ||
+ | php_admin_value max_input_time 120 | ||
+ | php_admin_value memory_limit 128M | ||
+ | php_admin_value post_max_size 250M | ||
+ | php_admin_value upload_max_filesize 250M | ||
+ | php_admin_value default_charset utf-8 | ||
+ | php_admin_value file_uploads On | ||
+ | php_admin_value session.gc_maxlifetime 7200 | ||
+ | </ | ||
+ | # protect some directories | ||
+ | < | ||
+ | Require all denied | ||
+ | </ | ||
+ | < | ||
+ | Require ip 127.0.0.1 | ||
+ | </ | ||
+ | < | ||
+ | Require all denied | ||
+ | </ | ||
+ | # selectively disable php | ||
+ | < | ||
+ | DirectoryIndex index.html | ||
+ | RemoveHandler .php | ||
+ | </ | ||
+ | < | ||
+ | DirectoryIndex index.html | ||
+ | RemoveHandler .php | ||
+ | </ | ||
+ | < | ||
+ | DirectoryIndex index.html | ||
+ | RemoveHandler .php | ||
+ | </ | ||
+ | # handle /courses URLs through index.php | ||
+ | AliasMatch ^/ | ||
+ | |||
+ | |||
+ | Of course, you must modify eclass path and ip addresses. | ||
+ | |||
+ | |||
+ | ==== 1.4 Mail transport application (e.g. sendmail, postfix, exim) ==== | ||
+ | |||
+ | |||
+ | Emails are sent during various platform operations (e.g. during users' registration). If there is no mail transport application or isn't configured correctly, platform emails are not sent. | ||
+ | |||
+ | **For Windows only: | ||
+ | |||
+ | Alternatively, | ||
+ | |||
+ | ===== 2. Installation ===== | ||
+ | |||
+ | |||
+ | ==== 2.1 Unix / Linux systems ==== | ||
+ | |||
+ | === Installation Process: === | ||
+ | |||
+ | |||
+ | You can decompress the openeclass-3.11.tar.gz file using the '' | ||
+ | |||
+ | 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 / | ||
+ | chown -R www-data * | ||
+ | find ./ -type f -exec chmod 664 {} \; | ||
+ | find ./ -type d -exec chmod 775 {} \; | ||
+ | |||
+ | Administrator' | ||
+ | |||
+ | 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:// | ||
+ | |||
+ | Current version of Open eClass DOESN' | ||
+ | |||
+ | 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, | ||
+ | * A ' | ||
+ | * Name for the main eClass database (default is eclass). Change it however, if there is a database with the same name already. | ||
+ | * | ||
+ | * The file path on the server. Make sure that the path is right (e.g. / | ||
+ | * | ||
+ | * | ||
+ | * 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' | ||
+ | * Name and address of your institute. | ||
+ | |||
+ | ==== 2.2 MS Windows systems ==== | ||
+ | |||
+ | ===Installation Process=== | ||
+ | |||
+ | Unzip the '' | ||
+ | |||
+ | In order to start installation, | ||
+ | |||
+ | * Computer hostname, in which MySQL is installed to (e.g. eclass.gunet.gr, | ||
+ | * A ' | ||
+ | * 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:// | ||
+ | * The file path on the server. Make sure that the path is right (e.g. C:\Program Files\Apache\htdocs\). | ||
+ | * Administrator' | ||
+ | * Administrator' | ||
+ | * 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' | ||
+ | * Name and address of your institute. | ||
+ | |||
+ | ===== 3. Post install actions ===== | ||
+ | |||
+ | ==== 3.1 How to modify test courses ==== | ||
+ | Platform 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' | ||
+ | ==== 3.2 Theme Options ==== | ||
+ | If you want to change the default theme or creating a new one, login in platform as administrator and click in "Admin tools" / "Other Tools / Theme settings" | ||
+ | |||
+ | |||
+ | ==== 3.3 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)/ | ||
+ | |||
+ | $langAboutText = "The platform version is"; | ||
+ | |||
+ | create '' | ||
+ | |||
+ | <?php | ||
+ | $langAboutText = " | ||
+ | ?> | ||
+ | |||
+ | 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 '' | ||
+ | '' | ||
+ | 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, | ||
+ | |||
+ | ==== 3.4 Support of mathematical symbols ==== | ||
+ | |||
+ | You can type mathematical symbols. See further details in | ||
+ | [[en: | ||
+ | |||
+ | |||
+ | ==== 3.5 Basic Settings ==== | ||
+ | You can configure several options of platform. After logging as admin user, click in "Admin Tools" and after that, click in " | ||
+ | |||
+ | 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 ' | ||
+ | |||
+ | ==== 3.6 Other settings ==== | ||
+ | |||
+ | 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/ | ||
+ | * 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, | ||
+ | |||
+ | Persmissions must be set to 444 | ||
+ | e.g. chmod 444 / | ||