Skip to content

Commit

Permalink
Small fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
royfrancis committed Oct 7, 2023
1 parent f6988bc commit 3e75ed0
Show file tree
Hide file tree
Showing 12 changed files with 82 additions and 55 deletions.
5 changes: 4 additions & 1 deletion home_contents.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,10 @@ format: html

- NGS technologies and challenges [{{< fa brands youtube >}}](https://youtu.be/5sUzkrucL1E) [{{< fa file-pdf >}}](topics/other/slide_sequencing.pdf)
- NGS Pipelines [{{< fa brands youtube >}}](https://youtu.be/6RBhfMvDkSI) [{{< fa file-pdf >}}](topics/other/slide_ngs_pipelines.pdf)

### Other

- QC of FastQ reads [{{< fa file-pdf >}}](topics/other/slide_qc.pdf) [{{< fa file-lines >}}](topics/other/lab_qc.html)
- Data management [{{< fa brands youtube >}}](https://youtu.be/PfcrDlhY1zE) [{{< fa file-powerpoint >}}](topics/other/slide_data_management.pdf)

### Useful resources
Expand All @@ -55,4 +59,3 @@ format: html
- Uppmax cheatsheet [{{< fa file-image >}}](topics/linux/assets/uppmax_cheat_sheet.png)
- Mac keyboard [{{< fa file-lines >}}](topics/other/lab_mac_keyboard.html)

***
13 changes: 10 additions & 3 deletions home_precourse.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -84,9 +84,16 @@ Where `username` is mentioned, change to your user name.

Once you have logged in to UPPMAX, run the following command.

```{r,echo=FALSE}
#| class-output: bash
cat(paste0("mkdir /proj/",upid,"/nobackup/username"))
```{r}
#| output: asis
#| echo: false
out <- paste0("mkdir /proj/", upid, "/nobackup/username")
cat(
"```{.bash filename='Terminal'}",
out,
"```",
sep = "\n"
)
```

This creates a directory with your user name. You will work inside this directory for the workshop. If you cannot write to the folder, the most likely reason is that you have not requested access to the workshop project via SUPR. This is described in step 1 above.
Expand Down
Binary file added topics/other/assets/mac_keyboard_alt.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added topics/other/assets/mac_keyboard_normal.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added topics/other/assets/mac_keyboard_shift.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added topics/other/assets/mac_keyboard_shitfAlt.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
64 changes: 34 additions & 30 deletions topics/other/lab_connect.qmd
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Connecting to UPPMAX"

description: "Connecting to UPPMAX through SSH and GUI (Browser and ThinLinc)"
date: ""
format: html
---
Expand Down Expand Up @@ -37,10 +37,7 @@ Fire up the available SSH program and enter the following:
$ ssh [email protected]
```

Replace username with your UPPMAX username.

Enter your password when prompted. As you type, nothing will show on the screen.
No stars, no dots. It is supposed to be that way. Just type the password and press enter, it will be fine.
Enter your password when prompted. As you type, nothing will show on the screen. No stars, no dots. It is supposed to be that way. Just type the password and press enter, it will be fine.

Now your screen should look something like this:

Expand All @@ -64,7 +61,7 @@ Last login: Fri May 18 15:03:59 2018 from mi04.icm.uu.se
dahlo@rackham4 ~ $
```

Now you are connected to UPPMAX and can start working on the labs.
Now you are connected to UPPMAX and can start working.

## Remote desktop

Expand All @@ -76,36 +73,43 @@ We have a ThinLinc server running at one of the login nodes which allows users t

To be able to login via a web browser you will have to set up two-factor authentication first. Follow the <a href="https://www.uppmax.uu.se/support/user-guides/setting-up-two-factor-authentication/" target="_blank" rel="noopener noreferrer">instructions at the UPPMAX homepage</a>, and once you are done you can continue below.

1. Go to the login page, <a href="https://rackham-gui.uppmax.uu.se/" target="_blank" rel="noopener noreferrer">https://rackham-gui.uppmax.uu.se/</a>
2. Enter your UPPMAX username.
3. Enter your UPPMAX password, followed by your current two-factor authentication code.
Eg. if your password is `hunter2` and your current two-factor authentication code is `123456` you will enter `hunter2123456` as your password.
![](assets/thinlinc_00.png){width="200px"}
4. It will ask you which profile you want to use, so first press the `Forward` button. Then you can choose which desktop environment you want to use. `Xfce` is pretty straight-forward and easy to use, but feel free to try either of them. You get to choose every time you login so it's not a permanent choice.
![](assets/thinlinc_01.png){width="200px"}
5. Once your desktop has been loaded, start a terminal either by clicking the black terminal icon at the bottom of the screen, or by pressing the `Applications` button in the top left corner and select `Terminal Emulator`.
![](assets/thinlinc_02.png){width="200px"}
1. Go to the login page, <a href="https://rackham-gui.uppmax.uu.se/" target="_blank" rel="noopener noreferrer">https://rackham-gui.uppmax.uu.se/</a>
2. Enter your UPPMAX username.
3. Enter your UPPMAX password, followed by your current two-factor authentication code.
Eg. if your password is `hunter2` and your current two-factor authentication code is `123456` you will enter `hunter2123456` as your password.

![](assets/thinlinc_00.png){width="200px"}

4. It will ask you which profile you want to use, so first press the `Forward` button. Then you can choose which desktop environment you want to use. `Xfce` is pretty straight-forward and easy to use, but feel free to try either of them. You get to choose every time you login so it's not a permanent choice.

![](assets/thinlinc_01.png){width="200px"}

5. Once your desktop has been loaded, start a terminal either by clicking the black terminal icon at the bottom of the screen, or by pressing the `Applications` button in the top left corner and select `Terminal Emulator`.

![](assets/thinlinc_02.png){width="200px"}

### ThinLink App

1. If you haven't already done so, download the ThinLinc client matching your local computer (i.e Windows, Linux, MacOS X or Solaris) from <a href="https://www.cendio.com/thinlinc/download" target="_blank" rel="noopener noreferrer">https://www.cendio.com/thinlinc/download and install it.
2. Launch the ThinLinc client. You should see a form where you can enter your username and password, and possibly a server name. If you only see this simple form:
![](assets/thinlinc_03.png){width="200px"}
1. If you haven't already done so, download the ThinLinc client matching your local computer (i.e Windows, Linux, MacOS X or Solaris) from <a href="https://www.cendio.com/thinlinc/download" target="_blank" rel="noopener noreferrer">https://www.cendio.com/thinlinc/download</a> and install it.
2. Launch the ThinLinc client. You should see a form where you can enter your username and password, and possibly a server name. If you only see this simple form as shown below, you can click **Advanced** to be able to set the server name.

![](assets/thinlinc_03.png){width="200px"}

3. Change the **Server** setting to `rackham-gui.uppmax.uu.se`.
4. Change the **Name** setting to your UPPMAX username.
5. Set the **Password** setting to your UPPMAX password.
6. You do not need to change any other settings.
7. You will first come to the `ThinLinc profile chooser`. Press the `Forward` button to continue. Then you can choose which desktop environment you want to use. `Xfce` is pretty straight-forward and easy to use, but feel free to try either of them. You get to choose every time you login so it's not a permanent choice.
8. Press the **Connect** button.
9. If you connect for the first time you will see the "The server's host key is not cached ..." dialog.

![](assets/thinlinc_01.png){width="200px"}

you can click Advanced to be able to set the server name.
3. Change the **Server** setting to `rackham-gui.uppmax.uu.se`.
4. Change the **Name** setting to your UPPMAX username.
5. Set the **Password** setting to your UPPMAX password.
6. You do not need to change any other settings.
7. You will first come to the `ThinLinc profile chooser`. Press the `Forward` button to continue. Then you can choose which desktop environment you want to use. `Xfce` is pretty straight-forward and easy to use, but feel free to try either of them. You get to choose every time you login so it's not a permanent choice.
8. Press the "Connect" button.
9. If you connect for the first time you will see the "The server's host key is not cached ..." dialog.
![](assets/thinlinc_01.png){width="200px"}
10. Once your desktop has been loaded, start a terminal either by clicking the black terminal icon at the bottom of the screen, or by pressing the `Applications` button in the top left corner and select `Terminal Emulator`.

10. Once your desktop has been loaded, start a terminal either by clicking the black terminal icon at the bottom of the screen, or by pressing the `Applications` button in the top left corner and select `Terminal Emulator`.
![](assets/thinlinc_02.png){width="200px"}
![](assets/thinlinc_02.png){width="200px"}

11. **Two factor authentication:** The ThinLinc client connects over SSH which means it **may** be required to present a two factor authentication code. If you need to use this when logging in with SSH you also need to use it when logging in with ThinLinc (it depends on where you connect from). The ThinLinc client does not know how to ask for the two factor code, so you will need to use the grace time feature. To do this, first you have to connect with regular SSH and present the required two factor code. Once you have logged in over SSH you can safely exit again. The login server will remember that you just logged in for a few minutes and will not ask for two factor authentication again, so make sure you do not wait too long to connect with the ThinLinc client.
11. **Two factor authentication:** The ThinLinc client connects over SSH which means it **may** be required to present a two factor authentication code. If you need to use this when logging in with SSH you also need to use it when logging in with ThinLinc (it depends on where you connect from). The ThinLinc client does not know how to ask for the two factor code, so you will need to use the grace time feature. To do this, first you have to connect with regular SSH and present the required two factor code. Once you have logged in over SSH you can safely exit again. The login server will remember that you just logged in for a few minutes and will not ask for two factor authentication again, so make sure you do not wait too long to connect with the ThinLinc client.

## After connection to UPPMAX

Expand Down
34 changes: 25 additions & 9 deletions topics/other/lab_download_files.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -31,26 +31,42 @@ Lets assume that you have a file "results.txt" in the following folder on UPPMAX
cat(paste0('/proj/',upid,'/nobackup/username/somefolder/'))
```

`username` and `somefolder` should be replaced with your real username and a real folder name.\
::: {.callout-note}
`username` and `somefolder` should be replaced with your real username and a real folder name.
:::

To download the file to your local workspace type:

```{r}
#| output: asis
#| echo: false
#| class-output: bash
cat(paste0('scp [email protected]:/proj/',upid,'/nobackup/username/somefolder/results.txt .'))
out <- paste0("scp [email protected]:/proj/", upid, "/nobackup/username/somefolder/results.txt .")
cat(
"```{.bash filename='Local Terminal'}",
out,
"```",
sep = "\n"
)
```

Note that the last `.` means that the file will keep the original name.

## Upload a file to UPPMAX

Now lets imagine that you have developed a script on your laptop and want to upload it to UPPMAX. The script is stored in your local workspace and is called "script.sh".\
Type this in your local workspace to upload the file to UPPMAX:
Now lets imagine that you have developed a script on your laptop and want to upload it to UPPMAX. The script is stored in your local workspace and is called "script.sh". Type this in your local workspace to upload the file to UPPMAX:

::: {.callout-note}
`username` and `somefolder` should be replaced with your real username and a real folder name.
:::

```{r}
#| output: asis
#| echo: false
#| class-output: bash
cat(paste0('scp script.sh [email protected]:/proj/',upid,'/nobackup/username/somefolder/.'))
out <- paste0("scp script.sh [email protected]:/proj/", upid, "/nobackup/username/somefolder/.")
cat(
"```{.bash filename='Local Terminal'}",
out,
"```",
sep = "\n"
)
```

Again, `username` and `somefolder` should be replaced with your real username and a real folder name.
12 changes: 8 additions & 4 deletions topics/other/lab_mac_keyboard.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,17 @@ format: html
---

**Normal**
![](data/linux/mac_keyboard_normal.jpg)

![](assets/mac_keyboard_normal.jpg)

**Holding shift**
![](data/linux/mac_keyboard_shift.jpg)

![](assets/mac_keyboard_shift.jpg)

**Holding alt**
![](data/linux/mac_keyboard_alt.jpg)

![](assets/mac_keyboard_alt.jpg)

**Holding alt+shift**
![](data/linux/mac_keyboard_shitfAlt.jpg)

![](assets/mac_keyboard_shitfAlt.jpg)
2 changes: 1 addition & 1 deletion topics/other/lab_open_session.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ library(yaml)
<div class="table-schedule">

```{r,eval=TRUE,echo=FALSE,chunk.title=NULL}
s <- read.csv("open_session.csv",sep=";",stringsAsFactors=F,header=T,na.strings="",colClasses="character")
s <- readxl::read_xlsx("open_session.xlsx")
# remove rows that are completely NA
s <- s[!apply(s,1,function(x) all(is.na(x))),]
cnames <- c("Room","Topic","Staff")
Expand Down
7 changes: 0 additions & 7 deletions topics/other/open_session.csv

This file was deleted.

Binary file added topics/other/open_session.xlsx
Binary file not shown.

0 comments on commit 3e75ed0

Please sign in to comment.