Skip to content

Commit 92ab884

Browse files
committed
torch is now open to all
1 parent 2da1b1a commit 92ab884

29 files changed

Lines changed: 87 additions & 87 deletions

docs/hpc/02_connecting_to_hpc/01_connecting_to_hpc.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,13 @@
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

@@ -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, `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.
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
@@ -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/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: 4 additions & 4 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
1212
- 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`
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 ...
@@ -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#torch`. 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`. The endpoint `nyu#prince` has been retired. 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/)

docs/hpc/03_storage/04_globus.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -55,11 +55,11 @@ More information about **Globus Connect Personal** and download links for Linux,
5555
![Globus Connect Personal](./static/globus_connect_personal.png)
5656

5757
### Transfer files between your Personal Endpoint and NYU nyu#torch
58-
To transfer files you need to specify two collections (endpoints). Specify one of them as **Greene scratch directory**, or **Greene archive directory** or **Greene home directory**. The other endpoint is the one created for your personal computer (e.g. My Mac Laptop) if it is involved in the transfer. When you first use the Greene directory collection, authentication/consent is required for the Globus web app to manage collections on this endpoint on your behalf.
58+
To transfer files you need to specify two collections (endpoints). Specify one of them as **Torch scratch directory**, or **Torch archive directory** or **Torch home directory**. The other endpoint is the one created for your personal computer (e.g. My Mac Laptop) if it is involved in the transfer. When you first use the Torch directory collection, authentication/consent is required for the Globus web app to manage collections on this endpoint on your behalf.
5959

6060
![Globus Start Transfer](./static/globus_start_transfer.png)
6161

62-
When writing to your Greene archive directory, please pay attention that there is a default inode limit of 20K per user.
62+
When writing to your Torch archive directory, please pay attention that there is a default inode limit of 20K per user.
6363

6464
When the second Endpoint is chosen to be your personal computer, your computer home directory content will show up. Now select directory and files (you may select multiple files when clicking on file names while pressing down "shift" key), click one of the two blue Start buttons to indicate the transfer direction. After clicking the blue Start button, you should see a message indicating a transfer request has been submitted successfully, and a transfer ID is generated. Globus file transfer service takes care of the actual copying.
6565

docs/hpc/03_storage/06_best_practices.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,4 +48,4 @@ Your home directory has a relatively small number of inodes.
4848
If you create a conda or python environment in you home directory, this can eat up all the inodes.
4949
:::
5050

51-
Please review the [Package Management section](../06_tools_and_software/01_intro.md#package-management-for-r-python--julia-and-conda-in-general) of the [Greene Software Page](../06_tools_and_software/01_intro.md).
51+
Please review the [Package Management section](../06_tools_and_software/01_intro.md#package-management-for-r-python--julia-and-conda-in-general) of the [Torch Software Page](../06_tools_and_software/01_intro.md).

docs/hpc/03_storage/07_large_number_of_small_files.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ Essentially, this is a large file sitting on the disk that contains a lot of sma
7575

7676
This is a memory-mapped database meaning, file can be larger than RAM. OS is responsible for managing the pages (like caching frequently uses pages).
7777

78-
For practical use it means: say you have 10 GB of RAM, and LMDB file of 100 GB. When you connect to this file, OS may decide to load 5GB to RAM, and the rest 95GB will be attached as virtual memory. Greene does not have a limit for virtual memory. Of course, if your RAM is larger than LMDB file, this database will perform the best, as OS will have enough resources to keep what is needed directly in RAM.
78+
For practical use it means: say you have 10 GB of RAM, and LMDB file of 100 GB. When you connect to this file, OS may decide to load 5GB to RAM, and the rest 95GB will be attached as virtual memory. Torch does not have a limit for virtual memory. Of course, if your RAM is larger than LMDB file, this database will perform the best, as OS will have enough resources to keep what is needed directly in RAM.
7979

8080
:::tip
8181
when you write key-value pairs to LMDB they have to be byte-encoded. For example, if you use Python you can use: for string `st.encode()`, for np.array use `ar.tobytes()`, or in general `pickle.dumps()`

docs/hpc/03_storage/08_transferring_cloud_storage_data_with_rclone.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
## Transferring files to and from Google Drive with RCLONE
44
Having access to Google Drive from the HPC environment provides an option to archive data and even share data with collaborators who have no access to the NYU HPC environment. Other options to archiving data include the HPC Archive file system and using [Globus](./04_globus.md) to share data with collaborators.
55

6-
Access to Google Drive is provided by [rclone](https://rclone.org/drive/) - rsync for cloud storage - 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](https://rclone.org/drive/) is available on Greene cluster as a module, the module versions currently available (March 2025) are:
6+
Access to Google Drive is provided by [rclone](https://rclone.org/drive/) - rsync for cloud storage - 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](https://rclone.org/drive/) is available on Torch cluster as a module, the module versions currently available (March 2025) are:
77
- **rclone/1.68.2**
88
- **rclone/1.66.0**
99
- **rclone/1.60.1**
@@ -25,11 +25,11 @@ This option works great for file sizes 1Gb+ to 250GB. Keep in mind that there is
2525
## rclone Configuration
2626
You need to configure rclone before you will be able to move files between the HPC Environment and Google Drive
2727

28-
There are specific instruction on the [rclone web site](https://rclone.org/drive/) and here is an example of the process for configuring rclone for use on Greene:
28+
There are specific instruction on the [rclone web site](https://rclone.org/drive/) and here is an example of the process for configuring rclone for use on Torch:
2929

30-
### Step 1: Login to Greene:
30+
### Step 1: Login to Torch:
3131

32-
Follow [instructions](../02_connecting_to_hpc/01_connecting_to_hpc.md) to log into the Greene HPC cluster.
32+
Follow [instructions](../02_connecting_to_hpc/01_connecting_to_hpc.md) to log into the Torch HPC cluster.
3333

3434
### Step 2: Load the rclone module
3535
```sh

docs/hpc/04_datasets/01_intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ Please open the ImageNet site, find the terms of use ([http://image-net.org/down
9292

9393
NYU has a subscription to Twitter Decahose - 10% random sample of the realtime Twitter Firehose through a streaming connection
9494

95-
*Datasets are stored* in GCP cloud (BigQuery) and on the HPC cluster Greene.
95+
*Datasets are stored* in GCP cloud (BigQuery) and on the HPC cluster Torch.
9696

9797
Please contact Megan Brown at [The Center for Social Media & Politics](https://csmapnyu.org/) to get access to data and learn the tools available to work with it.
9898

docs/hpc/06_tools_and_software/01_intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ We strongly advise that you setup your own computational enviromments via Apptai
1111
- [Using virtual environments for Python](../06_tools_and_software/04_python_packages_with_virtual_environments.mdx)
1212
- [Managing R packages with renv](../06_tools_and_software/05_r_packages_with_renv.mdx)
1313

14-
## Examples of software usage on Greene
14+
## Examples of software usage on Torch
1515
Examples can be found under `/scratch/work/public/examples/` and include the following
1616

1717
| | | |

0 commit comments

Comments
 (0)