Installing and Running StreamBase on 64-Bit Windows

Contents

Installation Considerations
History of 64-bit Support on Windows
Components Installed
Default Location
Usage Notes for 64-bit Windows

Installation Considerations

To install StreamBase on a supported 64-bit Windows platform, make sure you obtain the correct installer. There are independent StreamBase installers for 32-bit and 64-bit Windows. The 64-bit installer has a filename that includes the phrase Win64.

The StreamBase installer for 64-bit Windows provides:

  • 64-bit StreamBase Studio

  • 64-bit StreamBase Server run by default, plus 32-bit Server available as an option

  • Both 64-bit and 32-bit Oracle JDKs for private use by Studio and Server

The StreamBase installer for 32-bit Windows provides:

  • 32-bit StreamBase Studio

  • 32-bit StreamBase Server

  • 32-bit Oracle JDK for private use by Studio and Server

On 64-bit Windows, you can run both installers in either order, which gives you both 32-bit and 64-bit versions of StreamBase Studio. The second installer to run adds only the components not already installed by the first.

Certain StreamBase adapters rely on 32-bit DLLs provided by third parties. Applications that use these adapters must be run on the 32-bit StreamBase Server, which is why it is included on 64-bit Windows installations. 64-bit Studio provides an option to launch the 32-bit Server when needed.

History of 64-bit Support on Windows

StreamBase's support for 64-bit Windows has seen the following variations:

  • In the 7.x release series, the installers for 32-bit and 64-bit Windows are complete, independent, and mutually compatible. The 32-bit installer includes 32-bit StreamBase Studio and StreamBase Server. The 64-bit installer includes 64-bit Studio plus both 32-bit and 64-bit Servers. On 64-bit Windows, you can run both installers in sequence to obtain both 32-bit and 64-bit Studio on the same machine.

  • In releases 6.5 and 6.6, the 32-bit and 64-bit Windows installers were complete and independent, but mutually exclusive. You ran the 32-bit installer on 32-bit Windows and ran either installer on 64-bit Windows. Studio was 32-bit in all cases; the 64-bit kit included both 32-bit and 64-bit StreamBase Servers.

  • In releases 6.0 through 6.4, 64-bit Windows was supported with an overlay installation kit that installed on top of the standard 32-bit kit. Studio was 32-bit in all cases; the overlay kit provided a 64-bit version of StreamBase Server.

  • Releases 5.x and earlier did not support 64-bit Windows.

Components Installed

The 64-bit installer provides the following components in addition to the basic 32-bit StreamBase installation:

  • The bin64 folder, which contains 64-bit versions of:

    • sbd.exe, the StreamBase Server executable

    • sb-config.exe

    • sbbundle.exe

    • sbstudio.exe, the StreamBase Studio executable

    • Various supporting DLLs and other files

  • The jdk64 folder, which contains the runtime components of a 64-bit version of the Oracle-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 installer adds the following item to the Start menu:

Start → All Programs → StreamBase n.m → StreamBase n.m 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.

Default Location

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

  • C:\Program Files — primarily for native 64-bit Windows applications

  • C:\Program Files (x86) — primarily for 32-bit Windows applications

The StreamBase installation provides a mix of 32-bit and 64-bit files. For this reason, StreamBase installs all 32-bit and 64-bit components into the Program Files (x86) folder: 

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

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

See Default Installation Directories for the locations of workspace and configuration directories.

Usage Notes for 64-bit Windows

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

  • Studio automatically launches the 64-bit version of StreamBase Server if it detects the presence of a bin64 folder in %STREAMBASE_HOME%.

  • You can override this default and run the 32-bit version of the server by selecting the check box labeled Use 32-bit StreamBase Server instead of 64-bit version in the Run Configuration for your application (or the Debug or Trace Configuration). (This option only shows in the Configuration dialog if Studio detects the presence of %STREAMBASE_HOME%\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 StreamBase installation 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. If not, you can install the 32-bit version of Studio to work with 32-bit libraries from third party vendors.

  • 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 can still run on 64-bit Windows, by using the 32-bit sbd server under the WOW64 execution environment.

  • To give your 64-bit StreamBase applications access to 32-bit-only adapters, you can:

    1. Run your application on the 64-bit sbd server.

    2. Run the adapters on a 32-bit sbd server.

    3. Use one of the StreamBase to StreamBase adapters to manage communication between the two servers.

Back to Top ^