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:

       •  A load value report starts with a line containing only either the word  "start" or the word "begin".

       •  Individual load values are separated by newlines.

       •  Each load value report consists of three parts separated by colons (":") and containing no blanks.

       •  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".

       •  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.

       •  The third part is the measured load value.

       •  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.

SGE 6.2u5                                            $Date$                                         SGE_EXECD(8)