1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
<HTML>
<BODY BGCOLOR=white>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
NAME
sgecommdcntl - Grid Engine communication agent control com-
mand
SYNOPSIS
sgecommdcntl [ -d | -k | -t level ] [ -gid commprocname ] [
-h[elp] ] [ -p port ] [ -S ] [ -unreg commprocname id ]
DESCRIPTION
<I>sgecommdcntl</I> can be used to control the behavior of
<B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> or to retrieve information from a running
<B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>.
OPTIONS
-d Dump internal structures of the running <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>
process to /<I>tmp</I>/<I>commd</I>/<I>commd</I>.<I>dump</I>. The directory
/<I>tmp</I>/<I>commd</I> must exist and <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> must have write
access to it. The request is ignored otherwise.
This option is mainly intended for debugging purposes.
The functionality of the addressed <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> is not
affected.
-k Kill the addressed <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>. Pending communica-
tions at the time of a kill request will be discarded
immediately, yet the shutdown of a <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> will
not leave the processes being connected to the aborting
process in an inconsistent state.
-t level
<I>sgecommdcntl</I> establishes a connection to <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>
and displays continuous trace output corresponding the
trace level specified by level. The output consists of
a subset of the trace output displayed if <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>
is invoked with the -ll option.
Currently the only trace level being supported is 255.
-gid commprocname
Retrieve communication process identification number of
commprocname. Grid Engine components which enroll to
<B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> to be able to communicate with other Grid
Engine processes are registered by <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> with an
unique identification consisting of a name and an iden-
tification number. The identification name is identical
with the name of the Grid Engine component (e.g.
sge_qmaster for <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B>). The identification
number can be retrieved by the -gid option.
-help
Prints a listing of all options.
-p commdport
Port number to be used in order to address
<B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>.
-S Forces secure ports to be used for communication
between <I>sge</I>_<I>commd</I>s and between other Grid Engine com-
ponents and the <I>sge</I>_<I>commd</I>s. This requires all Grid
Engine daemons to be started with root permission and
the client programs to be configured set-uid root. In
turn, it ensures that unauthorized communication is
prohibited for non-root accounts.
-unreg commprocname id
Unregister Grid Engine component commprocname
registered with Id id to <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> (see the -gid
above for a description of commprocname and id).
To unregister a Grid Engine component from <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>
can become necessary if a Grid Engine daemon such as
<B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B>, <B><A HREF="../htmlman8/sge_execd.html">sge_execd(8)</A></B> or <B><A HREF="../htmlman8/sge_schedd.html">sge_schedd(8)</A></B> is
aborted in an uncontrolled fashion (e.g. by sending the
signal SIGKILL via <B><A HREF="../htmlman1/kill.html">kill(1)</A></B>) and <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> denies
restart of that component with the message error enrol-
ling to commd: COMMPROC ALREADY REGISTERED.
The registration facility of <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> is used to
avoid redundant Grid Engine daemons running on the same
host. If a Grid Engine component is aborted but unable
to unregister from <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B> the registration is
kept alive until a time-out of several minutes passes
or until the communication process is unregistered
manually.
ENVIRONMENTAL VARIABLES
COMMD_PORT If set, specifies the tcp port on which
<I>sgecommdcntl</I> is expected to listen for com-
munication requests. Most installations will
use a services map entry instead to define
that port.
COMMD_HOST If set, specifies the host on which the par-
ticular <I>sge</I>_<I>commd</I> to be used for Grid Engine
communication of <I>sgecommdcntl</I> resides. Per
default the local host is used.
SEE ALSO
<B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B>, <B><A HREF="../htmlman8/sge_commd.html">sge_commd(8)</A></B>, <B><A HREF="../htmlman8/sge_execd.html">sge_execd(8)</A></B>, <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B>,
<B><A HREF="../htmlman8/sge_schedd.html">sge_schedd(8)</A></B>.
COPYRIGHT
See <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B> for a full statement of rights and permis-
sions.
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
|
