Microbiome Helper Virtual Box - LangilleLab/microbiome_helper GitHub Wiki

Please note that out current efforts for distributing virtual environments are focused on shotgun metagenomics analyses instead of amplicon analyses. If you are interested in getting an updated virtual environment for running a QIIME 2 workflow you can download a docker image available from the QIIME 2 website.

Our 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. If you use any tools packaged with this image be sure to cite the tool's authors.

Includes

The Microbiome Helper Virtual Box includes several bioinformatic packages and databases used in our standard operating procedures and tutorials. The image also includes other tools for microbiome analyses such as for sequencing error correction or predicting phenotypes. Please cite all of the tools that you use for your analyses.

Requirements

  • Any desktop or laptop purchased within the last 3-5 years should work.
  • Must be 64-bit
  • More than 4 GB RAM to process the tutorial data. You may require additional RAM depending on the commands and size of the data you're processing.
  • At least 60 GB available hard drive space: the OVA file is 25 GB and the imported image is 40 GB (note that you should delete the OVA file once the image is imported to save space).
  • Using the amplicon-only version of the virtual box will drastically save download time and disk space (OVA is 12 GB and imported image is 25 GB).

Installation

  1. Download and install VirtualBox for the operating system you are using from here: https://www.virtualbox.org/wiki/Downloads

  2. Download a version of the Microbiome Helper virtual box below.

    If you only want to run amplicon data than you may want to download our amplicon-specific version which is substantially smaller: Microbiome Helper Vbox Amplicon-only (v0.4) (12 GB - OVA file).

    If you would like to run shotgun metagenomic data and/or use all features that were available during workshops then you can download the expanded version: Microbiome Helper Vbox (v2.3.0) (25 GB - OVA file).

    Check out the CHANGELOG for details.

  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. You can delete the OVA file once it is finished importing to save space!

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: 4096MB.
    • If your computer has 2 or more cores you can configure the virtual image with CPU == 2 (or more).

Moving files to the VBox image

  • To move files in and out of the VBox 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 Permanent" 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.