Bugzilla will be upgraded to version 5.0. The upgrade date is tentatively scheduled for 2 December 2018, pending final testing and feedback.
Bug 1445157 - [Docs][Upgrade][Install] Add section for 3.6 RHVH into 3.5 to 3.6 upgrade and installation procedures
[Docs][Upgrade][Install] Add section for 3.6 RHVH into 3.5 to 3.6 upgrade and...
Status: CLOSED CURRENTRELEASE
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: Documentation (Show other bugs)
3.6.10
Unspecified Unspecified
urgent Severity high
: ovirt-3.6.11
: ---
Assigned To: Byron Gravenorst
Tahlia Richardson
:
Depends On: 1445161
Blocks: 1462674
  Show dependency treegraph
 
Reported: 2017-04-25 03:08 EDT by Jiri Belka
Modified: 2017-07-10 02:13 EDT (History)
12 users (show)

See Also:
Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
Environment:
Last Closed: 2017-07-10 02:13:40 EDT
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: Docs
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)

  None (edit)
Description Jiri Belka 2017-04-25 03:08:47 EDT
Description of problem:

we probably need extension of below documentation url for cases where customer uses and still wants to use hypervisor node (ie. non plain EL with vdsm etc... rpm).

See description of the "problem" why 3.6 NGN was introduced at https://bugzilla.redhat.com/show_bug.cgi?id=1421098

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Upgrade_Guide/Upgrading_Hosts_in_a_Red_Hat_Enterprise_Linux_6_Cluster_to_Red_Hat_Enterprise_Linux_7.html

not sure if that should be a section or new page, anyway we need to tell that they can upgrade not only to EL7 but to 3.6 NGN (redhat-virtualization-host).

thus IMO there should be a section about 3.6 NGN (redhat-virtualization-host) also in installation guide as this is totally new thing in 3.6.

an example of wording in case on hypervisors:

"Note: Upgrading the cluster compatibility version of your cluster from 3.5 to 3.6 requires all Red Hat Enterprise Virtualization Hypervisor hosts in the cluster must be upgraded to Red Hat Virtualization Host for RHV 3.6 before the upgrade of the cluster compatibility version is possible. This upgrade means a switch to a new type of virtualization host, that is switching from legacy Red Hat Enterprise Virtualization Hypervisor (RHEV-H) to Red Hat Virtualization Host (RHVH)."

Please also note that there is still a bug in 3.6 host-deploy which causes vds_type for 3.6 ngn is incorrent. So maybe there should be a 'Note' section as well mentioning this as host upgrade manager can't upgrade 3.6 NGN inside 3.6 engine (ie. with host-deploy from 3.6 engine). See https://bugzilla.redhat.com/show_bug.cgi?id=1431226 and https://bugzilla.redhat.com/show_bug.cgi?id=1425660
This issue can be repaired only in 4.0 with 'Reinstall' button or via direct modification of the DB right now (a KB?).

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

How reproducible:
100%

Steps to Reproduce:
1. have 3.5 env with 3.5 rhevh (so called legacy hypervisor)
2. you want to try to upgrade to 3.6 including hosts but keep hosts not being
   plain EL but a kind of virtualization hosts
3. read docs for info

Actual results:
no info as 3.6 didn't know about 3.6 ngn

Expected results:
should be there

Additional info:
Comment 1 Yaniv Lavi 2017-04-25 03:25:59 EDT
I'm setting this one on urgent and requesting someone to rework this flow as soon as possible to include and recommended using the NGN for upgrades from 3.5 el6 to 3.6 el7 (note that this doesn't affect RHEL-H).
Comment 2 Lucy Bopf 2017-04-26 21:35:54 EDT
Yaniv, reading through this it appears there's still an open question about the workaround for the issue reported in https://bugzilla.redhat.com/show_bug.cgi?id=1431226.

"This issue can be repaired only in 4.0 with 'Reinstall' button or via direct modification of the DB right now (a KB?)."

Can you let us know which workaround we should document?
Comment 3 Lucy Bopf 2017-05-02 22:56:03 EDT
Assigning to Byron for review.

