To log in you will need an SSH client. We recommend PuTTY SSH but others are also available. After using PuTTY to get to
gw.hpc.nyu.edu you will use the program
ssh from a terminal window. If you are unfamiliar with the command line interface this may seem daunting - relax, it's easy and vastly more powerful than point-and-click. We have a basic tutorial here.
If you wish to use any software with a graphical interface, your Windows workstation must have an X server installed and running. This is described further in Preparing your Windows workstation below.
Preparing your Windows workstation for X
If you wish to use any software with a graphical interface, you will need an X server. This is a software package that draws on your local screen windows created on a remote computer (such as an NYU HPC cluster). There are a couple of options out there:
- One option is Xming. Installation instructions can be found on its web site. To use with PuTTY, we recommend Xming.
Before starting PuTTY you will need to launch Xming by double-clicking the Xming icon on your desktop or start it from the Start Menu.
- Another option is Cygwin/X. Instructions for downloading and installing it can be found here.
Before starting PuTTY you will need to have the X server running, by double-clicking the "XWin Server" shortcut under Cygwin-X on the Start Menu. You may wish to add this to your Windows Startup folder so it runs automatically after starting Windows.
Note: There are complications since X server 1.17. See this Cygwin/X FAQ, and the superuser page for how to populate the PuTTY field 'X authority file for local display' (somewhere in the middle to bottom of the page).
You will also need to download and install PuTTY SSH if you have not already.
Logging In - the easy, primitive way
This method is useful as a first-time login, to ensure you are able to connect. For ongoing use however, we recommend setting up and using SSH tunneling instead.
When you installed PuTTY you will have added to your Desktop and also the the Start Menu and icon labeled "putty". Double-clicking this icon will launch PuTTY, with the dialog initially in the "Session" category as in the screenshot below:
If this is not your first time through here, and you already saved a setup previously, you can select the saved session and hit "Load". This will do the following steps for you so you can just hit "Open". Otherwise, read on...
Enter the as Host Name "
gw.hpc.nyu.edu", leave the Port at its default value of 22 and select the "SSH" Protocol. Don't hit "Open" just yet!
Eventually, if not now, you will probably want to use some graphical applications. For the procedure described here, you don't need to check the "Enable X11 forwarding". You may disable it by un-selecting Connection -> SSH -> X11 from the Category menu on the left:
Again, don't hit "Open" just yet...
You can save these settings to use again next time. Return to the "Session" category and give this setup a name in the "Saved Sessions" box (perhaps NYU HPC"). Now click "Save".
Finally, hit "Open". You will get a command terminal for gw.hpc.nyu.edu. This is a deliberately restricted environment from which you can do little other than to log in to one of the HPC clusters.
Users do not automatically get accounts on NYU HPC Prince cluster, and dumbo Hadoop cluster. For information on how to get an account, please visit Getting or renewing an HPC account page.
After you click "Open", you will get a terminal window where you will be prompted to login using your NYU NetID and password. The window will display the following:
Now, you are on the NYU Network.
Therefore, log into a cluster using one of the following commands:
Suppose, I wish to login into the prince cluster, the window will display the following:
In the boxes below and elsewhere in this wiki, the symbol "
$" at the beginning of a line represents the command prompt - don't type the "
$", type only the remainder of the line following the "
$". Also wherever
NetID appears, replace it with your NYU NetID.
On Prince you may notice that you are now on a host named "
log-0" or "
log-1" or something similar. These clusters use multiple login nodes and which one you get depends how busy each is at the time. The login nodes are configured identically and see the same filesystems, so the specific node you are logged in to is not important.
Setting up SSH Tunneling