Bug 1868118

Summary: Add --upgrade flag to inventory plugin installation documentation step
Product: Red Hat Hybrid Cloud Console (console.redhat.com) Reporter: Mike McCune <mmccune>
Component: DocumentationAssignee: Matt Werner <mawerner>
Status: CLOSED NOTABUG QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: unspecifiedCC: ahumbe, mawerner, molasaga, spank
Target Milestone: ---   
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-12-15 14:56:29 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 Mike McCune 2020-08-11 17:52:56 UTC
Description of problem: The installation step here:

https://access.redhat.com/documentation/en-us/red_hat_insights/2020-04/html-single/remediating_issues_across_your_red_hat_satellite_infrastructure_using_red_hat_insights/index#configuring-your-satellite-infrastructure-to-communicate-with-insights


Needs an additional flag to work around an issue we have as noted in the Satellite product (BZ 1863597). Can we get the installation command updated to include the --upgrade flag:


# satellite-installer \
--enable-foreman-plugin-inventory-upload \
--foreman-proxy-plugin-remote-execution-ssh-install-key true \
--upgrade

Comment 4 Mike McCune 2020-11-16 22:07:58 UTC
The bug mentioned above likely won't be fixed until Spring 2021 or later. The --upgrade flag will never actively harm the Satellite even if in future versions it is a NO-OP.

I'd still vote we get this included in the docs, as the time before resolution is still some time from now

Comment 6 Spank McCoy 2020-11-23 20:56:54 UTC
Hi Mike,
Does the --upgrade flag apply to both 6.8 and 6.7, so both instances need the addition?
The document has

     On Satellite Server 6.8 and later, enter the following command:

    # satellite-installer \
    --enable-foreman-plugin-rh-cloud \
    --foreman-proxy-plugin-remote-execution-ssh-install-key true

    On Satellite Server 6.7 and earlier, enter the following command:

    # satellite-installer \
    --enable-foreman-plugin-inventory-upload \
    --foreman-proxy-plugin-remote-execution-ssh-install-key true

Comment 7 Mike McCune 2020-12-04 21:25:25 UTC
no need for the --upgrade flag for 6.8 as it is a noop, we want the --upgrade flag added for 6.7:

     On Satellite Server 6.8 and later, enter the following command:

    # satellite-installer \
    --enable-foreman-plugin-rh-cloud \
    --foreman-proxy-plugin-remote-execution-ssh-install-key true

    On Satellite Server 6.7 and earlier, enter the following command:

    # satellite-installer \
    --enable-foreman-plugin-inventory-upload \
    --foreman-proxy-plugin-remote-execution-ssh-install-key true \
    --upgrade

Comment 9 Mike McCune 2020-12-14 22:34:32 UTC
Received reports from a customer that the docs link above is missing the \ in the command here after "--foreman-proxy-plugin-remote-execution-ssh-install-key true"

see:


# satellite-installer \
--enable-foreman-plugin-inventory-upload \
--foreman-proxy-plugin-remote-execution-ssh-install-key true
--upgrade

this should be:


# satellite-installer \
--enable-foreman-plugin-inventory-upload \
--foreman-proxy-plugin-remote-execution-ssh-install-key true \
--upgrade


This means customers copy-pasting the command do not get the --upgrade line in the pasted command and the upgrade command is not issued. Can we get this corrected?

Comment 10 Spank McCoy 2020-12-15 13:19:04 UTC
This correction will be completed today, 15 Dec 2020.