Contents
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.
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.
The 64-bit installer provides the following components in addition to the basic 32-bit StreamBase installation:
-
The
bin64folder, 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
jdk64folder, 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
lib64folder, 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:
→ → →
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.
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.
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
bin64folder 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:
-
Run your application on the 64-bit sbd server.
-
Run the adapters on a 32-bit sbd server.
-
Use one of the StreamBase to StreamBase adapters to manage communication between the two servers.
-