[[PageOutline]] = 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.[[BR]] 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[[BR]] (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/)[[BR]] 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.[[BR]] Use the -f option to specify the path to the certificate (/home/geni/Tutorials/GEMINI//ssh/.pem) == Issues? == Notify geni-gemini-users@googlegroups.com if you run into any issues.