wiki:GENIExperimenter/Tutorials/OmniSetup

Version 17 (modified by Ben Newton, 8 years ago) (diff)

--

1. Download and Install Omni

Windows 8 (other Windows versions similar)

Download and Install

  1. Download Omni Windows Binaries at http://software.geni.net/local-sw/download&software=omniTools-2.10-win-setup.exe
  2. Click Accept, and run the downloaded executable file when the download completes.
  3. Click Next, accepting the agreement and the defaults for several (4) screens, then click Install. If you change the default location, be sure you change the path below to match.
  4. Click Next, and Finish to complete the install.

Configure PATH

  1. Open Control Panel, and search for PATH in the search box.
  2. Click "Edit the system environment variables"
  3. Click the Environment Variables... button
  4. Under system variables select the Path variable and click Edit...
  5. Click New, and type the install location: C:\Program Files (x86)\omniTools-2.10
  6. Click OK three times to close the three windows.

Mac OS

  1. Download Omni Mac OS Binaries at http://software.geni.net/local-sw/download&software=omniTools-2.10-mac.dmg
  2. Click Accept, then 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.
  3. Double-click on the omniTools drive to open it.
  4. Drag the omniTools-2.10 icon to the Applications icon.
  5. Open a terminal window.
  6. 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).

Linux/Unix

  1. Download the Omni source at http://software.geni.net/local-sw/download&software=gcf-2.10.tar.gz
  2. Click Accept, then follow steps 1, 2, and 3 at http://trac.gpolab.bbn.com/gcf/wiki/QuickStart

Test Installation

  1. Open a Command Prompt (cmd) or terminal window and type:
    omni --version
    
  2. If you see the following Omni is installed correctly:
         omni: GENI Omni Command Line Aggregate Manager Tool Version 2.10
         Copyright (c) 2011-2015 Raytheon BBN Technologies
    

2. Configure Omni

Download Configuration Info

  1. Login to the GENI Portal at http://portal.geni.net
  2. Click on Profile from the drop-down list that appears when you hover above your name on the top right corner of the page.
  3. Click on the 'Configure omni' tag
  4. In Step 1, Click 'Generate an SSL Certificate' (unless it says you already have)
  5. Click 'Generate Combined Certificate and Key File' (the Simple Option)
  6. Then, in Step 2, Click 'Download your omni data', and download omni.bundle to the Downloads directory.

Configure

  1. Open a terminal or Command Prompt and type (replace-all optional if this is your first time configuring omni):
    omni-configure --replace-all
    

Test Configuration

  1. In the terminal or command prompt type:
    omni getversion -a gpo-ig
    
  2. Unless you see ERROR messages which start like the line below, your configuration was successful.
    14:25:28 ERROR   : ...
    

3. Install GENI Tools

All Done

Once you have successfully logged-in, you may close the SSH connection. Your set-up is now complete. During the hands-on lab you will generate a set of your own public and private keys, and use this same procedure to log-in to GENI machines you will reserve.