Skip to content

Commit 37b74d9

Browse files
authored
Merge pull request #223 from NYU-RTS/long-live-torch
torch is now open to all
2 parents 94e26ca + f385806 commit 37b74d9

32 files changed

Lines changed: 135 additions & 135 deletions

docs/cloud/03_hpc_bursting_to_cloud/01_intro.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ To request access to the HPC Bursting capabilities, [please complete this form][
1616
This is not public, only per request of eligible classes or researchers
1717
:::
1818
```sh
19-
ssh <NetID>@greene.hpc.nyu.edu
19+
ssh <NetID>@login.torch.hpc.nyu.edu
2020
```
2121
ssh to the class on GCP (burst login node) - anyone can login but you can only submit jobs if you have approval
2222
```sh
@@ -50,9 +50,9 @@ When you run a bursting job the compute nodes will not see those file mounts. Th
5050

5151
The file systems are independent, so you must copy data to the GCP location.
5252

53-
To copy data, you must first start an interactive job. Once started, you can copy your data using scp from the HPC Data Transfer Nodes (greene-dtn). Below is the basic setup to copy files from Torch to your home directory while you are in an interactive bursting job:
53+
To copy data, you must first start an interactive job. Once started, you can copy your data using scp from the HPC Data Transfer Nodes (torch-dtn). Below is the basic setup to copy files from Torch to your home directory while you are in an interactive bursting job:
5454
```sh
55-
scp <NetID>@greene-dtn.hpc.nyu.edu:/path/to/files /home/<NetID>/
55+
scp <NetID>@dtn.torch.hpc.nyu.edu:/path/to/files /home/<NetID>/
5656
```
5757

5858

docs/cloud/03_hpc_bursting_to_cloud/02_visualization.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Add the following to your SSH config file (~/.ssh/config) on your local workstat
1010
Host burst
1111
HostName burst.hpc.nyu.edu
1212
User <NetID>
13-
ProxyJump <NetID>@greene.hpc.nyu.edu
13+
ProxyJump <NetID>@login.torch.hpc.nyu.edu
1414
ProxyJump <NetID>@burst.hpc.nyu.edu
1515
StrictHostKeyChecking no
1616
UserKnownHostsFile /dev/null

docs/hpc/02_connecting_to_hpc/01_connecting_to_hpc.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,19 @@
44
This page gives an overview of connecting to the HPC cluster, for a tutorial on this topic, head to the [this section](../12_tutorial_intro_shell_hpc/02_connecting_to_hpc.mdx)!
55
:::
66

7-
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). A CLI is a program that allows you to create and delete files, run programs, and navigate through directories and files via a typed prompt. On Mac, the built-in CLI application is called Terminal. While Windows 11 machines support a Linux Subsystem, which allows for similar functionality, a popular tool used to connect to a Linux server is a free application called [MoabXterm](https://mobaxterm.mobatek.net/documentation.html)
7+
There are several ways to interact with the Torch HPC cluster. Similar to other Linux clusters, the most common method of connection is via a Command Line Interface (CLI). A CLI is a program that allows you to create and delete files, run programs, and navigate through directories and files via a typed prompt. On Mac, the built-in CLI application is called Terminal. While Windows 11 machines support a Linux Subsystem, which allows for similar functionality, a popular tool used to connect to a Linux server is a free application called [MoabXterm](https://mobaxterm.mobatek.net/documentation.html)
88

99
:::tip
1010
If you'd prefer to access the HPC cluster via a web gateway instead, please refer to [the section describing Open OnDemand (OOD)](../09_ood/01_ood_intro.md).
1111
:::
1212

13-
The following sections will outline basic ways to connect to the Greene cluster. Access to the clusters is primarily handled via the Secure Shell Protocol, or ssh. Below we outline ways to connect via ssh on Mac, Linux, and Windows machines.
13+
The following sections will outline basic ways to connect to the Torch cluster. Access to the clusters is primarily handled via the Secure Shell Protocol, or ssh. Below we outline ways to connect via ssh on Mac, Linux, and Windows machines.
1414

1515
## Configuring Your SSH Client
1616

1717
To connect to HPC systems, you have to configure the SSH client on your machine. We recommend the following configuration:
1818
```sh
19-
Host greene.hpc.nyu.edu dtn.hpc.nyu.edu
19+
Host dtn.torch.hpc.nyu.edu
2020
User <NetID>
2121
StrictHostKeyChecking no
2222
ServerAliveInterval 60
@@ -46,7 +46,7 @@ New-Item -Path $HOME\.ssh\config -ItemType File
4646
# Open config File with Notepad
4747
C:\WINDOWS\System32\notepad.exe $HOME\.ssh\config
4848
```
49-
Configuring the file above will allow you to use the cmd terminal to connect to Greene.
49+
Configuring the file above will allow you to use the cmd terminal to connect to Torch.
5050

5151
### Common issues
5252

@@ -60,7 +60,7 @@ IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
6060
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
6161
It is also possible that a host key has just been changed.
6262
```
63-
Do not be alarmed - this is an issue that occurs because the Greene and Torch clusters have multiple login nodes. For instance, `greene.hpc.nyu.edu` resolves to one of three possible login nodes (`log-1`, `log-2`, and `log-3`). The configuration directive `StrictHostKeyChecking no` referenced in the recommended config above will prevent this error. Ensure that you have not missed adding it.
63+
Do not be alarmed - this is an issue that occurs because the Torch and Torch clusters have multiple login nodes. For instance, `login.torch.hpc.nyu.edu` resolves to one of three possible login nodes (`log-1`, `log-2`, and `log-3`). The configuration directive `StrictHostKeyChecking no` referenced in the recommended config above will prevent this error. Ensure that you have not missed adding it.
6464
:::
6565

6666
:::info SSH Timeout errors
@@ -78,10 +78,10 @@ To access the HPC systems, you must either be on the NYU secure network (such as
7878

7979
### Mac & Linux Access
8080

81-
Once you're on the VPN or the main NYU network on campus you can SSH directly to greene like so:
81+
Once you're on the VPN or the main NYU network on campus you can SSH directly to torch like so:
8282

8383
```sh
84-
ssh <Your NetID>@greene.hpc.nyu.edu
84+
ssh <Your NetID>@login.torch.hpc.nyu.edu
8585
```
8686

8787
### Windows
@@ -119,7 +119,7 @@ There is an extra layer of security when accessing Torch which is described belo
119119
- Return to terminal and hit Enter
120120
![torch-ssh-2fa-9](static/torch-ssh-2fa-9.png)
121121

122-
## SSH Keys for Greene
122+
## SSH Keys for Torch
123123
:::warning
124124
SSH keys are not supported on Torch!
125125
:::

docs/hpc/02_connecting_to_hpc/02_x11_forwarding.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
In rare cases when you need to interact with GUI applications on HPC clusters, you need to enable X11 forwarding for your SSH connection. Mac and Linux users will need to run the ssh commands described above with an additional flag:
66

77
```sh
8-
ssh -Y <NYU_NetID>@greene.hpc.nyu.edu
8+
ssh -Y <NYU_NetID>@login.torch.hpc.nyu.edu
99
```
1010

1111
However, Mac users need to install [XQuartz][xquartz], since X-server is no longer shipped with the macOS.

docs/hpc/03_storage/01_intro_and_data_management.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Every individual user has a home directory (under **`/home/$USER`**, environment
3939

4040
User home directories are backed up daily and old files under **`$HOME`** are not purged.
4141

42-
The User home directories are available on all HPC clusters (Greene) and on every cluster node (login nodes, compute nodes) as well as and Data Transfer Node (gDTN).
42+
The User home directories are available on all HPC clusters (Torch) and on every cluster node (login nodes, compute nodes) as well as and Data Transfer Node (gDTN).
4343

4444
:::warning
4545
Avoid changing file and directory permissions in your home directory to allow other users to access files.
@@ -62,7 +62,7 @@ Files stored in the HPC scratch file system are subject to the <ins>**HPC Scratc
6262

6363
Every user has a dedicated scratch directory (**/scratch/$USER**) with **5 TB** disk quota and **1,000,000 inodes** (files) limit per user.
6464

65-
The scratch file system is available on all nodes (compute, login, etc.) on Greene as well as Data Transfer Node (gDTN).
65+
The scratch file system is available on all nodes (compute, login, etc.) on Torch as well as Data Transfer Node (gDTN).
6666

6767
:::warning
6868
There are **No Back ups of the scratch file system.** ***Files that were deleted accidentally or removed due to storage system failures CAN NOT be recovered.***
@@ -83,7 +83,7 @@ Files stored in the HPC vast file system are subject to the <ins>***HPC Vast old
8383

8484
Every user has a dedicated vast directory (**`/vast/$USER`**) with **2 TB** disk quota and **5,000,000 inodes** (files) limit per user.
8585

86-
The vast file system is available on all nodes (compute, login, etc.) on Greene as well as Data Transfer Node (gDTN).
86+
The vast file system is available on all nodes (compute, login, etc.) on Torch as well as Data Transfer Node (gDTN).
8787

8888
:::warning
8989
There are **No Back ups** of the vastsc file system. ***Files that were deleted accidentally or removed due to storage system failures CAN NOT be recovered.***
@@ -108,7 +108,7 @@ For some of the datasets users must provide a signed usage agreement before acce
108108
Public datasets available on the HPC clusters can be viewed on the [Datasets page](../04_datasets/01_intro.md).
109109

110110
#### HPC Archive
111-
Once the Analysis stage of the research data lifecycle has completed, <ins>_HPC users should **tar** their data and code into a single tar.gz file and then copy the file to their archive directory (**`/archive/$USER`**_).</ins> The HPC Archive file system is not accessible by running jobs; it is suitable for long-term data storage. Each user has access to a default disk quota of **2TB** and ***20,000 inode (files) limit***. The rather low limit on the number of inodes per user is intentional. The archive file system is available only ***on login nodes*** of Greene. The archive file system is backed up daily.
111+
Once the Analysis stage of the research data lifecycle has completed, <ins>_HPC users should **tar** their data and code into a single tar.gz file and then copy the file to their archive directory (**`/archive/$USER`**_).</ins> The HPC Archive file system is not accessible by running jobs; it is suitable for long-term data storage. Each user has access to a default disk quota of **2TB** and ***20,000 inode (files) limit***. The rather low limit on the number of inodes per user is intentional. The archive file system is available only ***on login nodes*** of Torch. The archive file system is backed up daily.
112112

113113
- Here is an example ***tar*** command that combines the data in a directory named ***my_run_dir*** under ***`$SCRATCH`*** and outputs the tar file in the user's ***`$ARCHIVE`***:
114114
```sh

docs/hpc/03_storage/02_available_storage_systems.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ The NYU HPC cluster storage runs on Lenovo Distributed Storage Solution DSS-G ha
2020
- I/O Performance: up to 650k input/output operations per second (IOPS)
2121

2222
## Flash Tier Storage (VAST)
23-
An all flash file system, using [VAST Flash storage](https://www.vastdata.com/), is now available on Greene. Flash storage is optimal for computational workloads with high I/O rates. For example, If you have jobs to run with huge amount of tiny files, VAST may be a good candidate. If you and your lab members are interested, please reach out to [hpc@nyu.edu](mailto:hpc@nyu.edu) for more information.
23+
An all flash file system, using [VAST Flash storage](https://www.vastdata.com/), is now available on Torch. Flash storage is optimal for computational workloads with high I/O rates. For example, If you have jobs to run with huge amount of tiny files, VAST may be a good candidate. If you and your lab members are interested, please reach out to [hpc@nyu.edu](mailto:hpc@nyu.edu) for more information.
2424
- NVMe interface
2525
- Total size: 778 TB
2626
:::note
@@ -29,7 +29,7 @@ An all flash file system, using [VAST Flash storage](https://www.vastdata.com/),
2929

3030
## Research Project Space (RPS)
3131
[Research Project Space (RPS)](./05_research_project_space.mdx) volumes provide working spaces for sharing data and code amongst project or lab members.
32-
- RPS directories are available on the Greene HPC cluster.
32+
- RPS directories are available on the Torch HPC cluster.
3333
- There is no old-file purging policy on RPS.
3434
- RPS is backed up.
3535
- There is a cost per TB per year and inodes per year for RPS volumes.

docs/hpc/03_storage/03_data_transfers.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@ Globus is the recommended tool to use for large-volume data transfers due to the
55
:::
66

77
## Data-Transfer nodes
8-
Attached to the NYU HPC cluster Greene, the Greene Data Transfer Node (gDTN) are nodes optimized for transferring data between cluster file systems (e.g. scratch) and other endpoints outside the NYU HPC clusters, including user laptops and desktops. The gDTNs have 100-Gb/s Ethernet connections to the High Speed Research Network (HSRN) and are connected to the HDR Infiniband fabric of the HPC clusters. More information on the hardware characteristics is available at [Greene spec sheet](../10_spec_sheet.md).
8+
Attached to the NYU HPC cluster Torch, the Torch Data Transfer Node (gDTN) are nodes optimized for transferring data between cluster file systems (e.g. scratch) and other endpoints outside the NYU HPC clusters, including user laptops and desktops. The gDTNs have 100-Gb/s Ethernet connections to the High Speed Research Network (HSRN) and are connected to the HDR Infiniband fabric of the HPC clusters. More information on the hardware characteristics is available at [Torch spec sheet](../10_spec_sheet.md).
99

1010
### Data Transfer Node Access
1111
The HPC cluster filesystems include `/home`, `/scratch`, `/archive` and the [HPC Research Project Space](./05_research_project_space.mdx) are available on the gDTN. The Data-Transfer Node (DTN) can be accessed in a variety of ways
12-
- From NYU-net and the High Speed Research Network: use SSH to the DTN hostname `gdtn.hpc.nyu.edu`
13-
- From the Greene cluster (e.g., the login nodes): the hostname can be shortened to `gdtn`
12+
- From NYU-net and the High Speed Research Network: use SSH to the DTN hostname `gdtn.torch.hpc.nyu.edu`
13+
- From the Torch cluster (e.g., the login nodes): the hostname can be shortened to `gdtn`
1414
:::info
15-
For example, to log in to a DTN from the Greene cluster, to carry out some copy operation, and to log back out, you can use a command sequence like:
15+
For example, to log in to a DTN from the Torch cluster, to carry out some copy operation, and to log back out, you can use a command sequence like:
1616
```sh
1717
ssh gdtn
1818
rsync ...
@@ -30,10 +30,10 @@ logout
3030
Please use Data Transfer Nodes (DTNs) with these tools. While one can transfer data while on login nodes, it is considered a bad practice because it can degrade the node's performance.
3131
:::
3232

33-
Sometimes these two tools are convenient for transferring small files. Using the DTNs does not require to set up an SSH tunnel; use the hostname `dtn.hpc.nyu.edu` for one-step copying. See below for examples of commands invoked on the command line on a laptop running a Unix-like operating system:
33+
Sometimes these two tools are convenient for transferring small files. Using the DTNs does not require to set up an SSH tunnel; use the hostname `dtn.torch.hpc.nyu.edu` for one-step copying. See below for examples of commands invoked on the command line on a laptop running a Unix-like operating system:
3434
```sh
35-
scp HMLHWBGX7_n01_HK16.fastq.gz jdoe55@dtn.hpc.nyu.edu:/scratch/jdoe55/
36-
rsync -av HMLHWBGX7_n01_HK16.fastq.gz jdoe55@dtn.hpc.nyu.edu:/scratch/jdoe55/
35+
scp HMLHWBGX7_n01_HK16.fastq.gz jdoe55@dtn.torch.hpc.nyu.edu:/scratch/jdoe55/
36+
rsync -av HMLHWBGX7_n01_HK16.fastq.gz jdoe55@dtn.torch.hpc.nyu.edu:/scratch/jdoe55/
3737
```
3838
In particular, rsync can also be used on the DTNs to copy directories recursively between filesystems, e.g. (assuming that you are logged in to a DTN),
3939
```sh
@@ -48,7 +48,7 @@ Windows 10 machines may have the Linux Subsystem installed, which will allow for
4848
### Globus
4949
Globus is the recommended tool to use for large-volume data transfers. It features automatic performance tuning and automatic retries in cases of file-transfer failures. Data-transfer tasks can be submitted via a web portal. The Globus service will take care of the rest, to make sure files are copied efficiently, reliably, and securely. Globus is also a tool for you to share data with collaborators, for whom you only need to provide the email addresses.
5050

51-
The Globus endpoint for Greene is available at `nyu#greene`. The endpoint `nyu#prince` has been retired. Detailed instructions available at [Globus](./04_globus.md)
51+
The Globus endpoint for Torch is available at `nyu#torch`. Detailed instructions available at [Globus](./04_globus.md)
5252

5353
### rclone
5454
rclone - rsync for cloud storage, is a command line program to sync files and directories to and from cloud storage systems such as Google Drive, Amazon Drive, S3, B2 etc. rclone is available on DTNs. [Please see the documentation for how to use it.](https://rclone.org/)

0 commit comments

Comments
 (0)