|
META TOPICPARENT |
name="SystemAdministratorDocumentation" |
|
|
< < | The CREAM configuration file |
> > | The CREAM configuration file for the EMI-2 release |
|
|
|
The Command Executor |
|
< < | The commandexeuctor represents the implementation of specific functionality provided by CREAM (e.g. delegation, job management, activity management). More than one commandexecutor can be defined in the configuration file and its XML structure is as the following: |
> > | The commandexecuctor represents the implementation of specific functionality provided by CREAM (e.g. delegation, job management, activity management). At the current time CREAM provides three different commandexecuctors (BLAHExecutor, ActivityExecutor and DelegationExecutor) but new ones can be implemented and configured. The configuration of a commandexecutor is based on a well defined structure composed of a set of mandatory attributes and parameters which are specific for each executor: |
|
<commandexecutor |
|
* please DO NOT change the default value which comes from the YAIM configuration. |
|
> > | The Delegation Executor
The Delegation Executor implements delegation functionality (e.g. make a new delegation request, renew or destroy a delegation, etc). The list of attributes and parameters which define this executor, complete of their meaning and default values is:
attributes
- id: "DelegationExecutor"
- category: "DELEGATION_MANAGEMENT" (*)
- commandqueuesize: "0" (NB: the value MUST be "0" because the executor doesn't need the command queue) (*)
- commandqueueshared: "false" (*)
- commandworkerpoolsize: "0" (NB: the value MUST be "0" because the executor doesn't need the command queue) (*)
- filename: "/usr/share/java/glite-ce-cream-delegationExecutor.jar"
parameters
- CREAM_COPY_PROXY_TO_SANDBOX_BIN_PATH: the path of the script for copying the user delegation proxy into the specified job sandbox (default: "/usr/bin/glite-cream-copyProxyToSandboxDir.sh")
- CREAM_PURGE_PROXY_FROM_SANDBOX_BIN_PATH: the path of the script for deleting the user delegation proxy from the specified job sandbox (default: "/usr/bin/glite-ce-cream-purge-proxy")
- CREAM_SANDBOX_DIR: the directory where the sandbox files are staged on the CREAM CE node (default: "/var/cream_sandbox")
- DELEGATION_PURGE_RATE: specifies how often the delegation purger has to run (default "10" minutes)
* please DO NOT change the default value which comes from the YAIM configuration.
example
<commandexecutor id="DelegationExecutor"
category="DELEGATION_MANAGEMENT"
commandqueuesize="0"
commandqueueshared="false"
commandworkerpoolsize="0"
filename="/usr/share/java/glite-ce-cream-delegationExecutor.jar">
<parameter name="CREAM_COPY_PROXY_TO_SANDBOX_BIN_PATH" value="/usr/bin/glite-cream-copyProxyToSandboxDir.sh" />
<parameter name="CREAM_PURGE_PROXY_FROM_SANDBOX_BIN_PATH" value="/usr/bin/glite-ce-cream-purge-proxy" />
<parameter name="CREAM_SANDBOX_DIR" value="/var/cream_es_sandbox" />
<parameter name="DELEGATION_PURGE_RATE" value="10" /> <!-- minutes -->
</commandexecutor>
|
|
The BLAH Executor |
|
< < | This executor implements the CREAM's job management capabilities and it is based on the BLAH component. The attributes and parameters are accepted for well defining this commandexecutor are: |
> > | This executor implements the CREAM's job management capabilities (e.g. jobSubmit, jobCancel, jobInfo, etc). CREAM interacts with the BLAH component, an abstraction layer providing a unified interface to the underlying LRMS. At the time of writing CREAM supports through BLAH the following LRMS: LSF, PBS/Torque, SGE, Condor and SLURM. The list of attributes and parameters which define this executor, complete of their meaning and default values is: |
|
attributes |
|
parameters
- SANDBOX_TRANSFER_METHOD: sets the sandbox transfer method (GSIFTP/LRMS) (default: "GSIFTP")
|
|
< < |
- CREAM_SANDBOX_DIR: is the directory where the sandbox files are staged on the CREAM CE node (default: "/var/cream_sandbox")
|
> > |
- CREAM_SANDBOX_DIR: the directory where the sandbox files are staged on the CREAM CE node (default: "/var/cream_sandbox")
|
|
- CREAM_CREATE_SANDBOX_BIN_PATH: the path of the executable for creating the job sandbox (default: "/usr/bin/glite-cream-createsandboxdir")
- CREAM_COPY_PROXY_TO_SANDBOX_BIN_PATH: the path of the script for copying the user delegation proxy into the specified job sandbox (default: "/usr/bin/glite-cream-copyProxyToSandboxDir.sh")
- CREAM_PURGE_SANDBOX_BIN_PATH: the path of the executable for purging the job sandbox (default: "/usr/bin/glite-ce-cream-purge-sandbox")
|
|
- MAX_LEASE_TIME: the maximum allowed lease time (in second). I.e. if a client specifies a lease time too big, this value is used instead (dafault: "36000")
- LEASE_EXECUTION_RATE: specifies how often the job purger has to run (default: "30" minutes)
- GLEXEC_BIN_PATH: the path of the glexec executable (default: "/usr/sbin/glexec")
|
|
< < |
- GLEXEC_CAT_CMD_PATH: is the pathname of the "cat" command invoked by CREAM via glexec (default: "/bin/cat")
- BLAHP_BIN_PATH: is the path of the blahpd executable (default: "/usr/bin/blahpd")
|
> > |
- GLEXEC_CAT_CMD_PATH: the pathname of the "cat" command invoked by CREAM via glexec (default: "/bin/cat")
- BLAHP_BIN_PATH: the path of the blahpd executable (default: "/usr/bin/blahpd")
|
|
- BLAH_JOBID_PREFIX: represents a prefix for job names for BLAH. If the same BLAH parser serves multiple CREAM CEs, please choose a different value for each of these CREAM services. The value MUST be a string 6 characters long that starts with 'cr' and ends with '_' (default: "cream_")
- BLAH_COMMAND_TIMEOUT: represents the maximum time interval accepted by CREAM for the execution of commands by BLAH (default: "300" seconds)
- BLPARSER_RETRY_COUNT: represents the number of attempts to contact the BLAH parser (if it is not reachable) before giving up. If -1 is specified, CREAM will never give up (default: "100")
|
|
< < |
- BLPARSER_RETRY_DELAY: is the time interval (ms) between two attempts to contact the BLAH parser (default: "60000")
- LRMS_EVENT_LISTENER_PORT: is the port used by CREAM to receive notifications about job status changes sent by the BLParser/JobWrapper (default: "49152")
|
> > |
- BLPARSER_RETRY_DELAY: the time interval (ms) between two attempts to contact the BLAH parser (default: "60000")
- LRMS_EVENT_LISTENER_PORT: the port used by CREAM to receive notifications about job status changes sent by the BLParser/JobWrapper (default: "49152")
|
|
- HOST_SMP_SIZE: the default value for the hostsmpsize attribute (default: "2")
- JOB_WRAPPER_DELEGATION_TIME_SLOT = "3600"
<-- sec. -->
- JOB_WRAPPER_COPY_PROXY_MIN_RETRY_WAIT = "60"
<-- sec. -->
|
|
The Activity Executor (EMI-ES) |
|
< < | This Activity Executor implements the EMI-ES functionality. The accepted attributes and parameters are: |
> > | This Activity Executor implements the functionality (e.g. createActivity, getActivityInfo, etc) defined in the EMI-ES specification (v1.16). The list of attributes and parameters which define this executor, complete of their meaning and default values is: |
|
attributes |
|
- ACTIVITY_WRAPPER_TEMPLATE_PATH: the path where the ActivityWrapper template is placed (default: "/etc/glite-ce-cream-es/")
- BDII_URI: defines the BDII URI (e.g. _"ldap://cream.pd.infn.it:2170" _)
- BDII_RATE: specifies how often CREAM has to get information from the BDII (default: "60" minutes)
|
|
< < |
- BLAH_BIN_PATH: is the path of the blahpd executable (default: "/usr/bin/blahpd")
|
> > |
- BLAH_BIN_PATH: the path of the blahpd executable (default: "/usr/bin/blahpd")
|
|
- BLAH_PREFIX: represents a prefix for job names for BLAH. If the same BLAH parser serves multiple CREAM CEs, please choose a different value for each of these CREAM services. The value MUST be a string 6 characters long that starts with 'cr' and ends with '_' (default: "cr-es_")
- BLAH_COMMAND_TIMEOUT: represents the maximum time interval accepted by CREAM for the execution of commands by BLAH (default: "300" seconds)
|
|
< < |
- BLAH_NOTIFICATION_LISTENER_PORT: is the port used by CREAM to receive notifications about job status changes sent by the BLParser/ActivityWrapper (default: "49155")
|
> > |
- BLAH_NOTIFICATION_LISTENER_PORT: the port used by CREAM to receive notifications about job status changes sent by the BLParser/ActivityWrapper (default: "49155")
|
|
- BLAH_NOTIFIER_RETRY_COUNT: represents the number of attempts to contact the BLAH parser (if it is not reachable) before giving up. If -1 is specified, CREAM will never give up (default: "100")
|
|
< < |
- BLAH_NOTIFIER_RETRY_DELAY: is the time interval (ms) between two attempts to contact the BLAH parser (default: "60000")
|
> > |
- BLAH_NOTIFIER_RETRY_DELAY: the time interval (ms) between two attempts to contact the BLAH parser (default: "60000")
|
|
- COPY_PROXY_MIN_RETRY_WAIT: (default: "60" seconds)
- COPY_RETRY_COUNT_ISB: (default: "2")
- COPY_RETRY_FIRST_WAIT_ISB: (default: "60" seconds)
|
|
- DELEGATION_TIME_SLOT*: (default "3600" seconds)
- LIMIT_FOR_LIST_ACTIVITIES: defines the maximum number of items contained into the response to be sent back to the client (default: "500")
- PURGE_SANDBOX_BIN_PATH: the path of the executable for purging the job sandbox (default: "/usr/bin/glite-ce-cream-purge-sandbox")
|
|
< < |
- SANDBOX_DIR: is the directory where the sandbox files are staged on the CREAM CE node (default: "/var/cream-es_sandbox")
|
> > |
- SANDBOX_DIR: the directory where the sandbox files are staged on the CREAM CE node (default: "/var/cream-es_sandbox")
|
|
* please DO NOT change the default value which comes from the YAIM configuration. |
|
< < | The Delegation Executor
This Delegation Executor implements delegation functionality. The accepted attributes and parameters are:
attributes
- id: "DelegationExecutor"
- category: "DELEGATION_MANAGEMENT" (*)
- commandqueuesize: "0" (NB: the value MUST be "0" because the executor doesn't need the command queue) (*)
- commandqueueshared: "false" (*)
- commandworkerpoolsize: "0" (NB: the value MUST be "0" because the executor doesn't need the command queue) (*)
- filename: "/usr/share/java/glite-ce-cream-delegationExecutor.jar"
parameters
- CREAM_COPY_PROXY_TO_SANDBOX_BIN_PATH: the path of the script for copying the user delegation proxy into the specified job sandbox (default: "/usr/bin/glite-cream-copyProxyToSandboxDir.sh")
- CREAM_PURGE_PROXY_FROM_SANDBOX_BIN_PATH: the path of the script for deleting the user delegation proxy from the specified job sandbox (default: "/usr/bin/glite-ce-cream-purge-proxy")
- CREAM_SANDBOX_DIR: is the directory where the sandbox files are staged on the CREAM CE node (default: "/var/cream_sandbox")
- DELEGATION_PURGE_RATE: specifies how often the delegation purger has to run (default "10" minutes)
* please DO NOT change the default value which comes from the YAIM configuration. |
|
-- LisaZangrando - 2012-12-04 |