| 1 | [[PageOutline]] |
| 2 | |
| 3 | = Setting up your Computer with GENI Tools = |
| 4 | |
| 5 | Some of the tutorials at this camp will require you have a laptop that has: |
| 6 | 1. The Omni experimenter tool installed ([#a1.InstallOmni Instructions]) |
| 7 | 1. An ssh client ([#a2.SSHClient Instructions]) |
| 8 | 1. A browser capable of running Flash clients, and ([#a3.Flash-enabledBrowser Instructions]) |
| 9 | |
| 10 | == 1. Install Omni == |
| 11 | === Mac OS x === |
| 12 | 1. Download the package: [http://groups.geni.net/geni/attachment/wiki/UGREE-GENI/GREE-WC2014/toolSetup/MacOS/omniTools.dmg?format=raw omniTools.dmg]. |
| 13 | 1. Install the package using [wiki:GENIExperimenter/Tutorials/ToolsSetup/OmniMacOsX these instructions]. |
| 14 | |
| 15 | === Windows === |
| 16 | 1. Download this file: [http://groups.geni.net/geni/attachment/wiki/UGREE-GENI/GREE-WC2014/toolSetup/Windows/omni-tools-2.4.2-setup.exe?format=raw omni-tools-2.4.2-setup.exe]. |
| 17 | 1. Install the package using [wiki:GENIExperimenter/Tutorials/ToolsSetup/OmniWindows these instructions]. [[BR]] |
| 18 | |
| 19 | === Linux === |
| 20 | 1. Download the GCF package from http://software.geni.net/local-sw/download&software=gcf-2.4.1.tar.gz |
| 21 | 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. |
| 22 | |
| 23 | === Test the installation === |
| 24 | 1. Open a new terminal window (or command prompt in windows (`Start menu -> Programs -> Accessories -> Command Prompt`)) and type |
| 25 | {{{ |
| 26 | omni --version |
| 27 | }}} |
| 28 | If omni prints out its version number, you are all set! |
| 29 | |
| 30 | == 2. SSH Client == |
| 31 | |
| 32 | === Mac OS X/Linux === |
| 33 | Mac OS X and Linux come with an ssh client you can run from a Terminal window. You do not need to install anything. |
| 34 | |
| 35 | === Windows === |
| 36 | If you do not have an ssh client installed: |
| 37 | * Install [http://www.bitvise.com/ssh-client-download BitVise], an ssh client for Windows. [[BR]] |
| 38 | |
| 39 | ''Note: If you are using the Putty ssh client, you will need [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html puttygen] to convert the private keys used by GENI to Putty's format. |
| 40 | |
| 41 | === Test SSH with keys === |
| 42 | In the email you should have received a copy of an SSH private key and the corresponding passphrase. |
| 43 | To test your setup you will need these information: |
| 44 | * `username`: nriga |
| 45 | * `hostname`: pc2.instageni.illinois.edu |
| 46 | * `port`: 35386 |
| 47 | |
| 48 | ''' Mac OS X/Linux/Cygwin ''': Follow [wiki:HowTo/LoginToNodes#LinuxMacOSWindowsCygwin these instructions]. If you see a prompt `[nriga@my-node ~]$` you are all set! [[BR]] |
| 49 | ''' Windows ''': Follow [wiki:HowTo/LoginToNodes#WindowsBitViseFireSSHPutty these instructions]. If you see a prompt `[nriga@my-node ~]$` you are all set! |
| 50 | |
| 51 | == 3. Flash-enabled Browser == |
| 52 | 1. You will need [https://www.google.com/intl/en/chrome/browser/ Google Chrome] or [http://www.mozilla.org/en-US/firefox/new/ Firefox]. |
| 53 | 1. Make sure you are able to load [http://protogeni.net/flack]. The page should look like: |
| 54 | [[Image(http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/flack-login.png?format=raw, 10%)]] |
| 55 | '''Note''': If you do not have flash installed and you are using Firefox, install the [http://support.mozilla.org/en-US/kb/install-flash-plugin-view-videos-animations-games Flash plugin for Firefox]. |