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
- Locate the pkg folder supplied by dataJAR and the file named dataJAR-Auto-Update-x.x.pkg where x.x is the version number and upload to your master distribution point, see: https://docs.jamf.com/jamf-pro/administrator-guide/Package_Management.html
- Once uploaded, please set the Category to Auto-Update ensuring you save your changes.
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.