CVRG XNAT-CVI Installation Guide
From CVRG Wiki
CVRG XNAT-CVI description
Welcome to the installation guide for the CVRG XNAT-CVI, a Web and XML based system for managing cardiovascular imaging data and associated analytical results. This system is based on the open source project eXtensible Neuroimaging Archive Tool (XNAT) developed by the team at Washington University St. Louis lead by Dr. Dan Marcus. The XNAT-CVI extends the original XNAT system with additional functions and data elements to enable cardiovascular imaging (CVI) research.
This release of CVRG XNAT-CVI runs on a virtual machine.
It will run on any system supported by VirtualBox; currently Windows XP or newer, Mac OS X 10.5 or newer, and a variety of Linux distributions (see complete list).
This VM will also run on VMWare. For further information on VMWare requirements and compatibility, please refer to their VMWare Compatibility Guide
The virtual appliance is packaged as an ova file that can be imported from both virtualization platforms.
For the system to run smoothly, a minimum of 4GB of RAM is recommended on the host.
CVRG XNAT-CVI VM download instructions
Download the virtual appliance here:
Running XNAT-CVI in VirtualBox
Downloading and installing VirtualBox
Oracle VirtualBox for your OS can be downloaded from https://www.virtualbox.org/wiki/Downloads. The Base package is enough to run the CVRG XNAT-CVI virtual machine. Installation is straight forward. For details on installating VirtualBox visit VirtualBox Installation.
Importing the CVRG XNAT-CVI appliance into VirtualBox
Run VirtualBox application. Click on File -> Import Appliance.
Click Choose to select the OVA file.
Select the OVA file using the file browser and click Open.
The Import Settings window allows settings to be changed before importing the VM. The default RAM on this VM is 3GB. If this is too much for you host computer, it can be changed by clicking on the RAM amount on this window. The VM will run with as low as 512 MB, but performance will be reduced.
It will take several minutes to an hour to import the XNAT-CVI VM depending on host system capability.
CVRG XNAT-CVI has been imported.
Networking in VirtualBox
Networking is disabled by default when importing the OVA file. To enable networking select the XNAT-CVI VM and click on Network.
On the Network Settings window select Enable Network Adapter. From the Attached to drop down menu select the option that will work better on your environment (NAT for simplest set up). The MAC Address of the guest system can be edited if necessary for bridged networking. Click OK.
Run the VM by selecting it and clicking on Start.
Running XNAT-CVI in VMWare Player
Downloading and installing VMWare Player
VMWare Player can be downloaded from vmware.com. A free account is required.
For further information on how to install VMWare Player, please refer to their oficial documentation: Getting Started with VMWare Player
Importing the CVRG XNAT-CVI appliance into VMWare Player
Start VMWare Player application. Click on Open Virtual Machine.
Under Files of Type select All image files. Locate and select the downloaded OVA file and click on Open.
WMWare Player will display the Import Virtual Machine window. Click on Import.
A progress bar will be displayed.
The main VMWare Player window is displayed with the imported XNAT-CVI VM in it. If needed, click on Edit Virtual Machine Settings to change the amount of RAM allocated to the VM.
In the settings window the VM's allocated RAM can be modified. The default RAM on this VM is 3GB. If this is too much for you host computer, it can be changed by clicking on the RAM amount on this window. The VM will run with as low as 512 MB, but performance will be reduced.Click on OK.
Back in the main window, run the VM by clicking on Play virtual machine.
Networking in VMware Player
The VM is set up for bridged networking. You may need to alter the networking settings to make them work in your environment. To do so, with your VM powered off, go back to the Virtual Machine Settings, and click on Network Adapter. You will be able to choose between Bridged and NAT networking, and by clicking on the Advanced button you will be able to set the guest OS MAC Address. For the simplest set up, pick NAT, and click OK.
CVRG XNAT-CVI questions
For questions and issues please contact Greg Terry (email@example.com)