summaryrefslogtreecommitdiffstats
path: root/doc/gluster.8
diff options
context:
space:
mode:
authorshishir gowda <shishirng@gluster.com>2010-09-07 04:29:34 +0000
committerVijay Bellur <vijay@dev.gluster.com>2010-09-07 07:45:58 -0700
commit95bafb5ad41458fbb16c680af94c2841c49c5322 (patch)
treee02eab3aea5bab89b12a9d945ed3d221eab0fa39 /doc/gluster.8
parent09f9bd0bdc3d0f055f83ef1fc76be065cb26b26d (diff)
Man page updates
Signed-off-by: shishir gowda <shishirng@gluster.com> Signed-off-by: Vijay Bellur <vijay@dev.gluster.com> BUG: 1529 (need man pages for 'gluster' and 'glusterd') URL: http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=1529
Diffstat (limited to 'doc/gluster.8')
-rw-r--r--doc/gluster.8112
1 files changed, 91 insertions, 21 deletions
diff --git a/doc/gluster.8 b/doc/gluster.8
index 5354dcda9..c7e476e97 100644
--- a/doc/gluster.8
+++ b/doc/gluster.8
@@ -1,29 +1,29 @@
-.\" Copyright (c) 2008-2010 Gluster, Inc. <http://www.gluster.com>
+.\"
+.\" Copyright (c) 2006-2009 Gluster, Inc. <http://www.gluster.com>
.\" This file is part of GlusterFS.
.\"
-.\" GlusterFS is free software; you can redistribute it and/or modify
-.\" it under the terms of the GNU General Public License as published
+.\" 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
-.\" General Public License for more details.
+.\" Affero General Public License for more details.
.\"
-.\" You should have received a copy of the GNU General Public License
-.\" long with this program. If not, see
+.\" 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/>.
.\"
.\"
-.\"
.TH Gluster 8 "Gluster command line tool" "9 September 2010" "Gluster Inc."
.SH NAME
Gluster \- Gluster command line tool.
-.SH SYNOPSYS
+.SH SYNOPSIS
.B gluster
.PP
-To enter gluster cli
+To enter gluster prompt
.PP
(or)
.pp
@@ -34,11 +34,7 @@ To enter gluster cli
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.
-Only one instance of tool execution is permitted at a time.
-Parallel invocations will return an error to the second and further instances,
-with a description of where the first instance is running and what operation it is performing.
-
+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.
.SH COMMANDS
.PP
Mandatory or optional arguments to long options are also mandatory or optional
@@ -47,17 +43,91 @@ for any corresponding short options.
.PP
.TP
-\fB\ help \fR
-Help
+\fB\ volume info [all|<VOLNAME>] \fR
+list information of all volumes
+.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
+.TP
+\fB\ volume delete <VOLNAME> \fR
+delete volume specified by \fB\<VOLNAME>\fR
+.TP
+\fB\ volume start <VOLNAME> \fR
+start volume specified by \fB\<VOLNAME>\fR
+.TP
+\fB\ volume stop <VOLNAME> [force] \fR
+stop volume specified by \fB\<VOLNAME>\fR
+.TP
+\fB\ volume rename <VOLNAME> <NEW-VOLNAME> \fR
+rename volume \fB\<VOLNAME>\fR to \fB\<NEW-VOLNAME>\fR
+.TP
+\fB\ volume add-brick <VOLNAME> [(replica <COUNT>)|(stripe <COUNT>)] <NEW-BRICK> ... \fR
+add brick to volume \fB\<VOLNAME>\fR
+.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
+.TP
+\fB\ volume rebalance <VOLNAME> stop \fR
+stop rebalance of volume \fB\<VOLNAME>\fR
+.TP
+\fB\ volume rebalance <VOLNAME> status \fR
+rebalance status of volume \fB<VOLNAME>\fR
.TP
-\fB\ peer <options> \fR
-Command for peer management
+\fB\ volume replace-brick <VOLNAME> (<BRICK> <NEW-BRICK>) start|pause|abort|status \fR
+replace-brick operations
.TP
-\fB\ volume <options> \fR
-Command for volume management
+\fB\ volume set-transport <VOLNAME> <TRANSPORT-TYPE> [<TRANSPORT-TYPE>] ... \fR
+set transport type for volume \fB\<VOLNAME>\fR
+.TP
+\fB\ volume set-transport <VOLNAME> <TRANSPORT-TYPE> [<TRANSPORT-TYPE>] ... \fR
+set transport type for volume \fB\<VOLNAME>\fR
+\fR
+.TP
+\fB\ volume help \fB
+display help for the volume command
+.TP
+\fB\ volume log filename <VOLNAME> [BRICK] <PATH> \fB
+set the log file for corresponding volume/brick
+.TP
+\fB\ volume log locate <VOLNAME> [BRICK] \fB
+locate the log file for corresponding volume/brick
+.TP
+\fB\ volume log rotate <VOLNAME> [BRICK] \fB
+rotate the log file for corresponding volume/brick
+.TP
+\fB\ peer probe <HOSTNAME> \fR
+probe peer specified by \fB\<HOSTNAME>\fR
+.TP
+\fB\ peer detach <HOSTNAME> \fR
+detach peer specified by \fB\<HOSTNAME>\fR
+.TP
+\fB\ peer status \fR
+list status of peers
+.TP
+\fB\ peer help \fR
+Help command for peer
+.TP
+\fB\ help \fR
+display command options
.TP
\fB\ quit \fR
-Exit from cli.
+quit
.TP
+.PP
+.SH FILES
+/etc/glusterd/*
+
+.SH SEE ALSO
+.nf
+\fBfusermount\fR(1), \fBmount.glusterfs\fR(8), \fBglusterfs-volgen\fR(8)
+\fBglusterfs\fR(8), \fBglusterd\fR(8)
+\fR
+.fi
+.SH COPYRIGHT
+.nf
+Copyright(c) 2006-2010 Gluster, Inc. <http://www.gluster.com>
.fi