News
- Puppet Enterprise 2019.8.4 and 2018.1.18 are now available
- Puppet Enterprise 2019.8 is our long term support release
- Removing harmful terminology from our products
- Download FIPS-enabled Puppet Enterprise
- Puppet Plug-in 3.x for vRealize Automation end of life and considerations for VMware’s 8.x implementation going forward
- Did you miss the November Customer Support newsletter? Read it here.
FAQ
- Download the latest primary server packages for Puppet Enterprise
- Download the latest agent packages for Puppet Enterprise
- How do I open a support ticket?
- How do I update who can submit support requests?
- Prior versions of Puppet Enterprise documentation
- Request a new feature or enhancement
New to Puppet Enterprise®
- 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
- Starting a new Puppet Enterprise deployment: Avoid issues and make scaling easier
- Learn how to make your new Puppet Enterprise deployment successful
Performance tuning
- Diagnose performance issues and tune your Puppet Enterprise VM in VMware vSphere Hypervisor (ESXi)
- Use the Puppet Profile Parser to graph and investigate Puppet Server performance in Puppet Enterprise 2018.1 to 2019.2
- Use tasks to stop a thundering herd in Puppet Enterprise 2017.3 and later
- Identify and fix performance issues caused by frequent garbage collection in Puppet Enterprise
- Fix "java.lang.OutOfMemoryError" errors by increasing the Java heap size in Puppet Enterprise 2018.1 to 2019.x
- Get optimized performance settings in Puppet Enterprise 2018.1 and later
Security and certificates
- Tech Talk: Configuring Puppet's policy-based autosigning
- "nested asn1 error" when running “puppet cert clean” in Puppet Enterprise 2019.1.x and later
- Check and fix the expiry date for your CA certificate in Puppet Enterprise 2018.1 and later
- Set SSL cipher suites in Puppet Enterprise 2018.1 and later
- Errors authenticating with your LDAP user account in the Puppet Enterprise console after generating a new self-signed certificate for your directory server
- Add custom HTTP headers to NGINX in Puppet Enterprise 2016.4, 2017.3, 2018.1, 2019.2
Agents
- Puppet runs fail with a "WARNING: MSG:UnableToDownload" on Windows 2016 and earlier when using Chocolately
- Ensure that fact-based classification and automation work as expected by uploading facts to the primary server in Puppet Enterprise 2018.1 and later
- Agent runs fail on a FIPS enabled master in Puppet Enterprise 2018.1 to 2019.1
- "Pe_repo" error during Puppet runs after installing Bolt on a primary server in Puppet Enterprise
- After a Red Hat 7 OS update agents are not responding in the console in Puppet Enterprise
- "no implicit conversion from nil to integer" error in Puppet Enterprise 2018.1.x
Code Manager and file sync
- Fix a file sync storage crash for ca-data.git after adding certificates in Puppet Enterprise 2018.1 and 2019.0 and later
- Tech talk: Serving files with Puppet
- Code deployments fail when Git repository paths change type but keep the same path in Puppet Enterprise
- Fix an "object not found - no match for id" error in Code Manager in Puppet Enterprise 2018.1 and later
- Error during code deployment in Puppet Enterprise: “Object is not a committish”
- Recover from a file sync garbage collection exception in Puppet Enterprise
Console
- Using the Puppet Enterprise console to work with classes and configuration in Puppet Enterprise 2019.8.0
- Console password reset for Puppet Enterprise 2019.0.0 and 2019.0.1
- Filter facts with names containing symbols in Puppet Enterprise
- Puppet Server "Error Reported" and Orchestrator Service "Unreachable" in the console in Puppet Enterprise 2017.2 and later : Directory corrupted when restoring
- Use tasks to make API calls in the console in Puppet Enterprise 2017.3 and later
- Use tasks to run operating system commands in the console in Puppet Enterprise 2017.3 and later
Database
- Compilers converted to run PuppetDB relying on high-latency connections experience slowdowns in PE 2019.8
- Troubleshooting PuppetDB (pe-puppetdb) in Puppet Enterprise 2018.1 and later
- Change the PuppetDB port in Puppet Enterprise 2018.1.x and 2019.0.x
- Recommended reading: Getting to know the Puppet Query Language (PQL)
- Check database table sizes in Puppet Enterprise
- PostgreSQL logs filling up in Puppet Enterprise 2018.1.0
Installing and upgrading
- Upgrading to Puppet Enterprise 2019.8: Free resources, webinars, and workshops
- Confirming that your PE installation is ready for an upgrade
- Use a task to stay up to date with Puppet Enterprise z releases for PE 2017.3 and later
- Upgrade Puppet Enterprise with high availability enabled and no agent downtime
- Installing the Windows agent with PowerShell fails with the error "Could not create SSL/TLS secure channel" in Puppet Enterprise 2018.1 to 2019.1
- Prevent the puppetlabs-puppet_agent module from overwriting puppet.conf settings during Windows agent upgrades in Puppet Enterprise
Primary server (formerly master)
- Set the pxp-agent log level to trace in Puppet Enterprise 2019.8
- Resolve "Unrecoverable error occurred during database initialization" errors in the orchestrator by purging stuck jobs
- Check the status of ports used by Puppet Enterprise using a task
- Use tasks to run Puppet commands from the console in Puppet Enterprise
- Architecture terminology changes in Puppet Enterprise 2019.2
- Troubleshooting Hiera keys using “puppet lookup –explain” in Puppet Enterprise
Language and modules
- Write and test Puppet code and modules with Puppet Development Kit (PDK)
- Getting help for supported modules
- If you're using the puppetlabs-puppetdb_gc module, update it to version 1.1.0
- Redesigned Forge home page
- Fix an “ERROR -> Unable to connect to https://forgeapi.puppetlabs.com” when authenticating with the Forge in Puppet Enterprise
- Create a trusted fact, verify it, and then reference it in Hiera in Puppet Enterprise 2019.0 and later
Continuous Delivery for Puppet Enterprise
Bolt
Puppet Comply™
Puppet Remediate™
- 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
- Getting support for 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
MCollective
- Set SSL ciphers for the Active MQ broker in Puppet Enterprise 2018.1
- Improve MCollective stability by removing unneeded logrotate configuration in Puppet Enterprise
- Tune ActiveMQ logging for large node populations in Puppet Enterprise
- Disable the scheduled "refresh-mcollective-metadata" task on agent nodes in Puppet Enterprise
- Change the MCollective password in Puppet Enterprise 2015.x to 2017.2.x
- Tune ActiveMQ timeouts to improve MCollective connection reliability in Puppet Enterprise 3.7.2 to 2016.4.5 and 2016.5.x to 2017.2.1