summaryrefslogtreecommitdiffstats
path: root/doc/admin-guide/en-US/admin_commandref.xml
blob: df4c78f4869f5f9bc8fe7f5d120416d664c81760 (plain)
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
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
<?xml version='1.0' encoding='UTF-8'?>
<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "docbookV4.5/docbookx.dtd" []>
<chapter id="chap-Administration_Guide-Com_Ref">
  <title>Command Reference </title>
  <para>This section describes the available  commands and includes the
following section:
</para>
  <itemizedlist>
    <listitem>
      <para>gluster Command
</para>
      <para>Gluster Console Manager (command line interpreter)
</para>
    </listitem>
    <listitem>
      <para>glusterd Daemon
</para>
      <para>Gluster elastic volume management daemon
</para>
    </listitem>
  </itemizedlist>
  <section>
    <title>gluster Command </title>
    <para><emphasis role="bold">NAME</emphasis>
</para>
    <para>gluster - Gluster Console Manager (command line interpreter)
</para>
    <para><emphasis role="bold">SYNOPSIS</emphasis>
</para>
    <para>To run the program and display the gluster prompt:
</para>
    <para><emphasis role="bold">gluster</emphasis>
</para>
    <para>To specify a command directly:
gluster [COMMANDS] [OPTIONS]
</para>
    <para><emphasis role="bold">DESCRIPTION</emphasis>
</para>
    <para>The Gluster Console Manager is a command line utility for elastic volume management. You can run
the gluster command on any export server. The command enables administrators to perform cloud
operations such as creating, expanding, shrinking, rebalancing, and migrating volumes without
needing to schedule server downtime.
</para>
    <para><emphasis role="bold">COMMANDS</emphasis>
