Installing on Windows

Before you install Spotfire Data Streams, use the following checklist to make sure each target machine matches the prerequisites.

If you used a previous release of StreamBase Studio on the target machine, create backup copies of your existing Studio workspace directories, before using StreamBase Studio in the current release. Save the backup copy with filenames that indicate the version number of the release you are archiving. For example, save SB-workspace-10-03-00.zip.

The default location of the StreamBase Studio workspace directory is described in Default Installation Directories. You may have specified a different directory the first time you ran StreamBase Studio.

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

To install a maintenance release, you must first uninstall any existing version of the same major.minor release. If you do not, the Streaming installer prompts you to uninstall the existing one.

Do not remove the Streaming 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 prompt. Instead, to uninstall a previous Streaming release, use the Uninstall a program page in the Windows Control Panel.

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

To install Streaming on Windows, follow these steps:

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

TIBCO provides separate installer files for add-in products such as the High-Performance FIX Engine and StreamBase Manager.

As downloaded from the TIBCO distribution site, the installers are delivered in a single file named with the following pattern: SPOT_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 Streaming 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 Streaming 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 Streaming installation.

On Windows, the Streaming Runtime and all Streaming command-line utilities must be run from a StreamBase Command Prompt that you invoke from the Windows Start menu or from a shortcut on the Windows Desktop. Do not use the standard Windows command prompt. The StreamBase Command Prompt has its environment and PATH preconfigured for running Streaming commands and utilities.

See Environment Settings for a table of the environment variables set by the StreamBase Command Prompt.

When you run a Streaming 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 Streaming 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 Streaming to make the connection.

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

The message may refer to Streaming Server, or sbstudio.exe (StreamBase Studio), or javaw.exe (Java). You may see separate messages for internal programs epadmin.exe, swcoord.exe, and DTMengine.exe. In all cases, allow StreamBase Studio to make the connection. Streaming 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.

You are welcome to use a third-party command-line environment such as the Linux-like environment provided by Cygwin, as long as you are comfortable configuring that environment. Streaming formally supports using Streaming command and the mvn command using the StreamBase Command Prompt.

The primary caution about using Cygwin, MSys, or the Windows 10 Ubuntu subsystem is to make sure the subsystem has the same sense of home directory as the StreamBase Command Prompt or as Windows command prompts in general.

StreamBase Studio's embedded Maven subsystem writes to a critically important local repository stored by default in your Windows home directory, in a folder named .m2. If your Linux-like subsystem has a different meaning for your home directory, then it might try to create and use a different and competing .m2 directory in a different location.

You can set environment variables to reconcile the meaning of HOME in the various systems. As an alternative, you can set up custom settings.xml files for your different Maven installations to make sure they use the same local repository directory. See the online Maven documentation for further details.