Apache
Tomcat
Apache
Tomcat ist ein freier Servlet-fähiger Webserver, der auch im lokalen Netzwerk
eingesetzt werden kann.
Die
aktuelle Tomcat-Version kann unter http://tomcat.apache.org/
heruntergeladen werden.
Bei
der Generierung eines Html-Programms wird eine Datei <Programmname>.war
erzeugt. Diese Datei enthält alle notwendigen Daten und Programme, die der
Webserver benötigt.
Im Tomcat Web Application Manager (z.B. http://localhost:8080/manager/html) kann die war-Datei im Abschnitt WAR
file to deploy eingelesen werden:



Nach
dem Einlesen der war-Datei kann das Programm sofort durch Klicken des Kommandos
Start oder durch Eingabe der entsprechenden Adresse im Browser
(z.B. http://localhost:8080/Testprog)
gestartet werden. Voraussetzung dafür ist, das der Ebus-2T-Server läuft, da das
Programm den Ebus-2T-Server benötigt (siehe Html-Programm).
Wenn
der Tomcat Manager nicht startet, müssen folgende Zeilen in die Datei tomcat-users.xml
im Unterverzeichnis conf des Tomcat-Verzeichnisses eingefügt werden:
<role
rolename="admin"/>
<role
rolename="manager"/>
<user
name="" password="" roles="admin,manager"/>
Apache
Tomcat installieren unter Windows
Starten
Sie das Installationsprogramm apache-tomcat-6.0.32.exe und folgen Sie
den Anweisungen.
Bei
der Eingabe von User Name und Password empfiehlt es
sich, bei Roles zusätzlich admin anzugeben.
Admin
ist eine Anwendung für die Verwaltung der Zugriffsrechte von User und Gruppen
für die Web-Anwendungen.
Admin.war befindet sich auf der
Ebus-J-CD im Ordner tomcat und kann wie jede andere Web-Anwendung im Abschnitt WAR
file to deploy eingelesen werden (siehe oben).

Apache
Tomcat installieren unter Linux
1.
Melden Sie sich als root an.
2.
Legen Sie ein Verzeichnis für Tomcat an, z.B: mkdir /tomcat
3.
Kopieren Sie das Tomcat-Archiv in das Verzeichnis: cp
apache-tomcat-6.0.32.tar.gz /tomcat
4.
Entpacken Sie das Archiv, es wird ein Unterverzeichnis apache-tomcat-6.0.32 angelegt:
tar -zxvf apache-tomcat-6.0.32.tar.gz
5.
Wenn das Java Runtime noch nicht installiert ist, installieren Sie dieses
(siehe unten).
6.
Setzen Sie die Environmentvariablen CATALINA_HOME und JAVA_HOME. CATALINA_HOME
verweist auf das Tomcat-Verzeichnis und JAVA_HOME auf das Java-Runtime
verzeichnis. Fügen Sie folgende Zeilen in die Datei /etc/profile oder /root/.bashrc
oder /etc/bash.bashrc (je nach Linuxversion) ein:
export
JAVA_HOME=/java/jre1.6.0_17
export
CATALINA_HOME=/tomcat
7.
Starten Sie den Rechner neu oder melden Sie sich ab und wieder als root an.
8.
Prüfen Sie, ob die Environmentvariablen gesetzt sind: echo $CATALINA_HOME
9.
Setzen die die Ausführungsrechte: chmod a+x $CATALINA_HOME/bin/*.sh
Sie
können Tomcat starten mit $CATALINA_HOME/bin/startup.sh und beenden mit $CATALINA_HOME/bin/shutdown.sh
Java
Runtime installieren unter Linux
1.
Melden Sie sich als root an.
2.
Legen Sie ein Verzeichnis für Java an, falls es noch nicht existiert, z.B: mkdir
/java
3.
Kopieren Sie das Java Runtime in das Verzeichnis: cp jre-6u17-linux-i586.bin
/java
4.
Starten Sie das Installationsprogramm, es wird ein Unterverzeichnis jre1.6.0_17
angelegt: ./jre-6u17-linux-i586.bin
6.
Tragen Sie das bin-Verzeichnis in die Environmentvariablen PATH ein. Fügen Sie
dazu folgende Zeile in die Datei /etc/profile oder /root/.bashrc
oder /etc/bash.bashrc (je nach Linuxversion) ein:
PATH=/java/
jre1.6.0_17/bin:$PATH
Username
und Passwort für Web-Anwendung festlegen
Soll
ein Programmaufruf durch Username und Passwort geschützt werden, so kann dazu
das Tomcat Web Server Administration Tool verwendet werden.
Admin.war befindet sich auf der
Ebus-J-CD im Ordner tomcat und kann wie jede andere Web-Anwendung im Abschnitt WAR
file to deploy eingelesen werden (siehe oben).

Für
jedes Programm (z.B. Prog1) muss unter 'Roles' eine eigene Role angelegt
werden. (Achtung: Groß-/Kleinschreibung beachten: 1. Buchstabe groß, die
folgenden Buchstaben klein !)
Die
zulässigen User können dann der Role zugeordnet werden.
Die
Einträge für Username und Passwort können auch manuell in den Dateien web.xml
und tomcat-users.xml vorgenommen werden. Diese Dateien befinden sich im
Verzeichnis conf des Apache Tomcat. Wenn Apache Tomcat im Verzeichnis
C:\Apache installiert wurde, ist C:\Apache\conf das Verzeichnis.
Wenn
z.B. das Programm Prog1 für den User Huber mit dem Passwort Nashorn
geschützt werden soll, müssen in web.xml zusätzliche Abschnitte <security-constraint>
, <security-role> und <login-config>
eingetragen werden:
<security-constraint>
<web-resource-collection>
<web-resource-name>web</web-resource-name>
<url-pattern>/Prog1</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>Prog1</role-name>
</auth-constraint>
</security-constraint>
<security-role>
<role-name>Prog1</role-name>
</security-role>
<login-config>
<auth-method>BASIC</auth-method>
<realm-name> Prog1</realm-name>
</login-config>
In tomcat-users.xml
muss im Abschnitt <tomcat-users> eingetragen werden:
<role
rolename="Prog1"/>
<user
username="Huber" password="Nashorn"
roles="Prog1"/>