[[PageOutline]] = 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, 1. A browser capable of running Flash clients, and 1. An ssh client. == 1. Install Omni == === Mac OS x === == 1. Installing the Omni Experimenter Tool == 1. Download this file: [attachment:omniTools.dmg]. 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. 1. Double-click on the {{{omniTools}}} drive to open it. 1. Drag the omniTools icon to the Applications icon. 1. Open a terminal window. 1. Run the script `/Applications/omniTools/addAliases.sh`. 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/addAliases.sh` === Windows === 1. Download this file: [attachment:omni-tools-2.4.2-setup.exe]. 1. Run the Windows installer by double clicking on the downloaded file. 1. Point the `PATH` environment variable to the installed executables: a. Edit environment variables i. In ''Windows 7'', open the `Control Panel` and search for `PATH` in the search box. Click on "Edit environment variables for your accounts". i. In ''Windows XP'', find the System Properties window under `Control Panel -> System -> Advanced System Settings` and click "Environment Variables". a. Set the `PATH` variable. i. Determine the value of your `PATH` variable: * For Windows XP: select `C:\Program Files\omniTools` * For Windows 7: select `C:\Program Files (x86)\omniTools` 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`). 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 `;`. '''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 }}} === Linux === 1. Download the GCF package from http://software.geni.net/local-sw/download&software=gcf-2.4.1.tar.gz 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. '''Test the installation:''' 1. Open a new terminal window. 1. In this terminal window, run the command: {{{ omni.py --version }}} If omni prints out its version number, you are all set! == 2. SSH Client == == 3. Flash-enabled Browser ==