[[PageOutline]] = Setting up your Computer with GENI Tools = Some of the tutorials will require you have a laptop that has: 1. The Omni experimenter tool installed ([#a1.InstallOmni Instructions]) 1. An ssh client ([#a2.SSHClient Instructions]) 1. Chrome and Firefox browsers ([#a3.InstallChromeandFirefoxbrowsers Instructions]) == 1. Install Omni == '''Please make sure to install/upgrade to Omni 2.8''' Download and install omni by following the instructions at: http://trac.gpolab.bbn.com/gcf/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! == 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 === Install FireSSH, a Firefox ssh plugin: * Install the plugin from [https://addons.mozilla.org/en-US/firefox/addon/firessh/ FireSSH] [[BR]] {{{ #!comment Please install BOTH of the ssh clients below: i. FireSSH, a Firefox ssh plugin: * Install the plugin from [https://addons.mozilla.org/en-US/firefox/addon/firessh/ FireSSH] [[BR]] ii. Putty, a free implementation of Telnet and SSH for Windows * Install from [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html]. ''Make sure you download and install from [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html '''Windows installer for everything except PuTTYtel''].'' This installer includes ''puttygen'' to convert the private keys used by GENI to Putty's format and the ssh-agent called ''Pageant''. }}} {{{ #!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] }}} === Test SSH with keys === You should have received a copy of an SSH private key by email. To test your setup you will need this information: * `username`: sshtest * `hostname`: pc3.geni.it.cornell.edu * `port`: 32826 * passphrase for private key: v3rify ''' Mac OS X/Linux/Cygwin ''': Follow [wiki:HowTo/LoginToNodes#LinuxMacOSWindowsCygwin these instructions]. If you see the prompt `[sshtest@my-node ~]$` you are all set! [[BR]] ''' Windows ''': Use Firefox with FireSSH installed to test your ssh setup. See instructions at [wiki:HowTo/LoginToNodes#FireSSH these instructions]. If you see the prompt `[sshtest@my-node ~]$` 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]. == 4. Install and test Java 8 (Required if you attending Newcomers Day or the jFed tutorial) == 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 1. Make sure you are able to load [http://protogeni.net/flack]. The page should look like: [[Image(http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/flack-login.png?format=raw, 10%)]] '''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]. }}}