Bug 1389549

Summary: UX help button for iSCSI Multipathing broken
Product: Red Hat Enterprise Virtualization Manager Reporter: marc skinner <mskinner>
Component: ovirt-engineAssignee: Greg Sheremeta <gshereme>
Status: CLOSED CURRENTRELEASE QA Contact: Lucie Leistnerova <lleistne>
Severity: medium Docs Contact:
Priority: medium    
Version: 4.0.3CC: gklein, lbopf, lleistne, lsurette, lsvaty, mgoldboi, oourfali, pstehlik, rbalakri, Rhev-m-bugs, srevivo, thildred, trichard, ykaul
Target Milestone: ovirt-4.1.1-1Keywords: ZStream
Target Release: ---   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
: 1411072 (view as bug list) Environment:
Last Closed: 2017-04-23 14:57:47 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: UX RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1411072    
Attachments:
Description Flags
picture of help button none

Description marc skinner 2016-10-27 20:56:19 UTC
Created attachment 1214751 [details]
picture of help button

When you click on DATACENTER tab ... then click on iSCSI Multipathing tab

Click ADD ...

Then click the help button - the ? (question mark) on the title bar.

It should open a new window with the RHEV documentation.  It does not.

Running Firefox 49.0 on FC23.

Other ? (question marks) in the product work on my desktop - so I think only this one is broken.

Thanks!

Comment 1 Greg Sheremeta 2016-10-27 21:01:13 UTC
Thanks for reporting.

@Lucy or Tahlia, what URL should I use for this?

Comment 2 Tahlia Richardson 2016-10-27 23:51:54 UTC
The anchor for this section (in html-single) is administration-guide/#Configuring_iSCSI_Multipathing

The closest the multi-page HTML gets is administration-guide/85-preparing-and-adding-block-storage 

I'm not certain how the mapping works now in 4.0, given the change in links and layout with the new publication system, but one of these should work. 

Leaving needinfo on Lucy in case she knows more.

Comment 3 Lucy Bopf 2016-10-28 00:43:43 UTC
As I understand it, although the link format has entirely changed for the Customer Portal documentation, it remains the same for the documentation packaged with the product itself.

The most recent mapping file for the Administration Portal lists the anchor for this section as:

; Data Center main tab -> iSCSI Bonds sub-tab -> New
new_iscsi_bundle=Administration_Guide/sect-Preparing_and_Adding_Block_Storage.html#Configuring_iSCSI_Multipathing

I don't have a setup with iSCSI on which to test this particular help item, but on version 4.0.5.1-0.1.el7ev of the RHV Manager, I can confirm that the anchor above matches the link in the html version of the Administration Guide available on the login page:

https://example-rhevm/ovirt-engine/docs/manual/en_US/html/Administration_Guide/sect-Preparing_and_Adding_Block_Storage.html#Configuring_iSCSI_Multipathing

Comment 4 Greg Sheremeta 2016-10-28 04:27:39 UTC
Lucy is right with the format.

Thanks for the link clarification. I'll figure out why it's failing.

Comment 5 marc skinner 2016-10-31 13:47:04 UTC
iSCSI shouldn't have to be enabled for the help link/button to work.  It should just work, as customers will/should be able to read about the feature and how to set it up.

Comment 6 Greg Sheremeta 2016-10-31 13:51:18 UTC
(In reply to marc skinner from comment #5)
> iSCSI shouldn't have to be enabled for the help link/button to work.  It
> should just work, as customers will/should be able to read about the feature
> and how to set it up.

Correct -- she was simply referring to the fact that she couldn't navigate to the correct screen to test it for me :)

Comment 7 Greg Sheremeta 2016-11-28 02:50:02 UTC
moving to POST. Lastest build of rhevm-doc should fix this, but I need help testing it.

Comment 8 Greg Sheremeta 2016-12-28 22:51:32 UTC
Correction on Comment 7 -- this is an engine bug. Fixed in https://gerrit.ovirt.org/#/c/69272

Comment 12 Pavel Stehlik 2017-02-06 14:21:44 UTC
QE - DOC is not provided in beta, so this BZ will be checked for GA.

Comment 13 Greg Sheremeta 2017-04-01 19:30:07 UTC
Works for me on this week's build.

Comment 14 Lucie Leistnerova 2017-04-03 12:41:44 UTC
'?' opens documentation on 8.5.2. Configuring iSCSI Multipathing

verified in ovirt-engine-4.1.1.7-0.1.el7.noarch