This document describes how to bundle the JREs that are included within
the various JON distributions.

To create the JRE bundles, first download the appropriate JDK
distributions from:

  * http://java.sun.com/ for Linux, Windows, and Solaris
  * http://www.hp.com/go/java for HP-UX

UNIX Instructions
=================
For Linux, Solaris, and HP-UX, the process is straightforward. Install 
the JDK, then run the following commands:

  cd <jdk-install-dir>
  tar cvf - jre | gzip > /tmp/jre.tar.gz

For 1.4 JREs on Linux, before creating the JRE tarball, edit 
jre/lib/security/java.security and change the property
securerandom.source from "/dev/random" to "/dev/urandom" to avoid
blocking when using the SecureRandom class (e.g. when making an HTTPS
connection). For more information on why this is done, see
http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4705093.

For the x64 (AMD64/Intel64) Linux agent, we distribute the Sun 1.5 JRE
for the server, as well as the agent. This is because Sun does not
provide a 1.4 JRE for x64 Linux.

For HP-UX, the bundle must be created on an HP-UX machine to avoid
permissions issues.

TODO: Add instructions for AIX.

Windows Instructions
====================
For Windows, a self-extracting archive must be created, because Windows
does not include a command-line archive utility out-of-box. Install the
JDK, then, using the unz551xn.exe file checked into the same directory as
this README, run the following commands:

  cd <jdk-install-dir>
  zip -r jre.zip jre
  copy /b unz552xN.exe+jre.zip jre.exe
