Page History

<div style="background-color: yellow; border: 2px solid red; margin: 4px; padding: 2px; font-weight: bold; text-align: center;">
The HAL documentation has moved to <a href="https://docs.ncsa.illinois.edu/systems/hal/">https://docs.ncsa.illinois.edu/systems/hal/</a>. Please update any bookmarks you may have.
<br>
Click the link above if you are not automatically redirected in 7 seconds.
</br>
</div>
<meta http-equiv="refresh" content="7; URL='https://docs.ncsa.illinois.edu/systems/hal/en/latest/user-guide/running-jobs.html'" />

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

...

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

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

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

squeue (slurm command) → swqueue : check current running jobs and computational resource status.

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 (number of nodes for CPU partition).

Usage

• swrun -p <partition_name> -c <cpu_per_gpu> -t <walltime> -r <reservation_name>
  • <partition_name> (required) : cpucpun1, cpun2, cpun4, cpun8, gpux1, gpux2, gpux3, gpux4, gpux8, gpux12, gpux16.
  • <cpu_per_gpu> (optional) : 12 16 cpus (default), range from 12 16 cpus to 36 40 cpus.
  • <walltime> (optional) : 24 4 hours (default), range from 1 hour to 72 hours24 hours in integer format.
  • <reservation_name> (optional) : reservation name granted to user.
  • example: swrun -q p gpux4 -c 36 40 -t 72 24 (request a full node: 1x node, x4 node4x gpus, 144x 160x cpus, 72x 24x hours)
  • Using interactive jobs to run long-running scripts is not recommended. If you are going to walk away from your computer while your script is running, consider submitting a batch job. Unattended interactive sessions can remain idle until they run out of walltime and thus block out resources from other users. We will issue warnings when we find resource-heavy idle interactive sessions and repeated offenses may result in revocation of access rights.
• swbatch <run_script>
  • <run_script> (required) : same as original slurm batch.
  • <job_name> name> (requiredoptional) : job name.
  • <output_file> (requiredoptional) : output file name.
  • <error_file> file> (requiredoptional) : error file name.
  • <partition_name> (required) : cpucpun1, cpun2, cpun4, cpun8, gpux1, gpux2, gpux3, gpux4, gpux8, gpux12, gpux16.
  • <cpu_per_gpu> (optional) : 12 16 cpus (default), range from 12 16 cpus to 36 40 cpus.
  • <walltime> (optional) : 24 hours (default), range from 1 hour to 72 24 hours in integer format.
  • <reservation_name> (optional) : reservation name granted to user.

  • example: swbatch demo.sbswb

    Code Block
    language bash title demo.sbswb
    #!/bin/bash #SBATCH --job-name="demo" #SBATCH --output="demo.%j.%N.out" #SBATCH --error="demo.%j.%N.err" #SBATCH --partition=gpux1 #SBATCH --time=4 srun hostname

    
    

• swqueue
  • example: 
  • Image Added

New Job Queues (SWSuite only)

HAL Wrapper Suite Example Job Scripts

...

Native SLURM style

Available Queues

Submit Interactive Job with "srun"

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

Submit Batch Job

...

scancel [job_id] # cancel job with [job_id]

Job Queues

...

Max CPUs
Per Node

...

Max Memory
Per CPU (GB)

...

HAL Example Job Scripts

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

...

Max
Walltime

...

PBS style

Some PBS commands are supported by SLURM.

...