Connecting to Kebnekaise

ThinLinc

For this course we recommend using ThinLinc, but if you have your own installation of another SSH client that you prefer, you are welcome to use that. We will be using the command line only.

  • Download the client from https://www.cendio.com/thinlinc/download and install it.
  • Start the client. Enter the name of the server: kebnekaise-tl.hpc2n.umu.se and then enter your own username.
  • Go to “Options” -> “Security”. Check that authentication method is set to password.
  • Go to “Options” -> “Screen” and uncheck “Full screen mode”.
  • Enter your HPC2N password. Click “Connect”.

More information here: https://docs.hpc2n.umu.se/tutorials/connections/#thinlinc.

SSH

If you prefer to login with a regular SSH client (i.e. PuTTY, Terminal, Linux terminal, etc.) then use the following as server: 

kebnekaise.hpc2n.umu.se

Example: logging in from a terminal:

ssh <HPC2N username>@kebnekaise.hpc2n.umu.se

More information here:

Open OnDemand

If you prefer to use HPC2N’s OpenOnDemand web service, then:

  • Go to https://portal.hpc2n.umu.se
  • Login with your HPC2N username and password
  • Pick “Interactive Apps” -> “Kebnekaise desktop”
  • Fill in the information. Pick 1 regular core and however many hours you expect to use on the course. Launch
  • After you have logged in, start a terminal: “Applications” -> “System Tools” -> “MATE Terminal”

More information here: https://docs.hpc2n.umu.se/tutorials/connections/#open__ondemand

Setting up Git

Git is already installed on Kebnekaise, but you need to set your name and email globals unless you have already done this at some earlier time.

  • Open a terminal. In ThinLinc: Go to the menu at the top. Click “Applications” → “System Tools” → “MATE Terminal”.
  • Set your global name: $ git config --global user.name "Your Name"
  • Set your global email: $ git config --global user.email "yourname@example.com"

You may also want to set your editor. We recommend vim, but other options are nano and emacs.

  • $ git config --global core.editor vim

Testing your configuration

Create an example folder and cd into that, then create a file test.txt: 

$ mkdir <mydir> 
$ cd <mydir>
$ touch test.txt

Now initialize a repository and add the new file:

$ git init
$ git add test.txt

Now commit the change. The editor which you configured earlier should open. Add an example commit message:

$ git commit test.txt

Testing your configuration - continued

Now let us look at the log:

$ git log

When you do git log, you should see something like: 

commit ff8b6f699d98c72d5cffc64d65a1c618b976b45a (HEAD -> master)
Author: Birgitte Brydsö <bbrydsoe@cs.umu.se>
Date:   Thu Sep 17 13:53:59 2020 +0200

    Test of git

but with name, email and commit message different.

If that is the case, your Git should be configured correctly.

Download the course materials

For the individual hands-on part of the course, we have created some course materials which you will download from either the course website, the course GitHub, or the “important information” page.

  • Course website: https://www.hpc2n.umu.se/events/courses/2022/introduction-to-git
  • Course GitHub: https://github.com/hpc2n/course-intro-git
    • Click the green button labeled “Code” to get links to clone or download the materials.
  • Download the material, then please go to the terminal window where you have downloaded and set up Git.
  • Change the directory to wherever you wish to have the course material.
  • Copy/transfer the tarball there (or download there directly with wget <url-to-tarball>)
  • Unpack with tar zxvf <tarball>