13.2. Configuring the Foreman Discovery Plug-in

Procedure 13.1. To Configure the Foreman Discovery Plug-in:

1. Click Hosts Provisioning templates and edit the PXELinux global default template. Add the following entries at the end of the template:

   LABEL discovery
   MENU LABEL Foreman Discovery
   MENU DEFAULT
   KERNEL boot/foreman-discovery-image-latest.el6.iso-vmlinuz
   APPEND rootflags=loop initrd=boot/foreman-discovery-image-latest.el6.iso-img root=live:/foreman.iso rootfstype=auto ro rd.live.image rd.live.check rd.lvm=0 rootflags=ro crashkernel=128M elevator=deadline max_loop=256 rd.luks=0 rd.md=0 rd.dm=0 rd.bootif=0 rd.neednet=0 nomodeset selinux=0 stateless foreman.url=FOREMAN_URL
   IPAPPEND 2
   

   The foreman.url option on the APPEND line identifies the location of the Foreman instance. Ensure that this is set correctly in global settings or the discovered hosts will not register to Foreman.
   The IPAPPEND 2 option is important because it adds the BOOTIF=MAC option. This is reported by Facter as discovery_bootif, which is a key fact used for provisioning. It is expected that the interface that it is booted from will be the provisioning interface as well. The same interface is used as the primary interface and is used to retrieve DNS configuration from DHCP.
2. Set the ONTIMEOUT parameter to discovery to make the foreman.url option the default:

   ONTIMEOUT discovery

   Alternatively, the discovery image can search for a DNS SRV record called _x­foreman._tcp. If the DNS server is configured for this, do not configure the foreman.url option because it will override the DNS SRV record. The following is an example of the configuration for the ISC DNS server:

   _x­foreman._tcp SRV 0 5 443 foreman

3. Click Hosts Provisioning templates and then click Build PXE Default to deploy the configuration file on the TFTP server.

   Important

   The Foreman Discovery image does not support SELinux. Set selinux=0 in the template. The discovery image is read-only.