Puppet Enterprise 3.8

Puppet Enterprise support lifecycle

The Puppet Support Lifecycle policy provides guidelines for product support when Puppet Enterprise versions are released, and throughout the lifecycle of each version. This guide is to help customers strategically plan upgrades and version choices.

Puppet Enterprise versions are in one of three phases of the Puppet Support Lifecycle. These phases are:

  • Mainstream support: Puppet Enterprise versions in this phase receive security updates, bug fixes and the entitlement of technical support defined in the support plan. Customers on current support plans can access all services from customer support, including the authenticated FAQ, the customer support portal and other customer-facing sources (such as ask.puppet.com and the Puppet Forge).

  • Limited support: Puppet Enterprise versions in this phase are no longer eligible for security updates and bug fixes. Customers on valid support plans can access services from customer support, still receive SLA response times and utilize the other customer-facing resources listed above. Customers are always encouraged to upgrade to a fully-supported version of Puppet Enterprise. Puppet supports customers to upgrade to the current mainstream supported version(s) with a variety of assistance and resource options.

  • End-of-life (EOL): Puppet Enterprise versions in this phase are no longer eligible for security updates, bug fixes, or anything other than “commercially reasonable” assistance from customer support. Customers in the process of upgrading to a fully-supported version may contact support. As with other support phases, customer-facing sources such as the community and the Puppet Forge are still available.

Puppet produces a standard release approximately every three months. That means customers will always have access to the latest feature and security updates. Some customers often prefer to retain the same base version for an extended period. Puppet releases a new long term support (LTS) release every 18 months. All standard releases receive mainstream support until the next standard release or LTS option is available. An LTS release receives mainstream support for 24 months after launch.

Puppet Enterprise makes use of open source tools and libraries in addition to commercial-only software. Projects which Puppet, Inc. owns and maintains, like Facter, the Puppet Agent and Server, and PuppetDB, are effectively “upstream” of the commercial releases, and as such will move faster and have shorter support lifecycles than Puppet Enterprise. We may discontinue updates to our open-source platform components before their commercial EOL dates. Puppet also bundles and distributes externally-maintained components, such as Ruby, Postgres, and the JVM. We vet upstream security and feature releases and will update supported versions according to customer demand and our Product Security Policy.

Puppet provides either mainstream or limited support for the versions of Puppet Enterprise listed below. All versions older than Puppet Enterprise 3.8 are now End-of-life (EOL) and we encourage upgrading to the latest version.

PE versions Start mainstream support Start limited support EOL
2016.4 (LTS) October 20, 2016 October 2018 TBD
2016.2 June 21, 2016 October 20, 2016 January 31, 2017
2016.1 April 7, 2016 June 21, 2016 December 31, 2016
2015.3 December 8, 2015 April 7, 2016 December 31, 2016
2015.2 July 28, 2015 December 8, 2015 December 31, 2016
3.8 April 28, 2015 December 31, 2016 December 31, 2016

See also the operating system support lifecycle.

Getting support

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: https://support.puppetlabs.com

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/puppet/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/puppet
    • /var/opt/lib
    • /var/opt/pe-puppet
    • /var/opt/pe-puppetmaster
  • 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

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/pe-*
  • the contents of /var/opt/lib/pe-puppet/state/*
  • the contents of /etc/resolv.conf
  • the contents /etc/nsswitch.conf
  • the contents of /etc/hosts
  • the contents of /etc/sysconfig on RedHat and /etc/default on Debian (any environment variables that affect PE services; relevant files usually have a pe- prefix

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