Monitoring a BPMN Process with WSO2 DAS

This section provides instructions on how to monitor and publish completed BPMN process and task instances to the WSO2 Data Analytics Server (DAS) from the WSO2 Business Process Server (BPS). To publish data from BPS to DAS, the thrift or binary protocol is used. 

Configure WSO2 Data Analytics Server (DAS)

1. Download WSO2 DAS 3.0.1. 

2. Apply an offset of 2 to the default DAS port by editing the <Offset> element in the <DAS_HOME>/repository/conf/carbon.xml file.

   <Offset>2</Offset>

   This increments all ports used by the server by 2, which means the DAS server will run on port 9445. Port offset is used to increment the default port by a given value. It avoids possible port conflicts when multiple WSO2 products run on same host.

3. WSO2 DAS uses Spark engine to analyze the data. All definitions about the data published from WSO2 Business Process Server and the way it should be analyzed using Spark are shipped to WSO2 DAS as a .car file. To configure data streams, event receivers, event store and spark script for DAS follow these four steps:
1. Download the PC_Analytics.car file.
2. Start the WSO2 DAS server and login to the Management Console.
3. Click Carbon Applications>Add section under the Manage menu. 
4. Select the above PC_Analytics.car file you just downloaded and upload it.

Configure WSO2 Business Process Server

1. Start the Business Process Server and log in to the Management Console (https://<Server Host>:9443/carbon/admin/login.jsp).

2. Click BPMN Data Publisher under the Configure menu.
   

3. Fill the Publisher Configuration section according to the correct DAS (Data Analytics Server) instance server configuration using the table below as a guide and click Save. An example is provided below.  

   Field	Description
   Thrift URL	Use for non-secure data transmission (ex: tcp://localhost:7613)
   Thrift SSL URL	Use for secure data transmission (ex: ssl://localhost:7713)
   Username/Password	Credentials to be established a connection with DAS instance
   Type	Protocol type (Default, Thrift, Binary)
   Enable	If true, then enable publishing feature to the tenant.

   

4. To enable the data publisher component at runtime, change the value of the <dataPublishingEnabled> true in the activiti.xml file found in the <BPS_HOME>/repository/conf directory. 
   

   <bean id="bpmnDataPublisherConfiguration">
   	<property name="dataPublishingEnabled" value="true"/>
   </bean>

5. Restart the BPS server to save the changes. 

6. Deploy BPMN samples to the BPS and complete them according to the relevant users.

7. Click Data Explorer under Interactive Analytics to see the published data on DAS.