forked from Controls/gitea-pages
34 lines
1.4 KiB
Markdown
34 lines
1.4 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
|
|
- '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`
|