Bug 1365011

*** Bug 1365844 has been marked as a duplicate of this bug. ***

Hi Krutika,

I need a bit more information for this one.

- Planning to document this option in the table under "10.1. Configuring Volume Options" 
https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html-single/Administration_Guide/index.html#Configuring_Volume_Options

Let me know if this is fine.

- Please provide a brief description of the options. 

- Is there anything else you think customers should know about this option?

- Is there any usecase where a customer would NOT want this enabled?

- Is there any performance impact when these options are enabled? 

Thanks!

(In reply to Divya from comment #5)
> Hi Krutika,
> 
> I need a bit more information for this one.
> 
> - Planning to document this option in the table under "10.1. Configuring
> Volume Options" 
> https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html-
> single/Administration_Guide/index.html#Configuring_Volume_Options
> 
> Let me know if this is fine.
> 
> - Please provide a brief description of the options. 

The feature itself can be enabled and disabled respectively using the following two commands:

# gluster volume heal <VOLNAME> granular-entry-heal enable
# gluster volume heal <VOLNAME> granular-entry-heal disable

NOTE: The patch that adds this new CLI is still under review at http://review.gluster.org/#/c/15747/. If anything changes during the review, I'll post a comment here again to notify you of the change.

There are no other options wrt this feature except for the one above.

> 
> - Is there anything else you think customers should know about this option?

None.

> 
> - Is there any usecase where a customer would NOT want this enabled?

As far as RHGS 3.2.0 is concerned, this feature is only supported for HC/ROBO (Grafton) use-case.
> 
> - Is there any performance impact when these options are enabled? 

Enabling the option should help entry-self-heal on directories complete sooner, especially if the directory has lot of entries.

> 
> Thanks!

-Krutika

Thanks for your inputs Krutika!

I have drafted the content for this volume option based on your inputs and is available at: https://docs.google.com/document/d/1zwjwzzjucE0qXfHWqfIXa3RnVJ1D0_WpjVonUFvwnDU/edit#heading=h.9wgwad9hj5or

Could you please review and comment in the google doc if it is still technically accurate after the editing :)

Thanks,
Divya

Hi Divya,

 The draft looks good to me. I just wanted to know where it will be specified that the feature as of 3.2.0 will be supported for grafton/HC-ROBO use case as also the other details like the command to be used to turn the option on/off.

-Krutika

(In reply to Krutika Dhananjay from comment #8)
> Hi Divya,
> 
>  The draft looks good to me. 

Thanks for the confirmation

I just wanted to know where it will be
> specified that the feature as of 3.2.0 will be supported for grafton/HC-ROBO
> use case as also the other details like the command to be used to turn the
> option on/off.

This option will be added in the 3.2 Admin Guide in the table under "10.1. Configuring Volume Options" section.

Link to the 3.1.3 Admin guide for reference: https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html-single/Administration_Guide/index.html#Configuring_Volume_Options

Let me know if this option has to be documented in the grafton/HC-ROBO guide, I will raise another bug with the respective doc component.

> 
> -Krutika

(In reply to Divya from comment #9)
> (In reply to Krutika Dhananjay from comment #8)
> > Hi Divya,
> > 
> >  The draft looks good to me. 
> 
> Thanks for the confirmation
> 
> I just wanted to know where it will be
> > specified that the feature as of 3.2.0 will be supported for grafton/HC-ROBO
> > use case as also the other details like the command to be used to turn the
> > option on/off.
> 
> This option will be added in the 3.2 Admin Guide in the table under "10.1.
> Configuring Volume Options" section.
> 
> Link to the 3.1.3 Admin guide for reference:
> https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html-
> single/Administration_Guide/index.html#Configuring_Volume_Options
> 
> Let me know if this option has to be documented in the grafton/HC-ROBO
> guide, I will raise another bug with the respective doc component.
> 

Hi,

I just spoke to Sahina about it and she tells me there's an Operations Guide in Grafton where these will be captured. And Laura is working on that. So she could sync with you in the coming days.

So for now, there is no need to raise another bug I think.

-Krutika

> > 
> > -Krutika

Kruthika,

I have updated the documentation based on my discussion with Sas and as per comment 17.

Link to the doc: http://ccs-jenkins.gsslab.brq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.2-Administration_Guide-branch-master/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#Configuring_Volume_Options

Could you please verify if the changes are fine before moving the bug ON_QA?

Thanks!

It looks good for the most part except for the following line:

" If the volume is started, execute gluster volume heal VOLNAME granular-entry-heal enable / disable command to enable or disable granular-entry-heal option. "

Actually, if the volume is in any state other than "created" -- and that includes not just the "started" state but also the "stopped" state -- then the user has to use the `gluster volume heal ...` command as opposed to `gluster volume set ...` command.

(In reply to Krutika Dhananjay from comment #20)

Thanks, Krutika!

I have updated the documentation based on comment 20.

Link to the doc: http://ccs-jenkins.gsslab.brq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.2-Administration_Guide-branch-master/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html#Configuring_Volume_Options

Moving the bug ON_QA.

Verified based on the comment21

(In reply to SATHEESARAN from comment #22)
> Verified based on the comment21

Verified with the doc link provided in comment21

RHGS 3.2.0 GA completed on 23 March 2017