Installing StreamBase on Windows

Contents

Before You Install
Maintaining Multiple StreamBase Releases
Uninstalling a Previous Release of StreamBase
Installing 32- and 64-Bit Versions Together
Installation Process
64-Bit Windows Considerations
The Windows Start Menu
Post-Installation: Install Add-on Products
Post-Installation: Licensing
Post-Installation: Running from Command Windows
Post-Installation Option: Configure an External JDK
Allow Connection If Your Firewall Prompts
Related Topics

This page describes the installation of the TIBCO StreamBase® base kit on Windows platforms. The base kit for Windows includes the StreamBase Studio authoring environment, StreamBase Server, support files for the StreamBase Client API, TIBCO LiveView Server, and the LiveView extensions for StreamBase Studio.

TIBCO StreamBase® LiveView Desktop and the companion Desktop Workspace Manager are installed with a separate prodecure, described in Installing LiveView Desktop.

Before You Install

Read Prerequisite Documentation

For pertinent details on platforms, see the Supported Configurations topics. To learn what has changed from one release to another, read the Release Notes and New and Noteworthy.

Check System and Materials

To install StreamBase on Windows, you must have:

  • A computer with a 64-bit edition of one the following versions of Windows:

    • Windows 8.1 Pro

    • Windows 7 Professional

    • Windows Vista Business

    • Windows Server 2012 or Server 2012 R2

    • Windows Server 2008 or Server 2008 R2

    32-bit editions of the non-Server Windows versions above are supported for testing and evaluation only, but support for 32-bit Windows is deprecated starting with StreamBase release 7.5.0.

  • The computer must be connected to the Internet unless a StreamBase installation kit is already available on site.

  • A StreamBase installation kit downloaded from the TIBCO distribution site or from a private URL provided by your TIBCO Software representative.

  • A valid StreamBase license file, as discussed in Configuring a StreamBase License. Once put in place, the license file persists on your machine when you reinstall StreamBase.

Windows Installation Locations

For bot 64-bit and 32-bit Windows, the default installation path is: 

C:\TIBCO\sb-cep\n.m

where n.m are the major and minor release numbers. Other file system elements, such as program groups, shortcut names, and registry keys, similarly specify a major.minor version.

You can deploy both 32-bit and 64-bit versions of StreamBase on a computer running 64-bit Windows, as described below.

Maintaining Multiple StreamBase Releases

You can install more than one release of StreamBase on the same Windows computer, with specific limitations outlined below.

  • Maintenance releases are always installed in the parent release's directory. For example, release 7.5.2 would be installed in the StreamBase 7.5 directory. If you also have a 7.4.x release on the same machine, it would not be affected by installing 7.5.2, because that version would be located in the C:\TIBCO\sb-cep\7.4 directory.

  • New maintenance releases replace any previously-installed release for the same major.minor version on your system. That is, in the C:\TIBCO\sb-cep\n.m directory, there can be one and only one StreamBase release. Thus, when you install release 7.5.2, for example, it will supersede any 7.5 minor or maintenance release that may exist on your machine.

  • Other than changes caused by updating StreamBase software to fix bugs and provide new features, installing new releases does not impact existing StreamBase deployments. Workspaces, Windows services, event logging, registry keys, and so on, persist independently of the installed software.

Uninstalling a Previous Release of StreamBase

When you install a maintenance release, you must first uninstall any existing version of the same major.minor release. If you do not, the StreamBase installer prompts you to uninstall the existing one. This occurs if you try to install a maintenance release (such as 7.5.1) over a previous release (such as 7.5.0).

Do not remove the StreamBase installation directory manually. That is, do not drag it to the Recycle Bin or select it and press Delete, or remove it at a command line prompt. Instead, to uninstall a previous StreamBase release, use the Uninstall a program link in the Windows Control Panel.

