Table of Contents

Οδηγίες Εγκατάστασης Πλατφόρμας

Open eClass 4.0

Η πλατφόρμα Open eClass είναι ένα ολοκληρωμένο Σύστημα Διαχείρισης Ηλεκτρονικών Μαθημάτων και αποτελεί την πρόταση του Ακαδημαϊκού Διαδικτύου GUnet για την υποστήριξη της Υπηρεσίας Ασύγχρονης Τηλεκπαίδευσης. Αναπτύχθηκε από την Ομάδα Ασύγχρονης Τηλεκπαίδευσης του Ακαδημαϊκού Διαδικτύου, υποστηρίζεται κεντρικά από το GUnet και διανέμεται ελεύθερα ως Λογισμικό Ανοικτού Κώδικα.

1. Ενέργειες πριν την εγκατάσταση - Προαπαιτούμενα

Η Πλατφόρμα Ασύγχρονης Τηλεκπαίδευσης Open eClass έχει δοκιμαστεί και λειτουργεί κανονικά:

Στη συνέχεια παρατίθονται αναλυτικά οι οδηγίες εγκατάστασης της πλατφόρμας

Για την εγκατάσταση απαιτείται η ύπαρξη και η καλή λειτουργία μιας σειράς συστημάτων και εφαρμογών, ὀπως:


1.1.1 Web Server (Apache 2.x)

Ο Apache πρέπει να μπορεί να χειριστεί σελίδες τύπου .php Αν δεν τον έχετε ρυθμίσει, τότε αρκεί στο αρχείο ρυθμίσεων httpd.conf να προσθέσετε την ακόλουθη γραμμή:

AddType application/x-httpd-php .php

Επίσης, θα πρέπει να ορίσετε ότι η προκαθορισμένη κωδικοποίηση των σελίδων που στέλνει ο Web Server είναι UTF-8. Στον Apache, αυτό μπορείτε να το κάνετε βάζοντας στο αρχείο httpd.conf την δήλωση:

AddDefaultCharset UTF-8

Καλό είναι, για λόγους ασφαλείας, να απενεργοποιήσετε το directory indexing για τους υποκαταλόγους που θα εγκατασταθεί το eClass. Στο αρχείο httpd.conf προσθέστε στα Options την επιλογή -Indexes. Αν για παράδειγμα το eClass θα εγκατασταθεί στο /var/www/eclass τότε προσθέστε στο httpd.conf την παρακάτω δήλωση:

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

1.1.2 NGINX

Θεωρούμε ότι ο NGINX έχει ρυθμιστεί έτσι ώστε να μπορεί να εξυπηρετεί σελίδες php. Λόγω της λειτουργίας του συστήματος “Έγγραφα” θα πρέπει στο αρχείο ρυθμίσεων του site να γίνει η παρακάτω αλλαγή

      location ~ [^/]\.php($|/) {
              location ~ \..*/.*\.php$ {
                      return  404;
              }
              include snippets/fastcgi-php.conf;
      #
      #       # With php5-cgi alone:
      #       fastcgi_pass 127.0.0.1:9000;
      #       # With php5-fpm:
              fastcgi_pass unix:/var/run/php5-fpm.sock;
      }
              

1.2 PHP (εκδόσεις >= 8.1)

Ταυτόχρονα με την εγκατάσταση της PHP, απαιτείται και ενεργοποίηση της υποστήριξης του Apache για PHP. Σημειώστε ότι στη PHP, θα πρέπει να ενεργοποιήσετε την υποστήριξη για τα modules mysql-pdo, zlib, curl, xml, pcre, mbstring, intl, gd. Αν επιθυμείτε να χρησιμοποιήσετε κάποιον εξυπηρέτη LDAP για την πιστοποίηση των χρηστών, τότε θα πρέπει να ενεργοποιήσετε και το module για την υποστήριξη ldap. Είναι πιθανόν η διανομή της PHP που χρησιμοποιείτε να έχει ενσωματωμένη υποστήριξη για κάποια από τα παραπάνω modules.

Κατά την εγκατάσταση του eClass ελέγχεται αν πληρούνται τα παραπάνω.

Όσον αφορά το μέγιστο μέγεθος των αρχείων που θα επιτρέπεται να γίνονται upload στην πλατφόρμα, μπορείτε να το ρυθμίσετε με τις παρακάτω γραμμές στο αρχείο php.ini. Προτείνεται:

  upload_max_filesize = 100M (η προκαθορισμένη τιμή είναι 2M)
  memory_limit = 25M (η προκαθορισμένη είναι 8M)
  post_max_size = 110M (η προκαθορισμένη είναι 8M)

Επίσης, αν τυχόν, εμφανιστεί κάποιο notice της PHP κατά την διάρκεια της εφαρμογής, αναζητήστε στο αρχείο php.ini την μεταβλητή display_errors και αλλάξτε την τιμή της σε:

display_errors = Off

Μόνο για Windows

Στα windows extensions βγάζετε τα σχόλια (;) από τη γραμμή extension = php_ldap.dll

Μόνο για Mac OS X

 mysql.default_socket = /tmp/mysql.sock 

