-
Notifications
You must be signed in to change notification settings - Fork 6
/
home_precourse.qmd
112 lines (72 loc) · 7.17 KB
/
home_precourse.qmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
---
title: "Precourse"
subtitle: "These are steps to be completed before the workshop"
date: ""
toc: false
sidebar: false
format: html
---
```{r}
#| include: false
library(yaml)
library(here)
upid <- yaml::read_yaml(here("_quarto.yml"))$uppmax_project
upstore <- yaml::read_yaml(here("_quarto.yml"))$uppmax_storage
```
## PDC
Remote computing cluster Dardel at PDC in Stockholm will be use for data analyses. A PDC account is needed to use these resources.
If you do not already have a PDC account, please fill in the form at [https://blackfish.pdc.kth.se/cgi-bin/accounts/request.py](https://blackfish.pdc.kth.se/cgi-bin/accounts/request.py) **at least 2 weeks before the course start** and use the same email that you applied to the course with. Fill in this information about which course it is:
| | |
|---|---|
| __Lecturer/ Project Leader:__ | Martin Dahlö |
| __Course / Project Title:__ | edu24.uppmax |
## UPPMAX
Remote computing cluster UPPMAX will be use as a fallback cluster, if there should be any problems at PDC. A SUPR/NAISS account is needed to use these resources. SUPR is also the system that you will handle your own projects in if you want to use them in your research after the course.
If you do not already have one, create an account at [SUPR/NAISS](https://supr.naiss.se). Then, Log in to [SUPR/NAISS](https://supr.naiss.se/), preferably using the SWAMID.
![](assets/images/supr-login.jpg){width="70%"}
Before proceeding with applying for project membership and user accounts, we have to accept the NAISS User Agreement. Do this by clicking the [Personal Information](https://supr.naiss.se/person/) link in the left sidebar menu. The scroll down a bit until you reach the section **User Agreements**. If you already have accepted it the State will be a green box with the text Accepted in it. If it is anything else, click it to start the accepting process.
::: {.callout-tip}
This is where you might run into trouble if you don't have a SWAMID connected account. You will not be able to accept the user agreement online without it, so you will have to send in your acceptance in paper form together with a copy of your passport. This process can take a week or more, so please make sure you can accept the user agreement in good time.
:::
After making sure you have an accepted user agreement, go to the [**SUPR/NAISS Projects**](https://supr.naiss.se/project/) page and request membership to the project ID: [**`r paste0(upid)`**]{.badge}
![](assets/images/supr-request.jpg){width="70%"}
Once you are accepted to a project, you should see that project listed under your active projects.
![](assets/images/supr-projects.jpg){width="70%"}
Finally you need to request a login account to UPPMAX. This will be the account you use to log in to the actual computers, so it is not the same as your SUPR account. Login to SUPR and go to the [Accounts page](https://supr.naiss.se/account/). Under the **Possible Resource Account Requests** heading click on **Request Account on Rackham @ UPPMAX** button and confirm it on the next page. If it is missing from this page, it could be because you already have a login account created (only 1 account per person allowed), or that you have not yet gotten your project memberships approved.
Checking your request and approving your account requires some manual work, so you might have to wait for some time (up to a working day) before the next step. When the account is ready to be created, you will receive an email to your registered email address (shown in your SUPR contact information) with information on how to proceed. You will get a one-time URL that you use to get the password (within seven days) to login to the cluster with. The link is only valid for 1 visit, so write down the password you get. When that has been done, the account ready for use within 15 minutes and you can then login using your password. Once you have logged into the cluster you can change your password by typing `passwd` in the terminal and follow the instuctions.
::: {.callout-note}
You will get one username & password for the account on UPPMAX, and one username and password for the account on PDC. Please keep track of both, we will tell you when to use which account during the workshop.
:::
## Install tools
### ThinLinc
[![](assets/images/thinlinc.png){height="50px"}]((https://www.cendio.com/thinlinc/download))
ThinLinc allows graphical connection to UPPMAX. Download and install from [https://www.cendio.com/thinlinc/download](https://www.cendio.com/thinlinc/download). It can be used directly from the browser but it is recommended to download and install the client for better copy/paste operation.
### XQuartz
[![](assets/images/xquartz.png){height="60px"}](https://www.xquartz.org/)
Mac users will need to download and install [XQuartz](https://www.xquartz.org/) for X11 forwarding. *ie*; to forward remotely opened windows to local machine.
### MobaXterm (Optional)
[![](assets/images/mobaxterm.png){height="60px"}](http://mobaxterm.mobatek.net)
If you are on a Windows system, and you want to open graphical applications from the terminal, we recommend [MobaXterm](http://mobaxterm.mobatek.net). It is recommended that you INSTALL the program and not use the portable version. MobaXterm also has an integrated SFTP file browser.
### Filezilla (Optional)
[![](assets/images/filezilla.png){height="60px"}](https://filezilla-project.org/)
When you need to transfer data between the remote cluster and your computer, you can use the tools SCP or SFTP through the terminal. Windows users can use the SFTP browser available with MobaXterm. If you prefer a GUI to upload and download files from the remote cluster, we recommend installing [FileZilla](https://filezilla-project.org/).
## Connect to UPPMAX
See [Connecting to UPPMAX](topics/other/lab_connect_uppmax.qmd) instructions listed on the **Contents** page.
::: {.callout-tip}
If you want to get a primer on using the terminal, you can get started with the following **Tutorial One** at this link *[Unix tutorial for beginners](http://www.ee.surrey.ac.uk/Teaching/Unix/)*. You can use [https://scilifelab.github.io/courses/ngsintro/common/emu/](https://scilifelab.github.io/courses/ngsintro/common/emu/) [(or this mirror)](https://bellard.org/jslinux/vm.html?url=https://bellard.org/jslinux/buildroot-x86.cfg) to try the commands in the tutorial, so that you don't mess up any real world system. If you have any questions regarding this tutorial contact: *martin.dahlo [at] scilifelab.uu.se*.
:::
## Create a user folder
::: {.callout-note}
Where `username` is mentioned, change to your user name.
:::
Once you have logged in to UPPMAX, run the following command.
```{r}
#| attr-output: "filename='bash'"
#| class-output: bash
#| echo: false
cat(paste0("mkdir /proj/", upid, "/nobackup/username"))
```
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.
::: {.callout-note}
It may take an hour or so from request approval, before you can actually write to the folder. We will check before the workshop that all students have logged in and done this, so do not forget!
:::