Web-Server mit Tomcat 4.0.4

Tomcat ist ein frei verfügbarer Web-Server, der vollständig in Java geschrieben ist. Er ist im Prinzip auf jeder Platform verwendbar, die eine Java-Umgebung besitzt.

Installation und Betrieb von Tomcat wurde bereits oft beschrieben. Hier geht es um spezialisierte Anleitungen für bestimmte Anwendungsfälle.
Einer davon ist die schnelle Inbetriebnahme unter Windows.

Download:
=========

Folgende Komponenten sind notwendig:
1. Java Development Kit (JDK) ab Version 1.2
2. Tomcat 4.0.4

Links für den Download von Tomcat:
Download von Version 4.0.4 
(Hier gibt es mehrere Versionen.
Im Zweifelsfall: "jakarta-tomcat-4.0.4.zip" verwenden!)

Links für den Download des JDK:
Download von JDK 1.4 für Windows, Linux, Solaris

Hinweis: Wer den Download von ca. 40 MB scheut, kann auch ein älteres JDK verwenden.
Aber Achtung: ein JRE (Runtime Environment) reicht nicht, da hier der Compiler fehlt!

Weitere allgemeine Informationen:
Tomcat Homepage
Java-Homepage bei Sun


Einrichtung:
============

A) Schnelle Einrichtung unter Windows

 (Für höheren Anspruch an die Sicherheit und generell für den Produktivbetrieb 
  würde ich eher Unix empfehlen)

Basis-Installation und erster Test:
1. JDK installieren. Sun liefert ein setup-Programm mit, dass die Installation
   weitgehend automatisiert. Probleme gibt es manchmal, wenn vorher bereits
   ältere Java-Installation vorhanden sind. 
   (Siehe Troubleshooting)
2. jakarta-tomcat-4.0.4.zip in ein beliebiges Verzeichnis auf der Platte extrahieren 
   (mit WinZip oder die selbstextrahierende Datei verwenden)
   Beispiel: C:\programme\jakarta-tomcat-4.0.4
3. Batch-Datei mit folgendem Inhalt erstellen (mit Notepad):

         set JAVA_HOME=D:\Programme\jdk13
         set CATALINA_HOME="D:\Programme\jakarta-tomcat-4.0.4"

         %CATALINA_HOME%\bin\startup
 
   (Dateiname und Ort der Datei ist beliebig. Die Endung muss aber .BAT sein)
   Die ersten beiden Zeilen müssen auf die richtigen Verzeichnisse verweisen.
   Entsprechend ändern und lieber zweimal kontrollieren!
4. Batchdatei durch Doppelklick starten. 
   folgende Ausgabe soll in einem schwarzen Fenster erscheinen:
     
     Starting service Tomcat/Standalone
     
5. Testen im Web-Browser mit der Adresse: http://localhost:8080
   (Wenn es nicht funktioniert, testweise im Browser die Proxyverwendung deaktivieren)
   Weiteres dazu unter Troubleshooting

Einrichten einer neuen Web-Präsenz, Einfachste Methode: 
=======================================================

  Einfach ein neues Verzeichnis unter webapps\ anlegen und dort die 
  HTML-Dateien, Bilder und JSPs ablegen. Damit Tomcat das neue Verzeichnis
  als Web-Applikation erkennt, muss auch noch das Unterverzeichnis WEB-INF existieren.
  Danach Tomcat neu starten!
  z.B. "webapps\myweb\index.html" und das Verzeichnis "webapps\myweb\WEB-INF" 
       anlegen und mit 
       "http://localhost:8080/myweb/index.html" im Browser aufrufen.

  Wenn man das Verzeichnis "webapps/Root" verwendet, kann man auch die Startseite ändern.
  Jedoch hat man dann die Beispiele und Docs nicht mehr.

CGI und SSI in Tomcat
=====================

  Standardmäßig ist SSI und CGI in Tomcat deaktiviert.
  So kann man diese Funktionen wieder einschalten:

1. conf/web.xml ändern
   Es sind vier XML-Blöcke auskommentiert. Wie im Kommentar beschrieben, müssen
   diese vier Blöcke aktiviert werden.
   Suchhilfe: SsiInvokerServlet, CGIServlet, shtml, cgi-bin
2. JAR-Dateien umbenennen
   die Dateien: 
     server\lib\servlets-cgi.renametojar 
   und 
     server\lib\servlets-ssi.renametojar 
   müssen in .jar umbenannt werden, damit sie genutzt werden können.

  So kann man die CGI-Funktion testen:

1. Datei "webapps\myweb\WEB-INF\cgi\test.bat" mit diesem Inhalt erstellen:
     
     @echo off
     type header.txt

     echo Hallo ueber CGI!

2. Im gleichen Verzeichnis eine Datei "header.txt" erstellen:
   (Die Datei MUSS aus genau drei Zeilen bestehen: diese als erste:
        Content-Type: text/html
    und dann zwei Leerzeilen (alles ohne Spaces vorne und hinten))

3. Testen und aufrufen mit "http://localhost:8080/myweb/cgi-bin/test.bat"

Bitte ganz genau schauen bei den Verzeichnisnamen. Wenn irgendwo was nicht
passt, geht die grosse Sucherei los.
 


B) Schnelle Einrichtung unter Unix

 (Auch unter Unix kann Tomcat schnell und unkompliziert 
  installiert werden.)
  
  TODO


C) Komplette Einrichtung unter Unix

 (Für sicheren und zuverlässigen Betrieb hier die Langversion.
  Auch für die, die wissen wollen, was unter der Haube steckt)

  
  TODO

D) Produktivbetrieb in Verbindung mit Apache.

  
  TODO


Troubleshooting:
================


1. Windows:

  
  TODO