Tomcat-Server 4.0 Milestone 3 installieren

Tomcat 4.0

Die aktuelle Version des Tomcat 4.0 Servers ist Milestone 3.

Mit dieser Version wurden wiederum einige Neuerungen eingeführt. Aus diesem Grund soll hier nochmals der komplette Installationsvorgang beschrieben werden.

Die 4.0 Versionen enthalten im Gegensatz zu den alten 3.x Versionen nicht alle notwendigen Java-Pakete. Die notwendigen Pakete sind vor der Server Installation zu besorgen und zu installieren. Um auf diese Pakete zugreifen zu können, sind außerdem einige Umgebungsvariablen zu setzen.

Die aktuelle Version läuft trotz des frühen Entwicklungsstadiums bereits sehr stabil.

Version 4.0 integriert gegenüber 3.2 folgende zusätzlichen Features.
Sie unterstützt:

• die JavaServer Pages (JSP) Spezification Version 1.2
• sowie die Servlet API Spezification, Version 2.3
• WebDAV Level 2
• erweiterte Authentifizierungs-Funktionalität, z.B. Auslesen von Zertifikaten

Im Folgenden wird die Installation der aktuellen Milestone Version 3 von Tomcat 4.0 als Stand-alone-Variante beschrieben.

Die Test-Installation erfolgte auf einem Linux-Rechner mit Kernel Version 2.2.17 und jdk 1.3.0 von Blackdown.
Ant wurde in der aktuellen Version 1.2.1 verwendet. Diese ist nicht mehr 100%-ig kompatibel zu älteren Versionen, falls Probleme mit einer alten Version auftreten, sollte eine aktuelle Version installiert werden.

Diese Version benötigt im Gegensatz zu den Versionen 3.1 oder 3.2 einige zusätzliche Pakete, die von den Sun- bzw. Apache-Seiten zu beziehen sind.

Diese Beschreibung wendet sich an den erfahrenen Anwender. Ausführlichere Anleitungen existieren für die Versionen 3.1 und 3.2 beta 4.

Voraussetzungen

Installation vorbereiten

Alle oben aufgeführten Archive außer den optionalen müssen vor dem Compilieren des Tomcat-Servers bereits installiert sein.

Im folgenden wird davon ausgegangen, daß diese Archive unterhalb des Basis-Verzeichnisses

/opt/server

installiert wurden.

 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.
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.3.0/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 angenommen, daß das JDK im Verzichnis /opt/jdk1.3.0 installiert wurde: export JAVA_HOME=/opt/jdk1.3.0

Zum Übersetzen von ist ein JAXP-konformer XML-Parser notwendig. Der Pfad zu den entsprechenden .jar-Archiven kann in den CLASSPATH aufgenommen werden.

Zum Beispiel:

export CLASSPATH=$CLASSPATH:/opt/jaxp1.1ea/crimson.jar:\ /opt/jaxp1.1ea/jaxp.jar

./build.sh

 Umgebungsvariablen setzen

Oben wurde bereits erwähnt, daß zum Übersetzen von Tomcat 4.0 einige Zusatzpakete zu installieren sind. Um diese Pakete finden zu können, benötigt das build-Skript folgende Umgebungsvariablen.

Es handelt sich dabei um folgende Werte:

 CLASSPATH-Umgebungsvariable setzen

Für die Milestone-3-Version des Tomcat 4.0-Servers ist ein Setzen der CLASSPATH-Variablen nicht mehr notwendig. Die Archive werden vom Skript build.sh automatisch in den CLASSPATH aufgenommen.

Voraussetzung sind korrekt gesetzte Umgebungsvariablen.

Tomcat 4.0 übersetzen

Standardmäßig werden die Dateien des Tomcat-Servers in das Verzeichnis build/tomcat kopiert. Sollen mehrere Versionen des Servers übersetzt werden, kann jedem ein eigenes Verzeichnis zugewiesen werden. Zu diesem Zweck muß vor dem Ausführen des Skripts build.sh die Datei build.xml entsprechend angepaßt werden.

In ihr enthalten ist ein Element namens target, das wiederum mehrere property-Elemente enthält. Das property-Element tomcat.build enthält als value-Parameter das (relative) Verzeichnis, in das der Tomcat-Server installiert werden soll. In der Originaldatei ist hier immer das Verzeichnis ../build/tomcat angegeben.

Im folgenden Beispiel wurde das Zielverzeichnis in ../build/tomcat40-m3 geändert.

./web.xml

<property name="catalina.build" value="${basedir}/../build/catalina"/> <property name="jasper.build" value="${basedir}/../build/jasper"/> <property name="tomcat.build" value="${basedir}/../build/tomcat-4.0-m3"/> <property name="tomcat.dist" value="${basedir}/../dist/tomcat-4.0-m3"/>

./catalina/web.xml

<project name="Catalina" default="build-main" basedir=".">     <!-- ===================== Initialize Property Values =================== -->   <property name="build.compiler" value="classic"/>   <property name="catalina.build" value="../../build/catalina"/>   <property name="catalina.deploy" value="../../build/tomcat-4.0-m3"/>   <property name="catalina.dist" value="../../dist/catalina"/>

./jasper/web.xml

<project name="Jasper" default="build-main" basedir=".">     <!-- ===================== Initialize Property Values =================== -->   <property name="build.compiler" value="classic"/>   <property name="jasper.build" value="../../build/jasper"/>   <property name="jasper.deploy" value="../../build/tomcat-4.0-m3"/>   <property name="jasper.dist" value="../../dist/jasper"/>

Tomcat 4.0 starten

cd ../build/tomcat-4.0-m3/bin/

cd ../build/tomcat/bin/

Testlauf

http://localhost:8080

http://localhost:8080/examples/jsp