Welcome To Puppet Support
News
- Puppet Enterprise 2018.1 is our long-term support (LTS) release
- DSC module refactoring project beta
- Puppet Enterprise 2019.7 and 2018.1.15 are now available
- Did you miss the March Customer Support newsletter? Read it here.
- A few words on ticket priority level and urgency
- Puppet Pipelines End of Life notice
FAQ
- Where can I download the latest Puppet Enterprise master?
- Where can I download the latest Puppet Enterprise agent?
- How do I open a support ticket?
- What are the recommended upgrade paths for Puppet Enterprise?
- How do I update who can submit support requests?
- How do I choose what information is collected by the support script in Puppet Enterprise?
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
- Use the Puppet Profile Parser to graph and investigate Puppet Server performance in Puppet Enterprise 2018.1.x to 2019.2.x
- 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.x to 2019.x
- Get optimized performance settings in Puppet Enterprise 2018.1.x or later
- Submit puppetlabs-puppet_metrics_dashboard metrics to Support
Security and certificates
- "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
- Automate regenerating your monolithic master certificate by using a task in Puppet Enterprise 2018.1.x to 2018.1.7
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 master 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 Puppet Enterprise master
- 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
- 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
- Deploy code using a task in Puppet Enterprise 2017.3 and later
- Resolve a "R10K::Error: Git provider 'rugged' is not functional" error in Code Manager after a Puppet Enterprise upgrade
Console
- 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
- Create an authentication token in the console in Puppet Enterprise 2017.3 and later
- Console LDAP authentication is broken after upgrading to Puppet Enterprise 2018.1 or later
- Puppet Enterprise console Events page displays "Filter by node name:" field incorrectly in Internet Explorer 11
Database
- 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
- Error while provisioning a high availability replica: 'sync_peers' index 0 entry 'port' expects an Integer value, got String; in Puppet Enterprise 2016.5.x to 2017.3.x
- REST API call to PuppetDB with PowerShell "Invoke-RestMethod" command returns a "The underlying connection was closed" error in Puppet Enterprise
Installing and upgrading
- Expired GPG Key causes node installation to fail in Puppet Enterprise 2016.2 and earlier
- 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
- After installing or upgrading to PE 2019.0.2 with Continuous Delivery for PE impact analysis enabled, pe-puppetserver fails to start
Master
- 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
- Get Puppet Enterprise license information using the API
- Resolve a Puppet run overriding a new license.key file with an old license.key file in Puppet Enterprise
Language and modules
- Write and test Puppet code and modules with the Puppet Development Kit (PDK)
- Getting help for supported modules
- 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
- Clean or purge nodes in Puppet Enterprise 2017.3 to 2019.0 using a task
- Avoiding problems with symlinks in file resources in Puppet Enterprise
Continuous Delivery for Puppet Enterprise
Bolt™
Puppet 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