Jakarta Tomcat connector installation (Windows)

Today’s topic is about how to get Jakarta Tomcat connector working with your Tomcat.

Requirements:

1. Java 1.5 JDK (SDK) or higher
2. Apache HTTP Server 2.0.58 or higher
3. Apache Tomcat Servlet/JSP Container 5.5.17 or higher
4. Apache Jakarta Tomcat Connector JK-1.2.15

Download:

1. Java 1.5 JDK: http://java.sun.com
2. Apache HTTP Server 2.0.58: http://httpd.apache.org
3. Apache Tomcat Servlet/JSP Container 5.5.17: http://tomcat.apache.org
4. Apache Jakarta Tomcat Connector JK-1.2.15:
5. Please download binary distribution of your platform only: http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/

Configuration:

1. Java JDK path: D:\Program Files\Java\jdk5
2. Apache HTTP Server path: D:\Program Files\Apache Group\Apache2
3. Apache Tomcat path: D:\apache-tomcat
4. Apache HTTP DocumentRoot: E:\DocumentRoot
5. Servlet/JSP DocumentRoot (via Apache2/mod_jk): D:\apache-tomcat\webapps
6. Servlet/JSP DocumentRoot (via native Tomcat server, port 8080): D:\apache-tomcat\webapps
7. Access Servlet/JSP pages via Apache2/mod_jk: http://localhost/[jkmount-mapped url of your webapp]
8. Access native Tomcat server: http://localhost:8080/

Install Java 1.5 JDK:

1. Run file jdk_1_5_06-windows-i586-p.exe. Install under your D:\Program Files\Java\jdk5.

Install Tomcat 5.5:

1. Unpack and place Tomcat 5.5 and mod_jk:
2. Unpack file apache-tomcat-5.5.17.zip under D:\
3. Unpack file apache-tomcat-5.5.17-admin.zip under D:\
4. Rename directory D:\apache-tomcat-5.5.17 to D:\apache-tomcat

Install Tomcat connector:

1. Rename file mod_jk-apache-2.0.55.so to mod_jk.so, and place it under directory D:\Program Files\Apache Group\Apache2\modules

Configuration and Setup:

1. Set Environmental Variables:
2. JAVA_HOME=D:\Program Files\Java\jdk5
3. CATALINA_HOME=D:\apache-tomcat
4. Create empty file D:\Program Files\Apache Group\Apache2\conf\workers.properties, insert code:

workers.tomcat_home=D:\apache-tomcat
workers.java_home=D:\Program Files\Java\jdk5
ps=\
# Define worker ‘worker’
worker.list=worker
# Set properties for worker ‘worker’ (ajp13)
worker.worker.type=ajp13
worker.worker.host=localhost
worker.worker.port=8009
worker.worker.cachesize=10
worker.worker.cache_timeout=600
worker.worker.socket_keepalive=1
worker.worker.reclycle_tomout=300

Edit D:\Program Files\Apache Group\Apache2\conf\httpd.conf, insert code:

LoadModule jk_module modules/mod_jk.so
<IfModule mod_jk.c>
    JkWorkersFile conf/workers.properties
    JkLogFile logs/mod_jk.log
    JkLLogLevel error
    JkLogStampFormat “[%a %b %d %H:%M:%S %Y] “
    JkOptions +ForwardKeySize +ForwardURICompat –ForwardDirectories
    JkRequestLogFormat “%w %V %T”
    Alias /jsp-examples “D:/apache-tomcat/webapps/jsp-examples/”
    <Directory “D:/apache-tomcat/webapps/jsp-examples/”>
        Options Indexes +FollowSymLinks
        AllowOverride None
        Allow from all
    </Directory>
    Alias /servlets-examples “D:/apache-tomcat/webapps/servlets-examples/”
    <Directory “D:/apache-tomcat/webapps/servlets-examples/”>
        Options Indexes +FollowSymLinks
        AllowOverride None
        Allow from all
    </Directory>
    <Location /*/WEB-INF/*>
        AllowOverride None
        Deny from all
    </Location>
    JkMount /jsp-examples/*.jsp worker
    JkMount /servlets-examples/* worker
</IfModule>

Install and Start Tomcat

Tomcat can be installed as a Service or started as a Standalone Console application. Note to make sure that Apache HTTP Server has been started at this point.

1. Tomcat Service

Open the command-line prompt:
D:\apache-tomcat\bin\service.bat install
Note that this Service is installed, by default, as StartUp Type “manual”. You will need to start this Service manually each time your system reboot, you may consider to change the Service’s StartUp type to “Automatic”.
To shutdown the Tomcat Service:
NET STOP Tomcat5
To remove/uninstall the Tomcat Service:
Service.bat remove

1. Standalone Console application

D:\apache-tomcat\bin\startup.bat to start Tomcat.
D:\apache-tomcat\bin\shutdown.bat to shutdown Tomcat
Test Tomcat 5.5 and mod_jk installations:

1. Test the native Tomcat server:

http://localhost:8080/ 


http://localhost:8080/manager/status

1. Test Apache/mod_jk:

http://localhost/jsp-examples/ 


http://localhost/servlets-examples/