NAME
sge_qmaster - Grid Engine master control daemon
SYNOPSIS
sge_qmaster [ -help ] [ -lj log_file ] [ -nohist ] [
-noread-argfile ] [ -nostart-commd ] [ -nostart-schedd ] [
-nowrite-argfile ] [ -s ] [ -truncate-argfile ]
sge_qmaster -show-license
DESCRIPTION
sge_qmaster controls the overall Grid Engine behavior in a
cluster. For the purpose of scheduling jobs sge_qmaster
cooperates with sge_schedd(8). At start-up of sge_qmaster
sge_commd(8) is usually brought up automatically on the same
machine (if not already present).
OPTIONS
-help
Prints a listing of all options.
-lj log_file
Enables job logging. All actions taken by sge_qmaster
from submit to job exit are logged to the log_file.
This feature is also available with the sge_execd(8)
daemon.
-nohist
During usual operation sge_qmaster dumps a history of
queue, complex and host configuration changes to a his-
tory database. This database is primarily used with the
qacct(1) command to allow for qsub(1) like -l resource
requests in the qacct(1) command-line. This switch
suppresses writing to this database.
-noread-argfile
On primary start-up, sge_qmaster writes its command-
line arguments to a file. During later start-ups, this
argument file will be read and the options contained in
the file will be used as if supplied at the command-
line. This option suppresses reading of the argument
file.
-nostart-commd
Do not start-up sge_commd(8) automatically with
sge_qmaster.
-nostart-schedd
Do not startup sge_schedd(8) automatically with
sge_qmaster. sge_qmaster currently does not start
sge_schedd(8) automatically. Thus this option has no
effect.
-nowrite-argfile
On primary start-up, sge_qmaster writes its command-
line arguments to a file. During later start-ups, this
argument file will be read and the options contained in
the file will be used as if supplied at the command-
line. This option suppresses writing of the argument
file.
-s turns on sge_qmasters silent mode. Usually sge_qmaster
displays a license information on startup and waits for
a return to continue. With the -s switch sge_qmaster
starts up silently.
-show-license
Displays the current licensing information for your
Grid Engine system. This option also works if your
license has expired and sge_qmaster would exit immedi-
ately otherwise. Use the displayed information to
request an appropriate license from your Grid Engine
support contact.
-truncate-argfile
On primary start-up, sge_qmaster writes its command-
line arguments to a file. During later start-ups, this
argument file will be read and the options contained in
the file will be used as if supplied at the command-
line. This option truncates the argument file.
ENVIRONMENTAL 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_qmaster 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.
COMMD_PORT If set, specifies the tcp port on which
sge_commd(8) is expected to listen for com-
munication requests. Most installations will
use a services map entry instead to define
that port.
RESTRICTIONS
sge_qmaster is usually started from root on the master or
shadow master machines of the cluster (refer to the Grid
Engine Installation and Administration Guide for more infor-
mation about the configuration of shadow master hosts). If
started by a normal user, a master 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 treated
correctly by the system.
FILES
<sge_root>/<cell>/common/configuration
Grid Engine global configuration
<sge_root>/<cell>/common/local_conf/<host>
Grid Engine host specific configuration
<sge_root>/<cell>/common/history
History database
<sge_root>/<cell>/common/qmaster_args
sge_qmaster argument file
<sge_root>/<cell>/spool
Default master spool directory
SEE ALSO
sge_intro(1), sge_conf(5), sge_commd(8), sge_execd(8),
sge_schedd(8), sge_shadowd(8), Grid Engine Installation and
Administration Guide
COPYRIGHT
See sge_intro(1) for a full statement of rights and permis-
sions.
Man(1) output converted with
man2html