---
title: WORK Data Source Configuration
description: "# Step 6: Configure the data sources for the Workplace Cell The Workplace cell needs to communicate with your **i2b2 database** and in order to do this it needs to know where the tables for the **workdata** and **hivedata** reside.…"
url: "https://i2b2.org/docs/work-data-source-configuration/"
updated: "2026-09-15"
category: i2b2 Installation Guide / Chapter 4. Server Install Guide / A. Server Install on 1.7.12 and higher / 2. Data Source Configuration
---

# WORK Data Source Configuration

# Step 6: Configure the data sources for the Workplace Cell

The Workplace cell needs to communicate with your **i2b2 database** and in order to do this it needs to know where the tables for the **workdata** and **hivedata** reside. Therefore the **sixth** and **final step** in the cell configuration process is to configure the data sources for the Workplace Cell. This information is configured in the **work-ds.xml** file.

### Things to keep in mind when configuring your datasources:

- The **workdata** and **hivedata** tables were created during the chapter on Data Installation.

- The **WorkplaceDemoDS** points to the data source for your workdata tables.
  - The  and  need to match the database user you set up for your workdata. In the i2b2 demo database this is *i2b2workdata* and *demouser*.

- The **WorkplaceBootStrapDS** points to the data source for your WORK_DB_LOOKUP table which is a hivedata table.
  - The  and  need to match the database user you set up for your hivedata. In the i2b2 demo database this is *i2b2hive* and *demouser*.

- The  needs to have the following:
  - The correct JDBC information for your type of database.
  - The correct location of the database containing your workdata or hivedata tables. *(These may or may not reside in the same location)*

- Both the  and  need to accurately reflect the type of database you are connecting to.

### Steps to configure data sources

The following steps define how to configure your data sources for the Workplace Cell. These steps include example configurations for Oracle, PostreSQL and SQL Server.

1. The **work-ds.xml** file is located in the following directory:

***YOUR_I2B2_SRC_DIR***\edu.harvard.i2b2.workplace\etc\jboss

2. Open the work-ds.xml file to configure your data sources. *(see examples shown below)*

##### Oracle Database Configuration

##### PostgreSQL Database Configuration

##### SQL Server Database Configuration

3. If your environment has multiple projects pointing to different data sources then copy the  section for each project data source.

4. Update the **jndi-name** and **pool-name** to reflect the name of the second project .

***Example:***   A second project called Demo2 would have the following entry:

##### Second Data Source Configuration

Note

The above example is for an Oracle database. If your database is SQL Server or PostgreSQL then you will need to copy the  section for your type database connection. Do not use this one as it will not work.

5. Save the changes and close the file.
