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 @ egi.eu.

Difference between revisions of "HOWTO18 How to use the Catania Science Gateway Framework as Application Broker"

From EGIWiki
Jump to navigation Jump to search
 
(18 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Fedcloud-tf:Menu}} {{TOC_right}}
{{Template:Op menubar}} {{Template:Doc_menubar}}
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 fully compliant to the [https://documents.egi.eu/document/80 EGI.eu VO portal policy].
[[Category:Deprecated]]
{| style="border:1px solid black; background-color:lightgrey; color: black; padding:5px; font-size:140%; width: 90%; margin: auto;"
| style="padding-right: 15px; padding-left: 15px;" |
|[[File:Alert.png]] This page is '''Deprecated''' and should no longer be used
|}
 
{{TOC_right}}  
[[Category:Operations_Manuals]]
The [http://www.catania-science-gateways.it/ 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 [https://documents.egi.eu/document/80 EGI.eu VO Portal] and [https://documents.egi.eu/document/81 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.
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.
Line 17: Line 25:
Otherwise you can decide to directly visit one of the Science Gateway of [http://gridp.garr.it/service-providers.html this list].
Otherwise you can decide to directly visit one of the Science Gateway of [http://gridp.garr.it/service-providers.html this list].


Once you identified the applications you would like to execute you have to follow the following steps:
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
* Click on the "Sign In" link in the main page of the chosen Science Gateway
* Select your identity providers and login on the Science Gateway using your standard credential. EGI.eu SSO is available as identity providers. 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 CGF
* Select your identity federation. If you don't find any identity provider suitable for you, you can use the catch-all one: GrIDP.
<BR>
[[File:CSGF-IdentityFederations.jpg|center|x400px|A subset of Identity Federations supported by the CSGF]]
<BR>
* Select your identity providers and login on the Science Gateway using your standard credential. EGI.eu 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.
<BR>
<BR>
[[File:CSGF_IdentityProviders.jpg|center|x400px|A subset of the Identity Providers supported by the CSGF]]
[[File:CSGF_IdentityProviders.jpg|center|x400px|A subset of the Identity Providers supported by the GrIDP federation]]
<BR>
<BR>
* 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.
* 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.
Line 28: Line 40:
* Select the application you are willing to execute and go to the run page
* 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
* Fill in the form showed in the run page with your input parameters and click on the run button
<BR>
[[File:WRF.jpg|center|x400px|Form to submit WRF application on the EGI Federated Cloud]]
[[File:WRF.jpg|center|x400px|Form to submit WRF application on the EGI Federated Cloud]]
<BR>
* 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.
* 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.
<BR>
[[File:CSGF_myworkspace.jpg|center|x400px|MyWorkspace allows users to check the job status and downloand the output of done jobs]]
[[File:CSGF_myworkspace.jpg|center|x400px|MyWorkspace allows users to check the job status and downloand the output of done jobs]]
<BR>
* When your application execution is completed, you can download the output accessing the '''My Workspace''' web page page.
* When your application execution is completed, you can download the output accessing the '''My Workspace''' web page page.


Line 40: Line 56:
The Catania Grid & Cloud engine is a Java library that can be used in any Java enabled environment.
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 [mailto:sg-licence@ct.infn.it CSGF user support team].
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 [mailto:sg-licence@ct.infn.it CSGF Support Team].


== Deploy your Science Gateway based on the Catania Science Gateway Framework ==
== 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 [mailto:sg-licence@ct.infn.it CSGF user support team].
If you would like to deploy a new Science Gateway based on the CSGF, please contact the [mailto:sg-licence@ct.infn.it CSGF Support Team].
 
== References ==
* The Catania Science Gateway Framework web site can be reached at the following URL: http://www.catania-science-gateways.it

Latest revision as of 13:48, 10 September 2021

Main EGI.eu 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 EGI.eu 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. EGI.eu 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.

References