Changes between Version 24 and Version 25 of GiB-gettingStarted

Timestamp:

10/02/12 14:10:10 (12 years ago)

Author:

Vic Thomas

Comment:

--

GiB-gettingStarted

@@ -6 +6 @@
 
 
-== Install GENI-in-a-Box ==
+== 1.0 Install GENI-in-a-Box ==
 ''Please make sure you have [https://www.virtualbox.org VirtualBox] Version 4.1.16 or later installed on your computer.''
 
@@ -16 +16 @@
 
 
-== Get Started with a Simple Experiment ==
-
-=== Discover Resources ===
+== 2.0 Get Started with a Simple Experiment ==
+
+=== 2.1 Discover Resources ===
 
 We start by finding out the aggregates available to us inside GENI-in-a-Box and learning about the resources advertised by these aggregates:
@@ -127 +127 @@
 The output of the command is the ''advertisement rspec'' from the GENI-in-a-Box aggregate.  You'll see the aggregate advertises six compute resources.   Only two are shown here for readability reasons but you will find the complete advertisement rspec [attachment:gib-advert.rspec here].  Look at the description of the first resource in the rspec.   This compute resources is an openVZ container running Fedora 15 image (or an Ubuntu 10 image if you are using the Ubuntu flavor of GENI-in-a-Box).  The  resource has four network interfaces: {{{eth0}}} through {{{eth3}}}.  {{{eth0}}} is a control interface and is not available to the experimenter.  All six compute resources advertised by this aggregate are identical.  You can therefore use this aggregate to create experiment topologies with up to six nodes and up to three links per node. 
 
-=== Run an Experiment ===
-We are now ready to run an experiment using these resources.  We'll start with a very simple experiment that consists of two hosts connected to one another by a single link.   When the hosts come up they execute an experimenter specified script that:
+=== 2.2 Acquire and configure resources ===
+Before we run an experiment we need to acquire the resources needed the experiment.   Our introductory experiment will consist of two hosts connected to one another by a single link.   When the hosts come up they execute a script provided by us that:
     * Downloads and installs iperf on each host.
     * Runs iperf in server mode on one host and and in client mode on the other host.  The outputs of the iperf commands are written to /tmp/iperf-server.log and /tmp/iperf-client.log on the respective hosts.
@@ -142 +142 @@
 We'll use the rspec file called two-nodes-iperf.rspec.  You can view it [attachment:two-nodes-iperf.rspec here] or inside the VM.  This rspec requests two hosts called {{{left}}} and {{{right}}}.  Host {{{left}}} has one interface called {{{left:if0}}} and host {{{right}}} has one interface called {{{right:if0}}}.  The two interfaces are connected by a link called {{{left-right-lan}}}.   The {{{<install>}}} element in the rspec asks the GENI-in-a-Box aggregate manager to download a [attachment:iperf-execute-script.sh script] from the specified URL, uncompress and untar it,  and save it in the /local directory.  The {{{<execute>}}} element asks the aggregate to execute the specified script when the hosts come up.  In this case the script to be executed is the one that was installed in {{{/local}}}.
 
-The following steps will walk you through running this experiment:
-
-1. First we need to create a slice using the command {{{omni.py createslice myslice}}} where {{{myslice}}} is the name or our slice (of course you can give you slice some other name).
+The following steps will walk us through acquiring the resources for our experiment:
+
+1. First we need to create a slice using the command {{{omni.py createslice myslice}}} where {{{myslice}}} is the name or our slice (of course you can give your slice some other name).
 {{{
 $ omni.py createslice myslice