Uninstalling a previous StreamBase release does not affect any StreamBase application files you created in that release. The StreamBase uninstaller only removes files that the installer placed on your disk, and deliberately leaves certain files in place:

  • Your license file is preserved in C:\TIBCO\sb-cep\etc. This allows you to uninstall a release and re-install a maintenance release into the same directory, re-using the same license file.

  • Your StreamBase Studio workspace and configuration directories are preserved.

  • Any Eclipse plug-ins you downloaded and installed into StreamBase Studio are left behind, including any data, log files, and directories they use.

Installing 32- and 64-Bit Versions Together

To install StreamBase on a supported 64-bit Windows platform, make sure to obtain the correct installer, as there are independent StreamBase installers for 32-bit and 64-bit Windows.

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 StreamBase 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 StreamBase 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 StreamBase Studio provides an option to launch the 32-bit Server when needed.

Installation Process

To install StreamBase on Windows, follow these steps:

  1. If you are installing a maintenance release for an existing installation, first uninstall the existing StreamBase release, as described in Uninstalling a Previous Release of StreamBase.

  2. Launch the StreamBase installer by running the .msi installer file that you downloaded from the TIBCO distribution site or from an FTP site provided by your TIBCO Software representative.

    On 64-bit Windows, select the 64-bit version of the StreamBase installer. On the TIBCO distribution site, the file name is based on this pattern: TIB_sb-cep_m.n.p_win_x86_64.msi.

    On 32-bit Windows, select the 32-bit version of the StreamBase installer. On the TIBCO distribution site, the file name is based on this pattern: TIB_sb-cep_m.n.p_win_x86.msi.

    where m.n.p indicate the major, minor, and maintenance release versions.

  3. Follow the instructions on screen to accept the StreamBase license agreement.

  4. Accept the default StreamBase installation location or browse to a different location. However, do NOT try to overwrite a previous StreamBase installation.

  5. Click Install to begin the installation process.

  6. On the installer's final screen, select the check box to open the post-installation README in your Web browser to see important information. The README describes the entries installed in the Windows Start menu for this release.

  7. Click the Finish button.

Note

The StreamBase installation defines one or more Windows services that are not started by default, plus a number of registry keys. On a development machine, you do not need to modify these entities as part of the post-installation process or during subsequent StreamBase sessions. When you are ready to customize and deploy a StreamBase application when installing on a deployment server, consult the Running StreamBase Server as a Windows Service topic in the Administration Guide.

64-Bit Windows Considerations

Running StreamBase on 64-bit Windows gives rise to the following considerations and limitations:

  • When using the 64-bit StreamBase Command Prompt, the PATH and environment are pre-set 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.

  • StreamBase 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 StreamBase 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 StreamBase 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 certain Thomson Reuters adapters . 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.

The Windows Start Menu

This section describes Windows Start menu changes made by the StreamBase and Live Datamart installers.

Start Menu for Windows 7 and Windows Vista

Starting with TIBCO StreamBase release 7.5.0 and TIBCO Live Datamart 2.0.0, links to run the included applications are placed in the Windows Start menu in the TIBCO folder, as shown in the following illustration.

Be aware that all pre-7.5.0 and pre-2.0.0 versions of installed StreamBase software continue to display as individual entries above the TIBCO folder entry.

Installing the 64-bit version of StreamBase places both a 64-bit command prompt and a 32-bit command prompt on the Start menu. For more information, see Running from Command Windows.

Start Menu for Windows 8

On Windows 8, the StreamBase installer places an icon to start StreamBase Studio on the desktop, but does not initially appear to provide a way to start the other features installed.

However, you can switch to the Start tiles screen and use its seach feature for the phrases StreamBase or LiveView. This results in entries clearly labeled, such as StreamBase 7.5 64-bit Command Prompt.

The same Start menu structure is actually installed on Windows 8 as for Windows 7 as described in the previous section. However, Window 8 has famously lost its Start menu in favor of the start tiles mechanism.

