Skip to content

Troubleshooting

For problems with the Oneleet Agent itself, see the agent troubleshooting page.

The Configuration Profiles tab is disabled

Section titled “The Configuration Profiles tab is disabled”

Oneleet MDM isn’t turned on for your workspace. See Turn on Oneleet MDM.

The Oneleet Portal offers the profile only while your Apple push certificate is valid, so check the Apple MDM Setup tab first. The button is in the top right of the portal’s Devices page, and appears once the person has connected a device. Before that, they click Install Oneleet Agent and find it under Apple MDM profile.

If the Mac runs Oneleet Agent 2.6.0 or later, you can skip the download. Open the Mac and choose Manage device > Prompt user to enroll in MDM.

Downloading the profile doesn’t enroll the Mac. Someone has to approve it in System Settings > General > Device Management. See Install the profile.

If the Mac shows Other MDM, another product manages it. See Move from another MDM.

Someone removed the enrollment profile, or the Mac was erased. See When a profile is removed.

The agent didn’t install after a Mac enrolled

Section titled “The agent didn’t install after a Mac enrolled”

Oneleet retries the installation by itself until the agent connects. To follow the attempts, filter the Mac’s Activity tab for Agent install retry started. If the Mac is offline, it gets the agent when it’s back online.

The device is usually offline, and the command is delivered when it reconnects. See Command statuses.

Hover over it to see why. The usual reasons:

  • The Mac isn’t enrolled. A Mac with only the agent can’t be locked, wiped, or restarted. Enroll it.
  • The device is excluded from MDM. Change its MDM enrollment.
  • The agent is out of date. See Version requirements.
  • A command of the same kind is already pending.

Something else on the device sets the same value, usually Group Policy on a domain-joined device or another MDM. On a domain-joined device, the page shows how many Group Policy objects apply under Active Directory. Hover over the count to see them. Set the same value in both places, or manage that setting in only one of them.

  • FileVault: FileVault was on before the Mac enrolled. Rotate the key on the Mac.
  • BitLocker: the device needs Oneleet Agent 2.6.0 or later, Windows Pro, Enterprise, or Education, and a TPM.

A Mac doesn’t appear on the ADE Devices tab

Section titled “A Mac doesn’t appear on the ADE Devices tab”

Check that it’s assigned to Oneleet’s service in Apple Business, then click Sync now. See Enroll Macs with Apple Business Manager.

If the push certificate expires, Oneleet can’t reach any of your Macs. If the Apple Business service token expires, Oneleet can’t sync your inventory. Renew the existing credential. Don’t create a new one. See Renew the push certificate and Renew the service token.