1.7 KiB
Puppet Agent Configuration
The Puppet Agent provides the basic system configuration as defined in Hiera.
Automatic Puppet Agent Runs
By default the Puppet Agent runs daily somewhen between 5-8 AM.
The frequency can be changed in Hiera with the key puppet_client::exec_frequency.
Allowed parameters are
- 'halfhourly': every 30 minutes
- 'daily': once a day (default)
- 'weekly': every Monday
- 'boot_only': only shortly after bootup
The actual automatic Puppet Agent run is always on the same random time (except for boot_only). Check systemctl list-timers pli-puppet-run.timer for the exact time on a specific node.
For daily and weekly the 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:
# /opt/pli/libexec/pli-puppet-disable
puppet currently not disabled
# /opt/pli/libexec/pli-puppet-disable '1 week'
# /opt/pli/libexec/pli-puppet-disable
Puppet disabled until: Wed Nov 1 08:00:05 CET 2017
# /opt/pli/libexec/pli-puppet-disable stop
Stopping
# /opt/pli/libexec/pli-puppet-disable
puppet currently not disabled
#
The disabling time has to be in the date format (see date(1)).
Manual Execution of Puppet Agent
At any time you might update the node configuration by running the Puppet Agent manually. To do so run as user root the following command:
puppet agent -t
If you just wish to see what it would change without doing the actual change on the system, run
puppet agent -t --noop