Bug 1923169

Summary:	Ansible 2.9 channel is no longer required for RHV 4.4.5 and should be removed from RHV 4.4 documentation
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Martin Perina <mperina>
Component:	Documentation	Assignee:	Richard Hoch <rhoch>
Status:	CLOSED CURRENTRELEASE	QA Contact:	rhev-docs <rhev-docs>
Severity:	high	Docs Contact:
Priority:	high
Version:	4.4.4	CC:	aspauldi, ctomasko, emarcus, gdeolive, lsurette, mhicks, mkalinin, rhoch, sgoodman, srevivo
Target Milestone:	ovirt-4.4.5	Keywords:	Documentation, NoDocsQEReview
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Known Issue
Doc Text:	Limiting package subscriptions to the Ansible 2.9 channel is not required for Red Hat Virtualization 4.4.5 installation. Workaround: Remove the Ansible 2.9 channel subscription on Red Hat Virtualization Manager and Red Hat Virtualization hosts when upgrading from Red Hat Virtualization version 4.4.4 or lower.	Story Points:	---
Clone Of:		Environment:
Last Closed:	2021-03-30 14:42:09 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	Infra	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1917409
Bug Blocks:

Description Martin Perina 2021-02-01 13:59:33 UTC

As described in BZ1917409 RHV 4.4.5 includes ansible package within its own channels, so we need to remove channel ansible-2.9-for-rhel-8-x86_64-rpms from RHV 4.4 documentation and also mention in release notes, that customers should remove this channels on both RHV Manager and RHEL-H hosts when upgrading from RHV <= 4.4.4

Here are links to documentation where ansible-2.9-for-rhel-8-x86_64-rpms should be removed:

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_command_line/installing_the_self-hosted_engine_deployment_host_she_cli_deploy#Enabling_the_Red_Hat_Enterprise_Linux_Host_Repositories_SHE_deployment_host

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_cockpit_web_interface/installing_the_red_hat_virtualization_manager_she_cockpit_deploy#Enabling_the_Red_Hat_Virtualization_Manager_Repositories_install_RHVM

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_cockpit_web_interface/installing_hosts_for_rhv_she_cockpit_deploy#Enabling_the_Red_Hat_Enterprise_Linux_Host_Repositories_SHE_cockpit_deploy

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_cockpit_web_interface/migrating_to_remote_servers_she_cockpit_deploy#Migrating_the_Data_Warehouse_Service_to_a_Separate_Machine_migrate_DWH

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_command_line/installing_the_self-hosted_engine_deployment_host_she_cli_deploy#Enabling_the_Red_Hat_Enterprise_Linux_Host_Repositories_SHE_deployment_host

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_command_line/installing_the_red_hat_virtualization_manager_she_cli_deploy#Enabling_the_Red_Hat_Virtualization_Manager_Repositories_install_RHVM

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_command_line/installing_hosts_for_rhv_she_cli_deploy#Enabling_the_Red_Hat_Enterprise_Linux_Host_Repositories_SHE_cli_deploy

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_command_line/migrating_to_remote_servers_she_cli_deploy#Migrating_the_Data_Warehouse_Service_to_a_Separate_Machine_migrate_DWH

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_standalone_manager_with_local_databases/installing_the_red_hat_virtualization_manager_sm_localdb_deploy#Enabling_the_Red_Hat_Virtualization_Manager_Repositories_install_RHVM

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_standalone_manager_with_local_databases/installing_hosts_for_rhv_sm_localdb_deploy#Enabling_the_Red_Hat_Enterprise_Linux_Host_Repositories_SM_localDB_deploy

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_standalone_manager_with_local_databases/configuring_an_offline_repository_for_red_hat_virtualization_manager_installation_sm_localdb_deploy

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_standalone_manager_with_remote_databases/installing_the_red_hat_virtualization_manager_sm_remotedb_deploy#Enabling_the_Red_Hat_Virtualization_Manager_Repositories_install_RHVM

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_standalone_manager_with_remote_databases/installing_hosts_for_rhv_sm_remotedb_deploy#Enabling_the_Red_Hat_Enterprise_Linux_Host_Repositories_SM_remoteDB_deploy

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/installing_red_hat_virtualization_as_a_standalone_manager_with_remote_databases/configuring_an_offline_repository_for_red_hat_virtualization_manager_installation_sm_remotedb_deploy

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/upgrade_guide/updating_individual_hosts_minor_updates

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/upgrade_guide/manually_updating_hosts_minor_updates

