# About Patch Agent

The Patch Agent is a LaunchDaemon that runs every 4 hours by default to install or update specified applications. You can specify the applications that the Patch Agent will attempt to install or update using a Configuration Profile (opens new window). When installing Alectrona Patch on a Mac where a Patch Configuration Profile exists, this results in Alectrona Patch performing automated patch management client-side on your Mac based on your own specifications.

The Patch Agent is located at the following path:

/Library/Application Support/Alectrona/Patch/patch-agent

# Controlling the Patch CLT

The Patch Agent creates a job list based on the Configuration Profile installed on a Mac. It then takes this job list and begins to perform installations/updates by leveraging the Patch CLT. Once the Patch CLT is done installing/updating the application, it then notifies the Patch Agent that the installation was successful, and the Patch Agent moves on to the next software title in its job list.

# Active Intervals

The Active Intervals feature will silently update an application that has been recently deferred immediately after that application has been closed. This process occurs during the interval time (the idle period between Patch Agent runs). As an example, if an update to Zoom is deferred, then 30 minutes later the end-user closes Zoom, the Patch Agent will silently update Zoom without waiting until the next scheduled interval time. 😎

Note

The software ID of an application must exist in either the InstallOrUpdate or UpdateOnly keys to be eligible for an Active Interval update after a deferral.

# Patch Agent Preferences

Used to customize the Patch Agent for your organization.

Domain: com.alectrona.patch-agent

Key Description Data Type Example
InstallOrUpdate The software titles to automatically install or update (even if they are not currently installed) using the Patch Agent. Array of Strings <key>InstallOrUpdate</key>
<array>
    <string>title1</string>
    <string>title2</string>
</array>
UpdateOnly The software titles to automatically update if installed and out-of-date using the Patch Agent. Array of Strings <key>UpdateOnly</key>
<array>
    <string>title1</string>
    <string>title2</string>
</array>
RunInterval The Patch Agent runs every 4 hours by default. You can adjust this interval time for your environment. Note: This key is configured in seconds. The minimum setting is 600 seconds (10 minutes) and there is currently no maximum. Integer <key>RunInterval</key>
<integer>600</integer>
ActiveIntervals The Patch Agent will attempt to silently update any recently deferred app that exists in the InstallOrUpdate or UpdateOnly keys immediately after that app has been terminated by the user (even during an interval period). You can disable this behavior by setting to false. Boolean <key>ActiveIntervals</key>
<false/>
ReconAfterInstall Set to true to perform a Jamf Pro inventory update after a software title is installed or updated using the Patch Agent. Boolean <key>ReconAfterInstall</key>
<true/>
DeferIfRunning If an app is running when an update occurs, setting this key to true will suppress the update dialog and automatically perform a deferral. Boolean <key>DeferIfRunning</key>
<true/>
UpdateMAS Set to true to attempt to update and convert Mac App Store (MAS) apps to their non-MAS counterpart. Boolean <key>UpdateMAS</key>
<true/>

TIP

Some of these items can be easily configured with our Patch Profile Builder. You can also deploy a profile created using the Patch Profile Builder in combination with a custom profile to configure any of the optional settings above.