Bug 1145084

Summary:	[SNAPSHOT]: man or info page of gluster needs to be updated with snapshot commands
Product:	[Community] GlusterFS	Reporter:	Sachin Pandit <spandit>
Component:	glusterd	Assignee:	Sachin Pandit <spandit>
Status:	CLOSED CURRENTRELEASE	QA Contact:
Severity:	high	Docs Contact:
Priority:	high
Version:	3.6.0	CC:	bugs, gluster-bugs, nsathyan, rcyriac, rhinduja, spandit, ssamanta
Target Milestone:	---
Target Release:	---
Hardware:	x86_64
OS:	Linux
Whiteboard:	SNAPSHOT
Fixed In Version:	glusterfs-3.6.0beta2	Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:	1145069	Environment:
Last Closed:	2014-11-11 08:39:41 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1121603, 1122399, 1145069
Bug Blocks:

Description Sachin Pandit 2014-09-22 10:58:48 UTC

+++ This bug was initially created as a clone of Bug #1145069 +++

+++ This bug was initially created as a clone of Bug #1122399 +++

+++ This bug was initially created as a clone of Bug #1121603 +++

Description of problem:
=======================

Current man page is very outdated it doesn't have core self heal commands. With the new addition of snapshot command, please update the man page with snapshot commands, heal commands and any other commands which are left out.


Version-Release number of selected component (if applicable):
=============================================================

glusterfs-3.6.0.24-1.el6rhs.x86_64


How reproducible:
=================
1/1


Steps to Reproduce:
===================
1. man gluster

Actual results:
===============
It doesn't have any heal or snapshot related commands.


Expected results:
=================

man page of gluster should have information about gluster heal and snapshot commands

--- Additional comment from Sachin Pandit on 2014-07-23 03:20:23 EDT ---

I have renamed the bug, Because self-heal and snapshot are 2 different
components and its better to have 2 different bug raised for that.
Renaming this bug to make it more specific to snapshot commands.

--- Additional comment from Anand Avati on 2014-07-23 06:56:00 EDT ---

REVIEW: http://review.gluster.org/8357 (doc : man page for snapshot commands.) posted (#1) for review on master by Sachin Pandit (spandit)

--- Additional comment from Anand Avati on 2014-07-23 07:37:15 EDT ---

REVIEW: http://review.gluster.org/8357 (doc : man page for snapshot commands.) posted (#2) for review on master by Sachin Pandit (spandit)

--- Additional comment from Anand Avati on 2014-07-24 06:08:06 EDT ---

REVIEW: http://review.gluster.org/8357 (doc : man page for snapshot commands.) posted (#3) for review on master by Sachin Pandit (spandit)

--- Additional comment from Anand Avati on 2014-07-24 07:44:55 EDT ---

REVIEW: http://review.gluster.org/8357 (doc : man page for snapshot commands) posted (#4) for review on master by Sachin Pandit (spandit)

--- Additional comment from Anand Avati on 2014-07-25 02:46:19 EDT ---

COMMIT: http://review.gluster.org/8357 committed in master by Kaushal M (kaushal) 
------
commit fb730072c27c9ae1b99ff41dbff45e721017d543
Author: Sachin Pandit <spandit>
Date:   Wed Jul 23 08:24:19 2014 +0530

    doc : man page for snapshot commands
    
    This patch also contains few modifications in admin documentation.
    
    Change-Id: I7bc2a88e6cbcfe81dcfafc2956f5b7c5524b0f0b
    BUG: 1122399
    Signed-off-by: Sachin Pandit <spandit>
    Reviewed-on: http://review.gluster.org/8357
    Reviewed-by: Avra Sengupta <asengupt>
    Tested-by: Gluster Build System <jenkins.com>
    Reviewed-by: Kaushal M <kaushal>

Comment 1 Anand Avati 2014-09-22 11:33:53 UTC

REVIEW: http://review.gluster.org/8797 (doc : man page for snapshot commands) posted (#1) for review on release-3.6 by Sachin Pandit (spandit)

Comment 2 Anand Avati 2014-09-22 11:33:59 UTC

REVIEW: http://review.gluster.org/8799 (doc : man page and admin-guide for newly introduced snapshot delete option.) posted (#1) for review on release-3.6 by Sachin Pandit (spandit)

Comment 3 Anand Avati 2014-09-22 11:34:19 UTC

