Page Comparison

...

Table of Contents

maxLevel	3
minLevel	3
style	border:1
separator	pipe

Tip

title	Before you begin

You need to set

Set up the database as explained in Setting up Embedded H2

before

.
Download the H2 database driver and copy it to WSO2 IoT Server by following the steps

to configure your product with it. For more information, see

under Setting up

Embedded H2

drivers.

Setting up configuration files

...

Following are the datasource configuration properties:

Property	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.
minIdle	The minimum number of active connections that can remain idle in the pool, without extra ones being created, or enter zero to create none.
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.

Info
For more information on other parameters that can be defined in the datasource `xml` file, see Tomcat JDBC Connection Pool.

...

The default datasource configuration is defined in the master-datasources.xml file, located in the <IoTS_HOME>/conf/datasources/ directory. The database configurations in registry.xml and user-mgt.xml refer to the WSO2_CARBON_DB datasource.

Info
Edit the `WSO2_CARBON_DB`, `WSO2_MB_STORE_DB` and `WSO2AM_DB` datasources in the `master-datasources.xml` file by replacing the `url`, `username`, `password` and `driverClassName` settings with your custom values and also the other values accordingly.

Code Block

title	WSO2_Carbon_DB Datasource

<datasource>
   <name>WSO2_CARBON_DB</name>
   <description>The datasource used for registry and user manager</description>
   <jndiConfig>
      <name>jdbc/WSO2CarbonDB</name>
   </jndiConfig>
   <definition type="RDBMS">
      <configuration>
         <url>jdbc:h2:repository/database/WSO2CARBON_DB;DB_CLOSE_ON_EXIT=FALSE;LOCK_TIMEOUT=60000</url>
         <username>wso2carbon</username>
         <password>wso2carbon</password>
         <driverClassName>org.h2.Driver</driverClassName>
         <maxActive>50</maxActive>
         <maxWait>60000</maxWait>
         <minIdle>5</minIdle>
         <testOnBorrow>true</testOnBorrow>
         <validationQuery>SELECT 1</validationQuery>
         <validationInterval>30000</validationInterval>
      </configuration>
   </definition>
</datasource>

Code Block

title	WSO2_MB_STORE_DB Datasource

<datasource>
   <name>WSO2_MB_STORE_DB</name>
   <description>The datasource used for message broker database</description>
   <jndiConfig>
      <name>jdbc/WSO2MBStoreDB</name>
   </jndiConfig>
   <definition type="RDBMS">
      <configuration>
         <url>jdbc:h2:repository/database/WSO2MB_DB;DB_CLOSE_ON_EXIT=FALSE;LOCK_TIMEOUT=60000</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>
         <defaultAutoCommit>false</defaultAutoCommit>
      </configuration>
   </definition>
</datasource>

Code Block

title	WSO2AM_DB Datasource

<datasource>
   <name>WSO2AM_DB</name>
   <description>The datasource used for API Manager database</description>
   <jndiConfig>
      <name>jdbc/WSO2AM_DB</name>
   </jndiConfig>
   <definition type="RDBMS">
      <configuration>
         <url>jdbc:h2:repository/database/WSO2AM_DB;DB_CLOSE_ON_EXIT=FALSE</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>

Configure the WSO2_ANALYTICS_EVENT_STORE_DB and WSO2_ANALYTICS_PROCESSED_DATA_STORE_DB datasources in the analytics-datasources.xml, located in the file <IoTS_HOME>/analytics/repository/conf/datasources directory.

Info
Edit the `WSO2_ANALYTICS_EVENT_STORE_DB` and `WSO2_ANALYTICS_PROCESSED_DATA_STORE_DB` datasources in the `analytics-datasources.xml` file by replacing the `url`, `username`, `password` and `driverClassName` settings with your custom values and also the other values accordingly.

Code Block

title	WSO2_ANALYTICS_EVENT_STORE_DB Datasource

<datasource>
   <name>WSO2_ANALYTICS_EVENT_STORE_DB</name>
   <description>The datasource used for analytics record store</description>
   <definition type="RDBMS">
      <configuration>
         <url>jdbc:h2:repository/database/ANALYTICS_EVENT_STORE;AUTO_SERVER=TRUE;DB_CLOSE_ON_EXIT=FALSE;LOCK_TIMEOUT=60000</url>
         <username>wso2carbon</username>
         <password>wso2carbon</password>
         <driverClassName>org.h2.Driver</driverClassName>
         <maxActive>50</maxActive>
         <maxWait>60000</maxWait>
         <validationQuery>SELECT 1</validationQuery>
         <defaultAutoCommit>false</defaultAutoCommit>
         <initialSize>0</initialSize>
         <testWhileIdle>true</testWhileIdle>
         <minEvictableIdleTimeMillis>4000</minEvictableIdleTimeMillis>
      </configuration>
   </definition>