TIBCO recommends the following procedure to allow you to start and run StreamBase and LiveView programs with ease from the Windows 8 desktop:

  1. Open Windows 8 Desktop mode.

  2. Double-click This PC to open a Windows Explorer window.

  3. Navigate to the following location, or copy and paste this path in the Explorer window's navigation field: 

    C:\ProgramData\Microsoft\Windows\Start Menu\Programs

    The C:\ProgramData folder is hidden by default, so you may need to select the Hidden items check box on the View ribbon of the Explorer window.

  4. Select the TIBCO folder in this location. Right-click and drag it to the desktop, holding down the right-click mouse button all the way. Then release the mouse button, and select Create shortcut here from the pop-up menu.

  5. Thereafter, double-click the desktop shortcut to the TIBCO Start menu items, where you can navigate the folders and double-click to launch any item.

Post-Installation: Install Add-on Products

TIBCO provides separate installer files for the Excel Add-on, certain additional adapters, and add-in products such as the High-Performance FIX Engine.

As downloaded from the TIBCO distribution site, the installers are delivered in a single file named with the following pattern:

  • TIB_productid_major.minor.servicepack_win_arch.msi

where productid identifies the add-in or adapter, major, minor and servicepack identify the specific release, and arch identifies the targeted CPU architecture, either x86 for 32-bit or x86_64 for 64-bit.

After completing the installation of StreamBase on Windows, next install any external adapter or add-in product for which you have a license, using its separate installer.

The installers for most add-in products look for a matching StreamBase base release, and only allow installation of the product into that base release's directory. By contrast, external adapters can be installed on a machine that does not have a StreamBase installation.

Post-Installation: Licensing

Configure your StreamBase license as described in Configuring a StreamBase License.

Post-Installation: Running from Command Windows

Always run the command line version of StreamBase Server (sbd.exe) from a StreamBase Command Prompt invoked from the Windows Start menu, not from the standard Windows command prompt. The StreamBase Command Prompt has its environment and PATH preconfigured for running StreamBase and LiveView commands and utilities.

On 64-bit Windows, use the StreamBase m.n 64-bit Command Prompt menu item to run the 64-bit version of sbd.exe.

On 32-bit Windows, or on 64-bit Windows when both versions are installed, use the StreamBase m.n Command Prompt menu item to run the 32-bit version of sbd.exe.

You can set the environment manually using the sb-config command, as described in sb-config. But use caution when doing so if you have a mix of two or more StreamBase installations, as described in StreamBase Command Prompt.

Post-Installation Option: Configure an External JDK

To run StreamBase applications, you must have a supported JDK installed. StreamBase requires a full JDK, not just a JRE.

The StreamBase installation on all platforms includes the runtime components of an Oracle JDK for private use by StreamBase and LiveView programs. See Supported Configurations for the current version of the JDK shipped with StreamBase. By default, the private JDK is installed in the jdk subdirectory of your StreamBase installation. On 64-bit Windows, a 64-bit JDK is also installed in the jdk64 subdirectory.

If you prefer to use a separately installed JDK to run StreamBase applications, you must configure your system and StreamBase as described in Using an External JDK.

Allow Connection If Your Firewall Prompts

When you run a StreamBase application in StreamBase Studio (for example, by launching one of the demos in the SB Demos perspective), StreamBase Studio makes a local network connection to a StreamBase Server instance. When this connection is first attempted, your firewall or Internet security software issues a warning message. Always select the Allow or Unblock option that allows StreamBase to make the connection.

In StreamBase Studio, the connection cannot proceed until you allow the firewall or Internet security software to let StreamBase make the connection.

The message may refer to StreamBase Server, or sbstudio.exe (StreamBase Studio), or javaw.exe (Java). In all cases, allow StreamBase Studio to make the connection. StreamBase is not performing an outgoing connection of any kind.

You may see similar messages if you select options on the StreamBase Studio Welcome page that access an external website or open a topic in the local StreamBase Help (which uses a Java viewer). For example:

Related Topics