REVIEW: http://review.gluster.org/8805 (cli/snapshot : update of a snapshot delete syntax in documentation) posted (#1) for review on release-3.6 by Sachin Pandit (spandit)

Comment 4 Anand Avati 2014-09-22 11:52:06 UTC

REVIEW: http://review.gluster.org/8805 (cli/snapshot : update of a snapshot delete syntax in documentation.) posted (#2) for review on release-3.6 by Sachin Pandit (spandit)

Comment 5 Anand Avati 2014-09-22 11:52:19 UTC

REVIEW: http://review.gluster.org/8799 (doc : man page and admin-guide for newly introduced snapshot delete option) posted (#2) for review on release-3.6 by Sachin Pandit (spandit)

Comment 6 Anand Avati 2014-09-22 11:52:25 UTC

REVIEW: http://review.gluster.org/8797 (doc : man page for snapshot commands.) posted (#2) for review on release-3.6 by Sachin Pandit (spandit)

Comment 7 Anand Avati 2014-09-23 09:00:54 UTC

COMMIT: http://review.gluster.org/8797 committed in release-3.6 by Vijay Bellur (vbellur) 
------
commit cde7cf45c49a59a688788abc0358c482e30f4018
Author: Sachin Pandit <spandit>
Date:   Wed Jul 23 08:24:19 2014 +0530

    doc : man page for snapshot commands.
    
    This patch also contains few modifications in admin documentation.
    
    Change-Id: I7bc2a88e6cbcfe81dcfafc2956f5b7c5524b0f0b
    BUG: 1145084
    Signed-off-by: Sachin Pandit <spandit>
    Reviewed-on: http://review.gluster.org/8357
    Reviewed-by: Avra Sengupta <asengupt>
    Tested-by: Gluster Build System <jenkins.com>
    Reviewed-by: Kaushal M <kaushal>
    Signed-off-by: Sachin Pandit <spandit>
    Reviewed-on: http://review.gluster.org/8797
    Reviewed-by: Vijaikumar Mallikarjuna <vmallika>

Comment 8 Anand Avati 2014-09-23 09:01:20 UTC

COMMIT: http://review.gluster.org/8799 committed in release-3.6 by Vijay Bellur (vbellur) 
------
commit f7df69f61d22ed2b679cc91e1669a454d0c223d5
Author: Sachin Pandit <spandit>
Date:   Mon Jul 28 09:53:50 2014 +0530

    doc : man page and admin-guide for newly introduced snapshot delete option
    
    Change-Id: Iab5e7f63d673a2040e8d83ab7280121ff468836e
    BUG: 1145084
    Signed-off-by: Sachin Pandit <spandit>
    Reviewed-on: http://review.gluster.org/8378
    Reviewed-by: Atin Mukherjee <amukherj>
    Tested-by: Gluster Build System <jenkins.com>
    Reviewed-by: Kaushal M <kaushal>
    Signed-off-by: Sachin Pandit <spandit>
    Reviewed-on: http://review.gluster.org/8799
    Reviewed-by: Vijaikumar Mallikarjuna <vmallika>

Comment 9 Anand Avati 2014-09-23 10:13:44 UTC

COMMIT: http://review.gluster.org/8805 committed in release-3.6 by Vijay Bellur (vbellur) 
------
commit cd60de7b2fd8d40be83ee75773e703e6327c47db
Author: Sachin Pandit <spandit>
Date:   Mon Aug 25 09:46:14 2014 +0530

    cli/snapshot : update of a snapshot delete syntax in documentation.
    
    Change-Id: Id1a4b9684a8dd5750ee6eed841e3d5195407fb7e
    BUG: 1145084
    Signed-off-by: Sachin Pandit <spandit>
    Reviewed-on: http://review.gluster.org/8534
    Tested-by: Gluster Build System <jenkins.com>
    Reviewed-by: Kaushal M <kaushal>
    Signed-off-by: Sachin Pandit <spandit>
    Reviewed-on: http://review.gluster.org/8805
    Reviewed-by: Vijaikumar Mallikarjuna <vmallika>

Comment 10 Anand Avati 2014-09-24 06:38:06 UTC

REVIEW: http://review.gluster.org/8829 (doc/snapshot : admin guide updation.) posted (#1) for review on release-3.6 by Sachin Pandit (spandit)

