The developers of QIIME provide a VirtualBox disk image for QIIME 1.9.1. Instructions for using this image is available here. This is an alternative (unofficial) image with the same version of QIIME but with some features and enhancements as described below.
The QIIME developers are recommending that new users start using QIIME 2 rather than QIIME 1 (the version this image includes). I had created the original version of this image when I was using QIIME 1 for my work. This image is only provided with the hope that it will be useful for anyone still requiring QIIME 1.
Features and Enhancements
This image is based on the latest LTS version of Ubuntu 16.04.3 with Ubuntu MATE - a simpler desktop environment with minimal applications and desktop effects disabled for better performance. The default user is qiime with password qiime.
VirtualBox guest additions is pre-installed so features like shared folders, shared clipboard and better video support should all work immediately.
QIIME 1.9.1 and some dependencies (BLAST, Mothur, Clearcut, Infernal, Muscle, Cdbtools, Swarm, ea-utils, SeqPrep, SortmeRNA, BWA, BLAT) are installed using the Conda package manager and an environment is setup for the qiime user called qiime1. This environment is activated automatically on login.
R is installed along with the required packages (ape, biom, optparse, RColorBrewer, randomForest, vegan, DESeq2 and metagenomeSeq).
Additional dependencies installed - RDP Classifier, cd-hit, ChimeraSlayer, rtax, AmpliconNoise, Cytoscape and SourceTracker (Thanks to qiime-deploy).
Search and install additional software easily from the Ubuntu and Debian repositories using the inclued Synaptic Package Manager. Alternatively, packages can also be installed using the Conda package manager that is configured for the qiime user. Additional software like USEARCH can be made available by downloading the executable to /home/qiime/Software/bin and then creating a symlink or renaming the executable to the desired name. See tips section below for an example.
Storage space can be increased if necessary. LVM has been configured for the base installation so hard disk size can be increased if necessary by adding additional disks to the VM in VirtualBox.
Setup and Usage
- Install VirtualBox and the extension pack.
- Download the QIIME_1.9.1_UM.ova file.
- Click on the downloaded file. If that does not launch VirtualBox, open VirtualBox and then use the File --> Import Appliance option and select the downloaded file.
- VirtualBox will offer the possibility to configure the number of CPU's, the amount of RAM and other options in the next step.
Password for the QIIME user qiime is qiime. You can change it using the passwd command.
The qiime user has admin privileges (sudo) and so logging in to the root account is not normally required. If you do need to become root, use sudo su.
How do I exit the qiime1 conda environment?
Use the command source deactivate or dt (alias).
Increasing storage space
Shutdown the VM.
VirtualBox -> Settings - Storage -> Click on the "Adds Harddisk" button next to Controller: SATA. From there, select "Create new disk", use defaults and select a suitable disk size depending on the space available on the hard disk. Click OK when done.
Start VM, open terminal, use command lsblk to check if the new hard disk is listed.
Use LVM commands to extend and resize the file system:
pvcreate /dev/sdb vgextend ubuntu-mate-vg /dev/sdb lvresize -L +10G -r /dev/ubuntu-mate-vg/root
The root (/) filesystem should have now been resized. To check disk space usage, use the command (df -h).
Here is the output of the print_qiime_config.py command to test the QIIME installation:
(qiime1) [email protected]:~$ print_qiime_config.py -tvf System information ================== Platform: linux2 Python version: 2.7.13 | packaged by conda-forge | (default, May 2 2017, 12:48:11) [GCC 4.8.2 20140120 (Red Hat 4.8.2-15)] Python executable: /home/qiime/Software/miniconda3/envs/qiime1/bin/python QIIME default reference information =================================== For details on what files are used as QIIME's default references, see here: https://github.com/biocore/qiime-default-reference/releases/tag/0.1.3 Dependency versions =================== QIIME library version: 1.9.1 QIIME script version: 1.9.1 qiime-default-reference version: 0.1.3 NumPy version: 1.10.4 SciPy version: 0.17.1 pandas version: 0.20.3 matplotlib version: 1.4.3 biom-format version: 2.1.5 h5py version: 2.6.0 (HDF5 version: 1.8.17) qcli version: 0.1.1 pyqi version: 0.3.2 scikit-bio version: 0.2.3 PyNAST version: 1.2.2 Emperor version: 0.9.51 burrito version: 0.9.1 burrito-fillings version: 0.1.1 sortmerna version: SortMeRNA version 2.0, 29/11/2014 sumaclust version: SUMACLUST Version 1.0.00 swarm version: Swarm 1.2.19 [Jun 1 2017 11:47:02] gdata: Installed. RDP Classifier version (if installed): rdp_classifier-2.2.jar Java version (if installed): Not installed. QIIME config values =================== For definitions of these settings and to learn how to configure QIIME, see here: http://qiime.org/install/qiime_config.html http://qiime.org/tutorials/parallel_qiime.html blastmat_dir: None pick_otus_reference_seqs_fp: /home/qiime/Software/miniconda3/envs/qiime1/lib/python2.7/site-packages/qiime_default_reference/gg_13_8_otus/rep_set/97_otus.fasta sc_queue: all.q topiaryexplorer_project_dir: None pynast_template_alignment_fp: /home/qiime/Software/miniconda3/envs/qiime1/lib/python2.7/site-packages/qiime_default_reference/gg_13_8_otus/rep_set_aligned/85_otus.pynast.fasta cluster_jobs_fp: start_parallel_jobs.py pynast_template_alignment_blastdb: None assign_taxonomy_reference_seqs_fp: /home/qiime/Software/miniconda3/envs/qiime1/lib/python2.7/site-packages/qiime_default_reference/gg_13_8_otus/rep_set/97_otus.fasta torque_queue: friendlyq jobs_to_start: 1 slurm_time: None denoiser_min_per_core: 50 assign_taxonomy_id_to_taxonomy_fp: /home/qiime/Software/miniconda3/envs/qiime1/lib/python2.7/site-packages/qiime_default_reference/gg_13_8_otus/taxonomy/97_otu_taxonomy.txt temp_dir: /tmp/ slurm_memory: None slurm_queue: None blastall_fp: blastall seconds_to_sleep: 1 QIIME full install test results =============================== test_FastTree_supported_version (__main__.QIIMEDependencyFull) FastTree is in path and version is supported ... ok test_INFERNAL_supported_version (__main__.QIIMEDependencyFull) INFERNAL is in path and version is supported ... ok test_R_supported_version (__main__.QIIMEDependencyFull) R is in path and version is supported ... ok test_ampliconnoise_install (__main__.QIIMEDependencyFull) AmpliconNoise install looks sane. ... ok test_blast_supported_version (__main__.QIIMEDependencyFull) blast is in path and version is supported ... ok test_blastall_fp (__main__.QIIMEDependencyFull) blastall_fp is set to a valid path ... ok test_blastmat_dir (__main__.QIIMEDependencyFull) blastmat_dir is set to a valid path. ... ok test_cdbtools_supported_version (__main__.QIIMEDependencyFull) cdbtools is in path and version is supported ... ok test_cdhit_supported_version (__main__.QIIMEDependencyFull) cd-hit is in path and version is supported ... ok test_chimeraSlayer_install (__main__.QIIMEDependencyFull) no obvious problems with ChimeraSlayer install ... ok test_clearcut_supported_version (__main__.QIIMEDependencyFull) clearcut is in path and version is supported ... ok test_cluster_jobs_fp (__main__.QIIMEDependencyFull) cluster_jobs_fp is set to a valid path and is executable ... ok test_denoiser_supported_version (__main__.QIIMEDependencyFull) denoiser aligner is ready to use ... ok test_for_unrecognized_values (__main__.QIIMEDependencyFull) qiime_config has no extra values ... ok test_gdata_install (__main__.QIIMEDependencyFull) gdata is installed ... ok test_get_qiime_scripts_dir (__main__.QIIMEDependencyFull) Test that we can find the directory containing QIIME scripts. ... ok test_h5py (__main__.QIIMEDependencyFull) h5py is installed ... ok test_mothur_supported_version (__main__.QIIMEDependencyFull) mothur is in path and version is supported ... ok test_muscle_supported_version (__main__.QIIMEDependencyFull) muscle is in path and version is supported ... ok test_pynast_template_alignment_blastdb_fp (__main__.QIIMEDependencyFull) pynast_template_alignment_blastdb, if set, is set to a valid path ... ok test_pynast_template_alignment_fp (__main__.QIIMEDependencyFull) pynast_template_alignment, if set, is set to a valid path ... ok test_raxmlHPC_supported_version (__main__.QIIMEDependencyFull) raxmlHPC is in path and version is supported ... ok test_rtax_supported_version (__main__.QIIMEDependencyFull) rtax is in path and version is supported ... ok test_sourcetracker_installed (__main__.QIIMEDependencyFull) sourcetracker is installed ... ok test_temp_dir (__main__.QIIMEDependencyFull) temp_dir is set to a valid path ... ok test_uclust_supported_version (__main__.QIIMEDependencyFull) uclust is in path and version is supported ... ok test_usearch_supported_version (__main__.QIIMEDependencyFull) usearch is in path and version is supported ... ok ---------------------------------------------------------------------- Ran 27 tests in 0.276s OK