Adding a LiveView Agent to the BusinessEvents Project

By using the LiveView agent you can connect the TIBCO BusinessEvents project to the TIBCO Live Datamart server.

The LiveView agent is added to a processing unit similar to how other agents are added to the processing unit. The LiveView agent joins the cluster as leech and only to those spaces which are configured to publish data to the Live DataMart server.
Note: Ensure that in the CDD file, under the Cluster tab the Store Properties As Individual Fields check box is selected for the Object Management: [Cache] configuration. If this check box is not selected then the values of all the fields in the Live DataMart table are null.

Procedure

  1. In the BusinessEvents Studio, open the project CDD file for editing.
  2. In the Agent Classes tab, click Add Agent.
  3. Provide a Agent Class Name and select LiveView as Agent Class Type. Click OK.
    The new LiveView agent is listed under the Agent Classes. The LiveView agent has the LDM Connection Configuration and Entity Filter Configurations listed under it.
  4. Under the Agent Classes list, select the LiveView agent and provide values for the configurations.
    See CDD Agent Classes Tab Settings Reference for more details on the configurations.
  5. Select LDM Connection Configuration and provide values for the following configurations.
    Configuration Description
    LDM Url Specify URL of the TIBCO Live Datamart server.
    User Name User name for the TIBCO Live Datamart server.
    Password Password for the User Name.
    Initial Size Specify the initial size of the connection pool.
    Max Size Specify the maximum size of the connection pool.
  6. Select Entity Filter Configurations and provide values for the following configurations.
    Configuration Description
    Entity Filter Configurations Specify entities which you want to display in the LiveView dashboard. You can also specify a filter to select only those instances which qualifies the filter.

    For more information on adding a new filter and its configurations, see Adding Entity Filter Configurations for the LiveView Agent.

    Generate Liveview Files Select the check box to generate the LiveView configuration (.lvconf) files at the location specified in the Output Directory.
    Output Directory Specify the folder where the LiveView configuration (.lvconf) files are stored after generation.

    You can provide this location while starting the Live Datamart server to load the project data directly into the server.

  7. In the Processing Units tab, select the processing unit under which you want to add the LiveView agent. Under the Agents section, click the Add icon and select the newly created LiveView agent and click OK.
    Note: You must add the LiveView agent in a different processing unit than the inference agent. BusinessEvents TransformerFactory might get mixed up with LiveView client API when both the agents: LiveView agent and inference agent, are in the same processing unit. In such case, an error is published in the BusinessEvents logs. This is a harmless error as no data is missed-out in LiveView. To avoid this error, place the LiveView agent and the inference agent in different processing units.
  8. Save the project.