Initiating an Interactive Session
Overview
General information on how to initiate an interactive session, including requesting custom resources, and general information on X11 forwarding.
Interactive Session
Normally, compute nodes are only accessible to programs or jobs submitted as sbatch scripts to the scheduler. This mode of operation is ideal for well-understood research computing pipelines but may need to be approached more piecemeal through interactive sessions on compute nodes. This page documents how to obtain interactive shell sessions on compute nodes. Note that interactive graphical sessions are available through the Web Portal.
Once logged in, to launch an interactive compute session, simply run the following command:
interactive
This will launch an interactive compute session on one of the conventional compute nodes (specifically granting one core for up to four hours within the htc
partition).
Once the session launches, you can begin using the system through the terminal window.
X11 Forwarding is Automatic
If you need to run an X11-based program, launch an interactive session and run the program from within that terminal session.
This will automatically use the X11-forwarding feature built into your shell (in the case of Linux). On MacOS and Windows, using X11 apps natively on your workstation desktop may require an X11 client (such as Xquartz or Cygwin/X. The setup and use of these applications are beyond the scope of this document.
We recommend using the Web Portal for better graphical sessions.
Interactive Session Options
The interactive
command will work with many of the same options and switches as other slurm job-launching commands. This is because interactive
is an sbatch job under the hood. Any option that would be passed within a sbatch
script or to the sbatch
command itself will be accepted by interactive
and will override its defaults.
For example, you can specify how many CPU cores you want your interactive session to use with the -c number
option.
You can also specify how long you would like your session to run with the -t days-hours:minutes
option.
An example of using these options to launch an interactive session that uses 8 CPU cores on one node, runs for zero days and 4 hours
interactive -c 8 -N 1 -t 0-4:00