NAME
sge_execd - Sun Grid Engine job execution agent
SYNOPSIS
sge_execd [ -help ]
DESCRIPTION
sge_execd controls the Sun Grid Engine queues local to the machine on
which sge_execd is running and executes/controls the jobs sent from
sge_qmaster(8) to be run on these queues.
OPTIONS
-help
Prints a listing of all options.
LOAD SENSORS
If a load sensor is configured for sge_execd via either the global host
configuration or the execution-host-specific cluster configuration (See
sge_conf(5).), the executable path of the load sensor is invoked by
sge_execd on a regular basis and delivers one or multiple load figures
for the execution host (e.g. users currently logged in) or the
complete cluster (e.g. free disk space on a network wide scratch file
system). The load sensor may be a script or a binary executable. In
either case its handling of the STDIN and STDOUT streams and its
control flow must comply to the following rules:
The load sensor must be written as an infinite loop waiting at a
certain point for input from STDIN. If the string "quit" is read from
STDIN, the load sensor should exit. When an end-of-line is read from
STDIN, a load data retrieval cycle should start. The load sensor then
performs whatever operation is necessary to compute the desired load
figures. At the end of the cycle the load sensor writes the result to
stdout. The format is as follows:
o A load value report starts with a line containing only either the
word "start" or the word "begin".
o Individual load values are separated by newlines.
o Each load value report consists of three parts separated by colons
(":") and containing no blanks.
o The first part of a load value information is either the name of the
host for which load is reported or the special name "global".
o The second part is the symbolic name of the load value as defined in
the host or global complex list (see complex(5) for details). If a
load value is reported for which no entry in the host or global
complex list exists, the reported load value is not used.
o The third part is the measured load value.
o A load value report ends with a line with only the word "end".
ENVIRONMENTAL VARIABLES
SGE_ROOT Specifies the location of the Sun Grid Engine standard
configuration files.
SGE_CELL If set, specifies the default Sun Grid Engine cell. To
address a Sun Grid Engine cell sge_execd uses (in the
order of precedence):
The name of the cell specified in the environment
variable SGE_CELL, if it is set.
The name of the default cell, i.e. default.
SGE_DEBUG_LEVEL
If set, specifies that debug information should be
written to stderr. In addition the level of detail in
which debug information is generated is defined.
SGE_QMASTER_PORT
If set, specifies the tcp port on which sge_qmaster(8)
is expected to listen for communication requests. Most
installations will use a services map entry for the
service "sge_qmaster" instead to define that port.
SGE_EXECD_PORT If set, specifies the tcp port on which sge_execd(8) is
expected to listen for communication requests. Most
installations will use a services map entry for the
service "sge_execd" instead to define that port.
RESTRICTIONS
sge_execd usually is started from root on each machine in the Sun Grid
Engine pool. If started by a normal user, a spool directory must be
used to which the user has read/write access. In this case only jobs
being submitted by that same user are handled correctly by the system.
FILES
sgepasswd contains a list of user names and their
corresponding encrypted passwords. If available, the password file
will be used by sge_execd. To change the contents of this file
please use the sgepasswd command. It is not advised to change that
file manually.
<sge_root>/<cell>/common/configuration
Sun Grid Engine global configuration
<sge_root>/<cell>/common/local_conf/<host>
Sun Grid Engine host specific configuration
<sge_root>/<cell>/spool/<host>
Default execution host spool directory
<sge_root>/<cell>/common/act_qmaster
Sun Grid Engine master host file
SEE ALSO
sge_intro(1), sge_conf(5), complex(5), sge_qmaster(8).
COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions.