Home

Welcome to the geni-tools wiki

The geni-tools project provides a reference implementation of the GENI Aggregate Manager API. It consists of:

• omni - A command line client for reserving GENI resources via the GENI Aggregate Manager API
• gcf-am - A reference implementation of a GENI Aggregate Manager
• gcf-ch - A reference implementation of a GENI Clearinghouse

Getting Started

1. Download the software in the appropriate form:
   • Download the source (for use on Linux/Unix systems)
   • Download binaries for Windows
   • Download binaries for MacOS
2. Install the software
   • Install from source
   • Install the Windows binaries
   • Install the Mac binaries
3. Configure the software using one or both of the following:
   • Configure omni: For experimenters that want to use the command line tool to reserve resources in GENI.
   • Configure gcf: For developers that want to test with or build on top of the reference aggregate and clearinghouse. To actually test gcf you probably also need to configure omni.

Upgrading

• To upgrade Windows binaries, uninstall the existing version and then install the new version.
• To upgrade Mac binaries, uninstall the existing version and then install the new version.
• For UNIX, follow the upgrade instructions.

Reference Documentation

• Overview of Omni. This includes installation instructions, tutorials and detailed documentation for Omni.
• Common errors using Omni
• Using Omni to run acceptance tests that verify AM API compliance

Getting Help

• Omni users should join the geni-users google group to be notified of updates to omni and to get help with omni problems.
• For help with other geni-tools programs, developers should join the gcf-developers google group