LiveView has several customizations for logging, port usage, and authentication.
LiveView Server uses an internal default StreamBase Server configuration file (an sbconf file) that is maintained internally and should never be manually edited.
Instead, to manage LiveView Server configuration settings, place an sbconf file named
sbd.sbconf at the root of your Studio project directory and place your settings there. This project-specific sbconf file is automatically
merged with the internal LiveView Server configuration settings such that valid project-specific settings take precedence.
If the Automatically update/maintain server configuration files option (on the page), then Studio creates and maintains three server configuration files per project:→ settings for your LiveView project specify the
sbd.sbconf— For environment-specific settings, primarily used when running this project at the command prompt.
sbd-common.sbconf— For settings common to both command-line and Studio environments.
sbd-studio.sbconf— For settings specific to running projects in Studio, including module search path, resource search path, and Java path settings. This file is automatically maintained by Studio; do not edit or change this file manually.
sbd.sbconf file is still the top-level configuration file, because it includes the other two files. If your LiveView project has all
three server configuration files, make your LiveView-specific edits in the top-level
sbd.sbconf file, or in
sbd-common.sbconf. For LiveView projects, these project-specific settings are still automatically merged with the internally-maintained LiveView
server configuration settings.
See StreamBase Logging in the StreamBase documentation for a full explanation of server logging settings. For LiveView, system
logging is controlled by a configuration file. These files are by default installed in the
$STREAMBASE_HOME/liveview/server/engine/conf folder. The available logging configuration files are:
Default logging setting.
Enable verbose logging. This setting enables LVDEBUG messages to view detailed information on queries submitted to LiveView Server.
Enable verbose debug for alert functionality.
Enable logging of all debugging, including all StreamBase debugging. This setting enables verbose logging for both LiveView Server and the underlying StreamBase Server for multi-layered issues.
By default, LiveView uses logback for logging. You can change the logging configuration by setting the environment variable
STREAMBASE_LIVEVIEW_LOG equal to the name of one of the preconfigured log files. For example setting
STREAMBASE_LIVEVIEW_LOG=LVDebugLogback.xml will set LiveView Server logging to the verbose level.
LiveView logging settings work in tandem with StreamBase Server logging. Depending on your server configuration settings, you might overwrite one set of logging configurations with another. See the TIBCO StreamBase Administration Guide's article on StreamBase Logging for more information on background mode logging settings.
When launching a LiveView application from the command line or from StreamBase Studio, you might receive warnings like:
MemoryConfigTooLow - Maximum heap size configured to be 3,204 MB, which is below recommended size for LiveView production configurations
To avoid such warnings, you can specify a minimum JVM heap size for which the warnings are issued in your configuration file by setting the system property liveview.lvmonitor.min.heapmb in your .lvconf file, as follows:
<sysproperty name="liveview.lvmonitor.min.heapmb" value="2000"/>
Specify the property value in megabytes. In the above example, you would only receive the warnings if the heap size is under 2 GB, which is usually not sufficient for running typical applications.
You can put the property in a new configuration file that links to an existing lvconf. For instructions, see Creating New LiveView Configuration Files.
A running LiveView instance uses two ports. Each LiveView instance requires two TCP ports: one for server processes (streambase-port) and one for client connections (liveview-port). By default, these port numbers are 10000 and 10080. When you start a LiveView project, both ports are in use. There are three ways that you can change the port numbers for a server process:
Start the server with the command-line client lv-server and use the --streambase-port and --liveview-port options. The is option supersedes all other options. For example, the following lv-server command would start a project named
liveview-projecton ports 10001 and 10081:
lv-server run --streambase-port 10001 --liveview-port 10081
Use the sbd.sbconf file to set the system properties
liveview.port. This option supersedes the environment variable option in (3).
To specify port numbers in an sbd.sbconf, set the following options:
sbd.sbconf, add the
<server> <param name="tcp-port" value="
<java-vm>element, add the
liveview.portsystem property (whose value should differ from that of the
<java-vm> <sysproperty name="liveview.port" value="
different-new-port-value" /> </java-vm>
If you are running from StreamBase Studio, edit the ports as follows:
Right-click on a project folder, or on any of the lvconf files for a project, and select External Tools Configurations dialog.→ . This opens the
In the Options pane, set the port numbers.
Set the environment variables liveview.streambase.connection.pool.port and liveview.port. This option will be overridden by either option (1) or option (2).
By default, when you run a LiveView project, LiveView creates an lv-bin directory for generated project files and an lv-systemdata directory for generated project data. (These directories are hidden by default; you can change the default view with the Project Explorer filters.) You can add a system property to the project sbconf file (liveview.project.out) that defines a writable folder for files and metadata that LiveView Server generates:
<sysproperty value="..\out" name="liveview.project.out"/>
The value of this property can be an absolute or relative path. If it is a relative path, it will be appended to the liveview.project.home. If the specified folder is not writable, LiveView throws an exception. LiveView Server redirects all generated files and metadata to this path.
The lv-bin folder is written under the specified folder (for example, ..\out\lv-bin). If this property is not specified, the output folder is assumed to be the project home (lv-bin is then created in \project_home\lv-bin.) The the project_home folder is not writable, the compiler first tries the user's folder and then tries the temp folder. This information is logged. If LiveView cannot find a writable folder, it throws an exception.
If only 'sysproperty name="liveview.project.out"...' is set, SB/LV writes lv-bin and lv-systemdata to the lv.project.out directory.
If both 'sysproperty name="liveview.project.out"...' and 'sysproperty name="liveview.systemdata.directory"...' are set, lv-bin goes into lv.project.out and lv-systemdata goes in lv.systemdata.directory.
If only 'sysproperty name="liveview.systemdata.directory"...' is set, lv-bin goes in the project workspace and lv-systemdata goes in lv.systemdata.directory.