There might be other places which I missed, but in general ansible-2.9-for-rhel-8-x86_64-rpms should not be present in any RHV 4.4 documentation

Comment 1 Richard Hoch 2021-02-23 16:17:19 UTC

Martin,

Excellent list. Thank you.

Just to be sure, in section 1.2.1 of the Release Notes, in table 1.1.,should I remove the 4th row, "Red Hat Ansible Engine," entirely or replace its contents with other values in the cells? If other values, what should they be? https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html/release_notes/sect-subscriptions#Red_Hat_Subscription_Manager_Subscriptions_and_Repositories

Comment 2 Martin Perina 2021-03-10 12:53:51 UTC

(In reply to Richard Hoch from comment #1)
> Martin,
> 
> Excellent list. Thank you.
> 
> Just to be sure, in section 1.2.1 of the Release Notes, in table 1.1.,should
> I remove the 4th row, "Red Hat Ansible Engine," entirely or replace its
> contents with other values in the cells? If other values, what should they
> be?
> https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/
> html/release_notes/sect-
> subscriptions#Red_Hat_Subscription_Manager_Subscriptions_and_Repositories

Yes, channel should be replaced also from this list, I've missed that during my doc evaluation.
Thanks

Comment 3 Martin Perina 2021-03-10 12:54:22 UTC

(In reply to Martin Perina from comment #2)
> (In reply to Richard Hoch from comment #1)
> > Martin,
> > 
> > Excellent list. Thank you.
> > 
> > Just to be sure, in section 1.2.1 of the Release Notes, in table 1.1.,should
> > I remove the 4th row, "Red Hat Ansible Engine," entirely or replace its
> > contents with other values in the cells? If other values, what should they
> > be?
> > https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/
> > html/release_notes/sect-
> > subscriptions#Red_Hat_Subscription_Manager_Subscriptions_and_Repositories
> 
> Yes, channel should be replaced also from this list, I've missed that during
> my doc evaluation.
> Thanks

I mean, remove the whole line around Ansible Engine

Comment 4 Richard Hoch 2021-03-11 12:19:23 UTC

Please review this draft  MR: https://gitlab.cee.redhat.com/rhci-documentation/docs-Red_Hat_Enterprise_Virtualization/-/merge_requests/1917

Comment 5 Martin Perina 2021-03-12 05:41:48 UTC

(In reply to Richard Hoch from comment #4)
> Please review this draft  MR:
> https://gitlab.cee.redhat.com/rhci-documentation/docs-
> Red_Hat_Enterprise_Virtualization/-/merge_requests/1917

Looks good to me, thanks!

Comment 6 Richard Hoch 2021-03-14 08:59:14 UTC

Steve, please review the MR https://gitlab.cee.redhat.com/rhci-documentation/docs-Red_Hat_Enterprise_Virtualization/-/merge_requests/1917

Comment 7 Steve Goodman 2021-03-21 11:36:20 UTC

LGTM.

Merged.

Comment 8 Richard Hoch 2021-03-30 14:42:09 UTC

Published and closed.

Comment 9 Richard Hoch 2021-03-30 14:48:36 UTC

(In reply to Richard Hoch from comment #8)
> Published and closed.

The fixes were published 2 weeks before the planned release of version 4.4.5. It was decided to leave the changes in the documentation set rather than remove them now and reinsert them on the day the version was released.