</para>
    <para><informaltable frame="none">
        <tgroup cols="3">
          <colspec colnum="1" colname="c0" colsep="0"/>
          <colspec colnum="2" colname="cgen1" colsep="0"/>
          <colspec colnum="3" colname="c1" colsep="0"/>
          <thead>
            <row>
              <entry>Command</entry>
              <entry namest="cgen1" nameend="c1">Description</entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry namest="c0" nameend="c1" align="left">
                <emphasis role="bold">Volume</emphasis>
              </entry>
            </row>
            <row>
              <entry>volume info [all | VOLNAME]</entry>
              <entry namest="cgen1" nameend="c1">Displays information about all volumes, or the specified volume.</entry>
            </row>
            <row>
              <entry>volume create NEW-VOLNAME [stripe COUNT] [replica COUNT] [transport tcp | rdma | tcp,rdma] NEW-BRICK ...</entry>
              <entry namest="cgen1" nameend="c1">Creates a new volume of the specified type using the specified bricks and transport type (the default transport type is tcp).</entry>
            </row>
            <row>
              <entry>volume delete VOLNAME</entry>
              <entry namest="cgen1" nameend="c1">Deletes the specified volume.</entry>
            </row>
            <row>
              <entry>volume start VOLNAME </entry>
              <entry namest="cgen1" nameend="c1">Starts the specified volume.</entry>
            </row>
            <row>
              <entry>volume stop VOLNAME [force] </entry>
              <entry namest="cgen1" nameend="c1">Stops the specified volume. </entry>
            </row>
            <row>
              <entry>volume rename VOLNAME NEW-VOLNAME </entry>
              <entry namest="cgen1" nameend="c1">Renames the specified volume.</entry>
            </row>
            <row>
              <entry>volume help </entry>
              <entry namest="cgen1" nameend="c1">Displays help for the volume command.</entry>
            </row>
            <row>
              <entry namest="c0" nameend="c1" align="left">
                <emphasis role="bold">Brick</emphasis>
              </entry>
            </row>
            <row>
              <entry>volume add-brick VOLNAME NEW-BRICK ... </entry>
              <entry namest="cgen1" nameend="c1">Adds the specified brick to the specified volume.</entry>
            </row>
            <row>
              <entry>volume replace-brick VOLNAME (BRICK NEW-BRICK) start | pause | abort | status </entry>
              <entry namest="cgen1" nameend="c1">Replaces the specified brick.</entry>
            </row>
            <row>
              <entry>volume remove-brick VOLNAME [(replica COUNT)|(stripe COUNT)] BRICK ... </entry>
              <entry namest="cgen1" nameend="c1">Removes the specified brick from the specified volume.</entry>
            </row>
            <row>
              <entry namest="c0" nameend="c1" align="left">
                <emphasis role="bold">Rebalance</emphasis>
              </entry>
            </row>
            <row>
              <entry>volume rebalance VOLNAME start</entry>
              <entry namest="cgen1" nameend="c1">Starts rebalancing the specified volume.</entry>
            </row>
            <row>
              <entry>volume rebalance VOLNAME stop </entry>
              <entry namest="cgen1" nameend="c1">Stops rebalancing the specified volume. </entry>
            </row>
            <row>
              <entry>volume rebalance VOLNAME status </entry>
              <entry namest="cgen1" nameend="c1">Displays the rebalance status of the specified volume.</entry>
            </row>
            <row>
              <entry namest="c0" nameend="c1" align="left">
                <emphasis role="bold">Log</emphasis>
              </entry>
            </row>
            <row>
              <entry>volume log filename VOLNAME [BRICK] DIRECTORY </entry>
              <entry namest="cgen1" nameend="c1">Sets the log directory for the corresponding volume/brick. </entry>
            </row>
            <row>
              <entry>volume log rotate VOLNAME [BRICK] </entry>
              <entry namest="cgen1" nameend="c1">Rotates the log file for corresponding volume/brick.</entry>
            </row>
            <row>
              <entry>volume log locate VOLNAME [BRICK] </entry>
              <entry namest="cgen1" nameend="c1">Locates the log file for corresponding volume/brick. </entry>
            </row>
            <row>
              <entry namest="c0" nameend="c1" align="left">
                <emphasis role="bold">Peer</emphasis>
              </entry>
            </row>
            <row>
              <entry>peer probe HOSTNAME </entry>
              <entry namest="cgen1" nameend="c1">Probes the specified peer. </entry>
            </row>
            <row>
              <entry>peer detach HOSTNAME </entry>
              <entry namest="cgen1" nameend="c1">Detaches the specified peer. </entry>
            </row>
            <row>
              <entry>peer status </entry>
              <entry namest="cgen1" nameend="c1">Displays the status of peers. </entry>
            </row>
            <row>
              <entry>peer help </entry>
              <entry namest="cgen1" nameend="c1">Displays help for the peer command.</entry>
            </row>
            <row>
              <entry namest="c0" nameend="c1" align="left">
                <emphasis role="bold">Geo-replication</emphasis>
              </entry>
            </row>
            <row>
              <entry>volume geo-replication MASTER SLAVE start</entry>
              <entry namest="cgen1" nameend="c1">
                <para>Start geo-replication between the hosts specified by MASTER and SLAVE. You can specify a local master volume as :VOLNAME.</para>
                <para>You can specify a local slave volume as :VOLUME and a local slave directory as /DIRECTORY/SUB-DIRECTORY. You can specify a remote slave volume as DOMAIN::VOLNAME and a remote slave directory as DOMAIN:/DIRECTORY/SUB-DIRECTORY.</para>
              </entry>
            </row>
            <row>
              <entry>volume geo-replication MASTER SLAVE stop</entry>
              <entry namest="cgen1" nameend="c1">
                <para>Stop geo-replication between the hosts specified by MASTER and SLAVE. You can specify a local master volume as :VOLNAME and a local master directory as /DIRECTORY/SUB-DIRECTORY.</para>
                <para>You can specify a local slave volume as :VOLNAME and a local slave directory as /DIRECTORY/SUB-DIRECTORY. You can specify a remote slave volume as DOMAIN::VOLNAME and a remote slave directory as DOMAIN:/DIRECTORY/SUB-DIRECTORY.
