Bug 1396966

Summary: [Docs][SHE] Need to add prerequisite to subscribe to rhv-m channel in migrating from bare metal to RHEL Based HE environment using RHV-M appliance
Product: Red Hat Enterprise Virtualization Manager Reporter: Sarvesh Pandit <sapandit>
Component: DocumentationAssignee: Tahlia Richardson <trichard>
Status: CLOSED CURRENTRELEASE QA Contact: Byron Gravenorst <bgraveno>
Severity: medium Docs Contact:
Priority: medium    
Version: 4.2.3CC: bgraveno, lbopf, lsurette, rbalakri, srevivo, trichard, ylavi
Target Milestone: ovirt-4.2.4Keywords: Reopened, Triaged
Target Release: ---   
Hardware: All   
OS: Linux   
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-28 23:43:13 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:
Attachments:
Description Flags
RHV-M_subscription_register_errot none

Description Sarvesh Pandit 2016-11-21 09:58:25 UTC 
Created attachment 1222353 [details]
RHV-M_subscription_register_errot

Description of problem:
While migrating from Bare-metal RHV-M to RHEL based HE RHV-M, you need to answer following question as "NO"

Refer: https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/paged/self-hosted-engine-guide/chapter-4-migrating-from-bare-metal-to-a-rhel-based-self-hosted-environment
========================
Automatically execute engine-setup on the engine appliance on first boot (Yes, No)[Yes]? No
========================

This means we need to manually run "engine-setup" command on newly installed HE-VM i.e. RHV-M. Generally normal HE installation using RHV-M appliance, the appliance takes care of installation of rhevm and other dependent packages but here case is special as we are interrupting the normal behaviour of RHV-M appliance by running "engine-setup"  manually. To run this command we need to register and subscribe the RHV-M i.e HE-VM to required entitlements/channels. This step of registration and subscribing is missing.

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

How reproducible:
NA

Steps to Reproduce:
NA

Actual results:
No registration and subscription as using RHV-M appliance

Expected results:
Particular this case, yes registration and subscription even though using RHV-M appliance. Mention the link about subscribing the required channel in steps for migrating from Bare-metal RHV-M to RHEL based HE RHV-M.

Additional info:
Required entitlements:
https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/paged/installation-guide/chapter-3-red-hat-virtualization-manager
Comment 1 Yaniv Lavi 2016-11-22 12:44:35 UTC 
The appliance has all the packages needed for initial installation adding the channel should be a step 2 after the setup.
Comment 2 Sarvesh Pandit 2016-11-23 05:13:44 UTC 
(In reply to Yaniv Dary from comment #1)
> The appliance has all the packages needed for initial installation adding
> the channel should be a step 2 after the setup.

I didn't get you?

If you think appliance should ideally take care of the required packages then it seems issue with appliance, as per screenshot attached to bug it is not taking care of repo. 

Error message indirectly mentioning to register and subscribe the RHV-M then run engine-setup.
Comment 3 Yaniv Lavi 2016-11-23 08:47:11 UTC 
We need to add to the docs that you can either use the '--offline' option or needs to setup the channels.
Comment 10 Tahlia Richardson 2018-06-28 23:43:13 UTC 
Now published at https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html/self-hosted_engine_guide/chap-migrating_from_bare_metal_to_a_rhel-based_self-hosted_environment#Migrating_to_a_Self-Hosted_Environment
and 
https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.0/html/self-hosted_engine_guide/chap-migrating_from_bare_metal_to_a_rhel-based_self-hosted_environment#Migrating_to_a_Self-Hosted_Environment

The 4.2 update is part of BZ#1420604.