Bug 2229943

Summary:	[DDF] Section '3.2. Preparing a Satellite-registered system for the upgrade' of the docs, Procedure step 3:
Product:	Red Hat Enterprise Linux 9	Reporter:	Direct Docs Feedback <ddf-bot>
Component:	Documentation	Assignee:	Miriam Portman <mportman>
Documentation sub component:	DDF	QA Contact:
Status:	NEW ---	Docs Contact:
Severity:	unspecified
Priority:	high	CC:	aperotti, mdolezel, pstodulk, rfurlan, rhel-docs
Version:	unspecified	Keywords:	Documentation
Target Milestone:	rc
Target Release:	---
Hardware:	All
OS:	All
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:		Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Direct Docs Feedback 2023-08-08 09:09:25 UTC

Section '3.2. Preparing a Satellite-registered system for the upgrade' of the docs, Procedure step 3:
Enable and synchronize all required RHEL 8 and RHEL 9 repositories on the Satellite Server with the latest updates for the source and target OS versions.

`x86_64 8 or `

Instead of:

`x86_64 `

As an example, in case the Satellite registered host is 8.6, if the generic `8` version of the repository is selected, when the host performs the release set (section 3.1 step 5) it will fail with an error:

# subscription-manager release --set 8.6
No releases match '8.6'.  Consult 'release --list' for a full listing.

This might work if the host is registered to the CDN but it won't with Satellite.

Reported by: rhn-support-rfurlan

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/upgrading_from_rhel_8_to_rhel_9/assembly_preparing-for-the-upgrade_upgrading-from-rhel-8-to-rhel-9#annotations:a4333988-0241-4c7a-a70f-77f57a0daf74

Comment 1 Riccardo Furlan 2023-08-08 09:12:44 UTC

For some reason the text in the <> tags disappeared in the direct feedback form, adding the complete text:

Section '3.2. Preparing a Satellite-registered system for the upgrade' of the docs, Procedure step 3:
Enable and synchronize all required RHEL 8 and RHEL 9 repositories on the Satellite Server with the latest updates for the source and target OS versions.

`x86_64 8 or <source_os_version>`

Instead of:

`x86_64 <source_os_version>`

As an example, in case the Satellite registered host is 8.6, if the generic `8` version of the repository is selected, when the host performs the release set (section 3.1 step 5) it will fail with an error:

# subscription-manager release --set 8.6
No releases match '8.6'.  Consult 'release --list' for a full listing.

This might work if the host is registered to the CDN but it won't with Satellite.