Revision as of 00:12, 5 June 2025

MUSE HPC 2025 Workshop #2

Login to ELSA's Open OnDemand web portal with your TCNJ login and password
- Open browser and go to https://ondemand.hpc.tcnj.edu/
- Create your home directory if necessary by following the on-screen instructions

Additional help for this tutorial can be found at Accessing the Cluster via Open OnDemand

Login to the Open OnDemand port if you're not already logged in
Using the Open OnDemand menu, go to Clusters and choose _ELSA OpenHPC Cluster Shell Access
Execute Linux commands at the terminal prompt, e.g. ls
When you are done with the terminal, type exit at the command prompt and close the browser tab

Additional help for this tutorial can be found at Accessing the Cluster via SSH using Open OnDemand

Open a terminal shell again
Add the ELSA tutorial module by running module add elsa-tutorial
Run the ELSA tutorial setup script elsa-tutorial-setup.sh
Change to elsa-tutorial directory cd elsa-tutorial
Look at the a submit script cat submit.sh
Look at the other submit scripts in the tutorial directory using either cat or the Open OnDemand file manager
Edit the submit.sh script to change the email address to your email address and "Your name" in the export line to your own name. Use either nano or the Open OnDemand edit file option in the file manager
[Optional] Edit the other submit scripts to change the email address to your email address. Use either nano or the Open OnDemand edit file option in the file manager
Run the job sbatch submit.sh (this one will finish quickly)
Review the job.jobnumber.out file cat job.####.out or use the Open OnDemand file manager to view the contents
Run the other three jobs (these run much faster), e.g. sbatch submit-mpi.sh then sbatch submit-mpi.sh and finally sbatch submit-gpu.sh
Review the job output files for these jobs

Additional help for this tutorial can be found at Submitting Your First HPC Job

Download the zip file from Another Pi Implementation to your computer
Unpack the zip on your local machine
Make a new folder in your ELSA cluster home directory (e.g. workshop1)
Upload at least the mpi-pi-numinteg program (optionally upload the other files) to the folder you created above
Copy the submit-mpi.sh script from the elsa-tutorial folder
Edit the copy to make any necessary changes
- Change the command to run from mdart 50000 10000 to ./mpi-pi-numinteg
- Use 2 nodes with 16 ntasks
Change permissions on the mpi-pi-numinteg program while in the Linux shell to make it executable
- chmod +x mpi-pi-numinteg
Run the job by submitting it from the Linux shell
Review the job.jobnumber.out file

@@ Line 23: / Line 23: @@
 # Edit the <code>submit.sh</code> script to change the email address to your email address and "Your name" in the '''export''' line to your own name. Use either <code>nano</code> or the Open OnDemand edit file option in the file manager
 # [Optional] Edit the other submit scripts to change the email address to your email address. Use either <code>nano</code> or the Open OnDemand edit file option in the file manager
-# Run the serial job <code>sbatch submit-serial.sh</code> (this one can take 2-3 minutes to complete)
+# Run the job <code>sbatch submit.sh</code> (this one will finish quickly)
 # Review the job.'''jobnumber'''.out file <code>cat job.####.out</code> or use the Open OnDemand file manager to view the contents
-# Run the other two jobs (these run much faster)
+# Run the other three jobs (these run much faster), e.g. <code>sbatch submit-mpi.sh</code> then <code>sbatch submit-mpi.sh</code> and finally <code>sbatch submit-gpu.sh</code>
 # Review the job output files for these jobs
 Additional help for this tutorial can be found at [https://docs.hpc.tcnj.edu/index.php/HPC_Cluster_Job_Scheduler#Submitting_Your_First_HPC_Job Submitting Your First HPC Job]