Bug 1745324

Summary: Deprecate rhv-guest-tools-iso in favor of virtio-win-guest-tools
Product: Red Hat Enterprise Virtualization Manager Reporter: Gal Zaidman <gzaidman>
Component: DocumentationAssignee: Steve Goodman <sgoodman>
Status: CLOSED CURRENTRELEASE QA Contact: Rolfe Dlugy-Hegwer <rdlugyhe>
Severity: medium Docs Contact:
Priority: medium    
Version: 4.4.0CC: dfediuck, jcall, jherrman, lsurette, mkalinin, pkovar, rdlugyhe, rhodain, sbonazzo, sgoodman, srevivo
Target Milestone: ovirt-4.3.11Keywords: Documentation, NoDocsQEReview
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Deprecated Functionality
Doc Text:
The rhv-guest-tools-iso package is deprecated and will be replaced in Red Hat Virtualization 4.4 by virtio-win-guest-tools iso image. For information, see link:https://access.redhat.com/solutions/4899411[How can I install RHV Windows guest tools in RHEV 4.4?].
Story Points: ---
Clone Of: Environment:
Last Closed: 2020-07-16 10:48:09 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: Integration RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On: 1745298    
Bug Blocks: 1658061, 1659067, 1713700, 1717848    

Description Gal Zaidman 2019-08-25 12:00:34 UTC
At the current state the project is an Installshield based installer which installs the virtio-win drivers and relevant agents, the project is different from the U/S guest tools.

On 4.4 we intend to move away from that split and use the new virtio-win Wix toolset based msi installer which will be provided inside the virtio-win iso.

Comment 1 Steve Goodman 2019-11-06 08:51:24 UTC
Marina,

Because the functionality will be replaced in 4.4, but there is no current replacement, a deprecation notice is not appropriate now. However, customers need some prior notification that this change will take place.

Martin suggested that a KB article would be appropriate right now to make this announcement and give our users a heads-up, and then once it's done, we can add a Release Note to announce it in the product.

I assigned this to you for now to create a KB article, and a new BZ should be created, assigned to me, to make a release note in the release where the change appears.

Let us know what you think.

Comment 2 RHEL Program Management 2019-11-06 08:51:32 UTC
The documentation text flag should only be set after 'doc text' field is provided. Please provide the documentation text and set the flag to '?' again.

Comment 4 Marina Kalinin 2020-02-28 21:01:38 UTC
Hi,

I am confused for what is the ask here?
Is it about deprecating the previous installer? But aren't we going to have a 1:1 feature match replacement wiht the installshield?

Is this process going to be changed/deprecated?
https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.3/html-single/virtual_machine_management_guide/index#Installing_the_Guest_Agents_and_Drivers_on_Windows

Comment 5 Gal Zaidman 2020-03-01 07:57:22 UTC
(In reply to Marina Kalinin from comment #4)
> Hi,
> 
> I am confused for what is the ask here?
> Is it about deprecating the previous installer? But aren't we going to have
> a 1:1 feature match replacement wiht the installshield?
> 

Yes there is but the process is a bit different, the diffs can be found at the docs but in general:
- user needs to select to msi for his arch.
- user needs to install qemu-ga separately for now.
- user needs to select ovirt-ga from the installer.

> Is this process going to be changed/deprecated?
> https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.3/
> html-single/virtual_machine_management_guide/
> index#Installing_the_Guest_Agents_and_Drivers_on_Windows

Steve can sand you a link to the docs changes

Comment 15 Steve Goodman 2020-07-09 14:16:35 UTC
I spoke with Marina. We decided two things:

1. I'll add a deprecation notice to the 4.3.11 Release Notes in the Deprecated Features.
2. Sandro, we need a bug for 4.4 to create an enhancement note in the 4.4 Release Notes.
3. Marina will edit the KCS in comment 7.

Comment 16 Steve Goodman 2020-07-09 14:36:49 UTC
Here's the deprecation notice I'll add:

rhv-guest-tools.iso | The rhv-guest-tools iso image will be replaced in Red Hat Virtualization 4.4 by virtio-win-guest-tools iso image.

Comment 17 Steve Goodman 2020-07-09 15:35:20 UTC
Create new merge request:
https://gitlab.cee.redhat.com/rhci-documentation/docs-Red_Hat_Enterprise_Virtualization/-/merge_requests/1706

Rolfe please do peer review.

Comment 18 Steve Goodman 2020-07-09 15:54:33 UTC
Marina updated the article mentioned in comment 7.

Comment 19 Marina Kalinin 2020-07-09 16:08:08 UTC
(In reply to Steve Goodman from comment #15)
> I spoke with Marina. We decided two things:
> 
> 1. I'll add a deprecation notice to the 4.3.11 Release Notes in the
> Deprecated Features.
> 2. Sandro, we need a bug for 4.4 to create an enhancement note in the 4.4
> Release Notes.
> 3. Marina will edit the KCS in comment 7.

Thanks, Steve, for all the efforts! We finally got it straight, I believe.
Here is the updated KCS:
https://access.redhat.com/solutions/4899411.

Comment 22 Steve Goodman 2020-07-16 10:48:09 UTC
Published to 4.3 Release Notes.