Using an External JDK

The StreamBase installation on all platforms includes the runtime components of an Orcale-Sun JDK for private use by StreamBase Studio and StreamBase Server. See Supported Configurations for the current version of the JDK shipped with StreamBase.

If you prefer to use a separately installed Oracle-Sun JDK to run StreamBase applications, you must configure your system and StreamBase as follows:

Consult the Supported Configurations page to determine the current minimum JDK release levels supported by the current release of StreamBase. Do not try to use an earlier JDK release.
Download and install the JDK on each system that will run StreamBase Studio and StreamBase Server.
Configure both StreamBase Studio and StreamBase Server to use your JDK with these steps:
- Define the JAVA_HOME environment variable, and set it to the full, absolute path to the top-level directory containing your JDK.
- Define the STREAMBASE_USE_INTERNAL_JDK environment variable, and set its value to false. The value must be false in lowercase, as shown.
On 64-bit Windows, when using the StreamBase n.m 64-bit Command Prompt to invoke the 64-bit version of sbd, be sure to point JAVA_HOME to the location of a 64-bit JDK.
For StreamBase Server (but not Studio), as an alternative to using environment variables, you can edit the server configuration file for each instance of the server you will run. Edit the parameter param name="java-home" in the <java-vm> element to point to the full, absolute path of your external JDK. For example:
```
<java-vm>
  <param name="java-home" 
         value="C:\Program Files (x86)\Java\jdk1.6.0_23" />
</java-vm>
```
```
<java-vm>
  <param name="java-home" value="/usr/java/latest" />
</java-vm>
```
StreamBase Studio ignores the configuration file java-home setting, both for running Studio itself and for running StreamBase Server from within Studio. Thus, this setting only has an affect when running StreamBase Server at the command prompt with the sbd command.

On 64-bit Windows, you can install both 32-bit and 64-bit Oracle-Sun JDKs. Each is installed in a separate location, as shown in the examples in this section. For a 64-bit StreamBase installation, when you anticipate running the 64-bit version of sbd, be sure to point the java-home parameter to a supported 64-bit JDK. For example:
```
<param name="java-home" 
       value="C:\Program Files\Java\jdk1.6.0_23" />
```