Bug 1373052 - [Docs][SHE] Additional step and warning required for SHE upgrade procedure
Summary: [Docs][SHE] Additional step and warning required for SHE upgrade procedure
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: Documentation
Version: 4.0.0
Hardware: Unspecified
OS: Unspecified
high
unspecified
Target Milestone: ovirt-4.1.1
: ---
Assignee: rhev-docs@redhat.com
QA Contact: rhev-docs@redhat.com
URL:
Whiteboard:
Depends On: 1366879
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-09-05 02:28 UTC by Lucy Bopf
Modified: 2019-05-07 13:10 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-05-29 07:48:48 UTC
oVirt Team: Docs
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Bugzilla 1390028 0 high CLOSED [Docs][SHE] Implement feedback for SHE upgrade instructions 2021-02-22 00:41:40 UTC

Internal Links: 1390028

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.


Note You need to log in before you can comment on or make changes to this bug.