This page has moved to


Omni Client
Omni is a GENI command line tool for reserving resources at GENI aggregate managers via the GENI AM API using user accounts issued by a GENI clearinghouse.

An aggregate manager is a software server that provides resources to clients based on the GENI aggregate manager API. A clearinghouse provides users with GENI accounts (credentials). The Omni client communicates with a user's clearinghouse to create slices, enumerate available GENI aggregates, and access user and slice credentials which Omni uses when reserving resources from the available aggregates.

Getting Omni

The Omni client is distributed either as part of the  GENI Control Framework (GCF) software package or alone as a Mac or Windows binaries.

The current version of Omni is 2.10. Look here for older versions.

To use Omni:

  1. Download the software in the appropriate form:
  2. Install the software
  3. Configure omni

Omni Documentation


  •  Hello Omni is a simple introductory tutorial about using Omni. It will help you setup your environment and run a simple GENI experiment that will walk you through most of the Omni commands. This example does not include any OpenFlow aggregates, so if you want to also do a more advanced OpenFlow tutorial refer to the next set of tutorials.

Help using Omni

If you find yourself in need of help, here are some resources for you:

Scripting Examples

Omni can be used as a library in custom Python scripts. Here are some simple examples that you can use as references to learn more about scripting with Omni:

  • OmniScriptingWithOptions - An example script that uses Omni as a library and combines both Omni and its own command line arguments
  • OmniScriptingExpiration - A minimal script using Omni as a library that gets slice expiration times for all of an experimenter's slices

Older Versions

  • OmniUpdate from 1.6 - For instructions on updating to Omni V2.0+ from an earlier version, and the differences to expect