******************************* Οδηγίες Εγκατάσταης e-Class 1.2 ******************************* Η πλατφόρμα έχει δοκιμαστεί και λειτουργεί κανονικά σε Ms Windows NT/2000/XP, καθώς και σε διάφορες διανομές Unix/Linux (π.χ. Solaris, Debian, RedHat). Στη συνέχεια παρατίθενται αναλυτικά οι οδηγίες εγκατάστασης σε πλατφόρμες Unix/Linux και Ms Windows NT/2000/XP. *************************************************************** Οδηγίες εγκατάστασης του e-Class 1.2 (σε περιβάλλον Unix/Linux) *************************************************************** Στον υπολογιστή που θα εγκατασταθεί το e-Class πρέπει να τρέχει κάποιος web server. Η εφαρμογή έχει δοκιμαστεί με τον Apache, εκδόσεις 1.3.x και 2.0.x. Στον web server πρέπει να είναι εγκαταστημένη και η PHP 4.x με τα modules mysql, ldap, zlib και preg. Οι περισσότερες διανομές της PHP 4 περιέχουν τα modules αυτά. Κατά την εγκατάσταση ελέγχεται αν πληρούνται όλα τα προαπαιτούμενα. Συνίσταται να χρησιμοποιήσετε την τελευταία έκδοση της PHP. Αν η έκδοση της PHP είναι η 4.2 ή μεγαλύτερη, πρέπει να βάλετε στο αρχείο php.ini την παράμετρο: register_globals = on Ο Apache πρέπει να μπορεί να χειριστεί σελίδες με κατάληξη .php3 Αν δεν τον έχετε ρυθμίσει τότε αρκεί στο αρχείο httpd.conf, να προσθέσετε την ακόλουθη γραμμή: AddType application/x-httpd-php .php3 Απαιτείται επίσης πρόσβαση σε κάποια βάση δεδομένων MySQL. Πρέπει να έχετε έναν λογαριασμό που να μπορεί να δημιουργήσει βάσεις δεδομένων. Θα πρέπει επίσης ο MySQL server να έχει σαν default-character-set τα ελληνικά. Για να γίνει αυτό θα πρέπει να ξεκινήσετε τον mysqld (ή safe_mysqld) με την παράμετρο --default-character-set=greek Π.χ. /usr/local/mysql/bin/safe_mysqld --default-character-set=greek (+ τυχόν άλλες παράμετροι) Κατά την εγκατάσταση του e-Class θα σας ζητηθεί το login/password του λογαριασμού του Διαχειριστή (Administrator). Για την διαχείριση της βάσης δεδομένων χρησιμοποιείται το phpMyAdmin, ένα εργαλείο για διαχείριση της MySQL μέσω web. Στο πακέτο του e-Class περιλαμβάνεται η έκδοση 2.5.1 του phpMyAdmin, στον υποκατάλογο eclass/claroline/admin/mysql/. Στο σύστημα πρέπει επίσης να τρέχει κάποιος MTA (π.χ Sendmail), για τη μεταφορά των e-mail που στέλνει η πλατφόρμα e-Class. Όσον αφορά το μέγιστο μέγεθος των αρχείων που θα επιτρέπεται να γίνονται upload στην πλατφόρμα, μπορείτε να το ρυθμίσετε με τις παρακάτω γραμμές στο αρχείο php.ini. Προτείνεται: upload_max_filesize = 20M (η προκαθορισμένη τιμή είναι 2M) memory_limit = 25M (είναι 8M) post_max_size = 25M (είναι 8M) max_execution_time = 100 (είναι 30 δευτερόλεπτα) Μπορείτε να αποσυμπιέσετε το αρχείο eclass.tar.gz με την εντολή tar xzvf eclass.tar.gz . O υποκατάλογος που δημιουργείται κατά την αποσυμπίεση του πακέτου, περιέχει όλα τα αρχεία της εφαρμογής. Αυτός ο υποκατάλογος πρέπει να τοποθετηθεί σε σημείο προσβάσιμο από τον web server του υπολογιστή. Στους υποκαταλόγους eclass/, eclass/archive, eclass/claroline/garbage/, eclass/claroline/chat/ και eclass/claroline/include/ πρέπει να επιτρέπεται το γράψιμο αρχείων και η δημιουργία υποκαταλόγων από τον web server. Στο μεν κυρίως κατάλογο (eclass/) δημιουργούνται υποκατάλογοι για κάθε μάθημα, στον δε eclass/claroline/include/ θα γραφτεί το αρχείο των ρυθμίσεων της εφαρμογής κατά τη διάρκεια της εγκατάστασης. Το αρχείο αυτό ονομάζεται eclass/claroline/include/config.php. Ο web server τρέχει με τα δικαιώματα κάποιου συγκεκριμένου χρήστη ή group. Θα πρέπει να επιτρέψετε το γράψιμο από αυτόν τον χρήστη / group στους υποκαταλόγους αυτούς. Αν για παράδειγμα ο web server τρέχει με το user id www-data, μπορείτε να δώσετε: chmod 755 eclass/ eclass/archive/ eclass/claroline/garbage/ \ eclass/claroline/chat/ eclass/claroline/include/ chown www-data eclass/ eclass/archive/ eclass/claroline/garbage/ \ eclass/claroline/chat/ eclass/claroline/include/ Για να δώσετε τις παραπάνω εντολές, συνήθως χρειάζεται δικαιώματα διαχειριστή (root). Επίσης, καλό είναι να ορίσετε η προκαθορισμένη κωδικοποίηση των σελίδων που στέλνει ο web server να είναι η ελληνική (ISO 8859-7). Στον Apache, αυτό μπορείτε να το κάνετε βάζοντας στο αρχείο httpd.conf την παράμετρο: AddDefaultCharset iso-8859-7 Για να ξεκινήσετε την εγκατάσταση, επισκεφτείτε με κάποιον web broser την διεύθυνση που βρίσκεται ο υποκατάλογος claroline/install/. Αν για παράδειγμα ο κυρίως κατάλογος της εφαρμογής (ο eclass/) βρίσκεται στη διεύθυνση http://www.example.gr/eclass/, η διεύθυνση που πρέπει να πάτε είναι η http://www.example.gr/eclass/claroline/install/ Στη συνέχεια ακολουθείτε τις οδηγίες στη σελίδα αυτή. Κατά την εγκατάσταση θα πρέπει να γνωρίζετε τα παρακάτω. τον ldapserver του ιδρύματος στο οποίο θα εγκατασταθεί η εφαρμογή (π.χ. ldap.noc.uoa.gr) , το basedn του ldap server (π.χ. ou=people,o=UoA,c=gr ) και το email του helpdesk (στο οποίο θα αποστέλλονται οι αιτήσεις για δημιουργία λογαριασμού καθηγητή). Να σημειωθεί ότι ο υπολογιστής στον οποίο θα εγκατασταθεί το eclass θα πρέπει να έχει πρόσβαση στον ldapserver του ιδρύματος. Βεβαιωθείτε επίσης ότι το path της εγκατάστασης είναι σωστό. Μετά την εγκατάσταση συνίσταται για λόγους ασφαλείας του e-class, να αλλάξετε τα δικαιώματα πρόσβασης των αρχείων claroline/include/config.php και claroline/install/index.php και να επιτρέψτε μόνο ανάγνωση (chmod 444). chmod 444 eclass/claroline/include/config.php eclass/claroline/install/index.php Ακόμα συνίσταται για λόγους ασφαλείας να χρησιμοποιήσετε ελεγχόμενη πρόσβαση στο phpMyAdmin. Στο αρχείο eclass/claroline/admin/mysql/config.inc.php αναζητήστε την γραμμή $cfg['Servers'][$i]['auth_type']= Αλλάξτε τη δήλωση σε $cfg['Servers'][$i]['auth_type'] = 'cookie'; (δηλαδή η πρόσβαση θα βασίζεται στα cookies του browser) ή $cfg['Servers'][$i]['auth_type'] = 'http'; (η πρόσβαση θα ελέγχεται από τον apache) To e-Class κατά την εγκατάσταση εισάγει 5 δοκιμαστικές-γενικές Σχολές-Τμήματα. (ΤΜΑ Τμήμα1, ΤΜΒ Τμήμα 2 κλπ). Καλό είναι να τις αλλάξετε και να τις προσαρμόσετε στις Σχολές-Τμήματα του Ιδρύματός σας. Αυτό μπορείτε να το κάνετε μέσα από το διαχειριστικό εργαλείο. Περισσότερες και αναλυτικότερες οδηγίες για τις ενέργειες αυτές μπορείτε να βρείτε στο εγχειρίδιο του Διαχειριστή (στο διαχειριστικό εργαλείο). Τέλος να σημειωθεί ότι αν κάποιο ίδρυμα θέλει να αντικαταστήσει το αρχικό λογότυπο του e-Class με το δικό αρκεί να τροποποιήσει την εικόνα claroline/image/gunet/demo_banner.jpg Αφού ολοκληρώσει τις αλλαγές θα πρέπει να την μετονομάσει σε banner.jpg ************************************************************************** Οδηγίες εγκατάστασης του e-Class 1.2 (σε περιβάλλον Ms Windows NT/2000/XP) ************************************************************************** Η πλατφόρμα e-Class έχει δοκιμαστεί και λειτουργεί κανονικά σε πλατφόρμα Ms Windows NT/2000/XP με τον web server Apache. Για να εγκαταστήσετε ευκολότερα τον Apache και ό,τι άλλο χρειάζεται για να τρέξει το e-Class, μπορείτε να χρησιμοποιήσετε το πακέτο easyPHP που μπορείτε να κατεβάσετε από τη διεύθυνση: http://www.easyphp.org/ Η εγκατάσταση περιλαμβάνει, μεταξύ άλλων, τον Apache, καθώς και το διαχειριστή βάσεων δεδομένων MySQL. Να σημειωθεί ότι ο Apache θα πρέπει να μπορεί να χειρίζεται και σελίδες με κατάληξη .php3 . Επίσης, καλό είναι να ρυθμίσετε την προκαθορισμένη κωδικοποίηση των σελίδων να είναι η Ελληνική (ISO 8859-7). Για να γίνουν αυτές οι δύο ρυθμίσεις, μετά την εγκατάσταση του EasyPHP πρέπει στο αρχείο των ρυθμίσεων του Apache, httpd.conf , να προσθέσετε την ακόλουθη γραμμή: AddType application/x-httpd-php .php3 .php4 .php .inc AddDefaultCharset ISO-8859-7 Αν χρησιμοποιείτε έκδοση 2.0.x του Apache, την οποία έχετε εγκαταστήσει αυτόνομα και όχι με το πακέτο EasyPHP, θα πρέπει να εγκαταστήσετε επίσης και το πακέτο της PHP και να φροντίσετε να τη φορτώνει ο Apache, βάζοντας στο αρχείο των ρυθμίσεών του ( Apache2\conf\httpd.conf ) τη γραμμή: LoadModule php4_module "C:/Program Files/PHP/sapi/php4apache2.dll" (το path είναι σχετικό με την εγκατάσταση της PHP). Θα πρέπει επίσης να αντιγράψετε και τα εξής αρχεία dll στον φάκελο WinNT\System32 : * php\dlls\libeay32.dll * php\dlls\ssleay32.dll * php\extensions\php_ldap.dll * php\sapi\php4apache2.dll * php\php4ts.dll Επίσης χρειάζονται και κάποιες αλλαγές στις παραμέτρους της PHP, τις οποίες θα κάνετε στο αρχείο WinNT\php.ini : * Ορίζετε register_globals = On (η προκαθορισμένη τιμή είναι Off) * Στα Windows extensions βγάζετε τα σχόλια (;) από το τη γραμμή extension = php_ldap.dll * Συμπληρώσαμε τον SMTP server που σας εξυπηρετεί για αποστολή e-mail, π.χ. SMTP = mail.noc.uoa.gr * Όσον αφορά το μέγιστο μέγεθος των αρχείων που θα επιτρέπεται να γίνονται upload στην πλατφόρμα, μπορείτε να το ρυθμίσετε με τις παρακάτω γραμμές: upload_max_filesize = 20M (η προκαθορισμένη τιμή είναι 2M) memory_limit = 25M (είναι 8M) post_max_size = 25M (είναι 8M) max_execution_time = 100 (είναι 30 δευτερόλεπτα) * Τέλος, καλό είναι να ορίσετε κι εδώ την προκαθορισμένη κωδικοποίηση με τη γραμμή: default_charset = "iso-8859-7" Αποσυμπιέζετε το αρχείο e-class.zip στο root directory του Apache Server. Αν εγκαταστήσατε το EasyPHP στο προεπιλεγμένο κατάλογο, τότε το root directory του Apache βρίσκετε στη διαδρομή c:\Program Files\EasyPHP\www . Σε διαφορετική περίπτωση αναζητήστε το, κάτω από τον κατάλογο EasyPHP στην διαδρομή που επιλέξατε κατά την εγκατάσταση του EasyPHP. Αν ο υπολογιστή σας τρέχει τον WebServer της Microsoft (IIS) πρέπει να τον απενεργοποιήσετε. Πηγαίνετε στο Start->Programs->Administrative Tools->Services και σταματήστε την υπηρεσία «World Wide Web Publishing Service», κάνοντας δεξί κλικ και επιλέγοντας «stop». Για να απενεργοποιηθεί ο IIS μόνιμα, κάντε δεξί κλικ στην παραπάνω υπηρεσία και επιλέξτε «Disabled» από τον κατάλογο επιλογών «Startup type» Με την ολοκλήρωση των παραπάνω βημάτων, μπορείτε να αρχίσετε την διαδικασία εγκατάστασης του e-Class. 1. Ανοίξτε έναν Internet Φυλλομετρητή (Browser) και πληκτρολογήστε τη διεύθυνση: http://localhost/eclass/claroline/install/index.php 2. Ακολουθήστε τα βήματα εγκατάστασης που περιγράφονται στις σελίδες αυτές. 3. Για περισσότερη βοήθεια κάντε κλικ στο σύνδεσμο INSTALL.txt που βρίσκεται στο κάτω μέρος της σελίδας Κατά την εγκατάσταση θα πρέπει να γνωρίζετε τα παρακάτω. τον ldapserver του ιδρύματος στο οποίο θα εγκατασταθεί η εφαρμογή (π.χ. ldap.noc.uoa.gr) , το base dn του ldap server (π.χ. ou=people,o=UoA,c=gr ) και το email του helpdesk (στο οποίο θα αποστέλλονται οι αιτήσεις για δημιουργία λογαριασμού καθηγητή). Να σημειωθεί ότι ο υπολογιστής στον οποίο θα εγκατασταθεί το eclass θα πρέπει να έχει πρόσβαση στον ldapserver του ιδρύματος. Βεβαιωθείτε επίσης ότι το path της εγκατάστασης είναι σωστό. Για τη λειτoυργία της αποστολής email θα πρέπει να πάτε στο αρχείο php.ini και να δηλώσετε στην μεταβλητή SMTP το όνομα του mail server. Κατόπιν επανεκκινήστε τον apache. To e-Class κατά την εγκατάσταση εισάγει 5 δοκιμαστικές-γενικές Σχολές-Τμήματα. (ΤΜΑ Τμήμα1, ΤΜΒ Τμήμα 2 κλπ). Καλό είναι να τις αλλάξετε και να τις προσαρμόσετε στις Σχολές-Τμήματα του Ιδρύματός σας. Αυτό μπορείτε να το κάνετε μέσα από το διαχειριστικό εργαλείο. Περισσότερες και αναλυτικότερες οδηγίες για τις ενέργειες αυτές μπορείτε να βρείτε στο εγχειρίδιο του Διαχειριστή (στο διαχειριστικό εργαλείο). Τέλος να σημειωθεί ότι αν κάποιο ίδρυμα θέλει να αντικαταστήσει το αρχικό λογότυπο του e-Class με το δικό αρκεί να τροποποιήσει την εικόνα claroline/image/gunet/demo_banner.jpg Αφού ολοκληρώσει τις αλλαγές θα πρέπει να την μετονομάσει σε banner.jpg