Installing LiveView Desktop

This page describes the procedure to install TIBCO LiveView™ Desktop and its companion software, LiveView Desktop Workspace Manager, on its supported platforms. These procedures are independent of the instructions to install the base kit of StreamBase with its Live Datamart features. See the following pages for instructions on installing the StreamBase base kit:

Supported Platforms

TIBCO LiveView™ Desktop and LiveView Desktop Workspace Manager are supported on the following platforms:

  • Microsoft Windows, both 32-bit and 64-bit. (See Supported Configurations for the Windows versions supported.)

  • 64-bit Macintosh OS X on Apple Macintosh machines based on Intel hardware.

  • 64-bit Linux. See Supported Configurations for the Linux distributions supported.

The LiveView Desktop installer automatically installs the appropriate bitness version for the platform it is installed on:

  • 64-bit LiveView Desktop is installed on 64-bit Windows

  • 32-bit LiveView Desktop is installed on 32-bit Windows

  • 64 bit LiveView Desktop is installed on Mac OS X and Linux

On all three platforms, LiveView Desktop 2.0.3 and later installs a private copy of an Oracle Java 8 JRE under the liveview home directory, and always runs with that JRE. This is true whether LiveView Desktop is installed as part of a StreamBase installation, or by itself on a machine with no other StreamBase software. See Supported Configurations for the Java version currently shipped with StreamBase.

LiveView Desktop on Macintosh OS X does not require an installation of Apple Java 1.6.x, as in previous releases. LiveView Desktop uses its bundled Oracle Java 8 JRE by default, so it does not matter whether you uninstall Apple Java 6 or leave it in place.

Canonical Installation Location

TIBCO supports a canonical installation location for LiveView Desktop, which is:

STREAMBASE_HOME/liveview/desktop

On Windows, this path resolves by default to:

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

On Linux, the canonical location is:

/opt/tibco/sb-cep/n.m/liveview/desktop

On Mac OS X, the canonical location is the liveview/desktop folder under the base StreamBase installation, wherever that is. See the OS X installation instructions below for ways to resolve the actual and canonical installation locations for LiveView Desktop.

While you are free to install LiveView Desktop in any location on all platforms, installing into (or symbolic linking into) the canonical location preserves certain features of StreamBase Studio. In particular, some of the LiveView samples, and the LiveView demo in the SB Demos perspective, provide launchers for LiveView Desktop that presume Desktop can be found in the canonical location. To be able to use these launchers as provided, install LiveView Desktop in the location suggested by its installer (for Windows and Linux) or use a symbolic link on OS X as described in the OS X installation instructions.

Installing LiveView Desktop on Windows or Linux

On Windows, the installer that you download for LiveView Desktop is an MSI file whose name begins with TIB_sb-lvdt. Run this installer and follow the on-screen instructions. When prompted for the installation location, the installer suggests C:\TIBCO\sb-cep\n.m. Accept this location to install LiveView Desktop in the canonical location as described in the previous section.

On Linux, the LiveView Desktop installer file names also begin with TIB_sb-lvdt, and are provided in both .rpm-bin and .archive-bin formats. Follow the same instructions for each file type provided for the base kit installers on Installing StreamBase on Linux. When prompted for the installation location, accept the suggested default, /opt/tibco/sb-cep/n.m.

Installing LiveView Desktop on Mac OS X

The LiveView Desktop installers for Mac OS X are provided in two formats, DMG and .archive-bin. The installer file names follow these patterns:

  • DMG installer: TIB_sb-lvdt_version_macosx_x86_64.dmg

  • archive-bin installer: TIB_sb-lvdt_version_macosx_x86_64.archive-bin

DMG Installer on OS X

By far the easiest installation method, and the recommended one, is to download and run the DMG installer file. After showing you a license to agree to, the disk image opens on the OS X desktop.

As with the base StreamBase installation, you can drag the entire TIBCO LiveView Desktop n.m.x folder to your personal ~/Applications folder, or to the system /Applications folder, or to any other location. TIBCO recommends installing all StreamBase programs into ~/Applications.

TIBCO recommends dragging the entire TIBCO LiveView Desktop n.m.x folder to your personal ~/Applications folder, and then creating a symbolic link as described in the next section.

It is also possible for you to try to install LiveView Desktop manually into the canonical location under the liveview/desktop folder of your existing StreamBase installation. In this case, you must first manually create the liveview/desktop folder, then drag the contents of the TIBCO LiveView Desktop n.m.x folder from the DMG (not the folder itself) to the new liveview/desktop folder. If your base installation is in the system /Applications folder, doing this runs into permissions issues.

Reconciling Actual and Canonical Locations

