= Importing the latest MacOS upgrade into Munki =

Follow the following instructions to import the latest macOS upgrade to munki for distribution to all Orchard Macs.

== Downloading the latest macOS release ==

We use a python script by Greg Neagle which can create disk images containing macOS Installer applications available via Apple's softwareupdate catalogs. This is located on the build host Autumn-Glory {{{/srv/munki/macadmin-scripts}}} this is a branched git repo so ensure it is up to date prior to running.

run ```installinstallmacos.py``` as root, and you will presented with all the supported macOS releases.


== importing into munki ==

Once you have your dmg downloaded, use ```munkiimport``` to manually add the dmg. The name should always relate to the macOS for example Install_macOS_Big_Sur and ensure the version is correctly applied, Installer_item_location is macOS. 

== Create and set icon ==

Find the product page icon icns from within the dmg, you may have to mount the original dmg and search. Create a 256x256 png file of the icon, named the same as the munki pkginfo's Name key to {{{/srv/munki/orchard_repo/icons}}}

== Scoping ==

Use ```manana.orchard.private``` to create a new computer attribute mapping. Insert an attribute value of a pre-configured Jamf Smart Group  all the computers you want to scope to.

=== links for reference ===

Greg Neagles script - https://github.com/munki/macadmin-scripts

Using Munkiimport https://github.com/munki/munki/wiki/munkiimport

Jamf smart group example https://jss.orchard.ox.ac.uk/smartComputerGroups.html?id=748&o=r