Contents
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:
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 macOS 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 macOS and Linux
On all three platforms, LiveView Desktop 2.x and later installs a private copy of an Oracle Java 8 JRE 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.
LiveView Desktop on macOS 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.
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 macOS, LiveView Desktop is installed either in a user-determined location (when using the DMG installer), or in /opt/tibco
, when using the .archive-bin
installer. See the macOS 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 provide launchers for LiveView Desktop that presume Desktop can be found in the canonical location. This also applies to the LiveView demo in the SB Demos perspective.
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 macOS as described in the macOS installation instructions.
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\
. Accept this location to install LiveView Desktop in the canonical location as described in the previous section.
n.m
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
The LiveView Desktop installers for macO 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
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 macOS 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.
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 LiveView 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 macOS 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.
The archive-bin
installer for LiveView Desktop on macOS 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.
-
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 thearchive-bin
extension. -
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
-
The script checks for a compatible platform and architecture, and warns if you are installing the wrong version for the current platform.
-
The wrapper script prompts for the path to an installation directory, and proposes the UNIX default,
/opt/tibco/sb-cep/
. 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:n.m
/Users/
sbuser
/Applications/TIBCO StreamBase 7.6.0There 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. -
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.
-
The script prompts Do you accept this license agreement? Type
yes
and press Enter. -
The archive installer then extracts and installs the installation files into the specified location.
-
When done, the script prompts: Installation complete.
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\TIBCO Software Inc\LiveView Workspace Managern.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 macOS, 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.