11.5. Troubleshooting Satellite Discovery
If a machine does not show up correctly in the Satellite web UI under Hosts → Discovered Hosts, inspect the following configuration areas to help isolate the error:
- Try redeploying the default PXE Linux template.
- Verify the
pxelinux.cfg/defaultconfiguration file on the TFTP Capsule Server.
- Ensure adequate network connectivity between hosts, the Capsule Server, and the Satellite Server.
- Verify the
proxy.typeoptions in the default PXE Linux template.
- Ensure that the DNS is working correctly for that image, or use an IP address in the
proxy.urloption in the default PXE Linux template.
- Ensure that the DHCP server is delivering IP addresses to the booted image correctly.
- Ensure the discovered host (or virtual machine) has at least 500 MB of memory. Less memory can lead to various random kernel panic errors as the image needs to be extracted in-memory.
For gathering important system facts, use the
discovery-debugcommand. It prints out system logs, network configuration, list of facts, and other information on the standard output. The typical use case is to redirect this output and copy it with the
scpcommand for further investigation.
The first virtual console on the discovered host is reserved for systemd logs. Particularly useful system logs are tagged as follows:
- discover-host - initial facts upload
- foreman-discovery - facts refresh, reboot remote commands
- nm-prepare - boot script which pre-configures NetworkManager
- NetworkManager - networking information
Use TTY2 or higher to log in to a discovered host. The root account and SSH access are disabled by default, but you can enable SSH and set the root password using the following kernel command-line options in the Default PXELinux template on the APPEND line: