Getting support
You can get commercial support for versions of PE in mainstream and extended support. You can also get support from our user community.
Puppet Enterprise support life cycle
Some of our releases have long term support (LTS); others have short term support (STS). For each release, there are three phases of product support: Mainstream support, Extended support, and End of Life (EOL).
For full information about types of releases, support phases and dates for each release, frequency of releases, and recommendations for upgrading, see the Puppet Enterprise support lifecycle page.
If the latest release with the most up-to-date features is right for you, Download, try, or upgrade Puppet Enterprise . Alternatively, download an older supported release from Previous releases.
Open source tools and libraries
PE uses open source tools and libraries. We use both externally maintained components (such as Ruby, PostgreSQL, and the JVM) and also projects which we own and maintain (such as Facter, Puppet agent, Puppet Server, and PuppetDB.)
Projects which we own and maintain are "upstream" of our commercial releases. Our open source projects move faster and have shorter support life cycles than PE. We might discontinue updates to our open source platform components before their commercial EOL dates. We vet upstream security and feature releases and update supported versions according to customer demand and our Security policy.
The customer support portal
We provide responsive, dependable, quality support to resolve any issues regarding the installation, operation, and use of Puppet Enterprise (PE).
There are two levels of commercial support plans for PE: Standard and Premium. Both allow you to report your support issues to our confidential customer support portal. When you purchase PE, you receive an account and log-on for the portal, which includes access to our knowledge base.
Puppet Enterprise support script
When seeking support, you might be asked to run an information-gathering support script. This script collects a large amount of system information, compresses it, and prints the location of the zipped tarball when it finishes running.
The script is provided by the pe_support_script
module bundled with the installer. Running the command executes a single bash script which can be found at: /opt/puppetlabs/puppet/cache/lib/puppet_x/puppetlabs/support_script/v1/puppet-enterprise-support.sh
Run the support script on the command line of any PE node running Red Hat Enterprise Linux, Ubuntu, or SUSE Linux Enterprise Server operating systems with the command: /opt/puppetlabs/bin/puppet enterprise support
.
Use these options when you run the support script to modify the output:
Option | Description |
---|---|
--render-as <FORMAT> |
Specifies what rendering format to use. |
--verbose |
Logs verbosely. |
--debug |
Logs debug information. |
--classifier |
Collects classification data. |
--dir <DIRECTORY> |
Specifies where to save the support script's resulting tarball. |
--ticket <NUMBER> |
Specifies a support ticket number for record-keeping purposes. |
--encrypt |
Encrypts the support script's resulting tarball with GnuPG encryption.
Note: You must have GPG or GPG2 available in your PATH in order to encrypt the tarball. |
--log-age |
Specifies how many days worth of logs the support script collects. Valid values are positive integers or all to collect all logs, up to 1 GB per log. |
Information collected by the support script
The support script collects a large amount of system information that can help our Support team troubleshoot issues.
- iptables info: Is it loaded? What are the inbound and outbound rules for both IPv4 and IPv6?
- Facter output generated by
puppet facts find
- SELinux status
- The amount of free disk and memory on the system
- hostname info:
/etc/hosts
and the output ofhostname --fqdn
- List of established connections from
netstat
- The output from
ifconfig
- The umask of the system
- NTP configuration: what servers are available, the offset from them
- OS and kernel info from
uname -a
andlsb_release -a
(if installed) System package manager configuration files
- The state of installed PE packages as reported by the system package manager
- a list of Ruby gems installed by
/opt/puppetlabs/puppet/bin/gem
and/opt/puppetlabs/puppetserver/bin/gem
- the current process list
- a listing of Puppet certs
- a listing of all services and their state (such as running/stopped, enabled/disabled)
- current environment variables
- whether the Puppet master is reachable
- a list of all Puppet modules on the system
- the output of
puppet module changes
(shows if any modules installed by PE have been modified) - a listing (no content) of the files in:
-
/opt/puppetlabs
-
/var/log/puppetlabs
-
/var/opt/lib
-
- reports the size of the PostgreSQL databases and relations
- PE PostgreSQL configuration from:
-
/opt/puppetlabs/server/data/postgresql/9.6/data
- the output of
SELECT * FROM pg_settings;
- the output of
SELECT * FROM pg_stat_activity;
-
- The configuration used by PE RBAC to connect with a directory service, excluding sensitive information such as passwords
- r10k information:
- configuration files
- output of
r10k deploy display -p --detail
- The amount of disk space used by Code Manager
- the output from PE status API endpoints
- output from the PuppetDB
/summary-stats
endpoint, which provides non-identifying database statistics for troubleshooting - a list of active nodes from PuppetDB
- a list of active nodes from Orchestration Services
- a histogram of agent run start times from PuppetDB which is used to detect thundering herds
- output from the Puppet Server
/environments
endpoint, which lists available directory environments and module search paths - the
environment.conf
andhiera.yaml
configuration files from each environment
It also copies the following files:
- system logs
output from the dmesg command
- the contents of
/etc/puppetlabs/
(being careful to avoid sensitive files, such as modules, manifests, and ssl certs) - configuration files for PE services located under
/etc/sysconfig
or/etc/default
and/etc/puppetlabs
. - the contents of
/var/log/puppetlabs/
upgrade log files from
/opt/puppetlabs/server/data/postgresql/
- the contents of
/opt/puppetlabs/puppet/cache/state/
- the contents of
/opt/puppetlabs/pe_metric_curl_cron_jobs
or/opt/puppetlabs/puppet-metrics-collector
, if present - the contents of
/etc/resolv.conf
- the contents
/etc/nsswitch.conf
- the contents of
/etc/hosts
Getting support from the 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.
- Join the
Puppet Enterprise user group. Your request to join is sent to Puppet, Inc. for authorization and you receive an email when you’ve been added to the user group.
- Click on “Sign in and apply for membership.”
- Click on “Enter your email address to access the document.”
- Enter your email address.
- Join the open source Puppet user group.
- Join the Puppet developers group.
- Report issues with the open source Puppet project.