Caucho Resin is an XSL-enhanced Java servlet server and JSP engine.
Installation Instructions
Preparation
You will need to have installed a Java Runtime Environment such as that included in Sun's Java Development Kit, freely available from http://java.sun.com/j2se/1.4.2/download.html
Installation
-
There are full Resin installation instructions on Caucho's website. Click on "Documentation" then "Resin Web Server on Unix or Windows" to find the current installation instructions.
-
You should follow the instructions on this page headed "Deploying on Unix" to install Resin with a stand-alone web server. This will by default listen on port 8380.
Before continuing, the installation should be checked by pointing a browser at http://localhost:8380/ to check that the Resin installation has been successful. A test file, such as that at the end of this document, can be used to check this.
-
Enable the Gateway Module from the Zeus Web Server Administration Server.
-
Either specify a list of directories whose content should be mapped to Resin:
| Requests to send |
Web Server |
Port |
| /servlet (for example) |
localhost |
8380 |
or:
specify a file type extension that associates a particular content type with Resin:
| Requests to send |
Web Server |
Port |
| ~/.*\.jsp |
localhost |
8380 |
| ~/.*\.xtp |
localhost |
8380 |
Please note that the port number above is the default used by the Resin HTTP server. Replace this with the appropriate value if you use a different port.
Ideally no static content should be forwarded to Resin's HTTP server to take advantage of Zeus Web Server's superior connection handling abilities.
-
Enable 'Rewrite HTTP redirects' and 'Rewrite domain within a cookie' via the Radio buttons.
-
Commit the changes to the virtual server.
Creating a Test File
You may want to create a test file. For example, put the following text in the file /usr/local/web/test.jsp:
<%@ page language=javascript %>
<H1>Test jsp page</H1>
Is the sum correct?<BR>
2 + 2 = <%= 2 + 2 %>
Requests for http://<virtual_server_address>/test.jsp should now be parsed correctly!
Further information is available at http://java.sun.com/products/servlet/index.html for documentation on the Java Servlet API and JSP API.
