Version 22 (modified by Ben Newton, 8 years ago) (diff)


1. Download and Install Omni

Windows 8 (other Windows versions similar)

  1. Download Omni Windows Binaries at
  2. Click Accept, and run the downloaded executable file when the download completes.
  3. Click Next, accepting the agreement and the defaults for several (4) screens, then click Install. If you change the default location, be sure you change the path below to match.
  4. Click Next, and Finish to complete the install.
  5. Now, to configure the path, open Control Panel, and search for PATH in the search box.
  6. Click "Edit the system environment variables"
  7. Click the Environment Variables... button
  8. Under system variables select the Path variable and click Edit...
  9. Click New, and type the install location: C:\Program Files (x86)\omniTools-2.10
  10. Click OK three times to close the three windows.

Mac OS

  1. Download Omni Mac OS Binaries at
  2. Click Accept, then double-click on omniTools-2.10-mac.dmg to unpack it. This will result in a drive called omniTools to be mounted on your computer. You should see this drive on your Desktop.
  3. Double-click on the omniTools drive to open it.
  4. Drag the omniTools-2.10 icon to the Applications icon.
  5. Open a terminal window.
  6. Run the script /Applications/omniTools-2.10/addAliases.command. This script will add aliases for the various omni tools in your ~/.bash_profile or ~/.bash_login or ~/.profile. (The script looks for these files in this order).

Linux Unix

  1. Download the Omni source at
  2. Click Accept, then follow steps 1, 2, and 3 at

2. Test Omni Installation

  1. Open a Command Prompt (cmd) or terminal window and type:
    omni --version
  2. If you see the following Omni is installed correctly:
         omni: GENI Omni Command Line Aggregate Manager Tool Version 2.10
         Copyright (c) 2011-2015 Raytheon BBN Technologies

3. Configure Omni

Download Configuration Info

  1. Login to the GENI Portal at
  2. Click on Profile from the drop-down list that appears when you hover above your name on the top right corner of the page.
  3. Click on the 'Configure omni' tag
  4. In Step 1, Click 'Generate an SSL Certificate' (unless it says you already have)
  5. Click 'Generate Combined Certificate and Key File' (the Simple Option)
  6. Then, in Step 2, Click 'Download your omni data', and download omni.bundle to the Downloads directory.


  1. Open a terminal or Command Prompt and type (replace-all optional if this is your first time configuring omni):
    omni-configure --replace-all

Test Configuration

  1. In the terminal or command prompt type:
    omni getversion -a gpo-ig
  2. Unless you see ERROR messages which start like the line below, your configuration was successful.
    14:25:28 ERROR   : ...

All Done

Once you have successfully run the omni getversion command, your set-up is complete. During the hands-on lab you will use omni to reserve and interact with resources from the command line.