Troubleshooting
Use this guide to troubleshoot issues with your Puppet Enterprise installation.
Important: Before you troubleshoot, view the What gets installed and where? page. PE installs several software components,
configuration files, databases, services and users, and log files. It is useful to
know their locations when you need to troubleshoot your infrastructure.
-
Log locations
The software distributed with 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
If you have issues with the databases that support the console, make sure that the PostgreSQL database is not too large or using too much memory, that you don't have port conflicts, and thatpuppet apply
is configured correctly. -
Troubleshooting cloud deployments
If you encounter issues with your PE cloud deployment, try these fixes. -
Troubleshooting Code Manager
-
Troubleshooting Windows
Troubleshoot Windows issues with failed installations and upgrades, and failed or incorrectly applied manifests. Use the error message reference to solve your issues. Enable debugging. -
Troubleshooting backup and restore
If backup or restore fails, check for these issues.