Πριν ξεκινήσετε το πρόγραμμα για πρώτη φορά υπάρχει ένα σημείο ιδιαίτερα σημαντικό το οποίο θα πρέπει να προσέξετε. Αυτό σχετίζεται με τον καθορισμό των “συμφραζομένων” από τον οποίο εξαρτάται η ομαλή λειτουργία του Semanlink. Μια διαδικασία εξαιρετικά εύκολη!
(Για τους χρήστες του Tomcat : δεν είναι δυνατό απλώς να αντιγράψετε το αρχείο Semanlink.war στον κατάλογο (directory) “webapps” του Tomcat. Λυπούμαστε για αυτό, αλλά ο servlet του Semanlink λειτουργεί βάσει των πληροφοριών που περιέχονται στα «συμφραζόμενα» που πρόκειται να καθορίσουμε).
Το Semanlink είναι μια διαδικτυακή εφαρμογή. Προκειμένου λοιπόν να χρησιμοποιήσετε το λογισμικό είναι απαραίτητο να έχετε στον υπολογιστή σας εγκατεστημένη μια εφαρμογή servlet. (Servlet είναι το λογισμικό που καθορίζει την ομαλή λειτουργία μιας εφαρμογής ή διαδικτυακού προγράμματος. Για παράδειγμα το Java είναι ένα servlet το οποίο επιτρέπει την άψογη λειτουργία ορισμένων εφαρμογών).
Ραντεβού λοιπόν στη διεύθυνση http://tomcat.apache.org από όπου θα τηλεφορτώσουμε (download) το δικό μας servlet που ονομάζεται Tomcat.
Αφού κάνουμε κλικ στην έκδοση του Tomcat που επιθυμούμε να τηλεφορτώσουμε, επιλέγουμε από τη στήλη «Binary Distributions» το αρχείο που ονομάζεται Windows Service Installer. Το αποθηκεύουμε στον υπολογιστή μας και το εγκαθιστούμε.
Θα επανέλθουμε σε λίγο στον servlet αφού τώρα είναι απαραίτητο να εξετάσουμε την «καρδιά» της εφαρμογής μας. Είστε έτοιμοι; Πάμε!
Καθορίζοντας τα συμφραζόμενα του Semanlink
Η «καρδιά» του προγράμματός μας βρίσκεται στο αρχείο που ονομάζεται Semanlink.xml το οποίο θα βρείτε στο πρώτο επίπεδο του καταλόγου του λογισμικού. Ανάλογα με το αν είστε χρήστες Windows ή Macintoch ακολουθήστε τις παρακάτω οδηγίες :
Οι χρήστες Windows
Δημιουργούμε στο C: τον φάκελο “SemanlinkStuff” στον οποίο αντιγράφουμε το αρχείο “semanlink.war”. Υπενθυμίζουμε ότι το αρχείο αυτό βρίσκεται στον κατάλογο αρχείων του Semanlink που έχουμε τηλέφορτώσει. (Όπως παρατηρούμε στο αρχείο semanlink.war δεν υπάρχει ο αριθμός της πρόσφατης έκδοσης του λογισμικού μας. Αυτό επιτρέπει στο πρόγραμμα να ανανεώνεται πολύ εύκολα και γρήγορα). Mέσα στο “SemanlinkStuff” δημιουργούμε τον υποφάκελο “dataDir”, ο οποίος θα αποθηκεύει τα δεδομένα που θα δημιουργούμε μέσω του προγράμματός μας.
Στη συνέχεια ανοίγουμε με ένα επεξεργαστή κειμένου (συνίσταται το Wordpad) το αρχείο Semanlink.xml όπου τροποποιούμε τις τιμές τριών παραμέτρων :
1.docBase : Είναι κεφαλαιώδους σημασίας να αντικαταστήσετε την προϋπάρχουσα τιμή με το μονοπάτι που οδηγεί στο αρχείο του semanlink WAR. Για παράδειγμα όπου path-to-semanlink.war βάζουμε C:\semanlink\semanlink.war
2. semanlinkURL : Δεν πρέπει να ξεχνάμε ότι το Semanlink είναι μια διαδικτυακή εφαρμογή. Έτσι πρέπει να προσδιορίσουμε το URL στο όποιο το Semanlink θα «τρέχει». Το Url του Semanlink τελειώνει με την τιμή του «μονοπατιού» («/semanlink», εκτός αν το τροποποιήσετε- εμείς για λόγους πρακτικούς και λειτουργικούς προτείνουμε να μην αλλάξετε την ιδιότητα του «μονοπατιού» μας) . Έτσι, πληκτρολογούμε 127.0.0.1:8080/Semanlink
Η διεύθυνση 127.0.0.1:8080 επιτρέπει στο Semanlink να λειτουργήσει στον υπολογιστή μας ή αλλιώς τοπικό υπολογιστή (localhost) χωρίς να είμαστε συνδεδεμένοι στο διαδίκτυο.
3. semanlinkDataDir : Τέλος πρέπει να προσδιορίσουμε την παράμετρο «semanlinkDataDir», δηλαδή πού το λογισμικό μας θα αποθηκεύει τα δεδομένα. To servlet μας πρέπει να έχει άδεια για «εγγράψει» σε αυτό τον κατάλογο.
Tip : Κάνοντας «αντιγραφή» των τιμών του παρακάτω πίνακα και «επικόλληση» στο semanlink.xml (το αρχείο που ανοίξαμε με τον επεξεργαστή κειμένου) έχουμε κάνει σε χρόνο μηδέν τις απαραίτητες ρυθμίσεις !
< path="/semanlink" docbase="C:\SemanlinkStuff\semanlink.war" reloadable="true" debug="0">
< /Context>
Οι χρήστες Macintoch (OSX)
Δημιουργούμε τον φάκελο “SemanlinkStuff” εντός του κατάλογος «[short-username]» (όπου “[short-username]” αντικαθιστούμε με την κατάλληλη τιμή). Μέσα στον φάκελο “SemanlinkStuff” αντιγράφουμε το αρχείο “semanlink.war“ το οποίο βρίσκεται στο σύνολο των αρχείων του Semanlink που έχουμε τηλέφορτώσει. Μπορούμε επίσης να δημιουργήσουμε έναν συμβολικό σύνδεσμο προς το αρχείο αυτό.
Προσοχή : αν δημιουργήσετε με το Finder μια διαφορετική ονομασία δεν θα λειτουργήσει. (Όπως παρατηρούμε στο semanlink.war δεν υπάρχει ο αριθμός της πρόσφατης έκδοσης του λογισμικού μας. Αυτό επιτρέπει στο πρόγραμμα να ανανεώνεται πολύ εύκολα και γρήγορα). Mέσα στον φάκελο “SemanlinkStuff” δημιουργούμε τον υποφάκελο “dataDir”, ο οποίος θα αποθηκεύει τα δεδομένα που θα δημιουργούμε μέσω του προγράμματός μας.
Στη συνέχεια ανοίγουμε με ένα επεξεργαστή προγράμματος (συνίσταται το Wordpad) το αρχείο Semanlink.xml όπου τροποποιούμε τις τιμές τριών παραμέτρων :
1. docBase : Είναι κεφαλαιώδους σημασίας να αντικαταστήσετε την προϋπάρχουσα τιμή με το μονοπάτι που οδηγεί στο αρχείο Semanlink WAR. Για παράδειγμα όπου path-to-semanlink.war βάζουμε C:\semanlink\semanlink.war
2. semanlinkURL : Δεν πρέπει να ξεχνάμε ότι το Semanlink είναι μια διαδικτυακή εφαρμογή. Έτσι πρέπει να προσδιορίσουμε το URL στο όποιο το Semanlink θα «τρέχει». Πληκτρολογούμε 127.0.0.1:8080/Semanlink
Η διεύθυνση 127.0.0.1:8080 επιτρέπει στο Semanlink να λειτουργήσει στον υπολογιστή μας ή αλλιώς τοπικό υπολογιστή (localhost) χωρίς να είμαστε συνδεδεμένοι στο διαδίκτυο.
3. SemanlinkDataDir : Τέλος πρέπει να προσδιορίσουμε την παράμετρο «semanlinkDataDir», δηλαδή πού το λογισμικό μας θα αποθηκεύει τα δεδομένα.
Τip : Κάνοντας «αντιγραφή» των τιμών του παρακάτω πίνακα και «επικόλληση» στο semanlink.xml (το αρχείο που ανοίξαμε με τον επεξεργαστή κειμένου) έχουμε κάνει σε χρόνο μηδέν τις απαραίτητες ρυθμίσεις !
< path="/semanlink" docbase="/Users/[short-username]/SemanlinkStuff/semanlink.war" reloadable="true" debug="0">
< /Context>
Ένα βήμα πριν το τέλος : Ρυθμίζοντας τον Servlet
Αφού εξετάσαμε το αρχείο “semanlink.xml” ήρθε η ώρα να επιστρέψουμε στο servlet μας.
Αν έχετε εγκαταστήσει τον Tomcat 5
Αντιγράφουμε το αρχείο που μόλις τροποποιήσαμε και αποθηκεύσαμε χωρίς να αλλάξουμε το όνομά του (“Semanlink.xml”) στον κατάλογο εγκατάστασης του Tomcat conf/Catalina/localhost. Ο κατάλογος “localhost” βρίσκεται εκεί όπου επιλέξαμε να εγκαταστήσουμε τον Tomcat (π.χ. Program files). Ανοίγουμε λοιπόν τον φάκελο εγκατάστασης του Tomcat, ύστερα τον φάκελο “conf” και τέλος τον φάκελο “Catalina” εντός του οποίου υπάρχει ο φάκελος “localhost”. Αν δεν υπάρχει είναι πολύ απλό! Τον δημιουργείτε χωρίς βέβαια να ξεχάσετε να αντιγράψετε και να επικολλήσετε την «καρδιά» του Semanlink, το αρχείο “Semanlink.hml”! (Δεν θα ήταν άσχημα αν δημιουργούσατε ένα αντίγραφο ασφαλείας του αρχείου Semanlink.xml. Αν διαγράψετε, μετακινώντας ή σβήνοντας τον φάκελο εγκατάστασης του Tomcat δεν θα έχετε τίποτα να φοβηθείτε).
Αν έχετε εγκαταστήσει τον Tomcat 4
Επικολλήστε το “semanlink.xml” ως στοιχείο host στο αρχείο εγκατάστασης conf/server.xml του Tomcat
Εάν χρησιμοποιείτε διαφορετικό εκτός του Tomcat servlet
Δεν έχετε παρά να ανατρέξετε στις οδηγίες εγκατάστασης που τον συνοδεύουν.
Εάν για οποιοδήποτε λόγο, δεν μπορείτε ή δεν θέλετε να ακολουθήσετε τη διαδικασία που μόλις περιγράψαμε
Θα πρέπει να επεκτείνετε το αρχείο war, προσδιορίζοντας το URL του semanlink και τη θέση του semanlinkDataDir στο αρχείο WEB-INF web.xml, μέσω δύο παραμέτρων (που σχετίζονται με τα συμφραζόμενα του προγράμματος) που φέρουν τα ίδια ονόματα.
Αυτό ήταν!
Καθίστε αναπαυτικά στην πολυθρόνα σας, εκκινήστε τον Tomcat και πληκτρολογήστε στο πεδίο διευθύνσεων του φυλλομετρητή (browser) σας : http://127.0.0.1:8080/semanlink
Εμείς θα τα ξαναπούμε στη συνέχεια!
Posts
