From f15d554cd190dc5579759d7343efa941e5687624 Mon Sep 17 00:00:00 2001
From: Lukas Kluft <lukas.kluft@mpimet.mpg.de>
Date: Wed, 2 Apr 2025 09:52:44 +0200
Subject: [PATCH] Minor rewording for clarity and conciseness
---
lectures/command-line/slides.qmd | 43 +++++++++++++-------------------
1 file changed, 18 insertions(+), 25 deletions(-)
diff --git a/lectures/command-line/slides.qmd b/lectures/command-line/slides.qmd
index 81c2666..d6adf18 100644
--- a/lectures/command-line/slides.qmd
+++ b/lectures/command-line/slides.qmd
@@ -6,7 +6,7 @@ subtitle: "Controlling local and remote machines"
# Shell
* A shell exposes an operating system to a human user or other programs
-* On most Linux systems the default shell is _Bash_ (_PowerShell_ on Windows; _Zsh_ on MacOs)
+* On most Linux systems, the default shell is _Bash_ (_PowerShell_ on Windows; _Zsh_ on MacOs)
* Different shells come with different syntax and characteristics
## Built-in commands
@@ -52,13 +52,13 @@ subtitle: "Controlling local and remote machines"
## Take home messages
-* The command line is a text interface to interact with a computer
+* The command line is a text interface for interacting with a computer
* Built-in commands and core utilities are available on (almost) all machines
* Sequences of commands can be stored and executed as shell scripts
# Hands-on session {.handson}
-1. Open the command line (_Terminal_)
+1. Open the command line (_Terminal_^[More difficult for Windows users])
1. Create a shell script using an editor of your choice
1. Run the script and check the output
@@ -67,16 +67,7 @@ subtitle: "Controlling local and remote machines"
## Configuration
-::: {.r-stack}
-::: {.fragment .fade-out fragment-index=1}
-Supercomputers consist of various components
-:::
-::: {.fragment .fade-in fragment-index=1}
High-performance computers consist of various components
-:::
-:::
-
-. . .
:::: {.columns}
@@ -98,7 +89,8 @@ High-performance computers consist of various components
Different ways to work on a cluster depending on the task:
* Housekeeping/compiling (login nodes)
-* Interactive sessions/scripts on a compute node (`salloc`/`sbatch`)
+* Interactive sessions (compute nodes, `salloc`)
+* Batch scriptsscripts (compute nodes, `sbatch`)
* External services (e.g. _Jupyterhub_)
## SSH
@@ -107,8 +99,7 @@ Different ways to work on a cluster depending on the task:
```{raw}
ssh <YOUR_USERNAME>@levante.dkrz.de
```
- (use your user id instead of a123456)
-* Now you have access to the command line on levante
+* Now you have access to the command line **on levante**
## Public keys
@@ -116,12 +107,12 @@ Different ways to work on a cluster depending on the task:
## Generating SSH keys
-* Generate a private / public ssh key pair for authentication on your local system
+* Generate a private / public SSH key pair on your local system
```bash
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_levante
```
-* Upload the public (`.pub`) key to your [DKRZ profile](https://luv.dkrz.de) ([instructions](https://docs.dkrz.de/doc/levante/access-and-environment.html)), so levante can check your connection attempts
-* Use your private ssh key instead of your password when connecting to levante
+* Upload the public (`.pub`) key to your DKRZ profile ([how to](https://docs.dkrz.de/doc/levante/access-and-environment.html#public-key-authentication))
+* Use your private SSH key to authenticate when connecting to levante
```bash
ssh -i ~/.ssh/id_ed25519_levante <YOUR_USERNAME>@levante.dkrz.de
```
@@ -131,8 +122,8 @@ Different ways to work on a cluster depending on the task:
* Create a config file for convenience
```{.sshconfig filename=~/.ssh/config}
Host levante # the name you use in the shell
- Hostname levante.dkrz.de # the official name of the system
- User <YOUR_USERNAME> # add your user id
+ Hostname levante.dkrz.de # real host name of the system
+ User <YOUR_USERNAME> # your user id
IdentityFile ~/.ssh/id_ed25519_levante # your private key
```
(call `man ssh_config` for more info)
@@ -167,9 +158,11 @@ Different ways to work on a cluster depending on the task:
|keep scripts | store output | temporary stuff |
| small | big | big |
| SSD | HDD | HDD |
-|backuped | no backup | deleted after 2 weeks |
+|backup | no backup | deleted after 2 weeks |
-We all lost data to `/scratch`, many killed something on `/work`
+::: {.fragment .fade-up}
+> Anything not saved will be lost --- _Nintendo_
+:::
## Compute nodes
@@ -183,7 +176,7 @@ We all lost data to `/scratch`, many killed something on `/work`
## Take home messages
* High-performance computers like Levante are technically a cluster of numerous _normal_ computers that share the same hard disks
-* Using a secure shell (`ssh`) one can login to Levante and use it as any other machine
+* Using a secure shell (`ssh`) you can log into Levante and (mostly) use it like any other machine
* Computationally demanding or long-lasting jobs have to be submitted to the job queue
# Hands-on session {.handson}
@@ -207,7 +200,7 @@ We all lost data to `/scratch`, many killed something on `/work`
## tmux
-`tmux` enables to create and (re)attach to terminal sessions
+`tmux` enables to create and attach to terminal sessions
* Crate a new session
```{raw}
@@ -221,7 +214,7 @@ We all lost data to `/scratch`, many killed something on `/work`
## X-forwarding
-You can use X-forwarding to forward graphical user interfaces (GUIs) from the server
+forward graphical user interfaces (GUIs) from the server
* Install an X-server on your local machine (e.g. XQuartz)
* Pass the `-X` option to your `ssh` command^[or check the SSH config option]
--
GitLab