Instructions for using the GEC15 Tutorial VM for GEMINI

Preparing the User workspace Virtual Machine

  • Install VirtualBox

Download the VirtualBox software from

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.ova) from the website

  • Install the GEC15_Tutorials.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 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
  1. Run
$ -g ~/Tutorials/GEMINI/geminiXX/ssh/geminiXX.pem -b ~/Tutorials/GEMINI/geminiXX/ssh/geminiXX.p12
  1. 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: 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)


Notify if you run into any issues.

Last modified 11 years ago Last modified on 10/23/12 12:44:51