NAME
     sge_shadowd - Sun Grid Engine shadow master daemon

SYNOPSIS
     sge_shadowd

DESCRIPTION
     sge_shadowd is a "light weight" process which can be run  on
     so-called  shadow  master hosts in a Sun Grid Engine cluster
     to detect failure of the current Sun Grid Engine master dae-
     mon, sge_qmaster(8), and to start-up a new sge_qmaster(8) on
     the host on which the sge_shadowd runs. If  multiple  shadow
     daemons  are  active in a cluster, they run a protocol which
     ensures that only one of them will  start-up  a  new  master
     daemon.

     The  hosts suitable for being used as  shadow  master  hosts
     must  have  shared  root  read/write access to the directory
     $SGE_ROOT/$SGE_CELL/common as well as to the  master  daemon
     spool            directory            (by            default
     $SGE_ROOT/$SGE_CELL/spool/qmaster).  The names of the shadow
     master   hosts   need   to   be   contained   in   the  file
     $SGE_ROOT/$xQS_NAME_Sxx_CELL/common/shadow_masters.

RESTRICTIONS
     sge_shadowd may only be started by root.

ENVIRONMENT 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_shadowd  uses  (in  the  order  of   pre-
                    cedence):

                         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 com-
                    munication requests.  Most installations will
                    use  a  services  map  entry  for the service
                    "sge_qmaster" instead to define that port.

     SGE_DELAY_TIME This variable controls the interval in  which
                    sge_shadowd  pauses  if a takeover bid fails.
                    This value is used only when there are multi-
                    ple  sge_shadowd  instances and they are con-
                    tending to be the master.  The default is 600
                    seconds.

     SGE_CHECK_INTERVAL
                    This variable controls the interval in  which
                    the sge_shadowd checks the heartbeat file (60
                    seconds by default).

     SGE_GET_ACTIVE_INTERVAL
                    This variable controls the  interval  when  a
                    sge_shadowd  instance tries to take over when
                    the heartbeat file has not changed.

FILES
     <sge_root>/<cell>/common
                     Default configuration directory
     <sge_root>/<cell>/common/shadow_masters
                     Shadow master hostname file.
     <sge_root>/<cell>/spool/qmaster
                     Default master daemon spool directory
     <sge_root>/<cell>/spool/qmaster/heartbeat
                     The heartbeat file.

SEE ALSO
     sge_intro(1), sge_conf(5), sge_qmaster(8), Sun  Grid  Engine
     Installation and Administration

COPYRIGHT
     See sge_intro(1) for a full statement of rights and  permis-
     sions.