Quest Quick Start Guide

On May 1st, 2019 the Quest scheduler changed from Moab to Slurm. Researchers using Quest will have to update their job submission scripts and use different commands to run under the new scheduler.

This page provides help getting started with connecting to, accessing software on, and submitting jobs to the Quest computing cluster.

You will need to be logged in to Quest to get started. Visit Logging into Quest for further instructions.

For a video tutorial of Quest, see Introduction to Quest Fundamentals.

Navigating Quest

Once you've logged into Quest, you will begin in your Home directory: /home/<NetID>. The home directory has 80GB of storage and is backed up nightly. Backups are kept for two weeks.

Note that throughout this guide, items in angle brackets (<>) in example commands are parameters you need to change relative to your account and work. Do not include <> around the values you substitute into the commands.

You can navigate to the projects directory of your allocation by typing

cd /projects/<project_id>

Project directories are not backed up. You can check how much storage you have by typing

checkproject <project_id>

If you are not familiar with using command line, this tutorial, Learning the Shell, will help you learn the basics.

Moving Files onto Quest

Please visit the Transferring Files on Quest web page for information about transferring files from your local machine, Northwestern Box, Research Data Storage Service, or elsewhere, to Quest.

Software available on Quest

Many applications are available on Quest. You can access them through modules, which modify your environment to enable you to run the software. Quest uses modules so that multiple versions of the same software can be available for different users.

See Modules Software Environment Manager for examples of loading software with modules and a list of common commands.

If you would like additional software packages installed on Quest, please fill out the Software Installation Request Form. Additionally, you can also install software in your own home or project directories. For details, review our Installing Software on Quest page.

Running Jobs on Quest

When you first log in to Quest, you will be on one of the four login nodes: quser21, quser22, quser23, or quser24. From the login nodes, you can submit jobs to the compute nodes, edit files, and perform small test jobs. Login node use is limited to 4 cores and 4 GB of RAM per user.

To take advantage of Quest's computing power, jobs can be submitted to the compute nodes in two ways: Interactive jobs, which are particularly useful for GUI applications, or Batch jobs, which are the most common jobs on Quest. Interactive jobs are appropriate for GUI applications like Stata, Visit, Paraview, etc., testing and prototyping of programs, running jobs with small core counts (< 6), and for short duration jobs. Batch jobs are appropriate for jobs with no GUI interface, large core counts, or long duration.

See Submitting a Job on Quest for more details, example job submission commands, and an example of a submission script.

Managing Your Jobs on Quest

Command Description
squeue -u <NetID> Shows your jobs on the queue
squeue -A <AllocationID> Shows your jobs belonging to specified allocation
checkjob <JobID> Shows detailed information about specified job
scancel <JobID> Cancels your job from the command line
scancel -u <NetID> Cancels all of your jobs from the command line

For more information about managing your jobs visit Managing Jobs on Quest.

Getting Help

Learn more about using Quest from our documentation or attend one of our Introduction to Quest trainings. If you need more personalized assistance, send an email stating your issue to quest-help@northwestern.edu and the Northwestern IT Research Computing Services team will assist you with your issue.




Keywords:Quest, jobs, script, software, batch quickstart   Doc ID:70706
Owner:Research Computing .Group:Northwestern
Created:2017-02-15 16:16 CDTUpdated:2019-05-01 07:38 CDT
Sites:Northwestern
CleanURL:https://kb.northwestern.edu/quest-quickstart
Feedback:  3   1