[[PageOutline]] = Get to Know the GENI Experiment Engine = == Overview: == The GENI Experiment Engine (GEE) platform provides simple, preconfigured environments called '''slicelets''' to GENI users. A slicelet consists of [https://www.docker.com Docker containers] running on InstaGENI racks; all the containers in a slicelet are connected by a private L3 network. The goal of GEE is to make it fast and easy to get a basic experiment up-and-running on GENI (a.k.a., "the five minute rule"). This tutorial will familiarize participants with the GENI experiment engine. ---- '''The goal of the tutorial is, on each node, to run an HTTP query of the form:''' '''!http://www.lively-web.org/nodejs/GEETutorial/helloWorld?slice=&name=&ip=&local=&lat=&lng=''' '''This page will log each of your queries, and you can check that all your nodes were successfully able to run the query.''' ---- To meet this objective, participants will use [http://docs.ansible.com Ansible] to install software and run commands on GEE slicelets spanning 20 InstaGENI racks. == Prerequisites: == Familiarity with Linux. == Tools: == - During the tutorial we will use the [http://gee-project.org GEE Portal] to allocate slicelets to participants. You may instead allocate your slicelet in advance if you'd like. - We will be using [http://docs.ansible.com Ansible] to install software in and manage GEE slicelets. Though it's not required to complete the tutorial, you may want to install Ansible on your laptop following [http://docs.ansible.com/intro_installation.html these instructions]. Ansible does not run directly on Windows; Windows users who want to install Ansible locally can use [http://vagrantup.com Vagrant] to install an Ubuntu VM on their machine, and then install Ansible in that VM. == How to get help: == During the tutorial, please raise your hand and one of the tutorial leaders will help you. == Resources: == * GEE Portal: http://gee-project.org * Ansible: http://docs.ansible.com == Tutorial Instructions == {{{ #!html
Design/Setup
  • Part I: Design/Setup
    1. Get a GEE slicelet and download GEE helper files
    2. Learn about GEE networking
    3. Configure the Ansible controller for your slicelet
    4. Learn basic concepts of Ansible
Execute
  • Part II: Execute
    1. Create and run an Ansible playbook to install the software you'll need
    2. Create an Ansible playbook to download a parameterized URL from each node
    3. Run the playbook
    4. Verify that the playbook worked as expected
Finish
}}}