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.

  • HPC Account Request Form
    Note: Faculty can request their own accounts or can sponsor accounts for students.
  • 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 Users

    Note: A VPN connection is required to access the HPC for both on and off-campus users.

  • 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’.

  • In the connection settings of Global Protect, add vpn-groups.kennesaw.edu.

    In you system tray, use the globe icon to click ‘Connect’.

  • 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)

  • 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)

  • 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

  • #!/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.edu

    JOBID=`echo #PBS_JOBID | cut -f1 -d.`

    this_is_where_your_code_or_program_call_goes

    exit 0

  • $ qsub my_script.pbs
  • $ cat your_results.file
  • $exit