Blugold Center for High Performance Computing

If you are working off-campus, you will need to use the UWEC VPN. Please visit our help area for more information.

Your account for the clusters is the same as your university login information that you use for other UWEC services, though the username must be lowercase.

Cluster	Hostname	Port	SSH Command	VPN Required
BGSC2	bgsc2.uwec.edu	22	ssh username@bgsc2.uwec.edu	Off Campus Only
BOSE (Special Access Required)	bose.hpc.uwec.edu	50022	ssh username@bose.hpc.uwec.edu -p 50022	Always

To facilitate job scheduling on our clusters, we use the software 'Slurm' to look at what resources you need and run your script on one (or more) of the compute nodes once there is availability.

Step 1: Identify Module / Software

The first step to submitting a job on the cluster is to determine if the software you need is available on the cluster, and if so, what is it called. Use the command below to see all available software currently installed on the cluster you are using.

module avail

Once you identified what it is, you can use the following command to make it available for your current logged in session:

module load <software>/<version>

After using the above command, you'll have access to the commands to run the software. Note that you must do this directly in the submission script (Step 2) each time you want to use it.

Step 2: Submission Script

The next step to submitting a job on the cluster is to create a submission file that contains a list of all the resources you need and what commands you'd like Slurm to run on the nodes. 

Here is an example of a Slurm submission script that you can start with:

#!/bin/bash

#SBATCH --partition=week                                                 #Partition to submit to

#SBATCH --time=0-04:00:00                                                   #Time limit for this job (DD-HH-MM-SS)

#SBATCH --nodes=1                                                              #Nodes to be used for this job during runtime

#SBATCH --ntasks-per-node=1                                           #Number of CPU's Per node

#SBATCH --mem=1G                                                           #Total memory required for this job (1G = 1 Gigabyte)

#SBATCH --job-name="Slurm Sample"                              #Name of this job in work queue

#SBATCH --output=ssample.out                                         #Output file name

#SBATCH --output=ssample.err                                          #Error file name

#SBATCH --mail-user=<your desired email address>       #Email to send notifications to

#SBATCH --mail-type=ALL                                                  #Email notification type (BEGIN, END, FAIL, ALL)

#SBATCH --gpus=#                        # How many GPU cards do you need? (Only needed for GPU-based jobs on BOSE)

 

# Your Commands Below

module load <software>/<version>  # Load the required software

./command option1 option2   # Run the command for the software

 

The flags listed below are subject to change to the needs of your job.

#SBATCH --time=0-04:00:00       (The time format here is DD-HH:MM:SS, example is 4 hours)

#SBATCH --ntasks-per-node=1

#SBATCH --mem=150

#SBATCH --job-name="Slurm Sample"

#SBATCH --output=ssample.out

#SBATCH --output=ssample.err

#SBATCH --gpus=#

 

Step 3: Submit the job

Once you have your submission script created and all ready to go, use the following command to submit it:

sbatch <your script name>

 

Step 4: View your jobs

After your job is submitted, you can use the following commands to see all jobs in the submission queue as well as specifically the ones you submitted.

myjobs   <-- View your submitted jobs

squeue    <-- View all jobs on the queue

Do you have software that you want installed on either of our clusters (BGSC2 and/or BOSE) that is needed for your research or class project? We have an eForm available for you to fill out, which you can access by clicking the link below and selecting the "Software Request" option.

Start eForm Now (UWEC Login Required)

Please note that software installs are subject to approval and we are unable to install licensed software unless you have access to the license for your group.

To access the BOSE cluster, you'll need approval before you are able to connect to it. To request access, please fill out the eForm by clicking the link below and selecting the "Request Access to BOSE" option.

Start eForm Now (UWEC Login Required)

In your class, are you planning to use one of the supercomputing clusters for activities such as homework and/or exams? To ensure availability of cluster resources, you are able to reserve one or more nodes ahead of time. To request a reservation, use the eForm link below and choose the "Reserve a Node" option.

Start eForm Now (UWEC Login Required)

Please note that reservation requests are subject to approval and we cannot guarantee we're able to fully honor your request. We also are not taking reservations for research groups at this time.