Bug 1498352

Summary: [Docs][RFE][Upgrade] Provide upgrade procedure(s) for self-hosted engine upgrade from 4.1 to 4.2
Product: Red Hat Enterprise Virtualization Manager Reporter: Lucy Bopf <lbopf>
Component: DocumentationAssignee: Emma Heftman <eheftman>
Status: CLOSED CURRENTRELEASE QA Contact: Tahlia Richardson <trichard>
Severity: high Docs Contact:
Priority: high    
Version: 4.2.0CC: apinnick, jbelka, lsurette, mkalinin, pstehlik, rbalakri, rhodain, sbonazzo, smaudet, srevivo, stirabos, trichard, ykaul, ylavi
Target Milestone: ovirt-4.2.3Keywords: FutureFeature, Triaged
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard: docs-accepted
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-06-03 10:52:39 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: 1516295, 1560462    
Bug Blocks: 1522620    

Description Lucy Bopf 2017-10-04 06:13:59 UTC
The procedure for upgrading a self-hosted Red Hat Virtualization environment, including host updates, must be documented.

Assignee to work with QE to determine workflows, prerequisites, and known issues.

Comment 1 Lucy Bopf 2017-12-12 08:12:06 UTC
Correcting target for GA.

Comment 5 Lucy Bopf 2018-04-13 01:54:28 UTC
Accepting into the GA program and assigning to Emma for review.

I'm bumping up the estimate by a couple of hours to account for any investigation required for the extra points that have been added to this bug since the initial estimate was made.

Comment 6 Lucy Bopf 2018-04-13 04:33:39 UTC
Adding dependency on repository update BZs for GA. The same repo information can be used in the upgrade procedures.

Comment 7 Emma Heftman 2018-04-15 09:02:27 UTC
Hi Simone
Can you update me about the status of this procedure.
1. Is it ready to be documented?
2. Is there and RFE?
3. Have you documented the procedure?

Thanks!

Comment 8 Simone Tiraboschi 2018-04-16 10:07:34 UTC
Nothing special here:

1. set HE global maintenance mode
2. upgrade the engine from 4.1 to 4.2
3. exit global maintenance mode
4. upgrade the hosts as usual

Comment 9 Emma Heftman 2018-04-16 19:31:25 UTC
(In reply to Simone Tiraboschi from comment #8)
> Nothing special here:
> 
> 1. set HE global maintenance mode
> 2. upgrade the engine from 4.1 to 4.2
> 3. exit global maintenance mode
> 4. upgrade the hosts as usual

Simone, what about customers with 3.6 or 4 what is the procedure?
For example, the procedure from 3.6 to 4.1 was to 
"sequentially upgrade to any later versions of Red Hat Virtualization before upgrading to the latest version. For example, if you are using Red Hat Enterprise Virtualization 3.6, you must upgrade to the latest minor version of Red Hat Virtualization 4.0 before you can upgrade to Red Hat Virtualization 4.1."

So should customers with either 3.6 first upgrade to 4.0 and then to 4.1 latest version and only then to 4.2?
Should 4.0 customers first upgrade to 4.1 lastest minor version and then to 4.2?

Comment 10 Emma Heftman 2018-04-16 19:48:53 UTC
Hi Simone,
In addition to the previous question, does */var/tmp* directory still require 5 GB in which to extract the appliance files?

Thanks!

Comment 12 Simone Tiraboschi 2018-04-17 08:18:48 UTC
(In reply to Emma Heftman from comment #9)
> Simone, what about customers with 3.6 or 4 what is the procedure?

We cannot skip versions on engine side so as a general rule: 3.6 -> 4.0 -> 4.1 -> 4.2

3.6/el6 -> 4.0/el7 requires a special procedure due to the el6 -> el7.

4.1 -> 4.2 it's exactly as 4.0 -> 4.1

> For example, the procedure from 3.6 to 4.1 was to 
> "sequentially upgrade to any later versions of Red Hat Virtualization before
> upgrading to the latest version. For example, if you are using Red Hat
> Enterprise Virtualization 3.6, you must upgrade to the latest minor version
> of Red Hat Virtualization 4.0 before you can upgrade to Red Hat
> Virtualization 4.1."
> 
> So should customers with either 3.6 first upgrade to 4.0 and then to 4.1
> latest version and only then to 4.2?

Yes, exactly

> Should 4.0 customers first upgrade to 4.1 lastest minor version and then to
> 4.2?

Yes, right

Comment 13 Simone Tiraboschi 2018-04-17 08:20:07 UTC
(In reply to Emma Heftman from comment #10)
> Hi Simone,
> In addition to the previous question, does */var/tmp* directory still
> require 5 GB in which to extract the appliance files?
> 
> Thanks!

Just for 3.6/el6 -> 4.0/el7 upgrades.
It's not required for 4.0 -> 4.1 or 4.1 -> 4.2

Comment 15 Emma Heftman 2018-04-17 10:21:25 UTC
Progress: Worked on all upgrade paths with Simone.
3.6> 4.2
4.0 > 4.2
4.1 > 4.2

Comment 22 Emma Heftman 2018-05-08 06:09:13 UTC
Yaniv/Sandro/Pavel
Can you confirm whether we have any SHE customers with remote databases? Is this scenario something that is being tested by QE?

This RFE doesn't specifically mention it, but it may have slipped through.
Thanks!
Emma