Apache Software Foundation | Jakarta Project | Apache Tomcat


Printer Friendly Version
What's JK?

JK is a replacement to the elderly mod_jserv. It was a completely new Tomcat-Apache plug-in that handles the communication between Tomcat and Apache.

The newest JK2 is a refactoring of JK . The native part has been completly restructured and the configuration has been simplified a lot.

JK is more than just an apache module, since it could be used with majors WebServer :

  • mod_jk is an Apache module to be used with Apache 1.3 and 2.0 Webservers.
  • isapi is a redirector to be used with IIS .
  • nsapi is a redirector to be used with Netscape/iPlanet .
  • dsapi is a redirector to to be used with Domino .

Why should I use the JK?

JK was develop to overcome many limitations of its ancestor, mod_jserv .

mod_jserv was too complex and because it was ported from Apache/JServ, it brought with it lots of JServ specific bits that aren't needed by Apache.

Where mod_jserv supported only Apache webservers on Unix OS, JK supports much more web servers and operating systems through via a compatibility layer named the JK library . The layered approach provided by the JK library makes it easier to support many different webservers and OS.

JK offer better support for SSL, that's was a problem with mod_jserv which couldn't reliably identify whether a request was made via HTTP or HTTPS.

JK can, using the newer Ajpv13 protocol which relay many SSL informations required by servlet 2.2 and 2.3 specs.

JK offers a lot of different and flexible communications between a Web Server and the Tomcat Servlet Engine and could be used today with all of the ASF Tomcat Engines, 3.2.x , 3.3.x , 4.0.x , 4.1.x and 5.x

What's the difference between JK and JK2?

JK2 is a refactoring of JK and is much more powerfull.

Even if it works with Apache 1.3, JK2 has been developed with Apache 2.0 in mind, and is better suited for multi-threaded servers like IIS, NES/iPlanet. It can also be embeded in other applications and used from java.

JK2 improves the modularity and has a better separation between protocol and physical layer. As such JK2 support fast unix-socket, and could be extended to support others communications channels. It is better suited for JNI and may use (in a future version) JDK 1.4 NIO.

There is additional support for monitoring, similar with JMX in java. A module similar with mod_status is provided, and additional adapters can be used to interface and provide status and runtime configuration. .

The configuration has been changed to follow the component models. Multiple configuration sources can be supported ( in additon to file ) providing better integration with the embeding application. The config layer uses the management layer APIs and it can support persistence for changes done via runtime configuration.

Another feature is the JNI mode. Jk2 can be used as a JNI library and provide access to native features to java. For example it provides access to shared memory ( used for config and monitoring in a multiprocess environment ), unix domain sockets. It can also provide access to signals, chuid, win registry. All using the same communication mechansim, and supporting both in-process and out-of process modes.

Are there alternative ways to connect Apache and Tomcat?

The alternative ways are better described in mod_webapp documentation.

Check webapp site for it and then decide if you want to go on reading.

The big advantage of mod_webapp is that is very easy to configure, has a well defined protocol named WARP , does not care about the old crappy protocols used in Tomcat-3.x and so. But it would be possible to implement the WARP protocol in JK2 ;-))

The disadvantage is that it requires the Apache Portable Runtime which is still only easily available via Apache 2.0 and that it didn't support webservers like IIS, NES/iPlanet or Domino.

Additional References

Please note that we maintain a list of references to external documentation on connector usage and configuration in various environments as part of the Tomcat wiki Useful Links page.