1.3 Προτεινόμενο αρχείο ρυθμίσεων για τον Apache

Αρχικά, μπορείτε να χρησιμοποιήσετε τις παρακάτω ρυθμίσεις στο httpd.conf. (θεωρούμε ότι το eclass είναι εγκατεστημένο στο /var/www/html/)

 <Directory /var/www/eclass>
  Options         FollowSymLinks
  AllowOverride   None
  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
  </Directory>
  # protect some directories
  <Directory /var/www/eclass/config>
      Require all denied
  </Directory>
  <Directory /var/www/eclass/upgrade>
      Require ip 127.0.0.1
  </Directory>
  # selectively disable php
  <Directory /var/www/eclass/temp>
      DirectoryIndex index.html
      RemoveHandler .php
  </Directory>
  <Directory /var/www/eclass/video>
      DirectoryIndex index.html
      RemoveHandler .php
  </Directory>
  <Directory /var/www/eclass/courses>
      DirectoryIndex index.html
      RemoveHandler .php
  </Directory>
  # handle /courses URLs through index.php
  AliasMatch ^/courses/[A-Z_-]+[0-9]{1,5}/(index.php)?$ /var/www/eclass/index.php

Φυσικά στο παραπάνω αρχείο αλλάξτε τo path του eclass με το δικό σας. Όμοια και τις διευθύνσεις IP.

1.4 Σύστημα αποστολής email

Σε διάφορες λειτουργίες της πλατφόρμας (π.χ. κατά την εγγραφή των χρηστών), γίνεται αποστολή email. Αν δεν λειτουργεί κάποια εφαρμογή αποστολής email, τα email της πλατφόρμας δεν θα αποστέλλονται πουθενά.

Μόνο για Windows:

Εναλλακτικά, για να εγκαταστήσετε τα παραπάνω, μπορείτε να χρησιμοποιήσετε το πακέτο EasyPHP ή το πακέτο XAMPP.

2. Εγκατάσταση

2.1 Για περιβάλλοντα Unix / Linux

Αποσυμπιέστε το αρχείο openeclass-4.0.tar.gz με την εντολή

tar xzvf openeclass-4.0.tar.gz. 

O υποκατάλογος που δημιουργείται κατά την αποσυμπίεση του πακέτου, περιέχει όλα τα αρχεία της εφαρμογής και πρέπει να τοποθετηθεί σε σημείο προσβάσιμο από τον web server.

Για την ασφαλή λειτουργία της πλατφόρμας θα πρέπει να ρυθμίσετε τα δικαιώματα πρόσβασης έτσι ώστε ο web server να έχει δικαίωμα εγγραφής στους φακέλους courses, video, config, storage.

Για να ξεκινήσετε την εγκατάσταση, επισκεφτείτε με κάποιον web browser την διεύθυνση που βρίσκεται ο υποκατάλογος /install/. Αν για παράδειγμα ο κύριος κατάλογος της εφαρμογής (δηλαδή /var/www/html/openeclass/) βρίσκεται στη διεύθυνση http://www.example.gr/openeclass/, η διεύθυνση που πρέπει να πληκτρολογήσετε είναι η http://www.example.gr/openeclass/install/ Στη συνέχεια ακολουθείστε τα βήματα του οδηγού εγκατάστασης της πλατφόρμας όπως αυτά παρουσιάζονται στην οθόνη σας.

Σημειώστε ότι κατά την διαδικασίας εγκατάστασης θα σας ζητηθούν τα παρακάτω:

2.2 Για περιβάλλοντα MsWindows

Αποσυμπιέστε το αρχείο openeclass-4.0.zip. O υποκατάλογος που δημιουργείται κατά την αποσυμπίεση του πακέτου, περιέχει όλα τα αρχεία της εφαρμογής και πρέπει να τοποθετηθεί σε σημείο προσβάσιμο από τον web server.

Για να ξεκινήσετε την εγκατάσταση, επισκεφτείτε με κάποιον web browser την διεύθυνση που βρίσκεται ο υποκατάλογος /install/. Αν για παράδειγμα ο κυρίως κατάλογος της εφαρμογής (δηλαδή C:\Program Files\Apache\htdocs/openeclass\) βρίσκεται στη διεύθυνση http://www.example.gr/eclass/, η διεύθυνση που πρέπει να πληκτρολογήσετε είναι η http://www.example.gr/openeclass/install/ Στη συνέχεια ακολουθείστε τα βήματα του οδηγού εγκατάστασης της πλατφόρμας όπως αυτά παρουσιάζονται στην οθόνη σας.

Σημειώστε ότι κατά την διαδικασίας εγκατάστασης θα σας ζητηθούν τα παρακάτω:

2.3 Για περιβάλλοντα Mac OS X

Αποσυμπιέστε το αρχείο openeclass-4.0.zip. O υποκατάλογος που δημιουργείται κατά την αποσυμπίεση του πακέτου, περιέχει όλα τα αρχεία της εφαρμογής και πρέπει να τοποθετηθεί σε σημείο προσβάσιμο από τον web server.

