Skip to content

Latest commit

 

History

History
61 lines (41 loc) · 3.35 KB

uppmax.md

File metadata and controls

61 lines (41 loc) · 3.35 KB
Raw

nfcore/rnaseq: UPPMAX Configuration

The pipeline comes bundled with configurations to use the Swedish UPPMAX clusters (tested on milou, rackham, bianca and irma). As such, you shouldn't need to add any custom configuration - everything should work out of the box.

To use the pipeline on UPPMAX, you must specificy -profile uppmax when running the pipeline (as of Nov 2017).

Note that you will need to specify your UPPMAX project ID when running a pipeline. To do this, use the command line flag --project <project_ID>. The pipeline will exit with an error message if you try to run it pipeline with the UPPMAX config profile without a project.

Optional Extra: To avoid having to specify your project every time you run Nextflow, you can add it to your personal Nextflow config file instead. Add this line to ~/.nextflow/config:

params.project = 'project_ID' // eg. b2017123

Running offline

If you are running the pipeline on Bianca or Irma, you will not have an active internet connection and some automated features will not be able to function. Specifically, you'll need to transfer the pipeline files and the singularity image manually.

First, to generate the singularity image, run the following command. Note that you need singularity installed - this is available on the other UPPMAX clusters (Milou and Rackham):

First, pull the image file where you have an internet connection:

NB: The "tag" at the end of this command corresponds to the pipeline version. Here, we're pulling the docker image for version 1.0 of the nfcore/rnaseq pipeline Make sure that this tag corresponds to the version of the pipeline that you're using

singularity pull --name nfcore-rnaseq-1.0.img docker://nfcore/rnaseq:1.0
pwd # Prints path to your singularity container

The nfcore/rnaseq pipeline files can be downloaded from https://github.com/nf-core/rnaseq/releases

Download the pipeline files and transfer the compressed archive (the .zip or .tar.gz file). Once transferred, extract the pipeline files. For example, with a .zip file:

unzip 1.0.zip
mv nfcore-rnaseq-1.0 nfcore-rnaseq # rename the folder
cd nfcore-rnaseq-1.0
pwd # Prints full path to your pipeline

Finally, move to the directory where you want to run the pipeline and execute Nextflow with the path to the pipeline, as so:

cd /path/to/my/data/analysis
nextflow run /path/to/nfcore-rnaseq-1.0 -with-singularity /path/to/singularity/nfcore-rnaseq-1.0.img

(Note that you'll need the other common flags such as --reads and --genome in addition to this command).

NB: Note that you should not use the -r 1.0 flag recommended elsewhere. This tells Nextflow to download that version of the code when it runs. Here, you have already downloaded the code, so it generates an error.

Environment modules and development

If you would prefer to use environment modules instead of singularity, you can use the old version of the configuration by specifying -profile uppmax_modules (we don't recommend this).

For pipeline development work on milou, use -profile uppmax_devel - this uses the milou devel partition for testing the pipeline quickly. Please note that this is not suitable for proper analysis runs - only tiny test datasets.