Jump to: navigation, search


Revision as of 22:41, 15 October 2007 by Darin wright.ca.ibm.com (Talk | contribs) (Foundation 1.1)

J9 is the Java VM and classlibrary technology from IBM. It is highly versatile and is used as the basis for many of IBM's product offerings from embedded devices to enterprise solutions. IBM has also made the J9 VM available to the Apache Harmony project for use in running their class libraries.

IBM offers a number of J9 configurations free for evalutation purposes. For Eclipse developers looking to compile or run bundles that require only the Foundation 1.0 classes, this is ideal.

Getting J9

The trial J9 configurations are shipped as part of the WebSphere Everyplace Micro Environment (WEME) 6.1 product. Follow the steps below to get WEME 6.1.

  1. go to the WEME trials site
  2. select any of the links in the right hand column of the WEME 6.1 table (the first table on the page)
  3. on the Trials and betas page choose the trial that applies to you. Here you are choosing between Linux and Windows (ensure you select version 6.1)
  4. verify that you are about to get the right thing and click "Continue"
  5. at this point you will be ask to login/register. This process is relatively harmless and in the end worthwhile (you are after all getting this JRE for free)
  6. be sure to read and then agree to the license
  7. finally you get to te download page. Here there are several choices so read the headings carefully. You want CDC 1.0/Foundation 1.0/Personal Profile1.0 for Windows XP/X86 (or the corresponding one for Linux). This was the second section at the time of writing.
  8. Download the Binary or Executable file as you choose (acutally I don't know what a .bin file is...)
  9. after the download completes, run the installer and follow the instructions etc etc.
  10. when the install completes there will be a zip file called something like weme-win-x86-ppro10_6.1.0.20060317-111429.zip in the install location. That is the J9 configuration you want. Ignore all the other _jvm stuff. That, ironically, is the JRE used to run the installer that "installed" the .zip file. Of the ~46MB you downloaded, you actually only want that 8.5MB zip!
  11. unzip the J9 configuration zip file wherever you like

Running J9

J9 runs like any other Java system with the exception that the executables are called 'j9' and 'j9w' instead of 'java' and 'javaw'.

Ensure that the JAVA_HOME environment variable is not set. Having it set confuses other Javas (including J9) into using different directory structures.

Configuring J9 into your IDE

Now that you have J9 on your system, you need to tell the Eclipse IDE about it. That is, you need to install the JRE. Follow the instructions in the Eclipse help. Choose the "Standard VM" type and use the location into which you unzip'd J9 as the JRE home directory.

  • Ensure that the JAVA_HOME environment variable is not set. Having it set confuses other Javas (including J9) into using different directory structures.

If you are doing plug-in development, there is no need to set this new JRE definition as the default, PDE will match up your execution environment automatically.

Foundation 1.1

You may have noticed Foundation 1.1 downloads available. If you are using Eclipse 3.3.x, the J9 Foundation 1.1 configuration is not readily recognized by the Eclipse IDE. Using this configuration requires that you get and install the J9 Launching plugin from the JDT Debug page. If you are using Eclipse 3.4 (M2 or higher), you can use an execution environment description file to configure J9.

For example, an .ee file with the following contents could be used to configure J9 for Foundation 1.1. This example file defines paths relative to the location where the .ee file is installed - ${ee.home} - and assumes the .ee file is installed in the bin directory of the J9 installation.





-Dee.name="IBM J9 WebSphere Everyplace Micro Environment"
-Dee.description="IBM J9 J2ME Foundation Specification v1.1"
-Dee.copyright="(c) Copyright IBM Corp. 1991, 2006  All Rights Reserved"

To define an installed JRE in the IDE using an .ee file go to the Java > Installed JREs preference page and press the "Add..." button. On the JRE Type page Select the Execution Environment Description VM type and press the "Next" button.

On the JRE Definition page type in the location of the .ee file or use the "File..." button to select the .ee file. This will fill in attributes for the JRE from the .ee file. Press "Finish". You can now use the Foundation 1.1 configuration of J9 for building, running and debugging.