Extending and Customizing XNAT with Modules - Rick Herrick

Presentation

Day 2 Session 1 Configuration and Customization

Resources

The primary user account on the virtual machine is xnat. The password for all users on the virtual machine is xnat2012.

The NIH Stroke Scale is now available on the XNAT Marketplace: https://marketplace.xnat.org/plugin/nih-stroke-scale

The build.properties file is located on the virtual machine in the folder /opt/xnat/xnat_builder_1_6/build.properties.

The module repository is located on the virtual machine in the folder /opt/xnat/modules.

Sample module code is available in the folders egomaster and egomaster-3.5 under the folder /opt/xnat/workshop2012/d2s1-configandcustomization.

Maven is available on the virtual machine, but also from the Apache Maven site.

To build a module:

CODE

cd /opt/xnat/module-code
mvn clean package
cp target/module-name.jar /opt/xnat/modules

For example, to build the egomaster module:

CODE

cd /opt/xnat/workshop2012/d2s1-configandcustomization/egomaster
mvn clean package
cp target/workshop2012-d2s1_egomaster-3.7.jar /opt/xnat/modules

Once you've built a module, update XNAT with the following steps:

CODE

sudo service tomcat6 stop
pushd /opt/xnat/xnat_builder_1_6
bin/update.sh -Ddeploy=true
cd deployments/xnat
psql -U xnat -d xnat -f sql/xnat-update.sql
sudo service tomcat6 start
popd

These steps are wrapped up in a script named rebuild.sh located in the xnat user's home bin folder.