Byron, we're waiting on an answer about the workaround for the open issue mentioned, but you should be able to make a start on the other procedural updates. These updates must be made in the 3.6 documentation.
Comment 4 Yaniv Lavi 2017-05-14 09:53:27 EDT
(In reply to Lucy Bopf from comment #2)
> Yaniv, reading through this it appears there's still an open question about
> the workaround for the issue reported in
> https://bugzilla.redhat.com/show_bug.cgi?id=1431226.
> 
> "This issue can be repaired only in 4.0 with 'Reinstall' button or via
> direct modification of the DB right now (a KB?)."
> 
> Can you let us know which workaround we should document?

Reinstall option.
Comment 5 Yaniv Lavi 2017-06-04 10:32:00 EDT
(In reply to Yaniv Dary from comment #4)
> (In reply to Lucy Bopf from comment #2)
> > Yaniv, reading through this it appears there's still an open question about
> > the workaround for the issue reported in
> > https://bugzilla.redhat.com/show_bug.cgi?id=1431226.
> > 
> > "This issue can be repaired only in 4.0 with 'Reinstall' button or via
> > direct modification of the DB right now (a KB?)."
> > 
> > Can you let us know which workaround we should document?
> 
> Reinstall option.

Re-install is not needed. It was fixed in an async to latest 3.6.11.
Comment 6 Jiri Belka 2017-06-19 08:56:55 EDT
(In reply to Yaniv Lavi from comment #5)
> (In reply to Yaniv Dary from comment #4)
> > (In reply to Lucy Bopf from comment #2)
> > > Yaniv, reading through this it appears there's still an open question about
> > > the workaround for the issue reported in
> > > https://bugzilla.redhat.com/show_bug.cgi?id=1431226.
> > > 
> > > "This issue can be repaired only in 4.0 with 'Reinstall' button or via
> > > direct modification of the DB right now (a KB?)."
> > > 
> > > Can you let us know which workaround we should document?
> > 
> > Reinstall option.
> 
> Re-install is not needed. It was fixed in an async to latest 3.6.11.

^^^ "The fix" was in 4.1, see https://bugzilla.redhat.com/show_bug.cgi?id=1445297, or is there any other BZ for the fix you mentioned?
Comment 7 Jiri Belka 2017-06-20 03:22:56 EDT
(In reply to Jiri Belka from comment #6)
> (In reply to Yaniv Lavi from comment #5)
> > (In reply to Yaniv Dary from comment #4)
> > > (In reply to Lucy Bopf from comment #2)
> > > > Yaniv, reading through this it appears there's still an open question about
> > > > the workaround for the issue reported in
> > > > https://bugzilla.redhat.com/show_bug.cgi?id=1431226.
> > > > 
> > > > "This issue can be repaired only in 4.0 with 'Reinstall' button or via
> > > > direct modification of the DB right now (a KB?)."
> > > > 
> > > > Can you let us know which workaround we should document?
> > > 
> > > Reinstall option.
> > 
> > Re-install is not needed. It was fixed in an async to latest 3.6.11.
> 
> ^^^ "The fix" was in 4.1, see
> https://bugzilla.redhat.com/show_bug.cgi?id=1445297, or is there any other
> BZ for the fix you mentioned?

We recommend the upgrade from 3.6 should go via 4.0 but finish in latest 4.1 and there the fix exists.
Comment 8 Dan Kenigsberg 2017-06-20 08:55:09 EDT
Can rhv field engineering do anything to hasten handling of this documentation change?
Comment 16 Byron Gravenorst 2017-07-03 21:11:36 EDT
Thanks Jiri,

Does the following accurately capture the recommendation?

"Red Hat Enterprise Virtualization does not support using the 'Reinstall' button to install a different hypervisor type. For example Red Hat Enterprise Linux host to Red Hat Virtualization Host. To install a different hypervisor type, you must remove the host from the environment, install the new hypervisor,  and then add it back."

Regards
Comment 17 Jiri Belka 2017-07-04 03:10:40 EDT
(In reply to Byron Gravenorst from comment #16)
> Thanks Jiri,
> 
> Does the following accurately capture the recommendation?
> 
> "Red Hat Enterprise Virtualization does not support using the 'Reinstall'
> button to install a different hypervisor type. For example Red Hat
> Enterprise Linux host to Red Hat Virtualization Host. To install a different
> hypervisor type, you must remove the host from the environment, install the
> new hypervisor,  and then add it back."
> 
> Regards

Reads OK, thank you.
Comment 18 Byron Gravenorst 2017-07-05 00:35:05 EDT
Moving to ON_QA. See Comment 9 for details.
Comment 19 Tahlia Richardson 2017-07-09 21:02:41 EDT
Reviewed and merged.

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