Releases: jamf/Setup-Manager
v1.2beta
New Features
- Setup Manager can send webhooks on start and finish, (#70)
- User Entry:
- User Data file now contains a list of enrollmentActions
- added 'restart' option to 'finalAction' (#38, #58)
- icon sources and
accentColor
can now have a dark mode alternative defined in the profile (#61) - hitting the space bar while Setup Manager is the Active window will open a window with a scannable barcode of the serial number
message
and help:message
now interpret markdown formatting (#46)
Fixes and Improvements
- icon for
waitForUserEntry
can be changed from the profile - shell actions correctly show success or failure, depending on their exit code (#39)
- Jamf Pro policy actions show success or failure in most situations. Note that there are many things a policy can potentially do. Not all failures are caught. This registers failed pkg installations and policy scripts that return a non-zero exit code, which should cover most situations. Note also, these checks will only work on macOS 13 and higher. On macOS 12, Jamf policies will always be reported as success.
- read enrollment actions data from profile after user-initiated enrollments more reliably
- now tries for 15 seconds to reload images with local file paths, this should help in situations were the resources file are installed after Setup Manager
- many other fixes and improvements
- user data file will contain the enrollment user when the
userID
key is set - battery warning threshold is now different for Intel (%50) and Apple silicon (%20) Macs. This matches Apple's warnings before applying software updates
Deprecations and Removals
- the minimum macOS requirement for Setup Manager will be raised to macOS 13 soon
showBothButtons
option removed and non-functional, there will always be just one final action button displayed- the method for providing localized texts in the configuration profile changed in version 1.1. The previous method (by appending the two letter language code to the key) is considered deprecated. It will continue to work for the time being but will be removed in a future release. It is strongly recommended to change to the new dictionary-based solution.
Beta Features
Even though we are confident that the 1.2 release is overall stable and ready to be used in production, we believe this feature may require more testing. When, after thorough testing in your environment, you conclude this works for your workflow, please let us know about success or any issues you might encounter.
- Setup Manager can now run over Login Window, instead of immediately after installation. This also allows Setup Manager to work with AutoAdvance. Use the new
runAt
key in the profile to determine when Setup Manager runs
v1.1.1
v1.1
New Features
- new action
waitForUserEntry
which allows for two-phase installation workflows in Jamf Pro. When Setup Manager reaches this action it will wait for the user entry to save the data entry, then it will run a recon/Update Inventory. Policy actions that follow this, can then be scoped to data from the user entry. (#11) - data from user entry is now written to a file when Setup Manager submits data. See details in User Entry (#9)
- use token substitution in the
title
,message
, and actionlabel
values (as well ascomputerNameTemplate
) - token substitution can extract center characters with
:=n
- localization of custom text in the configuration profile has been simplified. The previous method still works, but is considered deprecated. Details in the documentation. The plist and profile example files have been updated.
Fixes and improvements
1.1beta:
- icons using
symbol:
that end in.app
now work properly - Elapsed time is shown in "About this Mac…" Start time is shown with option key.
- svg and pdf images used for
icon
s should now work - general fixes in user entry setup
- improved rendering in Help View (#12)
- fixes to json schema
- improved and updated documentation
- included Installomator script updated to v10.6
- added Setup Manager version and macOS version and build to tracking ping
- fixed UI glitch in macOS Sequoia
1.1 release:
- documentation updates and fixes (#35, #44, #48, #51)
- custom
accentColor
now works correctly with SF Symbol icons (#41) - setting a
placeholder
no longer overrides adefault
inuserEntry
(#43) - more UI updates
- Hebrew localization
Beta features
Even though we are confident that the 1.1 release is overall stable and ready to be used in production, we believe this feature may require more testing. When, after thorough testing in your environment, you conclude this works for your workflow, please let us know about success or any issues you might encounter.
- Setup Manager can now run over Login Window, instead of immediately after installation. This also allows Setup Manager to work with AutoAdvance. Use the new
runAt
key in the profile to determine when Setup Manager runs (#18)
Deprecations
These features are marked for removal in a future release:
- localized labels and text by adding the two-letter language code to key. Switch to localization with dictionaries.
showBothButtons
key and functionality
Setup Manager v1.1beta
New Features
- new action
waitForUserEntry
which allows for two-phase installation workflows in Jamf Pro. When Setup Manager reaches this action it will wait for the user entry to save the data entry, then it will run a recon/Update Inventory. Policy actions that follow this, can then be scoped to data from the user entry. (#11) - Setup Manager can now run over Login Window, instead of immediately after installation. This also allows Setup Manager to work with AutoAdvance. Use the new
runAt
key in the profile to determine when Setup Manager runs (#18) - data from user entry, is now written to a file when Setup Manager submits data. See details in User Entry (#9)
- use token substitution in the
title
,message
, and actionlabel
values (as well ascomputerNameTemplate
) - token substitution can extract center characters with
:=n
- localization in the configuration profile has been simplified. The previous method still works, but is considered deprecated. Details
Fixes and improvements
- icons using
symbol:
that end in.app
now work properly - Elapsed time is shown in "About this Mac…" Start time is shown with option key
- svg and pdf images used for
icon
s should now work - general fixes in user entry setup
- improved rendering in Help View (#12)
- fixes to json schema
- improved and updated documentation
- included Installomator script updated to v10.6
- added Setup Manager version and macOS version and build to tracking ping
- fixed UI glitch in macOS Sequoia
v1.0
- updated to new Jamf Concepts Use Agreement
- updated German and Swedish localizations
- added name for macOS 15
- new
hideActionLabels
andhideDebugLabel
keys - 'Jamf ID' is now only visible in the extended 'About this Mac' View (reachable when holding the option key)
- messaging when Setup Manager is launched in user space or with missing configuration
- UI tweaks
v1.0rc
- various minor fixes to localization, documentation, and small UI tweaks
- better error handling and display for some edge cases
- added ReadMe and License to installer pkg
Please note that the "Source code" archives included with this release contain only the project's documentation.
v0.9.1-306
Initial Commit