Files
Controls-docs/admin-guide/configuration/puppet_agent.md
T
2023-09-06 09:43:50 +02:00

1.4 KiB

Puppet Agent Configuration

The Puppet agent software communicates with the Puppet master to enforce desired system configurations defined in hiera.

Automatic Puppet Agent Runs

Puppet agent is configured to run daily between 5-8 AM. This describes how the Puppet agent can be configured to run at different intervals and also at different times than the default.

Agent Run Frequency

The intervals the Puppet agent runs can be configured in hiera with puppet_client::run_frequency

Allowed parameters

  • 'halfhourly': every 30 minutes
  • 'daily': once a day (default)
  • 'weekly': every Monday

The daily and weekly Puppet run respect the value set for puppet_client::exec_time

Execution Time

The actual automatic Puppet Agent run is always on the same random time. Check systemctl list-timers pli-puppet-run.timer for the exact time. For daily and weekly this time window is configured in Hiera with puppet_client::exec_time, the default is:

puppet_client::exec_time: '05:00 -- 08:00'

The time format used is '24-hour clock' HH:MM -- HH:MM

Temporarily Disable Automatic Puppet Agent Runs

Puppet execution can be disabled for a certain amount of time with the /opt/pli/libexec/pli-puppet-disable command.

The disabling time has to be in the date format (see date(1)).

Manual Execution of Puppet Agent

The Puppet agent can be run manually by executing following command puppet agent -t