Get more informative slurm email notification and logs through rcbio/1.3.3

1 Log on to O2
2 Start interactive job, and create working folder
3 Load the pipeline related modules
4 The bash script
5 Submit the script to Slurm:
6 Monitoring the jobs
7 Check job log
8 Re-run the job
9 To run your own script as Slurm pipeline

This page shows you how to run submit a bash script to Slurm. The runSingle script, accessible through the rcbio/1.3.3 module, converts an input bash script with sbatch command and submits a single job to the Slurm scheduler for you.

Features of the new way of submitting job:

Informative email notifications are sent when job fails or succeeds.
Get a better log with memory and CPU usage.
Auto re-run in case node fails.
When re-running on the same data folder, the user is asked to confirm to re-run or not if it was done successfully earlier.

Please read below for an example.

Log on to O2

If you need help connecting to O2, please review the Using Slurm Basic and the How to Login to O2 wiki pages.

From Windows, use the graphical PuTTY program to connect to o2.hms.harvard.edu and make sure the port is set to the default value of 22.

From a Mac Terminal, use the ssh command, inserting your HMS ID instead of user123:

ssh user123@o2.hms.harvard.edu

Start interactive job, and create working folder

For example, for user abc123, the working directory will be

srun --pty -p interactive -t 0-12:0:0 --mem 2000MB -c 1 /bin/bash
mkdir /n/scratch/users/${USER:0:1}/${USER}/test
cd /n/scratch/users/${USER:0:1}/${USER}/test

# This will setup the path and environmental variables for the pipeline
module load rcbio/1.3.3

The bash script

Submit the script to Slurm:

Monitoring the jobs

You can use the command:

To see the job status (running, pending, etc.). You also get two emails for each step, one at the start of the step, one at the end of the step.

Check job log

You can use the command:

This command list all the logs created by the pipeline runner. *.sh files are the slurm scripts for each step, *.out files are output files for each step, *.success files means job successfully finished for each step and *.failed means job failed for each steps.

You also get two emails for each step, one at the start of the step, one at the end of the step.

Re-run the job

You can rerun this command in the same folder

This command will check if the earlier run is finished or not. If not, ask user to kill the running jobs or not, then ask user to rerun the successfully finished steps or not. Click 'y', it will rerun, directly press 'enter' key, it will not rerun.

To run your own script as Slurm pipeline

In the example above, we run a bash script. You can run any command you like:

Let us know if you have any questions. Please include your working folder and commands used in your email. Any comments and suggestions are welcome!