Version 21 (modified by, 7 years ago) (diff)


GIMI & GEMINI on one InstaGENI slice


Start with this rspec which was created to use GIMI on InstaGENI. Create a couple slices & use that rspec in Flack with an InstaGENI aggregate. Then add GEMINI extensions through Flack. Here is an example of the final rspec at Utah InstaGENI. Below is the topology created.


There are two ways to initialize and instrumentize slices: through the GENI Desktop or using the gdesktop scripts. You only need to choose one of these two options.

GENI Desktop

Access the GENI Desktop at the following link: Login to the GENI Desktop using a supported clearinghouse. The GENI Desktop will direct you to your login page. Once you return to the GENI Desktop you will need to give your passphrase that you set when created your SSH key pair.

From the GENI Desktop you will be able to see your slices and their status. Click on the slice it want to initialize and the process will begin.

Once your slice has been initialized, click on the instrument to instrumentize your slice.

Instrumentation will take some time. When it is complete, a blue bar will appear at the top of your screen that you must click to reload your slice.

Gdesktop Scripts

On the GEC 17 tutorial VM, the gdesktop scripts are located at the following directory: ~/GEC17Tutorials/GEMINI/UW/geminiv2/. To run these scripts switch to this directory using the following command in the VM.

cd ~/GEC17Tutorials/GEMINI/UW/geminiv2/

To check the status of your slice, use the following command. In this example “GEMINIandGIMI” is the name of the slice and “~/Download/geni-keleigh.pem” is the location of my ssh key.

./ -n GEMINIandGIMI -f ~/Downloads/geni-keleigh.pem 

Initialize your slice using the following command, replacing my slice name and ssh key location with yours.

./ -n GEMINIandGIMI -f ~/Downloads/geni-keleigh.pem 

You should get output similar to this but the AM will be replaced with the one you used:

Instrumentize your slice by using the following command, replacing my slice name and sshkey location with yours.

./ -n GEMINIandGIMI -f ~/Downloads/geni-keleigh.pem 

You should get output similar to this:

When your slice finishes instrumentizing, login to the GENI Desktop and click on your slice there.

GENI Desktop features

From the GENI Desktop you can SSH into your nodes. Click on the launch icon(which looks like a rocket ship) and select “SSH”. Then click on the node you want to SSH into and select “Open SSH”.

You may get a window saying that the site is untrusted. Continue and accept the security certificate.

To see graphs of the GENI Desktop, click on the launch icon(which looks like a rocket ship) and select “GEMINI Graphs”.

Select the graphs you would like to appear and the nodes for which you would like to see graphs. Then press "Add Graphs" or "Add Graphs with Title". You can click on these graphs to open them in a new window.

Global Node:
Access the global node by choosing GEMINI GN from the launch menu. From here you can choose “View Live Feed” which allows you to see all the tables and graphs stored within the global node and use tools such as Wireshark.

Click on “Open PS Config” to open a window that allows you to view active measurements & create various tests to run on your slice.


Access LabWiki at the following link: Login to LabWiki using your GENI Portal credentials. When prompted send your information to LabWiki.

Type “step” in the search bar below “Prepare”. It should give options. Select the script ending in “step1-ping_all.rb”. Click and drag the paper and pencil icon to the column titled “Execute”.

Type your experiment name and slice name in the respective boxes under the Execute column. Make any necessary edits to the boxes labeled source1 through source5 so that they match the names of your nodes(if you used the rspec above the node will already be named properly). Write “true” in the graph box.

Scroll to the bottom of the Execute column and click on “Start Experiment”. Your experiment will begin and you can see progress in the log under the Execute column. When the experiment end a thin green bar will appear in that column.

If you open your slice in the GENI Desktop you can see changes on the graphs shown by the GENI Desktop while LabWiki is running experiments.

Repeat these LabWiki steps with the scripts ending with “step2-routing.rb”, “step3-ping_e2e.rb”, and “step4-otg_nmetrics.rb”. The input will very depending on the experiment script.

GIMI & GEMINI on one ExoGENI slice


If you plan to use the GENI Desktop to instrumentize your slice, follow those instructions before reserving resources
Use this rspec to create ExoGENI slices in Flack that had both GIMI and GEMINI. Below is the topology created.

If you are creating your own topology here are some things to keep in mind:
For GEMINI, the nodes must be named in a specific way. All global nodes must start with the prefix “GN-” and all other nodes must start with the prefix “MP-”. You will want to use an image from a GEMINI ExoGENI rspec for your global node rather than a GIMI image. Below is an example image for the global node:

<disk_image name="" version="58b9dd5ff527b570398124443e17ac2e66925bbd"/>

GEMINI needs to execute commands on each node with sudo. Sudo requires that each node has a hostname that is resolvable. Thus we will include a postboot script that sets a unique hostname and adds an entry in the /etc/hosts file so the hostname can be resolved. This allows the sudo commands to run without returning an error code.
On your MP nodes include the following section of code to add this postboot script:

    <install url="" install_path="/tmp" />
    <execute shell="/bin/bash" command="/tmp/ $sliceName $self.Name()"/>


The stable version of the GENI Desktop does not currently handle ExoGENI slices. I used the development version of the GENI Desktop and the development version of the gdesktop scripts to initialize & instrumentize the slices.

GENI Desktop

Login to GENI Desktop before reserving resources for your slice. Once you are on the page with your slices listed, go to address bar and change “stable” in the link to “dev” and go to that new page.

Keep this window open & create your slice as explained above. Go back to the development version of the GENI Desktop and refresh the page.
Follow the same steps for initializing and instrumentizing your slice as for with an InstaGENI slice. You will notice a green background when you are in development mode.

Gdesktop Scripts

For the development version of the gdesktop scripts be sure to add the –devel flag as seen below when running all scripts.

./ -n GEMINIandGIMI2 -f ~/Downloads/geni-keleigh.pem  --devel
./ -n GEMINIandGIMI2 -f ~/Downloads/geni-keleigh.pem  --devel

GENI Desktop Features

Within the GENI Desktop I could not see graphs or tables. I was able to SSH into the nodes via the GENI Desktop.


In LabWiki run the four experiment scripts on the slices just as you did with your InstaGENI slices. Instructions are here. Be sure to edit the boxes labelled source1 through source5 so they match the names of your nodes.

Attachments (36)