Für eine zulässige und erfolgreiche Installation des Tomcat in einem Paket müssen folgende Dinge gegeben sein:

• Man muss Paket-Admin eines Dynamic-Web Pakets sein
  
• Gebuchte JSP-Option (per Email an bestellung(at)hostsharing.net)
• Portvermerk in /etc/ports oder eigene IP für das Paket und entsprechende iptables-Regeln - je nach Installationsmodus (bei der Bestellung angeben, Preise hier)

Es stehen zwei Installationsmodi zur Verfügung. In beiden Modi läuft der Tomcat jedoch mit den Rechten des Paket-Users und kann somit nur auf nicht-privilegierte Ports (> 1024) zugreifen.

Einer der Modi muss bei der Bestellung der JSP-Option angegeben werden, damit die Hostmaster den Tomcat entsprechend installieren und die entsprechenden Einträge vornehmen können.

Apache Webserver als Proxy: mod_proxy

Hierbei läuft vor dem Tomcat Server der Apache Webserver mit mod_proxy und leitet alle Anfragen an den Tomcat weiter. Er arbeitet als Proxy. Dieses Verhalten wird über .htaccess-Dateien konfiguriert, die in den entsprechenden Subdomain-Verzeichnissen liegen müssen und eine bestimmte Rewrite-Regel beinhalten. Eine beispielhafte .htaccess-Datei sieht folgendermaßen aus:

RewriteEngine On
RewriteCond %{SERVER_PORT} ^80$
RewriteBase /
RewriteRule ^(.*)$ http://www.example.com:30031/${escape:$1} [P,L]

Die benutzten Ports werden von den Hostmastern in der Datei /etc/ports eingetragen.

Eigene Paket-IP: iptables

In dieser Konfiguration läuft der Tomcat auf einer eigenen IP und dem (Standard-)Port 8080, weswegen kein Eintrag in /etc/ports notwendig ist. Alle Anfragen an Port 80 werden über iptables-Regeln an den Tomcat weiter gereicht. Das Paket bekommt eine eigene IP und die Regeln müssen von einem Hostmaster in iptables eingetragen werden.

Das Installationsskript steht auf allen Hives mit Dynamic-Web Paketen unter dem Pfad /usr/local/share/tomcat/install-tomcat zur Verfügung und hat folgende Aufrufsyntax:

xyz00@host:~$ /usr/local/share/tomcat/install-tomcat -h

Usage: install-tomcat [OPTIONS]

This script creates all necessary directories, files and links to run Apache Tomcat in your package. You must invoke it as a package user.

-h, --help show this help
-m, --mode set install mode
mod_proxy: read ports from /etc/ports (default)
iptables : use default ports 8005, 8080 and 8443
-t, --test set test mode, does not create anything

xyz00@host:~$

Das Skript prüft zuerst ob es von einem gültigen Paket-User (nur Paket-Admins) aufgerufen wurde, ob die entsprechenden Ports in /etc/ports verfügbar sind (nur im Modus mod_proxy) und keine Verzeichnisse oder Dateien einer vorherigen Installation vorhanden sind. Entsprechende Fehler mit Hilfevorschlägen werden ausgegeben.

Wird das Skript mit dem Parameter -t aufgerufen; beendet es sich nach diesen Prüfungen selbst.

Wird es ohne Parameter oder mit dem Parameter -m aufgerufen, installiert es alle notwendigen Dateien und gibt entsprechende Meldungen aus.

• Verzeichnisse
• ~/etc/tomcat
  Für die Konfigurationsdateien des Tomcat.
  
• ~/tomcat/
  Für Symlinks in wichtige Verzeichnisse.
  
• ~/var/cache/
  
• ~/var/cache/tomcat/
  Für installierte Anwendungen (zur Laufzeit).
  
• ~/var/cache/tomcat/_tmp/
  Für temporäre Dateien des Tomcat (zur Laufzeit).
  
• ~/webapps/
  Für Anwendungen. Jeder konfigurierte Host bekommt ein Unterverzeichnis.
  
• ~/webapps/xyz00.hostsharing.net/
  Anwendungen des Default-Host.
  
• ~/webapps/tomcat.example.com/
  Anwendungen einer weiteren Domain mit vorkonfigurierter Subdomain tomcat.
  
• Dateien
• ~/etc/tomcat/server.xml
  Die Tomcat Konfigurationsdatei.
  
• ~/etc/tomcat/tomcat-users.xml
  Tomcats servserseitige Benutzerverwaltung.
  
• ~/etc/tomcat/web.xml
  Konfigurationsdatei des Servlet-Containers.
  
• Symlinks
• ~/tomcat/conf
  Link auf ~/etc/tomcat
• ~/tomcat/work
  Link auf ~/var/cache/tomcat
• ~/tomcat/temp
  Link auf ~/var/cache/tomcat/_tmp

Das Start- und Stop-Skript findet man unter dem Pfad /usr/local/share/tomcat/rc-tomcat und es hat folgende Aufrufsyntax:

xyz00@host:~$ /usr/local/share/tomcat/rc-tomcat
Using CATALINA_BASE: /home/pacs/xyz00/tomcat
Using CATALINA_HOME: /usr/local/share/tomcat/current55
Using CATALINA_TMPDIR: /home/pacs/xyz00/tomcat/temp
Using JRE_HOME: /usr/local/share/java/current50
Usage: rc-tomcat ( commands ... )
commands:
debug Start Catalina in a debugger
debug -security Debug Catalina with a security manager
jpda start Start Catalina under JPDA debugger
run Start Catalina in the current window
run -security Start in the current window with security manager
start Start Catalina in a separate window
start -security Start in a separate window with security manager
stop Stop Catalina
stop -force Stop Catalina (followed by kill -KILL)
version What version of tomcat are you running?
xyz00@host:~$