CVRG XNAT-CVI Installation Guide

From CVRG Wiki

Jump to: navigation, search

Contents

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.

System requirements

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:

CVRG-XNAT-02_2013.ova
Image:XNAT_Install_Cred.png

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.
Click Next.

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.
Click Import.

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 (james.g.terry@vanderbilt.edu)



Personal tools
Project Infrastructures