Version 3 (modified by, 6 years ago) (diff)


Setting up your laptop with GENI Tools

Some of the tutorials at this camp will require you have a laptop that has:

  1. The Omni experimenter tool installed,
  2. A browser capable of running Flash clients, and
  3. An ssh client.

1. Install Omni

Mac OS x

1. Installing the Omni Experimenter Tool

  1. Download this file: omniTools.dmg.
  2. Double-click on omniTools.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 icon to the Applications icon.
  5. Open a terminal window.
  6. Run the script /Applications/omniTools/ 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).
    • If you get an error do:
      • touch ~/.bash_profile
      • Rerun /Applications/omniTools/


  1. Download this file: omni-tools-2.4.2-setup.exe.
    1. Run the Windows installer by double clicking on the downloaded file.
    2. Point the PATH environment variable to the installed executables:
      1. Edit environment variables
        1. In Windows 7, open the Control Panel and search for PATH in the search box. Click on "Edit environment variables for your accounts".
        2. In Windows XP, find the System Properties window under Control Panel -> System -> Advanced System Settings and click "Environment Variables".
      2. Set the PATH variable.
        1. Determine the value of your PATH variable:
          • For Windows XP: select C:\Program Files\omniTools
          • For Windows 7: select C:\Program Files (x86)\omniTools
        2. If there is no PATH variable, click "New..." and set the name PATH and the value of C:\Program Files (x86)\omniTools (or C:\Program Files\omniTools`).
        3. If there is a PATH variable, click "Edit..." and append ;C:\Program Files (x86)\omniTools (or ;C:\Program Files\omniTools) to the PATH variable. Be sure to include the ;.

Test the installation:

  1. Test the installation by opening a Command Prompt and running the command:
    omni --version
    The Windows Command Prompt can be found by navigating: Start menu -> Programs -> Accessories -> Command Prompt
  2. If everything goes well, you should see output that looks like:
    omni: GENI Omni Command Line Aggregate Manager Tool Version 2.4.2
    Copyright (c) 2013 Raytheon BBN Technologies


  1. Download the GCF package from
  2. Install the GCF package using instructions at The Omni tool is part of the GCF package.

Test the installation:

  1. Open a new terminal window.
  2. In this terminal window, run the command:
    If omni prints out its version number, you are all set!

2. SSH Client

3. Flash-enabled Browser

Attachments (1)

Download all attachments as: .zip