New User QuickStart
Case: You are tired of putting sticky notes on your lab computer that say “leave machine on, job in progress” and your laptop hard drive is full. You need to consider using the KSU HPC.
-
Get an Account
HPC Account Request Form
Note: Faculty can request their own accounts or can sponsor accounts for students. -
Install the Global Protect VPN Client
Install the global protect vpn client from vpn.kennesaw.edu.
Guide: KSU Campus Network Access - Mac
Video: KSU VPN for Mac Users
Guide: KSU Campus Network Access - Windows
Video: KSU VPN for Windows UsersNote: A VPN connection is required to access the HPC for both on and off-campus users.
-
Mac
Launch Self Service app to install vpn-groups.kennesaw.edu to your settings.
In your top menu bar, use the globe icon to click ‘Connect’.
-
Windows
In the connection settings of Global Protect, add vpn-groups.kennesaw.edu.
In you system tray, use the globe icon to click ‘Connect’.
-
Upload Your File(s):
Mac: Launch Cyberduck and ‘Open Connection’ with the SFTP protocol. (Video help)
Server: hpc.kennesaw.edu Port: 22
Username: your_netid
Password: your_netid_password
08/22: There is a DUO authentication step required. (Example)
Win: Launch Bitvise SFTP session. (Video help)Server: hpc.kennesaw.edu Port: 22
Username: your_netid
Password: your_netid_password
Note: If asked to accept a private key, click 'Yes' to trust host.
08/22: There is a DUO authentication step required.
(1 - Duo push, 2 - Phone call) -
Start an SSH Session
Mac: Launch Terminal.app
At the prompt, enter ‘ssh your_netid@hpc.kennesaw.edu’
08/22: There is a DUO authentication step required.Win: Launch Power Shell
At the prompt, enter ‘ssh your_netid@hpc.kennesaw.edu’
08/22: There is a DUO authentication step required. (Example) -
Test Your Code or Process
Once logged in, your session will begin on a login node
Note: Do not test your code or run cpu intensive applications on the login node.
Use the ‘interact’ script to reserve a 1 compute node for your own use for an hour.
$ interact
To request more time (8 hour max) and more nodes (Ex. 2)
$ interact -t 8:00:00 -n 2
For all the options, $ interact -help
Note: once your testing is complete, exit your interact session before submitting your qsub reservation.
$ exit
-
Build a Simple Submission Script (my_script.pbs)
#!/bin/bash
#PBS -N your_script_name
#PBS -l nodes=1:ppn=1
#PBS -l walltime=01:00:00
#PBS -m abe
#PBS -M your_netid@kennesaw.eduJOBID=`echo #PBS_JOBID | cut -f1 -d.`
this_is_where_your_code_or_program_call_goes
exit 0
-
Submit Your Job Submission Script
$ qsub my_script.pbs -
Review Your Results
$ cat your_results.file -
Exit
$exit