Kurzanleitung zu Apache und ServletEngines

Die folgende Anleitung gibt Hilfestellung für erste Schritte mit Apache/2 und Resin. Sie ersetzt aber leider nicht die eingehende Beschäftigung mit der Dokumentation beider Programme.

1 Installation von Apache/2

Der WWW Server Apache/2 kann unter http://httpd.apache.org/ downgeloaded werden. Auf der CD ist im Unterverzeichnis »Apache2« die Version 2.0.44 enthalten. Die Version von Apache/2 und Modul für die Resin ServletEngine (siehe unten) müssen übereinstimmen! Es kann daher sein, dass eine älteren oder neuere Version von Apache/2 nicht mit dem Resin-Modul läuft.

1.1 Entpacken

Das Archiv httpd-2.0.44-os2.zip in das Wurzelverzeichnis der Festplatte entpacken. Apache ist dann z.B. unter D:\apache2 installiert. Als erstes nun die Startdatei startup.cmd editieren und die Zeile

set beginlibpath=F:\Apps\apache2\bin;F:\Apps\apache2\modules;

anpassen. Ein Update von Apache kann später normalerweise einfach über diese Version entpackt werden (die Konfigurationsdatei bleibt i.d.R. erhalten), nur diese Datei wird leider immer überschrieben und muss jedesmal wieder angepasst werden.

1.2 Grundkonfiguration

Im Unterverzeichnis \apache2\conf die Datei httpd-std.conf nach httpd.conf kopieren und im Editor öffnen. Nun alle Verweise nach /Apps/apache2 in /apache2 ändern.

Um zu bewirken, dass Apache nur eine bestimmte IP Adresse des Rechners nutzt, kann »Listen 80« z.B. in »Listen 192.168.0.100:80« geändert werden. Auch das local loopback interface (127.0.0.1) ist möglich. Dann nimmt Apache aber nur Verbindungen von der Maschine an, auf der er läuft. Für interne Testzwecke kann das aber ganz hilfreich sein.

Apache sollte jetzt bereits starten und die Begrüßungsseite anzeigen, wenn man mit dem Browser z.B. nach http://192.168.0.100 geht. Apache nun durch Strg-Untbr beenden.

2 Installation von Resin

Die Resin ServletEngine kann von http://www.caucho.com/ geladen werden. Auf der CD ist Version 2.1.8 enthalten. Prinzipiell laufen zwar auch ältere Versionen, die DLL, die Apache mit Resin verbindet ist aber speziell für Apache 2.0.44 und Resin 2.1.8.

Zuerst die Datei caucho.dll aus dem Verzeichnis \apache2\modules in das gleiche Verzeichnis der eben auf Festplatte entpackten Apache Version kopieren.

Nun die Datei add-to-httpd.conf im Verzeichnis \apache2\conf der CD öffnen und die zwei Blöcke von Einträgen an die entsprechenden Stellen in der vorhin editierten httpd.conf einfügen.

Nun Resin (resin-2.1.8.zip im Verzeichnis \resin auf der CD) ins Wurzelverzeichnis der gleichen Festplatte, auf der auch Apache installiert ist, entpacken. Dann das erzeugte Verzeichnis \resin-2.1.8 in \resin umbenennen. Danach die *.cmd Dateien aus dem \Resin Verzeichnis der Festplatte in das \resin\bin Verzeichnis auf der Festplatte kopieren.

Vor dem ersten Start von Resin bitte sicherstellen, dass Java 1.3 oder höher korrekt installiert ist. Die Resin Startdatei srun.cmd in \resin\bin enthält einen Befehl »call java131«. Diese java131.cmd (liegt auf der CD) dient auf meinem System dazu, Umgebungsvariablen für Java 1.3.1 zu setzen. So kann Java 1.1.8 das Standard-Java bleiben. In den cmd-Dateien, mit denen man für gewöhnlich Java Applikationen startet, wird dann temporär Java 1.3.1 aktiviert.

Resin kann nun mit srun.cmd gestartet werden. Ja nach Rechnergeschwindigkeit dauert das etwas. Danach sollte die Begrüßungsseite von Resin angezeigt werden, wenn man mit dem Browser den lokalen Rechner auf dem Port 8080 anspricht, also z.B. mit http://192.168.0.100:8080.

3 Test von Apache und Resin

Jetzt den Apache starten. Von nun an ist es egal, ob Apache oder Resin zuerst gestartet werden, allerdings liest Apache die Konfigurationsdatei von Resin nur beim Start ein, so dass bei manchen Umkonfigurationen von Resin auch Apache neu gestartet werden muss.

Nun kann der Status von Resin über Apache abgefragt werden, indem die URL http://192.168.0.100/caucho-status aufgerufen wird. Das erste Servlet kann, falls der Resin-Status ok ist, über http://192.168.0.100/examples/basic/servlet/HelloServlet aufgerufen werden.

Max Stempfhuber