Installing the Linux distribution of the NGS training inside Windows using VirtualBox

From BITS wiki
Jump to: navigation, search

We have created an image of a Linux Mint distribution with all tools and data, that are required for doing the RNA-Seq analysis workflow, already installed. To run this distribution in VirtualBox:

  • Install VirtualBox
  • Obtain the VM of this distribution by sending an email to bits@vib.be
  • Open VirtualBox by clicking the icon on your desktop
    VBicon.png

  • In the top menu, expand Machine and Select Add
    addVM.png

  • Browse to the folder containing the VirtualBox Machine Definition file (this is the VM) and click Open
    openVM.png

  • Start the VM by clicking the Start button
    startVM.png

In most cases it is worth while to check the settings of the VM before you start it:

  • The default amount of memory that is attributed to the VM is 3.6Gb. If need you can change that in the System tab of the Settings window. If you have more memory available (as is the case in the picture below) it's a good idea to contribute more memory to the VM (this will fasten up the analysis). If you don't have 3.6GB available decrease the amount of memory provided for the VM. The rule is here: provide as much memory as you can while staying in the green zone.
    settingsVM1.png

  • The VM has the same MAC address of the computer it was created on. This is not a problem unless you install the VM on multiple computers and let them access the internet at the same time. Having multiple computers with the same MAC address on a network can give trouble. So if you need to change it, you can do that on the Network tab of the Settings window by expanding the Advanced settings.
    settingsVM2.png

    Note that if your computer has two network adapters (e.g. wired and wifi) you can adjust them both by selecting the Adapter 2 tab.

To be exact, we offer not one but two VMs: one containing the tools (BITS-NGS_training.vdi), a second containing the data (RNASeq_DATA.vdi). This makes it easy to replace the data of the training by your own data and running the workflow on your data.


settingsVM3.png


Trouble shooting

Thanks to Pauline Depuydt for finding the solution !

If you get the following error message:

Cannot register the image … because UUID already exists
you should follow this explanation to fix the problem.