The Tomcat Domino Redirector is a DSAPI filter written by Andy Armstrong of Tagish. DSAPI is a plug-in infrastructure that allows you to write plug-ins that runs under the Domino HTTP stack and allows you to process HTTP requests before they reach the Domino HTTP stack. For those familiar with ISAPI, DSAPI is the same but for the Domino server.
The filter has recently been moved to be a official part of the Tomcat Connectors instead of being a separate project. The connector now also supports the JK2 protocol for those interested in such details. JK2 is the same protocol you use when you setup Tomcat being the Apache HTTP server using the mod_jk module.
To setup the DSAPI connector I simply followed the steps in a howto document I found on Google. I had to get the binary Tomcat 5.5.9 distribution from the Jakarta site since I couldn’t find the workers2.properties file anywhere else. Furthermore – the Registry file provided from the page didn’t set the “serverRoot” key for some reason so I had to create that key manually afterwards.
Other than that the whole process was painless and now JIRA runs happily behind Domino configured using Internet Sites documents without any issues and the users didn’t even notice. Nice.
