SGE_EXECD(8) System Manager's Manual SGE_EXECD(8) NAME sge_execd - Univa Grid Engine job execution agent SYNOPSIS sge_execd [ -help ] DESCRIPTION sge_execd controls the Univa 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 com- plete cluster (e.g. free disk space on a network wide scratch file sys- tem). 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 cer- tain 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 com- plex 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". After the word "end", it might be necessary to flush STDOUT to make the load values available for the execution daemon immediately. ENVIRONMENTAL VARIABLES SGE_ROOT Specifies the location of the Univa Grid Engine standard configuration files. SGE_CELL If set, specifies the default Univa Grid Engine cell. To address a Univa 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 writ- ten 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 ser- vice "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 ser- vice "sge_execd" instead to define that port. RESTRICTIONS sge_execd usually is started from root on each machine in the Univa 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 correspond- ing 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. //common/configuration Univa Grid Engine global configuration //common/local_conf/ Univa Grid Engine host specific configuration //spool/ Default execution host spool directory //common/act_qmaster Univa 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. Univa Grid Engine Administrative CoUGEn8.5.4 SGE_EXECD(8)