HowTo: Tomcat 7 Installation via mod_jk und Apache vHosts unter Debian

Da der Apache Webserver wesentlich leistungsfähiger und flexibler als der integrierte Webserver des Tomcat ist, ist es sinnvoll diesen auch einzusetzen. Zusätzlich können wir auf die Apache Module zurückgreifen und das vHost Management verwenden. Die Lösung wird via dem Apache Modul mod_jk realisiert, welches sämtliche Webserveranforderungen über das AJP Protokoll an den Tomcat weiterleitet.

Vorbereitung

*) Apache Tomcat 7 Installation wie in diesem HowTo beschrieben

*) Apache Webserver Installation (mod_jk kann auch in bestehende Installationen integriert werden)

[bash]aptitude install apache2[/bash]

Installation und Konfiguration des mod_jk Apache Moduls

Das mod_jk Apache Modul kann bequem über das Debian Repository installiert werden:

[bash]aptitude install libapache2-mod-jk[/bash]

Debian installiert dabei bereits die entsprechende Beispielkonfiguration mit, welche wir für unsere Zwecke editieren. Wenn die Tomcat Installation noch bei der Standardinstallation belassen wurde, müssen nur die ersten beiden Werte angepasst werden.

[bash]vi /etc/libapache2-mod-jk/workers.properties[/bash] [plain]workers.tomcat_home=/usr/local/tomcat
workers.java_home=/usr/lib/jvm/java-7-oracle
ps=/
worker.list=ajp13_worker
worker.ajp13_worker.port=8009
worker.ajp13_worker.host=localhost
worker.ajp13_worker.type=ajp13
worker.ajp13_worker.lbfactor=1[/plain]

In folgendem Schritt erstellen wir die Apache Modul Konfigurationsdatei für mod_jk mit folgenden Werten (Nur bei Debian 6 Squeeze notwendig) Wheezy erstellt die Konfiguration bereits in der Datei /etc/apache2/mods-enabled/jk.conf:

[bash]vi /etc/apache2/conf.d/mod-jk.conf[/bash] [plain]JkWorkersFile /etc/libapache2-mod-jk/workers.properties
JkLogFile /var/log/apache2/mod_jk.log
JkLogLevel error
JkShmFile /var/log/apache2/jk-runtime-status[/plain]

Apache vHost (Virtual Host) erstellen

Da nun die Grundkonfiguration des mod_jk abgeschlossen ist, legen wir nun einen vHost für eine Testdomain auf unseren Apache Webserver an (zB:. vhost.domain.com) und laden via JkMount den ajp13_worker nach /:

[bash]vi /etc/apache2/sites-available/vhost.domain.com[/bash]

 

[xml]<Virtualhost vhost.domain.com>
JkMount /* ajp13_worker
ServerName vhost.domain.com
DocumentRoot /usr/local/tomcat/webapps
ErrorLog /usr/local/tomcat/logs/error.log
CustomLog /usr/local/tomcat/logs/access.log common
<Directory /usr/local/tomcat/webapps>
Options -Indexes
</Directory>
</Virtualhost>[/xml]

Nun aktivieren wir den neuen vHost und starten den Apache Webserver neu:

[bash]a2ensite vhost.domain.com
/etc/init.d/apache2 restart[/bash]

Tomcat vHost (Virtual Host) konfigurieren

Da nun der Apache Webserver soweit konfiguriert ist um mit dem Tomcat über den AJP Connector zu kommunizieren, müssen wir die vHosts für den Tomcat noch entsprechend einrichten. In folgendem Beispiel wird die Domain vhost.domain.com auf das Beispiel Verzeichnis des Tomcats konfiguriert (/usr/local/tomcat/webapps/examples).

[sam id=’2′ codes=’true‘] [bash]vi /usr/local/tomcat/conf/server.xml[/bash]

 

[xml] <Host name="vhost.domain.com" appBase="webapps"
unpackWARs="true" autoDeploy="true">
<Context path=""
docBase="/usr/local/tomcat/webapps/examples"
debug="0" reloadable="true" />
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t &quot;%r&quot; %s %b" />
</Host>[/xml]

Damit die Konfiguration aktiv wird starten wir den Tomcat neu:

[bash]/etc/init.d/tomcat stop
/etc/init.d/tomcat start [/bash]

Testen der Apache mod_jk Tomcat Integration

Nun kann im via Browser auf den entsprechenden Hostnamen zugegriffen werden wo unsere Beispiele angezeigt werden sollte: