Changes between Initial Version and Version 1 of GENIExperimenter/Tutorials/GENI-SAVI


Ignore:
Timestamp:
05/22/15 15:14:47 (9 years ago)
Author:
acb@cs.princeton.edu
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • GENIExperimenter/Tutorials/GENI-SAVI

    v1 v1  
     1[[PageOutline]]
     2
     3= Get to Know the GENI Experiment Engine =
     4== Overview: ==
     5The 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. 
     6
     7----
     8
     9'''The goal of the tutorial is, on each node, to run an HTTP query of the form:'''
     10
     11  '''!http://www.lively-web.org/nodejs/GEETutorial/helloWorld?slice=<slice name>&name=<container name>&ip=<IP of host>&local=<IP of  container>&lat=<latitude of host>&lng=<longitude of container>'''
     12
     13'''This page will log each of your queries, and you can check that all your nodes were successfully able to run the query.'''
     14
     15----
     16
     17To meet this objective, participants will use [http://docs.ansible.com Ansible] to install software and run commands on GEE slicelets spanning 20 InstaGENI racks.
     18
     19== Prerequisites: ==
     20
     21Familiarity with Linux.
     22
     23== Tools: ==
     24   - 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.
     25   - 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.
     26
     27== How to get help: ==
     28
     29During the tutorial, please raise your hand and one of the tutorial leaders will help you.
     30
     31== Resources: ==
     32
     33 * GEE Portal: http://gee-project.org
     34 * Ansible: http://docs.ansible.com
     35 * [wiki:GEC22Agenda/ConfigMgmt Tutorial: Configuration Management Tools for Experimenters]
     36
     37== Tutorial Instructions ==
     38{{{
     39#!html
     40
     41
     42<table id="Table_01" height="409" border="0" cellpadding="0" cellspacing="0">
     43        <tr>
     44                <td>
     45                        <a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIExperimentEngine/DesignSetup"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/design.png?format=raw" width="152" height="152" alt="Design/Setup"></a>
     46               </td>
     47               <td>
     48<ul>
     49             <li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIExperimentEngine/DesignSetup">Part I: Design/Setup</a></li>
     50             <ol>
     51                 <li> Get a GEE slicelet and download GEE helper files </li>
     52                 <li> Learn about GEE networking </li>
     53                 <li> Configure the Ansible controller for your slicelet </li>
     54                 <li> Learn basic concepts of Ansible </li>
     55             </ol>
     56               </td>
     57        </tr>
     58        <tr>
     59                <td>
     60                        <a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIExperimentEngine/Execute"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/execute.png?format=raw" width="152" height="143" alt="Execute"></a>
     61                </td>
     62                <td>
     63             <ul>
     64<li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIExperimentEngine/Execute">Part II: Execute</a></li>
     65             <ol>
     66                 <li> Create and run an Ansible playbook to install the software you'll need </li>
     67                 <li> Create an Ansible playbook to download a parameterized URL from each node </li>
     68                 <li> Run the playbook </li>
     69                 <li> Verify that the playbook worked as expected </li>
     70             </ol>
     71                </td>
     72        </tr>
     73        <tr>
     74                <td>
     75                        <a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIExperimentEngine/Finish"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/finish.png?format=raw" width="152" height="114" alt="Finish"></a>
     76                </td>
     77
     78                <td>
     79             <ul>
     80             <li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIExperimentEngine/Finish">Part III: Finish</a></li>
     81             <ol>
     82                 <li> Free the GEE slicelet </li>
     83             </ol>
     84                </td>
     85
     86        </tr>
     87</table>
     88
     89}}}