Skip to content
Tom Mitchell edited this page Mar 2, 2017 · 4 revisions

Omni Tools for Mac OS

For your convenience, we provide a pre-built binary containing the Omni tools. The Omni Tools package for Mac OS includes:

  • clear-passphrases
  • omni
  • omni-configure
  • readyToLogin
  • stitcher
  • addMemberToSliceandSlivers
  • remote-execute

Notes:

  • These binaries have been tested with Mac OS 10.7-10.9.

Download

The latest geni-tools binaries for MacOS can be downloaded from the releases page.

Install

  1. 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.
  2. Double-click on the omniTools drive to open it.
  3. Drag the omniTools-2.10 icon to the Applications icon.
  4. Open a terminal window.
  5. 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).

Test the installation:

  1. Open a new terminal window.

  2. In this terminal window, run the command:

    omni --version
    

    If omni prints out its version number as below, you are all set!

    omni: GENI Omni Command Line Aggregate Manager Tool Version 2.10
    Copyright (c) 2015 Raytheon BBN Technologies
    

Configure

Follow the standard instructions for configuring omni.

Uninstall

  1. Drag the omniTools-2.10 application from your Applications folder to Trash.
  2. Optional: Delete the aliases created during the install. These aliases are added to your ~/.bash_profile or ~/.bash_login or ~/.profile.

Known Issues

  • Be sure to invoke the programs as omni and stitcher, not omni.py or stitcher.py, particularly if you still have an old version of omniTools installed.
  • Known Mac specific issues should be listed on GitHub.