GETTING LOGGED ON

Users will need to use ssh from their local machine to log into Research Computing clusters.

OnDemand Web Portal for Longleaf:  video

In addition to the command line methods described below for Linux, Windows, and Mac clients, you can use a web browser to work with Longleaf. See the OnDemand Web Portal documentation for more information.

Linux: video

Linux users can use ssh from within their Terminal application to connect to Longleaf or Dogwood.

If you wish to enable x11 forwarding use the “-X” or “-Y” ssh option. Be sure to use your UNC ONYEN and password for the login. The following are ssh commands for each cluster.

For Longleaf:

ssh -X <onyen>@longleaf.unc.edu

For Dogwood:

ssh -X <onyen>@dogwood.unc.edu

Windows:

We suggest Windows users download MobaXterm (Home Edition, Installer Edition) or other ssh clients (e.g. Putty, PowerShell, etc.). Then use the Session icon to create a Longleaf SSH session using longleaf.unc.edu for “Remote host” and your ONYEN for the “username” (Port should be left at 22). The steps for Dogwood are identical except the Session icon is used to create a Dogwood session using dogwood.unc.edu for “Remote host.”

Mac:

Mac users can use ssh from within their Terminal application (under the Utilities folder in Applications) to connect to Longleaf or Dogwood. The following are ssh commands for each cluster (be sure to use your UNC ONYEN and password for the login).

For Longleaf:

ssh -X <onyen>@longleaf.unc.edu

For Dogwood:

ssh -X <onyen>@dogwood.unc.edu

To enable x11 forwarding Mac users will need to download, install, and run Xquartz on their local machine in addition to using the “-X” or “-Y” ssh option. Furthermore, in many instances for x11 forwarding to work properly Mac users need to use the Terminal application that comes with Xquartz instead of the default Mac terminal application.

A successful login takes you to “login node” resources that have been set aside for user access. The login node is where you will edit your code, execute basic UNIX commands, and submit your jobs from to the SLURM job scheduler.

DO NOT RUN YOUR CODE OR RESEARCH APPLICATIONS DIRECTLY ON THE LOGIN NODE. THESE MUST BE SUBMITTED TO SLURM!

In order to connect to Longleaf from an off-campus location, a connection to the campus network through a VPN connection is required.