VAWACON - Jochen van Waasen

Abstract:
Dieser Text beschreibt die Kompilierung des Apache 2 Moduls mod_jk2 unter Windows. Das Ergebnis ist eine mod_jk2.dll Datei. Diese wird benutzt damit Apache 2 Tomcat 5 unter Windows integrieren kann. Diese Anleitung wurde getestet unter Windows 2000 mit Apache 2.0.48, Tomcat 5.0.18, ANT 1.5.3, Java 2 1.4 und Microsoft Visual Studio 6.

Voraussetzungen:

Korrekt installiertes J2SE SDK mit der Umgebungsvariablen JAVA_HOME.
Korrekt installiertes Microsoft Visual Studio.

Installation Apache 2:
1.	Laden Sie die ausführbare Windowsdatei apache_2.0.48-win32-x86-no_ssl.exe
2.	Installation von Apache 2 durch Doppelklick auf die heruntergeladene Datei. Folgen Sie den Installationsanweisungen.
2a.	As Setup Type choose Custom Installation: Dieser Installationstype installiert die header und library Dateien die benötigt werden um zusätzliche Module zu kompilieren und zu linken. Zusätzlich können Sie das Installationsverzeichnis für Apache bestimmen.
2b.	Folgen Sie den nächsten Installationsanweisungen.
3.	Setzen Sie die Umgebungsvariable APACHE2_HOME auf das Apache 2 Installationsverzeichnis.

Installation ANT:
1.	Laden Sie die ANT Distribution apache-ant-1.5.3-1-bin.zip herunter.
2.	Entpacken Sie die Distribution in das gewünschte Verzeichnis.
3.	Setzen Sie die Umgebungsvariable ANT_HOME auf das ANT Installationsverzeichnis.

Installation Tomcat Source Code:
1.	Laden Sie die Tomcat Source Code Distribution jakarta-tomcat-5.0.18-src.tar.gz herunter.
2.	Entpacken Sie den Source Code in das gewünschte Verzeichnis.
	Der Tomcat Connector ist in der Source Code Distribution enthalten.

Kompilieren Schritt 1: jkant.jar:
1.	Wechseln Sie in das jk Verzeichnis in Ihrem Tomcat Source Code Verzeichnis: `cd jakarta-tomcat-connectors/jk`
2.	Kompilieren und erzeugen Sie jkant.jar: `ant jkant`
	jkant.jar wurde erzeugt und befindet sich in: `jakarta-tomcat-connectors/jk/build/lib/jkant.jar` Der nächste Kompilierungsschritt benötigt diese Datei!

Kompilieren Schritt 2: mod_jk.dll:
1.	Erzeugen Sie eine Textdatei mit dem Namen build.properties im `jakarta-tomcat-connectors\jk` Verzeichnis. Fügen Sie folgende zwei Zeilen in die Textdatei ein: # Compile time options for the native code `so.debug=false` `so.optimize=true`
2.	Wechseln Sie in das native2 Verzeichnis: `cd jakarta-tomcat-connectors/jk/native2`
3.	Kompilieren und erzeugen Sie mod_jk2.dll: `ant`
	Fehlerbehebung: Fehler: BUILD FAILED [...] CreateProcess: "C:\Program Files\Microsoft Visual Studio\VC98\bin\mc" jk_logger_win32_message.mc error=3 Lösung: Die `jakarta-tomcat-connectors/jk/native2/build.xml` Datei ist für die Verwendung mit Microsoft Visual Studio entworfen. Der Pfad zum MS Visual Studio Installationsverzeichnis ist vom Autor der build.xml Datei vorgegegeben. Als Installationsverzeichnis wird C:\Program Files\Microsoft Visual Studio\VC98 angenommen. Mein Installationsverzeichnis ist ein anderes. Das Verzeichnis kann mit Hilfe der build.properties Datei angepasst werden. # MSVC mssdk.home=D:/programme/MicrosoftVisualStudio/VC98 Fügen Sie diese Zeile zu der build.properties Datei hinzu. Dies ist die einzige Änderung um das Problem zu lösen. Benutzen Sie slashes / in der Pfadangabe, keine backslashes \. Die build.properties Datei haben Sie bereits im the `jakarta-tomcat-connectors/jk` Verzeichnis angelegt. Benutzen Sie Ihren eigenen Pfad, dies ist nur ein Beispiel und es handelt sich um meinen Pfad! ;-) Fehler: BUILD FAILED [...] Cannot open include file: 'apr.h': No such file or directory Lösung: Setzen Sie die Umgebungsvariable APACHE2_HOME auf das Apache 2 Installationsverzeichnis.
4.	mod_jk2.dll wurde erzeugt und befindet sich in: `jakarta-tomcat-connectors/jk/build/jk2/apache2/mod_jk2.dll` Diese Datei ist spezielle für Apache 2.0.48, daher ist es eine gute Idee die Datei umzubenennen: mod_jk2_2.0.48.dll

Installation mod_jk2.dll:
1.	Die Datei mod_jk2_2.0.48.dll in das Apache 2 Installationsverzeichnis \modules kopieren.
2.	Jetzt kann Apache 2 konfiguriert werden um Tomcat 4 mittels mod_jk2_2.0.48.dll zu integrieren.
3.	Download: mod_jk2.dll

Kommentar: Kompilierung Tomcat 5.0.18 Connector
	Die zwei Dateien jk_channel_socket.c und jk_pool.c lassen sich nicht kompilieren. Es wird ein 'deprecated' Fehler ausgegeben. Der Entwickler hat diesen Fehler unbeabsichtigt verursacht und die entsprechende Zeile nicht auskommentiert als er die Dateien wieder in das CVS committed hat. Die Zeile #error am Anfang dieser zwei Dateien muss auskommentiert werden!

Kommentar: Microsoft Visual Studio

Warum wird Microsoft Visual Studio benötigt?

Um mod_jk2.dll zu kompilieren wird jkant.jar benötigt. Diese jar-Datei erweitert ANT und stellt spezielle Compiler Klassen zur Verfügung:
org.apache.jk.ant.compilers.MsvcCompiler
org.apache.jk.ant.compilers.MsvcLinker

Diese Klassen sind ausschließlich für die Verwendung mit MS Visual Studio programmiert.

Microsoft Visual Studio stellt einige header Dateien zur Verfügung. Diese werden benötigt um mod_jk2.dll unter Windows zu kompilieren. Andere Compiler stellen diese header Dateien nicht zur Verfügung, z.B. der freie Borland C++ 5.5 Compiler.

webmaster@vawacon.de