---
name: "sge_shadowd"
section: "8"
platform: "linux"
package: "gridengine-master"
version: "8.1.9+dfsg-13.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/sge_shadowd"
---

# sge\_shadowd(8)

Grid Engine shadow master daemon

## NAME

sge\_shadowd - 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 Grid Engine cluster to detect failure of the current Grid Engine master daemon, [*sge\_qmaster*(8)](/sge_qmaster/8.md), and to start-up a new [*sge\_qmaster*(8)](/sge_qmaster/8.md) 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 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 Grid Engine standard configuration files.

- **SGE\_CELL**

  If set, specifies the default Grid Engine cell. To address a Grid Engine cell *sge\_shadowd* uses (in 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)](/sge_qmaster/8.md) 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\_DELAY\_TIME**

  This variable controls the time for which *sge\_shadowd* pauses if a takeover bid fails. This value is used only when there are multiple *sge\_shadowd* instances and they are contending to be the master. The default is 600 seconds.

- **SGE\_CHECK\_INTERVAL**

  This variable controls the interval between *sge\_shadowd* checks of the heartbeat file (60 seconds by default).

- **SGE\_GET\_ACTIVE\_INTERVAL**

  This variable controls the interval between attempts by a *sge\_shadowd* instance to take over when the heartbeat file has not changed. The default is 240 seconds.

## 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_intro/1.md), [*sge\_conf*(5)](/sge_conf/5.md), [*sge\_qmaster*(8)](/sge_qmaster/8.md)

## COPYRIGHT

See [*sge\_intro*(1)](/sge_intro/1.md) for a full statement of rights and permissions.