Bug 1412024

Summary:	[Docs][SHE] Update the self-hosted engine installation procedures for RHV 4.1
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Lucy Bopf <lbopf>
Component:	Documentation	Assignee:	Byron Gravenorst <bgraveno>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Tahlia Richardson <trichard>
Severity:	high	Docs Contact:
Priority:	high
Version:	unspecified	CC:	bgraveno, gklein, lsurette, rbalakri, srevivo, stirabos, trichard, ykaul
Target Milestone:	ovirt-4.1.1
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-02-13 02:48:59 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:	1313916, 1331858, 1349301, 1366183
Bug Blocks:

Description Lucy Bopf 2017-01-11 02:06:05 UTC

The installation and configuration steps for a self-hosted installation of RHV 4.1 (Beta) must be tested, reviewed, and updated.

In particular, the output of hosted-engine --deploy should be updated as necessary.

Comment 1 Lucy Bopf 2017-01-11 02:07:05 UTC

Assigning to Byron for review.

Comment 5 Byron Gravenorst 2017-01-31 12:14:40 UTC

Hi Simone,

Could you please review the updated documentation (2.1. Deploying Self-Hosted Engine on Red Hat Enterprise Linux Hosts instructions), or pass this to the appropriate person?

I updated the Self-hosted engine instructions with the latest "hosted-engine --deploy" output.
I was unable to complete the installation due to an error during the "Running engine-setup on the appliance" phase.

I've been unable to confirm the output for the following steps, so could you please confirm that the documentation is still accurate:
- The gluster and iSCSI instructions in "3. Configuring Storage"
- "8. Creating the Manager Virtual Machine"

Kind regards,

Comment 6 Simone Tiraboschi 2017-01-31 14:34:58 UTC

(In reply to Byron Gravenorst from comment #5)
> Hi Simone,
> 
> Could you please review the updated documentation (2.1. Deploying
> Self-Hosted Engine on Red Hat Enterprise Linux Hosts instructions), or pass
> this to the appropriate person?

Done, I added a few minor comments.
Maybe it's worth to update section 2.2 at the same time since they are really close.

> 
> I updated the Self-hosted engine instructions with the latest "hosted-engine
> --deploy" output.
> I was unable to complete the installation due to an error during the
> "Running engine-setup on the appliance" phase.

Could you please provide more details? maybe it could also affect real users.

> I've been unable to confirm the output for the following steps, so could you
> please confirm that the documentation is still accurate:
> - The gluster and iSCSI instructions in "3. Configuring Storage"
> - "8. Creating the Manager Virtual Machine"

Yes, they are.

Comment 7 Byron Gravenorst 2017-02-01 06:27:02 UTC

Thanks for this Simone,

I managed to install the hosted-engine today via "hosted-engine --deploy" and cockpit. I used the latest rhev package that was made available yesterday (rhv-release-4.1.0-11-001.noarch.rpm). So the issue may have been with the rhv-release-4.1.0-8-001.noarch.rpm package.

I'll implement your suggestions and update 2.2. I will probably require another review afterwards because I'll need to add instructions for installing hosted engine on rhel host using cockpit (or at least, just instructions to install and run cockpit).

Regards,

Comment 15 Byron Gravenorst 2017-02-13 02:48:59 UTC

This content has been published to:

https://access.redhat.com/documentation/en/red-hat-virtualization/4.1-beta/single/self-hosted-engine-guide/#chap-Deploying_Self-Hosted_Engine