[[PageOutline]]
Tinyurl: http://www.tinyurl.com/geni-tools

= Setting up your Computer with GENI Tools =

Some of the tutorials  will require you have a laptop that has:
  1. An ssh client ([#a2.SSHClient Instructions])
  1. The Omni experimenter tool installed ([#a3.InstallOmni Instructions])
  1. Chrome and Firefox browsers ([#a3.InstallChromeandFirefoxbrowsers Instructions])
{{{
#!comment
  1. Install Java 8 ([#a4.InstallandtestJava8 Instructions])
}}}

== 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 [#TestSSHwithkeys Test SSH with Keys] section below. 

=== Windows ===
'''Recommended''' Install Putty, a free SSH client for Windows: 
   * http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

An alternative is FireSSH, a Firefox ssh plugin:
      * Install the plugin from [https://addons.mozilla.org/en-US/firefox/addon/firessh/ FireSSH]  [[BR]]

=== Test SSH with keys ===
You should have received a copy of an SSH private key by email.  (PuTTY users should use the key file with `PuTTY` in it's name.)

To test your setup you will need this information:
  * `username`: sshtest
  * `hostname`: pc1.geni.uchicago.edu
  * `port`:  33594
  * passphrase for private key: v3rify

In the instructions below, skip the step about downloading a private key and just use the key provided though email. [[BR]]
''' Mac OS X/Linux/Cygwin ''': Follow [wiki:HowTo/LoginToNodes#LinuxMacOSWindowsCygwin these instructions]. If you see the prompt `sshtest@sshtestvm:~$ ` you are all set! [[BR]]
''' Windows ''':  Follow [wiki:HowTo/LoginToNodes#WindowsPuTTYFireSSHBitViseGitBash these instructions]. If you see the prompt `sshtest@sshtestvm:~$ ` you are all set! 


== 3. Install Omni ==
'''Please make sure to install/upgrade to Omni 2.10'''

Download and install omni by following the instructions at:
       https://github.com/GENI-NSF/geni-tools/wiki/Omni   (''You do not have to configure Omni at this time.  You will be given instructions at the conference.'')

=== Test the installation ===
 1. Open a new terminal window (or command prompt in windows (`Start menu -> Programs -> Accessories -> Command Prompt`)) and type
{{{
       omni --version
}}}
   If omni prints out its version number, you are all set!

== 3. Install Chrome and Firefox browsers ==
  1. Chrome: [https://www.google.com/intl/en/chrome/browser/ Google Chrome] 
  2. Firefox:  [http://www.mozilla.org/en-US/firefox/new/ Firefox]. 


{{{
#!comment

== 4. Install and test Java 8 ==
  1. Install a recent Oracle Java 8 version (openJDK does not work well)
      * Windows and Mac users can go to http://java.com/en/download/
      * Linux users: see http://jfed.iminds.be/java8_on_linux/
  1. Verify you have the right version of Java installed:  http://java.com/verify.  


=== Test your installation:  ===
  1. Use '''Firefox''' to go to http://jfed.iminds.be.
  1. Click on the green button labeled "Quickstart jFed experimenter tool".
  1. If your Java setup is correct, a window will pop up that looks like: 
      [[Image(jfed.png, 20%)]] [[BR]]
  You are done with the Java setup!  You can close the window. [[BR]]
  '''Mac users:''' If the above window does not pop-up, see the instructions at http://doc.ilabt.iminds.be/jfed-documentation/mac.html.  
}}}




{{{
#!comment

Another option is !BitVise:
  * Install [http://www.bitvise.com/ssh-client-download BitVise], an ssh client for Windows. [[BR]]
Git For Windows supports ssh and has a git bash emulator:
  * [http://git-scm.com/download/win Git for Windows]
}}}