Tutorial 07 - PHP Reference Gateway for Airavata - Gateway Admin Guide

Introduction to Gateway Admin Portal 

Important

Setting up Gateway Preferences, registering and modifying Compute Resources, Application Modules, Application Interfaces and Application Deployments are tasks for gateway administrators. To follow below steps your user account requires administrator privileges. After you create as User Account send a request to Airavata Mailing List  to obtain admin access.

Register Compute Resource

1. To register a new compute resource navigate to ‘Compute Resource → Register’ from the main menu.

  Hint: Mandatory fields are tagged with ‘*’

1. In the page; enter

1. Hostname (Required to communicate with the resource)

2. Host Aliases

3. IP addresses

4. Resource Description

Click ‘Create’ and save above information. Upon saving another field; Maximum Memory Per Node ( In MB ) will appear. Enter the memory per node and click ‘Save Changes’ button.

1. Upon saving 3 more tabs will appear;

1. Queues: Enter job queue information in the resource

2. File System: Enter file path locations of the compute resource

3. Job Submission Interfaces: Protocol information required for job submissions.

4. Data Movement Interfaces: Protocol information required for input and output data stagings and transfers.

  Queue Tab

1. In Queue tab; click ‘Add Queue’ button and enter;

1. Queue Name (This is a unique value. Once entered cannot be modified)

2. Queue Description

3. Queue Max Run Time

4. Queue Max Nodes

5. Queue Max Processors

6. Max Jobs in Queue

7. Max Memory for Queue (in MB)

2. After entering informations click ‘Create’ and save. Can clear any entered information prior to saving by clicking ‘Reset’.

3. After the queue is saved it will get listed under ‘Existing Queues’ and can modify by clicking the <pen image> or can delete by clicking <trash can image>

4. When adding queues can add multiple queues by clicking ‘Add Queue’ Button.

  File System Tab

In this tab admin user has to enter information about important or used file locations in the resource.

1. Enter resources file path locations to folders;

1. HOME - HOME folder path of the compute resource

2. LOCAL -

3. LOCALTMP

4. SCRATCH

5. ARCHIVE

2. We use above captured locations for;

1. HOME -

2. LOCAL -

3. LOCALTMP -

4. SCRATCH -

5. ARCHIVE -

Job Submission Interface

This is the 4th tab in Register Compute Resource process.

1. Click on ‘Add a New Job Submission Interface’ button

2. Select a relevant job submission protocol from the available protocols;

1. LOCAL

2. SSH

3. 1. GLOBUS

   2. UNCORE

   3. CLOUD

   1. If you selected a protocol which is yet to be available, you will see the message; “<Protocol Name> protocol not being set up right now.Please choose another option”

   
   

   1. Once a protocol is selected enter below parameter for the selected protocol;

   1. Resource Manager - auto populated

   2. Resource Manager Type - Select from existing list; FORK, PBS, SLURM,LSF and UGE

   3. Push Monitoring Endpoint - User has to enter the path

   4. Job Manager Bin Path - User has to enter the path

   5. Job Manager Commands - User can enter commands for

   1. SUBMISSION

   2. JOB MONITORING

   3. DELETION

   4. CHECK JOB

   5. SHOW QUEUE

   6. SHOW RESERVATION

   7. SHOW START

   2. Once all data is entered click ‘Add Job Submission Protocol’ button to save.

   3. Per resource user can enter multiple protocols and when more than one protocol exists user has to enter priority of them. Click ‘Update Priority’, it will display added protocols and the user can enter priority. These fields are numeric fields. 

   
   

     Data Movement Interface

   1. In the tab click ‘Add a New Data Movement Interface’ button and select a protocol from the available list.

   2. For each protocol mandatory fields are be marked with a ‘*’

   3. Enter all parameters for the selected data movement interface and click ‘Add Data Movement Protocol’ button to save the parameters.

   
   

   Search Compute Resource

   1. Navigate to the search page through; Main Menu → Compute Resource → Browse.

   2. Name and the ID of all existing compute resources will be displayed. User can also search for the resource by giving the name in the text field above the list.

   3. Through this page user can Edit, View or Delete a compute resources. Icons for each actions are;

   1. To Edit click on the icon ‘Pen’ on the right hand side along with the compute resources name

   2. 1. To View click on the icon ‘Pen’ on the right hand side along with the compute resources name

      1. Depending on the access granted to each user/user role can edit, view or delete the computer resources.

      2. When clicked on ‘Edit’ icon user will be navigated to same set of UIs similar to registraign compute resource.s User can change existing values on each page and update.

      
      

      Tutorial III - Create & Search Application Module, Application Interface and Application Deployment

      NOTE: Registering and modifying Compute resources, Application Modules, Application Interfaces and Application Deployments are gateway admin’s tasks. When you create an account to follow below steps send a request to obtain admin access to Airavata Mailing List

       Create Application Module

      1. Navigate to App Catalog → Module and click ‘Create a New Application Module’ button.

      2. Enter all required information. Mandatory fields are marked with ‘*’

      
      

       Search Application Module

      1. Navigate to App Catalog → Module. All available application modules will be listed in the page.

      2. User can search for a specific module by entering the module name or part of the module name in the text box above the list OR select from the already available list.