Job management with SLURM

For complete SLURM documentation, see https://slurm.schedmd.com/. Here we only show simple examples with system-specific instructions.

HAL Slurm Wrapper Suite (Recommended)

Introduction

The HAL Slurm Wrapper Suite was designed to help users use the HAL system easily and efficiently. The current version is "swsuite-v0.1", which includes

srun (slurm command) → swrun : request resources to run interactive jobs.

sbatch (slurm command) → swbatch : request resource to submit a batch script to Slurm.

Rule of Thumb

• Minimize the required input options.
• Consistent with the original "slurm" run-script format.
• Submits job to suitable partition based on the number of GPUs needed.

Usage

• swrun -p <partition_name> -c <cpu_per_gpu> -t <walltime>
  • <partition_name> (required) : cpu, gpux1, gpux2, gpux3, gpux4, gpux8, gpux12, gpux16.
  • <cpu_per_gpu> (optional) : 12 cpus (default), range from 12 cpus to 36 cpus.
  • <walltime> (optional) : 24 hours (default), range from 1 hour to 72 hours.
  • example: swrun -q gpux4 -c 36 -t 72 (request a full node: 1x node, x4 node, 144x cpus, 72x hours)
• swbatch <run_script>
  • <run_script> (required) : same as original slurm batch.
  • <job_name> (optional) : job name.
  • <output_file> (optional) : output file name.
  • <error_file> (optional) : error file name.
  • <partition_name> (required) : cpu, gpux1, gpux2, gpux3, gpux4, gpux8, gpux12, gpux16.
  • <cpu_per_gpu> (optional) : 12 cpus (default), range from 12 cpus to 36 cpus.
  • <walltime> (optional) : 24 hours (default), range from 1 hour to 72 hours.

  • example: swbatch demo.sb

    demo.sb

    #!/bin/bash
    
    #SBATCH --job-name="demo"
    #SBATCH --output="demo.%j.%N.out"
    #SBATCH --error="demo.%j.%N.err"
    #SBATCH --partition=gpux1
    
    srun hostname

New Job Queues

HAL Wrapper Suite Example Job Scripts

New users should check the example job scripts at "/opt/samples/runscripts" and request adequate resources.

Native SLURM style

Submit Interactive Job with "srun"

srun --partition=debug --pty --nodes=1 \
--ntasks-per-node=12 --cores-per-socket=12 --mem-per-cpu=1500 --gres=gpu:v100:1 \
-t 01:30:00 --wait=0 \
--export=ALL /bin/bash

Submit Batch Job

sbatch [job_script]

Check Job Status

squeue                # check all jobs from all users 
squeue -u [user_name] # check all jobs belong to user_name

Cancel Running Job

scancel [job_id] # cancel job with [job_id]

Job Queues

HAL Example Job Scripts

New users should check the example job scripts at "/opt/apps/samples-runscript" and request adequate resources.

PBS style

Some PBS commands are supported by SLURM.

Check Node Status

pbsnodes

Check Job Status

qstat -f [job_number]

Check Queue Status

qstat

Delete Job

qdel [job_number]

Submit Batch Job

$ cat test.pbs
#!/usr/bin/sh
#PBS -N test
#PBS -l nodes=1
#PBS -l walltime=10:00

hostname
$ qsub test.pbs
107
$ cat test.pbs.o107
hal01.hal.ncsa.illinois.edu