The 2018 State of DevOps Report
Get the report

Configuring and tuning your Puppet Enterprise infrastructure

+ expand all - collapse all
+ open menu - close menu

Puppet Enterprise 2018.1

  1. Configure settings using the console
  2. Configure settings with Hiera

After you've installed Puppet Enterprise (PE), optimize it for your environment by configuring and tuning settings as needed. For example, you might want to add your own certificate to the whitelist, increase the max-threads setting for http and https requests, or configure the number of JRuby instances.

There are two main methods for configuring PE: using the console or adding a key to Hiera.

In general, use the console to apply and configure profile classes starting with puppet_enterprise::profile or when editing or adding any parameters in PE-managed configuration files. Parameter values set in the console override those you've manually set in the configuration files.

Use Hiera to apply and configure classes that aren't profile classes.

Important: When you enable high availability, you must use Hiera only — not the console — to specify tuning parameters. Using Hiera ensures configuration is applied to both your master and replica.

Configure settings using the console

In general, use the console to apply and configure profile classes starting with puppet_enterprise::profile or when editing or adding any parameters in PE-managed configuration files.

  1. In the console, click Classification, and select the node group that contains the class you want to work with.
  2. On the Configuration tab, find the class you want to work with, select the Parameter name from the list and edit its value, for example:
    ClassParameterValue
    puppet_enterprise::profile::certificate_authority client_whitelist example.puppetlabs.vm
  3. Click Add parameter and commit changes.

Configure settings with Hiera

Use Hiera to apply and configure classes that aren't profile classes.

You can use Hiera to do things like increase or decrease the number of JRuby instances on the Puppet Server, or tune the number of max_requests_per_instance that will accept requests on the Puppet Server.

In your Hiera default .yaml file, add the setting you're configuring.
The location for Hiera defaults is:

  • *nix: /etc/puppetlabs/code/environments/<ENVIRONMENT>/data/common.yaml

  • Windows: %CommonAppData%\PuppetLabs\code\environments\<ENVIRONMENT>\data\common.yaml

If you customize the hiera.yaml configuration to change location for data files (the datadir setting) or the path of the common data file (in the hierarchy section), look for the default .yaml file in the customized location.
Back to top