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, [wiki:Windows#Uninstall uninstall] the existing version and then [wiki:Windows install] the new version.
• To upgrade Mac binaries, [wiki:MacOS#Uninstall uninstall] the existing version and then [wiki:MacOS install] the new version.
• For UNIX, follow the [wiki:QuickStart#Upgrade upgrade] instructions.

Reference Documentation

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

Getting Help

• Omni users should [https://groups.google.com/forum/#!forum/geni-users subscribe] to geni-users@googlegroups.com to be notified of updates to omni and to get help with omni problems.
• For help with gcf send email to gcf-developers@googlegroups.com or [https://groups.google.com/forum/#!forum/gcf-developers subscribe].