| 58 | | == 3.1 Install Browser == |
| 59 | | |
| 60 | | If not already installed on your machine, please install one of these browsers: |
| 61 | | * Chrome: [https://www.google.com/intl/en/chrome/browser/ Google Chrome] |
| 62 | | * Firefox: [http://www.mozilla.org/en-US/firefox/new/ Firefox] - Required if you choose to use FireSSH (see below) |
| 63 | | |
| 64 | | == 3.2 SSH Client == |
| 65 | | |
| 66 | | === Mac OS X/Linux === |
| 67 | | 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. |
| 68 | | |
| 69 | | === Windows === |
| 70 | | Recommended |
| 71 | | Install PuTTY, a free SSH client for Windows: [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY] |
| 72 | | Alternative |
| 73 | | Install FireSSH, a Firefox ssh plugin: [https://addons.mozilla.org/en-US/firefox/addon/firessh/ FireSSH] |
| 74 | | |
| 75 | | == 3.3 Test SSH with keys == |
| 76 | | 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) |
| 77 | | |
| 78 | | === Mac OS X/Linux === |
| 79 | | 1. Save the NOT_PUTTY version of the private key on your computer. |
| 80 | | 1. Open a terminal |
| 81 | | 1. Ensure that your private key has the right permissions by typing: |
| 82 | | {{{ |
| 83 | | chmod 700 <private_key_file> |
| 84 | | }}} |
| 85 | | |
| 86 | | 1. Run ssh by typing: |
| 87 | | {{{ |
| 88 | | ssh -i <private key location> sshtest@pc3.geni.uchicago.edu -p 32826 |
| 89 | | }}} |
| 90 | | 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. |
| 91 | | |
| 92 | | If you see the prompt sshtest@test:~$ you have successfully logged-in to the node. |
| 93 | | |
| 94 | | |
| 95 | | === Windows PuTTY === |
| 96 | | 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) |
| 97 | | 1. Run PuTTY. |
| 98 | | 1. On the Basic options screen, in the Host Name field enter: {{{sshtest@pc3.geni.uchicago.edu}}} |
| 99 | | 1. In the Port field enter: '''32826''' |
| 100 | | 1. Make sure Connection type is: SSH |
| 101 | | 1. Under the settings categories on the left navigate to Connection-> '''SSH ->Auth'''. |
| 102 | | 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'''. |
| 103 | | 1. Click '''Open''' to establish the SSH connection. |
| 104 | | 1. If prompted about whether you trust the host (key not cached in registry), click Yes. |
| 105 | | 1. When prompted for the Passphrase enter: '''v3rify''' |
| 106 | | |
| 107 | | If you see the prompt sshtest@test:~$ you have successfully logged-in to the node. |
| 108 | | |
| 109 | | === Windows FireSSH === |
| 110 | | After you Install FireSSH : |
| 111 | | |
| 112 | | 1. Save the NOT_PUTTY version of the private key. |
| 113 | | 1. Load this URL into firefox: '''ssh://sshtest@pc3.geni.uchicago.edu:32826''' |
| 114 | | 1. In the pop-up window, enter the passphrase '''v3rify''' in the (mislabeled) password field, and click '''Browse...''' |
| 115 | | 1. Select the private key, and click '''Open'''. |
| 116 | | 1. Click '''OK'''. |
| 117 | | 1. If prompted about whether you trust the host (host key not cached in registry), click Yes. |
| 118 | | |
| 119 | | If you see the prompt sshtest@test:~$ you have successfully logged-in to the node. |
