Installing StreamBase on Windows

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 LiveView™ Desktop and the companion Desktop Workspace Manager are installed with a separate procedure, 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 a supported Windows as listed in Supported Configurations.

  • 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 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 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.

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.6.7 would be installed in the StreamBase 7.6 directory. If you also have a 7.5.x release on the same machine, it would not be affected by installing 7.6.7, because that version would be located in the C:\TIBCO\sb-cep\7.5 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 maintenance release. Thus, when you install release 7.6.7, for example, it will supersede any previous 7.6 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.6.7) over a previous release (such as 7.6.2).

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\m.n\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.

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.

    The 64-bit version of the StreamBase installer is named with the following pattern: TIB_sb-cep_m.n.p_win_x86_64.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, NEVER try to overwrite an existing 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

StreamBase is only supported on 64-bit Windows. This gives rise to the following considerations:

  • 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++ with a previous StreamBase release, 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.

The Windows Start Menu

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

Start Menu for Windows 7

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.

Start Menu for Windows 8.1

On Windows 8.1, 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 search feature to locate the phrases StreamBase or LiveView. This results in entries clearly labeled, such as StreamBase 7.6 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.

Start Menu for Windows 10

On Windows 10, Start menu entries for StreamBase and Live Datamart are much like the image shown above for the Windows 7 Start menu.

The difference is that Windows 10 no longer allows subfolders to appear in the Start menu. That is, in Windows 7, the Start menu was organized with a top-level TIBCO folder that contained TIBCO Live Datamart n.m and TIBCO StreamBase n.m subfolders. However, Windows 10 now allows only the top-level TIBCO folder in the Start menu, which means the contents of the former subfolders are concatenated into one folder.

If you have a single TIBCO product installed, the Windows 10 Start menu organization works well. However, if you have more than one TIBCO product installed, all Start menu entries from all products appear together in one long TIBCO menu.

Of course, the installers for existing products cannot be retroactively reconfigured to install each TIBCO product into its own top-level Start menu folder. Eventually, newer releases of TIBCO product installers, including installers for StreamBase and Live Datamart, will catch up with the new restrictions imposed by Windows 10.

In the meantime, you can manually reorganize your Start menu to place the menu entries for each TIBCO product into their own top-level, product-specific Start menu folder. Follow these steps:

  1. Use one the following Windows 10 key combinations:

    • Enter Windows-key+R and type shell:common start menu. Use this method if you installed your TIBCO product in a system-controlled folder such as C:\TIBCO or C:\Program Files. (By default, StreamBase and Live Datamart are installed in C:\TIBCO.)

    • Enter Windows-key+R and type shell:start menu. Use this method if you installed your TIBCO product in a personal folder as part of your Windows home directory.

  2. This opens a new Explorer window to the top of the System or Personal Start menu, respectively. Double-click Programs to enter the Start menu folder itself.

  3. Look for a folder named TIBCO. If not found, use the other key combination and look again. (It is also possible to have a TIBCO folder in both Start menu locations.)

  4. Look inside the TIBCO folder. If it contains subfolders for the product of interest, move each entire subfolder, one at a time, one level up to become a sibling of the TIBCO folder.

  5. Rename each moved subfolder so that it begins with "TIBCO". This keeps all TIBCO products alphabetically together in the Start menu. For example, move StreamBase n.m up parallel to its containing TIBCO folder, and rename it TIBCO StreamBase n.m. Do the same for the Live Datamart n.m subfolder.

  6. If you have other TIBCO products installed, including other versions of StreamBase, move their subfolders or move their individual menu entries for each product in turn.

    1. If your TIBCO folder contains individual menu entries instead of, or alongside subfolders, create new top-level folders, parallel to TIBCO, to contain the Start menu entries for each product of interest.

    2. Move the appropriate menu entries from the TIBCO folder to the newly created top-level folder.

  7. When the TIBCO folder is empty — that is, when all of its contents have been moved up to new top-level folders — you can delete the TIBCO folder.

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.maintenance_win_arch.msi

where productid identifies the add-in or adapter, major, minor and maintenance 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, you can 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.

The StreamBase installation provides a single StreamBase m.n Command Prompt command prompt menu item, which invokes the 64-bit command prompt. The 32-bit StreamBase command prompt is no longer provided.

For reference, consider the following historical information about previous StreamBase releases:

  • On 64-bit Windows, you would 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, you would 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

The StreamBase installation on all platforms includes the runtime components of an Oracle JDK for private use by StreamBase and Live Datamart programs. See Supported Configurations for the current version of the JDK shipped with StreamBase. The private JDK is installed in the jdk subdirectory of your StreamBase installation.

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

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 may issue 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: