diff options
Diffstat (limited to 'doc/gluster.8')
| -rw-r--r-- | doc/gluster.8 | 140 |
1 files changed, 66 insertions, 74 deletions
diff --git a/doc/gluster.8 b/doc/gluster.8 index 23910dc03..3c78fb8b1 100644 --- a/doc/gluster.8 +++ b/doc/gluster.8 @@ -1,133 +1,125 @@ -.\" -.\" Copyright (c) 2006-2010 Gluster, Inc. <http://www.gluster.com> + +.\" Copyright (c) 2006-2012 Red Hat, Inc. <http://www.redhat.com> .\" This file is part of GlusterFS. .\" -.\" GlusterFS is GF_FREE software; you can redistribute it and/or modify -.\" it under the terms of the GNU Affero General Public License as published -.\" by the Free Software Foundation; either version 3 of the License, -.\" or (at your option) any later version. -.\" -.\" GlusterFS is distributed in the hope that it will be useful, but -.\" WITHOUT ANY WARRANTY; without even the implied warranty of -.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -.\" Affero General Public License for more details. -.\" -.\" You should have received a copy of the GNU Affero General Public License -.\" along with this program. If not, see -.\" <http://www.gnu.org/licenses/>. +.\" This file is licensed to you under your choice of the GNU Lesser +.\" General Public License, version 3 or any later version (LGPLv3 or +.\" later), or the GNU General Public License, version 2 (GPLv2), in all +.\" cases as published by the Free Software Foundation. .\" .\" -.TH Gluster 8 "Gluster command line tool" "9 September 2010" "Gluster Inc." +.TH Gluster 8 "Gluster command line utility" "07 March 2011" "Gluster Inc." .SH NAME -Gluster \- Gluster command line tool. +gluster - Gluster Console Manager (command line utility) .SH SYNOPSIS .B gluster .PP -To enter gluster prompt +To run the program and display gluster prompt: +.PP +.B gluster .PP (or) -.pp - +.PP +To specify a command directly: +.PP .B gluster .I [commands] [options] -.PP -Gluster is a command line tool for dynamic volume management for glusterfs. + .SH DESCRIPTION -Gluster command line tool is used for dynamic volume management. -The tool must be executed on any of the export servers. The cli gives an easy way to perform cloud operations such as volume create, volume expand, volume shrink, volume migrate, volume rebalance without the necessity of scheduling downtimes. +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. .SH COMMANDS -.PP -Mandatory or optional arguments to long options are also mandatory or optional -for any corresponding short options. -.SS "Basic commands" + +.SS "Volume Commands" .PP .TP \fB\ volume info [all|<VOLNAME>] \fR -list information of all volumes +Display information about all volumes, or the specified volume. .TP -\fB\ volume create <NEW-VOLNAME> [stripe <COUNT>] [replica <COUNT>] [transport <tcp|rdma>] <NEW-BRICK> ... \fR -create a new volume of specified type with mentioned bricks, with specified transport-type [default:tcp] +\fB\ volume create <NEW-VOLNAME> [stripe <COUNT>] [replica <COUNT>] [transport <tcp|rdma|tcp,rdma>] <NEW-BRICK> ... \fR +Create a new volume of the specified type using the specified bricks and transport type (the default transport type is tcp). +To create a volume with both transports (tcp and rdma), give 'transport tcp,rdma' as an option. .TP \fB\ volume delete <VOLNAME> \fR -delete volume specified by \fB\<VOLNAME>\fR +Delete the specified volume. .TP \fB\ volume start <VOLNAME> \fR -start volume specified by \fB\<VOLNAME>\fR +Start the specified volume. .TP \fB\ volume stop <VOLNAME> [force] \fR -stop volume specified by \fB\<VOLNAME>\fR +Stop the specified volume. .TP \fB\ volume rename <VOLNAME> <NEW-VOLNAME> \fR -rename volume \fB\<VOLNAME>\fR to \fB\<NEW-VOLNAME>\fR +Rename the specified volume. .TP -\fB\ volume add-brick <VOLNAME> [(replica <COUNT>)|(stripe <COUNT>)] <NEW-BRICK> ... \fR -add brick to volume \fB\<VOLNAME>\fR +\fB\ volume set <VOLNAME> <OPTION> <PARAMETER> [<OPTION> <PARAMETER>] ... \fR +Set the volume options. .TP -\fB\ volume remove-brick <VOLNAME> [(replica <COUNT>)|(stripe <COUNT>)] <BRICK> ... \fR -remove brick from volume \fB\<VOLNAME>\fR -.TP -\fB\ volume rebalance <VOLNAME> start \fR -start rebalance of volume \fB\<VOLNAME>\fR +\fB\ volume help \fR +Display help for the volume command. +.SS "Brick Commands" +.PP .TP -\fB\ volume rebalance <VOLNAME> stop \fR -stop rebalance of volume \fB\<VOLNAME>\fR +\fB\ volume add-brick <VOLNAME> <NEW-BRICK> ... \fR +Add the specified brick to the specified volume. .TP -\fB\ volume rebalance <VOLNAME> status \fR -rebalance status of volume \fB<VOLNAME>\fR +\fB\ volume remove-brick <VOLNAME> <BRICK> ... \fR +Remove the specified brick from the specified volume. +.IP +.B Note: +If you remove the brick, the data stored in that brick will not be available. You can migrate data from one brick to another using +.B replace-brick +option. .TP -\fB\ volume replace-brick <VOLNAME> (<BRICK> <NEW-BRICK>) start|pause|abort|status \fR -replace-brick operations +\fB\ volume rebalance-brick <VOLNAME>(<BRICK> <NEW-BRICK>) start \fR +Start rebalancing the specified volume. .TP -\fB\ volume set-transport <VOLNAME> <TRANSPORT-TYPE> [<TRANSPORT-TYPE>] ... \fR -set transport type for volume \fB\<VOLNAME>\fR +\fB\ volume rebalance <VOLNAME> stop \fR +Stop rebalancing the specified volume. .TP -\fB\ volume set-transport <VOLNAME> <TRANSPORT-TYPE> [<TRANSPORT-TYPE>] ... \fR -set transport type for volume \fB\<VOLNAME>\fR -\fR +\fB\ volume rebalance <VOLNAME> status \fR +Display the rebalance status of the specified volume. .TP -\fB\ volume help \fB -display help for the volume command +\fB\ volume replace-brick <VOLNAME> (<BRICK> <NEW-BRICK>) start|pause|abort|status|commit \fR +Replace the specified brick. +.SS "Log Commands" .TP -\fB\ volume log filename <VOLNAME> [BRICK] <PATH> \fB -set the log file for corresponding volume/brick +\fB\ volume log filename <VOLNAME> [BRICK] <DIRECTORY> \fB +Set the log directory for the corresponding volume/brick. .TP \fB\ volume log locate <VOLNAME> [BRICK] \fB -locate the log file for corresponding volume/brick +Locate the log file for corresponding volume/brick. .TP \fB\ volume log rotate <VOLNAME> [BRICK] \fB -rotate the log file for corresponding volume/brick +Rotate the log file for corresponding volume/brick. +.SS "Peer Commands" .TP \fB\ peer probe <HOSTNAME> \fR -probe peer specified by \fB\<HOSTNAME>\fR +Probe the specified peer. .TP \fB\ peer detach <HOSTNAME> \fR -detach peer specified by \fB\<HOSTNAME>\fR +Detach the specified peer. .TP \fB\ peer status \fR -list status of peers +Display the status of peers. .TP \fB\ peer help \fR -Help command for peer +Display help for the peer command. +.SS "Other Commands" .TP \fB\ help \fR -display command options +Display the command options. .TP \fB\ quit \fR -quit -.TP -.PP -.SH FILES -/etc/glusterd/* +Exit the gluster command line interface. +.SH FILES +/var/lib/glusterd/* .SH SEE ALSO .nf -\fBfusermount\fR(1), \fBmount.glusterfs\fR(8), \fBglusterfs-volgen\fR(8) -\fBglusterfs\fR(8), \fBglusterd\fR(8) +\fBfusermount\fR(1), \fBmount.glusterfs\fR(8), \fBglusterfs\fR(8), \fBglusterd\fR(8) \fR .fi .SH COPYRIGHT .nf -Copyright(c) 2006-2010 Gluster, Inc. <http://www.gluster.com> - -.fi +Copyright(c) 2006-2011 Gluster, Inc. <http://www.gluster.com> |