= 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 1. Click accept, and run the downloaded executable file when the download completes. 1. 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. 1. Click Next, and Finish to complete the install. ==== Configure PATH ==== 1. Open Control Panel, and search for PATH in the search box. 1. Click "Edit the system environment variables" 1. Click the Environment Variables... button 1. Under system variables select the Path variable and click Edit... 1. Click New, and type the install location: C:\Program Files (x86)\omniTools-2.10 1. Click OK three times to close the three windows. ==== Test Installation ==== 1. Open a Command Prompt (cmd) or terminal window and type: {{{ omni --version }}} 1. 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 1. Click on `Profile` from the drop-down list that appears when you hover above your name on the top right corner of the page. 1. Click on the 'Configure omni' tag 1. In Step 1, Click 'Generate an SSL Certificate' (unless it says you already have) 1. Click 'Generate Combined Certificate and Key File' (the Simple Option) 1. Then, in Step 2, Click 'Download your omni data', to download omni.bundle to your computer. === Configure === 1. Open a terminal or Command Prompt. If this is your first time configuring omni type: {{{ omni-configure }}} otherwise if you have configured omni before type: {{{ omni-configure --replace-all }}} = 3. Install GENI Tools = == 3.1 Install Browser == If not already installed on your machine, please install one of these browsers: * Chrome: [https://www.google.com/intl/en/chrome/browser/ Google Chrome] * Firefox: [http://www.mozilla.org/en-US/firefox/new/ Firefox] - Required if you choose to use FireSSH (see below) == 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: [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY] Alternative Install FireSSH, a Firefox ssh plugin: [https://addons.mozilla.org/en-US/firefox/addon/firessh/ 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. 1. Open a terminal 1. Ensure that your private key has the right permissions by typing: {{{ chmod 700 }}} 1. Run ssh by typing: {{{ ssh -i sshtest@pc3.geni.uchicago.edu -p 32826 }}} 1. 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) 1. Run PuTTY. 1. On the Basic options screen, in the Host Name field enter: {{{sshtest@pc3.geni.uchicago.edu}}} 1. In the Port field enter: '''32826''' 1. Make sure Connection type is: SSH 1. Under the settings categories on the left navigate to Connection-> '''SSH ->Auth'''. 1. 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'''. 1. Click '''Open''' to establish the SSH connection. 1. If prompted about whether you trust the host (key not cached in registry), click Yes. 1. 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. 1. Load this URL into firefox: '''ssh://sshtest@pc3.geni.uchicago.edu:32826''' 1. In the pop-up window, enter the passphrase '''v3rify''' in the (mislabeled) password field, and click '''Browse...''' 1. Select the private key, and click '''Open'''. 1. Click '''OK'''. 1. 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.