Skip to main content

Auto-Update - Installation Guide

  • Updated

Introduction

This guide is for organisations with an Auto-Update subscription, or are undertaking a trial.

If your organisation has a datajar.mobi fully-managed or hybrid subscription, Auto-Update will already be deployed as a part of your datajar.mobi setup.

Prerequisites

In order to set up Auto-Update for Jamf you will require some prerequisites which are detailed below:

  • Jamf Pro -You will require admin access and or be the one responsible for managing your Jamf Pro.
  • macOS - In order to complete the steps outlined in this quick start guide you will require access to a macOS device. 
  • Assets - In order to complete the steps outlined in this quick start guide, first check whether you have received an email which contains either a link or zip file.
  • A test macOS device - We do recommend for testing purposes that you have with you a test device. This device will receive two configuration profiles and a .pkg containing the Auto-Update application.
  • Requirements - The following requirements need to be followed, to assure a successful Auto-Update implementation.

Configuring and setting up Auto-Update for Jamf

Please locate your supplied assets. These would have been supplied either as a link or a zip file. The contents will resemble the following structure:

  • extension attribute
  • mobileconfig
  • notifications
  • pkg
  • policy
NOTE: The service does not include re-use of components within additional Jamf Pro instances. If you are required to deploy Auto-Update to additional instances of Jamf Pro, please contact our support team by visiting: https://support.datajar.co.uk/hc/en-us/requests/new.

Setup Categories

  • Login to Jamf Pro and navigate to Settings ⚙ > Global Management > Categories > New +.
  • Create the following categories as default Priority in Self Service 9:
    • Auto-Update
    • Auto-Update Ongoing
  • Ensuring you save changes at each step.

Uploading the Extension Attribute

  • Login to Jamf and navigate to Settings ⚙ > Computer Management > Management Framework > Extension Attributes.
  • Click the New button.
  • In the Display Name set the name to Auto-Update.
  • Scroll down to the section called Input Type currently it should say Text Field, please ensure you change this to Script.
  • Locate the extension attribute folder supplied by dataJAR and the file named EA-Auto-Update.sh. 
  • Copy and Paste the contents of the EA-Auto-Update.sh file to the Extensions Attribute script window within Jamf Pro and click Save.

Uploading the Auto-Update Policy script

  • In Jamf Pro, navigate to the Settings ⚙ > Computer Management > Computer Management > Scripts.
  • Select New +.
  • Name the script Auto-Update.py.
  • Set the Category to Auto-Update.
  • Click on Script.
  • Locate the policy folder supplied by dataJAR and the file named Auto-Update.py.
  • Copy and Paste the contents of the Auto-Update.py file to the Script Contents window within Jamf Pro.
  • Click Options.
  • Set Priority to After and configure the following Parameter Labels as follows:
    • Parameter 4 = Add to Installs
    • Parameter 5 = Remove from Installs
    • Parameter 6 = Add to Uninstalls
    • Parameter 7 = Remove from Uninstalls
  • Click Save.

Uploading and deploying the Notifications Configuration Profile

NOTE: The Notifications Configuration Profile should only be deployed to devices running macOS 10.15 or newer.
  • In Jamf Pro, navigate to Computers > Configuration Profiles.
  • Select Upload.
  • Locate the notifications folder supplied by dataJAR and the file named dataJAR Auto-Update Notifications.mobileconfig.
  • Set the Name of the Configuration Profile to dataJAR Auto-Update Notifications.
  • Set the Category to Auto-Update.
  • Scope to your required devices.
  • Click Save.

Uploading and deploying the Auto-Update Configuration Profile

  • In Jamf, navigate to Computers > Configuration Profiles.
  • Select Upload.
  • Locate the mobileconfig folder supplied by dataJAR and the file named dataJAR Auto-Update.mobileconfig.
  • Set the Name of the Configuration Profile to Auto-Update.
  • Set the Category to Auto-Update.
  • Scope to your required devices.
  • Click Save.

Uploading the Auto-Update package

Create the Auto-Update Smart Group

  • In Jamf Pro, navigate to Computers > Smart Groups.
  • Select New +.
  • Set the Smart Computer Group name to Auto-Update Framework Not Installed and select Criteria.
  • Click Add +.
  • Select Packages Installed By Casper and Choose.
  • Set the following:
    • Operator = does not have
    • Value = dataJAR-Auto-Update-x.x.pkg (x.x is the version number of the package).
  • Add any additional criteria as needed.
  • Click Save.

Create the Auto-Update Install Policy

  • In Jamf Pro, navigate to Computers > Policies.
  • Select New +.
  • Configure the Policy with the following options:
    • Display Name = Install Auto-Update Framework
    • Category = Auto-Update
    • Trigger  = Recurring check-in
    • Frequency = Once per computer
    • Package = dataJAR-Auto-Update-x.x.pkg (x.x is the version number of the package).
    • Maintenance = Update Inventory
  • Click Scope and select Auto-Update Framework Not Installed.
  • Click Save.

Install the Auto-Update Catalogue Browser

  • In Jamf Pro, navigate to Computers > Policies.
  • Select New +.
  • Configure the Policy with the following options:
    • Display Name = Install Auto-Update Catalogue Browser
    • Category = Auto-Update Ongoing
    • Trigger  = Recurring check-in
    • Frequency = Once every week
    • Scripts = auto-update.py
    • Script Priority = After
    • Add to Installs = AutoUpdateCatalogueBrowser
  • Click Scope and select your administration Mac.
  • Click Save.
  • On your administration Mac, launch /Applications/Utilities/Terminal.app and execute:
     sudo jamf policy
  • Once installed, please launch /Applications/Auto-Update Catalogue Browser.app

Next Steps

You have now successfully installed and configured Auto-Update. Please ensure you review the Auto-Update - Administrator's Guide for more detailed information on creating additional policies.

For more information on Auto-Update Catalogue Browser, please see the Auto-Update Catalogue Browser - User Guide.

And please see the Definitions - Installation and User Guide, for how to setup a Definitions Patch Source within Jamf Pro.

Installation support

If you require support installing Auto-Update, please visit https://support.datajar.co.uk for our knowledge base or raise a new support incident by visiting: https://support.datajar.co.uk/hc/en-us/requests/new.



Related articles