第7章 Configuring the Discovery Service

Red Hat Satellite can detect hosts on a network that are not in your Satellite inventory. These hosts boot the discovery image that performs hardware detection and relays this information back to Satellite Server. This method creates a list of ready-to-provision hosts in Satellite Server without needing to enter the MAC address of each host.

When you boot a blank bare-metal host, the boot menu has two options: local and discovery. If you select discovery to boot the Discovery image, after a few minutes, the Discovery image completes booting and a status screen is displayed.

The Discovery service is enabled by default on Satellite Server. However, the default setting of the global templates is to boot from the local hard drive. To change the default setting, in the Satellite web UI, navigate to Administer > Settings, and click the Provisioning tab. Locate the Default PXE global template entry row, and in the Value column, enter discovery.

PXE mode

To use Satellite Server to provide the Discovery image, install the following RPM packages:

  • tfm-rubygem-foreman_discovery
  • foreman-discovery-image
  • tfm-rubygem-smart_proxy_discovery

The tfm-rubygem-foreman_discovery package contains the Satellite plug-in to handle discovered nodes, connections, and necessary database structures, and API.

The foreman-discovery-image package installs the Discovery ISO to the /usr/share/foreman-discovery-image/ directory. You can build a PXE boot image from this ISO using the livecd-iso-to-pxeboot tool. The tool saves this PXE boot image in the /var/lib/tftpboot/boot directory. For more information, see 「Building a Discovery Image」.

The tfm-rubygem-smart_proxy_discovery package configures Capsule Server, such as the integrated Capsule of Satellite Server, to act as a proxy for the Discovery service.

When the installation completes, you can view the new menu option by navigating to Hosts > Discovered Hosts.

7.1. Installing the Discovery Service

Complete the following procedure to enable the Discovery service on Capsule Server.

Procedure

  1. Enter the following commands on Capsule Server: 

    # satellite-maintain packages install foreman-discovery-image tfm-rubygem-smart_proxy_discovery

  2. Restart the satellite-maintain services: 

    # satellite-maintain service restart
  3. In the Satellite web UI, navigate to Infrastructure > Capsule.
  4. Click the Capsule Server and select Refresh from the Actions list. Locate Discovery in the list of features to confirm the Discovery service is now running.

Subnets

All subnets with discoverable hosts require an appropriate Capsule Server selected to provide the Discovery service.

To check this, navigate to Infrastructure > Capsules and verify if the Capsule Server that you want to use lists the Discovery feature. If not, click Refresh features.

In the Satellite web UI, navigate to Infrastructure > Subnets, select a subnet, click the Capsules tab, and select the Discovery Proxy that you want to use. Perform this for each subnet that you want to use.