MacOS

PageOutline

= 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 ==

Download [http://software.geni.net/local-sw/download&software=omniTools-2.10-mac.dmg omniTools-2.10-mac.dmg].

== 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 [wiki:OmniConfigure/Automatic 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 [https://github.com/GENI-NSF/geni-tools/issues?q=is%3Aopen+is%3Aissue+label%3Amac listed on GitHub].