</datasource>

Code Block

title	WSO2_ANALYTICS_PROCESSED_DATA_STORE_DB Datasource

<datasource>
   <name>WSO2_ANALYTICS_PROCESSED_DATA_STORE_DB</name>
   <description>The datasource used for analytics record store</description>
   <definition type="RDBMS">
      <configuration>
         <url>jdbc:h2:repository/database/ANALYTICS_PROCESSED_DATA_STORE;AUTO_SERVER=TRUE;DB_CLOSE_ON_EXIT=FALSE;LOCK_TIMEOUT=60000</url>
         <username>wso2carbon</username>
         <password>wso2carbon</password>
         <driverClassName>org.h2.Driver</driverClassName>
         <maxActive>50</maxActive>
         <maxWait>60000</maxWait>
         <validationQuery>SELECT 1</validationQuery>
         <defaultAutoCommit>false</defaultAutoCommit>
         <initialSize>0</initialSize>
         <testWhileIdle>true</testWhileIdle>
         <minEvictableIdleTimeMillis>4000</minEvictableIdleTimeMillis>
      </configuration>
   </definition>
</datasource>

Configure the the WSO2_METRICS_DB datasource in the metrics-datasources.xml file, located in the file <IoTS_HOME>/conf/datasources directory.

Info
Edit the `WSO2_METRICS_DB` datasources in the `metrics-datasources.xml` file by replacing the `url`, `username`, `password`, and `driverClassName` settings with your custom values and also the other values accordingly.

Code Block

title	WSO2_METRICS_DB Datasource

<datasource>
   <name>WSO2_METRICS_DB</name>
   <description>The default datasource used for WSO2 Carbon Metrics</description>
   <jndiConfig>
      <name>jdbc/WSO2MetricsDB</name>
   </jndiConfig>
   <definition type="RDBMS">
      <configuration>
         <url>jdbc:h2:repository/database/WSO2METRICS_DB;DB_CLOSE_ON_EXIT=FALSE;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>
         <defaultAutoCommit>true</defaultAutoCommit>
      </configuration>
   </definition>
</datasource>

Configure the the DM_DS datasource in the cdm-datasources.xml file located in the <IoTS_HOME>/conf/datasources directory.

Info
Edit the `DM_DS` datasources in the `cdm-datasources.xml` file by replacing the `url`, `username`, `password` and `driverClassName` settings with your custom values and also the other values accordingly.

Code Block

title	DM_DS Datasource

<datasource>
   <name>DM_DS</name>
   <description>The datasource used for CDM</description>
   <jndiConfig>
      <name>jdbc/DM_DS</name>
   </jndiConfig>
   <definition type="RDBMS">
      <configuration>
         <url>jdbc:h2:repository/database/WSO2DM_DB;DB_CLOSE_ON_EXIT=FALSE</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>

Configure all the device plugin datasources by editing the <PLUGIN_NAME>-datasources.xml file of the respective plugin by replacing the url, username, password and driverClassName settings with your custom values and also the other values accordingly.

Code Block

title	Example: Android plugin datasource

<datasource>
    <name>Android_DB</name>
    <description>The datasource used as the Android Device Management database</description>
    <jndiConfig>
        <name>jdbc/MobileAndroidDM_DS</name>
    </jndiConfig>
    <definition type="RDBMS">
        <configuration>
            <url>jdbc:h2:repository/database/WSO2MobileAndroid_DB;DB_CLOSE_ON_EXIT=FALSE
            </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>

...

You can create the database tables manually by executing the H2 script in the shell or web console:

Database	DB Script name and Location
`WSO2_CARBON_DB`	`<IoTS_HOME>/dbscripts//h2.sql`
`WSO2AM_DB`	`<IoTS_HOME>/dbscripts//apimgt/h2.sql`
`WSO2_MB_STORE_DB`	`<IoTS_HOME>/wso2/broker/dbscripts/mb-store/h2.sql`
`WSO2_ANALYTICS_EVENT_STORE_DB`


`WSO2_ANALYTICS_PROCESSED_DATA_STORE_DB`


`WSO2_METRICS_DB`	`<IoTS_HOME>/dbscripts//metrics/h2.sql`
`DM_DS`	`<IoTS_HOME>/dbscripts//cdm/h2.sql`
Device plugin databases Example: `Arduino_DB`	`<IoTS_HOME>/dbscripts//cdm/plugins/<PLUGIN_NAME>/h2.sql` Example: `<IoTS_HOME>/dbscripts//cdm/plugins/android/h2.sql`

Follow the steps below to run the H2 script in web console:

...

Versions Compared

Old Version 7

New Version Current

Key

Setting up configuration files