Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Target Audience and take home lessons:
The tutorial is targeted for Gateway developers who want to build a new gateway from scratch; for advanced developers who are investigating to improve a particular capability; and Campus Champions who can learn easier mechanisms to move data and execute jobs on XSEDE. The take home lessons include skills to execute compute jobs and workflows on XSEDE resources through grid interfaces; Wrap command line applications turning them into web accessible programmable interfaces and learn about open community development process to contribute to existing software with proper contribution governance models.

Click to see Agenda

Click to see Hands on Instructions

Table of Contents

Starting up XBaya

Download XBaya - JNLP Link

or

Use the binary distribution (Mac/Linux):

  1. Extract the Airavata binary distribution apache-airavata-0.4-incubating-SNAPSHOT-bin.zip to <AIRAVATA_HOME>.
  2. Execute <AIRAVATA_HOME>/bin/xbaya-gui.sh

Setup Registry

Select menu,

    Registry -> Setup Airavata Registry...

Provide the following,

URL

    http://demo.airavata.org:8090/jackrabbit-webapp-2.4.0/rmi

                   or

    http://gf9.ucs.indiana.edu:8090/jackrabbit-webapp-2.4.0/rmi

Username

    admin

Password

    admin

Click "OK"

Register Applications in Ranger

To register a new application select menu,

    XBaya -> Register Application  menu.

Provide the following Application details

Application name:

    list_files                         (or any other unique name)

Application Parameters:   

I/O

Name

Type

Input

path

String

Input

options

String

Output

result

StdOut

Add Deployments

Click on the “New deployment” button. “New Application Deployment” form will appear.

Provide the following details

Application host

    ranger

Executable path

    /bin/ls

Scratch working directory

    /scratch/01437/ogce/test

Click on the “HPC Configuration...” button. The HPC Configuration Options form will appear. Provide the following details,

Job Type

    serial

Project Account Number

    TG-STA110014S

Queue Type

    development

Click “Update”

Click “Add”

Click “Register”. You will see a Successfully saved confirmation message if the registration is successful.

After registering the Application successfully you will see your application in Left hand side Application Services list. Create a workflow using that service and run the workflow as if you did in previous workflow run.

Compose Workflow

To add a new workflow select menu,

    XBaya -> New Workflow.

A new Workflow editor will open along with the Workflow Properties dialog for that workflow. Enter the following details in the dialog

    Name

        retrieve_files_names

Click “OK”

From the left hand side “Component List” drag & drop the following to the Workflow editor.

2 x System Components -> Input

1 x System Components -> Output

1 x Application Services -> list_files

Connect output of “Input” components to inputs of “list_files_invoke”
Connect output of “list_files_invoke” component to input of “Output”

You may save the workflow by menu item

    XBaya -> Save (in order to save it in the local file system)

      or

    XBaya -> Export -> Workflow to Registry... (in order to save it in the Airavata Registry)

Running & Monitoring a Workflow

If the workflow is not already opened in XBaya, select menu,

    XBaya -> Open Workflow

       or

    XBaya -> Import -> Workflow from Registry

based on whether the workflow was saved in the file system or Airavata Registry.

Once the workflow is loaded on to XBaya select menu,

    Run -> Run on Interpreter Server...

Provide the following as values for the parameters

    path

        /bin

    options

        -al

    Experiment name

        Executables in ranger              (or any name you want to call it)

Click “Run”

The monitoring panel docked at the bottom of XBaya should get focus and show the notifications of the execution of the workflow.

The workflow loaded in XBaya should indicate the progress of the workflow execution.

Viewing Experiment Results

In XBaya select menu,

    View -> Airavata Registry

This will open a panel in XBaya docked at the left hand side. This will show the saved content in the Airavata Registry.

Expand the “Experiments” node to view the details of the experimentPlease click here and fill out a very short survey on the tutorial  - Gateways Tutorial Survey