forked from Controls/gitea-pages
45 lines
1.9 KiB
Markdown
45 lines
1.9 KiB
Markdown
# 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`
|