These are steps to be completed before the workshop.

1 Create UPPMAX and NSC accounts

Remote computing clusters (UPPMAX and NSC) will be use for data analyses. A SUPR/SNIC account is needed to use these resources.

If you do not already have one, create an account at https://supr.snic.se/.

Log in to SUPR/SNIC and request membership to the project IDs: snic2022-22-769 and snic2022-22-681.

Once you are accepted to a project, you should see that project listed under your active projects.

Finally you need to request login accounts to NSC and UPPMAX. These are the accounts you use to log in to the actual computers, so they are not the same as your SUPR account. Login to SUPR and go to the Accounts page. Under the Possible Resource Account Requests heading click on Request Account on Tetralith @ NSC and Request Account on Rackham @ UPPMAX button and confirm it on the next page. If either of them are 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 URL that you use to choose the password (within seven days). When that has been done, the account ready for use within 15 minutes and you can then login using your chosen password.

Note: You will get one username & password for the account on UPPMAX, and one username and password for the account on NSC. Please keep track of both, we will tell you when to use which account during the workshop.

2 Install tools

2.1 SFTP Browser

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.

2.2 ThinLinc

ThinLinc allows graphical connection to UPPMAX. Download and install from https://www.cendio.com/thinlinc/download. It can be used directly from the browser for most part, but if there are issues, the installed application may be helpful.

2.3 XQuartz

Mac users will need to download and install XQuartz for X11 forwarding. ie; to forward remotely opened windows to local machine.

2.4 MobaXterm(Optional)

If you are on a Windows system, and you want to open graphical applications from the terminal, we recommend MobaXterm. It is recommended that you INSTALL the program and not use the portable version. MobaXterm also has an integrated SFTP file browser.

3 Connect to UPPMAX

See “Connecting to UPPMAX” instructions on the Contents page.

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. You can use https://scilifelab.github.io/courses/ngsintro/common/emu/ (or this mirror) 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.

4 Create a user folder

Note: Where username is mentioned, change to your user name.

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

mkdir /proj/snic2022-22-769/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.

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!