Version 12 (modified by Ben Newton, 7 years ago) (diff)


1. Download and Install Omni

Windows 8 (other Windows versions similar)

Download and Install

  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.

Configure PATH

  1. Open Control Panel, and search for PATH in the search box.
  2. Click "Edit the system environment variables"
  3. Click the Environment Variables... button
  4. Under system variables select the Path variable and click Edit...
  5. Click New, and type the install location: C:\Program Files (x86)\omniTools-2.10
  6. Click OK three times to close the three windows.

Mac OS X/Linux


Test 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

2. 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   : ...

3. Install GENI Tools

All Done

Once you have successfully logged-in, you may close the SSH connection. Your set-up is now complete. During the hands-on lab you will generate a set of your own public and private keys, and use this same procedure to log-in to GENI machines you will reserve.