Project

General

Profile

New User Quick Start Tutorial

This is Obsolete now. Please look at OpenNebula4 New User Quick Start Tutorial instead.
Steps in this Tutorial will still work to access the old OpenNebula3 cloud if you substitute
fcl301.fnal.gov for fermicloud.fnal.gov below.

In order to be able to start Virtual Machines (VMs) in FermiCloud you should follow this steps (only once):

1. Create FermiCloud account

It is necessary to apply for an account to use FermiCloud, any registered employee, contractor, or visitor of Fermilab can do this.

New request should be submited via the Service Desk. Request FermiCloud Account

You will be able to instantiate, delete and monitor VMs from both the SSH command line and the web GUI.

2. SSH in FermiCloud and start a test VM

1. Get a valid kerberos ticket and ssh in fermicloud.fnal.gov.

HINT: you should be forwarding your kerberos ticket (this is client SSH setup). Some useful links if you have trouble with this here: and here:http://kb.mit.edu/confluence/pages/viewpage.action?pageId=4259969

2. Source user.sh and run 'onetemplate list'.

This is what you should run:

ssh $USER@fermicloud.fnal.gov
source /cloud/images/OpenNebula/scripts/one3.2/user.sh
onetemplate list 

This is aproximately what you should see:

$ ssh gerard1@fermicloud.fnal.gov
-bash-4.1$ source /cloud/images/OpenNebula/scripts/one3.2/user.sh
Service kx509/certificate
 issuer= /DC=gov/DC=fnal/O=Fermilab/OU=Certificate Authorities/CN=Kerberized CA HSM
 subject= /DC=gov/DC=fnal/O=Fermilab/OU=People/CN=Gerard Bernabeu Altayo/CN=UID:gerard1
 serial=0297ECA5
 hash=aa4b46f1
export ONE_AUTH=/cloud/login/gerard1/.one/one_x509
-bash-4.1$ onetemplate list 
  ID USER     GROUP    NAME                         REGTIME
  50 oneadmin oneadmin SLF6                  11/26 16:16:25
  56 oneadmin oneadmin SLF5                  12/11 10:18:27
 131 oneadmin oneadmin SLF5 32bit            06/06 12:58:08
 132 oneadmin oneadmin SLF6 32bit            06/06 12:59:54
 211 oneadmin oneadmin SLF6x IB x64          12/05 17:40:10
 220 oneadmin oneadmin SLF6x Vanilla         01/13 13:11:16
-bash-4.1$ 

3. Start a SLF6 VM, name it '$USER test VM', then check if it's online:

This is what you should run:

onetemplate instantiate "SLF6x Vanilla" --name "$USER test VM" 
onevm list
sleep 100
one_check-pingVMs.sh

You should see something like:

-bash-4.1$ onetemplate instantiate "SLF6x Vanilla" --name "gerard test VM" 
VM ID: 6598
-bash-4.1$ onevm list
    ID USER     GROUP    NAME         STAT CPU     MEM        HOSTNAME        TIME
  6598 gerard1  users    gerard test  runn   2      2G          fcl412 00 01:40:03
-bash-4.1$ one_check-pingVMs.sh 
+OK - Pingable VMs (1/1):
      6598 gerard1  users    gerard test  runn   2      2G          fcl412 00 01:37:40    fermicloud032.fnal.gov.

-bash-4.1$ 

From the output you can see that VM ID 6598 is owned by user gerard1, it's running on a host named fcl412 and it's hostname is 'fermicloud032.fnal.gov'.

The VM ID is unique, VM ID 6598 will be only this VM and once it is removed no other VM will reuse this ID. The hostname of the VM (fermicloud032.fnal.gov) will not change for the lifetime of the VM, but after you remove the VM the hostname gets reused.

4. Let's try to SSH in the freshly created VM, you are root in this machine and from now on you will be the admin.

ssh root@fermicloudO32.fnal.gov

At this point you could do whatever you need to do with the VM (eg: software testing)

5. Cleanup. Now that you are done with the VM, it is time to remove it. SSH in fermicloud.fnal.gov and use 'onevm delete $ID' or 'onevm shutdown $ID' to remove the VM.

-bash-4.1$ onevm delete 6598
Are you really sure you want to delete this VM? Type a Capital Y
Y
You seem sure, we proceed
-bash-4.1$ onevm list | grep  6598
-bash-4.1$ 

For the standard type of VMs that you get from FermiCloud both 'onevm delete' (hard stop + delete) and a 'onevm shutdown' (ordered shutdown + delete) will completely remove them.
You can only remove your own VMs.

3. Open the web GUI and start a test VM

1. Get a valid Kerberos certificate loaded in your web browser (eg: firefox). You can find instructions here http://computing.fnal.gov/authentication/kca/
2. Open this link from your web browser: http://fermicloud.fnal.gov
3. Click on 'Virtual Machines' from the left menu, here you will see are your VMs.
4. To create a new VM click on the upper left button labeled '+New'. A new form will pop up, here you should type a name for you to identify the VM, select a template and the number of VMs to create. Hit the Create button.
5. If the page does not self-refresh hit the refresh button (by the +New button). Once you see your new VM you can proceed to delete it using the Delete button at the upper right corner.

Now you're ready to use FermiCloud! For more details and VM flavours please take a look at the Quick User Guide