summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/admin-guide/en-US/markdown/admin_managing_snapshots.md133
1 files changed, 119 insertions, 14 deletions
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 \<vol-name\> \[-n \<snap-name\>\] \[-d \<description\>\]*
+Syntax :
+*gluster snapshot create <snapname\> <volname\(s\)\> \[description <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 \<vol-name\> \<snap-name\>*
+Syntax :
+*gluster snapshot restore <snapname\>*
-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 \<volname\>\ -s \<snap-name\> \[force\]*
+Syntax :
+*gluster snapshot delete <snapname\>*
+Details :
This command will delete the specified snapshot.
+--------------------------------------------------------------------------
+
**Listing of available snaps**
-*gluster snapshot list \[\<volname\> \[-s \<snap-name>\]\]*
+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 <volname\>\)\]*
+
+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 <volname\>\)\]*
-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 \[\<vol-name | all\>\]*
+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 <count\>\] \[snap-max-soft-limit <percent>\]\)
+ | \(\[auto-delete <enable|disable\>\]\)*
+
+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 <snapname\>*
-*gluster snapshot config \<vol-name | all\> \[\<snap-max-hard-limit\> \<count\>\] \[\<snap-max-soft-limit\> \<percentage\>\]*
+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 <snapname\>*
+Details:
+This command will de-activate the mentioned snapshot.
+-------------------------------------------------------------------------