Bug 1092388

Summary: [Docs] engine-backup: Correct restore procedures for Reports and DWH
Product: Red Hat Enterprise Virtualization Manager Reporter: Andrew Burden <aburden>
Component: DocumentationAssignee: Andrew Burden <aburden>
Status: CLOSED CURRENTRELEASE QA Contact: Lucy Bopf <lbopf>
Severity: medium Docs Contact:
Priority: high    
Version: 3.4.0CC: aburden, adahms, didi, gklein, jbelka, juwu, pstehlik, rbalakri, tdosek, yeylon, ylavi
Target Milestone: ovirt-3.6.0-rc3   
Target Release: 3.6.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard: docs
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 1217297 (view as bug list) Environment:
Last Closed: 2015-11-20 04:10:02 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: 1224889    
Bug Blocks: 1114064, 1217297, 1277358    

Description Andrew Burden 2014-04-29 08:23:06 UTC
Didi just brought this to my attention. It's too late for 3.4 as docs freeze has passed. 

Wiki has the info:
http://www.ovirt.org/Ovirt-engine-backup

Comment 1 Julie 2014-09-16 05:26:08 UTC
Hi Tomas,
  You mentioned the support team gets ticket daily for this bug, I checked with Andrew Dahms who documented most of the engine restore and backup content which can be found here [1] and he's really interested to know what is missing from the documentation. What are the customers running into and what are they trying to solve? If you could help us find some of answers and perhaps attach a few support cases, that would really help us to understand what else needs to be added in for the engine restore and backup section.


[1] https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.4/html-single/Administration_Guide/index.html#Backing_up_Red_Hat_Enterprise_Virtualization_Manager_using_the_engine-backup_Command

Comment 2 Tomas Dosek 2014-09-16 05:45:53 UTC
Hi Julie,

The missing steps are for reports/dwhd databases. While engine-backup provides with full backup of engine database, it does not create dumps of reports/dwhd database if these are installed.

There's already pending request for improvement in engine-backup, but until that is solved we need to back these up manually (using pg_dump) so it would be nice if documentation mentioned it.

So far we use articles like:
https://access.redhat.com/solutions/225823
https://access.redhat.com/solutions/759413

Comment 3 Julie 2014-09-23 08:43:08 UTC
*** Bug 1092384 has been marked as a duplicate of this bug. ***

Comment 4 Jiri Belka 2015-04-30 10:12:53 UTC
Please do something with that, it's unbelievable this BZ is stalled for such long time!

Especially it should mention something more about dwh, reports because of this bug BZ1217402.

Comment 5 Andrew Dahms 2015-04-30 11:32:46 UTC
Hi Jiri,

Thank you for following up on this bug, and I apologize that I have not provided an update on progress to you sooner.

Andrew Burden has been testing the procedures involved here over the past few weeks, and we are working on this bug as a priority now.

We will make sure to update the bug with progress as we go along, but please let us know if you have any questions or concerns. 

Kind regards,

Andrew

Comment 7 Yaniv Lavi 2015-09-24 11:49:55 UTC
Didi, can you help with the testing? what is missing?

Comment 8 Yedidyah Bar David 2015-10-12 12:38:20 UTC
(In reply to Yaniv Dary from comment #7)
> Didi, can you help with the testing? what is missing?

Nothing should be missing now, when bug 1224889 is solved.

Comment 9 Yaniv Lavi 2015-10-14 14:12:42 UTC
Can we commit the changes?

Comment 11 Lucy Bopf 2015-10-20 05:16:55 UTC
Reviewed. Made some minor edits to all topics to reduce some ambiguity of replaceable file names.

Added the following new revisions to the 3.5 Administration Guide production spec (23027):
Restoring a Backup to a Fresh Installation [28277, rev: 771916]
Restoring a Backup to Overwrite an Existing Installation [28243, rev: 771915]
Restoring a Backup with Different Credentials [28279, rev: 771914]

Updated Revision History [34613, rev: 771919]

Moving to VERIFIED.

Comment 12 Andrew Burden 2015-11-20 04:10:02 UTC
3.6 Beta documentation can be found at https://access.redhat.com/documentation/en/red-hat-enterprise-virtualization/