UvA HPC course 2017-02-01
Part A

UvA logo

SURFsara logo

This is part A of the tutorial UvA HPC course 2017-02-01 and covers the following topics:

  1. Access the user interface
  2. Add your public SSH key
  3. My first VM

1. Access the User Interface

The User Interface (UI) is the web site that allows you to manage your Virtual Machines (VMs) on the HPC Cloud.

Log in to the UI

Change your password

Once you login to the UI, it is a best practice to change the initial password.


Let’s check whether it worked.

From now on you can use your new password to log in to the UI. Do so now.

2. Add your public SSH key

To complete the setup of your HPC Cloud account, you need to add a Secure Shell (SSH) public key to your profile. This is a one-time task.

First, you need an SSH private/public key pair.

Next, you need to copy the public SSH key (id_rsa.pub) to the UI. The matching private key (id_rsa) stays safe in your laptop.

3. My first VM

Using the HPC Cloud revolves around building Virtual Machines (VM). SURFsara provides several Apps readily available in the HPC Cloud UI, to facilitate creating simple VMs. Apps are ready-made appliances for you to copy and use.

These are the steps to build your first VM from one of the Apps, detailed instructions will follow:

Let’s run your first VM on the HPC Cloud!

Import an app

Food for brain:

When you import an app, an image and a template will be created, as explained during the introductory presentation. In the UI you have an Images tab under Storage and a VMs tab under Templates on the left menu. You should see your new image and template there.

  • Can you see them?
  • What is the STATUS of the image just after you import it?
  • Refresh the contents of the Images tab page by clicking button , next to the button until it is READY.

Review the Template

A template consists of a set of attributes that defines a Virtual Machine. For example, how many cores you want your VM to have, how much RAM memory, what storage drives to attach, which network connections, etc. We will have to adapt the template to meet your requirements before you can use it to create VMs out of it.

Edit the imported template following these steps:

Start the VM

A template is just a description of the virtual machine that we want to build. Let’s create the actual virtual machine from it.

What happened?

Congratulations! You have just created a fresh, clean virtual machine!

Let’s summarise what you have seen so far. Click on each of the tabs on the left side menu and inspect the information provided. The most important ones at this point in time are described here:

Your VM will appear in the list of virtual machines. At first, it will have the state PENDING. This indicates that the HPC Cloud is looking for a place where your virtual machine can actually run. Finding the right place depends on the amount of resources (cores, memory, and disk) you requested in the associated template. Keep refreshing the list by clicking button . When the required capacity becomes available, your VM will show the status RUNNING. Only then can you actually use your VM.

Log in to the VM

You can interact with your VM in several ways: command-line (e.g.: SSH), VNC (UI in your browser) or a remote desktop. We will use SSH in a terminal for the time being.

The way to log in to your virtual machine is making use of the SSH key pair that you stored in your profile earlier.

Commandline access - SSH


Replace 145.100.5Q.RST with your IP address!

ssh ubuntu@145.100.5Q.RST

First login

If everything went well, the first time you try to log in, your terminal will ask you to add the VM’s IP to the list of known hosts. Type Yes, in that case.

You should now see a similar line in your terminal: ubuntu@ip-145...:~$

This means that you have logged in successfully to your Virtual Machine!

ubuntu@ip-145...:~$ ls /
ubuntu@ip-145...:~$ whoami
ubuntu@ip-145...:~$ echo "Some text ..." > myfile
ubuntu@ip-145...:~$ cat myfile
ubuntu@ip-145...:~$ logout

Food for brain:

Log in to your VM again. Is your file still there?

First shutdown

Let’s shut your first VM down. Anytime you expect your VM to be doing nothing useful, you should shut it down to stop consuming the resources that your VM is holding.

Food for brain:

When the VM has been shut down and disappeared from the list, check and refresh the Storage > Images and Templates > VMs tabs. Are your image and template still there?

BONUS food for brain

This section is meant to propose extra questions we thought would be nice for you to investigate. We invite you to do/think about them even after the workshop has finished.

Bonus: The HPC Cloud has hundreds of users. Many of them have common questions. In order to address these we have put together a web site with some documentation for users. We call it the HPC Cloud Documentation. Do you know the URL of this web site? Make sure you find out!


Your running VMs get exclusive access to their resources whether they are doing something useful or are idle. Because the HPC Cloud is offered on a fair-share basis and other users may actually be needing resources that you may be holding, before you move to the next part of this workshop, please remember to shut all your VMs down.

Next: part B

You completed part A of the Tutorial UvA HPC course 2017-02-01. Please continue with Tutorial Part B.