wiki:GEMINI/Tutorial/GEC15/Background/VM

Version 4 (modified by carpenter@vis.uky.edu, 11 years ago) (diff)

--

Instructions for using the GEC15 Tutorial VM for GEMINI

Preparing the User workspace Virtual Machine

  • Install VirtualBox

Download the VirtualBox software from http://www.virtualbox.org.

If you already have VirtualBox installed on your machine, make sure it is version 4.1 or above.

  • Download VirtualBox VM image for tutorials

Download the VirtualBox VM image (GEC15_Tutorials_Final.ova) from the website https://www.planet-lab.org/GEC15/

  • Install the GEC15_Tutorials_Final.ova virtual machine image

Start up VirtualBox, select File->Import Appliance..., and follow the instructions. Accept the default VM settings during the import.

To run the virtual machine, go to the Oracle VM VirtualBox Manager window, select the VM and click the green arrow labeled Start at the top of this window.

If the install was successful, you should see the logon screen for the Ubuntu OS.

Logging in

Login information for the VM will be provided at the beginning of the tutorial.

Once you are on the VM, you can access the credentials directly in the directory: /home/geni/Tutorials/GEMINI.
There is a directory for each user. The ssh directory contains the certificates and keys.

You will be assigned a username and password at the beginning of the tutorial.

SSL Key/Password Configuration

The instrumentize.py script requires password-less access to the nodes. Follow these steps to set this up.

  1. Place your GENI password in the file /home/geni/.ssl/password
  2. Add your ssh key to the ssh-agent by running the command (replacing geminiXX with your username):
    $ ssh-add /home/geni/Tutorials/GEMINI/geminiXX/ssh/geminiXX_key
    

Updating the code

You can get the latest scripts, configuration, and rspec files by changing to the GEMINI common directory and doing a git pull:

$ cd ~/Tutorials/GEMINI/common
$ git pull

Creating the slice

  • Flack: log in as the tutorial user that you chose
    (don't forget to log into the SA first: pgeni.gpolab.bbn.com). There are bookmarks for both in the Firefox toolbar.
  • OMNI: cd to the directory for your user (~/Tutorials/GEMINI/<username>)
    You can run omni commands directly from here and it will use the omni_config in that directory.
  • Protogeni test scripts: you can find them in /opt/protogeni.
    Use the -f option to specify the path to the certificate (/home/geni/Tutorials/GEMINI/<username>/ssh/<username>.pem)

Running instrumentize script

  • Make sure you have the most up-to-date scripts (see Updating the code above).
  • Run instrumentize.py from the directory /home/geni/Tutorials/GEMINI/common specifying your GENI certificate and the slice name.
$ instrumentize.py -f /home/geni/Tutorials/GEMINI/geminiXX/ssh/geminiXX.pem -n geminiXXslice

Accessing the portal

Before accessing the portal, add your certificate to the browser using these instructions

Issues?

Notify geni-gemini-users@googlegroups.com if you run into any issues.