New User Guide for HAL System

Step 1. Apply for a User Account

New user need to fill out THIS FORM to apply a system account.

After login with your NetID, you will need to fill out TWO forms.

By clicking "Submit Form", you only complete the FIRST form, please click "HERE" to complete the second form.

Step 2. Set up DUO device

New user needs to set up his/her DUO device via https://duo.security.ncsa.illinois.edu/. If there has any problem, See https://go.ncsa.illinois.edu/2fa for common questions and answers. Send an email to help+duo@ncsa.illinois.edu for additional help. 

Step 3. Log on for the First Time with SSH

New user needs to log on HAL system for the first time with SSH to initialize his/her accounts.

ssh <username>@hal.ncsa.illinois.edu

Interactive jobs

Starting an interactive job

Using original slurm command

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

Using slurm wrapper suite command

swrun -p gpux1

Keeping interactive jobs alive

Interactive jobs cease when you disconnect from the login node either by choice or by internet connection problems. To keep an interactive job alive you can use a terminal multiplexer like tmux.

You start tmux on the login node before you get an interactive slurm session with srun and then do all the work in it. In case of a disconnect you simply reconnect to the login node and attach to the tmux session again by typing:

tmux attach

or in case you have multiple session running:

tmux list-session
tmux attach -t <session_id>

Batch jobs

submit job with

#!/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

Step 4. Log on HAL System with HAL OnDemand

https://hal.ncsa.illinois.edu:8888