Alert.png The wiki is deprecated and due to be decommissioned by the end of September 2022.
The content is being migrated to other supports, new updates will be ignored and lost.
If needed you can get in touch with EGI SDIS team using operations @

HOWTO18 How to use the Catania Science Gateway Framework as Application Broker

From EGIWiki
(Redirected from HOWTO18)
Jump to navigation Jump to search
Main operations services Support Documentation Tools Activities Performance Technology Catch-all Services Resource Allocation Security

Documentation menu: Home Manuals Procedures Training Other Contact For: VO managers Administrators
Alert.png This page is Deprecated and should no longer be used

The Catania Science Gateway Framework (CSGF) has been developed by INFN, Division of Catania (Italy), to provide application developers with a tool to create Science Gateways (SGs) in short time and in a very easy way. CSGF is made of a set of libraries to manage Authentication & Authorization mechanisms and to interact with several different kinds of DCIs (grid, cloud, HPC, local, etc.). The CSGF is based on well established and widely adopted standards, such as SAGA, SAML, OCCI, JSR 286, etc. and it is fully compliant with both the VO Portal and User Traceability policies.

The CSGF allows users to execute applications on the EGI Federated Cloud through web portals/SGs. The Science Gateways based on CSGF provide users with intuitive web interface to execute applications on the Cloud as jobs and to manage these jobs during their running (check the status and download the output). The SGs takes care of starting the VMs on the EGI Federated Cloud, transfer the needed files (e.g. executable, input files, etc.), stop the VMs and download the output in behalf of the user.

A list of Science Gateways based on the CSGF is available here.

The EGI Federated Cloud users can exploit the CSGF features to:

In the following sections are available step by step instructions for the users.

Execute applications already integrated in a Science Gateway

The list of all the applications available in the CSGF based Science Gateways is available in the CHAIN-REDS Application Database. The CHAIN-REDS application database gives you the direct link to the application run pages. Otherwise you can decide to directly visit one of the Science Gateway of this list.

Once you identified the applications you would like to execute, you have to follow the below described steps:

  • Click on the "Sign In" link in the main page of the chosen Science Gateway
  • Select your identity federation. If you don't find any identity provider suitable for you, you can use the catch-all one: GrIDP.

A subset of Identity Federations supported by the CSGF

  • Select your identity providers and login on the Science Gateway using your standard credential. SSO is available as identity provider of the catch-all identity federation GrIDP. If you don't find any identity provider suitable for you, you can use the catch-all one: IDOPEN GARR. See the below image for a subset of the identity providers supported by the CSGF.

A subset of the Identity Providers supported by the GrIDP federation

  • If this is the first time you are logging in the selected Science Gateway, you'll be redirect to the Science Gateway registration page. Fill in the form and submit it.
  • Your registration request will be sent to the Science Gateway administrator. He will evaluate your request and accept or reject it. You will be notified by e-mail at the end of the process. This is a manual process, then you could wait for 1-2 working days until your request will be evaluted.
  • After your registration is accepted, you can login again on the Science Gateway following the same procedure above described. Now you are an authorised user and you are able to access the run pages of the applications integrated in the Science Gateway
  • Select the application you are willing to execute and go to the run page
  • Fill in the form showed in the run page with your input parameters and click on the run button

Form to submit WRF application on the EGI Federated Cloud

  • Now your application is running. You can monitor it (checking the status, run, done, etc.) accessing the My Workspace web page page of the Science Gateway.

MyWorkspace allows users to check the job status and downloand the output of done jobs

  • When your application execution is completed, you can download the output accessing the My Workspace web page page.

Add your application to a Science Gateway

The currently existing Science Gateways are running on top of a Liferay instance (although this is not a mandatory requirement). Then, to add your application to one of the already running SGs based on the CSGF, you have to develop a Java portlet according to the JSR 286 specification.

The CSGF provides portlet developers with a library, the Catania Grid & Cloud engine, exposing all the methods needed to interact with the EGI Federated Cloud and, in general, with the EGI e-infrastructure. Catania Grid & Cloud engine documentation is available here.

The Catania Grid & Cloud engine is a Java library that can be used in any Java enabled environment.

The CSGF team is keen to help you in the integration of new applications on the CSGF SGs. Then, if you need any assistance or help, contact the CSGF Support Team.

Deploy your Science Gateway based on the Catania Science Gateway Framework

If you would like to deploy a new Science Gateway based on the CSGF, please contact the CSGF Support Team.