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
SSH
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 |
#!/bin/bash
|
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). |
#MSUB -N <JOBNAME>
|
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>
or
#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>
Running an Interactive Session
The CSULB HPC supports running an interactive session via the terminal. Execute the "msub" command while defining walltime and resources required. Adding the trailing "-I" will indicate an interactive session.
msub -l walltime=<dd:hh:mm:ss> -l nodes=<N>:ppn=<p> -I
Managing Your Jobs
| Command |
Description |
showq
|
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.