Tomcat-Server 3.2 Final installieren

Tomcat 3.2

Diese Seite beschreibt die Installation der Final-Version des Tomcat-JSP-Servers in der Version 3.2 als Stand-alone-Variante.

Erläuterungen zur Konfiguration von Apache-Web-Server und Tomcat-Server, so daß Anfragen für JSP-Seiten automatisch vom Apache-Server zum Tomcat-Server weitergeleitet werden, findet sich hier. Es ist jedoch auch in diesem Fall zunächst eine lauffähige Stand-alone-Version des Tomcat-Servers zu installieren.

Die benötigten Archive sind vom Jakarta-Server der Apache-Group zu beziehen.

Voraussetzungen

Installieren

Die Archive jakarta-tomcat-3.2-src.tar.gz und jakarta-servletapi-3.2-src.tar.gz werden in ein für den Server angelegtes Basis-Verzeichnis kopiert.
Als Beispiel wird hier das Verzeichnis

/opt/server

verwendet.

Das Make-Tool Ant wird in ein weiteres, speziell dafür angelegtes Verzeichnis kopiert, das unter dem oben genannten angelegt wird, z.B.:

/opt/server/ant12

 ANT übersetzen

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.

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 angenommen, daß das JDK im Verzichnis /opt/jdk1.2.2 installiert wurde: export JAVA_HOME=/opt/jdk1.2.2 Durch die gesetzte JAVA_HOME-Umgebungsvariable findet das build-Skript automatisch das Java-Compiler-Archiv tools.jar, so daß dieses nicht mehr notwendigerweise in den CLASSPATH aufgenommen werden muß.

 Servlet-API für Tomcat 3.2 übersetzen

Zum Übersetzen des Tomcat-Servers sowie der Servlet-API wird ein JAXP-konformer XML-Parser benötigt. Der Pfad zu den entsprechenden .jar-Archiven kann in den CLASSPATH aufgenommen werden.

Zu empfehlen ist der Einsatz der neuen Version der Java API for XML (JAXP) von Sun.

Zum Beispiel:

export CLASSPATH=$CLASSPATH:/opt/xml/jaxp-1.1/jaxp.jar:\

                            /opt/jaxp-1.1/crimson.jar
				  

Die Vorbereitungen zum Compilieren der Servlet-API sind damit bereits abgeschlossen.

Vorausgesetzt wird dabei, daß die Umgebungsvariable JAVA_HOME noch wie oben beschrieben gesetzt ist.

Zum Starten des Compiler-Laufs muß nun in das Verzeichnis jakarta-servletapi-3.2-src gewechselt werden:

./build.sh	erzeugt die .class-Dateien
./build.sh dist	erzeugt das Archiv servlet.jar im Verzeichnis lib sowie die JavaDoc-Dokumentationen.

build/servletapi

jakarta-serveltapi-3.2-src/lib

 Tomcat 3.2 übersetzen

Zum Übersetzen muß die Umgebungsvariable ANT_HOME auf das build-Verzeichnis des Make-Tools Ant gesetzt werden, z.B.:

export ANT_HOME=/opt/server/build/ant

Die Konfigurations-Datei build.xml enthält einige fehlerhafte Angaben, die sich offensichtlich noch auf ältere Versionen des Tomcat-Servers beziehen. Diese müssen vor Ausführen des build-Skripts ggf. angepaßt werden:

<!-- ==================== Initialization properties ===================== -->
<property name="ant.home" value="../build/ant"/>
<property name="build.compiler" value="classic"/>
<property name="debug" value="on"/>
<property name="j2ee.home" value="../../j2ee/build/unix"/>        
<property name="jaxp" value="../jaxp-1.0.1" />
<property name="optimize" value="true" />
<property name="servlet.jar" value="../jakarta-servletapi-3.2-src/lib/servlet.jar"/>
<property name="tomcat.build" value="../build/tomcat"/>
<property name="tomcat.dist" value="../dist/tomcat"/>
				  

Auch hier gilt die Anmerkung von oben, nach fehlgeschlagenen Übersetzungsversuchen die erzeugten Dateien und Verzeichnisse zunächst zu löschen und erst danach einen erneuten Übersetzungslauf zu starten.

Diese befinden sich im Verzeichnis

build/tomcat

Standardeinstellung der Server-Installation ist das Verzeichnis build/tomcat.

Sollen mehrere Versionen des Servers parallel installiert werden, kann jeder ein eigenes Verzeichnis zugewiesen werden. Zu diesem Zweck muß vor dem Ausführen des Skripts build.sh die Konfigurations-Datei build.xml entsprechend angepaßt werden.

Im folgenden Beispiel wurde das Zielverzeichnis in ../build/tomcat32final geändert:

<!-- ==================== Initialization properties ===================== -->
<property name="ant.home" value="../build/ant"/>
<property name="build.compiler" value="classic"/>
<property name="debug" value="on"/>
<property name="j2ee.home" value="../../j2ee/build/unix"/>        
<property name="jaxp" value="../jaxp-1.0.1" />
<property name="optimize" value="true" />
<property name="servlet.jar" value="../jakarta-servletapi-3.2-src/lib/servlet.jar"/>
<property name="tomcat.build" value="../build/tomcat32final"/>
<property name="tomcat.dist" value="../dist/tomcat32final"/>
				  

 Tomcat starten

cd ../build/tomcat/bin/

cd ../build/tomcat32final/bin/

 Testlauf

http://localhost:8080/examples/jsp

 Tomcat beenden