Installing StreamBase on 64-Bit Windows

Installation Steps

To install StreamBase on a supported 64-bit Windows platform:

Install the base StreamBase for Windows kit, which installs 32-bit components.
Make sure you have installed the x64 version of the .NET 2.0 or later framework, which is required to install the StreamBase 64-bit overlay kit.
Run a second installer for 64-bit Windows that overlays 64-bit components onto the base 32-bit installation.

Important

You must install the 64-bit overlay kit into the same directory as the 32-bit base kit.

Default Locations

On 64-bit Windows, there are two Program Files folders:

C:\Program Files — for native 64-bit Windows applications
C:\Program Files (x86) — for 32-bit Windows applications

Because StreamBase for 64-bit Windows installs as an overlay kit over the 32-bit installation, the default StreamBase installation folder is:

C:\Program Files (x86)\StreamBase Systems\StreamBase.n.m

where n.m are the major and minor release numbers.

The default location for the StreamBase Studio workspace is the same as for 32-bit Windows XP:

C:\Documents and Settings\username\My Documents\
   StreamBase Studio n.m Workspace

The default location for the Studio configuration directory is also the same as for 32-bit Windows XP:

C:\Documents and Settings\username\Application Data\StreamBase\
   StreamBase Studio n.m Configuration

Components Installed

The 64-bit overlay installer adds the following components to the base 32-bit StreamBase folder:

The bin64 folder, which contains:
- A 64-bit version of sbd.exe, the StreamBase Server executable.
- A 64-bit version of sb-config.exe.
- Various supporting DLLs and other files.
The jdk64 folder, which contains the runtime components of a 64-bit version of the Sun JDK currently shipping with StreamBase Studio. (See the Supported Platforms page for the current JDK version.)
The lib64 folder, which contains 64-bit link libraries and DLLs.
Three samples get 64-bit components to demonstrate writing 64-bit functions and client applications in C++:
- sample\custom-simple-function
- sample\custom-aggregate-function
- sample\buffering
The existing Java and .NET samples work unmodified with either the 64-bit or 32-bit runtimes for those environments.

The 64-bit overlay installer also adds the following item to the Start menu:

Start → All Programs → StreamBase n.m → StreamBase 64-bit Command Prompt

The PATH and environment are pre-set in this command prompt to place the jdk64/bin and bin64 folders first in the path. Use the 64-bit Command Prompt to run the 64-bit StreamBase Server and other 64-bit command-line utilities.

Usage Notes

Study the following points to understand the use and limitations of running StreamBase on 64-bit Windows.

StreamBase Studio remains a 32-bit application, and runs from the 32-bit JVM installed in %STREAMBASE_HOME%\jdk.
By default, Studio launches the 32-bit sbd server to run and debug applications.
To run the 64-bit sbd server from Studio, add -Dstreambase.ide.sb-bin-directory=bin64 to the environment variable STREAMBASE_STUDIO_VMARGS. This variable might contain other directives at the same time. For example:
```
set STREAMBASE_STUDIO_VMARGS="-Xms=128M -Xmx=512M \
   -XX:MaxPermSize=128M                           \
   -Dstreambase.ide.sb-bin-directory=bin64"
```
Microsoft does not support loading 32-bit shared libraries or DLLs into 64-bit processes. Thus, if you have any StreamBase plug-ins such as custom functions or clients written in C++, they must be recompiled for 64-bit operation.
The 64-bit overlay kit includes 64-bit link libraries for C++ and .NET, which allows you to rebuild any custom client applications or custom functions for 64-bit operation.
Any embedded adapter that calls Windows-native libraries for underlying support must be adjusted to load the 64-bit version of those shared libraries, if available.
Certain StreamBase embedded adapters rely on third-party DLLs for which only a 32-bit version is available. Adapters in this category include: all Reuters adapters, all the IP adapters, and the Wombat adapter. These adapters still run on 64-bit Windows, using the 32-bit sbd server under the WOW64 execution environment.
To give your 64-bit StreamBase applications access to 32-bit-only adapters, run your application on the 64-bit sbd server, run the adapters on a 32-bit sbd server, and use the StreamBase-to-StreamBase adapter to manage communication between the layers.

Back to Top ^