Installations dokumentation af Tomcat-apache setup
-------------------------------------------------

Der er masser af dokumentation om Tomcat på http://jakarta.apache.org/tomcat/index.html
problemet er bare at intet af det fortæller hvordan man installerer på FreeBSD og hvordan man sætter
Tomcat op til at kører sammen med apache på en ordentlig måde.

installer følgende programmer fra ports :
- installer apache
- installer jdk1.1.8
- installer jakata-tomcat3.2.3
- installer mod_jk (sørger selv for at smide filen ned i apaches libexec bibliotek)

start/stop scripts ligger i /usr/local/tomcat/bin/startup.sh | shutdown.sh

lav en tomcat bruger

indsæt følgende i brugerens .profile (jeg bruger bash) :
"TOMCAT_HOME=/usr/local/tomcat ; export TOMCAT_HOME"
"JAVA_HOME=/usr/local/jdk1.1.8 ; export JAVA_HOME"

projekter til tomcat ligger i kataloget /webapps
lav f.eks. et softlink til brugerens hjemmekatalog

ret i filen server.xml i /conf, så nye projekter kan ses

<!-- XXX I commented out the HTTP connector since Apache serves static
content, this is just if you have a standanlone Tomcat (which can serve
HTML as well, just really slowly) -->

        <!-- Normal HTTP
        <Connector className="org.apache.tomcat.service.PoolTcpConnector">
            <Parameter name="handler"
                value="org.apache.tomcat.service.http.HttpConnectionHandler"/>
            <Parameter name="port"
                value="8080"/>
        </Connector>
        -->

<!-- XXX I changed the port mod_jk talks to Tomcat with here to 10001 (we
have loads of services running on our dev boxes), this port is only for
mod_jk <-> tomcat communication - don't point your browser to that port or
you'll get a few errors on your console or log :) -->

        <!-- Apache AJP12 support. This is also used to shut down tomcat.
          -->
        <Connector className="org.apache.tomcat.service.PoolTcpConnector">
            <Parameter name="handler"
       value="org.apache.tomcat.service.connector.Ajp12ConnectionHandler"/>
            <Parameter name="port" value="10001"/>
        </Connector>

<!-- XXX this is one of our current projects, any /rimmer URI will be 
served by Tomcat from the docBase directory -->

        <Context path="/rimmer"
                 docBase="webapps/rimmer"
                 crossContext="true"
                 debug="0"
                 reloadable="true" >
        </Context>

sørg for at sætte CLASSPATH i filen tomcat.sh

CLASSPATH=/usr/local/jdk1.1.8/lib/classes12.zip:/usr/local/tomcat/lib:/usr/local/jdk1.1.8/bin

chmod .sh filerne til at være eksekverbare!

start tomcat ./statup.sh
den vil nu modificere filen mod_jk.conf-auto dette gør den hver gang den starter. 
Hvis der skal rettes i konfigurationen skal man rette i server.xml

åben httpd.conf

inkrementer linien
LoadModule jk_module          libexec/apache/mod_jk.so 
og
AddModule mod_jk.c

/usr/local/etc/apache/mod_jk.conf indeholder :

<IfModule mod_jk.c>
        JkWorkersFile /usr/local/tomcat/conf/workers.properties
        JkLogFile  logs/jk.log
        JkLogLevel warn
        JkMount /*.jsp ajp12
        JkMount /servlet/* ajp12
        JkMount /examples/* ajp12
</IfModule>

indsæt indholdet af mod_jk.conf i bunden af httpd.conf efterfulgt at følgende linie :
Include /usr/local/tomcat/conf/mod_jk.conf-auto

tomcat skal altid startes først dernæst apache 
(da apache bruger den auto-genererede fil som tomcat danner ved hver opstart):
./startup.sh
apachectl start

Thats it folks !

/SJ20010830