This page is an insanely simple guide to just barely get you going. The documentation on this page will not be complete. It will not tell you everything. It will tell you just enough to get started with using Research Computing Cluster. First off, email email@example.com if you encounter any issues with the cluster or if your account doesn't get created within 1 hour of completing the Apply process.
Apply for Access to Research Computing
Go to http://rc.rit.edu/apply and login with your RIT username and password. It's as simple as that! If 1 hour passes without receiving an account creation email, please contact us at firstname.lastname@example.org.
Logging in to Research Computing
You may either use an SSH client or Remote Desktop (RDP) client to connect to ion.rc.rit.edu , the Research Computing Cluster Job Submission Node. When prompted for credentials, please use your RIT username and password.
Check the full articles on SSH and RDP, if it is your first time working with remote systems. For more information on how to move files between your RC Home Directory and another machine, please see Remote File Access.
SLURM – The Cluster Scheduler
Simple Linux Utility Resource Manager. It manages running your research computation on the Research Computing ClusterResearch Computing also has a new website! It has much of the same information as the wiki, but also includes our questionnaire, a place to catalog your research projects with us, and is overall aesthetically prettier (if you love RIT branding, you'll love this site). We are still in the process of making it as useful for researchers as possible so expect changes, and if you have any feedback don't be hesitant to contact us.
Apply for a User Account
In order to access SPORC and begin using Research Computing's resources you must first apply for a Research Computing User account. You will need to login in with you RIT username and password, and an account will be made for you. If one hour passes without receiving an account creation email us.
Click Here to Apply!
Research Computing aims to know the researchers, their research, and their computational and research computing needs. After creating an account make sure to fill out this questionnaire so we can provide what you need for your project. After completion, you response can be found under My Projects.
Logging in to Research Computing
Now that you have an account, you are ready to get onto our cluster, SPORC. To login SPORC or other Research Computing provided resources, you will need to use either SSH or FastX. The first time you access SPORC, I would recommend you do it through SSH. FastX is useful for when you need a graphical interface, such as when you are visualizing data or analyzing graphs. Remember: the host name for SPORC is sporcsubmit.rc.rit.edu.
Navigating the Terminal
Whether you logged in with SSH or FastX, it important that you know how to navigate the terminal. Through the terminal you will do most of the work for your research with Research Computing, including but not limited to : creating and editing files, loading software, and running jobs. If you have never used a terminal before, start by learning some Basic Unix Commands and how to use a Text Editor.
SLURM – The Cluster Scheduler
Slurm is the software we use to manage your research computation on SPORC. You tell it what resources you need (read this if you need help determining what you need), and it dispatches your work to one or more of those computers that make up SPORC, and then the program runs to completion. When your work is done, SLURM Slurm frees up those resources so that someone else can use them. There are Below we have outlined two ways to submit work:jobs. Before writing and submitting your first job, become familiar with how to view your jobs and the resources available on SPORC.
View Slurm Basic Commands documentation.
Using a SLURM Batch File (sbatch)
This is the preferred method for creating work for the Research Computing Cluster. An SBATCH file consists of some commands telling SLURM Slurm what resources you need, followed by the Linux commands necessary to perform the requested work. Here you can tell SLURM Slurm how many cores (CPU) you need and how much memory (RAM), as well as how long to let your job run before it has taken too long. This file can then be run using the "sbatch" command to submit it to the SLURM Slurm Queue.
For more information on SLURM parameters see SLURM SchedulerFor example SBATCH files, please run "grab-examples" from the command line. This will create the folder "slurm-examples" in your Home Directory and fill it will some scripts showing you the basic usage of the cluster. NOTE: Since the examples were made, we have changed the name of our partitions (groups of certain computers). Instead of
#SBATCH -p work -n 4 use
#SBATCH -p tier3 -n 4.
Using Interactive Mode (sinteractive)
If you need user interaction or are only running something once then run `sinteractive`. This will ask you for the resources you require and then connect you to the scheduled node. If you don't know what that entails, just try it. Be sure to exit from your sinteractive session by running exit when you're done, otherwise you're a terrible person for requesting resources you aren't using. See For the full SLURM user documentation if you need to make batch jobs or want to learn about other cool commands like squeue, sbatch, scontrol, sacct, scancel, and smap.process, see our documentation.
View Submitting a job with sinteractive documentation.
- Try to avoid requesting more resources than you need on the cluster. Any resources that you tell SLURM Slurm you're going to use cannot be offered to other users regardless of whether you actually use those resources. If you fudge your numbers too much, you're eligible to have your allocation terminated by admins.
- "sinteractive" is not the best way to run jobs by any means. For any sort of repeatable workflow, you will need to write SBATCH jobs.
- "sinteractive" uses the Linux Screen utility. For more help see Screen Help.
Your research more than likely needs software, whether it's for creating, analyzing, or visualizing data. So before you start researching, you need to learn how to use modules. Modules are the way Research Computing provides a lot of software without it all conflicting with each other. If you need it, we might have it as a module. Run `module avail` to see what modules we have available for loading. From that list, you can run `module load <NAME>/<VERSION>` where <NAME>/<VERSION> is from that list. For example, you can run `module load R/3.1.1` and then you magically have access to that version of R.. If we don't have it email us.
View Using Modules documentation.
Need More Help?
If you need help using any Research Computing resources, don't hesitate to stop by our lab. Our infrastructure is changing all the time and our documentation may not always be up-to-date. We're more than happy to work with you to accommodate your research needs.