| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| == FreeSurfer VirtualBox VM Images == | == Running FreeSurfer in VirtualBox 7.X == |
| Line 7: | Line 7: |
|
<<BR>> Tested running on hosts: Windows 10, Mac OS 11.6 (Intel Mac) with VirtualBox 6.1.30. <<BR>> VM: minimum of 8 GB free RAM apart from RAM already in use by the host OS and other applications. <<BR>> VM: minimum of 2 CPU's/cores from the host. |
<<BR>> Intel CPU Host: minimum of 4 CPU's/cores and 16 GB RAM. <<BR>> Virtualbox VM: minimum of 2 CPU's/cores and 8G RAM allocated from the host. |
| Line 11: | Line 10: |
|
<<BR>> Host Disk Space (required): ~8GB for virtual image download (compressed *.ova file), ~30G for expanded VM image.* <<BR>> Host Disk Space (optional): ~8GB for tutorial data download (compressed *.tgz file), ~14G for expanded tutorial data.* |
<<BR>> Host Disk Space: ~150GB for a complete install of Ubuntu 22, freesurfer, including all downloads. |
| Line 15: | Line 13: |
| <<BR>> ''* To accommodate the VM, the tutorial data, and other data, please locate the VM on a disk partition with at least 60G of free space.'' | |
| Line 18: | Line 15: |
|
<<BR>> Some familiarity with the linux terminal running bash shell including removing, copying, editing files and setting/unsetting environment variables. <<BR>> Some familiarity with simple bash commands/scripting, e.g., as found in the shell initialization file. |
<<BR>> Some familiarity with the linux terminal including removing, copying, editing files and setting/unsetting environment variables. <<BR>> Some familiarity with issuing commands in the bash shell. |
| Line 21: | Line 18: |
|
'''Install VirtualBox on your Host Machine: '''<<BR>> '''VirtualBox install on Windows OS host:''' [[https://drive.google.com/file/d/1vbJxFUx1qiEnC2Z0nDaOtaz8_Cira9FX/view?usp=sharing|Vbox_Windows_install.pdf]]<<BR>> '''VirtualBox install on MacOS host:''' [[https://drive.google.com/file/d/11HfpKIaJ5kUhT17o6jY4Xm-rG740OiKj/view?usp=sharing|Vbox_MacOS_install.pdf]] *<<BR>> '''VirtualBox install on linux OS host:''' [[https://www.virtualbox.org/wiki/Linux_Downloads|linux downloads]]<<BR>> * ''We are aware that VirtualBox may crash on Intel or M1 Macs running MacOS 12.x (Monterey).'' '''Download and Run the Virtual Machine:'''<<BR>> '''''The VM image has been discontinued for the time being. A notification will be sent to the freesurfer list if a new image is made available. For security reasons we no longer provide the password to older versions of the VM image.''''' Right click on the <file name>.ova.7z file and see what options you have under the choices for "Open with". If your current archive program choices cannot open a 7zip file, then try installing one of the utilities listed below. You will be prompted for a pass code when the archive is successfully opened. If you do not have the pass code to open the image, then '''send an email to the FreeSurfer help list''' to receive it. '''For 7zip on Windows''' try the free version of [[https://www.win-rar.com/start.html?&L=0|WinRAR]] to expand the 7zip file. <<BR>> '''For 7zip on MacOS''' try the free [[https://macpaw.com/the-unarchiver|Unarchiver]] to expand the 7zip file. <<BR>> '''For 7zip on linux''' try the package manager programs, e.g., yum, dnf, apt, to download and install a 7z or 7za binary. <<BR>> Expanding the <file name>.ova.7z will generate a new file without the .7z extension, i.e., <file name>.ova will be created. This is the file to import directly into VirtualBox. If the archive program creates the <file name>.ova file under a subdirectory with the same <file name>.ova name, then rename the subdirectory to be something different. Be aware that some archive programs may delete the original <file name>.ova.7z file after it is expanded. This document will take you through the steps to setup and run the VM. '''Screenshots to setup the VM were taken from VirtualBox running on MacOS and Windows.''' Apart from some variations in the GUI on different hosts, the menus options are the same on MacOS, Windows and Linux. See: [[https://drive.google.com/file/d/159f-7OBx3yNpDKgeSBH4v10O7A0ktVAQ/view?usp=sharing|Vbox_load_image.pdf]] |
The current instructions for creating a Virtual Box VM to host the Ubuntu 22 Linux OS running freesurfer 7.4.1 can be found [[https://drive.google.com/file/d/1uNwv29fCeuMHrmTyXw94ZSuroNsPOxu-/view?usp=sharing|here]]. This includes complete instructions about how to create a general purpose Ubuntu 22 VM on your host machine which can run any Linux software compatible with Ubuntu 22. Only the last few pages are specific to installing freesurfer and testing the basic freesurfer environment. Apart from some variations in the appearance of the Virtal Box application windows on the different hosts, the menus options are the same on MacOS, Windows and Linux host machines. |
| Line 44: | Line 24: |
|
'''Example screenshot of VM up and running:''' Once the VM starts and you have added your FreeSurfer license file, you can start a terminal and it should come up with the environment set to run the 7.2.0 release. {{attachment:Ubuntu_VM_720.png}} '''Adding the tutorial data to the VM:''' <<BR>> <<BR>>This document describes how to setup, run and test the VM using commands from the FreeSurfer course tutorial data; the primary focus is on the Freeview command. <<BR>>[[https://drive.google.com/file/d/1lF2joiU5KygxsQkFZOEOrKbDMi_H8sFJ/view?usp=sharing|setup_tutorial_data.pdf]] <<BR>> |
Home page for the Virtual Course is here
Running FreeSurfer in VirtualBox 7.X
System Requirements:
Intel CPU Host: minimum of 4 CPU's/cores and 16 GB RAM.
Virtualbox VM: minimum of 2 CPU's/cores and 8G RAM allocated from the host.
Host Graphics card: 3D graphics card with its own graphics memory & accelerated OpenGL drivers.
Host Disk Space: ~150GB for a complete install of Ubuntu 22, freesurfer, including all downloads.
Host: A working network connection.
Additionally see the Freesurfer Release 7 System Requirements.
Suggested Experience Level:
Some familiarity with downloading files, e.g., via a web browser or using commands such as wget, curl from the linux terminal.
Some familiarity with the linux terminal including removing, copying, editing files and setting/unsetting environment variables.
Some familiarity with issuing commands in the bash shell.
The current instructions for creating a Virtual Box VM to host the Ubuntu 22 Linux OS running freesurfer 7.4.1 can be found here. This includes complete instructions about how to create a general purpose Ubuntu 22 VM on your host machine which can run any Linux software compatible with Ubuntu 22. Only the last few pages are specific to installing freesurfer and testing the basic freesurfer environment. Apart from some variations in the appearance of the Virtal Box application windows on the different hosts, the menus options are the same on MacOS, Windows and Linux host machines.
See this post about how to share a subdirectory from Windows inside the Ubuntu VM.
This document describes how to access (share) an external drive plugged into the Windows machine in the Ubuntu VM:
Vbox_Windows_mount_external_drive.pdf