News
- Puppet Enterprise 2021.7.1 is now available
- Puppet Enterprise 2021.7 is our long term support release
- Older Support Knowledge Base articles are now in an archive
- Recommended viewing: Puppet support knowledge playlist on YouTube
- Removing harmful terminology from our products
- Download FIPS-enabled Puppet Enterprise
FAQ
- Download the latest primary server and agent packages for Puppet Enterprise
- Open a ticket with Puppet Support
- How do I update who can submit support requests?
- Run the support script for Puppet Enterprise 2016.2 to 2019.7
- Give your colleagues access to Puppet Support tickets via email (CC) or the Support Portal
- Make Puppet Enterprise licenses that are not being used available to other nodes
New to Puppet Enterprise®
- Puppet Enterprise Guide: Learn how to get up and running with PE
- Puppet Practice Labs: Free, browser-based, hands-on learning
- Recommended reading: New to using Puppet Enterprise? Quickly find the best content to start your automation journey.
- Recommended reading: How I became a Puppet Certified Professional from home
- Learn Puppet language basics
- Troubleshooting potential issues in Puppet Enterprise: How to learn more
Performance tuning
- Tools and resources to help you find and fix issues in Puppet Enterprise
- Run “EXPLAIN (ANALYZE, BUFFERS)” on a PostgreSQL query with a long run time in Puppet Enterprise
- High swap usage on your primary server or replica in Puppet Enterprise
- Prevent code deployments from impacting performance in Puppet Enterprise
- Tune task and plan performance in Puppet Enterprise
- Use Java Flight Recorder to record and share diagnostic data with Support to help debug performance issues in Puppet Enterprise
Security and certificates
- Spring4Shell statement
- Puppet response to recent Log4j vulnerabilities FAQ
- Resolve intermittent SSL errors when agent runs fail in Puppet Enterprise
- Puppet response for CVEs in puppetlabs-apt and puppetlabs-mysql modules
- Fix an “ERROR: You’re using an RSA key with SHA-1” error message in Puppet Enterprise
- Troubleshooting LDAP integration issues in Puppet Enterprise
Agents
- Configure a setting in the “puppet.conf” file in Puppet Enterprise
- Generate a list of node certnames that are not checking in (are unresponsive) in Puppet Enterprise
- Use cached catalogs with the orchestrator in Puppet Enterprise
- Puppet made changes to a node running in no-op mode in Puppet Enterprise
- Get a debug log from an agent run in Puppet Enterprise
- Can Puppet Enterprise remove agent nodes from inventory collection on a specific package provider?
Code Manager and file sync
- “failed to start SSH session: Unable to exchange encryption keys” error message in FIPS-enabled Puppet Enterprise 2019.8.10, 2021.5, and 2021.6
- Code deployment is slow when code repositories include binary files in Puppet Enterprise
- Deploying code: What is a control repo, and how can it help me manage code in Puppet Enterprise?
- Recommended reading: Code Manager improvements reduce deployment time and effort
- SSH errors when deploying code from GitLab with Code Manager in Puppet Enterprise or Continuous Delivery for PE
- Fix a file sync storage crash for ca-data.git after adding certificates in Puppet Enterprise 2018.1 and 2019.0 and later
Console
- Change the output of a Puppet run from text with color to no color in Puppet Enterprise
- Check the lifetime (expiration date) for a token in Puppet Enterprise
- Get detailed information on what was applied to a node by jobs and plans in Puppet Enterprise
- Agent nodes are unresponsive (not reporting) in the console in Puppet Enterprise
- Permission denied error when using patch management on a Windows node for Puppet Enterprise
- Resolve “connection type” errors when running tasks, plans, or Puppet with the orchestrator in Puppet Enterprise
Database
- Puppet Server fails after “pg_wal” fills up the hard drive in Puppet Enterprise
- Prevent PuppetDB from failing after Puppet Enterprise upgrade on an external unmanaged PostgreSQL node
- PQL query to return all nodes where a fact does not exist in Puppet Enterprise
- Efficiently run a PQL query on a long list of nodes in Puppet Enterprise
- Determine if large facts cause performance issues in Puppet Enterprise
- Monitor the performance of your Puppet Enterprise infrastructure
Installing and upgrading
- Expired GPG Key causes node installation to fail in Puppet Enterprise 2016.4.0 to 2019.8.4
- Resolve an “ERROR: deadlock detected” error message in PuppetDB when upgrading to Puppet Enterprise 2019.8 or later from a previous version
- “Something unexpected occurred: An uncaught server error was thrown. Check the log for details” error after upgrading Puppet Enterprise from 2021.3 to 2021.7
- When re-installing Puppet agent on a node you get a “does not match its private key” error in Puppet Enterprise
- Run different but compatible versions of Puppet Enterprise and Puppet agent on your infrastructure and agent nodes
- Support for IPv6 in Puppet Enterprise
Primary server (formerly master)
- “cem_windows” module shows an unconfigured benchmark applied to an agent node in Puppet Enterprise
- A PE service fails to start after changing and backing up configuration in conf.d in Puppet Enterprise
- Fix an "Insecure world writable" error in Puppet Enterprise
- Get information about issues with facts using Facter debug options in Puppet Enterprise
- Running a plan with a file path in it from Puppet Enterprise fails
- See all Hiera lookup --explain results for class parameters for a node in Puppet Enterprise
Language and modules
- Write and test Puppet code and modules with Puppet Development Kit (PDK)
- Get help for supported modules
- Fix unexpected module issues with “fails to meet some dependencies” errors in Puppet Enterprise
- Tools to help you write Puppet code
- Change a gem dependency in a module generated by Puppet Development Kit
- The "puppetlabs-pe_databases" module causes a “/Stage[main]/Pe_databases” error message on the PE-PostgreSQL node when upgrading to the latest version of Puppet Enterprise
Continuous Delivery for Puppet Enterprise
- Update the pe-r10k package in Puppet Enterprise 2019.8.7 and 2021.2 if you are using Continuous Delivery for PE impact analysis
- Change the backup timeout parameter when a snapshot fails in Continuous Delivery for Puppet Enterprise
- Certificates expire in Puppet Application Manager version 1.62.0 in Continuous Delivery for Puppet Enterprise
- Rebuild Kubernetes IPtables rules in Continuous Delivery for Puppet Enterprise
- Get Puppet Application Manager and Continuous Delivery for Puppet Enterprise version and troubleshooting information
- When upgrading Puppet Application Manager you get an “error when evicting pod” error in Continuous Delivery for Puppet Enterprise
Bolt
Puppet Comply™
- Download an offline (air-gapped) Comply bundle
- Delete an incomplete backup in Puppet Application Manager in Puppet Comply
- Reset the Puppet Application Manager password for Puppet Comply
- Fix a "certificate signed by an unknown authority" error when connecting Comply to Puppet Enterprise
- Build a custom installer for Puppet Application Manager and use it to migrate to a new cluster for Comply
- Configure OpenShift as a Mutual Transport Layer Security (MLTS) proxy for serving Puppet Enterprise certificates to Comply
Puppet Remediate™
- Get support for Puppet Remediate
- Remediate may fail to start in offline mode
- Windows nodes “Inaccessible” and discovery fails in Remediate
- LDAP users not syncing with a "Synchronization ignored as it’s already in progress" message in Puppet Remediate
- "Network response was not okay" error when uploading a module in Puppet Remediate 1.0.1
- Unresponsive UI after uploading a module with many tasks in Puppet Remediate 1.0.1