TIBCO StreamBase® and TIBCO® Live Datamart README

What Was Installed?

StreamBase is a complete kit that provides:

  • StreamBase Studio for application authoring, testing, and debugging.
  • The StreamBase Runtime to be run on this machine.
  • The TIBCO Live Datamart Runtime for this machine.
  • StreamBase Manager for monitoring and performing administrative tasks on running StreamBase applications.
  • A set of command-line utilities to manage the StreamBase Runtime and to connect to a running fragment or application.
  • Java, C++, .NET, and Python APIs for creating custom StreamBase and Live Datamart clients, and Java APIs for creating custom StreamBase functions, operators, and adapters.
  • A copy of TIBCO Enterprise Runtime for R (TERR) Developer Edition for private use by StreamBase applications.
  • A copy of TIBCO LiveView Web Standard Edition for development-only purposes.

Notice that Live Datamart release numbers match their companion StreamBase release numbers (unlike in previous releases). Thus, StreamBase 10.3.x is accompanied by Live Datamart 10.3.x.

The installation is placed by default in C:\TIBCO\sb-cep\10.3\.

Separate Workspace Locations for Each Release

StreamBase Studio stores the files that comprise your StreamBase projects in a folder known as a workspace. The default location for the StreamBase Studio workspace is the following for Windows 10 and later:

C:\Users\username\Documents\StreamBase Studio n.m Workspace

where n.m is the current StreamBase release number. If you used a previous release of StreamBase Studio on this machine, that version's workspace folder is preserved in its current location.

Do Not Mix Workspace Versions

By default, StreamBase Studio creates a separate workspace for each major StreamBase release. TIBCO recommends starting with a clean, unused workspace for the latest release and importing your projects from an earlier release's workspace. This allows you to return to the older workspace using an older installed StreamBase release to support existing projects.

It is very important to not try to re-use a StreamBase 7 workspace directly in StreamBase 10. StreamBase 10 provides a new Apache Maven-based project format. While an automatic upgrade wizard is provided to migrate your projects from previous workspace formats to the new Maven format, there is no downgrade facility. This is why TIBCO recommends copying your StreamBase 7.x and Live Datamart 2.x projects into a clean, new StreamBase 10.3 workspace.

It is equally important to be careful about opening StreamBase 10.2.x workspaces in 10.3.0. StreamBase 10.3.0 makes edits to the POM files when upgrading Maven format projects from earlier 10.x releases. Once edited, those projects only work well in StreamBase 10.3.0 or later.

Installing Multiple Versions

You can install more than one release of StreamBase on the same Windows PC. New releases are installed by default in C:\TIBCO\sb-cep\n.m\, where n.m are the major and minor release numbers.

This means you can have on the same Windows machine any number of StreamBase instances, as long as their major.minor release numbers are different.

Maintenance releases are automatically installed in the appropriate major.minor release directory. For example, release 10.3.1 would be installed in the same directory as StreamBase 10.3.0 and thus replace it.

Start Menu Items

The installation adds a TIBCO entry to the Start menu.

On Windows 7 and 8.1, the TIBCO folder on the menu contains subfolders with names such as StreamBase n.m and Live DataMart n.m, where n.m is the current release number for the respective products.

On Windows 10, subfolders are no longer supported in folders on the Start menu. The unfortunate consequence is that entries for all currently installed TIBCO products are collapsed into a single folder in the Start menu. For StreamBase 10 releases, use the Start menu's search function to locate items by StreamBase release number.

The TIBCO folder on Windows 10 contains the following important entries:

  • StreamBase n.m Command Prompt: Opens a Windows Command Prompt with the environment set to run StreamBase command line tools.
  • StreamBase Studio n.m: Launches the StreamBase Studio development environment.
  • StreamBase Manager n.m: Launches StreamBase Manager, a graphical server console thats shows you runtime statistics for your StreamBase Server processes.

Next Steps: Run the Demos and Learn What's New

Start by opening StreamBase Studio:

On Windows 7, look for the StreamBase Studio 10.3 icon that the installer placed on the desktop. Double-click this icon.

On Windows 7 or 8.1, the TIBCO folder on the menu contains subfolders with names such as StreamBase n.m and Live DataMart n.m, where n.m is the current release number for the respective products. Open the StreamBase folder and select the icon for StreamBase Studio.

On Windows 10:

  • If you are in the Windows 10 tablet mode, switch to desktop mode.
  • Look for the StreamBase Studio 10.3 icon that the installer placed on the desktop. Double-click this icon.
  • As an alternative, you can click the Start button in the lower left corner of the Windows 10 desktop. Then type StreamBase Studio 10.3 to locate the Studio instance to run.

If you are new to StreamBase, you can:

  • Run the demos. From the Welcome page, click the First Steps button, then select SteamBase Demos.
  • Read the Getting Started Guide and follow the steps to build your first StreamBase EventFlow application.

If you are familiar with previous releases of StreamBase, read New and Noteworthy.