Bug 1498293 - Adding a RHEV provider IP does not clearly state what IP/Hostname to add
Summary: Adding a RHEV provider IP does not clearly state what IP/Hostname to add
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat CloudForms Management Engine
Classification: Red Hat
Component: Documentation
Version: 5.8.0
Hardware: All
OS: Linux
medium
medium
Target Milestone: GA
: 5.9.2
Assignee: Dayle Parker
QA Contact: Suyog Sainkar
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2017-10-03 21:13 UTC by Gilbert Kimetto
Modified: 2018-03-29 08:05 UTC (History)
13 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2018-03-29 08:05:35 UTC
Category: ---
Cloudforms Team: RHEVM
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)
Add_IP_Address (43.55 KB, image/png)
2017-10-03 21:13 UTC, Gilbert Kimetto
no flags Details


Links
System ID Private Priority Status Summary Last Updated
Red Hat Bugzilla 1498290 0 unspecified CLOSED Adding a RHEV provider IP does not clearly state what IP/Hostname to add 2021-02-22 00:41:40 UTC

Internal Links: 1498290

Description Gilbert Kimetto 2017-10-03 21:13:01 UTC
Description of problem:

The IP address to add is not clear when adding a RHEV provider.

Under Compute -> Infrastructure -> Provider
 When you Click Configuration to add a provider the label says to add an IP.
 What it actually expects is the MSA Hosted Engine IP address and credentials 

Version-Release number of selected component (if applicable):


How reproducible:


Steps to Reproduce:
1.) Under Compute -> Infrastructure -> Provider
2.) When you Click Configuration to add a provider the label says to add an IP.
3.) What it actually expects is the MSA Hosted Engine IP address and credentials 
Actual results:


Expected results:

Should say add the Hosted Engine/MSA IP address

Additional info:

Comment 2 Gilbert Kimetto 2017-10-03 21:13:50 UTC
Created attachment 1333941 [details]
Add_IP_Address

Comment 3 Gilbert Kimetto 2017-10-03 21:25:05 UTC
Needs a doc update as well for "Managing Providers" 


URL:

https://access.redhat.com/documentation/en-us/red_hat_cloudforms/4.5/html/managing_providers/infrastructure_providers#red_hat_virtualization_providers

1.2.2. Adding a Red Hat Virtualization Provider

Comment 4 Andrew Dahms 2018-03-20 01:05:37 UTC
Assigning to Dayle for review.

Comment 7 Dayle Parker 2018-03-28 01:19:42 UTC
Created attachment 1413940 [details]
Revised procedure for adding a RHV provider

Attached is a screenshot of the procedure with extra clarification.

Comment 8 Dayle Parker 2018-03-28 01:29:46 UTC
I've had a chat with Tahlia Richardson (long-time technical writer for the RHV docs team, CCed) about the terminology and how to make this more clear. 

"MSA Hosted Engine" is not a common term, and doesn't exist in the RHV documentation, and we want to continue to remain consistent with docs for other Red Hat products to avoid confusion for users. The IP address/hostname that should be entered here is that of the RHV Manager (which is not always a self-hosted engine -- it can also be hosted elsewhere). So the change I've made, to provide a bit of extra clarification for users is:

Was:
Enter the Hostname or IPv4 or IPv6 address of the provider. 

Now:
Enter the Hostname or IPv4 or IPv6 address of the Red Hat Virtualization Manager. 

Suyog, would you mind reviewing and letting me know your thoughts on the change, and the issue raised here?

https://github.com/ManageIQ/manageiq_docs/pull/789

And Gilbert, let me know if you have any additional thoughts on this.

Many thanks,
Dayle

Comment 10 Gilbert Kimetto 2018-03-28 15:06:49 UTC
That sounds more informative/clear

Comment 11 Dayle Parker 2018-03-29 08:05:35 UTC
Thanks, Suyog and Gilbert.

I've published this update in the 4.5 and 4.6 guides now in "1.2.2. Adding a Red Hat Virtualization Provider":

https://access.redhat.com/documentation/en-us/red_hat_cloudforms/4.5/html-single/managing_providers/

https://access.redhat.com/documentation/en-us/red_hat_cloudforms/4.6/html-single/managing_providers/


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