Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1991914

Summary:	[DOC] engine-backup now refuses to restore to an older version
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Yedidyah Bar David <didi>
Component:	Documentation	Assignee:	Eli Marcus <emarcus>
Status:	CLOSED CURRENTRELEASE	QA Contact:	rhev-docs <rhev-docs>
Severity:	high	Docs Contact:
Priority:	high
Version:	4.4.7	CC:	ctomasko, emarcus, lsurette, mhicks, sgoodman, srevivo
Target Milestone:	ovirt-4.4.9	Keywords:	Documentation, EasyFix, NoDocsQEReview, PrioBumpGSS, ZStream
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:	2021-11-17 13:22:49 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	Integration	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1991171
Bug Blocks:

Description Yedidyah Bar David 2021-08-10 11:52:39 UTC

Description of problem:

Since 4.4.7.3 (bug 1932392, even though it's targeted 4.4.8), engine-backup refuses to restore if the installed version is older than the one used for backup.

Please update the important note in [1] accordingly - now it's not just same "major" release, but also not older. E.g. you can't restore to 4.4.7.3 a backup taken with 4.4.7.5.

Also, please add similar text to hosted-engine [2]. There, it's even more important, as it takes quite a long time to get to the point where it fails due to the version. Also: With 4.4.8, see bug 1991171, instead of failing, it prompts the user, letting the user handle the restore failure manually. Please see that bug and add relevant text.

[1] https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html-single/administration_guide/index#Restoring_a_Backup_with_the_engine-backup_Command

[2] https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html-single/administration_guide/index#Backing_up_and_Restoring_a_Self-hosted_Engine

Comment 1 Eli Marcus 2021-10-18 11:31:23 UTC

from BZ#1932392:
 
"You can only restore to a version >= the version used to do the backup. Otherwise, it's essentially a downgrade, which is not supported."

Comment 2 Eli Marcus 2021-10-18 15:06:27 UTC

Hi Didi, please review: 

https://github.com/oVirt/ovirt-site/pull/2590

Full note under "Restoring a Backup with the engine-backup Command":
"Backups can only be restored to environments of the same release as that of the backup or later. For example, a backup of a {virt-product-fullname} version 4.2.6 environment can only be restored to a {virt-product-fullname} environment with version 4.2.6, 4.3.z, 4.4.z or later. To view the version of {virt-product-fullname} contained in a backup file, unpack the backup file and read the value in the version file located in the root directory of the unpacked files."

Partial note under "Backing up and restoring a Self-hosted engine" prerequisites:

"For example, a backup of a {virt-product-fullname} version 4.2.6 environment can only be restored to a {virt-product-fullname} environment with version 4.2.6, 4.3.z, 4.4.z or later."

Comment 3 Yedidyah Bar David 2021-10-18 19:51:33 UTC

Any reason to make comment 2 private? AFAIU its contents are already public in github, right?

Commented about the actual question in the PR.

Comment 4 Eli Marcus 2021-10-19 15:51:08 UTC

(In reply to Yedidyah Bar David from comment #3)
> Any reason to make comment 2 private? AFAIU its contents are already public
> in github, right?
> 
> Commented about the actual question in the PR.

only due to force of habit from RHV...

Comment 5 Eli Marcus 2021-10-25 11:34:27 UTC

Hi Didi, please review one more time: 

https://github.com/oVirt/ovirt-site/pull/2590/files

Comment 6 Yedidyah Bar David 2021-10-25 12:04:03 UTC

Commented on github. Thanks!

Comment 7 Eli Marcus 2021-11-17 13:22:49 UTC

published