Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Red Hat Satellite engineering is moving the tracking of its product development work on Satellite to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "Satellite project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs will be migrated starting at the end of May. If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "Satellite project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/SAT-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

Bug 2089339

Summary:	please update Provisioning Guide (esp 7.8. Building a Discovery Image) for pulp3 usage
Product:	Red Hat Satellite	Reporter:	Patrick C. F. Ernzer <pcfe>
Component:	Documentation	Assignee:	Malhar Jivrajani <mjivraja>
Documentation sub component:	default	QA Contact:
Status:	CLOSED WONTFIX	Docs Contact:
Severity:	urgent
Priority:	urgent	CC:	lucas.blenkhorn, mdolezel, mjivraja, momran, saydas, zuansorg
Version:	6.10.0
Target Milestone:	Unspecified
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:	2023-04-17 16:44:00 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 Patrick C. F. Ernzer 2022-05-23 13:18:31 UTC

Document URL: https://access.redhat.com/documentation/en-us/red_hat_satellite/6.10/html/provisioning_guide/configuring-the-discovery-service#building-a-discovery-image

Section Number and Name: 7.8. Building a Discovery Image

Describe the issue: provided instructions outdated.
we tell the user to consume
~~~
repo --name=rhel --baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7.7/x86_64
repo --name=sat --baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/sat-capsule/6.10/os
~~~

But with pulp3 these paths are no longer correct.

Comment 3 Malhar Jivrajani 2022-08-18 06:52:06 UTC

Link to the PR: https://github.com/theforeman/foreman-documentation/pull/1572

Comment 7 Sayan Das 2022-11-05 17:41:46 UTC

I have tested my suggested approach in Satellite 6.11.3 and 6.11.4 on RHEL 7:

** Install Discovery image and livecd-tools

# yum install foreman-discovery-image livecd-tools --disableplugin=foreman-protector 


** Enable the following repos in satellite UI.

# hammer --csv repository list --fields Id,Name | column -s, -t
Id  Name
5   Red Hat Enterprise Linux 7 Server Kickstart x86_64 7.9
28  Red Hat Enterprise Linux 7 Server - Optional RPMs x86_64 7Server
8   Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
11  Red Hat Satellite 6.11 for RHEL 7 Server RPMs x86_64
31  Red Hat Software Collections RPMs for Red Hat Enterprise Linux 7 Server x86_64 7Server


** Set their download policy to Immediate, and sync them.

** Once they are synced, export the repos in syncable way. [ this does not consumes additional space as it uses hardlinks of preexisting content ]

# hammer content-export complete repository --format syncable --id 5
[.................................................................................................................................................................] [100%]
Generated /var/lib/pulp/exports/Org_1/Export-Red_Hat_Enterprise_Linux_7_Server_Kickstart_x86_64_7_9-5/1.0/2022-11-04T17-49-32-01-00

# hammer content-export complete repository --format syncable --id 8
[.................................................................................................................................................................] [100%]
Generated /var/lib/pulp/exports/Org_1/Export-Red_Hat_Enterprise_Linux_7_Server_RPMs_x86_64_7Server-8/2.0/2022-11-04T17-50-00-01-00

# hammer content-export complete repository --format syncable --id 11
[.................................................................................................................................................................] [100%]
Generated /var/lib/pulp/exports/Org_1/Export-Red_Hat_Satellite_6_11_for_RHEL_7_Server_RPMs_x86_64-11/1.0/2022-11-04T18-51-00-01-00

# hammer content-export complete repository --format syncable --id 28
[.................................................................................................................................................................] [100%]
Generated /var/lib/pulp/exports/Org_1/Export-Red_Hat_Enterprise_Linux_7_Server_-_Optional_RPMs_x86_64_7Server-28/1.0/2022-11-05T15-24-05-01-00

# hammer content-export complete repository --format syncable --id 31
[.................................................................................................................................................................] [100%]
Generated /var/lib/pulp/exports/Org_1/Export-Red_Hat_Software_Collections_RPMs_for_Red_Hat_Enterprise_Linux_7_Server_x86_64_7Server-31/1.0/2022-11-05T17-58-38-01-00


** Setup the discovery kickstart:

