Tom Mitchell edited this page May 11, 2017 · 7 revisions


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 Tools software package or alone as Mac or Windows binaries.

The current version of Omni is 2.10. Older versions are available on the releases page or via git.

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.

  • Omni workflow is a complete example and workflow for using Omni.

    Omni Workflow

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:

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.