summaryrefslogtreecommitdiffstats
path: root/doc/admin-guide/en-US/markdown/admin_commandref.md
blob: 4ff05f4eff2d2ecbcce0550bdef3168f2efe4aa1 (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
Command Reference
=================

This section describes the available commands and includes the following
section:

-   gluster Command

    Gluster Console Manager (command line interpreter)

-   glusterd Daemon

    Gluster elastic volume management daemon

gluster Command
===============

**NAME**

gluster - Gluster Console Manager (command line interpreter)

**SYNOPSIS**

To run the program and display the gluster prompt:

**gluster**

To specify a command directly: gluster [COMMANDS] [OPTIONS]

**DESCRIPTION**

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.

**COMMANDS**

  ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  Command                                                                                                    Description
  ---------------------------------------------------------------------------------------------------------- ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  **Volume**

  volume info [all | VOLNAME]                                                                                Displays information about all volumes, or the specified volume.

  volume create NEW-VOLNAME [stripe COUNT] [replica COUNT] [transport tcp | rdma | tcp,rdma] NEW-BRICK ...   Creates a new volume of the specified type using the specified bricks and transport type (the default transport type is tcp).

  volume delete VOLNAME                                                                                      Deletes the specified volume.

  volume start VOLNAME                                                                                       Starts the specified volume.

  volume stop VOLNAME [force]                                                                                Stops the specified volume.

  volume rename VOLNAME NEW-VOLNAME                                                                          Renames the specified volume.

  volume help                                                                                                Displays help for the volume command.

  **Brick**

  volume add-brick VOLNAME NEW-BRICK ...                                                                     Adds the specified brick to the specified volume.

  volume replace-brick VOLNAME (BRICK NEW-BRICK) start | pause | abort | status                              Replaces the specified brick.

  volume remove-brick VOLNAME [(replica COUNT)|(stripe COUNT)] BRICK ...                                     Removes the specified brick from the specified volume.

  **Rebalance**

  volume rebalance VOLNAME start                                                                             Starts rebalancing the specified volume.

  volume rebalance VOLNAME stop                                                                              Stops rebalancing the specified volume.

  volume rebalance VOLNAME status                                                                            Displays the rebalance status of the specified volume.

  **Log**

  volume log filename VOLNAME [BRICK] DIRECTORY                                                              Sets the log directory for the corresponding volume/brick.

  volume log rotate VOLNAME [BRICK]                                                                          Rotates the log file for corresponding volume/brick.

  volume log locate VOLNAME [BRICK]                                                                          Locates the log file for corresponding volume/brick.

  **Peer**

  peer probe HOSTNAME                                                                                        Probes the specified peer.

  peer detach HOSTNAME                                                                                       Detaches the specified peer.

  peer status                                                                                                Displays the status of peers.

  peer help                                                                                                  Displays help for the peer command.

  **Geo-replication**

  volume geo-replication MASTER SLAVE start                                                                  Start geo-replication between the hosts specified by MASTER and SLAVE. You can specify a local master volume as :VOLNAME.
                                                                                                             
                                                                                                             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.

  volume geo-replication MASTER SLAVE stop                                                                   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.
                                                                                                             
                                                                                                             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.

  volume geo-replication MASTER SLAVE config [options]                                                                                                                                                                                                                                                                                             Configure geo-replication options between the hosts specified by MASTER and SLAVE.

  gluster-command COMMAND                                                                                    The path where the gluster command is installed.

  gluster-log-level LOGFILELEVEL                                                                             The log level for gluster processes.

  log-file LOGFILE                                                                                           The path to the geo-replication log file.

  log-level LOGFILELEVEL                                                                                     The log level for geo-replication.

  remote-gsyncd COMMAND                                                                                      The path where the gsyncd binary is installed on the remote machine.

  ssh-command COMMAND                                                                                        The ssh command to use to connect to the remote machine (the default is ssh).

  rsync-command COMMAND                                                                                      The rsync command to use for synchronizing the files (the default is rsync).

  volume\_id= UID                                                                                            The command to delete the existing master UID for the intermediate/slave node.

  timeout SECONDS                                                                                            The timeout period.

  sync-jobs N                                                                                                The number of simultaneous files/directories that can be synchronized.

                                                                                                             ignore-deletes                                                                                                                                                                                                                        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.

  **Other**

  help                                                                                                                                                                                                                                                                                                                                             Display the command options.

  quit                                                                                                                                                                                                                                                                                                                                             Exit the gluster command line interface.
  ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

**FILES**

/var/lib/glusterd/\*

**SEE ALSO**

fusermount(1), mount.glusterfs(8), glusterfs-volgen(8), glusterfs(8),
glusterd(8)

glusterd Daemon
===============

**NAME**

glusterd - Gluster elastic volume management daemon

**SYNOPSIS**

glusterd [OPTION...]

**DESCRIPTION**

The glusterd daemon is used for elastic volume management. The daemon
must be run on all export servers.

**OPTIONS**

  Option                              Description
  ----------------------------------- ----------------------------------------------------------------------------------------------------------------
  **Basic**
  -l=LOGFILE, --log-file=LOGFILE      Files to use for logging (the default is /usr/local/var/log/glusterfs/glusterfs.log).
  -L=LOGLEVEL, --log-level=LOGLEVEL   Logging severity. Valid options are TRACE, DEBUG, INFO, WARNING, ERROR and CRITICAL (the default is INFO).
  --debug                             Runs the program in debug mode. This option sets --no-daemon, --log-level to DEBUG, and --log-file to console.
  -N, --no-daemon                     Runs the program in the foreground.
  **Miscellaneous**
  -?, --help                          Displays this help.
  --usage                             Displays a short usage message.
  -V, --version                       Prints the program version.

**FILES**

/var/lib/glusterd/\*

**SEE ALSO**

fusermount(1), mount.glusterfs(8), glusterfs-volgen(8), glusterfs(8),
gluster(8)