TomcatWeb/Jk2Generic

{{{

• STEP 1 Build "mod_jk2.so" and "jkjni.so" - do whatever needs to be done

• STEP 2 Place mod_jk2.so and jkjni.so with other Apache modules. In case of Mandrake 9.1, it was in /usr/lib/apache2-extramodules

• STEP 3 Setup your Apache virtual host. Although you can run without it, I prefer going the "right way". In my case: /etc/httpd/conf.d/75_mod_jk2.conf # # Sample Apache configuration file for mod_jk2. # Include this in your httpd.conf. #

  <IfDefine HAVE_JK2>

  • <IfModule !mod_jk2.c>

    • LoadModule jk2_module extramodules/mod_jk2.so

    </IfModule>

  </IfDefine>

  <IfModule mod_jk2.c>

  • # # Restrict access to JK status handler #

    <Location "/jkstatus/">

    • Order Deny,Allow Deny from all Allow from 127.0.0.1 Allow from 192.168.61.110

    </Location>

  </IfModule> /etc/httpd/2.0/conf/vhosts/External.ev.co.yu

  <VirtualHost 192.168.61.12:80>

  • ServerName External.ev.co.yu ServerAdmin Nikola.Milutinovic@ev.co.yu DocumentRoot /home/www/public_html ErrorLog /home/www/logs/error.log CustomLog /home/www/logs/access.log common <IfModule mod_alias.c>

    • ScriptAlias /cgi-bin/ "/home/www/cgi-bin/"

    </IfModule> <Directory /home/www/public_html>

    • AllowOverride FileInfo AuthConfig Limit Indexes Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec <Limit GET POST HEAD OPTIONS PROPFIND>

      • Order allow,deny Allow from all

      </Limit> <LimitExcept GET POST HEAD OPTIONS PROPFIND>

      • Order deny,allow Deny from all

      </LimitExcept>

    </Directory> <Directory /home/www/cgi-bin>

    • AllowOverride None Options FollowSymLinks Order allow,deny Allow from all

    </Directory>

  </VirtualHost>

• STEP 4 Setup virtual host on Tomcat. /etc/tomcat/server.xml

  <Host name="External.ev.co.yu" debug="0" appBase="/home/www/webapps"

  • unpackWARs="true">

  • <Valve className="org.apache.catalina.valves.AccessLogValve"

    • directory="logs" prefix="external_access_log." suffix=".txt"

      pattern="common"/>

    <Logger className="org.apache.catalina.logger.FileLogger" directory="logs"

    • prefix="external_log." suffix=".txt" timestamp="true"/>

    <Context docBase="ConsumerBill" path="/bill" reloadable="true">

    • <!-- setupt datasources as needed -->

    </Context>

  </Host>

• STEP 5 Setup JK2 on Tomcat side. /etc/tomcat4/jk2.properties # Set the desired handler list # handler.list=apr,request,channelJni handler.list=apr,request,channelUnix #

  apr.NativeSo=/usr/lib/apache2-extramodules/jkjni.so request.tomcatAuthentication=false channelUnix.file=${jkHome}/work/tomcat.sock

• STEP 6 !!! Ensure that jkjni.so picks up "serverConf" value from environment! The easiest way for me was to edit /etc/tomcat/tomcat4.conf and add: serverRoot=/etc/httpd/2.0 export serverRoot If you're not using RPM version, just make sure that *that* variable is defined in the script starting tomcat. This is needed by jkjni.so, so it can locate workers2.properties. And if you're wondering, jkjni.so is needed to talk to UNIX domain socket. Tomcat can open it without using "handler apr" and jkjni.so, but refuses to communicate over it.

• STEP 7 Setup your Apache side of JK2. Edit ${serverConf}/worker2.properties file. You must define socket channel, ajp13 worker and at least one URI mapping to your virtual host. Needless to say, VHost definitions on Tomcat and Apache must (should?) match. /etc/httpd/2.0/conf/workers2.properties

• ["logger"]
  • level=DEBUG [config:] debug=0 debugEnv=0 [uriMap:] info=Maps the requests. Options: debug debug=0 # Alternate file logger

    [logger.file:0] level=DEBUG file=/var/log/httpd/mod_jk2.log [workerEnv:] info=Global server options timing=1 debug=0 [channel.un:unixsock] info=Main socket to Tomcat engine file=/var/tomcat4/work/tomcat.sock [status:] info=Status worker, displays runtime informations [ajp13:unixsock] info=Default AJP 1.3 worker channel=channel.un:unixsock [uri:/jkstatus/*] info=Display status information and checks the config file for changes. group=status: [uri:external.ev.co.yu/bill] info=Consumers bill group=ajp13:unixsock

• STEP 8 Restart Tomcat and then Apache. }}}