Skip to content

cantscript/SchoolAssembly

Repository files navigation

School Assembly: V2.0

Renamed Project: Same tool, new name!

Newly updated project which now uses a Configuration Profile to control the script! Admins no longer need to edit anything in the script for easier manipulation and ongoing maintenance

App deployment/onboarding tool for macOS design for use Jamf School. School Assembly give's visual feedback to Admins or End User while installing applications on deployment of device


School Assembly Tool Dependancies

This workflow utilises

Installomator must be installed on the target device(s) prior to running. swiftDialog will be installed via Installomator in script logic, if not already installed.

Use one of the following to deliver Installomator to target device(s) with Jamf School

  1. By scripting installation before running School Assembly Tool  
  2. Deploying via a package and then running School Assembly Tool

App Icons

App icons referenced by a configuration profile need to be on the device prior to running this tool. If you deploy Installomator by a package you could create a custom package which includes both Installomator and the required app icons and deploy that you your target device(s)

V2.0 does not allow for images references to be from the internet.
(This is a current limitation of the School Assembly Tool logic in this version. I hope to fix this in a future version)


Deployment (Quick Guide)

To use the School Assembly tool follow the steps below

  • Install Installomator on the target device(s) via Jamf School prior to using the tool
  • Package any icon images and deploy to the target device(s) via Jamf School prior to using the tool
  • Create a configuration profile to control the School Assembly tool, there is an Example Configuration Profile available
  • Upload the configuration profile into Jamf School and deploy to target device(s)
  • Copy the School Assembly script into Jamf School
  • Scope and deploy to target device(s)
  • School Assembly tool will run on target device(s), installing swiftDialog if required

If there is no user logged into the device the tool will wait until, checking every 5 seconds, until there is a user logged in before running

If there is no configuration profile installed a notification will be displayed onscreen and the tool will exit

Logs for the School Assembly script can be found at /var/tmp/jsmacOSOnboarder.log
Once School Assembly has ran it creates a done flag in the following location which will prevent further runs of School Assembly, until removed: /Users/Shared/.SchoolAssembled

For full detailed deployment steps visit the Wiki


Configuration Profile Manifest

When creating the configuration profile for School Assembly you may wish to use popular GUI tools Profile Creator or iMazing Profile Editor

Install the Configuration Profile Manifest to your local machine to build the required configuration profile through Profile Creator or iMazing Profile Editor

For guides on where to install the manifest plist visit Profile Creator Manifest Instructions or iMazing Profile Editor Instructions


User Guide

Please use the Wiki to find full usage guide


Thanks!

This script has been heavily inspired by "Progress 1st swiftDialog.sh" & "Installomator 1st Auto-install DEPNotify.sh" by Søren Theilgaard

With help from scriptingosx with reading profile keys in bash scripts

About

Jamf School focused App Deployment / Onboarding tool for macOS, controlled with a Config Profile. Give visual feedback to Admins and End Users when building a device

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages