Skip to content

Conversation

@pkamath2
Copy link

@pkamath2 pkamath2 commented Oct 19, 2025

Added quick start instructions for new joiners to get started with NYU HPC.

See my fork for a readable version of the markdown - https://github.com/pkamath2/marl-handbook/blob/hpc_updates/ch2/compute.md

Copy link
Member

@bmcfee bmcfee left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @pkamath2 ! Several comments below:

ch2/compute.md Outdated

## Accessing HPC and First Time Login

* Raise a request to get access to HPC using this link - https://identity.it.nyu.edu/identityiq/home.jsf. This step creates your Unix id and a user profile on HPC.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This needs to be accessed from on-campus or via VPN, right? Probably worth documenting.

For Windows and other SSH Config options please see [[1]](https://sites.google.com/nyu.edu/nyu-hpc/accessing-hpc?authuser=0 ) in the document links above.
* Next, you can logon to the HPC login nodes using yout Net ID and password using iTerm (on Mac) or PuTTy (on Windows)-
```ssh <Net ID>@greene.hpc.nyu.edu```
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can actually be simplified if you add

User <Net ID>

to .ssh/config for the hpc hosts. Then you can just do ssh greene.hpc.nyu.edu

* Next, you can logon to the HPC login nodes using yout Net ID and password using iTerm (on Mac) or PuTTy (on Windows)-
```ssh <Net ID>@greene.hpc.nyu.edu```
**Note:** If you are not on the NYU network, you will need to connect to VPN.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's also the gateway tunnel if you're not on the VPN. Maybe we can add a section at the end for this?

NYU HPC uses SLURM to submit a job to the CPU or GPU clusters. A job can be a batch (e.g., training your neural network on GPUs as a long running background thread/process), or an interactive job (e.g., running a Jupyter notebook)
**Note**: You will need a project account code to run any SLURM commands (on the CPU or GPU clusters). This code is of the format "pr_###_<function>". Your project PI/Supervisor should be able to create a new project on the HPC management portal and give you a code.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this is strictly necessary. RIT is used to manage priority access, but if you don't include it, things will still run (just at lower priority) -- right?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The HPC doc says RIT projects are enforced by the Slurm scheduler - https://sites.google.com/nyu.edu/nyu-hpc/hpc-projects - so I just assumed we needed one.

ch2/compute.md Outdated
```
$ ./singrw # Assuming you have already created a container image at the location, start it in read-write mode.
$ pip install jupyterlab
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

probably this should be in your conda rather than pip, right?

Also a good idea to include links to configuring a conda kernel in jupyter

Copy link
Author

@pkamath2 pkamath2 Oct 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I usually use pip from inside the conda environment (which pip points to the python installation within my conda env). But using conda here makes sense.

$ ./singrw # Assuming you have already created a container image at the location, start it in read-write mode.
$ pip install jupyterlab
$ jupyter lab --no-browser -port=9000 -ip=0.0.0.0
```
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

actually this all seems like not something we should document / encourage, and rather we should direct folks to use OOD for launching notebook instances.

Maybe @tomxi has some useful things to contribute here?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants