Category Filter

Common errors while enrolling Mac in Apple Business Manager

Whilst attempting to enroll Mac in Apple Business Manager through the Hexnode portal, there are a few common errors one is liable to come across.

1. Profile Installation Failed

Profile Installation failed while enrolling Mac in ABM

Description

This is a common error message that occurs during device activation.

Solution

Here are some possible remedies for this error:

    • Make sure there is an adequate number of MDM Licenses in order to manage your devices.
        1. Sign in to your Hexnode UEM portal, head on to Admin > License > Total device count.

        1. If the maximum limit on the number of enrolled devices has been reached, you’ll need to upgrade the license to manage more devices.

      Total number of devices enrolled in Hexnode UEM
    • Ensure that the Server Token has not expired.
        1. After signing in to your Hexnode UEM portal,
          navigate to Admin > Apple Business/School Manager > Apple DEP.
        2. Switch to the DEP Accounts tab and check the date of license expiration.

      Licence expiration dates of Apple DEP accounts in Hexnode UEM
    • In case the Server Token has expired,
        1. Sign in to your Apple Business Manager account.
        2. Navigate to Settings > choose your MDM server > Click on Download Token to download a new DEP Token from your server.
        3. Head on to Admin > Apple Business/School Manager > Apple DEP > DEP Accounts.
        4. Click on the edit icon that appears when you move the cursor to the right of the respective DEP account.
        5. Upload the new token in the Upload Token field and click Save.

      Upload Token in Edit DEP Account
    • Verify that you have pushed the DEP Policy to your macOS device.
        1. You can push the DEP Policy to your macOS device(s) by signing in to your Hexnode UEM portal.
          Go to Admin > Apple Business/School Manager > Apple DEP.
        2. Select DEP Devices > Choose the required device(s) > Click the Associate DEP Profile button.

      Now, you need to wipe your device to re-enroll them into your Hexnode UEM account.

    • Check if the Pre-approved settings have been enabled in both Enrollment settings and Apple DEP settings.
      On your Hexnode UEM portal,
      1. Go to Admin > Enrollment.
      2. If you have enabled the option Pre-approved Devices only under Enrollment Restrictions,
          1. Head on to the Admin > Apple Business/School Manager > Select Apple DEP > DEP Accounts.
          2. Click on the edit icon that appears when you move the cursor to the right of the respective DEP account.
          3. Check the option Add as Pre-approved Device > Click Save.

        Add as Pre-approved device in Edit DEP Account
    • Ensure that there are no pending OS updates on any of the macOS devices that you are trying to enroll. If there are pending OS updates, you’ll have to remove the required devices from your Apple Business Manager account before executing the OS update.
        1. Go to Apple Business Manager and sign in to your account.
        2. Click Devices. Search and select the required devices from the list. You can filter devices based on their source, order numbers, device types, etc.
        3. Next, click on the database icon.
        4. Select the Unassign option to unassign devices from the MDM server.
        5. After unbinding the device from the MDM server, complete the pending OS updates on your macOS device.
        6. Go back to your Apple Business Manager account and re-assign the devices to the MDM server.
        7. Now, sign in to your Hexnode UEM portal and navigate to Admin > Apple Business/School Manager > Apple DEP > DEP Devices > Click the Sync with DEP button.

      Sync device with DEP for Mac

2. Even after successful sync, the device does not get listed on the DEP Devices page on the Hexnode portal.

Solution

Perform the following methods to resolve this syncing issue:

  • Check whether the DEP token is expired. Renew the DEP token, and then factory reset the devices.
  • If the DEP token is not expired, ensure that any new terms and conditions released by Apple are accepted from the ABM portal. If Apple’s terms are not accepted, renew the token again (even if the token is still valid) and accept the conditions. Now, perform the sync action again.
  • Ensure that you have not enrolled the device in the MDM server using an enrollment method other than DEP. If any other method is used, remove the device from management and reset your device to factory settings. From your Hexnode UEM portal, go to Admin > Apple Business/School Manager > select Apple DEP > click the Sync with DEP button.

3. Cancelled

Description

Error message during device activation.

Solution

  • Check your network connectivity.
  • Try restoring the device. Restoring a device reloads the configurations into it. Then, try re-enrolling the device after restoring it successfully.

4. A server with the specified hostname could not be found.

Description

Error message during device activation.

Solution

  • Check your network connectivity and try again.

5. NOT_ACCESSIBLE.

Description

Error message while adding devices to the DEP portal.

Probable Cause

This error occurs if the device is not eligible for ABM enrollment or is already enrolled by another organization.

Solution

  • Check if the device is eligible for DEP enrollment. If not, enroll the device via Apple Configurator.
  • Ensure that the device is not already enrolled or maintained by another organization.

6. Unable to view the MDM servers tab after signing into the ABM portal.

Solution

  • Make sure that you log in to ABM with an account with either Administrator or Device Enrolment Manager roles. To assign such roles in ABM, sign in to Apple Business Manager with an account that has the role of Administrator or People Manager. Then, select Roles under People and edit/add the required roles for the respective users.
  • Also, ensure that the admin has agreed to Apple’s terms and conditions.