Use the puppet infrastructure tune
command when Puppet Enterprise services are generating java.lang.OutOfMemoryError
errors on infrastructure hosts and/or cannot keep up with agent load. You can also use it to avoid performance issues after you make infrastructure changes such as upgrading PE, adding new compilers or replicas, or making changes to the system resources of existing hosts.
The tune
command outputs settings to optimize available system resources and performance in Puppet Enterprise. You can configure the settings that tune
outputs in either Hiera (preferred) or the console, but not both. Values set in the console override values set in Hiera.
Version and installation information
PE version: All supported
Solution
The puppet infrastructure tune
command is compatible with most standard PE configurations. It works best for customers using a standard Puppet Enterprise installation, with all infrastructure on the primary server. If you have a very large codebase or large deployment, it might not provide the best guidance for you.
Our documentation covers how to use the tune
command and its most commonly used helpful optional parameters to get your current settings and optimized settings for OS and JRuby memory.
In addition, the following optional parameter is helpful in solving performance issues that our team sees:
--estimate
Outputs a capacity summary estimating the maximum number of active nodes your infrastructure can serve, and the minimum number of JRubies needed to serve your active nodes.
Get more information about all of the available parameters by running puppet infrastructure tune --help
or puppet pe tune --help
How can we improve this article?
0 comments
Please sign in to leave a comment.
Related articles