wiki:GENIExperimenter/Tutorials/OmniSetup

Version 11 (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.

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

3.1 Install Browser

If not already installed on your machine, please install one of these browsers:

3.2 SSH Client

Mac OS X/Linux

Mac OS X and Linux come with an ssh client you can run from a Terminal window. You do not need to install anything. Proceed to the "Test SSH with keys" section below.

Windows

Recommended

Install PuTTY, a free SSH client for Windows: ​PuTTY

Alternative

Install FireSSH, a Firefox ssh plugin: ​FireSSH

3.3 Test SSH with keys

You should have received a copy of an SSH private key by email. Follow the instructions below which apply to your Operating System and SSH client. (PuTTY users should use the key file with PUTTY in it's name)

Mac OS X/Linux

  1. Save the NOT_PUTTY version of the private key on your computer.
  2. Open a terminal
  3. Ensure that your private key has the right permissions by typing: 
    chmod 700 <private_key_file>
  1. Run ssh by typing: 
    ssh -i <private key location> sshtest@pc3.geni.uchicago.edu -p 32826
  2. Enter the passphrase (v3rify) when prompted. Note: If you are prompted for a password then something went wrong. Make sure that all the information is correct.

If you see the prompt sshtest@test:~$ you have successfully logged-in to the node.

Windows PuTTY

  1. You will use the PUTTY version of the private key. Save the key on your computer. (It was converted from the standard format using the puttygen program. For more information look here)
  2. Run PuTTY.
  3. On the Basic options screen, in the Host Name field enter: sshtest@pc3.geni.uchicago.edu
  4. In the Port field enter: 32826
  5. Make sure Connection type is: SSH
  6. Under the settings categories on the left navigate to Connection-> SSH ->Auth.
  7. Next to the "Private key file for authentication" field at the bottom, click Browse... and select the private key file you saved to your computer, and click Open.
  8. Click Open to establish the SSH connection.
  9. If prompted about whether you trust the host (key not cached in registry), click Yes.
  10. When prompted for the Passphrase enter: v3rify

If you see the prompt sshtest@test:~$ you have successfully logged-in to the node.

Windows FireSSH

After you Install FireSSH :

  1. Save the NOT_PUTTY version of the private key.
  2. Load this URL into firefox: ​ssh://sshtest@pc3.geni.uchicago.edu:32826
  3. In the pop-up window, enter the passphrase v3rify in the (mislabeled) password field, and click Browse...
  4. Select the private key, and click Open.
  5. Click OK.
  6. If prompted about whether you trust the host (host key not cached in registry), click Yes.

If you see the prompt sshtest@test:~$ you have successfully logged-in to the node.

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.