Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Puppet automation software discovery

Discovery identifies Puppet Masters running on UNIX servers.

Discovery uses secure shell (SSH) commands to collect information.

To access Puppet Master records, navigate to All > Configuration > Automation Servers > Puppet Masters. You can view the resources in the related list of the Puppet Master record.

How the Puppet Master probe works

Discovery identifies the Puppet Master using the following process:

  1. The UNIX - Active Processes probe detects a running process that matches one of the following criteria:
    • The name of the process is pe-httpd.
    • The name of the process is ruby and the parameters of the process contain puppet master.
  2. If there is a match on one of these criteria:
    • A record is created in the Puppet Master table [cmdb_ci_puppet_master] if one does not already exist for that running process.
    • The Puppet - Master Info probe is triggered. The sensor of this probe populates additional information in the Puppet Master [cmdb_ci_puppet_master] record.

Requirements to discover a Puppet master

By default, Discovery identifies Puppet Masters running on UNIX servers. Discovery uses secure shell (SSH) commands to collect information.

The credentials used to discover the UNIX server must have privileges to execute the following commands. The use of sudo is supported, but you must add the must_sudo parameter to the probe.

ProbeCommands
Puppet – Master Infopuppet, echo, hostname (within the Borne shell script)
Puppet – Certificate Requestspuppet
Puppet – Manifestsecho, sed, find (within the Bourne shell script)
Puppet – Modulespuppet

Data collected

    
NamePuppet Master [cmdb_ci_puppet_master]namePuppet - Master Info
Configuration directoryPuppet Master [cmdb_ci_puppet_master]config_directoryPuppet - Master Info
Manifest directoryPuppet Master [cmdb_ci_puppet_master]manifestdirPuppet - Master Info
Module pathPuppet Master [cmdb_ci_puppet_master]modulepathPuppet - Master Info
Fully qualified domain namePuppet Master [cmdb_ci_puppet_master]fqdnPuppet - Master Info
IP AddressPuppet Master [cmdb_ci_puppet_master]ip_addressPuppet - Master Info
VersionPuppet Master [cmdb_ci_puppet_master]versionPuppet - Master Info

Parent Topic:Software discovery