Welcome To Puppet Support
Announcements
- KB#0261 Puppet Enterprise 2018.1 is now available
- KB#0181 Puppet Enterprise 2018.1 is our long-term support (LTS) release
- KB#0265 Know what you have — Puppet Discovery generally available 8 May
- KB#0259 Puppet Enterprise 2017.3.6 is now available
- KB#0260 Puppet Enterprise 2016.4.11 is now available
- KB#0238 New look and feel for the Support Portal
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 portal 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#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 2017.3.x
- KB#0011 Troubleshoot and fix performance issues in Puppet Enterprise 2015.x to 2017.3.x with the puppetlabs-puppet_metrics_collector module
- KB#0089 Automate your PE database, maintenance, backups, and tuning with the npwalker/pe_databases module for Puppet Enterprise 2015.3.x to 2017.2.x
Security and certificates
- KB#0023 Renew expiring Puppet Enterprise certificates for PE 3.x to 2017.3.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
- KB#0026 Resolve a duplicate declaration error when adding a hostname to the certificate authority whitelist in the console for Puppet Enterprise 2016.2 to 2017.1.x and 2017.3.x
Agents
- 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 2017.3.x
- KB#0225 AIX agent runs fail with facter errors in Puppet Enterprise 2016.4.x to 2017.3
- KB#0207 Direct agent logs somewhere other than /var/log/messages in Puppet Enterprise 2015.2 to 2017.3.x
- KB#0203 Failed lookups on added LDAP users and groups during Puppet agent runs in Puppet Enterprise 2016.4.x, 2017.2.x, and 2017.3.x
Code Manager and file sync
- KB#0267 Code Manager deployments fail with a "Cannot lock" or "Index is locked" error in Puppet Enterprise 2016.x and 2017.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 and 2017.2.x
- KB#0055 Code Manager "timeout was exceeded" error when deploying code with "puppet-code deploy --all --wait" in Puppet Enterprise 2017.2.1
- KB#0056 Use Code Manager to deploy code from a repository with a self-signed certificate for Puppet Enterprise 2016.x - 2017.1.x and 2017.3.x
- KB#0057 Automate configuration of Code Manager with the npwalker/pe_code_manager_webhook module for Puppet Enterprise 2015.3.x to 2017.2.x
Console
- 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
- KB#0068 Collect, backup, and restore classification data with the node classifier API for Puppet Enterprise 3.7.x to 2017.2.x
Database
- 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
- KB#0087 The KahaDB directory fills up and prevents PuppetDB from working in Puppet Enterprise 2016.4.5 and all earlier versions, or 2016.5.x
- KB#0090 Removing nodes: Understanding "puppet node purge", "node-ttl", and "node-purge-ttl" in Puppet Enterprise 2015.x to 2017.2.x
Installing and upgrading
- KB#0102 Expired GPG Key causes node installation to fail in Puppet Enterprise 2016.2 and earlier
- KB#0234 Puppet Plug-in v3.0 for vRealize Automation: adding a Puppet master fails in Puppet Enterprise 2016.4.x to 2017.3.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"
- KB#0106 Resolve a "different operating system" error when installing the Puppet Enterprise 2017.1.1 agent RPM on AIX 7.2
Master
- KB#0263 Change the hostname of a monolithic master in Puppet Enterprise 2017.3.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
- 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
- KB#0137 Change the hostname of a monolithic master in Puppet Enterprise 2016.5.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#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
- KB#0171 Installing gems on Windows with Puppet Enterprise versions earlier than 2016.4.0
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