Difference between revisions of "GCF Primer"

From GCube System
Jump to: navigation, search
(Dealing with Globus)
 
(60 intermediate revisions by 2 users not shown)
Line 1: Line 1:
# [[gCore Tutorial#Tutorial overview|Tutorial overview]]
+
This Primer gives a gentle introduction to the task of developing gCube services with the gCore Framework. Have a quick look at the prerequisites and make sure you go through the preliminary steps. Then dive in.
## [[gCore Tutorial#Ground rules: preparing the environment|Ground rules: preparing the environment]]
+
 
## [[gCore Tutorial#Installing gCore|Installing gCore]]
+
#[[Prerequisites & Preliminaries|First Things First: Prerequisites & Preliminaries]]
# [[Single Port-Type|From configuration to testing with a single Port-Type]]
+
#[[The ACME Project|The ACME Project: Organising Structure & Dependencies]]
## [[Single Port-Type#Structuring the service code|Structuring the service code]]
+
# [[The Development Cycle|A Quick Tour of Development]]
## [[Single Port-Type#Structuring the service code|Delving into the implementation]]
+
## [[The Development Cycle#My First Profile|My First Profile]]
## [[Single Port-Type#Building & Deploying|Building & Deploying]]
+
## [[The Development Cycle#A Tiny JNDI |A Tiny JNDI]]
## [[Single Port-Type#gCore Logging & Restart|gCore Logging & Restart]]
+
## [[The Development Cycle#A PortType Interface|A PortType Interface]]
## [[Single Port-Type#A Test Client|A Test Client]]
+
## [[The Development Cycle#A Simple Implementation|A Simple Implementation]]
## [[Single Port-Type#Refining the implementation|Refining the implementation]]
+
## [[The Development Cycle#Building & Deploying|Building & Deploying]]
# [[Adding State]]
+
## [[The Development Cycle#Starting the gHN|Starting the gHN]]
## [[Adding State#Multi Port-Type service|Multi Port-Type service]]
+
## [[The Development Cycle#A Minimal Client|A Minimal Client]]
## [[Adding State#Basic steps|Basic steps]]  
+
# [[Refining the implementation|Refining the Implementation: Faults, Logs, and PortType Contexts]]
## [[Adding State#Implementation|Implementation]]
+
## [[Refining the implementation#A Faultful PortType|A Faultful PortType]]
## [[Adding State#Configuring JNDIs & Descriptors|Configuring JNDIs & Descriptors]]
+
## [[Refining the implementation#Logging it!|Logging it!]]
## [[Adding State#Building & Deploying|Building & Deploying]]
+
## [[Refining the implementation#Node & Port-Type Contexts|Node & Port-Type Contexts]]
## [[Adding State#A Test Client|A Test Client]]
+
# [[Adding State|Adding State: Concepts, Patterns, and Standards]]
 +
## [[Adding_State#WS-Resources and The Implied Resource Pattern|WS-Resources and The Implied Resource Pattern]]
 +
## [[Adding_State#WS-Resources and Standard Interfaces|WS-Resources and Standard Interfaces]]
 +
## [[Adding_State#The Lifetime of WS-Resources|The Lifetime of WS-Resources]]  
 +
## [[Adding_State#Persistence for WS-Resources|Persistence for WS-Resources]]
 +
## [[Adding_State#Publishing WS-Resources|Publishing WS-Resources]]
 +
# [[Advanced_Topics|Advanced Topics]]
 +
## [[Advanced_Topics#Interfacing_the_Information_System|Interfacing the Information System]]
 +
## [[Advanced_Topics#Interfacing_the_Information_System|Service security]]
 
# [[Learning more]]
 
# [[Learning more]]
== Tutorial overview ==
 
This tutorial intends to present gCore and its related software required to design, build, and deploy software that can be effectively used to build complex applications that might be eventually integrated within a gCube infrastructure.
 
 
=== How this tutorial is organized ===
 
The tutorial takes an incremental approach to illustrate all the steps of the service development cycle in relation to a first Port-Type. For simplicity, it assumes the Port-Type to be stateless. Then it introduces the assumption of state, when by enriching the sample service with additional Port-Types.
 
 
=== Who should use this tutorial ===
 
