2. Access

There are several ways to interact with the Greene HPC cluster. Similar to other Linux clusters, the most common method of connection is via a Command Line Interface (CLI).

Architecture
Generic diagram of the cluster architecture and outside connectivity

2.1. NYU VPN

If you are connecting from a remote location that is not on the NYU network (your home for example), you have to use VPN to connect to NYU network.

  1. Set up your computer to use the NYU VPN, a detailed guide to install on your local machine:

    For more resources a generic VPN and MFA resource can be found here.

  2. Once you’ve created a VPN connection, you can proceed as if you were connected to the NYU net.

2.2. SSH

SSH (Secure Shell) is a secure remote login and administrating protocol that enables users to login to the remote servers or systems securely to perform their tasks. It allows users to login and works securely on the remote servers over an unsecured network.

If you are connected to NYU network directly or through a VPN then you can simply ssh in your local terminal:

ssh <NetID>@greene.hpc.nyu.edu

Enter the same password which you use to login into your NYU account and you are good to go.

Warning

Whenever you login, you land up on one of the login nodes and you should not run compute heavy jobs on login nodes directly, to avoid HPC account termination.

2.2.1. Saving SSH Keys

Instead of typing password every time you need to log in, you can also save ssh keys on your HPC account.

Caution

Only save keys from the computer you trust.

  • Generate ssh keys on your local machine.

    ssh-keygen
    

    Follow the prompt, just hit Enter to go with default settings.

  • Copy the key to HPC server.

    ssh-copy-id -i ~/.ssh/id_rsa.pub <NetID>@greene.hpc.nyu.edu
    
  • Done, now you won’t need to type your password again from your current machine.

2.3. Web Interface

The HPC Web interface also known as OOD (built upon Open OnDemand ) is an interactive interface to remote computing resources which helps computational researchers and students efficiently utilize remote computing resources. The OOD Web Interface is one stop solution for all your HPC needs from accessing your files to submitting and viewing your jobs to running an interactive app.

Features Include:

  • Easy file management - upload and download files, view HTML and pictures without downloading

  • Command-line shell access without any SSH client locally installed

  • Job management and monitoring

  • Full Linux desktop experience without X11

  • Interactive Apps such as JupyterHub and RStudio without the need for port forwarding

2.3.1. Connection to OOD

To access interactive OOD interface visit: https://ood.hpc.nyu.edu (VPN Required), enter your NetID and password and click Log in with your NYU account.

OOD Login

2.3.2. Access the Shell

Under the clusters menu you can select the Greene Shell Access option to access the Linux shell. No local SSH client is required.

Shell Access

Common Error

A common issue that can occur is receiving an error that the Open OnDemand page cannot be reached. Sometimes this can indicate that the service is down, but often this is an issue with the the local browser cache. You can test this by opening a private browser window and seeing if OOD will load. If it does, try deleting the cache for https://ood.hpc.nyu.edu in your browser history to resolve this issue.

2.3.3. Interactive Applications

GUI based applications are accessible without the need for port or X11 forwarding. Select the Interactive Apps menu, select the desired application, and submit the job based on required resources and options.

Interactive apps