Thank you for your feedback.
Form temporarily unavailable. Please try again or contact docfeedback@servicenow.com to submit your comments.
Versions
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store
Close

Puppet automation software discovery

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 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.
  3. With the activation of the Puppet Configuration Management plugin, the sensor processing of Puppet - Master Info triggers the following simultaneously:
    • Puppet – Certificate Requests: The sensor of this probe populates the Puppet Certificate Request [puppet_certificate_request table] with open requests. Open requests are requests that are not already signed or rejected.
    • MultiProbe Puppet – Resources: This probe contains the following probes:
      • Puppet – Module: The sensor of this probe populates records within the Puppet Module [puppet_module] table.
      • Puppet – Manifests: The sensor of this probe populates records within the Puppet Manifest [puppet_manifest], Puppet Class [puppet_class], and Puppet Parameter [puppet_parameter] tables.

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.

With the addition of the Puppet Configuration Management plugin, Discovery identifies the following associated elements:
  • Puppet Certification Requests
  • Puppet Manifests
  • Puppet Modules
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.
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

Data collected

Table 1. Data collected by Discovery for Puppet automation software, by default
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 2. Data collected by Discovery for Puppet automation software, with the Puppet Configuration Management plugin
Name Module [puppet_module] name Puppet - Modules
Path Module [puppet_module] path Puppet - Modules
Name Manifest [puppet_manifest] name Puppet - Manifests
Path Manifest [puppet_manifest] path Puppet - Manifests
Content Manifest [puppet_manifest] content Puppet - Manifests
Name Class [puppet_class] name Puppet - Manifests
Inherits class Class [puppet_class] inherits Puppet - Manifests
Selectable Class [puppet_class] selectable Puppet - Manifests
Name Parameter [puppet_parameter] name Puppet - Manifests
Default value Parameter [puppet_parameter] default_value Puppet - Manifests
Name Certificate Request [puppet_certificate_request] name Puppet - Certificate Requests
Node request Certificate Request [puppet_certificate_request] node_request Puppet - Certificate Requests