gCore Tutorial is dedicated to developers that have an average knowledge of Unix-like systems and Java, and some experience with Web Service concepts, terminology, and procedures. The purpose of the tutorial is to help them take advantage of the numerous patterns, interfaces, frameworks, and tools offered by the ''gCore framework'' creating well-structured and supported gCube services.
 
 
== Ground rules: preparing the environment ==
 
* Exclusively a Java & Unix-like system environment
 
** 1.5.0_08+
 
** OS requirements as per underlying Globus
 
* Typically, a Shell + IDE environment
 
** IDE for code configuration & authoring
 
** Shell for code building & deployment
 
** Require both installation & configuration
 
 
== Obtaining gCore ==
 
* through SVN checkout
 
''https://svn.research-infrastructures.eu/gcore/gcore/trunk/GCORE/CONTAINER''
 
* with Etics downloads (only for gCube developers)
 
''https://grids16.eng.it/BuildReport/'', Module: org.gcore.gcontainer
 
* through command line or IDE plugin alike, e.g. Subversion for Eclipse
 
 
Put it into a folder of choice (named from now on, the ''gCore LOCATION'')
 
 
=== gContainer at a glance ===
 
 
Here is the directory structure once the gCore distribution is uncompressed
 
<pre>
 
gCore LOCATION
 
|
 
|-bin
 
|
 
|-config
 
|
 
|-endorsed
 
|
 
|-etc
 
|
 
|-lib
 
|
 
|-libexec
 
|
 
|-share
 
      |
 
      |-gcore_tools
 
      |-globus_wsrf_common
 
      |-globus_wsrf_core
 
      |-globus_wsrf_core_registry
 
      |-globus_wsrf_msd_userful_rp_schema
 
      |-globus_wsrf_test
 
      |-globus_wsrf_tools
 
      |-licences
 
      |-schema     
 
</pre>
 
 
Here is the list of the most significant directory names:
 
* bin contains the commands
 
* etc is used to place container and service specific configuration
 
* lib contains the java libraries
 
* share/gcube_tools
 
 
=== Dealing with Globus ===
 
In order to deal with the underlying Globus technology, the following steps are needed:
 
 
export GLOBUS_LOCATION to the gCore LOCATION
 
export PATH to gCore bin
 
configure ''${GLOBUS_LOCATION}/etc/globus_wsrf_core/server-config.wsdd'' by specifing the hostname as value of the logicalHost parameter
 
 
<pre>
 
 
<deployment name="defaultServerConfig" xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java" xmlns:wsa="http:/
 
/schemas.xmlsoap.org/ws/2004/03/addressing" xmlns:wsnt="http://docs.oasis-open.org/wsn/2004/06/wsn-WS-BaseNotification-1.2-draft-01.xsd" xmlns:wsrp="http://d
 
ocs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceProperties-1.2-draft-01.xsd" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
 
 
    <globalConfiguration>
 
        <parameter name="logicalHost" value="localhost"/>
 
        [...]
 
    <globalConfiguration>
 
</deployment>
 
 
</pre>
 
 
To test it: start GHN  ''gcore-start-container -nosec'' (by defaut on 8080, otherwise start with ''-p <port>'')
 
  
=== GHN Passport ===
+
--[[User:Manuele.simi|Manuele.simi]]
[[Image:GCore003.png|frame|]]
+

Latest revision as of 13:58, 8 June 2010

This Primer gives a gentle introduction to the task of developing gCube services with the gCore Framework. Have a quick look at the prerequisites and make sure you go through the preliminary steps. Then dive in.

  1. First Things First: Prerequisites & Preliminaries
  2. The ACME Project: Organising Structure & Dependencies
  3. A Quick Tour of Development
    1. My First Profile
    2. A Tiny JNDI
    3. A PortType Interface
    4. A Simple Implementation
    5. Building & Deploying
    6. Starting the gHN
    7. A Minimal Client
  4. Refining the Implementation: Faults, Logs, and PortType Contexts
    1. A Faultful PortType
    2. Logging it!
    3. Node & Port-Type Contexts
  5. Adding State: Concepts, Patterns, and Standards
    1. WS-Resources and The Implied Resource Pattern
    2. WS-Resources and Standard Interfaces
    3. The Lifetime of WS-Resources
    4. Persistence for WS-Resources
    5. Publishing WS-Resources
  6. Advanced Topics
    1. Interfacing the Information System
    2. Service security
  7. Learning more

--Manuele.simi