Welcome To Puppet Support
Announcements
- KB#0297 Puppet Enterprise 2018.1.4 is now available
- KB#0296 Puppet Enterprise 2017.3.10 is now available
- KB#0295 Puppet Enterprise 2016.4.15 is now available
- KB#0181 Puppet Enterprise 2018.1 is our long-term support (LTS) release
- 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#0007 Attaching files to your support ticket
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#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 2017.3.x
- KB#0138 Fix "java.lang.OutOfMemoryError" errors in Puppet Enterprise 2015.x to 2018.1.x
- KB#0011 Troubleshoot and fix performance issues in Puppet Enterprise 2016.4.x to 2018.1.x with the puppetlabs-puppet_metrics_collector module
Security and certificates
- KB#0023 Renew expiring Puppet Enterprise certificates for PE 3.x to 2017.3.x
- 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
- KB#0025 Recommended reading - Detecting and remediating WannaCry for Puppet Enterprise 2015.2 to 2017.2
Agents
- 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
- KB#0258 Mitigate or fix a very large PXP agent log on AIX in Puppet Enterprise 2016.4.x to 2017.3.5
- KB#0236 Agent run fails after enabling package data collection ("package_inventory_enabled") in Puppet Enterprise 2016.4.x to 2018.1.x
Code Manager and file sync
- 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, and 2018.1.x
- KB#0055 Code Manager "timeout was exceeded" error when deploying code with "puppet-code deploy --all --wait" in Puppet Enterprise 2017.2.1
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 PE 2017.2.x console
- 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 2017.3.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#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
- KB#0105 Upgrading to Puppet Enterprise 2016.4.x from PE 2015.3 and earlier fails with a "java.lang.AssertionError: Assert failed: the secret key must be exactly 16 bytes error"
Master
- 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 and 2018.1.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
- KB#0136 "hiera --version" returns Hiera 3.3.1 instead of Hiera 5 for Puppet Enterprise 2016.4.5, 2017.1.x, and 2017.2.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#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
- KB#0170 Create and verify a trusted fact and reference it in Hiera in Puppet Enterprise 2016.2.x and 2016.4.x
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