Developers Getting Started With i2b2
Space shortcuts
Space Tools
Skip to end of metadata
Go to start of metadata

Beginning in i2b2 1.7.12, server installation is dramatically simplified. There are now three ways to install:

Quick Install

The quick install is a fully packaged and compiled version of i2b2, complete with Wildfly and all other necessary server components. Download it from the i2b2 software page.  Then, 


  1. Install Java 8 if you missed this step earlier. (see chapter 2.4.1)
  2. Copy the entire wildfly-17.0.1.Final folder to your /opt folder.
    • Linux: cp –r wildfly-17.0.1.Final /opt
    • Windows: xcopy /E wildfly-17.0.1.Final C:\opt
  3. Modify the datasource files for each cell (see subsections on configuring each cell).


Pre-compiled war file install

i2b2 is releasing a pre-compiled server binary as a war file. This file can simply be dropped into the Wildfly directory. Therefore, the steps are nearly the same:

  1. Install all the server pre-requisites in Chapter 2 (including Wildfly and Java 8). 
  2. Download the war file from the i2b2 software page
  3. Copy the war file into the deployments folder (/opt/wildfly-VERSION-Final/standalone/deployments/).
  4. Modify the datasource files for each cell (see subsections on configuring each cell).


Build from source

Developers will want to build i2b2 from source code. Although the legacy documentation for building each cell separately is still available in other sections of this chapter, the process for building a complete war file has been dramatically simplified. 

  1. Build the war from source.
    1. Change directory into the edu.harvard.i2b2.server-common folder.
    2.  Run the ant build command
            ant clean dist war
  2. Copy the i2b2.war from the dist folder to /opt/wildfly-VERSION-Final/standalone/deployments/ .
  3. Modify the datasource files for each cell (see subsections on configuring each cell).


After the build is complete, Wildfly should be started and installation verified. The subsections in this chapter give further details on these steps.

  • No labels