Installation
Η εγκατάσταση και το development του openeclass απαιτούν τα εξής εργαλεία/υπηρεσίες:
- php
- web server (apache)
- database (mysql)
- openeclass source code
- editor (vim/emacs/nano/gedit/kate/notepad++,etc)
- GitHub account
- Git
- GitHub client για Windows αν το development γίνεται σε windows
Γενικότερα προτείνεται το development σε Linux, αν και είναι εφικτό να γίνει και σε Windows. Οι Mac users ίσως θέλουν να ρίξουν μια ματιά στο homebrew για την εγκατάσταση πακέτων, αν και το xampp υπάρχει και για Mac (δεν το έχουμε δοκιμάσει).
Παρακάτω θα δούμε τη διαδικασία εγκατάστασης του Openeclass και των διαφόρων components για το web development σε Windows.
Το wampp είναι ένα πακέτο που περιέχει συγκεντρωμένες όλες τις εξαρτήσεις που χρειάζονται για το php development. Συγκεκριμένα περιέχει τον Apache web server, τη Mysql βάση δεδομένων, την PHP γλώσσα, καθώς και ένα control panel για να διαχειριζόμαστε εύκολα όλες τις υπηρεσίες.
Για να το εγκαταστήσετε κατεβάστε αυτό το αρχείο. Ακολουθούν αναλυτικές οδηγίες εγκατάστασης του xampp.
Βήμα 1
Μόλις τρέξουμε το αρχείο που μόλις κατεβάσαμε θα εμφανιστεί η παρακάτω εικόνα και θα ξεκινήσει η διαδικασία της εγκατάστασης.
Βήμα 2
Διαλέγουμε όλα τα περιεχόμενα.
Βήμα 3
Πολύ σημαντικό, ο φάκελος όπου θα εγκαταστεθεί το xampp δεν πρέπει να είναι μέσα στο Program Files.
Ο installer έχει προρυθμισμένο το φάκελο C:\xampp οπότε θα το εγκαταστήσουμε εκεί.
Βήμα 4
Το επόμενο βήμα μας προτρέπει να μάθουμε περισσότερα για την υπηρεσία Bitnami. Παρ' όλο που έχει ενδιαφέρον, δεν είναι ο σκοπός μας, οπότε ξετικάρουμε την επιλογή.
Βήμα 5
Βήμα 6
Η διαδικασία εγκατάστασης ξεκίνησε.
Βήμα 7
Η εγκατάσταση τελείωσε, πατάμε Finish για να ανοίξει το control panel του xampp.
Βήμα 8
Παρακάτω είναι το control panel του xampp με τον Apache και τη Mysql να τρέχουν. Παρατηρήστε ότι είναι και τα 2 πράσινα. Για να ξεκινήσει μια υπηρεσία πατάμε Start, για να σταματήσει Stop.
Σε περίπτωση που ο Apache δεν ξεκινάει και εμφανίζει σφάλμα, κάντε επανεκίννηση των Windows, ανοίξτε το control panel και προσπαθήστε να ξεκινήσετε πάλι τον Apache.
Βήμα 9
Σε περίπτωση που το firewall προειδοποιήσει για τον Apache ή τη Mysql, κάντε τις ακόλουθες ρυθμίσεις και πατήστε Allow Access.
Όλοι οι εκπαιδευόμενοι πρέπει να διαθέτουν ένα λογαριασμό στο GitHub. Όσοι δεν έχουν θα πρέπει να δημιουργήσουν ένα λογαριασμό πηγαίντας στο https://github.com/join. Εισάγετε τα στοιχεία που ζητούνται(username, e-mail, password) και διαλέξτε το Free plan.
Υπενθυμίζουμε ότι οι παρακάτω οδηγίες είναι μόνο για Windows (Vista/7/8).
Πηγαίνετε στην ακόλουθη διεύθυνση https://windows.github.com/, κατεβάστε τον GitHub client και τρέξτε το εκτελέσιμο για να εγκατασταθεί.
Μόλις τελειώσει θα έχουν δημιουργηθεί 2 εικονίδια στην Επιφάνεια Εργασίας.
Το κυρίως πρόγραμμα είναι το GitHub το οποίο μόλις το ανοίξουμε μας ζητάει username και password. Εισάγουμε αυτά με τα οποία κάναμε λογαριασμό στο παραπάνω βήμα.
Βήμα 1
Το αμέσως επόμενο βήμα είναι να κάνουμε το λεγόμενο fork του κώδικα του openeclass στο δικό μας λογαριασμό. Στη ουσία γίνεται αντιγραφή του repository στο δικό μας account.
Πάμε στο https://github.com/maellak/openeclass και πατάμε πάνω δεξιά το κουμπί Fork.
Από δω και στο εξής, ό,τι αλλαγή κάνουμε θα είναι πάνω στο δικό μας αντίγραφο και με τη μέθοδο των Pull Requests, θα κάνουμε merge στο πατρικό repository του maellak. Έτσι, αν γίνει κάποιο λάθος είναι πολύ πιο εύκολο να κανουμε revert τις αλλαγές.
Βήμα 2
Αφού έχουμε ήδη εγκαταστήσει τον Github client από προηγούμενο βήμα, στη δεξιά στήλη πατάμε το Clone In Desktop.
Αν χρησιμοποιείτε Firefox, θα δείτε το παρακάτω παράθυρο. Βάλτε τικ στο Remember my choice και πατήστε Οκ.
Βήμα 3
Αμέσως μετά θα σας ρωτήσει που να σώσετε το repository. Θα το αποθηκεύσουμε συγκεκριμένα στο εξής Path:
My Computer -> Local Disk (C:) -> xampp -> htdocs
Μόλις τελειώσει, θα δείτε μια παρόμοια εικόνα με την παρακάτω.
Σε αυτό το σημείο, έχουμε τοπικά τον πηγαίο κώδικα και είναι ταυτόχρονα υπό version control (git). Μένει μόνο να φτιάξουμε τη βάση δεδομένων.
Βήμα 1
Για να παίξει το openeclass πρέπει να πρώτα να δημιουργήσουμε μία βάση δεδομένων. Αρχικά θα ορίσουμε ένα username/password για τη διαχείριση της βάσης. Έχοντας ανοιχτές τις υπηρεσίες apache/mysql από το control panel του xampp, ανοίγουμε τον Web Browser (Firefox) και στη μπάρα διευθύνσεων γράφουμε:
localhost/security/xamppsecurity.php
Δίνουμε έναν εύκολο κωδικό (πχ. ~yg5%_Lms) και πατάμε Password changing.
Προσοχή:
Αν δουλεύαμε σε περιβάλλον production, ο κωδικός της βάσης δεδομένων θα πρέπει να είναι μεγάλος και δύσκολος. Επίσης είναι καλή πρακτική κάθε βάση να έχει το δικό της χρήστη. Σε development περιβάλλοντα όπως το δικό μας όπου δουλεύουμε τοπικά, δε χρειάζεται να είμαστε τόσο προσεκτικοί.
Βήμα 2
Πάμε τώρα να δημιουργήσουμε τη βάση δεδομένων του openeclass.
Έχοντας ανοιχτές τις υπηρεσίες apache/mysql από το control panel του xampp, ανοίγουμε τον Web Browser (Firefox) και στη μπάρα διευθύνσεων γράφουμε:
localhost/phpmyadmin
Το username είναι root και το password αυτό που ορίσαμε παραπάνω.
Πάνω αριστερά πατάμε New.
Αμέσως μετά, δίνουμε ένα όνομα στη βάση, επιλέγουμε utf8_unicode_ci από το μενού και πατάμε Create. Ένα μήνυμα με πράσινο φοντο θα μας ειδοποιήσει ότι η βάση δημιουργήθηκε.
Το τελευταίο βήμα είναι να εγκαταστήσουμε το Openeclass.
Τα Windows δεν έχουν προεγκατεστημένο κάποιον text editor αρκετά καλό για web development. Το word, το notepad αποκλείονται δια ροπάλου. Ένας πολύ καλός text editor είναι ο notepadd++ και μάλιστα είναι open source. Μπορείτε να τον κατεβάσετε από εδώ.
Οι υπολογιστές του εργαστηρίου διαθέτουν τη διανομή Fedora. Ένας από τους πολλούς οδηγούς εγκατάστασης μπορεί να βρεθεί εδώ.
Οι παρακάτω εντολή δίνεται ως root (όταν ζητηθεί δώστε τον κωδικό που έχουμε πει στην αίθουσα) και εγκαθιστά τα απαραίτητα πακέτα:
su -
curl https://raw.githubusercontent.com/maellak/scripts/master/fedora-homedir.sh | sh
Από δω και στο εξής, ο φάκελος μέσα στον οποίο θα δουλέψουμε είναι ο /home/ellak/public_html.
Βήμα 1
Αρχικά γινόμαστε root:
su -
Βήμα 2
Εγκατάσταση MySQL (το free πακέτο λέγεται mariadb) και ξεκίνημα της υπηρεσίας:
yum install -y mariadb-serversystemctl start mysqld
Βήμα 3
Στο τελευταίο βήμα δίνουμε την παρακάτω εντολή. Όταν ζητηθεί, βάζουμε έναν εύκολο κωδικό (πχ. ~yg5%_Lms) και πατάμε Enter. Σε όλες τις άλλες ερωτήσεις πατάμε απλά Enter.
mysql_secure_installation
Προσοχή: Αν δουλεύαμε σε περιβάλλον production, ο κωδικός της βάσης δεδομένων θα πρέπει να είναι μεγάλος και δύσκολος. Επίσης είναι καλή πρακτική κάθε βάση να έχει το δικό της χρήστη. Σε development περιβάλλοντα όπως το δικό μας όπου δουλεύουμε τοπικά, δε χρειάζεται να είμαστε τόσο προσεκτικοί.
Αρχικά βεβαιωθείτε ότι έχετε κάνει fork το repository του openeclass.
Βήμα 1
Αρχικά, αν κάποιος είναι συνδεδεμένος ως root θα πρέπει να συνδεθεί με το χρήστη ellak. Σε ένα terminal, αν δώσουμε την εντολή whoami, θα μας πει ποιος χρήστης είμαστε. Αν εμφανίσει root δίνετε την παρακάτω εντολή, αλλιώς παραλείψτε την παρακάτω εντολή.
su - ellak
Βήμα 2
Πάμε μέσα στο φάκελο όπου o Apache 'σερβίρει' τις σελίδες μας:
cd /home/ellak/public_html
Βήμα 3
Αντικαθιστούμε το username με αυτό που δώσαμε στο github κατα την εγγραφή.
git clone https://github.com/username/openeclass.git
Τέλος πάμε στη διεύθυνση: http://localhost/openeclass και ακολουθούμε τις οδηγίες εγκατάστασης.
Πάμε με τον Firefox στην παρακάτω διεύθυνση για να ξεκινήσει η διαδικασία εγκατάστασης του Openeclass: http://localhost/openeclass/install.
Βήμα 1
O Install Wizard του Openeclass. Επιλέγουμε ελληνικά και πάμε στο επόμενο βήμα.
Βήμα 2
Στο δεύτερο βήμα ελέγχει αν το σύστημά μας πληροί όλες τις απαιτούμενες εξαρτήσεις. Αγνοήστε το μήνυμα περί LDAP.
Βήμα 3
Αποδοχή της άδειας GPL2.
Βήμα 4
Εδώ είναι το σημαντικότερο βήμα. Εισάγουμε τα στοιχεία του χρήστη root και το password που δημιουργήσαμε. Δίνουμε ένα όνομα για τη νέα βάση που θα δημιουργηθεί ή αφήνουμε το eclass.
Βήμα 5
Αμέσως μετά, ο οδηγός μας ζητάει τα στοιχεία του διαχειριστή της πλατφόρμας. Στην περίπτωσή μας, το σημαντικότερο είναι το Συνθηματικό του Διαχειριστή, με το οποίο θα κάνουμε login αργότερα. Το αλλάζουμε σε κάτι εύκολο. Ισχύουν οι ίδιοι κανόνες με τον κωδικό της MySQL. Σε περιβάλλον production θα βάζαμε κάτι δύσκολο και θα αλλάζαμε και το username.
Βήμα 6
Εδώ βλέπουμε κάποιες επιπλέον επιλογές που ο οδηγός μας δίνει τη δυνατότητα να ορίσουμε. Στην περίπτωσή μας τα αφήνουμε όπως είναι και πάμε στο επόμενο βήμα.
Βήμα 7
Στο τελευταίο βήμα βλέπουμε τις επιλογές που έχουμε κάνει μέχρι τώρα. Αν έχουμε κάνει κάποιο λάθος ή θέλουμε να κάνουμε κάποια αλλαγή, τώρα είναι κατάλληλη στιγμή να πάμε πίσω σε προηγούμενα βήματα.
Βήμα 8
Αν όλα πήγαν καλά, θα ειδοποιηθούμε ότι η εγκατάσταση ήταν επιτυχής.
Πατώντας το Είσοδος στο Open eClass μας πάει στο link http://localhost/openclass όπου και βλέπουμε το περιβάλλον της εφαρμογής. Δίνοντας username/password αυτή που ορίσαμε στο βήμα 5 συνδεόμαστε ώς διαχειριστές.
