Obtain the FutureGrid Accounts for the Summer School 2012

Welcome ,

This is your personalized set of instructions to obtain a FutureGrid Account for the Summer School 2012. It includes the following steps:

  • Step 1: Get a portal account
  • Step 2: Join the summer school project
  • Step 3: (Optional) Add an OpenID for portal SSO with your providor
  • Step 4: Upload your ssh public key
  • Step 5: Wait for your account and project membership to be approved
  • Step 6: Test to access a FutureGrid Resource

You must complete all the steps to successfully get access to FG resources. The best way to achieve this is to keep this page in your bookmark and return to it after you complete the various steps in the sequential order. To assist you, we also open a new tab for each of the steps when you click on a button.

Step 1: Get a portal account

The portal is the central point for managing your access to various FutureGrid Resources. The portal also offers several useful information on how to use FutureGrid in the form of manual, tutorials and FAQs. To create a portal account please click on the following registration button.

Please click here to register
Once you find the registration page, please fill out the information. Fields marked with * are mandatory and can not be omitted.
Please, note that you need to pay attention to the following:

  1. For this tutorial you must specify the Sign up code which will be given to you by the instructor or via e-mail.
    Note: Without the signup code we will not approve your account.
  2. Read the terms and check the box and agree to the terms
  3. Fill in the captcha image code
  4. Click the button “Create New Account”
  5. Check your email. You should receive a message telling you that you successfully applied and that a message indicating your approval will be coming soon.

Step 2: Join the summer school project

For this step you must be logged into the portal. If you have registered as described in step 1, you will be automatically logged in. If you have already a FutureGrid account, please log in now.

Click here to join the project

Step 3: (Optional) Add an OpenID

Many users may use services that allow login via OpenIDs. Google is a a prime example. It is possible for you to loginto the portal with an OpenID if you accosiate it with your portal account. To do so, please click on the button bellow, chose the provider you have and associate the OpenID, while following a login with your providor. If you do not like to use OpenID for the login to the portal, you can skip his step.

Step 4: Add a public key via the FutureGrid Portal

In order to ssh into FutureGrid resources you must have an ssh key associated with your account. First you must create an ssh key pair. If you already have a ssh key and you know where it is you can skip the next sections and do directly to step 5. In case you do not have a key pair, you will need to generate one dependent on which OS you use.

Step 4.a: Generate a public key pair for UNIX users

Use the tool ssh-keygen. This program is commonly available on most UNIX systems. It will prompt you for a password and a location for the key. We recommend using the location ~/.ssh/ A sample session for a user with the name einstein follows:

$ ssh-keygen -C einstein@mycomputer
Generating public/private rsa key pair.
Enter file in which to save the key (/home/einstein/.ssh/id_rsa): 
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/einstein/.ssh/id_rsa
Your public key has been saved in /home/einstein/.ssh/id_rsa.pub.
The key fingerprint is:
90:46:9b:cf:09:16:94:17:df:43:f4:99:97:0d:42:4a einstein@mycomputer
The key's randomart image is:
+--[ RSA 2048]----+
|     .+...Eo= .       |
|     ..=.o + o +o    |
|      O.  o o +.o      |
|     o = .   . .       |
|        S                     |
|                                 |
|                                 |
|                 |
|                                 |
+-----------------+

With the -C flag you can specify a comment that will be attached to your key.
 

Step 4.a: generate a keypair for Windows users

ssh clients are less standard on Windows. For this step we require you to use putty. If you use other ssh clients, and are familiar with them, you can use them also. However, we may not be able to help you in case of issues.

You can download the three programs you need form:

Please note, you will need all three of the programs.

First create a key pair by running puttygen and clicking the Generate button.  You will be asked to move the mouse around to generate random entropy.  When it is complete you should see a window like the following:


Select a password for your key pair and save both the public and private key to a known location. You could choose any folder and any file name but you must remember the location and name which will be needed in the later step. We recommend you store the keys under your home directory (e.g. in windows 7 it is typically C:\Users\YOURUSERNAME). You will use this key pair when accessing FutureGrid machines.
Notice the OpenSSH key format in the window (circled in the image above).  Copy this value to a known location.  This is the value that will be needed in the next steps.

Step 4.b: Upload your public ssh key (Unix and Windows Users)

  1. Open up the file that contains your ssh public key and copy its contents to your systems clipboard.
  2. Click on the button bellow to add your SSH key

  • This button redirects you to a page that includes  a link Add a public key. Click that link.
  • Paste your ssh key into the box marked Key. IMPORTANT: Leave the Title field blank.
  • make sure that when you paste your key, it does not contain newlines or carriage returns that may have been introduced by incorrect pasting and copying. Please remove them. Most users have no problems with this.

At this point you are all set. However you will still need to wait till all accounts have been set up to use the resources. Please, check your email for further updates. You can also refresh this page and see if the boxes in your account status information are all green. Than you can continue.

Step 5: Wait for your account and project membership to be approved

Let us check if your account is all set up. If every box in the graphiv bellow is green, you are all set. If it is not, you will have to wait till your account has been approved. This may take some time, and you can check on the status while refreshing this page.

 

Step 6: Connect to a FutureGrid Compute Resource

This step can only be done once the previous step is completed. In addition, you need to wait for about an hour till your key has been propagated to the various system resources in FutureGrid

Step 6: Connect to a FutureGrid Compute Resource for UNIX users

To connect to hotel with the standard UNIX OpenSSH tool use the following command:
 

ssh -A -i <path to private key> <username>@hotel.futuregrid.org

as we place the key in the default location, you can also say
 

ssh -A -i <username>@hotel.futuregrid.org

Note: the presence of the -A argument above.  That is necessary for steps later in the tutorial.

Step 6: Connect to a FutureGrid Compute Resource for Windows users

Run pgagent

In order to support ssh forwarding (and thus be able to securely perform all the exercises in this tutorial) you must run pgagent.  It is located here:

Once you have it downloaded to your local system run it.  It runs as a background service.  Once started you should see an icon in the bottom right corner of your desktop that looks like the one in the red box below:

Right click on that Icon and select add key.  Browse to find your private key where you generated and stored in the Step 4. If you have followed the recommendation it would be under your home directory with the name you have specified. If prompted for your key’s password enter it.

To ssh in from windows use the putty executable downloaded above.  Start putty and you should see a window like the one below:

Enter hotel.futuregrid.org into the Host Name (or IP address) field. 
Next make sure that ssh forwarding is on.  To do this, from the right hand menu select Connection -> SSH -> Auth as shown below:


Check the box marked Allow agent forwarding (circled in red).
Note: At this point it is recommended that you select Session from the list on the left and save this session under the name Hotel.
Now click Open and your connection to hotel should begin.  Follow the instructions in the terminal.
 

Useful Links