Comment 11 Anand Avati 2014-09-24 10:48:48 UTC

COMMIT: http://review.gluster.org/8829 committed in release-3.6 by Vijay Bellur (vbellur) 
------
commit 3b4664d7aa8eda5011fedeaeaad3281c1b06a517
Author: Sachin Pandit <spandit>
Date:   Tue Sep 23 07:03:11 2014 +0530

    doc/snapshot : admin guide updation.
    
    Change-Id: I1980bc0984f941cd415fbc754495353f561155a8
    BUG: 1145084
    Signed-off-by: Sachin Pandit <spandit>
    Reviewed-on: http://review.gluster.org/8817
    Tested-by: Gluster Build System <jenkins.com>
    Reviewed-by: Vijay Bellur <vbellur>
    Signed-off-by: Sachin Pandit <spandit>
    Reviewed-on: http://review.gluster.org/8829

Comment 12 Niels de Vos 2014-09-25 08:27:26 UTC

A beta release for GlusterFS 3.6.0 has been released. Please verify if the release solves this bug report for you. In case the glusterfs-3.6.0beta2 release does not have a resolution for this issue, leave a comment in this bug and move the status to ASSIGNED. If this release fixes the problem for you, leave a note and change the status to VERIFIED.

Packages for several distributions should become available in the near future. Keep an eye on the Gluster Users mailinglist [2] and the update (possibly an "updates-testing" repository) infrastructure for your distribution.

[1] http://supercolony.gluster.org/pipermail/gluster-users/2014-September/018883.html
[2] http://supercolony.gluster.org/pipermail/gluster-users/

Comment 13 Niels de Vos 2014-09-25 08:27:53 UTC

A beta release for GlusterFS 3.6.0 has been released. Please verify if the release solves this bug report for you. In case the glusterfs-3.6.0beta2 release does not have a resolution for this issue, leave a comment in this bug and move the status to ASSIGNED. If this release fixes the problem for you, leave a note and change the status to VERIFIED.

Packages for several distributions should become available in the near future. Keep an eye on the Gluster Users mailinglist [2] and the update (possibly an "updates-testing" repository) infrastructure for your distribution.

[1] http://supercolony.gluster.org/pipermail/gluster-users/2014-September/018883.html
[2] http://supercolony.gluster.org/pipermail/gluster-users/

Comment 14 Niels de Vos 2014-09-25 08:28:07 UTC

A beta release for GlusterFS 3.6.0 has been released. Please verify if the release solves this bug report for you. In case the glusterfs-3.6.0beta2 release does not have a resolution for this issue, leave a comment in this bug and move the status to ASSIGNED. If this release fixes the problem for you, leave a note and change the status to VERIFIED.

Packages for several distributions should become available in the near future. Keep an eye on the Gluster Users mailinglist [2] and the update (possibly an "updates-testing" repository) infrastructure for your distribution.

[1] http://supercolony.gluster.org/pipermail/gluster-users/2014-September/018883.html
[2] http://supercolony.gluster.org/pipermail/gluster-users/

Comment 15 Niels de Vos 2014-09-25 08:28:13 UTC

A beta release for GlusterFS 3.6.0 has been released. Please verify if the release solves this bug report for you. In case the glusterfs-3.6.0beta2 release does not have a resolution for this issue, leave a comment in this bug and move the status to ASSIGNED. If this release fixes the problem for you, leave a note and change the status to VERIFIED.

Packages for several distributions should become available in the near future. Keep an eye on the Gluster Users mailinglist [2] and the update (possibly an "updates-testing" repository) infrastructure for your distribution.

[1] http://supercolony.gluster.org/pipermail/gluster-users/2014-September/018883.html
[2] http://supercolony.gluster.org/pipermail/gluster-users/

Comment 16 Niels de Vos 2014-11-11 08:39:41 UTC

This bug is getting closed because a release has been made available that should address the reported issue. In case the problem is still not fixed with glusterfs-3.6.1, please reopen this bug report.

glusterfs-3.6.1 has been announced [1], packages for several distributions should become available in the near future. Keep an eye on the Gluster Users mailinglist [2] and the update infrastructure for your distribution.

[1] http://supercolony.gluster.org/pipermail/gluster-users/2014-November/019410.html
[2] http://supercolony.gluster.org/mailman/listinfo/gluster-users