Getting Support for Puppet Enterprise

A newer version is available; see the version menu above for details.

Getting support for Puppet Enterprise is easy; it is available both from Puppet Labs and the community of Puppet Enterprise users. We provide responsive, dependable, quality support to resolve any issues regarding the installation, operation, and use of Puppet.

There are three primary ways to get support for Puppet Enterprise:

See the support lifecycle page for more details.

Reporting Issues to the Customer Support Portal

Puppet Labs provides two levels of commercial support offerings for Puppet Enterprise: Standard and Premium. Both offerings allow you to report your support issues to our confidential customer support portal. You will receive an account and log-on for this portal when you purchase Puppet Enterprise.

Customer support portal:

The PE Support Script

When seeking support, you may be asked to run an information-gathering support script named, “puppet-enterprise-support”. The script is located in the root of the unzipped Puppet Enterprise installer tarball; it is also installed on any master, PuppetDB, or console node and can be run via /opt/puppetlabs/bin/puppet-enterprise-support.

This script will collect a large amount of system information, compress it, and print the location of the zipped tarball when it finishes running. We recommend that you examine the collected data before forwarding it to Puppet Labs, as it may contain sensitive information that you will wish to redact.

The information collected by the support script includes:

  • iptables info (is it loaded? what are the inbound and outbound rules?) (both ipv4 and ipv6)
  • a full run of Facter (if installed)
  • SELinux status
  • the amount of free disk and memory on the system
  • hostname info (/etc/hosts and the output of hostname --fqdn)
  • the umask of the system
  • NTP configuration (what servers are available, the offset from them)
  • the OS and kernel
  • a list of installed packages
  • the current process list
  • a listing of Puppet certs
  • a listing of all services (except on Debian, which lacks the equivalent command)
  • current environment variables
  • whether the Puppet master is reachable
  • the output of mco ping and mco inventory
  • a list of all modules on the system
  • the output of puppet module changes (shows if any modules installed by PE have been modified)
  • the output of /nodes.csv from the console (includes a list of known nodes and metadata about their most recent Puppet runs)
  • a listing (no content) of the files in
    • /opt/puppetlabs/
    • /var/opt/lib
  • reports the size of the PostgreSQL databases and relations
  • reports the contents of the following PostgreSQL databases
    • console
    • pe-activity
    • pe-classifier
    • pe-rbac
    • pe-puppetdb
  • r10k config files
    • /opt/puppetlabs/puppet/bin/gem
    • /opt/puppetlabs/puppet/bin/r10k

It also copies the following files:

  • system logs
  • the contents of /etc/puppetlabs/ (being careful to avoid sensitive files, such as modules, manifests, ssl certs, and MCollective credentials)
  • the contents of /var/log/puppetlabs/
  • the contents of /opt/puppetlabs/server/data/puppetserver/state
  • the contents of /etc/resolv.conf
  • the contents /etc/nsswitch.conf
  • the contents of /etc/hosts

Free Support

If you are evaluating Puppet Enterprise, we also offer support during your evaluation period. During this period you can report issues with Puppet Enterprise to our public support portal. Please be aware that all issues filed here are viewable by all other users.

Public support portal:

Join the Puppet Enterprise User Group

  • Click on “Sign in and apply for membership.”
  • Click on “Enter your email address to access the document.”
  • Enter your email address.

Your request to join will be sent to Puppet Labs for authorization and you will receive an email when you’ve been added to the user group.

Getting Support From the Existing Puppet Community

As a Puppet Enterprise customer you are more than welcome to participate in our large and helpful open source community as well as report issues against the open source project.

↑ Back to top