Differences between revisions 24 and 25
Deletions are marked like this. Additions are marked like this.
Line 4: Line 4:
== What is a Virtual Disk Image? ==
A Virtual Disk Image is copy of an operating system (called Guest Operating System ) which can run in your machine (called Host Operating System). Usually, the Guest OS is customized with custom programs installed on top of it. Virtualization software enables one to test another OS without the need for physically installing it in the disk or it enables one to execute certain programs which are available only for the guest OSes.

== How to get the FreeSurfer Disk Image Running? ==

  * Download and install [[http://www.virtualbox.org/wiki/Downloads|VirtualBox]]. Installing it usually is just a matter of double-clicking the installer and following the steps.

  * Download the [[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/5.3.0/freesurfer-Virtualbox-linux-x86-stable-pub-v5.3-full.vdi.gz|FreeSurfer disk image]]. Save it to a meaningful location (e.g. ~Username/VirtualBoxImages) and unzip the file once the download is complete.


==== Running the VirtualBox for the first time ====
Start the !VirtualBox Software. It should look like the image below (The left part of the window is empty because we haven't created any virtual machine).

{{attachment:VirtualBoxInstall1.png}}

Click '''New''' on the top left and use the following settings:

   Name: '''Freesurfer5.3'''<<BR>>
   Type: '''Linux'''<<BR>>
   Version: '''Red Hat (64 bit)'''<<BR>>

{{attachment:VirtualBoxInstall2a.png}}

Click on '''Next'''. This should bring up a slider where you'll allot the amount of memory to the virtual machine. In the case we recommend 4Gigs of RAM.

{{attachment:VirtualBoxInstall3.png}}

Click on '''Next'''. This should bring up a dialog box. Select '''Use an existing virtual hard drive file''' and click to folder icon to navigate to the !FreeSurfer disk image you downloaded from above.

{{attachment:VirtualBoxInstall4.png}}

Click on '''Create'''. You are back in the main screen.

{{attachment:VirtualBoxInstall5a.png}}

Click on '''Start'''. The virtual machine should start up after clicking '''OK''' to the various messages you'll be presented with a desktop which looks like below.

{{attachment:VirtualBoxInstall6.png}}

'''''NOTE:''' If you recieve the following error:'' '''''Failed to open a session for the virtual machine Fusion Middleware.''''' ''You will need to make sure you have 'virtualization enabled' in the BIOS settings of your machine. Follow the directions [[http://luiscberrocal.wordpress.com/2013/06/03/error-on-virtualbox-vt-x-features-locked-or-unavailable-in-msr-verr_vmx_msr_locked_or_disabled|on this page]].''

To start !FreeSurfer click the '''Terminal''' icon on the desktop. To test the installation type

{{{
tksurfer bert lh inflated -annotation aparc
}}}

{{attachment:VirtualBoxInstall7.png}}

==== Notes ====
 * For the FreeSurfer disk image, the password to `sudo` commands / `root` account is simply `freesurfer`.

== Advanced Steps ( Recommended ) ==
==== Installing the Guest Additions ====
Guest additions enable one to do cool stuff like running the Guest OS in full screen, have a common clipboard etc. To do this, click on '''Devices''' in your main menu and then click on '''Install Guest Additions''' and Follow the instructions.

==== Sharing drives ====
Not yet written.
this page is obsolete (could not delete it due to locking failure)

Contents

this page is obsolete (could not delete it due to locking failure)

Installation/FreeSurferVirtualImage (last edited 2020-04-15 01:13:10 by buildqa)