IDRT - Integrated Data Repository Toolkit
Space shortcuts
Space Tools
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

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 If this version is no longer available, just 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/i2b2_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.

Copying the files to the Linux server

Now copy all files with SFTP to the Ubuntu machine. On Windows, you can use WinSCP (http://winscp.net), on a Mac the program Cyberduck (http://www.cyberduck.ch) or the excellent MacFusion (http://www.macfusionapp.org).
    
To connect to your virtual machine, use the "Host-Only-Adapter". The "Host-Only-Adapter" is the interface with the 192.168.56.-IP. You can use the command *ifconfig to find out the IP.
    
It is highly recommended to create a "snapshot" of your VirtualBox virtual machine before running the i2b2 Wizard.

  • No labels