Contents of a LiveView Project

The LiveView projects for integration with TIBCO Service Performance Manager must be organized in a hierarchical folder structure.

The folder structure must contain the following artifacts:

  • SPMDataPublisher/SPMDataPublisher.sbapp: The main application file that connects the Enterprise Message Service input/output ports, and provides basic configurable parameters for integrating TIBCO Service Performance Manager with LiveView
  • *.lvconf files: The files responsible for generating data tables in LiveView
  • sbd.sbconf: The XML configuration file for the StreamBase server to provide project-specific jar file dependencies, JVM settings, and other properties. For more information, see The sbd.sbconf Configuration File.
  • lv-interfaces: The directory that contains the *.sbint files
  • lv-systemdata: The directory containing a pre-configured dashboard files to be viewed in the LiveView Desktop
  • <SPM_Schema_File>.xml: The SPM schema file for each project
  • spm-liveview-config.properties: The configuration properties file for advanced configuration of the SPM client
  • LV_SPM_Logback.xml: The logging configuration for the LiveView project
  • DataPurge/DataPurge.sbapp: The purging application that gets rid of the old data to make space for new streaming data. For more information, see DataPurge Application.
    Note: You can see the project artifacts in any LiveView project sample located at SPM_HOME/spm/2.2/adapters/liveview/lv-examples.

    The sbd.sbconf Configuration File

The sbd.sbconf file is an XML configuration file for the StreamBase server to provide project-specific jar file dependencies, JVM settings, and other properties. The <java-vm> settings in sbd.sbconf contain various configuration options, such as:

  • <sysproperty>: provides properties, such as liveview.port, email alert properties, custom properties, and so on
  • <jar>: specifies jar file dependencies for the project. A LiveView integration project needs the following jar file dependencies:
    • Spmdatapublisher.jar: The generic LiveView integration adapter jar file
    • SPM Client API jars: rtcommon.jar, rtclient.jar
    • Jars related to Enterprise Message Service: tibcrypt.jar, tibjms.jar
    • Log4j jar
    • Jars for the adapter for LiveView (required for the DataPurge application):
      <STREAMBASE_HOME>/lib/adapter/sb-lv-adapter.jar
      <STREAMBASE_HOME>/lib/ext/sb-adapter-common.jar

      DataPurge Application

All the LiveView projects include a StreamBase application, named DataPurge. The database tables in the sample projects keep growing due to the continuously streaming data. This requires opening up memory or storage space frequently by periodically deleting older data. The application has a timer to invoke the LiveView Delete Operator, which deletes the older data at regular intervals.

By default, purging is invoked every 24 hours, that is every 86400 seconds. Data of two weeks, that is 14 days or 1209600 seconds, is retained.

You can add following properties to DataPurge.lvconf to tune the purging feature:

  • <parameter name="period" value="<seconds>"/> to set the time period to trigger the purging
  • <parameter name="retention" value="<seconds>"/> to set the time period of data retention