Bug 1277061

Summary:	[Docs] [Installation] [SHE] Update the dwh & reports section to include '--reconfigure-optional-components'
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Julie <juwu>
Component:	Documentation	Assignee:	Julie <juwu>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Tahlia Richardson <trichard>
Severity:	low	Docs Contact:
Priority:	medium
Version:	unspecified	CC:	adahms, bazulay, bdagan, bugs, dfediuck, didi, gklein, iheim, istein, juwu, lbopf, lsurette, movciari, nbarcet, pkubica, pstehlik, rbalakri, Rhev-m-bugs, sbonazzo, sradco, srevivo, tdosek, ylavi
Target Milestone:	ovirt-3.6.7
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:	1166077	Environment:
Last Closed:	2016-06-20 01:24:38 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:	1072360, 1166077
Bug Blocks:	1166078

Comment 2 Julie 2015-11-16 02:15:30 UTC

More feedback from Didi in regards to the data warehouse and reports topics.
========================
8.4.1 Prerequisites 1.: Not exactly. You can also set them up all at once.
Not that important.

8.4.2 Prerequisites 2.: I'd phrase the last two a bit more generally,
perhaps:

- Access to the database of the engine.
  If it was set up automatically, (then the existing text), otherwise
you'll also need to provide access on the database machine to the
dwh/reports machine (including pg_hba.conf, firewall, etc., up to you how
much to detail).

Similarly with the other procedures.

Procedure 8.2. step 6 and 8: Do not install the package 'rhevm'. If for any
reason you do, in step 8 you are asked whether to configure the engine.
Reply 'No'.

A reason why you might need/want to install rhevm on this machine:
Currently engine-backup is in rhevm-tools, which requires rhevm. If you
want to use it to backup dwh/reports, you are in above flow.

Similarly with the other procedures.

8.4.3 Prerequisites 3.: (in addition to notes above) last point should be:
allow access to the _dwh_ machine pg port 5432.

We specifically do not require access to the engine db. We used to, at some
point, and dropped this. This is mainly to allow separating the network:
Have one network with the engine and one with the dwh db. Users might want
other software/systems access dwh db (for analysis, billing, whatever) and
still not expose the engine.

8.4.4 Prerequisites: Again, engine+dwh can be done in a single run.

Procedure 8.8 step 1.: This one is different. Here, you can't do
engine+reports in a single run, because you still do not have dwh. If you
did install both, and reply 'yes' to both, you are stuck when asked about
dwh db. If you reply 'no' to Reports, install dwh, then run again
'engine-setup', you'll not be asked again about Reports. If you want to be
asked again, you can do this with 'engine-setup
--reconfigure-optional-components'. This option was added in 3.5.0, you
might want to add it here.
========================

Comment 3 Lucy Bopf 2016-06-07 06:49:19 UTC

Assigning to Julie for review.

Comment 4 Julie 2016-06-20 01:24:38 UTC

Revisited this old bug.
The reconfigure option is included and published already. See https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html-single/Self-Hosted_Engine_Guide/index.html#Data_Warehouse_and_Reports_Configuration_Notes for more information.

Other feedback do not apply anymore after the restructuring of the data warehouse section. The section will be reviewed again as part of the 4.0 release.

Please feel free to open a new bug if you have any questions or concerns.

Kind regards,
Julie