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.

Note: The Live Datamart plugin for TIBCO BusinessEvents is required for LiveView agent, and is available only in the TIBCO BusinessEvents Enterprise edition.
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.
    1. Click Add to add an entity filter configuration.
    2. In the Entity Uri field, click the Browse icon and select the supported entity as per your requirement. Click OK.
    3. In the Entity Filter field, specify a query to filter out the entity based on your requirement. For example,
      • Entity Uri - /Concepts/Account
      • Entity Filter - Balance > 10000

      specifies to send the Account concept to the publisher only when the Balance is greater than 10000.

      If this field is empty, then all instances of the entity are pushed to the Live Datamart server.

    Note: The supported entities are Concept, Metrics, and Events.
    Generate Liveview Files Select the check box to generate the LiveView configuration (.lvconf) files at the location specified in the Ouput 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.
  8. Save the project.