- Table of contents
- New User Quick Start Tutorial
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 firstname.lastname@example.org -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.
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