|
Diese Seite beschreibt die Installation des
Tomcat-JSP-Servers als Stand-alone-Variante
in der Version 3.1.
Eine Beschreibung, wie der Tomcat-Server
über einen Apache-Server angesprochen
werden kann, findet sich hier.
Es ist jedoch auch in diesem Fall zunächst eine
lauffähige Stand-alone-Version des Tomcat-Servers
notwendig.
Die benötigten Archive sind vom
Jakarta-Server
der Apache Group zu beziehen.
|
Voraussetzungen
|
| Benötigte Archive: |
| Tomcat |
Enthält die Source-Dateien des Tomcat-JSP-Servers,
zusammengefaßt im Archiv
jakarta-tomcat.tar.gz.
|
| Ant |
Das Archiv jakarta-ant.tar.gz
enthält ein vollständig in Java implementiertes Make-Tool,
das zum Compilieren des Tomcat-Servers sowie zusätzlicher
Komponenten des Servers benötigt wird.
|
|
| Optionale Archive: |
|
Installieren
|
Die Archive jakarta-tomcat.tar.gz
und jakarta-ant.tar.gz werden in
ein für den Server angelegtes Basis-Verzeichnis
kopiert.
Als Beispiel wird hier das Verzeichnis
/opt/server
verwendet.
|
|
Archive kopieren:
|
cp jakarta-tomcat.tar.gz /opt/server |
| cp jakarta-ant.tar.gz /opt/server |
|
Beide Archive müssen in diesem Verzeichnis
entpackt werden:
|
|
Archive entpacken:
|
gunzip jakarta-ant.tar.gz |
| gunzip jakarta-tomcat.tar.gz |
| tar xf jakarta-ant.tar |
| tar xf jakarta-tomcat.tar |
ANT übersetzen
|
Der folgende Schritt besteht darin, das
Make-Tool Ant zu compilieren.
Dazu muß in das Verzeichnis jakarta-ant
gewechselt werden, das beim Entpacken des Archivs
jakarta-ant.tar.gz entstand:
|
| |
cd jakarta-ant |
Nun kann dieses Tool übersetzt werden.
Dazu sind folgende Voraussetzungen notwendig:
|
Java-JDK
|
Ein installiertes Java-JDK muß vorhanden sein,
da es sich bei diesem Tool um ein reines
Java-Programm handelt, das auch mit einem
Java-Compiler übersetzt werden muß.
Eine Liste aktueller JDKs findet sich
hier.
|
|
CLASSPATH
|
Die CLASSPATH-Umgebungsvariable enthält eine
Liste von Pfaden zu Java-Klassen.
Zum Übersetzen von Ant wird die
Sun-Javac-Compiler-Klasse
sun/tools/javac/Main
benötigt. Diese befindet sich im
Archiv tools.jar.
Das Archiv muss somit in die
CLASSPATH-Umgebungsvariable aufgenommen werden,
Dies geschieht beispielsweise über folgende
Anweisung:
export CLASSPATH=/opt/jdk1.2.2/lib/tools.jar
Das Verzeichnis, in dem die Sourcen für Ant
liegen, muß nicht aufgenommen werden, dies geschieht
später automatisch.
|
|
JAVA_HOME
|
Die JAVA_HOME-Umgebungsvariable muß gesetzt sein.
Zum Compilieren von Ant ist hier der
Pfad zum JDK-Basisverzeichnis aufzunehmen.
In einer bash-Shell unter Linux
kann diese Variable über folgende Anweisung
gesetzt werden. Es wird dabei angenommen, daß
das JDK im Verzichnis
/opt/jdk1.2.2 installiert wurde:
export JAVA_HOME=/opt/jdk1.2.2
|
|
| Übersetzen |
Der Übersetzungsvorgang wird aus dem
jakarta-ant-Verzeichnis
durch Aufruf des folgenden Shell-Skripts
durchgeführt:
./build.sh
Dieses Shell-Skript ruft automatisch das zweite Skript
./bootstrap.sh auf, wenn das Archiv
ant.jar
noch nicht existiert.
Außerdem wird das Paket ant
installiert.
|
Tomcat 3.1 übersetzen
|
Die Vorbereitungen zum Compilieren des JSP-Servers
sind damit abgeschlossen.
Zum Starten des Compiler-Laufs muß nun in das Verzeichnis
jakarta-tomcat gewechselt werden:
|
|
In das Tomcat Source Verzeichnis wechseln
|
cd ../jakarta-tomcat
|
In diesem Verzeichnis muß nur noch das Skript
build.sh ausgeführt werden:
|
| Tomcat compilieren |
./build.sh
|
Tomcat starten
|
Während des Compilierens wird das
Verzeichnis build auf der gleichen
Ebene wie die Installationsverzeichnisse
jakarta-ant und jakarta-tomcat
erstellt. Darin enthalten ist das Verzeichnis tomcat,
das den neu compilierten Tomcat-Server beherbergt.
Die folgende Anweisung wechselt in dieses Verzeichnis:
|
|
In das Tomcat Verzeichnis wechseln
|
cd ../build/tomcat/bin/
|
|
Der Tomcat-Server ist fertig compiliert und enthält
bereits eine Standard-Konfiguration.
Somit kann der Server nun versuchsweise gestartet und
mit Hilfe der mitgelieferten Beispiele getestet werden.
|
| Tomcat starten |
./startup.sh |
Während des Startvorgangs werden die Einstellungen
für den CLASSPATH und LOG-Files gelistet, wie sie
vom Server verwendet werden.
Eventuelle Fehler können hier leicht lokalisiert werden.
Normalerweise sollte der Server jedoch mit den
Default-Einstellungen bereits problemlos starten.
Die Funktion kann getestet werden, indem die Startseite
des Servers mit Hilfe eines beliebigen Web-Browsers
aufgerufen wird:
|
Testlauf
|
| Tomcat testen |
Im Browser kann die Tomcat-Start-Seite über die Adresse
http://localhost:8080
aufgerufen werden.
|
Abbildung der Startseite des Tomcat-Servers.
Wird diese Startseite in dieser Form angezeigt,
war die Installation des Servers erfolgreich.
Der Server empfängt Anfragen über den Default-Port
8080 und überträgt auch Daten zurück zum Client.
|
Als nächstes bleibt noch zu prüfen, ob JSP-Seiten
compiliert und angezeigt werden können.
Da hierzu Zugriffe auf den Java-Compiler notwendig
sind, besteht hier noch eine potentielle Fehlerquelle.
Der Test ist am einfachsten durchzuführen, indem
einige der JSP-Beispiele des Servers aufgerufen werden.
Die Beispiel-Seite kann über den Link JSP Examples
erreicht werden, siehe dazu die
Abbildung der Startseite.
|
| JSP Beispiel Seite anzeigen |
Die Beispielseite kann über den entsprechenden Link oder
die Adresse
http://localhost:8080/examples/jsp
erreicht werden.
|
|
Im Browser sollte nun eine
Index-Seite mit den JSP-Beispielen
des Tomcat-Servers zu sehen sein.
|
| JSP Beispiel ausführen |
Ein beliebiges Beispiel aus der Liste kann zum Testen verwendet werden.
Das Snoop-Beispiel liefert einige
Angaben über die Übertragungsmethode und das Betriebssystem.
|
