PSU Mac Admins 2016 Packaging Workshop Resources

Here are the resources you will need to effectively participate in the packaging workshop at PSU Mac Admins 2016 on Monday, June 27th. Save yourself some time and frustration by downloading these items in advance — the conference wifi might not cooperate!

Sample packages:

ne — “the nice editor”

ASIX USB3 to Gigabit Ethernet Driver

Adobe Acrobat Reader DC

Firefox disk image

Google Chrome disk image


Suspicious Package


WhiteBox Packages


PSU Mac Admins 2016 Packaging Workshop Resources

Professional Training and Support for Munki

munkiOne of the objections some organizations have against using open source tools like Munki is that they want to pay for professional training and support.

Amsys has professional training for Munki:

If you can’t get to London, check out other professional support and training organizations around the world:

Munki Professional Support

Professional Training and Support for Munki

Revisiting receipts for OS X installs via Munki


When using Munki to upgrade OS X with a package created using createOSXinstallPkg (, the recommendation has been to change the auto-generated receipts array:

The intention here was to provide something that would satisfy Munki’s check to see if an item needs to be installed: if the recommended receipt is present, Munki won’t attempt to (re-)install the package that installs OS X.

A problem

However, I recently discovered an issue with this approach. For some machines here, an “InstallYosemite” item was added to their manifest’s managed_installs some time ago to force an upgrade to Yosemite. Once that upgrade was complete, the normal installcheck mechanism found a receipt for “” of version “” or higher, and did not offer to reinstall Yosemite, even though the item remained in “managed_installs” in that machine’s manifest.

Later we added “InstallElCapitan” as an optional_install for all users (in an included_manifest). If a user with a machine manifest like the one described above then chose to self-upgrade to El Capitan, as part of the El Capitan install, the “” receipt is removed. (Note that at, the previous recommended receipt to check for El Capitan is “” since the “” is not present in an El Capitan install.)

Once the El Capitan upgrade is complete, when Munki later checks for updates, it encounters “InstallYosemite” in the managed_installs. Since the “” receipt is no longer present, it decides it needs to install Yosemite once again. This of course, fails, since the package itself has an installcheck, which errors with:

Cannot install on volume / because it is disabled.
installer: Cannot install on volume / because it is disabled.
installer: You can’t upgrade this version of OS X because a newer version
is installed.

If your InstallElCapitan package also includes the Munki bootstrap flag (to ensure all other needed updates for El Capitan are performed), this can lead to a loop where Munki attempts to install Yosemite, fails, tries again, etc.

A fix

The obvious fix is to remove “InstallYosemite” from all manifests once you are offering “InstallElCapitan”. But I think I have a way to avoid this situation in the future. I will recommend a different installation check item for createOSXinstallPkg-type items.

Instead of modifying the auto-generated receipts array, I will now recommend adding an installs array. Here’s one for El Capitan:


This directs Munki to look at the ProductVersion key in /System/Library/CoreServices/SystemVersion.plist, and compare it with 10.11.4. (you could even just make it “10.11” to prevent Munki offering this as an upgrade to 10.11.[0-3] machines.)

/System/Library/CoreServices/SystemVersion.plist exists in all versions of OS X, so it’s a better comparison than package receipts that may or may not exist in future versions of OS X. And it’s easier to revise in the future since the ProductVersion maps to the OS X version you are installing.

Revisiting receipts for OS X installs via Munki Advanced Munki links

Here are the collected links from today’s “Advanced Munki” presentation at the MACAD conference in London (

Unattended installs:
Force install after date:
Apple Update Metadata:
Conditional items:
Admin-provided conditions:
Pre- and Post-install scripting:
Bootstrapping with Munki:
Configuration Profiles with Munki:
Desktop picture profile template:
On-Demand items: Not much documentation yet! But…
Customizing the GUI: Advanced Munki links