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