Bug 1679862 - Document steps for HEKETI_ZONE_CHECKING RFE
Summary: Document steps for HEKETI_ZONE_CHECKING RFE
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Container_Native_Storage_with_OpenShift
Version: ocs-3.11
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: ---
: OCS 3.11.z Batch Update 2
Assignee: Chandrakanth Pai
QA Contact: Rachael
URL:
Whiteboard:
Depends On: 1635204
Blocks: 1672844
TreeView+ depends on / blocked
 
Reported: 2019-02-22 05:03 UTC by Rachael
Modified: 2019-04-01 06:08 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-04-01 06:08:34 UTC
Embargoed:


Attachments (Terms of Use)
PDF version of the OCS 3.11 Deployment Guide (10.51 MB, application/pdf)
2019-03-21 05:16 UTC, Chandrakanth Pai
no flags Details
PDF version of the OCS 3.11 Deployment Guide (10.43 MB, application/pdf)
2019-03-22 04:51 UTC, Chandrakanth Pai
no flags Details
PDF version of the OCS 3.11 Deployment Guide (10.49 MB, application/pdf)
2019-03-22 11:33 UTC, Chandrakanth Pai
no flags Details
PDF version of the OCS 3.11 Deployment Guide (10.49 MB, application/pdf)
2019-03-23 00:39 UTC, Chandrakanth Pai
no flags Details
PDF version of the OCS 3.11 Deployment Guide (10.49 MB, application/pdf)
2019-03-24 22:31 UTC, Chandrakanth Pai
no flags Details

Comment 5 RamaKasturi 2019-03-05 10:52:42 UTC
Hello John,

   Can we also mention about what is the recommended way for customers or users to set this option ? I see that is missing in the above comment.

Thanks
kasturi

Comment 7 RamaKasturi 2019-03-05 17:40:10 UTC
sorry if i was not clear the way i asked the question.

I was expecting us to add a line in the document saying "though there are two ways of enabling this feautre at 3.11.2, recommended way of doing would be via storage class options" . I was looking for the above statement as well in the doc inputs you provided.

Hope i am clear now.

Comment 8 John Mulligan 2019-03-08 19:39:46 UTC
(In reply to RamaKasturi from comment #7)
> sorry if i was not clear the way i asked the question.
> 
> I was expecting us to add a line in the document saying "though there are
> two ways of enabling this feautre at 3.11.2, recommended way of doing would
> be via storage class options" . I was looking for the above statement as
> well in the doc inputs you provided.
> 
> Hope i am clear now.

Sure. That sounds OK to me. I'm still not 100% on documenting the latter but I'm not dead set against it.

Comment 11 Chandrakanth Pai 2019-03-19 10:49:47 UTC
Hi John,

The changes suggested by Rachael involve adding the glusterfs_zone variable in the examples shown for the glusterfs and glusterfs_registry section in the inventory file (Chapters 4 and 5 of the Deployment Guide). I have made this change as per Rachael's inputs in the bug.

She has also requested to add a separate note/section on how to use the heketi zone checking feature and any pre-requisites required for the same.
As per my understanding, you have suggested not to document all the ways to configure the storageclass. Kasturi suggested adding a line "There are two ways of enabling this feature at 3.11.2, recommended way of doing would be via storage class options" and you have disagreed with the latter part of her suggestion.

Therefore, could you please let me know your thoughts.
It would be helpful if you can provide your inputs at the earliest as I need to address this bug by today as we are nearing the GA. 

Thanks,
Chandrakanth

Comment 12 John Mulligan 2019-03-19 14:11:53 UTC
(In reply to Chandrakanth Pai from comment #11)
> Hi John,
> 
> The changes suggested by Rachael involve adding the glusterfs_zone variable
> in the examples shown for the glusterfs and glusterfs_registry section in
> the inventory file (Chapters 4 and 5 of the Deployment Guide). I have made
> this change as per Rachael's inputs in the bug.

Sounds good.

> 
> She has also requested to add a separate note/section on how to use the
> heketi zone checking feature and any pre-requisites required for the same.
> As per my understanding, you have suggested not to document all the ways to
> configure the storageclass. Kasturi suggested adding a line "There are two
> ways of enabling this feature at 3.11.2, recommended way of doing would be
> via storage class options" and you have disagreed with the latter part of
> her suggestion.
> 
> Therefore, could you please let me know your thoughts.
> It would be helpful if you can provide your inputs at the earliest as I need
> to address this bug by today as we are nearing the GA. 
> 

Sorry if I was unclear. I _do_ want to document the method of enabling strict zone checking using the storage class. I _do not_ want to document enabling strict zone checking using the ZONE_CHECKING environment variable at this time.

Please let me know if this response is sufficient to answer your questions or you need more details.

Comment 16 Chandrakanth Pai 2019-03-21 05:16:54 UTC
Created attachment 1546307 [details]
PDF version of the OCS 3.11 Deployment Guide

Comment 19 Chandrakanth Pai 2019-03-22 04:51:20 UTC
Created attachment 1546761 [details]
PDF version of the OCS 3.11 Deployment Guide

Comment 23 Chandrakanth Pai 2019-03-22 11:33:06 UTC
Created attachment 1546826 [details]
PDF version of the OCS 3.11 Deployment Guide

Comment 27 Chandrakanth Pai 2019-03-23 00:39:50 UTC
Created attachment 1547176 [details]
PDF version of the OCS 3.11 Deployment Guide

Comment 28 Chandrakanth Pai 2019-03-24 22:31:51 UTC
Created attachment 1547532 [details]
PDF version of the OCS 3.11 Deployment Guide


Note You need to log in before you can comment on or make changes to this bug.