This is part A of the tutorial VU HPC course 2018-11-16 and covers the following topics:
The User Interface (UI) is the web site that allows you to manage your Virtual Machines (VMs) on the HPC Cloud.
You will receive your access credentials from the workshop facilitators.
Once you login to the UI for the first time, it is a good practice to change the initial password.
Let’s check whether your new set of access credentials work. Sign-out from the UI:
From now on, you can use your new password to log in to the UI. Please login again.
To complete the setup of your HPC Cloud account, you need to add a Secure Shell (SSH) public key to your UI account. This is a one-time task!
If you are not familiar with the SSH authentication method, please read about it on our documentation page.
First, you need to own an SSH private/public key pair.
ls ~/.ssh; you should see the files
Next, you need to copy the public SSH key (
id_rsa.pub) to the UI. The matching private key (
id_rsa) remains safe in your laptop.
cat ~/.ssh/id_rsa.pub, then select and copy all the text)
Working with the HPC Cloud service mostly revolves around building and destroying Virtual Machines. This section will guide you through the process of building a VM running Linux. Here’s an overview of the main steps you will be taking:
imagewith a Linux operating system installed
templateto run your first VM
Let’s create your first VM to be run on the HPC Cloud Oort!
SURFsara HPC Cloud provides ready-made
app) to their users. These appliances are available in the
Apps option of the Storage menu in the HPC Cloud UI. This is meant to help users instantiating secure VM’s quickly. Proceed as follows:
You will see a list of ‘all’ the
apps we have available. For the purposes of this course, we will make use of an Ubuntu
appliancewith the name Ubuntu-18.04.1-Desktop (2018-11-01) by clicking on the tick-box next to it
Under section Select the Datastore to store the resource, choose the entry displaying 147: Courses_img by clicking anywhere in the entry row. It should now read, right above the entry you just clicked:
You selected the following datastore: Courses_img.
appliancefrom the Marketplace to your work environment
Food for brain
When you import an
templateare 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 have just imported an
app, you should now see your new
- Can you see them?
- What is the STATUS of the
imagejust after you started importing it?
- Refresh the images list until the Status is READY.
template consists of a set of attributes that define how a Virtual Machine should look like. For example, how many cores do you want your VM to have? How much RAM memory? What storage drives to attach? Which network connections, etc. ? You will have to adapt the
template you imported from the Apps list, so that the VM(s) you create out of it meet the requirements you have.
For this part of the course, we would like you to edit the imported
template following these steps:
templatecreated previously and check the tick-box
NIC) for your VM
NIC 0on the left pane is mapped to
If this is not the case, then under the Inputs section select Type Tablet and Bus USB from the drop-down lists, and finally click the Add button next to those drop-down lists.
template, click the green button Update at the top, to save your changes.
As mentioned earlier, a
template is just a description of the Virtual Machine that we want to build. Let’s create the actual VM from it.
An overview of all existing VMs, that you have the priviledges to see, are displayed. This list is (probably) empty at the moment, because you have not yet started any VM.
templateattributes, for the time being do not change them (in particular, leave Number of instances at 1)
Congratulations! You have just created a fresh, clean Virtual Machine!
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 VM can actually run. Finding the right place depends on the amount and types of resources (cores, memory, disk…) you requested in the
template. Keep refreshing the list by clicking the refresh button . When the required resources become available, your VM will show the status
RUNNING. Only then you will be able to make use of it.
Let’s summarise what you have seen so far. Click on each of the tabs on the left menu and inspect the information provided. The most important ones at this point are:
templategives your VM the shape you want. It is just a recipe, and not the machine itself.
imagesas hard drives.
appliancesendorsed by SURFsara HPC Cloud team. One
appof course is a bundle of an
template, which provide a basic working set of installed software and configured properties that allow you to easily create and use a 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.
In order to log in to your VM, you will make use of the SSH public key stored in your profile earlier. Proceed as follows:
The IP address of a VM is shown in the IPs column on the VM list, and in the Network tab of the VM details page.
On your laptop: start a terminal
On your laptop: type the following command on the terminal to establish a connection with your VM
Replace 145.100.5Q.RST with your IP address!
You may receive a message like the following:
WARNING: Your password has expired. You must change your password now and login again! Changing password for ubuntu. (current) UNIX password:
In that case, you will have to “change” the password for user
ubuntu. Type in the old password (you will not see any characters being typed, but that is expected), which is:
ubuntu (without the quote marks). Then hit Enter. After that, type in a new password that you will know, followed by the Enter key. And type that new password again.
You may be logged out after a successful password change. Type the
ssh command again that you typed before you were prompted to change the password.
If everything went well, the first time you try to log in your terminal will ask you to add the VM IP to the list of known hosts. Type Yes, in that case.
You should now see a similar line in your terminal:
This is the prompt of your VM and is waiting for your input.
You have logged in successfully!
ubuntu@packer-ubuntu-14:~$ ls / ubuntu@packer-ubuntu-14:~$ whoami
ubuntu@packer-ubuntu-14:~$ echo "Hello HPC Cloud!" > myfile ubuntu@packer-ubuntu-14:~$ cat myfile
ctrl-Din your terminal (do not issue any shutdown command):
Food for brain
Log in to your VM again. Is your file still there?
Let’s shutdown your VM. Whenever you do not need your VM running, you should shut it down to stop consuming the resources allocated.
You can always boot the “same” VM again whenever you need it, from the corresponding
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
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, 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 not. Because the HPC Cloud is offered on a fair-share basis and other users may actually be needing resources that you may be holding, please remember to terminate all your VMs before you move to the next part of this workshop.