Files
gitea-pages/admin-guide/configuration/puppet_agent.md
T

1.9 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 (to see the exact time do systemctl list-timers pli-puppet-run.timer)
  • '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 ... 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: ::

[root@lxdev04 ~]# /opt/pli/libexec/pli-puppet-disable puppet currently not disabled [root@lxdev04 ~]# /opt/pli/libexec/pli-puppet-disable '1 week' [root@lxdev04 ~]# /opt/pli/libexec/pli-puppet-disable Puppet disabled until: Wed Nov 1 08:00:05 CET 2017 [root@lxdev04 ~]# /opt/pli/libexec/pli-puppet-disable stop Stopping [root@lxdev04 ~]# /opt/pli/libexec/pli-puppet-disable puppet currently not disabled [root@lxdev04 ~]#

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