User Tools

Site Tools


Table of Contents


QIIME™ (canonically pronounced chime) stands for Quantitative Insights Into Microbial Ecology. QIIME is an open-source bioinformatics pipeline for performing microbiome analysis from raw DNA sequencing data. QIIME2 is a completely new and different version than QIIME1.



See versions of qiime2 that are available:

$ module avail qiime2

Load a particular version into your environment and run it:

$ module load qiime2/2021.8
$ qiime --help


Notes from the sysadmin during installation:

$ mkdir -p /var/tmp/chroot/qiime2
$ rpm --rebuilddb --root=/var/tmp/chroot/qiime2
$ wget
$ sudo rpm --root=/var/tmp/chroot/qiime2 -i centos-release-7-9.2009.0.el7.centos.x86_64.rpm
$ sudo yum --installroot=/var/tmp/chroot/qiime2 install -y rpm-build yum wget vim
$ sudo cp /etc/resolv.conf /var/tmp/chroot/qiime2/etc
$ sudo mount --bind /dev/ /var/tmp/chroot/qiime2/dev
$ sudo mount -t proc procfs /var/tmp/chroot/qiime2/proc
$ sudo mount -t sysfs sysfs /var/tmp/chroot/qiime2/sys
$ sudo chroot /var/tmp/chroot/qiime2
# wget
# bash -u -p /export/apps/qiime2/conda
# eval "$(/export/apps/qiime2/conda/bin/conda shell.bash hook)"
# conda update -n base conda
# wget
# conda env create -p /export/apps/qiime2/2021.8 --file qiime2-2021.8-py38-linux-conda.yml
# conda activate /export/apps/qiime2/2021.8
# env > conda-qiime2-2021.8
# exit
$ sudo mkdir -p /export/apps/qiime2/2021.8
$ sudo chown aorth /export/apps/qiime2/2021.8
$ rsync -av /var/tmp/chroot/qiime2/export/apps/qiime2/2021.8/ /export/apps/qiime2/2021.8
$ sudo chown -R root:root /export/apps/qiime2/2021.8
$ sudo umount /var/tmp/chroot/qiime2/dev /var/tmp/chroot/qiime2/proc /var/tmp/chroot/qiime2/sys

QIIME2 has over 200 dependencies and is essentially impossible to install without the use of Miniconda (it is not even published on PyPy anymore, so installing it with pip is not an option). My strategy is to install Conda somewhere globally and then use it to install QIIME2. After the installation is done I think we don't technically need Conda itself anymore, as all binaries seem to be linked against libraries in the qiime2/2021.8 directory. Furthermore, I first installed qiime2/2021.8 in a chroot on the local file system and then rsynced it over to the network applications directory. This is MUCH faster, but more importantly, it avoids random "permission denied" errors I was getting when installing on the network file system.

To create the modulefile I compared the output env before and after loading the Qiime2 environment with Conda.

qiime2-software.txt · Last modified: 2021/10/05 15:34 by aorth