Troubleshooting
Use this guide to troubleshoot issues with your Puppet Enterprise (PE) installation.
Important: Before following troubleshooting guidance, review What gets installed and where. PE installs several software components, configuration
files, databases, logs, services, and users. It is useful to know their locations when
you need to troubleshoot your infrastructure.
-
Log locations
The software distributed with Puppet Enterprise (PE) generates log files you can use for troubleshooting. -
Troubleshooting installation
If installation fails, check for these issues. -
Troubleshooting disaster recovery
If disaster recovery commands fail, check for these issues. -
Troubleshooting puppet infrastructure run commands
Ifpuppet infrastructure run
commands fail, review the logs at/var/log/puppetlabs/installer/bolt_info.log
and check for these issues. -
Troubleshooting connections between components
If agent nodes can't retrieve configurations, check for communication, certificate, DNS , and NTP issues. -
Troubleshooting the databases
Use these strategies to troubleshoot issues with the databases that support the console. -
Troubleshooting cloud deployments
If you encounter issues with a PE cloud deployment, review the troubleshooting information. -
Troubleshooting SAML connections
There are some common issues and errors that can occur when connecting a SAML identity provider to PE, such as failed redirects, rejected communications, and failed group binding. -
Troubleshooting backup and restore
If backup or restore fails, check for these issues. -
Troubleshooting Code Manager
-
Troubleshooting Windows
Troubleshoot issues in Windows PE installations, such as failed installations, failed upgrades, problems applying manifests, and other issues.