# cd /usr/share/foreman-discovery-image
# cp -p foreman-discovery-image.ks foreman-discovery-image-custom.ks

# vi foreman-discovery-image-custom.ks

Replace the existing "repo --name" line and add these five exported repos at the top of the file in this way i.e. 

# head -5 foreman-discovery-image-custom.ks
repo --name=rhel --baseurl=file:///var/lib/pulp/exports/Org_1/Export-Red_Hat_Enterprise_Linux_7_Server_RPMs_x86_64_7Server-8/2.0/2022-11-04T17-50-00-01-00/content/dist/rhel/server/7/7Server/x86_64/os/
repo --name=kickstart --baseurl=file:///var/lib/pulp/exports/Org_1/Export-Red_Hat_Enterprise_Linux_7_Server_Kickstart_x86_64_7_9-5/1.0/2022-11-04T17-49-32-01-00/content/dist/rhel/server/7/7.9/x86_64/kickstart/
repo --name=sat --baseurl=file:///var/lib/pulp/exports/Org_1/Export-Red_Hat_Satellite_6_11_for_RHEL_7_Server_RPMs_x86_64-11/1.0/2022-11-04T18-51-00-01-00/content/dist/rhel/server/7/7Server/x86_64/satellite/6.11/os/
repo --name=optional --baseurl=file:///var/lib/pulp/exports/Org_1/Export-Red_Hat_Enterprise_Linux_7_Server_-_Optional_RPMs_x86_64_7Server-28/1.0/2022-11-05T15-24-05-01-00/content/dist/rhel/server/7/7Server/x86_64/optional/os/
repo --name=scl --baseurl=file:///var/lib/pulp/exports/Org_1/Export-Red_Hat_Software_Collections_RPMs_for_Red_Hat_Enterprise_Linux_7_Server_x86_64_7Server-31/1.0/2022-11-05T17-58-38-01-00/content/dist/rhel/server/7/7Server/x86_64/rhscl/1/os/


** Generate the ISO:

# livecd-creator --title="Discovery-Image" --compression-type=xz --cache=var/cache/build-fdi --config /usr/share/foreman-discovery-image/foreman-discovery-image-custom.ks --fslabel fdi --tmpdir /var/tmp

** Make it network-bootable:

# isohybrid --partok fdi.iso
# isohybrid --partok --uefi fdi.iso
# implantisomd5 fdi.iso


I have also tested by Discovering a VM using this new ISO and it works fine. 





Now, if we have to do a similar thing for Satellite 6.11.3+\ 6.12 on RHEL 8 OS to get a FDI build on RHEL 8, then in this exact same way, The following repos needs to be processed:

Red Hat Satellite 6.11 for RHEL 8 x86_64 RPMs
Red Hat Enterprise Linux 8 for x86_64 - BaseOS Kickstart 8.6
Red Hat Enterprise Linux 8 for x86_64 - AppStream RPMs 8.6
Red Hat Enterprise Linux 8 for x86_64 - BaseOS RPMs 8
Red Hat Enterprise Linux 8 for x86_64 - AppStream RPMs 8

And then further synced, exported and mentioned in the kickstart file.

Since there are no livecd-creator present in RHEL 8 or above, lorax needs to be installed and "livemedia-creator" command needs to be used to build the image. 

But here the challenge :

A) We don't ship a el8\rhel-8 based discovery image or kickstart , neither in Sat 6.11 nor in upcoming sat 6.12 i.e. the files in /usr/share/foreman-discovery-image are RHEL 7 specific. 

B) Due to A, It's hard for the end user to figure out how and what exact changes they need to make in the kickstart for RHEL 8 based FDI. 

e.g. like including the module directives after the repos:

module --name=ruby --stream=2.7
module --name=postgresql --stream=12
module --name=foreman --stream=el8

and many more. 


C) We will also need to provide the full livemedia-creator command with correct options for the end-users to copy and execute.


So for FDI on a el8 version, either Sat eng team needs to be provide further instructions ( https://bugzilla.redhat.com/show_bug.cgi?id=1990875#c19 ) or else users need to be redirected to https://github.com/theforeman/foreman-discovery-image along with some instrcutions about how to use RHEL 8 repos instead of CentOS repos.