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

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

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

• Σε περιβάλλοντα MsWindows (Windows NT, Windows 2000, Windows XP, Windows 2003, Windows Vista, Windows 7, Windows 2008)
• Σε διάφορες διανομές Linux (π.χ. RedHat, CentOS, Debian, Ubuntu, OpenSuse κ.λπ.)
• Σε άλλα περιβάλλοντα UNIX (π.χ. Solaris).

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

• Ενέργειες πριν την εγκατάσταση - Προαπαιτούμενα
• Για περιβάλλοντα Unix / Linux
• Για περιβάλλοντα MsWindows
• Ενέργειες μετά την εγκατάσταση
• • Αλλαγή δοκιμαστικών σχολών
  • Αλλαγή λογότυπου
  • Αλλαγή θέματος εμφάνισης
  • Αλλαγή μηνυμάτων
  • Υποστήριξη μαθηματικών συμβόλων
  • Υποστήριξη άλλων γλωσσών
  • Εγγραφή χρηστών μέσω αίτησης
  • PhpMyAdmin
  • Ρυθμίσεις του πίνακα config
  • Άλλες ρυθμίσεις

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

Για την εγκατάσταση της πλατφόρμας Open eClass 2.4, απαιτείται η ύπαρξη και η καλή λειτουργία μιας σειράς συστημάτων και εφαρμογών. Αυτές είναι οι εξής:

1. Web Server (Apache 2.x)

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

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

Επίσης, θα πρέπει να ορίσετε ότι η προκαθορισμένη κωδικοποίηση των σελίδων που στέλνει ο 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>

2. PHP (εκδόσεις >= 5.0)

Η πλατφόρμα λειτουργεί χωρίς προβλήματα με εκδόσεις >= 5.0

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

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

Θα πρέπει επίσης να ορίσετε στο αρχείο php.ini τις παραμέτρους:

short_open_tag = on
magic_quotes_gpc = on

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

• upload_max_filesize = 40M (η προκαθορισμένη τιμή είναι 2M)
• memory_limit = 25M (η προκαθορισμένη είναι 8M)
• post_max_size = 45M (η προκαθορισμένη είναι 8M)
• max_execution_time = 100 (η προκαθορισμένη είναι 30 sec)

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

display_errors = Off

Τέλος, καλό είναι να ορίσετε κι εδώ την προκαθορισμένη κωδικοποίηση με τη γραμμή: default_charset = "UTF-8"

Μόλις ολοκληρώσετε τις αλλαγές σας, επανεκκινήστε τον apache.

3. MySQL (εκδόσεις 4.1.x ή 5.x)

Παράλληλα με την εγκατάσταση της MySQL θα πρέπει να δημιουργηθεί ένας λογαριασμός χρήστη (user account), με δικαιώματα δημιουργίας και διαγραφής βάσης δεδομένων.

4. sendmail ή postfix (προαιρετικά)

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

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

Διαδικασία εγκατάστασης

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

Αν ο web server τρέχει σαν χρήστης www-data, για να ρυθμίσετε τα δικαιώματα πρόσβασης μπορείτε να δώσετε τις παρακάτω εντολές (σαν χρήστης root):

		cd (path του eclass) (π.χ. cd /var/www/html/openeclass)
		chown -R www-data *
		find ./ -type f -exec chmod 664 {} \;
		find ./ -type d -exec chmod 775 {} \;
		

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