</para>
              </entry>
            </row>
            <row>
              <entry morerows="10">volume geo-replication MASTER SLAVE config [options]</entry>
              <entry/>
              <entry>Configure geo-replication options between the hosts specified by MASTER and SLAVE. </entry>
            </row>
            <row>
              <entry>gluster-command COMMAND</entry>
              <entry>The path where the gluster command is installed.</entry>
            </row>
            <row>
              <entry>gluster-log-level LOGFILELEVEL</entry>
              <entry>The log level for gluster processes.</entry>
            </row>
            <row>
              <entry>log-file LOGFILE</entry>
              <entry>The path to the geo-replication log file.</entry>
            </row>
            <row>
              <entry>log-level LOGFILELEVEL</entry>
              <entry>The log level for geo-replication.</entry>
            </row>
            <row>
              <entry>remote-gsyncd COMMAND</entry>
              <entry>The path where the gsyncd binary is installed on the remote machine.</entry>
            </row>
            <row>
              <entry>ssh-command COMMAND</entry>
              <entry>The ssh command to use to connect to the remote machine (the default is ssh).</entry>
            </row>
            <row>
              <entry>rsync-command COMMAND</entry>
              <entry>The rsync command to use for synchronizing the files (the default is rsync).</entry>
            </row>
            <row>
              <entry>volume_id= UID</entry>
              <entry>The command to delete the existing master UID for the intermediate/slave node.</entry>
            </row>
            <row>
              <entry>timeout SECONDS</entry>
              <entry>The timeout period.</entry>
            </row>
            <row>
              <entry>sync-jobs N</entry>
              <entry>The number of simultaneous files/directories that can be synchronized.</entry>
            </row>
            <row>
              <entry/>
              <entry>ignore-deletes</entry>
              <entry>If this option is set to 1, a file deleted on master will not trigger a delete operation on the slave. Hence, the slave will remain as a superset of the master and can be used to recover the master in case of crash and/or accidental delete.</entry>
            </row>
            <row>
              <entry namest="c0" nameend="c1" align="left">
                <emphasis role="bold">Other</emphasis>
              </entry>
            </row>
            <row>
              <entry>help</entry>
              <entry/>
              <entry>Display the command options.</entry>
            </row>
            <row>
              <entry>quit</entry>
              <entry/>
              <entry>Exit the gluster command line interface.</entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable></para>
    <para><emphasis role="bold">FILES</emphasis>

</para>
    <para>/etc/glusterd/*
</para>
    <para><emphasis role="bold">SEE ALSO </emphasis></para>
    <para>fusermount(1), mount.glusterfs(8), glusterfs-volgen(8), glusterfs(8), glusterd(8)</para>
  </section>
  <section>
    <title>glusterd Daemon </title>
    <para><emphasis role="bold">NAME</emphasis>
</para>
    <para>glusterd - Gluster elastic volume management daemon</para>
    <para><emphasis role="bold">SYNOPSIS</emphasis>
</para>
    <para>glusterd [OPTION...]
</para>
    <para><emphasis role="bold">DESCRIPTION</emphasis>
</para>
    <para>The glusterd daemon is used for elastic volume management. The daemon must be run on all export servers.
</para>
    <para><emphasis role="bold">OPTIONS</emphasis>
</para>
    <para><informaltable frame="none">
        <tgroup cols="2">
          <colspec colnum="1" colname="c0" colsep="0"/>
          <colspec colnum="2" colname="c1" colsep="0"/>
          <thead>
            <row>
              <entry>Option</entry>
              <entry>Description</entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry namest="c0" nameend="c1" align="left">
                <emphasis role="bold">Basic</emphasis>
              </entry>
            </row>
            <row>
              <entry>-l=LOGFILE, --log-file=LOGFILE</entry>
              <entry>Files to use for logging (the default is /usr/local/var/log/glusterfs/glusterfs.log).</entry>
            </row>
            <row>
              <entry>-L=LOGLEVEL, --log-level=LOGLEVEL</entry>
              <entry>Logging severity. Valid options are TRACE, DEBUG, INFO, WARNING, ERROR and CRITICAL (the default is INFO). </entry>
            </row>
            <row>
              <entry>--debug</entry>
              <entry>Runs the program in debug mode. This option sets --no-daemon, --log-level to DEBUG, and --log-file to console.</entry>
            </row>
            <row>
              <entry>-N, --no-daemon</entry>
              <entry>Runs the program in the foreground.</entry>
            </row>
            <row>
              <entry namest="c0" nameend="c1" align="left">
                <emphasis role="bold">Miscellaneous</emphasis>
              </entry>
            </row>
            <row>
              <entry>-?, --help</entry>
              <entry>Displays this help.</entry>
            </row>
            <row>
              <entry>--usage</entry>
              <entry>Displays a short usage message.</entry>
            </row>
            <row>
              <entry>-V, --version</entry>
              <entry>Prints the program version.</entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable></para>
    <para><emphasis role="bold">FILES</emphasis>

</para>
    <para>/etc/glusterd/*
</para>
    <para><emphasis role="bold">SEE ALSO </emphasis></para>
    <para>fusermount(1), mount.glusterfs(8), glusterfs-volgen(8), glusterfs(8), gluster(8)</para>
  </section>
</chapter>