Bug 1428846

Summary:	Docs: Hosted Engine installation with 4.1 beta does not work
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Martin Tessun <mtessun>
Component:	Documentation	Assignee:	rhev-docs <rhev-docs>
Status:	CLOSED WONTFIX	QA Contact:	rhev-docs <rhev-docs>
Severity:	urgent	Docs Contact:
Priority:	unspecified
Version:	4.1.0	CC:	dmoessne, gklein, lbopf, lsurette, mtessun, rbalakri, srevivo
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-04-10 04:05:41 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	Docs	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	1419743

Description Martin Tessun 2017-03-03 13:38:01 UTC

Description of problem:
When trying to install hosted engine with 4.1 beta RHVH it fails as it cannot locate the install image.


Version-Release number of selected component (if applicable):
ovirt-hosted-engine-setup-2.1.0.1-1.el7ev.noarch

How reproducible:
always

Steps to Reproduce:
1. Install RHVH
2. Try installing HE as described in 
   https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1-beta/html/self-hosted_engine_guide/initiating_self-hosted_engine_deployment_on_rhvh


Actual results:
Setup fails as the OVA cannot be located and the rpm isn't available in Beta.

Expected results:
OVA should be located as described in the documentation


Additional info:
Due to the rpm missing in the beta, it is currently not possible to install hosted engine.

Steps needed:
1. Create directory /usr/share/ovirt-engine-appliance/
2. copy the ova file from the portal there
3. Create file /etc/ovirt-hosted-engine/10-appliance.conf
   The file needs the following content:
   ~~~
   description=<Description>
   version=<Version String>
   path=/usr/share/ovirt-engine-appliance/<appliance-ova-name>
   sha1sum=<sha1sum>
   ~~~

E.g. for the current rhvm-appliance this looks like:
~~~
description=The oVirt Engine Appliance image (OVA)
version=4.1-20170126.0-1.x86_64.rhevm
path=/usr/share/ovirt-engine-appliance/rhvm-appliance-20170126.0-1.x86_64.rhevm.ova
sha1sum=024258fd91baa9c75297cf6004f1ab65f393bd52
~~~

So in case you want to manually install the OVA these steps are needed besides the ones mentioned in the documentation.

Comment 1 Martin Tessun 2017-03-03 13:50:05 UTC

Some further information:

[root@ovirt1 ovirt-engine-appliance]# yum search --enablerepo=rhel-7-server-rhvh-4-rpms --enablerepo=rhel-7-server-rhvh-4-beta-rpms ovirt-engine-appliance
Loaded plugins: imgbased-persist, product-id, search-disabled-repos, subscription-manager
rhel-7-server-rhvh-4-beta-rpms                                                                                                           | 3.7 kB  00:00:00    
rhel-7-server-rhvh-4-rpms                                                                                                                | 3.7 kB  00:00:00    
Warning: No matches found for: ovirt-engine-appliance
No matches found
[root@ovirt1 ovirt-engine-appliance]# yum search --enablerepo=rhel-7-server-rhvh-4-rpms --enablerepo=rhel-7-server-rhvh-4-beta-rpms rhvm-appliance
Loaded plugins: imgbased-persist, product-id, search-disabled-repos, subscription-manager
================================================================= N/S matched: rhvm-appliance ==================================================================
rhvm-appliance.noarch : The RHEV-M Appliance image (OVA)

  Name and summary matches only, use "search all" for everything.
[root@ovirt1 ovirt-engine-appliance]#

As the hosted-engine --deploy does look for an rpm named ovirt-engine-appliance, it is not able to locate the package named rhvm-appliance.
I will open an additional bug for this, but our documentation should describe how to download (and install) the rhvm-appliance rpm.

Comment 3 Lucy Bopf 2017-04-05 01:34:54 UTC

Martin, is this bug still applicable for RC or GA, or has the missing RPM now been included?

Let me know if there are any further documentation requirements.

Comment 4 Martin Tessun 2017-04-07 09:30:13 UTC

Hi Lucy,

I think this is (at least) not applicable for the GA version, as the enablement of the repos should work as expected there.

(In reply to Lucy Bopf from comment #3)
> Martin, is this bug still applicable for RC or GA, or has the missing RPM
> now been included?

The missing rpm has always been there, but you needed to explicitely enable the beta channel on the Host/Hypervisor.

> 
> Let me know if there are any further documentation requirements.

I believe for beta also no additional clarification is needed, as GA is soon.

Thanks!
Martin

Comment 5 Lucy Bopf 2017-04-10 04:05:41 UTC

Thanks for confirming, Martin.

Moving this one to CLOSED then.