Helma Logo
main list history
previous version  overview  next version

Version 5 by tobi on 11. December 2008, 14:45

To obtain better control over Jetty in a Helma installation the following patch enables Jetty to be configured from an XML file called jetty.xml in Helma's installation directory.

An example file is provided, too, configuring a NCSA log file, a generic listener on port 8080, an AJP listener on port 8009, a static context for Helma's static directory, a password protected context running two Jetty servlets as well as an SSL listener on port 8443.

For the latter one, you also need the jetty.keystore file which contains two self-signed certificates for the host names 127.0.0.1 and localhost.

To try it out apply the patch to the Helma source and drop the other two attached files into the Helma installation directory. You should disable any definitions of HTTP or AJP ports in the start script or properties file to avoid interference with Helma's settings.

<em>Note: Starting with Helma 1.6.3 the <code>-c</code> switch is officially available. Applying the patch is only necessary if you are using an older version.</em>

The patch adds the argument <code>-c</code> defining the location of the configuration file to the launcher.jar command-line invocation:

  java -jar launcher.jar -c jetty.xml

<em>Note: Starting with Helma 1.6.3 the <a href="https://dev.helma.org/trac/helma/changeset/9337">-c switch is officially available</a>. Applying the patch is only necessary if you are using an older version.</em>

After restarting Helma you still should be able to connect to Helma either directly via http://localhost:8080 or from within Apache (e.g. using mod_jk or mod_proxy_ajp) via http://localhost:8009

The secure server should be available via https://localhost:8443 – you probably need to define some security exceptions in your browser due to the self-signed certificates.

More information about the XML configuration capabilities is available at the <a href="http://jetty.mortbay.org/jetty5/tut/XmlConfiguration.html">Jetty 5 site</a>. I did not find official API docs for this version, only these ones at http://www.dpml.net/api/jetty/5.1.6/.

<% this.attachments %>

     removed
     added