| 11 | === Mac OS x === |
| 12 | == 1. Installing the Omni Experimenter Tool == |
| 13 | 1. Download this file: [attachment:omniTools.dmg]. |
| 14 | 1. 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. |
| 15 | 1. Double-click on the {{{omniTools}}} drive to open it. |
| 16 | 1. Drag the omniTools icon to the Applications icon. |
| 17 | 1. Open a terminal window. |
| 18 | 1. Run the script `/Applications/omniTools/addAliases.sh`. This script will add aliases for the various |
| 19 | Omni tools in your {{{~/.bash_profile}}} or {{{~/.bash_login}}} or {{{~/.profile}}}. (The script looks for these |
| 20 | files in this order). |
| 21 | * If you get an error do: |
| 22 | - `touch ~/.bash_profile` |
| 23 | - Rerun `/Applications/omniTools/addAliases.sh` |
| 24 | |
| 25 | === Windows === |
| 26 | 1. Download this file: [attachment:omni-tools-2.4.2-setup.exe]. |
| 27 | 1. Run the Windows installer by double clicking on the downloaded file. |
| 28 | 1. Point the `PATH` environment variable to the installed executables: |
| 29 | a. Edit environment variables |
| 30 | i. In ''Windows 7'', open the `Control Panel` and search for `PATH` in the search box. Click on "Edit environment variables for your accounts". |
| 31 | i. In ''Windows XP'', find the System Properties window under `Control Panel -> System -> Advanced System Settings` and click "Environment Variables". |
| 32 | a. Set the `PATH` variable. |
| 33 | i. Determine the value of your `PATH` variable: |
| 34 | * For Windows XP: select `C:\Program Files\omniTools` |
| 35 | * For Windows 7: select `C:\Program Files (x86)\omniTools` |
| 36 | i. 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`). |
| 37 | i. 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 `;`. |
| 38 | |
| 39 | '''Test the installation:''' |
| 40 | 1. Test the installation by opening a Command Prompt and running the command: |
| 41 | {{{ |
| 42 | omni --version |
| 43 | }}} |
| 44 | The Windows Command Prompt can be found by navigating: `Start menu -> Programs -> Accessories -> Command Prompt` |
| 45 | 2. If everything goes well, you should see output that looks like: |
| 46 | {{{ |
| 47 | omni: GENI Omni Command Line Aggregate Manager Tool Version 2.4.2 |
| 48 | Copyright (c) 2013 Raytheon BBN Technologies |
| 49 | }}} |
| 50 | |
| 51 | === Linux === |
| 52 | 1. Download the GCF package from http://software.geni.net/local-sw/download&software=gcf-2.4.1.tar.gz |
| 53 | 1. Install the GCF package using instructions at http://trac.gpolab.bbn.com/gcf/wiki/QuickStart. The Omni tool is part of the GCF package. |
| 54 | |
| 55 | '''Test the installation:''' |
| 56 | 1. Open a new terminal window. |
| 57 | 1. In this terminal window, run the command: |
| 58 | {{{ |
| 59 | omni.py --version |
| 60 | }}} |
| 61 | If omni prints out its version number, you are all set! |