Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
#acl WikiGroup:read,write,delete,revert All:read <<TableOfContents(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. This customized Guest OS is basically a disk image. A virtualization software enables you to seamlessly boot the disk image ( customized Guest OS ) in the Host OS. This system 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. As an example, the !FreeSurfer disk image provided [[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/5.3.0/freesurfer-Virtualbox-linux-x86-stable-pub-v5.3-full.vdi.gz|here]] has the entire !FreeSurfer v5.3.0 on top of a Xubuntu Linux distribution. ( Xubuntu is a lightweight Ubuntu distribution ). So, to boot this disk image up and execute it, you need a virtualization software for your platform. In this tutorial, we use [[http://www.virtualbox.org/|VirtualBox]]. In effect, * Host OS - your OS. ( for example, Windows ) * Virtualization Software - Virtualbox ( for Windows if your Host OS is Windows ) * Guest OS - Xubuntu 11.10 ( customized because it has !FreeSurfer v5.3.0 already installed ) == Download and Install VirtualBox == Depending on your platform, the relevant !VirtualBox binary is found [[http://www.virtualbox.org/wiki/Downloads|here]]. Installing it usually is just a matter of double-clicking the installer and following the steps. '''''NOTE:''''' If you recieve the following error: {{{ Failed to open a session for the virtual machine Fusion Middleware. VT-x features locked or unavailable in MSR. (VERR_VMX_MSR_LOCKED_OR_DISABLED). }}} 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]]. == How to get the FreeSurfer Disk Image Running? == ==== Download the disk image ==== First the disk image is downloaded from [[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/5.3.0/freesurfer-Virtualbox-linux-x86-stable-pub-v5.3-full.vdi.gz|here]]. Save it to a meaningful location which cannot be deleted by accident. Like `C://Program Files/VirtualBoxImages` for Windows, `/home/<username>/VirtualBoxImages/` for Linux-es, `/Users/<username>/VirtualBoxImages` for Macs. ==== Running the VirtualBox for the first time ==== !VirtualBox Software is run. It looks like this. {{attachment:1.png}} The left part of the window is empty because we haven't created any virtual machine. ==== Adding the downloaded hard disk image ==== From the main menu, select the '''Virtual Media Manager''' option under the "File" menu. It should look like below. {{attachment:4.png}} Click on "Add". This should bring up a file dialog where you'll navigate to where you saved the disk image and select it and click "Open". After which you'd see the name of the disk image in the Hard Disks tab. Like following.. {{attachment:5.png}} Click "OK" to end the wizard. ==== Creating a New Virtual Machine ==== You are back in the main screen. Click on "New" and click on "Continue". In the next screen, !VirtualBox asks for the name of the virtual machine and the Type of OS and the version. Type should be `Linux` and Version should be `Ubuntu`. You can type any name but it should look like this. Click "Continue". {{attachment:2.png}} !VirtualBox asks the amount of base memory you want to allocate. Make sure it's not too low and tending somewhere near the upper limit. If you have 8 GB of memory, allocate atleast 2 GB. {{attachment:3.png}} In the resulting "Virtual Hard Disk" page, enable '''Boot Hard Disk''' and select the '''Use existing hard disk''' option. It should've already selected the virtual hard disk you added in the "Adding the Downloaded Hard Disk Image" step. If not, select that. {{attachment:6.png}} Click on "Continue" after which you'll be presented with a Summary. After verifying the information. Click on "Done". {{attachment:7.png}} ==== Running the virtual machine ==== Your !VirtualBox app should look like this now {{attachment:8.png}} Click on the green arrow '''Start''' to start the virtual machine. As you can see in the following screenshot, Xubuntu is booting up. {{attachment:9.png}} You'll be presented with a desktop which looks like below. Don't worry about installing software updates right away, but you can do so if you want to. ( Please see the "Notes" below ). {{attachment:10.png}} If you open up Xterm, you'd see the !FreeSurfer environment starting up. Test the installation to your heart's content. Here I've given `tksurfer bert lh inflated -annotation aparc` just to see `tksurfer` works. {{attachment:11.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'''. Follow the instructions in the booted up FSv5.0.0 image. ==== Sharing drives ==== Not yet written. == Authors == Krish Subramaniam Help from:Nick Schmansky, Pedro Paulo de Magalhaes Oliveira Junior |
PNG IHDR E èwõ pHYs u u:8Û +tEXtDescription Window Class: Qt-subapplicationVEQ "tEXtTitle Oracle VM VirtualBox ManagerÇ£& IDATxì½w|Tǹÿÿº½iµÒ®$$! B*L;®`ÛqÿÆN±ãÜä&7å&÷Þä&qI~In;81îظbéf:¨B½îjµ½6¿?-$(*ày_»çÌÌyfvuÎgyæ ÎçÕµk@ ázgÅ7Æ¿¥b¯°Z¾|Ùh[D 0êlÜø)Ä £³èÕµk,¸ T*ÕXYF 0jD£Q ضm;VEôé!"@ |ÑF£XÑcm @ ÂØC½ºv-"ðEfãÆOå%õÉڰ´A@ c;ôiDóÝÞèËïl|ã®Ó ¿²jyNªYÇ45t=@ k J"DsÍí½{{ÓúMû0 CoÙyhã}åÓ î¹}Ù´üt/0D¾¨¼öÚkÍ--³ù±Ç k[.±²ÿZ7p 3¸$òɨ:pâÔíEIQ«yJ%˲,Ëûì¬ [>oY9oÂ(K ,Ë ª«ëéé$IV;ìÒ쬬±6?o¾õfCC#MÓßüÆ×u:}ìø¶mÛöíß _^½:33ó£?>qâ>õÈÃÛl6üº®îäú÷Öã×å³g_^ûÃ1uWeeee% |óß0 ÕÝßM à8Îl6åääÌ]Î2ÌÈ]ë@ |A\´yóÁÛæÞ±tæ3^¿öýXMøãoßëõÁ¯û0Éj¾cnEOa ï¿þz·Óß², O×>]zÚ´²% Z !¤( sµ»¥¤¸¤¡¡QQcÇN}úʲ|üÄ °ÍýªìÛÿùÍ_º ¿Þ»oßUiõêÕC4çûvÍfe½^¯Óér:]HäBÜUát3VßdáªóÌ3Ïzü?øKm$¾ÊÀ#bpIÄ3ôKë7½òñöÿüê~þÄÊV-zúÅwn]<£¤(Í«¶ï;ÐÙ~òÞ{ DYÅ_$@i6mú ë¡©-Ôh4ÝNç{ï½çv» <qS67ìªÜÕÛÛ{ûm·ù|¾£Çù|>AXMH°Ç¯«;yèð¡®®.QµZmÎäÉK. ÔêêCuw;E±X,ÅEEÓ¦MøaÒ¤I:> ;vtöìY¸@}}}(ââ~U©©?Ïh4677wvv0 #Ëò Fcí¿ùæñX'^=¿f $'Ûzðþö7Ërÿ}÷@kkÛÚW×ÀM7ÞTX8 <8ôÊÊ;î°Ùl¡Pèù5kdYnhh:~üÄ£GN§¢(F£)//wNy9˲ÍÍM¯¿ñ&Bhþ¼ysæÌ$éåþÓår%&&>øÀ,{Á[Óptè^Ä×î=nw¯Á ¯¨¨ÈÏËNuY·ïØ^UU%bfæÄââÂuëÞ¥KMÃeø: úM<yòÐ#L |¡xæg±ºÌÁï fv_MË]?Xóø^ôçÿýúß?¨zäÇoµµT BaQ FbYòë0fD"ºu ×ëo\± ÿVN²ÙV¬XñꫯÀÑcÇ°$Âøýþ÷?x_§ÓkµZ èèè!-5å·»·««sãÆN TR\ »*+eY[¢- 565 jÆ;÷ìÙ )))*ßÔÔ¼y˧Ëyãû¤iº¸¸p÷î= ¯·¹¹ûl ; Ãõ+âÄÏ X¼hÑÞ}{`ÊüãÇOÀ¸Ôöã IX ü Ì°Õ0DÝCéÐøý>,ÅÌf#>ïÓëõ<¯r»{öìÙÓÜÜtï=÷¦§gÌ3gWeåî={²²²?îr¹8»ý¶ÛÐC0¼! N/¼>ß}æóù= ïG}찧ͦVÿt Vëtv}ðAÿ/Õp¾Ný¾ÉÂõÁ@_Î%iÜ®_q~¦Áo 4Cõ¢XNõëW>Ûs¢á¿üÊ_ßÚÞÑzçU* i8:èt*â&"!1FJJJüÜAZj*MÓ¢ôô¸âËK²¼há¢3¦,Ëiii&F"QEßz{]o¯ûĪâ@ °{Ï HLL¼ç{´ ĦçâñûýûöíéÓ§-^´ 8°yËcÇÏ>#11±_ùâ¢â={ö" =á÷û`òäÉø*ñÌ1£ªªêèÑ£9'544j4¢Ââ!$Ñ¥¶?ÄàìÙ»ÇZµrø±D/ºÐQëoÿ{ìµÅbYºd øýþÏ ´´Ô{éíÛ·ïÝ·¯½îd]~^þ9sZZ[Þ^·. ÀòåˬVëÐgHÓ EQp`Ö©S§Þy÷]YÍæ¡«|´´Ô»¿|7Ã0>Ùf_§~ÖÅ?á CLÅÞ³â$ FFçU<ßîô°4(Àó*F½Z-BÁ `º æW BýÞ¢A©TªéÓÏÎM0 S__¿{÷î^'¾L ,¶JKJbJ"©/&7ÎÎN\òÀ ìwj $2Y³êÏÔ:u2 ?~ [[Z2ÈìRBBBnnNmmݺwÞ²²RçËj?~3tá 1Ä% ¡p¸··÷óÏ,]º46°ùyù4M@AAýiooÏÏ˧(êÖ[nyéoÃz¨¨¨°`JÁE- ΧªÌf|$\´zWw7þ8òóòñ LDÃü:]@ Äs!rÇ¢éU W5ôyeF,EEB!JuÃÃÞ E(Âð±X,ØÔÞÞ.ËrìÙÐÖÞ+VëyD«ÑÄu\.×G v»£¬´çùÊÝN§S/-²8&¿&eOJL<ÏE0ødSIiqýzIO¨:vüîÈ é=kVmm]4eY¶¬t?࿨IÔ~øÁ¹¸¢írL`.{Hq,BèýÞ¯;tøðÔ©S® C à×½n¢(X< ÍÐC:Ì^¨ûö 24üê1(8O¾óë4@øbÒo®-WtQD,CÅèÿ>vû»ýù Z CC8 NÏÈ3gYÇéC©iz½.äl$-jµ:77§¦¦6 løäEi5®î® >Á.=ãrS+=+''G¤O7};ëp8°Ø:rôh~~¾F£ §Óe³õ÷úÄJ² SQQT²,WW×8 A/51Ë`0øýþÊÝx+æÕ1íééÍÍM EZf8èÚ¿L¶i P©xè ú¡iº®®.¾ÊÐC: b Ùív<°5µ5%%%4MWUUá³))) Âú÷ÖKdëéq·´¶ìªÜU1¿â¢WzH¯°CWONJ¢( !T[w²¸¸aã'γ»¯0æ\ÅbW×øðêaª¢Á%EQ)7í/1³àÁ?¼¶ âUìô³3&LÞ¿ñõ¬Ôäi¥eÄVÆ¥Köôôtw;«ªªªªªâWÅÇV÷ÃnOÆÏ»võôô®¯DÎù<ôzýòò]N§óù5k¬Vk8 fYöѯ~µ_;aæ{÷í«ëêz)111tvv¢XP0eP!BÓtqQѮʳz a© Côñ®;W åÈp¸Ôö%óêk¯Íæü¼¼éÓ§OÌØÚÚ ÿñòË,ËvvvÆWzHàwßMF£IMIU«Õ3¦Oß·kkÛ^ÀáÕ |²Ñív«ÕêU+WÕÖÕnݺmϽi©²²&^ôC ée÷b8Õõz}aaá±cÇZZ_³eÙ~_Æ×@¸n¸Ô`ê @ýâæ±Ñ½ºb^Ñû dO|ñ'úTTRêé©Ú¿X0¿${b²ZÅ¿O£Ñh ¸ÿÕÕÕõôôàÕò)ª1{f³åÖ[nݾc»Ûí>zìXii)ËrÍÍçÿÌ;71ÑvðСîî.§Ó©Õj3$ ÂÜpà ¶Ä#Gtw;½^ZrØíCüíÞ³ÏîåLÎÑj |fYvèUTWØþ L4©´¤¤¶®. B¡ Ì5Ëç÷ÕÖÖy<ôW¬øxÃXé ðx< |