Let's say you installed both the StreamBase base kit and LiveView Desktop into your personal ~/Applications folder, as recommended. In this case, in a Terminal session, we can navigate into ~/Applications and list its contents. For example:

cd ~/Applications
ls

Let's say the results are the following:

TIBCO StreamBase 7.6.0/
TIBCO LiveView Desktop 2.1.0/

In this case, all you need is a symbolic link inside the base kit, pointing to the LiveVew Desktop folder. First, navigate into the base kit's folder:

cd TIBCO\ StreamBase\ 7.6.0
ls

The results are:

bin/ etc/     jdk/ liveview/ sample/     sbmanager.app/ sdk/
doc/ include/ lib/ man/      sbstudio.app/

As you see, the base kit already has a liveview folder that contains all LiveView related files. Navigate into that folder:

cd liveview
ls

The results are:

LiveView_README.html contrib/ sample/  tools/
ant/                 lib/     server/

No folder named desktop exists here yet. The canonical location of LiveView Desktop expects a folder named desktop at this location, so we can create a symbolic link to the folder that contains the actual LiveView Desktop installation. Do not link to the LiveView executable itself, only to its containing folder. For example:

ln -s ~/Applications/TIBCO\ LiveView\ Desktop\ 2.1.0  desktop

With this solution, you can run the LiveView Wikipedia demo in Studio's SB Demos perspective without special steps, and the OS X versions of LiveView Desktop launchers provided in several samples all work as designed.

The downside of this solution is that you must recreate the symbolic link with every new maintenance release of the StreamBase base kit.

Archive-Bin Installer on OS X

The archive-bin installer for LiveView Desktop on OS X is based on the Linux archive-bin installer and does not much differ from it. The file consists of a tar.gz installation archive wrapped in a shell script.

The following procedure installs from the installation archive directly into the canonical location under the StreamBase base kit.

  1. If you download the archive-bin installer file using the Safari browser, it adds a .txt extension to the file to protect the system from possibly malicious scripts. First rename the file from its .archive-bin.txt extension, back to the archive-bin extension.

  2. Run this installer from a Terminal session with commands like the following:

    cd ~/Downloads
    sh TIB_sb-lvdt_7.6.0_macosx_x86_64.archive-bin
    
  3. The script checks for a compatible platform and architecture, and warns if you are installing the wrong version for the current platform.

  4. The wrapper script prompts for the path to an installation directory, and proposes the UNIX default, /opt/tibco/sb-cep/n.m. Replace this path with the full, absolute path to your existing StreamBase base kit. The installer script does not recognize environment variable expansion or the tilde (~) shortcut. Specify a full path such as the following:

    /Users/sbuser/Applications/TIBCO StreamBase 7.6.0
    

    There is no need to escape the spaces in the path with backslashes. Do not specify the path to the liveview/desktop subfolder; the archive already contains that path.

  5. The wrapper script displays the text of the StreamBase license agreement. Press Space to page through the license text, or press q (a single lowercase Q) to skip to the end.

  6. The script prompts Do you accept this license agreement? Type yes and press Enter.

  7. The archive installer then extracts and installs the installation files into the specified location.

  8. When done, the script prompts: Installation complete.

Installing LiveView Desktop Workspace Manager

The TIBCO LiveView™ Desktop Workspace Manager allows you to upload and download saved LiveView Desktop workspaces to and from a LiveView Server instance. The Workspace Manager is included as part of your LiveView Desktop license, but it does have a separate installation required.

For the Workspace Manager, there is no canonical location and thus no installation location requirements at all. The Workspace Manager runs from wherever you install it and connects to the LiveView Server instance you specify.

The names of all Workspace Manager installer files follow this pattern:

  • TIB_sb-lvdt_wsmanager_version_platform_arch.extension

For Windows, the installer's default and recommended installation location is in the personal Application Data area of the current user's home directory. This allows separate users of the same Windows machine to have their own copies of the Workspace Manager. The default installation location for Windows is:

C:\Users\sbuser\AppData\Local\Cloud Software Group, Inc.LiveView Workspace Manager n.m\

For Linux, TIBCO provides two installer types for the Workspace Manager, an rpm-bin and a archive-bin. Use these installers in the same way as the ones for the base kit, described in Installing StreamBase on Linux.

On Macintosh OS X, as for LiveView Desktop itself, TIBCO provides both DMG and archive-bin installers, which have filenames that follow these patterns:

  • DMG installer: TIB_sb-lvdt_wsmanager_version_macosx_x86_64.dmg

  • archive-bin installer: TIB_sb-lvdt_wsmanager_version_macosx_x86_64.archive-bin

Run these installers with steps much like the ones for LiveView Desktop itself.