---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Puppet automation software

# Puppet automation software discovery {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Discovery identifies Puppet Masters running on UNIX servers.

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

To access Puppet Master records, navigate to AllConfigurationAutomation ServersPuppet 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.
   {#c_PuppetAutomationSoftwareDiscovery__ul_kvm_zvj_3w}
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.
   {#c_PuppetAutomationSoftwareDiscovery__ul_lvm_zvj_3w}
{#c_PuppetAutomationSoftwareDiscovery__ol_jvm_zvj_3w}

## 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.  
{#c_PuppetAutomationSoftwareDiscovery__simpletable_rmx_jvv_cr__entry__2}

| Probe | Commands |
|-|-|
| Puppet -- Master Info | puppet, echo, hostname (within the Borne shell script) |
| Puppet -- Certificate Requests | puppet |
| Puppet -- Manifests | echo, sed, find (within the Bourne shell script) |
| Puppet -- Modules | puppet |
[ ]

{#c_PuppetAutomationSoftwareDiscovery__simpletable_rmx_jvv_cr}

## Data collected {#c_PuppetAutomationSoftwareDiscovery__section_hzw_bd1_bcb}

{#c_PuppetAutomationSoftwareDiscovery__table_asr_wst_cr__entry__4}

|   |   |   |   |
|-|-|-|-|
| Name | Puppet Master \[cmdb_ci_puppet_master\] | name | Puppet - Master Info |
| Configuration directory | Puppet Master \[cmdb_ci_puppet_master\] | config_directory | Puppet - Master Info |
| Manifest directory | Puppet Master \[cmdb_ci_puppet_master\] | manifestdir | Puppet - Master Info |
| Module path | Puppet Master \[cmdb_ci_puppet_master\] | modulepath | Puppet - Master Info |
| Fully qualified domain name | Puppet Master \[cmdb_ci_puppet_master\] | fqdn | Puppet - Master Info |
| IP Address | Puppet Master \[cmdb_ci_puppet_master\] | ip_address | Puppet - Master Info |
| Version | Puppet Master \[cmdb_ci_puppet_master\] | version | Puppet - Master Info |
[Table 1. Data collected by Discovery for Puppet automation software, by default]

{#c_PuppetAutomationSoftwareDiscovery__table_asr_wst_cr}
* **[Add the must_sudo parameter to the Puppet probe](https://servicenow-prod.fluidtopics.net/JaWvwx4oNnKE~QnyLHuoyQ)**   
  To use the Puppet probe with sudo, you must add the must_sudo parameter to each probe that requires it.

*[\>]: and then