Skip to content

MicrobiomeHelper Virtual Box

Gavin Douglas edited this page Sep 27, 2016 · 54 revisions

We have constructed a Linux (Ubuntu v16.04 LTS Desktop) Virtual Box image that can be used to run all Microbiome Helper workflows and tutorials. This Virtual Box image can be run on any operating system (Windows, Mac, Linux) and saves the time consuming task of installing and configuring multiple bioinformatic packages.

Includes

The MicrobiomeHelper VirtualBox includes several bioinformatic packages. Please cite all of the specific tools that you use for your analysis.

Requirements

  • Any desktop or laptop purchased within the last 3-5 years should work.
  • Must be 64-bit
  • 4GB RAM

  • 25GB available hard drive space

Installation

  1. Download and install VirtualBox for the operating system you are using. https://www.virtualbox.org/wiki/Downloads
  2. Download the latest version of Microbiome Helper Vbox (v0.2.9) (11.7 GB - OVA file). If that doesn't work, click here for an alternate link (CHANGELOG).
  3. "Import" the Microbiome Helper Vbox into VirtualBox by opening the OVA file or within VirtualBox File->Import Appliance. More detailed and graphical instructions for importing the image are [available here] (https://www.maketecheasier.com/import-export-ova-files-in-virtualbox).

Optional Configuration

  • During the import step (or later in settings) you can change the default amount of RAM and number of CPU available for use by the VirtualBox.
    • If your computer has 8GB of RAM or more, we would recommend configuring the virtual image with RAM: 4000MB.
    • If your computer has 2 or more cores you can configure the virtual image with CPU == 2 (or more).

Moving files to the virtualbox image

  • To move files in and out of the virtualbox image you can create a "shared folder":
    • Settings->Shared Folders (Note this is in the VirtualBox GUI on your local PC)
    • Click on the little "+" sign on the folder on the right.
    • Choose a "Folder Path" and "Folder Name"
    • Check the "Auto-Mount" and "Make Permament" boxes
    • Click OK (twice) and restart the virtual image if it was already running.
  • The shared folder will be at /media/sf_<folder name>

Other Notes

  • The default username and password are both "mh_user".
  • If you'd like to use USEARCH v6.1 for chimera removal (with chimera_filter_usearch61.pl), rather than VSEARCH, you will need to get a license to use this program and put the binary called "usearch61" in your PATH.

Known issues

  • If you get a "VT-x/AMD-V hardware acceleration" error when booting for the first time, you might be able to fix it by following the steps here.
Clone this wiki locally