Version 15 (modified by Ben Newton, 8 years ago) (diff)


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. (Note: GENI never sees your home institution username and password. For more information on how this works, see

  1. Go to and 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.
    IF your institution does not appear here, STOP and fill out this form:
  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.
    IF this does not happen, STOP and fill out this form:
  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. Congratulations, you're done! You should now be at the portal home page and you are ready for the GENI tutorial.

2. Computer Requirements

Verify your laptop/desktop meets these minimum requirements:

  • Runs a relatively recent version of Mac OS X, Windows or Linux.
  • 2 GB of memory
  • A modern processor, at least dual core and >1.5 GHz, (no Intel Atom, no netbooks, no tablets)
  • A good connection to the Internet
  • webcam (optional, but recommended)
  • microphone
  • headphones/speakers

If you have a choice, MacOS/Linux machines are preferred as they have built-in ssh tools.
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: Google Chrome
  2. Firefox: Firefox.

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.


Recommended - Install Putty, a free SSH client for Windows: Alternative - Install FireSSH, a Firefox ssh plugin:

Install the plugin from 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/Tool. (PuTTY users should use the key file with PUTTY in it's name)

Mac OS X/Linux

Save the NOT_PUTTY version of the private key attached to this message on your computer. Open a terminal Ensure that your private key has the right permissions by typing : chmod 700 <private_key_file> Run ssh by typing: ssh -i <private key location> -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 are all set!

Windows PUTTY

You will use the PUTTY version of the private key attached to this message. Save the key on your computer. (It was converted from the standard fromat using the puttygen program. For more information look here) Run PuTTY. On the Basic options screen, in the Host Name field enter: In the Port field enter: 32826 Make sure Connection type is: SSH Under the settings categories on the left navigate to Connection-> SSH ->Auth. 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. Click Open to establish the SSH connection. If prompted about whether you trust the host (key not cached in registry), click Yes. When prompted for the Passphrase enter: v3rify If you see the prompt sshtest@test:~$ you are all set!

Windows FireSSH

After you Install FireSSH :

Save the NOT_PUTTY version of the private key attached to this message on your computer. Load this URL into firefox: ssh:// In the pop-up window, enter the passphrase v3rify in the (mislabeled) password field, and click Browse... Select the private key, and click Open. Click OK. If prompted about whether you trust the host (host key not cached in registry), click Yes. If you see the prompt sshtest@test:~$ you are all set!

You are now connected to a GENI virtual machine, and you know how to establish an SSH connection using a private key, which will be necessary for the tutorial. You can now close the connection. Your setup is complete.