CVRG Registry Installation Guide

From CVRG Wiki

Jump to: navigation, search

Welcome to the installation guide for the CVRG Registry, an online tool for analyzing data.

Contents

CVRG Registry Description

Welcome to a technology preview of the CVRG workflow application. The application provides an extract, transform and load mechanism that takes a clinical dataset conforming to a defined structure and loads it into an instance of i2b2. This VM is intended to demonstrate the functionality of the application and is not for production use.

System Requirements

The CVRG Registry works best with the following software:

Software Type Vendor/Name Recommended Version
Operating System Windows XP
Windows 7
Ubuntu 10.04.3
Mac OS X Snow Leopard
Web Browser Firefox 5
Safari 5.1
VMWare Fusion 3.1.3

It is recommended that the machine running the VM have 4Gs of RAM.

CVRG VM Download Instructions

Download one of the latest virtual machine files found in this folder. You can use the *.tar.gz format or the *.ova format. (Wikipedia OVA info here) Md5sum files are located in the folder as well.

Tar Format

If you download the tar.gz format:

1) Unzip the file
2) Untar the file
3) Open the .vmx file using Player or Workstation

OVA Format

If you download the ova format:

1) Open the OVA file in VMware Player, or ...Italic text
2) Import the OVA file into VMware Workstation using:
2.1) File > Import/Export
2.2) Select "Virtual Appliance" when asked to choose the source type

Note: See "Potential VMware Issue" further below.

VMware Software

You may use either VMware Workstation (purchase required, alternatively you may have access to an education license), or VMware Player (free) to run the virtual machine.

Check out VMware Workstation here:

    http://www.vmware.com/products/workstation/

Or download the VMware Player here:

    http://www.vmware.com/products/player/

Fusion Users

VMware Fusion users can use the tar file or ova file. If using the ova file, then the ovftool must be used as described below in the section titled "Potential VMware Issue".

Shutting Down the VM

Some versions of VM software may not provide the option of VM > Shut Down Guest. If this is your case, then the following steps will gracefully shut down the guest OS:

1) Login as root with the password on the screen
2) Type "halt" and press Enter
3) Wait for the VM to power off


Potential VMware Issue

Late breaking news: The error mentioned below might be avoided by using just released VMware Workstation 8.0. Have not had time to verify just yet. Nevertheless, the workaround below still works.

If during this process of extracting the OVA file, you encounter an error

  • The OVF descriptor file could not be parsed" using VMware Workstation, or
  • Failed to open virtual machine: Failed to query source for information" using VMware Player,
  • ... then you'll need to download the latest VMware version of ovftool and execute it from the command line to convert the OVA file to VMX file format.

The latest version of VMware ovftool can be downloaded here:

    http://communities.vmware.com/community/vmtn/server/vsphere/automationtools/ovf.

After installation of the latest VMware ovftool, open a command window and import the OVA with these steps:

1) Make a folder for the VM
2) Move the OVA file into this new folder
3) Execute this command in the folder

   "c:\Program Files\VMware\VMware OVF Tool\ovftool" {name}.ova {name}.vmx

4) You should see something like this:

  • Opening VMX target: VMware-vCenter-Server-Appliance.vmx
  • Writing VMX file: VMware-vCenter-Server-Appliance.vmx
  • Disk Transfer Completed
  • Completed successfully

Then you can open - not import - the new VMX file from within VMware Workstation or VMware Player.

Retrieved from "http://wiki.cvrgrid.org/index.php/CVRG_Registry_Installation_Guide"
Personal tools
Project Infrastructures