HOW TO CREATE AND ACCESS A VIRTUAL MACHINE INSTANCE

 


What are the steps for the provisioning of a dedicated Virtual Machine (VM) via the WEkEO portal once I have been provided the necessary privileges to create a VM?

 

VM SERVER CONFIGURATIONS AVAILABLE ON WEkEO

 

Category XS - XtraSmall S- Small
vCPUs 4 8
RAM 32  GB 64 GB
Block Storage 500 GB 2 TB
File Storage 500 GB 1 TB
Object Storage 500 GB 4 TB
Public IPs 3 3
Load Balancers 0 1
GPUs 0 0
Block Storage SSD No No
VPN 0 0

 

 

ACCESS THE VM DASHBOARD

Login to WEkEO and click on your <username>.  A drop-down menu with several options is shown as below. Select the option Virtual Machines.

vm_step1

In the single-sign-on page, select the option CAS.

Single-Sign-On

 

 

 

 

 

 

 

 

 

The dashboard is shown:

vm_step3

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

USER SETTINGS

Before creating any VMs, please make sure that your user credentials are configured for Linux (VM account). These credentials are different from the WEkEO username and passowrd that are used to access the platform. The Linux credentials are required to login into any provisioned VM instance. To configure credentials for the VM, navigate to <username> in  dashboard and select "USER SETTINGS" from the drop-down list as shown below.

User settings menu

 

VM user credentials and Key Pairs:

The panel to set-up the credentials for VMs is displayed. Under "Linux Settings", enter the desired username and password to be used in the deployed VM. In this example, user 'test' is created.

 

 

Key Pairs are commonly used for accessing instances via SSH, on WEkEO the following actions are enabled: Add and Delete. WEkEO stores key pairs to simplify administration.

To navigate to the Key Pairs section:

  1. Select the Infrastructure link in the navigation bar
  2. Select the Keys & Certs link in the sub navigation bar

Please also refer to the section "virtual machine account" in the wekeo registration page

 

CREATE A VM INSTANCE

Navigate back to the dashboard and click on Provisioning. All the VM instances and other related statistics are showed in a panel. Click on the ADD button (circled in red in the figure below) at the top of the list of instances. This will open a dialog to configure a VM instance by selecting OS, storage, network etc.

guide_vm_step5

In the first step, the user is asked to select the type of instance (operating system, OS) among the ones showed in the figure below:

guide-vm-select-os

Operating System: select one OS and click NEXT. In the example below, CentOS has been selected for the VM instance to be provisioned.

CentOS

 

 

 

 

 

 

Group: After selecting the OS, continue to the 'Group' tab. Enter a desired name for the VM instance and select one of the following environment tag from the drop-down list: Dev, Test, Staging, Production. Also to make it easier search the instance later by keywords, enter these keywords under Tags.

guide-vm-08

 

Configure: Continuing to next tab provides several configuration options including storage and network. Following fields are of interest and rest of the fields can stay with the default values.

Configure VM

Version: This refers to OS/Linux image version to use for the instance. This can be left to default value.Plan:  You are allowed to launch instance(s) whose combined allocation of resources should not exceed the maximum defined by category XS or S (depends on the role) in the table below. For instance, if you are allowed for XS category, then you can create two instances of m1.large (CPU:2, RAM:16GB) or one instance of m1.xlarge (CPU:4, RAM:32). Similarly if you are allowed for S category, then you can create two instances of m1.xlarge (CPU:4, RAM:32) or one instance of m1.2xlarge.

Volumes: You can define one or more volumes as per your usage needs. By default a single volume (block storage) is created.

Network: Select the only network shown in the drop-down list as shown below

select network

 

Security Group: Select the security group "default".

security group

Assign floating IP: Select the only option available in the drop-down list 'Assign floating ip' if you require the VM instance to be configured with public IP address (for reaching the instance from internet ).

 

Assign floating ip

 

Automate: Continue to the next tab 'Automate'. All the default values can be left unchanged. 

Automate

 

Review: The final tab shows the summary of the configured options for the VM. If everything looks ok, click on 'Complete' to provision the VM instance.

Review of VM options

 

Locate the instance: Now search for the VM instance by entering the first few characters of the VM instance name that you provided in the previous step. In this example, we have used 'myFirstVM' as the name of the instance. 

Instance name

 

Click on the row in the result set that corresponds to the instance that you just created. This will display the panel showing the progress in provisioning the instance. 

Instance provisioning progress

Public IP address: Once the instance is ready, the public IP address (if floating ip was chosen) is visible under VMs option.

public IP address

 

Console access: Scrolling down further shows various tabs including one to access the VM via its console. Clicking on the 'Console' tab opens the console of the instance. Press 'Enter' key if the login prompt is not visible in the console. Now enter the credentials (see above) to access the provisioned instance.

19-Console

 

 

DELETE A VM INSTANCE

Please, delete the instance if its no longer required by clicking the DELETE button (see figure below).

 

 

WEkEO Virtual Machines video demo

This section shows step-by-step the provisioning of a dedicated Virtual Machine (VM) on the WEkEO portal.