Bug 2143777

Summary: Update Satellite and Capsule upgrade steps to use satellite-maintain self-upgrade instead of maintenance repo enable
Product: Red Hat Satellite Reporter: Gaurav Talreja <gtalreja>
Component: UpgradesAssignee: satellite6-bugs <satellite6-bugs>
Status: CLOSED MIGRATED QA Contact: Satellite QE Team <sat-qe-bz-list>
Severity: high Docs Contact:
Priority: high    
Version: 6.12.0CC: agadhave, ehelms
Target Milestone: UnspecifiedKeywords: Documentation, MigratedToJIRA, Reopened, Triaged
Target Release: Unused   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2024-06-06 12:55:26 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 Gaurav Talreja 2022-11-17 20:19:01 UTC
Document URL:

Section Number and Name:
3.1.1. Upgrading a Connected Satellite Server
3.1.2. Upgrading a Disconnected Satellite Server
3.3. Upgrading Capsule Servers (updated earlier in BZ 2096950)
6.1. Updating Satellite Server
6.2. Updating Disconnected Satellite Server
6.3. Updating Capsule Server

Describe the issue:
There is no need to enable the maintenance repository now as thats being handled by the satellite-maintain.

Suggestions for improvement:

Need to remove:

# subscription-manager repos --enable \
satellite-maintenance-6.12-for-rhel-8-x86_64-rpms
and use below command for connected setup,

#satellite-maintain self-upgrade

And for disconnected setup,

satellite-maintain self-upgrade --maintenance-repo-label <6.12-maintenance-repo-label>


Additional information:
Earlier for 6.11, it was updated only for the capsule upgrade step, and other sections were missing in this https://bugzilla.redhat.com/show_bug.cgi?id=2096950 , so mentioned sections need an update for both 6.11 and 6.12 docs

Comment 1 Marie Hornickova 2022-11-18 09:57:57 UTC
Hello Gaurav,

Many thanks for reporting this issue.

The BZ has been assigned and the docs team will keep informing about any progress on the fix in this ticket.

Thank you!

Comment 4 Gaurav Talreja 2024-01-04 10:04:48 UTC
Hi Eric, documentation still contains explicit steps for module enable "dnf module enable satellite-maintenance:el8"  and maintenance repo enable "subscription-manager repos --enable satellite-maintenance-6.14-for-rhel-8-x86_64-rpms", which could be done as part of "satellite-maintain self-upgrade" command itself for y-stream upgrades, so shouldn't we document it instead?

Also, we are recommending self-upgrade in Capsule upgrade guide, and its missing in Satellite upgrade guide, which is inconsistent as of now, so I don't think this should be closed as NOTABUG here, I would like to hear your opinion on this,
https://access.redhat.com/documentation/en-us/red_hat_satellite/6.14/html/upgrading_red_hat_satellite_to_6.14/upgrading_satellite#upgrading_capsule_server_upgrade-guide

Comment 5 Eric Helms 2024-06-06 12:55:26 UTC
This BZ has been automatically migrated to the issues.redhat.com Red Hat Issue Tracker. All future work related to this report will be managed there.

Due to differences in account names between systems, some fields were not replicated.  Be sure to add yourself to Jira issue's "Watchers" field to continue receiving updates and add others to the "Need Info From" field to continue requesting information.

To find the migrated issue, look in the "Links" section for a direct link to the new issue location. The issue key will have an icon of 2 footprints next to it, and begin with "SAT-" followed by an integer.  You can also find this issue by visiting https://issues.redhat.com/issues/?jql= and searching the "Bugzilla Bug" field for this BZ's number, e.g. a search like:

"Bugzilla Bug" = 1234567

In the event you have trouble locating or viewing this issue, you can file an issue by sending mail to rh-issues. You can also visit https://access.redhat.com/articles/7032570 for general account information.

Comment 6 Red Hat Bugzilla 2024-10-05 04:25:37 UTC
The needinfo request[s] on this closed bug have been removed as they have been unresolved for 120 days