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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
'\" t
.\"___INFO__MARK_BEGIN__
.\"
.\" Copyright: 2004 by Sun Microsystems, Inc.
.\"
.\"___INFO__MARK_END__
.\" $RCSfile: sge_shadowd.8,v $ Last Update: $Date: 2007-11-08 23:04:23 $ Revision: $Revision: 1.11 $
.\"
.\"
.\" Some handy macro definitions [from Tom Christensen's man(1) manual page].
.\"
.de SB \" small and bold
.if !"\\$1"" \\s-2\\fB\&\\$1\\s0\\fR\\$2 \\$3 \\$4 \\$5
..
.\" "
.de T \" switch to typewriter font
.ft CW \" probably want CW if you don't have TA font
..
.\"
.de TY \" put $1 in typewriter font
.if t .T
.if n ``\c
\\$1\c
.if t .ft P
.if n \&''\c
\\$2
..
.\"
.de M \" man page reference
\\fI\\$1\\fR\\|(\\$2)\\$3
..
.TH xxQS_NAME_Sxx_SHADOWD 8 2007-11-08 "xxRELxx" "xxQS_NAMExx Administrative Commands"
.SH NAME
xxqs_name_sxx_shadowd \- xxQS_NAMExx shadow master daemon
.\"
.\"
.SH SYNOPSIS
.B xxqs_name_sxx_shadowd
.\"
.\"
.SH DESCRIPTION
.I xxqs_name_sxx_shadowd
is a "light weight" process which can be run on so-called shadow
master hosts in a xxQS_NAMExx cluster to detect failure of the current
xxQS_NAMExx master daemon,
.M xxqs_name_sxx_qmaster 8 ,
and to start-up a new
.M xxqs_name_sxx_qmaster 8
on the host on which the
.I xxqs_name_sxx_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.
.PP
The hosts suitable as shadow master hosts must have
shared root read/write access to the directory
.IR $xxQS_NAME_Sxx_ROOT/$xxQS_NAME_Sxx_CELL/common ,
as well as to the master daemon spool directory
(by default
.IR $xxQS_NAME_Sxx_ROOT/$xxQS_NAME_Sxx_CELL/spool/qmaster ).
The names of the shadow master hosts need to be contained in the file
.IR $xxQS_NAME_Sxx_ROOT/$xQS_NAME_Sxx_CELL/common/shadow_masters .
.\"
.\"
.SH RESTRICTIONS
.I xxqs_name_sxx_shadowd
may only be started by root.
.\"
.\"
.SH "ENVIRONMENT VARIABLES"
.\"
.IP "\fBxxQS_NAME_Sxx_ROOT\fP" 1.5i
Specifies the location of the xxQS_NAMExx standard configuration
files.
.\"
.IP "\fBxxQS_NAME_Sxx_CELL\fP" 1.5i
If set, specifies the default xxQS_NAMExx cell. To address a xxQS_NAMExx
cell
.I xxqs_name_sxx_shadowd
uses (in order of precedence):
.sp 1
.RS
.RS
The name of the cell specified in the environment
variable xxQS_NAME_Sxx_CELL, if it is set.
.sp 1
The name of the default cell, i.e. \fBdefault\fP.
.sp 1
.RE
.RE
.\"
.IP "\fBxxQS_NAME_Sxx_DEBUG_LEVEL\fP" 1.5i
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.
.\"
.IP "\fBxxQS_NAME_Sxx_QMASTER_PORT\fP" 1.5i
If set, specifies the TCP port on which
.M xxqs_name_sxx_qmaster 8
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.
.\"
.IP "\fBxxQS_NAME_Sxx_DELAY_TIME\fP" 1.5i
This variable controls the time for which
.I xxqs_name_sxx_shadowd
pauses if a takeover bid fails. This value is used only when there are multiple
.I xxqs_name_sxx_shadowd
instances and they are contending to be the master.
The default is 600 seconds.
.\"
.IP "\fBxxQS_NAME_Sxx_CHECK_INTERVAL\fP" 1.5i
This variable controls the interval between
.I xxqs_name_sxx_shadowd
checks of the heartbeat file (60 seconds by default).
.\"
.IP "\fBxxQS_NAME_Sxx_GET_ACTIVE_INTERVAL\fP" 1.5i
This variable controls the interval between attempts by a
.I xxqs_name_sxx_shadowd
instance to take over when the heartbeat file has not changed.
The default is 240 seconds.
.\"
.\"
.SH "FILES"
.nf
.ta \w'<xxqs_name_sxx_root>/ 'u
\fI<xxqs_name_sxx_root>/<cell>/common\fP
Default configuration directory
\fI<xxqs_name_sxx_root>/<cell>/common/shadow_masters\fP
Shadow master hostname file.
\fI<xxqs_name_sxx_root>/<cell>/spool/qmaster\fP
Default master daemon spool directory
\fI<xxqs_name_sxx_root>/<cell>/spool/qmaster/heartbeat\fP
The heartbeat file.
.fi
.\"
.\"
.SH "SEE ALSO"
.M xxqs_name_sxx_intro 1 ,
.M xxqs_name_sxx_conf 5 ,
.M xxqs_name_sxx_qmaster 8
\" .M xxqs_name_sxx_qmaster 8 ,
\" .I xxQS_NAMExx Installation and Administration Guide.
.\"
.SH "COPYRIGHT"
See
.M xxqs_name_sxx_intro 1
for a full statement of rights and permissions.
|
