General Requirements

To upgrade computers to macOS Catalina, you need the following:

• Managed computers with macOS 10.9.5–10.14.6

• The macOS Catalina app from Apple School Manager. For more information, see Select and buy content in Apple School Manager in the Apple School Manager User Guide.

  Note: After adding the app, you must synchronize Apple School Manager with Jamf School. For more information on how to synchronize, see Synchronization.

Creating a Smart Group for Target Computers

1. In Jamf School, navigate to Devices > Groups.

2. Click +Add Group.

3. Enter a name for the group in the Group Name field.

4. (Optional) Enter a description for the group in the Description field.

5. Select Smart Group for the group type and click Add.

6. Click the Members payload.

7. To filter group membership by computers with a macOS version between 10.9.5–10.14.6, click +Add Filter and do the following:

   1. Choose "Operating System" from the criteria pop-up menu.

   2. Choose "equals" from the operator pop-up menu.

   3. Choose "macOS" from the value pop-up menu.

   4. Enter "10.9.5" in the minimum value field.

   5. Enter "10.14.6" in the maximum value field.

8. (Optional) Add any additional filters and criteria as needed by clicking +Add Filter.

9. Select Match all rules.

10. Click Save Scope.

11. (Optional) If you are upgrading 1:1 and shared computers, repeat steps 2 through 10 to create separate smart device groups for each.

The group membership is displayed in the table below scope.

Upgrading 1:1 Computers

1. In Jamf School, navigate to Apps > Apps in the sidebar.

2. Select the checkbox next to the macOS Catalina app.

3. Click Edit Scope.

4. Enter the name of the device group of computers eligible for macOS Catalina that you previously created in the Scope field.

5. Choose one of the following installation methods from the Install Type pop-up menu:

   • To install the app on devices automatically, choose "Change to automatic installation for all groups".
     The macOS Catalina app displays in the Applications folder and users are prompted to install the upgrade.

   • To allow users to install the app themselves, choose "Change to on-demand installation for all groups".
     The macOS Catalina app displays in Jamf School Self Service for users to upgrade at their convenience.

6. Click Save.

Upgrading Shared Computers Using Apple Remote Desktop

Upgrading Shared Computers Using Scripting in Jamf School

1. In Jamf School, navigate to Apps > Apps in the sidebar.

2. Select the checkbox next to the macOS Catalina app.

3. Click Edit Scope.

4. Enter the device group of computers eligible for macOS Catalina that you previously created in the Scope field.

5. Choose one of the following installation methods from the Install Type pop-up menu:

   • To install the app on devices automatically, choose "Change to automatic installation for all groups".

   • To allow users to install the app themselves, choose "Change to on-demand installation for all groups".

6. Click Save.

7. Navigate to Devices > Groups.

8. Click +Add Group.

9. Enter a name for the group in the Group Name field.

10. (Optional) Enter a description for the group in the Description field.

11. Select Smart Group for the group type and click Add.

12. Click the Members payload.

13. To filter group membership by computers with a macOS version between 10.9.5–10.14.6, click +Add Filter and do the following:

    1. Choose "Operating System" from the criteria pop-up menu.

    2. Choose "equals" from the operator pop-up menu.

    3. Choose "macOS" from the value pop-up menu.

    4. Enter "10.9.5" in the minimum value field.

    5. Enter "10.14.6" in the maximum value field.

14. To filter group membership by computers with the macOS Catalina app installed, click +Add Filter and do the following:

    1. Choose "Managed App (Installed)" from the criteria pop-up menu.

    2. Choose "one of the following" from the operator pop-up menu.

    3. Choose "macOS Catalina (VPP, macOS)" from the value pop-up menu.

15. (Optional) Add any additional filters and criteria as needed by clicking +Add Filter.

16. Select Match all rules.

17. Click Save Scope.

18. Navigate to Scripts in the sidebar.

19. Click +Create new script.

20. Enter a name for the script in the Name field.

21. Choose "Bash" from the Type pop-up menu.

22. (Optional) Enter a description in the Description field.

23. Choose when the script should run from the When to run pop-up menu.Note: It is recommended that you choose the "On a schedule" option. If you select this option, it is recommended that you test and stage this upgrade. The success of this workflow will vary based on network bandwidth.

24. Enter the following in the Content field:
    #!/bin/bash -v/Applications/InstallmacOSCatalina.app/Contents/Resources/startosinstall --agreetolicense

25. Configure the scope of the script by clicking the + icon and adding the device group of computers eligible for macOS Catalina with the macOS Catalina app installed that you previously created to the script scope.

26. Click Save.

Troubleshooting Failed Computer Upgrades

If the computers in scope fail to upgrade, you can do the following:

• Check the network connection if the computer is unable to receive commands from Jamf School.

• Run the script on fewer computers at a time if you have low network bandwidth.

• Check the available disk space on the computers. The upgrade will fail if computers do not have enough available disk space. For more information about the disk space requirements, see macOS Catalina Technical Specifications from Apple's support website.

• Ensure the computer meets the hardware requirements for the upgrade. For more information about the hardware requirements, see macOS Catalina Technical Specifications from Apple's support website.

Related Information

For related information, see the following section in this guide:

macOS Updates
Find out how to update to minor macOS releases.