Version 10 (modified by Hussamuddin Nasir, 5 years ago) (diff)


Lab One: Understanding the AM API using Named Data Networking


This experiment on GENI is useful for familiarizing new experimenters with GENI and the tools for using GENI.

This tutorial uses custom OS images; thus, it may take longer for the resources allocated to load the custom OS images.


Background information about pre-requisites, tools, resources, and where to get help.


  • The user must have configured the SSH keys
  • The user must have downloaded and configure Omni tools
  • Check your Java installation and other requirements here!

What you will learn

The high levels goals for this exercise are to:

  1. Understand what happens behind the scenes when you run and experiment in GENI
  2. Learn about RSpecs and the GENI AM API
  3. Learn about the Omni experimenter tool

You will learn these concepts by running an experiment based on the Named Data Networking (NDN) Future Internet Architecture. The NDN Forwarding Daemon (NFD) will be installed on the nodes in your network and you will run an application that fetches content by name. Optionally, you can instrument you application using the GENI Desktop to see graphs of traffic on the network links. This will give you greater insight into when application data is fetched from a cache and when it comes all the way from a data source.

Experiment Topology and Setup

Tutorial Setup

Five VMs at the same physical location connected by Layer 2 links. This scenario emulates the real NDN testbed, where the University and Internet nodes are equivalent to Hubs in the NDN testbed.


  • Part I: Design/Setup
    • Step 1: Design Experiment
    • Step 2: Establish Environmentt
    • Step 3: Obtain Resources
  • Part II: Execute
    • Step 4: Wait for resources to be ready
    • Step 5: Try out NDN application