Macjutsu/super v5.1.0-beta4

on GitHub

[5.1.0-beta4]

2025-06-06

Highlights (5.1.x)

• Completely rearchitected super preferences mechanism allows for alternate configuration workflows. In other words, you can now create multiple different super workflow configurations and active them on an as-needed basis.
• New scheduling options for automatic deferrals when provisioning new systems and when you want to delay the start of a workflow after zero day.
• New workflow options for installing non-system software updates.
• Significant quality of life improvements for gathering information about the super workflow configuration including a new super-audit.log.

Highlights (5.0.x)

• Suport for macOS 15 Sequoia.
• New scheduled installation workflows allow administrators or the end user to specify a date and time for the installation of macOS updates/upgrades, Jamf Pro Policies, or enforced system restarts.
• New schedule workflow active option allows administrators to set exactly when the super workflow is active, thus allowing for "maintenance windows".
• MacAdmin's SOFA integration allows schedule and deadline options to align with macOS release dates (as opposed to when super discovers a macOS release).
• Completely rearchitected main super logic so all workflow options can be permanent (via configuration profile) or temporary until the requested workflow is completed.
• Completely rearchitected software update/upgrade discovery to significantly improve reliability, performance, and improve support for native macOS software update restrictions deferral.
• Significantly improved behavior for alternate workflow targets (non-system updates, Jamf Pro Policies, and enforced system restarts) now support all deferral, schedule, deadline, and display options.
• Even more user interface customization options.
• Please visit the super Wiki for full details!

Compatibility Notes (5.x)

• super 5.x requires macOS 11 or newer.
• Several super 4.x command line options and managed preferences are not compatible with super 5.x
• Most super 3.0 command line options and managed preferences are not compatible with super 5.x
• Previously saved super 3.0 and 4.x Apple silicon authentication credentials are automatically migrated the first time super 5.x runs.
• Refer to this spreadsheet (tab separated values) for migrating super command line options.
• Refer to this spreadsheet (tab separated values) for migrating super managed preferences.
• New Jamf Pro Extension Attribute scripts for features unique to super 5.x.
• Several updated Jamf Pro Extension Attribute scripts now supports super versions 3.0, 4.x, and 5.x.
• Updated example MDM configuration profiles.
• Updated Jamf Pro External Application Custom Schema.

Known Issues (5.x)

• There are currently no available Rapid Security Response (RSR) updates for any version of macOS. As such, RSR update workflows have not been validated against this version of super.
• The Jamf Pro new Managed Software Updates feature remains unreliable if the workflow target is not the latest minor update or major upgrade. In the mean time, the legacy Jamf Pro software update API remains stable (although deprecated) and local authentication is always the most reliable.

Specific Changes (5.1.0-beta4)

• New macOS Setup Assistant "done file" detection automatically defers the workflow if super is installed during new system provisioning. In other words, it's now safe to install super during macOS onboarding (including ADE workflows), as it will automatically defer based on the --deferral-timer-default=minutes option or the default of 60 minutes.
• New --schedule-deferred-start-file=/local/path option automatically defers the workflow if the specified file is not found. This allows for super to be safely installed during extended macOS onboarding workflows (like Jamf Setup Manager, Setup-Your-Mac, SplashBuddy, etc.), as it will automatically defer based on the --deferral-timer-default=minutes option or the default of 60 minutes.
• New --schedule-deferred-start-days=number option automatically defers the workflow until the specified number of days has passed since the zero date. Simliar to the native macOS update/upgrade deferral mechanism, this option prevents super from interrupting the user (or if there is no user, from automatically installing) until after the deferred start number of days has passed.
• Resolved an issue that could prevent authentication options from being saved when using the --config-edit-main or --config-edit=ConfigurationName options.
• Resolved an issue that prevented a previously set automatic workflow launch when using the --config-edit-main or --config-edit=ConfigurationName options.
• Resolved an issue that prevented the --config-delete=ConfigurationName and --config-delete-all options from properly removing all relevant workflow settings.
• Improvements to the workflow complete reset mechanism should prevent issues caused by previously scheduled installations not properly reseting.
• Updated spreadsheet (tab separated values) for migrating to super v5.1.0 command line options.
• Updated spreadsheet (tab separated values) for migrating to super v5.1.0 managed preferences.
• Updated example MDM configuration profiles for super v5.1.0.
• As always, typo fixes and improvements to both regular and verbose log output.
• super 5.1.0-beta4 SHA-256: a05ecc6ec1dea5568532196a70c98b178e944312ef45724f87afcbde1823f737

Please refer to the Change log for full details.