Skip to main content

Definitions - Installation and User Guide

  • Updated

Introduction

Reporting on the patch level of your devices is important, which is why we extended Auto-Update to create and update Patch definitions for the titles included within Auto-Update, in October 2021.

Screenshot_2021-10-14_at_15.22.11.png

These patch definitions are inline with the mechanisms that Auto-Update uses to define and detect a titles version.

Your Auto-Update subscription/trial or a datajar.mobi hybrid subscription now includes one of these additional Patch sources enabled for patch reporting.

If your subscription started before October 2021, please raise a new support incident requesting a Definitions instance by visiting: https://support.datajar.co.uk/hc/en-us/requests/new.

Installation

To add this patch source to your Jamf Pro instance:

  • Login to Jamf and navigate to Settings ⚙ > Computer Management > Patch Management
  • Click the New button.
  • In the Display Name set the name to definitions.datajar.mobi.
  • Check Enabled.
  • In Server and Port, enter the full Definitions URL supplied by dataJAR (for example: definitions.datajar.mobi/xxxxxxxxxxxxxxxxxxx/v1/). No port is needed to be defined.
  • Check Use SSL.
  • Uncheck Validate Software Title Definitions.
  • Click Save.
  • Click Test
  • Click Test (once more), to confirm connectivity.

Screenshot_2021-10-20_at_19.24.44.png

If there are any issues found, please raise a new support incident by visiting: https://support.datajar.co.uk/hc/en-us/requests/new.

Adding a Patch Definition

  • Login to Jamf and navigate to Settings ⚙ > Computers> Patch Management
  • Click the New button.
  • Click the disclosure triangle next to the definitions.datajar.mobi entry.
  • Locate the title you wish to add a Patch Definition for, and click +.
  • Click Edit to change the category to Auto-Update.

If the chosen Patch Definition contains an Extension Attribute, you will need to perform the below before the Patch Definition will be enabled for reporting:

  • Click the Edit button.
  • Click the Extension Attributes tab.
  • Review the content of the Extension Attribute, and if happy proceed else please raise a new support incident by visiting: https://support.datajar.co.uk/hc/en-us/requests/new.
  • Click Accept.
  • Check "I have reviewed the script and accept use of this extension attribute"
  • Click OK

The Patch Definition will now be enabled for reporting.

NOTE: If an Extension Attribute is updated or added to a Patch Definition, you'll see a notification in Jamf Pro that there has been a change and the above steps will need to be taken to approve this new/updated Extension Attribute.

Screenshot_2021-10-20_at_19.53.12.png

Patch Policies

Patch Policies are not supported with Auto-Update.

The purpose of Definitions is to leverage Patch Reporting in conjunction with Auto-Update Policies to report on a title within macOS devices managed by your Jamf Pro instance.

 

Related articles