51 lines
1.7 KiB
Markdown
51 lines
1.7 KiB
Markdown
# 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
|
|
|
|
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 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
|
|
```
|