From d1d4518406d91ff63920a6afceb9d25e3df70b3a Mon Sep 17 00:00:00 2001 From: Graviton28 Date: Mon, 22 Jun 2026 10:56:24 -0600 Subject: [PATCH 1/5] Revise SSH keys and config file documentation Updated SSH keys and config file instructions for clarity and added a recommendation for using Easley for workloads. --- ssh_keygen_config.md | 25 +++++++++++-------------- 1 file changed, 11 insertions(+), 14 deletions(-) diff --git a/ssh_keygen_config.md b/ssh_keygen_config.md index f52d90e7..0d05335c 100644 --- a/ssh_keygen_config.md +++ b/ssh_keygen_config.md @@ -1,37 +1,34 @@ # SSH keys and config file -Once you start computing you will be logging in to the CARC systems fairly often and having to type your username at the machine address will become tedious. In order to alleviate this tedium it is beneficial to generate ssh keys and a ssh config file. The ssh keys bypass the need to enter your password each time you log in, and the config file stores the addresses of all the machines you are logging in to. +Once you start computing, you will be logging in to the CARC systems fairly often, and having to type your username at the machine address will become tedious. In order to alleviate this tedium, it is beneficial to generate SSH keys and an SSH config file. The ssh keys bypass the need to enter your password each time you log in, and the config file stores the addresses of all the machines you are logging in to. ### SSH key generation -First, set up your ssh key. To do this type in the terminal prompt: +First, set up your ssh key. To do this, type in the terminal prompt: ```bash ssh-keygen ``` -Just keep hitting enter until the program finishes. We recommend that you decline setting up a passphrase as this defeats the convenience of having a SSH key. Now that your SSH key has been generated you need to copy it to your home directory at CARC. To do, open terminal and type: +Just keep hitting enter until the program finishes. We recommend that you decline setting up a passphrase as this defeats the convenience of having an SSH key. Now that your SSH key has been generated you need to copy it to your home directory at CARC. To do this, open a terminal and type: ```bash ssh-copy-id yourusername@machinename.alliance.unm.edu ``` -Since your home directory is shared across all machines at CARC you only need to do this step once to enable ssh key access across all CARC machines. +Since your home directory is shared across all machines at CARC you only need to do this step once to enable SSH key access across all CARC machines. ### SSH config file -To make logging in to CARC even easier we also recommend setting up a ssh config file which allows you to simply type `ssh machinename` instead of your username at the machine address. To set up this file simply copy the example below and save it to a text document in your `ssh` folder, which is found at `~/.ssh/`. Change the user to your CARC username and you are set to log in quickly and efficiently. You can add machines based on which ones you have access to. +To make logging in to CARC even easier we also recommend setting up an SSH config file which allows you to simply type `ssh machinename` instead of your username at the machine address. To set up this file simply copy the example below and save it to a text document in your `ssh` folder, which is found at `~/.ssh/`. Change the user to your CARC username and you are set to log in quickly and efficiently. You can add machines based on which ones you have access to. ```bash -Host wheeler - hostname wheeler-sn.alliance.unm.edu +Host easley + hostname easley-sn.alliance.unm.edu user CHANGEME port 22 -Host galles - hostname galles.alliance.unm.edu +Host wheeler + hostname wheeler-sn.alliance.unm.edu user CHANGEME port 22 -Host xena - hostname xena.alliance.unm.edu - user CHANGEME - ForwardX11 yes - port 22sa ``` +We recommend using Easley for most workloads — it offers roughly double the compute power, storage, and speed compared to Wheeler. +*This quickbyte was validated on 6/22/2026* From 8d88b577c1b6a199293415c0939f1765a3f57cee Mon Sep 17 00:00:00 2001 From: Graviton28 Date: Mon, 22 Jun 2026 10:57:28 -0600 Subject: [PATCH 2/5] Revise SSH keys and config file documentation Formatted the SSH keys and config file instructions for clarity and consistency. --- ssh_keygen_config.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/ssh_keygen_config.md b/ssh_keygen_config.md index 0d05335c..9c182f2c 100644 --- a/ssh_keygen_config.md +++ b/ssh_keygen_config.md @@ -1,22 +1,22 @@ # SSH keys and config file -Once you start computing, you will be logging in to the CARC systems fairly often, and having to type your username at the machine address will become tedious. In order to alleviate this tedium, it is beneficial to generate SSH keys and an SSH config file. The ssh keys bypass the need to enter your password each time you log in, and the config file stores the addresses of all the machines you are logging in to. +Once you start computing, you will be logging in to the CARC systems fairly often, and having to type your username at the machine address will become tedious. In order to alleviate this tedium, it is beneficial to generate SSH keys and an SSH config file. The SSH keys bypass the need to enter your password each time you log in, and the config file stores the addresses of all the machines you are logging in to. ### SSH key generation -First, set up your ssh key. To do this, type in the terminal prompt: +First, set up your SSH key. To do this, type in the terminal prompt: ```bash ssh-keygen ``` -Just keep hitting enter until the program finishes. We recommend that you decline setting up a passphrase as this defeats the convenience of having an SSH key. Now that your SSH key has been generated you need to copy it to your home directory at CARC. To do this, open a terminal and type: +Just keep hitting enter until the program finishes. We recommend that you decline setting up a passphrase, as this defeats the convenience of having an SSH key. Now that your SSH key has been generated, you need to copy it to your home directory at CARC. To do this, open a terminal and type: ```bash ssh-copy-id yourusername@machinename.alliance.unm.edu ``` -Since your home directory is shared across all machines at CARC you only need to do this step once to enable SSH key access across all CARC machines. +Since your home directory is shared across all machines at CARC, you only need to do this step once to enable SSH key access across all CARC machines. ### SSH config file -To make logging in to CARC even easier we also recommend setting up an SSH config file which allows you to simply type `ssh machinename` instead of your username at the machine address. To set up this file simply copy the example below and save it to a text document in your `ssh` folder, which is found at `~/.ssh/`. Change the user to your CARC username and you are set to log in quickly and efficiently. You can add machines based on which ones you have access to. +To make logging in to CARC even easier, we also recommend setting up an SSH config file, which allows you to simply type `ssh machinename` instead of your username at the machine address. To set up this file, simply copy the example below and save it to a text document in your `ssh` folder, which is found at `~/.ssh/`. Change the user to your CARC username, and you are set to log in quickly and efficiently. You can add machines based on which ones you have access to. ```bash Host easley @@ -29,6 +29,4 @@ Host wheeler port 22 ``` -We recommend using Easley for most workloads — it offers roughly double the compute power, storage, and speed compared to Wheeler. - *This quickbyte was validated on 6/22/2026* From 68d05d0024b683457bce2d5660cb4611c0cd89bc Mon Sep 17 00:00:00 2001 From: xc1-hub Date: Wed, 24 Jun 2026 14:18:25 -0600 Subject: [PATCH 3/5] Update ssh_keygen_config.md --- ssh_keygen_config.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ssh_keygen_config.md b/ssh_keygen_config.md index 9c182f2c..8bb96e64 100644 --- a/ssh_keygen_config.md +++ b/ssh_keygen_config.md @@ -16,7 +16,7 @@ ssh-copy-id yourusername@machinename.alliance.unm.edu Since your home directory is shared across all machines at CARC, you only need to do this step once to enable SSH key access across all CARC machines. ### SSH config file -To make logging in to CARC even easier, we also recommend setting up an SSH config file, which allows you to simply type `ssh machinename` instead of your username at the machine address. To set up this file, simply copy the example below and save it to a text document in your `ssh` folder, which is found at `~/.ssh/`. Change the user to your CARC username, and you are set to log in quickly and efficiently. You can add machines based on which ones you have access to. +To make logging in to CARC even easier, we also recommend setting up an SSH config file, which allows you to simply type `ssh machinename` instead of your username at the machine address. To set up this file, simply copy the example below and save it to a text document in your `ssh` folder, which is found at `~/.ssh/`. Name the file "config". Change the user to your CARC username, and you are set to log in quickly and efficiently. You can add machines based on which ones you have access to. ```bash Host easley From ab5dc3d9caf58a040d62390bdd7f537ad04cd335 Mon Sep 17 00:00:00 2001 From: xc1-hub Date: Wed, 24 Jun 2026 17:16:42 -0600 Subject: [PATCH 4/5] Update ssh_keygen_config.md I added a description about how to save the config file in Windows and Mac, and I updated the cluster names in the example text. --- ssh_keygen_config.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/ssh_keygen_config.md b/ssh_keygen_config.md index 8bb96e64..a97658e5 100644 --- a/ssh_keygen_config.md +++ b/ssh_keygen_config.md @@ -16,17 +16,20 @@ ssh-copy-id yourusername@machinename.alliance.unm.edu Since your home directory is shared across all machines at CARC, you only need to do this step once to enable SSH key access across all CARC machines. ### SSH config file -To make logging in to CARC even easier, we also recommend setting up an SSH config file, which allows you to simply type `ssh machinename` instead of your username at the machine address. To set up this file, simply copy the example below and save it to a text document in your `ssh` folder, which is found at `~/.ssh/`. Name the file "config". Change the user to your CARC username, and you are set to log in quickly and efficiently. You can add machines based on which ones you have access to. +To make logging in to CARC even easier, we also recommend setting up an SSH config file, which allows you to simply type `ssh machinename` instead of your username at the machine address. To set up this file, simply copy the example below, change the user to your CARC username, and save it to a text document in your `ssh` folder, which is found at `~/.ssh/`. +If you are using Windows, use Notepad and save the File name as "config" (with quotation marks), and leave the Save as type as TextDocuments(*.txt). You can also save the File name as "config" (NO quotation marks), and change the Save as type to "All files". +If you are using a Mac, save the file name as "config" (NO quotation marks) and uncheck the box that says "If no extension is provided, use '.txt'". +Now you are set to log in quickly and efficiently. You can add machines based on which ones you have access to. ```bash Host easley hostname easley-sn.alliance.unm.edu user CHANGEME port 22 -Host wheeler - hostname wheeler-sn.alliance.unm.edu +Host hopper + hostname hopper-sn.alliance.unm.edu user CHANGEME port 22 ``` -*This quickbyte was validated on 6/22/2026* +*This quickbyte was validated on 6/24/2026* From d2b4b78a12132da7f8bd5f02a7602b257c676f75 Mon Sep 17 00:00:00 2001 From: xc1-hub Date: Thu, 25 Jun 2026 14:27:56 -0600 Subject: [PATCH 5/5] Update ssh_keygen_config.md --- ssh_keygen_config.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/ssh_keygen_config.md b/ssh_keygen_config.md index a97658e5..a88676a0 100644 --- a/ssh_keygen_config.md +++ b/ssh_keygen_config.md @@ -16,9 +16,7 @@ ssh-copy-id yourusername@machinename.alliance.unm.edu Since your home directory is shared across all machines at CARC, you only need to do this step once to enable SSH key access across all CARC machines. ### SSH config file -To make logging in to CARC even easier, we also recommend setting up an SSH config file, which allows you to simply type `ssh machinename` instead of your username at the machine address. To set up this file, simply copy the example below, change the user to your CARC username, and save it to a text document in your `ssh` folder, which is found at `~/.ssh/`. -If you are using Windows, use Notepad and save the File name as "config" (with quotation marks), and leave the Save as type as TextDocuments(*.txt). You can also save the File name as "config" (NO quotation marks), and change the Save as type to "All files". -If you are using a Mac, save the file name as "config" (NO quotation marks) and uncheck the box that says "If no extension is provided, use '.txt'". +To make logging in to CARC even easier, we also recommend setting up an SSH config file, which allows you to simply type `ssh machinename` instead of your username at the machine address. To set up this file, simply copy the example below, change the user to your CARC username, and save it to a text document in your `ssh` folder, which is found at `~/.ssh/`. Save the File name as "config". If you are using Windows Notepad, change the Save type to "All files". Now you are set to log in quickly and efficiently. You can add machines based on which ones you have access to. ```bash