Running Blue Dragon JE22 under JRun4

The following instructions describe one way to run Blue Dragon under JRun4:

  1. Download the ZIP File version (labelled “Any”) J2EE version of Blue Dragon http://www.newatlanta.com/c/products/bluedragon/download/home.
  2. Unzip the file into any temporary directory.
  3. In the JRun4 administrator (http://localhost:8000/) create a new server called BlueDragon. (I use port 8400).
  4. Browse to the new server folder location (…./JRun4/servers/bluedragon) and delete the default.ear folder.
  5. Now copy the expand war file folder (something like BlueDragon_webapp_701_352) in your unzipped temporary directory under the …./JRun4/servers/bluedragon directory.
  6. Rename the new BlueDragon_webapp_701_352 to BlueDragon-war.
  7. In the JRun4 administrator, start the BlueDragon server and then view the BlueDragon-war settings page.
  8. Edit the Context Path from “/BlueDragon-war” to “/“.

The Blue Dragon test page should now be available at http://localhost:8400/

A few more steps are required is you want to use the XML CFML Tags and Functions. If you try running a page using XML features of CFML you will get an error message:

Unrecognized error code: The configured XML parser does not support JAXP 1.3. Please configure the JVM to use a JAXP 1.3 compliant XML parser. If using Sun Microsystems’ JDK 1.5, this can be done by setting the system property javax.xml.parsers.DocumentBuilderFactory to “com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl”.

The following steps will change the JVM’s default XML parser to the one required by Blue Dragon (Assuming you are using JVM 1.5+):

  1. In the JRun4 administrator, view the Java VM Settings page.
  2. Add the following to the VM Arguments:
  3. Restart the BlueDragon server.

Note: This will effect all JRun4 servers, as the JVM settings are shared. Anyone know how to do this on per server basis?


Leave a Reply

Copyright © 2005, David Beale

  • Valid XHTML 1.0!
  • Valid CSS
  • Level Triple-A conformance icon, W3C-WAI Web Content Accessibility Guidelines 1.0