Bug 1613529

Summary: Description of Healing panel on Brick dashboard links to upstream gluster docs
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Martin Bukatovic <mbukatov>
Component: web-admin-tendrl-monitoring-integrationAssignee: Anmol Sachan <asachan>
Status: CLOSED ERRATA QA Contact: Elena Bondarenko <ebondare>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: rhgs-3.4CC: apaladug, asachan, ebondare, julim, mbukatov, nthomas, rhs-bugs, sankarshan
Target Milestone: ---Keywords: ZStream
Target Release: RHGS 3.4.z Batch Update 1   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: tendrl-monitoring-integration-1.6.3-13.el7rhgs Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-10-31 08:45:18 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:
Attachments:
Description Flags
screenshot 1: Description of Healing panel linking to upstream resources none

Description Martin Bukatovic 2018-08-07 18:39:55 UTC
Description of problem
======================

Description of Healing panel on Brick dashboard links to upstream gluster docs:

Version-Release number of selected component
============================================

tendrl-monitoring-integration-1.6.3-7.el7rhgs.noarch

How reproducible
================

100 %

Steps to Reproduce
==================

1. Instal RHGS WA using tendrl-ansible
2. Import Trusted storage pool with at least one volume
3. Go to Brick dashboard and check description of "Healing" panel
   there (available via little "i" icon on top left corner of the panel).

Actual results
==============

The description links to upstream gluster docs:

> The Healing panel displays healing information for a given brick based on
> healinfo. See https://gluster.readthedocs.io/en/latest/Troubleshooting/heal-info-and-split-brain-resolution/
> for how to troubleshoot healing and split brain issues

See screenshot #1.

Expected results
=================

The description links to downstream gluster docs.

Comment 1 Martin Bukatovic 2018-08-07 18:41:56 UTC
Created attachment 1474076 [details]
screenshot 1: Description of Healing panel linking to upstream resources

Comment 4 Anand Paladugu 2018-09-09 17:43:11 UTC
I would not suggest pointing to any upstream docs in RHGS.  Also the bug is asking for managing self heal,  and the suggested downstream doc is managing the split brain. They  are not necessarily same.

Comment 5 Nishanth Thomas 2018-09-10 08:42:03 UTC
The healing pannel tooltip is as follows:

> The Healing panel displays healing information for a given brick based on
> healinfo. See https://gluster.readthedocs.io/en/latest/Troubleshooting/heal-info-and-split-brain-resolution/
> for how to troubleshoot healing and split brain issues

Hence i think the proposed the ds link is relevant as per the baove context.

My suggestion is to remove this link itself from the tooltip.Else we have to change this with every release to point to the right doc link

Comment 6 Nishanth Thomas 2018-09-10 08:43:32 UTC
@martin, let me know if you are ok with the above suggestion; based on that I will provide the acks

Comment 7 Nishanth Thomas 2018-09-10 16:07:16 UTC
New description(As per the discussion with Ju and team on 10 Sept): The Healing panel displays healing information for a given brick based on Healinfo, i.e. statistics of entries pending heal, in split-brain and currently being healed.

Links will be removed from the description.

Comment 8 Martin Bukatovic 2018-09-11 08:41:53 UTC
(In reply to Nishanth Thomas from comment #6)
> @martin, let me know if you are ok with the above suggestion; based on that
> I will provide the acks

I agree with the removal of the link.

Comment 10 Anmol Sachan 2018-09-12 09:23:03 UTC
The updated description will be : The Healing panel displays healing information for a given brick based on Healinfo, i.e. statistics of entries pending heal and split-brain.

Comment 12 Elena Bondarenko 2018-09-25 11:54:28 UTC
The description of Healing panel is exactly the way it was described in Comment 10.

Comment 14 errata-xmlrpc 2018-10-31 08:45:18 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2018:3427