Difference: UserGuideEMI2 (19 vs. 20)

Revision 202012-03-30 - AlviseDorigo

Line: 1 to 1
 
META TOPICPARENT name="UserDocumentation"

CREAM User's Guide for EMI-2

Line: 1809 to 1809
 
  • --timeout|-t N sets the SOAP's connection timeout to N seconds (the default is 30 seconds); when the CLI is connecting to (and exchanging data with) a remote ES service, if the transmission hungs up for a time greater than the SOAP connection timeout, the command will exit with an error message
  • --certfile|-c <user_certificate_file> and --keyfile|-k <user_key_file> set the couple certificate/key to use for authentication (instead of the proxyfile). Some ES servers do not support yet (and probably will not support never) the proxy certificates. These 2 options must be use together or not at all; they are mutually exclusive with the --proxyfile option.
  • --donot-verify-ac-sign|-A disable the certification authority check
Added:
>
>

Modifying the connection EPR

Any WebService is reachable at a certain endpoint (hostname and TCPPORT) and EPR (EndPoint Reference) like this:
https://cream-52.pd.infn.it:8443/ce-cream-es/services/CreationService
https:// is the protocol, cream-52.pd.infn.it:8443 is the endpoint (as explained above), /ce-cream-es/services/CreateActivityService is the EPR. A WebService like CREAM/ES can publish more operations (activity creation, activity status, activity list, etc.); different operations can be linked to different EPRs (but same protocol/endpoint). In the case of CREAM/ES this is the mapping:

  • Activity creation: /ce-cream-es/services/CreationService
  • Activity status, cancel, pause, resume, restart, wipe, info: /ce-cream-es/services/ActivityManagementService
  • Activity list: /ce-cream-es/services/ActivityInfoService
  • Delegation operations: /ce-cream-es/services/DelegationService

These EPRs in principle can differ from the EPRs of another ES implementation, then the ES command line has the possibility to specify a different EPR for a certain operation. In the following example we create an activity to a CREAM/ES implementation (cream-10.pd.infn.it) and to a Unicore/ES implementation (zam052v02.zam.kfa-juelich.de:8080) specifying two different EPRs; note that we will use the -d (--debug) option in order to print extra information (e.g. the complete address to contact, including the EPR):

