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
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>gfmdhost</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="gfmdhost">
<a name="gfmdhost.1"></a><div class="titlepage"></div>
<div class="refnamediv">
<a name="name"></a><h2>Name</h2>
<p>gfmdhost — Gfarm metadata server host maintenance command</p>
</div>
<div class="refsynopsisdiv" title="Synopsis">
<a name="synopsis"></a><h2>Synopsis</h2>
<div class="cmdsynopsis"><p><code class="command">gfmdhost</code> [-l] [-P <em class="replaceable"><code>path</code></em>] [-1]</p></div>
<div class="cmdsynopsis"><p><code class="command">gfmdhost</code> [-N] [-P <em class="replaceable"><code>path</code></em>] [-1]</p></div>
<div class="cmdsynopsis"><p><code class="command">gfmdhost</code> { -c | -m } [-P <em class="replaceable"><code>path</code></em>] [-1] [-p <em class="replaceable"><code>port-number</code></em>] [-C <em class="replaceable"><code>cluster-name</code></em>] [-t
{ m | c | s }
] {<em class="replaceable"><code>metadata-server-name</code></em>}</p></div>
<div class="cmdsynopsis"><p><code class="command">gfmdhost</code> {-d} [-P <em class="replaceable"><code>path</code></em>] [-1] {<em class="replaceable"><code>metadata-server-name</code></em>}</p></div>
</div>
<div class="refsect1" title="DESCRIPTION">
<a name="description"></a><h2>DESCRIPTION</h2>
<p><span class="command"><strong>gfmdhost</strong></span> is used to display and maintain
the information about synchronous and asynchronous replicated metadata
servers.
<span class="command"><strong>gfmdhost</strong></span> has functions which can be selected by
-l, -c, -m and -d options.
These functions are mutually exclusive, and only one option
among them can be specified.
If none of them is specified, registered metadata server (gfmd host)
names will be listed.
</p>
</div>
<div class="refsect1" title="FUNCTIONS">
<a name="functions"></a><h2>FUNCTIONS</h2>
<p>
The functions of <span class="command"><strong>gfmdhost</strong></span> command are listed in following.
</p>
<div class="variablelist"><dl>
<dt><span class="term"><none></span></dt>
<dd><p>
If no function is specified,
all the registered gfmd hosts are displayed
in alphabetical order.
</p></dd>
<dt><span class="term"><code class="option">-l</code></span></dt>
<dd>
<p>
All registered gfmd hosts are listed with detailed information.
They are grouped by the clusters and ordered alphabetically.
</p>
<p>
The detailed information is displayed in the following order.
</p>
<p><code class="option">Connection State (+|||-|?|x|e|u)</code></p>
<p>
"+" means that the gfmd is connected to the master gfmd, and
its metadata are synchronized.
"|" means that the gfmd is connected to the master gfmd, but
its metadata have not been synchronized yet. Note that this
may happen even on a synchronous slave gfmd, when the slave
is just connecting to the master, or in the middle of metadata
transfer even if it has been already synchronized.
"-" means that the gfmd is not connected to the master gfmd.
"?" means either the gfmd state is unknown because it's just
after the connection was established, or the master gfmd is
Gfarm-2.5.0, but this gfmdhost command is 2.5.1 or later.
"x" means that the connection with master gfmd was established,
but automatic synchronization was impossible because of too many
metadata changes, thus, manual synchronization via dump and
restore of the backend database is necessary.
"e" means an error happened, and log file must be checked manually.
In the case of "x" or "e", it may be displayed even when the
slave gfmd is down.
"u" means that the slave gfmd is connected to the master gfmd, but
the state is not supported by this gfmdhost command.
This column for the master gfmd is always "+".
</p>
<p><code class="option">Server Type (master|slave)</code></p>
<p>
This represents whether the gfmd is master or slave.
</p>
<p><code class="option">Replication Type (sync|async|-)</code></p>
<p>
"sync" means a synchronous replication.
"async" means an asynchronous replication.
This column for the master is always "-".
</p>
<p><code class="option">Configration of Master Candidate (c|m|s)</code></p>
<p>
"m" means the default master gfmd, "c" means a master
candidate that can be selected as a master gfmd,
and "s" means a gfmd that is not a master candidate and only
works for a slave gfmd.
</p>
<p><code class="option">Cluster Name</code></p>
<p>
A cluster name where the gfmd belongs to.
"(default)" is displayed for the default cluster.
</p>
</dd>
<dt><span class="term"><code class="option">-N</code></span></dt>
<dd><p>
Displays a hostname and port number of the connected metadata
server.
</p></dd>
<dt><span class="term"><code class="option">-c</code></span></dt>
<dd><p>
Registers the gfmd host that is specified in the argument.
-C, -p, -t can be optionally specified.
</p></dd>
<dt><span class="term"><code class="option">-m</code></span></dt>
<dd><p>
Modifies the gfmd host that is specified in the argument.
-C, -p, -t can be optionally specified.
</p></dd>
<dt><span class="term"><code class="option">-d</code></span></dt>
<dd><p>
Deletes the gfmd host that is specified in the argument.
The master gfmd cannot be deleted.
</p></dd>
<dt><span class="term"><code class="option">-?</code></span></dt>
<dd><p>Prints usage.</p></dd>
</dl></div>
</div>
<div class="refsect1" title="OPTIONS">
<a name="options"></a><h2>OPTIONS</h2>
<div class="variablelist"><dl>
<dt><span class="term"><code class="option">-C</code> <em class="parameter"><code>cluster-name</code></em></span></dt>
<dd>
<p>
This option specifies a cluster name where the gfmd host
belongs to. If it is not specified, the default cluster is
assumed. This option is only available with -c or -m option.
</p>
<p>
The cluster name means a group of synchronous replicated
metadata servers. That is, slave metadata servers in the same
cluster with the master metadata server are synchronously
replicated servers that can be changed to a master metadata
server without any loss of metadata operations. Other
metadata servers are asynchronously replicated servers.
</p>
</dd>
<dt><span class="term"><code class="option">-p</code> <em class="parameter"><code>port-number</code></em></span></dt>
<dd><p>
This option specifies a port number of the gfmd.
If it is not specified, 601 is assumed.
This option is only available with -c or -m option.
</p></dd>
<dt><span class="term"><code class="option">-t</code> {m|c|s}</span></dt>
<dd><p>
This option specifies a configuration of master candidate.
It is only available with -c or -m option.
"m" means the default master, "c" means a master candidate and
and "s" means a slave only gfmd.
If it is not specified, "c" is assumed.
The gfmd configured as the default master cannot be changed to
a master candidate or slave-only directly.
If the gfmd that is not the default master is changed to the
default master by "-t m", the original default master is
changed to a master candidate at the same time.
</p></dd>
<dt><span class="term"><code class="option">-P</code> <em class="parameter"><code>path</code></em></span></dt>
<dd><p>
This option specifies a pathname or a Gfarm URL to identify
a metadata server which will be accessed by this command.
If not specified, "/" is used as the default value.
</p></dd>
<dt><span class="term"><code class="option">-1</code></span></dt>
<dd><p>
With this option, gfmdhost only tries to connect with one
metadata server specified by -P option, or if missing,
<span class="token">metadb_server_host</span> statement in
<code class="filename">gfarm2.conf</code> file.
</p></dd>
</dl></div>
</div>
<div class="refsect1" title="SEE ALSO">
<a name="see-also"></a><h2>SEE ALSO</h2>
<p>
<span class="citerefentry"><span class="refentrytitle">gfarm2.conf</span>(5)</span>
</p>
</div>
</div></body>
</html>
|
