The IDRT Import and Mapping Tool (IMT) is a client application designed to run on your local machine. It doesn't need administrator's privileges. It is available for Windows (XP/Vista/7/8) and Linux. Up to 2 GB free disk space are used temporarily.
It requires Java 7 (either runtime or standard edition) to be installed.
Because it operates on the i2b2 database directly rather then using the i2b2 Web Service API, you need a physical connection to that database. This includes network access to the database server (check your firewall when in doubt), a JDBC database driver (for PostgreSQL, it is supplied within the tool) and a database account that was granted the right to write to the required i2b2 project tables. If you used the i2b2 wizard to create a project, you already provided the credentials.
In cases of problems, download and install DbVisualizer Free, then try to create a database connection with the same values as entered in the IMT. DbVisualizer is also a Java application that uses JDBC for database connection. It allows to ping the server and its (read) permissions on connect.
If problems persist with DbVisualizer, it is most likely an issue outside the scope of the IMT.
Installation and Configuration
Download the zip file suitable for your operating system and extract it into a program folder.
Loading and transforming large amounts of data might require more memory than Java is able to allocate by default. It is recommended to assign additional memory by editing the configuration file IMT.ini and set:
- Initial memory allocation (Default: -Xms512m)
- Maximum memory allocation (Default: -Xmx1024m)
to higher values.
Finally, run IDRT IMT.exe (Windows) or IDRT IMT (Linux).