$ glite-es-activity-create --endpoint zam052v02.zam.kfa-juelich.de:8080 --epr /EMI-ES/services/CreateActivityService ~/JDLs/activity_sleep120.adl -c ~/.globus/usercert.pem -k ~/.globus/userkey_nopass.pem -d
Parsing XML file [/home/dorigoa/JDLs/activity_sleep120.adl] and converting to SOAP objects...
There're 1 activity/ies to submit
Sending CreateActivity request to service [https://zam052v02.zam.kfa-juelich.de:8080/EMI-ES/services/CreateActivityService]
*****************************************
ActivityID     = 5c9b6f1e-1a3b-409f-aea4-d550c57bf155
ActivityMgrURI = https://zam052v02.zam.kfa-juelich.de:8080/EMI-ES/services/ActivityManagementService
Status         = ACCEPTED
Status Attrs   = {CLIENT_STAGEIN_POSSIBLE}
Timestamp      = Thu Jan  1 01:00:00 1970
Description    = 
ETNSC          = 
STAGEIN Dir    = {gsiftp://zam052v07.zam.kfa-juelich.de:2811/home15/unicore/FILESPACE/5c9b6f1e-1a3b-409f-aea4-d550c57bf155/}
SESSION Dir    = {}
STAGEOUT Dir   = {}

$ glite-es-activity-create --endpoint cream-10.pd.infn.it --epr /ce-cream-es/services/CreationService ~/JDLs/activity_sleep120.adl -d
Parsing XML file [/home/dorigoa/JDLs/activity_sleep120.adl] and converting to SOAP objects...
There're 1 activity/ies to submit
Sending CreateActivity request to service [https://cream-10.pd.infn.it:8443/ce-cream-es/services/CreationService]
*****************************************
ActivityID     = CR_ES569960280
ActivityMgrURI = https://cream-10.pd.infn.it:8443/ce-cream-es/services/ActivityManagementService
Status         = PREPROCESSING
Status Attrs   = {}
Timestamp      = Fri Mar 30 09:57:14 2012
Description    = 
ETNSC          = 
STAGEIN Dir    = {gsiftp://cream-10.pd.infn.it/var/cream-es_sandbox/dteam/CN_Alvise_Dorigo_L_Padova_OU_Personal_Certificate_O_INFN_C_IT_dteam_Role_NULL_Capability_NULL_dteam004/56/CR_ES569960280/ISB}
SESSION Dir    = {}
STAGEOUT Dir   = {gsiftp://cream-10.pd.infn.it/var/cream-es_sandbox/dteam/CN_Alvise_Dorigo_L_Padova_OU_Personal_Certificate_O_INFN_C_IT_dteam_Role_NULL_Capability_NULL_dteam004/56/CR_ES569960280/OSB}

Note the different EPRs used for the two activity creations. The ES UI has defaults built-in for all the EPRs needed to contact a CREAM/ES implementation (in fact, this guide refers to the CREAM/ES UI, conceived mainly as CREAM/ES client, but able to 'talk' also to other ES implementations thanks to the standardized ES interface).

Also note that for the Unicore/ES implementation (that does not support yet the proxy certificates) we had to specify our certificate and key files with the corresponding options described above.

In the following example we will ask for activity's status on both CREAM/ES and Unicore/ES implementations using, again, different EPRs:

$ glite-es-activity-status --endpoint zam052v02.zam.kfa-juelich.de:8080 --epr /EMI-ES/services/ActivityManagementService -c ~/.globus/usercert.pem -k ~/.globus/userkey_nopass.pem -d 5c9b6f1e-1a3b-409f-aea4-d550c57bf155
Sending ActivityStatus request for ActivityID(s) {5c9b6f1e-1a3b-409f-aea4-d550c57bf155} to service [https://zam052v02.zam.kfa-juelich.de:8080/EMI-ES/services/ActivityManagementService]
*****************************************
ActivityID  = 5c9b6f1e-1a3b-409f-aea4-d550c57bf155
Status      = TERMINAL
Attributes  = {CLIENT_STAGEOUT_POSSIBLE}
Timestamp   = Fri Mar 30 10:00:34 2012
Description = 

$ glite-es-activity-status --endpoint cream-10.pd.infn.it CR_ES778754308 -d
Sending ActivityStatus request for ActivityID(s) {CR_ES778754308} to service [https://cream-10.pd.infn.it:8443/ce-cream-es/services/ActivityManagementService]
*****************************************
ActivityID  = CR_ES778754308
Status      = TERMINAL
Attributes  = {}
Timestamp   = Fri Mar 30 09:49:16 2012
Description = reason=0

Note that in this last example, for the status request to cream-10.pd.infn.it (CREAM/ES implementation) we omitted the --epr option and the command used the (correct) built-in EPR value (/ce-cream-es/services/ActivityManagementService). If we try to get activity status on the Unicore/ES and we forget the EPR specification, the built-in will be used and an error message will be returned by Unicore:

$ glite-es-activity-status --endpoint zam052v02.zam.kfa-juelich.de:8080 -c ~/.globus/usercert.pem -k ~/.globus/userkey_nopass.pem -d 5c9b6f1e-1a3b-409f-aea4-d550c57bf155
Sending ActivityStatus request for ActivityID(s) {5c9b6f1e-1a3b-409f-aea4-d550c57bf155} to service [https://zam052v02.zam.kfa-juelich.de:8080/ce-cream-es/services/ActivityManagementService]
Received NULL fault; the error is due to another cause:  FaultString=[Cannot send message to https://zam052v02.zam.kfa-juelich.de:8080/ce-cream-es/services/ActivityManagementService, such a site is not registered with this gateway.] FaultCode=[SOAP-ENV:Client] FaultSubCode=[SOAP-ENV:Client] FaultDetail=[]
 

-- MassimoSgaravatto - 2011-04-07

-- MassimoSgaravatto - 2012-03-14

Changed:
<
<
-- AlviseDorigo - 2012-03-26
>
>
-- AlviseDorigo - 2012-03-30
 
META FILEATTACHMENT attachment="cream_job_states.jpg" attr="" comment="" date="1331716396" name="cream_job_states.jpg" path="cream_job_states.jpg" size="18586" user="AlviseDorigo" version="1"
 
This site is powered by the TWiki collaboration platformCopyright © 2008-2023 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback