Preparing the installation
Downloading the necessary files
To install i2b2 with the i2b2 Wizard, you need to download the following components:
1. The very latest version of i2b2 Wizard
The recent versions no longer contain a version number but rather a date. Just download the latest one from here: http://community.i2b2.org/repos/i2b2/trunk/related/i2b2Wizard/ZIP%20files/
2. A supported Linux installation disc image
i2b2 Wizard supports different Linux distributions, but using Ubuntu 14.04 (32 bit) is recommended. Download this file: http://releases.ubuntu.com/14.04/ubuntu-14.04.2-desktop-i386.iso
To get an overview of the supported Linux distributions, unzip the i2b2 Wizard file you have just downloaded and have a look at the scripts/os_version directory. This directory contains a script for each supported operating system. If your favourite Linux distribution is not supported, it is possible to create a copy of the most similar available version script with the file name of your desired distribution. We will come to this later.
3. A virtual machine software
We recommend using VirtualBox, which you can download from here: https://www.virtualbox.org/. In this guide, we are using version 4.3.28-100309 on Mac OS X. Just pick the latest version, and also install the VirtualBox additions.
4. The i2b2 files
While the i2b2 Wizard can download most of the necessary files automatically, you have to download some files for i2b2 manually. These are:
- i2b2core-src-XXX.zip (i2b2 Hive source code)
- i2b2createdb-XXX.zip (Boston Demodata)
- i2b2webclient-XXX.zip (i2b2 webclient source code)
Note that XXX is a placeholder for the current version.
You can download them from: https://www.i2b2.org/software/index.html Pick the latest version. i2b2 Wizard is - hopefully - already compatible with the latest version. To get an overview of the supported i2b2 versions, unzip the i2b2 Wizard file you have just downloaded and have a look at the scripts/product_version directory. This directory contains a script for each supported i2b2 version. If your i2b2 version is not included, it is possible to create a copy of the most similar available version script with the file name of your desired distribution. We will come to this later.
Put these files into the packages folder from the i2b2 Wizard installation directory. If you haven't downloaded the files, i2b2 Wizard will automatically ask you to provide a "server path" in a later step. If this URL contains the valid i2b2 source code repository, i2b2 Wizard can download all files automatically. Please note that the suggested download URL is not working because it does not host the i2b2 source files due to i2b2's licensing (the i2b2 team wants you to download the files from their website). This feature is rather ment for organizations to host their own local copy of the i2b2 files, which simplifies the installation of new i2b2 hives with i2b2 Wizard.