From 2783fbed2a6a8481eadbab8ca5ad03513f7f54f4 Mon Sep 17 00:00:00 2001 From: Sachin Pandit Date: Fri, 13 Jun 2014 08:55:31 +0530 Subject: docs : Admin document updation for snapshot commands. Change-Id: I8460e7feed7e1b0cf37e735852f5c269adfadd77 BUG: 1061685 Signed-off-by: Sachin Pandit Reviewed-on: http://review.gluster.org/8060 Reviewed-by: Rajesh Joseph Tested-by: Gluster Build System Reviewed-by: Vijay Bellur --- .../en-US/markdown/admin_managing_snapshots.md | 133 ++++++++++++++++++--- 1 file changed, 119 insertions(+), 14 deletions(-) (limited to 'doc/admin-guide/en-US') diff --git a/doc/admin-guide/en-US/markdown/admin_managing_snapshots.md b/doc/admin-guide/en-US/markdown/admin_managing_snapshots.md index e76ee9151dd..4ae6e4e062b 100644 --- a/doc/admin-guide/en-US/markdown/admin_managing_snapshots.md +++ b/doc/admin-guide/en-US/markdown/admin_managing_snapshots.md @@ -22,45 +22,150 @@ Snapshot Management **Snapshot creation** -*gluster snapshot create \ \[-n \\] \[-d \\]* +Syntax : +*gluster snapshot create \[description \] \[force\]* -This command will create a snapshot of a GlusterFS volume. User can provide a snap-name and a description to identify the snap. The description cannot be more than 1024 characters. +Details : +This command will create a snapshot of a GlusterFS volume. +User can provide a snap-name and a description to identify the snap. +The description cannot be more than 1024 characters. -Volume should be present and it should be in started state. +To be able to take a snapshot, Volume should be present and it should be +in started state. + +----------------------------------------------------------------------------- **Restoring snaps** -*gluster snapshot restore -v \ \* +Syntax : +*gluster snapshot restore * -This command restores an already taken snapshot of a GlusterFS volume. Snapshot restore is an offline activity therefore if the volume is online then the restore operation will fail. +Details : +This command restores an already taken snapshot of a GlusterFS volume. +Snapshot restore is an offline activity therefore if the volume is +online (in started state) then the restore operation will fail. Once the snapshot is restored it will be deleted from the list of snapshot. +--------------------------------------------------------------------------- + **Deleting snaps** -*gluster snapshot delete \\ -s \ \[force\]* +Syntax : +*gluster snapshot delete * +Details : This command will delete the specified snapshot. +-------------------------------------------------------------------------- + **Listing of available snaps** -*gluster snapshot list \[\ \[-s \\]\]* +Syntax: +*gluster snapshot list \[volname\]* + +Details: +This command is used to list all snapshots taken, or for a specified volume. +If Volname is given, then the snaps belonging to that particular volume +is displayed. + +------------------------------------------------------------------------- + +**Information of available snaps** + +Syntax: +*gluster snapshot info \[\(snapname | volume \)\]* + +Details: +This command gives out the information such as snapshot name, snapshot UUID, +time at which snapshot was created, and it lists down the snap-volume-name, +Number of snaps taken for a particular volume, number of snaps available +for that particular volume, and the state of snapshot. + +------------------------------------------------------------------------ + +**Status of snapshots** + +Syntax: +*gluster snapshot status \[\(snapname | volume \)\]* -This command is used to list all snapshots taken, or for a specified volume. If snap-name is provided then it will list the details of that snap. +Details: +This command will give a detailed information about the snapshot. +The details included in this will be Brick-patch of the snapshot bricks, +Volume Group(LVM details) to which the taken snapshot belong to, Status +of the snapshot bricks (whether its running or not), PID of the bricks, +Data percentage filled for that partiuclar Volume Group to which the +snapshots belong to, And total size of the Logical volume to which +the snapshots belong to. +If snapname is specified then details of the mentioned snapshot is displayed. +If Volume name is specified then details of all the snaps belonging to +the mentioned volume name is displayed. +If both snapname and volume name is not specified then details of all +the snaps present will be displayed. + +------------------------------------------------------------------------ **Configuring the snapshot behavior** -*gluster snapshot config \[\\]* +Syntax: +*gluster snapshot config \[volname\]* + +Details: +This command will display existing config values for a volume. If volume name +is not provided then config values of all the volume is displayed. +System config is displayed irrespective of volume name. + + +Syntax: +*snapshot config \[volname\] \(\[snap-max-hard-limit \] \[snap-max-soft-limit \]\) + | \(\[auto-delete \]\)* + +Details: +The above command can be used to change the existing config values. +If volname is provided then config value of that volume is changed, +else it will set/change the system limit. + +As of now, snap-max-soft-limit and auto-delete cannot be configured to +individually volume. soft-limit and auto-delete is only applicable +globally. Once that is set, all the volumes will inherit the global +value. + +The system limit is the default value of the config for all the volume. +Volume specific limit cannot cross the system limit. +If a volume specific limit is not provided then system limit will be +considered. + +When auto-delete feature is enabled, then as soon as the soft-limit +is reached the oldest snapshot is deleted for every successful snapshot +creation, With this it is ensured that number of snapshot created is +not more than snap-max-hard-limit. + +When auto-delete feature is disabled, If the the soft-limit is +reached then user is given a warning about exceeding soft-limit +along with successful snapshot creation message (oldest snapshot is +not deleted). And upon reaching hard-limit further snapshot creation +is not allowed. + +------------------------------------------------------------------------- + +**Activating a snapshot** -This command will display existing config values for a volume. If volume name is not provided then config values of all the volume is displayed. System config is displayed irrespective of volume name. +Syntax: +*gluster snapshot activate * -*gluster snapshot config \ \[\ \\] \[\ \\]* +Details: +This command will activate the mentioned snapshot. -The above command can be used to change the existing config values. If vol-name is provided then config value of that volume is changed, else it will set/change the system limit. +Note : By default the snapshot is activated during snapshot creation. -The system limit is the default value of the config for all the volume. Volume specific limit cannot cross the system limit. If a volume specific limit is not provided then system limit will be considered. +------------------------------------------------------------------------- -If any of this limit is decreased and the current snap count of the system/volume is more than the limit then the command will fail. If user still want to decrease the limit then force option should be used. +**Deactivate a snapshot** +Syntax: +*gluster snapshot deactivate * +Details: +This command will de-activate the mentioned snapshot. +------------------------------------------------------------------------- -- cgit