Step 6: CRC Loader properties: Configure data source lookup

During the hivedata installation one of the tables created was the CRC_DB_LOOKUP table. The CRC Loader needs to communicate with this table and in order to do this we need to tell it where to find the Hivedata tables. During this step we will define the properties for JDBC connection and the data source lookup in the following CRC Loader configuration files.

CRCLoaderApplicationContext.xml
edu.harvard.i2b2.crc.loader.properties (should still be open from previous section)

Prerequisite

You need to know the location of your Hivedata tables. These are owned by the PM cell.

Things to keep in mind when configuring the data sources in CRCLoaderApplicationContext.xml:

The following properties need to be updated or verified that they are set correctly for your environment:

"driverClassName"

make sure the jdbc driver is correct for the type of database you are connecting to

"url"

verify the jdbc is correct for your type of database
The correct location the database that has your hivedata tables

"username" and "password"

needs to match the database user you setup for your hivedata. In the i2b2 demo database this is i2b2hive and demouser.

Steps to update data sources in CRCLoaderApplicationContext.xml

These steps include example configurations for Oracle, PostgreSQL and SQL Server.

1. The CRCLoaderApplicationContext.xml file is located in the following directory:

YOUR_I2B2_SRC_DIR\i2b2\edu.harvard.i2b2.crc\etc\spring\

The location shown above is written for Windows. If you are on a Linux machine the slashes in the path name need to be changed.

Linux Path: use a forward slash.
Windows Path: use a backward slash.

EXAMPLES:

Linux Path: /opt/edu.harvard.i2b2.crc/etc/spring/

Windows Path: C:\opt\data\edu.harvard.i2b2.crc\etc\spring\

2. Open the CRCLoaderApplicationContext.xml file to configure the data source for the CRC Loader

Oracle Database

<bean id="CRCBootstrapDS" class="org.apache.commons.dbcp.BasicDataSource"
	destroy-method="close">
	<property name="driverClassName" value="oracle.jdbc.driver.OracleDriver" />
	<property name="url" value="jdbc:oracle:thin:@localhost:1521:XE" />
	<property name="username" value="i2b2hive" />
	<property name="password" value="demouser" />
</bean>

PostgreSQL Database

<bean id="CRCBootstrapDS" class="org.apache.commons.dbcp.BasicDataSource"
	destroy-method="close">
	<property name="driverClassName" value=" org.postgresql.Driver " />
	<property name="url" value="jdbc:postgresql://localhost:5432/i2b2" />
	<property name="username" value="i2b2hive" />
	<property name="password" value="demouser" />
</bean>

SQL Server Database

<bean id="CRCBootstrapDS" class="org.apache.commons.dbcp.BasicDataSource"
	destroy-method="close">
	<property name="driverClassName" value="com.microsoft.sqlserver.jdbc.SQLServerDriver" />
	<property name="url" value="jdbc:sqlserver://localhost:1433" />
	<property name="username" value="i2b2hive" />
	<property name="password" value="demouser" />
</bean>

3. Save the changes and close the file.

Steps to update data sources in edu.harvard.i2b2.crc.loader.properties

These steps include example configurations for Oracle, PostgreSQL and SQL Server.

1. Go to the edu.harvard.i2b2.crc.loader.properties file you still have opened from earlier.

2. Scroll to the section called Datasource Lookup info.

3. Set the Datasource Lookup information to reflect the information you entered previously in the CRCLoaderApplicationContext.xml file.

Oracle Configuration

edu.harvard.i2b2.crc.loader.ds.lookup.datasource=CRCBootsrapDS

edu.harvard.i2b2.crc.loader.ds.lookup.servertype=ORACLE

edu.harvard.i2b2.crc.loader.ds.lookup.schemaname=i2b2hive

PostgreSQL Configuration

edu.harvard.i2b2.crc.loader.ds.lookup.datasource=CRCBootsrapDS

edu.harvard.i2b2.crc.loader.ds.lookup.servertype=PostgreSQL

edu.harvard.i2b2.crc.loader.ds.lookup.schemaname=i2b2hive

SQL Server Configuration

edu.harvard.i2b2.crc.loader.ds.lookup.datasource=CRCBootsrapDS

edu.harvard.i2b2.crc.loader.ds.lookup.servertype=SQLServer

edu.harvard.i2b2.crc.loader.ds.lookup.schemaname=i2b2hive.dbo

4. Save the changes and close the file.