• Το όνομα του υπολογιστή όπου είναι εγκατεστημένη η MySQL (π.χ. openeclass.org, ή localhost - αν είναι στον ίδιο υπολογιστή)
• Ένα "Όνομα Χρήστη" και "Συνθηματικό" για ένα χρήστη της MySQL με δικαιώματα δημιουργίας και διαγραφής βάσεων
• Όνομα για την κύρια βάση δεδομένων του eClass (το default είναι eclass). Αλλάξτε το οπωσδήποτε, αν υπάρχει ήδη μια βάση δεδομένων με το ίδιο όνομα.
• URL της πλατφόρμας (όπως αυτό θα εμφανίζεται στον browser μετά την εγκατάσταση π.χ. http://www.openeclass.org/eclass/)
• Το path των αρχείων στον server. Βεβαιωθείτε ότι το path είναι σωστό (π.χ. /var/www/html/).
• Όνομα / Επώνυμο και email Διαχειριστή.
• Όνομα Χρήστη και Συνθηματικό Διαχειριστή.
• Το όνομα που θέλετε να δώσετε στην πλατφόρμα (π.χ. Open eClass)
• Tηλέφωνο και email helpdesk (σε αυτό το email στέλνονται οι διάφορες αιτήσεις, θα μπορούσε να είναι το ίδιο με του διαχειριστή).
• Όνομα και διεύθυνση του ιδρύματος σας.

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

Διαδικασία εγκατάστασης

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

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

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

• Το όνομα του υπολογιστή όπου είναι εγκατεστημένη η MySQL (π.χ. openeclass.org, localhost - αν είναι στον ίδιο υπολογιστή)
• Ένα "Όνομα Χρήστη" και "Συνθηματικό" για ένα χρήστη της MySQL με δικαιώματα δημιουργίας και διαγραφής βάσεων
• Όνομα για την κύρια βάση δεδομένων του eClass (το default είναι eclass). Αλλάξτε το οπωσδήποτε, αν υπάρχει ήδη μια βάση δεδομένων με το ίδιο όνομα.
• URL της πλατφόρμας (όπως αυτό θα εμφανίζεται στον browser μετά την εγκατάσταση π.χ. http://www.openeclass.org/eclass/)
• Το path των αρχείων στον server. Βεβαιωθείτε ότι το path είναι σωστό (π.χ. C:\Program Files\Apache\htdocs\).
• Όνομα / Επώνυμο και email Διαχειριστή.
• Όνομα Χρήστη και Συνθηματικό Διαχειριστή
• Το όνομα που θέλετε να δώσετε στην πλατφόρμα (π.χ. Open eClass)
• Tηλέφωνο και email helpdesk (σε αυτό το email έρχονται οι διάφορες αιτήσεις θα μπορούσε να είναι το ίδιο με του διαχειριστή).
• Όνομα και διεύθυνση του ιδρύματος σας.

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

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

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

Αλλαγή λογότυπου

Aν κάποιο ίδρυμα θέλει να αντικαταστήσει το αρχικό λογότυπο του OpeneClass με το δικό, αρκεί να αντικαταστήσει την εικόνα

με την δικιά του.

Αλλαγή θέματος εμφάνισης

Εξ'ορισμού η πλατφόρμα έχει σαν θέμα εμφάνισης το «classic». Μπορείτε να το αλλάξετε από το διαχειριστικό εργαλείο σε «modern». Σημειώστε ότι στους χρήστες η αλλαγή θα γίνει ορατή στην επόμενη είσοδό τους στην πλατφόρμα.

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

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

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

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

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

Μπορείτε να αλλάξετε τα ονόματα των βασικών ρόλων των χρηστών της πλατφόρμας αλλάζοντας το αρχείο μηνυμάτων (path του eClass)/modules/lang/greek/common.inc.php

Επίσης σημειώστε ότι μπορείτε να προσθέσετε κείμενο (π.χ. ενημερωτικού περιεχομένου) στα αριστερά και δεξιά της αρχικής σελίδας της πλατφόρμας. Για το σκοπό αυτό, αναθέστε την τιμή - μήνυμα στις μεταβλητές $langExtrasLeft και $langExtrasRight αντίστοιχα, που βρίσκονται στο (path του eClass)/modules/lang/greek/common.inc.php

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

Η πλατφόρμα υποστηρίζει την συγγραφή μαθηματικών συμβόλων στα υποσύστηματα "Ασκήσεις", "Περιοχές συζητήσεων" και "Ανακοινώσεις". Συγκεκριμένα στο υποσύστημα "Ασκήσεις" μπορείτε να βάλετε μαθηματικά σύμβολα στα πεδία "Περιγραφή Άσκησης" όταν δημιουργείτε μια καινούρια άσκηση (ή όταν την διορθώνετε), στο πεδίο "Προαιρετικό Σχόλιο" όταν δημιουργείτε μια καινούρια ερώτηση σε μια άσκηση (ή όταν την διορθώνετε). Στο υποσύστημα "Περιοχές συζητήσεων" όταν συντάσσετε ένα καινούριο μήνυμα ή όταν απαντάτε σε αυτό και στο υποσύστημα "Ανακοινώσεις" όταν δημιουργείτε μια ανακοίνωση. Τα μαθηματικά σύμβολα πρέπει απαραίτητα να περικλείονται με τα tags <m> και </m>. Π.χ. πληκτρολογώντας

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

Υποστήριξη άλλων γλωσσών

Η πλατφόρμα διαθέτει υποστήριξη για τα Αγγλικά και τα Ισπανικά. Αν θέλετε να απενεργοποιήσετε κάποια από αυτές τις γλώσσες, προσθέστε στο αρχείο ρυθμίσεων config.php την γραμμή

$active_ui_languages = array('el', 'en');

$active_ui_languages = array('el', 'es');

Εξ' ορισμού η παραπάνω μεταβλητή έχει την τιμή

$active_ui_languages = array('el', 'en', 'es');

Εγγραφή χρηστών μέσω αίτησης

Στο αρχείο config.php ορίζεται η μεταβλητή close_user_registration η οποία εξ'ορισμού έχει τιμή FALSE. Αλλάζοντας την σε τιμή TRUE η εγγραφή χρηστών με δικαιώματα "φοιτητή" δεν θα είναι πλέον ελεύθερη. Οι χρήστες για να αποκτήσουν λογαριασμό στην πλατφόρμα θα ακολουθούν πλέον διαδικασία παρόμοια με τη δημιουργία λογαριασμού "καθηγητή" δηλαδή θα συμπληρώνουν μια φόρμα-αίτηση δημουργίας λογαριασμού φοιτητή. Η αίτηση εξετάζεται από τον διαχειριστή ο οποίος εγκρίνει την αίτηση, οπότε δημιουργεί τον λογαριασμό, ή την απορρίπτει. Αν δεν επιθυμείτε να αλλάξει ο τρόπος εγγραφής φοιτητών αφήστε την όπως είναι. (δηλαδή στην τιμή FALSE).

PhpMyAdmin

Η πλατφόρμα διανέμεται με το διαχειριστικό εργαλείο phpMyAdmin. Για λόγους ασφαλείας, η πρόσβαση στο phpMyAdmin γίνεται μέσω cookies του browser. Αν θέλετε να το αλλάξετε, ανατρέξτε στο αρχείο ρυθμίσεων config.inc.php του phpMyAdmin.

Ρυθμίσεις του πίνακα config

Το eClass κατά την εγκατάσταση, δημιουργεί στην κεντρική βάση δεδομένων τον πίνακα config. Σε αυτό τον πίνακα, κάθε γραμμή του αντιστοιχεί σε μία (προαιρετική) ρύθμιση της πλατφόρμας. Οι ρυθμίσεις αυτές ζητούνται από το πρόγραμμα εγκατάστασης. Αν δεν τις αλλάξετε έχουν κάποιες τιμές εξ´ ορισμού. Αργότερα μπορούν να τροποποιηθούν, από το διαχειριστικό εργαλείο της πλατφόρμας. Αυτές είναι:

• email_required: Το email των χρηστών, κατά την εγγραφή τους, θα είναι υποχρεωτικό.
• am_required: Ο αριθμός μητρώου των χρηστών, κατά την εγγραφή τους, θα είναι υποχρεωτικός.
• dropbox_allow_student_to_student: Θα επιτρέπεται η ανταλλαγή αρχείων μεταξύ χρηστών στο υποσύστημα 'Ανταλλαγή αρχείων'.
• dont_display_login_form: Δεν θα εμφανίζεται στην αρχική σελίδα της πλατφόρμας η οθόνη σύνδεσης και θα εμφανίζεται ένας σύνδεσμος προς αυτήν.
• block_username_change: Δεν θα επιτρέπεται να αλλάζουν οι χρήστες το 'όνομα χρήστη'.
• display_captcha: Να εμφανίζεται κωδικός ασφάλειας κατά την εγγραφή νέων χρηστών.
• insert_xml_metadata: Να επιτρέπεται στους εκπαιδευτές να ανεβάσουν μεταδεδομένα σε αρχεία του υποσύστηματος 'Εγγραφα'.

• doc_quota: Καθορίζεται το εξ' ορισμού όριο αποθηκευτικού χώρου μαθήματος για το υποσύστημα «Έγγραφα».
• video_quota: Καθορίζεται το εξ' ορισμού όριο αποθηκευτικού χώρου μαθήματος για το υποσύστημα «Βίντεο».
• dropbox_quota: Καθορίζεται το εξ' ορισμού όριο αποθηκευτικού χώρου μαθήματος για το υποσύστημα «Ανταλλαγή αρχείων».
• group_quota: Καθορίζεται το εξ' ορισμού όριο αποθηκευτικού χώρου μαθήματος για το υποσύστημα «Ομάδες Χρηστών».

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

Αν θέλετε να χρησιμοποιήσετε την πλατφόρμα με Web server που έχει ενεργοποιημένη την υποστήριξη SSL (π.χ. https://eclass.gunet.gr) μπορείτε να το κάνετε δηλώνοντας στο config.php την μεταβλητή urlSecure. π.χ. $urlSecure = "https://eclass.gunet.gr". Περισσότερες και αναλυτικότερες οδηγίες για τις ενέργειες αυτές, μπορείτε να βρείτε στο εγχειρίδιο του Διαχειριστή (βρίσκεται μέσα στο διαχειριστικό εργαλείο).

Σημειώστε, ότι οι χρήστες της πλατφόρμας θα πρέπει να έχουν την javascript ενεργοποιημένη στον browser τους.

• Για τους χρήστες του Internet Explorer, από τα μενού επιλέξτε διαδοχικά Internet Options/Security/Custom Level/Security Options και μαρκάρετε την επιλογή "Scripting of java applets".
• Για τους χρήστες του Firefox, επιλέξτε διαδοχικά Edit / Preferences / Web features και μαρκάρετε την επιλογή "Enable JavaScript".

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