Unattended Provisioning Troubleshooting

Below are some topics and troubleshooting steps that you may encounter while using the unattended provisioning. Please add topics or provide answers if you can.

Host is stuck in PXEboot cycle after provisioning.

libvirt

PXELinux is broken on some systems for versions >= 4.02.

If new host fails to boot from the local hard disk, try to replace "LOCALBOOT 0" with "LOCALBOOT -1" in your PXE default template;
If this does not help you can try "chain.c32 hd0,0" instead.

Host did not get the provision file

If your host can't get the provision file check your apache config. The foreman configuration should be in a file called foreman.conf. There you have the vHost configuration for HTTP and HTTPS access. If you have multiple interfaces in your foreman server, you must make sure that the right IP address under which the host tries to access the foreman server is configured here. You may also configure apache to listen on all interfaces by using the * wildcard. Your foreman.conf should look similar to

<VirtualHost *:80>
  ServerName foreman.my.domain
  ServerAlias foreman
  DocumentRoot /usr/share/foreman/public
  PassengerAppRoot /usr/share/foreman/
  RailsAutoDetect On
  AddDefaultCharset UTF-8
</VirtualHost>

<VirtualHost *:443>
  ServerName foreman.my.domain
  ServerAlias foreman

  RailsAutoDetect On
  DocumentRoot /usr/share/foreman/public
  PassengerAppRoot /usr/share/foreman/

  # Use puppet certificates for SSL

  SSLEngine On
  SSLCertificateFile      /var/lib/puppet/ssl/certs/mycert.pem
  SSLCertificateKeyFile   /var/lib/puppet/ssl/private_keys/mykey.pem
  SSLCertificateChainFile /var/lib/puppet/ssl/certs/ca.pem
  SSLCACertificateFile    /var/lib/puppet/ssl/certs/ca.pem
  SSLVerifyClient         optional
  SSLOptions              +StdEnvVars
  SSLVerifyDepth          3
</VirtualHost>

If your system failed to retrieve the kickstart file it may be due to the fact that the template build failed.

Use the spoof parameter by pointing your browser to a url similar to:

http://foreman/unattended/provision?spoof=123.321.123.321
  • 123.321.123.321 is the hosts IP Address (the one you want to build).
  • usually you want to see the page source, the browser might display the file in html which will result in hard to read output.
  • the completed template will be displayed or any errors that were encountered while the template was being built.

Some questions did not get answered by the provision file.

Provision file is using the wrong installation media server.