Για να ξεκινήσετε την εγκατάσταση, επισκεφτείτε με κάποιον web browser την διεύθυνση που βρίσκεται ο υποκατάλογος /install/. Αν για παράδειγμα ο κυρίως κατάλογος της εφαρμογής (π.χ. /Library/WebServer/Documents/openeclass ή /Users/(username)/Sites/openeclass) βρίσκεται στη διεύθυνση http://www.example.gr/eclass/, η διεύθυνση που πρέπει να πληκτρολογήσετε είναι η http://www.example.gr/openeclass/install/ Στη συνέχεια ακολουθείστε τα βήματα του οδηγού εγκατάστασης της πλατφόρμας όπως αυτά παρουσιάζονται στην οθόνη σας.

Σημειώστε ότι κατά την διαδικασίας εγκατάστασης θα σας ζητηθούν τα παρακάτω:

3. Ενέργειες μετά την εγκατάσταση

3.1 Αλλαγή δοκιμαστικών σχολών

To OpeneClass κατά την εγκατάσταση εισάγει 3 δοκιμαστικές / γενικές Σχολές /Τμήματα. (Τμήμα 1 με κωδικό TMA, Τμήμα 2 με κωδικό TMB κ.λπ.). Εσείς θα πρέπει να τις αλλάξετε και να τις προσαρμόσετε στις Σχολές ή Τμήματα που επιθυμείτε. Αυτό μπορείτε να το κάνετε μέσα από το διαχειριστικό εργαλείο. Μπαίνοντας σαν διαχειριστής στην πλατφόρμα και κάντε κλικ στα “Εργαλεία διαχείρισης”. Μετά κάντε κλικ στη “Διαχείριση Μαθημάτων” και κλικ στην επιλογή “Ιεραρχία Τμημάτων”. Επιλέξτε την επιλογή “Προσθήκη” ή κάντε δεξί κλικ στα υπάρχοντα και επιλέξτε “Διόρθωση” ή “Διαγραφή”.

3.2 Αλλαγή Θέματος

Αν θέλετε να αλλάξετε το θέμα της πλατφόρμας μπείτε ως διαχειριστής, κάντε κλικ στο “Διαχείριση πλατφόρμας” και μετά κλικ στο “Ρυθμίσεις Εμφάνισης”.

3.3 Αλλαγή μηνυμάτων

Αν θέλετε να αλλάξετε οποιοδήποτε μήνυμα της πλατφόρμας συνίσταται να το κάνετε ως εξής: Δημιουργήστε ένα αρχείο τύπου .php με όνομα greek.inc.phpenglish.inc.php αν πρόκειται για αγγλικά μηνύματα) και τοποθετήστε το στον κατάλογο (path του eclass)/config/ . Αναζητήστε το όνομα της μεταβλητής που περιέχει το μήνυμα που θέλετε να αλλάξετε και απλά αναθέστε της το καινούριο μήνυμα. Π.χ. Αν θέλουμε να αλλάξουμε το μήνυμα

$langAboutText = "Η έκδοση της πλατφόρμας είναι";

σε

$langAboutText = "Τρέχουσα έκδοση της πλατφόρμας";

απλά δημιουργούμε το greek.inc.php στον κατάλογo (path του eclass)/config/ ως εξής:

<?php
$langAboutText = "Τρέχουσα έκδοση της πλατφόρμας"; 

Με τον παραπάνω τρόπο εξασφαλίζεται η διατήρηση των τροποποιημένων μηνυμάτων από μελλοντικές αναβαθμίσεις της πλατφόρμας.

3.4 Υποστήριξη μαθηματικών συμβόλων

Για την σύνταξη μαθηματικών / χημικών συμβόλων δείτε παρακάτω

Συγγραφή μαθηματικών συμβόλων

3.5 Βασικές ρυθμίσεις

Μπορείτε να ρυθμίσετε αρκετές λειτουργίες της πλατφόρμας αφού πρώτα μπείτε σαν «Διαχειριστής» και μετά κάνετε κλικ στα “Εργαλεία Διαχείρισης” / “Ρυθμίσεις”.

Η πλατφόρμα υποστηρίζει το ανέβασμα στην πλατφόρμα των πιο διαδεδομένων τύπων αρχείων κειμένου, βίντεο, ήχου, εικόνας κ.λπ. Αν θέλετε να προσθέσετε κάποιον καινούριο, συμπληρώστε την κατάληξη του αρχείου στο “Τύποι επιτρεπτών αρχείων για τους εκπαιδευτές” ή στο “Τύποι επιτρεπτών αρχείων για τους εκπαιδευόμενους” αντίστοιχα.

3.6 Άλλες ρυθμίσεις

Μόνο για συστήματα Unix/Linux:

Αφού ολοκληρωθεί η εγκατάσταση, συνίσταται για λόγους ασφαλείας, να αλλάξετε τα δικαιώματα πρόσβασης των αρχείων

/config/config.php και 
/install/index.php 

και να επιτρέψτε μόνο ανάγνωση (τα permissions των παραπάνω θα πρέπει να είναι 444). Π.χ.:

chmod 444 /config/config.php /install/index.php