{{{ #!html

1. GENI Portal Account Instructions

These instructions are to test if you are able to log into the GENI Portal using the username and password you use at your home institution, and, in the event that fails, to help you request a GENI account.=C2=A0 (Note: GENI never sees your home institution username and password. For more information on how this works, see=C2=A0http://www.incommon.org/federation/basics.html.)
  1. Go to=C2=A0https://portal.geni.net=C2=A0and click the big orange "Use GENI" button.
  2. On the institution chooser page, select your home institution. The text entry field will auto-complete institutions if you type in a few characters. Or you can choose the "Show a list of organizations" option and find your institution in the drop down box.=C2=A0
    IF your institution does not appear here,=C2=A0STOP=C2=A0and fill out this form:=C2=A0https://shib-idp.geni.net/geni/request.html.
  3. Click "Continue". You should be redirected to your home institution's login page.
  4. Type in your usual home institution Username and Password. Again, note this information is not sent to GENI.
  5. You should be redirected to a GENI agreement page.=C2=A0
    IF this does not happen,=C2=A0STOP=C2=A0and fill out this form:=C2=A0https://shib-idp.geni.net/geni/request.html.
  6. On the GENI agreement page, check the two boxes that indicate you agree to all policies and to let the portal work on your behalf. Then "submit" the page.=C2=A0 Congratulations, you're done!=C2=A0 You should now be at the portal home page and you are ready for the GENI tutorial.

2. Computer Requirements< /h3>=C2=A0=C2=A0=C2=A0 Verify your laptop/desktop meets these minimum requirements:

If you have a choice, MacOS/Linux machines are preferred as they have built-in ssh tools.=C2=A0

If you have a webcam please use it at the tutorial---web-based tutorials are much less impersonal if we can see your faces!

3. Install GENI Tools

3.1 Install Browsers

If not already installed on your machine, please install these browsers:
    1. Chrome:=C2=A0Google Chrome
    2. Firefox:=C2=A0Firefox.

3.2 SSH Client

=C2=A0 =C2=A0 Mac OS X/Linux
M ac OS X and Linux come with an ssh client you can run from a Terminal windo w. You do not need to install anything. Proceed to the "Test SSH with keys"=C2=A0se ction below.

=C2 =A0 =C2=A0=C2=A0Windows

Recommended -=C2=A0=C2=A0Install Put ty, a free SSH client for Windows:

Alternative - Install FireSSH, a Firefox ssh plugin:

3.3 Test SSH with keys

Attached is a copy of an SSH pri vate key. Follow the instructions below which apply to your Operating Syste m/Tool. =C2=A0(PuTTY users should use the key file with=C2=A0PUTTY =C2=A0in it's name)=C2=A0

=C2=A0 =C2=A0=C2=A0Mac OS X/Linux
  1. Save the NOT_PUTTY version of the pr ivate key attached to this message on your computer. =C2=A0
  2. Open a terminal
  3. Ensure that your private key has the right permissions by typing :
    chmod 700 <priv
ate_key_file>
  4. Run ssh by typing:
  5. ssh -i <private key location> sshtest@pc3.geni.uchicago.edu -p 32826
5.=C2=A0 Enter the passphrase (v3rify) when prompted.=C2=A0Note: If you are prompted for a password then something went wrong. Make sure that all the information is correct.

If you see the prom pt=C2=A0sshtest@test:~ $=C2=A0you are all s et!=C2=A0

=C2=A0 =C2=A0=C2=A0Windows PUTTY
  1. You will use the PUTTY version of the private key attached to this message.=C2=A0 Save the key on your computer. (It was converted from the standard fromat usi ng the puttygen program. For more information look=C2=A0here)
  2. Run PuTTY. =C2=A0
  3. On the Basic options screen, in the Hos t Name field enter: =C2=A0sshtest@pc3.geni.uchicago.edu
  4. In the P ort field enter: 32826
  5. Make sure Connection type is: =C2=A0< b>SSH
  6. Under the settings categories on the left navigate to Con nection-> SSH ->Auth.=C2=A0
  7. Next to the "Priva te key file for authentication" field at the bottom, click Brow se... and select the private key file you saved to your computer, and c lick Open.=C2=A0
  8. Click Open to establish the SSH conn ection.
  9. If prompted about whether you trust the host (key not cache d in registry), click Yes. =C2=A0
  10. When prompted for the Passphrase enter: v3rify

If you see the prompt=C2=A0sshtest@test:~$ =C2=A0you are all set!=C2=A0

=C2=A0 =C2=A0=C2=A0Windows FireSSH

After you Install =C2=A0FireSSH=C2=A0:

    1. Save the NOT_PUTTY version of the private key attached to this message on your computer.=C2=A0
    2. Load this URL into fir efox: =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0ssh://sshtest@pc3.geni.uchicago.e du:32826
    3. In the pop-up window, enter the passphrase v3r ify in the (mislabeled) password field, and click Browse...=C2 =A0
    4. Select the private key, and click Open.
    5. Click OK.=C2=A0
    6. If prompted about whether you trust the host (host k ey not cached in registry), click Yes. =C2=A0
If you see the prompt=C2=A0sshtest@test:~$=C2=A0you are all set!=C2=A0
You are now connected to a GENI virtual machine, and you kno w how to establish an SSH connection using a private key, which will be nec essary for the tutorial.=C2=A0 You can now close the connection. Your setup is complete.=C2=A0
}}}