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

Bug 1373052

Summary: [Docs][SHE] Additional step and warning required for SHE upgrade procedure
Product: Red Hat Enterprise Virtualization Manager Reporter: Lucy Bopf <lbopf>
Component: DocumentationAssignee: rhev-docs <rhev-docs>
Status: CLOSED CURRENTRELEASE QA Contact: rhev-docs <rhev-docs>
Severity: unspecified Docs Contact:
Priority: high    
Version: 4.0.0CC: lsurette, rbalakri, srevivo, stirabos, ykaul, ylavi
Target Milestone: ovirt-4.1.1Keywords: EasyFix
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: 2017-05-29 07:48:48 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: 1366879    
Bug Blocks:    

Description Lucy Bopf 2016-09-05 02:28:20 UTC
The following update must be made to the self-hosted engine upgrade procedure for both host types:

* A warning should be added that the shared self-hosted engine storage domain may require additional space to complete the upgrade successfully. This generally applied only for iSCSI LUN disks. See https://bugzilla.redhat.com/show_bug.cgi?id=1366879#c43 for more information.


The following update must be made to the self-hosted engine upgrade procedure for RHEL hosts:

* A step for updating all packages on the RHEL host must be added after the repositories are enabled, and before 'hosted-engine --upgrade-appliance' is run.

Comment 1 Yaniv Lavi 2016-12-05 08:39:47 UTC
I'm not sure we need to document this, since the setup code checks this and upgrade helper also tells user about it. Simone, can you check?

Comment 2 Simone Tiraboschi 2017-01-31 09:26:40 UTC
(In reply to Lucy Bopf from comment #0)
> The following update must be made to the self-hosted engine upgrade
> procedure for both host types:
> 
> * A warning should be added that the shared self-hosted engine storage
> domain may require additional space to complete the upgrade successfully.
> This generally applied only for iSCSI LUN disks. See
> https://bugzilla.redhat.com/show_bug.cgi?id=1366879#c43 for more information.

Yes, we already have that check in the code; it's in the early step of the upgrade (3.6/el6 -> 4.0/el7) path.

https://gerrit.ovirt.org/gitweb?p=ovirt-hosted-engine-setup.git;a=blob;f=src/plugins/gr-he-upgradeappliance/engine/misc.py;h=ddd77dea4e40cf90668646989a56113797f0e222;hb=refs/heads/master#l219

> * A step for updating all packages on the RHEL host must be added after the
> repositories are enabled, and before 'hosted-engine --upgrade-appliance' is
> run.

On the upgrade helper tool we have:
Step 8: On the host, update the Manager virtual machine packages.
# yum update ovirt-hosted-engine-setup rhevm-appliance
which is fine for 4.0.
We will have an issue when the rhv-appliance 4.1 will land in the channel.

This step instead is wrong since at the point the engine is still with el6:
Step 6: On the Manager virtual machine, enable the required repository.
# subscription-manager repos --enable=rhel-7-server-rhv-4.0-rpms

Comment 3 Yaniv Lavi 2017-05-29 07:37:42 UTC
(In reply to Simone Tiraboschi from comment #2)
> 
> On the upgrade helper tool we have:
> Step 8: On the host, update the Manager virtual machine packages.
> # yum update ovirt-hosted-engine-setup rhevm-appliance
> which is fine for 4.0.
> We will have an issue when the rhv-appliance 4.1 will land in the channel.
> 
> This step instead is wrong since at the point the engine is still with el6:
> Step 6: On the Manager virtual machine, enable the required repository.
> # subscription-manager repos --enable=rhel-7-server-rhv-4.0-rpms

Please check if this is fixed and if it is, close this bug.

Comment 4 Lucy Bopf 2017-05-29 07:48:48 UTC
(In reply to Yaniv Dary from comment #3)
> (In reply to Simone Tiraboschi from comment #2)
> > 
> > On the upgrade helper tool we have:
> > Step 8: On the host, update the Manager virtual machine packages.
> > # yum update ovirt-hosted-engine-setup rhevm-appliance
> > which is fine for 4.0.
> > We will have an issue when the rhv-appliance 4.1 will land in the channel.
> > 
> > This step instead is wrong since at the point the engine is still with el6:
> > Step 6: On the Manager virtual machine, enable the required repository.
> > # subscription-manager repos --enable=rhel-7-server-rhv-4.0-rpms
> 
> Please check if this is fixed and if it is, close this bug.

Yep, it looks like this was fixed already:

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.0/html-single/self-hosted_engine_guide/#Upgrading_the_Self-Hosted_Engine

Since there are no other requirements now, I'm closing this bug.