Overview

To run the pulse™ server you need to be using Java 1.5. This means that by default, all Java builds will also use Java 1.5. So what if your project requires an older JDK, say 1.4 or earlier? This cookbook entry describes how to configure your pulse™ project to use a JDK of your choosing. This is a two part process in which you first configure your pulse™ project to require Java 1.4, and then, if necessary, update your server/agents to handle builds that require Java 1.4.

Configure your server/agents to run builds that require Java 1.4

The following steps show you how to configure the server/agents with the details (such as installation directory) of Java 1.4.

1. Go to the configuration view for the agent that has access to Java 1.4.
2. Now select the "resources" tree item. It is likely that pulse has already detected that the Java 1.5 is installed. What we need to do is create a similar resource version, but for 1.4.
3. Edit the java resource or create a new resource called java if it does not exist by clicking on "add" link and setting the name to java.
4. Add a new version, called 1.4, and add 3 properties:
   1. java.bin.dir, for example: /usr/local/java/jdk1.5.0_08/bin. Select this property to be added to the path.
   2. JAVA_HOME, for example: /usr/local/java/jdk1.5.0_08. Select this property to be added to the environment.
   3. java.bin, for example: /usr/local/java/jdk1.5.0_08/bin/java

Configure your project to require Java 1.4

The following steps guide you through the process of creating a Java 1.4 required resource for your pulse™ project. If your project requires a different version of Java, substitute the "1.4" for your required version.

1. Go to the configuration view for the project.
2. Choose the "required resources" tree item.
3. Click the "add" link to bring up the required resource form. Where it asks for the name and version of the resource, enter the name java and the version you require, which is 1.4 for this example. Alternatively, you can select the "browse" link and select the java 1.4 resource that you just configured from the list.

When selecting a required resource you can use the resource browser to view the list of all configured resources, including those from remote agents!

What does all this mean?

What you have done here is told pulse that Java 1.4 resource is available on the specified agent, and if a build requires that particular resource, pulse will

1. only build on an agent that has the required resource, and
2. import that resource into the build context, setting up the PATH and environment as requested.

The result is a build that will always run against your select version of Java. Nice.

Further reading

For more information about resources and how they work in pulse™, good starting points are:

• Resources
• Resource Repository