# 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`