HPC User Guide

This page provides assistance getting started with connecting to, and submitting jobs on the CSULB central High Performance Computing (HPC) cluster.

How to Access the Central HPC

Web UI

The central HPC offers a graphical user interface that is accessible via a web browser. Please connect via SSH once before using the web UI. This is necessary to automatically provision a home folder.

URL: https://hpc.its.csulb.edu


If you are not on a device connected to the campus network, please connect to the campus virtual private network (VPN).

Server name: hpc.its.csulb.edu

Authentication: campus ID and password

Command and Options

Command Description
REQUIRED: The first line of your script, specifying the type of shell (in this case, bash) to use
#MSUB -l walltime=<dd:hh:mm:ss>
Provides the scheduler with the time needed for your job to run so resources can be allocated. If no walltime is provided, the default value is 00:01:00:00 (one hour).
Give the job a descriptive name
#MSUB -m abe
Sends an email if your job (a)borts, (b)egins, or (e)nds. You can use any combination of the 3 letters
#MSUB -M <your_emailaddress>
Specifies email address, can be a comma separated list of users.
#MSUB -l nodes=<N>:ppn=<p>
#MSUB -l procs=<n>
The first option specifies how many nodes and how many ppn (processors (cores) per node). Nodes can be defined as a digit quantity, or a specific node such as n001.cluster.com. The second option specifies how many processors total without restricting them to being on a specific number of nodes. Use only one of these lines, NOT both. If neither of these options are used, one core on one node will be allocated.
#MSUB -l nodes=<N>:gpus:<g>
To request GPU resources define the number of nodes needed (generally one) and how many gpus.
#MSUB -j oe
Joins the (o)utput and (e)rror files into a single file. By default the name of the output file will be of the form JOBNAME.oJOBID, and the file will be in the directory from which you submitted the job.
#MSUB -o <outlog>
Writes the output log for the job into a file named outlog (you can change this file name). If not specified, the output log is written to a file in the directory you submitted the job from that is named according to JOBNAME.oJOBID.
#MSUB -e <errlog>
Writes the error file for the job into a file named errlog (you can change this file name). If not specified, the error log is written to a file in the directory you submitted the job from that is named according to JOBNAME.eJOBID.

Submitting a Batch Job

Saved scripts can be submitted to the HPC via the command line. To submit your script type:

msub <name_of_script>

Managing Your Jobs

Command Description
Shows all active jobs and their job numbers
showq -u <your_BeachID>
Shows your active jobs and their job numbers
checkjob <job_number>
Shows information about your specific job, including job status
checkjob -v <job_number>
Detailed report from checkjob which is useful for debugging
canceljob <job_number>
Cancels your job from the command line
canceljob ALL
Cancels all of your jobs from the command line

Contact for Help

For technical assistance, contact ITS HPC Support at ITS-HPCSupport@csulb.edu.

Print Article


Article ID: 60907
Tue 8/21/18 2:39 PM
Tue 10/3/23 12:08 PM

Related Services / Offerings (1)

Division of Information Technology (DoIT) offers a Central High Performance Computing (HPC) environment for Faculty computing in their pursuit of teaching and learning. This service includes shared cycles on several high performance clusters equipped with a variety of research software packages.