Bug 1397001

Summary: [Docs][SHE] Upgrading SHE from 3.6 to 4.0 - remove subscription step
Product: Red Hat Enterprise Virtualization Manager Reporter: Sarvesh Pandit <sapandit>
Component: DocumentationAssignee: Byron Gravenorst <bgraveno>
Status: CLOSED CURRENTRELEASE QA Contact: rhev-docs <rhev-docs>
Severity: high Docs Contact:
Priority: high    
Version: 4.0.0CC: alukiano, bgraveno, gklein, jbelka, lbopf, lsurette, mavital, mjankula, rbalakri, srevivo, ykaul, ylavi
Target Milestone: ovirt-4.0.6   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-02-08 05:49:55 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:

Description Sarvesh Pandit 2016-11-21 11:26:22 UTC
Description of problem:
https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/paged/self-hosted-engine-guide/54-upgrading-a-rhev-h-based-self-hosted-engine-environment

In the above process, 6th step is wrong:

===================
6. On the Manager virtual machine, enable the required repository.

# subscription-manager repos --enable=rhel-7-server-rhv-4.0-rpms
===================

First thing "rhel-7-server-rhv-4.0-rpms" is repo which need to enable on RHEL host, this is RHV-H-7 for 3.6 so we can't enable it on any RHV-Host.

Second thing at this step, RHV-M is RHEL 6.X based HE-VM, so can't enable RHEL 7 repo on 6.X systems. 

Version-Release number of selected component (if applicable):
NA

How reproducible:
NA

Steps to Reproduce:
NA

Actual results:
6th Step is mentioned.

Expected results:
Need to remove wrong 6th step from document. without this step upgrade works fine. 

Additional info:

Comment 1 Yaniv Lavi 2016-11-22 12:47:29 UTC
Can you please review the docs here? Do we need this step for RHV-H?

Comment 2 Jiri Belka 2016-11-22 13:43:40 UTC
(In reply to Sarvesh Pandit from comment #0)
> Description of problem:
> https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/paged/
> self-hosted-engine-guide/54-upgrading-a-rhev-h-based-self-hosted-engine-
> environment
> 
> In the above process, 6th step is wrong:
> 
> ===================
> 6. On the Manager virtual machine, enable the required repository.
> 
> # subscription-manager repos --enable=rhel-7-server-rhv-4.0-rpms
> ===================
> 
> First thing "rhel-7-server-rhv-4.0-rpms" is repo which need to enable on
> RHEL host, this is RHV-H-7 for 3.6 so we can't enable it on any RHV-Host.
> 
> Second thing at this step, RHV-M is RHEL 6.X based HE-VM, so can't enable
> RHEL 7 repo on 6.X systems. 
> 
> Version-Release number of selected component (if applicable):
> NA
> 
> How reproducible:
> NA
> 
> Steps to Reproduce:
> NA
> 
> Actual results:
> 6th Step is mentioned.
> 
> Expected results:
> Need to remove wrong 6th step from document. without this step upgrade works
> fine. 
> 
> Additional info:

It seems step '6.' is useless as appliance will replace current HE VM anyway. Should be confirmed by responsible QE team.

Comment 3 Artyom 2016-12-01 08:41:26 UTC
Agree with Jiri about step 6:
hosted-engine --upgrade-appliance will create new VM so it useless to add channels to the old VM

Correct me if I wrong:
1) The command --upgrade-appliance exists only under hosts with the 4.0 packages, so you will need to upgrade first hosts.

2) I must run upgrade of RHEV-H from the engine or via PXE, and not via package manager, so you do not need to run subscription manager commands

Comment 4 Lucy Bopf 2016-12-04 23:42:51 UTC
*** Bug 1401006 has been marked as a duplicate of this bug. ***

Comment 5 Byron Gravenorst 2017-01-06 00:17:07 UTC
*** Git link:

https://gitlab.cee.redhat.com/rhci-documentation/docs-Red_Hat_Enterprise_Virtualization/merge_requests/309


*** What's changed:

Removed the incorrect step from the procedure.