From f037fe9143706375bea140b61fd87d13e5b2b961 Mon Sep 17 00:00:00 2001 From: Amar Tumballi Date: Mon, 28 May 2012 19:32:14 +0530 Subject: documentation - Admin-Guide Updates Change-Id: I6e053b6a5f099fb7b1c228668949463c795b4fc7 Signed-off-by: Amar Tumballi Reviewed-on: http://review.gluster.com/3496 Tested-by: Gluster Build System Reviewed-by: Vijay Bellur --- doc/admin-guide/en-US/admin_commandref.xml | 68 +++++++++++++++--------------- 1 file changed, 35 insertions(+), 33 deletions(-) (limited to 'doc/admin-guide/en-US/admin_commandref.xml') diff --git a/doc/admin-guide/en-US/admin_commandref.xml b/doc/admin-guide/en-US/admin_commandref.xml index df4c78f4869..05196b77326 100644 --- a/doc/admin-guide/en-US/admin_commandref.xml +++ b/doc/admin-guide/en-US/admin_commandref.xml @@ -2,8 +2,7 @@ Command Reference - This section describes the available commands and includes the -following section: + This section describes the available commands and includes thefollowing section: @@ -36,10 +35,8 @@ 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. + The Gluster Console Manager is a command line utility for elastic volume management. 'gluster' command enables administrators to perform cloud +operations such as creating, expanding, shrinking, rebalancing, and migrating volumes without needing to schedule server downtime. COMMANDS @@ -66,7 +63,8 @@ needing to schedule server downtime. 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). + Creates a new volume of the specified type using the specified bricks and transport type (the default transport type is tcp). + NOTE: with 3.3.0 release, transport type 'rdma' and 'tcp,rdma' are not fully supported. volume delete VOLNAME @@ -80,10 +78,6 @@ needing to schedule server downtime. 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. @@ -94,16 +88,16 @@ needing to schedule server downtime. - volume add-brick VOLNAME NEW-BRICK ... - Adds the specified brick to the specified volume. + volume add-brick VOLNAME [replica N] [stripe N] NEW-BRICK1 ... + Adds the specified brick(s) to the given VOLUME. Using add-brick, users can increase the replica/stripe count of the volume, or increase the volume capacity by adding the brick(s) without changing volume type. - volume replace-brick VOLNAME (BRICK NEW-BRICK) start | pause | abort | status - Replaces the specified brick. + volume replace-brick VOLNAME (BRICK NEW-BRICK) [start | start force | abort | status | commit | commit force] + Used to replace BRICK with NEW-BRICK in a given VOLUME. After replace-brick is complete, the changes to get reflected in volume information, replace-brick 'commit' command is neccessary. - volume remove-brick VOLNAME [(replica COUNT)|(stripe COUNT)] BRICK ... - Removes the specified brick from the specified volume. + volume remove-brick VOLNAME [replica N] BRICK1 ... [start | stop | status | commit | force ] + Removes the specified brick(s) from the specified volume. 'remove-brick' command can be used to reduce the replica count of the volume when 'replica N' option is given. To ensure data migration from the removed brick to existing bricks, give 'start' sub-command at the end of the command. After the 'status' command says remove-brick operation is complete, user can 'commit' the changes to volume file. Using 'remove-brick' without 'start' option works similar to 'force' command, which makes the changes to volume configuration without migrating the data. @@ -112,7 +106,7 @@ needing to schedule server downtime. volume rebalance VOLNAME start - Starts rebalancing the specified volume. + Starts rebalancing of the data on specified volume. volume rebalance VOLNAME stop @@ -127,17 +121,32 @@ needing to schedule server downtime. 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. + + + + Debugging + + - volume log locate VOLNAME [BRICK] - Locates the log file for corresponding volume/brick. + volume top VOLNAME {[open|read|write|opendir|readdir [nfs]] |[read-perf|write-perf [nfs|{bs COUNT count COUNT}]]|[clear [nfs]]} [BRICK] [list-cnt COUNT] + Shows the operation details on the volume depending on the arguments given. + + + + volume profile VOLNAME {start|info|stop} [nfs] + Shows the file operation details on each bricks of the volume. + + + volume status [all | VOLNAME] [nfs|shd|BRICK] [detail|clients|mem|inode|fd|callpool] + Show details of activity, internal data of the processes (nfs/shd/BRICK) corresponding to one of the next argument given. If now argument is given, this command outputs bare minimum details of the current status (include PID of brick process etc) of volume's bricks. + + + statedump VOLNAME [nfs] [all|mem|iobuf|callpool|priv|fd|inode|history] + Command is used to take the statedump of the process, which is used captures most of the internal details. @@ -182,7 +191,6 @@ needing to schedule server downtime. volume geo-replication MASTER SLAVE config [options] - Configure geo-replication options between the hosts specified by MASTER and SLAVE. @@ -226,7 +234,6 @@ needing to schedule server downtime. 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. @@ -237,7 +244,6 @@ needing to schedule server downtime. help - Display the command options. @@ -251,10 +257,8 @@ needing to schedule server downtime. FILES - /etc/glusterd/* + /var/lib/glusterd/* - SEE ALSO - fusermount(1), mount.glusterfs(8), glusterfs-volgen(8), glusterfs(8), glusterd(8)
glusterd Daemon @@ -326,9 +330,7 @@ needing to schedule server downtime. FILES - /etc/glusterd/* + /var/lib/glusterd/* - SEE ALSO - fusermount(1), mount.glusterfs(8), glusterfs-volgen(8), glusterfs(8), gluster(8)
-- cgit