Contents
This page provides start and stop instructions for running TIBCO LiveView Server using the Minimal sample.
When a LiveView Server instance starts, its first task is to compile a set of provided configuration specifications into one or more LiveView data tables. On subsequent starts, LiveView Server recompiles only the configuration specifications that have changed, if any.
A LiveView table is a data table with a particular schema that is ready to accept a stream of incoming data and queries. In the absence of the configuration specifications for at least one data table, there is nothing for the LiveView Server to do, and it cannot start.
Thus, to start the LiveView Server even for a simple test requires some configuration. The LiveView installation provides a sample that illustrates the minimal configuration for LiveView, which is just enough to start and run the server. This smallest possible LiveView configuration requires a valid LiveView configuration file to define a data table.
LiveView configuration files are called lvconf files. All lvconf files that constitute a single LiveView project must reside in the same src/main/liveview folder. When you run a LiveView Server instance, you are running the configuration defined in the project folder that contains
your lvconf files.
-
Start StreamBase Studio.
-
Select > from Studio's top-level menu.
-
In the text filter field, enter
minimalto narrow the list of selections. -
Select the sample whose description is
Shows the minimum configuration to start LiveView Serverand press .
The sample loads into Studio with the project name sample_lv-sample-minimal.
Follow the steps below to start LiveView Server running the Minimal sample. These steps apply equally to the Windows and macOS editions of StreamBase Studio.
-
In the Minimal sample's LiveView Project Viewer, click the green button in the upper right corner of the viewer panel, next to the Help button. (
)
-
Studio opens the Console view, and begins to show messages from LiveView Server. After a few minutes, look for a Console view message that says:
{ Server Started } - *** All tables have been loaded. LiveView is ready to accept client connections. ***
As an alternative, you can run a LiveView fragment project from the menu:
-
In the Project Explorer view, select the project's folder,
sample_lv-minimal. -
Right-click and select > from the context menu.
-
Studio opens the Console view. Wait for the
All tables have been loadedmessage.
As a third alternative, you can run a LiveView fragment project with Studio's button:
-
In the Project Explorer view, select the project's folder,
sample_lv-minimal. -
Click the button (
) in Studio's top-level menu bar.
-
This opens the Run As dialog. Select LiveView Project and click .
-
Studio opens the Console view. Wait for the
All tables have been loadedmessage.
Notice that LiveView Server runs in Studio independently of any StreamBase Server run or debug session you might want to run at the same time. The only constraint are the port numbers, which must be different for each running server. You can configure StreamBase Server to automatically try another port if Studio's default port, 10000, is in use by LiveView Server.
You can also run two or more instances of LiveView Server by editing one instance's launch configuration to use different ports.
If you started LiveView Server from StreamBase Studio, stop it by clicking the red and blue square Terminate LiveView Fragment
button (
) in Studio's top-level menu bar.
You can also use the lv-client shutdown command to stop the server. Open a separate terminal window on macOS or a StreamBase Command Prompt on Windows, and enter:
lv-client shutdown
This command as shown presumes that LiveView Server is running on the default StreamBase and LiveView ports. Use the -p or -u options to specify a different port or URL. See lv-client help for more.