WSO2 BAM Datasource

The WSO2BAM_DATASOURCE, which is defined in the <PRODUCT_HOME>/repository/conf/bam-datasources.xml file is used to store the results of a Hive analysis job of BAM, to a RDBMS.

To point BAM to a RDBMS, you need to edit the default datasource configuration defined as shown below in the bam-datasources.xml file.

Replace the url, username, password and driverClassName settings with your custom values and also the other values accordingly in the bam-datasources.xml file as shown in the below example.

<datasource>
			<name>WSO2BAM_DATASOURCE</name>
			<description>The datasource used for analyzer data</description>
			<definition type="RDBMS">
				<configuration>
					<url>jdbc:h2:repository/database/samples/BAM_STATS_DB;AUTO_SERVER=TRUE</url>
					<username>wso2carbon</username>
					<password>wso2carbon</password>
					<driverClassName>org.h2.Driver</driverClassName>
					<maxActive>50</maxActive>
					<maxWait>60000</maxWait>
					<testOnBorrow>true</testOnBorrow>
					<validationQuery>SELECT 1</validationQuery>
					<validationInterval>30000</validationInterval>
				</configuration>
			</definition>
		</datasource>

The datasource configuration options are as follows:

Parameter	Description
`url`	The URL of the database.
`username`	The name of the database user.
`password`	The password of the database user.
`driverClassName`	The class name of the database driver.
`maxActive`	The maximum number of active connections that can be allocated from this pool at the same time, or enter a negative value for no limit.
`maxWait`	The maximum number of milliseconds that the pool will wait (when there are no available connections) for a connection to be returned before throwing an exception. You can enter zero or a negative value to wait indefinitely.
`testOnBorrow`	The indication of whether objects will be validated before being borrowed from the pool. If the object fails to validate, it will be dropped from the pool, and another attempt will be made to borrow another.
`validationQuery`	The SQL query that will be used to validate connections from this pool before returning them to the caller.
`validationInterval`	The indication to avoid excess validation, and only run validation at the most, at this frequency (time in milliseconds). If a connection is due for validation, but has been validated previously within this interval, it will not be validated again.

Setting up the drivers

Follow the steps below to set up the drivers for WSO2 BAM datasource.

Download the driver JAR file of the respective RDBMS type.
Copy the driver JAR file to the <PRODUCT_HOME>/repository/components/lib/ directory.

Include the folder path of the RDBMS driver JAR file within the Hive auxiliary JAR properties in the <PRODUCT_HOME>/repository/conf/advanced/hive-site.xml (on Linux) as shown below. Windows users must use the <BAM_HOME>/repository/conf/advanced/hive-site-win.xml file instead.

<property>
    <name>hive.aux.jars.path</name>
    <value>file://${CARBON_HOME}/repository/components/plugins/apache-cassandra_1.1.3.wso2v2.jar,
           file://${CARBON_HOME}/repository/components/plugins/guava_12.0.0.wso2v1.jar,
           file://${CARBON_HOME}/repository/components/plugins/json_2.0.0.wso2v1.jar,
           file://${CARBON_HOME}/repository/components/plugins/commons-dbcp_1.4.0.wso2v1.jar,
           file://${CARBON_HOME}/repository/components/plugins/commons-pool_1.5.6.wso2v1.jar,
           file://${CARBON_HOME}/repository/components/lib/mysql-connector-java-5.1.23-bin.jar
   </value>
   </property>

Restart the server.