For the XNAT 2010 Workshop we are providing a Virtual Machine (VM) so that users can easily experience using the full suite of XNAT tools.

VM Contents:

  • Ubuntu 10.04 with Tomcat 6, PostgreSQL 8.4, and OpenJDK 1.6
  • XNAT 1.4+ from hg.xnat.org (http:_hg.xnat.org-), changeset 2a779a4c12e8 (http:_hg.xnat.org-xdat_release-changeset-2a779a4c12e8)
  • DicomServer r702
  • XNAT Desktop
  • XNAT Gateway GUI
  • DicomBrowser
  • Sample Data (loaded into XNAT and available at ~/SampleData)
  • Customized schemas (located at ~/xnat/projects)

Many details are the same as the official XNAT 1.4 Virtual Machine, but we have included additional software and greatly simplified the VM installation process by using the Open Virtualization Format (OVF) . We have only tested the VM using VirtualBox 3.2. VMWare currently only supports the legacy OVF format, thus it will not be able to use this VM in VMWare.

Download the VM

Three files are required for the Virtual Machine, please download them to your computer:
xnat-demo.vmdk - virtual hard disk (3.6GB)
xnat-demo.ovf - configuration file
xnat-demo.mf - checksums

Installing the VM

Once you have installed VirtualBox, open VirtualBox, click the "File" menu, and select "Import Appliance." Choose the location of the xnat-demo.ovf file and follow the wizard.

Port Forwarding

The XNAT installation will by default only be browsable from within the VM. You can instruct VirtualBox to forward all network traffic for a specific port to the VM. On Windows, you may need to execute the following commands from inside the VirtualBox installation path (e.g. C:\Program Files\VirtualBox).

From the command line on your Host machine (i.e. not inside the Virtual Machine):

VBoxManage setextradata xnat-demo "VBoxInternal/Devices/pcnet/0/LUN#0/Config/http/HostPort" 8080
VBoxManage setextradata xnat-demo "VBoxInternal/Devices/pcnet/0/LUN#0/Config/http/GuestPort" 8080
VBoxManage setextradata xnat-demo "VBoxInternal/Devices/pcnet/0/LUN#0/Config/http/Protocol" TCP

From your physical computer, you can point your browser at http://localhost:8080/xnat . If other computers will access this XNAT VM, please update the URLs in XNAT's Administer > Default Settings to match your public IP address.

If you already have a server that is using port 8080, you could switch the HostPort line to some other free port, e.g. port 8084:

VBoxManage setextradata xnat-demo "VBoxInternal/Devices/pcnet/0/LUN#0/Config/http/HostPort" 8084

Patches

If you downloaded or installed the Virtual Machine prior to June 28th, please be aware that there is a small bug (several schemas were missing). The issue has been fixed in the version available for download now, but in case you wish to patch your existing installation. Please extract the contents of file:patch.zip to overlay your ~/xnat/projects, then, in the VM, run:

~/tomcat/bin/shutdown.sh

cd ~/xnat
bin/update.sh -Ddeploy=true
psql -h localhost -U xnat -f deployments/xnat/sql/xnat-update.sql xnat

~/tomcat/bin/startup.sh

Known Issues & Workarounds

  • VM stuck after the host machines wakes up from suspend. Try disabling "VT-x/AMD-V" in the settings, according to issue 2023 . This setting controls the native machine code execution, by disabling it, the VM may be noticably slower, but hopefully it will work after a suspend.
  • No labels