= GpENI =
Evaluation requires access to [https://geni-planetlab-5.ksu.gpeni.net/ GpENI Integrated Access Portal] as a GpENI Administrator account to create a slice and add !PlanetLab and VINI nodes to the slice.

Information about GpENI was found at [https://wiki.ittc.ku.edu/gpeni_wiki/index.php/Main_Page GpENI: Great Plains Environment for Network Innovation] wiki page.

Version reviewed in this evaluation are MyPLC 5.0 (revision 17) and MyVINI (revision 18485).

Time frame: This evaluation took place July 1-9, 2010.

= GpENI Findings =

At [https://geni-planetlab-5.ksu.gpeni.net/ GpENILab Test Portal] tried to created account by
selecting the "Create an Account" option and but not sure which site.  Site PI re-directed me 
to http://www.ittc.ku.edu/gpeni/contact.php form to request an GpENI Administrator account.
No response from this request.  Account was eventually set up by intern Ali Sydney at the 
[https://geni-planetlab-5.ksu.gpeni.net/ GpENI Integrated Access Portal].

Once installed there is a failure in running the myvini.sh conversion script, the script is
trying to get a missing file from the VINI site.  Awaiting responses to request to address
missing file.


= GpENI How-to =

A slice was already created at the [https://geni-planetlab-5.ksu.gpeni.net/ MyVINI controller] that included one VINI node and 1 !PlanetLab node on the GpENI network. Requested details of procedure used to set up the nodes. 

Here is the procedure used to add the nodes to the slice:

 1. Install the MyPLC controller and follow instructions in the 
    [http://www.vini-veritas.net/documentation/trellis/administrator MyVINI Administrators Guide].  
    After installing MyPLC, execute  the following to transform the MyPLC instance in to MyVINI:
{{{
 $ svn co http://svn.planet-lab.org/svn/MyVINI/trunk MyVINI
   A    MyVINI/myvini.sh
   A    MyVINI/configs
   A    MyVINI/configs/iptables
   A    MyVINI/configs/sudoers.php
   A    MyVINI/configs/yum.conf
   A    MyVINI/myvini-plcsh.py
   A    MyVINI/README
   Checked out revision 18485.
   $ cd MyVINI
   $ sudo ./myvini.sh
   --09:48:36--  http://www.vini-veritas.net/boot/bootstrapfs-planetlab-i386.tar.bz2.production
           => `/var/www/html/boot/bootstrapfs-planetlab-i386.tar.bz2'
   Resolving www.vini-veritas.net... 143.215.131.196
   Connecting to www.vini-veritas.net|143.215.131.196|:80... connected.
   HTTP request sent, awaiting response... 200 OK
   Length: 152,626,141 (146M) [application/x-bzip2]
    6% [===>                                                                ] 10,360,392    --.--K/s  ETA 3:26:37
   10:03:39 (11.20 KB/s) - Read error at byte 10360392/152626141 (Connection timed out). Retrying.
   --10:03:40--  http://www.vini-veritas.net/boot/bootstrapfs-planetlab-i386.tar.bz2.production
  (try: 2) => `/var/www/html/boot/bootstrapfs-planetlab-i386.tar.bz2'
   Connecting to www.vini-veritas.net|143.215.131.196|:80... connected.
   HTTP request sent, awaiting response... 206 Partial Content
   Length: 152,626,141 (146M), 142,265,749 (136M) remaining [application/x-bzip2]
   100%[++++===============================================================>] 152,626,141    3.20M/s    ETA 00:00
   10:04:12 (4.28 MB/s) - `/var/www/html/boot/bootstrapfs-planetlab-i386.tar.bz2' saved [152626141/152626141]
   --10:04:12--  http://svn.planet-lab.org/svn/NodeManager-topo/trunk/create-topo-attributes.py
           => `/root/topo/create-topo-attributes.py'
   Resolving svn.planet-lab.org... 128.112.139.50
   Connecting to svn.planet-lab.org|128.112.139.50|:80... connected.
   HTTP request sent, awaiting response... 200 OK
   Length: 12,263 (12K) [text/plain]
   100%[===================================================================>] 12,263        --.--K/s             
   10:04:13 (288.43 KB/s) - `/root/topo/create-topo-attributes.py' saved [12263/12263]
}}}
 2. Two tar files are needed:

   2a. Install MyPLC: The MyPLC installation generates a "bootstrap" tarball that contains the Linux Kernel,
       that is renamed to correspond to the !PlanetLab "nodegroup" name used in the MyPLC controller.

   2b. Convert MyPLC to MyVINI: This conversion also generates another tarball containing the 
       Linux Kernel and some trellis modules for creating virtual topologies. This bootstrap 
       file should be renamed to correspond to the VINI nodegroup. 

 3. Create 2 "nodegroups" within the MyVINI controller: 1 VINI and 1 !PlanetLab nodegroup.  A 
    Nodegroup is a means to group similar nodes. All !PlanetLab nodes are placed in the same 
    nodegroup, and same for all VINI nodes.  

 4. Add each node to the respective nodegroup.

 5. Downloaded the respective images for each node and booted each node


The procedure above was not executed, the existing nodes were accessed in the slice definition at the portal
as shown in this capture:

[[Image(2010-07-06_GpENI-2.jpg)]]