Bug 1781908

Summary:	Related to Subscription Watch - Wrong Satellite instructions for Installing Inventory Plugin
Product:	Red Hat Hybrid Cloud Console (console.redhat.com)	Reporter:	Christian Marineau <cmarinea>
Component:	Documentation	Assignee:	Anni Bond <anbond>
Status:	CLOSED CURRENTRELEASE	QA Contact:	satellite-doc-list
Severity:	high	Docs Contact:
Priority:	unspecified
Version:	unspecified	CC:	anbond, dvoss, ktordeur, sokeeffe, spetrosi
Target Milestone:	---	Keywords:	PrioBumpPM, Reopened, SubscriptionExperience
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2020-05-06 13:28:18 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Christian Marineau 2019-12-10 21:32:48 UTC

Document URL: 
https://access.redhat.com/documentation/en-us/subscription_central/2019-11/html-single/getting_started_with_the_subscription_watch_pilot/index#proc-installing-satellite-inventory-upload-plugin_assembly-setting-up-subscriptionwatch-ctxt

https://access.redhat.com/documentation/en-us/subscription_central/2019-11/html-single/getting_started_with_subscription_watch_pilot_with_simple_content_access/index#proc-installing-satellite-inventory-upload-plugin_assembly-setting-up-subscriptionwatch-simplecontent-ctxt

Section Number and Name: 
Chapter 9. Installing the Satellite inventory upload plugin

Describe the issue: 
The instructions given will work under Satellite 6.5, but not under Satellite 6.6. In 6.6, yum will report: Nothing to do


Suggestions for improvement: 
We should have 2 different instruction: 1 for Satellite 6.5 and another for Satellite 6.6+

For 6.6, the right command should look like this:
foreman-maintain packages install tfm-rubygem-foreman_inventory_upload-*


Additional information: 
Since calling foreman-maintain will trigger additional steps, we should warn customer that Satellite will be down during the execution of foreman-maintain.

Comment 6 Dave Johnson 2019-12-12 15:15:34 UTC

Please assess the impact of this issue and update the severity accordingly.  Please refer to https://bugzilla.redhat.com/page.cgi?id=fields.html#bug_severity for a reminder on each severity's definition.

If it's something like a tracker bug where it doesn't matter, please set the severity to Low.

Comment 7 Sergei Petrosian 2019-12-12 15:46:46 UTC

As on Satellite 6.6 and later the yum command will fail, however, return the solution, I am setting the severity to medium. The documentation now is incorrect but is not catastrophic.

~~~~
# yum install tfm-rubygem-foreman_inventory_upload-*

WARNING: Excluding 15451 updates due to foreman-protector. 
Use foreman-maintain packages install/update <package> 
to safely install packages without restrictions.
Use foreman-maintain upgrade run for full upgrade.

Error: Nothing to do
~~~~

Comment 9 Anni Bond 2019-12-19 16:02:42 UTC

The docs update has been made to the repository.

Comment 11 Anni Bond 2020-01-13 15:08:31 UTC

Since I tried to clarify and still misunderstood the first time, can I clarify that:
1 - The original wording worked for Satellite 6.5.
2 - The current wording works for Satellite 6.6.

Is there anything else I am missing? Thanks

Comment 12 Sergei Petrosian 2020-01-13 18:46:06 UTC

Hi Anni,

yes, you are correct. The request was to turn the step to something like this:

~~~~
1. Install the Satellite inventory upload plugin on the Satellite Server:
* On Satellite Server 6.5 and lower, enter the following command:
# yum install tfm-rubygem-foreman_inventory_upload-*

* On Satellite Server 6.6 and higher, enter the following command:
# foreman-maintain packages install tfm-rubygem-foreman_inventory_upload-*
~~~~

Thank you

Comment 14 Sergei Petrosian 2020-04-15 08:56:12 UTC

Update in command:
> * On Satellite Server 6.6 and higher, enter the following command:
> # foreman-maintain packages install tfm-rubygem-foreman_inventory_upload-*
> ~~~~
This has been changed for Satellite 6.6 and higher, the command is now the following:
# satellite-maintain packages install tfm-rubygem-foreman_inventory_upload-*

Thank you

Comment 15 Anni Bond 2020-05-06 13:28:18 UTC

That change has been requested to merge. Thank you!