SEAGrid Portal User Guide

Introduction to SEAGrid Gateway

Hosted SEAGrid portal is the UI developed by the Airavata team for interested science communities to work with. This user guide provides step-by-step information on obtaining a complete science gateway experience for science and scholarly communities using Airavata as a middleware platform. In the user guide we would also discuss main features and services provided for gateway communities via Airavata.

User guide will tell you;

• How to register users in the portal.

• What are projects and how to use them.

• How to create, launch and monitor experiments.

• Sharing your work with others.

• Using own allocation for job submissions in compute resources.

• How to get help, provide feedback and request for new applications.

For more details on Airavata middleware visit Airavata site

Gateway Details

1. Hosted SEAGrid Gateway link;
   https://seagrid.org/

2. Download application input files from;
   Sample application input files I 
   Sample application input files II 

Tutorial I - Gateway Login

1. A new user has to create an account using ‘Create account’ link on top right hand corner of the gateway.

2. To create an account;

   1. Please enter mandatory information and submit. A confirmation message will confirm the creation.

   2. Important;

      1. Username cannot have spaces.

      2. Username & password must be longer than 5 characters.

      3. Password is case sensitive, need at least one number, one special character (!@#$%), at least one upper case letter and one lower case letter.

      4. Enter all the mandatory fields indicated by a star; *.

   3. Account creation page: https://seagrid.org/create

1. User can also login using campus credentials through CILogon. This is also available from https://seagrid.org/create

2. Using CILogon will not require specific account creation to request access to the gateway, but still gateway admin will asses and give an active role to use the gateway.

1. Once the account is created you will receive an email to confirm the account creation.To confirm use the link provided in the email and follow given instructions.

2. Till the gateway administrator verifies and enable the account; you will not be able to submit jobs on compute resources.

3. Once the account is enabled the account owner will receive an email notification on new gateway privileges.

4. Gateway admin might even contact the user over email to get more information on research interests in order to assist the user.

1. Once the account is created successfully; login to the gateway using the created account.

2. Gateway login screen link

   1. https://seagrid.org/login

3. OR use the 'Log In' link given on the 'Create New Account' page after account retain is successful.

4. Login Page;

Open

1. Gateway user can use their own compute resource(cluster) allocation within the gateway to launch jobs.

2. Prior to using the allocation users need to set up the allocation account details in the gateway.

Add Allocation Details

1. Navigate to User Settings (This is under gateway username in the menu on righthand side.

   
   Image II - User Settings Navigation

2. User Settings Screen

   
   Image III - User Settings

3. Select Compute Resources from above to add allocation details.

4. Click 'Add a Compute Resource Account'

5. Select the resource from the dropdown list.

6. Provide the required information. NOTE: You may not have allocation project, QOS or Reservation. Minimum requirement is the login username and the scratch location and SSH key.

7. When assigning SSH key by default the default SSH key will be assigned. If user prefers can generate a new key and assign here.

Generate SSH Key

1. For individual users to generate new SSH key navigate to User Settings → Credential Store

2. In Credential store you will have the default key displayed and can be copied.

3. To generate a new key provide a description and add.

   
   Image IV - User Settings → Credential Store

4. User can delete keys and also tag any key as the 'default' SSH key

Add SSH Key to Authorized Keys

1. SSH keys are generated for secure communication between airavata middleware and compute resource.

2. Once SSH key is generated, it needs to be added to the authorized keys file for user in the respective compute resource/cluster.

3. To add the SSH key login to your account in the cluster.

4. Navigate to .SSH directory and open authorized_keys.

5. Add the SSH key assigned in user settings and save.

6. If you have don't have .ssh directory or the authorized_keys file, create them.