jamJAR Preferences

macmule edited this page Nov 19, 2017 · 6 revisions

Introduction

The jamJAR postflight stores it's configuration in the uk.co.dataJAR.jamJAR preference domain.

This can be set via defaults, a plist or (strongly recommended) a profile.

This profile should be installed at the Computer level.

If any keys are not set, then the below defaults are used.

Defaults

<key>log_file_dir</key>
<string>/var/log/</string>
<key>munki_mode</key>
<false/>
<key>notifier_msg_installed</key>
<string>%s %s has been installed</string>
<key>notifier_msg_nopending</key>
<string>No updates pending</string>
<key>notifier_msg_pending</key>
<string>Logout to complete pending updates</string>
<key>notifier_msg_title</key>
<string>jamJAR</string>
<key>notifier_msg_uptodate</key>
<string>Latest version of %s is installed.</string>
<key>notifier_path</key>
<string>/Library/Application Support/JAMF/bin/Management Action.app/Contents/MacOS/Management Action</string>
<key>notifier_sender_id</key>
<string>com.jamfsoftware.selfservice</string>

log_file_dir

This is the directory in which the jamJAR.log is created, this is created via the jamJAR postflight after every run. The log rotates at midnight & appends the date to the old file.

notifier_msg_installed

The notification text to display when an item is installed, this requires 2 string placeholders (%s).

These are then passed the following:

  1. Item Name (i.e. Google Chrome).
  2. Item Version (i.e. 56.0.2924.87).

notifier_msg_nopending

The notification text to display when all pending updates have been installed.

notifier_msg_pending

The notification text to display when there are updates pending.

Currently blocking apps or apps requiring a restart action will all trigger this notification.

notifier_msg_title

The notification texts title.

Defaults to jamJAR

notifier_msg_uptodate

The notification text to display when a jamJAR policy is initiated via Self Service & the title attempted to install is up-to-date.

This requires 1 string placeholders (%s), which defaults to Item Name (i.e. Google Chrome).

notifier_path

The path of the application sending the notifications.

Currently only terminal-notifier & Jamf Pro's Management Action have been tested.

If this is defined within jamJAR preferences but is missing, then no notifications are sent when a user is logged in. The only notifications will be from Munki status over the loginwindow.

Defaults to Management Action.

notifier_sender_id

The bundle ID of the application that sent the notification, this is only used for terminal-notifier, but seems that Jamf Pro's Management Action ignores this if sent.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.