Bug 1160742

Summary: [Docs] [Install] Wrong examples during setup of rhevm-reports and missing note if one is using Self-Hosted Engine
Product: Red Hat Enterprise Virtualization Manager Reporter: Vladimir Vasilev <vvasilev>
Component: DocumentationAssignee: Tahlia Richardson <trichard>
Status: CLOSED CURRENTRELEASE QA Contact: Lucy Bopf <lbopf>
Severity: medium Docs Contact:
Priority: medium    
Version: 3.4.1-1CC: adahms, ecohen, gklein, juwu, lbopf, lsurette, rbalakri, vvasilev, yeylon
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 1219336 (view as bug list) Environment:
Build Name: 22722, Installation Guide-3.4-1.0 Build Date: 07-10-2014 15:03:26 Topic ID: 7523-631270 [Specified]
Last Closed: 2015-05-20 05:46:28 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1227301    

Description Vladimir Vasilev 2014-11-05 14:33:17 UTC
Title: Installing and Configuring the History Database and Red Hat Enterprise Virtualization Manager Reports

Describe the issue:
The mentioned example in step 3 is wrong. If rhevm-reports and rhevm-dwh are installed before that than it will be "Configure" instead of "Install". This is the actual result after step 1 and 2 are done:

          --== PRODUCT OPTIONS ==--
         
          Configure Reports on this host (Yes, No) [Yes]: 
          Configure Data Warehouse on this host (Yes, No) [Yes]:

Suggestions for improvement:
Either change "Install" to "Configure" or remove steps 1 and 2.

Additional information:
Another issue is if one is using Self-Hosted Engine the heartbeat on the hypervisors will reboot RHEVM because during the setup of the reports ovirt-engine is stopped. A note can be added in the documentation in this case that user needs to schedule a maintenance with "hosted-engine --set-maintenance --mode=global".

Comment 1 Julie 2014-11-24 07:24:59 UTC
Hi Vladimir,
   Thanks for filing this bug. You will be contacted again for bug verification.

Hi Tahlia,
The History and Reports section has been removed from the 3.5 Installation Guide and moved to the Customer Portal. Please assess if any changes need to made there (ask Lucy). Please also assess if this bug needs to backported for 3.4. 

A note needs to be added for Self-Hosted Engine.

Cheers,
Julie

Comment 8 Lucy Bopf 2015-05-13 06:08:43 UTC
Reviewed in cs22722 (3.4):

'Install' has been changed to 'Configure' to match actual output. 'Important' box has been added telling hosted engine users to set global maintenance mode.

Updated in cs22722:
Installing and Configuring the History Database and Red Hat Enterprise Virtualization Manager Reports [7523-757215] (already added by Tahlia)
Revision History [30105-757768]


Reviewed in cs22766 (3.5):

Moving hosted engine to maintenance mode has been added as prerequisite to all DWH-Reports topics that require an ovirt-engine restart.

Updated in cs23028:
Installing and Configuring Data Warehouse and Reports on the Red Hat Enterprise Virtualization Manager [7523-757217]
Installing and Configuring Data Warehouse on the Red Hat Enterprise Virtualization Manager and Reports on a Separate Machine [42467-757218]
Installing and Configuring Data Warehouse on a Separate Machine and Reports on the Red Hat Enterprise Virtualization Manager [42468-757219]
Revision History [34615-757771]

Comment 9 Tahlia Richardson 2015-05-20 05:46:28 UTC
Included in May 19 async release.