[[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 ([]) 1. Java 7.x ([]) See instructions below. == 1. Install Omni == '''Please make sure to install/upgrade to Omni 2.7''' Download and install omni 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 === Please install BOTH of the ssh clients below: i. FireSSH, a Firefox ssh plugin: * Install from [https://addons.mozilla.org/en-US/firefox/addon/firessh/ FireSSH] a Firefox SSH plugin [[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 these information: * `username`: sshtest * `hostname`: pc2.instageni.wisc.edu * `port`: 33850 * passphrase for private key: v3rify ''' Mac OS X/Linux/Cygwin ''': Follow [wiki:HowTo/LoginToNodes#LinuxMacOSWindowsCygwin these instructions]. If you see a 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 a 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 7.x installation == You must have Java 7.xx installed. '''Version 8.x will not work.''' 1. Windows: Install from [https://www.java.com/en/download/help/windows_manual_download.xml]. 1. Mac OS: Install from [https://www.java.com/en/download/help/mac_install.xml] 1. Linux: Install from [https://www.java.com/en/download/help/linux_x64_install.xml] === 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]. }}}