Installing StreamBase on Windows

Contents

Before You Install
Coexistence of Multiple StreamBase Installations
Uninstalling Previous Releases
Installation Process
Installing External Adapters and Frameworks
Post-Installation: Licensing
Post-Installation: Running from Command Windows
Post-Installation Option: Configure an External JDK
Allow Connection by StreamBase Studio if Your Firewall Prompts
Uninstalling on Windows
Related Topics

This topic explains how to install the StreamBase authoring and server software on Windows.

Before You Install

Read Prerequisite Documentation

If you have not already done so, read the Release Notes, New and Noteworthy, and the Supported Configurations topics.

Check Materials

To install StreamBase on Windows, you need:

  • A machine running either:

    • A 32-bit version of Windows 7 Professional, Windows Vista Business, Windows XP Professional, or Windows Server 2003.

    • A 64-bit version of Windows 7 Professional, Windows Vista Business, Windows Server 2008, or Windows Server 2003.

  • A StreamBase for Windows installation CD-ROM or USB drive, or a StreamBase installation kit downloaded from streambase.com, or from a private URL provided by your StreamBase Systems representative.

  • A valid StreamBase license file.

Migrating from StreamBase 3.x

StreamBase release 3.7 and earlier requires you to uninstall all previous releases before installing a newer release. If you have any 3.x release currently installed, follow the instructions in Migrating from StreamBase 3.7.

Coexistence of Multiple StreamBase Installations

Starting with release 5.0, you can install more than one release of StreamBase on the same Windows machine. Here are some important features of multiple installations:

  • For 32-bit Windows, StreamBase 5.0 and later versions are installed by default in: 

    C:\Program Files\StreamBase Systems\StreamBase.n.m

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

    C:\Program Files (x86)\StreamBase Systems\StreamBase.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, are similarly version-decorated.

  • On the same Windows machine, you can have any number of StreamBase 5.0 or later instances, as long as the major.minor release number is different.

  • Maintenance releases are always installed in the parent release's directory. For example, release 7.0.2 would be installed in the same directory as StreamBase 7.0.0.

  • Conversely, you cannot install a maintenance release alongside its parent major release. That is, you can install release 6.6.4 without removing release 6.6, but you cannot install 6.6.4 alongside release 6.6. You can only upgrade from release 6.6 to 6.6.4.

  • Going forward, installing new releases of StreamBase should not impact existing StreamBase deployments. Installation directories, Windows services, event logging, registry keys, and so on, are independent.

Uninstalling Previous Releases

The StreamBase installer might prompt you to uninstall an existing release. This occurs if you are installing a maintenance release (such as 7.0.2) when you currently have a previous release installed (such as 7.0.0).

Uninstalling a previous StreamBase release does not affect any StreamBase application files you created in that release. Your StreamBase Studio workspace is left in place, along with any project files it contains.

To remove a previous StreamBase release:

  • On Windows XP, use the Windows Add or Remove Programs Control Panel.

  • On Window 7 or Windows Vista, use the Uninstall a program link in the Control Panel's top level.

Installation Process

To install StreamBase on Windows, follow these steps:

  1. If you are installing a maintenance release for an existing installation, uninstall the existing StreamBase release, as described in the previous section.

  2. Launch the StreamBase installer using one of the following methods:

    • Load the StreamBase for Windows CD-ROM or USB drive. Locate and double-click Setup.exe.

    • Run the StreamBase .msi file that you downloaded from streambase.com or from an FTP site provided by your StreamBase Systems representative.

    On 64-bit Windows, be sure to select the 64-bit version of the StreamBase installer, whose file name begins with StreamBase-Win64.

  3. Follow the instructions onscreen 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, to read 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. You do not need to modify these entities as part of the post-installation process, or during your initial use of StreamBase. When you are ready to customize and deploy a StreamBase application, consult the Running StreamBase Server as a Windows Service topic in the Administration Guide.

Installing External Adapters and Frameworks

External adapters and StreamBase Frameworks may have their own separate installer files. Adapter and Framework Installer file names follow naming patterns like these:

  • streambase-name-adapter-version-datecode-arch.msi

  • streambase-name-framework-version-datecode-arch.msi

where name identifies the adapter or Framework, version is the release number, datecode is a timestamp, and arch identifies the targeted CPU architecture.

After the StreamBase base kit is installed, install any external adapter or Framework for which you have a license, using its separate installer.

Framework installers look for a matching StreamBase base release, and only allow installation of the framework into that base release's directory. External adapter Installers can possibly be run on a machine that does not have a StreamBase installation, so the choice of location directory is more flexible.

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 the StreamBase Command Prompt invoked from the Windows Start menu, not from the standard Windows command prompt. The StreamBase Command Prompt has its environment preconfigured for running StreamBase 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.

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 a Sun JDK for private use by StreamBase Studio and StreamBase Server. 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 by StreamBase Studio if Your Firewall Prompts

When you run a StreamBase application in 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:

Uninstalling on Windows

To uninstall StreamBase:

  • On Windows XP, use the Windows Add or Remove Programs Control Panel.

  • On Window 7 or Windows Vista, use the Uninstall a program link in the Control Panel's top level.

Do not remove the StreamBase installation directory manually.

The StreamBase uninstaller only removes files that it placed on your disk, and deliberately leaves certain files in place:

  • Your license file is preserved in streambase-install-dir\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 Studio are left behind, including any data, log files, and directories they use.

Related Topics