Bug 2170845 - Example missing for "--foreman-proxy-dhcp-ipxefilename" option in provisioing guide when an external Capsule will be used for iPXE
Summary: Example missing for "--foreman-proxy-dhcp-ipxefilename" option in provisioing...
Keywords:
Status: CLOSED NOTABUG
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Documentation
Version: 6.13.0
Hardware: All
OS: All
medium
medium
Target Milestone: Unspecified
Assignee: Marie Hornickova
QA Contact:
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2023-02-17 12:09 UTC by Sayan Das
Modified: 2023-08-03 17:35 UTC (History)
0 users

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2023-02-19 16:53:43 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker SAT-16005 0 None None None 2023-02-17 12:12:47 UTC

Description Sayan Das 2023-02-17 12:09:35 UTC
Document URL: 

https://dxp-docp-prod.apps.ext-waf.spoke.prod.us-west-2.aws.paas.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/provisioning_hosts/index?lb_target=preview#

Section Number and Name: 

Chapter 5. Configuring iPXE to Reduce Provisioning Times

Point 19 of "5.1. Booting Virtual Machines"

Point 17 of "5.2. Chainbooting iPXE from PXELinux"


Describe the issue: 

We mention what needs to be done with "--foreman-proxy-dhcp-ipxefilename" in case of satellite i.e.

~~~
On Satellite Server, run:

satellite-installer --foreman-proxy-dhcp-ipxefilename "http://satellite.example.com/unattended/iPXE?bootstrap=1"

~~~

But we don't mention anything about capsule. So when user is not using this option on capsule, The dhcpd.conf gets generated with following segment 

if exists user-class and option user-class = "iPXE" {
  filename "http://capsule613.lab.example.com:8000/unattended/iPXE";

which i believe is not correct. 


Suggestions for improvement: 

Assuming my assumption is correct and from what i can see as an example in https://access.redhat.com/documentation/en-us/red_hat_satellite/6.10/html/provisioning_guide/configuring_networking-configuring_gpxe_to_reduce_provisioning_times#booting_virtual_machines ,  I would prpose to add one more point in 6.13 doc , to include 


~~~
In any external capsule Server, run:

satellite-installer --foreman-proxy-dhcp-ipxefilename "http://capsule.example.com:8000/unattended/iPXE?bootstrap=1"

~~~


Additional information: 

We seem to be skipping this part since 6.11 docs. So please confirm with foreman\satellite SMEs if my observation is wrong here or else we should consider my proposal here.

Comment 2 Sayan Das 2023-02-19 16:53:43 UTC
I tested today and It seems, we don't need to do anything extra for External Capsules and the default configuration i.e.

if exists user-class and option user-class = "iPXE" {
  filename "http://capsule613.lab.example.com:8000/unattended/iPXE";


works fine for iPXE or iPXE via PXELinux.


Closing this bug


Note You need to log in before you can comment on or make changes to this bug.