Welcome To Puppet Support
Announcements
- KB#0311 Puppet Enterprise 2019.0.1 is now available
- KB#0181 Puppet Enterprise 2018.1 is our long-term support (LTS) release
- KB#0316 Did you miss the November Customer Support Newsletter? Read it here.
- KB#0312 Puppet Enterprise 2018.1.5 is now available
- KB#0292 Did you miss the July Customer Support Newsletter? Check it out here.
- KB#0282 Did you miss the April Customer Support Newsletter? Read or download it here.
FAQ
- KB#0001 Where can I download the latest master version?
- KB#0002 Where can I download the latest agent version?
- KB#0004 How do I open a support ticket?
- KB#0005 What are the recommended upgrade paths for Puppet Enterprise?
- KB#0006 How do I update who can submit support requests?
- KB#0305 Where can I use SFTP to upload files to Puppet support?
New to Puppet Enterprise®
- KB#0271 Learn Puppet language basics
- KB#0268 Troubleshooting potential issues in Puppet Enterprise: How to learn more
- KB#0266 Starting a new Puppet Enterprise deployment: Avoid issues and make scaling easier
- KB#0257 Learn how to make your new Puppet Enterprise deployment successful
- KB#0212 Get started learning Puppet: concepts, successful implementation, Puppet code, version control, modules, Hiera, roles and profiles
- KB#0190 The top 5 things to automate with Puppet right now
Performance tuning
- KB#0309 Submit puppetlabs-puppet_metrics_dashboard metrics to Support
- KB#0284 Manage the installation and configuration of metrics dashboards using the puppetlabs-puppet_metrics_dashboard module for Puppet Enterprise 2016.4.x to 2018.1.x
- KB#0215 Prevent a thundering herd: Use max-queued-requests in Puppet Enterprise 2017.3.1 and later
- KB#0088 Recommended reading - Prevent an eventual PuppetDB slowdown - Preventative maintenance for PuppetDB: node-purge-ttl
- KB#0045 Diagnose, stop, and prevent a thundering herd for Puppet Enterprise 3.x to 2019.0.x
- KB#0138 Fix "java.lang.OutOfMemoryError" errors in Puppet Enterprise 2015.x to 2018.1.x
Security and certificates
- KB#0023 Renew expiring Puppet Enterprise certificates for PE 3.x to 2017.3.x
- KB#0306 Add custom HTTP headers to NGINX in Puppet Enterprise 2016.4, 2017.3, 2018.1
- KB#0299 Automate regenerating your monolithic master certificate by using a task in Puppet Enterprise 2018.1.x
- KB#0221 CVE-2017-15059 in Puppet Enterprise 2016.4.0 to 2016.4.9, 2017.2.x, 2017.3.0 to 2017.3.2
- KB#0205 Unsigned Certificates page unavailable and cert "Error: header too long errors" in Puppet Enterprise 2016.4.7
- KB#0024 Add certificates to the Puppet certificate bundle in Puppet Enterprise 2015.2.x to 2017.3.x
Agents
- KB#0307 After a Red Hat 7 OS update agents are not responding in the console in Puppet Enterprise
- KB#0302 "no implicit conversion from nil to integer" error in Puppet Enterprise 2018.1.x
- KB#0294 Puppet agent runs fail with a "Could not find catalog" error in Puppet Enterprise 2018.1.3
- KB#0286 Use a task to enable or disable the Puppet daemon for a group of agents in Puppet Enterprise 2018.x
- KB#0285 Identifying nodes where the Puppet daemon is enabled or disabled in Puppet Enterprise 2018.x
- KB#0269 Troubleshooting agent run errors and slow runs in Puppet Enterprise by adding flags
Code Manager and file sync
- KB#0310 Recover from a file sync garbage collection exception in Puppet Enterprise
- KB#0298 Deploy code using a task in Puppet Enterprise 2017.3.x and later
- KB#0288 Resolve a "R10K::Error: Git provider 'rugged' is not functional" error in Code Manager after a Puppet Enterprise upgrade
- KB#0267 Code Manager deployments fail with a "Cannot lock" or "Index is locked" error in Puppet Enterprise 2016.x to 2018.1.x
- KB#0239 Resolve SSL errors when connecting to GitHub using the r10k shellgit provider in Puppet Enterprise
- KB#0112 Configure Code Manager with multiple control repos in Puppet Enterprise 2016.4.x, 2017.3.x, 2018.1.x, and 2019.0.x
Console
- KB#0283 Console LDAP authentication is broken after Puppet Enterprise 2018.1 upgrade
- KB#0256 Puppet Enterprise console Events page displays "Filter by node name:" field incorrectly in Internet Explorer 11
- KB#0064 Troubleshooting missing environments in the node classifier for Puppet Enterprise 2016.x to 2017.2.x
- KB#0065 Change the time zone for reports in the console for Puppet Enterprise 2016.4.x to 2017.2.x
- KB#0066 Puppet Server “Error Reported” and Orchestrator Service “Unreachable” in the console in Puppet Enterprise 2017.2.x to 2019.x
- KB#0067 Decommissioned nodes causing orchestration job failure in the console in Puppet Enterprise 2017.2.1
Database
- KB#0287 Check database table sizes in Puppet Enterprise
- KB#0277 PostgreSQL logs filling up in Puppet Enterprise 2018.1.0
- KB#0270 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
- KB#0254 REST API call to PuppetDB with PowerShell "Invoke-RestMethod" command returns a "The underlying connection was closed" error in Puppet Enterprise
- KB#0199 Resolve a 'PuppetDB: Connection refused' error in Puppet Enterprise 2015.2 to 2019.0.x
- KB#0086 Recommended reading - Performing complex searches on Package Inspector data for Puppet Enterprise 2017.2.x
Installing and upgrading
- KB#0102 Expired GPG Key causes node installation to fail in Puppet Enterprise 2016.2 and earlier
- KB#0304 "fast_gettext" error in Puppet Enterprise when upgrading from Puppet agent 5.3.3 (PE 2017.3.2) and earlier to 5.3.4 (PE 2017.3.4) and later
- KB#0293 Completely remove the previous version of the Puppet Plug-in for VMware vRealize Automation plug-in when installing the latest plug-in
- KB#0234 Puppet Plug-in v3.0 and 3.1 for vRealize Automation: adding a Puppet master fails in Puppet Enterprise 2016.4.x to 2018.1.x
- KB#0103 Check your preconfigured node groups when installing or upgrading Puppet Enterprise 2017.2.x, 2017.1.x, or 2016.x
- KB#0104 Installing or upgrading fails while searching for "/opt/puppet/share/locale/config.yaml" in Puppet Enterprise 2017.1.x or 2017.2.1
Master
- KB#0315 Resolve a Puppet run overriding a new license.key with an old license.key file in Puppet Enterprise
- KB#0300 Get a JRuby thread dump on Puppet Enterprise 2018.1.x
- KB#0263 Change the hostname of a monolithic master in Puppet Enterprise 2017.3.x to 2019.0.x
- KB#0217 Puppet communication protocol (PCP) broker service disabled on the compile masters in high availability deployments in Puppet Enterprise 2017.3.x
- KB#0216 Use "journalctl -u puppetserver.service" to get additional Puppet server troubleshooting information in Puppet Enterprise 2015.2 to 2016.2.1
- KB#0211 Remove unnecessary packages installed on infrastructure nodes and compile masters during Puppet runs in Puppet Enterprise 2016.4.x, 2017.3.x, and 2018.1.x
Language and modules
- KB#0183 Write and test Puppet code and modules with the Puppet Development Kit (PDK)
- KB#0168 Getting help for supported modules
- KB#0303 Recommended reading: Introducing the new device manager module for agentless automation
- KB#0281 "Evaluation Error: Error while evaluating a Function Call, Cannot allocate memory" when executing external Ruby commands in Puppet Enterprise 2018.1.0 and later
- KB#0200 "undefined method `[]' for nil:NilClass" error when attempting to update packages in Puppet Enterprise 2015.2.0 to 2016.4.7, and 2016.5.1 to 2017.2.3
- KB#0247 Resolve errors installing Microsoft SQL Server using the puppetlabs-sqlserver module and a UNC path as the source in Puppet Enterprise
MCollective
- KB#0244 Improve MCollective stability by removing unneeded logrotate configuration in Puppet Enterprise
- KB#0243 Tune ActiveMQ logging for large node populations in Puppet Enterprise
- KB#0222 Disable the scheduled "refresh-mcollective-metadata" task on agent nodes in Puppet Enterprise
- KB#0159 Change the MCollective password in Puppet Enterprise 2015.x to 2017.2.x
- KB#0160 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
- KB#0161 ActiveMQ becomes unresponsive in Puppet Enterprise 2016.4.3 and earlier, 2016.5, and 2017.1
Puppet Discovery™
Puppet Pipelines™
- KB#0264 Sudo and root permissions agent errors in Pipelines for Applications
- KB#0262 Keep the agent up to date, check its status, and gather troubleshooting information in Pipelines for Applications
- KB#0255 Change the runtime user for the agent in Pipelines for Applications before installation
- KB#0253 Add submodules to build application projects in Pipelines for Applications
- KB#0252 Previously working build fails with a "Repository not found" error in Pipelines for Applications
- KB#0251 PR or commit recognized but not building in Pipelines for Applications