Bug 1371615 - [Doc RFE] Add a new 'Troubleshooting' section to the Deployment Guide
Summary: [Doc RFE] Add a new 'Troubleshooting' section to the Deployment Guide
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat
Component: doc-Container_Native_Storage_with_OpenShift
Version: cns-1.0
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: ---
: CNS 3.4
Assignee: Divya
QA Contact: krishnaram Karthick
URL:
Whiteboard:
: 1386684 (view as bug list)
Depends On:
Blocks: 1385252
TreeView+ depends on / blocked
 
Reported: 2016-08-30 15:51 UTC by Anjana Suparna Sriram
Modified: 2017-01-23 07:23 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: Enhancement
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-01-23 07:23:04 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Anjana Suparna Sriram 2016-08-30 15:51:58 UTC
Document URL: 

Section Number and Name: 

Describe the issue: 

Suggestions for improvement: 

Additional information:

Comment 4 Anjana Suparna Sriram 2016-10-21 06:57:41 UTC
*** Bug 1386684 has been marked as a duplicate of this bug. ***

Comment 5 Divya 2016-10-21 07:25:05 UTC
Raghavendra,

I see the current content (https://github.com/heketi/heketi/wiki/Troubleshooting-Guide) a is WIP. Could you please add all the troubleshooting information by 26-Oct?

Thanks,
Divya

Comment 6 Raghavendra Talur 2016-10-27 05:19:39 UTC
It is taking more time than expected to reproduce the scenarios that I have collected from previous bugs. It is essential to reproduce the scenarios to be able to give a valid solution as part of troubleshoot guide. I would need more time on this before I could hand it off to Doc team.

Comment 8 Divya 2016-11-14 09:06:24 UTC
Raghavendra,

I have edited the troubleshooting content and is available at:https://docs.google.com/document/d/1Co8ROwNF9TjYNeafvZkeF9AcINOjVWnIyYkMpqOhjyI/edit#heading=h.z3897ittjg3i

Please review and share your feedback on the google doc.

Comment 9 Raghavendra Talur 2016-11-18 06:13:15 UTC
Divya,

I have few comments on the doc, everything else looks good to me.

Comment 10 Divya 2016-11-18 09:10:18 UTC
(In reply to Raghavendra Talur from comment #9)
> Divya,
> 
> I have few comments on the doc, everything else looks good to me.

I have incorporated the comments suggested by you. I moved the content to the CNS guide. Link to the doc: https://doc-stage.usersys.redhat.com/documentation/en/red-hat-gluster-storage/3.1/single/container-native-storage-for-openshift-container-platform/#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Troubleshooting

Comment 12 krishnaram Karthick 2017-01-05 05:28:59 UTC
1) There is a change in minimum volume size with CNS 3.4. Following content has to be updated to reflect the new changes

 Creating volumes smaller than 4 GB fails with error
If you create volumes smaller than 4GB, it fails with Requested volume size (3 GB) is smaller than the minimum supported volume size (4194304) error. This is due to the limits set in Heketi in /etc/heketi/heketi.json file. You must note that the minimum volume size is function of minimum brick size and hence differs for different durability type volumes. 

2) Can we also add a note about curl http://deploy-heketi-storage-project.cloudapps.mystorage.com/hello & curl http://storage-project.cloudapps.mystorage.com/hello failing? 

Troubleshooting step would be to try and ping the ip directly

Divya, please discuss with Raghavendra Talur to get more detail about these two comments.

Comment 13 Raghavendra Talur 2017-01-05 08:17:42 UTC
(In reply to krishnaram Karthick from comment #12)
> 1) There is a change in minimum volume size with CNS 3.4. Following content
> has to be updated to reflect the new changes
> 
>  Creating volumes smaller than 4 GB fails with error
> If you create volumes smaller than 4GB, it fails with Requested volume size
> (3 GB) is smaller than the minimum supported volume size (4194304) error.
> This is due to the limits set in Heketi in /etc/heketi/heketi.json file. You
> must note that the minimum volume size is function of minimum brick size and
> hence differs for different durability type volumes. 

This is right. We should do away with this note in troubleshoot guide. Please remove this bullet as it is no longer valid.

> 
> 2) Can we also add a note about curl
> http://deploy-heketi-storage-project.cloudapps.mystorage.com/hello & curl
> http://storage-project.cloudapps.mystorage.com/hello failing? 
> 
> Troubleshooting step would be to try and ping the ip directly

This makes sense. I have added this point as a separate bullet in google doc. Please pick it from there.

> 
> Divya, please discuss with Raghavendra Talur to get more detail about these
> two comments.

Comment 14 Divya 2017-01-06 07:08:36 UTC
(In reply to Raghavendra Talur from comment #13)

> > 
> > 2) Can we also add a note about curl
> > http://deploy-heketi-storage-project.cloudapps.mystorage.com/hello & curl
> > http://storage-project.cloudapps.mystorage.com/hello failing? 
> > 
> > Troubleshooting step would be to try and ping the ip directly
> 
> This makes sense. I have added this point as a separate bullet in google
> doc. Please pick it from there.

Raghavendra,

I have edited the bullet point in the google doc [1]. Could you please review and confirm if it is technically correct?

Thanks!

[1] https://docs.google.com/document/d/1Co8ROwNF9TjYNeafvZkeF9AcINOjVWnIyYkMpqOhjyI/edit#heading=h.b1r3z1cocc5f

Comment 15 Raghavendra Talur 2017-01-06 09:06:03 UTC
Yes, it is technically correct.

Comment 17 krishnaram Karthick 2017-01-06 11:59:25 UTC
requested changes are made, moving the bug to verified.


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