Bug 1694666 - [TEXT] Description of RHVM Appliance should be in sync with docs.
Summary: [TEXT] Description of RHVM Appliance should be in sync with docs.
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: ovirt-hosted-engine-setup
Version: 4.3.0
Hardware: Unspecified
OS: Unspecified
high
medium
Target Milestone: ovirt-4.3.4
: 4.3.1
Assignee: Gal Zaidman
QA Contact: Nikolai Sednev
URL:
Whiteboard:
Depends On: 1553758
Blocks: 1709969
TreeView+ depends on / blocked
 
Reported: 2019-04-01 11:36 UTC by Steve Goodman
Modified: 2019-06-20 14:48 UTC (History)
13 users (show)

Fixed In Version: ovirt-hosted-engine-setup-2.3.9
Doc Type: If docs needed, set a value
Doc Text:
Clone Of: 1553758
Environment:
Last Closed: 2019-06-20 14:48:16 UTC
oVirt Team: Integration
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHEA-2019:1563 0 None None None 2019-06-20 14:48:19 UTC
oVirt gerrit 99704 0 ovirt-hosted-engine-setup-2.3 MERGED Fix dialog, change "engine appliance" to "engine" 2019-05-06 10:02:32 UTC
oVirt gerrit 99775 0 ovirt-hosted-engine-setup-2.3 MERGED Fix dialog, change "engine appliance" to "engine" 2019-05-06 11:25:05 UTC

Description Steve Goodman 2019-04-01 11:36:58 UTC
+++ This bug was initially created as a clone of Bug #1553758 +++

--- Additional comment from Steve Goodman on 2019-04-01 06:39:19 UTC ---

Sandro,

As a newcomer to RHV, I found the whole concept of the appliance to be very confusing. When I looked up what an appliance is, I found that it's a self-contained virtual machine used for a specific purpose. However, the way we use the term in the documentation, it is only for installing the virtual machine that hosts the engine, not the virtual machine itself. BUT we use the term inconsistently, which leads to more confusion. Specifically:
* We use the term in the documentation, as I just mentioned, to refer to something that installs the virtual machine that hosts the engine.
* But in the current SHE Guide, in section 2.2, step 7 [1], the command prompt refers to the appliance as the actual virtual machine, not just something used to install the vm:
  > Please provide the FQDN you would like to use for the engine appliance.
  > Note: This will be the FQDN of the engine VM you are now going to launch,
  > it should not point to the base host or to any other existing machine.
  > Engine VM FQDN:  manager.example.com
  > Please provide the domain name you would like to use for the engine appliance.
  > Engine VM domain: [example.com]

[1] https://access.redhat.com/documentation/en-aus/red_hat_virtualization/4.2/html-single/self-hosted_engine_guide/#Deploying_the_Self-Hosted_Engine_Using_the_CLI_deploy

The command prompts and the documentation need to be in sync. The command prompts should be updated.

Comment 1 Steve Goodman 2019-04-01 12:22:38 UTC
I see that this was given the keyword Documentation.

This is not a documentation bug. It is a bug in the text in the installer script. I'm not sure what the correct keyword is, but I don't think it's "Documentation".

Comment 2 Nikolai Sednev 2019-06-04 11:36:15 UTC
Works for me on these components:
ovirt-hosted-engine-ha-2.3.1-1.el7ev.noarch
ovirt-hosted-engine-setup-2.3.9-1.el7ev.noarch

[ INFO  ] Detecting host timezone.
          Please provide the FQDN you would like to use for the engine.
          Note: This will be the FQDN of the engine VM you are now going to launch,
          it should not point to the base host or to any other existing machine.
          Engine VM FQDN:  []:

Comment 4 errata-xmlrpc 2019-06-20 14:48:16 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/RHEA-2019:1563


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